Formatos de Datos e Infraestructura

1. Acerca de este registro

Este registro abarca los datos que las Condiciones del Servicio enumeran como exportables en su sección sobre la exportación de sus datos. Para cada formato indica la estructura de los datos, el estándar que sigue el formato, quién puede utilizarlo y dónde.

Todas las exportaciones que aquí se describen son gratuitas, tanto si las realiza usted mismo como si nos las solicita. Las exportaciones están disponibles durante toda la vigencia de su contrato y, una vez finalizado este, durante el período de recuperación de datos que establecen las Condiciones del Servicio.

Los formatos siguen los siguientes estándares y especificaciones abiertas.

• JSON, para el formato zincirx.dpp (sección 2) y para los datos propios de un titular de la cuenta (sección 7).
• JSON-LD, con un vocabulario que publicamos, entregado dentro de una credencial verificable del W3C (W3C Verifiable Credential), para cada pasaporte en formato de lectura mecánica (sección 3).
• GS1 EPCIS 2.0, para los pasos registrados del lote al que corresponde cada pasaporte (sección 3).
• GS1 Digital Link, para las direcciones de los pasaportes construidas a partir del GTIN de un producto y del número de lote asignado a un lote (sección 4).
• Códigos QR, como imágenes PNG, JPEG o SVG (sección 4).
• CSV y PDF, para las listas de lotes, los detalles de los lotes y los informes (sección 5).
• SHA-256, para las huellas de los archivos subidos (sección 6) y los resúmenes de los pasaportes exportados (sección 2).
• ZIP, para enviar muchos archivos juntos (sección 8).

Cualquier otra cosa que solicite se le envía en un formato estructurado, de uso común y de lectura mecánica (sección 8). La sección 9 enumera las restricciones y limitaciones técnicas que conocemos.

Mantenemos este registro actualizado y anunciamos en esta página cada modificación que se introduzca en él (sección 13).

2. Todos sus pasaportes en el formato zincirx.dpp

El formato zincirx.dpp es nuestro propio formato abierto para una copia completa de sus pasaportes. Un único archivo JSON contiene todos los pasaportes que su empresa ha emitido, en todos los niveles de acceso y con su historial completo de revisiones, junto con un manifiesto de resúmenes SHA-256.

Los propietarios y administradores de su empresa pueden descargarlo en cualquier momento, de forma gratuita, desde la página «Pasaporte Digital de Producto» de la aplicación web, mediante «Descargar todos los pasaportes». El archivo abarca la empresa en la que estén trabajando en el momento de la descarga.

El archivo consta de dos partes. La primera es un manifiesto. Indica el nombre y la versión del formato y el momento de la exportación; identifica a su empresa por su nombre, número de identificación fiscal, GLN, número EORI y país; indica el número de pasaportes; enumera el identificador de cada pasaporte con el resumen SHA-256 de ese pasaporte, y señala la fecha más tardía hasta la que cualquiera de los pasaportes deba permanecer en línea. Mientras firmemos los pasaportes (sección 3), indica también nuestro identificador de emisor y un resumen SHA-256 de esa lista de resúmenes.

La segunda parte contiene los pasaportes. Cada uno de ellos incluye lo siguiente.

• Su disponibilidad: el día en que se emitió y el día en que finaliza su plazo de disponibilidad.
• Sus identificadores: el identificador del pasaporte, la dirección de su página pública y, cuando estén definidos, su número de lote, su GTIN y su dirección GS1 Digital Link.
• El producto y el lote: el nombre, la descripción, la categoría y el grupo de productos del producto, y el nombre, la fecha de producción, el estado y la fecha y hora de creación del lote y, en el caso de un lote retirado, el motivo de la retirada.
• Sus atributos, cada uno con su clave, su valor, su etiqueta y su unidad, y el bloque y el nivel de acceso a los que pertenece: público, restringido o de las autoridades.
• Sus certificaciones.
• Sus revisiones: para cada modificación, qué se modificó, el valor anterior y el nuevo, quién hizo la modificación y cuándo.
• Sus eventos de trazabilidad: los pasos registrados del lote, como documento GS1 EPCIS 2.0 (sección 3).
• Sus evidencias: cada foto y cada documento adjuntos al lote y a sus pasos, enumerados con su nombre de archivo, tipo, tamaño y huella SHA-256.
• Sus datos enlazados: el pasaporte como documento JSON-LD en cada nivel de acceso (sección 3).

