Crear un lote de guías de nacionalización

Descripción

Permite a los clientes enviar un lote de guías para iniciar su proceso de nacionalización. El sistema procesa la información de cada guía, valida los datos y retorna un identificador para el seguimiento del lote.

Rate limiting: 20.000 guías por minuto por cliente. Al exceder: HTTP 429.

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

Autenticación
POST /guias-hijas ← AQUÍ
GET /guias-hijas/{idLote}
POST /guias-master
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-hijas

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

[]

Respuesta

200

Lote de guías recibido y gestionado correctamente.

{
    "isError": false,
    "data": {
        "ok": "Lote gestionado correctamente",
        "id_lote": "b7e6a3c6-3392-4d23-8f0a-1725841e7e4e",
        "numero_sublotes": 1
    }
}

Ejemplo de respuesta

200 Lote de guías recibido y gestionado correctamente.

{
    "isError": false,
    "data": {
        "ok": "Lote gestionado correctamente",
        "id_lote": "b7e6a3c6-3392-4d23-8f0a-1725841e7e4e",
        "numero_sublotes": 1
    }
}

Errores

400

Error en la solicitud. Los datos enviados no cumplen con el formato o las validaciones requeridas.

{
    "isError": true,
    "data": {
        "ok": "Datos de entrada inválidos",
        "mensaje": "La solicitud contiene datos inválidos o con formato incorrecto.",
        "detalle": "Revise los campos de la solicitud y vuelva a intentarlo."
    }
}

401

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

Jwt is expired

429

Se ha excedido el límite de solicitudes permitidas.

Too many requests, please try again later.

500

Error interno del servidor.

{
    "isError": true,
    "data": {
        "ok": "Error interno del servidor",
        "mensaje": "Error interno del servidor",
        "detalle": "Ocurrió un error inesperado al procesar la solicitud."
    }
}