NemHandel (OIOUBL)
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.
Denmark — NemHandel (OIOUBL)
Denmark uses NemHandel for B2B e-invoicing. Invoices are sent as OIOUBL XML (DK_OIOUBL). NemHandel requires a token and a certificate per company.
Supported invoiceType
| Value | Description |
|---|---|
| DK_OIOUBL | Denmark OIOUBL (NemHandel) |
Upload NemHandel token POST
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/upload-token |
| 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",
"tokenType": "DENMARK_INVOICE",
"tokenName": "NemHandel Token",
"token": "your-nemhandel-token",
"generateDate": "2025-04-01"
}
Update NemHandel token PATCH
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/update-token |
| Method | PATCH |
| Content-Type | application/json |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Request body: Same as Upload NemHandel token.
Check NemHandel token exists GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/exists |
| 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 |
Get NemHandel token GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/get-token |
| 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 |
Delete NemHandel token DELETE
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/{companyId} |
| Method | DELETE |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| tokenId | UUID | Yes | Token ID |
Upload NemHandel certificate POST
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/upload-certificate |
| Method | POST |
| Content-Type | multipart/form-data |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Form fields: companyId, certificate (file), password (optional)
Update NemHandel certificate PATCH
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/update-certificate |
| Method | PATCH |
| Content-Type | multipart/form-data |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Check NemHandel certificate exists GET
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/certificate-exists |
| 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 |
Delete NemHandel certificate DELETE
Endpoint Information
| Property | Value |
|---|---|
| URL | /token/DK/certificate/{companyId} |
| Method | DELETE |
| Base URL | Stage Environment URLhttps://app-stage.docnova.ai/ Production Environment URLhttps://api.docnova.ai/ |
| Authorization | Bearer JWT |
Send invoice to NemHandel POST
Endpoint Information
| Property | Value |
|---|---|
| URL | /invoice/DK/send-to-nemhandel |
| 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",
"invoiceIdList": ["uuid-1", "uuid-2"]
}