---
title: "Consultar historial de procesos de un comprobante"
method: GET
path: "/api/v1/comprobante/historial"
tags: ["Nómina Electrónica"]
---

# Consultar historial de procesos de un comprobante

`GET /api/v1/comprobante/historial`

**Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante/historial

Permite consultar el detalle del historial de procesos generados para un comprobante de nómina electrónica. Incluye información sobre cada etapa del proceso de generación, firma, envío y respuesta de la DIAN.

## Query parameters

- `idComprobante` string, required

## Headers

- `Authorization` string, required

## Response `200`

Consulta exitosa

- object — Respuesta de consulta del historial de auditoría de un comprobante
  - `mensajesError` string[] — Lista de mensajes de error identificados en el proceso de nómina electrónica
  - `operacionExitosa` boolean — Indica si se pudo ejecutar correctamente el servicio
  - `idComprobante` string — Identificador del comprobante en el sistema
  - `numero` string — Número del documento sin prefijo
  - `prefijo` string — Prefijo del documento
  - `listaProcesos` object[] — Lista con los procesos ejecutados en el ciclo de vida del comprobante, ordenados cronológicamente
    - `proceso` string — Nombre del proceso de nómina electrónica ejecutado
    - `fechaEjecucion` string, date-time — Fecha en la que se ejecutó el proceso
    - `estado` string — Estado del proceso ejecutado de nómina electrónica

## Other responses

- `400` — Error de validación o datos de entrada incorrectos. Posibles causas: - Campos obligatorios faltantes (ej. empleado.numeroDocumento). - Formato de fechas o números inválido. - Límite de elementos excedido (por ejemplo: máximo 100 comprobantes o 50 IDs). - Identificadores con formato incorrecto.
- `401` — No autorizado para el uso del servicio. Posibles causas: - No se envió el Bearer token en la cabecera Authorization. - Token inválido o caducado. - Sesión o tenant no válidos.
- `429` — Límite de peticiones excedido (Too Many Requests).
- `500` — Error interno del servidor. Ocurrió un error inesperado en el servidor.

---

[API](https://skmtc.net/loggro/apis/documentos-electr-nicos.md) · [All operations](https://skmtc.net/loggro/apis/documentos-electr-nicos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggro/documentos-electr-nicos/versions/f390b90daf37/schema)