Cotización

Se calcula el valor del envío dependiendo de las transportadoras que tienes habilitadas

Request 🚀

url

https://app.aveonline.co/api/nal/v1.0/generarGuiaTransporteNacional.php

Method

POST

Header

Content-Type: application/json

Params JSON

• tipo* String Enrutador de la API, "cotizar2"
• token* String Token recibido en la Autenticación con vigencia de una hora
• idempresa* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación
• origen* String Ciudad de origen o codigo DANE correspondiente, se obtiene del Listado de ciudades
• destino* String Ciudad de destino o codigo DANE correspondiente, se obtiene del Listado de ciudades
• valorrecaudo Number Valor que se requiere recaudar
• unidades Number Unidades de empaque que se van a enviar, valor por defecto-> 1
• productos* Array Object -> [{}]
  • alto String Dimensión de alto del producto
  • largo String Dimensión de largo del producto
  • ancho String Dimensión de ancho del producto
  • peso* String Peso del producto
  • unidades* Number Cantidad de productos con estas mismas características
  • nombre* String Descripción del producto
  • valorDeclarado* String Costo de la mercancia, de cada producto
• valorMinimo Number Para asignar la valoracion minima ($10.000) a la unidad de empaque: 1. Para asignar la suma de valores declarados de cada producto: 0
• idasumecosto* Number Si el cliente asume el costo del servicio de recaudo: 1. Si no: 0
• contraentrega* Number Si el cliente asume el costo del envio: 1. Si no: 0
• idtransportador* String Identificador de la transportadora procedente del Listado de operadores logísticos`
• plugin* String Identificador del metodo de acceso. Colocar apiave
• idagente* String Agente asociado a la cuenta del usuario. El agente se usa para validar si código de interrapisidimo. Si no se pasa, se calcula el agente asociado a la ciudad origen y que tenga codigo de interrapisidimo. Se obtiene del Listado de agentes.

Formas de pago de la guía

1. Si usted va a generar una guía a crédito sin recaudo.

Usted asume: Costo del transporte
Destinatario asume: Ningún costo

Campo	Valor
valorrecaudo	0
contraentrega	0
idasumecosto	0

2. Si usted desea recaudar.

Usted asume: Ningún costo
Destinatario asume: Dinero a recaudar + Costo del transporte + Costo del recaudo

Campo	Valor
valorrecaudo	Ej: 50000 (Dinero a recaudar)
contraentrega	1
idasumecosto	1

3. Si usted desea recaudar.

Usted asume: Costo del recaudo
Destinatario asume: Costo de transporte + Dinero a recaudar

Campo	Valor
valorrecaudo	Ej: 50000 (Dinero a recaudar)
contraentrega	1
idasumecosto	0

4. Si usted desea recaudar.

Usted asume: Costo del transporte
Destinatario asume: Dinero a recaudar + Costo del recaudo

Campo	Valor
valorrecaudo	Ej: 50000 (Dinero a recaudar)
contraentrega	0
idasumecosto	1

5. Si usted desea recaudar.

Usted asume: Costo de transporte + Costo del recaudo
Destinatario asume: Dinero a recaudar

Campo	Valor
valorrecaudo	Ej: 50000 (Dinero a recaudar)
contraentrega	0
idasumecosto	0

Ejemplo

{
  "tipo": "cotizar2",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoxMTY5MDYsImV4cCI6MTYyNTYwMzA2MCwiYXByb2JhZG9zIjpbMTUyODldfQ.QjLQUri4XrArwIDFL1dTr2aQdKv6WgKiTBj25qJkaLM",
  "idempresa": 15289,
  "origen": "MEDELLIN(ANTIOQUIA)",
  "destino": "CUCUTA(NORTE DE SANTANDER)",
  "valorrecaudo": 92000,
  "productos": [
    {
      "alto": "10",
      "largo": "10",
      "ancho": "10",
      "peso": "1",
      "unidades": 2,
      "nombre": "Nombre producto",
      "valorDeclarado": "46000"
    },
    {
      "alto": "10",
      "largo": "10",
      "ancho": "10",
      "peso": "1",
      "unidades": 1,
      "nombre": "Nombre producto",
      "valorDeclarado": "46000"
    }
  ],
  "valorMinimo": 0,
  "idasumecosto": 1,
  "contraentrega": 1,
  "plugin": "apiave"
}

Response 📄

Success

• status String Estado del resultado
• message String Mensaje de respuesta
• cotizaciones Array Object -> [{}]
  • numbererror String Tipo de error encontrado
  • dataerror String Descripción del error encontrado
  • codTransportadora String Identificador de la transportadora
  • nombreTransportadora String Nombre de la transportadora
  • logoTransportadora String Imagen con el logo de la transportadora
  • logoTransportadora2 String Imagen con el logo de la transportadora 2
  • origen String Ciudad de origen
  • destino String Ciudad de destino
  • unidades Number Unidades de empaque
  • kilos Number Peso total de los productos
  • pesovolumen Number Peso volumen calculado en caso que exista por operador
  • valoracion String Valoracion total de los productos
  • porcentajeValoracion Number El porcentaje que la tranportadora determina para la cotizacion
  • codigoTrayecto String Identificador del trayecto para la transportadora
  • trayecto String Tipo de trayecto
  • tipoEnvio String Tipo de envio
  • fletexkilo String Costo del flete por cada Kg
  • fletexunidad String Costo del flete por unidad de empaque
  • fletetotal String Costo del flete total
  • diasentrega Number Dias para la entrega
  • costoManejo Number Costo del manejo por valoracion de la mercancia
  • valorTotal Number Costo total de transporte
  • valorOtrosRecaudos Number Costo por el servicio de recaudo
  • total Number Costo total de la guia

Ejemplo

{
  "status": "ok",
  "message": "cotizaciones encontradas",
  "cotizaciones": [
    {
      "codTransportadora": "29",
      "nombreTransportadora": "ENVIA - nacional",
      "logoTransportadora": "https://www.aveonline.co/app/temas/imagen_transpo/084935-1-envia-094632-1-ENVIA.jpg",
      "logoTransportadora2": "https://www.aveonline.co/app/temas/imagen_transpo/084935-1-envia-094632-1-ENVIA.jpg",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "CUCUTA(NORTE DE SANTANDER)",
      "unidades": 1,
      "kilos": 3,
      "pesovolumen": 2,
      "valoracion": "184000",
      "porcentajeValoracion": "1",
      "codigoTrayecto": "11",
      "trayecto": "nacional",
      "tipoEnvio": "Mensajeria",
      "fletexkilo": 15200,
      "fletexunidad": 15200,
      "fletetotal": 15200,
      "diasentrega": "2",
      "costoManejo": 1840,
      "valorTotal": 17040,
      "valorOtrosRecaudos": 4253,
      "total": 21293
    },
    {
      "codTransportadora": "1010",
      "nombreTransportadora": "TCC SA - nacional",
      "logoTransportadora": "https://www.aveonline.co/app/temas/imagen_transpo/104926-1-tcc.jpg",
      "logoTransportadora2": "https://www.aveonline.co/app/temas/imagen_transpo/104926-1-tcc.jpg",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "CUCUTA(NORTE DE SANTANDER)",
      "unidades": 1,
      "kilos": 3,
      "pesovolumen": 1,
      "valoracion": "184000",
      "porcentajeValoracion": "1",
      "codigoTrayecto": "45",
      "trayecto": "nacional",
      "tipoEnvio": "Mensajeria",
      "fletexkilo": 17700,
      "fletexunidad": 17700,
      "fletetotal": 17700,
      "diasentrega": "3",
      "costoManejo": 1840,
      "valorTotal": 19540,
      "valorOtrosRecaudos": 3600,
      "total": 23140
    },
    {
      "codTransportadora": "1022",
      "nombreTransportadora": "SAFERBO - nacional",
      "logoTransportadora": "https://www.aveonline.co/app/temas/imagen_transpo/045506-1-logo saferbo.png",
      "logoTransportadora2": "https://www.aveonline.co/app/temas/imagen_transpo/045506-1-logo saferbo.png",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "CUCUTA(NORTE DE SANTANDER)",
      "unidades": 1,
      "kilos": 3,
      "pesovolumen": 0,
      "valoracion": "184000",
      "porcentajeValoracion": "2",
      "codigoTrayecto": "64",
      "trayecto": "nacional",
      "tipoEnvio": "Mensajeria",
      "fletexkilo": 18853,
      "fletexunidad": 18853,
      "fletetotal": 18853,
      "diasentrega": "3",
      "costoManejo": 3680,
      "valorTotal": 22533,
      "valorOtrosRecaudos": 4467,
      "total": 27000
    }
  ]
}

Error

Tipificación de errores

numberror	dataerror	codTransportadora
-0-	No hay errores	Codigo del operador
-1	El origen no existe
-2	El destino no existe
-3	El peso no puede ser negativo o menor a cero
-4	Las unidades no puede ser negativas o menor a cero
-5	El valor declarado no puede ser negativo o menor a 10.000 pesos
-6	El numero de unidades no puede ser mayor a [unidadesMaximas]
-7	El numero de kilos no puede ser mayor a [kilosMaximos]
-1000	Se ha presentado un problema con el calculo. Intente de nuevo o el servicio no esta configurado o el trayecto que intenta ingresar no es valido. Validar que los kilos o unidades sean las autorizadas para el servicio. Kilos Autorizados: [kilosMaximos], Unidades autorizadas: [unidadesMaximas]
-999	Se ha presentado un problema con el calculo. Intente de nuevo o el servicio no esta configurado o el trayecto que intenta ingresar no es valido

Error desconocido

{
  "status": "error",
  "message": "error desconocido"
}

No se encuentran datos asociados

{
  "status": "error",
  "message": "cotizaciones no encontradas",
  "cotizaciones": []
}

Credenciales incorrectas o token expirado

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