ZincirX ZincirX

Documentación

Guía de Inicio Rápido

¡Bienvenido a ZincirX! Esta guía le ayudará a comenzar con nuestra plataforma de trazabilidad de la cadena de suministro.

Paso 1: Cree su Cuenta

  1. Visite ZincirX y haga clic en "Registrarse"
  2. Introduzca su nombre y su dirección de correo electrónico
  3. Elija una contraseña de al menos ocho caracteres, o bien regístrese con su cuenta de Google o Facebook
  4. Acepte las Condiciones del Servicio, la Política de Venta, Entrega y Reembolso y las Condiciones de Tratamiento de Datos, y lea la Política de Privacidad
  5. Inicie sesión con la cuenta que acaba de crear

Paso 2: Complete la Incorporación

  1. Proporcione su dirección de correo electrónico para notificaciones
  2. Verifique su correo electrónico a través del enlace de confirmación
  3. Ingrese la información y categoría de su empresa
  4. Complete la configuración de su perfil comercial

Paso 3: Cree su Primera Plantilla

  1. Navegue a la sección de Plantillas
  2. Haga clic en "Crear Nueva Plantilla"
  3. Defina los pasos del proceso de su cadena de suministro
  4. Establezca los requisitos de validación para cada paso
  5. Guarde y active su plantilla

Paso 4: Comience a Rastrear Lotes

  1. Vaya a la sección de Lotes
  2. Cree un nuevo lote utilizando su plantilla
  3. Ejecute cada paso a medida que los productos avanzan por su cadena de suministro
  4. Cargue documentación y medios de respaldo
  5. Comparta enlaces de verificación con las partes interesadas

Conceptos Fundamentales

Plantillas

Las plantillas definen el proceso estándar para su cadena de suministro. Contienen una serie de pasos por los que los productos deben pasar, junto con los requisitos de validación para cada paso.

  • Definiciones de flujo de trabajo reutilizables
  • Requisitos de pasos personalizables
  • Controles de acceso basados en roles
  • Reglas de validación y dependencias

Lotes

Los lotes representan series de producción específicas o grupos de productos que siguen una plantilla. Cada lote tiene un UUID único para seguimiento y verificación.

  • Identificación única mediante UUID
  • Ejecución paso a paso, con la fecha y la hora de cada paso
  • Adjuntos de medios y documentos
  • Capacidades de verificación pública

Pasos del Lote

Pasos individuales dentro de la ejecución de un lote, cada uno con su propio estado, marcas de tiempo y documentación de respaldo.

  • Seguimiento de estado (pendiente, en_progreso, completado, fallido)
  • Registro de marcas de tiempo para cada cambio de estado
  • Datos de ubicación y coordenadas GPS
  • Adjuntos de archivos y notas

Perfiles Comerciales

Información de la empresa vinculada a las cuentas de usuario, que permite la colaboración multipartita y el acceso basado en roles.

  • Identificación y verificación de la empresa
  • Clasificación por categoría comercial
  • Información de contacto y preferencias
  • Gestión de permisos de acceso

Roles de Usuario y Permisos

Rol Permisos Caso de Uso Típico
Fabricante Crear plantillas, iniciar lotes, ejecutar todos los pasos Productores originales que crean y gestionan productos
Distribuidor Ejecutar pasos específicos, actualizar ubicaciones, agregar documentación Empresas de logística y distribución que manejan productos
Minorista Ver información de lotes, ejecutar pasos finales, verificación orientada al cliente Tiendas y establecimientos que venden al consumidor final
Inspector Ver todos los datos, agregar certificaciones, documentación de control de calidad Organismos reguladores y equipos de aseguramiento de calidad
Consumidor Verificación pública mediante códigos UUID/QR Clientes finales que consultan el recorrido registrado de un producto

Integración API

Autenticación

ZincirX utiliza autenticación mediante tokens de API (Laravel Sanctum). Para integrar con nuestra API:

  1. Solicite un token enviando su dirección de correo electrónico y su contraseña a /api/auth/login
  2. Envíe ese token como bearer token en la cabecera Authorization de cada solicitud
  3. Los endpoints de verificación pública bajo /api/public no requieren token

