Panoramica VPD | eConnect

Il servizio Validated Party Data (VPD) è un'API GraphQL che consente di interrogare e verificare i dati delle parti. La VPD aggrega dati da molteplici fonti ufficiali e offre un quadro affidabile e verificato delle organizzazioni: denominazioni legali, nomi commerciali, identificativi, indirizzi delle sedi e informazioni di settore.

A cosa serve la VPD?

La VPD è particolarmente utile quando, prima di inviare una fattura o un ordine, si desidera verificare se il destinatario è correttamente registrato. Pensi alla validazione di un numero di Camera di Commercio, alla ricerca della denominazione ufficiale o alla verifica di un indirizzo di sede. Poiché i dati vengono aggregati da più fonti e verificati da eConnect, si risparmia lavoro di ricerca manuale e si riduce il rischio di indirizzamento errato.

Applicazioni tipiche:

Validazione delle parti prima della fatturazione o dell'inserimento ordini
Arricchimento degli indirizzi nel CRM o ERP
Verifica dei debitori durante l'onboarding di nuove relazioni
Ricerca di identificativi (KvK, OIN, partita IVA, GLN)

API GraphQL

La VPD utilizza GraphQL invece di REST. Ciò significa che in una singola query richiede esattamente i campi di cui ha bisogno. Non riceve dati superflui e non deve interrogare più endpoint.

Ambiente

Endpoint

Produzione

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

Accettazione

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

Autenticazione

La VPD utilizza OAuth2 Client Credentials per l'autenticazione. Richieda un token all'identity server di eConnect con 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

Utilizzi il Bearer token ricevuto nell'header Authorization per ogni richiesta GraphQL. Per l'ambiente di accettazione utilizzi accp-identity.econnect.eu.

Funzionalità principali

Funzionalità

Descrizione

Dati aggregati

Dati delle parti da più fonti ufficiali, verificati da eConnect

GraphQL

Query flessibili, recuperare solo i campi necessari

Ricerca

Per identificativo, nome, CAP, città, paese o termine di ricerca libero

Schema party

Struttura estesa con identificativi, sedi (incl. coordinate), nomi commerciali e informazioni di settore

Playground

Interfaccia grafica per test interattivi senza scrivere codice

Primi passi

Il modo più rapido per iniziare con la VPD:

Richieda le credenziali API VPD tramite psb.econnect.eu o contatti il reparto vendite
Ottenga un token OAuth2 con scope vpd
Invii la prima query GraphQL all'endpoint VPD
Oppure utilizzi la VPD Playground per testare in modo interattivo

Desidera saperne di più sul modello dati delle parti? Legga l'articolo sullo schema VPD, oppure inizi direttamente con la VPD Playground.

Provi la VPD Playground

Correlati