Nómina Individual Electrónica

Url POST

Producción:

https://api.payroll.emision.co/api/v1/service/payrolls/production

Pruebas:

https://api.payroll.emision.co/api/v1/service/payrolls/test

Headers

Content-Type: application/json
Accept: application/json
Authorization: Bearer :token

Nota

El texto :token debe ser reemplazado por el token generado en el SSO.

Parameters

type * :

type: string

Tipo de documento emitido. Para nómina Individual debe ser 102.

has_certificate:

type: boolean

Campo para especificar si posee un certificado propio diferente al de proveedor tecnológico.

payroll * :

type: object

Contenido de nómina.

novedad:

type: boolean

default: false. Solo True para un nuevo registro adicional de novedad.

periodo * :

type: object

Contienen los atributos del período de generación del documento.

fecha_ingreso * :

type: string (AAAA-MM-DD)

Fecha de ingreso del trabajador a la empresa.

fecha_retiro:

type: string (AAAA-MM-DD)

Se completa solo si el trabajador se retiró en este período.

fecha_liquidacion_inicio * :

type: string (AAAA-MM-DD)

Fecha de inicio de liquidación de esta nómina.

fecha_liquidacion_fin * :

type: string (AAAA-MM-DD)

Fecha fin de liquidación de esta nómina.

tiempo_laborado * :

type: integer

Tiempo laborado por el trabajador en la compañía expresado en días.

fecha_gen * :

type: string (AAAA-MM-DD)

Fecha de emisión del documento.

numero_secuencia_xml * :

type: object

Datos internos de la compañía que identifican la nómina.

codigo_trabajador:

type: string

Código de identificación del trabajador en la empresa.

prefijo:

type: string

Prefijo de identificación de la nómina.

consecutivo * :

type: integer

Número consecutivo que identifica esta corrida de nómina.

lugar_generacion_xml * :

type: object

Utilizado para atributos de lugar de generación de la nómina.

pais * :

type: String

Código de país donde se generó esta nómina.

Nota

Ver listado en https://endpoint.emision.co/dian-tables/Country.

departamento * :

type: String

Código del departamento donde se generó la nómina.

municipio * :

type: String

Código del municipio donde se generó la nómina.

idioma * :

type: String

Código de idioma

Nota

Ver listado en https://endpoint.emision.co/dian-tables/Language.

proveedor_xml * :

type: object

Utilizado para atributos del proveedor del documento XML.

razon_social:

type: String

Nombre o razón social del proveedor de soluciones tecnológicas.

primer_apellido:

type: String

Primer apellido del proveedor de soluciones tecnológicas.

segundo_apellido:

type: String

Segundo apellido del proveedor de soluciones tecnológicas.

primer_nombre:

type: String

Primer nombre del proveedor de soluciones tecnológicas.

otros_nombres:

type: String

Otros nombres del proveedor de soluciones tecnológicas.

nit * :

type: integer

Nit de la empresa proveedora de soluciones tecnológicas.

dv * :

type: integer

Digito de verificación del NIT.

software_id * :

type: string

Identificador del software asignado por la DIAN.

software_pin * :

type: string

Pin del software asignado en la DIAN.

informacion_general * :

type: object

Utilizado para atributos de informacion general.

ambiente * :

type: integer

Ambiente de trabajo:

1-Producción.

2-Test.

tipo_xml * :

type: String

Para Nómina Individual 102.

fecha_gen * :

type: string (AAAA-MM-DD)

Fecha de generación del documento.

hora_gen * :

type: string (HH:MM:SSdHH:MM)

Hora de generación del documento.

periodo_nomina * :

type: integer

Período de liquidación de nómina en la empresa:

1-semanal

2-Decenal

3-Catorcenal

4-Quincenal

5-Mensual

tipo_moneda * :

type: String

Código del tipo moneda del documento.

Nota

Ver listado en https://endpoint.emision.co/dian-tables/CurrencyType.

