Menu
HomeTariffeWebinar
Connexion
Contatti
Contatti

Integratori e sviluppatori

Non reinventi la ruota. Integri l’infrastruttura VeraTrace in white label.

Discutiamo di integrazione
FRONTEND • WIDGETS • REACT/VUE SDK

Esperienza nativa

Il rigore della prova crittografica, la semplicità di un’API.

Offra tracciabilità verificabile ai Suoi clienti senza sviluppare l’infrastruttura. In formato DPP, con i dati richiesti dalla due diligence EUDR.

Una richiesta vera, la sua risposta vera

Nessuno screenshot disegnato: ecco una chiamata a un endpoint pubblico dell'API, senza chiave né account, e il JSON-LD che restituisce. Copi il comando e otterrà la stessa risposta.

Richiesta
curl -s https://veratrace.eu/api/dfc/companies/000000001-vitrine-producteur
Risposta — HTTP 200, application/ld+json
{
  "@context": [
    "http://www.datafoodconsortium.org/ontologies/context.json",
    {
      "vrt": "https://veratrace.eu/ontology#",
      "skos": "http://www.w3.org/2004/02/skos/core#",
      "dfc-f": "http://w3id.org/dfc/taxonomies/facets.rdf#"
    }
  ],
  "@graph": [
    {
      "@id": "https://veratrace.eu/dfc/enterprises/000000001-vitrine-producteur",
      "@type": "dfc-b:Enterprise",
      "dfc-b:name": "LES JARDINS DE LA VALLEE CLAIRE (exemple)",
      "dfc-b:hasDescription": "Exploitation maraîchère conduite en agriculture biologique depuis 2011, sur 14 hectares répartis entre plein champ et abris froids. Une quarantaine d'espèces cultivées sur l'année, dont les cœurs de gamme melon, tomate de plein champ et courges d'hiver. Livraison en circuits courts (magasins de producteurs, cuisines centrales) et vente au carreau du marché de gros.",
      "dfc-b:hasAddress": {
        "@id": "https://veratrace.eu/dfc/enterprises/000000001-vitrine-producteur/address",
        "@type": "dfc-b:Address",
        "dfc-b:hasCity": "Cavaillon",
        "dfc-b:hasPostalCode": "84300",
        "dfc-b:hasCountry": "France",
        "dfc-b:region": "Provence-Alpes-Côte d'Azur"
      },
      "vrt:siret": "00000000100016",
      "vrt:legalForm": "Autre personne morale de droit privé",
      "dfc-b:hasCertification": [
        {
          "@id": "https://veratrace.eu/dfc/vocabulary/certification/ab",
          "@type": "skos:Concept",
          "skos:prefLabel": "AB — Agriculture biologique — certifié par un organisme agréé",
          "vrt:officialFacet": false,
          "vrt:certifiedBy": "Ecocert"
        },
        {
          "@id": "http://w3id.org/dfc/taxonomies/facets.rdf#HEV",
          "@type": "skos:Concept",
          "skos:prefLabel": "HVE — Haute valeur environnementale, niveau 3",
          "vrt:officialFacet": true
        }
      ]
    }
  ]
}

L'impresa interrogata è una scheda di esempio dell'elenco: fittizia, con un SIREN nell'intervallo 000 che l'INSEE non assegna. La richiesta e la risposta, invece, sono reali — esportazione DFC (Data Food Consortium) di una scheda.

Questa risposta è prodotta dallo stesso codice dell'endpoint e un test la convalida rispetto allo schema OpenAPI pubblicato: se smettesse di conformarvisi, la nostra integrazione continua fallirebbe.

Console sviluppatore — chiavi e quoteRiferimento API

Matrice dei casi d’uso

Per ERP e IoT

Produzione e Sourcing

Data Originators (ERP, IoT, FMIS)

CREATE & CERTIFY

Trasformi i Suoi dati grezzi in Passaporti Digitali verificabili.

Vedi gli endpoint di ingestione
Per E-commerce e App

Marketplace e Retail

Data Consumers (E-commerce, App)

DISPLAY & CONVERT

Mostri l'origine e le prove CSR direttamente sulle Sue schede prodotto.

