Stock

Tous ces outils s’appellent en POST avec une clé bbv_. Ce sont aussi les outils du serveur MCP.

vendor_context_getCopier le lien

Périmètre : lecture, clé read ou write.

Contexte de la clé : l’entreprise, ses points de retrait (id à donner pour créer une pièce) et les essences saisissables (nom, masse volumique).

Aucun paramètre nommé.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_context_get \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

vendor_stock_listCopier le lien

Périmètre : lecture, clé read ou write.

Pièces vivantes de l’entreprise, en ligne ou non (500 au plus, les plus récentes d’abord) : numéro, type, essence, dimensions, unité, prix, quantités, publication. Filtres q, published. Paginé : limit, offset.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_stock_list \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

vendor_pieces_nearCopier le lien

Périmètre : lecture, clé read ou write.

Pièces disponibles les plus proches de critères (essence, type, épaisseur, largeur, longueur, qualité, sec) quand rien ne correspond exactement, triées par écart : même essence d’abord, puis écart relatif des dimensions. Critères à la main, ou repris d’une ligne de demande de pièces (requestRef + requestLine). Chaque pièce porte ses écarts (mm, m) et sa qualité, pour proposer une alternative au client. Seulement le stock en ligne de l’entreprise ; une ligne de demande doit lui être adressée.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_near \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

vendor_pieces_getCopier le lien

Périmètre : lecture, clé read ou write.

Une pièce par id ou reference (numéro), avec ses photos ; history: true ajoute l’historique des modifications.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_get \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

vendor_pieces_createCopier le lien

Périmètre : écriture, clé write seulement.

Ajoute un lot de pièces identiques au stock. storageLocationId : un point de retrait de l’entreprise (vendor_context_get). Au mètre ou au m², priceHt obligatoire ; à la pièce, prix de la formule active si absent ; poids calculé si absent. Créée hors ligne sauf publish: true.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_create \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "…",
  "essence": "…",
  "storageLocationId": "00000000-0000-0000-0000-000000000000",
  "thicknessMm": 5,
  "widthMm": 5,
  "lengthM": 0.1,
  "quantityTotal": 1
}'

vendor_pieces_updateCopier le lien

Périmètre : écriture, clé write seulement.

Modifie une pièce : fields ne contient QUE les champs à changer, le reste est repris de la pièce. Une pièce déjà vendue ne change plus que de quantité (jamais sous le vendu) et de prix.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_update \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "00000000-0000-0000-0000-000000000000",
  "fields": {}
}'

vendor_pieces_duplicateCopier le lien

Périmètre : écriture, clé write seulement.

Crée une nouvelle pièce à partir d’une existante (comme « Dupliquer » de l’écran Stock), avec overrides pour les champs qui changent. Créée hors ligne.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_duplicate \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "00000000-0000-0000-0000-000000000000"
}'

vendor_pieces_publishCopier le lien

Périmètre : écriture, clé write seulement.

Met une pièce en ligne (published: true, exige un prix) ou la retire du site (false, archivage). Le stock et les commandes en cours ne bougent pas.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_publish \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "00000000-0000-0000-0000-000000000000",
  "published": true
}'

vendor_pieces_deleteCopier le lien

Périmètre : écriture, clé write seulement.

Supprime une pièce jamais vendue ni commandée (suppression logique, restaurable, numéro conservé). Sinon refusé : la retirer du site avec vendor_pieces_publish.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_delete \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "00000000-0000-0000-0000-000000000000"
}'

vendor_pieces_images_setCopier le lien

Périmètre : écriture, clé write seulement.

Remplace la galerie photo d’une pièce (URLs http(s) déjà hébergées, texte alternatif, cadrage center ou top). Liste vide = aucune photo.

curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_pieces_images_set \
  -H "Authorization: Bearer $CLE" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "00000000-0000-0000-0000-000000000000",
  "images": []
}'