El contenedor es contexto
Un paquete va en un palé y el palé en un contenedor: el registro identifica la carga en cada nivel, no el recipiente permanente. El contenedor ya tiene su código BIC (ISO 6346) y su precinto; entran como enlaces del PID.
Cómo funciona
Del alta a la historia sellada, en siete pasos.
Una unidad en tránsito recibe su documento en el alta, se ata al objeto por su firma física y acumula una historia que cualquiera puede verificar con herramientas estándar, sin depender del registro.
Alta
Quien registra envía el perfil de la unidad (paquete, palé cargado, saca…), la clase de captura (estación, móvil con SDK, dispositivo de terceros o API) y, si quiere, medidas, peso, evidencias y un SSCC u otras referencias. Las evidencias pueden subirse o enviarse solo como huellas SHA-256 si el cliente las conserva. Declara que no sube datos personales fuera de las imágenes.
PID y llave de la unidad
El registro genera 60 bits aleatorios, comprueba que no existen y emite el PID con sus dos símbolos de control. Devuelve una sola vez la llave (pidk_…): da control total sobre esa unidad y nada más. Las estaciones sin red usan bloques de PID reservados por adelantado por dispositivos homologados.
Firma física
Se calcula la «biometría» de la unidad: geometría, peso, forma 3D, parches de textura del cartón en posiciones fijas, trazado de la cinta, disposición de la etiqueta, aspecto y mapa de daños. Objeto compacto, sin datos personales: nunca texto OCR ni recortes de etiqueta.
Acta sellada y anclada
Todo queda en un acta en JSON canónico (RFC 8785). Su huella SHA-256 la firma el dispositivo (opcional, sube el nivel) y siempre el registro (Ed25519), y entra en un libro solo de añadir. Cada día UTC se cierra en un árbol Merkle (RFC 6962), una declaración firmada y encadenada con la del día anterior y un ancla en Bitcoin con OpenTimestamps.
Resolución pública
El ID se resuelve en su URL, por QR o por API. Cualquiera ve si existe, cuándo se registró, con qué clase y nivel, su estado, su linaje, el último avistamiento verificado y las huellas para verificar el acta. Nunca imágenes, medidas, peso, referencias privadas ni quién lo registró. Un SSCC enlazado en público resuelve en /00/{SSCC}.
Avistamientos
Una nueva captura de la misma unidad reclama el ID y se compara 1:1 con la firma del alta: coincide, a revisar o no coincide, con puntuación por rasgo y una explicación. Un «no coincide» también se registra. Es un servicio de los operadores.
Linaje
Una unidad es un estado, no un objeto. Si se abre, consolida, divide o reembala, nace un PID nuevo enlazado a sus padres, que pasan a «sustituido». La historia completa se sigue por el grafo.
Alcance
Qué recibe un PID y qué no.
PARCID es la identidad de lo que viaja: unidades físicas en tránsito sin emisor permanente. Entra en el registro lo que cumple a la vez cuatro condiciones.
No tiene emisor permanente
Ni número de serie propio grabado ni un registro que ya lo identifique.
Cambia de estado
Se cierra, se abre, se consolida o se reembala durante el viaje.
Cambia de custodia
Pasa por manos distintas: remitente, almacén, transportista, destinatario.
Vive poco
De horas a meses: nace al cerrarse y muere al entregarse.
| Perfil | Qué es | Alcance en v0.1 |
|---|---|---|
parcel | Caja, sobre, bidón o bulto cerrado que viaja como una pieza | Núcleo: niveles 0 a 3, captura de estación |
pallet_load | Un palé cargado: la carga estibada y enfardada, no el palé de madera | Niveles 0 a 2; rasgos propios en v0.2 |
container_load | La carga estibada dentro de un contenedor | Niveles 0 a 2; rasgos propios en v0.2 |
tote | Cubeta, jaula, roll, barril: envases reutilizables | Niveles 0 a 2; rasgos propios en v0.2 |
bag | Saca postal, valija o equipaje | Niveles 0 a 2; rasgos propios en v0.2 |
crate | Caja de transporte de arte, instrumentos o maquinaria | Niveles 0 a 2; rasgos propios en v0.2 |
El vehículo es custodio
La furgoneta o el camión no reciben PID: tienen VIN y matrícula, y la matrícula identifica a una persona. Entran como custodio de la unidad, con una referencia opaca, nunca la matrícula en claro.
La maleta es la unidad
La etiqueta de equipaje se emite para cada viaje; la maleta es la misma en todos. Con el perfil bag, la maleta conserva su PID y la etiqueta del viaje se enlaza como bag_tag.
PARCID no identifica cosas en general: identifica unidades mientras viajan, y les da contexto con lo que ya tiene registro propio.
Anatomía de un acta
Cada acta se puede verificar sin preguntarnos.
Con el acta, la clave pública del registro y la prueba de inclusión, cualquiera recalcula la huella, comprueba la firma, sigue la ruta Merkle hasta la raíz del día y comprueba que la declaración diaria está firmada, encadenada y anclada en Bitcoin.
- Recalcular record_hash sobre el JSON canónico
- Comprobar la firma Ed25519 con la clave publicada
- Seguir la prueba de inclusión hasta la raíz Merkle del día
- Comprobar la declaración diaria y su prueba OpenTimestamps en Bitcoin
Niveles de garantía
Confianza calibrada, no unicidad absoluta.
Ningún rasgo físico es único como una huella dactilar. Cada alta dice cómo se capturó y con qué nivel. Una unidad registrada en nivel 1 que pasa por una estación obtiene un avistamiento de nivel 3 y su resolución muestra el mejor nivel alcanzado.
Registrado (sin verificar)
unverifiedAlta por API sin firma de dispositivo ni evidencias verificadas.
Firmado
signedFirma Ed25519 de la clave del cliente, secuencia válida, al menos 2 evidencias con hash, medidas o peso.
Atestado
attestedLo anterior + atestación del dispositivo o dispositivo homologado + nonce de frescura + firma física con parches de textura.
Estación
stationLo anterior en estación registrada con geometría normalizada, báscula calibrada, nube de puntos y coherencia multisensor + sello RFC 3161.
Qué hay que subir para crear un ID
| Nivel | Qué se sube | Qué distingue |
|---|---|---|
| Mínimo (L0) | Nada obligatorio salvo la clase de captura. Opcional: medidas y peso. | Solo el documento: sirve para enlazar referencias (un SSCC, un seguimiento), no para reconocer la unidad. |
| Básico (L1) | Medidas y peso con tolerancias, 2 fotos (cenital y perspectiva) o sus hashes, firma Ed25519 del cliente. | Separa el paquete de la mayoría de los que viajan el mismo día por la misma ruta. |
| Recomendado (L2) | Lo anterior + parches de textura en 4 posiciones fijas, trazado de la cinta, disposición de la etiqueta (sin su contenido), atestación del dispositivo, nonce de frescura. | Separa dos cajas idénticas de fábrica recién cerradas. |
| Estación (L3) | Lo anterior en geometría normalizada (origen 0·0·0, reglas, cámaras fijas, luz propia) + nube de puntos + báscula calibrada + coherencia multisensor. | Comparable entre máquinas y en el tiempo: la «cabina de fotos de pasaporte» del paquete. |
Linaje
Abrir, consolidar o reembalar no rompe la historia.
Una caja cerrada, abierta, con el contenido fuera o reembalada no es la misma unidad: son estados distintos, cada uno con su PID, enlazados por actas firmadas por quien hace la operación. El hijo nace con llave propia.
| Operación | Padres → hijos | Estado de los padres |
|---|---|---|
open | 1 → 1 (la misma caja, abierta y vuelta a cerrar) | sustituido |
repack | 1 → 1 (otra caja) | sustituido |
consolidate | N → 1 | sustituidos todos |
split | 1 → N | sustituido |
attach | 1 → 1 (el mismo objeto gana una captura de nivel superior) | sigue activo: es un avistamiento, no linaje |
Lo que no es identidad
Se enlazan al PID. No lo sustituyen.
Número de seguimiento
Lo pone el transportista, se reutiliza y se copia.
SSCC
Identifica la unidad logística de un envío, no la unidad física ni su estado. Entra como clave de primera clase y resuelve en /00/{SSCC}.
Contenido de la etiqueta
Son datos personales y además se reimprime. Nunca entra en el registro.
Lo gratuito y lo que prestan los operadores