---
title: "Generar múltiples comprobantes de nómina electrónica"
method: POST
path: "/api/v1/comprobantes"
tags: ["Nómina Electrónica"]
---

# Generar múltiples comprobantes de nómina electrónica

`POST /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

Este servicio REST permite generar hasta 100 documentos soporte por pago de nómina electrónica, cumpliendo con los requisitos establecidos por la DIAN.

**Formato del JSON:** Consulta el detalle técnico del formato requerido en [Estructura Documentos Electrónicos - Nómina Electrónica.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20N%C3%B3mina%20Electr%C3%B3nica.xlsx)

## Headers

- `Authorization` string, required

## Request body

- object

## Response `201`

Petición procesada con éxito

- object — Respuesta de la generación masiva de comprobantes de nómina electrónica
  - `mensajesError` string[] — Lista de mensajes de error que impiden que el comprobante se procese
  - `peticionProcesada` boolean — Se retorna el valor true si se pudo ejecutar correctamente el servicio, procesando la petición enviada. Se retorna el valor false si no se pudo ejecutar correctamente el servicio.
  - `respuestasPorComprobante` object[] — En caso de ejecutarse correctamente el servicio, se retorna esta lista con la respuesta para cada comprobante de nómina.
    - `mensajesError` string[] — Lista de mensajes de error que impiden que el comprobante se procese
    - `idComprobante` string — En caso de que el proceso de generación de nómina electrónica se haya completado de forma exitosa, retorna el identificador del documento para el sistema.
    - `numero` string — Corresponde al número del documento soporte de pago de nómina electrónica, sin prefijo.
    - `prefijo` string — Corresponde al Prefijo del documento soporte de pago de nómina electrónica, en caso de contar con este.
    - `tipoComprobante` string — Indica el tipo de comprobante de nómina procesado (documento soporte de pago de nómina electrónica). NIE: para nómina individual electrónica. NIAE: para nómina individual de ajuste electrónica por reemplazo. NIEE: para nómina individual de ajuste electrónica por eliminación.
    - `comprobanteProcesado` boolean — Booleano que indica si el documento fue recibido en el sistema. Se retorna true si el proceso se terminó completamente y pasará a proceso de validación por parte del proveedor tecnológico. Se retorna false si se encontraron errores graves en la información de entrada.
  - `respuestaPorDocumento` object[]
    - `mensajesError` string[] — Lista de mensajes de error que impiden que el comprobante se procese
    - `idComprobante` string — En caso de que el proceso de generación de nómina electrónica se haya completado de forma exitosa, retorna el identificador del documento para el sistema.
    - `numero` string — Corresponde al número del documento soporte de pago de nómina electrónica, sin prefijo.
    - `prefijo` string — Corresponde al Prefijo del documento soporte de pago de nómina electrónica, en caso de contar con este.
    - `tipoComprobante` string — Indica el tipo de comprobante de nómina procesado (documento soporte de pago de nómina electrónica). NIE: para nómina individual electrónica. NIAE: para nómina individual de ajuste electrónica por reemplazo. NIEE: para nómina individual de ajuste electrónica por eliminación.
    - `comprobanteProcesado` boolean — Booleano que indica si el documento fue recibido en el sistema. Se retorna true si el proceso se terminó completamente y pasará a proceso de validación por parte del proveedor tecnológico. Se retorna false si se encontraron errores graves en la información de entrada.

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