sevDesk to XRechnung 3.0 Integration & Schema Crosswalk
Why Native sevDesk Exports Fail XRechnung 3.0 Validation
1. sevDesk's `invoiceNumber` field is a free-text string without a mandatory scheme identifier; XRechnung 3.0 requires BT-1 to be paired with a scheme ID (e.g., `urn:oioubl:id:invoice-1.2` or a national scheme) via cbc:ID/@schemeID, which sevDesk does not provide, causing BR-01 and PEPPOL-EN16931-R008 failures.
2. sevDesk stores the Leitweg-ID in `customerInternalNote` as unstructured text, but XRechnung 3.0 mandates BT-10 as a dedicated element (cbc:BuyerReference) with a strict pattern (max 46 chars, no spaces); native exports omit this element entirely, triggering BR-DE-15.
3. sevDesk's `contact.vatNumber` is a single field that may contain either a VAT ID or a tax number without a scheme identifier; XRechnung 3.0 requires BT-31/BT-48 to be qualified with a scheme ID (e.g., `VA` for VAT, `FC` for tax number) via cbc:CompanyID/@schemeID, and missing or ambiguous scheme IDs cause BR-CO-9 and BR-CL-01 validation errors.
Mandatory sevDesk to XRechnung 3.0 Field Crosswalk Matrix
Deterministic attribute mapping from sevDesk payloads to EN 16931 Business Terms (BT) and UBL-2.1 XPaths.
| sevDesk Source Field | EN 16931 Business Term | Target UBL-2.1 XPath | Card. | Transformation & Normalization Rule | Schematron Rule |
|---|---|---|---|---|---|
| invoiceNumber String, e.g. "RE-2024-00123" | BT-1 | /Invoice/cbc:ID | 1..1 | Trim whitespace and truncate to 50 characters; if empty, generate a fallback ID using pattern 'SEV-' + current timestamp in milliseconds. Set @schemeID to 'urn:oioubl:id:invoice-1.2' (or a custom scheme ID agreed with the receiver) to satisfy scheme requirements. | BR-01 ↗ |
| customerInternalNote String, e.g. "Leitweg-ID: 1234567890-12345-67" | BT-10 | /Invoice/cbc:BuyerReference | 0..1 | Extract the Leitweg-ID using regex 'Leitweg-ID:\s*([^\s]+)' from the note; if not found, use the entire trimmed note. Remove all whitespace and truncate to 46 characters. If the result is empty, omit the element. | BR-DE-15 ↗ |
| contact.vatNumber String, e.g. "DE123456789" | BT-31 | /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID | 0..1 | Remove spaces and hyphens. If the value matches a VAT ID pattern (e.g., starts with 2-letter country code followed by alphanumerics), set @schemeID to 'VA'. Otherwise, if it matches a tax number pattern (e.g., digits only), set @schemeID to 'FC'. If no match, omit the element. | BR-CO-9 ↗ |
| invoicePos[].sumNet Number (decimal), e.g. 123.45 | BT-131 | /Invoice/cac:InvoiceLine/cbc:LineExtensionAmount | 1..n | For each invoice position, round sumNet to 2 decimal places using half-up rounding. Ensure the currencyID attribute is set to 'EUR'. Verify that the sum of all LineExtensionAmount equals the InvoiceLineNetTotal (BT-106) within 0.01 tolerance. | BR-CO-10 ↗ |
Test Your sevDesk XRechnung 3.0 XML Export Live
Validate your generated UBL-2.1 payload against EN 16931 & XRechnung 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