For each item in the request body, the endpoint will respond if it is allowed to submit a business case for a bill recipient with the provided ID. In addition to the provided ID, the response will always contain the billRecipientId, if a business case submission is allowed.
Dibito REST API (1.1)
The Dibito REST API provides services to submit, verify and deliver eBills. The API is designed to be used by biller integrations.
Product Website
https://www.dibito.chAPI Key
This API requires an API key to be passed in the `X-API-Key` header.Generate your API key in the Dibito application under "Dibito -> API Keys".
Further Informations
Consult our documentation for futher informations about creating and handling eBills.Download OpenAPI description
Overview
URL
Codeblock GmbH
Languages
Servers
Generated server url
https://app.dibito.ch/
Bodyapplication/jsonrequired
email address of the bill recipient
Example: "peter@muster.ch"
SIX ID of the bill recipient
Example: 41010560425610180
Swiss enterprise identification number (UID) without dashes, dots or extension. Note that this has to contain the swiss enterprise identification number (UID) from the commercial register (Handelsregister) which may be different from the VAT UID (Mehrwertsteuer UID).
Example: "CHE123456789"
- Generated server url
https://app.dibito.ch/api/v1/bill-recipients/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://app.dibito.ch/api/v1/bill-recipients/search \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY_HERE' \
-d '{
"items": [
{
"emailAddress": "peter@muster.ch",
"billRecipientSixId": 41010560425610180,
"enterpriseIdentificationNumber": "CHE123456789"
}
]
}'Search successfully executed
email address of the bill recipient
Example: "peter@muster.ch"
SIX ID of the bill recipient
Example: 41010560425610180
Swiss enterprise identification number (UID) without dashes, dots or extension. Note that this has to contain the swiss enterprise identification number (UID) from the commercial register (Handelsregister) which may be different from the VAT UID (Mehrwertsteuer UID).
Example: "CHE123456789"
Response
application/json
{ "items": [ { … } ] }
Request
Verify if a bill recipient is part of the eBill infrastructure by its billRecipientSixId. The call will return the billRecipientSixId if the bill recipient has been found in the eBill infrastructure. Receiving a billRecipientSixId does not necessary mean that the corresponding bill recipient is an active eBill user, it only means that this billRecipientSixId exists in the eBill infrastructure.
Security
X-API-Key
- Generated server url
https://app.dibito.ch/api/v1/bill-recipients/{billRecipientSixId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://app.dibito.ch/api/v1/bill-recipients/{billRecipientSixId}' \
-H 'X-API-Key: YOUR_API_KEY_HERE'Response
application/json
{ "billRecipientSixId": 41010560425610180 }