Referencia técnica

Un código corto, firmado y comprobable a simple vista

Esta página distingue el código de consulta que funciona en la web del formato objetivo de producción. El esquema de veinte bytes requiere implementación y auditoría criptográfica; la consulta de ejemplo no valida firmas reales.

Identidad visible. Trazabilidad conectada.

Doce características de la estampilla.

La propuesta de estampilla reúne la identidad de cada unidad y los datos de su medicamento. El QR abre la consulta; el código de barras representa el consecutivo de impresión de ejemplo.

Etiqueta ilustrativa de solución oral Traza de 120 ml, diseñada como una sola pieza.
Concepto visual de etiqueta. El QR funcional y los doce campos se consultan a continuación.

Los datos de la unidad, campo por campo

EMPRESA PÚBLICA Y/O PRIVADA EJEMPLO
Identificador único TRZ-7F2K-4K7Q-92FA
Territorio de destino Por definir en cada implementación
Nombre del medicamento Solución oral Traza
Contenido neto 120 ml
Forma y concentración Solución oral
No indicada
Fabricante o importador · registro sanitario Laboratorio Cerro Alto
RS-EJEMPLO
Sitio de consulta traza.technology
Consecutivo de impresión 000001 Consecutivo de ejemplo
Código de barrasCode 128
Fecha de emisión
Lote de producción LOTE-VS-26-012
Datos de ejemplo; no identifican un medicamento comercial ni una relación institucional existente. El territorio y las condiciones de impresión se definen en cada implementación. La imagen de etiqueta es un concepto ilustrativo, no una pieza lista para impresión ni una acreditación de seguridad física o validez fiscal. Consultar el QR no certifica el contenido del envase.
  1. Código QR

    Abre la URL pública de esta unidad. Una copia del gráfico conserva el mismo identificador.

  2. Identificador único

    El ID legible coincide con el QR y puede introducirse manualmente para consultar la unidad.

  3. Territorio de destino

    Se define para cada implementación. Aquí no se declara una jurisdicción ni una operación territorial real.

  4. Sitio de consulta

    El dominio visible indica dónde consultar la identidad, también fuera de esta página.

  5. Consecutivo de impresión

    Número de ejemplo de la pieza impresa. Es un campo distinto del identificador de la unidad.

  6. Código de barras

    Code 128 legible que codifica el consecutivo de ejemplo. No representa una identificación GS1 ni validación fiscal.

  1. Contenido neto

    El volumen se toma de la presentación registrada: 120 ml para esta unidad.

  2. Nombre del medicamento

    La denominación permite contrastar el envase con la ficha de la unidad consultada.

  3. Forma y concentración

    Forma farmacéutica y concentración correspondientes al medicamento de ejemplo.

  4. Responsable y registro sanitario

    Fabricante o importador y referencia sanitaria declarada. RS-EJEMPLO no representa una aprobación oficial.

  5. Fecha de emisión

    Fecha en que se emitió la identidad. Es distinta de producción, activación o vencimiento.

  6. Lote de producción

    Se conserva como campo propio y coincide con el lote de la unidad consultada.

Cinco requisitos que fijan el diseño

El ejemplo consultable usa el formato TRZ-XXXX-XXXX-XXXX y datos de un registro local. Los requisitos siguientes corresponden al diseño objetivo; no describen comprobaciones criptográficas ejecutadas por esta web.

  • Único a gran escala, sin coordinación central

    Varios procesos deben poder generar identificadores en paralelo sin consultarse entre sí ni arriesgar una colisión.

  • No adivinable

    Conocer un código no debe permitir derivar otros. Un correlativo simple sería enumerable: alguien imprimiría códigos válidos «futuros».

  • Comprobable sin consultar la base de datos

    El objetivo es validar la firma antes de consultar el registro. El esquema, las claves, su seguridad y el rendimiento deberán comprobarse en la implementación; esta web no ejecuta esa validación.

  • Corto

    Tiene que caber en un QR pequeño con corrección de errores suficiente para tolerar roces, humedad y una etiqueta curva.

  • Legible por una persona

    Si la cámara falla, el código se escribe a mano en la página de consulta. Eso obliga a agrupar caracteres y a incluir un dígito de control.

Código consultable de esta web · datos de ejemplo
TRZ-7F2K-4K7Q-92FA
https://traza.technology/verificar/?c=TRZ-7F2K-4K7Q-92FA&t=medicamentos

Anatomía del identificador

El formato objetivo reserva veinte bytes en cuatro partes. Es una propuesta de diseño pendiente de validación; no es el formato de doce caracteres de los códigos consultables en esta web.

  1. 1 byte Versión
  2. 1 byte Época de clave
  3. 10 bytes Identificador único
  4. 8 bytes Firma truncada
