Common Peppol invoice validation errors and fix order
What Belgian SMEs see when Peppol validation fails, and the order to fix VAT totals, buyer numbers, and missing fields before send.
Updated
Your software said no before the customer saw it
Validation means your invoicing tool or Access Point refuses the invoice before Peppol delivery. The file fails the structured-invoice rules. That is not a customer saying “we will not pay,” and it is not a delivery status problem.
Fix validation first. Do not use a legal invoice number on a document you already know is invalid. After a failed send or a later customer reply, see Fix a rejected Peppol invoice.
Symptoms you will recognise
| What you notice | Likely cause |
|---|---|
| “VAT total doesn’t match the lines” | Line VAT and document VAT were calculated differently |
| “Buyer number wrong” / cannot find customer on Peppol | Enterprise number or scheme incorrect |
| “Missing invoice number / date / currency” | Required header fields empty |
| “Line description empty” or “unit not allowed” | Incomplete line |
| “VAT rate doesn’t match the category” | Wrong VAT code on a line (standard, exempt, reverse charge, franchise) |
| “Payable amount doesn’t add up” | Discounts, charges, or VAT not rolled into the total |
Most “almost ready” invoices fail on VAT maths or buyer identity.
Fix in this order
Later errors often vanish once earlier ones are fixed. Work top-down:
- Buyer and seller identity - Correct legal names. For Belgium, Peppol addressing uses scheme 0208 and the ten-digit enterprise number (KBO/BCE). Do not put a VAT number (
BE0…) where the Peppol ID expects0208+ enterprise number. Keep leading zeros. Check parent vs subsidiary. Confirm the buyer with participant lookup. - Invoice basics - Number, issue date, currency (usually
EURdomestically). - Lines - Description, quantity, unit, net amount on every line.
- VAT on each line - Same category and rate as your Belgian VAT treatment; see legal mentions.
- Totals - Fix VAT mapping in the product, then regenerate totals. Do not hand-edit one total field alone.
- References the buyer expects - Purchase order number if they require it.
- Validation error
A refusal before delivery: the structured invoice failed the rules, so Peppol never treated it as a delivered business document.
Quick checklist before send
- Seller and buyer names and addresses
- Your VAT / enterprise IDs for the scenario
- Invoice number and date
- At least one complete line
- VAT breakdown that matches the lines
- IBAN or structured payment communication if you put them on the invoice
Then: open the full error report → fix in the order above → re-validate until clean → only then send (first Peppol invoice). Field meanings: EN 16931 / UBL.