Przegląd VPD | eConnect

Usługa Validated Party Data (VPD) to API GraphQL, które umożliwia odpytywanie i weryfikację danych podmiotów. VPD agreguje dane z wielu oficjalnych źródeł i zapewnia wiarygodny, zweryfikowany obraz organizacji: nazwy prawne, nazwy handlowe, identyfikatory, adresy siedzib i informacje o sektorze.

Do czego służy VPD?

VPD jest szczególnie wartościowe, gdy przed wysłaniem faktury lub zamówienia chce się sprawdzić, czy odbiorca jest prawidłowo zarejestrowany. Obejmuje to walidację numeru KvK, wyszukiwanie oficjalnej nazwy firmy lub weryfikację adresu siedziby. Ponieważ dane są agregowane z wielu źródeł i weryfikowane przez eConnect, oszczędza się ręczne wyszukiwanie i zmniejsza ryzyko błędnego adresowania.

Typowe zastosowania:

Walidacja podmiotów przed fakturowaniem lub składaniem zamówień
Wzbogacanie adresów w CRM lub ERP
Weryfikacja dłużników podczas onboardingu nowych relacji
Wyszukiwanie identyfikatorów (KvK, OIN, NIP, GLN)

API GraphQL

VPD wykorzystuje GraphQL zamiast REST. Oznacza to, że w jednym zapytaniu żąda się dokładnie potrzebnych pól. Nie otrzymuje się zbędnych danych i nie trzeba odpytywać wielu endpointów.

Środowisko

Endpoint

Produkcja

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

Akceptacja

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

Uwierzytelnianie

VPD wykorzystuje OAuth2 Client Credentials do uwierzytelniania. Token żąda się od identity server eConnect ze 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

Otrzymany token Bearer używa się w headerze Authorization przy każdym żądaniu GraphQL. Dla środowiska akceptacyjnego używa się accp-identity.econnect.eu.

Główne funkcjonalności

Funkcjonalność

Opis

Zagregowane dane

Dane podmiotów z wielu oficjalnych źródeł, zweryfikowane przez eConnect

GraphQL

Elastyczne zapytania, pobieranie tylko potrzebnych pól

Wyszukiwanie

Po identyfikatorze, nazwie, kodzie pocztowym, mieście, kraju lub wolnym terminie wyszukiwania

Schema party

Rozbudowana struktura z identyfikatorami, lokalizacjami (w tym współrzędnymi), nazwami handlowymi i informacjami o sektorze

Playground

Interfejs graficzny do interaktywnych testów bez pisania kodu

Pierwsze kroki

Najszybszy sposób na rozpoczęcie pracy z VPD:

Zamówienie danych uwierzytelniających VPD API przez psb.econnect.eu lub kontakt z działem sprzedaży
Uzyskanie tokena OAuth2 ze scope vpd
Wysłanie pierwszego zapytania GraphQL do endpointu VPD
Lub skorzystanie z VPD Playground do interaktywnych testów

Chcą Państwo dowiedzieć się więcej o modelu danych podmiotów? Artykuł o schemacie VPD lub bezpośredni start z VPD Playground.

Wypróbuj VPD Playground

Powiązane