---
title: "Consultar comprobantes generados"
method: GET
path: "/api/v1/comprobantes"
tags: ["Nómina Electrónica"]
---

# Consultar comprobantes generados

`GET /api/v1/comprobantes`

**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/comprobantes

A través de este servicio REST es posible obtener la información de uno o varios Documentos Soporte de Pago de Nómina Electrónica, previamente generados y transmitidos a la DIAN. El servicio admite la consulta de hasta 300 documentos por petición.

Permite verificar si un documento fue correctamente generado y transmitido a la DIAN, así como identificar posibles errores reportados por la entidad o por el sistema interno.

## Query parameters

- `idComprobantes` string[], required

## Headers

- `Authorization` string, required

## Response `200`

Consulta exitosa

- object — Respuesta de consulta de información de una lista de comprobantes
  - `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
  - `respuestaPorDocumento` object[] — Lista con la respuesta de consulta por cada documento
    - `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
    - `numero` string — Número del documento sin prefijo
    - `prefijo` string — Prefijo del documento
    - `idDocumento` string — Identificador del documento en el sistema
    - `documentoRecibido` boolean — Indica si el documento fue alguna vez enviado a nómina electrónica. Independiente de si fue procesado o tuvo errores.
    - `estadoDocumento` string — Indica el estado del documento recibido. Posibles valores: 'En validación' (En proceso de validación ante la DIAN), 'Rechazado' (Rechazado por la aplicación o por la DIAN), 'Confirmado' (Confirmado en la aplicación).
    - `estadoNotificadoDIAN` string — Descripción del Estado de la notificación del documento a la DIAN. Posibles valores: 'Confirmado', 'Confirmado con Notificación'.
    - `codigoEstadoNotificadoDIAN` string — Código del Estado de la notificación del documento a la DIAN. Posibles valores: 'C' (Confirmado), 'CN' (Confirmado con Notificación).
    - `notificadoDIAN` boolean — Indica si se notificó a la DIAN
    - `fechaValidacionDian` string, date-time — Fecha en que se notificó a la DIAN

## 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)