trm:

type: integer

Tasa de cambio aplicable al documento según tipo_moneda ingresado.

notas:

type: Array

Notas explicativas o aclaratorias relativo al documento.

empleador * :

type: object

Especifica atributos del empleador o emisor del documento.

razon_social:

type: String

Nombre o razón social del empleador.

primer_apellido:

type: String

Primer apellido del empleador.

segundo_apellido:

type: String

Segundo apellido del empleador.

primer_nombre:

type: String

Primer nombre del empleador.

otros_nombres:

type: String

Otros nombres del empleador.

nit * :

type: integer

Nit de la empresa.

dv * :

type: integer

Digito de verificación del NIT.

pais * :

type: String

Código de país donde se encuentra ubicada la empresa.

Nota

Ver listado en https://endpoint.emision.co/dian-tables/Country.

departamento:

type: String

Código del departamento donde se encuentra ubicada la empresa.

municipio * :

type: String

Código del municipio donde se encuentra ubicada la empresa.

direccion * :

type: String

Dirección física del empleador.

trabajador * :

type: object

Contiene los atributos correspondientes al trabajador.

tipo_trabajador * :

type: integer

Grupo que pertenece el trabajador de acuerdo a la Clasificación PILA.

subtipo_trabajador * :

type: integer

Subgrupo PILA al que pertenece el trabajador.

alto_riesgo * :

type: boolean

Si el trabajador participó en labores de alto riesgo en este período de liquidación.

tipo_documento * :

type: integer

Tipo de identificación del trabajador:

11- Registro civil 12- Tarjeta de identidad 13- Cédula de ciudadanía 21- Tarjeta de extranjería 22- Cédula de extranjería 31- NIT 41- Pasaporte 42- Documento de identificación extranjero 47- PEP 50- NIT de otro país 91- NUIP *

numero_documento * :

type: integer

Número del documento de identificación del trabajador.

primer_apellido * :

type: String

Primer apellido del trabajador.

segundo_apellido * :

type: String

Segundo apellido del trabajador.

primer_nombre * :

type: String

Primer nombre del trabajador.

otros_nombres:

type: String Opcional

Otros nombres del trabajador.

pais_trabajo * :

type: string

Código de país donde se realizó la labor o prestó el servicio.

Nota

Ver listado en https://endpoint.emision.co/dian-tables/Country.

municipio_trabajo * :

type: String

Código del municipio donde se encuentra ubicada la empresa.

direccion_trabajo * :

type: String

Dirección física donde vive el trabajador.

salario_integral * :

type: boolean

Se debe ingresar true si el salario es integral.

tipo_contrato * :

type: integer

Tipo de contrato:

1-Término fijo

2-Término indefinido

3-Obra o Labor

4-Aprendizaje

5-Prácticas

sueldo * :

type: integer

Sueldo base que tiene el trabajador.

codigo_trabajador:

type: String

Código con el cual se identifica al trabajador en la empresa.

pago * :

type: object

Atributos relacionados con el pago.

forma * :

type: integer

Forma como se realiza el pago.

metodo * :

type: integer

Metodo como el que se realiza el pago.

banco:

type: string

Nombre de la entidad bancaria del empleado donde se realiza el pago.

Advertencia

Obligatorio si el metodo de pago es bancario.

tipo_cuenta:

type: string

Si el método de pago se realiza de forma bancaria se debe ingresar.

Advertencia

Obligatorio si el metodo de pago es bancario.

numero_cuenta:

type: String

Si el método de pago se realiza de forma bancaria se debe ingresar.

Advertencia

Obligatorio si el metodo de pago es bancario.

fechas_pago * :

type: array (AAAA-MM-DD)

Fechas en las que se pagó la nómina reportada en este documento.

devengados * :

type: object

Definición de todos los atributos de devengo en este documento.

dias_trabajados * :

type: integer

Días laborados durante el período de pago.

sueldo_trabajado * :

type: integer

