Transmettre les données
Envoyez les références, matières, lieux de fabrication et informations de lot depuis vos outils. Retrouvez le lien entre votre référence interne et son passeport.
Souscrivez à l’API seule pour créer vos passeports produits, générer vos QR codes et préparer vos puces NFC depuis votre ERP, votre PIM ou votre application. Aucun abonnement à la plateforme SaaS ou à Shopify n’est nécessaire.
Documentation publique, accès API payant. La documentation est consultable librement. L’offre API est en préparation : les accès et clés du programme pilote restent à activer avant toute utilisation du service.
L’API constitue l’une de nos trois offres, au même titre que la plateforme SaaS et l’application Shopify. Votre logiciel effectue les appels et récupère les fichiers directement : aucun passage par un tableau de bord n’est requis pour générer vos supports.
Envoyez les références, matières, lieux de fabrication et informations de lot depuis vos outils. Retrouvez le lien entre votre référence interne et son passeport.
Récupérez un fichier QR code à intégrer à une étiquette, un emballage ou votre chaîne d’impression. Pour le NFC, récupérez le lien à écrire dans la puce.
Ajoutez un contrôle ou une réparation, puis mettez à jour les informations du passeport. Le lien porté par l’étiquette reste associé au même produit.
L’impression, le choix de l’étiquette et l’encodage font partie du déploiement. Découvrir les supports et leur mise en place.
Ce modèle Node.js prépare un passeport pour un exemplaire, avec les deux supports. Votre référence LOT-42-0001 permet de le retrouver dans votre propre système.
La réponse décrite dans le contrat contient l’identifiant du passeport, son statut, son lien et les ressources QR/NFC demandées. La publication fait l’objet d’une étape distincte.
Exemple de contrat, à utiliser après l’ouverture d’un environnement de test et la remise d’une clé API.
Suivre l’exemple complet et lire la réponse →Node.js · Création d’un passeport · Contrat de test
// La clé reste dans votre application serveur.
const baseUrl = process.env.TRACE_API_URL;
const response = await fetch(`${baseUrl}/passports`, {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TRACE_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "LOT-42-0001"
},
body: JSON.stringify({
external_id: "LOT-42-0001",
identification_level: "item",
product: {
name: "Veste Atelier",
sku: "VESTE-BLEU-M"
},
carriers: { qr: true, nfc: true }
})
});
if (!response.ok) {
throw new Error(`Création refusée : ${response.status}`);
}
const passport = await response.json();
console.log(passport.id, passport.status);
Chaque route ci-dessous s’ajoute à l’adresse de base /trace/v1. Le fichier OpenAPI décrit les champs, réponses et opérations prévus.
/productsEnregistrer une référence produit/passportsCréer son passeport/passports/{passportId}/publishPublier les informations validées/passports/{passportId}/qr.svgTélécharger le QR à imprimer/passports/{passportId}/nfc-payloadRécupérer le lien à encoder/passport-batchesPréparer plusieurs passeportsLe choix des données, du niveau d’identification et du support doit correspondre aux exigences applicables à votre catégorie de produits. Le cadre ESPR et ses textes sectoriels guident ce travail.
L’API facilite la circulation de vos informations ; la conformité dépend aussi de leur contenu, de leur exactitude et des règles de votre secteur.
Comprendre le cadre réglementaire →Cadrez vos données, les échanges avec vos outils et le passage aux étiquettes physiques.
Une API de traçabilité doit prolonger vos outils métier sans multiplier les saisies. Cadrez les sources de données, les identifiants, les reprises et le passage aux supports physiques avant de lancer une première intégration pilote.
Lire le guide : Intégrer une API de traçabilité à votre ERP ou PIM : par où commencer ?Avant les QR codes et les étiquettes, il faut des informations vérifiables. Découvrez une méthode de collecte fournisseurs, de validation et de gestion des accès pour préparer les données de votre passeport produit.
Lire le guide : Comment préparer les données de votre passeport numérique produit ?Passer du passeport numérique à l’étiquette demande une méthode de production. Découvrez les étapes pour préparer les identifiants, imprimer les QR, encoder les puces et vérifier chaque association après la pose sur le produit.
Lire le guide : Comment imprimer, encoder et vérifier ses étiquettes de traçabilité ?Partagez vos outils, vos volumes et vos besoins d’étiquetage pour cadrer le parcours de votre équipe.