Menu
InícioPreçosWebinars
Connexion
Contacto
Contacto

Integradores e programadores

Não reinvente a roda. Integre a infraestrutura VeraTrace em marca branca.

Falar de integração
FRONTEND • WIDGETS • REACT/VUE SDK

Experiência nativa

O rigor da prova criptográfica, a simplicidade de uma API.

Ofereça rastreabilidade verificável aos seus clientes sem desenvolver a infraestrutura. No formato DPP, e com os dados que a diligência EUDR exige.

Um pedido real, a sua resposta real

Sem captura desenhada: eis uma chamada a um endpoint público da API, sem chave nem conta, e o JSON-LD que devolve. Copie o comando e obterá a mesma resposta.

Pedido
curl -s https://veratrace.eu/api/dfc/companies/000000001-vitrine-producteur
Resposta — 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
        }
      ]
    }
  ]
}

A empresa consultada é uma ficha de exemplo do registo: fictícia, com um SIREN na gama 000 que o INSEE não atribui. O pedido e a resposta, esses, são reais — exportação DFC (Data Food Consortium) de uma ficha.

Esta resposta é produzida pelo mesmo código do endpoint, e um teste valida-a face ao esquema OpenAPI publicado: se deixasse de estar conforme, a nossa integração contínua falharia.

Consola de programador — chaves e quotasReferência da API

Matriz de casos de utilização

Para ERP e IoT

Produção e Sourcing

Originadores de dados (ERP, IoT, FMIS)

CRIAR E CERTIFICAR

Transforme os seus dados em bruto em Passaportes Digitais verificáveis.

Ver os endpoints de ingestão
Para E-commerce e Apps

Marketplaces e Retalho

Consumidores de dados (comércio eletrónico, apps)

EXIBIR E CONVERTER

Apresente a origem e as provas RSE diretamente nas suas fichas de produto.

Guia de integração do Widget
Para WMS e Pooling

Logística e Circularidade

Movimentadores (WMS, pooling)

RASTREAR E TRANSFERIR

Rastreie os movimentos de stocks e de contentores (grades, paletes) entre sítios.

API de transferência de ativos
Para RSE e Qualidade

Auditoria e Conformidade

Verificadores (RSE, ferramentas de qualidade)

AUDITAR E REPORTAR

Equipe a diligência devida EUDR e o formato DPP, e proteja os aprovisionamentos.

Formato dos relatórios de auditoria

Modelo flexível: API gratuita para conectores técnicos, Revenue Share para prescritores de negócio ou Licença de Marca Branca para Grandes Contas.

Documentação|SDKs e Bibliotecas|Disponibilidade dos endpoints|Obter chave de API

Questões técnicas

Que tecnologia para a integração?
API REST autenticada por uma chave de programador (X-VeraTrace-Api-Key: vt_live_… ou Authorization: Bearer vt_live_…), criada em self-service a partir da sua conta. A especificação OpenAPI 3.1 é pública e lê-se sem conta na página Programadores. Os endpoints de verificação de prova chamam-se mesmo sem qualquer chave. Acrescem webhooks em tempo real, widgets incorporáveis, iframes e exportações de dados para integrações leves. No roteiro, ainda não entregues: os SDK JavaScript / Python / Go e a autenticação OAuth2 — hoje é a chave em cabeçalho. Os exemplos cURL, JS e Python da página Programadores podem ser copiados tal como estão enquanto aguarda.
Quanto tempo demora a integração?
Widget iframe: algumas horas. API só de leitura: 1-2 dias. Integração completa bidirecional: 1-2 semanas consoante a sua stack.
Podemos testar em sandbox?
Ainda não. O ambiente api-sandbox.veratrace.eu está declarado na especificação a título de roteiro, mas não está provisionado até à data — não o utilize como alvo. Entretanto, o essencial testa-se sem risco e sem custos: os endpoints públicos de verificação (recolhas de produtos, passaporte, GS1, atestações) chamam-se em modo de leitura na produção, sem qualquer chave, e o plano Free cobre a integração. Escreva-nos se precisar de um conjunto de dados simulados dedicado.
Que blockchain utilizam?
Atualmente off-chain (base de dados distribuída assinada). Migração para a nossa própria cadeia VeraTrace Chain prevista para 2027 para a descentralização completa.
Os nossos clientes têm de compreender a blockchain?
Não. A integração abstrai toda a complexidade. Os seus clientes veem dados de rastreabilidade, não mecanismos criptográficos.
Que tipos de integração propõem?
API/SDK para integração profunda, widgets incorporáveis para exibição rápida, exportações CSV/JSON para relatórios e webhooks para sincronização em tempo real.
Como funciona o revenue share?
O senhor / a senhora recebe uma percentagem de cada transação de rastreabilidade gerada pelos seus clientes. A taxa depende do volume e do nível de parceria.
Suporte técnico?
Documentação completa, Slack dedicado aos parceiros e suporte técnico por email. Os parceiros Premium têm contacto direto com a equipa de desenvolvimento.
RGPD e dados?
Alojamento europeu, conformidade RGPD nativa. Os seus clientes permanecem proprietários dos seus dados. Nunca vendemos dados a terceiros.

Está a desenvolver uma solução agri/food?

Falemos do seu caso de utilização

Discutir a integração

É uma ESN, consultor de terreno ou fornecedor de IoT? Procuramos também parceiros de implementação. Contacte-nos. Contacte-nos

Editores e integradores

Uma oferta distinta, para quem consome os nossos dados por API em vez de pela interface.

Free

Grátis

30 req/min · 1 000 req/j

Enterprise

Sob orçamento

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

Estes escalões não se comparam com os de cima: tarifam um volume de chamadas, não uma utilização da plataforma.