Cada resumen del manifiesto es el hash SHA-256 de ese pasaporte expresado en JSON compacto, con las claves de sus objetos ordenadas y con las barras y los caracteres no ASCII sin escapar, de modo que un mismo contenido da siempre el mismo resumen. Volver a calcularlo permite comprobar si un pasaporte del archivo es el que se exportó.

Las fotos y los documentos propiamente dichos no se incluyen en el archivo. Cada uno de ellos puede descargarse como se describe en la sección 6 y, previa solicitud, se los enviamos todos juntos (sección 8). Sus huellas le permiten comprobar que un archivo que usted tiene es el que quedó registrado.

Puede utilizar el archivo para sus propios registros, como copia de seguridad de sus pasaportes o para trasladarlos a otro proveedor o a sus propios sistemas.

3. Cada pasaporte en formato de lectura mecánica: JSON-LD y GS1 EPCIS 2.0

Cada pasaporte emitido está disponible además en dos versiones de lectura mecánica a través de nuestra interfaz de programación pública, en direcciones formadas a partir del identificador del pasaporte. Cualquier persona puede utilizarlas, de forma gratuita y sin iniciar sesión.

La primera es el pasaporte como documento JSON-LD. Contiene el producto, el lote, los atributos y las certificaciones del pasaporte, un apartado que indica lo que abarca el documento, como el grupo de productos y el hecho de que describe un lote, y un enlace a sus eventos de trazabilidad. Los datos del lote incluyen su dirección GS1 Digital Link, cuando la tiene.

El documento JSON-LD utiliza un vocabulario que publicamos en nuestro sitio web y que cada documento cita en su contexto, de modo que puede consultarse cada término que utiliza.

El documento se entrega dentro de una credencial verificable del W3C (W3C Verifiable Credential) que lleva nuestra firma digital, realizada con una clave Ed25519. Nuestra interfaz pública de verificación comprueba esa firma, lo que muestra que el documento procede de nosotros y no ha cambiado desde que lo firmamos; no muestra que su contenido sea cierto. En una solicitud también puede pedirse el documento sin la credencial.

La segunda son los eventos de trazabilidad del lote, como documento GS1 EPCIS 2.0 en JSON-LD. Contiene un evento por cada paso que se haya iniciado, con el momento en que ocurrió, el nombre del paso y, cuando se registró una posición, el lugar. Cada evento identifica el lote por su GTIN y su número de lote cuando ambos están definidos y, en caso contrario, por la dirección de su página pública.

El documento JSON-LD muestra únicamente los atributos públicos de un pasaporte. La excepción es una solicitud realizada con una autorización de acceso que su empresa haya concedido para el acceso restringido o de las autoridades: en ese caso, el documento muestra también los atributos del nivel de esa autorización. Una autorización puede abarcar un pasaporte, los pasaportes de una plantilla de producto o todos los pasaportes de su empresa, y quien la tiene la presenta en forma de token con cada solicitud.

El documento EPCIS muestra los pasos registrados del lote, que también se muestran en su página pública.

La copia completa, en todos los niveles de acceso, es el archivo zincirx.dpp (sección 2), que solo pueden descargar los propietarios y administradores de su empresa.

4. Direcciones de los pasaportes, GS1 Digital Link y códigos QR

Cada pasaporte tiene una dirección en nuestro sitio web, formada a partir de su identificador, en la que puede verse su página pública una vez emitido el pasaporte. Esa es la dirección que contiene su código QR, salvo que usted elija en su lugar la dirección GS1 Digital Link.

Cuando una plantilla de producto tiene un GTIN y un lote tiene un número de lote, el pasaporte tiene además una dirección GS1 Digital Link, construida a partir del GTIN y del número de lote conforme a lo previsto en el estándar GS1 Digital Link. Esa dirección conduce a la página pública del pasaporte y se incluye en el archivo zincirx.dpp y en el documento JSON-LD del pasaporte.

Los códigos QR pueden descargarse como imágenes en los siguientes lugares.

