Prehľad VPD | eConnect

Služba Validated Party Data (VPD) je GraphQL API, prostredníctvom ktorého dopytujete a overujete údaje o stranách. VPD agreguje dáta z viacerých oficiálnych zdrojov a poskytuje Vám spoľahlivý, overený obraz organizácií: právne názvy, obchodné názvy, identifikátory, adresy sídiel a sektorové informácie.

Na čo sa VPD používa?

VPD je obzvlášť hodnotná, ak chcete pred odoslaním faktúry alebo objednávky skontrolovať, či je príjemca správne registrovaný. Ide napríklad o validáciu čísla KvK, vyhľadanie oficiálneho názvu spoločnosti alebo overenie adresy sídla. Vďaka tomu, že údaje sú agregované z viacerých zdrojov a overené spoločnosťou eConnect, ušetríte manuálne vyhľadávanie a znížite riziko chybného adresovania.

Typické použitia:

Validácia strany pred fakturáciou alebo zadaním objednávky
Obohatenie adries vo Vašom CRM alebo ERP
Kontrola dlžníkov pri onboardingu nových vzťahov
Vyhľadávanie identifikátorov (KvK, OIN, IČ DPH, GLN)

GraphQL API

VPD používa GraphQL namiesto REST. To znamená, že jedným dopytom získate presne tie polia, ktoré potrebujete. Nedostanete zbytočné dáta a nemusíte volať viacero endpointov.

Prostredie

Endpoint

Produkcia

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

Akceptácia

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

Autentifikácia

VPD používa OAuth2 Client Credentials na autentifikáciu. Vyžiadajte si token od eConnect identity servera so 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

Použite prijatý Bearer token v hlavičke Authorization pri každom GraphQL dopyte. Pre akceptačné prostredie použite accp-identity.econnect.eu.

Kľúčové funkcie

Funkcia

Popis

Agregované dáta

Údaje o stranách z viacerých oficiálnych zdrojov, overené spoločnosťou eConnect

GraphQL

Flexibilné dopyty, získanie len tých polí, ktoré potrebujete

Vyhľadávanie

Podľa identifikátora, názvu, PSČ, mesta, krajiny alebo voľného výrazu

Party schéma

Rozsiahla štruktúra s identifikátormi, lokáciami (vrátane súradníc), obchodnými názvami a sektorovými informáciami

Playground

Grafické rozhranie pre interaktívne testovanie bez písania kódu

Prvé kroky

Najrýchlejší spôsob, ako začať s VPD:

Vyžiadajte si VPD API credentials cez psb.econnect.eu alebo kontaktujte obchodné oddelenie
Získajte OAuth2 token so scope vpd
Odošlite svoj prvý GraphQL dopyt na VPD endpoint
Alebo použite VPD Playground na interaktívne testovanie

Chcete vedieť viac o dátovom modeli strán? Prečítajte si článok o VPD schéme, alebo začnite priamo s VPD Playground.

Vyskúšajte VPD Playground

Súvisiace