Objets & associations
Bac, mesure et indicateur de remplissage : les distinctions nécessaires à une intégration fiable.
4. Comprendre les objets
| Terme utilisé dans cette documentation | Objet de l’API | Rôle |
|---|---|---|
| Pharmacie / magasin | store |
Périmètre métier auquel rattacher les bacs et les droits d’accès. |
| Shelfy | promo_bin, identifié par deviceId et serial |
Le bac promo équipé de son dispositif peseur ; lu via /api/promo-bins. |
| Produit du bac | products[] |
Produits associés au bac : productId, name, brand, ean, unitWeight. |
| Référence 100 % | weight.baseG |
Poids du bac plein, base du pourcentage de remplissage. |
| Indicateur de remplissage | indicator |
mode, units, percent et status. |
| Mesure | point de fill-history |
Poids et remplissage à une date ; voir la section 5.2. |
Indicateur de remplissage
Chaque bac porte un indicator :
| Champ | Signification |
|---|---|
mode |
units (nombre d’unités, bac mono-produit au poids unitaire confirmé), percent, ou pending (pas encore de valeur affichable). |
units |
Nombre d’unités estimé, en mode units seulement. |
percent |
Remplissage par rapport à la référence 100 %. |
status |
État selon les seuils : avertissement à 30 %, critique à 10 %. |
La quantité en unités n’est donnée que pour un bac mono-produit : pour un bac mixte, seul le pourcentage de remplissage est fiable.