API e integraciones

La plataforma se diseñó a partir de su API

Un desarrollador ante una pantalla con código: acceso programático a los pasaportes digitales de producto.

Todo lo que hace la pantalla pasa por la API

WIARA fue una API antes de tener interfaz. El panel que usted utiliza se comunica con la misma interfaz programática que le damos a usted: no hay un modo privado ni ninguna función que exista solo detrás de un botón. Por eso la integración no es un añadido a la plataforma, sino la plataforma misma.

Hay dos interfaces. Una sirve para la integración y la administración, con más de cien operaciones documentadas según OpenAPI 3.0.3: pasaportes, plantillas, organizaciones, archivos, registro de auditoría y estadísticas. La otra es pública y de solo lectura, y es la que usa cualquiera para abrir los propios pasaportes.

Enviamos la especificación completa a los equipos que están haciendo una integración: basta con pedirla. Quizá le interesen también los estándares técnicos sobre los que se construye la plataforma, o el propio producto →

Qué puede automatizar

API e integraciones

Dos interfaces, un mismo contrato

Una API de integración para sus sistemas y una API pública de solo lectura para los pasaportes. Ambas documentadas según OpenAPI 3.0.3.

Servicio de resolución GS1 Digital Link

Los pasaportes se abren con su identidad GS1 Digital Link. El servicio de resolución (resolver) es conforme con la norma ISO/IEC 18975, no con un esquema propietario.

Modelo, lote, artículo

Los tres niveles de granularidad, además de las variantes de producto. El mismo estándar de código QR, sea cual sea el nivel que acabe fijando su acto delegado.

Borrador, vista previa, publicación

El pasaporte se prepara como borrador, se revisa a través de un enlace protegido y se publica cuando está listo. Todas las versiones quedan en el historial.

Registro de auditoría a demanda

Quién cambió qué, por objeto, usuario, fabricante, operador o plataforma. En lugar de un diario interminable, una pregunta con respuesta.

24 lenguas, de forma programática

Los valores del pasaporte se gestionan por idioma. La traducción automática se activa o desactiva en cada pasaporte.

Qué abarca el acceso programático

Todas las áreas que siguen se gestionan íntegramente a través de la API, sin ningún paso manual en la interfaz.

Ciclo de vida del pasaporte

✅ Creación, edición, borrador, vista previa mediante enlace protegido, publicación e historial completo de versiones.

Plantillas

✅ Creación y versionado de plantillas, estado por versión, traducciones por idioma y plantillas a medida asignadas a un único fabricante.

Organizaciones

✅ Plataformas, operadores y fabricantes con sus direcciones y contactos, incluida la transferencia de titularidad.

Vinculación operador ↔ fabricante

✅ Códigos de invitación, vista previa antes de aceptar, aceptación en nombre de su propia organización y desvinculación.

Archivos y pruebas documentales

✅ Carga segura, historial de versiones de cada archivo y enlaces de descarga firmados con validez limitada.

Registro de auditoría

✅ Consultas por objeto, por actor y por organización, pensadas para responder a un auditor y no para recorrerlas a mano.

Estadísticas

✅ Métricas y series temporales por ámbito, para sus paneles y no solo para los nuestros.

Acceso y tokens

✅ Tokens de acceso personales que se emiten y revocan por usuario, bajo supervisión administrativa.

Taxonomía

✅ Reglamentos y grupos de productos almacenados como datos: un nuevo grupo de productos se añade sin rediseñar nada.

Lectura pública

✅ Apertura de un pasaporte mediante GS1 Digital Link a nivel de modelo, lote o artículo, variantes incluidas. Un pasaporte retirado da una respuesta reconocible en lugar de quedarse en silencio.

API e integraciones

Preguntas frecuentes

Sí. La especificación OpenAPI completa no se publica en abierto, pero la enviamos a cualquier equipo que prepare una integración: solo tiene que pedirla. Así la documentación llega a quien la usa y no a quien la copia.

Sí. La interfaz es un cliente más del mismo acceso programático que recibe usted. Esa es la diferencia entre una plataforma con API y una plataforma a la que se le añadió una API.

Sí. Crear y actualizar pasaportes, subir documentos y gestionar organizaciones son operaciones programáticas, de modo que su sistema puede invocarlas directamente. El patrón de integración adecuado depende de su sistema, y eso se habla con uno de nuestros ingenieros: no hay una receta estándar.

Mediante GS1 Digital Link, la forma estándar de que un código QR apunte a un producto. El servicio de resolución es conforme con la norma ISO/IEC 18975 y la identidad se basa en el GTIN.

La respuesta es reconocible. Un pasaporte que se publicó y ya no es válido no se hace pasar por uno que nunca existió: el sistema que lo lee puede distinguirlo y actuar en consecuencia.

Todavía no. EPCIS 2.0 es una ampliación prevista para sectores con trazabilidad intensiva, y el pasaporte básico no lo necesita. Preferimos decirlo claramente a que se dé por supuesto.

Un equipo técnico en una reunión de trabajo, integrando una plataforma de DPP.
Estándares abiertosAcceso programático
Estándares abiertosAcceso programático
Verificado el

DigitalProductPassport en otros países: Albania · Bulgaria · Chequia · Croacia · Eslovaquia · Eslovenia · Grecia · Hungría · Polonia · Rumanía · Serbia · Unión Europea