Submit register request
Register a company on the Peppol network using its business identifier.
Endpoint
| Property | Value |
|---|---|
| URL | POST /white-label-partner/register-request |
| Method | POST |
| Auth | R-Auth: <partner-jwt> |
| Content-Type | application/json |
| Base URL | Stage Environment https://api-fr-stage.docnova.ai/ Production Environment https://api-fr.docnova.ai/ |
Example Request
curl --location '{{baseUrl}}/white-label-partner/register-request' \
--header 'Content-Type: application/json' \
--header 'R-Auth: {{partnerJwt}}' \
--data-raw '{
"companyApiKey": "{{companyApiKey}}",
"icd": "0225",
"businessIdentifier": "1234567890123"
}'
Request body
{
"companyApiKey": "<company-apiKey>",
"icd": "0225",
"businessIdentifier": "1234567890123"
}
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
companyApiKey | string | Yes | Company API key from Create company or Get company API key |
icd | string | Yes | Peppol ICD scheme code |
businessIdentifier | string | Yes | The identifier value under the given ICD |
Common ICD codes
| ICD | Scheme | Country |
|---|---|---|
0225 | SIREN | France |
9930 | VAT | Germany |
0088 | GLN | Global |
0184 | CVR | Denmark |
9914 | VAT | Austria |
0208 | CBE | Belgium |
Response
{
"companyId": "f5e6d7c8-1234-5678-9abc-...",
"status": "APPROVED"
}
Response fields
| Field | Description |
|---|---|
companyId | Company UUID |
status | APPROVED for auto-approved requests or IN_PROCESS for requests pending review |
Auto-approval
participantAutoApprove is enabled for your partner account. All Peppol registrations return APPROVED immediately without manual review.
Error Codes
| HTTP Status | errorType | Description |
|---|---|---|
400 Bad Request | — | The companyApiKey is invalid, inactive, or expired. Check the errorMessage field in the response for details. |
403 Forbidden | PARTNER_ACCESS_DENIED | The company associated with companyApiKey does not belong to this partner account. |
404 Not Found | COMPANY_NOT_FOUND | No active company was found for the provided companyApiKey. |