VPD-Übersicht | eConnect

Der Validated Party Data (VPD) Service ist eine GraphQL API, mit der Sie Parteidaten abfragen und verifizieren können. Die VPD aggregiert Daten aus mehreren offiziellen Quellen und bietet Ihnen ein zuverlässiges, verifiziertes Bild von Organisationen: juristische Namen, Handelsnamen, Identifier, Geschäftsadressen und Brancheninformationen.

Wofür verwenden Sie die VPD?

Die VPD ist besonders wertvoll, wenn Sie vor dem Versand einer Rechnung oder Bestellung prüfen möchten, ob der Empfänger korrekt registriert ist. Denken Sie an die Validierung einer Handelsregisternummer, die Suche nach dem offiziellen Firmennamen oder die Überprüfung einer Geschäftsadresse. Da die Daten aus mehreren Quellen aggregiert und von eConnect verifiziert werden, sparen Sie manuelle Recherchearbeit und reduzieren das Risiko fehlerhafter Adressierung.

Typische Anwendungsfälle:

Parteivalidierung vor Rechnungsstellung oder Bestellaufgabe
Adressanreicherung in Ihrem CRM oder ERP
Debitorenprüfung beim Onboarding neuer Geschäftsbeziehungen
Identifier-Lookup (Handelsregister, OIN, USt-IdNr., GLN)

GraphQL API

Die VPD verwendet GraphQL statt REST. Das bedeutet, dass Sie in einer einzigen Abfrage genau die Felder anfordern, die Sie benötigen. Sie erhalten keine überflüssigen Daten und müssen nicht mehrere Endpoints ansprechen.

Umgebung

Endpoint

Produktion

https://vpd.econnect.eu/graphql/v1

Akzeptanz

https://accp-vpd.econnect.eu/graphql/v1

Authentifizierung

Die VPD verwendet OAuth2 Client Credentials zur Authentifizierung. Fordern Sie ein Token beim eConnect Identity Server mit Scope vpd an:

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

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

Verwenden Sie das erhaltene Bearer Token im Authorization-Header bei jeder GraphQL-Anfrage. Für die Akzeptanzumgebung verwenden Sie accp-identity.econnect.eu.

Kernfunktionen

Funktion

Beschreibung

Aggregierte Daten

Parteidaten aus mehreren offiziellen Quellen, von eConnect verifiziert

GraphQL

Flexible Abfragen, nur die benötigten Felder abrufen

Suche

Nach Identifier, Name, Postleitzahl, Stadt, Land oder freiem Suchbegriff

Party-Schema

Umfangreiche Struktur mit Identifiern, Standorten (inkl. Koordinaten), Handelsnamen und Brancheninformationen

Playground

Grafische Oberfläche für interaktives Testen ohne Code zu schreiben

Erste Schritte

Der schnellste Weg, um mit der VPD zu starten:

Beantragen Sie VPD API-Credentials über psb.econnect.eu oder kontaktieren Sie den Vertrieb
Holen Sie sich ein OAuth2-Token mit Scope vpd
Senden Sie Ihre erste GraphQL-Abfrage an den VPD-Endpoint
Oder verwenden Sie den VPD Playground zum interaktiven Testen

Möchten Sie mehr über das Party-Datenmodell erfahren? Lesen Sie den Artikel zum VPD-Schema, oder starten Sie direkt mit dem VPD Playground.

VPD Playground ausprobieren

Verwandt