Copyright Teleinte SAS 2021 Para mayor información en operaciones@teleinte.com
Nomina - Enviar
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ño
360 Dias
1 Mes
30 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: 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
Email
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
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
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
{
"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 "
}
]
]
}
{
"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.