API Información Guía (Guide Information)

Orden de llamada

La API de Información Vuelo se debe llamar antes que esta API de Información Guía, ya que esta última depende de la información registrada en la primera para validar el envío y registrar la información correctamente.

Descripción

La API de Información Guía recibe la información de la Guía Madre (MAWB) junto con su documento en PDF (Base64). Posee un método POST en el cuál se enviarán los datos necesarios para actualizar o crear un registro de la Guía y se recibirá como respuesta el estado del procesamiento.

POST

Endpoint

🔐 POST - Ambiente Productivo

🚀 https://apis.andreanigloballpack.com/informacion/guia

🧪 POST - Ambiente de Prueba

🛠️ https://apisqa.andreanigloballpack.com/informacion/guia

El cliente debe ingresar la información de la guía.

• El head debe contener el token de autenticación. Si no se ingresa un token correcto, tendremos un error de autenticación.

Request

{
 "contratoCourier": "400035265",
 "mawbNumber": "000-12345678",
 "ctns": 21,
 "kgs": 848.938,
 "pcs": 25,
 "fecha": "2025-09-07T17:44:46.832Z",
 "mawbDocBase64": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMg..."
}

CAMPO	DESCRIPCIÓN	REQUERIDO
contratoCourier	ContratoCourier que identifica al Cliente AGP	SI
mawbNumber	Número de Manifiesto / Guía Madre	SI
ctns	Cantidad de Pallet	SI
kgs	Peso Total de la Guía	SI
pcs	Cantidad de Envíos	SI
fecha	Fecha de Envío	NO
mawbDocBase64	PDF del Manifiesto	NO

Response

Status 200 (OK)

Ocurre cuando la Guía ya existía y se actualizó correctamente su información. En el campo notification, de haberse cargado el documento PDF, aparecerá su URL.

{
    "status" = "OK",
    "content" = 
    {
        "status" = "OK",
        "mensaje" = "Guía actualizada correctamente",
        "mawbNumber" = "000-12345678",
        "notification" = null
    }
}

Status 200 (OK)

Ocurre cuando la Guía no existía anteriormente y se creó un nuevo registro. En el campo notification, de haberse cargado el documento PDF, aparecerá su URL.

{
    "status" = "OK",
    "content" = 
    {
        "status" = "OK",
        "mensaje" = "Guía recibida correctamente",
        "mawbNumber" = "000-12345678",
        "notification" = null
    }
}

Status 400 (BadRequest)

Ocurre cuando el Contrato Courier no es válido.

{
    "status" = "ERROR",
    "mensaje" = "Contrato no encontrado o inactivo",
    "mawbNumber" = "000-12345678"
}

Status 400 (BadRequest)

Ocurre cuando la Guía Madre ingresada no corresponde al Contrato Courier.

{
    "status" = "ERROR",
    "mensaje" = "Guía no encontrada para ese número de contrato",
    "mawbNumber" = "000-12345678"
}