EU VIDA · PEPPOL 3.0 · ZUGFERD 2.3 · XRECHNUNG · KSEF · FATTURAPA

E-Invoicing Schematron Studio & Batch ERP JSON Compiler

3 CREDITS
invoice.xmlUBL-2.1
DETECTED SOURCEShopify
BT-131 LINE SUM199.95 EUR
BT-106 HEADER200.00 EUR
SCHEMATRON: 7 FATAL, 1 WARN· 1ms
Peppol BIS Billing 3.0
BR-01An Invoice shall have a valid EN 16931 Specification identifier (BT-24)
Spec & Diff
xpath: /ubl:Invoice/cbc:CustomizationID

Missing <cbc:CustomizationID> or value does not declare EN 16931 CIUS compliance.

fix: Insert <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>.

BR-CL-01Document currency code (BT-5) MUST belong to ISO 4217 uppercase code list
Spec & Diff
xpath: /ubl:Invoice/cbc:DocumentCurrencyCode

Found invalid or lowercase currency code "eur". Expected uppercase ISO 4217 (e.g. "EUR").

fix: Replace <cbc:DocumentCurrencyCode>eur</cbc:DocumentCurrencyCode> with uppercase "EUR".

PEPPOL-EN16931-R008Document MUST NOT contain empty XML elements (found 1: <cbc:AdditionalStreetName>)
Spec & Diff
xpath: //cbc:AdditionalStreetName[not(node())]

Peppol Schematron forbids empty elements such as <cbc:AdditionalStreetName></cbc:AdditionalStreetName> serialized from null ERP fields.

fix: Strip empty <cbc:AdditionalStreetName> nodes prior to XML serialization.

PEPPOL-EN16931-R020Seller electronic address (BT-34) MUST be provided with a valid EAS @schemeID
Spec & Diff
xpath: /ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID

Missing <cbc:EndpointID schemeID="..."> inside <cac:AccountingSupplierParty>/<cac:Party>.

fix: Add <cbc:EndpointID schemeID="9930">DE123456789</cbc:EndpointID> as the first child of Seller <cac:Party>.

PEPPOL-EN16931-R010Buyer electronic address (BT-49) MUST include a valid EAS @schemeID attribute
Spec & Diff
xpath: /ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cbc:EndpointID

Buyer <cbc:EndpointID> is either missing or lacks the mandatory EAS @schemeID attribute.

fix: Add schemeID="9930" (or "0088" for GLN / "0204" for Leitweg-ID) to Buyer <cbc:EndpointID>.

BR-DE-15Buyer reference / Leitweg-ID (BT-10) is missing
Spec & Diff
xpath: /ubl:Invoice/cbc:BuyerReference

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.

fix: Insert <cbc:BuyerReference>991-12849-74</cbc:BuyerReference> in the document header.

BR-CO-10Sum of Invoice line net amount (BT-106 = 200.00) != sum of lines (BT-131 = 199.95)
Spec & Diff
xpath: /ubl:Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount

Mathematical discrepancy of 0.05 EUR between InvoiceLine sum (199.95) and LegalMonetaryTotal/LineExtensionAmount (200.00).

fix: Set cbc:LineExtensionAmount and cbc:TaxExclusiveAmount to 199.95.

BR-S-08Standard rate VAT TaxableAmount (BT-116 = 200.00) does not match S-rated lines (199.95)
Spec & Diff
xpath: /ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmount

TaxSubtotal/TaxableAmount reports 200.00, but Standard rated ("S") lines total 199.95.

fix: Recalculate BT-116 = 199.95, VAT BT-117 = 37.99, and PayableAmount BT-115 = 237.94.

Automate Shopify → Peppol BIS Billing 3.0 AP Delivery

Deploy certified Peppol Access Point & ZUGFeRD ERP connector

