Magento 2 (Adobe Commerce) to Factur-X 1.07 (French Mandate) Integration & Schema Crosswalk
Why Native Magento 2 (Adobe Commerce) Exports Fail Factur-X 1.07 (French Mandate) Validation
1. Magento 2's `/V1/invoices` API does not expose a dedicated SIREN/SIRET field; `billing_address.vat_id` contains a VAT number (e.g., FR12345678901) but Factur-X requires BT-30 (Seller legal registration ID) and BT-47 (Buyer legal registration ID) as separate SIREN identifiers, causing BR-FR-01 failures.
2. Monetary amounts in Magento 2 are stored as floats (e.g., `row_total` = 100.005) and lack the mandatory 2-decimal rounding required by BR-CO-10 and BR-CO-15; native exports produce values like 100.005 which violate the decimal precision rules of CII-D16B.
3. Magento 2 does not provide a Leitweg-ID or EAS code for electronic routing; the `billing_address.vat_id` is not mapped to BT-34 (Seller electronic address) or BT-49 (Buyer electronic address) with schemeID, causing PEPPOL-EN16931-R020 and BR-DE-15 validation errors.
Mandatory Magento 2 (Adobe Commerce) to Factur-X 1.07 (French Mandate) Field Crosswalk Matrix
Deterministic attribute mapping from Magento 2 (Adobe Commerce) payloads to EN 16931 Business Terms (BT) and CII-D16B XPaths.
| Magento 2 (Adobe Commerce) Source Field | EN 16931 Business Term | Target CII-D16B XPath | Card. | Transformation & Normalization Rule | Schematron Rule |
|---|---|---|---|---|---|
| increment_id string, e.g. "INV-2024-0001" | BT-1 | /rsm:CrossIndustryInvoice/rsm:ExchangedDocument/ram:ID | 1..1 | Use the raw string value; ensure it is not empty and does not exceed 35 characters (truncate if necessary). | BR-01 ↗ |
| order_currency_code string, e.g. "EUR" | BT-5 | /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:InvoiceCurrencyCode | 1..1 | Map directly to ISO 4217 three-letter code; validate against allowed currency list (e.g., EUR, USD). | BR-02 ↗ |
| billing_address.vat_id string, e.g. "FR12345678901" | BT-31 | /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ram:SellerTradeParty/ram:SpecifiedTaxRegistration/ram:ID[@schemeID='VA'] | 0..1 | Extract the VAT number, remove spaces and hyphens, and ensure it starts with a valid country code (e.g., FR). Set schemeID to 'VA'. | BR-S-08 ↗ |
| items[].row_total float, e.g. 100.005 | BT-131 | /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeSettlementLineMonetarySummation/ram:LineTotalAmount | 1..1 | Round to 2 decimal places using half-up rounding (e.g., 100.005 -> 100.01) and format as a decimal string with exactly two digits after the decimal point. | BR-CO-10 ↗ |
Test Your Magento 2 (Adobe Commerce) Factur-X 1.07 (French Mandate) XML Export Live
Validate your generated CII-D16B payload against EN 16931 & Factur-X 1.07 (French Mandate) 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