UBL, CII or ZUGFeRD

CIUS Support

The API supports the following CIUS (Core Invoice Usage Specification):

• XRechnung (Germany - 🇩🇪)
• PEPPOL BIS Billing 3.0 (Belgium - 🇧🇪)

It is possible to send UBL.BE (Belgium - 🇧🇪) invoices to the /v1/json/ubl endpoint. However, we recommend you to use PEPPOL BIS Billing 3.0 instead.

We're currently working on supporting more countries / CIUS specifications. If you have any requests please get in touch!

To generate UBL invoices for a specific CIUS, set the X-FINAX-CIUS HTTP header accordingly.

Germany 🇩🇪

To generate XRechnung compliant UBL invoices, there is no need to set the X-FINAX-CIUS header, as XRechnung is the default CIUS for UBL invoices.

XRechnung - CII or UBL

There is no official recommendation which format to use (CII or UBL) in Germany. Both formats are supported by the API and generally accepted.

In case you want to generate ZUGFeRD invoices through /v1/pdf/merge make sure to use CII format to generate the embedded XML.

Belgium 🇧🇪

To generate PEPPOL BIS Billing 3.0 compliant UBL invoices, set the X-FINAX-CIUS HTTP header to PEPPOL BIS Billing 3.0.

There is no support to generate UBL.BE invoices through the API, since PEPPOL BIS Billing 3.0 is the recommended format in Belgium.