Consultar guías master por cliente y fechas

Descripción

Retorna la lista paginada de guías master asociadas a un cliente, filtradas por rango de fechas.

El rango máximo entre fecha_inicio y fecha_fin es de 6 meses.

Rate limiting: 10 solicitudes por minuto por cliente.

Puede consultarse en cualquier momento después de crear guías master con POST /guias-master.

🔐 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

GET /guias-master/clientes/{identificacion}/guias

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

Parámetros

Nombre	Tipo	Requerido	Descripción
`identificacion` path	string	Sí	NIT del cliente titular de la cuenta en Coordinadora. Se usa para filtrar las guías master asociadas a ese cliente.
`fecha_inicio` query	string	Sí	Fecha de inicio del rango de consulta en formato ISO (YYYY-MM-DD). Requerida.
`fecha_fin` query	string	Sí	Fecha de fin del rango de consulta en formato ISO (YYYY-MM-DD). Debe ser mayor o igual a fecha_inicio. Rango máximo: 6 meses. Requerida.
`pagina` query	integer	No	Número de página a consultar. Mínimo: 1. Por defecto: 1.
`limite` query	integer	No	Número de registros por página. Mínimo: 1, Máximo: 100. Por defecto: 10.

Respuesta

200

Lista paginada de guías master obtenida exitosamente.

{
    "isError": false,
    "data": {
        "datos": [
            {
                "mawb": "406024230831",
                "fecha_creacion": "2026-03-12T10:00:00.000Z",
                "nombre_estado": "En tránsito",
                "aeropuerto_llegada": "BOG",
                "aeropuerto_salida": "PEK",
                "ciudad_destino": "BOGOTA",
                "ciudad_embarque": "PEKIN",
                "ciudad_remitente": "PEKIN",
                "departamento_consignatario": "CUNDINAMARCA",
                "departamento_destino": "CUNDINAMARCA",
                "direccion_consignatario": "Carrera 7 # 32-16",
                "direccion_remitente": "Calle Comercio 45",
                "dv_aerolinea": "6",
                "dv_consignatario": "1",
                "fecha_estado": "2026-03-14T08:30:00.000Z",
                "eta": "2026-03-14T16:30:00.000Z",
                "etd": "2026-03-12T10:15:00.000Z",
                "fecha_en_destino": "2026-03-15T08:00:00.000Z",
                "fecha_llegada": "2026-03-14T17:00:00.000Z",
                "guias_asociadas": 23,
                "habilitar_nacionalizacion": true,
                "nit_aerolinea": "800249687",
                "nit_consignatario": "900123456",
                "nit_remitente": "987654321",
                "nombre_aerolinea": "LATAM AIRLINES COLOMBIA",
                "nombre_consignatario": "Comercio Internacional SAS",
                "nombre_remitente": "Proveedor Internacional S.A.",
                "numero_vuelo": "LA9999",
                "pais_destino": "Colombia",
                "pais_embarque": "China",
                "peso_guias_asociadas": 98.5,
                "peso_kg": 112,
                "telefono_remitente": "861012345678",
                "tipo_carga": "1",
                "val_declarado_usd": 5000,
                "val_trm": 4200
            }
        ],
        "total_registros": 1,
        "total_paginas": 1,
        "pagina_actual": 1
    }
}

Ejemplo de respuesta

200 Lista paginada de guías master obtenida exitosamente.

{
    "isError": false,
    "data": {
        "datos": [
            {
                "mawb": "406024230831",
                "fecha_creacion": "2026-03-12T10:00:00.000Z",
                "nombre_estado": "En tránsito",
                "aeropuerto_llegada": "BOG",
                "aeropuerto_salida": "PEK",
                "ciudad_destino": "BOGOTA",
                "ciudad_embarque": "PEKIN",
                "ciudad_remitente": "PEKIN",
                "departamento_consignatario": "CUNDINAMARCA",
                "departamento_destino": "CUNDINAMARCA",
                "direccion_consignatario": "Carrera 7 # 32-16",
                "direccion_remitente": "Calle Comercio 45",
                "dv_aerolinea": "6",
                "dv_consignatario": "1",
                "fecha_estado": "2026-03-14T08:30:00.000Z",
                "eta": "2026-03-14T16:30:00.000Z",
                "etd": "2026-03-12T10:15:00.000Z",
                "fecha_en_destino": "2026-03-15T08:00:00.000Z",
                "fecha_llegada": "2026-03-14T17:00:00.000Z",
                "guias_asociadas": 23,
                "habilitar_nacionalizacion": true,
                "nit_aerolinea": "800249687",
                "nit_consignatario": "900123456",
                "nit_remitente": "987654321",
                "nombre_aerolinea": "LATAM AIRLINES COLOMBIA",
                "nombre_consignatario": "Comercio Internacional SAS",
                "nombre_remitente": "Proveedor Internacional S.A.",
                "numero_vuelo": "LA9999",
                "pais_destino": "Colombia",
                "pais_embarque": "China",
                "peso_guias_asociadas": 98.5,
                "peso_kg": 112,
                "telefono_remitente": "861012345678",
                "tipo_carga": "1",
                "val_declarado_usd": 5000,
                "val_trm": 4200
            }
        ],
        "total_registros": 1,
        "total_paginas": 1,
        "pagina_actual": 1
    }
}

Errores

400

Error de validación en los parámetros de entrada.

{
    "isError": true,
    "data": {
        "ok": "Error en la solicitud",
        "mensaje": "La fecha inicial debe ser en formato ISO (YYYY-MM-DD)"
    }
}

401

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

Jwt is expired

404

No se encontraron guías master para el cliente en el rango de fechas indicado.

{
    "isError": true,
    "data": {
        "ok": "Guías Master no encontradas",
        "mensaje": "No se encontraron guías master para el cliente especificado en el rango de fechas indicado."
    }
}

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",
        "mensaje": "Ocurrió un error interno al procesar su solicitud."
    }
}