Fang opp konkursåpninger mot norske selskaper med et planlagt kall mot /insolvency/search, og match dem mot egne kunder og leverandører.
En kunde som går konkurs, tar med seg utestående fordringer. En leverandør som går konkurs, tar med seg forskudd, bestillinger og ofte leveransen du var avhengig av. I begge tilfeller er det som regel for sent når du leser om det i avisen eller får brev fra bobestyrer. Kredittavdelinger, innkjøpsavdelinger og regnskapsbyråer trenger å vite om konkursåpninger tidlig nok til å stanse leveranser, stoppe utbetalinger og melde krav.
Det finnes også et etterlevelsesperspektiv. En virksomhet som er rapporteringspliktig etter hvitvaskingsloven skal følge opp kundeforholdet løpende. En konkurs hos en kunde er en opplysning som kan være relevant for den oppfølgingen; hva som kreves av din virksomhet må du vurdere selv.
For Norge finnes ingen automatisk overvåking med webhook (POST /monitor dekker ikke Norge), og det finnes ingen strøm av registerendringer. Konkursvarsler er derimot tilgjengelige, og de hentes med et vanlig oppslag. Mønsteret er derfor enkelt: kjør oppslaget etter en fast plan, for eksempel hver morgen, og sammenlign med listen over selskapene du følger.
# Norske konkursvarsler curl 'https://api.prometiam.com/functions/v1/risk-api/insolvency/search?country=NO&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Varslene gjelder kun selskaper, aldri privatpersoner. Endepunktet dekker tolv markeder (Frankrike, Tyskland, Storbritannia, Østerrike, Sveits, Norge, Finland, USA, Nederland, Danmark, Kroatia og Sverige), så samme kall med et annet country brukes for kunder i de andre landene. Tyskland, Østerrike og Nederland har varsler, men ingen selskapsregistre hos oss.
import os, requests
API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}
def hent_konkurser():
r = requests.get(f'{API}/insolvency/search',
params={'country': 'NO', 'limit': 100}, headers=HEAD)
r.raise_for_status()
return r.json().get('data', [])
# Match varslene mot dine egne kunder og leverandører (se feltene i dokumentasjonen)
for varsel in hent_konkurser():
print(varsel)
Eksemplet henter de siste varslene; i produksjon filtrerer du dem mot kunde- og leverandørlisten din. Lagre hvilke varsler du allerede har behandlet, slik at hver konkurs bare utløser én sak. Se dokumentasjonen for nøyaktig varselformat og filtre. Når en kandidat er funnet, bekrefter du selskapet med GET /companies/search?country=NO&company_number=... og leser status og local_status.
Kredittavdelinger setter gjerne opp jobben som en nattlig oppgave som oppretter en sak i økonomisystemet når en kunde dukker opp i konkursvarslene: stans nye leveranser, flytt kunden til forskuddsbetaling og meld kravet i boet. Innkjøp bruker samme jobb mot leverandørlisten for å stanse forskuddsbetalinger og finne en reserveleverandør før leveransen uteblir.
Regnskapsbyråer og revisorer kan kjøre samme kontroll mot hele kundeporteføljen og varsle klienten selv. Siden varslene kommer i samme format som for de andre landene, kan en nordisk kundeportefølje overvåkes av ett og samme skript: du bytter bare country.
status, local_status og roller endres når registeret endres, og norske data oppdateres daglig.POST /monitor dekker ikke Norge.Ett kall per natt mot konkursendepunktet og noen hundre profiloppslag i uken ligger langt innenfor Starter (9,99 € per måned, 1 000 kreditter). Med sanksjonsscreening og webhooks for kunder i andre land velger du Professional (29,99 € per måned, 10 000 kreditter). 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.