Schemas

Tipo de documento de identificación de la empresa.

Valores posibles:

• ni — NIT (Número de Identificación Tributaria)
• cc — Cédula de Ciudadanía
• ce — Cédula de Extranjería
• ti — Tarjeta de Identidad
• pa — Pasaporte

Rol del usuario en la empresa.

Valores posibles:

• admin — Administrador (acceso total)
• accountant — Contador (acceso a nómina y contabilidad)
• reviewer — Revisor (acceso de solo lectura)
• worker — Persona (acceso a su propio perfil)

Rango del número de personas activas en la empresa.

Valores posibles:

• 1-19 — Entre 1 y 19 personas
• 20-49 — Entre 20 y 49 personas
• 50-99 — Entre 50 y 99 personas
• 100-149 — Entre 100 y 149 personas
• 150-200 — Entre 150 y 200 personas
• over_200 — Más de 200 personas

Frecuencia de liquidación de nómina.

Valores posibles:

• monthly — Mensual
• fortnightly — Quincenal
• mixed — Mixta (algunos empleados mensual, otros quincenal)

Método de pago de nómina.

Valores posibles:

• wire_transfer — Transferencia bancaria
• cash — Efectivo

Área funcional del usuario en la empresa:

• accounting — Contabilidad.
• administrative — Administrativa.
• general_management — Gerencia general.
• hr — Recursos humanos.
• other — Otra área (especificar en area_other_info).
• student — Estudiante en práctica.

Nivel de acceso de la empresa según su suscripción activa:

• free — Sin suscripción activa.
• premium — Suscripción básica activa.
• premium_hr — Suscripción con módulo de gestión humana.
• premium_full — Suscripción con acceso completo a todos los módulos.
• premium_plus — Suscripción extendida con funcionalidades adicionales.

Tipo de documento de identificación de la persona.

Valores posibles:

• cc — Cédula de Ciudadanía
• ce — Cédula de Extranjería
• ti — Tarjeta de Identidad
• rc — Registro Civil
• pa — Pasaporte
• pe — Permiso Especial de Permanencia (PEP)
• ce_no_pension — Cédula de Extranjería sin obligación de pensión
• pe_no_pension — Permiso Especial de Permanencia sin obligación de pensión
• pt — Permiso por Protección Temporal (PPT)
• pt_no_pension — Permiso por Protección Temporal sin obligación de pensión

Tipo de cuenta bancaria.

Valores posibles:

• savings_account — Cuenta de ahorros
• current_account — Cuenta corriente

Categoría del contrato laboral.

Valores posibles:

• employee — Empleado
• contractor — Contratista
• schooling_trainee — Aprendiz SENA etapa lectiva
• productive_trainee — Aprendiz SENA etapa productiva
• dual_trainee — Aprendiz SENA formación dual
• intern — Practicante universitario
• student_decree_055 — Estudiante pasantía (Decreto 055 de 2015)
• student_law_789 — Estudiante (Régimen especial Ley 789 de 2002)
• part_time_contract — Contrato a tiempo parcial

Modalidad del salario.

Valores posibles:

• monthly — Salario mensual fijo
• per_hour — Salario por hora
• integral_salary — Salario integral
• part_time — Tiempo parcial

Periodo de nómina en el que se aplica el descuento del préstamo.

Valores posibles:

• all_periods — Todos los periodos
• first_fortnightly — Primera quincena
• second_fortnightly — Segunda quincena

Estado actual de la solicitud de novedad.

Valores posibles:

• pending — Pendiente de revisión por el administrador
• approved — Aprobada por el administrador
• rejected — Rechazada por el administrador

Tipo de colilla de pago.

Valores posibles:

• payroll — Nómina estándar (valor por defecto)
• termination — Liquidación de contrato
• payroll_termination — Nómina con liquidación de contrato
• social_benefit — Prestación social (prima, cesantías o intereses)
• payroll_social_benefit — Nómina con prestación social
• service_bonus — Prima de servicios (alias de social_benefit)
• severance_interests — Intereses de cesantías (alias de social_benefit)
• payroll_service_bonus — Nómina con prima de servicios (alias de payroll_social_benefit)
• payroll_severance_interests — Nómina con intereses de cesantías (alias de payroll_social_benefit)

Categoría del concepto recurrente de nómina.

Valores posibles:

• incomes — Ingresos (salariales y no salariales)
• salary_income — Ingresos salariales
• non_salary_income — Ingresos no salariales
• deductions_and_loans — Deducciones y préstamos
• deductions — Deducciones
• loans — Préstamos

Categoría contable de los conceptos de nómina.

Valores posibles:

• incapacities_licenses — Incapacidades y licencias
• salary_income — Ingresos salariales
• non_salary_income — Ingresos no salariales
• occasional_non_salary_income — Ingresos no salariales ocasionales
• overtime — Horas extras y recargos
• deductions — Deducciones
• social_benefits — Prestaciones sociales
• social_security — Seguridad social
• retentions — Retenciones
• termination — Liquidación
• payment_method — Método de pago
• legal — Legales
• loan — Préstamos

