ProductKennisDevelopers
Platform Control
Validated Party Data (VPD): overzicht

De Validated Party Data service: partij-informatie verifiëren via de GraphQL API.

De Validated Party Data (VPD) service is een GraphQL API waarmee je partijgegevens kunt opvragen en verifiëren. De VPD aggregeert data uit meerdere officiële bronnen en biedt je een betrouwbaar, geverifieerd beeld van organisaties: juridische namen, handelsnamen, identifiers, vestigingsadressen en sectorinformatie.

Waarvoor gebruik je de VPD?

De VPD is vooral waardevol als je vóór het verzenden van een factuur of order wilt controleren of de ontvanger correct is geregistreerd. Denk aan het valideren van een KvK-nummer, het opzoeken van de officiële bedrijfsnaam of het controleren van een vestigingsadres. Doordat de data uit meerdere bronnen wordt geaggregeerd en door eConnect geverifieerd, bespaar je handmatig opzoekwerk en verminder je het risico op foutieve adressering.

Typische toepassingen:

  • Partijvalidatie vóór facturering of orderplaatsing
  • Adresverrijking in je CRM of ERP
  • Debiteurencheck bij onboarding van nieuwe relaties
  • Identifier-lookup (KvK, OIN, BTW-nummer, GLN)
  • eDelivery-capability check: controleren of een ontvanger een specifiek documenttype op een bepaald kanaal accepteert, zonder een aparte SMP-lookup
  • Best-effort match bij dataverrijking via de find-query, voor scenario's met onvolledige of inconsistente invoer
GraphQL API

De VPD gebruikt GraphQL in plaats van REST. Dat betekent dat je in één query precies de velden opvraagt die je nodig hebt. Je krijgt geen overbodige data terug en je hoeft niet meerdere endpoints aan te spreken.

OmgevingEndpointProductiehttps://vpd.econnect.eu/graphql/v1Acceptatiehttps://accp-vpd.econnect.eu/graphql/v1
Authenticatie

De VPD gebruikt OAuth2 Client Credentials voor authenticatie. Vraag een token aan bij de eConnect identity server met scope vpd:

POST https://identity.econnect.eu/connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=jouw-client-id
&client_secret=jouw-client-secret
&scope=vpd

Gebruik het ontvangen Bearer token in de Authorization header bij elk GraphQL-verzoek. Voor de acceptatieomgeving gebruik je accp-identity.econnect.eu.

Kernfeatures
FeatureBeschrijvingGeaggregeerde dataPartijgegevens uit meerdere officiële bronnen, door eConnect geverifieerdGraphQLFlexibele queries, alleen de velden ophalen die je nodig hebtZoekenOp identifier, naam, postcode, stad, land of vrije zoektermBest-effort matchDe find-query levert resultaten op basis van een combinatie van velden, ook wanneer de invoer onvolledig of inconsistent isCodetabellenAanvullende queries company, sbi en nace voor rechtsvormen per land en sectorcodes (NL en EU)Party schemaUitgebreide structuur met identifiers, locaties (incl. coördinaten), handelsnamen, sectorinformatie en eDelivery-capabilities per kanaalPlaygroundGrafische interface voor interactief testen zonder code te schrijven
Eerste stappen

De snelste manier om met de VPD te starten:

  1. Vraag VPD API-credentials aan via psb.econnect.eu of neem contact op met sales
  2. Haal een OAuth2-token op met scope vpd
  3. Stuur je eerste GraphQL query naar het VPD-endpoint
  4. Of gebruik de VPD Playground om interactief te testen
Veelgestelde vragen
Uit welke bronnen haalt de VPD partijgegevens?

De VPD aggregeert data uit meerdere officiële bronnen, waaronder het Handelsregister (KvK) en andere publieke registers. De gegevens worden door eConnect geverifieerd voordat ze beschikbaar komen via de API. Daardoor bespaar je handmatig opzoekwerk en verminder je het risico op foutieve adressering.

Heb ik speciale credentials nodig voor de VPD?

Ja, de VPD gebruikt OAuth2 Client Credentials voor authenticatie met scope vpd. Je vraagt een access token aan bij de eConnect identity server en stuurt het mee als Bearer token bij elk GraphQL-verzoek. Credentials kun je aanvragen via psb.econnect.eu of via sales.

Wat is het verschil tussen de VPD en een handmatige KvK-lookup?

De VPD combineert gegevens uit meerdere bronnen in één gestandaardiseerde API-call, terwijl een KvK-lookup alleen het Handelsregister raadpleegt. Bovendien retourneert de VPD alle bekende identifiers (KvK, OIN, BTW, GLN) in één keer, inclusief vestigingsadressen met coördinaten, wat het ideaal maakt voor geautomatiseerde verrijking in je CRM of ERP.

Meer weten over het party-datamodel? Lees het artikel over het VPD-schema, of ga direct aan de slag met de VPD Playground.

Probeer de VPD Playground

Gerelateerd
PreviousTransform API
NextVPD-schema