Copyright Teleinte SAS 2021
Para mayor información en operaciones@teleinte.com
Observación: Información sujeta a cambios

EndPoint


Método: POST

EndPoint:

Pruebas
https://servicios-pruebas.afacturar.com/api/nomina/enviar

Habilitación
https://servicios-habilitacion.afacturar.com/api/nomina/enviar

Producción
https://servicios.afacturar.com/api/nomina/enviar

Seguridad SSL: Afacturar cuenta en sus endpoint con certificados de seguridad (DigiCert SHA2 Extended Validation Server CA), su aplicación debe ser capaz de negociar y validar dicho certificado.

Parámetros de entrada


HEADERS


Accept: application/json

Authorization: Bearer Token asignado a cada cliente


BODY


documento_obligado: Número de identificación del cliente

data: JSON

testSetId: Número entregado en la DIAN para la Habilitación. Este parametro es soló para habilitación


Estructura de JSON de entrada


Nomina


nomina Objeto Requerido

Información de la nomina

Especificación:

novedad Objeto Requerido

Indica si existe alguna Novedad Contractual en el Documento Soporte de Pago de Nómina Electrónica del Trabajador en dicho mes.

Especificación:

es_novedad Boolean Requerido

Describe si la nomina tiene novedad.

Especificación: True o false

cune String Requerido

Debe ir el CUNE del documento al cual se le realizará la novedad contractual

Especificación: Si la nomina tiene novedad se debe indiciar el cune de la nomina que tiene novedad, de lo contrario va en vacio

encabezado Objeto Requerido

Encabezado

Especificación:

fecha_liquidacion_inicio Date Requerido

Fecha de inicio de Liquidación de Nómina 

Especificación: AAAA-MM-DD

fecha_liquidacion_fin Date Requerido

Fecha fin de Liquidación de Nómina 

Especificación: AAAA-MM-DD

fecha_generacion Date Requerido

Fecha de emisión del documento de nómina

Especificación: AAAA-MM-DD

hora_generacion Time Requerido

Hora de emisión del documento de nómina

Especificación: HH24:MM:SS

prefijo String Requerido

Prefijo del documento, depende de las sucursales que posea el Empleador, esté es elegido por el emisor del documento

Especificación:

numero_documento String Requerido

Consecutivo manejado por el Empleador, esté es elegido por el emisor del documento 

Especificación: Mínimo 1 caracter

nota Array Requerido

Observaciones del documento

Especificación: String

periodo_nomina Parametrizado Requerido

Codigo de Periodo de Nómina

Especificación:

1= Semanal

2= Decenal

3= Catorcenal

4= Quincenal

5= Mensual 

6= Otro 

tiempo_laborado String Requerido

Cantidad de Tiempo que lleva laborando el Trabajador en la empresa, para indicar el tiempo laborado, se debe tener en cuenta la siguiente nomenclatura


Calculo Tiempo Laborado Significado
1 Año360 Dias
1 Mes30 Dias

Ejemplo: 5 Años + 3 Meses + 18 Dias => (5*360)+(3*30)+18 => 1908.00

Especificación: Cantidad de dias

pais Parametrizado Requerido

Código dentificador del país. Código alfa-2 asignado al pais

Especificación: Estandar ISO 3166-1. Inf adicional Ver

departamento Parametrizado Requerido

Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado

Especificación: ISO 3166-2:CO. Inf adicional Ver

ciudad Parametrizado Requerido

Código del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

idioma Parametrizado Requerido

Código del idioma donde se genera el documento

Especificación: es- Español castellano. Inf adicional Ver

moneda Parametrizado Requerido

Divisa aplicable a toda la factura

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver

fecha_retiro Date No_requerido

Fecha de retiro del trabajador o aprendiz

Especificación: AAAA-MM-DD

cambio_de_moneda Objeto No_requerido

Cambio de moneda

Especificación:

fecha_cambio Date Requerido

Fecha del cambio de la moneda.

Especificación: Formato AAAA-MM-DD y es requerido si la moneda de origen es diferente de COP

codigo Parametrizado Requerido

La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver. Es requerido si la moneda de origen es diferente de COP

valor_base_trm String-patron Requerido

Tasa de cambio del día de emisión o expedición del documento.

Especificación: Formato #####.##, separador con punto, dos decimales. Es requerido si la moneda de origen es diferente de COP

informacion_trabajador Objeto Requerido

informacion_trabajador

Especificación:

tipo_identificacion Parametrizado Requerido

Tipo de documento de identificación de la empresa o persona

Especificación:

11= Registro civil

12= Tarjeta de identidad

13= Cedula ciudadania

21= Tarjeta de extranjería

22= Cedula de extranjería

31= NIT

41= Pasaporte

42= Documento de identificación extranjero

50= NIT de otro país

91=NUIP

identificacion String Requerido

Número completo de la identificación de la empresa o persona

Especificación: Alfanumérico

correo_electronico Requerido

Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.

Especificación: xxxx@xx.xx;yyyy@yy.yy

numero_movil String No_requerido

Número de móvil para el envio de notificaciones

Especificación: 3111111111

nombre Array Requerido

Nombre del trabajador

Especificación:

primer_nombre String Requerido

Primer nombre

Especificación: Mínimo 3 caracteres

otros_nombres String No_requerido

Otros nombre

Especificación:

primer_apellido String Requerido

Primer apellido

Especificación: Mínimo 3 caracteres

segundo_apellido String Requerido

Segundo apellido

Especificación: Mínimo 3 caracteres

pais Parametrizado Requerido

Código dentificador del país. Código alfa-2 asignado al pais

Especificación: Estandar ISO 3166-1. Inf adicional Ver

nombre_pais String No_requerido

Nombre del país.

Especificación: Estandar ISO 3166-1. Inf adicional Ver

departamento Parametrizado Requerido

Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado

Especificación: ISO 3166-2:CO. Inf adicional Ver

nombre_departamento String No_requerido

Nombre del departamento

Especificación: ISO 3166-2:CO. Inf adicional Ver

ciudad Parametrizado Requerido

Código del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

nombre_ciudad String No_requerido

Nombre del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

direccion String Requerido

Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección

Especificación: Mínimo 10 caracteres

contrato Objeto Requerido

contrato

Especificación:

codigo_trabajador String Requerido

Codigo del Trabajador,  queda a manejo interno del empleador. 

Especificación:

tipo_trabajador Parametrizado Requerido

Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos.

Especificación: Ver

subtipo_trabajador Parametrizado Requerido

Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. Corresponde a una sub clasificación de PILA para conocer en que calidad se realizan las cotizaciones a la seguridad social

Especificación:

00= No aplica

01= Dependiente pensionado por vejez activo

riesgo_pensional Boolean Requerido

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.

Especificación: True o false

tipo_contrato Parametrizado Requerido

Tipo de Contrato que posee el empleado con el Empleador 

Especificación:

1= Termino fijo

2= Termino indefinido

3= Obra o labor

4= Aprendizaje

5= Prácticas o pasantías

fecha_ingreso Date Requerido

Fecha de Ingreso del trabajador a la empresa. Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz presenta ingreso o vinculación a la nómina del reportante. (en caso de tener mas de un ingreso en el mes, se debe reportar la primera fecha en la que se presenta esta novedad en el mes que se esta reportando).

Especificación: AAAA-MM-DD

salario_integral Boolean Requerido

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.

Especificación: True o false

sueldo String-patron Requerido

Valor Base o Sueldo del trabajador según lo estipulado en su contrato. Corresponde al Sueldo Trabajado por los días laborados. Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado, este puede ser fijo o variable de acuerdo a la unidad de tiempo en que las partes hayan acordado el pago, teniendo como base el día o la hora trabajada.

Especificación: Separador con punto, dos decimales

pago Objeto Requerido

pago

Especificación:

fecha Array Requerido

Lista de fecha/s de Pago de la Nómina 

Especificación: AAAA-MM-DD

forma Parametrizado Requerido

Formas de Pago del Documento 

Especificación:

1= Contado

metodo Parametrizado Requerido

Metodos de Pago del Documento 

Especificación:

10 = Efectivo

42 = Consignación bancaria

20 = Cheque

Inf adicional Ver

cuenta_bancaria Array No_requerido

Datos de la entidad bancaria

Especificación:

nombre_banco Alfabético Requerido

Nombre de Entidad Bancaria del Empleado donde se realiza la consignación 

Especificación: Mínimo 3 caracteres

tipo Alfabético Requerido

Tipo de Cuenta Bancaria del Empleado donde se realiza la consignación 

Especificación: Mínimo 1 caracteres

numero Alfabético Requerido

Numero de Cuenta Bancaria del Empleado donde se realiza la consignación 

Especificación: Mínimo 3 caracteres

devengados Objeto Requerido

devengados

Especificación:

basico Objeto Requerido

Atributos Basicos de Devengos del Documento

Especificación:

dias_trabajados Numerico Requerido

Número de días que el trabajador o aprendiz efectivamente estuvo ejecutando sus labores en la empresa. 

Especificación: Separador con punto, dos decimales

sueldo String-patron Requerido

Valor Base o Sueldo del trabajador según lo estipulado en su contrato. Corresponde al Sueldo Trabajado por los días laborados. Corresponde al valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado, este puede ser fijo o variable de acuerdo a la unidad de tiempo en que las partes hayan acordado el pago, teniendo como base el día o la hora trabajada.

Especificación: Separador con punto, dos decimales

auxilio_transporte Objeto No_requerido

Parte de los viáticos pagado al trabajador correspondientes a medios de transporte y/o los gastos de representación.

Especificación:

pago String-patron Requerido

Valor de Auxilio de Transporte que recibe el trabajador por ley, según aplique.  

Especificación: Separador con punto, dos decimales

viaticos Array No_requerido

Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento.

Especificación:

salarial Boolean Requerido

Indica que es salarial o no salarial.

Salarial: Es el pago que recibe periódicamente una persona por la realización de su trabajo.

No salarial: Son acuerdos permitidos por la ley que admiten que el trabajador y la empresa pacten que determinados conceptos y valores no constituyan salario.

 

Especificación: (S) es salarial, (N) no es salarial

pago String-patron Requerido

Valor de Viaticos, Manutención y Alojamiento.  

Especificación: Separador con punto, dos decimales

horas_extra_diurna Array No_requerido

Horas Extras Diarias de Devengos del Documento. La hora extra diurna es la que se trabaja después de terminada jornada laboral ordinaria, y en horas del día de 6am a 9pm con un recargo del 25%.

La jornada laboral ordinaria es la cantidad de horas al día a que se comprometió a laborar el empleado.

El trabajo diurno es el que se desarrolla entre las 6 de la mañana y las 9 de la noche según lo señala el artículo 160 del código sustantivo del trabajo.

 

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Hora Extra Diurna 

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Hora Extra Diurna

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Horas Extra Diurna 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

horas_extra_nocturna Array No_requerido

Horas Extras Nocturnas de Devengos del Documento. Una hora extra nocturna es aquella que se labora adicional a la jornada laboral ordinaria y que además se labora en horario nocturno de 9pm a 6am con un recargo del 75%.

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Hora Extra Nocturna  

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Hora Extra Nocturna 

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Hora Extra Nocturna 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

horas_recargo_nocturno Array No_requerido

Horas Recargo Nocturno de Devengos del Documento. El recargo nocturno es aquel recargo que se paga al trabajador que desarrolla su jornada ordinaria en la noche de 9pm a 6am con un recargo del 35%.

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Horas Recargo Nocturno  

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Horas Recargo Nocturno 

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Horas Recargo Nocturno 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

horas_extra_diurna_dominical_festivo Array No_requerido

Horas Extras Diarias Dominicales y Festivas de Devengos del Documento. La hora extra diurna dominical o festiva se da cuando se cumplen las siguientes condiciones: Se trabaja en un domingo o festivo. Se trabajan más de 8 horas diarias si esa es la jornada ordinaria, el porcentaje de incremento es del 100%

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Horas Extras Diarias Dominicales y Festivas  

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Horas Extras Diarias Dominicales y Festivas 

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Horas Recargo Nocturno 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

horas_recargo_diurno_dominical_festivo Array No_requerido

Horas Recargo Diarias Dominicales y Festivas de Devengos del Documento. El recargo dominical y festivo es aquel recargo al trabajador que por una u otra razón debe laborar un domingo o un festivo. El recargo por trabajar una jornada ordinaria en un domingo o festivo es del 75% sobre la hora ordinaria, por el sólo hecho de trabajar en esos días. Así lo dispone el artículo 179 del código sustantivo del trabajo.

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Horas Recargo Diarias Dominicales y Festivas  

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Horas Recargo Diarias Dominicales y Festivas 

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Horas Recargo Diarias Dominicales y Festivas 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

horas_extra_nocturna_dominical_festivo Array No_requerido

Horas Extras Nocturnas Dominicales y Festivas de Devengos del Documento. La hora extra nocturna dominical o festiva se configura cuando se trabaja en un domingo o festivo, se trabaja tiempo extra o suplementario y el trabajo extra se desarrolla en horario nocturno (9pm – 6am). El porcentaje de incremento es del 150%.

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Horas Extras Nocturna Dominical y Festivos 

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Horas  Extras Nocturna Dominical y Festivos 

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Horas  Extras Nocturna Dominical y Festivos 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

horas_recargo_nocturno_dominical_festivo Array No_requerido

Horas Recargo Nocturno Dominicales y Festivas del Documento. El recargo nocturno es aquel recargo que se paga al trabajador que desarrolla su jornada ordinaria en la noche de 9pm a 6am con un recargo del 110%.

Especificación:

fecha_hora_inicio Date Requerido

Fecha de inicio de Horas  Recargo Nocturno Dominical y Festivos

Especificación: AAAA-MM-DDTHH:MM:SSZ

fecha_hora_fin Date Requerido

Fecha fin de Horas Recargo Nocturno Dominical y Festivos 

Especificación: AAAA-MM-DDTHH:MM:SSZ

cantidad_horas Numerico Requerido

Cantidad de Horas Recargo Nocturno Dominical y Festivos 

Especificación: #

pago String-patron Requerido

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

Especificación: Separador con punto, dos decimales

vacaciones Array No_requerido

Elementos de vacaciones de devengos del documento

Especificación:

tipo Parametrizado Requerido

Codigo del tipo de licencia

Comunes: Tiempo de descanso remunerado, que será de 15 dias habiles consecutivos por cada año de servicio.

Compensadas: La compensación de las vacaciones en dinero ocurre cuando el trabajador no las disfruta a pesar de tener derecho a ello, y en su lugar recibe su equivalente en dinero.

Especificación:

COMUNES

COMPENSADAS

fecha_inicio Date No_requerido

Fecha de inicio del disfrute de vacaciones

Especificación: AAAA-MM-DD

fecha_fin Date No_requerido

Fecha fin del disfrute de vacaciones

Especificación: AAAA-MM-DD

cantidad_dias Numerico Requerido

Número de días que el trabajador estuvo inactivo/activo durante el mes por vacaciones.

Especificación: #

pago String-patron Requerido

Valor Pagado por Vacaciones Disfrutadas o no disfrutadas, dependiendo el tipo comunes o compensadas.

Comunes: Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un determinado tiempo.

Compensadas: Valor Pagado por Vacaciones no disfrutadas. Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un determinado tiempo.

Especificación: Separador con punto, dos decimales

prima Array No_requerido

Pagos por el reconocimiento del logro o cumplimiento por parte del trabajador en el desarrollo de sus labores, de condiciones definidas expresamente entre las partes o el pago al trabajador de forma ocasional y por mera liberalidad o los pactados entre las partes de forma expresa como pago no salarial.

Especificación:

salarial Boolean Requerido

Indica que es salarial o no salarial.

Salarial: Es el pago que recibe periódicamente una persona por la realización de su trabajo.

No salarial: Son acuerdos permitidos por la ley que admiten que el trabajador y la empresa pacten que determinados conceptos y valores no constituyan salario.

 

Especificación: (S) es salarial, (N) no es salarial

cantidad_dias Numerico Requerido

Cantidad de dias trabajados para calculo de Pago de Corte de Prima.

Especificación: #

pago String-patron Requerido

Valor Pagado por Prima

Especificación: Separador con punto, dos decimales

cesantias Objeto No_requerido

Las Cesantías son una prestación social; que el empleador debe pagar a sus trabajadores adicional al salario ordinario. El monto de esta retribución equivale a un mes de salario por cada año trabajado del empleado. Las Cesantías se convierten en un ahorro en caso de que llegues a quedarte sin trabajo o para alcanzar tus objetivos de vivienda y educación.

Especificación:

salario_base_liquidacion String-patron No_requerido

Valor del salario para el calculo de las cesantias

Especificación: Separador con punto, dos decimales

cantidad_dias Numerico Requerido

Cantidad de dias para el calculo de las cesantias

Especificación: #

pago String-patron Requerido

Valor Pagado por Cesantias

Especificación: Separador con punto, dos decimales

intereses_cesantias Objeto No_requerido

El empleador debe pagar a sus trabajadores unos intereses sobre las cesantías que tenga acumuladas a 31 de diciembre.

Especificación:

porcentaje String-patron Requerido

Porcentaje de Interes de Cesantias 

Especificación: Separador con punto, dos decimales

pago String-patron Requerido

Valor Pagado por Intereses de Cesantias 

Especificación: Separador con punto, dos decimales

