How to File Electronic Payroll with DIAN in Colombia 🇨🇴: Employer Walkthrough for Nómina Electrónica

How to File Electronic Payroll with DIAN in Colombia 🇨🇴: Employer Walkthrough for Nómina Electrónica
Emmanuel Amegah

Emmanuel Amegah

May 16, 2026

Nómina electrónica is Colombia's mandatory electronic payroll document system, administered by DIAN (Dirección de Impuestos y Aduanas Nacionales). Every payment of employment income to a formal employee must be supported by a DIAN-validated Documento Soporte de Nómina Electrónica (DSNE). Without it, the employer cannot deduct the payroll cost from corporate income tax.

Who Must Comply

Nómina electrónica is mandatory for all employers with employees under a formal employment contract (contrato de trabajo), regardless of company size. Independent contractors are not covered — the obligation applies only to formal employment relationships.

What Nómina Electrónica Is

The DSNE is a structured XML document transmitted to DIAN's technical services for each payroll payment. DIAN validates the document in real time and returns a CUFE (Código Único de Documento Electrónico de Nómina) — a unique validation code that confirms the document is legally valid. Without a CUFE-confirmed DSNE, the payroll expense is not deductible for Colombian corporate income tax.

Step 1: Register as a Nómina Electrónica Issuer with DIAN

Requirements

  • Active RUT with the employer's NIT
  • Digital signature certificate (firma electrónica) from a DIAN-authorised certifying entity (e.g., Certicámara, GSE, Andes SCD)
  • Software solution: DIAN-authorised third-party provider or DIAN's free tool

Registration steps

  1. Log in to the DIAN portal at muisca.dian.gov.co using the company NIT and digital signature.
  2. Navigate to "Facturación Electrónica" and select "Nómina Electrónica."
  3. Complete the habilitación form, declaring the software solution to be used.
  4. Submit a test set of documents (typically 5 to 10 DSNE) in the DIAN habilitación environment.
  5. Once the test set is approved, DIAN activates the employer for production transmission.

The habilitación process typically takes 5 to 15 business days. Begin registration 3 to 4 weeks before the first payroll run.

Step 2: Choose a Software Solution

DIAN free tool: Suitable for small employers. Manual data entry per employee per pay period; limited automation.

Own software: Requires implementing the DIAN XML schema specification and obtaining technical certification. Only recommended with significant internal development resources.

Authorised software provider (most common): DIAN maintains a list of authorised operadores de nómina electrónica. The employer feeds payroll data to the provider's system; the provider handles document generation, schema compliance, and DIAN transmission.

Step 3: Structure Each Payroll Document (DSNE)

Each DSNE must include:

Employer data: NIT, company name, and software provider identifier.

Employee data: Cédula, full name, contract type, and start date.

Remuneration data: Basic salary, overtime, commissions, bonuses, and non-salary payments. Plus all deductions: health (EPS 4%), pension (AFP/ONP 4%), and other agreed deductions.

Accruals data: Prima de servicios, cesantías, vacaciones, and intereses sobre cesantías accruals for the period.

Net pay: Total devengado (earned), total deducido (deducted), net payment amount, and payment date.

Each individual employee payment requires its own document.

Step 4: Transmit to DIAN and Receive the CUFE

  1. Transmit the XML document to DIAN's production web service via your software provider or DIAN's tool.
  2. DIAN validates in real time — typically within seconds.
  3. If validation passes, DIAN returns the CUFE. The document is now legally valid.
  4. If validation fails, DIAN returns an error code. Correct and resubmit before the pay period closes.

Store the CUFE with the payroll record. It is the proof of DIAN validation required in a corporate income tax audit.

Step 5: Issue a Nota de Ajuste for Corrections

If a payroll payment is corrected after the DSNE has been validated, issue a Nota de Ajuste referencing the original DSNE's CUFE. Never cancel and reissue — always use the Nota de Ajuste process.

Common Mistakes

1. Not completing the habilitación before the first payroll run. DIAN requires a validated test set before granting production access. Operators who skip this step have no valid DSNE and therefore no deductible payroll expense for any period prior to activation.

2. Transmitting summary documents instead of per-employee documents. Each employee payment requires its own DSNE. A single document covering multiple employees is not valid under DIAN's schema.

3. Omitting accrual concepts. The DSNE must include prima, cesantías, and vacaciones accruals — not just cash payments. Incomplete documents fail DIAN validation or are rejected in audits.

4. Not storing the CUFE. If the CUFE is lost, the deduction cannot be defended in a corporate income tax audit. Every DSNE must be archived with its CUFE.

5. Missing the Nota de Ajuste obligation. Correcting payroll by reissuing a new DSNE without referencing the original creates duplicate documents in DIAN's system.

How Cadana Supports Colombian Payroll Compliance

Generating DIAN-compliant DSNE documents, managing the habilitación and CUFE retrieval process, including all required accrual concepts, and handling Notas de Ajuste for corrections — Cadana's global payroll tax engine handles the full nómina electrónica cycle at the API layer.

Book a demo at cadanapay.com/book-demo to see how it works in practice.

Sources and References

Process current as of April 2026. Verify the current DIAN XML schema version and habilitación requirements via the DIAN portal before implementation.

Emmanuel Amegah

Emmanuel Amegah