Estado de la guía

Se consultan el estado de la guía

Request 🚀

url

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

Method

POST

Header

Content-Type: application/json

Params JSON

• tipo* String Enrutador de la API, "obtenerEstadoAuth"
• token* String Token recibido en la Autenticación con vigencia de una hora
• id* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación
• guia* String Numero identificador de la guia dado en la Generacion de guias
• dsnumfactura String Numero de factura interna asociada a la guia por parte del cliente. Si se activa Debe estar asociada al id Identificador del usuario dentro de AVEONLINE
• ordencompra String Numero identificador de orden de compra o pedido interna asociada a la guia por parte del cliente
• referencia String Numero identificador de referencia de tienda ecommerce, erp, etc interna asociada a la guia por parte del cliente

Ejemplo

{
    "tipo":"obtenerEstadoAuth",
    "token":"eyJ0eXAiOiJKV1QiLCJhbGciOihjgv4brjk35n2o5MzY4MiwiZXhwIjoxNjIzMzU5MTUwLCJhcHJvYmFkb3MiOls2MD3XX0.r9NpCiuYhVU3m1W5KS0fHLtfM3NjLPZbbM2AEFgCNHo",
    "id": 15289,
    "guia":"212342474354",
    "ordencompra" :"",
    "referencia" :""

}

Response 📄

Success

• status String Estado del resultado
• message String Mensaje de respuesta
• guias Array Object -> [{}]
  • pkid Number Identificador interno de registro en base de datos AVE
  • idtransportadora String Identificador de la transportadora
  • dsconsec String Numero identificador de la guia
  • destinatario String Nombre del destinatario
  • telefono String Numero telefonico del destinatario
  • direccion String Direccion del destinatario
  • estado String Estado en el cual se encuentra la guia actualmente
  • rutadigitalizada String Ruta del estado de la guia en la transportadora
  • origen String Ciudad de origen
  • destino String Ciudad de destino
  • dsreferencia String Referencias adicionales
  • dsordencompra String Identificador que agrupa una cantidad determinada de guias relacionadas a una orden de compra
  • idagente Number Agente asociado a la cuenta del usuario
  • idempresa Number Identificador del usuario dentro de AVEONLINE
  • idcliente Number Identificador interno del cliente
  • dsfechaentrega String Fecha en la que se realizó la entrega
  • dsfecha String Fecha de creación de la guía
  • dstipotrayecto String Tipo de trayecto
  • dscomtotal String Comentarios realizados por la transportadora
  • dsflete String Costo del flete
  • manejo String Costo del manejo por valoracion de la mercancía
  • contraentrega String Si el cliente asume el costo del envio: 1. Si no: 0
  • dscostorecaudo String Costo por el servicio de recaudo
  • totalflete Number Costo total de la guia
  • agente String Agente asociado a la cuenta del usuario
  • totalUnidades String Número total de las unidades de la guía
  • totalkilos String Número de Kg de la guía
  • kilosvol String Kilogramos por volumen
  • nombreRemitente String Nombre del remitente
  • direccionRemitente String Dirección del remitente
  • diceContener String Contenido del paquete
  • numfacturacliente String Número interno relacionado a la facturación del cliente
  • factura_ave_tn String Factura asociada a la guía
  • factura_ave_tn_fecha String Fecha de facturación
  • factura_ave_rec String Factura recaudo asociada a la guía
  • factura_ave_tn_rec String Fecha de factura recaudo
  • recibo_caja Number Numero de pago cuando es recaudo,
  • recibo_caja_fecha Date Fecha de pago cuando es recaudo,
  • numero_reembolso Number Numero de nota credito a favor del cliente asociado a la guia,
  • numero_reembolso_fecha Date Fecha nota credito a favor del cliente asociado a la guia,
  • numero_reembolso_obs String Observacion nota credito a favor del cliente asociado a la guia,
  • historicos Array Object -> [{}]
    • estado String Estado anterior de la guía
    • fechamostrar String Fecha del estado
    • descripcion String Descripción del estado
    • aclaracion String Aclaración sobre el estado
    • novedad Number Si el estado es una novedad: 1. Si no: 0
  • rutave String Ruta en AVEONLINE sobre el estado de la guía
  • tipo String Tipo de guia (Credito / Recaudo / Contraentrega)

Ejemplo

{
  "status": "ok",
  "message": "registros encontrados",
  "guias": [
    {
      "pkid": 1773118,
      "idtransportadora": "33",
      "dsconsec": "2103453474354",
      "destinatario": "PRUEBA1",
      "telefono": "300000000",
      "direccion": "PRUEBA RECAUDO",
      "estado": "EN NOVEDAD",
      "rutadigitalizada": "http:\/\/sismilenio.servientrega.com\/WebAtencioncliente\/Rastreo\/ImagenGuia.aspx3h8ewdfesConsulta=&sinControlLlamada=SI&numGuia=2102474354&CorreoCliente=",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "MEDELLIN(ANTIOQUIA)",
      "dsreferencia": "",
      "dsordencompra": "",
      "idagente": 260340,
      "idempresa": 603477,
      "idcliente": 2734958,
      "dsfechaentrega": null,
      "dsfecha": "2021\/06\/01",
      "dstipotrayecto": "urbano",
      "dscomtotal": "",
      "dsflete": "10200",
      "manejo": "4212",
      "contraentrega": "0",
      "dscostorecaudo": "0",
      "totalflete": 14412,
      "transportadora": "SERVIENTREGA",
      "agente": "ATTC",
      "totalUnidades": "1",
      "totalkilos": "3",
      "kilosvol": "1",
      "nombreRemitente": "AVE -ATTC",
      "direccionRemitente": "san cristobal",
      "diceContener": "PRUEBA DEMO",
      "numfacturacliente": "",
      "factura_ave_tn": " ",
      "factura_ave_tn_fecha": null,
      "factura_ave_rec": " ",
      "factura_ave_rec_fecha": null,
      "recibo_caja": "",
      "recibo_caja_fecha": null,
      "numero_reembolso": "",
      "numero_reembolso_fecha": "",
      "numero_reembolso_obs": "",
      "historicos": [
        {
          "estado": "EN NOVEDAD",
          "fechamostrar": "05\/14\/2021 00:52:51",
          "descripcion": "SALIDA A BODEGA LOCAL",
          "aclaracion": "",
          "novedad": 1
        }
      ],
      "rutave": "https:\/\/app.aveonline.co\/buscarguia.php?guia=210247423354",
      "tipo": "Recaudo"
    }
  ]
}

Error

No se encuentran datos asociados

{
  "status": "error",
  "message": "error en la preparacion"
}

Número de guía no encontrada

{
  "status": "error",
  "message": "La guia no existe"
}

Credenciales incorrectas o token expirado

{
  "status": "error",
  "message": "autenticacion fallida"
}