Tipo de documento contable para la integración con el proveedor.

Valores posibles:

• payroll — Nómina (provisión)
• social_benefits — Prestaciones sociales (provisión)
• social_security — Seguridad social (provisión)
• payroll_payment — Nómina y prestaciones (comprobante de egreso)
• social_security_payment — Seguridad social (comprobante de egreso)

Tipo de duración del contrato.

Valores posibles:

• indefinite — Contrato a término indefinido
• fixed — Contrato a término fijo
• project — Contrato por obra o labor

Subtipo de cotizante aplicado al contrato para la liquidación de seguridad social.

Valores posibles:

• no_subtype — Sin subtipo
• pensioner — Pensionado
• age_exempt_contributor — Cotizante exonerado por edad
• qualified_for_pension — Habilitado para pensión
• compensated_contributor — Cotizante compensado

Código del tipo de riesgo laboral ARL (Administradora de Riesgos Laborales).

Valores posibles:

• risk_1 — Clase I: Riesgo mínimo (ej. oficinas, trabajo administrativo)
• risk_2 — Clase II: Riesgo bajo (ej. algunos procesos manufactureros)
• risk_3 — Clase III: Riesgo medio (ej. maquinaria industrial)
• risk_4 — Clase IV: Riesgo alto (ej. minería, construcción)
• risk_5 — Clase V: Riesgo máximo (ej. manejo de explosivos)

Modo de reporte de prestaciones sociales en la nómina electrónica ante la DIAN.

Valores posibles:

• provision_per_month — Las prestaciones sociales se incluyen mensualmente de acuerdo al concepto de devengo
• at_the_time_of_payment — Las prestaciones sociales se incluyen al momento del pago
• payment_in_year — Las cesantías e intereses se reportan en diciembre si no se han pagado durante el año; la prima al momento del pago

Estado de habilitación de la empresa ante la DIAN para emitir nómina electrónica.

Valores posibles:

• unauthorized — No habilitada, sin envío previo a la DIAN
• authorized — Habilitada y autorizada por la DIAN
• waiting_response — Esperando respuesta de la DIAN
• pending_to_send — Pendiente de envío a la DIAN
• rejected — Rechazada por la DIAN
• failed — Error en el proceso de habilitación

Modo de reporte de vacaciones en la nómina electrónica ante la DIAN.

Valores posibles:

• holidays_provision_per_month — Las vacaciones se incluyen mensualmente de acuerdo al concepto de devengo
• holidays_at_the_time_of_payment — Las vacaciones se incluyen al momento del pago
• holidays_payment_in_year — Las vacaciones se reportan en diciembre si no se han pagado durante el año

Frecuencia de pago de la suscripción a cobrar.

Valores posibles:

• month — Mensual
• year — Anual

Tipo de pago anticipado de vacaciones aplicado a la nómina.

Valores posibles:

• no_early_payment — Sin pago anticipado de vacaciones.
• early_payment_holidays_only — Solo vacaciones anticipadas.
• early_payment_holidays_and_payroll — Vacaciones y nómina anticipadas.

Tipo de pago a incluir en el archivo bancario de una nómina individual.

Valores posibles:

• payroll — Solo nómina (valor por defecto)
• service_bonus — Solo prima de servicios
• payroll_service_bonus — Nómina más prima de servicios
• termination — Solo liquidación de contrato
• payroll_termination — Nómina más liquidación (solo liquidados)
• severance_interests — Solo intereses de cesantías
• payroll_severance_interests — Nómina más intereses de cesantías
• social_benefit — Solo prestaciones sociales (cuando hay múltiples categorías)
• payroll_social_benefit — Nómina más prestaciones sociales (cuando hay múltiples categorías)

Tramo de la nómina a incluir en la colilla. Solo aplica cuando la nómina fue liquidada con vacaciones anticipadas; en ese caso el periodo se divide en tramos según los conceptos de cada parte.

Valores posibles:

• full_period — Periodo completo
• 0, 1, 2... — Índice del tramo (los disponibles varían por nómina)

Los valores exactos se obtienen del campo payroll_range del endpoint GET /v1/{company_id}/payrolls/{payroll_id}/payslip_options. Si no se envía, se usa full_period por defecto.

Tipo de pago a incluir en el archivo bancario de un periodo completo.

Valores posibles:

• payroll — Solo nómina (valor por defecto)
• service_bonus — Solo prima de servicios
• payroll_service_bonus — Nómina más prima de servicios
• termination — Solo liquidaciones de contrato
• payroll_termination — Nómina más liquidaciones (solo liquidados)
• payroll_termination_full — Nómina completa (sin pago anticipado) más liquidaciones
• severance_interests — Solo intereses de cesantías
• payroll_severance_interests — Nómina más intereses de cesantías
• social_benefit — Solo prestaciones sociales (cuando hay múltiples categorías)
• payroll_social_benefit — Nómina más prestaciones sociales (cuando hay múltiples categorías)

Formato del archivo generado para el certificado.

Valores posibles:

• pdf — Genera el certificado en PDF
• xlsx — Genera el certificado en Excel (valor por defecto si se omite)