Skip to main content
Post

Paperless-ngx AI: Find Receipts and Track Warranty Dates

Quickchat published a tutorial for building a Paperless-ngx assistant that finds an appliance receipt, reads its recorded warranty date, and links back to the original document. This is a walkthrough, not a new built-in integration.

The example agent is called Receipt Drawer. You ask "Where is the receipt for our espresso machine?" and it answers with the model, purchase information, the expiry date you saved, and a link to the receipt. It uses two read-only API Actions: one searches receipt titles and text, and the other reads the selected document's text and custom fields. A third Action covers questions like "Which recorded warranties expire in January?" by filtering on a Date custom field named warranty_expiry. The sample kettle receipt has no expiry date on purpose, so you can check that the assistant leaves missing information missing.

The setup is built around a private archive. You create a dedicated Paperless-ngx user with view-only permissions and put its API token in each Action's fixed Authorization header, not in the prompt or chat. In Quickchat, you turn off Widget & Embed access and set Chat Page Access to Nobody, then test in the dashboard's AI Preview. Retrieved text and fields do travel to the hosted assistant to answer the question.

Before you start, you need a Paperless-ngx instance reachable from Quickchat over HTTPS. A localhost or LAN address won't work for hosted Actions. You also need a Quickchat account with enough AI credits for three Actions and testing. The tutorial uses Paperless-ngx v3.5.0 and says to check your own version's API explorer before copying the date filter. The warranty dates in the demo are manually assigned sample data. The OCR text alone doesn't fill the field.

A starter kit has the fictional sample receipts, Action settings, Main Prompt, and a test checklist. Those are editable reference files, not a one-click agent import.

Loading replies