Verified op harde identifier
Een geldig en gevonden KVK-nummer kan een harde match ondersteunen. Het antwoord blijft evidence en methode vermelden.
Voorbeelden zonder verkoopfictie
Zie precies wat erin gaat, wat eruit komt en wanneer review nodig blijft.
Deze voorbeelden volgen de huidige request- en responsevormen. Organisaties, identifiers en scores zijn bewust fictief: ze leggen de workflow uit en zijn geen verzonnen klantcases.
Bron per voorstel Review bij twijfel Origineel blijft bewaard
Waar dit bij helpt
Maak een databesluit controleerbaar vóór je het toepast.
Probable op meerdere signalen
Naam plus adres kan een waarschijnlijke kandidaat geven, maar zonder harde identifier blijft expliciete bevestiging passend.
Ambiguous of unmatched
Meerdere plausibele kandidaten of onvoldoende bewijs leveren een afzonderlijke status op, geen kunstmatig ingevuld bedrijfsrecord.
Werkbare route
Van eerste signaal tot veilig resultaat.
- 01
Kies het juiste voorbeeld
Gebruik resolve voor kandidaatselectie, enrich voor één duurzame reparatie en repair-jobs voor CSV.
- 02
Vervang fictieve invoer
Gebruik een eigen afgebakend testrecord en verwijder velden die je niet daadwerkelijk bezit.
- 03
Controleer alle statussen
Test niet alleen het happy path maar ook probable, ambiguous, unmatched en providerfouten.
- 04
Log bewijs en beslissing
Bewaar de response en het latere reviewbesluit gekoppeld aan je eigen external_id.
Synthetisch voorbeeld · geen klantdata
Een contractgeldige request naast het responsetype.
Een KVK-nummer wordt genormaliseerd naar acht cijfers. De werkelijke matchstatus en kandidaten verschijnen alleen in de live demo eronder.
12345678 en Voorbeeldbedrijf B.V. zijn uitsluitend fictieve requestwaarden. De output wordt niet gesimuleerd.
Resolve-request · fictief
{
"record": {
"external_id": "demo-001",
"name": "Voorbeeldbedrijf B.V.",
"kvk_number": "12345678"
}
}ResolveResponse · contracttype
type ResolveResponse = {
status:
| "verified"
| "probable"
| "ambiguous"
| "unmatched";
confidence: number;
candidates: ResolveCandidate[];
};
type ResolveCandidate = {
display_name: string;
kvk_number: string | null;
confidence: number;
method: string;
hard_identifier: boolean;
evidence: string[];
};Echte API-response
Geen vooraf ingevulde uitkomst.
Deze demo toont alleen data die de resolve-API op dat moment retourneert. Ontbreekt de server-side demosleutel, dan blijft de demo zichtbaar uitgeschakeld.
- Input
- Resolve
- Kandidaten
- Besluit
Vul een bedrijfsnaam in om de echte resolve-response te bekijken.
CSV-voorbeeld
Een CSV-pilot begint met een UTF-8 bestand waarin external_id verplicht en uniek is. Komma en puntkomma worden herkend.
- Maximaal 500 records
- Maximaal 10 MB
- Review.csv voor accept, reject of override
Enrichmentvoorbeeld
Voor duurzame single-recordverwerking gebruik je POST /v1/companies/enrich en volg je daarna de aangemaakte job.
- Idempotency-Key is verplicht
- 202 Accepted bij jobstart
- final_data bevat het verwerkingsresultaat
Veelgestelde vragen
Eerst weten wat er precies gebeurt.
Zijn de getoonde bedrijven echte klanten?
Nee. Alleen de requestinvoer gebruikt expliciete placeholders. Contracttypen leggen de responsevorm uit; daadwerkelijke resultaten komen alleen uit de live demo.
Kan ik deze JSON direct gebruiken?
Gebruik de veldstructuur als startpunt, maar vervang alle placeholders en controleer je API-key, featuretoegang en gewenste foutafhandeling.
Waar staat het volledige API-contract?
De actuele OpenAPI-documentatie staat op api.bedrijfsbron.nl/docs. Een pilot-key en repairfeature kunnen apart worden geactiveerd.
Begin met echte input
Bespreek je dataset Toets Bedrijfsbron eerst op een afgebakende dataset.
Beschrijf je bronbestand, gewenste velden en beslisregels. Dan kan de pilot worden ingericht zonder directe writeback naar je ERP of CRM.