Aller au contenu

Lecteurs de codes-barres

Réception de stock et préparation de commandes

Dernière mise à jour : 5 September 2026

STOAR prend en charge la lecture de codes-barres pour la réception de stock, la préparation de commandes et la recherche de produits — sans aucun pilote, plug-in ni application à installer.

Les lecteurs se connectent en mode clavier HID : le lecteur s'appaire ou se branche comme un clavier, « saisit » le code décodé dans le champ actif et envoie Entrée pour valider. Tout lecteur prenant en charge le mode clavier HID fonctionne.

Ce que tu peux faire avec un lecteur #

Flux de travail Ce qui se passe
Réception de stock Admin → Catalogue → Réception de stock Chaque lecture ajoute du stock et enregistre une entrée dans le journal d'audit
Préparation de commandes Admin → Commandes → Préparer les articles Chaque lecture confirme un article de la commande ; « Marquer comme expédiée » se débloque une fois toutes les lignes préparées
Recherche de produits Recherche globale de l'administration La lecture d'un code retrouve le produit instantanément
Applications sur mesure GET /api/v1/barcode/{code} Résoudre un code-barres vers un produit ou une déclinaison depuis ta propre application

Comment les codes sont résolus #

Les produits et les déclinaisons portent chacun deux identifiants :

  • Code-barres — le code fabricant (EAN-13, UPC-A, GTIN) imprimé sur l'emballage de l'article
  • SKU — ton identifiant interne

Une lecture est résolue dans cet ordre : code-barres de la déclinaison → code-barres du produit → SKU de la déclinaison → SKU du produit. Autrement dit, les articles peuvent porter aussi bien des codes-barres fabricant que tes propres étiquettes SKU — les deux se lisent correctement.

Les codes-barres se saisissent dans Admin → Catalogue → Produits, sur le produit lui-même et sur chaque déclinaison.

Essayer sans lecteur #

Tu n'as besoin d'aucun matériel pour essayer les flux de lecture. Puisqu'un lecteur ne fait que saisir un code dans le champ actif avant d'appuyer sur Entrée, tu peux faire la même chose à la main : ouvre Réception de stock, Préparation de commandes ou le Point de vente, clique dans le champ de lecture, puis saisis ou colle le code-barres ou la SKU d'un produit et appuie sur Entrée. L'article est réceptionné, préparé ou ajouté à la vente exactement comme si tu l'avais scanné. C'est le moyen le plus rapide de démontrer ou d'apprendre le flux avant que ton lecteur n'arrive — et une solution de repli pratique si une étiquette est abîmée ou absente.

Les développeurs qui créent une application sur mesure peuvent résoudre un code sans passer du tout par l'interface d'administration : GET /api/v1/barcode/{code} renvoie le produit et la déclinaison correspondants au format JSON.

Configuration du lecteur #

Chaque lecteur a besoin de trois choses :

  1. Mode clavier HID — et non le mode série/SPP ou SDK
  2. Suffixe Entrée (retour chariot) — envoyé après chaque lecture, c'est lui qui valide le formulaire
  3. Disposition de clavier US English sur l'hôte (ou configure le lecteur en conséquence) — une disposition non concordante peut altérer les codes alphanumériques

Socket Mobile 1D (série S700)

Lecteur Bluetooth de poche pour codes-barres linéaires (1D) — EAN, UPC, Code 128, Code 39. Un bon choix si toutes tes étiquettes sont des codes-barres de distribution standard. Ne lit ni les QR codes ni les Data Matrix.

  1. Scanne le code-barres de configuration « Basic Mode (HID) » du guide de démarrage rapide Socket Mobile — les lecteurs Socket sont souvent livrés en Application Mode (SDK), dont STOAR n'a pas besoin
  2. Appaire l'appareil depuis les réglages Bluetooth de ton matériel (il apparaît comme un clavier)
  3. Le suffixe Entrée est la valeur par défaut de Socket en mode HID — scanne dans n'importe quel champ texte pour le vérifier

Socket Mobile 2D (S720 / S740)

Même format et même configuration que le modèle 1D, avec un imageur 2D qui lit également les QR Code, Data Matrix, PDF417 ainsi que les codes affichés à l'écran. Choisis ce modèle si tu imprimes des étiquettes QR pour tes bacs ou tes SKU internes.

La configuration est identique à celle du modèle 1D : scanne « Basic Mode (HID) », puis appaire comme clavier.

Zebra DS2208 (USB filaire)

Lecteur portable USB filaire doté d'un imageur 1D et 2D. La valeur sûre pour un poste de réception fixe — pas de batterie, pas d'appairage.

  1. Branche-le en USB — il fonctionne comme un clavier HID d'emblée
  2. Scanne le code-barres de configuration « Add an Enter Key (Carriage Return/Line Feed) » du guide de démarrage rapide du DS2208
  3. Si les caractères sortent incorrects, scanne le code-barres de configuration de disposition clavier correspondant à ton hôte (par exemple US English)

Zebra DS2278 (Bluetooth sans fil)

La version sans fil du DS2208 — même imageur, plus un socle de charge. Idéal pour préparer les commandes en se déplaçant dans l'entrepôt.

  • Via le socle : branche le socle en USB ; il se présente comme un clavier — prêt à l'emploi
  • Bluetooth direct : scanne le code-barres de configuration « Bluetooth Keyboard Emulation (HID Slave) », puis appaire depuis les réglages Bluetooth de ton matériel

Dans les deux cas, scanne également « Add an Enter Key (Carriage Return/Line Feed) ».

Choisir un lecteur #

Scénario Recommandation
Poste de réception fixe, coût le plus bas Zebra DS2208
Préparation mobile dans l'entrepôt Zebra DS2278
Format de poche, utilisé avec un téléphone ou une tablette Socket Mobile 2D
Uniquement des codes-barres de distribution standard, budget serré Socket Mobile 1D
Des étiquettes QR ou Data Matrix, maintenant ou plus tard N'importe quel modèle 2D

Dépannage #

Symptôme Solution
La lecture remplit le champ mais rien n'est validé Le suffixe Entrée/CR n'est pas configuré — scanne le code-barres de configuration du suffixe correspondant à ton modèle
Notification « Unknown code » Le code n'est enregistré sur aucun produit ni aucune déclinaison — ajoute-le dans Admin → Catalogue → Produits
Les lettres ou les symboles sortent incorrects La disposition clavier de l'hôte ne correspond pas à celle du lecteur — règle les deux sur US English
Le lecteur Socket ne saisit rien Il est en Application Mode — scanne le code-barres de configuration « Basic Mode (HID) »
Les zéros de tête disparaissent sur les codes UPC Configure le format de transmission UPC du lecteur pour qu'il corresponde au code enregistré — la correspondance est exacte