📜 Historial de Órdenes de Compra

Lista paginada de órdenes de compra del cliente excluyendo estado CARRITO.

GET /ordenes-compras/historial v1.0.0
Autenticación
Bearer Token
Ambiente
Servidor según ambiente (dev, test o prod). `guias-anticipadas-services-test.coordinadora.com` se define sin protocolo; el pipeline antepone `https://`.

Descripción

Lista paginada de órdenes de compra del cliente excluyendo estado CARRITO. Consulta solo la tabla ordenes_compras (sin join a detalles/paquetes).

Contrato query: ListarHistorialOrdenesComprasQuerySchema en cm-guias-anticipadas-ms (listar-historial-ordenes-compras.dto.ts).

Notas de exposición

  • Path Istio en este gateway: GET /ordenes-compras/historial (rewrite al MS).
  • No es el target de Locust. La prueba de carga (flujo-17 / CA-014) apunta al

endpoint público de suite-backend: GET /guias-anticipadas/ordenes-compras/historial.

🔒 Autenticación:

  • 🔑 Bearer Token en el header Authorization.

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 /ordenes-compras/historial

Base URL https://guias-anticipadas-services-test.coordinadora.com

Parámetros

Nombre Tipo Requerido Descripción
nit query string Sí NIT del cliente
email query string Sí Email del cliente
division query string No División del cliente (opcional)
pagina query integer No Número de página (default 1)
registros_por_pagina query integer No Tamaño de página (default 50, máx. 100)
orden query string No Dirección de ordenamiento
orden_por query string No Columna de ordenamiento

Respuesta

200
✅ Historial paginado
{
    "isError": false,
    "data": {
        "items": [
            []
        ],
        "pagina": 1,
        "registros_por_pagina": 50,
        "total_registros": 120,
        "total_paginas": 3
    }
}

Ejemplo de respuesta

200 ✅ Historial paginado 
{
    "isError": false,
    "data": {
        "items": [
            []
        ],
        "pagina": 1,
        "registros_por_pagina": 50,
        "total_registros": 120,
        "total_paginas": 3
    }
}

Errores

400
❌ Parámetros de query inválidos
{
    "isError": true,
    "message": "Los valores de entrada no son correctos.",
    "code": "BAD_REQUEST",
    "statusCode": 400,
    "cause": "El campo nit es obligatorio"
}
500
💥 Error interno del servidor
[]