Přehled VPD | eConnect

Služba Validated Party Data (VPD) je GraphQL API, prostřednictvím kterého dotazujete a ověřujete údaje o stranách. VPD agreguje data z více oficiálních zdrojů a poskytuje Vám spolehlivý, ověřený obraz organizací: právní názvy, obchodní názvy, identifikátory, adresy sídel a sektorové informace.

Na co se VPD používá?

VPD je obzvlášť hodnotná, pokud chcete před odesláním faktury nebo objednávky zkontrolovat, zda je příjemce správně registrován. Jde například o validaci čísla KvK, vyhledání oficiálního názvu společnosti nebo ověření adresy sídla. Díky tomu, že údaje jsou agregované z více zdrojů a ověřené společností eConnect, ušetříte manuální vyhledávání a snížíte riziko chybného adresování.

Typická použití:

Validace strany před fakturací nebo zadáním objednávky
Obohacení adres ve Vašem CRM nebo ERP
Kontrola dlužníků při onboardingu nových vztahů
Vyhledávání identifikátorů (KvK, OIN, IČ DPH, GLN)

GraphQL API

VPD používá GraphQL místo REST. To znamená, že jedním dotazem získáte přesně ta pole, která potřebujete. Nedostanete zbytečná data a nemusíte volat více endpointů.

Prostředí

Endpoint

Produkce

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

Akceptace

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

Autentizace

VPD používá OAuth2 Client Credentials pro autentizaci. Vyžádejte si token od eConnect identity serveru se 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žijte přijatý Bearer token v hlavičce Authorization při každém GraphQL dotazu. Pro akceptační prostředí použijte accp-identity.econnect.eu.

Klíčové funkce

Funkce

Popis

Agregovaná data

Údaje o stranách z více oficiálních zdrojů, ověřené společností eConnect

GraphQL

Flexibilní dotazy, získání jen těch polí, která potřebujete

Vyhledávání

Podle identifikátoru, názvu, PSČ, města, země nebo volného výrazu

Party schéma

Rozsáhlá struktura s identifikátory, lokacemi (včetně souřadnic), obchodními názvy a sektorovými informacemi

Playground

Grafické rozhraní pro interaktivní testování bez psaní kódu

První kroky

Nejrychlejší způsob, jak začít s VPD:

Vyžádejte si VPD API credentials přes psb.econnect.eu nebo kontaktujte obchodní oddělení
Získejte OAuth2 token se scope vpd
Odešlete svůj první GraphQL dotaz na VPD endpoint
Nebo použijte VPD Playground pro interaktivní testování

Chcete vědět více o datovém modelu stran? Přečtěte si článek o VPD schématu, nebo začněte přímo s VPD Playground.

Vyzkoušejte VPD Playground

Související