Polishing xRechnung and ZUGFeRD in Business Central

In the last few weeks, I’ve spent quite some time in the German e-invoicing corner of Business Central – specifically around the xRechnung and ZUGFeRD formats that Microsoft ships on top of the E-Documents framework.

These formats are strategically important. With B2B e-invoicing becoming mandatory in Germany in phases from 2025 onwards, and formats like xRechnung and ZUGFeRD explicitly listed as compliant EN 16931 syntaxes, quality matters a lot more than “it usually works”.

The good news: Microsoft has done the heavy lifting by delivering standard apps for xRechnung and ZUGFeRD in Business Central.

The less good news: in real-world usage, a number of small but important issues show up – things that make validators unhappy, confuse users, or simply get in the way of partners rolling this out at scale.

So I decided to help polish these modules by opening issues (and preparing pull requests) in the ALAppExtensions and BCApps GitHub repos. Below is a short overview of what I’ve been working on and why it matters.

---

What has been fixed / worked on so far

• Buyer Reference check – Limit Buyer Reference mandatory validation to sales e-documents so posting purchase documents no longer throws “Customer does not exist”.
  → #29257, #29294 – included in BC27.2
  → Follow-up: the original fix introduced a new bug, tracked in #29423. – included in BC27.2
• Invoice discount precision – Keep full discount % precision in xRechnung XML so totals match Business Central and pass validators.
  → #29253 prepared for next major, yet to be backported to BC27.x
• Mandatory customer data – Catch missing mandatory customer data before posting avoiding invalid xRechnung file.
  → #29264 – included in BC27.1
• Better extensibility – Add hooks / IsHandled so partners and ISVs can override line mapping and add extra fields in xRechnung / ZUGFeRD without forking the whole implementation.
  → #29314 – included in BC27.1
• ZUGFeRD file type – Fix the case where a valid ZUGFeRD PDF was sent with a .xml extension and the wrong MIME type.
  → BCApps #5220 – prepared for next major, yet to be backported to BC27.x
• “Embed PDF in export” flag – Make the flag actually embed the PDF for xRechnung.
  → #29414 – prepared for next major, yet to be backported to BC27.x
• Customer email in ZUGFeRD – Export customer email into the correct ZUGFeRD XML node to satisfy popular validators.
  → #29420 – prepared for next major, yet to be backported to BC27.x
• Update 18.11.2025, Fixed by Kilian@Prisma Informatik GmbH:
  ZUGFeRD Export for custom reports – Enabling ZUGFeRD export for custom reports.
  → #29255 – included in BC27.2
• Update 21.12.2025, Fixed by Kilian@Prisma Informatik GmbH:
  Use Responsibility Center address + Salesperson as contact in ZUGFeRD/xRechnung export (same sourcing as Peppol).
  → #29482 – prepared for next major, yet to be backported to BC27.x

---

Status – where we are now

All of the topics above are backed by GitHub issues in the ALAppExtensions and BCApps repos, and for most of them I’ve already prepared or am preparing pull requests with concrete fixes.

Some changes are still under discussion, some are already accepted, and others are waiting in Microsoft’s internal pipeline. In other words: the groundwork is there, but the final word on shipping dates and exact releases is, of course, up to Microsoft.

My goal with these contributions is simple: close the gap between “it works in a demo” and “it survives real German e-invoicing projects, validators, and auditors.”

---

How to set up xRechnung or ZUGFeRD in Business Central

If you haven’t touched the E-Documents framework yet, the basic setup for xRechnung and ZUGFeRD follows the same pattern. The German localization supports XRechnung (UBL), PEPPOL BIS 30 DE and ZUGFeRD through the E-Document framework. (Electronic invoicing in Germany)

Below is a “short version” of the steps I usually go through.

1. Prerequisites

• Use a German company / localization.
• Make sure the E-Documents apps for Germany (E-Document Core + E-Documents for Germany) are installed.

2. Create an E-Document Service for selected format

1. Go to E-Document Services (Tell me → E-Document Services). (Set up e-documents)
2. Choose New and fill in:

• Code / Description – e.g. XRECHNUNG or ZUGFERD.
• Document Format – choose XRechnung or ZUGFeRD.
• Service Integration – None

• On the Export FastTab turn on Buyer Reference Mandatory and choose where it comes from (Your Reference or Customer Reference) according to your customers’ requirements. (Use buyer reference on the E-invoice)

3. Configure the E-Document workflow

1. Go to Workflow Templates, reset Microsoft templates if needed, and look for E-Document Workflow templates.
2. Create a new workflow from the template (Send to one service).
3. On the workflow lines:
   • In Then Response, choose Send E-Document using setup and point it to the correct E-Document Service (xRechnung or ZUGFeRD).
4. Enable the workflow.

4. Set up a Document Sending Profile

1. Go to Document Sending Profiles.
2. Create (for example) EDOC_XRECHNUNG or EDOC_ZUGFERD.
3. On Sending Options:
   • Set Electronic Document to Extended E-Document Service Flow.
   • Pick the E-Document Workflow you have created in the previous step.
   • Enable Email and set E-Mail Attachment to E-Document or PDF & E-Document if you want to email the XML/PDF as well.
4. Set one of these sending profiles as Default or assign them per customer on the Customer card.

5. Test the setup

1. Create a Sales Invoice for a customer that uses your new sending profile.
2. Post it, then choose Post and Send.
3. Business Central should:
   • Create an E-Document for the invoice.
   • Run E-Mail Editor and attach xRechnung XML or a ZUGFeRD PDF with embedded XML
4. Later, you can open the posted invoice → Related → E-Document → Open to inspect the E-Document log and download the file for your validator.

Call to action – please try xRechnung & ZUGFeRD

If you’re a partner, ISV, or customer working with German e-invoicing, I’d really like to invite you to:

• Set up a sandbox with the German localization and enable E-Documents with xRechnung and/or ZUGFeRD.
• Run your real-world scenarios through it – discounts, master data edge cases, different validators, subscription scenarios, and so on.
• When you see something odd:
  • open an issue in the relevant GitHub repo (ALAppExtensions or BCApps), and
  • feel free to reference any of the issues I listed above so we can connect the dots.

The more feedback we feed back into the standard apps now, the smoother life will be for everyone once B2B e-invoicing is simply “how we do invoices.”