Connectez commandes, stocks et entrepôts avec l’API Boostmyshop

L’API REST Boostmyshop ouvre votre logistique e-commerce à votre ERP, à votre BI et à vos outils maison : commandes, stock, préparation, achats et transport, en lecture comme en écriture.

Dans Boostmyshopcommandes, stock, entrepôts

Votre codeappelle l’API REST

Boostmyshop Ventes Commandes

Commandes

Les commandes à expédier dans Boostmyshop
CommandeCanalClientÉtat
1064APIMargaux F.Nouvelle
1060AmazonMarc T.En stock
1058ManoManoLéa M.Bloquée
1053CdiscountPaul D.Non allouée
1051ShopifyInès L.Erreur étiquette
1047PrestaShopHugo B.Épuisée
1042AmazonCamille R.Partielle

7 commandes

Requête

POST/api/v2/sales/orders

Authorization: Bearer $TOKEN
Content-Type: application/json
{
  "integration_id": 4,
  "store_id": 1,
  "reference": "1064",
  "status": "processing",
  "payment_method": "card",
  "customer": { "firstname": "Margaux", "lastname": "F.", … },
  "billing_address": { … },
  "shipping_address": { … },
  "shipping": { "method": "colissimo_home" },
  "items": [{ "product_id": 214, "qty": 1, … }]
}

Réponse201 Created

{
  "id": 1064,
  "reference": "1064",
  "status": "processing",
  "created_at": "2026-11-17T10:42:00+01:00",
  "items": [
    { "sku": "SWEAT-GRY-L", "qty": 1, "qty_to_ship": 1 }
  ],
  …
}

L’essentiel

Une API REST, avec sa documentation OpenAPI complète.

Ce que votre développeur cherche en premier, relevé dans la documentation de l’API.

Format
REST et JSON
Documentation
complète, au format OpenAPI 3.0.3
Opérations
164
Débit
300 appels par minute

Relevé le

Ce que couvre l’API

API logistique e-commerce : 164 opérations, de la commande à l’achat.

API OMS, API WMS, stock et achats : chaque métier de Boostmyshop expose ses opérations de lecture et d’écriture.

Commandes et retours

Créez et modifiez les commandes, bloquez-les ou annulez-les, lisez expéditions, factures et avoirs, traitez les retours.

42 opérations

18 en lecture24 en écriture

Voir les chemins
  • POST/api/v2/sales/orders
  • POST/api/v2/sales/orders/{id}/hold
  • GET/api/v2/sales/shipments
  • POST/api/sales/order/{orderReference}/ship
  • GET/api/sales/invoices
  • POST/api/v2/returns/{id}/return_label

Stock et entrepôts

Lisez et ajustez le stock par SKU et par entrepôt, suivez les mouvements, gérez emplacements, transferts et missions de picking.

25 opérations

12 en lecture13 en écriture

Voir les chemins
  • GET/api/advanced-stock/product/{sku}/stocks
  • PUT/api/advanced-stock/product/{sku}/warehouse/{warehouse_id}
  • PUT/api/advanced-stock/warehouse/{warehouse_id}/items
  • GET/api/v2/stock-movements
  • POST/api/v2/transfers
  • POST/api/v2/picking-missions/{id}/scan

Préparation de commandes

Listez les commandes prêtes, partielles ou en attente de chaque entrepôt, lancez la préparation, pickez, emballez, affectez les bacs.

18 opérations

9 en lecture9 en écriture

Voir les chemins
  • GET/api/v2/order-preparation/{warehouseId}/instock
  • POST/api/v2/in-progress
  • GET/api/v2/in-progress/picking
  • POST/api/v2/in-progress/{id}/pick
  • POST/api/v2/in-progress/{id}/pack
  • POST/api/v2/in-progress/{id}/bin/{binId}

Achats et réceptions

Lisez les besoins d’approvisionnement, créez commandes fournisseurs et réceptions, tenez à jour fournisseurs et références.

34 opérations

17 en lecture17 en écriture

Voir les chemins
  • GET/api/v2/supply-needs/warehouse/{warehouseId}
  • POST/api/v2/purchase-orders
  • POST/api/v2/purchase-orders/{id}/receive
  • GET/api/v2/suppliers
  • POST/api/v2/supplier-items
  • POST/api/v2/free-receptions/{id}/scan

Transport

Lisez les transporteurs et les modes de livraison configurés, et les tarifs disponibles pour une commande.