• En la página de un lote en la aplicación web, los titulares de cuentas que pueden ver el lote pueden descargar su código QR como imagen PNG o JPEG, o abrir una página de etiqueta lista para imprimir. En la página de etiqueta, cuando un pasaporte tiene una dirección GS1 Digital Link, puede ponerse esa dirección en su código QR en lugar de la otra.
• En «Mis UUIDs», en la aplicación web, puede descargarse como imagen PNG o SVG el código QR de cada pasaporte asignado a su empresa, emitido o aún no emitido.

Una vez emitidos pasaportes con un GTIN, ese GTIN no puede modificarse ni eliminarse de su plantilla de producto, de modo que las direcciones GS1 Digital Link impresas con él siguen conduciendo a esos pasaportes.

5. Listas de lotes, detalles de lotes e informes: CSV y PDF

Los titulares de cuentas pueden exportar desde la aplicación web los datos que pueden ver sobre los lotes de su empresa.

• La lista de lotes, en CSV o PDF, desde la propia lista de lotes, con los filtros que hayan aplicado. El archivo CSV tiene una fila por lote, con su identificador, su plantilla de producto, su estado, su fecha de producción, la dirección de correo electrónico del titular de la cuenta que lo creó, su fecha y hora de creación y su grado de avance en sus pasos.
• Los detalles de un lote, en PDF o CSV, desde la página del lote. El archivo CSV recoge los detalles del lote y, a continuación, una fila por paso, con su nombre, su estado y su ubicación, las posiciones registradas al inicio y al final del paso, la persona responsable, sus horas de inicio y de finalización y su duración. El PDF muestra además el código QR del lote.
• Los informes personalizados, en CSV, desde el apartado «Reportes», con los datos que cada informe esté configurado para mostrar.

Cada archivo CSV comienza con una línea de título y la fecha y hora en que se generó. A continuación, una lista de lotes contiene una única tabla; los detalles de un lote y un informe personalizado se organizan en bloques, cada uno con su propio encabezado. Los encabezados de los detalles de un lote están en el idioma que utiliza el titular de la cuenta.

Los archivos CSV están pensados para su procesamiento posterior, y los archivos PDF, para su lectura e impresión.

6. Fotos y documentos subidos

Cada foto y cada documento subidos a ZincirX se almacenan exactamente tal como se subieron. Los titulares de cuentas que pueden ver la plantilla, el lote o el paso al que pertenece un archivo pueden abrirlo y descargarlo allí, en esa misma forma.

Cualquier persona que visite la página pública de un pasaporte puede también abrir allí las fotos y los documentos que se muestran en ella.

Cada archivo recibe al subirse una huella SHA-256, que permite mostrar que el archivo no ha cambiado desde entonces. Las huellas de los archivos adjuntos a sus lotes y a los pasos de estos figuran en el archivo zincirx.dpp (sección 2).

Para recibir todas las fotos y todos los documentos de su empresa en una sola descarga, solicítenoslo (sección 8).

7. Los datos propios de un titular de la cuenta: JSON

Cada titular de la cuenta puede descargar una copia de sus propios datos en un archivo JSON, mediante «Descargar mis datos», en la página de su perfil en el sitio web, o mediante «Exportar Mis Datos», en la pantalla de perfil de la aplicación móvil.

El archivo incluye los datos de su cuenta, a saber, su nombre, su dirección de correo electrónico, su número de teléfono y cuándo se creó la cuenta; las empresas a las que pertenece, con su rol en cada una y cuándo se incorporó a ella, así como la dirección de correo electrónico, el número de teléfono, la ciudad y el país de la primera de ellas; las plantillas que creó, con sus nombres, descripciones y fechas y horas de creación; los lotes que creó, con sus identificadores, nombres, estados y fechas y horas de creación; y la fecha y hora de la exportación.

Se trata de los datos propios del titular de la cuenta. Los registros de su empresa se exportan como se describe en las secciones 2 a 6.

8. Todo lo demás, previa solicitud

Previa solicitud, le enviamos todo aquello que las Condiciones del Servicio enumeran como exportable y que usted no puede exportar por sí mismo como se describe en las secciones 2 a 7. Se lo enviamos de forma gratuita y sin dilación indebida, en un formato estructurado, de uso común y de lectura mecánica, como JSON o CSV, con los archivos tal como se subieron.

