Repository navigation
Feature Request: Optional Paperless-ngx Integration for Statement Vault #5071
Bishop-trevorstuart
started this conversation in
Feature Requests
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Describe the feature
I'd like to see Sure offer an optional integration with Paperless-ngx, allowing Paperless to serve as the document storage for Sure's Statement Vault.
I use both applications in my homelab. Paperless is where I keep my original financial documents, including bank and credit card statements. Sure's Statement Vault is where I want to associate those statements with the appropriate accounts, track statement coverage, and reconcile balances.
Currently, getting the full benefit of both means storing the same statement PDF in two places.
What I'd like is the option to connect Sure directly to Paperless so that:
I can select an existing document from Paperless and link it to an account in Sure.
Sure continues to handle account associations, statement periods, coverage tracking, balances, and reconciliation.
The original document remains stored in Paperless, without Sure needing another copy.
I can open or download the document from Sure's Statement Vault, with Paperless providing the actual file.
The integration is completely optional. Anyone not using Paperless continues using Sure's existing Statement Vault exactly as they do today.
Ideally, this would be configured through Sure's settings by providing the Paperless server address and the required authentication.
For an initial implementation, read-only access to Paperless would be sufficient. I don't think two-way synchronization is necessary.
Why is this feature important?
My main reason is to avoid maintaining two copies of the same financial documents.
Paperless already handles document storage, OCR, searching, organization, and archiving. Sure handles the financial side much better, particularly associating statements with accounts and checking them against transaction and balance history.
I'd prefer to let each application do what it does best.
I already use n8n to move documents from Paperless into Sure when needed, so automating the upload isn't really the problem. The improvement I'm suggesting is not having to upload a second copy in the first place.
I suspect other self-hosted users running both applications would benefit from this too.
It would also make document management simpler. If I need to find, organize, or back up an original statement, there's one authoritative document archive rather than two separate collections to manage.
Additional context, screenshots, and relevant links
A few related Sure developments seem relevant:
PR #4826 – Add Account Statements to the API — Recently merged and provides additional ways to work with Statement Vault.
PR #3422 – Bridge Statement Vault to document search — Related work on making statement documents accessible through Sure's document-search functionality.
PR #4516 – Typed family documents — Broader document-management development.
Paperless also has an established REST API that could potentially support this integration.
A few things I'd consider important:
Keep it optional. Sure's existing document storage should remain the default.
Don't delete originals. Removing a statement or unlinking an account in Sure should never automatically delete the document from Paperless.
Preserve Sure's functionality. Using external storage shouldn't mean losing statement coverage or reconciliation features.
Respect permissions. A user shouldn't be able to access a Paperless document through Sure unless they're authorized to access it.
Handle unavailable documents. If Paperless is temporarily offline, Sure should still retain its statement metadata and show that the original document is temporarily unavailable.
Automatic discovery of new Paperless statements, perhaps through tags or document types, would be a useful future enhancement. I wouldn't consider it necessary for the first version.
I'm not suggesting that Paperless replace Sure's financial records or reconciliation functionality. I'd simply like it to be an alternative location for the original statement documents.
All reactions