El registro de DPP ya tiene documentación para desarrolladores

Kiril ShivachevKiril Shivachev•Publicado el •8 minutos de lectura
Panel de parcheo de fibra óptica con puertos numerados y cables amarillos

Basta un pasaporte erróneo para que no se registre ninguno de los otros 99 de la misma solicitud. Esta regla figura en la documentación del registro de pasaportes digitales de productos de la UE. La Comisión Europea la publicó el 30 de octubre de 2026 y la Dirección General de Mercado Interior, Industria, Emprendimiento y Pymes la anunció oficialmente el 16 de noviembre. Es la primera vez que se describe por escrito cómo entra un pasaporte en el registro. Por ahora, sin embargo, solo tenemos la descripción. Las funciones de prueba irán apareciendo de forma gradual antes de que el registro esté plenamente operativo.

Qué publicó la Comisión el 30 de octubre

En su página de recursos sobre el pasaporte digital de producto, la Comisión colgó seis documentos técnicos, todos en la versión 1.0, con fecha de 30 de octubre de 2026 y solo en inglés. Tres de ellos son los que más interesan a fabricantes e importadores:

  • la API Integration Guide explica cómo se envían los pasaportes para su registro y cómo se hace el seguimiento del resultado;
  • la Semantic Data Guide establece con qué esquemas y vocabularios comprueba el registro los datos;
  • la Self-Hosted Authentication Guide describe cómo debe responder al registro el servidor en el que está alojado el pasaporte.

Los otros tres son las especificaciones OpenAPI, los archivos de artefactos semánticos y la guía de cuentas de servicio (Service Account guide).

El registro funciona desde el 20 de julio de 2026, pero hasta ahora solo podían darse de alta en él organizaciones. La guía para operadores económicos todavía indica que, por el momento, no es posible registrar un pasaporte con éxito. Los nuevos documentos describen cómo se hará. Si antes quiere saber qué es el registro, escribimos sobre su puesta en marcha en julio.

Cinco endpoints, hasta 100 pasaportes por solicitud, todo o nada

La interfaz de registro de pasaportes digitales de producto, descrita en la API Integration Guide v1.0 del 30 de octubre de 2026, tiene exactamente cinco endpoints públicos. El primero devuelve la lista de grupos y subgrupos de productos que acepta el registro. El segundo recibe los pasaportes que se van a registrar. Los otros tres muestran en qué punto está el procesamiento: la lista de tareas, el estado de una tarea concreta y el resultado de cada pasaporte por separado (en JSON o CSV).

Los pasaportes no quedan registrados al instante. Usted envía una solicitud, el registro responde con el código 202 y un número de tarea, y el resultado lo consulta más tarde. Cada solicitud lleva una clave obligatoria (Idempotency-Key). Gracias a ella, si se corta la conexión y vuelve a enviar la misma solicitud, no se crean duplicados.

Los límites son concretos:

  • de 1 a 100 pasaportes por solicitud, con un máximo de 10 MB en total;
  • un solo grupo de productos y un solo subgrupo por solicitud (por ejemplo, baterías, subgrupo LMT);
  • la solicitud es atómica: si un solo pasaporte no cumple los requisitos, no se registra ninguno.

Esta última regla tiene una consecuencia práctica directa. Si es usted importador y recibe pasaportes de varios proveedores, le conviene enviar una solicitud distinta para cada uno. De lo contrario, un error en los datos de un proveedor frenará también los pasaportes de los demás. Los pasaportes corregidos se envían en una nueva solicitud, con una nueva clave.

El identificador único debe ser una dirección web que abra el pasaporte

Según la documentación de la API de la Comisión, el identificador único de producto (UPI) debe ser una URL HTTPS de entre 8 y 2000 caracteres. El registro no recibe el pasaporte en la solicitud, sino su dirección. La abre en el momento de la comprobación y verifica el contenido conforme al Reglamento de Ejecución (UE) 2026/1778. Si la dirección no se abre, el error es UPI_NOT_RESOLVABLE y, como la solicitud es atómica, se rechaza la solicitud completa. El registro no guarda el contenido que ha leído.

Por eso el orden es estricto: primero publica el pasaporte y después lo registra. Un proveedor que le diga «lo subiremos cuando usted lo haya registrado» invierte la secuencia, y usted no conseguirá registrarlo. El simple número de serie de su sistema tampoco es un UPI. Puede formar parte de la dirección, pero el registro exige una dirección que funcione.

