Create a master guide

Allows creating a master guide that groups multiple child guides under the same MAWB.

POST /mawb v1.0.0

Autenticación: Bearer Token
Ambiente: Development Server (DEV), Test Server, Production Server

Descripción

Allows creating a master guide that groups multiple child guides under the same MAWB.

Rate limiting: 15 master guides per minute per client.

Step 4 of 6 in the nationalization flow:

Authentication
POST /hawb
GET /hawb/{batchId}
POST /mawb ← HERE
POST /mawb/hawb
POST /mawb/nationalization

🔐 Authentication required


Header	`Authorization: Bearer <access_token>`
Token (TEST)	`POST https://api-test.coordinadora.tech/oauth/token`
Token (PROD)	`POST https://api.coordinadora.tech/oauth/token`
Method	Basic Auth — Client ID as username, Client Secret as password
Body	`Content-Type: application/x-www-form-urlencoded` · `grant_type=client_credentials`
Validity	3600 seconds
HTTP 401	Token not sent, invalid or expired

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

Quick Start

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

Ejemplo rápido

Generando ejemplo…

Generando ejemplo…

Generando ejemplo…

Endpoint

POST /mawb

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

[]

Respuesta

201

Master guide created successfully.

{
    "isError": false,
    "data": {
        "ok": "Master guide created successfully",
        "message": "Master guide created successfully",
        "mawb": "MAWB-12345678"
    }
}

Ejemplo de respuesta

201 Master guide created successfully.

{
    "isError": false,
    "data": {
        "ok": "Master guide created successfully",
        "message": "Master guide created successfully",
        "mawb": "MAWB-12345678"
    }
}

Errores

400

Invalid input data. A required field is missing or has an incorrect format.

{
    "isError": true,
    "data": {
        "ok": "Invalid input data",
        "message": "Invalid input data",
        "detail": "Field «mawb» is required"
    }
}

401

Unauthorized. The authentication token is invalid, has expired, or was not provided.

JWT has expired

409

Conflict. The master guide with the provided MAWB already exists.

{
    "isError": true,
    "data": {
        "ok": "Master number already exists",
        "message": "Master number already exists",
        "detail": "Error ID: 092e3a5646e527cb"
    }
}

429

The request limit has been exceeded.

Too many requests, please try again later.

500

Internal server error. An unexpected problem occurred during processing.

{
    "isError": true,
    "data": {
        "ok": "Internal server error",
        "message": "Internal server error",
        "detail": "An error occurred while trying to save the master guide to the database."
    }
}