Nómina individual

Reporta el documento soporte de pago de Nómina Individual Electrónica (TipoDocumento: NIE; código DIAN 102-NominaIndividual) con la nómina de todos los trabajadores en un único JSON.

nota

Actualmente el sistema no procesa ningún XML ante la DIAN: solo valida que la estructura del JSON sea correcta. La estructura puede cambiar con nuevos lineamientos de la DIAN.

Estructura del documento

Documento
├── SoftwareSeguridad
├── EmisorData
├── EncabezadoNominaData
└── lsTrabajador (1-N)
    ├── (datos del trabajador)
    ├── lsFechasPagos
    ├── Devengados
    │   └── lsAuxTransporte, lsHorasExtra, lsVacaciones, Primas, Cesantias, ...
    ├── Deducciones
    │   └── lsSindicatos, lsSanciones, lsLibranzas, lsComTercAnticipos
    └── lsNotasNomina

Los nodos de lista de Devengados y Deducciones se detallan en Listas y anexos.

SoftwareSeguridad (SeguridadSoftwareType)

Datos para que el sistema valide la identificación y autorización del sistema que se está integrando.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
TipoDocumento	Tipo de documento enviado	Sí	Nómina Individual Electrónica: NIE
GuidEmpresa	Código de identificación de la empresa que genera los datos	Sí	Código asignado al momento de la implementación para identificar la empresa de donde provienen los datos.
GuidOrigen	Código de identificación del origen de los datos	Sí	Código asignado al momento de la implementación para identificar el origen de donde provienen los datos.
HashSeguridad	Código de seguridad	Sí	Clave de seguridad asignada al momento de la implementación.
GuidSistemaIntegrado	Código de identificación del sistema integrado asociado.	Sí	Código asignado al momento de la implementación para identificar el sistema integrado de donde proviene el documento.

EmisorData (EmisorType)

Datos del empleador (emisor del documento de nómina).

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
EmiTipoPersona	Tipo de persona del emisor	Sí	Ver lista
EmiTipoIdentificacion	Tipo de identificación del emisor	Sí	Ver lista
EmiIdentificacion	Número de identificación del emisor	Sí
EmiDVIdentificacion	Digito de Verificacion del emisor	Sí

EncabezadoNominaData (EncabezadoNominaType)

Datos generales del documento de nómina.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
FechaHoraGen	Fecha y Hora de Generacion	Sí	Formato: aaaa-mm-dd hh:mm:ss Ejemplo: 2019-08-01 17:40:25
PaisGen	Código del Pais en el que se genera el documento.	Sí	Colombia - CO
DepartamentoGen	Código DANE del departamento en el cual se genera el documento	Sí	Ver tabla de códigos DANE
MunicipioGen	Código DANE del municipio en el cual se genera el documento	Sí	Ver tabla de códigos DANE
TipoDocumento	Código del tipo de documento según codificacion de la DIAN	Sí	102: NominaIndividual

lsTrabajador (List<TrabajadorType>)

Listado de los trabajadores incluidos en el documento. Un solo JSON reporta la nómina de todos los trabajadores.

Ocurrencia: 1-N (Obligatorio mínimo un registro)