incapacidades Array No_requerido

Incapacidad laboral la incapacidad que afronta un trabajador para laborar como consecuencia de una enfermedad o un accidente.

Especificación:

fecha_inicio Date Requerido

Fecha de inicio de la incapacidad

Especificación: AAAA-MM-DD

fecha_fin Date Requerido

Fecha fin de la incapacidad

Especificación: AAAA-MM-DD

cantidad_dias Numerico Requerido

Número de días que el trabajador o aprendiz estuvo inactivo por incapacidad (sin importar su origen).

Especificación: #

tipo Parametrizado Requerido

Codigo al cual corresponda el tipo de incapacidad del Empleado

Especificación:

1= Comun

2= Profesional

3= Laboral

pago String-patron Requerido

Valor Pagado por Incapacidad con respecto a Cantidad de Dias 

Especificación: Separador con punto, dos decimales

licencias Array No_requerido

Las licencias laborales son una protección que otorga la ley al trabajador, frente a una enfermedad, cualquiera sea el origen de esta, sea remunerada o no

Especificación:

tipo Parametrizado Requerido

Codigo del tipo de licencia

Especificación:

MP= Maternidad o Paternidad

R= Licencia remunerada

NR= Licencia no remunerada

fecha_inicio Date Requerido

Fecha donde se inicia la licencia

Especificación: AAAA-MM-DD

fecha_fin Date Requerido

Fecha donde termina la licencia

Especificación: AAAA-MM-DD

cantidad_dias Numerico Requerido

Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por el tipo de licencia

Especificación: #

pago String-patron Requerido

Valor Pagado por la licencia 

Especificación: Separador con punto, dos decimales

bonificaciones Array No_requerido

Bonificación es una forma de premio que se da al trabajador, en forma de pago o aumento del valor a pagar, por un determinado propósito. Es algo adicional que se paga al trabajador, generalmente por alcanzar metas o resultados, ya sea individualmente o a nivel colectivo o de empresa.

Especificación:

salarial Boolean Requerido

Indica que es salarial o no salarial.

Salarial: Es el pago que recibe periódicamente una persona por la realización de su trabajo.

No salarial: Son acuerdos permitidos por la ley que admiten que el trabajador y la empresa pacten que determinados conceptos y valores no constituyan salario.

 

Especificación: (S) es salarial, (N) no es salarial

pago String-patron Requerido

Valor Pagado por la bonificación 

Especificación: Separador con punto, dos decimales

auxilios Array No_requerido

Son beneficios, ayudas o apoyos económicos, pagados al trabajador de forma habitual u ocasional o pactados entre las partes.

Especificación:

salarial Boolean Requerido

Indica que es salarial o no salarial.

Salarial: Es el pago que recibe periódicamente una persona por la realización de su trabajo.

No salarial: Son acuerdos permitidos por la ley que admiten que el trabajador y la empresa pacten que determinados conceptos y valores no constituyan salario.

 

Especificación: (S) es salarial, (N) no es salarial

pago String-patron Requerido

Valor Pagado por el auxilio

Especificación: Separador con punto, dos decimales

huelgas_legales Array No_requerido

Es un derecho del que goza todo trabajador colombiano; esta consiste en el cese de actividades y en la implementación de manifestaciones pacíficas como respuesta a un proceso fallido de conciliación entre empleador y empleados que tiene su origen en la violación de derechos o el incumplimiento de beneficios colectivos que inciden en la producción, ocupación u oficio que se está ejecutando.

Especificación:

fecha_inicio Date Requerido

Fecha de inicio de la huelga legalmente declarada

Especificación: AAAA-MM-DD

fecha_fin Date Requerido

Fecha de fin de la huelga legalmente declarada

Especificación: AAAA-MM-DD

cantidad_dias Numerico Requerido

Número de días en los que el trabajador estuvo inactivo por huelga legalmente declarada. 

Especificación: #

otros_conceptos Array No_requerido

Valor  de  los  demás  pagos  fijos  o  variables  realizados  al  trabajador  que  remuneren  en  dinero  o  en  especie  como  contraprestación  directa  del  servicio,  sea cualquiera la forma o denominación que se adopte (Salarial).

Valor de los demás pagos que ocasionalmente y por mera liberalidad recibe el trabajador del empleador, en dinero o en especie no para su beneficio, ni para enriquecer su patrimonio, sino para desempeñar a cabalidad sus funciones (No  Salarial).

Especificación:

descripcion String Requerido

Nombre del Concepto que corresponde a los demás pagos fijos o variables realizados al trabajador que remuneren en dinero o en especie como contraprestación directa del servicio, sea cualquiera la forma o denominación que se adopte.

Especificación:

salarial Boolean Requerido

Indica que es salarial o no salarial.

Salarial: Es el pago que recibe periódicamente una persona por la realización de su trabajo.

No salarial: Son acuerdos permitidos por la ley que admiten que el trabajador y la empresa pacten que determinados conceptos y valores no constituyan salario.

 

Especificación: (S) es salarial, (N) no es salarial

pago String-patron Requerido

Valor  Pagado  por  otros conceptos  

Especificación: Separador con punto, dos decimales

compensaciones Array No_requerido

Suma de dinero definido en el régimen de compensaciones como retribución mensual recibido por el asociado por la ejecución de su actividad material o inmaterial, la cual se fija teniendo en cuenta el tipo de labor desempeñada, el rendimiento o la productividad y la cantidad de trabajo aportado. El monto de la compensación ordinaria podrá ser una suma básica igual para todos los asociados (Ordinaria).

Los demás pagos adicionales a la Compensación Ordinaria que recibe el asociado como retribución por su trabajo, definidos en el régimen de compensaciones (Extraordinaria).

Especificación:

tipo Parametrizado Requerido

Codigo del tipo de compensación

Especificación:

O= Ordinaria

E= Extraordinaria

pago String-patron Requerido

Valor Pagado por compensación

Especificación: Separador con punto, dos decimales

BonoEPCTV Array No_requerido

Bonos Electronicos o de Papel de Servicio, Cheques, Tarjetas, Vales, etc de Devengos del Documento

Especificación:

salarial Boolean Requerido

Indica que es salarial o no salarial.

Salarial: Es el pago que recibe periódicamente una persona por la realización de su trabajo.

No salarial: Son acuerdos permitidos por la ley que admiten que el trabajador y la empresa pacten que determinados conceptos y valores no constituyan salario.

 

Especificación: (S) es salarial, (N) no es salarial

alimentacion Boolean Requerido

Indica que es alimentación o no

Especificación: (S) es alimentación, (N) no es alimentación

pago String-patron Requerido

Valor que el trabajador recibe como concepto salarial / no salarial, por medio de bonos electrónicos, recargas, cheques, vales, es decir todo pago realizado en un medio diferente a dinero en efectivo o consignación de cuenta bancaria. 

Especificación: Separador con punto, dos decimales

comisiones Array No_requerido

Son complementos salariales que se pactan en el contrato, o en cualquier momento de la relación laboral, y que se determinan en función de la realización de un determinado negocio por parte del trabajador y en un periodo concreto, también se presenta como incentivo por el logro de objetivos.

Especificación:

pago String-patron Requerido

Valor Pagado por Comision

Especificación: Separador con punto, dos decimales

pagos_terceros Array No_requerido

Beneficios en cabeza del Trabajador que se pagan a un proveedor o tercero.

Especificación:

pago String-patron Requerido

Valor Pagado por Pago Tercero

Especificación: Separador con punto, dos decimales

anticipos Array No_requerido

Derecho de los empleados que es recogido en el Estatuto de los Trabajadores, en el artículo número 29, en donde se menciona que el trabajador y, con su autorización, sus representantes legales, tendrán derecho a percibir, sin que llegue el día señalado para el pago, anticipos a cuenta del trabajo ya realizado

Especificación:

pago String-patron Requerido

Valor Pagado por anticipo

Especificación: Separador con punto, dos decimales

dotacion Array No_requerido

De conformidad con lo previsto en el artículo 230 del Código Sustantivo del Trabajo, o la norma que lo modifique, adicione o sustituya, corresponde al valor que el empleador dispone para suministrar la dotación de sus trabajadores.

Especificación:

pago String-patron Requerido

Valor Pagado por dotacion

Especificación: Separador con punto, dos decimales

apoyo_sostenimiento Array No_requerido

Pago que el patrocinador realiza de forma mensual como ayuda o apoyo economía al aprendiz o practicante universitario durante su etapa lectiva y fase practica.

Especificación:

pago String-patron Requerido

Valor Pagado por Apoyo a Sostenimiento

Especificación: Separador con punto, dos decimales

teletrabajo Array No_requerido

Valor pagado al trabajador por el uso de recursos tecnológicos de internet en los que incurre el trabajador para desarrollar sus actividades a distancia.

