API Stocks

Endpoints de gestion des stocks. Voir Collection stocks pour les schémas complets.

Tous les endpoints requièrent une authentification (authMiddleware + requireMembership).

/api/stocks/depots

Dépôts de stockage du tenant.

GET /api/stocks/depots

Paramètre Type Description

company

ObjectId

Tenant courant

type

string

depot, vitrine, consignation ou transit

is_active

boolean

Filtre sur le statut actif

is_virtual

boolean

Filtre sur les dépôts virtuels

managed_by

string

warehouse, garage ou distributor

page

number

Page (défaut : 1)

limit

number

Résultats par page (défaut : 10)

  • 200 — liste paginée

GET /api/stocks/depots/:id

  • 200 — objet StockDepot

  • 404 — introuvable

POST /api/stocks/depots

Crée un dépôt.

  • 201 — créé

PATCH /api/stocks/depots/:id

  • 200 — mis à jour

DELETE /api/stocks/depots/:id

  • 204 — supprimé

/api/stocks/addresses

Adresses de rangement au sein d’un dépôt (allées, rayons, cases).

CRUD standard : GET /, GET /:id, POST /, PATCH /:id, DELETE /:id

/api/stocks/items

Niveaux de stock par article et dépôt.

GET /api/stocks/items

Paramètre

Type

Description

company

ObjectId

Tenant courant

article

ObjectId

Filtre par article

depot

ObjectId

Filtre par dépôt

page

number

Page (défaut : 1)

limit

number

Résultats par page (défaut : 10)

  • 200 — liste paginée

GET /api/stocks/items/:id

  • 200 — objet Stock

POST /api/stocks/items

  • 201 — créé

PATCH /api/stocks/items/:id

  • 200 — mis à jour

DELETE /api/stocks/items/:id

  • 204 — supprimé

/api/stocks/batches

Lots de réception d’articles (numéro de lot, date d’expiration).

CRUD standard : GET /, GET /:id, POST /, PATCH /:id, DELETE /:id

/api/stocks/movements

Mouvements de stock (entrées, sorties, ajustements). Les mouvements sont en lecture seule ou créés automatiquement par le système.

GET /api/stocks/movements

Paramètre

Type

Description

company

ObjectId

Tenant courant

article

ObjectId

Filtre par article

depot

ObjectId

Filtre par dépôt

type

string

in, out, transfer, adjustment, reservation ou return

reason

string

purchase, sale, return, adjustment, transfer ou inventory

page

number

Page (défaut : 1)

limit

number

Résultats par page (défaut : 10)

  • 200 — liste paginée

GET /api/stocks/movements/:id

  • 200 — objet StockMovement

POST /api/stocks/movements

Crée un mouvement manuellement (cas exceptionnels). En règle générale les mouvements sont générés automatiquement.

  • 201 — créé

/api/stocks/reservations

Réservations de stock liées à des commandes ou devis.

CRUD standard : GET /, GET /:id, POST /, PATCH /:id, DELETE /:id

/api/stocks/backorders

Commandes en attente de réapprovisionnement.

CRUD standard : GET /, GET /:id, POST /, PATCH /:id, DELETE /:id

/api/stocks/transfers

Transferts de stock entre dépôts.

GET /api/stocks/transfers

  • 200 — liste paginée

GET /api/stocks/transfers/:id

  • 200 — objet StockTransfer

POST /api/stocks/transfers

  • 201 — transfert créé

PATCH /api/stocks/transfers/:id

  • 200 — mis à jour

DELETE /api/stocks/transfers/:id

  • 204 — supprimé

GET /api/stocks/transfers/:transferId/lines

Liste les lignes d’un transfert.

  • 200 — liste de lignes

POST /api/stocks/transfers/:transferId/lines

Ajoute une ligne au transfert.

  • 201 — ligne créée

GET /api/stocks/transfers/:transferId/lines/:lineId

  • 200 — objet StockTransferLine

PATCH /api/stocks/transfers/:transferId/lines/:lineId

  • 200 — mis à jour

DELETE /api/stocks/transfers/:transferId/lines/:lineId

  • 204 — supprimé

/api/stocks/inventories

Inventaires de stock (complet ou partiel par zone/article).

GET /api/stocks/inventories

  • 200 — liste paginée

GET /api/stocks/inventories/:id

  • 200 — objet StockInventory

POST /api/stocks/inventories

  • 201 — créé

PATCH /api/stocks/inventories/:id

  • 200 — mis à jour

DELETE /api/stocks/inventories/:id

  • 204 — supprimé

GET /api/stocks/inventories/:inventoryId/lines

Liste les lignes d’inventaire (comptage par emplacement).

  • 200 — liste

POST /api/stocks/inventories/:inventoryId/lines

  • 201 — ligne créée

GET /api/stocks/inventories/:inventoryId/lines/:lineId

  • 200 — objet StockInventoryLine

PATCH /api/stocks/inventories/:inventoryId/lines/:lineId

  • 200 — mis à jour

GET /api/stocks/inventories/:inventoryId/adjustments

Liste les ajustements générés lors de la validation de l’inventaire.

  • 200 — liste d’ajustements

GET /api/stocks/inventories/:inventoryId/adjustments/:adjustmentId

  • 200 — objet StockInventoryAdjustment