/
XML_UBL

XML_UBL

Dec 22, 2025

Overview

The module provides support for XML/UBL 2.0/2.1/2.2 invoices export. It requires PHP 7.4 or higher.
Warning: This is initial implementation, please verify exported files with your accountant

Activating the module

  1. The plugin is free and available to all HostBill users. In order to activate the plugin go to Settings→ Modules→ Plugins → Inactive, find and activate UBL Invoices plugin.

  2. Once the plugin is activated you will be directed to Settings→ Modules→ Plugins to configure the module.

Module configuration

Fill in the standard configuration fields:

  1. Choose module display name

  2. Select if you want the plugin to be accessible for all staff members or only selected staff members

Configure UBL settings:

  1. UBL Version - select UBL document version, from 2.0, 2.1, 2.2

  2. Country - select your company's country from the dropdown list

  3. Company Name - your company name

  4. Tax ID - your company Tax ID

  5. Legal ID - your company legal registration number

  6. Street - your company street address

  7. Building number - your company building number

  8. City - your company city

  9. Postal Code - your company post code

  10. Bank/Sepa: IBAN - if the payment method is sepa dd or bank transfer, this number will be used in Payee Financial Account

  11. Bank/Sepa: account name - if the payment method is sepa dd or bank transfer, this number will be used in Payee Financial Account

  12. Invoice item: Unit code - entry item unit code appearing on exported invoice, default to C62

  13. VAT Registration field - client registration field name, used for storing customer VAT number

  14. Auto-validate - auto-validate each newly generated XML invoice. Use for testing only as it will significantly slow down xml generation.

  15. Attach PDF file - once enabled HostBill-generaed PDF invoice file will be attached to UBL/XML file

  16. Use issue date - once enabled HostBill's invoice creation date would be used even for paid invoices

  17. Add due date - once enabled due date information will be added to generated XML - note that it may break some UBL validators

  18. Use Peppol format - once enabled genreated document will use UBL 2.1 with peppol customization

  19. Peppol EndpointID Scheme - when peppol format is used enter your  endpoint scheme id - ie for Belgium's peppol its 0208

  20. Peppol: Buyer EndpointID Scheme: - when peppol format is used enter buyer's  endpoint scheme id - ie for Belgium's peppol its 9925