Especificación:

pago String-patron Requerido

Valor Pagado por trabajo en teletrabajo

Especificación: Separador con punto, dos decimales

bonificacion_por_retiro Array No_requerido

Es una suma de dinero acordada entre las partes, empleador y trabajador, con la cual se remunera a los empleados que ejecutan el retiro voluntario de la organización

Especificación:

pago String-patron Requerido

Valor Pagado por Retiro de la empresa

Especificación: Separador con punto, dos decimales

indemnizacion Array No_requerido

Es un pago al cual tiene derecho un trabajador cuando la empresa prescinde de sus servicios.

Especificación:

pago String-patron Requerido

Valor Pagado por Indemnización

Especificación: Separador con punto, dos decimales

reintegro Array No_requerido

Cuando se reintegra un trabajador por orden judicial, significa que el trabajador fue despedido por el empleador, y si en ocasión a ese despido el empleador le pagó una indemnización por despido injustificado al trabajador, este debe reintegrar lo pagado por ese concepto.

Especificación:

pago String-patron Requerido

Valor Pagado correspondiente a Reintegro por parte del empleador

Especificación: Separador con punto, dos decimales

deducciones Objeto Requerido

deducciones

Especificación:

salud Objeto Requerido

El trabajador debe estar afiliado al sistema de salud. La cotización por salud que corresponde al 12.5% de la base del aporte, se hace en conjunto con la empresa. Ésta última aporta el 8.5%, y el empleado debe aportar el 4% restante. Ese 4% es el valor que se debe descontar (deducir) del total devengado a cargo del empleado.

Especificación:

porcentaje String-patron Requerido

Porcentaje que le corresponde al trabajador

Especificación: Separador con punto, dos decimales

deduccion String-patron Requerido

Valor Pagado correspondiente a Salud por parte del trabajador

Especificación: Separador con punto, dos decimales

fondo_pension Objeto Requerido

Los trabajadores que tengan un salario mensual igual o superior a 4 salarios mínimos deben realizar un aporte adicional al sistema de pensiones con destino al fondo de solidaridad pensional.

El fondo de solidaridad pensional es un fondo creado por el artículo 25 de la ley 100 de 1993, que tiene como objetivo subsidiar los aportes de los trabajadores que por su nivel de ingresos no puedan realizar los aportes correspondientes.

Especificación:

porcentaje String-patron Requerido

Porcentaje que le corresponde al trabajador

Especificación: Separador con punto, dos decimales

deduccion String-patron Requerido

Valor Pagado correspondiente a Pension por parte del trabajador

Especificación: Separador con punto, dos decimales

fondo_seguridad_pensional Objeto Requerido

El Fondo de Solidaridad Pensional (FSP) es una cuenta especial de la Nación, que no tiene personería jurídica, adscrita al Ministerio de la Protección Social, destinada a subsidiar las cotizaciones para pensiones de los grupos de población que por sus características y condiciones socioeconómicas no tienen acceso a los Sistemas de Seguridad Social, así como el otorgamiento de subsidios económicos para la protección de las personas en estado de indigencia o de pobreza extrema.

Especificación:

porcentaje String-patron Requerido

Porcentaje que le corresponde al trabajador

Especificación: Separador con punto, dos decimales

deduccion String-patron Requerido

Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador

Especificación: Separador con punto, dos decimales

fondo_subsistencia Objeto Requerido

Es destinada a la protección de las personas en estado de indigencia o de pobreza extrema, mediante un subsidio económico.

El cincuenta por ciento (50%) de la cotización adicional del 1% sobre la base de cotización, a cargo de los afiliados al sistema general de pensiones cuya base de cotización sea igual o superior a cuatro (4) salarios mínimos legales mensuales vigentes.

Especificación:

porcentaje String-patron Requerido

Porcentaje que le corresponde al trabajador

Especificación: Separador con punto, dos decimales

deduccion String-patron Requerido

Valor Pagado correspondiente a Fondo de Solidaridad Pensional por parte del trabajador

Especificación: Separador con punto, dos decimales

sindicatos Array No_requerido

Las cuotas que los trabajadores sindicalizados deben aportar al sindicato al que estén afiliados, y siempre que medie autorización del empleado, se pueden descontar o deducir de la nómina del empleado.

Especificación:

porcentaje String-patron Requerido

Porcentaje que correspondiente a Aportes del Sindicato correspondiente

Especificación: Separador con punto, dos decimales

deduccion String-patron Requerido

Valor Pagado correspondiente a Aportes del Sindicato por parte del trabajador

Especificación: Separador con punto, dos decimales

sanciones Array No_requerido

Las sanciones es una forma en que el empleador busca corregir faltas importantes de un trabajador, ya sea leve o grave, ya que si un empleado ocupa un puesto de trabajo debe cumplir con las responsabilidades que le corresponden con el cargo en que se encuentra.

Especificación:

tipo Parametrizado Requerido

Codigo del tipo de sanción

Especificación:

PRIVADA= Privada u ordinaria

PUBLICA= Publica

deduccion String-patron Requerido

Valor Pagado correspondiente a Sanción

Especificación: Separador con punto, dos decimales

libranzas Array No_requerido

La libranza es una orden o autorización de descuento que el trabajador o contratista libra en favor de la operadora de libranzas, quien es la entidad que concede el crédito al trabajador.

Las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza

Especificación:

descripcion String Requerido

Nombre de la Libranza que corresponda a las cuotas que el empleado deba pagar a una entidad financiera, para la amortización de un crédito que le haya sido otorgado por libranza .

Especificación: Minimo 3 caracteres

deduccion String-patron Requerido

Valor Pagado correspondiente a Aportes a Entidades Financieras por parte del trabajador

Especificación: Separador con punto, dos decimales

pagos_terceros Array No_requerido

Deducciones en cabeza del Trabajador que se pagan a un proveedor o tercero.

Especificación:

deduccion String-patron Requerido

Valor Pagado por Pago Tercero

Especificación: Separador con punto, dos decimales

anticipos Array No_requerido

Los trabajadores que hayan recibido algún anticipo durante el mes.

Especificación:

deduccion String-patron Requerido

Valor Pagado por Anticipo

Especificación: Separador con punto, dos decimales

otras_deducciones Array No_requerido

Las deducciones de nómina son los descuentos o valores que se le restan o deducen al trabajador de su total devengado, es decir, del monto total del salario que recibe en un mes o quincena.

Especificación:

deduccion String-patron Requerido

Valor Pagado por Otra Deducción

Especificación: Separador con punto, dos decimales

pension_voluntaria Objeto No_requerido

Ahorro voluntario que permite acumular un capital con la posibilidad de diversificar en alternativas rentables y flexibles

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente al ahorro que hace el trabajador para complementar su pension obligatoria o cumplir metas especificas.

Especificación: Separador con punto, dos decimales

retencion_fuente Objeto No_requerido

La retención en la fuente no es ningún impuesto, sino que es el simple cobro anticipado de un determinado impuesto que bien puede ser el impuesto de renta, a las ventas o de industria y comercio.

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.

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Retención en la Fuente por parte del trabajador

Especificación: Separador con punto, dos decimales

afc Objeto No_requerido

Ahorro Fomento a la contruccion.Las cuentas de ahorro para el fomento de la construcción (AFC) brindan beneficios tributarios a las personas que las utilizan para adquirir vivienda ¿cómo?, los recursos depositados en estas cuentas no forman parte de la base de retención en la fuente del contribuyente y son rentas exentas del impuesto sobre la renta y complementarios.

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a AFC por parte del trabajador

Especificación: Separador con punto, dos decimales

cooperativa Objeto No_requerido

Las cuotas o aportes que los empleados hagan a las cooperativas legalmente constituidas.

Las personas que se asocian a una cooperativa no son empleados, por consiguiente, no existe ningún vínculo laboral; ni siquiera en las cooperativas de trabajo asociado, donde el trabajador no es más que un socio, y, en consecuencia, no le cobijan muchos de los beneficios laborales que son exclusivos de las personas que tienen un vínculo laboral con alguna empresa o persona natural, que no el caso de un cooperado o socio de una cooperativa.

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Cooperativas por parte del trabajador

Especificación: Separador con punto, dos decimales

embargo_fiscal Objeto No_requerido

Se pueden descontar también de la nómina, el valor que se deba pagar por las obligaciones que el empleado tenga con su empresa, como puede ser un crédito que ésta le haya otorgado, o como compensación por algún perjuicio o detrimento económico que el empleado le haya causado a la empresa.

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Embargos Fiscales por parte del trabajador

Especificación: Separador con punto, dos decimales

plan_complementario Objeto No_requerido

Valor de planes complementarios de salud al que el trabajador se encuentran afiliado, siempre que medie autorización del empleado.

