Controleer of een leverancier bestaat, actief is en een geldig btw-nummer heeft, en laat u verwittigen wanneer er iets wijzigt. Gegevens uit de KBO, via een REST-API.
Een leverancier wordt meestal één keer gecontroleerd, bij de aanmaak in het ERP, en daarna jarenlang vertrouwd. Intussen verandert de onderneming van naam of zetel, wordt ze stopgezet of gaat ze failliet. Voor een inkoopafdeling of een boekhouding is dat een echt risico: een factuur op een onbestaand of stopgezet ondernemingsnummer, een betaling aan een nieuw rekeningnummer van een onderneming die niet meer bestaat, of een btw-aftrek op een btw-nummer dat niet geldig is.
Een goede leverancierscontrole heeft twee momenten: bij de opname in uw leverancierslijst en daarna doorlopend. De eerste is een opzoeking, de tweede is bewaking.
Zoek de leverancier op met het ondernemingsnummer op de factuur, controleer de status en vraag het btw-nummer na bij VIES. Voorbeeld met 0417.497.106:
# 1. Opzoeken en status controleren
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=BE&company_number=0417497106' \
-H 'Authorization: Bearer rk_live_...'
# 2. Btw-nummer controleren bij VIES
curl 'https://api.prometiam.com/functions/v1/risk-api/vat/BE0417497106' \
-H 'Authorization: Bearer rk_live_...'
# 3. Leverancier bewaken
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"company_id": 123, "country": "BE"}'
Het btw-nummer in het antwoord komt uit het register (vat_number_source: "register"): de KBO bevestigt de btw-plicht. Voor een onderneming in een ander land kan het nummer ook volgens een regel zijn opgebouwd (rule): de vorm klopt dan, maar de registratie is niet bevestigd. Controleer dat met GET /vat/{nummer}.
Met POST /monitor krijgt u een webhook bij een wijziging van status, een stopzetting of een faillissement, een sanctietreffer (beta) en bij registerwijzigingen zoals een nieuwe naam, rechtsvorm of maatschappelijke zetel. Een leverancier waarvan het register het adres wijzigt, is een goed moment om ook uw betalingsgegevens na te kijken.
Prometiam heeft geen Nederlands handelsregister. Voor Nederland levert GET /insolvency/search?country=NL wel insolventieberichten van rechtspersonen, afkomstig uit het Centraal Insolventieregister. Een zaak verdwijnt zes maanden nadat ze is afgesloten. Die berichten zijn niet gekoppeld aan bedrijfsprofielen: u zoekt op naam, en de koppeling met uw eigen leveranciersrecord maakt u zelf. Wat het register is en hoe het werkt, leest u in het Centraal Insolventieregister (Engels).
Een bestand van enkele honderden leveranciers past ruim in Starter (9,99 € per maand, 1.000 credits). Heeft u webhooks en sanctiescreening nodig, dan is Professional (29,99 € per maand, 10.000 credits) het juiste plan. Zie de prijzen.
Start uw gratis proefperiode van 14 dagen · API-documentatie
De proefperiode duurt 14 dagen en omvat 500 credits. Een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend; daarna loopt het Starter-plan (9,99 € per maand) tenzij u opzegt.