Invoice (Factur-X / CDAR)
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 Authentication.
France — Invoice (Factur-X / CDAR)
Submit invoice (ERP flow — recommended) POST
Purpose of use: Single-step save + send to PPF in one call.
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/cdar/submit |
| 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)
{
"companyId": "uuid",
"invoiceNumber": "INV-2025-001",
"statusCode": "A1",
"reasonCode": null,
"reasonText": null,
"siren": "123456789",
"companyName": "Acme France SAS"
}
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
| companyId | UUID | Yes | Sender company ID |
| invoiceNumber | String | Yes | Invoice number |
| statusCode | String | Yes | CDAR status (A1 accepted, A2 rejected, …) |
| reasonCode | String | No | Reason code for rejection |
| reasonText | String | No | Human-readable reason |
| siren | String | No | SIREN (ERP flow) |
| companyName | String | No | Company name (ERP flow) |
Responses
200 — Submitted
400 — Validation
401 — Unauthorized
500 — PPF submission failed
Submit UBL/CII invoice (structured XML) POST
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/submit |
| Method | POST |
| Content-Type | application/xml (raw UBL/CII) |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| companyId | UUID | Yes | Sender company |
| invoiceNumber | String | Yes | Invoice number |
| invoiceTypeCode | String | No | Default 380; 381 = credit note |
| flowSyntax | String | No | UBL or CII |
| siren | String | No | Override SIREN (ERP) |
Request body: Raw XML (UBL or CII, max 10MB).
Get invoice CDV status GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/cdv/{companyId}/{invoiceNumber} |
| Method | GET |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Get invoice CDV detail GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/cdv/detail/{invoiceCdvId} |
| Method | GET |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
List invoices (CDV) GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/cdv/list |
| Method | GET |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| companyId | UUID | Yes | Company |
| page | Integer | No | Page index |
| size | Integer | No | Page size |
Get invoice history GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/cdv/history/{invoiceCdvId} |
| Method | GET |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Receive incoming CDAR POST
Purpose of use: Store an incoming CDAR acknowledgement received from PPF.
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/FR/cdar/receive |
| Method | POST |
| Content-Type | application/xml (raw CDAR) |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Request body: Raw CDAR XML (max 5MB).