L'IoT Box d'Odoo : connecter vos machines à votre ERP
Imprimantes de tickets, balances homologuées, scanners, terminaux de paiement, pieds à coulisse, caméras : l'IoT Box fait remonter les données de vos périphériques directement dans Odoo, sans ressaisie. Voici ce qu'elle sait faire, ce qu'elle ne sait pas faire, et dans quels cas elle reste indispensable en 2026.
Dans la plupart des PME que nous accompagnons, l'ERP s'arrête au clavier. Le poids d'un colis est lu sur une balance puis retapé dans Odoo. Une cote est mesurée au pied à coulisse puis recopiée sur une feuille de contrôle. Une étiquette est imprimée depuis un logiciel tiers. Chacune de ces ruptures coûte du temps et introduit des erreurs. L'IoT Box existe précisément pour les supprimer.
1. Qu'est-ce que l'IoT Box, concrètement
L'IoT Box est un micro-ordinateur (un Raspberry Pi 3 ou 4) livré avec le programme Odoo IoT préinstallé. Branchée sur le même réseau que votre base Odoo, elle joue le rôle de traducteur : elle détecte les périphériques qui lui sont raccordés, les expose à Odoo comme des appareils utilisables dans les applications, et convertit les instructions d'Odoo en langages compris par le matériel (ESC/POS pour les imprimantes de tickets, ZPL pour les étiquettes Zebra, protocoles propriétaires pour les balances et les terminaux de paiement).
Depuis Odoo 17, la documentation ne parle plus d'IoT Box mais de système IoT, qui recouvre deux déclinaisons : la box physique, et le Windows virtual IoT, un programme installé sur un PC Windows 10 ou 11 qui rend les mêmes services, à quelques exceptions près. Le choix entre les deux n'est pas anodin.
| Critère | IoT Box physique | Windows virtual IoT |
|---|---|---|
| Matériel requis | Raspberry Pi 3 ou 4 | PC ou serveur Windows 10 / 11 |
| Caméras et outils de mesure (Fabrication, Qualité) | Oui | Non compatibles |
| Imprimantes DYMO Series 5 | Non | Oui |
| Accès SSH et débogage à distance | Oui | Non |
| Port terminaux de paiement Worldline / Ingenico | 9001 | 9050 |
| Dépendance à un poste allumé | Non, autonome | Oui |
Si votre projet touche à la fabrication ou au contrôle qualité (photos de pièces, mesures automatiques), la box physique est obligatoire. Le Windows virtual IoT ne gère ni les caméras ni les instruments de mesure. Et une machine virtuelle Windows tournant sur macOS ou Linux n'est pas supportée par Odoo.
2. Comment elle fonctionne : branchement et appairage
Mettre la box sur le réseau
Le plus simple reste le câble Ethernet vers le routeur, puis l'alimentation. En Wi-Fi, la box émet à la mise sous tension un réseau nommé IoTBox-xxxxxxxxxxxx : on s'y connecte, le navigateur redirige vers la page d'accueil de la box (ou l'adresse 10.11.12.1), et l'on choisit le réseau cible. Deux LED situées près du logement de carte SD donnent l'état : rouge pour absence d'accès Internet, verte clignotante pour attente de connexion à une base, verte fixe pour connectée.
Une règle de sécurité s'applique sans exception : l'IoT Box ne doit jamais être rendue accessible publiquement depuis Internet. Elle vit sur le réseau local, avec les périphériques et les postes clients.
Appairer la box à la base Odoo
Une fois l'application Internet des objets installée dans Odoo, trois voies existent :
- Détection automatique : depuis l'application IoT, le bouton Connecter lance un scan du réseau. C'est la méthode par défaut, et elle suffit dans la majorité des cas.
- Code d'appairage : un code valable deux heures après la mise sous tension, affiché sur un écran HDMI branché à la box, imprimé automatiquement sur une imprimante USB, ou lisible sur la page d'accueil de la box. Attention, ce code ne s'affiche pas si la box est déjà rattachée à une autre base, piège classique lors des duplications de base.
- Jeton de connexion : appairage hors ligne réservé au mode développeur, en copiant un jeton depuis Odoo vers la page d'accueil de la box.
Le certificat HTTPS, un prérequis souvent oublié
Après appairage, Odoo demande automatiquement un certificat HTTPS pour la box, qui bascule alors sur une adresse en .odoo-iot.com. Ce certificat conditionne le fonctionnement de certains périphériques réseau, en premier lieu les terminaux de paiement. Deux conditions cumulatives sont exigées : la base doit être une base de production (ni copie, ni duplicata, ni staging), et l'abonnement Odoo doit être en cours de validité. Une IoT Box branchée sur une base de test n'obtiendra jamais son certificat, et les paiements ne fonctionneront pas.
3. Les périphériques compatibles
Odoo maintient une liste officielle de matériels validés. Voici les grandes familles, avec les points de configuration qui font gagner du temps.
Imprimantes de tickets et d'étiquettes
USB ou réseau, pilotées via CUPS embarqué. Epson (ESC/POS) et Zebra (ZPL) sont les marques recommandées, sans pilote à sélectionner. Les imprimantes Bluetooth ne sont pas compatibles.
Balances
Connexion USB, éventuellement via adaptateur série. Homologation légale obligatoire dans l'Union européenne. Modèle de référence chez Odoo : la Mettler-Toledo Ariva-S, avec son câble propriétaire dédié.
Lecteurs de codes-barres
Le scanner doit terminer chaque lecture par un caractère ENTER. Deux réglages décisifs sur la fiche appareil : la disposition du clavier (QWERTY US par défaut) et l'option Est un scanner.
Terminaux de paiement
Worldline, Ingenico et SIX exigent un système IoT (Belgique, Pays-Bas, Luxembourg pour les deux premiers). Adyen et Stripe fonctionnent en revanche sans IoT Box.
Caméras
Une simple webcam USB suffit. Odoo recommande du matériel Logitech postérieur à 2010. Usage typique : photographier une pièce à un point de contrôle qualité pour constituer une preuve d'audit.
Outils de mesure
Pieds à coulisse, micromètres, jauges de profondeur ou de hauteur, en USB ou Bluetooth. Les catalogues Sylvac font référence. La mesure remonte seule dans le contrôle qualité, avec norme et tolérance.
Écrans clients HDMI
Deux ports HDMI depuis les modèles 2020, donc deux écrans en plus de la caisse. Un écran peut afficher le panier en temps réel, l'autre une URL libre pour de la promotion. Diagonale minimale de 6 pouces.
Tiroirs-caisses
Le tiroir ne se branche pas sur la box mais sur l'imprimante de tickets, via un câble RJ25. C'est l'ordre d'impression qui déclenche son ouverture.
Pédales de commande
Une pédale USB permet de valider une étape d'ordre de travail sans lâcher la pièce. Chaque pédale est associée à une action et à une touche, et l'ordre des déclencheurs détermine la priorité.
4. Les applications Odoo qui l'exploitent
L'IoT Box n'a pas d'intérêt en soi : elle prend sa valeur dans les applications qui consomment les données de vos périphériques.
Point de Vente
C'est l'usage historique. Dans les paramètres du point de vente, la section Appareils connectés permet d'affecter à la caisse une imprimante de tickets, une balance, un écran client, un lecteur de codes-barres et un terminal de paiement. Bon à savoir : depuis la version 13, une IoT Box par point de vente n'est plus nécessaire, un même matériel peut être partagé entre plusieurs caisses (à l'exception des terminaux Ingenico).
Fabrication
C'est le gisement de valeur le plus sous-exploité. Sur chaque poste de travail, un onglet Déclencheurs IoT associe un périphérique, une touche et une action. Concrètement, l'opérateur appuie sur une pédale pour valider une étape, une caméra photographie automatiquement la pièce, un pied à coulisse renseigne la cote mesurée, une imprimante sort l'étiquette de lot au bon moment. L'ordre de travail devient un vrai poste instrumenté, sans MES additionnel.
Qualité
Trois types de points de contrôle exploitent un appareil IoT : Prendre une photo, Mesure (avec champs Norme et Tolérance) et Imprimer l'étiquette. La valeur mesurée, normalement saisie à la main, est renseignée par l'instrument, ce qui supprime à la fois l'erreur de recopie et la tentation d'arrondir.
Inventaire et Codes-barres
Lecture des codes-barres en réception, préparation et inventaire, pesée automatique des colis de livraison quand une balance est connectée, et impression automatique de documents à la validation d'un transfert, paramétrable par type d'opération depuis Odoo 17. Sans imprimante IoT liée, le rapport est simplement téléchargé au lieu d'être imprimé.
5. Cinq cas d'usage métier
Commerce de détail
Caisse complète : imprimante de tickets, tiroir-caisse déclenché par l'imprimante, scanner, balance homologuée pour les produits vendus au kilo, écran client affichant le panier en temps réel, second écran en affichage promotionnel, terminal de paiement. Les étiquettes produits sortent en ZPL sur une Zebra.
Restauration
Envoi automatique des commandes vers les imprimantes de cuisine et de bar depuis la caisse, ticket client, terminal de paiement, écran client. Le personnel de salle ne retourne plus en cuisine pour transmettre une commande.
Atelier de production
Poste de travail équipé d'une pédale pour valider les étapes, d'une caméra pour photographier chaque pièce, d'un pied à coulisse Bluetooth dont la mesure alimente directement le contrôle qualité, et d'une imprimante d'étiquettes pour le numéro de série. Odoo devient un MES léger sans logiciel supplémentaire.
Entrepôt et logistique
Scanners sur toutes les opérations, impression automatique des bons et étiquettes transporteur à la validation des transferts, pesée automatique des colis à l'expédition. Le poids réel remplace le poids théorique dans le calcul des frais de port.
Laboratoire et métrologie
Instruments de mesure reliés à des points de contrôle avec norme et tolérance, déclenchement d'alertes qualité en cas d'écart, traçabilité complète des relevés. À noter : ces appareils exigent la box physique, le Windows virtual IoT ne les gère pas.
6. Les points de vigilance
L'IoT Box n'est pas un objet magique. Voici ce que nous voyons revenir le plus souvent en intervention.
- Le réseau est le premier suspect. La box, les périphériques réseau et les postes clients doivent être sur le même réseau. Les problèmes de résolution de nom de l'adresse en .odoo-iot.com se règlent souvent par un changement de DNS, et Odoo précise explicitement que les problèmes réseau sortent du périmètre de son support.
- Le certificat HTTPS bloque sur les bases de test. Aucun certificat ne sera délivré hors base de production avec abonnement actif. Un pare-feu, y compris celui du routeur, peut aussi bloquer sa génération.
- Les terminaux de paiement veulent une IP fixe. Sans réservation d'adresse sur le routeur, la liaison se perd. Même chose pour les imprimantes ePOS en accès réseau local.
- L'association imprimante et rapport vit dans le cache du navigateur. Deux utilisateurs sur deux postes peuvent donc imprimer le même document sur deux imprimantes différentes. Un bouton de réinitialisation existe, mais il n'agit que sur le navigateur courant.
- La détection de pilotes n'est pas parfaite. Du texte aléatoire à l'impression signale un mauvais pilote. Pour Epson et Zebra, la bonne pratique est de n'en sélectionner aucun.
- Un peu de patience au démarrage. Comptez jusqu'à deux minutes pour qu'une imprimante apparaisse dans la liste des appareils, et quelques minutes de mise à jour après le premier appairage.
- L'image de la box se met à jour. Après une montée de version d'Odoo, un reflashage de la carte micro-SD est fréquemment nécessaire. Ne jamais débrancher la box pendant une mise à jour.
Odoo propose un accès distant via jeton Tailscale pour son support. L'éditeur avertit lui-même que fournir ce jeton donne accès à l'IoT Box et à l'ensemble de votre réseau local. À ne faire qu'avec un interlocuteur officiel identifié, et à révoquer ensuite.
7. Ce qui change avec Odoo 18 et 19
La tendance de fond est claire : Odoo réduit progressivement les cas où le boîtier est indispensable.
- Odoo 18 a détaché l'écran client de l'IoT Box. Il fonctionne désormais sur un second écran USB-C ou HDMI du poste de caisse, ou sur n'importe quel appareil via un QR code.
- Odoo 19 introduit le Local Network Access, qui s'appuie sur une fonction de sécurité de Chromium 142 et permet à la caisse de dialoguer directement, depuis le navigateur, avec des imprimantes ePOS compatibles, sans IoT Box ni certificat auto-signé. Il faut activer un paramètre système et accorder une autorisation navigateur, et l'imprimante doit disposer d'une IP statique.
- Les imprimantes ePOS réseau fonctionnent déjà sans IoT depuis plusieurs versions, contrairement aux ePOS en USB.
Reste que le boîtier garde un territoire propre, et il est large : tout ce qui touche à la fabrication et à la qualité (caméras, instruments de mesure, pédales), les balances, les terminaux Worldline, Ingenico et SIX, les imprimantes USB, les périphériques série anciens, et les configurations multi-écrans déportés.
Plusieurs articles en ligne annoncent pour Odoo 19 une IoT Box virtuelle multiplateforme intégrée au navigateur, ou la disparition de l'IoT pour les terminaux Worldline. Ces affirmations ne figurent ni dans la documentation officielle Odoo 19, ni dans les notes de version, qui indiquent au contraire que Worldline exige toujours un système IoT. La seule alternative logicielle documentée à ce jour reste le Windows virtual IoT.
8. Combien ça coûte, et faut-il acheter la box chez Odoo
Le modèle économique a changé, et beaucoup d'articles en ligne diffusent encore l'ancien. La fiche produit de l'IoT Box a disparu de la boutique Odoo : l'URL renvoie une erreur 404, et une recherche iot dans la boutique ne donne aucun résultat. La FAQ officielle affiche pourtant toujours un prix d'achat, avec un lien vers cette page morte.
Ce qui subsiste, c'est l'abonnement IoT, de l'ordre de 25 euros par mois et par box en zone euro. Il n'est pas optionnel : la documentation Odoo 19 précise qu'il est requis pour un usage en production et pour la génération du certificat HTTPS, et qu'il est créé automatiquement dès qu'un système IoT se connecte à la base. La FAQ ajoute que le boîtier est offert avec chaque abonnement souscrit, frais de port inclus. Autrement dit, vous ne payez plus le matériel, vous payez le service. Et le Windows virtual IoT n'y échappe pas non plus.
Deux prérequis s'ajoutent à la facture. L'application Internet des objets n'existe pas en Odoo Community : elle est réservée à l'édition Enterprise. Et le certificat HTTPS exige une base de production avec un abonnement Odoo en cours de validité.
Peut-on fabriquer sa propre IoT Box ?
Techniquement oui, et Odoo le documente elle-même. L'image système est publiquement téléchargeable sur nightly.odoo.com, régénérée chaque semaine, et la procédure de flashage sur carte micro-SD figure dans la documentation officielle. Le firmware embarqué est publié sous licence LGPL-3, y compris la recette de construction de l'image. Le matériel supporté reste le Raspberry Pi 3 ou 4 ; le Pi 5 n'est pas listé.
Une box auto-construite continue de recevoir les mises à jour, puisque le mécanisme est intégré au firmware libre. En revanche elle ne bénéficie plus de la garantie d'un an avec échange standard, ce qui compte pour du matériel en production. Et surtout, elle ne dispense pas de l'abonnement : c'est la connexion à la base de production qui déclenche la facturation, pas l'origine du boîtier.
L'abonnement mensuel par box, l'édition Enterprise, et surtout le matériel périphérique lui-même : imprimantes, balance homologuée, scanners, instruments de mesure. C'est ce dernier poste qui pèse le plus, et c'est aussi celui qui réserve les mauvaises surprises. Le choix d'un modèle non validé par Odoo, ou d'un câble non conforme sur une balance Mettler-Toledo, transforme une installation d'une demi-journée en chantier de plusieurs semaines.
Un projet de connexion de périphériques sur Odoo ?
Avant d'acheter du matériel, faites valider votre architecture. Nos consultants certifiés Odoo cadrent votre besoin et vous évitent les impasses classiques : matériel non homologué, base de test sans certificat, réseau mal segmenté.
- Audit de vos flux et identification des ruptures de saisie à supprimer
- Choix du système IoT adapté : box physique ou Windows virtual IoT
- Liste de matériel validée, compatible et homologuée pour la France
- Chiffrage du paramétrage et des développements éventuels
- Mise en oeuvre, tests en conditions réelles et formation des équipes
Sources
- Documentation Odoo 19.0, Internet des objets (IoT), incluant les pages IoT box, Windows virtual IoT, Connexion, Appareils et Dépannage
- Documentation Odoo 19.0, Point de Vente et matériel, incluant les pages imprimantes de reçus, balance, écran client et accès réseau local
- Odoo, liste du matériel compatible IoT et FAQ IoT
- Odoo, images système de l'IoT Box et comparatif des éditions Community et Enterprise
- Notes de version Odoo 18 et Odoo 19