2 opérations

2 en lecture0 en écriture

Voir les chemins
  • GET/api/tms/carrier
  • GET/api/v2/tms/orders/{order_id}/rates

Catalogue et fabrication

Créez et modifiez produits, kits et lots, gérez les nomenclatures et les ordres de fabrication.

22 opérations

8 en lecture14 en écriture

Voir les chemins
  • POST/api/v2/products
  • GET/api/v2/products/search/{queryString}
  • POST/api/v2/kits/{productId}
  • POST/api/v2/products/{product_id}/sources
  • POST/api/v2/manufacturing
  • POST/api/v2/manufacturing/{id}/confirm

Intégrations et pilotage

Suivez vos intégrations et leurs erreurs, relancez un flux, lisez les ventes par produit et par entrepôt, créez tâches et notes.

21 opérations

14 en lecture7 en écriture

Voir les chemins
  • GET/api/v2/integrations/{integration_id}/errors
  • POST/api/v2/integrations/{id}/feed/{feed_code}/schedule
  • GET/api/v2/statistics/sales/warehouse/{warehouseId}
  • POST/api/v2/organizer
  • GET/api/v2/account/stores
  • GET/api/auth/permissions

Une documentation OpenAPI complète détaille les 164 opérations, leurs paramètres et leurs réponses.

Cas d’intégration

Votre ERP, votre BI, votre outil maison : branchés sur Boostmyshop.

Quatre intégrations courantes, appel par appel.

Votre ERP réceptionne, Boostmyshop a le bon stock.

Dans BoostmyshopStock › Produits

Votre ERPenregistre la réception

Boostmyshop Stock Produits

HOODIE-BLK-M

Stock par entrepôt

Le stock de HOODIE-BLK-M par entrepôt dans Boostmyshop
EntrepôtPhysiqueRéservéEmplacement
Lyon00—
Nantes170A-01

Derniers mouvements

Les derniers mouvements de stock de HOODIE-BLK-M
DateEntrepôtQuantitéMotif
Aujourd’hui 10:15Nantes+12Ajustement · Réception ERP 4471

Stock physique total : 17

Requête

POST/api/v2/stock-movements

Authorization: Bearer $TOKEN
Content-Type: application/json
{
  "product_id": 131,
  "to_warehouse_id": 2,
  "qty": 12,
  "category": "adjustment",
  "comments": "Réception ERP 4471"
}

Réponse201 Created

{
  "id": 58213,
  "sku": "HOODIE-BLK-M",
  "to_warehouse_name": "Nantes",
  "new_qty": 17,
  "created_at": "2026-11-17T10:15:00+01:00",
  …
}

Votre ERP reste maître du stock, et Boostmyshop prépare et expédie à partir des chiffres de votre ERP.

Le numéro de suivi de la 1064 repart vers votre canal.

Dans BoostmyshopVentes › Expéditions

Votre connecteurlit l’expédition

Boostmyshop Ventes Expéditions

Expéditions

Entrepôt : Lyon

Les expéditions de Lyon dans Boostmyshop
CommandeTransporteurSuiviÉtat
1064Colissimo6A10640000017Expédiée
1060GLS—À préparer
1051DHL—Erreur étiquette

Expédition de la commande 1064

Mode de livraison
Colissimo Domicile
N° de suivi
6A10640000017
Contenu
1 × SWEAT-GRY-L

Requête

GET/api/v2/sales/shipments?filters[order_reference]=1064

Authorization: Bearer $TOKEN

Réponse200 OK

{
  "data": [
    {
      "order_reference": "1064",
      "method_description": "Colissimo Domicile",
      "trackings": [{ "number": "6A10640000017", … }],
      "warehouse_id": 1,
      "items": [{ "sku": "SWEAT-GRY-L", "qty": 1 }]
    }
  ],
  "meta": { "total": 1 }
}

Votre client suit son colis là où il a commandé, sans ressaisie.

La commande fournisseur de Confection A, créée par votre outil d’achat.

Dans BoostmyshopAchats › Commandes fournisseurs

Votre outil d’achatcrée la commande

Boostmyshop Achats Commandes fournisseurs

Commandes fournisseurs

Entrepôt : Lyon

Les commandes fournisseurs de Lyon dans Boostmyshop
RéférenceFournisseurArrivée prévue
PO-20261117-0021Confection Ajeu. 26 nov.
PO-20261015-0003Atelier Bjeu. 19 nov.

