Skip to content

Campos de la Nómina Electrónica

Campo Tipo Requerido Descripción
type_document_id number Si Tipo de documento, para nómina electrónica siempre sera id 9
prefix string Si Prefijo de la nómina
consecutive number Si Consecutivo del número de la nómina
date date Si Fecha de emisión (YYYY-MM-DD)
time time Si Hora de emisión (HH:MM:SS)
resolution_number number Si Número de resolución
sendmail number Si Esta propiedad permite definir si se enviará de forma automatica el correo al cliente
sendmailtome number Si Esta propiedad permite definir si se enviará de forma automatica el documento al correo del emisor, recibe true o false
notes string No Notas libre de la nómina
establishment_name string No Nombre del establecimiento
establishment_address string No Dirección del establecimiento
establishment_phone string No Teléfono del establecimiento
establishment_email string No Email del establecimiento
establishment_municipality number No Municipio del establecimiento
establishment_logo string Si Archivo de imagen del logo del establecimiento en base64 para usar en el PDF.
email_cc_list object No Permite definir un lista de email a los que será enviado un documento de forma simultanea
head_note string No Permite incluir una nota en la cabezera del documento.
foot_note string No Permite incluir una nota en pie de página del documento.
novelty object Si Grupo de campos para información relacionadas con las novedades de la nómina
novelty[novelty] boolean Si Indica si la nómina es una novedad o no, si lo es debe indicar el CUNE de la nómina anterior.
novelty[uuidnov] string No CUNE de la nómina anterior si es reemplazo.
period object Si Grupo de campos para información del período de liquidación de la nómina
period[admision_date] date Si Indica la fecha de admisión del trabajador (DD-MM-YYYY)
period[settlement_start_date] date Si Fecha de inicio del período de liquidación
period[settlement_end_date] date Si Fecha de finalización del período de liquidación
period[worked_time] number Si Días trabajados durante ese período
period[issue_date] date Si Fecha de emisión de la nómina
worker_code string Si Código interno del trabajador para la secuencia de documentos (Puede ser su número de identificación).
worker[type_worker_id] number Si Identificador del tipo de trabajador (Ver tabla Tipos de Trabajadores)
worker[sub_type_worker_id] number Si Identificador del subtipo de trabajador (Ver tabla Subtipos de Trabajadores)
worker[payroll_type_document_identification_id] number Si Identificador del tipo de documento de identificacion en nómina (Ver tabla Tipo de Documento de Identificacion de Nómina)
worker[municipality_id] number Si Identificador del municipio (Ver tabla Municipios)
worker[high_risk_pension] boolean Si Indica si el empleado tiene pensión de alto riesgo
worker[identification_number] string Si Indica si el numero de identificación del empleado
worker[surname] string Si Indica el primer apellido del empleado
worker[second_surname] string No Indica el primer apellido del empleado
worker[first_name] string Si Indica el primer nombre del empleado
worker[middle_name] string No Indica el segundo nombre del empleado
worker[address] string Si Indica la dirección de recidencia del empleado
worker[salary] number Si Indica el sueldo base del empleado
worker[email] string Si Indica el correo electrónico del empleado
tarifaica string No Indica la Tarifa del Impuesto de Industria y Comercio (ICA) aplicable al emisor
actividadeconomica string No Código de la actividad económica del emisor.
dont_send_yet boolean No Le indica al sistema la opción de enviar el documento posteriormente a la DIAN.
Campo Tipo Requerido Descripción
deductions object Si Deducciones del trabajador
deductions[eps_type_law_deductions_id] number Si Identificador del tipo de deducción de ley para EPS (Ver tabla Deducciones legales)
deductions[eps_deduction] number Si Valor de la deducción de la EPS
deductions[pension_type_law_deductions_id] number Si Identificador del tipo de deducción de ley para Pensión (Ver tabla Deducciones legales)
deductions[pension_deduction] number Si Valor de la deducción de la Pensión
deductions[deductions_total] number Si Valor total de las deducciones
deductions[fondosp_deduction_SP] number No Valor de la deducción del Fondo de Solidaridad Pensional
deductions[fondossp_sub_type_law_deductions_id] number Si Identificador del tipo de Fondo de Subsistencia (Ver tabla Deducciones legales)
deductions[fondosp_deduction_sub] number No Valor de la deducción del Fondo de Subsistencia
deductions[labor_union] array No Aportes a sindicatos
deductions[labor_union][percentage] numeric Si Porcentaje de aporte sindical
deductions[labor_union][deduction] numeric Si Valor de la deducción sindical
deductions[sanctions] array No Sanciones disciplinarias
deductions[sanctions][public_sanction] numeric Si Valor de la sanción pública
deductions[sanctions][private_sanction] numeric Si Valor de la sanción privada
deductions[orders] array No Libranzas
deductions[orders][description] string Si Descripción de la libranza
deductions[orders][deduction] numeric Si Valor de la deducción por libranza
deductions[third_party_payments] array No Pagos a terceros deducidos
deductions[third_party_payments][third_party_payment] numeric Si Descripción de la libranza
deductions[advances] array No Anticipos deducidos
deductions[advances][advance] numeric Si Valor del anticipo deducido
deductions[other_deductions] array No Otras deducciones
deductions[other_deductions][other_deduction] numeric Si Valor de la deducción
deductions[other_deductions][description_deduction] string No Descripción de la deducción
deductions[voluntary_pension] numeric No Pensión voluntaria
deductions[withholding_at_source] numeric No Retención en la fuente
deductions[afc] numeric No Ahorro para el Fomento de la Construcción (AFC)
deductions[cooperative] numeric No Aporte a cooperativa
deductions[tax_liens] numeric No Embargos fiscales
deductions[supplementary_plan] numeric No Plan complementario de salud
deductions[education] numeric No Deducción por educación
deductions[refund] numeric No Reintegro deducido
deductions[debt] numeric No Deuda
Campo Tipo Requerido Descripción
accrued object Si Conceptos correspondiente a las prestaciones sociales del trabajador como salario, horas extras, recargos, vacaciones, prestaciones sociales, incapacidades, licencias, bonificaciones, auxilios, comisiones, entre otros.
accrued[worked_days] number Si Dias trabajados durante el periodo de liquidación
accrued[salary] number Si Valor del salario liquidado
accrued[transportation_allowance] number Si Valor del auxilio de transporte durante el período liquidado
accrued[accrued_total] number Si Valor total de las prestaciones sociales liquidadas
accrued[salary_viatics] number No Viáticos salariales
accrued[non_salary_viatics] number No Viáticos no salariales
accrued[HEDs] array No Horas extras diurnas
accrued[HEDs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HEDs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HEDs][quantity] numeric Si Cantidad de horas extras
accrued[HEDs][percentage] numeric Si Id del porcentaje de recargo de horas extras (Ver tabla Tipos de recargos por horas extras)
accrued[HEDs][payment] numeric Si Valor total a pagar por horas extras
accrued[HENs] array No Horas Extra Nocturnas
accrued[HENs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HENs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HENs][quantity] numeric Si Cantidad de horas extras
accrued[HENs][percentage] numeric Si Id del porcentaje de recargo de horas extras (Ver tabla Tipos de recargos por horas extras)
accrued[HENs][payment] numeric Si Valor total a pagar por horas extras
accrued[HRNs] array No Horas Recargo Nocturno
accrued[HRNs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HRNs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HRNs][quantity] numeric Si Cantidad de recargos
accrued[HRNs][percentage] numeric Si Id del porcentaje de recargo (Ver tabla Tipos de recargos por horas extras)
accrued[HRNs][payment] numeric Si Valor total a pagar por recargos
accrued[HEDDFs] array No Horas Extra Diurnas Dominicales y Festivas
accrued[HEDDFs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HEDDFs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HEDDFs][quantity] numeric Si Cantidad de recargos
accrued[HEDDFs][percentage] numeric Si Id del porcentaje de recargo (Ver tabla Tipos de recargos por horas extras)
accrued[HEDDFs][payment] numeric Si Valor total a pagar por recargos
accrued[HRDDFs] array No Horas Recargo Diurno Dominicales y Festivas
accrued[HRDDFs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HRDDFs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HRDDFs][quantity] numeric Si Cantidad de recargos
accrued[HRDDFs][percentage] numeric Si Id del porcentaje de recargo (Ver tabla Tipos de recargos por horas extras)
accrued[HRDDFs][payment] numeric Si Valor total a pagar por recargos
accrued[HENDFs] array No Horas Extra Nocturnas Dominicales y Festivas
accrued[HENDFs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HENDFs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HENDFs][quantity] numeric Si Cantidad de recargos
accrued[HENDFs][percentage] numeric Si Id del porcentaje de recargo (Ver tabla Tipos de recargos por horas extras)
accrued[HENDFs][payment] numeric Si Valor total a pagar por recargos
accrued[HRNDFs] array No Horas Recargo Nocturno Dominicales y Festivas
accrued[HRNDFs][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[HRNDFs][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[HRNDFs][quantity] numeric Si Cantidad de recargos
accrued[HRNDFs][percentage] numeric Si Id del porcentaje de recargo (Ver tabla Tipos de recargos por horas extras)
accrued[HRNDFs][payment] numeric Si Valor total a pagar por recargos
accrued[common_vacation] array No Vacaciones comunes disfrutadas
accrued[common_vacation][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[common_vacation][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[common_vacation][quantity] numeric Si Cantidad de días de vacaciones
accrued[common_vacation][payment] numeric Si Valor total a pagar por vacaciones
accrued[paid_vacation] array No Vacaciones pagadas
accrued[paid_vacation][quantity] numeric Si Cantidad de días de vacaciones
accrued[paid_vacation][payment] numeric Si Valor total vacaciones
accrued[service_bonus] array No Prima de servicios
accrued[service_bonus][quantity] numeric Si Cantidad de días de prima de servicios
accrued[service_bonus][payment] numeric Si Valor total salarial prima de servicios
accrued[service_bonus][paymentNS] numeric Si Valor total no salarial prima de servicios
accrued[severance] array No Cesantías
accrued[severance][percentage] numeric Si Porcentaje de intereces de cesantías
accrued[severance][payment] numeric Si Valor total cesantías
accrued[severance][interest_payment] numeric Si Valor de intereces de cesantías
accrued[work_disabilities] array No Incapacidades laborales
accrued[work_disabilities][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[work_disabilities][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[work_disabilities][quantity] numeric Si Cantidad de días de incapacidades laborales
accrued[work_disabilities][type] numeric Si Tipo de incapacidades laborales (Ver tabla Tipos de incapacidades laborales)
accrued[work_disabilities][payment] numeric Si Valor total incapacidades laborales
accrued[maternity_leave] array No Licencia por maternidad
accrued[maternity_leave][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[maternity_leave][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[maternity_leave][quantity] numeric Si Cantidad de días de licencia por maternidad
accrued[maternity_leave][payment] numeric Si Valor total licencia por maternidad
accrued[paid_leave] array No Licencias remuneradas
accrued[paid_leave][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[paid_leave][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[paid_leave][quantity] numeric Si Cantidad de días de licencia remunerada
accrued[paid_leave][payment] numeric Si Valor total licencia remunerada
accrued[non_paid_leave] array No Licencias no remuneradas
accrued[non_paid_leave][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[non_paid_leave][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[non_paid_leave][quantity] numeric Si Cantidad de días de licencia no remunerada
accrued[bonuses] array No Bonificaciones
accrued[bonuses][salary_bonus] datetime No Bonificación salarial
accrued[bonuses][non_salary_bonus] datetime No Bonificación no salarial
accrued[aid] array No Ayudas
accrued[aid][salary_assistance] datetime No Auxilio salarial
accrued[aid][non_salary_assistance] datetime No Auxilio no salarial
accrued[legal_strike] array No Huelga legal
accrued[legal_strike][start_time] datetime Si Hora de inicio (YYYY-MM-DD HH:MM:SS)
accrued[legal_strike][end_time] datetime Si Hora de finalización (YYYY-MM-DD HH:MM:SS)
accrued[legal_strike][quantity] numeric Si Cantidad de días de Huelga legal
accrued[other_concepts] array No Otros conceptos devengados
accrued[other_concepts][salary_concept] datetime No Concepto salarial
accrued[other_concepts][non_salary_concept] numeric No Concepto no salarial
accrued[other_concepts][description_concept] string Si Descripción del concepto
accrued[compensations] array No Compensaciones
accrued[compensations][ordinary_compensation] numeric Si Compensación ordinaria
accrued[compensations][extraordinary_compensation] numeric Si Compensación extraordinaria
accrued[epctv_bonuses] array No Bonificaciones de EPCTV (Empresas de la Economía Popular que Cumplen Toda la Vigencia)
accrued[epctv_bonuses][paymentS] numeric No Pago salarial
accrued[epctv_bonuses][paymentNS] numeric No Pago no salarial
accrued[epctv_bonuses][salary_food_payment] numeric No Pago salarial por alimentación
accrued[epctv_bonuses][non_salary_food_payment] numeric No Pago no salarial por alimentación
accrued[commissions] array No Comisiones
accrued[commissions][commission] numeric Si Valor de la comisión
accrued[third_party_payments] array No Pagos a terceros
accrued[third_party_payments][third_party_payment] numeric Si Valor del pago a tercero
accrued[advances] array No Anticipos devengados
accrued[advances][advance] numeric Si Valor del anticipo
accrued[endowment] numeric No Dotación
accrued[sustenance_support] numeric No Apoyo de sostenimiento
accrued[telecommuting] numeric No Teletrabajo
accrued[withdrawal_bonus] numeric No Bonificación de retiro
accrued[compensation] numeric No Compensación o Indemnización
accrued[compensation] numeric No Compensación o Indemnización