Skip to main content
Version: Latest

Calcular un envio

Permite cotizar el envio antes de generar un pedido.

Request 🚀​

url​

https://app.aveonline.co/avestock/api/calcularenvio.php

Method​

POST

Content-Type: application/json
Authorization: {data.token}

Params JSON​

  • tipo* String Enrutador de la API, "authave"
  • empresa* Number Identificador de la empresa dentro de AVEONLINE, se obtiene en la Autenticación
  • bodegaOrigen* String Ciudad de origen correspondiente, se obtiene del Listado de ciudades
  • clientDestino* String Ciudad de destino correspondiente, se obtiene del Listado de ciudades
  • paymentCliente* Number Activar si el cliente del pedido pagará el pedido (1=SI,2=NO)
  • grandTotalPeso* Number Total peso (Kg)
  • campo* Number Identificador del operador logistico que desee cotizar. Si lo pasa vacio, se calcula con todos los operadores asociados a la cuenta AVEONLINE de Listado de operadores logísticos
  • recaudo* Number Valor a recaudar del pedido
  • grandTotalDeclarado* Number Valor total declarado del pedido
  • paymentAsumecosto* Number Activar si el cliente del pedido asumirá el costo del recaudo (1=SI,2=NO)
  • origenpedidos* Number Identificador interno de AveCRM. Por defecto es 1
  • grandTotalUnit* Number Cantidad total de unidades del pedido
  • products* Array Object -> [{}] Detalle de los productos del pedido. Es la unica fuente de las medidas reales del paquete: si no se envia, el cotizador aproxima una caja y el valor cotizado puede no corresponder al envio.
    • largo* Number Largo del producto en cms. Tambien se acepta el nombre length
    • ancho* Number Ancho del producto en cms. Tambien se acepta el nombre width
    • alto* Number Alto del producto en cms. Tambien se acepta el nombre height
    • unidades Number Cantidad de productos con estas mismas medidas. Tambien se acepta quantity o units. Por defecto 1
  • grandTotalVol Number Volumen total del pedido en cm3. Solo se usa como respaldo cuando no se envia products
  • idalto Number NO se tiene en cuenta en el calculo. Las medidas se toman de products
  • idancho Number NO se tiene en cuenta en el calculo. Las medidas se toman de products
  • idlargo Number NO se tiene en cuenta en el calculo. Las medidas se toman de products
  • idagente String Agente asociado a la cuenta del usuario. Se usa para validar si tiene código de Interrapidísimo; si no se pasa, se calcula el agente asociado a la ciudad de origen que tenga código de Interrapidísimo. Se obtiene del Listado de agentes
  • plugin* String Identificador del metodo de acceso.Por defecto es aveonline

Ejemplo​

{
  "tipo": "authave",
  "empresa": 6077,
  "bodegaOrigen": "BARRANQUILLA(ATLANTICO)",
  "clientDestino": "BOGOTA(CUNDINAMARCA)",
  "paymentCliente": 0,
  "grandTotalPeso": "6.00",
  "campo": "",
  "recaudo": 0,
  "grandTotalDeclarado": "10000.00",
  "paymentAsumecosto": 0,
  "origenpedidos": 1,
  "grandTotalUnit": 1,
  "grandTotalVol": "24000.00",
  "idagente": 0,
  "plugin": "aveonline",
  "products": [
    {
      "largo": 40,
      "ancho": 30,
      "alto": 20,
      "unidades": 1
    }
  ]
}

Response 📄​

Success​

  • items Array Object -> [{}]
    • status Number Respuesta del servidor numérica
    • message String Respuesta del servidor en modo texto
    • flete Number Valor del flete de transporte
    • variable Number Valor del flete variable o costo del valor declarado
    • comision Number Valor del costo del recaudo
    • total Number Valor total del envío
    • campo Number Codigo numerico del operador logístico
    • transportadora String Nombre del operador logistico
    • stringdata Array Object -> [{}] en caso que se tenga algunas consideraciones adicionales en los resultados

Ejemplo​

{
  "status": "ok",
  "mensaje": "registros encontrados",
  "items": [
    {
      "status": 1,
      "message": "Datos recibidos",
      "flete": 44400,
      "variable": 7920,
      "comision": 0,
      "total": 52320,
      "campo": 1009,
      "transportadora": "COORDINADORA MERCANTIL",
      "stringdata": []
    },
    {
      "status": 1,
      "message": "Datos recibidos",
      "flete": 0,
      "variable": 0,
      "comision": 0,
      "total": 0,
      "campo": 1026,
      "transportadora": "DOMINA",
      "stringdata": []
    }
  ]
}

No se encuentran datos asociados o credenciales inválidas​

{
  "items": [
    "status": 1,
    "message": "Datos recibidos",
    "flete": 0,
    "variable": 0,
    "comision": 0,
    "total": 0,
    "campo": 0000,
    "transportadora": "OPERADOR",
    "stringdata": []
  ]
}