Minder velden laten typen
Vraag eerst een herkenbaar identiteitssignaal en vul pas na bevestiging aanvullende velden voor.
Zakelijke klant-onboarding
Van bedrijfsnaam in het formulier naar een gecontroleerd klantrecord.
Gebruik resolve voor directe kandidaatselectie, laat de gebruiker bevestigen welk bedrijf wordt bedoeld en start pas daarna enrichment. Zo wordt onboarding sneller zonder ambiguity te verbergen.
Bron per voorstel Review bij twijfel Origineel blijft bewaard
Waar dit bij helpt
Maak een databesluit controleerbaar vóór je het toepast.
Twijfel is een status
Toon meerdere kandidaten bij ambiguous en laat unmatched doorstromen naar handmatige invoer of review.
Bewijs blijft beschikbaar
Bewaar matchmethode en evidence naast het klantrecord voor support, audit en latere correctie.
Werkbare route
Van eerste signaal tot veilig resultaat.
- 01
Verzamel minimale invoer
Vraag bijvoorbeeld bedrijfsnaam plus postcode of een KVK-nummer; stuur het adres genest mee.
- 02
Roep resolve aan
Verwerk verified, probable, ambiguous en unmatched als verschillende UX-staten in plaats van één succespad.
- 03
Laat de organisatie bevestigen
Toon kandidaatnaam, plaats en beschikbare identifier. Bij meerdere kandidaten kiest de gebruiker bewust.
- 04
Start idempotente enrichment
Stuur het bevestigde record naar /enrich met een unieke Idempotency-Key en volg de jobstatus.
- 05
Review en finaliseer
Gebruik final_data na auto-apply of review en bewaar het oorspronkelijke formulierrecord daarnaast.
Synthetisch voorbeeld · geen klantdata
Een complete onboardingstatus, niet alleen een zoekveld.
Onderstaand fictieve invoersjabloon toont een contractgeldige resolve-call. De live demo eronder toont alleen een werkelijke response wanneer de server-side demosleutel aanwezig is.
Alleen de invoer is fictief. Namen, identifiers, plaatsen en scores worden niet vooraf als output ingevuld.
Stap 1 · formulier naar resolve
POST /v1/companies/resolve
X-API-Key: <server-side key>
{
"record": {
"external_id": "signup-1042",
"name": "Voorbeeldbedrijf",
"address": {
"postal_code": "1234 AB",
"country_code": "NL"
}
}
}Stap 2 · verwerk de echte status
if (result.status === "verified") {
return showConfirmation(result.candidates[0]);
}
if (
result.status === "probable" ||
result.status === "ambiguous"
) {
return showCandidatePicker(result.candidates);
}
return showManualCompanyEntry();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.
UX per resolve-status
Maak iedere status zichtbaar in de onboarding, zodat een lage zekerheid nooit als een stille bevestiging voelt.
- verified: bevestig of ga gecontroleerd door
- probable: vraag expliciete bevestiging
- ambiguous: toon kandidaten
- unmatched: handmatige invoer of review
Enrichment na bevestiging
De duurzame job hoort na de organisatiematch. Zo voorkom je dat aanvullende data aan de verkeerde klant wordt gekoppeld.
- Unieke Idempotency-Key per onboarding
- Poll de jobstatus server-side
- Gebruik final_data, niet alleen een kandidaat
Veelgestelde vragen
Eerst weten wat er precies gebeurt.
Kan de API rechtstreeks vanuit mijn formulier worden aangeroepen?
Laat de browser je eigen serverroute aanroepen. Bewaar de Bedrijfsbron API-key uitsluitend server-side en proxy alleen de benodigde invoer.
Wat toon ik bij meerdere kandidaten?
Toon relevante kandidaatgegevens en laat de gebruiker kiezen. Sla een ambiguous antwoord niet automatisch op als definitieve organisatie.
Moet enrichment in hetzelfde request?
Nee. Resolve geeft direct kandidaten. Enrich start daarna een duurzame job met 202 Accepted en een unieke Idempotency-Key.
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.