Este servicio REST permite generar un comprobante individual de nómina electrónica para un empleado, cumpliendo con los requisitos establecidos por la DIAN y garantizando la correcta emisión del documento dentro del sistema de facturación electrónica.
El comprobante generado incluye la información del empleado, el periodo de nómina, los valores devengados y las deducciones aplicadas, con el fin de asegurar la trazabilidad, transparencia y cumplimiento normativo de la nómina electrónica.
Nota: Este endpoint está diseñado para la generación individual de comprobantes, ideal para integraciones con sistemas de recursos humanos o gestión contable que procesan la nómina de manera automática.
El servicio requiere como entrada:
- Identificación del facturador electrónico (emisor del comprobante) - Datos del empleado (identificación, nombre, cargo, etc.) - Periodo de nómina (fecha de inicio y fecha de fin) - Detalle de devengados (ingresos, horas extras, bonificaciones, etc.) - Detalle de deducciones (retenciones, aportes, préstamos, entre otros)
¿Qué tipo de información puedes obtener?
La respuesta de este servicio incluye:
- Estado de generación del comprobante - Identificador único del comprobante - Respuesta de validación de la DIAN con códigos y descripciones - Elementos electrónicos asociados, tales como:
- XML del comprobante (Base64)
- PDF de la representación gráfica (Base64)
- CUFE o CUDE del documento
Formato específico del XML
Consulta el detalle técnico del formato requerido para el XML: Estructura Documentos Electrónicos - Nómina Electrónica.xlsx
Ejemplos de uso comunes
- Generación de comprobantes individuales de nómina para empleados - Cumplimiento de obligaciones legales ante la DIAN - Procesos de cierre de nómina mensual o quincenal - Integración con sistemas de gestión contable o de RRHH