Corresponde al sueldo por los días trabajados.

transporte:

type: object Array

Atributos relacionados a viáticos por transporte, alojamiento y manutención.

auxilio:

type: integer

Parte de los viáticos pagados al trabajador para medios de transporte.

aloj_s:

type: integer

Parte de los viáticos pagados para alojamiento - manutención. De carácter salarial.

aloj_ns:

type: integer

Parte de los viáticos pagados para alojamiento - manutención. De carácter no salarial.

heds:

type: object Array

Utilizado para atributos de horas extras diurnas del documento.

hora_inicio:

type: string (YYYY-MM-DDTHH:MM:SS)

Hora de inicio de la hora extra.

hora_fin:

type: string (YYYY-MM-DDTHH:MM:SS)

Hora de fin de la hora extra.

cantidad * :

type: integer

Cantidad de horas extras trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

hens:

type: object Array

Utilizado para atributos de horas extras nocturnas del documento.

hora_inicio:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de inicio de la hora extra.

hora_fin:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de fin de la hora extra.

cantidad * :

type: integer

Cantidad de horas extras trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

hrns:

type: object Array

Utilizado para atributos de horas con recargo nocturno del documento.

hora_inicio:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de inicio de la hora con recargo.

hora_fin:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de fin de la hora con recargo.

cantidad * :

type: integer

Cantidad de horas con recargo trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

heddfs:

type: object Array

Utilizado para atributos de horas extras diurnas dominicales y festivas del documento.

hora_inicio:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de inicio de la hora extra.

hora_fin:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de fin de la hora extra.

cantidad * :

type: integer

Cantidad de horas extras trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

hrddfs:

type: object Array

Utilizado para atributos de horas recargo diurno dominical y festivo del documento.

hora_inicio:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de inicio de la hora con recargo.

hora_fin:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de fin de la hora con recargo.

cantidad * :

type: integer

Cantidad de horas con recargo trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

hendfs:

type: object Array

Utilizado para atributos de horas extras nocturnas dominical y festivo del documento.

hora_inicio:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de inicio de la hora extra.

hora_fin:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de fin de la hora extra.

cantidad * :

type: integer

Cantidad de horas extras trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

hrndfs:

type: object Array

Utilizado para atributos de horas con recargo nocturnas dominicales y festivo del documento.

hora_inicio:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de inicio de la hora con recargo.

hora_fin:

type: string (AAAA-MM-DD HH:MM:SSdHH:MM)

Hora de fin de la hora con recargo.

cantidad * :

type: integer

Cantidad de horas con recargo trabajadas.

pago * :

type: integer

Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente.

vacaciones:

type: object

Atributos de vacaciones remuneradas en tiempo o dinero.

comunes:

type: object Array

Vacaciones remuneradas en tiempo.

fecha_inicio:

type: string (AAAA-MM-DD)

Fecha de inicio del disfrute de las vacaciones, siempre que este dentro del período de este documento.

fecha_fin:

type: string (AAAA-MM-DD)

Fecha fin del disfrute de las vacaciones, siempre que este dentro del período de este documento.

cantidad * :

type: integer

Cantidad de días disfrutados en las vacaciones.

pago * :

type: integer

Valor pagado al trabajador por el descanso remunerado.

compensadas:

type: object Array

Vacaciones no disfrutadas y pagadas.

cantidad * :

type: integer

Número de días que el trabajador estuvo activo durante el mes sin disfrutar sus vacaciones. (Vacaciones NO disfrutadas)

pago * :

type: integer

Corresponde al valor pagado al trabajador, por el descanso remunerado que no disfrutó y que tiene derecho por haber trabajado un determinado tiempo. (Vacaciones NO disfrutadas)

primas:

type: object

Atributos correspondientes a las primas.

cantidad * :

type: integer

Cantidad de días trabajados para el cálculo de la prima.

pago * :

type: integer

Valor pagado por prima legal, considerada salarial.

