› Reference › Supported input file formats › UBL (XRechnung) field mapping › UBL XML invoice rendering preferences

UBL XML invoice rendering preferences

If you process UBL XML invoices, you can choose whether to view an invoice image rendered from the XML data using the AP Essentials template or the official xRechnung visualization stylesheet.

The Render UBL XML invoices (XRechnung) using the official stylesheet setting controls how Tungsten AP Essentials displays and exports UBL invoices. This setting only affects UBL XML invoices in XRechnung format. If this setting is enabled, the invoice image is rendered using the official stylesheet. If this setting is disabled, the AP Essentials template is used to generate the invoice image.

The XML data is always used for data extraction and field interpretation, regardless of this setting. This setting only determines which image is displayed in AP Essentials Office and what is exported to PDF or TIFF.

When the setting is disabled

When this setting is disabled, the invoice image is generated using the AP Essentials template and displayed in AP Essentials Office and used for PDF or TIFF exports.

When the setting is enabled

When this setting is enabled, the invoice image is rendered from the XML using the official xRechnung visualization stylesheet and displayed in AP Essentials Office and used for PDF or TIFF exports.

The rendered invoice image includes a disclaimer stating that the image is software-generated from the XML data. This disclaimer is part of the official xRechnung visualization stylesheet.

Benefits

This setting lets you choose between two rendering approaches:

Using the AP Essentials template
Provides a standardized layout for all UBL XRechnung invoices.
Using the official xRechnung visualization stylesheet

Provides the following benefits:

  • Ensures the displayed image matches the authoritative invoice data in the XML.
  • Provides consistent formatting across different invoice formats.
  • Ensures all data from the XML is visually represented.
  • Better for automated processing.
  • Meets legal requirements in some countries (such as Germany) to display the XML data.

Rendered invoice image

When this setting is enabled, Tungsten AP Essentials uses the official xRechnung visualization stylesheet to render the invoice image from the XML data. This stylesheet is maintained by KoSIT (Coordination Office for IT Standards) and is the standard visualization tool for xRechnung invoices in Germany.

The xRechnung visualization stylesheet transforms the structured XML invoice data into a human-readable PDF format. The rendered image displays all invoice information in a standardized layout, including:

  • Invoice header information (invoice number, date, supplier, and buyer details)
  • Line items with descriptions, quantities, and prices
  • Tax calculations and totals
  • Payment terms and banking information
  • Any additional notes or references

The rendered image includes a disclaimer at the top stating that the document is software-generated from the XML data.

The invoice rendered from XML can span several pages.

Attachments

When this setting is enabled and Storage service is enabled, all embedded attachments are extracted and appear in the Attachments tab.