Bevakning via API

Vad är Bevakning?

Bevakning via API består av tre enkla POST-endpoints som tillsammans täcker hela flödet: skapa listor, hämta förändringar och följa upp statistik – direkt från ditt eget system.

Du bevakar personer (personnummer) och företag (organisationsnummer) och får samma händelser som i webbtjänsten, men helt automatiserade.

Det här får du

• Möjlighet att skapa, lägga till, ta bort eller ersätta objekt i bevakningslistor.
• Förändringar per valbart datumintervall med tidsstämpel för varje ändring.
• Statistik och historik för en enskild lista eller alla listor.
• Möjlighet att gå vidare direkt till en ny kreditupplysning via API när en förändring upptäcks.

När passar tjänsten?

• När du vill automatisera kundvård och riskövervakning i affärssystemet.
• Vid adressbevakning, för att aviseras när en bevakad person eller ett bevakat företag byter adress.
• Vid uppföljning av betalningsanmärkningar, statusändringar, konkurs eller ägarbyten.

Bra att veta

Bevakningen bygger på samma datakällor och händelseflöde som webbtjänstens bevakning. Du väljer själv kontrollintervall, men de flesta kunder kör en kontroll per dag. Bevakningsutskick sparas inte i Digitala Arkivet.

Tre API-endpoints för bevakning

Bevaknings-API:et består av tre enkla POST-endpoints. Tillsammans täcker de hela flödet: skapa listor, hämta förändringar och följa upp statistik.

1. Uppdatera listan – POST /monitor/list_update

Skapa en ny lista eller ändra en befintlig. Med action anger du om du vill lägga till, ta bort, ersätta eller hämta innehåll. Ange id_type 1 för personnummer och 2 för organisationsnummer. Listor skapas automatiskt om de inte redan finns.

Används till exempel när ditt kundregister uppdateras och du vill synka de bevakade objekten utan manuellt arbete.

2. Kolla förändringar – POST /monitor/list

Hämta alla objekt i en lista som har ändrats inom ett valbart datumintervall. För varje träff får du tillbaka vilken typ av ändring som skett och när den registrerades. Med extended=true får du dessutom extra personuppgifter för personlistor.

Ändringstyperna skiljer sig åt mellan personer och företag. Kreditrelaterade ändringar (Kronofogden, mål, rating) kräver att du har aktiva kreditabonnemang.

3. Hämta statistik – POST /monitor/list_info

Se status för en enskild lista eller få en översikt över alla bevakningslistor. För varje lista visas antal aktiva objekt, senaste aktivitet och totala händelser. Du kan även välja att inkludera historik för spårbarhet och uppföljning.

Vanliga användningsområden

Bevakning via API passar utmärkt när du vill automatisera kundvård och riskövervakning. En vanlig arbetsgång är att synka ditt kundregister varje natt, kontrollera förändringar varje morgon och låta ändringarna skapa ärenden eller uppdatera kreditlimiter i ditt affärssystem.

Exempel på signaler du kan fånga upp:

• Adressändring hos en kund som ska få faktura.
• Ny betalningsanmärkning eller ändrat skuldsaldo.
• Styrelse- eller firmateckningsförändring hos ett företag.
• Statusändring, konkurs eller likvidation.
• Ny företagsägare eller verklig huvudman.

Adressbevakning och avisering

En av de mest använda delarna av bevakningen är adressbevakning. Istället för att köra hela kundregistret mot en adresskontroll inför varje utskick eller faktureringskörning lägger du upp objekten i en bevakningslista – sedan aviserar API:et dig när kontrollen upptäcker att någon av dem folkbokförs eller registreras på en ny adress.

Aviseringen innehåller både den nya adressen och tidpunkten för ändringen, så att du kan uppdatera ditt register automatiskt. Resultatet är färre returnerade brev och fakturor, korrekta leveransadresser och ett register som håller sig aktuellt utan manuellt underhåll. Behöver du istället hämta adressen vid ett enskilt tillfälle passar utvalda uppgifter bättre.

Kombinera med kreditupplysning och beslutsstöd

När en förändring upptäcks kan nästa steg vara att hämta en ny kreditupplysning via API eller köra objektet genom beslutsstödet. På så sätt uppdateras kreditlimiten automatiskt och du slipper manuella mellansteg.

Samma nyckel, skarp data

Testet körs mot skarp data och samma API-nyckel används sedan live. Kunder med höga volymer kör miljontals frågor i månaden genom samma infrastruktur.

Se alla API-tjänster eller webbtjänsten Bevakning.