Eliminar un vendedor

En esta página se proporcionan indicaciones sobre cómo eliminar un vendedor de los anuncios de socios administrados.

Nota: Las empresas que venden sus productos mediante mercados o comercios minoristas se denominan vendedores. Una vez que incorporas un vendedor en los anuncios de socios administrados, se considera que es un socio administrado. Para simplificarlo, en esta página también se usará “vendedor” para referirse a los socios administrados (es decir, los socios incorporados).

NO SE PUEDE eliminar un vendedor con campañas publicitarias activas.

La API de eliminación de vendedores inhabilita la cuenta publicitaria y elimina cualquier activo que se haya creado durante la incorporación, como, por ejemplo:

Segmento de catálogo
Página
Usuario del sistema
Empresa

Una vez eliminado correctamente, si quieres, puedes reutilizar el vendor_id asociado del vendedor y asignarlo a otro vendedor.

Antes de empezar

Antes de eliminar un vendedor, asegúrate de completar estos pasos:

Permisos necesarios

Para llamar a la API de eliminación de vendedores, necesitarás los siguientes permisos:

Administrador de la empresa
Administrar el crédito
Desarrollador de aplicaciones

Llamada a la API de eliminación de vendedores

Solicitud

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/v20.0"

La respuesta de la llamada a la API se devuelve inmediatamente con un ASYNC_SESSION_ID. Mientras la solicitud se sigue procesando, se debe consultar el valor de ASYNC_SESSION_ID hasta que se alcance el estado terminal [COMPLETED|FAILED].

Parámetros

Nombre	Descripción
`appsecret_proof` Cadena	Obligatorio. Cadena hexadecimal para demostrar la propiedad del identificador de acceso proporcionado. El parámetro `appsecret_proof` se debe generar a partir del identificador de acceso del mercado y la clave secreta de la aplicación.
`child_business_external_id` Cadena	Obligatorio, excepto si se proporciona `child_business_id`. Cada mercado debe pasar un identificador único para cada vendedor. Nombre del campo en el lado de los mercados es `vendor_id`.
`child_business_id` Cadena	Obligatorio, excepto si se proporciona `child_business_external_id`. Identificador de la cuenta de Business Manager del vendedor.
`marketplace_bm_id` Cadena	Obligatorio. Identificador de la cuenta de Business Manager del mercado. Consulta Encontrar el identificador de tu empresa en Meta Business Manager para obtener más información.

Respuesta

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

Usa el valor de ASYNC_SESSION_ID para obtener el estado de eliminación del vendedor de los anuncios de socios administrados.

Consulta Cómo consultar la sesión asíncrona para obtener una respuesta para obtener más información.

Respuesta correcta

Si el estado es COMPLETED, los datos resultantes de la consulta de la sesión asíncrona tendrán el siguiente aspecto:

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

Respuesta con error

Si el estado es FAILED, los datos resultantes de la consulta de la sesión asíncrona tendrán el siguiente aspecto:

Códigos de error

Las solicitudes realizadas a la API de eliminación de vendedores pueden dar como resultado varias respuestas de error. Consulta Cómo gestionar un error para obtener más información.

Código de error	Subcódigo de error	Mensaje de error
1800007	2310162	El identificador de empresa que has introducido ({business_id}) no es el de un socio de los anuncios de socios administrados. Comprueba tu entrada o introduce un nuevo identificador de empresa.
1800007	2310163	El identificador de proveedor que has introducido ({vendor_id}) no es el de un socio de los anuncios de socios administrados. Comprueba tu entrada o introduce un nuevo identificador de proveedor.
1800008	2310164	Tu empresa no administra el socio ({business_id O vendor_id}) que intentas eliminar. Comprueba el identificador o introduce otro.
1800009	2310113	No se puede eliminar el socio administrado con el identificador de empresa {business_id}. No se puede eliminar mientras tenga un saldo pendiente de {amount} {currency}. Una vez que remitas el pago de la factura, vuelve a intentar eliminar el socio.
1800009	2310134	El propietario {page_owner_id} de la página {page_id} no es un usuario administrador del sistema. La página no se ha creado mediante los anuncios de socios administrados y se tiene que eliminar para poder eliminar el socio.
1800009	2310135	Este socio tiene una o varias páginas de Facebook que no se han creado mediante los anuncios de socios administrados. Estas páginas tienen que eliminarse para poder eliminar el socio: {list_of_page_ids}.
1800009	2310165	No se puede eliminar la empresa mientras tenga campañas activas. Ve al Administrador de anuncios para consultar cuándo finalizarán sus campañas activas o desactivarlas.