Tous les outils

Documentation ScanGencode

Retrouver un article à partir de son gencode (EAN, UPC, GTIN), en croisant plusieurs bases de données ouvertes.

01 — Principe

Comment ça marche ?

ScanGencode interroge successivement trois bases de données produits jusqu'à trouver une correspondance, et affiche l'image et la description du premier article identifié.

Open Food Facts
Produits alimentaires — très bien fourni en France
Open Products Facts
Produits non-alimentaires (le même projet, hors alimentation)
UPCitemdb
Base généraliste internationale, en dernier recours
Résultat affiché
Image, nom, marque, description du premier article trouvé

Dès qu'une base répond avec un article valide, la recherche s'arrête — les suivantes ne sont pas interrogées. Si aucune des trois ne connaît le code, des liens de recherche manuelle (Google, Google Shopping, Amazon) sont proposés à la place.


02 — Scanner

Scanner avec l'appareil photo

Sur les navigateurs compatibles, un bouton « Scanner avec l'appareil photo » apparaît sous le champ de recherche. Il ouvre la caméra (arrière par défaut sur mobile), reconnaît le code-barres directement dans l'image, puis lance la recherche automatiquement dès qu'un code exploitable est détecté.

La lecture du code-barres se fait entièrement dans le navigateur (API BarcodeDetector) : l'image de la caméra n'est jamais envoyée où que ce soit, seul le numéro détecté est utilisé pour la recherche.

Compatibilité : fonctionne sur Chrome et Edge (Android et ordinateur). Safari et iOS ne l'implémentent pas encore au moment de l'écriture — sur ces navigateurs, le bouton n'apparaît simplement pas, et la saisie manuelle reste toujours disponible. L'accès à la caméra nécessite aussi que le site soit servi en HTTPS.


03 — Performance

Un cache local pour aller plus vite

Chaque résultat (trouvé ou non) est mémorisé localement par gencode, pour éviter de re-questionner les bases à chaque recherche du même code :

Cela permet aussi de ménager le quota d'UPCitemdb, dont l'accès gratuit est limité en nombre de requêtes par jour.


04 — Confidentialité

Ce qui est transmis aux bases externes

Seul le gencode recherché est envoyé aux services tiers (Open Food Facts, Open Products Facts, UPCitemdb) — aucune autre donnée, aucun compte, aucun suivi.

Les liens de recherche manuelle (Google, Amazon…) proposés quand rien n'est trouvé ouvrent un nouvel onglet vers ces sites — rien n'est fait automatiquement en votre nom.

05 — Limites

Ce que l'outil ne garantit pas

Résultat « le plus probable »

Le premier article trouvé est affiché, sans confirmation croisée entre bases. Il peut arriver que ce ne soit pas le bon article, notamment sur des codes réutilisés ou mal enregistrés.

Couverture variable

Très bonne pour les produits alimentaires vendus en France ou en Europe ; plus incertaine pour les produits récents, artisanaux ou vendus hors grande distribution.


06 — FAQ

Questions fréquentes

Quels formats de code sont acceptés ?

Tout code numérique de 6 à 14 chiffres : EAN-8, UPC-A, EAN-13, ITF-14… Aucune vérification de clé de contrôle n'est effectuée, seule la longueur est validée.

Pourquoi le bouton « Scanner » n'apparaît pas ?

Le navigateur ne supporte pas l'API de détection de code-barres (c'est le cas de Safari/iOS actuellement). La saisie manuelle du numéro reste toujours possible.

Pourquoi le résultat semble erroné ?

Les bases utilisées sont alimentées par leurs communautés respectives ; une erreur de saisie côté base (mauvais gencode associé à un produit) peut se répercuter ici. Le lien « Voir la fiche complète » permet de vérifier et, sur Open Food Facts, de corriger l'entrée.

Le résultat peut-il être périmé ?

Oui, jusqu'à 30 jours à cause du cache local. Une mise à jour récente d'un produit peut donc ne pas apparaître immédiatement.


Lancer une recherche