Skip to main content
Version: Latest

Listado de Agentes o canales de ventas

Permite ver los agentes o canales de venta de la empresa.

Token obligatorio

Este servicio requiere el token que entrega la Autenticación. El token debe pertenecer a la misma empresa que envías en idempresa. Si tu integración hoy lo consulta sin token, agrégalo: las peticiones sin token o con el token de otra empresa serán rechazadas.

Request 🚀​

url​

https://app.aveonline.co/api/comunes/v1.0/agentes.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "listarAgentesPorEmpresaAveStocks"
  • token* String Token recibido en la Autenticación con vigencia de una hora Se debe usar el valor de **data.tokenBody** de la respuesta.
  • idempresa* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación

Ejemplo​

{
  "tipo": "listarAgentesPorEmpresaAveStocks",
  "token": "TU_TOKEN_JWT",
  "idempresa": 15289
}

Response 📄​

Success​

  • status String Estado del resultado
  • message String Mensaje de respuesta
  • agentes Array Object -> [{}]
    • id Number Identificador de agente
    • nombre String Nombre del agente
    • identificacion String Identificación del agente
    • email String Correo electrónico asociado al agente
    • direccion String Dirección del agente
    • telefono String Número telefónico del agente
    • idciudad String Ciudad del agente
    • principal String Agente principal S/N
    • nombrecontacto String Nombre de contacto del agente
    • tienevalorminimo Boolean Valor minimo declarado

Ejemplo​

{
  "status": "ok",
  "message": "registros encontrados",
  "agentes": [
    {
      "id": 10535,
      "nombre": "Admin wehbf",
      "email": "admiqen@handymail.com",
      "direccion": "Calle 43 #88",
      "telefono": "452436369",
      "idciudad": "MEDELLIN(ANTIOQUIA)",
      "principal": "S",
      "nombrecontacto": "test",
      "tienevalorminimo": false

    },
    {
      "id": 111231,
      "nombre": "DEs",
      "email": "adewrtmin@handymail.com",
      "direccion": "Calle 49 #88",
      "telefono": "45634369",
      "idciudad": "BOGOTA(CUNDINAMARCA)",
      "principal": "N",
      "nombrecontacto": "test",
      "tienevalorminimo": false

    },
    {
      "id": 123117,
      "nombre": "oqenj ave",
      "email": "admreiin@handymail.com",
      "direccion": "Carrera 23 #88",
      "telefono": "456345369",
      "idciudad": "MANIZALES(CALDAS)",
      "principal": "N",
      "nombrecontacto": "test",
      "tienevalorminimo": false

    }
  ]
}

Error​

No se encuentran datos asociados​

{
  "status": "error",
  "message": "registros no encontrados",
  "estados": []
}

Credenciales incorrectas o token expirado​

{
  "status": "error",
  "message": "credenciales incorrectas"
}

Sin token o token de otra empresa​

HTTP 401

{
  "status": "error",
  "message": "no autorizado"
}