Saltar al contenido principal

delete-agent

Este método se utiliza para eliminar un agente de ventas.

NOTAS

En el caso de los agentes, todos son eliminables a menos que exista un caso especial que no lo sea, por lo tanto y teniendo en cuenta lo anterior, este método solo es funcional para los agentes que tengan el campo isEditable con valor -1.

Atencion

Al eliminar un agente automáticamente dejaran de funcionar sus credenciales de inicio de sesión por lo que ya no podrán ingresar en la plataforma, así mismo, los clientes que estén asignados a ese agente dejaran de tener dicha asignación y pasaran a ser clientes normales de la tienda, es decir, clientes que no tiene asignado ningún agente de ventas.

Las órdenes de venta que estén ligadas al agente eliminado seguirán disponibles para su consulta, es decir, aunque se elimine el agente, no afectara a las órdenes de venta y podrán consultarse de manera normal, tanto en la Plataforma como por medio de la API web

Path del método​

delete-agent

Endpoint final​

PRODUCCION

https://aceptabits.com/api/thirdparty/v1/delete-agent

SANDBOX DE PRUEBAS

https://sandbox.aceptabits.com/api/thirdparty/v1/delete-agent

Método de petición HTTP​

POST

Lista de parámetros​

ParámetroObligatorioDescripciónvalor
codeSiEl código del agente que se quiere eliminarEjemplo:
pgbage9743164639751694

Deveras de ingresar el código del agente que requieres eliminar

Este código es único y puedes encontrarlo al consultar la información de un agente dentro de los metodos get-agents o show-agent

Lista de códigos​

Exitoso
CódigoDescripción
0078El agente se ha eliminado con éxito

 

Error
CódigoDescripción
0000El Token API no es correcto y la autenticación del usuario ha fallado
0003El Token API no es correcto y la autenticación del usuario ha fallado
1458El Token API no es correcto y la autenticación del usuario ha fallado
1459El código del agente es requerido
1460El agente que se intenta eliminar no existe (el código del agente es incorrecto)
1461El Token API no es correcto y la autenticación del usuario ha fallado
1462Ocurrió un problema al eliminar el agente, inténtelo nuevamente o consulte con soporte técnico para más ayuda

Ejemplo de respuesta EXITOSA​

Exitoso

Código HTTP 200


{
    "status": true,
    "success": {
        "code": "0078"
    }
}

Descripción de la respuesta​

  • Revisar el listado de códigos EXITOSO para conocer el significado de success code.

Ejemplo de respuesta FALLIDA​

Error

Código HTTP 400, Código HTTP 401, Código HTTP 500


{
    "status": false,
    "error": {
        "code": "1459"
    }
}

Descripción de la respuesta​

  • Revisar el listado de códigos ERROR para conocer la causa y saber cómo corregir
  • Si se obtiene un código HTTP 500 comunicarse a soporte técnico
  • Si se obtiene un código HTTP 401 revisar que el Token API este correcto
Notas

Si tienes alguna duda recuerda que siempre puedes contactar con el equipo de soporte para desarrolladores ingresando en el siguiente enlace: Soporte para desarrolladores.