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. Se debe usar el valor de **tokenBody** devuelto en el login.
• id* Number Identificador de la empresa (**idEnterprise**), se obtiene en la Autenticación
• guia* String Numero identificador de la guía dado en la Generacion de guias
• dsnumfactura String Numero de factura interna asociada a la guía por parte del cliente.
• ordencompra String Numero identificador de orden de compra o pedido interna asociada a la guía por parte del cliente
• referencia String Numero identificador de referencia de tienda ecommerce, erp, etc interna asociada a la guía por parte del cliente

Ejemplo

{
  "tipo": "obtenerEstadoAuth",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoyNTE0MjA5ODYsImV4cdwDDESCBRWAssYwOTcxMiwiYXByb2JhZG9zIjpbMjU1MDVdfQ.n8o9SYPBTNi4n_l7WJ378Ni7ohykP-32ssawDs-iuOw",
  "id": 25505,
  "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 guía
  • destinatario String Nombre del destinatario
  • telefono String Numero telefónico del destinatario
  • direccion String Dirección del destinatario
  • estado String Estado en el cual se encuentra la guía actualmente
  • rutadigitalizada String Ruta del estado de la guía 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 guías relacionadas a una orden de compra
  • idagente Number Agente asociado a la cuenta del usuario
  • idempresa Number Identificador de la empresa 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 valoración de la mercancía
  • contraentrega String Si el cliente asume el costo del envío: 1. Si no: 0
  • dscostorecaudo String Costo por el servicio de recaudo
  • totalflete Number Costo total de la guía
  • 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 Número de pago cuando es recaudo
  • recibo_caja_fecha Date Fecha de pago cuando es recaudo
  • numero_reembolso Number Número de nota crédito a favor del cliente asociado a la guía
  • numero_reembolso_fecha Date Fecha nota crédito a favor del cliente asociado a la guía
  • numero_reembolso_obs String Observación nota crédito a favor del cliente asociado a la guía
  • 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 guía (Crédito / Recaudo / Contraentrega)
  • ruta_rotulo String URL para la impresión del rótulo estándar
  • rotulo String Alias de ruta_rotulo
  • ruta_guia String URL para la impresión de la guía oficial de la transportadora
  • ruta_sticker String URL para la impresión del sticker térmico (110x120)

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.aspx?Consulta=&sinControlLlamada=SI&numGuia=2102474354&CorreoCliente=",
      "origen": "MEDELLIN(ANTIOQUIA)",
      "destino": "MEDELLIN(ANTIOQUIA)",
      "dsreferencia": "",
      "dsordencompra": "",
      "idagente": 260340,
      "idempresa": 25505,
      "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",
      "ruta_rotulo": "https://app.aveonline.co/app/modulos/paqueteo/imprimir.rotulo.beta.php?pkid=1773118&dsconsec=2103453474354&idagente=260340&idexp=25505&codagente=&idcliente=2734958&idremitente=0&imprimir=1&idempresa=25505&idtransportador=33",
      "rotulo": "https://app.aveonline.co/app/modulos/paqueteo/imprimir.rotulo.beta.php?pkid=1773118&dsconsec=2103453474354&idagente=260340&idexp=25505&codagente=&idcliente=2734958&idremitente=0&imprimir=1&idempresa=25505&idtransportador=33",
      "ruta_guia": "https://app.aveonline.co/app/modulos/paqueteo/imprimir.guia.servientrega.php?idtransportadorx=33&guia=2103453474354",
      "ruta_sticker": "https://app.aveonline.co/app/modulos/paqueteo/pdf/guias/imprimir.rotulo.envia_110_120v2.php?guiasx=1&pkidxsel[]=1773118"
    }
  ]
}

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"
}