Skip to main content
Version: Latest

Crear agente

Creación de agentes unicos asociados al usuario registrado

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, "crearAgente"
  • token* String Token recibido en la Autenticación con vigencia de una hora
  • identificacion* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación
  • nombre* String Nombre del agente
  • idnit* String Número del nit o identificación del agente
  • telefono* String Celular o fijo, sin espacios ni caracteres especiales
  • direccion* String Dirección del agente
  • correo* String Email Correo electronico del agente
  • ciudad* String | Number Nombre o el código DANE de la ciudad del agente se debe obtener de la Lista de ciudades
  • idvalorminimo* Number 1 | 2 ¿El agente liquidará con valores de manejo mínimos? 1 = si, 2 = no
  • email1* String Correo para novedades, tickets y operacion
  • email2* String Correo Comercial
  • email3 String Correo opcional 3
  • email4 String Correo opcional 4
  • nombreContacto String Nombre de contacto del remitente
  • comentarios String Observaciones adicionales
  • verRecaudos* Number 0 | 1 ¿Sus agentes pueden ver recaudos? 0 = si, 1 = no
  • rutaimgalterna String Ruta completa donde esta el logo o imagen del agente
  • agentePrincipal Number 1 | 2 ¿El agente es el principal? 1 = si, 2 = no

Ejemplo​

{
  "tipo": "crearAgente",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoxMTgyNDcsImV4cCI6MTYyNTc3MTg4MCwiYXByb2JhZG9zIjpbNjA3N119.sDXnTT3f-L-lgifv00lgG8lhJldOq7W2TmPEXkqxr3w",
  "nombre": "Alan Garcia",
  "idnit": "36878747",
  "identificacion": 6077,
  "telefono": "3134564545",
  "direccion": "calle 54 B sur 23",
  "nombreContacto": "Alan Garcia",
  "correo": "alan@aveonline.co",
  "idvalorminimo": 2,
  "ciudad": "MEDELLIN(ANTIOQUIA)",
  "comentarios": "",
  "email1": "alangarcia@aveonline.co",
  "email2": "alangarcia@aveonline.co",
  "email3": "alangarcia@aveonline.co",
  "email4": "alangarcia@aveonline.co",
  "verRecaudos": 1,
  "rutaimgalterna": "https://www.aveonline.co/principales/img/logo.png",
  "agentePrincipal": 2
}

Response 📄​

Success​

  • status String Estado del resultado
  • message String Mensaje de respuesta

Ejemplo​

{
  "status": "ok",
  "message": "Insertado correctamente",
  "id": "0000",
  "nombre" : "Nombre Registro",
}

Error​

Credenciales incorrectas o token expirado​

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

Campos obligatorios​

{
  "status": "error",
  "message": "Campos obligatorios {campos}"
}

Error en la inserción​

{
  "status": "error",
  "message": "No se pudo realizar la insercion"
}

Validacion de existencia​

{
  "status": "ok",
  "message": "El registro ya existe con el cliente asociado"
}