API key, Company ID and Tracking ID

Three values come up in every integration, and they are found in three different places. This page says where each one is.

API key

Open Settings > ERP Management > API Management and click Generate.

Each key carries a name you choose, a type, a creation date and an expiry date. Two details matter in practice:

Keys expire one year after creation. The EXPIRED DATE column shows when. An integration that worked for months and suddenly returns an authorisation error on its anniversary has an expired key — generate a new one and swap it in.

The ACTIVE toggle is a kill switch. Turning it off stops that key immediately without deleting it, which is the safe way to cut off an integration you are still investigating.

Keep the key out of screenshots, tickets and e-mails. Anyone holding it can act on your company's data.

Company ID

Almost every API call takes a companyId, and it is a UUID — not your SIREN, not your VAT number, not the company name.

The portal does not display it. You obtain it from the login response:

curl --location 'https://api-fr.docnova.ai/auth/login' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "apiKey": "<your api key>",
    "email": "<your account e-mail>"
  }'

The response contains a companies array, and each entry has an id — that UUID is the companyId for that company:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-...",
  "companies": [
    {
      "id": "60ccd1a7-5348-47b2-9ef6-...",
      "name": "Example Company Ltd.",
      "taxNumber": "1234567890"
    }
  ]
}

If your account can see several companies, match on taxNumber — for a French company that is the SIREN — rather than on the name, since names repeat.

note

The same login response also returns the jwt you send in the R-Auth header on subsequent calls. The API key gets you the token; the token authorises the call.

Tracking ID

The Tracking ID identifies one document as it travels through the platform. It is returned when you post a document, and it is shown on the invoice itself under Lifecycle (CDV).

"I posted an invoice and got a Tracking ID, but it is not in the portal"

A Tracking ID means the platform accepted the document for processing, not that the document became an invoice. Processing can still fail on validation, and a document that fails never appears in the Sales Invoice list.

Query the document with its Tracking ID before assuming the invoice is lost:

BASE='https://api-fr.docnova.ai/invoice/get-document-status-by-tracking'

curl -X GET "$BASE?companyId=<company uuid>&trackingId=<tracking uuid>" \
  --header 'R-Auth: <jwt token>'

A COMPLETED status with nothing visible in the portal points at the wrong company or a filter, not at a lost document. Any other status carries the reason the document stopped, which is what support needs from you.

Two portal-side causes are worth ruling out first: the Registration Date filter on the invoice list defaults to a narrow range, and the company selector at the top of the screen may be pointing at another company.