pago_ns:

type: integer

Valor pagado por prima, considerada no salarial.

cesantias:

type: object

Atributos correspondientes a las cesantías.

pago * :

type: integer

Valor pagado según la ley.

porcentaje * :

type: integer

Porcentaje aplicado para el cálculo de los intereses a las cesantías.

pago_intereses * :

type: integer

Valor pagado por intereses a las cesantías.

incapacidades:

type: object Array

Atributos de las incapacidades laborales.

fecha_inicio:

type: string (AAAA-MM-DD)

Fecha de inicio de la incapacidad, siempre que este dentro del período de este documento.

fecha_fin:

type: string (AAAA-MM-DD)

Fecha fin de la incapacidad, siempre que este dentro del período de este documento.

cantidad * :

type: integer

Cantidad de días de incapacidad.

tipo * :

type: integer

Tipo de incapacidad:

1-Común

2-Profesional

3-Laboral

pago * :

type: integer

Valor pagado por la incapacidad.

licencias:

type: object

Atributos de las licencias remuneradas, no remuneradas y maternidad.

mp:

type: object array

Atributos de licencia por Maternidad Paternidad.

fecha_inicio:

string (AAAA-MM-DD)

Fecha que inicia la licencia.

fecha_fin:

string (AAAA-MM-DD)

Fecha que termina la licencia.

cantidad * :

type: integer

Cantidad de días que el trabajador estuvo inactivo por la licencia.

pago * :

type: integer

Valor pagado por los días de licencia.

r:

type: object array

Atributos de licencia remunerada.

fecha_inicio:

string (AAAA-MM-DD)

Fecha que inicia la licencia.

fecha_fin:

string (AAAA-MM-DD)

Fecha que termina la licencia.

cantidad * :

type: integer

Cantidad de días que el trabajador estuvo inactivo por la licencia.

pago * :

type: integer

Valor pagado por los días de licencia.

nr:

type: object array

Atributos de licencia no remunerada.

fecha_inicio:

string (AAAA-MM-DD)

Fecha que inicia la licencia.

fecha_fin:

string (AAAA-MM-DD)

Fecha que termina la licencia.

cantidad * :

type: integer

Cantidad de días que el trabajador estuvo inactivo por la licencia.

bonificaciones:

type: object Array

Atributos de los valores pagados al trabajador en por incentivo o recompensa.

s:

type: integer

Valor pagado por bonificación salarial.

ns:

type: integer

Valor pagado por bonificación considerada no salarial.

auxilios:

type: object Array

Atributos de los valores pagados al trabajador por beneficios, ayudas o apoyos.

s:

type: integer

Valor pagado por auxilio salarial.

ns:

type: integer

Valor pagado por auxilios considerada no salarial.

huelgas_legales:

type: object Array

Para los días en los que participó el trabajador en huelgas legales.

fecha_inicio:

string (AAAA-MM-DD)

Fecha que inicia la huelga.

fecha_fin:

string (AAAA-MM-DD)

Fecha que termina la huelga.

cantidad * :

type: integer

Cantidad de días que el trabajador estuvo inactivo por la huelga.

otros_conceptos:

type: object Array

Utilizado para otros conceptos de devengos asociados a esta nómina.

descripcion * :

type: String

descripción del concepto que se paga en esta nómina.

s:

type: integer

Valor pagado por otros conceptos considerado salarial.

ns:

type: integer

Valor pagado por otros conceptos considerada no salarial.

compensaciones:

type: object Array

Pago compensatorio como retribución al desempeño en su actividad.

o * :

type: integer

Valor pagado por compensaciones ordinarias.

e * :

type: integer

Valor pagado por compensaciones extraordinarias.

bonos_epctv:

type: object Array

Atributos de forma de pago diferente a dinero en efectivo o consignación bancaria. Son ejemplos bonos electrónicos, recargas, cheques, vales.

s:

type: integer

Se considera de concepto salarial.

ns:

type: integer

Se considera de concepto no salarial.

alimentacion_s:

type: integer

Para alimentación por concepto salarial.

alimentacion_ns:

type: integer

Para alimentación por concepto no salarial.

comisiones:

type integer Array

Valor pagado por comisiones, usualmente del área comercial.

pagos_terceros:

type: integer Array

Beneficios en cabeza del trabajador que se pagan a un tercero.

anticipos:

type: integer Array

Valores pagados por anticipo de Nómina.

dotacion:

type: integer

Valor que el trabajador recibe para compra de vestimenta apropiada de acuerdo al medio laboral.

apoyo:

type: integer

Apoyo económico pagado al aprendiz o practicante universitario.

teletrabajo:

type: integer

Valor pagado por teletrabajo.

bonificacion_retiro:

type: integer

Valor pagado por retiro de la empresa.

indemnizacion:

type: integer

Valor pagado por indemnizar un empleado.

reintegro:

type: integer

Valor que le regresa la empresa al trabajador por una deducción mal realizada en otro pago de nómina.

deducciones:

type: object

Definición de todos los atributos de deducciones en este documento.

salud * :

type: object

Utilizado para los atributos de salud del documento.

porcentaje * :

type: integer

Porcentaje de deducción que paga el trabajador por salud.

deduccion * :

type: integer

Valor pagado correspondiente a salud por parte del trabajador.

fondo_pension * :

type: object

Utilizado para los atributos de pensión del documento.

porcentaje * :

type: integer

Porcentaje de deducción que paga el trabajador por pensión.

deduccion * :

type: integer

Valor pagado correspondiente a pensión por parte del trabajador.

fondo_sp:

type: object

Utilizado para los atributos de los fondo solidaridad pensional y subsistencia del documento.

porcentaje:

type: integer

Porcentaje de deducción que paga el trabajador para fondo solidaridad pensional.

deduccion:

type: integer

Valor pagado correspondiente al fondo de solidaridad pensional por parte del trabajador.

porcentaje_sub:

type: integer

Porcentaje de deducción que paga el trabajador para el fondo de subsistencia.

deduccion_sub:

type: integer

Valor descontado como aporte al fondo de subsistencia por parte del trabajador.

sindicatos:

type: object Array

Utilizado para los atributos de pensión del documento.

porcentaje * :

type: integer

Porcentaje de deducción que paga el trabajador para el sindicato.

deduccion * :

type: integer

Valor pagado correspondiente al sindicato por parte del trabajador.

sanciones:

type: object Array

Utilizado para los atributos de sanciones aplicada por el incumplimiento de una regla o norma de conducta obligatoria.

publica * :

type: integer

Valor pagado por parte del trabajador para cubrir una sanción pública.

privada * :

type: integer

Valor pagado por parte del trabajador para cubrir una sanción privada.

libranzas:

type: object Array

Utilizado para los atributos de libranzas.

descripcion * :

type: string

Descripción de la libranza.

deduccion * :

type: integer

Valor de la cuota deducida para el pago de la cuota de la libranza.

pagos_terceros:

Type: integer Array

Deducciones en cabeza del trabajador que se pagan a un tercero.

anticipos:

Type: integer Array

Deducciones por anticipos a nómina.

otras_deducciones:

Type: integer Array

Valores deducidos de este pago por deducciones diferentes a las anteriormente especificadas.

pension_voluntaria:

Type: integer

Valor que aporta el trabajador a la pensión voluntaria.

retencion_fuente:

Type: integer

Valor deducido para el pago de la retención en el fuente.

afc:

Type: integer

Deducciones por ahorro al fomento a la construcción.

cooperativa:

Type: integer

Cuota que el trabajador paga a la cooperativa.

embargo_fiscal:

Type: integer

Valor descontado de la nómina por embargos fiscales.

plan_complementarios:

Type: integer

Valores descontados para el pago de planes complementarios de salud a los que este afiliado el trabajador.

