Apps › Print and documents

Paperless-ngx Connector

Paperless-ngx's correspondents, document types, tags and documents come into Odoo with their OCR text, and with Create Vendor Bills ticked, each imported document gets a draft vendor bill with its PDF attached.

Open the live demo Read the manual

Odoo 16Odoo 17Odoo 18Odoo 19Odoo 20

The Paperless-ngx instance form: Base Url, API Token and the state Connected, the health block, and the tabs Safety, Import and Vendor Bills
The Paperless-ngx instance form: Base Url, API Token and the state Connected, the health block, and the tabs Safety, Import and Vendor Bills
Runs onOdoo 16 to 20Community or Enterprise, self-hosted or Odoo.sh
NeedsInvoicingno Enterprise module
Price89 EURone-time, per series, on the Odoo Apps Store
Demodemo20.bambooforge.devlogin page already filled in
Supportsupport@bambooforge.devfirst reply within one business day
Version20.0.1.0.14bambooforge_paperless_connector

125 automated checks run before every release of this app, the same suite on every series it ships for. The complete list is in the source you receive; run it yourself with --test-enable.

How you use it

Four flows, in the order you will meet them

Flow 01

Connect: one instance per Paperless-ngx server, dry-run first

Test Connection proves the address and the token, and the first import writes nothing.

  1. In Odoo: Paperless Connector > Configuration > Instances > New. Enter the server's address and the API token of a Paperless user.
  2. Press Test Connection. The state turns Connected.
  3. On the Import tab press Queue Document Import: correspondents, document types and tags are listed first, then the documents.
  4. Read Operations > Logs and Validation Results, untick Dry Run Mode and press the button again.
The Paperless-ngx instance form: Base Url, API Token and the state Connected, the health block, and the tabs Safety, Import and Vendor Bills
Flow 02

The archive, searchable in Odoo

Odoo's copy of Paperless's names, dates and OCR text; the files stay in Paperless.

  1. Catalog > Documents lists each document with its correspondent, type, created date and archive serial number.
  2. A document's form shows its tags and its OCR text; the list searches that text.
  3. Catalog > Correspondents, Document Types and Tags list each with the number of documents Paperless counts for it.
The Documents list: each document's title, correspondent, document type, created date and archive serial number
Flow 03

A draft vendor bill for each imported document

Off until you tick Create Vendor Bills; every document an import writes gets one, whatever its type.

  1. On the Vendor Bills tab tick Create Vendor Bills, pick the journal, and for a line set Default Expense Account and Total Custom Field.
  2. Each document an import writes without a bill gets one in draft: the vendor found by the correspondent's name, the document's date, its title as reference.
  3. The bill gets one line when the document carries the total in that custom field, and the document's PDF in its chatter.
  4. An accountant checks and posts it in Invoicing > Vendors > Bills.
Flow 04

Failed jobs are listed, with their error

Every job is retried, set aside after its last try, and shown with its error.

  1. Open the Control Tower: one card per instance with its backlog, dead letters and conflicts.
  2. Open Dead-letter, fix the cause the error names, select the jobs and use Requeue Jobs.
  3. A bill that could not be drafted is an error line under Operations > Logs; the document is imported all the same.
The Control Tower card of a Paperless-ngx instance: health Warning, a backlog of 5 jobs, 2 dead letters, no conflict and 4 flow runs in 24 hours

Price and where to buy

89 EUR, one payment per Odoo series, on the Odoo Apps Store. Pick your series:

Twelve months of support by the people who wrote the code; bug fixes and improvements within the series free for as long as it is published. Report a bug within two months of purchase and, if it is not resolved within fifteen days, you get a full refund. Full source under OPL-1, no licence key, no phone-home. The whole promise.