Valet av API för företagsinformation beror på vilka beslut uppgifterna ska stödja och hur de ska användas i ert system. Ett API som passar för att fylla i ett registreringsformulär behöver inte täcka samma informationsbehov som ett flöde för återkommande leverantörsbedömningar.

För att bedöma om en tjänst passar behöver ni följa uppgifterna från valet av företag till tolkning, lagring och senare uppdateringar. Roarings svenska API:er ger konkreta exempel på skillnader som påverkar integrationsvalet.

Skilj företagssökning från uppslag

Har ni redan organisationsnumret kan det användas för att hämta uppgifter om det valda företaget. I Roarings svenska Company Information API, version 2.0, används companyId, som specifikationen beskriver som företagets registrerings- eller organisationsnummer.

När användaren börjar med ett företagsnamn behöver ni först hitta möjliga företag. Roarings Company Search för Sverige, version 2.1, söker med fritext och filter och är markerat som ett separat tillägg. Sökningen ger kandidater; därefter behöver ni välja vilket företags identifierare som ska användas för uppslaget.

Sökinställningarna påverkar vilka kandidater ni får se. Company Search kan tillåta stavavvikelser genom fuzzy-sökning, medan inaktiva företag utesluts som standard. Vid exempelvis genomgång av äldre leverantörsregister kan standardurvalet därför vara för snävt.

En tom träfflista visar utfallet för sökfrågan och dess avgränsningar. Den räcker inte för slutsatsen att företaget saknas i underlaget. En namnträff behöver på motsvarande sätt kopplas till det företag ni faktiskt avser innan uppgifterna används.

Fältens betydelse avgör om de går att använda

En lista över tillgängliga fält visar inte ensam om uppgifterna räcker för ert flöde. I svenska Company Information 2.0 skiljer schemat exempelvis mellan postadress och besöksadress. Har ert CRM ett enda adressfält behöver ni välja vilken av dem som motsvarar fältets funktion.

Antal anställda anges som ett textintervall. Det passar ett behov av storleksklass, men uppfyller inte ett krav på exakt personalantal. Att omvandla intervallet till en enda siffra skulle tillföra en precision som uppgiften inte har.

För bransch behöver ni förstå både värdet och kodsystemet. I den svenska API-referensen betyder 00009 att branschkoden är okänd. Referensen anger också att SNI 2025 används för aktiva företag sedan den 16 december 2025. Vid historiska jämförelser behöver ni kontrollera kodsystemet för de faktiska poster ni jämför innan ni tolkar en kodskillnad som ändrad verksamhet.

Bestäm också vad ett saknat värde betyder för varje fält innan det får skriva över en befintlig uppgift. Ett okänt värde och en bekräftad förändring behöver inte få samma följd i ert system.

Samma granskning behövs för de marknader och företagsformer som ni omfattar. En allmän uppgift om landstäckning besvarar inte om ett visst fält finns för en viss företagsform. Roarings datasetsida för Företagsinformation beskriver erbjudandet; rätt lands- och versionsdokumentation behövs för att bedöma fälten.

Kontrollera resultatet även när HTTP-anropet lyckas

HTTP-statusen visar inte ensam om ni har fått de företagsuppgifter ni begärde. I Company Information 2.0:s dokumenterade svarsmodell för HTTP 200 beskrivs också resultatets status.code: 0 betyder hittat och 1 betyder ej hittat.

Vid uppslag av flera företag beskriver svarsmodellen dessutom:

• requestCount: antal begärda poster.
• hitCount: antal hittade poster.
• noMatchIds: identifierare som inte kunde matchas.

Integrationens avstämning behöver därför gå längre än att registrera ett lyckat anrop. Företag som inte kunde matchas behöver förbli synliga när ni bedömer om en uppdatering är färdig.

En utebliven företagsträff bör inte behandlas som ett tillfälligt serverfel. Kontroll av identifieraren kan behövas i det första fallet, medan ett tillfälligt driftfel kan kräva ett nytt försök.

Skilj datans ändringstid från er hämttid

Bestäm när uppgifterna behöver hämtas: vid registrering, inför ett beslut eller återkommande under relationen.

Skilj mellan när uppgiften ändrades i datakällan, när den blev tillgänglig hos leverantören och när ert system hämtade den. En tidsstämpel för ert senaste API-anrop visar inte i sig när företagsuppgiften senast ändrades.

Även datum i samma svar kan beskriva olika saker. I Company Information 2.0 avser changeDate när posten ändrades, medan statusDateFrom gäller företagets statusdatum.

Om ett beslut kräver en viss aktualitet behöver ni verifiera den för just uppgiften och leveransen. Ett nyligen genomfört uppslag räcker inte som underlag för den bedömningen.

Följ en förändring fram till genomförd uppdatering

Roaring dokumenterar webhookstöd för svenska Company Information 2.0. Den generella webhook-guiden beskriver flera leveransmodeller och att event kan levereras mer än en gång. Guiden rekommenderar därför idempotent behandling: samma händelse ska kunna behandlas igen utan att exempelvis skapa dubbla arbetsärenden. Den exakta hanteringen behöver följa rätt dataset, eventtyp och version.

Ert mottagande kan fungera samtidigt som ett efterföljande skrivfel lämnar CRM-posten oförändrad. Misslyckad intern behandling behöver därför kunna upptäckas och hanteras på nytt, även om själva leveransen redan är kvitterad. En leveranskvittens och en genomförd lokal uppdatering är två olika saker att följa upp.

Låt testet avgöra om flödet fungerar

Välj ett avgränsat användningsfall och pröva vad som händer från förfrågan till uppdaterad post i ert eget system.

För ett registreringsflöde behöver testet visa att rätt företag kan väljas bland sökträffarna och att exempelvis adress och storleksklass får rätt betydelse i era fält. För återkommande uppdateringar behöver testet även omfatta omatchade identifierare och, om webhooks ingår, återleveranser av event.

Roarings kom igång-guide visar vägen till sandbox och testdata vid respektive endpoint. Använd de dokumenterade sandboxfallen för att kontrollera hur integrationen tolkar testsvaren. Fel vid intern lagring och återleveranser behöver ni också testa i er egen integrationsmiljö.

Sandboxdata bevisar inte produktionsfältens täckning eller aktualitet. Bedöm därför produktionsdata separat med ett företagsurval som speglar era marknader och företagsformer, och granska de fält som flödet är beroende av.