Es un conjunto de servicios adquiridos voluntariamente por cada empleado, que le brinda coberturas no incluidas en el Plan de Beneficios en Salud (PBS) o le permiten tener atención en condiciones de comodidad y tecnología no cubiertas por el PBS

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Planes Complementarios por parte del trabajador

Especificación: Separador con punto, dos decimales

educacion Objeto No_requerido

Valor de servicios educativos que el trabajador autorice descuento.

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Conceptos Educativos por parte del trabajador

Especificación: Separador con punto, dos decimales

reintegro Objeto No_requerido

Valor que le regresa el trabajador a la empresa por un devengo mal realizado en otro pago de nómina

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Reintegro por parte del trabajador

Especificación: Separador con punto, dos decimales

deuda Objeto No_requerido

Valor que se deba pagar por las obligaciones que el empleado tenga con su empresa, como puede ser un crédito que ésta le haya otorgado, o como compensación por algún perjuicio o detrimento económico que el empleado le haya causado a la empresa.

Se pueden descontar también de la nómina, el valor que se deba pagar por las obligaciones que el empleado tenga con su empresa, como puede ser un crédito que ésta le haya otorgado, o como compensación por algún perjuicio o detrimento económico que el empleado le haya causado a la empresa.

Especificación:

deduccion String-patron Requerido

Valor Pagado correspondiente a Deuda con la Empresa por parte del trabajador

Especificación: Separador con punto, dos decimales

valor_nomina Objeto Requerido

valor_nomina

Especificación:

valor_base String-patron Requerido

Sueldo Base que el Trabajdor tiene en la empresa.

Especificación: Separador con punto, dos decimales

valor_total_devengos String-patron Requerido

Valor total de la Suma de todos los Devengados del Documento

Especificación: Separador con punto, dos decimales

valor_total_deducciones String-patron Requerido

Valor total de la Suma de todas las Deducciones del Documento 

Especificación: Separador con punto, dos decimales

valor_total_pago String-patron Requerido

Debe ir el total de: Devengados - Deducciones 

Especificación: Separador con punto, dos decimales

generalidades Objeto Requerido

Información de quien envia la información

Especificación:

tipo_ambiente_dian Parametrizado Requerido

Ambiente de la DIAN al que se destina el documento enviado.

Especificación:

1= Producción

2= Pruebas

version Numerico Requerido

Identificación consecutiva de la especificación

Especificación:

identificador_transmision String Mínimo 5 caracteres

Código único para identificar el paquete transmitido

Especificación:

integrador Objeto Requerido

Información de quien envia la información

Especificación:

nombre Parametrizado Requerido

Nombre de quien realiza la integración

Especificación: S o N

tipo Parametrizado Requerido

Codigo del medio usado para realizar la integración

Especificación:

MOVIL

WEB

DLL

EXCEL

ERP-XXXXXXXXX

webhook String No_requerido

URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.

Especificación: URL con portocolo de seguridad - HTTPS

notificacion Objeto Requerido

Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.

Especificación:

es_automatico Parametrizado Requerido

Indicar si la notificación es enviada de forma automatica

Especificación: S o N

para Requerido

Especificación: xxx@xx.xxx

con_copia No_requerido

Especificación: xxx@xx.xxx

complemento_asunto String No_requerido

Especificación:

Estructura json

							{
	"nomina": [
		{
			"novedad": {
				"es_novedad": "",
				"cune": ""
			},
			"encabezado": {
				"fecha_liquidacion_inicio": "",
				"fecha_liquidacion_fin": "",
				"fecha_generacion": "",
				"hora_generacion": "",
				"prefijo": "",
				"numero_documento": "",
				"nota": [
					""
				],
				"periodo_nomina": "",
				"tiempo_laborado": "",
				"pais": "",
				"departamento": "",
				"ciudad": "",
				"idioma": "",
				"moneda": ""
			},
			"cambio_de_moneda": {
				"fecha_cambio": "",
				"codigo": "",
				"valor_base_trm": ""
			},
			"informacion_trabajador": {
				"tipo_identificacion": "",
				"identificacion": "",
				"correo_electronico": "",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "",
					"otros_nombres": "",
					"primer_apellido": "",
					"segundo_apellido": ""
				},
				"pais": "",
				"nombre_pais": "",
				"departamento": "",
				"nombre_departamento": "",
				"ciudad": "",
				"nombre_ciudad": "",
				"direccion": ""
			},
			"contrato": {
				"codigo_trabajador": "",
				"tipo_trabajador": "",
				"subtipo_trabajador": "",
				"riesgo_pensional": "",
				"tipo_contrato": "",
				"fecha_ingreso": "",
				"salario_integral": "",
				"sueldo": ""
			},
			"pago": {
				"fecha": [
					""
				],
				"forma": "",
				"metodo": "",
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": "",
					"sueldo": ""
				},
				"auxilio_transporte": {
					"pago": ""
				},
				"viaticos": [
					{
						"salarial": "",
						"pago": ""
					}
				],
				"horas_extra_diurna": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"horas_extra_nocturna": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"horas_recargo_nocturno": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"horas_extra_diurna_dominical_festivo": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"horas_recargo_diurno_dominical_festivo": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"horas_extra_nocturna_dominical_festivo": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"horas_recargo_nocturno_dominical_festivo": [
					{
						"fecha_hora_inicio": "",
						"fecha_hora_fin": "",
						"cantidad_horas": "",
						"pago": ""
					}
				],
				"vacaciones": [
					{
						"tipo": "",
						"fecha_inicio": "",
						"fecha_fin": "",
						"cantidad_dias": "",
						"pago": ""
					}
				],
				"prima": [
					{
						"salarial": "",
						"cantidad_dias": "",
						"pago": ""
					},
					{
						"salarial": "",
						"cantidad_dias": "",
						"pago": ""
					}
				],
				"cesantias": {
					"salario_base_liquidacion": "",
					"cantidad_dias": "",
					"pago": ""
				},
				"intereses_cesantias": {
					"porcentaje": "",
					"pago": ""
				},
				"incapacidades": [
					{
						"fecha_inicio": "",
						"fecha_fin": "",
						"cantidad_dias": "",
						"tipo": "",
						"pago": ""
					}
				],
				"licencias": [
					{
						"tipo": "",
						"fecha_inicio": "",
						"fecha_fin": "",
						"cantidad_dias": "",
						"pago": ""
					}
				],
				"bonificaciones": [
					{
						"salarial": "",
						"pago": ""
					}
				],
				"auxilios": [
					{
						"salarial": "",
						"pago": ""
					}
				],
				"huelgas_legales": [
					{
						"fecha_inicio": "",
						"fecha_fin": "",
						"cantidad_dias": ""
					}
				],
				"otros_conceptos": [
					{
						"descripcion": "",
						"salarial": "",
						"pago": ""
					}
				],
				"compensaciones": [
					{
						"tipo": "",
						"pago": ""
					}
				],
				"BonoEPCTV": [
					{
						"salarial": "",
						"alimentacion": "",
						"pago": ""
					}
				],
				"comisiones": [
					{
						"pago": ""
					}
				],
				"pagos_terceros": [
					{
						"pago": ""
					}
				],
				"anticipos": [
					{
						"pago": ""
					}
				],
				"dotacion": [
					{
						"pago": ""
					}
				],
				"apoyo_sostenimiento": [
					{
						"pago": ""
					}
				],
				"teletrabajo": [
					{
						"pago": ""
					}
				],
				"bonificacion_por_retiro": [
					{
						"pago": ""
					}
				],
				"indemnizacion": [
					{
						"pago": ""
					}
				],
				"reintegro": [
					{
						"pago": ""
					}
				]
			},
			"deducciones": {
				"salud": {
					"porcentaje": "",
					"deduccion": ""
				},
				"fondo_pension": {
					"porcentaje": "",
					"deduccion": ""
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "",
					"deduccion": ""
				},
				"fondo_subsistencia": {
					"porcentaje": "",
					"deduccion": ""
				},
				"sindicatos": [
					{
						"porcentaje": "",
						"deduccion": ""
					}
				],
				"sanciones": [
					{
						"tipo": "",
						"deduccion": ""
					}
				],
				"libranzas": [
					{
						"descripcion": "",
						"deduccion": ""
					}
				],
				"pagos_terceros": [
					{
						"deduccion": ""
					}
				],
				"anticipos": [
					{
						"deduccion": ""
					}
				],
				"otras_deducciones": [
					{
						"deduccion": ""
					}
				],
				"pension_voluntaria": [
					{
						"deduccion": ""
					}
				],
				"retencion_fuente": {
					"deduccion": ""
				},
				"afc": {
					"deduccion": ""
				},
				"cooperativa": {
					"deduccion": ""
				},
				"embargo_fiscal": {
					"deduccion": ""
				},
				"plan_complementario": {
					"deduccion": ""
				},
				"educacion": {
					"deduccion": ""
				},
				"reintegro": {
					"deduccion": ""
				},
				"deuda": {
					"deduccion": ""
				}
			},
			"valor_nomina": {
				"valor_base": "",
				"valor_total_devengos": "",
				"valor_total_deducciones": "",
				"valor_total_pago": ""
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 0,
		"identificador_transmision": "",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		},
		"notificacion": {
			"es_automatico": "",
			"para": "",
			"con_copia": "",
			"complemento_asunto": ""
		}
	}
}							

