eBill business cases can be created in Dibito in two different ways:
- Direct upload of a PDF file via the Dibito web application
- Delivering a PDF file via e-mail
- Creation via the Dibito API
Dibito accepts the following formats:
- QR-bill with integrated eBill information or with an eBillRecipientId anywhere in the document
- A PDF A/3 document with an eBill XML file attached
- Any PDF document with the eBill information in JSON or XML format (only via API)
After submitting a business case, Dibito automatically starts the free validation of your data. View the current status of all business cases in the "Business cases" view. Read on for a detailed description of the possible statuses.
What are business cases?
eBill does not only recognize invoices, which is why it is generally referred to as business cases. Business cases are:
- Invoices
- Reminders / payment reminders
- Credit notes
- Notifications
- Installment payments
- Donation requests
How do I find the eBill identification of my contacts?
For private individuals, the eBill identification is the e-mail address. Please note that each private individual can only enter one e-mail address in the eBill portal. This e-mail address may not correspond to the contact's primary e-mail address.
For companies, it is the company identification number (UID). You can find the UID of every Swiss company in the federal UID register. (Example: CHE-428.851.403).
You can find out whether you can send an eBill invoice to a person or a company in the Dibito interface under the "Recipient" menu item. There you will also find the 17-digit recipient ID from the eBill portal. This remains constant, even if, for example, a private individual changes their e-mail address.
QR-bill with integrated eBill information
The QR-bill is a PDF document that contains the eBill information in a QR code. The eBill recipient information is contained in the "Alternative procedure" (AltPmt) field.
Example: eBill/B/hans.muster@example.org
Consult the official eBill documentation for more information.
Simply create test PDFs in Dibito under the menu item "Examples" or on the QR invoice generator from Codeblock.
QR-bill with eBillRecipientId anywhere in the document
If your software does not support the "Alternative procedure" field, you can place the eBill recipient directly in the document as a workaround. Dibito recognizes this text and inserts it as the recipient in the eBill business case.
Example: eBillRecipientId:hans.muster@example.org
Notes on formatting
- The new text "ebillRecipientId:..." can be placed anywhere on the page.
- The text together with the variable must be separated by a colon and must not contain any spaces.
- Capitalization is ignored.
PDF A/3 document with an eBill XML file attached
You can create any invoice documents in PDF A/3 format with an attachment in eBill XML format (eBill-SIX_v4.xml) and use them directly in Dibito. No further steps are necessary, all eBill information is transferred directly from the document.
Contact the manufacturer of your accounting system to find out whether this functionality is supported.
Open our sample PDF in Adobe Acrobat Reader and select "Attachments" from the tools on the right. Here you can download the attached XML file eBill-SIX_v4.xml with all billing information.
Any PDF document with the eBill information in JSON or XML format
If your accounting software does not have eBill functionality, Dibito can handle the conversion to PDF/A-3 format and the integration of eBill invoice information. In this case, use the Dibito API to transmit the invoice information in Dibito-specific JSON or XML format parallel to your document.