Stripe to Peppol BIS Billing 3.0 Integration & Schema Crosswalk
Bridging Stripe Billing Webhooks (`invoice.finalized`) to Peppol BIS 3.0
Stripe Invoices store monetary amounts in minor currency units (cents/pennies as integers) and do not natively enforce Peppol Electronic Address Scheme (`EAS`) identifiers:
1. **Minor-Unit Conversion:** Divide `invoice.subtotal`, `invoice.tax`, and `lines.data[].amount` by `100` (for 2-decimal currencies) using fixed-point decimal arithmetic.
2. **Customer EndpointID (BT-49):** Map `customer.metadata.peppol_endpoint_id` and `customer.metadata.peppol_scheme_id` to `cac:AccountingCustomerParty/cac:Party/cbc:EndpointID`.
3. **Empty Node Prevention:** Do not serialize null `customer.address.line2` into `<cbc:AdditionalStreetName/>`, or `PEPPOL-EN16931-R008` will reject the payload.
Mandatory Stripe to Peppol BIS Billing 3.0 Field Crosswalk Matrix
Deterministic attribute mapping from Stripe payloads to EN 16931 Business Terms (BT) and UBL-2.1 XPaths.
| Stripe Source Field | EN 16931 Business Term | Target UBL-2.1 XPath | Card. | Transformation & Normalization Rule | Schematron Rule |
|---|---|---|---|---|---|
| invoice.number string ("B8192-0001") | BT-1 (Invoice ID) | /ubl:Invoice/cbc:ID | 1..1 | Direct string mapping; ensure finalized status | BR-01 ↗ |
| invoice.currency lowercase string ("eur") | BT-5 (Currency Code) | /ubl:Invoice/cbc:DocumentCurrencyCode | 1..1 | Convert to uppercase ISO 4217 ("EUR") | BR-CL-01 ↗ |
| customer.metadata.peppol_endpoint string ("0088:7300010000001") | BT-49 (Buyer EndpointID) | /ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cbc:EndpointID | 1..1 | Split prefix into @schemeID and value into node text | PEPPOL-EN16931-R010 ↗ |
| invoice.subtotal_excluding_tax integer (cents) | BT-106 / BT-109 | /ubl:Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount | 1..1 | Divide by 100 and format to 2 decimal places (.toFixed(2)) | BR-CO-10 ↗ |
Test Your Stripe 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