ZincirX ZincirX

Documentation

Guide de démarrage rapide

Bienvenue sur ZincirX ! Ce guide vous aidera à prendre en main notre plateforme de traçabilité de la chaîne d’approvisionnement.

Étape 1 : créez votre compte

  1. Rendez-vous sur ZincirX et cliquez sur « Créer un compte »
  2. Saisissez votre nom et votre adresse e-mail
  3. Choisissez un mot de passe d’au moins huit caractères, ou créez plutôt votre compte avec votre compte Google ou Facebook
  4. Acceptez les Conditions d’utilisation, la Politique de vente, de livraison et de remboursement et les Conditions de traitement des données, et lisez la Politique de confidentialité
  5. Connectez-vous avec le compte que vous venez de créer

Étape 2 : finalisez l’intégration

  1. Indiquez votre adresse e-mail pour les notifications
  2. Vérifiez votre adresse e-mail grâce au lien de confirmation
  3. Saisissez les informations et la catégorie de votre entreprise
  4. Finalisez la configuration du profil de votre entreprise

Étape 3 : créez votre premier modèle

  1. Accédez à la section Modèles
  2. Cliquez sur « Créer un nouveau modèle »
  3. Définissez les étapes de votre processus de chaîne d’approvisionnement
  4. Définissez les exigences de validation de chaque étape
  5. Enregistrez et activez votre modèle

Étape 4 : commencez le suivi des lots

  1. Accédez à la section Lots
  2. Créez un nouveau lot à partir de votre modèle
  3. Exécutez chaque étape à mesure que les produits avancent dans votre chaîne d’approvisionnement
  4. Téléversez les documents et médias justificatifs
  5. Partagez les liens de vérification avec les parties prenantes

Concepts clés

Modèles

Les modèles définissent le processus type de votre chaîne d’approvisionnement. Ils contiennent une série d’étapes par lesquelles les produits doivent passer, ainsi que les exigences de validation de chaque étape.

  • Définitions de flux de travail réutilisables
  • Exigences d’étape personnalisables
  • Contrôles d’accès basés sur les rôles
  • Règles de validation et dépendances

Lots

Les lots représentent des séries de production spécifiques ou des groupes de produits qui suivent un modèle. Chaque lot possède un UUID unique pour le suivi et la vérification.

  • Identification unique par UUID
  • Exécution étape par étape, avec la date et l’heure de chaque étape
  • Médias et documents joints
  • Fonctions de vérification publique

Étapes d’un lot

Les étapes individuelles de l’exécution d’un lot, chacune avec son propre statut, ses horodatages et ses documents justificatifs.

  • Suivi du statut (pending, in_progress, completed, failed)
  • Horodatage de chaque changement de statut
  • Données de localisation et coordonnées GPS
  • Fichiers joints et notes

Profils d’entreprise

Informations sur l’entreprise liées aux comptes utilisateurs, permettant la collaboration entre plusieurs parties et un accès basé sur les rôles.

  • Identification et vérification de l’entreprise
  • Classification par catégorie d’activité
  • Coordonnées et préférences
  • Gestion des autorisations d’accès

Rôles et autorisations des utilisateurs

Rôle Autorisations Cas d’usage type
Fabricant Créer des modèles, lancer des lots, exécuter toutes les étapes Producteurs d’origine qui créent et gèrent des produits
Distributeur Exécuter certaines étapes, mettre à jour les localisations, ajouter des documents Entreprises de logistique et de distribution qui manipulent les produits
Détaillant Consulter les informations des lots, exécuter les étapes finales, vérification côté client Magasins et points de vente qui vendent aux consommateurs finaux
Inspecteur Consulter toutes les données, ajouter des certifications, documents de contrôle qualité Organismes de réglementation et équipes d’assurance qualité
Consommateur Vérification publique via UUID/codes QR Clients finaux qui consultent le parcours enregistré d’un produit

Intégration de l’API

Authentification

ZincirX utilise une authentification par jeton d’API (Laravel Sanctum). Pour intégrer notre API :

  1. Demandez un jeton en envoyant votre adresse e-mail et votre mot de passe par une requête POST à /api/auth/login
  2. Envoyez ce jeton en tant que jeton bearer dans l’en-tête Authorization de chaque requête
  3. Les points de terminaison de vérification publique sous /api/public ne nécessitent aucun jeton