Endpoints Principales

Operaciones de Lotes

  • GET /api/batches
  • POST /api/batches
  • GET /api/batches/{id}
  • POST /api/batches/{id}/steps/{stepId}/complete

Gestión de Plantillas

  • GET /api/templates
  • POST /api/templates
  • PUT /api/templates/{id}

Verificación Pública

  • GET /verify/{uuid}
  • GET /qr/{uuid}/image

Registros y Verificación

Dónde se Conservan sus Datos

  • Almacenamiento: La base de datos propia de ZincirX, en servidores que operamos
  • Revisiones del pasaporte: Solo se añaden: un cambio se registra como una nueva revisión y se conservan las anteriores
  • Archivos de prueba: Cada archivo subido lleva una huella SHA-256, de modo que puede demostrarse que no ha cambiado
  • Disponibilidad: Un pasaporte sigue accesible durante el plazo vendido con él, diez años de forma predeterminada, contados desde el día en que se emite

Funciones de Verificación

Los registros de la cadena de suministro se conservan en la propia base de datos de ZincirX, en sus propios servidores. La plataforma está diseñada para que terceros puedan verificar esos registros:

  • Registro de plantillas, incluido un GTIN opcional para el producto
  • Registros de creación de lotes y de finalización de pasos, con marcas de tiempo
  • Una huella SHA-256 para cada archivo cargado, para poder demostrar que el archivo no ha cambiado
  • Revisiones del Pasaporte Digital de Producto que solo se añaden: un cambio se registra como una nueva revisión y las anteriores se conservan

Mejores Prácticas

Seguridad

  • Utilice una contraseña segura y única para su cuenta de ZincirX y nunca comparta sus datos de inicio de sesión
  • Revise periódicamente los miembros de su empresa y retire los accesos que ya no sean necesarios
  • Compruebe los detalles de un paso y los archivos adjuntos antes de marcarlo como completado
  • Utilice contraseñas seguras para su cuenta de correo electrónico empresarial

Gestión de Datos

  • Proporcione información precisa y completa para cada paso
  • Cargue archivos multimedia claros y relevantes para la verificación
  • Utilice convenciones de nomenclatura consistentes para lotes y plantillas
  • Revise y actualice periódicamente su perfil comercial

Colaboración

  • Comparta el acceso a los lotes con los socios relevantes de la cadena de suministro
  • Comunique claramente los requisitos de cada paso a todos los participantes
  • Utilice códigos QR para facilitar la verificación por parte de los clientes finales
  • Mantenga una comunicación regular con su red de cadena de suministro

Solución de Problemas

Problemas de Inicio de Sesión

  • Compruebe que ha introducido correctamente su dirección de correo electrónico y su contraseña
  • Si se registró con Google o Facebook, inicie sesión con el mismo proveedor
  • Borre la caché y las cookies del navegador
  • Utilice el enlace de restablecimiento de contraseña de la página de inicio de sesión si no recuerda su contraseña

Fallos en Lotes y Cargas

  • Compruebe que dispone de pasaportes (UUID) prepagados antes de crear un lote
  • Asegúrese de que la conectividad de red sea estable
  • Espere a que finalice una carga anterior antes de iniciar otra
  • Compruebe que cada archivo cargado no supera el límite de tamaño indicado en el formulario de carga

Problemas de Rendimiento

  • Utilice navegadores modernos (Chrome, Firefox, Safari)
  • Cierre las pestañas y aplicaciones innecesarias del navegador
  • Verifique la velocidad de su conexión a internet
  • Borre los datos del navegador y reinícielo si es necesario

Soporte y Recursos

Soporte de la Comunidad

Conéctese con otros usuarios de ZincirX y obtenga soporte impulsado por la comunidad para sus preguntas y desafíos.

  • Foros y discusiones de usuarios
  • Compartición de mejores prácticas
  • Solicitudes de funciones y comentarios

Soporte Técnico

Obtenga asistencia directa de nuestro equipo técnico para problemas de integración y específicos de la plataforma.

  • Soporte de integración API
  • Orientación sobre el Pasaporte Digital de Producto y GS1 Digital Link
  • Consultoría de soluciones personalizadas
Comenzar Ahora