Esto incluye, por ejemplo, lo siguiente.

• Todas las fotos y todos los documentos de su empresa, en un único archivo comprimido ZIP, con cada archivo tal como se subió.
• Una lista de todos los identificadores de pasaporte asignados a su empresa, emitidos o aún no emitidos.
• El perfil de su empresa, así como sus miembros y los roles de estos.
• Sus plantillas y sus definiciones de pasos.
• Las estadísticas de escaneo que conservamos sobre sus pasaportes.
• Las autorizaciones de acceso que su empresa haya concedido y el registro de las lecturas realizadas con ellas.
• Sus pedidos y las facturas que se le hayan emitido.
• Los registros de qué versiones de nuestras condiciones se aceptaron en nombre de su empresa y de la confirmación, en cada compra, de que esta era definitiva.

Para solicitarlo, escriba a info@zincirx.com. Solo comprobamos que la solicitud procede de alguien facultado para actuar en nombre de su empresa, como un propietario o un administrador, o un proveedor al que usted haya autorizado para actuar en su nombre.

Los únicos datos excluidos de la exportación se enumeran en las Condiciones del Servicio, en su sección sobre la exportación de sus datos. Se trata de datos sobre el funcionamiento del propio ZincirX cuya exportación pondría en riesgo nuestros secretos comerciales o la seguridad del servicio.

9. Limitaciones conocidas

Estas son las restricciones y limitaciones técnicas que conocemos en cuanto a la exportación y el traslado de sus datos.

• No ofrecemos una interfaz de programación publicada para exportar una cuenta completa. La copia completa de sus pasaportes es el archivo zincirx.dpp, y lo que no cubren las secciones 3 a 7 se envía previa solicitud (sección 8).
• Nuestra interfaz de programación pública proporciona únicamente la parte pública de un pasaporte, o la parte que abarca una autorización de acceso, y limita el número de solicitudes que pueden realizarse en un período determinado.
• La firma de la credencial de un pasaporte se realiza mediante un método propio. Nuestra interfaz de verificación la comprueba, pero es posible que otros programas para credenciales verificables no la acepten.
• El archivo zincirx.dpp enumera cada foto y cada documento con su nombre, tipo, tamaño y huella, pero no contiene el archivo en sí.
• El archivo zincirx.dpp abarca una sola empresa cada vez. El propietario o administrador de varias empresas descarga un archivo por cada una de ellas.
• Las revisiones registran las modificaciones de los atributos, las certificaciones y el grupo de productos de un pasaporte. Las modificaciones de los pasos de un lote, como sus notas y ubicaciones, no se conservan como revisiones, como tampoco los archivos que su empresa elimina, por lo que las exportaciones muestran los pasos y los archivos tal como se encuentran en el momento de la exportación, sin versiones anteriores.
• Las fotos añadidas con la aplicación móvil se comprimen, y las grandes se reducen de tamaño, en el teléfono antes de subirse, por lo que el archivo que conservamos, y su huella, corresponden a esa copia procesada y no a la foto original del teléfono.
• Un archivo SVG descargado desde «Mis UUIDs» contiene el código QR como imagen de píxeles incrustada, no como formas vectoriales.
• Las exportaciones de las secciones 2, 5 y 6 se realizan en la aplicación web. El titular de la cuenta cuya cuenta esté suspendida, que aún no haya aceptado una nueva versión de nuestras condiciones o que actúe en nombre de una empresa que no tenga ningún paquete de pasaportes, como una cuyo plan anterior de duración determinada haya finalizado, no puede acceder a ellas allí. En ese caso, se las enviamos previa solicitud (sección 8), de forma gratuita.
• El traslado a otro proveedor no cambia adónde conducen los códigos QR ya impresos en sus productos. Siguen conduciendo a los pasaportes que alojamos nosotros (sección 12).

10. Dónde funciona el servicio y qué Derecho se aplica

ZincirX Bilişim Teknoloji ve Danışmanlık A.Ş. gestiona ZincirX desde Turquía, para nuestras dos sociedades. Cuando usted contrata con ZincirX Inc., ZincirX Bilişim Teknoloji ve Danışmanlık A.Ş. gestiona el servicio por cuenta de esta, y ZincirX Inc. sigue siendo responsable ante usted del servicio.