Versión. Permite cambiar el formato más adelante sin invalidar lo ya impreso. Época de clave. Direcciona la clave con la que se firmó. Rotar claves no invalida el histórico. Identificador único. La emisión y la posición dentro de ella, cifradas para no revelar orden ni volumen. Firma truncada. Campo previsto para un autenticador. El esquema criptográfico y su seguridad requieren validación independiente.
La distribución de bytes no demuestra seguridad ni constituye una firma ECDSA verificada. Una copia conserva el mismo identificador y no crea otra unidad. El formato definitivo y las medidas anticopia requieren validación en cada despliegue.

De veinte bytes a algo que se pueda leer y teclear

La representación objetivo propone Base32 Crockford con control de errores de escritura. El bloque siguiente es ilustrativo: no es un vector criptográfico de prueba ni un código reconocido por el registro de esta web.

En el formato objetivo, el dígito de control se comprobaría antes de consultar un servicio. El lector de esta web comprueba el formato del identificador de ejemplo; no implementa ese algoritmo ni valida una firma criptográfica.

La URL va en mayúsculas a propósito. El modo alfanumérico de QR codifica más información por módulo que el modo byte, así que el mismo contenido cabe en un QR una o dos versiones más pequeño: escanea antes y tolera más daño. El esquema y el dominio no distinguen mayúsculas, y el servidor acepta la ruta en mayúsculas.

Un dominio corto también importa: menos caracteres son menos módulos, y menos módulos permiten imprimir más pequeño con el mismo nivel de corrección de errores.

Formato objetivo ilustrativo · no consultable en esta web
TRZ-9FXK-2M4Q-J8TV-QH3N-7WPD-BL5R-XCK

URL en el QR (mayúsculas, modo alfanumérico):
HTTPS://T.EXAMPLE/V/9FXK2M4QJ8TVQH3N7WPDBL5RXCK

El código es su propio índice

La arquitectura objetivo propone direccionar el registro desde el identificador. Los beneficios descritos requieren implementación y medición; no son resultados comprobados por esta web.

La época direcciona la clave, así que no hay que probar claves. La firma descarta la basura sin tocar almacenamiento. La emisión embebida apunta directamente al único registro que contiene el pasaporte. Y la posición dentro de la emisión es la clave exacta de la fila.

Nada busca; todo direcciona. Esa es la diferencia entre un identificador aleatorio —que obliga a consultar la base de datos incluso para descartar basura— y uno firmado, que decide válido o inventado antes de preguntar nada.

La validez de un código la prueba la derivación, no una fila guardada. Al emitir una orden se escribe un registro con su tamaño y su estado; las etiquetas existen matemáticamente desde ese momento. La fila de una etiqueta concreta nace en su primera consulta, de modo que solo las unidades que alguien mira ocupan espacio.

Consecuencia práctica: reimprimir un tramo años después produce exactamente los mismos bytes. No existen códigos perdidos, y un tramo archivado que alguien consulte vuelve a la vida sin romper la consulta.

Especificaciones de impresión

No hay hardware propietario: cada emisor imprime con su propia infraestructura. Lo que se fija es el mínimo que hace que el código se lea en una tienda con luz mala.

Simbología
QR modelo 2
El estándar más extendido en cámaras de teléfono.
Corrección de errores
Nivel M mínimo, Q recomendado
Tolera roces y suciedad sin dejar de decodificar.
Tamaño del módulo
≥ 0,33 mm
Por debajo, las cámaras de gama baja empiezan a fallar.
Zona quieta
4 módulos
El margen en blanco es parte del código, no decoración.
Tamaño impreso
≥ 22 × 22 mm
Referencia para el frasco de medicamento; se valida sobre el envase y sustrato elegidos.
Contraste
≥ 40 %
Medido sobre el sustrato real, no sobre la pantalla del diseñador.
Junto al código
Últimos caracteres legibles
El respaldo cuando la cámara no coopera.
Antes de la corrida, el emisor sube una muestra impresa y el sistema la comprueba: decodifica el QR, mide zona quieta y contraste y confirma que el código legible coincide. La muestra aprobada queda ligada a esa emisión.

Plantillas y salidas de impresión

El emisor elige una plantilla del sistema y no edita el layout: el sistema inyecta los datos. Así una etiqueta impresa hoy y otra dentro de un año son comparables.

  • Render determinista

    El mismo código con la misma versión de plantilla produce un archivo idéntico byte a byte. No hace falta almacenar artes: se vuelven a generar.

  • Para imprenta

    PDF vectorial de imposición, con marcas de corte y registro y sangrado, para tirar pliegos completos.

  • Para línea de producción

    Lenguaje nativo de impresora térmica, para etiquetar en línea a la velocidad de la máquina.

  • Para sobreimpresión

    Salida de solo capa variable, si el fondo de seguridad ya viene preimpreso en offset.

La impresión no depende de la conexión: el rango se descarga una vez y un proceso local alimenta la impresora, con cola propia y reporte diferido al reconectar.

Lo que sigue

La referencia de integración describe la API objetivo. La consulta pública permite explorar los códigos de ejemplo disponibles en esta web, con sus resultados y límites explicados.