Commande PO-20261117-0021

Fournisseur
Confection A
Entrepôt
Lyon
Produits
6
Total
1 840,00 €

Requête

POST/api/v2/purchase-orders

Authorization: Bearer $TOKEN
Content-Type: application/json
{
  "supplier_id": 7,
  "warehouse_id": 1,
  "eta": "2026-11-26",
  "items": [{ "product_id": 131, "qty": 12, "price": "21.00" }, …]
}

Réponse201 Created

{
  "id": 88,
  "reference": "PO-20261117-0021",
  "supplier_name": "Confection A",
  "warehouse_name": "Lyon",
  "eta": "2026-11-26",
  "grandtotal": "1840.00",
  …
}

La commande arrive dans Boostmyshop, prête pour la réception à Lyon.

Vos ventes par produit et par entrepôt, dans votre tableau de bord.

Votre tableau de bordventes de Lyon

Votre codelit les statistiques

Votre tableau de bord Ventes par entrepôt

Lyon

Quantités vendues

Les ventes de Lyon par produit dans votre tableau de bord
SKU30 jours15 jours5 jours
TSHIRT-RED-M41228
SWEAT-GRY-L27124

Relevé de Boostmyshop

Produits vendus
38
Périodes
30, 15 et 5 jours

Requête

GET/api/v2/statistics/sales/warehouse/1?limit=2

Authorization: Bearer $TOKEN

Réponse200 OK

{
  "periods": { "1": 30, "2": 15, "3": 5 },
  "data": [
    { "sku": "TSHIRT-RED-M", "sales_period_1": 41, … },
    { "sku": "SWEAT-GRY-L", "sales_period_1": 27, … }
  ],
  "meta": { "total": 38 }
}

Les trois périodes paramétrées dans Boostmyshop, prêtes pour vos graphiques.

Pas de code à écrire ? Vos canaux et vos transporteurs se branchent par les intégrations, votre assistant IA par le serveur MCP.

Exemple d’appel

Vos commandes en cours, en un appel.

cURL

export BMS_URL="https://…"  # l’adresse de votre compte Boostmyshop
export BMS_TOKEN="…"  # votre jeton d’accès

curl -g "$BMS_URL/api/v2/sales/orders?limit=10&filters[status]=processing" \
  -H "Authorization: Bearer $BMS_TOKEN" \
  | jq '.meta.total, [.data[].reference]'  # le total, puis les références

JavaScript

const base = process.env.BMS_URL; // l’adresse de votre compte Boostmyshop
const token = process.env.BMS_TOKEN; // votre jeton d’accès

const orders = await fetch(`${base}/api/v2/sales/orders?limit=10&filters[status]=processing`, {
  headers: { Authorization: `Bearer ${token}` },
}).then((response) => response.json());

console.log(orders.meta.total, orders.data.map((order) => order.reference)); // le total, puis les références

Python

import os, requests

base = os.environ["BMS_URL"]  # l’adresse de votre compte Boostmyshop
token = os.environ["BMS_TOKEN"]  # votre jeton d’accès

orders = requests.get(
    f"{base}/api/v2/sales/orders",
    params={"limit": 10, "filters[status]": "processing"},
    headers={"Authorization": f"Bearer {token}"},
).json()

print(orders["meta"]["total"], [order["reference"] for order in orders["data"]])  # le total, puis les références

PHP

<?php
$base = getenv('BMS_URL'); // l’adresse de votre compte Boostmyshop
$token = getenv('BMS_TOKEN'); // votre jeton d’accès

$ch = curl_init("$base/api/v2/sales/orders?" . http_build_query(['limit' => 10, 'filters' => ['status' => 'processing']]));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $token"],
    CURLOPT_RETURNTRANSFER => true,
]);
$orders = json_decode(curl_exec($ch), true);

echo $orders['meta']['total'], ' ', implode(', ', array_column($orders['data'], 'reference')), PHP_EOL; // le total, puis les références

La documentation OpenAPI complète décrit l’authentification, les schémas et toutes les opérations.

Questions fréquentes

API logistique e-commerce : ce qu’on nous demande.

Mis à jour le

Vos opérations tournent déjà sur Boostmyshop.

Commandes, stock, préparation et achats, reliés à vos canaux et à vos transporteurs.

Branchez-y vos systèmes.