Trabajar con productos, pasaportes y versiones

La ficha de producto va primero

Un pasaporte siempre se construye a partir de un producto: empieza en Productos. La ficha contiene el nombre, los identificadores, la categoría y los datos del operador económico que después aparecen en el pasaporte.

Los números de artículo global se validan con dígito de control al introducirlos, y la plataforma puede buscar un duplicado exacto o un nombre similar antes de guardar. La categoría no se puede cambiar una vez que existen pasaportes, y un identificador publicado queda bloqueado, porque un pasaporte es prueba de lo declarado en un momento dado.

Redactar el pasaporte

1. Abre Pasaportes y elige Crear pasaporte.
2. Selecciona el producto; el formulario sigue el esquema de su categoría.
3. Rellena los campos que puedas respaldar con pruebas, con el formulario guiado o el editor JSON.
4. Guarda. Cada guardado produce una versión inmutable en lugar de sobrescribir el historial.

La validación es el espacio de cumplimiento

Ejecutar una validación evalúa la versión con el motor determinista de reglas para los mercados elegidos y guarda una ejecución: hallazgos con su gravedad y la regla que los origina, una puntuación ponderada con nota y una acción siguiente sugerida.

Un pasaporte sin validación no demuestra nada. Valida después de cada cambio relevante y lee los hallazgos: el motor indica qué exige una regla, no certifica el producto.

Versiones, diferencias y custodia

El historial de versiones lista cada versión guardada con su autor, y la vista de diferencias muestra los cambios campo a campo entre dos versiones: útil cuando alguien pregunta qué ha cambiado desde la versión que vio un cliente.

La misma página incluye la cadena de custodia (un titular activo a la vez, con transferencias registradas y emitidas como eventos EPCIS), la trazabilidad de refabricación, el arrendamiento, la serialización (división y fusión) y el panel de soportes QR, enlace digital GS1, DataMatrix y RFID.

Publicación

Publicar convierte una versión en pasaporte público. Revisa antes la vista previa pública y usa la ocultación de campos para lo comercialmente sensible: un campo oculto se elimina de la interfaz pública y de la página, y permanece oculto allí donde se reutiliza la carga pública, incluidos los justificantes y los flujos de canales.

Después de publicar, sigue trabajando en la versión siguiente. La versión publicada sigue disponible hasta que publiques una más reciente.

Componentes y pasaportes anidados

En un pasaporte, abre Components para registrar la estructura del producto: cada línea puede enlazar un pasaporte de tu organización, un pasaporte de componente publicado por otro emisor (https o GS1 Digital Link) o ser solo estructura. Los enlaces son referencias, nunca copias.

El resumen señala pasaportes de componentes retirados, sin publicar o con hallazgos, y Used in lista los productos que contienen un pasaporte. Las líneas públicas aparecen en el pasaporte público con nombre, cantidad y enlace solamente; un componente retirado crea una acción urgente.

Artículos serializados a gran escala

Para trazabilidad por artículo sin un pasaporte completo por unidad, abre Items en un pasaporte: genera hasta 1.000.000 de números de serie por tarea, en segundo plano, o registra números existentes. Cada número se resuelve mediante su GS1 Digital Link hacia este pasaporte, y la página pública muestra el estado propio del artículo.

La exportación de impresión / codificación incluye para cada artículo la URI Digital Link (QR, NFC) y la cadena de elementos GS1 (DataMatrix, RFID), en archivos de 100.000 líneas.

Modelos y variantes

En Catálogo, Modelos y variantes, agrupa las variantes de un estilo o familia bajo un modelo: categoría, marca, ejes de variación (color, talla, capacidad) y datos de pasaporte comunes. Indica los valores por eje: cada combinación que falte se convierte en un producto con su referencia, su GTIN y un pasaporte que parte de los datos comunes. Las combinaciones existentes se omiten y un fallo no detiene las demás.

