GUIDE VENDEUR · API STOCK

Synchroniser le stock dès qu’il change

Votre logiciel envoie chaque modification à Boutique9okz par une requête sécurisée. Le stock, le prix ou le statut d’une annonce existante sont traités immédiatement, sans attendre un import manuel.

Créer une clé API Préférer un fichier CSV ou Excel

MISE EN ROUTE

Créer la connexion en quatre étapes

1
Ouvrez l’Espace Pro
Dans « API stock temps réel », cliquez sur « Gérer mes clés ».
2
Nommez la connexion
Par exemple « ERP principal » ou « Gestion stock magasin ».
3
Copiez la clé immédiatement
La clé complète n’est affichée qu’une seule fois. Conservez-la dans les secrets de votre serveur.
4
Testez sur une annonce
Envoyez un SKU connu, contrôlez la réponse, puis activez les envois automatiques.

REQUÊTE HTTP

Envoyer le nouveau stock

Utilisez l’adresse https://boutique9okz.fr/api/v1/inventory avec la méthode POST. Une clé d’idempotence différente accompagne chaque événement et permet de rejouer sans doublon une requête interrompue.

EXEMPLE CURL

curl -X POST "https://boutique9okz.fr/api/v1/inventory" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Idempotency-Key: stock-20260813-000001" \
  -H "Content-Type: application/json" \
  -d '{"updates":[{"sku":"LIVRE-001","stock":4,"price":12.90,"status":"Active"}]}'

ChampUtilitéRègle

skuVotre référence vendeurRecommandée et prioritaire après l’ID

eanEAN, ISBN ou UPCAccepté si une seule de vos annonces utilise ce code

stockQuantité disponibleEntier positif ou nul

pricePrix en eurosNombre égal ou supérieur à 1,00

statusPublicationActive, Brouillon ou En pause

CONTRÔLE

Traiter chaque résultat

La réponse distingue les annonces modifiées, inchangées et refusées. Une erreur sur une ligne n’annule pas les autres lignes valides de la même requête. Le champ index commence à 0 pour identifier la ligne concernée dans le tableau updates.

EXEMPLE DE RÉPONSE

{
  "request_id": "…",
  "received": 1,
  "changed": 1,
  "unchanged": 0,
  "error_count": 0,
  "errors": []
}

SÉCURITÉ & PÉRIMÈTRE

Ce que protège la connexion

ISOLATION

Vos annonces uniquement

Une clé est rattachée à un seul compte vendeur. Elle ne peut ni lire ni modifier le stock d’un autre vendeur.

RÉVOCATION

Couper un accès

Révoquez immédiatement une clé perdue ou inutilisée depuis l’Espace Pro, puis créez-en une nouvelle.

CONNEXION SERVEUR

Créez votre première clé vendeur

Commencez par une annonce test et conservez la clé uniquement dans votre logiciel de gestion.

Ouvrir l’Espace Pro