Estructura JSON de respuesta


Salida Exitosa



{
	"codigo_error": 0,
	"descripcion_error": "OK",
	"tiempo_ejecucion": 2.8475100994110109,
	"transaccion": "5e5e5e5e5e55e",
	"resultado": {
		"cune": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"numero_nomina": "S00001",
		"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
		"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
		"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520S00001.xml",
		"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520S00001.xml",
		"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520S00001.xml",
		"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520S00001.pdf"
	},
	"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
	"ErrorMessage_DIAN": ""
}
							  
							 

Salida con errores de semantica



{
    "codigo_error": 400,
    "descripcion_error": "Hay un problema con la informacion entregada",
    "tiempo_ejecucion": 0.01330113410949707,
    "transaccion": "5e74ce82707f6",
    "resultado": [
        {
            "propiedad": "nomina[0].encabezado.periodo_nomina",
            "descripcion": "Does not have a value in the enumeration [1,2,3,4,5]"
        },
        {
            "propiedad": "nomina[0].encabezado.periodo_nomina",
            "descripcion": "Does not have a value in the enumeration [1,2,3,4,5]"
        },
        {
            "propiedad": "nomina[0].encabezado",
            "descripcion": "The property hora_generacio is not defined and the definition does not allow additional properties"
        }
    ],
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": ""
}
						
					  

Salida con errores de datos



{
    "codigo_error": 400,
    "descripcion_error": "Hay problema(s) con la información entregada",
    "resultado": [
        [
            {
                "propiedad": "nomina->valor_nomina-> valor_total_pago ",
                "descripcion": "El valor total del pado es diferente al (valor base + valor devengos) - valor deducciones  "
            }
        ]
    ]
}									
						
						

Salida con errores HTTP



{
	"codigo_error": 500,
	"descripcion_error": "Unauthenticated."
}
						

Salida con error de datos en la DIAN



{
    "codigo_error": 15,
    "descripcion_error": "La validación en la DIAN devuelve error(es)",
    "tiempo_ejecucion": 1.9776690006256104,
    "transaccion": "5e74d144dd565",
    "resultado": {
		"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"numero_nomina": "SETP990001504",
        "url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
        "qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
        "url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
    },
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": ""
}
						

Codigo de respuesta


Cuando usted hace un llamado a la API, puede recibir los siguientes mensajes de error en la respuesta. Puede que haya algo mal con su solicitud o puede que algo esté mal de nuestra parte. Los errores responden con un código de error y JSON que contiene un mensaje, una descripción y un código API más preciso.

Códigos de ERROR


Tabla de Errores
Código Estado Descripción Acción sugerida
28 Timeout La operación duro más de 60 seg
15 Error retornado por la DIAN La información enviada no cumple con el estandar del XML o los valores no estan bien calculados
400 Solicitud incorrecta Hay un problema con su solicitud Compruebe que su solicitud sigue la documentación de la API y utiliza la sintaxis correcta.
401 No autorizado No tiene la autorización necesaria para realizar la solicitud. Asegúrese de estar utilizando una clave API válida con los permisos necesarios para su solicitud.
403 Prohibido El servidor entendió la solicitud, pero se negó a cumplirla. Vea si su plan en Afacturar.com incluye el recurso que está solicitando y su clave API tiene las autorizaciones necesarias.
404 No encontrado El servidor no pudo encontrar el recurso solicitado. Cambie su URL de solicitud para que coincida con un punto final API válido.
405 Método no permitido El recurso no tiene el método especificado. (por ejemplo, PUT en las transmisiones) Cambie el método para seguir la documentación del recurso.
409 Conflicto Un conflicto surgió de su solicitud. (por ejemplo, el OFE no esta asociado al código de autorización) Modificar la carga útil para eliminar el conflicto..
415 Tipo de medio no admitido La solicitud no está en un formato compatible. Verifique que su encabezado Content-Type sea compatible y que su solicitud cumpla con la documentación.
422 Entidad no procesable La solicitud fue sintácticamente correcta pero falló debido a errores semánticos. Asegúrese de que su solicitud incluya todos los campos obligatorios y que sus datos sean válidos.
429 Exceder el límite de envío Se excede el numero de transacciones permitido (120 por minuto). Verifique que se encuentra dentro de los límites acordados con Afacturar.
500 Error de servidor interno Algo salió mal de nuestro lado. Pruebe la solicitud nuevamente más tarde. Si el error no se resuelve, póngase en contacto con el soporte técnico soporte@afacturar.com.
503 Servicio no disponible Estamos experimentando niveles de tráfico más altos de lo normal. Prueba la solicitud nuevamente, ya estamos enterado del problema para aumentar la capacidad.

Nomina ejemplos


