Reimpresión de Guías

Esta API permite obtener las URLs de impresión de guías, rótulos y stickers térmicos generados previamente. Está diseñada para facilitar la recuperación masiva de documentos logísticos para una transportadora y cliente específicos.

---

Autenticación

El acceso requiere un JWT (JSON Web Token) válido firmado por Aveonline en las cabeceras:

• Authorization: data.token (Envía directamente el string del token)

🔑 Autenticación V3

El token se obtiene por medio de la autenticación V3.

---

Endpoint de Consulta

Método: POST
URL: https://api.aveonline.co/api-logistics/public/api/guides/reprint/v1/reprint

Parámetros del Cuerpo (JSON Body)

Parámetro	Requerido	Tipo	Descripción
idoperador	SÍ	int	ID numérico de la transportadora (ej. 29 para Envía, 1010 para TCC).
idcliente	SÍ	int	ID del cliente al que pertenecen las guías.
guias	SÍ	array	Arreglo de strings con los números de guía a consultar.

---

Ejemplo de Consulta

{
  "idoperador": 1010,
  "idcliente": 39841,
  "guias": ["7654321098", "1234567890"]
}

Los datos deben enviarse obligatoriamente en formato JSON a través del cuerpo de la petición.

---

Respuesta Exitosa (200 OK)

La API retorna un campo resultado (un arreglo) con el detalle individual de cada guía procesada.

{
  "status": "ok",
  "message": "proceso correcto",
  "resultado": [
    {
      "codigo": "0",
      "mensaje": "Guia encontrada",
      "numguia": "7654321098",
      "rutaguia": "https://app.aveonline.co/assets/data/envia/guias/guias-7654321098.pdf",
      "archivoguia": "000",
      "rotulo": "https://app.aveonline.co/app/modulos/paqueteo/imprimir.rotulo.beta.php?...",
      "transportadora": "ENVIA",
      "rutasticker": "https://app.aveonline.co/app/modulos/paqueteo/pdf/guias/imprimir.rotulo.envia_110_120v2.php?...",
      "archivosticker": "JVBERi0xLjQKJ..."
    }
  ]
}

Descripción de campos de Respuesta

Objeto Principal

• status: (string) Estado de la petición (ok o error).
• message: (string) Descripción general del proceso.
• resultado: (array) Lista de guías consultadas con sus respectivos documentos.

Detalle de Guías (resultado)

• codigo: (string) 0 para éxito, -1 para error de validación o no encontrada.
• mensaje: (string) Detalle del resultado por guía (ej. "Guia no corresponde al operador").
• numguia: (string) Número de guía consultado.
• rutaguia: (string) URL directa al PDF de la guía oficial.
• rotulo: (string) URL para visualizar el rótulo de Aveonline.
• rutasticker: (string) URL para el sticker térmico (110x120).
• archivosticker: (string) Contenido en Base64 del sticker para impresión directa.
• transportadora: (string) Nombre del operador logístico asociado.

---

Respuestas de Error

Código	Mensaje	Razón
401	Signature verification failed	El token JWT es inválido, expiró o no se envió.
422	The guias field is required	Faltan campos obligatorios en el JSON enviado.
200/404	No encontraron registros	Ninguna de las guías coincide con el operador o cliente proporcionado.

Ejemplos de Error en el Body

Error por parámetros faltantes:

{
  "status": "error",
  "message": "El campo 'idtransportador' es requerido",
  "resultado": []
}

Error de integridad (Guía de otro operador o cliente):

{
  "status": "error",
  "message": "No encontraron registros",
  "resultado": [
    {
      "codigo": "-1",
      "mensaje": "La guia no corresponde al operador",
      "numguia": "7654321098"
    }
  ]
}

Nota: Si el campo codigo dentro del arreglo es -1, la guía específica no pudo ser recuperada por falta de coincidencia de seguridad (Operador/Cliente).