Recette — créer un plan

C’est le flux canonical d’écriture : créer un plan de réassort, puis ajouter un article. La même forme s’applique aux autres types de plans (réassort, etc.) — seuls les chemins et champs diffèrent.

Cela crée des données réelles dans votre organisation. Utilisez un token avec la bonne permission d’écriture et testez d’abord contre une organisation non-production si vous le pouvez.

1. Créer le plan

POST /api/restock-plans avec name (et optionnellement brandId, collectionId, description). Il retourne l’id du nouveau plan et le status (DRAFT).

cURL
Python
JavaScript

curl -X POST https://app.solya.app/api/restock-plans \
  -H "Authorization: Bearer solya_sa_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Adidas FW25 Restock Wave 1",
    "brandId": "brand-uuid-adidas",
    "collectionId": "coll-uuid-fw25",
    "description": "First restock order for Adidas FW25"
  }'

import requests
BASE, TOKEN = "https://app.solya.app", "solya_sa_xxx"
headers = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}

plan = requests.post(f"{BASE}/api/restock-plans", headers=headers, json={
    "name": "Adidas FW25 Restock Wave 1",
    "brandId": "brand-uuid-adidas",
    "collectionId": "coll-uuid-fw25",
}).json()
plan_id = plan["id"]   # e.g. "rop-uuid-001"; status == "DRAFT"

const BASE = "https://app.solya.app", TOKEN = "solya_sa_xxx"
const headers = { Authorization: `Bearer ${TOKEN}`, "Content-Type": "application/json" }

const plan = await (await fetch(`${BASE}/api/restock-plans`, {
  method: "POST", headers,
  body: JSON.stringify({
    name: "Adidas FW25 Restock Wave 1",
    brandId: "brand-uuid-adidas",
    collectionId: "coll-uuid-fw25",
  }),
})).json()
const planId = plan.id // status: "DRAFT"

Réponse :

{ "id": "rop-uuid-001", "brandId": "brand-uuid-adidas", "collectionId": "coll-uuid-fw25", "status": "DRAFT" }

2. Ajouter un article

POST /api/restock-plans/{planId}/items avec variantId, sizeId, shopId, quantity. Il retourne { "success": true, "itemId": "…" }.

cURL
Python
JavaScript

curl -X POST https://app.solya.app/api/restock-plans/rop-uuid-001/items \
  -H "Authorization: Bearer solya_sa_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "variantId": "var-uuid-adidas-stan", "sizeId": "sz-uuid-43", "shopId": "shop-uuid-paris-opera", "quantity": 12 }'

res = requests.post(
    f"{BASE}/api/restock-plans/{plan_id}/items",
    headers=headers,
    json={"variantId": "var-uuid-adidas-stan", "sizeId": "sz-uuid-43",
          "shopId": "shop-uuid-paris-opera", "quantity": 12},
).json()

if not res.get("success"):
    raise RuntimeError(f"add item failed: {res.get('errorCode')}")
print("added item", res["itemId"])

const res = await (await fetch(`${BASE}/api/restock-plans/${planId}/items`, {
  method: "POST", headers,
  body: JSON.stringify({
    variantId: "var-uuid-adidas-stan", sizeId: "sz-uuid-43",
    shopId: "shop-uuid-paris-opera", quantity: 12,
  }),
})).json()
if (!res.success) throw new Error(`add item failed: ${res.errorCode}`)
console.log("added item", res.itemId)

Gérer la réponse

Ajouter des articles passe par des règles métier, alors préparez-vous à ces résultats :

Succès — { "success": true, "itemId": "…" }.
Bloqué par une règle — success: false avec errorCode: "BUSINESS_RULE_VIOLATION"; lisez le message et ajustez.
Validation — errorCode: "VARIANT_REQUIRED", "QUANTITY_INVALID", etc. Corrigez la charge utile.
Authentification — 401 UNAUTHORIZED (token mauvais/expiré) ou 403 FORBIDDEN (permission manquante).

Voir Codes d’erreur pour le mapping complet.

Les autres types de plans suivent le même motif — par ex. réassort est POST /api/rebalance-plans puis POST /api/rebalance-plans/{id}/items. Consultez les champs exacts par endpoint dans l’onglet Référence API.

Intégration API

Recettes API

Plateforme & modèle de données

Couche décision (référence)

Exploitation & infrastructure

Specs d'ingestion (référence)

Workflows (référence)

Règles de tagging (référence)

Alertes (référence)

Recette — créer un plan

1. Créer le plan

2. Ajouter un article

Gérer la réponse

​1. Créer le plan

​2. Ajouter un article

​Gérer la réponse

1. Créer le plan

2. Ajouter un article

Gérer la réponse