Consultar estados y trazabilidad de guías

Permite consultar el estado actual, historial de estados, novedades,

POST /clientes-tracking/mio v1.0.0
Ambiente
Entorno de desarrollo, Entorno de pruebas, Entorno de producción

Descripción

Permite consultar el estado actual, historial de estados, novedades, información TPS, vínculos y datos Droop de una o varias guías.

El servicio:

  • Valida la configuración del cliente por NIT.
  • Consulta estados MIO en batches.
  • Consulta TPS, novedades y vínculos en paralelo.
  • Enriquece la información con datos internacionales, guia digital y Droop cuando aplica.

Quick Start

  1. Obtén tus credenciales de acceso.
  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

POST /clientes-tracking/mio

Base URL https://api-dev.coordinadora.tech/clientes-tracking/mio

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

{
    "nit": "890904713",
    "guias": [
        "20016012502",
        "20016012503"
    ]
}

Respuesta

200
Consulta completada exitosamente
{
    "message": "Consulta completada con éxito",
    "data": {
        "guias_consultadas": [
            {
                "guia": "20016012502",
                "id_estado_actual": 7,
                "estado_actual": "En punto Droop",
                "estado": [
                    {
                        "id_estado": 1,
                        "nombre_estado": "Recogido",
                        "fecha_estado": "2025-01-10",
                        "internacional": false
                    },
                    {
                        "id_estado": 7,
                        "nombre_estado": "En punto Droop",
                        "fecha_estado": "2025-01-12",
                        "internacional": false
                    }
                ],
                "novedad": [
                    {
                        "codigo": "NOV01",
                        "descripcion": "Dirección incompleta"
                    }
                ],
                "origen": "Bogotá",
                "destino": "Medellín",
                "codigo_dane_origen": "11001",
                "codigo_dane_destino": "05001",
                "producto": "EXPRESS",
                "referencia": "REF123",
                "tipoguia": 1,
                "dias_promesa_servicio": 2,
                "vinculos": [
                    {
                        "tipo": "Reexpedición",
                        "guia_vinculada": "20016088888"
                    }
                ],
                "punto_droop": {
                    "nombre_droop": "Droop Centro",
                    "direccion_droop": "Calle 10 # 5-20",
                    "telefono_droop": "6012345678",
                    "horario_droop": "08:00 - 18:00",
                    "codigo_droop": "D001"
                },
                "guia_digital": "https://clientes-tracking-services-test.coordinadora.com/clientes-tracking/obtener-imagen/frgeg2235235657"
            }
        ],
        "guias_incorrectas": [
            "99999999999"
        ]
    }
}

Ejemplo de respuesta

200 Consulta completada exitosamente 
{
    "message": "Consulta completada con éxito",
    "data": {
        "guias_consultadas": [
            {
                "guia": "20016012502",
                "id_estado_actual": 7,
                "estado_actual": "En punto Droop",
                "estado": [
                    {
                        "id_estado": 1,
                        "nombre_estado": "Recogido",
                        "fecha_estado": "2025-01-10",
                        "internacional": false
                    },
                    {
                        "id_estado": 7,
                        "nombre_estado": "En punto Droop",
                        "fecha_estado": "2025-01-12",
                        "internacional": false
                    }
                ],
                "novedad": [
                    {
                        "codigo": "NOV01",
                        "descripcion": "Dirección incompleta"
                    }
                ],
                "origen": "Bogotá",
                "destino": "Medellín",
                "codigo_dane_origen": "11001",
                "codigo_dane_destino": "05001",
                "producto": "EXPRESS",
                "referencia": "REF123",
                "tipoguia": 1,
                "dias_promesa_servicio": 2,
                "vinculos": [
                    {
                        "tipo": "Reexpedición",
                        "guia_vinculada": "20016088888"
                    }
                ],
                "punto_droop": {
                    "nombre_droop": "Droop Centro",
                    "direccion_droop": "Calle 10 # 5-20",
                    "telefono_droop": "6012345678",
                    "horario_droop": "08:00 - 18:00",
                    "codigo_droop": "D001"
                },
                "guia_digital": "https://clientes-tracking-services-test.coordinadora.com/clientes-tracking/obtener-imagen/frgeg2235235657"
            }
        ],
        "guias_incorrectas": [
            "99999999999"
        ]
    }
}

Errores

400
Error de validación del request
{
    "message": "El campo guias no puede estar vacío",
    "code": "VALIDATION_ERROR"
}
404
Cliente no encontrado o inactivo
{
    "message": "Cliente no encontrado",
    "code": "CLIENT_NOT_FOUND"
}
500
Error interno del servicio
{
    "message": "Error interno consultando estados MIO",
    "code": "INTERNAL_ERROR"
}