Cambia los datos comunes y aplícalos: cada pasaporte de variante afectado recibe una nueva versión validada, tras una vista previa. Los lotes y artículos serializados siguen bajo el pasaporte de cada variante (Modelo, Variante, Lote, Artículo). El pasaporte público de una variante indica su modelo y sus valores.

¿Puedo recuperar cambios antes de guardar una versión?

Crear y editar guardan automáticamente valores estructurados válidos tras una pausa en un borrador privado de organización y usuario, separado del historial inmutable. Restaura, descarga o descarta explícitamente la recuperación. Otra versión o esquema no se restaura automáticamente; los cambios de otra pestaña generan conflicto, no sobrescritura.

La recuperación caduca tras 30 días; la limpieza programada elimina borradores anteriores. Se avisa antes de cerrar con cambios sin confirmar. El JSON de desarrollador inválido no se guarda ni se incluye en la descarga estructurada: copia su texto aparte. Guardar/Crear conserva el proceso habitual de validación y publicación.

¿Cómo descargo el paquete de auditoría?

Propietarios y administradores eligen una versión en Evidence & audit package y descargan la instantánea JSON interna: versión inmutable, validaciones y aprobaciones de esa versión, enlaces, manifiesto de hashes y revisiones, respuestas de proveedores e historial de auditoría acotado. No incluye archivos, claves de almacenamiento, tokens de invitación ni URLs firmadas.

Las revisiones y respuestas reflejan la hora de exportación, no necesariamente la creación de la versión. El checksum SHA-256 canónico detecta cambios, pero no es firma ni certificación. Trata la descarga como información interna confidencial.

¿Qué ven los lectores en el pasaporte público?

El pasaporte público presenta los datos publicados en grupos etiquetados - identificadores, fabricante, bloque de la categoría, materiales, etc. - con las unidades en los valores, los valores codificados por su nombre y las listas de registros como tablas. Debajo de los datos muestra la credencial de autenticidad, los campos que no se muestran públicamente y quién puede leerlos, y enlaces a formatos legibles por máquina: JSON del pasaporte, JSON etiquetado, Asset Administration Shell, el linkset de GS1, el pasaporte de materiales para recicladores, la credencial y las claves y el DID del emisor.

El código QR de la página codifica el GS1 Digital Link del producto cuando tiene GTIN, que la plataforma resuelve al pasaporte, con la zona de silencio de cuatro módulos que necesitan los lectores. Si introduce su propio enlace en el campo del soporte de datos, asegúrese de que su resolutor envía ese GTIN a este pasaporte.

Referencia página por página

Estas páginas se revisaron en la consola de la organización el 8 de octubre de 2026 con una organización de ejemplo aislada. Los controles pueden variar según el rol, el plan, el estado del registro y los proveedores configurados. Las explicaciones prácticas y los nombres de los controles siguientes siguen la interfaz en inglés revisada.

Products (/products)

The catalogue contains stable product identities and the identifiers used by passports, stores and GS1 links. Counts distinguish the organization total from the current filtered result.

Use search and category filters to narrow the catalogue, then compare the filtered count with the organization total. Open an identity to edit it or start a passport, and inspect selected rows before a bulk action because selection is page-scoped. Export a CSV when a snapshot of catalogue identities is needed outside the console.

A product category is constrained once passports exist, and a published GTIN is protected.

Controles y opciones

• Search name, SKU, GTIN, brand or manufacturer, optionally filter Category, then Filter or Clear.
• Add product opens the identity form; Import CSV previews a spreadsheet; Shopify / WooCommerce opens store connections.
• Export CSV downloads the catalogue. Select rows for the available bulk actions, or open a product to inspect and edit its record.
• The table's checkboxes select only the current page; confirm the visible selection before a bulk action.

Create product (/products/new)

Product identity combines name, SKU, category, optional GTIN and model number with brand, image URL, workspace and economic operator details.

