factus-js iconfactus-js
Tablas de referencia

Nómina electrónica

Constantes tipadas del SDK para nómina electrónica y tablas de devengados y deducciones.

Catálogos de referencia para el módulo de nómina (factus.payrolls).

Fuente oficial: Tablas de referencia nómina

Periodo de nómina (PayrollPeriodCode)

import { PayrollPeriodCode, PayrollPeriodCodeInfo } from "factus-js";

const code = PayrollPeriodCode.Monthly;

console.log(code); // "5"
console.log(PayrollPeriodCodeInfo[code].description); // "Mensual"
ClaveValorDescripción
Biweekly"4"Quincenal
Monthly"5"Mensual

Tipo de cuenta bancaria (PayrollAccountTypeCode)

import { PayrollAccountTypeCode, PayrollAccountTypeCodeInfo } from "factus-js";

const code = PayrollAccountTypeCode.Savings;

console.log(code); // "2"
console.log(PayrollAccountTypeCodeInfo[code].description); // "Ahorros"
ClaveValorDescripción
Payroll"1"Nómina
Savings"2"Ahorros
Checking"3"Corriente

Tipo de trabajador (WorkerTypeCode)

import { WorkerTypeCode, WorkerTypeCodeInfo } from "factus-js";

const code = WorkerTypeCode.Dependent;

console.log(code); // "01"
console.log(WorkerTypeCodeInfo[code].description); // "Dependiente"
ClaveValorDescripción
Dependent"01"Dependiente
DomesticService"02"Servicio doméstico
CommunityMother"04"Madre comunitaria
SenaLearningStage"12"Aprendices del SENA en etapa lectiva
PublicOfficialUnlimitedIbc"18"Funcionarios públicos sin tope máximo de IBC
SenaProductiveStage"19"Aprendices del SENA en etapa productiva
HealthPostgraduateStudent"21"Estudiantes de posgrado en salud
PrivateSchoolTeacher"22"Profesor de establecimiento particular
StudentLaborRisksOnly"23"Estudiantes aportes solo riesgos laborales
PublicEntitySpecialHealthRegime"30"Dependiente entidades o universidades públicas con régimen especial en salud
CooperativeWorker"31"Cooperados o pre cooperativas de trabajo asociado
ParticipationSystemDependent"47"Trabajador dependiente de entidad beneficiaria del sistema general de participaciones - aportes patronales
PartTimeWorker"51"Trabajador de tiempo parcial
PrePensionerLiquidatingEntity"54"Pre pensionado de entidad en liquidación
PrePensionerVoluntaryHealth"56"Pre pensionado con aporte voluntario a salud
PublicSectorIntern"58"Estudiantes de prácticas laborales en el sector público

Subtipo de trabajador (WorkerSubtypeCode)

ClaveValorDescripción
NotApplicable"00"No aplica
ActiveRetiredDependent"01"Dependiente pensionado por vejez activo

Tipo de contrato (ContractTypeCode)

ClaveValorDescripción
FixedTerm"1"Término fijo
IndefiniteTerm"2"Término indefinido
TermOrLabor"3"Término o labor
Apprenticeship"4"Aprendizaje
Internship"5"Prácticas o Pasantías

Tipo de identificación para nómina (PayrollIdentityDocumentCode)

Usa este catálogo en worker.identification_document_code. No incluye PPT (48).

ClaveValorDescripción
CivilRegistration"11"Registro civil
IdentityCard"12"Tarjeta de identidad
CitizenshipCard"13"Cédula de ciudadanía
ForeignerIdentityCard"21"Tarjeta de extranjería
ForeignerId"22"Cédula de extranjería
NIT"31"NIT
Passport"41"Pasaporte
ForeignIdentificationDocument"42"Documento de identificación extranjero
PEP"47"PEP
ForeignNIT"50"NIT otro país
NUIP"91"NUIP

Tipos de devengados y deducciones

Constantes para los campos accrual_type_code / deduction_type_code dentro de los bloques accruals y deductions. Cada una expone su mapa *Info con la descripción oficial.

Constante SDKCampo API típicoValores
PayrollSeveranceTypeCodeaccruals.cesa.*1 Cesantías, 2 Intereses a cesantías
PayrollPremiumTypeCodeaccruals.prim1 Primas, 2 Primas no salariales
PayrollIncentiveTypeCodeaccruals.boni.*1 Bonificación, 2 Bonificación no salarial
PayrollEpctvBonusTypeCodeaccruals.bono.*14 Pagos salariales / no salariales / alimentación
PayrollTransportAllowanceTypeCodeaccruals.tra.*13 Auxilio transporte y viáticos
PayrollCompensationTypeCodeaccruals.comp.*1 Ordinarias, 2 Extraordinarias
PayrollOtherConceptTypeCodeaccruals.otro.*1 Salarial, 2 No salarial
PayrollLeaveTypeCodeaccruals.lice.*1 Maternidad/paternidad, 2 Vacaciones compensadas
PayrollVacationTypeCodeaccruals.vaca.*1 Comunes, 2 Compensadas
PayrollIncapacityTypeCodeaccruals.inca.*1 Común, 2 Profesional, 3 Laboral
PayrollAllowanceTypeCodeaccruals.auxi.*1 Salarial, 2 No salarial
PayrollOvertimeTypeCodeaccruals.hora.*17 Horas extra y recargos
PayrollPensionSolidarityFundTypeCodededucciones fondo solidaridad1 Solidaridad pensional, 2 Subsistencia
PayrollSanctionTypeCodedeductions.sanc.*1 Pública, 2 Privada

Cesantías (PayrollSeveranceTypeCode)

ClaveValorDescripción
Severance"1"Cesantías
SeveranceInterest"2"Intereses a cesantías

Horas extra y recargos (PayrollOvertimeTypeCode)

ClaveValorDescripción
DaytimeOvertime"1"Hora extra diurna
NighttimeOvertime"2"Hora extra nocturna
NightSurcharge"3"Hora recargo nocturno
SundayHolidayDaytimeOvertime"4"Hora extra diurna dominical y festivos
SundayHolidayDaySurcharge"5"Hora recargo diurno dominical y festivos
SundayHolidayNighttimeOvertime"6"Hora extra nocturna dominical y festivos
SundayHolidayNightSurcharge"7"Hora recargo nocturno dominical y festivos

En esta página