Kontrollera att leverantören finns, är aktiv och har rätt uppgifter, vid upphandling och löpande. Ett anrop per leverantör, samma svar för alla länder.
En leverantör läggs upp en gång och används sedan i flera år. Under tiden kan bolaget byta namn, flytta, byta bolagsform, gå i likvidation eller hamna i konkurs. Inköp och ekonomi upptäcker det oftast först när en faktura studsar eller en leverans uteblir.
Leverantörskontroll handlar om tre saker: att kontrollera uppgifterna när leverantören läggs upp, att bevaka dem därefter och att kunna visa vad som kontrollerades och när. Med uppgifter hämtade från Bolagsverket via API kan det göras i affärssystemet i stället för i webbläsaren.
GET /companies/search?country=SE&company_number=... slår upp leverantören på organisationsnummer. Saknar du numret går det att söka på name=.GET /companies/{id} returnerar status, bolagsform, adress och momsnummer.GET /vat/{number} kontrollerar momsnumret mot VIES, till exempel innan en utlandsfaktura bokförs.POST /monitor bevakar leverantören och skickar ett webhook-larm vid ändrad status, avregistrering, sanktionsträff eller registerhändelse.GET /companies/{id}/financials ger digitalt inlämnade årsredovisningar (Scale-planen).import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'SE', 'company_number': '5560125790'})
for c in r.json().get('data', []):
print(c['company_name'], c['status'], c['local_status'])
Exemplet använder Volvos organisationsnummer 556012-5790. En vanlig regel är att godkänna leverantören bara om status är active, och att lägga in en bevakning med POST /monitor direkt efter godkännandet.
| Fält | Användning i leverantörskontrollen |
|---|---|
status och local_status | Aktiv, under likvidation, konkurs eller avregistrerad, med registrets egen beteckning |
legal_form och local_legal_form | Kontroll av att bolagsformen stämmer med avtalet |
company_name | Jämförelse med namnet på fakturan |
| Adressfält | Registrerad adress att jämföra med leverantörsregistret |
vat_number och vat_number_source | Momsnummer att kontrollera mot VIES |
Spara svaret tillsammans med tidpunkten för anropet: organisationsnummer, company_name, status, legal_form och momsnummer. Då kan ni i efterhand visa vad som kontrollerades och när. Stämmer namnet i registret inte med namnet på fakturan, eller skiljer sig adressen från den som leverantören har lämnat, pausa utbetalningen och fråga leverantören innan ni ändrar något i leverantörsregistret. Ett namnbyte syns som registerhändelse via GET /company-events/search, så det går att se om avvikelsen beror på en ändring i registret.
På Scale-planen hämtar du årsredovisningar för svenska bolag med GET /companies/{id}/financials. Det gäller årsredovisningar som lämnats in digitalt (iXBRL). Bolag som lämnar in på papper eller på annat sätt finns inte med. Beloppen kommer i inlämningsvalutan och i euro enligt ECB:s årsgenomsnitt. Starter, Professional och provnycklar har 10 anrop per månad till det här anropet.
GET /vat/{number}.Starter (9,99 EUR per månad, 1 000 krediter) räcker för kontroll vid registrering. Behöver ni bevakning med webhooks väljer ni Professional (29,99 EUR, 10 000 krediter). Scale (99,99 EUR, 50 000 krediter) lägger till årsredovisningar. Årsbetalning ger två månader gratis.
Svenska uppgifter kommer från Bolagsverket. Enskilda firmor (enskilda näringsidkare) ingår aldrig i tjänsten.
Starta 14 dagars gratis provperiod · API-dokumentation
Provperioden varar i 14 dagar och omfattar 500 krediter. Kort krävs, ingenting dras under provperioden; därefter fortsätter Starter (9,99 EUR per månad) om du inte säger upp.