CIUS:
Rule CodeSeveritySyntaxAssertion SpecificationAction
BE-PEPPOL-R001-KBOfatalBE · UBL-2.1Belgian B2B Peppol invoices MUST provide a 10-digit CBE/KBO Enterprise Number in cbc:EndpointID with @schemeID="0208"/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cbc:EndpointID[@schemeID="0208"]XML Diff
BR-01fatalEU · UBL-2.1An Invoice shall have a Specification identifier (BT-24)/ubl:Invoice/cbc:CustomizationIDXML Diff
BR-02fatalEU · UBL-2.1An Invoice shall have an Invoice number (BT-1)./ubl:Invoice | /cn:CreditNoteXML Diff
BR-CO-10fatalEU · UBL-2.1Sum of Invoice line net amount (BT-106) must equal sum of all line net amounts (BT-131)/ubl:Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmountXML Diff
BR-CO-13fatalEU · UBL-2.1Invoice total amount without VAT (BT-109) = Σ Invoice line net amount (BT-131) - Sum of allowances on document level (BT-107) + Sum of charges on document level (BT-108).cac:LegalMonetaryTotalXML Diff
BR-CO-15fatalDE · CII-D16BInvoice total amount with VAT (BT-112) must equal Tax exclusive amount (BT-109) + VAT total (BT-110)/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:GrandTotalAmountXML Diff
BR-CO-16fatalEU · UBL-2.1Amount due for payment (BT-115) = Invoice total amount with VAT (BT-112) -Paid amount (BT-113) +Rounding amount (BT-114).cac:LegalMonetaryTotalXML Diff
BR-DE-15fatalDE · UBL-2.1Buyer reference / Leitweg-ID (BT-10) is strictly mandatory in XRechnung/ubl:Invoice/cbc:BuyerReferenceXML Diff
BR-FR-01fatalFR · CII-D16BFrench Seller SIREN/SIRET identifier (BT-30) with schemeID 0002 is mandatory for Factur-X/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ram:SellerTradeParty/ram:SpecifiedLegalOrganization/ram:IDXML Diff
BR-S-08fatalEU · UBL-2.1Standard rate VAT category taxable amount (BT-116) must match sum of Standard rate lines/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal[cac:TaxCategory/cbc:ID="S"]/cbc:TaxableAmountXML Diff
BR-S-09fatalEU · UBL-2.1round((abs(xs:decimal(../cbc:TaxableAmount)) * (xs:decimal(cbc:Percent) div 100)) * 10 * 10) div 100 )">[BR-S-09]-The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT category code (BT-118) is "Standard rated" shall equal the VAT category taxable amount (BT-116) multiplied by the VAT category rate (BT-119)./*/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory[normalize-space(cbc:ID) = 'S'][cac:TaxScheme/normalize-space(upper-case(cbc:ID))='VAT']XML Diff
DE-R-001fatalEU · UBL-2.1If both supplier and customer are located in Germany, an invoice shall contain information on "PAYMENT INSTRUCTIONS" (BG-16).(/ubl-invoice:Invoice | /ubl-creditnote:CreditNote)[$supplierCountryIsDE and $customerCountryIsDE]XML Diff
DE-R-002fatalEU · UBL-2.1If both supplier and customer are located in Germany, the group "SELLER CONTACT" (BG-6) shall be provided.(/ubl-invoice:Invoice/cac:AccountingSupplierParty | /ubl-creditnote:CreditNote/cac:AccountingSupplierParty)[$supplierCountryIsDE and $customerCountryIsDE]XML Diff
DE-R-015fatalEU · UBL-2.1If both supplier and customer are located in Germany, the element "Buyer reference" (BT-10) shall be provided.(/ubl-invoice:Invoice | /ubl-creditnote:CreditNote)[$supplierCountryIsDE and $customerCountryIsDE]XML Diff
DE-R-016fatalEU · UBL-2.1If both supplier and customer are located in Germany, and if one of the VAT codes S, Z, E, AE, K, G, L, or M is used, an invoice shall contain at least one of the following elements: "Seller VAT identifier" (BT-31) or "Seller tax registration identifier" (BT-32) or "SELLER TAX REPRESENTATIVE PARTY" (BG-11).(/ubl-invoice:Invoice | /ubl-creditnote:CreditNote)[$supplierCountryIsDE and $customerCountryIsDE]XML Diff
DE-R-017warningEU · UBL-2.1If both supplier and customer are located in Germany, the element "Invoice type code" (BT-3) should only contain the following values from code list UNTDID 1001: 326 (Partial invoice), 380 (Commercial invoice), 384 (Corrected invoice), 389 (Self-billed invoice), 381 (Credit note), 875 (Partial construction invoice), 876 (Partial final construction invoice), 877 (Final construction invoice).(/ubl-invoice:Invoice | /ubl-creditnote:CreditNote)[$supplierCountryIsDE and $customerCountryIsDE]XML Diff
DE-R-018fatalEU · UBL-2.1If both supplier and customer are located in Germany, information on cash discounts for prompt payment (Skonto) shall be provided within the element "Payment terms" BT-20 in the following way: First segment "SKONTO", second segment amount of days ("TAGE=N"), third segment percentage ("PROZENT=N"). Percentage must be separated by dot with two decimal places. In case the base value of the invoiced amount is not provided in BT-115 but as a partial amount, the base value shall be provided as fourth segment "BASISBETRAG=N" as semantic data type amount. Each entry shall start with a #, the segments must be separated by # and a row shall end with a #. A complete statement on cash discount for prompt payment shall end with a XML-conformant line break. All statements on cash discount for prompt payment shall be given in capital letters. Additional whitespaces (blanks, tabulators or line breaks) are not allowed. Other characters or texts than defined above are not allowed.(/ubl-invoice:Invoice | /ubl-creditnote:CreditNote)[$supplierCountryIsDE and $customerCountryIsDE]XML Diff
DK-R-002fatalEU · UBL-2.1Danish suppliers MUST provide legal entity (CVR-number)ubl-creditnote:CreditNote[$DKSupplierCountry = 'DK'] | ubl-invoice:Invoice[$DKSupplierCountry = 'DK']XML Diff
FATTURAPA-IT-00311fatalIT · UBL-2.1SdI Error 00311: Invalid CodiceDestinatario (must be 7 uppercase alphanumeric characters or 0000000 with PEC)/p:FatturaElettronica/FatturaElettronicaHeader/DatiTrasmissione/CodiceDestinatarioXML Diff
FATTURAPA-IT-00404fatalIT · UBL-2.1SdI Error 00404: Duplicate invoice number and date combination already registered in Sistema di Interscambio/p:FatturaElettronica/FatturaElettronicaBody/DatiGenerali/DatiGeneraliDocumento/NumeroXML Diff
IT-R-001fatalEU · UBL-2.1BT-32 (Seller tax registration identifier) - For Italian suppliers BT-32 minimum length 11 and maximum length shall be 16. Per i fornitori italiani il BT-32 deve avere una lunghezza tra 11 e 16 carattericac:AccountingSupplierParty/cac:Party[$supplierCountry = 'IT']/cac:PartyTaxScheme[normalize-space(cac:TaxScheme/cbc:ID) != 'VAT']XML Diff
IT-R-002fatalEU · UBL-2.1BT-35 (Seller address line 1) - Italian suppliers MUST provide the postal address line 1 - I fornitori italiani devono indicare l'indirizzo postale.cac:AccountingSupplierParty/cac:Party[$supplierCountry = 'IT']XML Diff
KSEF-PL-NIP-01fatalPL · FA-2-XMLPolish Seller NIP (Podmiot1/DaneIdentyfikacyjne/NIP) must be an exact 10-digit tax identifier without PL prefix/Faktura/Podmiot1/DaneIdentyfikacyjne/NIPXML Diff
KSEF-PL-P1-DATEfatalPL · FA-2-XMLKSeF Invoice Issue Date (Fa/P_1) must conform to YYYY-MM-DD and cannot exceed session submission timestamp/Faktura/Fa/P_1XML Diff
KSEF-PL-P15-SUMfatalPL · FA-2-XMLKSeF Total Gross Amount Due (Fa/P_15) must equal sum of net rate buckets (P_13_1..P_13_7) plus VAT (P_14_1..P_14_5)/Faktura/Fa/P_15XML Diff
Showing 25 of 60 loaded (1156 total in DB)
PUBLISHED ON NPMJS.COM

CI/CD CLI Validator & Webhook Normalization API

Execute npx invoicespec-cli invoice.xml in your pipeline or POST Stripe & Shopify webhooks to /api/v1/normalize.

terminal — node.js cli & rest webhook compiler npm: invoicespec-cli@1.0.0 ↗
# 1. Local CI/CD Schematron check (Published on npm)
$ npx invoicespec-cli ./invoice.xml

# 2. Compile Stripe Invoice JSON -> Peppol BIS 3.0 UBL 2.1 XML
$ curl -X POST https://invoicespec-hub.pages.dev/api/v1/normalize \
  -H "Content-Type: application/json" \
  -d '{"action":"convert_json","target_format":"peppol-ubl","erp_json":{"object":"invoice","number":"INV-2026-01","currency":"eur"}}'