Creating your own UBL invoice
Do you wish to create an UBL invoice yourself? Read these 5 steps carefully.
Need help? Feel free to contact us!
1. Version of the UBL invoice
Before anything else, it's important to know that every European country has its own interpretation of the UBL invoice standard.
For example: in the Netherlands we work with the UBL of Simplerinvoicing, version 2.1 ("UBL-SI"). If you are Dutch company with customers outside of the Netherlands, there is little chance that your foreign customers can process a UBL-SI file. If this is the case, you can easily adjust the UBL format to the settings of that specific country (for example E-FFF for Belgium).
It is recommended to send the generic European UBL version to foreign customers, not UBL-SI. It doesn't matter if you are a Dutch, English, Swedish, German, Spanish or Danish country. All countries can apply this same method.
2. Tools for XML
UBL is a very complicated XML format. It's not recommended to build a DOM document yourself as it needs to be created element by element.
Use the XSD to generate the Java classes with xjc. instead. If you do not use Java, you can try to connect with XSD tools. XSD is the generic version, but can also be used for UBL-SI.
View this Excel file for an overview of which elements you should and should not use - and what these elements signify individually.
3. Know the destination of the UBL invoice
It's important to know the destination of the UBL invoice. UBL is a standard document, but there are still some dialects and interpretations within this standard. There are several things you need to take into account:
Embedding the PDF in the UBL.
The UBL invoice has the option to embed the PDF in Base64 format. Some accounting packages also expect this, as it's not possible to attach the PDF-file as a separate attachment.
Other packages, on the other hand, are not ready for an UBL that large. In that case they cannot process the UBL invoice at all. Sometimes the bookkeeping package processes the PDF from the UBL ánd from the mail, which leads to two PDFs with the booking proposal.
If the UBL and PDF are both attached to the email, make sure they have the same file nam. Only the extension should be different.
The subject of the email.
Accounting packages use the subject to route the invoice. For example, some packages indicate that it involves a purchase invoice by including "[INK]". As a result, the UBL invoice ends up in the right accounting spot.
Therefore, it's important to know the destination of the UBL invoice, so that this can be taken into account when generating the UBL and e-mail.
You can determine the destination of the UBL invoice by selecting the accounting package on your website to which the e-invoice will be sent.
4. Bounce Management
More and more customers are setting up a special email address to receive invoices. These emails end up directly in the customer's accounts - or not.
If there's a problem with the email or the UBL, the SMTP server will reject the mail and a hard 'sending failed' bounce will occur immediately. It's also a possibility that the accounting package does receive the mail, but cannot process it. The accounting package will then send a bounce mail to the MAIL FROM address of the SMTP envelope (soft bounce).
It's important to process both soft and hard bounces. This will prevent the invoice from appearing unpaid, as they never arrived.
Some accounting packages apply whitelisting to the MAIL FROM address of the SMTP envelope and / or to the address in the 'From: header' of the mail itself.
If you haven't agreed on a generic whitelisting with bookkeeping packages, it is important to point out to your customer(s) that whitelisting may be necessary. The customer then needs to set this up himself in the accounting package.
From PDF to UBL via Storecove
Eventually, a good UBL invoice requires quite some things. However, if you want to save yourself some trouble, you can also use Storecove for creating and sending UBL invoices.
With Storecove all incoming invoices are automatically converted from PDF to UBL, before they end up in your accounting package. You can also send e-invoices to companies, governments and municipalities (mandatory as of April 2019). The invoices are sent via the 100% secure Peppol network.
Do you wish to try it yourself? Click on the button below and try UBL invoicing for free.
Try UBL invoicing for free
More information about creating UBL invoices