Skip to content

How does the program learn to read a supplier’s invoices?

Each supplier lays out its invoices its own way. For each supplier, the program saves which area of the page each field is in: these are its reading rules. They are learned on their own when you review its invoices, refined by marking on the PDF, and with them the next ones are read better.

What are a supplier’s rules?

They are a list of fields, and for each one its name and the box on the page where its value usually appears are saved. When another invoice from that supplier arrives, those areas are passed to the AI as a hint: ‘the total is usually here’. And the reliability checks whether each field has come out where it should.

The rules belong to the supplier, not to the company: if you work with several companies in the same ERP, they are used in all of them. Each supplier has a single rules record, with as many fields as needed.

In the review’s list of fields, those that already have a zone saved for that supplier have the rule badge.

Do I have to create them by hand?

No. The program learns on its own at two moments:

Only the zone of fields that have a value and a box is learned. A zone that hardly moves compared with the one already there —the same total, a little wider because the amount has one more digit— doesn’t count as a change: the rule stays as it was. That way, reviewing one more invoice from a supplier that is already read correctly doesn’t leave it not validated.

How do I correct a zone that is wrong?

By marking it on the PDF, on an invoice from that supplier:

  1. Open the invoice in Tools → Document import.
  2. In the list on the right, click the Mark on the PDF button of the field that is failing.
  3. Drag a box over its value, on the PDF. The program reads the text inside and puts it in as the value.
  4. Click Save zones, or go straight to Import.

What you mark by hand always changes the rule, even if it looks like the one already there: it is your correction and it wins.

If it isn’t yet known which supplier the invoice is from, you can still mark. The zone stays on the field and becomes a rule as soon as the invoice has a supplier and you save or import it.

You don’t need to mark every field. Correcting the ones that fail is enough: the AI keeps handling the rest.

What does validating a supplier mean?

Validate supplier means saying ‘I have checked their invoices and the program reads them correctly’. It is one of the conditions for their invoices to come in without going through review, together with the minimum reliability in the settings.

When you click it, the zones of the invoice you have open are also saved. The button disappears and the supplier now has the Validated badge in the header of the fields.

Importing a reviewed invoice also validates its supplier: importing it already says that it has been read correctly. You don’t need to click Validate supplier first.

A validated supplier stops being validated when its rules change without importing any invoice: marking a zone by hand and saving it, removing a field with a rule, or adding or removing a distinctive text. It goes back to the Not validated badge because rules that have just changed haven’t yet been tried out on any invoice. When you import the next one, it becomes validated again.

Bear in mind that validating isn’t enough on its own. If Always review is ticked in the Settings —it is by default—, everything goes through review even if the supplier is validated.

What are the supplier’s fingerprints for?

They are what only appears on one supplier’s invoices: their Tax ID, their bank account, their website or email, their phone, a word from their name, some fixed phrase in the footer. They are used to recognise who the invoice is from when the Tax ID can’t be read, which is what happens when it is inside the logo, and to check the Tax ID when it is read.

They are learned on their own every time you import an invoice from the supplier, and refined with each one: what doesn’t repeat on the next one gradually fades out. Nothing is ever taken from your company or from the recipient, which would appear on every invoice you receive. How they are used and what happens if they don’t match the Tax ID is explained in what to do if it doesn’t recognise the supplier.

You see them in the Recognise this supplier drop-down, below the fields, each with its type; the faded ones are crossed out. You can remove the ones you don’t want. To add one by hand, type the text in Distinctive text… and click Add. Rules for the ones typed by hand:

The drop-down only appears when the invoice already has a supplier: the texts are saved in its rules record, and without a supplier there is no record to save them in.

If something goes wrong

What you seeWhat has happenedWhat to do
Save zones, Validate supplier and Recognise this supplier don’t appearThe invoice has no supplierResolve that first: what to do if it doesn’t recognise the supplier
‘A field … already exists’That name is already in the list or in the rulesUse the one already there and mark its zone
The supplier goes back to Not validatedIts rules or its hand-typed fingerprints have changedCheck the next invoice and import it: it becomes validated again
It is validated and its invoice still goes through reviewAlways review is ticked in the Settings, or the reliability of that invoice doesn’t reach the minimumUntick Always review if you want them to come in on their own; if not, look at the reliability reasons
I mark the zone and the value comes out emptyThe box doesn’t cover the words, or that area is an imageMake the box bigger; if the field is a graphic, type the value by hand
I save the zones and the next invoice is still the sameThat supplier has another layout, or the invoice was assigned to another oneCheck in the header of the fields which supplier and which Tax ID were recognised

Previous: Review and correct what the system has read · Next: What to do if it doesn’t recognise the supplier

More about Invoice import