Create a DATEV XML package

Select XML when the receiving workflow expects DATEV document packages rather than only an EXTF booking CSV. Confirm the schema and package type with the recipient first.

Configuration

Under XML Export Settings, choose a supported schema, enable XSD validation, and select a package mode. The generator writes all XML files in UTF-8.

Extended XML package

The ZIP contains:

  • document.xml as the archive manifest
  • individual document XML files under documents/
  • PDFs under pdfs/ when requested

The manifest references the individual document data and linked PDF.

DATEV transfer-compatible package

The ZIP contains document.xml and linked PDFs at the ZIP root. Each PDF uses the persistent transfer identifier referenced by document.xml. Depending on the selected schema, this is a GUID or the corresponding v05 document identifier. Invoice and credit memo PDFs therefore do not use generic names such as invoice_<ID>.pdf or creditmemo_<ID>.pdf in this package.

Choose this mode only when the recipient expects that layout.

Keep XML and CSV separate

Selecting Both (CSV + XML) creates two archives. The accounting-data archive contains the EXTF booking CSV and, when selected, customer master data. The XML document archive contains only the XML package files and its linked PDFs.

An XML-only export with customer master data also keeps the files separate. Magento provides one master-data ZIP and one XML document ZIP. Uploading the two formats separately prevents the XML package from being handled as a standard CSV archive.

XML mapping

Invoice and credit memo XML mappings are separate JSON objects. Keys identify XML fields and values use the same expression language as CSV mappings. The selected schema affects the generated namespaces and supported ledger structure, so do not copy a mapping between schema choices without testing it.

Validation

When Validate XML against XSD is enabled, the extension validates the manifest and any generated document XML files. A validation error stops the export. Keep validation enabled for go-live tests and resolve the reported field or structure instead of treating the switch as a compatibility fix.

Files on the server

The generator writes its working files under var/export/datev/. Archive names follow DATEV_XML_<type>_<from>_<to>.zip. Extended-package document XML files use the invoice or credit memo number. In a transfer-compatible package, the PDF filename matches the identifier stored in document.xml.