Sjekk at en norsk leverandør finnes, er aktiv og ikke er på vei ut av registeret, før første faktura og på nytt jevnlig. Data fra Brønnøysundregistrene i ett REST-kall per organisasjonsnummer.
De fleste virksomheter har flere leverandører enn noen har oversikt over. Mange er registrert én gang i økonomisystemet, med et organisasjonsnummer og et kontonummer, og blir aldri sjekket igjen. Likevel er det nettopp der risikoen ligger: et selskap som er slettet fra registeret, et selskap som er under tvangsoppløsning, en leverandør som er under konkursbehandling, eller et organisasjonsnummer som rett og slett er skrevet feil i en faktura.
Å vite hvem man handler med er et krav i flere regelverk. Hvitvaskingsloven pålegger rapporteringspliktige kundetiltak og løpende oppfølging av kundeforholdet. Og i bransjer med allmenngjorte tariffavtaler, som bygg, renhold og transport, har bestillere og hovedleverandører informasjons- og påseplikt overfor leverandørene etter allmenngjøringsloven og tilhørende forskrift. Påseplikten gjelder lønns- og arbeidsvilkår, og et registeroppslag erstatter den ikke. Men i begge tilfeller er første steg det samme: kontroller at motparten er den den utgir seg for å være, og at den fortsatt er i drift.
Brønnøysundregistrene publiserer Enhetsregisteret som åpne data, så et enkelt oppslag på ett nummer kan gjøres gratis, for eksempel i organisasjonsnummer-søket. Utfordringen kommer når du skal sjekke flere hundre leverandører automatisk, hver for seg og med jevne mellomrom, og i samme format som leverandører i andre land.
Leverandørkontrollen bygger på to endepunkter. Først slår du opp organisasjonsnummeret, deretter henter du hele profilen med id fra søket. For Norge er id selve organisasjonsnummeret.
# 1. Søk på organisasjonsnummer (Equinor ASA) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=NO&company_number=923609016' \ -H 'Authorization: Bearer rk_live_...' # 2. Hele profilen med roller curl 'https://api.prometiam.com/functions/v1/risk-api/companies/923609016' \ -H 'Authorization: Bearer rk_live_...'
Samme to kall fungerer med country=SE, DK, FI og de andre landene, så en leverandørliste på tvers av Norden kan sjekkes med én integrasjon. Ønsker du i tillegg å screene leverandørens navn og rolleinnehavere mot sanksjonslister, bruker du GET /sanctions/screen?name=... (beta, Professional-planen).
import os, requests
API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}
def sjekk_leverandor(orgnr):
s = requests.get(f'{API}/companies/search',
params={'country': 'NO', 'company_number': orgnr}, headers=HEAD).json()
if not s.get('data'):
return 'ikke_funnet'
c = requests.get(f"{API}/companies/{s['data'][0]['id']}", headers=HEAD).json()['data']
if c['status'] != 'active':
return 'til_gjennomgang: ' + c['status']
return 'ok'
Kjør funksjonen når leverandøren opprettes, og deretter som en planlagt jobb over hele leverandørregisteret, for eksempel hver natt eller hver uke. Norske data oppdateres daglig.
| Felt | Hva det betyr |
|---|---|
company_name, company_number | Navn og organisasjonsnummer slik Enhetsregisteret har dem |
status og local_status | Standardisert status, og registerets egen status (for eksempel under avvikling eller tvangsoppløsning) |
legal_form og local_legal_form | Organisasjonsform, for eksempel AS, ASA, ENK, NUF |
founding_date og adresse | Stiftelsesdato og forretningsadresse |
activity_code | Næringskode (NACE) |
vat_number | Norsk merverdiavgiftsnummer (NO + nummer + MVA) når selskapet er registrert i Merverdiavgiftsregisteret, ellers null |
| Roller | Styreleder, styremedlemmer, daglig leder med flere, slik registeret publiserer dem |
| Signal om tvangsoppløsning | Registerets signal om at selskapet er under tvangsoppløsning, blant risikosignalene på selskapet |
Enkeltpersonforetak (ENK) er med, slik registeret publiserer dem. Regnskap hentes med GET /companies/{id}/financials på Scale-planen: de tre siste godkjente årsregnskapene fra Regnskapsregisteret, uten antall ansatte.
/company-events/search returnerer ingenting for norske selskaper.POST /monitor) for Norge. Løpende kontroll gjøres ved å kjøre oppslaget på nytt med jevne mellomrom og sammenligne med forrige svar.80 leverandører som sjekkes ukentlig er rundt 1 000 kreditter i måneden (3 kreditter per leverandør og kontroll: selskapsoppslag 1, insolvens 2), som passer i Starter (9,99 € per måned, 1 000 kreditter); 500 leverandører er rundt 6 500 kreditter. Trenger du sanksjonsscreening i beta og webhooks, velger du Professional (29,99 € per måned, 10 000 kreditter). Scale (99,99 € per måned, 50 000 kreditter) inkluderer regnskapsdata. Prisene er offentlige, og årlig betaling gir to måneder gratis. Se prisene.
Start din gratis prøveperiode på 14 dager · API-dokumentasjon
Prøveperioden varer i 14 dager og gir 500 kreditter. Betalingskort kreves, men ingenting belastes under prøveperioden; deretter går du over til Starter (9,99 € per måned) hvis du ikke sier opp.