API Información Guía (Guide Information)
Call order
The "Información Vuelo" API must be called before this "Información Guía" API, as the latter depends on the information registered in the former to validate the shipment and correctly register the information.
Description¶
The "Información Guía" API receives the Guía Madre (MAWB)'s information along with its PDF document (Base64). It has a POST method where the necessary data is sent to update or create a Guía record, and in response, the processing status is provided.
POST¶
Endpoint¶
🔐 POST - Production Environment
🧪 POST - Testing Environment
The client must enter the Guía's information.
- The head must include the authentication token. If a correct token is not entered, we will have an authentication error.
Request¶
{
"contratoCourier": "400035265",
"mawbNumber": "000-12345678",
"ctns": 21,
"kgs": 848.938,
"pcs": 25,
"fecha": "2025-09-07T17:44:46.832Z",
"mawbDocBase64": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMg..."
}
| FIELD | DESCRIPTION | REQUIRED |
|---|---|---|
| contratoCourier | ContratoCourier which identifies the AGP Client | YES |
| mawbNumber | Manifest Number / Guía Madre | YES |
| ctns | Pallet Quantity | YES |
| kgs | Total Weight of the Guía | YES |
| pcs | Number of Shipments | YES |
| fecha | Shipping Date | NO |
| mawbDocBase64 | PDF of the Manifest | NO |
Response¶
Status 200 (OK)
Occurs when the Guía already existed and its information was updated successfully. In the notification field, if the PDF document have been uploaded, its URL will appear.
{
"status" = "OK",
"content" =
{
"status" = "OK",
"mensaje" = "Guía actualizada correctamente",
"mawbNumber" = "000-12345678",
"notification" = null
}
}
Status 200 (OK)
Occurs when the Guía did not exist previously and a new record was created. In the notification field, if the PDF document have been uploaded, its URL will appear.
{
"status" = "OK",
"content" =
{
"status" = "OK",
"mensaje" = "Guía recibida correctamente",
"mawbNumber" = "000-12345678",
"notification" = null
}
}
Status 400 (BadRequest)
Occurs when the Contrato Courier is not valid.
{
"status" = "ERROR",
"mensaje" = "Contrato no encontrado o inactivo",
"mawbNumber" = "000-12345678"
}
Status 400 (BadRequest)
Occurs when the Guía Madre entered was not found for that Contrato Courier.
{
"status" = "ERROR",
"mensaje" = "Guía no encontrada para ese número de contrato",
"mawbNumber" = "000-12345678"
}