Collection from Gmail
BuiltOAuth-based connection that finds relevant messages and fetches attachments without manually scanning the inbox.
From scattered receipts to a structured document workflow
A Windows-based workspace that finds, gathers, reviews, registers and archives vouchers from Gmail, attachments and local or synced folders.
The solution is developed as a concept prototype and portfolio demonstration — not presented as a production-ready system.
Receipt Assistant is a functional MVP developed for small businesses that need better oversight of receipts, invoices and other expense documentation. The solution gathers vouchers from multiple sources, identifies relevant documents and organises them through a controlled workflow. The user keeps decision authority when the system lacks information or is uncertain about how a voucher should be handled. Receipt Assistant is not an accounting system and does not perform bookkeeping on its own. It reduces manual preparation and prepares documentation for further review and accounting.
In smaller businesses, vouchers often exist in many places: Gmail and other email accounts, PDF attachments, photos of paper receipts, mobile folders, downloads and local folders, supplier portals and apps.
The documentation exists, but must be found, assessed, named and registered manually. That creates unnecessary time use and risk that vouchers are forgotten, processed more than once or linked to the wrong entity.
The starting point for the project was therefore a practical question: Can collection and structuring be automated without the user losing control?
The workflow is built as a controlled chain where automation stops when the basis is too weak:
The solution searches connected sources for documents that may be receipts or invoices.
Possible vouchers are shown with supplier, date, subject, document type and calculated priority.
Relevant information is extracted from the document and compared with known suppliers, categories and previous registrations.
Uncertain cases go to «Needs your help». The user can review and correct entity, supplier, date, amount, currency, document type and category.
Approved vouchers receive a voucher ID and standardised file name. The document is registered in the voucher register and archived in the correct structure.
The system suggests and structures. The user approves uncertain decisions.
The flow is designed with clear stops when the basis is too weak for automatic decisions.
Source → candidate → extraction → review → decision → registration → archiving
Receipt Assistant is built on a human-in-the-loop principle. This matters especially when a voucher may be private or business-related, the supplier is unknown, date, amount or document type is missing, one voucher may belong to multiple entities, or the document may be a copy of an earlier voucher.
Original emails and attachments are not changed or deleted as part of processing.
The solution has been developed and tested with vouchers from among others mobile and internet providers, software and SaaS services, AI tools and digital subscriptions, public transport and other travel expenses, parking and taxi, office and IT-related purchases, and other business-related suppliers.
Supplier rules and categories should be extendable without building a new application for each business.
The solution is built on least-privilege access. Connection to Gmail happens through the user's approval, and access can be revoked.
Receipt Assistant does not store the user's Gmail password, does not delete original emails, does not change original attachments, does not perform bookkeeping outside the solution, and does not decide uncertain cases without human review. Technical details are kept in the log rather than opaque error messages in the user interface.
Receipt Assistant is developed as a Python-based Windows application. The technical solution includes among other things Google OAuth 2.0, Gmail API, local and synced document processing, structured configuration of accounts and entities, SHA-256-based duplicate control, a voucher register in structured data format, standardised folder and archive logic, separate technical logging and local storage of authentication information with protection suited to the Windows environment. The solution is not presented as a full cloud platform or a fully integrated accounting system.
A working Windows application has been developed with a core flow from Gmail and synced document sources to review, registration and archiving.
The functions below are built in the MVP. Further integrations and channels are described under further development.
OAuth-based connection that finds relevant messages and fetches attachments without manually scanning the inbox.
Possible vouchers are gathered in a filterable overview. Single vouchers or several relevant documents can be handled together.
Uncertain cases are gathered in «Needs your help», so the system does not make irreversible decisions on weak grounds.
Supplier, date, amount, currency, document type, category and entity are structured before registration.
The document's digital fingerprint is used to prevent the same attachment being registered more than once.
Approved documents receive a unique voucher ID and are gathered in a structured register with status and key information.
Choice between private and business-related documentation, plus administration of multiple entities.
Vouchers can be processed from local or synced folders, including documents transferred from mobile.
The user connects a Gmail account or selects an available document source. Receipt Assistant searches for relevant documents and presents them as candidates.
The project shows how an administrative task can be analysed as an end-to-end workflow rather than solved with isolated automations. The value lies in combining understanding of a real SMB need, integration with existing information sources, structured document flow, automation of repetitive work, clear control points, user experience and error handling, security and traceability, and room for further scaling.
The project documents practical product development at the intersection of workflow, digital transformation, automation, user needs and responsible use of technology.
Completed functional MVP · Pilot-ready
The core flow from Gmail and synced document sources to review, registration and archiving is built. The solution has been tested in limited real-world use. It is not commercially launched or rolled out to external customers.
This is a completed portfolio and development project at MVP level, with a clear basis for further piloting and product development.
Adaptation must follow the organisation's systems, access needs and accounting process.
Commercial leader, AI strategist and concept developer
Concept, product logic, user flow and solution are developed from a concrete administrative need in a small business. The project combines business understanding, workflow, digital transformation, product development and practical use of technology.
Receipt Assistant is not currently available as a public demo or commercial product. Get in touch for professional dialogue on workflow, automation and practical AI in smaller businesses.