Présentation du produit

Ce que c'est

AgriWare Connector n'est pas lui-même un système de gestion d'entrepôt. Il ne gère ni le rayonnage, ni les circuits de préparation, ni le matériel de lecture de codes-barres — c'est la couche d'intégration entre un WMS existant et le module Inventaire d'Odoo. Le WMS externe appelle cette API pour lire les données de produits, d'entrepôts et de stocks d'Odoo, et pour transmettre les réceptions entrantes et expéditions sortantes dans le flux de stock standard d'Odoo.

Version Odoo prise en charge

Odoo 19. AgriWare Connector dépend de quatre modules de l'Odoo Community Association (OCA) — component, component_event, connector et queue_job — qui sont inclus dans le téléchargement de la marketplace Odoo Apps : aucune installation séparée n'est nécessaire pour une installation depuis la marketplace.

Architecture d'intégration

Chaque requête de cette intégration est initiée par le WMS externe ; Odoo n'appelle jamais le WMS. Toutes les données résident finalement dans la base PostgreSQL d'Odoo — AgriWare Connector n'ajoute aucun entrepôt de données séparé.

Capacités de l'API REST

AgriWare Connector expose une API REST versionnée, enracinée à /agriware/api/v1. Toutes les réponses du contrôleur partagent une forme cohérente {"status": "success" | "error", ...}.

• GET /health — contrôle de santé public, aucune authentification requise
• GET /products — récupération de jusqu'à 100 produits ; POST /products et PATCH /products/{external_id} — création et mise à jour des produits
• GET /warehouses — récupération des entrepôts ; POST /warehouses et PATCH /warehouses/{external_id} — création et mise à jour des entrepôts
• GET /suppliers, POST /suppliers et PATCH /suppliers/{external_id} — récupération, création et mise à jour des fournisseurs
• GET /inventory — récupération des quantités de stock disponibles
• GET /lots, POST /lots et PATCH /lots/{external_id} — récupération, création et résolution des lots et numéros de série
• POST /inventory-adjustments — mise en attente d'un comptage d'inventaire initial pour révision humaine dans Odoo
• POST /receipts et /receipts/{id}/validate — création et validation des réceptions entrantes, y compris pour les produits suivis par lot ou numéro de série
• GET /receipts/{external_reference} — consultation du statut d'une réception par votre propre référence externe
• POST /dispatches et /dispatches/{id}/validate — création et validation des expéditions sortantes, y compris pour les produits suivis par lot ou numéro de série
• GET /dispatches/{external_reference} — consultation du statut d'une expédition par votre propre référence externe

Authentification et contrôle d'accès

Chaque endpoint protégé requiert un en-tête Authorization: Bearer portant une véritable clé API Odoo. Les clés sont générées et gérées en libre-service, à l'intérieur d'Odoo, par les utilisateurs du groupe AgriWare Administrator — sans intervention d'un développeur. L'utilisateur sous-jacent de la clé authentifiée doit également appartenir au groupe AgriWare API User pour appeler l'API. Les clés API sont isolées par entreprise grâce à des règles d'enregistrement.

Opérations d'inventaire prises en charge

• Lecture des données de produits, d'entrepôts, de fournisseurs et de stocks
• Création et mise à jour des produits, entrepôts et fournisseurs, identifiés par vos propres identifiants externes
• Configuration des correspondances d'unités de mesure pour les unités non fournies par défaut dans Odoo
• Création et résolution des lots et numéros de série pour les produits traçables
• Mise en attente des observations d'inventaire initial pour révision humaine — elles ne sont jamais appliquées automatiquement au stock réel ; un responsable d'inventaire doit les examiner et les appliquer manuellement depuis l'écran natif d'ajustement d'inventaire d'Odoo
• Création d'une réception entrante en brouillon, puis validation par rapport aux quantités reçues, y compris pour les produits suivis par lot ou numéro de série
• Création d'une expédition sortante en brouillon, puis validation par rapport aux quantités expédiées, y compris pour les produits suivis par lot ou numéro de série
• Consultation du statut d'une réception ou d'une expédition par votre propre référence externe
• Protection contre les transactions en double via un verrou consultatif PostgreSQL sur chaque référence externe

Limitations actuelles

• Pas de pagination sur les endpoints produits, entrepôts ou inventaire (plafonnés à 100 enregistrements)
• Pas de contrôle d'accès par entrepôt au sein d'une même entreprise
• Les réceptions et expéditions partielles ne sont pas prises en charge — les quantités doivent correspondre exactement
• Les imports d'inventaire initial sont mis en attente pour révision humaine — l'application d'un comptage validé au stock réel Odoo nécessite toujours une étape manuelle dans l'écran natif d'ajustement d'inventaire d'Odoo, par conception
• Aucune synchronisation automatique ou planifiée — chaque requête est initiée par le WMS externe
• Pas d'adaptateurs intégrés spécifiques à un WMS — il s'agit d'une seule API REST générique

Captures d'écran