Germany: VAT declaration in XML format creation without transferring to ELSTER - Dynamics 365 for Finance and Operations (AX 7.3)

Applies to: Microsoft Dynamics 365 for Finance and Operations, Enterprise edition


ELSTER is thestandard of tax administration in Germany. It provides various tools thatcompanies in Germany use for electronic financial reporting. For thedeclaration of value-added tax (VAT) returns, ELSTER provides endpoints to theopen interface of a web service. These endpoints were supported by MicrosoftDynamics 365 for Operations. However, ELSTER has announced that, asof January 1, 2019, the open interface for transferring data forsales tax returns will be closed by the German tax authorities.

Starting January 1, 2019, the ELSTER Rich Client (ERiC)interface must be used to transfer data for sales tax returns. For moreinformation about ERiC, see the Appendix ofthis document.

At the same time, if a company is registered in Germany,users can submit the VAT declaration via the web interface Mein ELSTER or byusing ElsterFormular.

Starting from the November 14, 2018 ELSTER open interface ofweb service will support the transfer of the data for VAT declaration withversion 11 of TransferHeader (TH) and user data header (NH). The previousversions TH (Version 8) and NH (Version 10) will no longer be accepted as ofthis date.


This hotfix provides changes in XML format according to thenew requirements for report submitting via the web interface or ERiC, andpossibility of saving of the generated XML.

Submission of a VAT declaration through the web interface orERiC requires the following adjustments to the XML format:

  • The <Elster> namespace must be changed.
  • The <Vorgang> tag must be reported with the “send-Auth” value.
  • The <Datei> block of fields must be reported.
  • The <TransferHeader> tag must be reported with the version=“11” attribute.

For Microsoft Dynamics 365 for Finance and Operations, theupdate will let users in Germany complete these tasks:

  • Preview the updated format by using the existing Preview tab in the Electronic tax declaration log form.
  • Save the VAT declaration in XML format from an attachment to a record in the Electronic tax declaration log form.
  • Manually update status of the “Electronic tax declaration log” record to Sent.


To prepare the Microsoft Dynamics 365 for Finance andOperations for generation of Germany VAT declaration in new XML format(with <TransferHeader> and <TransferHeader> of version “11”)the following steps must to be done:

  1. Download and import updated GER configurations: Elster (DE).version.3.4.xml.
  2. Download and install update packages according to the prerequisites in the GER configuration and documentation.

To set up new version of the format and use it for reportingstarting from the 14 November 2018 the following steps should be done:

  1. Don’t remove previously set up Elster (DE) format.
  2. Download new format from the LCS: Elster (DE).version.3.4.
  3. New version of the Elster (DE) format will appear in list of versions related to Elster (DE) in Electronic reporting module.
  4. Select version “3.4” of the Elster (DE) and check Effective from date for it. Update the Effective from date of the format you are going to use if needed.

Effective from dates parameter let system to determine in the run time which version of the format to be in use taking into account system date.

VAT declaration generation

To create a new VAT declaration report, open Tax > Declarations > Salestax > Report sales tax for settlement period select correspondingparameters on the dialog and click “OK”.

In the German sales tax report dialogmark Create electronic tax document check box as you didpreviously. You do not need to set up Style sheet for preview parameter.System will automatically define which style sheet to be used for which formatand apply it on Preview tab of the Electronic taxdeclaration log form. By “OK” button of the German sales taxreport dialog, a new line in the Tax > Declarations > Salestax > Electronic tax declaration log form will becreated.

The XML file is already generated basing on the criteriadefined in the German sales tax report dialog and generatedXML file is attached via Document management to the line in the Electronictax declaration log table. To review or save this file for furthersubmission (outside of the system), select the line in Electronic taxdeclaration log form and click on Document handling button in thebottom of the form:


Document handling form will be opened showing generatedfile. From this window you may open the file (via an application associatedwith .xml extension in your system):


Sent field is now available for manual marking.When marked a new line in the File transactions table iscreated. File transactions form shows which user and whencreated and marked the report as Sent. Once marked a report cannot be unmarked.

Open Preview tab of the Electronic tax declarationlog form to preview the reported values.


The Developers area of the ELSTER website provides examples that show how developers can interact with ERiC for the submission of VAT declaration in XML file format. Examples are provided for C++, C#, and Java. To access this area of the website, you must be registered as a developer. An example may help to create your own executable file to submit XML file using ERiC. You will need to download ERiC DLLs to submit XML file to ELSTER using executable file.

ERiC-Release 27 version is announced to be supported by ELSTER until the April 2019 and can be downloaded by the link.

See more information about ERiC releases.

Hotfix Information

How to obtain the Microsoft Dynamics AX updates files

This update is available for manual download andinstallation from LCS.


You must have one of the following products installed toapply this hotfix:

  • Microsoft Dynamics 365 for Operations

Restart requirement

You must restart the Application Object Server (AOS) serviceafter you apply the hotfix.

If you are encountering an issue downloading, installingthis hotfix, or have other technical support questions, contact your partneror, if enrolled in a support plan directly with Microsoft, you can contacttechnical support for MicrosoftDynamics and create a new support request.

You can also contact technical support for MicrosoftDynamics by phone using these links for country specific phone numbers. To dothis, visit one of the following Microsoft websites:

In special cases, charges that are ordinarily incurred forsupport calls may be canceled if a Technical Support Professional for MicrosoftDynamics and related products determines that a specific update will resolveyour problem. The usual support costs will apply to any additional supportquestions and issues that do not qualify for the specific update in question.

More Information

Note This is a "FAST PUBLISH" articlecreated directly from within the Microsoft support organization. Theinformation contained here is provided as-is in response to emerging issues. Asa result of the speed in making it available, the materials may include typographicalerrors and may be revised at any time without notice. See Terms of Use forother considerations.