Aller au contenu principal

API de stock

L'API de stock vous permet de lire les informations de stock actuelles d'un produit ainsi que l'historique complet de ses mouvements de stock, et vous donne un aperçu des modifications récentes dans l'ensemble de votre catalogue.

Tous les points de terminaison sont en lecture seule et nécessitent la portée stock:read. Authentifiez chaque requête comme décrit dans Authentification.

URL de base : https://api.storelinkr.com

Obtenir les informations de stock d'un produit​

Renvoie le stock actuel d'un seul produit, avec la répartition par emplacement et les sources qui ont fourni le stock. Vous pouvez rechercher le produit par UUID, EAN ou SKU.

GET /api/public/v2/catalog/products/{uuid}/stock
GET /api/public/v2/catalog/products/ean/{ean}/stock
GET /api/public/v2/catalog/products/sku/{sku}/stock

Exemple​

curl -X GET "https://api.storelinkr.com/api/public/v2/catalog/products/ean/8712345678901/stock" \
     -H "X-StoreLinkr-Api-Key: your_api_token_here" \
     -H "X-StoreLinkr-Api-Secret: your_api_secret_here" \
     -H "Accept: application/json"

Réponse​

{
  "status": "success",
  "product": {
    "uuid": "01234567-89ab-cdef-0123-456789abcdef",
    "ean": "8712345678901",
    "sku": "SKU-001"
  },
  "stock": {
    "has_stock": true,
    "quantity_available": 18,
    "quantity_supplier": 0,
    "delivery_date": null,
    "stock_locations": [
      { "name": "Warehouse 1", "quantity": 3, "source": "CYCLESOFTWARE" },
      { "name": "Warehouse 2", "quantity": 5, "source": "CYCLESOFTWARE" }
    ],
    "sources": ["CYCLESOFTWARE"]
  }
}
ChampDescription
has_stockIndique si le produit a du stock disponible.
quantity_availableLa quantité totale disponible (somme de tous les entrepôts).
quantity_supplierLe stock détenu chez un fournisseur (dropshipping).
delivery_dateLa date de livraison prévue, si elle est connue.
stock_locationsLa répartition par entrepôt.
sourcesLes intégrations qui ont fourni le stock.

Si aucun produit ne correspond, l'API renvoie 404 Not Found.

Obtenir les mouvements de stock d'un produit​

Renvoie l'historique paginé des modifications de stock d'un seul produit, du plus récent au plus ancien. Disponible par UUID, EAN ou SKU.

GET /api/public/v2/catalog/products/{uuid}/stock/mutations
GET /api/public/v2/catalog/products/ean/{ean}/stock/mutations
GET /api/public/v2/catalog/products/sku/{sku}/stock/mutations

Paramètres de requête​

ParamètrePar défautDescription
limit100Nombre de résultats par page (maximum 500).
page0Numéro de page (en commençant à zéro).

Réponse​

{
  "status": "success",
  "product": {
    "uuid": "01234567-89ab-cdef-0123-456789abcdef",
    "ean": "8712345678901",
    "sku": "SKU-001"
  },
  "pagination": { "pages": 1, "page": 0, "start": 0, "totalRecords": 2, "limit": 100 },
  "mutations": [
    {
      "uuid": "…",
      "ean": "8712345678901",
      "previous_quantity": 5,
      "new_quantity": 3,
      "delta": -2,
      "product_quantity": 18,
      "stock_location_uuid": "…",
      "stock_location_name": "Warehouse 1",
      "source": "ORDER_DEDUCTION",
      "source_label": "Order deduction",
      "changed_by": "CYCLESOFTWARE",
      "reference": "1078",
      "created": "2026-07-19T10:00:00+00:00"
    }
  ]
}

Chaque mouvement décrit la modification dans un entrepôt : previous_quantity et new_quantity sont les niveaux de cet entrepôt, delta est la variation et product_quantity est le total du produit après la modification. Consultez Historique des stocks pour savoir comment ils sont enregistrés.

Mouvements de stock récents (tout le catalogue)​

Renvoie un aperçu paginé des modifications de stock les plus récentes dans l'ensemble de votre catalogue, du plus récent au plus ancien. Utilisez-le pour créer des tableaux de bord ou pour interroger régulièrement les modifications.

GET /api/public/v2/catalog/stock/mutations

Il accepte les mêmes paramètres de requête limit et page et renvoie les mêmes structures pagination et mutations que ci-dessus (sans l'objet product, car les entrées peuvent concerner de nombreux produits).

Exemple​

curl -X GET "https://api.storelinkr.com/api/public/v2/catalog/stock/mutations?limit=50" \
     -H "X-StoreLinkr-Api-Key: your_api_token_here" \
     -H "X-StoreLinkr-Api-Secret: your_api_secret_here" \
     -H "Accept: application/json"