Step 1: Entities
Registering a Company for Accesspoint Features
To utilize the Accesspoint features for a company and enable integrations such as Peppol , a one-time API-based registration call is required. This call will gather essential company information to create the account.
Example
Below is an example JSON body for the registration call:
POST Endpoint
- Endpoint:
Host + "/v1/einvoices/registrations"
For sandbox this is POST https://api.sandbox.billit.be/v1/einvoices/registrations
Example
f{
"TaxIdentifier" : "BE123456789",
"CompanyName" : "Tech Corp INC.",
"CommercialName" : "Tech Corp",
"TaxDeductable" : true,
"TaxLiable" : true,
"IBAN" : "BE1234567890",
"Mobile": "+32499999999",
"Email" : "[email protected]",
"ContactFirstName" : "John",
"ContactLastName" : "Doe",
"Language" : "EN",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Tav": "John Doe",
"Name": "Tech Corp",
"Street": "Tech Street",
"StreetNumber": "1",
"Box": "Floor 1",
"Zipcode": "1000",
"City": "Tech City",
"CountryCode": "BE",
"Phone": "+32499999999"
}
]
}
Retrieve Registered Entities and Integrations
To retrieve information about registered entities and their active integrations or networks, you can use a GET request to the following endpoint:
GET Endpoint
- Endpoint:
Host + "/v1/einvoices/registrations"
This GET request to the specified endpoint will provide a response containing details such as company data, active integrations, networks, and their respective status.
{
"Companies": [
{
"CompanyID": 12345678,
"CompanyDetails": {
"TaxIdentifier": "BE1234567890",
"CompanyName": "Tech Corp",
"Addresses": [],
"TaxDeductable": true,
"TaxLiable": true,
"Identifiers": []
},
"Integrations": []
},
{
"CompanyID": 987654,
"CompanyDetails": {
"TaxIdentifier": "BE1234567890",
"CompanyName": "Food Corp",
"Addresses": [],
"TaxDeductable": true,
"TaxLiable": true,
"Identifiers": []
},
"Integrations": [
{
"IntegrationID": 1234,
"Integration": "Peppol",
"IntegrationStatus": "Active",
"IntegrationStatusDescription": "",
"IntegrationDocumentToSign": ""
}
]
}
]
}
PATCH Endpoint
- Endpoint:
Host + "/v1/einvoices/registrations/{registrationID}"
This PATCH request to the specified endpoint will update the registration with only the specified values of the passed down object. Only the elements in the example below can be patched.
{
"CompanyName": "Tech Corp",
"CommercialName": "Tech Corp",
"TaxDeductable": null,
"TaxLiable": false,
"IBAN": "BE1234567890",
"Mobile": "+320499999999",
"Phone": "3224609999",
"Email": "[email protected]",
"ContactFirstName": "Jane",
"ContactLastName": "Doe",
"Language": "EN",
"Street": "Tech street",
"StreetNumber": "2",
"Box": "Floor 2",
"Zipcode": "1000",
"City": "Tech City",
"CountryCode": "BE"
}
Deactivate Endpoint
- Endpoint:
Host + "/v1/einvoices/registrations/{RegistrationID}"
You can deactivate an account by using the deactivate endpoint. Provide the ID in the URL and we will deactivate the account.
Example for sandbox : https://api.sandbox.billit.be/v1/einvoices/registrations/999999
Updated 22 days ago