Kemipas API
Til webbureauer og ERP-partnere, der skal forbinde en forhandlers webshop eller ERP-system med Kemipas. Kemipas holder ordrer med omfattede kemikalier tilbage, indtil kunden har en gyldig kundeerklæring efter forordning (EU) 2019/1148, og frigiver dem, når kunden har underskrevet med MitID.
Bruger forhandleren WooCommerce, findes der et færdigt plugin under Integrationer i Kemipas. Så er denne side ikke nødvendig.
Forløbet
- Når en ordre er lagt, kalder systemet
POST /v1/ordrer/tjekmed kundens CVR-nummer og ordrelinjerne. Kemipas genkender de omfattede varer på varenummeret. - Svarer Kemipas
"tilladt": false, holdes ordren tilbage i jeres system. Kemipas sender selv kunden et link til erklæringen, når der er en mailadresse. - Når kunden har underskrevet (eller forhandleren har godkendt en afvigende ordre), sender Kemipas webhooken
ordre.frigivet. Så kan ordren sendes. - Når varen er leveret, registreres salget med
POST /v1/handler. Forordningen kræver oplysningerne for hver transaktion.
Kan Kemipas ikke kontaktes, bør ordrer med omfattede varer holdes tilbage og tjekkes igen senere. De må ikke sendes uden tjek.
Adgang
Alle kald går til https://demo.kemipas.dk med en API-nøgle i headeren. Forhandleren opretter nøglen i Kemipas under Integrationer og giver den til jer. Den sendes aldrig på mail fra Kemipas.
Authorization: Bearer kp_live_…
Content-Type: application/jsonTjekker nøglen og returnerer forhandlerens navn og de varenumre, der er omfattet.
{ "ok": true, "forhandler": "Demo Kemi A/S", "omfattede_varenumre": ["H2O2-35", "CIP-ACID"] }Tjek en ordre
{
"cvr": "41223344",
"ordre": "10442",
"email": "indkob@kunde.dk",
"virksomhed": "Brygværket ApS",
"leveringsadresse": "Vestergade 3, 5000 Odense C",
"linjer": [
{ "varenummer": "CIP-ACID", "navn": "CIP Acid 20 L", "maengde": 40, "enhed": "L" },
{ "varenummer": "SAEBE", "navn": "Håndsæbe", "maengde": 2 }
]
}| Felt | Beskrivelse |
|---|---|
| cvr | Kundens CVR-nummer, 8 cifre. Kunder i andre EU-lande: momsnummeret med landekode, fx SE556677889901 (tjekkes i VIES; kunden får et engelsk forløb uden MitID). Påkrævet. |
| ordre | Ordrenummeret i jeres system. Kommer igen i webhooks. Det samme nummer kan tjekkes flere gange. |
| Hvor kunden får linket til erklæringen. Anbefalet. | |
| leveringsadresse | Én linje. Levering til pakkeshop eller pakkeboks holdes til forhandlerens vurdering. |
| linjer[].maengde | Samlet mængde i kg eller liter (fx 2 dunke à 20 L = 40). Udelades enhed, bruges produktets enhed i Kemipas. |
{ "tilladt": false, "status": "mangler", "ordre_holdt": true, "link_sendt": true, "omfattede_varenumre": ["CIP-ACID"] }| status | Betydning |
|---|---|
| godkendt | Gyldig erklæring. Ordren må sendes. |
| udloeber | Gyldig, men udløber inden for 30 dage. Ordren må sendes; kunden har fået et fornyelseslink. |
| ikke_omfattet | Ingen omfattede varer på ordren. |
| mangler | Ingen erklæring. Hold ordren; kunden får et link. |
| udloebet | Erklæringen er udløbet. Hold ordren; kunden får et link. |
| produkt_mangler | Et produkt står ikke på erklæringen (se mangler_produkter). Hold ordren. |
| afventer_godkendelse | Erklæringen venter på forhandlerens godkendelse. Hold ordren. |
| til_vurdering | Ordren afviger fra erklæringen (mængde eller levering) og venter på forhandleren. Hold ordren. |
| afvist | Forhandleren har afvist ordren. Send den ikke. |
Registrér et salg
Kaldes for hver omfattet vare, når den er leveret. Brug varenumrene fra omfattede_varenumre.
{ "cvr": "41223344", "varenummer": "CIP-ACID", "maengde": 40, "reference": "10442" }Webhooks
Registrér jeres modtager med nøglen. Signeringsnøglen returneres én gang. En webhook med samme adresse erstattes. Adressen skal bruge https.
{ "url": "https://shop.dk/kemipas/webhook", "events": ["ordre.frigivet", "ordre.afvist"] }
→ { "id": 7, "url": "https://shop.dk/kemipas/webhook", "events": [...], "secret": "whsec_…" }| Hændelse | Hvornår |
|---|---|
| ordre.frigivet | En holdt ordre må sendes. Data: ordre, cvr. |
| ordre.afvist | Forhandleren har afvist en afvigende ordre. Data: ordre, cvr. |
| erklaering.godkendt | En kunde har fået en gyldig erklæring. |
| erklaering.udloeber | Erklæringen udløber om 30 dage. |
| erklaering.udloebet | Erklæringen er udløbet. |
POST https://shop.dk/kemipas/webhook
Kemipas-Event: ordre.frigivet
Kemipas-Signature: t=1794300000,v1=5f2c…
{ "type": "ordre.frigivet", "created": "2026-11-10T09:12:00.000Z", "data": { "ordre": "10442", "cvr": "41223344", "erklaering": "KP-2026-0042" } }Signaturen er HMAC-SHA256 af <t>.<rå body> med signeringsnøglen. Afvis kald, der er ældre end 10 minutter. Svar med 2xx; ellers forsøger Kemipas igen med stigende interval.
Node.js
import crypto from 'node:crypto';
function verify(header, rawBody, secret) {
const m = /t=(\d+),v1=([a-f0-9]{64})/.exec(header ?? '');
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 600) return false;
const expected = crypto.createHmac('sha256', secret).update(`${m[1]}.${rawBody}`).digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(m[2]));
}PHP
function kemipas_verify($header, $raw_body, $secret) {
if (!preg_match('/t=(\d+),v1=([a-f0-9]{64})/', $header, $m)) return false;
if (abs(time() - (int) $m[1]) > 600) return false;
return hash_equals(hash_hmac('sha256', $m[1] . '.' . $raw_body, $secret), $m[2]);
}Øvrige kald
Har kunden en gyldig erklæring, og for hvilke produkter? Fx til at vise en besked i kurven, før kunden bestiller.
Opretter en kunde og sender eventuelt et link: { "cvr": "41223344", "email": "indkob@kunde.dk", "send_link": true, "varenumre": ["CIP-ACID"] }
Fejl
Fejl returneres som { "fejl": "kode", "besked": "…" } med HTTP-status 400 (forkert forespørgsel) eller 401 (ugyldig nøgle). Ved 5xx eller netværksfejl: hold ordren, og prøv igen.
Spørgsmål: drift@kemipas.dk