El servicio funciona en servidores facilitados por un proveedor de alojamiento. La tabla que figura al final de esta página indica el nombre del proveedor de alojamiento y el país en el que se encuentran los servidores.

Por consiguiente, la infraestructura está sujeta al Derecho del país en el que se encuentran los servidores y al Derecho de Turquía, donde está establecida ZincirX Bilişim Teknoloji ve Danışmanlık A.Ş., que la gestiona. La sociedad con la que usted contrata está sujeta asimismo al Derecho del país en el que está establecida: Turquía, en el caso de ZincirX Bilişim Teknoloji ve Danışmanlık A.Ş., y los Estados Unidos, en el caso de ZincirX Inc. La tabla lo resume.

Algunas partes del servicio dependen de otros proveedores. Los correos electrónicos que envía el servicio se entregan a través del servicio de correo del proveedor de alojamiento, que los transmite a un servicio de retransmisión de correo electrónico. Cuando un titular de la cuenta utiliza el asistente de IA, lo que escribe se envía a Google, que lo trata por cuenta nuestra para generar la respuesta, y nosotros no lo almacenamos.

Las Condiciones de Tratamiento de Datos (https://zincirx.com/data-processing) describen a los subencargados del tratamiento que tratan los datos personales incluidos en su contenido y, previa solicitud, le enviamos la lista actualizada de estos, con indicación del lugar en que cada uno de ellos los trata. La Política de Privacidad (https://zincirx.com/privacy) explica cómo se gestionan los mensajes enviados al asistente de IA.

Mantenemos esta información actualizada. Un proveedor de alojamiento nuevo o sustitutivo supone un cambio de subencargado del tratamiento, del que le informamos con antelación, como se describe en las Condiciones de Tratamiento de Datos.

11. Solicitudes de gobiernos y autoridades

Un tribunal o una autoridad pública de cualquier país puede pretender acceder a datos que conservamos o pedirnos que se los entreguemos. Estas son las medidas que adoptamos para que no se acceda a los datos que conservamos para usted, ni se transfieran, de un modo que entre en conflicto con el Derecho de la Unión Europea o con el Derecho del Estado miembro de que se trate.

Las aplicamos a todos los datos que conservamos para usted, sean o no datos personales, y con independencia del país en que se conserven.

• Solo damos a un gobierno o a una autoridad pública acceso a datos que conservamos para usted, o se los transferimos, cuando la ley nos obliga a ello, por ejemplo en virtud de una orden jurídicamente vinculante de un tribunal o de una autoridad competente, o cuando la ley nos exige comunicar la sospecha de un delito que amenace la vida o la seguridad de una persona. No lo hacemos de forma voluntaria.
• Antes de dar cumplimiento a una orden, comprobamos que tiene una base jurídica que nos vincula, que procede de un tribunal o de una autoridad facultados para dictarla y qué abarca exactamente.
• Cuando los datos se conservan en la Unión Europea y la orden procede de un tribunal o de una autoridad de un país no perteneciente a la Unión, solo le damos cumplimiento en las circunstancias que el artículo 32 del Reglamento de Datos de la UE establece para tales órdenes, por ejemplo en virtud de un acuerdo internacional entre ese país y la Unión o un Estado miembro.
• Solo revelamos el mínimo que exige la orden, según una interpretación razonable de esta.
• Antes de cumplir una solicitud, le informamos de ella. Solo nos abstenemos de informarle cuando la ley o la orden nos lo prohíben o nos exigen esperar, por ejemplo para proteger una investigación penal, y únicamente mientras así lo dispongan. Cuando los datos se conservan en la Unión Europea y la solicitud procede de fuera de la Unión, solo nos abstenemos de informarle cuando la solicitud sirve a fines de aplicación de la ley, y únicamente mientras el hecho de informarle comprometa esa labor.
• Dentro de nuestras sociedades, solo tiene acceso a sus datos el personal que lo necesita para operar el servicio, prestar asistencia técnica o garantizar su seguridad, y ese personal está obligado a mantener su confidencialidad.
• Los datos circulan entre los navegadores o las aplicaciones móviles y nuestros servidores a través de conexiones cifradas (HTTPS).
• Las contraseñas se almacenan únicamente en forma de hash, los titulares de cuentas pueden activar la autenticación en dos pasos, y el acceso a los datos de una empresa en el servicio depende de la pertenencia a esa empresa y del rol del miembro.

Estos compromisos forman parte de su contrato con nosotros, porque esta página forma parte de las Condiciones del Servicio. Cuando usted contrata con ZincirX Inc., un acuerdo escrito somete a ZincirX Bilişim Teknoloji ve Danışmanlık A.Ş., que opera la plataforma, a las mismas obligaciones de protección de datos que las Condiciones de Tratamiento de Datos (https://zincirx.com/data-processing) imponen a ZincirX Inc.

Las Condiciones del Servicio indican cómo procedemos ante una orden de actuar contra un contenido, y las Condiciones de Tratamiento de Datos indican cómo procedemos ante una exigencia legal de tratar los datos personales que figuran en su contenido.

12. Cambio de proveedor y salida del servicio

La forma de trasladar sus datos a otro proveedor o a sus propios sistemas, o de obtener su supresión, se establece en las Condiciones del Servicio (https://zincirx.com/terms), en la sección dedicada al cambio de proveedor, la salida del servicio y la supresión. Esa sección fija el plazo de preaviso, el período transitorio y el período de recuperación de datos, e indica qué se suprime y cuándo.

Los datos que puede exportar, y los únicos datos excluidos de la exportación, se enumeran en las Condiciones del Servicio, en la sección dedicada a la exportación de sus datos. Esta página indica los formatos en que esos datos están disponibles.

Las Condiciones de Tratamiento de Datos (https://zincirx.com/data-processing) indican cómo se devuelven y se suprimen los datos personales que figuran en su contenido cuando finaliza el servicio.

La exportación, el cambio de proveedor y la supresión son gratuitos. Durante un cambio de proveedor, le prestamos asistencia a usted y a cualquier proveedor al que usted autorice para actuar en su nombre, y, previa solicitud, le enviamos a usted, o a ese proveedor, las exportaciones descritas en esta página. También puede conceder a ese proveedor una autorización de acceso para que pueda leer sus pasaportes a través de nuestra interfaz de programación (sección 3).

Durante todo el plazo de preaviso y el período transitorio, ZincirX sigue funcionando con normalidad, incluidas la aplicación web, las páginas de sus pasaportes, las direcciones GS1 Digital Link y las interfaces de programación descritas en esta página, y usted puede realizar todas las exportaciones aquí descritas hasta que finalice el período de recuperación de datos.

Los códigos QR ya impresos en sus productos siguen conduciendo a los pasaportes que alojamos nosotros después de que usted traslade sus datos, como explican las Condiciones del Servicio en la sección dedicada a los códigos QR impresos tras su salida.

13. Modificaciones de esta página

Mantenemos esta página actualizada. Cuando añadimos, modificamos o retiramos un formato, un estándar o una interfaz, o cuando cambian el proveedor de alojamiento o el país de los servidores, lo anunciamos en esta página, y la fecha que figura al principio de la página indica la versión vigente.

Dado que esta página forma parte de las Condiciones del Servicio, una modificación que reduzca sus derechos surte efecto en la forma que las Condiciones del Servicio prevén para las modificaciones significativas.

Ninguna modificación le impide exportar sus datos de forma gratuita.

14. Contacto

Para solicitar una exportación, o si tiene alguna pregunta sobre los formatos, las interfaces o la infraestructura aquí descritos, escriba a info@zincirx.com o llame al número +90 536 587 41 81. Nuestra página de contacto, en https://zincirx.com/contact, indica ambos.

Estos mensajes los leen y responden personas. El asistente de IA no puede recibir solicitudes ni notificaciones.

Puede escribirnos en inglés, turco, alemán o español.

Los datos de nuestras sociedades figuran en el Aviso Legal (https://zincirx.com/legal-notice). Allí, entre esos datos, se indican nuestros representantes en la Unión Europea con sus datos de contacto, y, en lugar de dirigirse a ellos, siempre puede escribir a info@zincirx.com.