educacion:

Type: integer

Valor de servicio educativo que el trabajador autorice el descuento.

reintegro:

Type: integer

Valor que le regresa el trabajador a la empresa por una mala liquidación en una nómina anterior.

deuda:

Type: integer

Valor que el trabajador paga por las obligaciones créditos, compensaciones o detrimento económico con la empresa.

redondeo:

Type: integer

Valores válidos para el redondeo de valores en este documentos. Los permitidos son +-2.00.

devengados_total * :

Type: integer

Valor total del la sumatoria de los devengados de este documento.

deducciones_total * :

Type: integer

Valor total del la sumatoria de las deducciones de este documento.

comprobante_total * :

Type: integer

Valor de los devengados menos las deducciones.

Body

Nómina Individual (básico)

Contiene los datos mínimos para generar un documento.

{
        "type": "102",
        "payroll":{
                "periodo":{
                        "fecha_ingreso": "2021-11-01",
                        "fecha_liquidacion_inicio": "2021-11-01",
                        "fecha_liquidacion_fin": "2021-11-30",
                        "tiempo_laborado" : 30,
                        "fecha_gen" : "2021-11-15"
                },
                "numero_secuencia_xml":{
                        "codigo_trabajador":0,
                        "prefijo": "NDX",
                        "consecutivo": "000012"
                },
                "lugar_generacion_xml":{
                        "pais" : "CO",
                        "municipio" : "11001",
                        "idioma": "es"
                },
                "proveedor_xml":{
                        "razon_social": "Nodexum SAS",
                        "nit": "901285179",
                        "dv": "0",
                        "software_id": "d2990645-77fb-496b-b37a-0b102c2303b1",
                        "software_pin": "54321"
                },
                "informacion_general":{
                        "ambiente" : "2",
                        "tipo_xml" : "102",
                        "fecha_gen" : "2021-11-15",
                        "hora_gen" : "19:23:00",
                        "periodo_nomina" : 5,
                        "tipo_moneda" : "COP",
                },
                "empleador":{
                        "razon_social":"Nodexum SAS",
                        "nit":"901285179",
                        "dv":"0",
                        "pais":"CO",
                        "municipio":"11001",
                        "direccion":"Prueba"
                },
                "trabajador":{
                        "tipo_trabajador":"01",
                        "subtipo_trabajador":"01",
                        "alto_riesgo":false,
                        "tipo_documento":"11",
                        "numero_documento":"12345678",
                        "primer_apellido":"Perez",
                        "segundo_apellido":"Sanchez",
                        "primer_nombre":"Pedrito",
                        "otros_nombres":"Alejandro",
                        "pais_trabajo":"CO",
                        "municipio_trabajo":"11001",
                        "direccion_trabajo":"Prueba",
                        "salario_integral":false,
                        "tipo_contrato":"1",
                        "sueldo":10000.00,
                        "codigo_trabajador":0
                },
                "pago":{
                        "forma":"1",
                        "metodo":"10",
                        "banco":"Banco Santander",
                        "tipo_cuenta":"Corriente",
                        "numero_cuenta":"1234-56789"
                },
                "fechas_pago":["2021-11-15"],
                "devengados":{
                        "dias_trabajados": 30,
                        "sueldo_trabajado": 10000.00
                },
                "deducciones":{
                        "salud":{
                                "porcentaje":4,
                                "deduccion":400.00
                        },
                        "fondo_pension":{
                                "porcentaje":4,
                                "deduccion":400.00
                        }
                },
                "devengados_total":10000.00,
                "deducciones_total": 800.00,
                "comprobante_total": 9200.00
        }
}

Responses

Response 200 OK

Si el documento ha superado las validaciones y fue enviado a la DIAN.

{
        "message": "La nómina con ID NODE0014555 se encuentra en proceso de envío ante la DIAN.",
        "id": "NODE0014555"
}

Nota

El elemento id es utilizado para consultar el estado de documento.