Konkursovervåking med API

Fang opp konkursåpninger mot norske selskaper med et planlagt kall mot /insolvency/search, og match dem mot egne kunder og leverandører.

Problemet: du hører om konkursen for sent

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.

Norge: periodiske oppslag, ikke overvåking

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.

Et planlagt Python-skript

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.

Slik bygger du det inn i arbeidsflyten

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.

Det du kan kombinere med

  • Daglig oppslag på selskapsprofilen for de viktigste kundene og leverandørene: status, local_status og roller endres når registeret endres, og norske data oppdateres daglig.
  • Signalet om tvangsoppløsning på selskapet, som viser at registeret har startet en tvangsoppløsningsprosess.
  • Regnskap fra Regnskapsregisteret (de tre siste godkjente årsregnskapene) på Scale-planen, for å se egenkapital og resultat bak en kunde med økende utestående.

Hva du ikke får

  • Ingen webhook-overvåking for Norge: POST /monitor dekker ikke Norge.
  • Ingen selskapshendelser for Norge, så ingen hendelsesstrøm å abonnere på.
  • Kun selskaper. Personlig konkurs og gjeldsforhandling er ikke med.
  • Varslene er ikke en juridisk kunngjøring. Ved tvil om en konkurs er reell, kontroller mot den offisielle kilden før du handler.
  • Sanksjonsscreening er i beta, og PEP-screening er i beta og gjelder kun Spania.

Hvilken plan passer?

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.

Relatert

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.

Frequently asked questions

Kan jeg få webhook-varsel når en norsk kunde går konkurs?
Nei. Norge har ingen overvåking (POST /monitor). Du henter konkursvarslene med GET /insolvency/search?country=NO etter en fast plan og matcher dem mot egne kunder.
Hvor ofte bør jeg kjøre oppslaget?
Én gang per virkedag dekker de fleste behov. Norske data oppdateres daglig, så hyppigere kjøringer gir sjelden nye treff.
Gjelder varslene også personlig konkurs?
Nei. Insolvensvarslene gjelder kun selskaper, aldri privatpersoner.
Hvilke andre land dekkes av konkursendepunktet?
Tolv markeder: Frankrike, Tyskland, Storbritannia, Østerrike, Sveits, Norge, Finland, USA, Nederland, Danmark, Kroatia og Sverige. Tyskland, Østerrike og Nederland har kun varsler, ikke selskapsprofiler.
Er det mulig å prøve før jeg betaler?
Ja. Prøveperioden varer i 14 dager og gir 500 kreditter. Betalingskort kreves, men ingenting belastes under prøveperioden.