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

Contiene los datos mínimos para generar un documento.

 1{
 2        "type": "102",
 3        "payroll":{
 4                "periodo":{
 5                        "fecha_ingreso": "2021-11-01",
 6                        "fecha_liquidacion_inicio": "2021-11-01",
 7                        "fecha_liquidacion_fin": "2021-11-30",
 8                        "tiempo_laborado" : 30,
 9                        "fecha_gen" : "2021-11-15"
10                },
11                "numero_secuencia_xml":{
12                        "codigo_trabajador":0,
13                        "prefijo": "NDX",
14                        "consecutivo": "000012"
15                },
16                "lugar_generacion_xml":{
17                        "pais" : "CO",
18                        "municipio" : "11001",
19                        "idioma": "es"
20                },
21                "proveedor_xml":{
22                        "razon_social": "Nodexum SAS",
23                        "nit": "901285179",
24                        "dv": "0",
25                        "software_id": "d2990645-77fb-496b-b37a-0b102c2303b1",
26                        "software_pin": "54321"
27                },
28                "informacion_general":{
29                        "ambiente" : "2",
30                        "tipo_xml" : "102",
31                        "fecha_gen" : "2021-11-15",
32                        "hora_gen" : "19:23:00",
33                        "periodo_nomina" : 5,
34                        "tipo_moneda" : "COP",
35                },
36                "empleador":{
37                        "razon_social":"Nodexum SAS",
38                        "nit":"901285179",
39                        "dv":"0",
40                        "pais":"CO",
41                        "municipio":"11001",
42                        "direccion":"Prueba"
43                },
44                "trabajador":{
45                        "tipo_trabajador":"01",
46                        "subtipo_trabajador":"01",
47                        "alto_riesgo":false,
48                        "tipo_documento":"11",
49                        "numero_documento":"12345678",
50                        "primer_apellido":"Perez",
51                        "segundo_apellido":"Sanchez",
52                        "primer_nombre":"Pedrito",
53                        "otros_nombres":"Alejandro",
54                        "pais_trabajo":"CO",
55                        "municipio_trabajo":"11001",
56                        "direccion_trabajo":"Prueba",
57                        "salario_integral":false,
58                        "tipo_contrato":"1",
59                        "sueldo":10000.00,
60                        "codigo_trabajador":0
61                },
62                "pago":{
63                        "forma":"1",
64                        "metodo":"10",
65                        "banco":"Banco Santander",
66                        "tipo_cuenta":"Corriente",
67                        "numero_cuenta":"1234-56789"
68                },
69                "fechas_pago":["2021-11-15"],
70                "devengados":{
71                        "dias_trabajados": 30,
72                        "sueldo_trabajado": 10000.00
73                },
74                "deducciones":{
75                        "salud":{
76                                "porcentaje":4,
77                                "deduccion":400.00
78                        },
79                        "fondo_pension":{
80                                "porcentaje":4,
81                                "deduccion":400.00
82                        }
83                },
84                "devengados_total":10000.00,
85                "deducciones_total": 800.00,
86                "comprobante_total": 9200.00
87        }
88}

Responses

Response 200 OK

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

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

Nota

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