Principaux points de terminaison

Opérations sur les lots

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

Gestion des modèles

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

Vérification publique

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

Enregistrements et vérification

Où vos données sont conservées

  • Stockage: La propre base de données de ZincirX, sur des serveurs que nous exploitons
  • Révisions des passeports: Par ajout uniquement — une modification est enregistrée comme une nouvelle révision et les précédentes sont conservées
  • Fichiers justificatifs: Chaque fichier téléversé porte une empreinte SHA-256, ce qui permet de démontrer qu’il n’a pas été modifié
  • Disponibilité: Un passeport reste accessible pendant la durée vendue avec lui, dix ans par défaut, à compter du jour de son émission

Fonctions de vérification

Les enregistrements de la chaîne d’approvisionnement sont conservés dans la propre base de données de ZincirX, sur ses propres serveurs. La plateforme est conçue pour rendre ces enregistrements vérifiables par des tiers :

  • Enregistrement des modèles, avec un GTIN facultatif pour le produit
  • Enregistrements de la création des lots et de l’achèvement des étapes, horodatés
  • Une empreinte SHA-256 pour chaque fichier téléversé, permettant de démontrer qu’un fichier n’a pas été modifié
  • Révisions du passeport numérique de produit par ajout uniquement : une modification est enregistrée comme une nouvelle révision et les précédentes sont conservées

Bonnes pratiques

Sécurité

  • Utilisez un mot de passe robuste et unique pour votre compte ZincirX et ne communiquez jamais vos identifiants de connexion
  • Passez régulièrement en revue les membres de votre entreprise et retirez les accès qui ne sont plus nécessaires
  • Contrôlez les détails d’une étape et les fichiers qui y sont joints avant de la marquer comme terminée
  • Utilisez des mots de passe robustes pour la messagerie électronique de votre entreprise

Gestion des données

  • Fournissez des informations exactes et complètes pour chaque étape
  • Téléversez des fichiers multimédias clairs et pertinents à des fins de vérification
  • Appliquez des conventions de nommage cohérentes pour les lots et les modèles
  • Relisez et mettez à jour régulièrement le profil de votre entreprise

Collaboration

  • Partagez l’accès aux lots avec les partenaires concernés de votre chaîne d’approvisionnement
  • Communiquez clairement les exigences des étapes à tous les participants
  • Utilisez les codes QR pour faciliter la vérification par les clients finaux
  • Entretenez une communication régulière avec le réseau de votre chaîne d’approvisionnement

Dépannage

Problèmes de connexion

  • Vérifiez que votre adresse e-mail et votre mot de passe sont correctement saisis
  • Si vous avez créé votre compte avec Google ou Facebook, connectez-vous avec le même fournisseur
  • Videz le cache et les cookies du navigateur
  • Utilisez le lien de réinitialisation du mot de passe sur la page de connexion si vous ne vous souvenez plus de votre mot de passe

Échecs de création de lot et de téléversement

  • Vérifiez que vous disposez de passeports prépayés (UUID) avant de créer un lot
  • Assurez-vous que votre connexion réseau est stable
  • Attendez la fin d’un téléversement avant d’en lancer un autre
  • Vérifiez que chaque fichier téléversé respecte la taille maximale indiquée sur le formulaire de téléversement

Problèmes de performances

  • Utilisez un navigateur récent (Chrome, Firefox, Safari)
  • Fermez les onglets et les applications inutiles
  • Vérifiez le débit de votre connexion Internet
  • Effacez les données du navigateur et redémarrez-le si nécessaire

Assistance et ressources

Assistance communautaire

Échangez avec d’autres utilisateurs de ZincirX et obtenez l’aide de la communauté pour vos questions et vos difficultés.

  • Forums et discussions entre utilisateurs
  • Partage de bonnes pratiques
  • Demandes de fonctionnalités et retours

Assistance technique

Bénéficiez de l’aide directe de notre équipe technique pour les questions d’intégration et celles propres à la plateforme.

  • Aide à l’intégration de l’API
  • Conseils sur le passeport numérique de produit et GS1 Digital Link
  • Conseil en solutions sur mesure
Commencer maintenant