API for automatisert leverandørkontroll

Én integrasjon over flere offentlige registre

De underliggende registrene publiserer ulike statuser og kontrakter. Leverandørsjekk normaliserer organisasjonsnummer, aktivitet og arbeidsomfang til ett versjonert svar, samtidig som den opprinnelige kilden og observerte statusen bevares som evidens.

• Én kontrakt for renhold, bemanning, bilpleie og asbest.
• Versjonerte regler og eksplisitt kontrollgrunnlag i hvert svar.
• Kildehelse skiller manglende data fra et negativt registerfunn.
• Samme resultatmodell i web, enkeltkall, bulk og historikk.

Hva kan kontrolleres?

Aktivitetskontrollene dekker Arbeidstilsynets registre for renhold, bemanning, bilpleie og asbest. Asbest krever at arbeidsomfang oppgis. En virksomhetsprofil kan i tillegg hente identitet, registreringer, siste tilgjengelige regnskap og et minimert offentlig rollesnitt fra Brønnøysundregistrene.

Et vellykket svar er permitted, not_permitted eller indeterminate. Svaret inneholder kontrolltid, regelversjon, kildehelse og basis med myndighet, register og observert kildestatus. Statusen gjelder bare den valgte aktiviteten og er ikke en generell godkjenning.

Typiske integrasjoner

• Kontroller aktivitetskravet når en leverandør opprettes i et innkjøps- eller økonomisystem.
• Kjør en ordnet bulkkontroll av en eksisterende leverandørliste og håndter feil per rad.
• Opprett overvåking etter godkjent onboarding og hent versjonert kontrollhistorikk ved revisjon.
• Motta signerte webhooks når et relevant registerverdict eller selskapsfaktum endres.

Kom i gang

1. Opprett konto og lag en API-nøkkel på Min side.
2. Send nøkkelen som Authorization: Bearer <nøkkel>.
3. Bruk enkeltkontroll, bulk, watches eller webhooks etter behov.

curl -sS 'https://leverandorsjekk.no/v1/verify/943001820?activity=cleaning' \
  -H 'Authorization: Bearer leverandorsjekk_...'

curl -sS https://leverandorsjekk.no/v1/verifications \
  -H 'Authorization: Bearer leverandorsjekk_...' \
  -H 'Content-Type: application/json' \
  --data '{"checks":[{"organization_number":"943001820","activity":"cleaning"}]}'

Bulk, overvåking og hendelser

Bulk tar 1–100 kontroller per kall og isolerer valideringsfeil per rad. CSV-import på Min side tar inntil 500 rader. Supplier-watches kan følge flere aktiviteter per leverandør og bevare kontrollhistorikk.

Webhook-endepunkter konfigureres via API-et. Hver levering HMAC-signeres, har leveringshistorikk og kan forsøkes på nytt eller replayes.

curl -sS https://leverandorsjekk.no/v1/webhook-endpoints \
+  -H 'Authorization: Bearer leverandorsjekk_...' \
+  -H 'Content-Type: application/json' \
+  --data '{"url":"https://example.no/leverandorsjekk-events"}'

Offentlig enkeltoppslag er begrenset til 60 forespørsler per minutt per klient. Autentisert bulk er i tillegg begrenset til 500 kontroller per minutt per konto, med mindre driftskonfigurasjonen setter en lavere grense.

Slik kan API-et inngå i ERP, innkjøp og CRM

• Leverandøropprettelse: Kjør en aktivitetsavgrenset kontroll før leverandøren godkjennes i innkjøps- eller ERP-flyten.
• Porteføljevask: Send en ordnet bulk med organisasjonsnummer og aktivitet, og knytt hvert svar tilbake til samme rad i eget system.
• Løpende oppfølging: Opprett watches for leverandører som allerede er i bruk, og motta signerte webhooks når et kildebelagt registerfaktum endres.
• Dokumentasjon: Lagre kontrolltid, regelversjon, basis og kildehelse sammen med beslutningen i eget saks- eller compliance-system.

Integrasjonen sender ikke fritekst til en generell risikomodell. Klienten velger aktivitet eksplisitt og får samme avgrensede verdict som i gratisoppslaget.

Kontrakt og full dokumentasjon

Den publiserte OpenAPI-kontrakten er maskinlesbar og beskriver endepunkter, autentisering, request-/responsfelter og feilsvar. Den er det tekniske kontraktbeviset som bør brukes til klientgenerering og integrasjonstest.

Kontakt oss for å avklare aktivitetsdekning, forventet volum, rategrenser og hvordan kontrollbeviset skal lagres i ERP-, CRM- eller compliance-flyten.

Åpne OpenAPI-kontrakten Opprett konto for API-nøkkel