Create a batch of nationalization guides

Descripción

Allows clients to submit a batch of guides to start their nationalization process. The system processes the information for each guide, validates the data, and returns a tracking identifier for the batch.

Rate limiting: 20,000 guides per minute per client. If exceeded: HTTP 429.

Step 2 of 6 in the nationalization flow:

Authentication
POST /hawb ← HERE
GET /hawb/{batchId}
POST /mawb
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 /hawb

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

[]

Respuesta

200

Batch of guides received and processed successfully.

{
    "isError": false,
    "data": {
        "ok": "Batch managed successfully",
        "batchId": "b7e6a3c6-3392-4d23-8f0a-1725841e7e4e",
        "subBatchCount": 1
    }
}

Ejemplo de respuesta

200 Batch of guides received and processed successfully.

{
    "isError": false,
    "data": {
        "ok": "Batch managed successfully",
        "batchId": "b7e6a3c6-3392-4d23-8f0a-1725841e7e4e",
        "subBatchCount": 1
    }
}

Errores

400

Bad Request. The submitted data does not comply with the required format or validations.

{
    "isError": true,
    "data": {
        "ok": "Invalid input data",
        "message": "The request contains invalid or incorrectly formatted data.",
        "detail": "Please review the request fields and try again."
    }
}

401

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

JWT has expired

429

The request limit has been exceeded.

Too many requests, please try again later.

500

Internal Server Error.

{
    "isError": true,
    "data": {
        "ok": "Internal server error",
        "message": "Internal server error",
        "detail": "An unexpected error occurred while processing the request."
    }
}