Skip to content

This Google Apps Script automates the extraction, processing, and organization of PDF files containing electronic invoices (DANFE or NF-e) from Gmail. It scans emails for attachments, identifies the sender (supplier) and recipient (client) based on predefined lists, and renames the PDF files using a structured format: SUPPLIER-NF-DANFE.pdf.

License

Notifications You must be signed in to change notification settings

Takk8IS/GetNFePDF4Gmail

Repository files navigation

Get NFe PDF 4 Gmail 📄

GetNFePDF4Gmail

Version Licence GitHub issues GitHub stars

Efficiently organize and manage your electronic invoices (DANFE or NF-e) directly from Gmail into Google Drive, ensuring your financial documents are always in order.

🌟 Features of GetNFePDF4Gmail™

GetNFePDF4Gmail™ is a powerful Google Apps Script designed to streamline the process of handling electronic invoices received via Gmail. By automating the extraction, renaming, and organization of PDF invoices into a well-structured folder hierarchy in Google Drive, this script saves time and reduces errors in financial document management.

GetNFePDF4Gmail GetNFePDF4Gmail GetNFePDF4Gmail

🚀 Key Features

  • 📥 Automatic Email Scanning: Scans your Gmail inbox for emails containing PDF invoices based on customizable search criteria.
  • 🗂️ Structured Folder Organization: Organizes invoices into Google Drive folders based on the client and supplier, creating a clear and easy-to-navigate document structure.
  • ✏️ Intelligent File Renaming: Renames PDF files in the format SUPPLIER-NF-DANFE.pdf by extracting the DANFE number and supplier name from the file content.
  • ⏸️ Session Management: Built-in pause and resume functionality to handle large volumes of emails efficiently, ensuring uninterrupted processing.

📦 Project Structure

GetNFePDF4Gmail
├── AUTHORS.md
├── ClientsList.js
├── FUNDING.yml
├── GetNFePDF4Gmail.js
├── GoogleAppsScript.md
├── LICENSE.md
├── PRIVACY.md
├── README.md
├── SuppliersList.js
└── images
    ├── screenshot-01.png
    ├── screenshot-02.png
    ├── screenshot-03.png
    └── screenshot-04.png

🏃‍♂️ How to Use

  1. Clone the repository and set up the Google Apps Script project in your Google Drive.
  2. Modify the ClientsList.js and SuppliersList.js with your own data.
  3. Run the script to start processing your Gmail inbox and organizing invoices.

🔒 Ethical Use

GetNFePDF4Gmail™ is designed for legal and ethical use. The script should be employed to streamline and organize personal or business financial documents in accordance with Gmail's and Google Drive's terms of service.

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

  1. Fork the repository.
  2. Create your feature branch (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

💡 Donations

If this project has been helpful, consider making a donation:

USDT (TRC-20): TGpiWetnYK2VQpxNGPR27D9vfM6Mei5vNA

Your support helps us continue to develop innovative tools.

📜 Licence

This project is licensed under the CC-BY-4.0 Licence. See the LICENSE file for more details.

🏆 About Takk™ Innovate Studio

Leading the Digital Revolution as the Pioneering 100% Artificial Intelligence Team.

About

This Google Apps Script automates the extraction, processing, and organization of PDF files containing electronic invoices (DANFE or NF-e) from Gmail. It scans emails for attachments, identifies the sender (supplier) and recipient (client) based on predefined lists, and renames the PDF files using a structured format: SUPPLIER-NF-DANFE.pdf.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published