UBL invoices explained for Belgian construction contractors
Understand how UBL 2.1 XML and Peppol BIS Billing 3.0 work in Belgium, how UBL differs from PDFs, and what every construction invoice must contain.
If you work with Belgian business clients, general contractors, or public authorities, you hear "UBL" and "Peppol" in almost every conversation with your accountant. Yet most contractors never need to read a single line of XML code. Knowing what UBL actually does — and why a PDF attached to an email no longer counts as a legal Belgian B2B invoice since 1 January 2026 — saves rejected progress bills and payment delays.
Visual comparison between an emailed PDF (for private B2C clients) and a structured UBL 2.1 Peppol BIS Billing 3.0 invoice (mandatory for Belgian B2B since 2026).
What a UBL invoice actually is
UBL stands for Universal Business Language — an open international XML standard for structured business documents including invoices, credit notes, and purchase orders. In Belgium, the mandatory domestic B2B e-invoicing profile is Peppol BIS Billing 3.0, built on the European semantic standard EN 16931 and exchanged in UBL 2.1 XML.
Think of the difference between a PDF and a UBL file this way:
- In a PDF, the figure
€10,176.00is just ink drawn at coordinates on a page. Your client's accounting tool has to guess what it means using OCR scanning, or someone in finance has to re-type it by hand. - In a UBL XML file, every single value sits inside an unambiguous machine-readable tag:
<cbc:PayableAmount currencyID="EUR">10176.00</cbc:PayableAmount>
When that file arrives over the Peppol network, your customer's accounting or ERP software immediately knows the exact net amount, VAT rate, IBAN, structured payment reference, and purchase-order number with zero manual re-entry.
What sits inside a Belgian construction UBL invoice
A compliant Belgian construction UBL invoice contains every mandatory legal item you already put on paper, mapped to fixed fields:
| UBL section | Belgian construction details stored |
|---|---|
| Document header | Sequential invoice number, issue date, due date, currency (EUR), and document type (380 for invoice, 381 for credit note). |
| Supplier & customer IDs | Legal names, addresses, Belgian VAT numbers (BE0...), and Peppol participant identifiers (0208:<KBO/BCE number>). |
| Project & order references | Purchase order reference (OrderReference) or contract/site ID — essential for general contractors and public-sector Mercurius bills. |
| Invoice lines | Itemised scope descriptions, quantities, units (HUR for hours, MTR for metres, MTK for m²), unit prices, and net line totals. |
| VAT breakdown | Totals per Belgian VAT rate and category code: S for standard/reduced rates (21%, 12%, 6%) or AE (VATEX-EU-AE) for co-contractor reverse-charge VAT, plus the required legal exemption text. |
| Payment instructions | Supplier IBAN, BIC, and Belgian OGM/VCS structured payment reference so bank reconciliation matches automatically. |
| Embedded readable view | Optional PDF visual copy bundled inside the XML so site managers or architects can read the layout without opening raw XML. |
Why emailing a PDF or XML file does not satisfy Belgium's 2026 B2B rule
Two widespread misconceptions still trip up Belgian building SMEs:
- "I'll send a PDF by email as usual." For in-scope domestic Belgian B2B transactions, a PDF by email has not been a legally valid invoice since 1 January 2026. It remains fine for private homeowners (B2C).
- "My tool exports a UBL XML file, so I'll attach it to an email." Exporting an arbitrary XML file and emailing it is not the same as validated Peppol exchange. The file must pass EN 16931 / Peppol BIS Billing 3.0 schema and business-rule checks and be transmitted over the structured network (unless a documented fallback applies). Check exact scope rules in mandatory Peppol e-invoicing in Belgium and on the official Belgian B2B e-invoicing FAQ.
Note also what the official FAQ clarifies: a human-readable PDF is not legally mandatory alongside a UBL invoice, though embedding one inside the UBL makes approval much faster for project managers who check quantities visually.
How your software creates and sends a UBL invoice
You never open a text editor or type XML brackets yourself. In a proper construction invoicing tool, the workflow stays completely visual:
- Convert your approved quote, work order, or progress statement into an invoice as usual (check our full quote-to-invoice workflow).
- Verify the customer's KBO/BCE number, VAT treatment (
6%,21%, or0%reverse charge), and any purchase-order reference. - Click send: the software builds the UBL 2.1 XML, validates every mandatory Peppol BIS Billing 3.0 business rule before transmission, embeds the readable PDF copy, and dispatches it via a certified Peppol Access Point straight into your client's accounting system.
- Track delivery confirmation inside your invoicing list rather than wondering whether an email landed in spam.
For a practical walkthrough of connecting your company to the network, read Peppol e-invoicing step by step.
Five-point compliance check for construction UBL invoices
- Validate reverse-charge and 6% VAT mappings: Confirm your software outputs
AE+VATEX-EU-AEplus the 2023 1-month contestation wording for co-contractor bills, and accurateStax breakdowns for 6%/21% bills (see Belgian construction VAT rates and the FPS Finance VAT portal). - Test both an invoice and a credit note: Sending a clean UBL credit note (type
381) referencing the original invoice prevents month-end headaches when a progress bill needs correction. - Check incoming UBL supplier invoices too: Receiving wholesaler and subcontractor UBL files via Peppol eliminates manual purchase entry and protects against IBAN invoice fraud.
- Archive the structured XML for 10 years: FPS Finance requires retaining invoices and VAT accounting records for 10 years. Keep the original structured UBL document intact alongside a readable view — storing only a printed PDF does not preserve the legal original.
- Verify against official Belgian guidance: Keep einvoice.belgium.be bookmarked for profile updates and technical notices.
Generate validated Peppol BIS 3.0 UBL invoices straight from your construction quotes and progress bills without touching XML. Explore Enfin invoicing or view pricing.
Advance invoices and progress billing in Belgian construction
Structure Belgian construction advance invoices and progress bills cleanly: sample schedule, Breyne Act 5% cap, VAT timing and Book XIX rules.
A B2C contractor still needs to receive Belgian supplier invoices through Peppol
Understand why consumer-facing contractors still need structured supplier-invoice intake and organise the incoming construction-cost workflow.
Belgian reverse-charge VAT (co-contractor) for construction invoices
Check both legal tests before issuing a 0% Belgian co-contractor VAT invoice: immovable work, periodic VAT filers, the 2023 1-month clause and Peppol codes.