--- title: "Endpoint para emitir una nómina a la DIAN" method: POST path: "/payrolls" tags: ["Nóminas electrónicas"] --- # Endpoint para emitir una nómina a la DIAN `POST /payrolls` Este endpoint permite emitir una nómina electrónica a la DIAN. Recuerda visitar previamente las guías de [Inicio](https://e-provider-docs.alegra.com/docs/gu%C3%ADa-creaci%C3%B3n-de-una-compa%C3%B1%C3%ADa-asociada) y la guía de [Habilitación en la DIAN - Nómina Electronica](https://e-provider-docs.alegra.com/docs/gu%C3%ADa-del-proceso-de-habilitaci%C3%B3n-en-la-dian-n%C3%B3mina-electr%C3%B3nica) ## Request body - object - `company` object — Objeto con información de la empresa con la que se desea emitir la nómina electrónica. Este atributo es opcional, sino se envia este objeto, Alegra tomará la compañía asociada al token de autenticación - `id` string, required — Id de la empresa - `prefix` string — Prefijo de la nómina electrónica - `number` number, double, required — Número de la nómina electrónica - `governmentData` object, required — Objeto que contiene la información de la nómina electrónica en formato JSON según el estándar de la DIAN - `Novedad` object — Objeto con la información del documento que presenta la novedad - `CUNENov` string — Cune del documento que presenta la novedad - `Periodo` object, required — Objeto con la información del periodo de nómina que se desea emitir - `FechaIngreso` string, date, required — 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). - `TiempoLaborado` number — Cantidad de Tiempo en días que lleva laborando el Trabajador en la empresa - `FechaRetiro` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz presenta retiro de la nómina del reportante.(en caso de tener mas de un retiro en el mes, se debe reportar la ultima fecha en la que se presenta esta novedad en el mes que se esta reportando). - `FechaLiquidacionInicio` string, date, required — Fecha de inicio de Liquidación de Nómina - `FechaLiquidacionFin` string, date, required — Fecha fin de Liquidación de Nómina - `LugarGeneracionXML` object, required — Objeto con la información del lugar de generación del documento - `Pais` string — Codigo del país donde se genera el documento. Se debe colocar el Codigo que corresponda de la tabla de países de la DIAN - `MunicipioCiudad` string, required — Código del municipio o ciudad donde se genera el documento. Se debe colocar el Codigo que corresponda de la tabla de municipios de la DIAN - `InformacionGeneral` object, required — Objeto con la información general del documento - `PeriodoNomina` string, required — Corresponde al Codigo de Periodo de Nómina. Se debe colocar el Codigo que corresponda de la tabla de periodos de nómina de la DIAN - `TipoMoneda` string, required — Tipo de Moneda utilizada en el documento. Se debe colocar el Codigo que corresponda de la tabla de monedas de la DIAN - `TRM` number, float — Tasa Representativa del mercado. Corresponde a la tasa de cambio de la moneda utilizada en el documento en el Campo “TipoMoneda” a Pesos Colombianos. - `Notas` string — Campo de libre uso para Observaciones en el documento - `Empleador` object, required — Objeto con la información del empleador - `RazonSocial` string — Debe corresponder al Nombre de la Razón Social del Empleador - `PrimerApellido` string — Primer Apellido del empleador - `SegundoApellido` string — Segundo Apellido del empleador - `PrimerNombre` string — Primer Nombre del empleador - `OtrosNombres` string — Otros Nombres del empleador - `NIT` number, double, required — Debe corresponder al NIT del Empleador que realiza el documento, sin guiones ni DV - `DV` number, double, required — Debe corresponder al DV del NIT del Empleador que realiza el documento - `Pais` string, required — Código del país donde se encuentra ubicada la empresa del empleador en el mes que se esta reportando. Se debe colocar el Codigo que corresponda de la tabla de paises de la DIAN - `MunicipioCiudad` string, required — Código del municipio o ciudad donde se encuentra ubicada la empresa del empleador en el mes que se esta reportando. Se debe colocar el Codigo que corresponda de la tabla de municipios de la DIAN - `Direccion` string, required — Debe corresponder a la dirección del lugar físico de expedición del documento. - `Trabajador` object, required — Objeto con la información del trabajador - `TipoTrabajador` string, required — Código del tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. Se debe colocar el Codigo que corresponda de la tabla de tipos de trabajador de la DIAN - `SubTipoTrabajador` string, required — Código del Sub tipo de trabajador del Ministerio de salud. Aportes a Seguridad Social de Activos. Se debe colocar el Codigo que corresponda de la tabla de subtipos de trabajador de la DIAN - `AltoRiesgoPension` boolean, required — 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. - `TipoDocumento` string, required — Tipo de documento de identificación que actualmente tiene el trabajador, aprendiz, o pasante. Se debe colocar el Codigo que corresponda de la tabla de tipos de identificación de la DIAN - `NumeroDocumento` number, required — Numero de identificación que actualmente el trabajador o aprendiz - `PrimerApellido` string, required — Primer Apellido del trabajador o aprendiz - `SegundoApellido` string — Segundo Apellido del trabajador o aprendiz - `PrimerNombre` string, required — Primer Nombre del trabajador o aprendiz - `OtrosNombres` string — Otros Nombres del trabajador o aprendiz - `LugarTrabajoPais` string — Código del país actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. Se debe colocar el Codigo del país - `LugarTrabajoMunicipioCiudad` string, required — Código del municipio o ciudad actual donde se encontraba ubicado el trabajador o aprendiz en el mes reportado. Se debe colocar el Codigo que corresponda de la tabla de municipios de la DIAN - `LugarTrabajoDireccion` string, required — Debe corresponder a la dirección del lugar físico donde vive el empleado. - `SalarioIntegral` boolean, required — 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. - `TipoContrato` string, required — Tipo de Contrato que posee el empleado con el Empleador. Se debe colocar el Codigo que corresponda de la tabla de tipos de contratos de la DIAN - `Sueldo` number, float, required — 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. - `CodigoTrabajador` string — Codigo del Trabajador - `Pago` object, required — Objeto con la información del pago del documento - `Forma` string, required — Formas de Pago del Documento. Se debe colocar el Codigo que corresponda de la tabla de formas de pago de la DIAN - `Metodo` string, required — Metodos de Pago del Documento. Se debe colocar el Codigo que corresponda de la tabla de métodos de pago de la DIAN - `Banco` string — Si el método de pago se realiza de forma bancaria. Se debe colocar el nombre de la entidad bancaria donde el trabajador tiene su cuenta para pago de nómina. - `TipoCuenta` string — Tipo de Cuenta Bancaria del Empleado donde se realiza la consignación - `NumeroCuenta` string — Numero de Cuenta Bancaria del Empleado donde se realiza la consignación - `FechasPagos` object, required — Objeto con la información de fechas de pago del documento - `FechaPago` string[], required — Array con fechas de Pago de la Nómina - `Devengados` object, required — Objeto con la información de los devengados del documento - `Basico` object, required — Objeto con la información basica de los devengados - `DiasTrabajados` number, required — Número de días que el trabajador o aprendiz efectivamente estuvo ejecutando sus labores en la empresa. - `SueldoTrabajado` number, float, required — 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. - `Transporte` object[] — Array con información sobre devengados por concepto de transporte - `AuxilioTransporte` number, float — Parte de los viáticos pagado al trabajador correspondientes a medios de transporte y/o los gastos de representación. - `ViaticoManuAlojS` number, float — Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento. - `ViaticoManuAlojNS` number, float — Parte de los viáticos pagado al trabajador correspondientes a manutención y/o alojamiento No Salariales. - `HEDs` object — Objeto con la información devengada por concepto de horas extras diarias - `HED` object[], required — Array con información sobre devengados por concepto de horas extras diarias - `HoraInicio` string, date-time — Hora de inicio de Hora Extra Diurna - `HoraFin` string, date-time — Hora de fin de Hora Extra Diurna - `Cantidad` number, required — Cantidad de Horas Extra Diurna - `Porcentaje` '1', required — Porcentaje al cual corresponde el calculo de 1 hora Extra Diurna. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `HENs` object — Objeto con la información devengada por concepto de horas extras nocturnas - `HEN` object[], required — Array con información sobre devengados por concepto de horas extras nocturnas - `HoraInicio` string, date-time — Hora de inicio de Hora Extra Nocturna - `HoraFin` string, date-time — Hora de fin de Hora Extra Nocturna - `Cantidad` number, required — Cantidad de Horas Extra Nocturna - `Porcentaje` '2', required — Porcentaje al cual corresponde el calculo de 1 hora Extra Nocturna. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `HRNs` object — Objeto con la información devengada por concepto de horas recargo nocturno - `HRN` object[], required — Array con información sobre devengados por concepto de horas recargo nocturno - `HoraInicio` string, date-time — Hora de inicio de Hora Recargo Nocturno - `HoraFin` string, date-time — Hora de fin de Hora Recargo Nocturno - `Cantidad` number, required — Cantidad de Horas Recargo Nocturno - `Porcentaje` '3', required — Porcentaje al cual corresponde el calculo de 1 hora Recargo Nocturno. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `HEDDFs` object — Objeto con la información devengada por concepto de horas extras diarias dominicales y festivas - `HEDDF` object[], required — Array con información sobre devengados por concepto de horas extras diarias dominicales y festivas - `HoraInicio` string, date-time — Hora de inicio de Horas Extras Diurnas Dominical y Festivos - `HoraFin` string, date-time — Hora de fin de Horas Extras Diurnas Dominical y Festivos - `Cantidad` number, required — Cantidad de Horas Extras Diurnas Dominical y Festivos - `Porcentaje` '4', required — Porcentaje al cual corresponde el calculo de 1 hora Extras Diurnas Dominical y Festivo. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `HRDDFs` object — Objeto con la información devengada por concepto de horas recargo diarias dominicales y festivas - `HRDDF` object[], required — Array con información sobre devengados por concepto de horas recargo diarias dominicales y festivas - `HoraInicio` string, date-time — Hora de inicio de Horas Recargo Diurnas Dominical y Festivos - `HoraFin` string, date-time — Hora de fin de Horas Recargo Diurnas Dominical y Festivos - `Cantidad` number, required — Cantidad de Horas Recargo Diurnas Dominical y Festivos - `Porcentaje` '5', required — Porcentaje al cual corresponde el calculo de 1 hora Recargo Diurnas Dominical y Festivo. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `HENDFs` object — Objeto con la información devengada por concepto de horas extras nocturnas dominicales y festivas - `HENDF` object[], required — Array con información sobre devengados por concepto de horas extras nocturnas dominicales y festivas - `HoraInicio` string, date-time — Hora de inicio de Horas Extras Nocturnas Dominical y Festivos - `HoraFin` string, date-time — Hora de fin de Horas Extras Nocturnas Dominical y Festivos - `Cantidad` number, required — Cantidad de Horas Extras Nocturnas Dominical y Festivos - `Porcentaje` '6', required — Porcentaje al cual corresponde el calculo de 1 hora Extras Nocturnas Dominical y Festivo. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `HRNDFs` object — Objeto con la información devengada por concepto de horas recargo nocturno dominicales y festivas - `HRNDF` object[], required — Array con información sobre devengados por concepto de horas recargo nocturno dominicales y festivas - `HoraInicio` string, date-time — Hora de inicio de Horas Recargo Nocturno Dominical y Festivos - `HoraFin` string, date-time — Hora de fin de Horas Recargo Nocturno Dominical y Festivos - `Cantidad` number, required — Cantidad de Horas Recargo Nocturno Dominical y Festivos - `Porcentaje` '7', required — Porcentaje al cual corresponde el calculo de 1 hora Recargo Nocturno Dominical y Festivo. Se debe colocar el Porcentaje que corresponda de la tabla de la DIAN para tipos de horas extra - `Pago` number, float, required — Es el valor pagado por el tiempo que se trabaja adicional a la jornada legal o pactada contractualmente. - `Vacaciones` object — Objeto con la información devengada por concepto de vacaciones - `VacacionesComunes` object[] — Array con información sobre devengados por concepto de vacaciones comunes - `FechaInicio` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador presenta el inicio del disfrute de sus vacaciones en tiempo. - `FechaFin` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador regresa o termina el disfrute de sus vacaciones. - `Cantidad` number, required — Número de días que el trabajador estuvo inactivo durante el mes por vacaciones - `Pago` number, float, required — Corresponde al valor pagado al trabajador, por el descanso remunerado que tiene derecho por haber trabajado un determinado tiempo. (Vacaciones SI disfrutadas) - `VacacionesCompensadas` object[] — Array con información sobre devengados por concepto de vacaciones compensadas - `Cantidad` number, required — Número de días que el trabajador estuvo activo durante el mes sin disfrutar sus vacaciones. (Vacaciones NO disfrutadas) - `Pago` number, float, required — Corresponde al valor pagado al trabajador, por el descanso remunerado que no disfrutó y que tiene derecho por haber trabajado un determinado tiempo. (Vacaciones NO disfrutadas) - `Primas` object — Objeto con información sobre devengados por concepto de primas - `Cantidad` number, required — Cantidad de dias trabajados para calculo de Pago de Corte de Prima - `Pago` number, float, required — Valor Pagado por Prima Legal con respecto a Cantidad de Dias - `PagoNS` number, float — Valor Pagado por Prima No Salarial - `Cesantias` object — Objeto con información sobre devengados por concepto de cesantías - `Pago` number, float, required — Valor Pagado por Cesantias - `Porcentaje` number, float, required — Porcentaje que corresponde al Interes de Cesantia de Ley - `PagoIntereses` number, float, required — Pago de los Intereses de Cesantia otorgada por Ley. - `Incapacidades` object — Objeto con la información devengada por concepto de incapacidades - `Incapacidad` object[] — Array con información sobre devengados por concepto de incapacidades - `FechaInicio` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador presenta o da por iniciada su Incapacidad. - `FechaFin` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador presenta o da por terminada su Incapacidad. - `Cantidad` number, required — Número de días que el trabajador o aprendiz estuvo inactivo por incapacidad (sin importar su origen). - `Tipo` number, float, required — Se debe indicar el codigo al cual corresponda el tipo de incapacidad del Empleado. Se debe colocar el Codigo que corresponda de la tabla de tipos de incapacidades de la DIAN - `Pago` number, float, required — Valor de la prestación económica pagada al trabajador por consecuencia de la falta de capacidad laboral sin importar su origen. - `Licencias` object — Objeto con la información devengada por concepto de licencias - `LicenciaMP` object[] — Array con información sobre devengados por concepto de licencias de maternidad - `FechaInicio` string, date — Fecha donde da inicio la Licencia de Maternidad o Paternidad - `FechaFin` string, date — Fecha donde termina la Licencia de Maternidad o Paternidad - `Cantidad` number, required — Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por licencia de maternidad o paternidad. - `Pago` number, float, required — Valor pagado al trabajador del descanso remunerado que la ley confiere por el nacimiento de un hijo, y que es reconocido y pagado por la EPS a la que está afiliado el padre o la madre, o en su defecto por el empleador. - `LicenciaR` object[] — Array con información sobre devengados por concepto de licencias remuneradas - `FechaInicio` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz inicia algún permiso o licencia remunerada. - `FechaFin` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz termina el permiso o licencia remunerada. - `Cantidad` number, required — Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por permiso o licencia pero que le fueron reconocidos en su pago. - `Pago` number, float, required — Valor pagado al trabajador corresponde a tiempo no laborado, que por ley o por acuerdo con el empleador se le concede - `LicenciaNR` object[] — Array con información sobre devengados por concepto de licencias no remuneradas - `FechaInicio` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz inicia alguna suspensión, permiso o licencia NO remunerada. - `FechaFin` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador o aprendiz termina la suspensión, permiso o licencia NO remunerada. - `Cantidad` number, required — Número de días que el trabajador o aprendiz efectivamente estuvo inactivo por suspensión, permiso o licencia y que NO le fueron reconocidos en su pago. - `Bonificaciones` object — Objeto con la información devengada por concepto de bonificaciones - `Bonificacion` object[] — Array con información sobre devengados por concepto de bonificaciones - `BonificacionS` number, float — Son valores pagados al trabajador en forma de incentivo o recompensa por la contraprestación directa del servicio. - `BonificacionNS` number, float — Son valores de incentivos pagados al trabajador de forma ocasional y por mera liberalidad o los pactados entre las partes de forma expresa como pago no salarial. - `Auxilios` object — Objeto con la información devengada por concepto de auxilios - `Auxilio` object[] — Array con información sobre devengados por concepto de auxilios - `AuxilioS` number, float — Son beneficios, ayudas o apoyos económicos, pagados al trabajador de forma habitual o pactados entre las partes como factor salarial. - `AuxilioNS` number, float — Son beneficios, ayudas o apoyos económicos, pagados al trabajador de forma ocasional y por mera liberalidad o los pactados entre las partes de forma expresa como pago no salarial. - `HuelgasLegales` object — Objeto con la información devengada por concepto de huelgas legales - `HuelgaLegal` object[] — Array con información sobre devengados por concepto de huelgas legales - `FechaInicio` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador inicia la huelga legalmente declarada. - `FechaFin` string, date — Este dato se debe diligenciar solamente en el registro del mes en que el trabajador termina la huelga legalmente declarada. - `Cantidad` number, required — Número de días en los que el trabajador estuvo inactivo por huelga legalmente declarada. - `OtrosConceptos` object — Objeto con la información devengada por otros conceptos - `OtroConcepto` object[] — Array con información sobre devengados por otros conceptos - `DescripcionConcepto` string, required — 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. - `ConceptoS` number, float — 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). - `ConceptoNS` number, float — 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). - `Compensaciones` object — Objeto con la información devengada por concepto de compensaciones - `Compensacion` object[] — Array con información sobre devengados por concepto de compensaciones - `CompensacionO` number, float, required — 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). - `CompensacionE` number, float, required — 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). - `BonoEPCTVs` object — Objeto con la información devengada por concepto de Bonos Electronicos o de Papel de Servicio, Cheques, Tarjetas, Vales, etc - `BonoEPCTV` object[] — Array con información sobre devengados por concepto de Bonos Electronicos o de Papel de Servicio, Cheques, Tarjetas, Vales, etc - `PagoS` number, float — Valor que el trabajador recibe como contraprestación por el trabajo realizado, 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 (Salarial). - `PagoNS` number, float — Valor que el trabajador recibe como concepto 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 (No Salarial). - `PagoAlimentacionS` number, float — Valor que el trabajador recibe como concepto 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 (Para Alimentación Salarial). - `PagoAlimentacionNS` number, float — Valor que el trabajador recibe como concepto 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 (Para Alimentación No Salarial). - `Comisiones` object — Objeto con la información devengada por concepto de comisiones - `Comision` number[] — Array con información sobre devengados por concepto de comisiones - `PagosTerceros` object — Objeto con la información devengada por concepto de pagos a terceros - `PagoTercero` number[] — Array con información sobre devengados por concepto de pagos a terceros - `Anticipos` object — Objeto con la información devengada por concepto de anticipos - `Anticipo` number[] — Array con información sobre devengados por concepto de anticipos - `Dotacion` number, float — 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. - `ApoyoSost` number, float — Corresponde al valor no salarial que el patrocinador paga de forma mensual como ayuda o apoyo economía al aprendiz o practicante universitario durante su etapa lectiva y fase practica. - `Teletrabajo` number, float — Valor que debe ser pagado al trabajador cuyo contrato indica expresamente que puede laborar mediante teletrabajo - `BonifRetiro` number, float — Valor establecido por mutuo acuerdo por retiro del Trabajador - `Indemnizacion` number, float — Valor de Indemnizacion establecido por ley - `Reintegro` number, float — Valor que le regresa la empresa al trabajador por una deducción mal realizada en otro pago de nomina - `Deducciones` object, required — Objeto con la información de las deducciones del documento - `Salud` object, required — Objeto con información sobre deducciones por conceptos de salud - `Porcentaje` number, required — Debe corresponder al porcentaje de deducción de salud que paga el trabajador - `Deduccion` number, float, required — 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. - `FondoPension` object, required — Objeto con información sobre deducciones por conceptos de fondos de pensión - `Porcentaje` number, required — Debe corresponder al porcentaje de deducción de fondo de pensión que paga el trabajador - `Deduccion` number, float, required — El trabajador también debe estar afiliado al sistema de pensiones. La cotización por pensión está a cargo tanto de la empresa como del empleado. Del total del aporte (16%), la empresa aporta el 75% (12%) y el trabajador aporta el restante 25% (4%). Como el trabajador debe aportar un 4% por concepto de pensión, este valor se le descuenta (deduce) del valor devengado en el respectivo periodo (mes o quincena). - `FondoSP` object — Objeto con información sobre deducciones por conceptos de fondos de seguridad pensional - `Porcentaje` number — Debe corresponder al porcentaje de deducción de fondo de seguridad pensional que paga el trabajador - `DeduccionSP` number, float — Todo trabajador que devengue un sueldo que sea igual o superior a 4 salarios mininos, debe aportar un 1% al Fondo de solidaridad pensional. - `PorcentajeSub` number, float — Se debe colocar el Porcentaje que correspondiente al Fondo de Subsistencia correspondiente - `DeduccionSub` number, float — Valor Pagado correspondiente a Fondo de Subsistencia por parte del trabajador - `Sindicatos` object — Objeto con la información de deducciones por concepto de sindicatos - `Sindicato` object[] — Array con información sobre deducciones por concepto de sindicatos - `Porcentaje` number, required — Porcentaje establecido en la ley o por estatutos del sindicato. - `Deduccion` number, float, required — Las cuotas que los trabajadores sindicalizados deben aportar al sindicato al que estén afiliados, y siempre que medie autorización del empleado - `Sanciones` object — Objeto con la información de deducciones por concepto de sanciones - `Sancion` object[] — Array con información sobre deducciones por concepto de sanciones - `SancionPublic` number, required — Valor por el del incumplimiento de una regla o norma de conducta obligatoria (Publica) - `SancionPriv` number, float, required — Valor por el del incumplimiento de una regla o norma de conducta obligatoria (Privada o Ordinaria) - `Libranzas` object — Objeto con la información de deducciones por concepto de libranzas - `Libranza` object[] — Array con información sobre deducciones por concepto de libranzas - `Descripcion` string, required — 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 - `Deduccion` number, float, required — 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 - `PagosTerceros` object — Objeto con la información de deducciones por concepto de pagos a terceros - `PagoTercero` number[] — Array con información sobre deducciones por concepto de pagos a terceros - `Anticipos` object — Objeto con la información de deducciones por concepto de anticipos - `Anticipo` number[] — Array con información sobre deducciones por concepto de anticipos - `OtrasDeducciones` object — Objeto con la información de deducciones por concepto de otras deducciones - `OtraDeduccion` number[] — Array con información sobre deducciones por concepto de otras deducciones - `PensionVoluntaria` number, float — Valor correspondiente al ahorro que hace el trabajador para complementar su pension obligatoria o cumplir metas especificas. - `RetencionFuente` number, float — Si hubiere lugar, la empresa deberá calcular y retener al empleado el valor correspondiente a retención en la fuente por ingresos laborales. Este valor será declarado y consignado en la respectiva declaración mensual de retención en la fuente. - `AFC` number, float — Corresponde a (Ahorro Fomento a la contruccion) - `Cooperativa` number, float — Las cuotas o aportes que los empleados hagan a las cooperativas legalmente constituidas - `EmbargoFiscal` number, float — Los embargos ordenados por autoridad judicial competente contra los empleados deben ser descontados de la nómina por la empresa y consignarlos en la cuenta que el juez haya ordenado. - `PlanComplementarios` number, float — Valor de planes complementarios de salud al que el trabajador se encuentran afiliado, siempre que medie autorización del empleado. - `Educacion` number, float — Valor de servicios educativos que el trabajador autorice descuento. - `Reintegro` number, float — Valor que le regresa el trabajador a la empresa por un devengo mal realizado en otro pago de nómina - `Deuda` number, float — 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. - `Redondeo` number, float — Se utiliza para cuando se utilice el Redondeo en el Documento, Definido en el numeral 1.1.1 - `DevengadosTotal` number, float, required — Valor total de la Suma de todos los Devengados del Documento - `DeduccionesTotal` number, float, required — Valor total de la Suma de todas las Deducciones del Documento - `ComprobanteTotal` number, float, required — Debe ir el total de: Devengados - Deducciones ## Response `200` Objeto que representa la respuesta cuando se envía una nómina electrónica a la DIAN - object - `emission` object - `id` string — Id de nómina electrónica - `idReference` string — Id de nómina electrónica de referencia afectada por la nómina electrónica actual, se utiliza para nóminas de reemplazo y anulación - `date` string, date-time — Fecha de emisión de nómina electrónica - `status` 'REGISTERED' | 'WAITING_RESPONSE' | 'FAILED' | 'SENT' | 'CANCELED' | 'REPLACED' — Estado de la nómina electrónica - `legalStatus` 'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED' — Estado legal de la nómina electrónica ante la DIAN - `companyIdentification` string — Identificación de la empresa empleadora - `employeeIdentification` string — Identificación del empleado - `cune` string — Código único de nómina electrónica asignado para el documento - `prefix` string — Prefijo de nómina electrónica - `number` number, double — Número de nómina electrónica - `fullNumber` string — Número de nómina electrónica (Incluye prefijo y número) - `governmentResponse` object — Objeto con información de la respuesta de la DIAN - `code` string — Código de respuesta de la DIAN - `message` string — Mensaje de respuesta de la DIAN - `errorMessages` string[] — Array con mensajes de error devueltos por la DIAN - `xmlFileName` string — Nombre del archivo XML que se envió a la DIAN - `zipFileName` string — Nombre del archivo Zip que se envió a la DIAN ## Other responses - `400` — Objeto que representa una respuesta de error por validaciones - `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder - `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema --- [API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/versions/5fcb0d90e251/schema)