Menu
InicioTarifasWebinars
Connexion
Contacto
Contacto

Integradores y desarrolladores

No reinvente la rueda. Integre la infraestructura VeraTrace en marca blanca.

Hablar de integración
FRONTEND • WIDGETS • REACT/VUE SDK

Experiencia nativa

El rigor de la prueba criptográfica, la sencillez de una API.

Ofrezca trazabilidad verificable a sus clientes sin desarrollar la infraestructura. En formato DPP, y con los datos que exige la diligencia debida EUDR.

Una petición real, su respuesta real

Sin captura dibujada: aquí tiene una llamada a un endpoint público de la API, sin clave ni cuenta, y el JSON-LD que devuelve. Copie el comando y obtendrá la misma respuesta.

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

La empresa consultada es una ficha de ejemplo del directorio: ficticia, con un SIREN en el rango 000 que el INSEE no asigna. La petición y la respuesta, en cambio, son reales — exportación DFC (Data Food Consortium) de una ficha.

Esta respuesta la produce el mismo código que el endpoint, y una prueba la valida contra el esquema OpenAPI publicado: si dejara de ajustarse a él, nuestra integración continua fallaría.

Consola de desarrollador — claves y cuotasReferencia de la API

Matriz de casos de uso

Para ERP e IoT

Producción y Sourcing

Data Originators (ERP, IoT, FMIS)

CREATE & CERTIFY

Convierta sus datos en bruto en Pasaportes Digitales verificables.

Ver los endpoints de Ingestión
Para E-commerce y Apps

Marketplaces y Retail

Data Consumers (E-commerce, Apps)

DISPLAY & CONVERT

Muestre el origen y las pruebas RSE directamente en sus fichas de producto.

Guía de integración del Widget
Para WMS y Pooling

Logística y Circularidad

Movers (WMS, Pooling)

TRACK & TRANSFER

Trace los movimientos de stock y de contenedores (cajas, palés) entre sitios.

API de Transferencia de activos
Para RSE y Calidad

Auditoría y Conformidad

Verifiers (RSE, Quality Tools)

AUDIT & REPORT

Equipe la diligencia debida EUDR y el formato DPP, y asegure los aprovisionamientos.

Formato de los informes de auditoría

Modelo flexible: API gratuita para los conectores técnicos, Revenue Share para los prescriptores comerciales o Licencia de Marca Blanca para las Grandes Cuentas.

Documentación|SDKs y bibliotecas|Disponibilidad de los endpoints|Obtener clave API

Preguntas técnicas

¿Qué tecnología se usa para la integración?
API REST autenticada mediante una clave de desarrollador (X-VeraTrace-Api-Key: vt_live_… o Authorization: Bearer vt_live_…), creada en autoservicio desde su cuenta. La especificación OpenAPI 3.1 es pública y se lee sin cuenta en la página Desarrolladores. Los endpoints de verificación de pruebas se llaman incluso sin ninguna clave. Además hay webhooks en tiempo real, widgets integrables, iframes y exportaciones de datos para las integraciones ligeras. En la hoja de ruta, aún no entregados: los SDK de JavaScript / Python / Go y la autenticación OAuth2; hoy se usa la clave en la cabecera. Mientras tanto, los ejemplos de cURL, JS y Python de la página Desarrolladores se pueden copiar tal cual.
¿Cuánto tiempo lleva la integración?
Widget iframe: unas pocas horas. API de solo lectura: 1-2 días. Integración completa bidireccional: 1-2 semanas según su stack.
¿Se puede probar en sandbox?
Todavía no. El entorno api-sandbox.veratrace.eu figura en la especificación como parte de la hoja de ruta, pero a día de hoy no está aprovisionado: no lo utilice como destino. Mientras tanto, lo esencial se puede probar sin riesgo y sin coste: los endpoints públicos de verificación (retiradas de producto, pasaporte, GS1, atestaciones) se llaman en solo lectura sobre producción, sin ninguna clave, y el nivel Free cubre la integración. Escríbanos si necesita un conjunto de datos simulados específico.
¿Qué blockchain utilizan?
Actualmente off-chain (base de datos distribuida firmada). Migración a nuestra propia cadena VeraTrace Chain prevista para 2027 para la descentralización completa.
¿Deben nuestros clientes entender la blockchain?
No. La integración abstrae toda la complejidad. Sus clientes ven datos de trazabilidad, no mecanismos criptográficos.
¿Qué tipos de integración ofrecen?
API/SDK para una integración profunda, widgets integrables para una visualización rápida, exportaciones CSV/JSON para informes y webhooks para la sincronización en tiempo real.
¿Cómo funciona el revenue share?
Usted recibe un porcentaje de cada transacción de trazabilidad generada por sus clientes. La tasa depende del volumen y del nivel de colaboración.
¿Soporte técnico?
Documentación completa, Slack dedicado para los socios y soporte técnico por correo electrónico. Los socios Premium tienen contacto directo con el equipo de desarrollo.
¿RGPD y datos?
Alojamiento europeo, cumplimiento RGPD nativo. Sus clientes siguen siendo propietarios de sus datos. Nunca vendemos datos a terceros.

¿Desarrolla una solución agroalimentaria?

Hablemos de su caso de uso

Hablar de integración

¿Es usted una ESN, un consultor de campo o un proveedor de IoT? También buscamos socios de despliegue. Contáctenos. Contáctenos

Editores e integradores

Una oferta aparte, para quien consume nuestros datos por API en lugar de por la interfaz.

Free

Gratis

30 req/min · 1 000 req/j

Enterprise

Previo presupuesto

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

Estos niveles no se comparan con los de arriba: tarifican un volumen de llamadas, no un uso de la plataforma.