Supprimer un vendeur ou une vendeuse

Cette page vous explique comment supprimer un vendeur ou une vendeuse des publicités de partenaires géré·es.

Remarque : les entreprises qui vendent leurs produits par le biais de marketplaces ou de distributeur·ices sont qualifiés de vendeurs ou de vendeuses. Les vendeurs et vendeuses que vous intégrez dans les publicités de partenaires géré·es sont considéré·es comme des partenaires géré·es. Pour plus de simplicité, nous utiliserons sur cette page les termes « vendeur » et « vendeuse » pour désigner les partenaires géré·es (c’est-à-dire les personnes ou entreprises intégrées).

Un vendeur ou une vendeuse ayant des campagnes publicitaires actives NE PEUT PAS être supprimé·e.

L’API Seller Deletion désactive le compte publicitaire et supprime les éléments créés durant l’intégration, y compris :

Segment de catalogue
Page
Utilisateur·ice système
Entreprise

Une fois que le vendeur ou la vendeuse est supprimé·e, vous pouvez réutiliser et réattribuer son vendor_id à un autre vendeur ou une autre vendeuse.

Avant de commencer

Avant de supprimer un vendeur ou une vendeuse, veillez à effectuer les actions suivantes :

Autorisations requises

Pour appeler l’API Seller Deletion, vous aurez besoin des autorisations suivantes :

Admin de l’entreprise
Gestion du crédit
Développement d’applications

Appel d’API Seller Deletion

Requête

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "DELETE", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses?child_business_external_id=<VENDOR_ID>", 
        "name": "<ASYNC_SESSION_NAME>"
      } 
  ]' \
  -F "appsecret_proof=<APP_SECRET>" \
  "https://graph.facebook.com/v21.0"

La réponse à l’appel d’API est renvoyée immédiatement avec un ASYNC_SESSION_ID. Pendant le traitement de la requête, interrogez le statut de l’ASYNC_SESSION_ID jusqu’à ce que celui-ci indique [COMPLETED|FAILED].

Paramètres

Nom	Description
`appsecret_proof` chaîne	Obligatoire. Chaîne hexadécimale prouvant la propriété du token d’accès fourni. Le `appsecret_proof` doit être généré à partir du token d’accès et de la clé secrète du marketplace.
`child_business_external_id` chaîne	Obligatoire, sauf si `child_business_id` est fourni. Chaque marketplace doit passer un ID unique pour chaque vendeur ou vendeuse. Le nom du champ côté marketplace est `vendor_id`.
`child_business_id` chaîne	Obligatoire, sauf si `child_business_external_id` est fourni. ID Business Manager du vendeur ou de la vendeuse.
`marketplace_bm_id` chaîne	Obligatoire. ID Business Manager du marketplace. Voir Trouver votre ID d’entreprise dans Meta Business Manager pour plus d’informations.

Réponse

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

Utilisez l’ASYNC_SESSION_ID pour obtenir le statut de suppression d’un vendeur ou d’une vendeuse dans les publicités de partenaires géré·es.

Voir Comment interroger le statut d’une session asynchrone pour plus d’informations.

Réponse en cas de réussite

Si le statut de la session asynchrone est COMPLETED, vous obtiendrez un résultat du type :

{
  "result": "{\"id\":\"<MANAGED_PARTNER_BM_ID>\", \"success\":true}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

Réponse en cas d’échec

Si le statut de la session asynchrone est FAILED, vous obtiendrez un résultat du type :

Codes d’erreur

Les requêtes envoyées à l’API de suppression de vendeur ou de vendeuse peuvent générer plusieurs réponses différentes en cas d’erreur. Pour plus d’informations, consultez la section Comment traiter une erreur.

Code d’erreur	Sous-code d’erreur	Message d’erreur
1800007	2310162	L’ID d’entreprise {business_id} que vous avez saisi ne correspond à aucun·e partenaire dans les publicités de partenaires géré·es. Vérifiez votre saisie ou indiquez un autre ID d’entreprise.
1800007	2310163	L’ID de vendeur ou de vendeuse {vendor_id} que vous avez saisi ne correspond à aucun·e partenaire dans les publicités de partenaires géré·es. Vérifiez votre saisie ou indiquez un autre ID de vendeur ou de vendeuse.
1800008	2310164	Votre entreprise ne gère pas la ou le partenaire {business_id OR vendor_id} que vous essayez de supprimer. Vérifiez l’ID ou saisissez-en un autre.
1800009	2310113	Impossible de supprimer la ou le partenaire géré·e associé·e à l’ID d’entreprise {business_id}. Elle ou il ne peut pas être supprimé·e avec un solde dû de {amount} {currency}. Vous pourrez renouveler votre tentative de suppression de la ou du partenaire une fois votre facture réglée.
1800009	2310134	La ou le propriétaire {page_owner_id} de la Page {page_id} n’est pas un·e utilisateur·ice système admin. La Page n’a pas été créée via les publicités de partenaires géré·es et elle doit d’abord être supprimée pour que vous puissiez supprimer la ou le partenaire.
1800009	2310135	Cette ou ce partenaire possède une ou plusieurs Pages Facebook qui n’ont pas été créées via les publicités de partenaires géré·es. Ces Pages doivent d’abord être supprimées pour que vous puissiez supprimer la ou le partenaire : {list_of_page_ids}
1800009	2310165	L’entreprise ne peut pas être supprimée tant qu’elle a des campagnes actives. Vous pourrez la désactiver dans le Gestionnaire de publicités une fois que ses campagnes actives seront terminées.