ZincirX ZincirX

Documentación

Guía de Inicio Rápido

¡Bienvenido a ZincirX! Esta guía le ayudará a comenzar con nuestra plataforma de gestión de cadena de suministro basada en blockchain.

Paso 1: Conecte su Billetera

  1. Instale la extensión de navegador MetaMask si aún no lo ha hecho
  2. Cree o importe su billetera
  3. Visite ZincirX y haga clic en "Conectar Billetera"
  4. Apruebe la conexión en MetaMask
  5. Cambie a la Red Scimatic (Chain ID: 481) cuando se le solicite

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
  • Seguimiento de ejecución de pasos en tiempo real
  • 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 direcciones de billetera, 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 verifican la autenticidad del producto

Integración API

Autenticación

ZincirX utiliza autenticación basada en billetera. Para integrar con nuestra API:

  1. Firme mensajes con la clave privada de su billetera
  2. Incluya la dirección de la billetera en las solicitudes API
  3. Verifique las firmas en la red Scimatic

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

Integración Blockchain

Red Scimatic

  • Chain ID: 481
  • Network Name: Scimatic
  • Currency: SCI
  • Type: Enterprise blockchain network

Integración de Contratos Inteligentes

ZincirX opera en modo híbrido, combinando almacenamiento en base de datos tradicional con verificación blockchain. Las operaciones clave de blockchain incluyen:

  • Registro y verificación de plantillas
  • Registros de creación de lotes y finalización de pasos
  • Pistas de auditoría inmutables para todas las operaciones
  • Flujos de trabajo de múltiples firmas para operaciones críticas

Mejores Prácticas

Seguridad

  • Mantenga seguras las claves privadas de su billetera y nunca las comparta
  • Realice copias de seguridad periódicas de su billetera y frases de recuperación
  • Verifique todos los detalles de la transacción antes de firmar
  • 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 Conexión de Billetera

  • Asegúrese de que MetaMask esté instalado y desbloqueado
  • Verifique que esté en la red correcta (Scimatic - Chain ID: 481)
  • Borre la caché y las cookies del navegador
  • Intente desconectar y reconectar su billetera

Fallos en Transacciones

  • Verifique su saldo de SCI para las comisiones de gas
  • Asegúrese de que la conectividad de red sea estable
  • Espere a que las transacciones anteriores se completen
  • Intente aumentar el límite de gas si las transacciones fallan

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 específica sobre blockchain
  • Consultoría de soluciones personalizadas
Comenzar Ahora