Cotización

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

Request 🚀

url

https://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 ($1.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

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
}

Response 📄

Success

• status String Estado del resultado
• message String Mensaje de respuesta
• cotizaciones Array Object -> [{}]
  • codTransportadora String Identificador de la transportadora
  • nombreTransportadora String Nombre de la transportadora
  • logoTransportadora String Imagen con el logo de la transportadora
  • origen String Ciudad de origen
  • destino String Ciudad de destino
  • unidades Number Unidades de empaque
  • kilos Number Peso total de los productos
  • 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
  • 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",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "CUCUTA(NORTE DE SANTANDER)",
      "unidades": 1,
      "kilos": 3,
      "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",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "CUCUTA(NORTE DE SANTANDER)",
      "unidades": 1,
      "kilos": 3,
      "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",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "CUCUTA(NORTE DE SANTANDER)",
      "unidades": 1,
      "kilos": 3,
      "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

No se encuentran datos asociados

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

Credenciales incorrectas o token expirado

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