Approvisionnements - Vue d'ensemble

Les approvisionnements (procurements) représentent des avis de réception fournisseur envoyés au WMS. Ils déclarent les articles attendus pour qu’ils soient réceptionnés physiquement.

Workflow complet

1. Prérequis : référentiels

   • Les articles attendus doivent exister (POST /articles)
   • Le fournisseur doit exister si config.CheckSupplier est activé (POST /suppliers)

2. Déclarer l’approvisionnement — POST /procurements

   • Contient les lignes avec les articles et quantités attendues
   • L’uniqueProcurementID ne peut pas être réutilisé

3. Réception physique WMS (asynchrone)

   • Le WMS enregistre les réceptions

4. Récupérer le compte-rendu — GET /procurements/reports

   • Pollez avec afterId ou afterDate
   • Le rapport contient : quantités reçues, numéros de lot, dates, détails par réception

Structure d’un approvisionnement

Un approvisionnement contient un en-tête (fournisseur, date de réception) et des lignes (articles + quantités attendues).

{
  "uniqueProcurementID": "APPRO-001",
  "supplierCode": "FOUR01",
  "expectedReceiptDate": "2024-07-01",
  "procurementEntries": [
    { "lineID": "1", "articleReference": "ART-001", "expectedQuantity": 500 },
    { "lineID": "2", "articleReference": "ART-002", "expectedQuantity": 200 }
  ]
}

Compte-rendu de réception

Le rapport de réception est structuré en 3 niveaux :

ProcurementReport
  └── Entries (par ligne de commande)
        └── Details (par réception physique)
              → numéro de lot, n° série, quantité reçue, date article

Note

Un même approvisionnement peut avoir plusieurs rapports si la réception se fait en plusieurs fois.

Endpoints

Méthode	Endpoint	Description
POST	/procurements	Créer des approvisionnements
GET	/procurements	Lister les approvisionnements
GET	/procurements/reports	Comptes-rendus de réception
GET	/procurements/{uniqueProcurementID}/reports	Rapports d’un approvisionnement