Ejemplo 1.

							{
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "2021-01-01",
				"fecha_liquidacion_fin": "2021-01-31",
				"fecha_generacion": "2021-02-10",
				"hora_generacion": "10:00:00",
				"prefijo": "",
				"numero_documento": "1",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "5000.00",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "110001",
				"idioma": "es",
				"moneda": "COP"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33000000",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "Juan",
					"otros_nombres": "Marcos",
					"primer_apellido": "Perez",
					"segundo_apellido": "Perez"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "Bogota",
				"direccion": "Carrera 10 96-29"
			},
			"contrato": {
				"codigo_trabajador": "2020",
				"tipo_trabajador": "01",
				"subtipo_trabajador": "00",
				"riesgo_pensional": false,
				"tipo_contrato": 5,
				"fecha_ingreso": "2005-05-03",
				"salario_integral": "N",
				"sueldo": "4000000.00"
			},
			"pago": {
				"fecha": [
					"2021-02-01"
				],
				"forma": 1,
				"metodo": 45,
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": 30,
					"sueldo": "4000000.00"
				},
				"teletrabajo": [
					{
						"pago": "100000.00"
					}
				]
			},
			"deducciones": {
				"salud": {
					"porcentaje": "4.00",
					"deduccion": "160000.00"
				},
				"fondo_pension": {
					"porcentaje": "4.00",
					"deduccion": "160000.00"
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "0.50",
					"deduccion": "20000.00"
				},
				"fondo_subsistencia": {
					"porcentaje": "0.50",
					"deduccion": "20000.00"
				},
				"libranzas": [
					{
						"descripcion": "Compensar credito de libre inversión",
						"deduccion": "387000.00"
					}
				]
			},
			"valor_nomina": {
				"valor_base": "40000000.00",
				"valor_total_devengos": "4100000.00",
				"valor_total_deducciones": "747000.00",
				"valor_total_pago": "3353000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}							

Ejemplo 2.

							{
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "2021-01-01",
				"fecha_liquidacion_fin": "2021-01-31",
				"fecha_generacion": "2021-02-10",
				"hora_generacion": "10:00:00",
				"prefijo": "",
				"numero_documento": "1",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "5000.00",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "110001",
				"idioma": "es",
				"moneda": "USD"
			},
			"cambio_de_moneda": {
				"fecha_cambio": "2021-03-01",
				"codigo": "COP",
				"valor_base_trm": "2500.00"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33000000",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "Juan",
					"otros_nombres": "Marcos",
					"primer_apellido": "Perez",
					"segundo_apellido": "Perez"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "Bogota",
				"direccion": "Carrera 10 96-29"
			},
			"contrato": {
				"codigo_trabajador": "2020",
				"tipo_trabajador": "01",
				"subtipo_trabajador": "00",
				"riesgo_pensional": false,
				"tipo_contrato": 5,
				"fecha_ingreso": "2005-05-03",
				"salario_integral": "N",
				"sueldo": "1142.00"
			},
			"pago": {
				"fecha": [
					"2021-02-01"
				],
				"forma": 1,
				"metodo": 45,
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": 30,
					"sueldo": "1142.00"
				}
			},
			"deducciones": {
				"salud": {
					"porcentaje": "4.00",
					"deduccion": "45.68"
				},
				"fondo_pension": {
					"porcentaje": "4.00",
					"deduccion": "45.68"
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "0.50",
					"deduccion": "5.71"
				},
				"fondo_subsistencia": {
					"porcentaje": "0.50",
					"deduccion": "5.71"
				}
			},
			"valor_nomina": {
				"valor_base": "1142.00",
				"valor_total_devengos": "1142.00",
				"valor_total_deducciones": "102.78",
				"valor_total_pago": "1039.22.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}							

Ejemplo 3.

							{
	"nomina": [
		{
			"novedad": {
				"es_novedad": false,
				"cune": ""
			},
			"encabezado": {
				"fecha_liquidacion_inicio": "2022-12-01",
				"fecha_liquidacion_fin": "2022-12-31",
				"fecha_generacion": "2022-12-23",
				"hora_generacion": "10:00:00",
				"prefijo": "NE",
				"numero_documento": "258",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "330.00",
				"pais": "CO",
				"departamento": "08",
				"ciudad": "08573",
				"idioma": "es",
				"moneda": "COP"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33000000",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "Juan",
					"otros_nombres": "Marcos",
					"primer_apellido": "Perez",
					"segundo_apellido": "Perez"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "Bogota",
				"direccion": "Carrera 10 96-29"
			},
			"contrato": {
				"codigo_trabajador": "2020",
				"tipo_trabajador": "01",
				"subtipo_trabajador": "00",
				"riesgo_pensional": false,
				"tipo_contrato": 5,
				"fecha_ingreso": "2005-05-03",
				"salario_integral": "N",
				"sueldo": "1300000.00"
			},
			"pago": {
				"fecha": [
					"2022-12-31"
				],
				"forma": 1,
				"metodo": 45,
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": 30.0,
					"sueldo": "1256666.67"
				},
				"auxilio_transporte": {
					"pago": "89832.00"
				},
				"vacaciones": [
					{
						"tipo": "COMPENSADAS",
						"fecha_inicio": "",
						"fecha_fin": "",
						"cantidad_dias": 30.0,
						"pago": "43333.33"
					}
				]
			},
			"deducciones": {
				"salud": {
					"porcentaje": "4.00",
					"deduccion": "72800.00"
				},
				"fondo_pension": {
					"porcentaje": "4.00",
					"deduccion": "72800.00"
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "0.00",
					"deduccion": "0.00"
				},
				"fondo_subsistencia": {
					"porcentaje": "0.00",
					"deduccion": "0.00"
				}
			},
			"valor_nomina": {
				"valor_base": "1300000.00",
				"valor_total_devengos": "1389832.00",
				"valor_total_deducciones": "145600.00",
				"valor_total_pago": "1244232.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}							

Ejemplo 4.

							{
	"nomina": [
		{
			"novedad": {
				"es_novedad": false,
				"cune": ""
			},
			"encabezado": {
				"fecha_liquidacion_inicio": "2022-12-01",
				"fecha_liquidacion_fin": "2022-12-31",
				"fecha_generacion": "2022-12-23",
				"hora_generacion": "10:00:00",
				"prefijo": "NE",
				"numero_documento": "259",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "330.00",
				"pais": "CO",
				"departamento": "08",
				"ciudad": "08573",
				"idioma": "es",
				"moneda": "COP"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33000000",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "Juan",
					"otros_nombres": "Marcos",
					"primer_apellido": "Perez",
					"segundo_apellido": "Perez"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "Bogota",
				"direccion": "Carrera 10 96-29"
			},
			"contrato": {
				"codigo_trabajador": "2020",
				"tipo_trabajador": "01",
				"subtipo_trabajador": "00",
				"riesgo_pensional": false,
				"tipo_contrato": 5,
				"fecha_ingreso": "2005-05-03",
				"salario_integral": "N",
				"sueldo": "1300000.00"
			},
			"pago": {
				"fecha": [
					"2022-12-31"
				],
				"forma": 1,
				"metodo": 45,
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": 29.0,
					"sueldo": "1213333.34"
				},
				"auxilio_transporte": {
					"pago": "89832.00"
				},
				"vacaciones": [
					{
						"tipo": "COMUNES",
						"fecha_inicio": "2022-12-01",
						"fecha_fin": "2022-12-02",
						"cantidad_dias": 2.0,
						"pago": "86666.66"
					}
				]
			},
			"deducciones": {
				"salud": {
					"porcentaje": "4.00",
					"deduccion": "72800.00"
				},
				"fondo_pension": {
					"porcentaje": "4.00",
					"deduccion": "72800.00"
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "0.00",
					"deduccion": "0.00"
				},
				"fondo_subsistencia": {
					"porcentaje": "0.00",
					"deduccion": "0.00"
				}
			},
			"valor_nomina": {
				"valor_base": "1300000.00",
				"valor_total_devengos": "1303165.34",
				"valor_total_deducciones": "145600.00",
				"valor_total_pago": "1157565.34"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}							

Consumo del API


CURL

								curl -X POST \
  https://servicios-pruebas.afacturar.com/api/vp_des/nomina \
  -H 'accept: application/json' \
  -H 'authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIn0.eyJhdWQiOiIxMyIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIiwiaWF0IjoxNTg4MjY5ODY0LCJuYmYiOjE1ODgyNjk4NjQsImV4cCI6MTYxOTgwNTg2NCwic3ViIjoiMTA3NyIsInNjb3BlcyI6W119.dzEvpEWCbZMGIeuTixpUdnvCqE_p_bQEI-3qP-7o6vXV2JzeSrk9Avo-HCjxQD58CUsWdyusa87bEoRthuq2RmdoLRAu7cBKmH_UmJa4iNNZIjZFgGPNzHHNsqf8PUnfGrlC0bvOIpfCoEruP6_AkuHTZ2ToeW8KC1iOg793VrNzJ63co5etpe5cYGkObp9qhGVu00zoGwlzpzyUems9xMj8rJ3g6kOv89p4FlNd9k5-Gn3hceR4oG_PpMnfg0lMMQH55CClXT7Nqj98VrJbE7zLLOOgZbTYYhtXvl9I826OY-5y50UH8b9UQ3npSmXU2y6CPMMrhB32K5XdYjnkLRkO3pYWzkmyRYL6vksOyRSTQX6_2tXDHA0Z0mSlEReo-h2vNv8ptk5unK1BrKIck4YOUwQfv39THhObarIAKvxYleggDs37oyxuGM7kW4lHfkEJGafXINMXHHpqz4Gf3x03oLz3rR4A0iGGK5I-18KzeBt3nAJrwsqmflurlZYPWkmz_IQTuu69FcbrB1X9XQ7Kd6ZPQSrrONAg6MXE_hyjdl_qfzdqp20hBCE1PcNmAsVdk9aMmIglW1lgDaELm71uSX3oIyhW0fGGjKRNAlaxwVYk22i0z4YP_QBjjV4icCTQzOOjVXE0HcKxuqGThjDy315-BM9hETEgfQvUSJE' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -H 'postman-token: 66ddadf8-cf0e-6598-4ae5-e35395aac6ac' \
  -F 'data={
	"nomina": [
		{
			"encabezado": {
				"fecha_liquidacion_inicio": "2021-01-01",
				"fecha_liquidacion_fin": "2021-01-31",
				"fecha_generacion": "2021-02-10",
				"hora_generacion": "10:00:00",
				"prefijo": "",
				"consecutivo": "1",
				"nota": [
					"Nota 1",
					"Nota 2",
					"Nota 3"
				],
				"periodo_nomina": 5,
				"tiempo_laborado": "5000.00",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "110001",
				"idioma": "es",
				"moneda": "COP"
			},
			"informacion_trabajador": {
				"tipo_identificacion": 13,
				"identificacion": "33333333",
				"correo_electronico": "jperez@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"primer_nombre": "Juan",
					"otros_nombres": "Marcos",
					"primer_apellido": "Perez",
					"segundo_apellido": "Perez"
				},
				"pais": "CO",
				"nombre_pais": "Colombia",
				"departamento": "11",
				"nombre_departamento": "Bogota",
				"ciudad": "11001",
				"nombre_ciudad": "Bogota",
				"direccion": "Carrera 10 96-29"
			},
			"contrato": {
				"codigo_trabajador": "2020",
				"tipo_trabajador": "01",
				"subtipo_trabajador": "00",
				"riesgo_pensional": true,
				"tipo_contrato": 5,
				"fecha_ingreso": "2005-05-03",
				"salario_integral": "N",
				"sueldo": "4000000.00"
			},
			"pago": {
				"fecha": [
					"2021-02-01"
				],
				"forma": 1,
				"metodo": 45,
				"cuenta_bancaria": {
					"nombre_banco": "",
					"tipo": "",
					"numero": ""
				}
			},
			"devengados": {
				"basico": {
					"dias_trabajados": 30,
					"sueldo": "4000000.00"
				},
				"teletrabajo": [
					{
						"pago": "100000.00"
					}
				]
			},
			"deducciones": {
				"salud": {
					"porcentaje": "4.00",
					"deduccion": "160000.00"
				},
				"fondo_pension": {
					"porcentaje": "4.00",
					"deduccion": "160000.00"
				},
				"fondo_seguridad_pensional": {
					"porcentaje": "0.50",
					"deduccion": "20000.00"
				},
				"fondo_subsistencia": {
					"porcentaje": "0.50",
					"deduccion": "20000.00"
				},
				"libranzas": [
					{
						"descripcion": "Compensar credito de libre inversión",
						"deduccion": "387000.00"
					}
				]
			},
			"valor_nomina": {
				"valor_base": "40000000.00",
				"valor_total_devengos": "4100000.00",
				"valor_total_deducciones": "747000.00",
				"valor_total_pago": "3353000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"identificador_transmision": "2021-02-18",
		"integrador": {
			"nombre": "",
			"tipo": "",
			"webhook": ""
		}
	}
}' \
  -F documento_obligado=830020470								

C#

								var client = new RestClient("https://servicios-pruebas.afacturar.com/api/vp_des/nomina");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "53f655e3-8f92-62ae-ab14-dc3f89d5bf08");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIn0.eyJhdWQiOiIxMyIsImp0aSI6ImY3M2I5YTA0NjQwMThhNDQ5ZDkxYzQ3YmJjMDZhOGEzOTkxZDY0MWRmODlhYWQ5NTczYzQwZWQ3YzJhMjIxZTE2MTYwM2M2ODA2MDBmZjNjIiwiaWF0IjoxNTg4MjY5ODY0LCJuYmYiOjE1ODgyNjk4NjQsImV4cCI6MTYxOTgwNTg2NCwic3ViIjoiMTA3NyIsInNjb3BlcyI6W119.dzEvpEWCbZMGIeuTixpUdnvCqE_p_bQEI-3qP-7o6vXV2JzeSrk9Avo-HCjxQD58CUsWdyusa87bEoRthuq2RmdoLRAu7cBKmH_UmJa4iNNZIjZFgGPNzHHNsqf8PUnfGrlC0bvOIpfCoEruP6_AkuHTZ2ToeW8KC1iOg793VrNzJ63co5etpe5cYGkObp9qhGVu00zoGwlzpzyUems9xMj8rJ3g6kOv89p4FlNd9k5-Gn3hceR4oG_PpMnfg0lMMQH55CClXT7Nqj98VrJbE7zLLOOgZbTYYhtXvl9I826OY-5y50UH8b9UQ3npSmXU2y6CPMMrhB32K5XdYjnkLRkO3pYWzkmyRYL6vksOyRSTQX6_2tXDHA0Z0mSlEReo-h2vNv8ptk5unK1BrKIck4YOUwQfv39THhObarIAKvxYleggDs37oyxuGM7kW4lHfkEJGafXINMXHHpqz4Gf3x03oLz3rR4A0iGGK5I-18KzeBt3nAJrwsqmflurlZYPWkmz_IQTuu69FcbrB1X9XQ7Kd6ZPQSrrONAg6MXE_hyjdl_qfzdqp20hBCE1PcNmAsVdk9aMmIglW1lgDaELm71uSX3oIyhW0fGGjKRNAlaxwVYk22i0z4YP_QBjjV4icCTQzOOjVXE0HcKxuqGThjDy315-BM9hETEgfQvUSJE");
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
request.AddParameter("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW", "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\n\t\"nomina\": [\n\t\t{\n\t\t\t\"encabezado\": {\n\t\t\t\t\"fecha_liquidacion_inicio\": \"2021-01-01\",\n\t\t\t\t\"fecha_liquidacion_fin\": \"2021-01-31\",\n\t\t\t\t\"fecha_generacion\": \"2021-02-10\",\n\t\t\t\t\"hora_generacion\": \"10:00:00\",\n\t\t\t\t\"prefijo\": \"\",\n\t\t\t\t\"consecutivo\": \"1\",\n\t\t\t\t\"nota\": [\n\t\t\t\t\t\"Nota 1\",\n\t\t\t\t\t\"Nota 2\",\n\t\t\t\t\t\"Nota 3\"\n\t\t\t\t],\n\t\t\t\t\"periodo_nomina\": 5,\n\t\t\t\t\"tiempo_laborado\": \"5000.00\",\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"ciudad\": \"110001\",\n\t\t\t\t\"idioma\": \"es\",\n\t\t\t\t\"moneda\": \"COP\"\n\t\t\t},\n\t\t\t\"informacion_trabajador\": {\n\t\t\t\t\"tipo_identificacion\": 13,\n\t\t\t\t\"identificacion\": \"33700230\",\n\t\t\t\t\"correo_electronico\": \"jperez@teleinte.com\",\n\t\t\t\t\"numero_movil\": \"\",\n\t\t\t\t\"nombre\": {\n\t\t\t\t\t\"primer_nombre\": \"JUan\",\n\t\t\t\t\t\"otros_nombres\": \"Marcos\",\n\t\t\t\t\t\"primer_apellido\": \"Perez\",\n\t\t\t\t\t\"segundo_apellido\": \"Perez\"\n\t\t\t\t},\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"nombre_pais\": \"Colombia\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"nombre_departamento\": \"Bogota\",\n\t\t\t\t\"ciudad\": \"11001\",\n\t\t\t\t\"nombre_ciudad\": \"Bogota\",\n\t\t\t\t\"direccion\": \"Carrera 10 96-29\"\n\t\t\t},\n\t\t\t\"contrato\": {\n\t\t\t\t\"codigo_trabajador\": \"2020\",\n\t\t\t\t\"tipo_trabajador\": \"01\",\n\t\t\t\t\"subtipo_trabajador\": \"00\",\n\t\t\t\t\"riesgo_pensional\": true,\n\t\t\t\t\"tipo_contrato\": 5,\n\t\t\t\t\"fecha_ingreso\": \"2005-05-03\",\n\t\t\t\t\"salario_integral\": \"N\",\n\t\t\t\t\"sueldo\": \"4000000.00\"\n\t\t\t},\n\t\t\t\"pago\": {\n\t\t\t\t\"fecha\": [\n\t\t\t\t\t\"2021-02-01\"\n\t\t\t\t],\n\t\t\t\t\"forma\": 1,\n\t\t\t\t\"metodo\": 45,\n\t\t\t\t\"cuenta_bancaria\": {\n\t\t\t\t\t\"nombre_banco\": \"\",\n\t\t\t\t\t\"tipo\": \"\",\n\t\t\t\t\t\"numero\": \"\"\n\t\t\t\t}\n\t\t\t},\n\t\t\t\"devengados\": {\n\t\t\t\t\"basico\": {\n\t\t\t\t\t\"dias_trabajados\": 30,\n\t\t\t\t\t\"sueldo\": \"4000000.00\"\n\t\t\t\t},\n\t\t\t\t\"teletrabajo\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"pago\": \"100000.00\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t},\n\t\t\t\"deducciones\": {\n\t\t\t\t\"salud\": {\n\t\t\t\t\t\"porcentaje\": \"4.00\",\n\t\t\t\t\t\"deduccion\": \"160000.00\"\n\t\t\t\t},\n\t\t\t\t\"fondo_pension\": {\n\t\t\t\t\t\"porcentaje\": \"4.00\",\n\t\t\t\t\t\"deduccion\": \"160000.00\"\n\t\t\t\t},\n\t\t\t\t\"fondo_seguridad_pensional\": {\n\t\t\t\t\t\"porcentaje\": \"0.50\",\n\t\t\t\t\t\"deduccion\": \"20000.00\"\n\t\t\t\t},\n\t\t\t\t\"fondo_subsistencia\": {\n\t\t\t\t\t\"porcentaje\": \"0.50\",\n\t\t\t\t\t\"deduccion\": \"20000.00\"\n\t\t\t\t},\n\t\t\t\t\"libranzas\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"descripcion\": \"Compensar credito de libre inversión\",\n\t\t\t\t\t\t\"deduccion\": \"387000.00\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t},\n\t\t\t\"valor_nomina\": {\n\t\t\t\t\"valor_base\": \"40000000.00\",\n\t\t\t\t\"valor_total_devengos\": \"4100000.00\",\n\t\t\t\t\"valor_total_deducciones\": \"747000.00\",\n\t\t\t\t\"valor_total_pago\": \"3353000.00\"\n\t\t\t}\n\t\t}\n\t],\n\t\"generalidades\": {\n\t\t\"tipo_ambiente_dian\": 2,\n\t\t\"identificador_transmision\": \"2021-02-18\",\n\t\t\"integrador\": {\n\t\t\t\"nombre\": \"\",\n\t\t\t\"tipo\": \"\",\n\t\t\t\"webhook\": \"\"\n\t\t}\n\t}\n}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"documento_obligado\"\r\n\r\n830020470\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);								

Historico de cambios


Versión Cambios Fecha de liberación
1 Creación del api 2021-04-23