Decide the category and stable SKU before saving because later passports use those identifiers and the category's schema. Add GTIN only after confirming ownership and format; optional operator and image fields can be completed from reliable source data. Choose Save and create passport only when you are ready to start the first declaration.

A product record is not a published passport.

Controles y opciones

• Enter a unique SKU and choose the correct category before saving; the category drives the passport form and validation pack.
• Use GTIN only when it belongs to this product; the form checks format and ownership constraints.
• Save product only creates the catalogue record; Save & create passport continues into the initial declaration.
• Review any duplicate suggestion before creating another record for the same physical product.

Product detail (/products/[id])

The current identity and editable fields sit together so you can confirm what passport versions refer to.

Confirm name, SKU, GTIN, category, and economic-operator details against the physical product before updating them. The page links to passports that use this identity, so a changed field can affect downstream consistency. Restricted edits or deletion may be refused once versioned or published records depend on the product.

Changing a category or GTIN may be refused after passports or publication exist.

Controles y opciones

• Save product updates allowed identity and operator fields after validation.
• View passports opens the linked passport list; Create passport starts another passport for this product where allowed.
• All products returns to the catalogue.
• Delete product is restricted and should be used only when the record is eligible; published records retain their trace.

Models and variants (/models)

A model groups a product family under shared category, brand and passport data. Each variant remains its own product and passport.

Create a model for a stable product family before generating variants. Category, code, brand, workspace, and variant axes define which individual products can belong to it. Creating the family does not create its combinations; inspect the detail page to decide which variant values and shared passport data should be applied.

Choose the category carefully because variants inherit it.

Controles y opciones

• Open a model row to inspect its variant axes and products.
• New model requires a code, name and category; optionally choose brand and workspace.
• Variant axes such as colour and size define which value combinations can be generated later.
• Create model stores the family; it does not create every variant until you use Generate on the detail page.

Model detail (/models/[id])

The model page lists variants and lets an editor generate combinations, maintain shared passport data or attach existing products.

Preview the combination list and SKU/name pattern before generating variants to avoid unwanted product identities. Shared passport data can be saved as a model template, then previewed and deliberately applied to existing variants; it is not an automatic silent rewrite. Review skipped or failed combinations and the resulting passport revisions individually.

Generation reports each failed or skipped combination separately.

Controles y opciones

• Enter values for each axis, check the SKU and name patterns, optionally supply GTINs, and Generate missing combinations.
• Save shared data changes the model template; Preview on variants shows differences before Apply to variants writes new passport versions.
• Add an existing product as a variant only when its category and axis values fit this model.
• Remove from model unlinks a variant without deleting its product or passport.

Passport portfolio (/dpps)

The list is the working entry point for draft, active, archived and recalled passports, with filters, bulk actions and direct links to each record.

Filter the portfolio before selecting rows so the intended passports are visible. Bulk publication and lifecycle actions are state- and role-dependent, and one item can fail while others succeed; read the per-item result. Open a record for evidence, history, visibility, and validation instead of relying on list status alone.

A bulk action can partially succeed; read the result for every item.

Controles y opciones

• Search by product and filter Status or Category; Filter applies and Clear resets the list.
• New DPP starts a passport for an existing product; Import CSV can create products and draft passports together.
• Select rows to use Publish, Archive or Recall where your role and each record state permit; review the per-item result.
• Merge selected combines eligible serialized outputs, while Print labels prepares carrier sheets for selected passports.
• Open enters one passport's detailed workflow.

Create passport (/dpps/new)

Choose a product and author its first structured passport version using the category schema.

Select an existing product first so the editor can load its category schema. Use guided fields for ordinary entry and Developer JSON only when you need to supply the complete structured payload. Save the first draft, inspect validation findings, and compare its public preview with the intended declaration before any release request.

Creating a passport does not claim that a draft pack is legally approved.

Controles y opciones

• Select the product; use the guided sections for supported fields or Developer JSON for a full structured payload.
• Fill identifiers, operator and category fields from reliable source material.
• Download the working JSON if you need an offline copy; a valid private working draft can be restored before the first save.
• Create DPP saves a draft version. Validate and review its public preview before publication.