Guida all'integrazione del widget
Per WMS e Pooling

Logistica e circolarità

Movers (WMS, Pooling)

TRACK & TRANSFER

Tracci i movimenti di scorte e contenitori (cassette, pallet) tra siti.

API di trasferimento degli asset
Per CSR e Qualità

Audit e conformità

Verifiers (CSR, Quality Tools)

AUDIT & REPORT

Attrezzi la due diligence EUDR e il formato DPP, e metta in sicurezza gli approvvigionamenti.

Formato dei rapporti di audit

Modello flessibile: API gratuita per i connettori tecnici, Revenue Share per i procacciatori d'affari o Licenza White Label per i grandi clienti.

Documentazione|SDK e librerie|Disponibilità degli endpoint|Ottieni la chiave API

Domande tecniche

Quale tecnologia per l’integrazione?
API REST autenticata da una chiave sviluppatore (X-VeraTrace-Api-Key: vt_live_… oppure Authorization: Bearer vt_live_…), creata in autonomia dal Suo account. La specifica OpenAPI 3.1 è pubblica e si legge senza account nella pagina Sviluppatori. Gli endpoint di verifica della prova si chiamano persino senza alcuna chiave. A questi si aggiungono webhook in tempo reale, widget incorporabili, iframe ed esportazioni di dati per le integrazioni leggere. Nella roadmap, non ancora disponibili: gli SDK JavaScript / Python / Go e l'autenticazione OAuth2 — oggi si usa la chiave nell'intestazione. Nel frattempo, gli esempi cURL, JS e Python della pagina Sviluppatori si possono copiare così come sono.
Quanto tempo richiede l’integrazione?
Widget iframe: qualche ora. API in sola lettura: 1-2 giorni. Integrazione completa bidirezionale: 1-2 settimane a seconda del Suo stack.
Si può testare in sandbox?
Non ancora. L'ambiente api-sandbox.veratrace.eu è dichiarato nella specifica come parte della roadmap, ma a oggi non è predisposto — non lo utilizzi come destinazione. Nel frattempo, l'essenziale si testa senza rischi e senza costi: gli endpoint pubblici di verifica (richiami di prodotto, passaporto, GS1, attestazioni) si chiamano in sola lettura sulla produzione, senza alcuna chiave, e il livello Free copre l'integrazione. Ci scriva se ha bisogno di un set di dati simulati dedicato.
Quale blockchain utilizzate?
Attualmente off-chain (database distribuito firmato). La migrazione verso la nostra catena VeraTrace Chain è prevista per il 2027 per la decentralizzazione completa.
I nostri clienti devono capire la blockchain?
No. L'integrazione nasconde tutta la complessità. I Suoi clienti vedono dati di tracciabilità, non meccanismi crittografici.
Quali tipi di integrazione proponete?
API/SDK per un'integrazione profonda, widget incorporabili per una visualizzazione rapida, esportazioni CSV/JSON per il reporting e webhook per la sincronizzazione in tempo reale.
Come funziona il revenue share?
Lei riceve una percentuale su ogni transazione di tracciabilità generata dai Suoi clienti. L'aliquota dipende dal volume e dal livello di partnership.
Supporto tecnico?
Documentazione completa, Slack dedicato ai partner e supporto tecnico via email. I partner Premium hanno un contatto diretto con il team di sviluppo.
GDPR e dati?
Hosting europeo, conformità GDPR nativa. I Suoi clienti restano proprietari dei loro dati. Non vendiamo mai dati a terzi.

Sviluppa una soluzione agri/food?

Parliamo del Suo caso d’uso

Parlare di integrazione

È una ESN, un consulente sul campo o un fornitore IoT? Cerchiamo anche partner di implementazione. Ci contatti. Contattaci

Editori e integratori

Un'offerta distinta, per chi consuma i nostri dati tramite API anziché tramite l'interfaccia.

Free

Gratuito

30 req/min · 1 000 req/j

Enterprise

Su preventivo

3 000 req/min · 1 000 000 req/j

Questi livelli non si confrontano con quelli sopra: tariffano un volume di chiamate, non un utilizzo della piattaforma.