Retirer des canaux et faire le ménage

Retirer d'un canal

curl -X DELETE https://api.nembol.com/rest/v1/listings/{id} \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Idempotency-Key: delist-VDJ-001-shopify"

La réponse est 202, et le worker retire l'annonce du canal. L'enregistrement de l'annonce est conservé avec status: "delisted" (historique préservé) ; vous pouvez la republier à tout moment avec POST /listings.

Supprimer un produit

curl -X DELETE https://api.nembol.com/rest/v1/products/{id} \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Idempotency-Key: delete-VDJ-001"

Supprimer, c'est archiver : le produit disparaît de GET /products et de toute recherche le concernant (?sku= compris), sauf si vous demandez status=archived ; il reste lisible par id (GET /products/{id}, statut archived), il peut donc être restauré. Un produit archivé avec merged_into renseigné a été fusionné dans ce produit ; avec merged_into: null, il a été supprimé. Rien n'est détruit. Si le produit a encore des annonces en ligne, vous obtenez 422 product_still_listed. Retirez-le d'abord de tous les canaux. Le retrait se fait en arrière-plan : si vous supprimez pendant qu'il est en cours, vous obtenez 409 listing_operation_in_progress. Attendez operation.completed (ou interrogez l'annonce jusqu'à delisted), puis supprimez ; ne réessayez pas en boucle. Ce garde-fou est voulu : il rend impossible la « suppression accidentelle d'un produit en ligne ».

Pièges à éviter

• Les annonces importées/liées ne peuvent pas être retirées via Nembol (listing_not_delistable). Elles appartiennent au canal : gérez-les sur le canal ou déconnectez-le.
• Retirer n'est pas supprimer. L'annonce sur le canal prend fin, le produit Nembol reste intact avec toutes ses données.
• Vérifiez sur le canal si c'est important : interrogez l'annonce jusqu'à delisted, puis l'ancienne url_on_channel doit renvoyer une 404.

Dernière mise à jour le 22 octobre 2026