Peppol & VAT (Intervat)
How to get “API Key” from Portal?
To obtain the API key used with /auth/login, navigate to Settings → ERP Management → API Management in the Portal and use Generate. See also Authentication.
Belgium — Peppol & VAT (Intervat)
Belgium uses Peppol BIS Billing 3.0 for e-invoicing (PEPPOL_BIS). Docnova also supports CBE company lookup, SMP migration keys for Peppol onboarding, and Intervat VAT declaration XML generation.
Supported invoiceType
| Value | Description |
|---|---|
| PEPPOL_BIS | Peppol BIS Billing 3.0 (Belgium) |
Get company info by VAT GET
Purpose of use: Look up company data from the CBE (Crossroads Bank for Enterprises) using a Belgian VAT number.
Endpoint Information
| Property | Value |
|---|---|
| URL | /company/BE/get-company-info |
| Method | GET |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| vatNumber | String | Yes | Belgian VAT, e.g. BE0123456789 |
Example response
{
"companyName": "Example BV",
"vatNumber": "BE0123456789",
"address": "Street 1, 1000 Brussels",
"enterpriseNumber": "0123456789"
}
Get Peppol SMP migration key GET
Purpose of use: Obtain the migration key when moving a participant to a new SMP (Service Metadata Publisher) on Peppol.
Endpoint Information
| Property | Value |
|---|---|
| URL | /company/BE/get-migration-key |
| Method | GET |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| companyId | UUID | Yes | Company ID |
Create VAT declaration XML (Intervat) POST
Purpose of use: Generate Intervat-compatible VAT declaration XML from structured declaration data.
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/BE/create-vat-declaration-xml |
| Method | POST |
| Content-Type | application/json |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Request body: JSON matching your Intervat period and box fields (structure as agreed with Docnova / your integration spec).
Response: XML string or document reference suitable for upload to Intervat.