kemipas.dk

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

  1. Når en ordre er lagt, kalder systemet POST /v1/ordrer/tjek med kundens CVR-nummer og ordrelinjerne. Kemipas genkender de omfattede varer på varenummeret.
  2. 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.
  3. Når kunden har underskrevet (eller forhandleren har godkendt en afvigende ordre), sender Kemipas webhooken ordre.frigivet. Så kan ordren sendes.
  4. 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/json
GET/v1/ping

Tjekker 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

POST/v1/ordrer/tjek
{
  "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 }
  ]
}
FeltBeskrivelse
cvrKundens 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.
ordreOrdrenummeret i jeres system. Kommer igen i webhooks. Det samme nummer kan tjekkes flere gange.
emailHvor kunden får linket til erklæringen. Anbefalet.
leveringsadresseÉn linje. Levering til pakkeshop eller pakkeboks holdes til forhandlerens vurdering.
linjer[].maengdeSamlet 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"] }
statusBetydning
godkendtGyldig erklæring. Ordren må sendes.
udloeberGyldig, men udløber inden for 30 dage. Ordren må sendes; kunden har fået et fornyelseslink.
ikke_omfattetIngen omfattede varer på ordren.
manglerIngen erklæring. Hold ordren; kunden får et link.
udloebetErklæringen er udløbet. Hold ordren; kunden får et link.
produkt_manglerEt produkt står ikke på erklæringen (se mangler_produkter). Hold ordren.
afventer_godkendelseErklæringen venter på forhandlerens godkendelse. Hold ordren.
til_vurderingOrdren afviger fra erklæringen (mængde eller levering) og venter på forhandleren. Hold ordren.
afvistForhandleren har afvist ordren. Send den ikke.

Registrér et salg

POST/v1/handler

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.

POST/v1/webhooks
{ "url": "https://shop.dk/kemipas/webhook", "events": ["ordre.frigivet", "ordre.afvist"] }
→ { "id": 7, "url": "https://shop.dk/kemipas/webhook", "events": [...], "secret": "whsec_…" }
HændelseHvornår
ordre.frigivetEn holdt ordre må sendes. Data: ordre, cvr.
ordre.afvistForhandleren har afvist en afvigende ordre. Data: ordre, cvr.
erklaering.godkendtEn kunde har fået en gyldig erklæring.
erklaering.udloeberErklæringen udløber om 30 dage.
erklaering.udloebetErklæ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

GET/v1/kunder/{cvr}/status

Har kunden en gyldig erklæring, og for hvilke produkter? Fx til at vise en besked i kurven, før kunden bestiller.

POST/v1/kunder

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