Nómina electrónica
Set de pruebas superadoServicio independiente (electronic-payroll-service) para la emisión del documento soporte de pago de nómina electrónica y notas de ajuste, con firma digital, cálculo de CUNE, colilla de pago en PDF y webhooks.
- POST /v1/payrolls para nómina individual con devengados, deducciones y cálculo de CUNE.
- POST /v1/payroll-adjustments para notas de ajuste (reemplazo o anulación de nóminas previas).
- Consultas dedicadas: GET /v1/documents, GET /v1/documents/{document_id}, GET /v1/documents/{document_id}/artifacts y GET /v1/employers/{tax_id}/status.
- Colilla de pago en PDF con código QR oficial de la DIAN y plantilla configurable por empresa.
- Envío automático del desprendible por correo electrónico al trabajador con plantilla por empresa.
- Webhooks con firma HMAC al consumidor para notificar la aceptación o rechazo de la DIAN.
- Aislamiento e idempotencia estricta por empleador para evitar duplicidad de comprobantes.
El set de pruebas de habilitación ante la DIAN quedó aprobado el 21 de septiembre de 2026 con el software propio de Defriction S.A.S. como emisor: se transmitieron y fueron aceptadas 5 nóminas individuales y 4 notas de ajuste, con CUNE y ApplicationResponse oficiales de la DIAN.
La habilitación es por emisor: cada empresa que use el servicio de nómina debe habilitar su propio software ante la DIAN. Consulta la guía de habilitación con software propio.
El servicio se encuentra desplegado y funcional en ambiente de desarrollo. El paso a producción depende de que el portal de la DIAN marque el software como habilitado.
Ejemplo de código · sustituye los datos antes de usarlo
POST /v1/payrolls
{
"employer_nit": "900234567",
"employee": { "identification": "1098765432", "first_name": "Carlos", "family_name": "Gómez" },
"period": { "settlement_start": "2026-09-01", "settlement_end": "2026-09-30", "payment_date": "2026-09-30" },
"accruals": { "salary": 2500000, "transportation_allowance": 162000 },
"deductions": { "health": 100000, "pension": 100000 }
}