# Tell the extraction how to read your invoices

- 2026-11-17

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

| Conversion | Uses the instructions |
| --- | --- |
| PDF upload in the web app, also several files at once | Yes |
| External API V1 with a PDF | Yes |
| Email Import | Yes |
| PDFs uploaded individually or in a ZIP file | Yes |
| Structured invoice data, for example a CSV or JSON import | No |
| PDF through a connected AI assistant or the Windows Connector | Yes |
| Enter an invoice manually, view XML or validate an existing file | No |
| Upload without sign-in | No |

## 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

- [Confirm or fix review findings](/resources/review-validation/confirm-or-fix-review-findings)
- [Read the Email Import guide](/developer-api/email-invoices)
- [Read the bulk run guide](/developer-api/bulk-runs)
