XRechnung Format
XRechnung is a German e-invoicing specification. This extension generates XRechnung XML and supports selecting the target XRechnung version (2.2 / 2.3 / 3.0).
Overview
| Property | Value |
|---|---|
| Version | 2.2 / 2.3 / 3.0 |
| Type | Pure XML |
| Region | Germany |
| Use Case | XRechnung XML export |
If you need strict B2G submission requirements (Leitweg-ID, routing portals, etc.), validate and enrich the generated XML in your integration layer.
Configuration
Enable XRechnung
Stores >Configuration > MageB2B > E-Invoice:
- Set Default B2B Format: XRechnung
- Set XRechnung Version as required
- (Recommended) Set Validation Level to Strict
Required Data
| Field | Required | Description |
|---|---|---|
| VAT ID | Yes | German VAT number |
| Tax Number | Yes | Steuernummer |
| Seller Contact Name/Phone/Email | Recommended | Required by some XRechnung rule sets (BR-DE-2) |
Generated Files
XRechnung produces pure XML (no PDF):
| File | Path Example |
|---|---|
| XML | pub/media/einvoice/invoice-100000001-xrechnung.xml |
Credit memo generation in this module also supports XRechnung (XML only).
Validation
XRechnung can be validated via the configured validation settings (and your receiver’s rule set).
Validation Levels
For XRechnung, Strict validation is recommended, especially if you integrate with external receivers that enforce additional business rules.
Submission Portals
This extension generates the XML. Submission (ZRE/OZG‑RE/Peppol/…) is handled separately.
Best Practices
- Select the required XRechnung version (2.2 / 2.3 / 3.0) per store view
- Use Strict validation when integrating with external receivers
- Keep seller contact data complete (name/phone/email)
- Validate the generated XML with your receiver’s ruleset
Troubleshooting
Validation Failed
Error: "XRechnung validation failed"
Solution:
- Check all required fields are filled
- Verify VAT ID format includes country code
- Ensure billing address is complete