GravamenexAPI
Obtener API key
Documento soporte de pago de nómina · CUNE

Nómina electrónica

Habilitación superada

Servicio 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.

Qué incluye
  • 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.
Estado de habilitación DIAN

El set de pruebas de habilitación ante la DIAN quedó aprobado el 21 de septiembre de 2026: se transmitieron y fueron aceptadas 5 nóminas individuales y 4 notas de ajuste, con CUNE y ApplicationResponse oficiales de la DIAN.

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 nómina individual
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 }
}