Integra Nómina Electrónica en tu Sistema
API REST para generar y transmitir documentos soporte de nómina electrónica a la DIAN. Cumple con la Resolución 000013 de 2021 sin desarrollar desde cero.
¿Qué es el Documento Soporte de Nómina Electrónica?
El documento soporte de pago de nómina electrónica es un archivo XML que los empleadores deben generar y transmitir a la DIAN con la información de los pagos realizados a sus empleados.
Base Legal
Resolución 000013 de 2021 - Establece los requisitos técnicos para la generación y transmisión del documento soporte de nómina electrónica.
Propósito
Soportar los costos y deducciones en el impuesto sobre la renta derivados de los pagos de nómina y sus conceptos asociados.
Obligados
Todos los empleadores que realicen pagos o abonos en cuenta que constituyan costo o gasto para efectos del impuesto sobre la renta.
Documentos de Nómina Soportados
Genera todos los tipos de documentos de nómina electrónica requeridos por la DIAN
Documento Soporte de Nómina
Documento XML que contiene toda la información de pago al trabajador: devengados, deducciones y neto a pagar.
POST /ep/payroll Nota de Ajuste - Reemplazar
Para corregir completamente un documento de nómina previamente transmitido. Reemplaza el documento original.
POST /ep/payroll/replace Nota de Ajuste - Eliminar
Para anular completamente un documento de nómina previamente transmitido cuando fue emitido por error.
POST /ep/payroll/delete Conceptos de Nómina Soportados
Devengados
Deducciones
¿Cómo Funciona la Integración?
Integra nómina electrónica en tu sistema de nómina en pocos pasos
Tu Sistema de Nómina
Calcula salarios, deducciones y genera la información de pago para cada empleado.
Envías JSON a MATIAS API
Una petición HTTP POST con los datos de nómina en formato JSON estructurado.
MATIAS API Procesa
Genera XML UBL 2.1, firma digitalmente y transmite a la DIAN automáticamente.
DIAN Valida
La DIAN recibe, valida y genera el CUNE (Código Único de Nómina Electrónica).
Recibes Respuesta
MATIAS te devuelve el CUNE, XML firmado y estado de la transmisión.
Integración Simple
Solo necesitas enviar un JSON con los datos de nómina. MATIAS API se encarga del resto: XML, firma digital y transmisión a DIAN.
// Endpoint: POST {{url}}/ep/payroll
// Header: Authorization: Bearer {token}
{
"type_document_id": 9,
"employer": {
"identification_number": "900123456",
"name": "Mi Empresa SAS"
},
"worker": {
"type_worker_id": 1,
"type_contract_id": 1,
"surname": "Pérez",
"first_name": "Juan",
"identification_number": "1234567890",
"integral_salary": false,
"salary": 4500000
},
"payment": {
"payment_form_id": 1,
"payment_method_id": 42
},
"accrued": { ... },
"deductions": { ... }
}Calendario de Transmisión
Conoce los plazos establecidos por la DIAN para transmitir los documentos de nómina
Plazos de Transmisión
Nómina Mensual
Debe transmitirse dentro de los 10 primeros días hábiles del mes siguiente al período de pago.
Nómina Quincenal
Debe transmitirse dentro de los 10 primeros días hábiles del mes siguiente, consolidando ambas quincenas.
Notas de Ajuste
Se pueden transmitir en cualquier momento después de identificar el error, dentro de los plazos de corrección tributaria.
Sanciones por Incumplimiento
El no cumplimiento puede generar sanciones según el Art. 651 del Estatuto Tributario: hasta el 5% de las sumas respecto de las cuales no se suministró la información.
Recomendación
Automatiza la transmisión con MATIAS API para evitar olvidos y cumplir siempre a tiempo. Configura alertas en tu sistema de nómina.
Transmisión por Lotes En desarrollo
Próximamente: envía la nómina de todos tus empleados en una sola petición al final del período. Actualmente se transmite documento por documento.
Ejemplo: Ciclo de Nómina Mensual
Período de Trabajo
El empleado trabaja durante el mes
Liquidación de Nómina
Tu sistema calcula devengados y deducciones
Pago al Empleado
Consignas el salario neto
Transmisión a DIAN
Envías el documento de nómina vía MATIAS API
CUNE Generado
Documento válido ante DIAN
¿Por Qué MATIAS API para Nómina?
Beneficios exclusivos para desarrolladores y empresas de software de nómina
Integración Rápida
Envía JSON, recibe CUNE. Sin necesidad de generar XML, firmar digitalmente ni conectarte a DIAN. Integración en días, no meses.
Firma Digital Incluida
Nos encargamos de la firma digital de los documentos XML. No necesitas adquirir ni gestionar certificados digitales para tus clientes.
Actualización Automática
Cuando la DIAN actualiza especificaciones técnicas, nosotros actualizamos la API. Tu código no cambia, siempre estás al día.
Multi-Empresa
Gestiona la nómina electrónica de múltiples empresas desde una sola cuenta. Ideal para casas de software y contadores.
Transmisión por Lotes En desarrollo
Próximamente: envía la nómina de todos tus empleados en una sola petición. Por ahora, transmisión documento por documento.
Soporte Especializado
Soporte técnico de desarrolladores para desarrolladores. Asesoría en integración, resolución de dudas técnicas y debugging.
Comparativa: Desarrollo Propio vs MATIAS API
Precios para Nómina Electrónica
La nómina electrónica está incluida en todos nuestros planes sin costo adicional
Casa de Software
Para empresas que desarrollan software de nómina
Servidor Dedicado
Para grandes volúmenes de nómina
Paquetes por NIT
Para empresas con software propio
¿Ya tienes un plan de facturación?
Si ya eres cliente de MATIAS API, simplemente comienza a usar los endpoints de nómina electrónica. No necesitas contratar nada adicional.
¿Solo necesitas nómina electrónica?
Si solo necesitas transmitir nómina (sin facturación), contáctanos para una cotización personalizada adaptada a tu volumen.
¿Listo para integrar Nómina Electrónica?
Crea tu cuenta gratuita y comienza a transmitir documentos de nómina hoy mismo
Dudas sobre Nómina Electrónica
Resuelve las preguntas más comunes sobre la integración y transmisión de nómina
¿Qué es el CUNE y para qué sirve?
El CUNE (Código Único de Nómina Electrónica) es un identificador único de 96 caracteres que genera la DIAN para cada documento de nómina electrónica validado. Es el equivalente al CUFE de la facturación electrónica. El CUNE certifica que el documento fue transmitido y validado correctamente por la DIAN, y debe conservarse como soporte para efectos tributarios.
¿Cuál es la diferencia entre nómina electrónica y factura electrónica?
La factura electrónica documenta transacciones comerciales (ventas de bienes o servicios) y se emite al cliente. La nómina electrónica documenta los pagos laborales realizados a empleados y se transmite directamente a la DIAN, no al trabajador. Ambas requieren formato XML UBL 2.1, firma digital y validación previa de la DIAN, pero tienen estructuras y propósitos diferentes.
¿Qué empresas están obligadas a transmitir nómina electrónica?
Todos los empleadores que realicen pagos o abonos en cuenta que constituyan costo o gasto para efectos del impuesto sobre la renta deben transmitir el documento soporte de nómina electrónica. Esto incluye personas jurídicas y naturales con empleados. Las fechas de implementación varían según el calendario establecido por la DIAN en la Resolución 000013 de 2021.
¿Qué pasa si transmito la nómina con errores?
Si detectas errores en un documento de nómina ya transmitido, puedes corregirlo mediante una Nota de Ajuste. Existen dos tipos: Reemplazar (corrige completamente el documento original) y Eliminar (anula el documento si fue emitido por error). MATIAS API soporta ambos tipos de notas de ajuste con endpoints dedicados.
¿Necesito un certificado digital para transmitir nómina?
Sí, los documentos de nómina electrónica deben estar firmados digitalmente. Sin embargo, MATIAS API se encarga de la firma digital por ti. No necesitas adquirir, instalar ni gestionar certificados digitales. Nosotros firmamos el XML antes de transmitirlo a la DIAN, simplificando significativamente tu integración.
¿Puedo transmitir nómina de empleados de múltiples empresas?
Sí, con los planes Casa de Software y Servidor Dedicado puedes gestionar la nómina de múltiples empresas desde una sola cuenta de MATIAS API. Esto es ideal para software de nómina que atiende varios clientes, bureaus de nómina, o grupos empresariales con varias razones sociales.
¿Qué conceptos de nómina soporta MATIAS API?
MATIAS API soporta todos los conceptos establecidos por la DIAN: salario básico, auxilio de transporte, horas extras (diurnas, nocturnas, festivas), comisiones, bonificaciones, viáticos, vacaciones, primas, cesantías, incapacidades, licencias, y todas las deducciones (salud, pensión, retención en la fuente, embargos, libranzas, etc.).
¿Cómo integro nómina electrónica con mi sistema de nómina existente?
La integración es sencilla: después de que tu sistema calcule la nómina, envías un JSON con los datos del empleado, devengados y deducciones a nuestra API REST. MATIAS genera el XML UBL 2.1, firma digitalmente y transmite a DIAN. Te devolvemos el CUNE y estado de validación. Puedes ver ejemplos de código en nuestra documentación técnica.
¿La nómina electrónica tiene costo adicional en MATIAS API?
No, la nómina electrónica está incluida en todos los planes de MATIAS API sin costo adicional. Si ya tienes un plan de facturación electrónica, simplemente comienza a usar los endpoints de nómina. Los documentos de nómina se cuentan dentro de tu volumen contratado junto con facturas y otros documentos.
¿Qué soporte técnico ofrecen para la integración de nómina?
Ofrecemos soporte técnico especializado para desarrolladores. Incluye documentación completa con ejemplos, asesoría en integración, resolución de dudas técnicas, y debugging de errores. Respuesta en 1-8 horas hábiles para planes estándar, y soporte prioritario para planes premium. Contacto vía WhatsApp, email o sistema de tickets.
¿Tienes más preguntas?
Nuestro equipo técnico está listo para ayudarte
¿Listo para Integrar Nómina Electrónica?
Comienza hoy mismo. Crea tu cuenta, obtén tus credenciales API y transmite tu primer documento de nómina en minutos.