Xero Accounting to Peppol BIS Billing 3.0 Integration & Schema Crosswalk
Why Native Xero Accounting Exports Fail Peppol BIS Billing 3.0 Validation
1. Xero's `InvoiceNumber` field lacks the mandatory scheme identifier (BT-1) required by PEPPOL-EN16931-R008; native exports omit the `cbc:ID` attribute `schemeID` and fail BR-02.
2. Xero's `Contact.TaxNumber` is a single field without country-specific scheme qualifiers (e.g., SIREN for France, Leitweg-ID for Germany), causing BR-CO-10 and BR-CO-15 failures when mapping to BT-31/BT-48.
3. Xero's `LineItems[].UnitAmount` uses decimal precision that can cause rounding discrepancies; without explicit rounding to 2 decimals and proper tax category mapping from `TaxType`, BR-S-08 and PEPPOL-EN16931-R020 validations fail.
Mandatory Xero Accounting to Peppol BIS Billing 3.0 Field Crosswalk Matrix
Deterministic attribute mapping from Xero Accounting payloads to EN 16931 Business Terms (BT) and UBL-2.1 XPaths.
| Xero Accounting Source Field | EN 16931 Business Term | Target UBL-2.1 XPath | Card. | Transformation & Normalization Rule | Schematron Rule |
|---|---|---|---|---|---|
| InvoiceNumber String, e.g., 'INV-2024-001' | BT-1 | /Invoice/cbc:ID | 1..1 | Trim whitespace; if empty, generate a fallback ID using 'XERO-' + InvoiceID; set schemeID attribute to 'XERO' if not provided. | PEPPOL-EN16931-R008 ↗ |
| Contact.TaxNumber String, e.g., 'FR12345678901' | BT-31 | /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID | 0..1 | Extract country prefix (first 2 chars) to determine schemeID (e.g., 'FR' for SIREN, 'DE' for Leitweg-ID); if no prefix, default to 'ISO6523-1' and validate against EAS list. | BR-CO-10 ↗ |
| LineItems[].UnitAmount Decimal, e.g., 100.00 | BT-131 | /Invoice/cac:InvoiceLine/cac:Price/cbc:PriceAmount | 1..1 | Round to 2 decimal places using half-up rounding; ensure currencyID attribute matches Invoice.CurrencyCode; if negative, set to 0 and flag error. | BR-S-08 ↗ |
| LineItems[].TaxType String, e.g., 'OUTPUT2' | BT-151 | /Invoice/cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:ID | 1..1 | Map Xero TaxType to EN16931 tax category code: 'OUTPUT2' -> 'S' (standard), 'ZERORATED' -> 'Z', 'EXEMPT' -> 'E'; if unknown, default to 'S' and log warning. | PEPPOL-EN16931-R020 ↗ |
Test Your Xero Accounting Peppol BIS Billing 3.0 XML Export Live
Validate your generated UBL-2.1 payload against EN 16931 & Peppol BIS Billing 3.0 rules directly in your browser.
Missing <cbc:CustomizationID> or value does not declare EN 16931 CIUS compliance.
Remediation: Insert <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>.
Found invalid or lowercase currency code "eur". Expected uppercase ISO 4217 (e.g. "EUR").
Remediation: Replace <cbc:DocumentCurrencyCode>eur</cbc:DocumentCurrencyCode> with uppercase "EUR".
Peppol Schematron forbids empty elements such as <cbc:AdditionalStreetName></cbc:AdditionalStreetName> serialized from null ERP fields.
Remediation: Strip empty <cbc:AdditionalStreetName> nodes prior to XML serialization.
Missing <cbc:EndpointID schemeID="..."> inside <cac:AccountingSupplierParty>/<cac:Party>.
Remediation: Add <cbc:EndpointID schemeID="9930">DE123456789</cbc:EndpointID> as the first child of Seller <cac:Party>.
Buyer <cbc:EndpointID> is either missing or lacks the mandatory EAS @schemeID attribute.
Remediation: Add schemeID="9930" (or "0088" for GLN / "0204" for Leitweg-ID) to Buyer <cbc:EndpointID>.
No <cbc:BuyerReference> (BT-10) found. Mandatory in XRechnung 3.0 (BR-DE-15) and required in Peppol BIS 3.0 (PEPPOL-EN16931-R003) when OrderReference is absent.
Remediation: Insert <cbc:BuyerReference>991-12849-74</cbc:BuyerReference> in the document header.
Mathematical discrepancy of 0.05 EUR between InvoiceLine sum (199.95) and LegalMonetaryTotal/LineExtensionAmount (200.00).
Remediation: Set cbc:LineExtensionAmount and cbc:TaxExclusiveAmount to 199.95.
TaxSubtotal/TaxableAmount reports 200.00, but Standard rated ("S") lines total 199.95.
Remediation: Recalculate BT-116 = 199.95, VAT BT-117 = 37.99, and PayableAmount BT-115 = 237.94.
Other ERP to E-Invoicing Compliance Bridges
Unlock Pro Batch XML / PDF Converter ($29/mo) →4 mandatory EN 16931 Business Term mappings
4 mandatory EN 16931 Business Term mappings
4 mandatory EN 16931 Business Term mappings
4 mandatory EN 16931 Business Term mappings