Skip to main content

Guide · 2026-11-17

Markdown export

Tell the extraction how to read your invoices

Save short instructions about your invoice layouts in the profile. Every new document conversion of your company reads them, including External API V1 and Email Import. They help the extraction find printed values. They cannot change printed amounts or bypass validation.

What extraction instructions do

You explain your invoice layouts once, and every new conversion uses that knowledge.

Extraction instructions are notes about your invoices, for example where a reference number sits or which printed date is the delivery date. The extraction reads them together with the invoice.

An instruction helps the extraction find a value that is printed on the invoice. It does not supply a value that the invoice does not show.

Each company in your account has its own instructions. They are available on every plan.

Save instructions

  1. Open Profile, then Extraction instructions.
  2. Write your instructions in the field Instructions for this company. You have up to 10,000 characters.
  3. Describe when a rule applies, for example for which supplier or at which place on the page.
  4. Choose Save instructions.

Which conversions use them

ConversionUses the instructions
PDF upload in the web app, also several files at onceYes
External API V1 with a PDFYes
Email ImportYes
PDFs uploaded individually or in a ZIP fileYes
Structured invoice data, for example a CSV or JSON importNo
PDF through a connected AI assistant or the Windows ConnectorYes
Enter an invoice manually, view XML or validate an existing fileNo
Upload without sign-inNo

What instructions cannot do

Instructions cannot change printed amounts. They cannot bypass validation: a file is issued only when it passes the validation of its format.

Instructions apply to conversions that start after you save them. A conversion that has already started keeps the instructions it started with.

In Email Import, instructions in the email itself win over the company instructions.

Instructions are never added to the e-invoice, neither as an attachment nor as an invoice note.

Switch them off

Leave the field empty and save. New conversions then run without instructions.

Good instructions

A good instruction names the supplier or document, the place on the page, and what to do when the value is missing.

A reference number below the title
For invoices from Example AG, a reference starting with ZDE directly below the title is the customer order number. Copy it only if present.
The right date
On invoices from Sample Logistics Ltd, the date labelled "Service date" at the top right is the delivery date. Do not use the invoice date for it.
Two similar numbers
On our own invoices, the number after "Order no." is the purchase order reference. The invoice number is the number after "Invoice no.".
Avoid: a value instead of a place
Always use 19 % VAT.

Who can change them

  • People who may edit the company can save instructions.
  • People with read-only access to the company can read them, but not change them.

Next steps