Campo	Descripción	Obligatorio	Observaciones
Consecutivo	Debe corresponder a un consecutivo manejado por el Empleador	Sí	Número consecutivo para identificar el trabajador: 1, 2, 3,…
Codigo	Código interno que identifica al empleado en el sistema de nómina	No
Prefijo	Prefijo del documento, depende de las sucursales que posea el Empleador	No
Numero	Debe corresponder al Prefijo y consecutivo manejado por el Empleador	Sí
Novedad	Indica si existe alguna Novedad Contractual en el Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica del Trabajador en dicho Mes.	No	Debe ir el CUNE del documento al cual se le realizará la novedad contractual
PeriodoNomina	Código del periodo de nómina según listado DIAN	Sí	Ver lista
TipoMoneda	Tipo de moneda base del documento.	Sí	COP - Peso Colombiano
TRM	en caso que el tipo moneda sea diferente de COP (Peso Colombiano) se debe definir el TRM.	No	Tasa representativa del mercado en caso que el tipo moneda sea diferente de COP
FechaIngreso	Se debe diligenciar unicamente en el mes en el que el empleado ingreso a la empresa, en caso de tener mas de un ingreso, se debe indicar la ultima fecha.	No	Formato: aaaa-mm-dd Ejemplo: 2019-08-01
FechaRetiro	Se debe diligenciar unicamente en el mes en que el empleado se retiro de la empresa, en caso de presentar varios retiros se debe indicar la ultima fecha.	No	Formato: aaaa-mm-dd Ejemplo: 2019-08-01
FechaLiquidacionIni	Fecha de inicio de Liquidación de Nómina	Sí	Formato: aaaa-mm-dd Ejemplo: 2019-08-01
FechaLiquidacionFin	Fecha fin de Liquidación de Nómina	Sí	Formato: aaaa-mm-dd Ejemplo: 2019-08-01
TiempoLaborado	Cantidad de Tiempo que lleva laborando el Trabajador en la empresa	Sí	Ver lista
TipoTrabajador	Código del tipo de trabajador según listado de la DIAN	Sí	Ver lista
SubTipoTrabajador	Código del subtipo de trabajador según listado de la DIAN	Sí	Ver lista
AltoRiesgoPension	Si el trabajador desarrollo durante el presente periodo alguna de las actividades descritas en el Decreto 2090 de 2003, o la norma que lo modifique, adicione o sustituya.	Sí	True o False
TipoDocumento	Tipo de documento del trabajador	Sí	Ver lista
NumeroDocumento	Numero de identificacion del trabajador	Sí
PrimerApellido	Primer Apellido del trabajador	Sí
SegundoApellido	Segundo apellido del trabajador	Sí
PrimerNombre	Primer nombre del trabajador	Sí
OtrosNombres	Otros nombres del trabajador	No
LugarTrabajoPais	Código del pais donde realiza las actividades el trabajador	Sí	Colombia - CO
LugarTrabajoDepartamento	Código DANE del departamento donde realiza las actividades el trabajador	Sí	Ver tabla de códigos DANE.
LugarTrabajoMunicipio	Código DANE del municipio donde realiza las actividades el trabajador	Sí	Ver tabla de códigos DANE.
LugarTrabajoDireccion	Direccion donde realiza las actividades el trabajador	Sí
CorreoNotificacion	Correo electrónico al cual se le debe enviar el comprobante de nómina al trabajador	No	Si este campo no es informado, el sistema no enviará comprobante de nómina al trabajador
SalarioIntegral	Si el trabajador tiene un salario integral, el cual es el tipo de remuneración que incluye todos los conceptos que puedan constituir salario en un solo monto o pago (prestaciones sociales y recargos nocturno, dominical y festivo, y el trabajo extra) y que sea superior a 10 SMLMV mas un 30% correspondiente a factor prestacional.	Sí	True o False
TipoContrato	Código del tipo de contrato del trabajador	Sí	Ver lista
Sueldo	Se debe colocar el Sueldo Base que el Trabajador tiene en la empresa	Sí
PagoForma	Código de la forma de pago	Sí	1: Contado
PagoMetodo	Código del método de pago	Sí	Ver lista
PagoBanco	Nombre de Entidad Bancaria del Empleado donde se realiza la consignación	No	Si el pago se realiza por transferencia bancaria este campo es obligatorio
PagoTipoCuenta	Tipo de Cuenta Bancaria del Empleado donde se realiza la consignación	No	Si el pago se realiza por transferencia bancaria este campo es obligatorio
PagoNumeroCuenta	Numero de Cuenta Bancaria del Empleado donde se realiza la consignación	No	Si el pago se realiza por transferencia bancaria este campo es obligatorio
Redondeo	En caso en que la aplicacion del redondeo marque una diferencia entre los totales calculados y la suma de los parciales, se debe informar aquí esa diferencia.	No	Ver lista
lsFechasPagos	Listado de las fechas de pago de nómina	Sí	Debe existir por lo menos un elemento en la lista. Ver lista
Devengados	Valores devengados de tipo DevengadosType	Sí	Ver lista
Deducciones	Valores de las deducciones de tipo DeduccionesType	Sí	Ver lista
lsNotasNomina	Listado de notas adicionales del trabajador	Sí	Ver lista
DevengadosTotal	Valor total de la Suma de todos los items de Devengados del Documento	Sí
DeduccionesTotal	Valor total de la Suma de todas las items de Deducciones del Documento	Sí
ComprobanteTotal	Debe ir el total de: Devengados - Deducciones	Sí

lsFechasPagos (List<FechaType>)

Fechas de pago de la nómina del trabajador.

Ocurrencia: 1-N (Obligatorio, al menos un registro)

Campo	Descripción	Obligatorio	Observaciones
FechaPago	Fecha de Pago de la Nómina	Sí	Formato: aaaa-mm-dd Ejemplo: 2019-08-01

Devengados (DevengadosType)

