Enable nationalization for a master guide

Activates the nationalization process for a specific MAWB.

POST /mawb/nationalization v1.0.0
Autenticación
Bearer Token
Ambiente
Development Server (DEV), Test Server, Production Server

Descripción

Activates the nationalization process for a specific MAWB.

⚠️ Irreversible action: Once executed, it is not possible to add more child guides or modify the master guide content. Make sure all required child guides are correctly associated before executing this endpoint.

Rate limiting: 15 enablements per minute per client.

Step 6 of 6 in the nationalization flow (final and irreversible step):

  1. Authentication
  2. POST /hawb
  3. GET /hawb/{batchId} → verify processingGuides = 0
  4. POST /mawb
  5. POST /mawb/hawb → verify all batches are associated
  6. POST /mawb/nationalization ← HERE

✅ Required preconditions:

  • The master guide must exist and have been created correctly
  • At least one child guide batch must be associated to the master
  • All batches must be associated before executing — the operation is irreversible

🔐 Authentication required

HeaderAuthorization: Bearer <access_token>
Token (TEST)POST https://api-test.coordinadora.tech/oauth/token
Token (PROD)POST https://api.coordinadora.tech/oauth/token
MethodBasic Auth — Client ID as username, Client Secret as password
BodyContent-Type: application/x-www-form-urlencoded · grant_type=client_credentials
Validity3600 seconds
HTTP 401Token not sent, invalid or expired

Credentials (Client ID and Client Secret) are provided by Coordinadora's Technology Department.

Quick Start

  1. Obtén tus credenciales de acceso (Bearer Token).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

POST /mawb/nationalization

Base URL https://api-dev.coordinadora.tech/nacionalizacion

Parámetros

Sin parámetros declarados.

Body *

{
    "$ref": "#/components/schemas/EnableNationalizationRequest"
}

Ejemplo de request

[]

Respuesta

200
Nationalization enabled successfully.
{
    "isError": false,
    "data": {
        "mawb": "MAWB-12345678",
        "message": "Nationalization enabled successfully",
        "processingTime": "85ms"
    }
}

Ejemplo de respuesta

200 Nationalization enabled successfully. 
{
    "isError": false,
    "data": {
        "mawb": "MAWB-12345678",
        "message": "Nationalization enabled successfully",
        "processingTime": "85ms"
    }
}

Errores

400
Invalid input data. The MAWB cannot be empty.
{
    "isError": true,
    "data": {
        "ok": "Error enabling nationalization",
        "message": "Invalid input data",
        "detail": "The 'mawb' field cannot be empty."
    }
}
401
Unauthorized. The authentication token is invalid, has expired, or was not provided.
JWT has expired
409
Conflict. The guide cannot be enabled due to a business rule.
{
    "isError": true,
    "data": {
        "ok": "Error enabling nationalization",
        "message": "Master guide 1111 is already enabled for nationalization",
        "detail": "The operation cannot be performed twice."
    }
}
500
Internal server error.
{
    "isError": true,
    "data": {
        "ok": "Error enabling nationalization",
        "message": "Internal error processing MAWB: 1111",
        "detail": "An unexpected server error occurred."
    }
}