Consultar estado de un lote de guías

Permite consultar el estado actual de un lote de guías previamente creado.

GET /guias-hijas/{idLote} v1.0.0
Autenticación
Bearer Token
Ambiente
Servidor de Desarrollo (DEV), Servidor de Pruebas, Servidor de Producción

Descripción

Permite consultar el estado actual de un lote de guías previamente creado.

El lote se considera completamente procesado cuando guiasProceso es igual a 0. En ese punto, guiasGeneradas + guiasFallidas debe ser igual a totalGuias.

Rate limiting: 50 solicitudes por minuto por cliente. Buena práctica: implementar intervalo mínimo de 2 segundos entre consultas.

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

  1. Autenticación
  2. POST /guias-hijas → se obtiene el id_lote
  3. GET /guias-hijas/{idLote} ← AQUÍ — consultar estado del lote creado
  4. POST /guias-master
  5. POST /guias-master/hijas
  6. POST /guias-master/nacionalizacion

🔐 Autenticación requerida

HeaderAuthorization: Bearer <access_token>
Token (TEST)POST https://api-test.coordinadora.tech/oauth/token
Token (PROD)POST https://api.coordinadora.tech/oauth/token
MétodoBasic Auth — Client ID como usuario, Client Secret como contraseña
BodyContent-Type: application/x-www-form-urlencoded · grant_type=client_credentials
Vigencia3600 segundos
HTTP 401Token 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

  1. Obtén tus credenciales de acceso (Bearer Token).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

GET /guias-hijas/{idLote}

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

Parámetros

Nombre Tipo Requerido Descripción
idLote path string Sí Identificador único del lote. Valor retornado en el campo id_lote del response del POST /guias-hijas. Sensible a mayúsculas y caracteres especiales.

Respuesta

200
Información del estado del lote obtenida exitosamente.
{
    "isError": false,
    "data": {
        "idLote": "264081134-1776785291254-9d6c97",
        "totalGuias": 3,
        "guiasGeneradas": 2,
        "guiasFallidas": 1,
        "guiasProceso": 0,
        "emailCliente": "logistica@comerciointl.com",
        "detalleGuiasGeneradas": [
            {
                "idPedidoCliente": "PED-2025-00892",
                "guiaCM": "13220721777"
            }
        ]
    }
}
204
El lote consultado no existe. Ocurre cuando el idLote enviado no corresponde a ningún registro existente. Verificar que el idLote fue copiado correctamente desde el response del POST /guias-hijas. El body de la respuesta estará vacío — no intentar parsear JSON.

Ejemplo de respuesta

200 Información del estado del lote obtenida exitosamente. 
{
    "isError": false,
    "data": {
        "idLote": "264081134-1776785291254-9d6c97",
        "totalGuias": 3,
        "guiasGeneradas": 2,
        "guiasFallidas": 1,
        "guiasProceso": 0,
        "emailCliente": "logistica@comerciointl.com",
        "detalleGuiasGeneradas": [
            {
                "idPedidoCliente": "PED-2025-00892",
                "guiaCM": "13220721777"
            }
        ]
    }
}

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
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."
    }
}