Crear una guía master

Permite crear una guía master que agrupa múltiples guías bajo un mismo MAWB.

POST /guias-master v1.0.0

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

Descripción

Permite crear una guía master que agrupa múltiples guías bajo un mismo MAWB.

Rate limiting: 15 guías master por minuto por cliente.

Paso 4 de 6 en el flujo de nacionalización:

Autenticación
POST /guias-hijas
GET /guias-hijas/{idLote}
POST /guias-master ← AQUÍ
POST /guias-master/hijas
POST /guias-master/nacionalizacion

🔐 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

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

[]

Respuesta

201

Guía master creada exitosamente.

{
    "isError": false,
    "data": {
        "ok": "Guía Master creada exitosamente",
        "mensaje": "Guía Master creada exitosamente",
        "mawb": "MAWB-12345678"
    }
}

Ejemplo de respuesta

201 Guía master creada exitosamente.

{
    "isError": false,
    "data": {
        "ok": "Guía Master creada exitosamente",
        "mensaje": "Guía Master creada exitosamente",
        "mawb": "MAWB-12345678"
    }
}

Errores

400

Error en los datos de entrada. Algún campo requerido falta o tiene un formato incorrecto.

{
    "isError": true,
    "data": {
        "ok": "Datos de entrada inválidos",
        "mensaje": "Datos de entrada inválidos",
        "detalle": "El campo «mawb» es obligatorio"
    }
}

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 master con el MAWB proporcionado ya existe.

{
    "isError": true,
    "data": {
        "ok": "El número de master ya existe",
        "mensaje": "El número de master ya existe",
        "detalle": "Error ID: 092e3a5646e527cb"
    }
}

429

Se ha excedido el límite de solicitudes permitidas.

Too many requests, please try again later.

500

Error interno del servidor. Ocurrió un problema inesperado durante el procesamiento.

{
    "isError": true,
    "data": {
        "ok": "Error interno del servidor",
        "mensaje": "Error interno del servidor",
        "detalle": "Ocurrió un error al intentar guardar la guía master en la base de datos."
    }
}