Habilitar nacionalización de una guía master

Activa el proceso de nacionalización para un MAWB específico.

POST /guias-master/nacionalizacion v1.0.0

Autenticación: Bearer Token
Ambiente: Servidor de Desarrollo (DEV), Servidor de Pruebas, Servidor de Producción

Descripción

Activa el proceso de nacionalización para un MAWB específico.

⚠️ Acción irreversible: Una vez ejecutada, no es posible asociar más guías hijas ni modificar el contenido de la guía master. Asegúrese de que todas las guías hijas necesarias estén correctamente asociadas antes de ejecutar este endpoint.

Rate limiting: 15 habilitaciones por minuto por cliente.

Paso 6 de 6 en el flujo de nacionalización (paso final e irreversible):

Autenticación
POST /guias-hijas
GET /guias-hijas/{idLote} → verificar guiasProceso = 0
POST /guias-master
POST /guias-master/hijas → verificar que todos los lotes estén asociados
POST /guias-master/nacionalizacion ← AQUÍ

✅ Precondiciones requeridas:

La guía master debe existir y haber sido creada correctamente
Al menos un lote de guías hijas debe estar asociado a la master
Todos los lotes deben estar asociados antes de ejecutar — la operación es irreversible

🔐 Autenticación requerida


Header	`Authorization: Bearer <access_token>`
Token (TEST)	`POST https://api-test.coordinadora.tech/oauth/token`
Token (PROD)	`POST https://api.coordinadora.tech/oauth/token`
Método	Basic Auth — Client ID como usuario, Client Secret como contraseña
Body	`Content-Type: application/x-www-form-urlencoded` · `grant_type=client_credentials`
Vigencia	3600 segundos
HTTP 401	Token no enviado, inválido o expirado

Las credenciales (Client ID y Client Secret) son entregadas por el Departamento de Tecnología de Coordinadora.

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 /guias-master/nacionalizacion

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

[]

Respuesta

200

Nacionalización habilitada exitosamente.

{
    "isError": false,
    "data": {
        "mawb": "MAWB-12345678",
        "mensaje": "Nacionalización habilitada exitosamente",
        "tiempoProcesamiento": "85ms"
    }
}

Ejemplo de respuesta

200 Nacionalización habilitada exitosamente.

{
    "isError": false,
    "data": {
        "mawb": "MAWB-12345678",
        "mensaje": "Nacionalización habilitada exitosamente",
        "tiempoProcesamiento": "85ms"
    }
}

Errores

400

Error en los datos de entrada. El MAWB no puede estar vacío.

{
    "isError": true,
    "data": {
        "ok": "Error al habilitar nacionalización",
        "mensaje": "Datos de entrada inválidos",
        "detalle": "El campo 'mawb' no puede estar vacío."
    }
}

401

No autorizado. El token de autenticación es inválido, ha expirado o no fue provisto.

Jwt is expired

409

Conflicto. La guía no puede ser habilitada por una regla de negocio.

{
    "isError": true,
    "data": {
        "ok": "Error al habilitar nacionalización",
        "mensaje": "La guía master 1111 ya está habilitada para nacionalización",
        "detalle": "La operación no se puede realizar dos veces."
    }
}

500

Error interno del servidor.

{
    "isError": true,
    "data": {
        "ok": "Error al habilitar nacionalización",
        "mensaje": "Error interno al procesar MAWB: 1111",
        "detalle": "Ocurrió un error inesperado en el servidor."
    }
}