UBL is the standard file format for sending invoices electronically, so your clients can process them directly into their financial accounting software without manual work. This article explains what UBL is and how to set it up in Legalsense.
In this article
What UBL means
UBL stands for Universal Business Language (⧉ ubl.xml.org) and is the standard format for electronically sending invoices. It lets your client's financial accounting software process an invoice directly, without manual actions. A UBL invoice is prepared as an XML file; this article refers to that file simply as "UBL."
Before you start
To generate a correct XML file that meets the UBL standard, and that your client's financial accounting software can process without errors, make sure the following basic data is entered correctly and completely in your firm's Firm settings.
Firm settings page, showing the address and VAT number fields.
Enter your firm's address details completely in the relevant address fields, and enter your firm's VAT number. Legalsense includes this data as the sender in the UBL file, so your client's financial accounting software can recognize who sent the invoice.
Sending UBL with the invoice email
Legalsense can add the UBL file as an attachment to the invoice email, alongside the PDF version or instead of it. See the article ↪ Sending invoices by email from Legalsense for more information about sending invoices by email.
You set this up under Settings → Billing → Emails.
Email settings, showing the Use UBL attachments checkbox and the Invoice attachment list.
- Select Use UBL attachments to turn on the UBL options.
- In the Invoice attachment list, choose which files Legalsense attaches to the invoice email: - PDF: only the PDF version, without UBL. - PDF + XML in UBL: the PDF version and the UBL file. - XML in UBL: only the UBL file.
- Click Save.
This is the firm-wide default. You can choose a different attachment for a specific debtor, as described under Overriding UBL settings for a specific debtor below.
Downloading a UBL invoice
You can also download the UBL file of an invoice yourself, with the Download button on the invoice.
Invoice detail view, showing the Download button with the UBL invoice option.
When you click UBL invoice (XML), Legalsense downloads an XML file. You can then process this file outside Legalsense, for example by adding it as an attachment to an email in Outlook.
Including an embedded PDF
Under Settings → General → System, you can configure whether UBL output consists of XML only or also includes an embedded PDF. When you embed a PDF, you can also select which invoice template Legalsense uses to generate it. This is the firm-wide default, applied to every debtor unless you override it for a specific debtor, as described below.
Note: This setting only applies to UBL invoices created after you change it.
System settings, showing the UBL output options and invoice template selection.
Overriding UBL settings for a specific debtor
You can override the UBL settings for an individual debtor, so its invoices don't have to follow the firm-wide defaults, for example if that client's financial accounting software only accepts the UBL file, or expects a different embedded PDF layout. You set this on the debtor's own contact page, in the Debtor information section alongside its VAT number and other billing fields. See the article ↪ Contact management to learn more about the rest of that section.
Three fields there follow the firm-wide settings:
- Invoice attachment: which files Legalsense attaches to the invoice email (Settings → Billing → Emails).
- UBL output content: whether the UBL file includes an embedded PDF (Settings → General → System).
- PDF template for embedded invoice: which invoice template generates that PDF (Settings → General → System).
Each field is set to Use system default, so the debtor follows whichever firm-wide value is currently set. To override a field for this debtor only, clear Use system default and select an option.
Note: UBL output content and PDF template for embedded invoice only appear if Peppol is enabled. See the article ↪ Peppol to learn how to set this up.
Debtor information section on a contact's edit page, showing the Invoice attachment, UBL output content and PDF template for embedded invoice fields set to Use system default.
As with the firm-wide setting, a change to a debtor's UBL output content or PDF template only applies to UBL invoices for that debtor created after you make the change. Invoices Legalsense already generated keep the output and template that were in effect at the time.
Comments
0 comments
Please sign in to leave a comment.