API Mouvements de Stock

Suivez et enregistrez les mouvements de stock dans vos entrepots. Chaque modification d'inventaire est enregistree comme un mouvement.

Endpoints

GET

/stock-movements

stock_movements:read

Obtenir une liste paginee des mouvements de stock. Supporte les filtres par produit, entrepot, type et plage de dates.

POST

/stock-movements

stock_movements:write

Enregistrer un nouveau mouvement de stock. Les niveaux d'inventaire seront mis a jour automatiquement.

Reference des Champs

Champ	Type	Obligatoire	Description
id	string	Non	Identifiant unique du mouvement de stock (lecture seule)
productId	string	Oui	Identifiant du produit
productSku	string	Non	SKU du produit (lecture seule)
productName	string	Non	Nom du produit (lecture seule)
warehouseId	string	Oui	Identifiant de l'entrepot
warehouseName	string	Non	Nom de l'entrepot (lecture seule)
variantId	string	Non	Identifiant de la variante du produit (le cas echeant)
quantity	integer	Oui	Quantite du mouvement (entier positif)
movementType	string	Oui	IN, OUT, ADJUSTMENT, TRANSFER_OUT ou TRANSFER_IN
reference	string	Non	Numero de reference (ex. bon de commande)
unitCost	integer	Non	Cout unitaire en centimes
batchNumber	string	Non	Numero de lot
notes	string	Non	Notes supplementaires
createdAt	datetime	Non	Horodatage ISO 8601 (lecture seule)

Parametres de Requete (Liste)

Champ	Type	Obligatoire	Description
page	integer	Non	Numero de page (defaut : 1)
limit	integer	Non	Elements par page (defaut : 20, max : 100)
productId	string	Non	Filtrer par ID de produit
warehouseId	string	Non	Filtrer par ID d'entrepot
movementType	string	Non	Filtrer par type : IN, OUT, ADJUSTMENT, TRANSFER_OUT, TRANSFER_IN
from	string	Non	Filtre de date de debut (ISO 8601)
to	string	Non	Filtre de date de fin (ISO 8601)

Exemple

Lister les mouvements de stock

bash

curl "https://api.mercozy.com/api/v1/external/stock-movements?page=1&limit=20&movementType=IN" \
  -H "X-API-Key: mk_live_xxxxx"

Creer un mouvement de stock

bash

curl -X POST "https://api.mercozy.com/api/v1/external/stock-movements" \
  -H "X-API-Key: mk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "product-uuid",
    "warehouseId": "warehouse-uuid",
    "quantity": 100,
    "movementType": "IN",
    "reference": "PO-2024-001",
    "notes": "Initial stock"
  }'

Exemple de Reponse

json

{
  "data": {
    "id": "sm_abc123",
    "productId": "product-uuid",
    "productSku": "WDG-001",
    "productName": "Premium Widget",
    "warehouseId": "warehouse-uuid",
    "warehouseName": "Main Warehouse",
    "variantId": null,
    "quantity": 100,
    "movementType": "IN",
    "reference": "PO-2024-001",
    "unitCost": null,
    "batchNumber": null,
    "notes": "Initial stock",
    "createdAt": "2025-12-15T10:30:00Z"
  }
}