Conceptos devengados por el trabajador en el periodo.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
DiasTrabajados	Cantidad de dias laborados durante el Periodo de Pago	Sí
SueldoTrabajadoDevengado	Valor Base o Sueldo del trabajador según lo estipulado en su contrato. Corresponde al Sueldo Trabajado por los días laborados.	Sí
lsAuxTransporte	Listado de los pagos de auxilio de transporte y de viaticos de limentacion devengados por el trabajador.	No	Ver lista
lsHorasExtra	Cooresponde al listado de horas extra y horas de recargo autorizadas y devengadas por el trabajador.	No	Ver lista
lsVacaciones	Corresponde a todos los elementos de vaciones de devengos del documento.	No	Ver lista
Primas	Corresponde a Primas de Devengos del Documento	No	Ver lista
Cesantias	Corresponde a los elementos de Cesantias de Devengos del Documento	No	Ver lista
lsIncapacidades	Corresponde al listado de incapacidades reportadas por el trabajador	No	Ver lista
lsLicencias	Corresponde al listado de Licencias reportadas por el trabajador	No	Ver lista
lsBonAuxOConceptos	Listado de Bonificaciones, auxilios y otros conceptos de devengos del documento	No	Ver lista
lsHuelgas	Listado de elementos de Huelgas legales de devengos del documentos	No	Ver lista
lsCompensaciones	Listado de Compensaciones del documento	No	Ver lista
lsComTercAnticipos	Listado de Comisiones, Pagos a Terceros y Anticipos que hacen parte de los devengos del documento	No	Ver lista
lsBonoEPCTV	Elementos de Bonos Electrónicos o de Papel de Servicio, Cheques, Tarjetas, Vales, etc de Devengos del Documento	No	Ver lista
Dotacion	valor que el empleador dispone para suministrar la dotación de sus trabajadores.	No
ApoyoSost	valor no salarial que el patrocinador paga de forma mensual como ayuda o apoyo economía al aprendiz o practicante universitario durante su etapa lectiva y fase practica.	No
Teletrabajo	Valor que debe ser pagado al trabajador cuyo contrato indica expresamente que puede laborar mediante teletrabajo	No
BonifRetiro	Valor establecido por mutuo acuerdo por retiro del Trabajador	No
Indemnizacion	Valor de Indemnizacion establecido por ley	No
Reintegro	Valor que le regresa la empresa al trabajador por una deducción mal realizada en otro pago de nómina	No

Deducciones (DeduccionesType)

Conceptos deducidos al trabajador en el periodo.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
SaludPorcentaje	Debe corresponder al porcentaje de deducción de salud que paga el trabajador	Sí
SaludDeduccion	Valor Pagado correspondiente a Salud por parte del trabajador	Sí
PensionPorcentaje	porcentaje de deducción de fondo de pensión que paga el trabajador	Sí
PensionDeduccion	Valor Pagado correspondiente a Pension por parte del trabajador	Sí
SegPensionalPorc	porcentaje de deducción de fondo de seguridad pensional que paga el trabajador	No	Estos valores son obligatorios para todo trabajador que devengue un sueldo que sea igual o superior a 4 salarios mininos, debe aportar un 1% al Fondo de solidaridad pensional.
SegPensionalDeduccion	Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador	No
FondoSubsistPorc	Porcentaje que correspondiente al Fondo de Subsistencia correspondiente	No
FondoSubsistValor	Valor Pagado correspondiente a Fondo de Subsistencia por parte del trabajador	No
lsSindicatos	Listado de deducciones correspondientes a sindicatos	No	Ver lista
lsSanciones	Listado de deducciones correspondientes a Sanciones	No	Ver lista
lsLibranzas	Listado de deducciones correspondientes a Libranzas	No	Ver lista
lsComTercAnticipos	Corresponde a los pagos a terceros, anticipos u otras deducciones del documento.	No	Ver lista
PensionVoluntaria	Valor correspondiente al ahorro que hace el trabajador para complementar su pension obligatoria o cumplir metas especificas.	No
RetencionFuente	Valor Pagado correspondiente a Retención en la Fuente por parte del trabajador	No	Si hubiere lugar, la empresa deberá calcular y retener al empleado el valor correspondiente a retención en la fuente por ingresos laborales. Este valor será declarado y consignado en la respectiva declaración mensual de retención en la fuente.
AFC	Valor Pagado correspondiente a AFC por parte del trabajador	No	Corresponde a (Ahorro Fomento a la contruccion)
Cooperativa	Valor Pagado correspondiente a Cooperativas por parte del trabajador	No	Las cuotas o aportes que los empleados hagan a las cooperativas legalmente constituidas
EmbargoFiscal	Valor Pagado correspondiente aEmbargos Fiscales por parte del trabajador	No	Los embargos ordenados por autoridad judicial competente contra los empleados deben ser descontados de la nómina por la empresa y consignarlos en la cuenta que el juez haya ordenado.
PlanComplementarios	Valor Pagado correspondiente a Planes Complementarios por parte del trabajador	No	Valor de planes complementarios de salud al que el trabajador se encuentran afiliado, siempre que medie autorización del empleado.
Educacion	Valor Pagado correspondiente a Conceptos Educativos por parte del trabajador	No	Valor de servicios educativos que el trabajador autorice descuento
Reintegro	Valor Pagado correspondiente a Reintegro por parte del trabajador	No	Valor que le regresa el trabajador a la empresa por un devengo mal realizado en otro pago de nómina
Deuda	Valor Pagado correspondiente a Deuda con la Empresa por parte del trabajador	No

lsNotasNomina (List<NotaNominaType>)

Notas o información adicional del documento.

Ocurrencia: 0-N (Opcional)

Campo	Descripción	Obligatorio	Observaciones
Nota	Información adicional: Texto libre, relativo al documento, Ejemplo: Información de Novedades de los trabajadores.	Sí