Skip to main content
Version: 1.0.1

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.

API Management screen with generated keys

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 tax number, not your VAT identification number, not the company name.

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

curl --location 'https://api.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 rather than on the name, since company 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 also shown on the invoice itself.

"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.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.