La guía de alojamiento propio (Self-Hosted Authentication Guide) añade algunas reglas para el servidor donde está el pasaporte. La parte pública debe abrirse sin iniciar sesión y con un máximo de tres redirecciones. Los datos protegidos solo se entregan cuando el registro presenta un token firmado por el sistema de autenticación de la Comisión, válido durante 120 segundos como máximo. Si el token no es válido, el servidor debe denegar el acceso. No puede devolver sin avisar la versión pública en lugar de la protegida.

Antes de la primera solicitud: una organización verificada y una cuenta de servicio

El registro de DPP solo acepta solicitudes de organizaciones que han superado una verificación. La verificación se hace con un sello electrónico cualificado, y aquí es donde las empresas tropiezan a menudo, porque una firma electrónica normal no sirve. Lo explicamos en detalle en el artículo sobre el sello electrónico. La condición de organización verificada dura hasta que caduca el sello, pero nunca más de tres años. Después, el registro no acepta nuevos registros ni cambios hasta que se renueve la verificación.

Las solicitudes a la API las envía una cuenta de servicio (service account). La guía de cuentas de servicio, también del 30 de octubre, fija estos límites:

  • la cuenta la crea el administrador de la organización y recibe el rol «Register DPPs»;
  • una organización puede tener como máximo 5 cuentas de este tipo;
  • cada cuenta puede tener hasta 2 claves activas, con una validez recomendada de un año y máxima de dos;
  • la clave privada es responsabilidad del operador económico: es él quien la genera, la custodia y la controla.

Según la guía para operadores económicos, no se prevé que el registro cobre una cuota de suscripción. Los costes reales son el sello y la integración.

JSON es el único formato obligatorio y, por ahora, solo las baterías tienen esquemas

La guía semántica de la Comisión (Semantic Data Guide v1.0) indica que para el registro se exigirá JSON, porque es el único formato obligatorio según la norma EN 18216:2026. JSON-LD y XML también se comprueban si los envía, pero no son obligatorios. Para las pymes es una buena noticia: no necesitan datos enlazados (linked data) ni RDF para registrar un pasaporte.

Por ahora solo hay esquemas y vocabularios concretos para las baterías, en tres subgrupos: baterías de vehículos eléctricos, baterías industriales y baterías de medios de transporte ligeros (LMT). Los textiles, los muebles, el hierro y el acero y los productos de construcción comparten el núcleo común de 12 conceptos básicos (identificador, estado, fecha de la última modificación, idioma y otros), pero todavía no tienen esquemas propios. Los recibirán con el acto delegado de cada grupo. La interfaz de registro será la misma; solo cambiará el grupo de productos indicado en la solicitud.

Algunas cosas aún no están claras. Los documentos no incluyen un catálogo completo de códigos de error ni límites al número de solicitudes, y no describen el formato del identificador que devuelve el registro. Tampoco se ha anunciado cuándo empezará el registro a aceptar pasaportes de prueba para baterías. La Comisión celebra un seminario web sobre la API y el modelo semántico el 26 de noviembre de 2026. Recogeremos las novedades en nuestra página de cambios normativos.

Qué puede preparar antes de que estén disponibles las funciones de prueba

Con la documentación del registro del 30 de octubre puede empezar a prepararse ya, sin esperar a que el registro esté plenamente operativo:

  • compruebe si su organización tiene un sello electrónico cualificado y cuándo caduca;
  • decida quién será el administrador en el registro y dónde se guardarán las claves privadas de la cuenta de servicio;
  • pida a sus proveedores que le confirmen que sus pasaportes estarán publicados en una dirección HTTPS que funcione antes de que usted los registre;
  • planifique las solicitudes por subgrupo de productos y por proveedor, para que un solo error no lo detenga todo.

En WIARA desarrollamos la plataforma DigitalProductPassport conforme a las guías en su versión 1.0: los pasaportes se publican en JSON en una dirección permanente y el identificador verificado de cada organización se guarda como un ajuste aparte. Probaremos el registro en el entorno de la Comisión cuando las funciones de prueba estén disponibles. La clave privada para el registro se queda en sus manos, no en las nuestras. Si quiere saber qué significa esto para sus productos, escríbanos.

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