Passport detail (/dpps/[id])

This long record brings product identity, version history, validation findings, obligations, dossiers, public visibility, localization, carriers and lifecycle tools into one place.

Work through this record in sequence: verify product identity and category, inspect evidence and provenance, run the intended market validation, then review public visibility and preview. Publishing freezes a versioned declaration; later edits create another revision. Lifecycle actions such as archive, recall, registry submission, and derived passports have different effects, so read each confirmation before applying it.

A high readiness score does not replace the legally reviewed pack or the accountable override needed for a draft pack.

Controles y opciones

• Use Evidence & audit package, Provenance, Components, Items and Custody to inspect traceability around the current version.
• Edit creates a new immutable revision; History compares revisions; Preview shows the current public projection.
• Validate EU or EU + UK stores rule findings. Resolve findings in the authoring form and rerun validation before publication.
• Publish or request a publication review according to role and pack status. Archive, Recall and Submit to registry have separate effects and confirmations.
• Public field visibility controls exactly which structured paths reach the public page and downstream exports; check the preview after changing it.
• QR, DataMatrix, GS1 Digital Link and AAS export reuse the published or previewed payload as labelled.

Edit passport (/dpps/[id]/edit)

Edits are staged against the current version and saved as a new version, preserving earlier declarations.

Choose the authoring mode that exposes the fields you need, and confirm any working-draft recovery before typing over current work. Saving creates a new immutable version; it does not rewrite a previous public declaration. Re-run validation and attach evidence to the new version, then inspect its preview before publishing it.

A new version needs its own validation and evidence links.

Controles y opciones

• Choose Guided, All fields or Developer JSON according to the data you need to edit.
• Use category sections, repeatable rows and field help to enter the source data; invalid JSON must be corrected before switching modes.
• Download current working JSON or restore the private working draft when the page offers recovery.
• Save creates the next version after schema validation; Cancel leaves the current saved version intact.

Passport version history (/dpps/[id]/history)

History lists saved versions and a field-level comparison so a reviewer can see exactly what changed.

Use the comparison to identify which field paths changed between two saved versions, not just that a version number increased. Preserve the chosen version number when discussing validation, evidence, or an audit package. Return to the current passport to see the latest working state, which may differ from a historical published snapshot.

A version row represents an immutable saved snapshot.

Controles y opciones

• Select two versions where the comparison controls appear.
• Read the From and To columns by field path; unchanged fields are omitted from the change list.
• Use Back to passport to return to the active record and its latest validation.
• Preserve the version number when referencing an audit package or evidence link.

Public preview (/dpps/[id]/preview)

The preview shows identity, visibility policy and the structured payload that a consumer would see.

Compare the public identity and structured data with the saved declaration and visibility policy. Look for both missing information and information that should remain private, especially after a redaction change. A published passport can expose the revised visibility projection immediately, so verify the live page after saving such a change.

For a published release, saving a visibility change affects the public projection immediately.

Controles y opciones

• Inspect Public identity for product, issuer and operator details.
• Check Visibility policy and Public structured data for paths withheld by redaction.
• Open live passport when a release is published; Back to passport returns to editing and validation.

Passport components (/dpps/[id]/components)

Structure rows represent parts of the product, optionally linking another passport, an external digital link or a supplier.

Add each part with a quantity and the relevant supplier or linked passport when known. Check whether the line should be visible to consumers, since a public component reference can expose more than an internal structure row. Use the reverse Used in list to understand where this passport is referenced by parent products.

A component link is a reference to another passport, not a copy of its data.

Controles y opciones

• Add a component with name, quantity and optional role, mass, supplier and linked passport.
• Public passport visibility controls whether the consumer sees the component name, quantity and link.
• Inspect Structure for linked component status and Used in for parent passports that reference this one.
• Edit or remove a line on the row where your role permits.