ERechnung

At the end of March, the German Federal Council (Bundesrat) passed a new law that makes it mandatory for companies to receive electronic invoices. The receipt of electronic invoices will be mandatory for domestic B2B transactions from January 1, 2025. The sending of electronic invoices is also mandatory, but there are exceptions and transitional rules that apply.

In addition to being more environmentally friendly than paper invoices, e-invoicing offers many benefits to businesses. For example, e-invoices can be processed automatically for time and cost savings. Moreover, electronic invoices are easier to archive and retrieve than paper invoices.

Electronic invoices are also safer and more secure than paper invoices. They are protected from unauthorized access and cannot be lost or damaged in the mail. To ensure authenticity and integrity, electronic invoices can also be digitally signed.

Creating Electronic Invoices

Electronic invoices can be created in various formats, such as ZUGFeRD, XRechnung, and Factur-X. These formats are based on the XML standard and can be read and processed by machines. This makes it easier for companies to automate their invoicing processes and reduce the risk of errors.

TX Text Control provides all the basic technologies required to create these PDF documents, as it fully supports PDF/A-3b, the required format for electronic invoices.

XRechnung or ZUGFeRD?

XRechnung is a pure XML format for processing digital invoices. ZUGFeRD combines the human-readable PDF format with a machine-readable XML format. Since the release of ZUGFeRD version 2.1, both the XML resulting from XRechnung and the way the XML is integrated into a PDF file can be combined.

A sample application discussed in another article implements the XRechnung class, which holds all the data needed to create the invoice, and also uses the ZUGFeRD-csharp library to generate the necessary XML.

Learn More

This article shows how to create valid XRechnung and ZUGFeRD invoices with ASP.NET Core C#. The invoice is created with the help MailMerge component and the ZUGFeRD-csharp library.

Creating Valid XRechnung / ZUGFeRD Invoices with ASP.NET Core C#

The following C# code shows how to embed the ZUGFeRD XML in a document and export it to a PDF/A file:

string xmlZugferd = xRechnung.CreateXML(); // load Xml file string metaData = File.ReadAllText("metadata.xml");

TXTextControl.SaveSettings saveSettings = new TXTextControl.SaveSettings();

// create a new embedded file var zugferdInvoice = new TXTextControl.EmbeddedFile( "ZUGFeRD-invoice.xml", Encoding.UTF8.GetBytes(xmlZugferd), metaData);

zugferdInvoice.Description = "ZUGFeRD-invoice"; zugferdInvoice.Relationship = "Alternative"; zugferdInvoice.MIMEType = "application/xml"; zugferdInvoice.LastModificationDate = DateTime.Now;

// set the embedded files saveSettings.EmbeddedFiles = new TXTextControl.EmbeddedFile[] { zugferdInvoice }; A template is merged with the XRechnung object to generate the human readable version of the invoice.

using (TXTextControl.ServerTextControl tx = new TXTextControl.ServerTextControl()) { tx.Create(); // load the document tx.Load("template.tx", TXTextControl.StreamType.InternalUnicodeFormat);

// merge the data using (MailMerge mm = new MailMerge()) { mm.TextComponent = tx; mm.MergeObject(xRechnung); }

// save the document tx.Save("test.pdf", TXTextControl.StreamType.AdobePDFA, saveSettings); } Opening the created PDF document in Acrobat Reader displays the visual representation and embedded XML in the Attachments pane:

Extracting ZUGFeRD XML from PDF

TX Text Control provides a feature to extract attachments from PDF documents.

The following GetXmlAttachment method uses TX Text Control to load the PDF document using the &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; ServerTextControl Class &#9584; Load Method Loads text in a certain format. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Load method. The &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; LoadSaveSettingsBase Class &#9584; EmbeddedFiles Property Specifies an array of EmbeddedFile objects which will be embedded in the saved document. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Embedded Files property of the LoadSettings contains an array of &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; EmbeddedFile Class The EmbeddedFile class represents a file embedded in another document. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Embedded File objects after the PDF is loaded.

private string GetXmlAttachment(string Filename) {

using (TXTextControl.ServerTextControl tx = new TXTextControl.ServerTextControl()) { tx.Create();

// load documment LoadSettings ls = new TXTextControl.LoadSettings() { PDFImportSettings = PDFImportSettings.LoadEmbeddedFiles };

tx.Load(Filename, TXTextControl.StreamType.AdobePDF, ls);

// all attachments var embeddedFiles = ls.EmbeddedFiles;

// find the "alternative" xml representation foreach (EmbeddedFile embeddedFile in embeddedFiles) {

if (embeddedFile.Relationship == "Alternative" && embeddedFile.MIMEType == "text/xml") {

// return converted XML return Encoding.UTF8.GetString((byte[])embeddedFile.Data); }

}

return null; //something went wrong } } Each attachment is checked against the Relationship and MIMEType requirements to return the associated embedded XML document.

To extract the alternative XML invoice from a PDF/A-3b document, the above method can be called as in the code below:

var xml = GetXmlAttachment("facturx_invoice_pdfa3b_01.pdf"); Free Consulting

Do you have any questions about electronic invoicing or how to create electronic invoices with TX Text Control? Contact us for a free consultation. We are happy to help you with your project.

Contact Us

Conclusion

Electronic invoicing will become mandatory in Germany in 2025. Companies that are not yet prepared for this change should start planning now. TX Text Control provides all the necessary tools to create electronic invoices in various formats, such as ZUGFeRD and XRechnung. With TX Text Control, you can automate your invoicing processes and reduce the risk of errors.

TX Text Control .NET Server

DS Server

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

Blog

Core Technologies

Blog

Authors

Latest Posts

Support Resources

Documentation

Support

Getting Started

Other Resources

About Us

Industry events

Company

Contact

Newsletter

Legal

Sign in

Create account

Text Control Account

ERechnung

Post tagged with ERechnung in 2024

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

​

Latest Posts

​

Support

Getting Started

​

Other Resources

Company

Contact

Newsletter

Legal

Text Control Account

​

​

ERechnung

Post tagged with ERechnung in 2024 ​

April 2024

Post tagged with ERechnung in 2024