Documentaci贸n T茅cnica: Mapeo de Conceptos Previred
1. Resumen Ejecutivo
Este documento describe los identificadores de conceptos (slugs) utilizados para la generaci贸n del archivo de Previred. Estos conceptos se extraen directamente de la tabla payroll_process_items y se normalizan para su inclusi贸n en las columnas del reporte.
2. Especificaciones de Origen
- Ruta del Servicio: app/services/reports/legals/previred/cl/entities/concepts/body_headers.rb
- L贸gica de Normalizaci贸n: La query genera columnas din谩micas utilizando el prefijo concept_ seguido del c贸digo del 铆tem de proceso.
- Tratamiento de Datos: Los c贸digos originales en la plataforma (Rankmi) que contengan may煤sculas o espacios son normalizados (snake_case) para asegurar la compatibilidad con las claves finales del reporte.
3. Definici贸n de Conceptos Fijos
Se han definido 39 conceptos base que son transversales a la estructura de Previred. Estos c贸digos deben existir en la configuraci贸n de la n贸mina para ser procesados correctamente:
| Categor铆a | C贸digos de Concepto (Slug) |
| Previsi贸n (AFP/IPS) | afp, base_afp_aportes, base_imponible_afp, previred_base_imponible_afp, prev_afp, sis, depositos_convenidos, cotizacion_apvi, cotizacion_empleado_apvc, cotizacion_empleador_apvc, cuenta2_estadistico, prev_fapp_cotizacion, prev_mcc_prima_uf, prev_rentabilidad_protegida, prev_rima |
| Salud (Isapre/Fonasa) | salud, cotizacion_fonasa, base_imponible_salud, health_insurance_declared_amount, salud_adicional_afecto_a_impuestos, salud_adicional_exento_de_impuestos, salud_ges |
| Seguro de Cesant铆a | afc_seguro_de_cesantia, aporte_patronal_seguro_de_cesantia, base_afc_aportes |
| Cargas y Asignaciones | asignacion_familiar, asignacion_familiar_retroactiva, reintegro_carga_familiar, descuento_por_cargas_familiares_ips, welfare_fund_family_charge_discounts |
| IPS / Mutual / Otros | monto_pension_ips, porcentaje_cotizacion_ips, cotizacion_mutual, cotizacion_trabajo_pesado, porcentaje_cotizacion_trabajo_pesado, alternative_severance_amount |
| Asistencia | dias_considerados_asistencia, dias_con_licencia |
| Caja Compensaci贸n | ccaf_not_affiliated_isapre_quote |
4. Conceptos Din谩micos (CCAF)
Para las Cajas de Compensaci贸n, los c贸digos se generan din谩micamente seg煤n el identificador 煤nico (<ccaf>) asignado a la empresa en el modelo. La nomenclatura en el c贸digo fuente y archivos resultantes sigue el patr贸n concept_[item]_[id_ccaf].
Los rubros din谩micos disponibles son:
- Pr茅stamos: concept_prestamos_<ccaf>
- Leasing: concept_ccaf_leasing_<ccaf>
- Seguros: concept_ccaf_seguro_<ccaf>
- Otros Descuentos: concept_ccaf_otros_<ccaf>
- Dental: concept_ccaf_dental_<ccaf>
5. Consideraciones de Implementaci贸n
Nota sobre Normalizaci贸n:
Cualquier cambio en el c贸digo del concepto dentro de la configuraci贸n de n贸mina de Rankmi afectar谩 directamente la generaci贸n del reporte. Si el c贸digo en la base de datos es Sueldo Base, el motor de reportes buscar谩 concept_sueldo_base. Es imperativo que los slugs listados en la secci贸n 3 coincidan exactamente con la parametrizaci贸n del sistema.
Preguntas Frecuentes (FAQ)
1. 驴Por qu茅 algunos descuentos de la Caja de Compensaci贸n no aparecen en mi reporte? Para que los descuentos (como pr茅stamos, seguros o dental) se reflejen, el c贸digo del concepto en la configuraci贸n de la n贸mina debe incluir el identificador espec铆fico de tu Caja. Si el sistema no detecta la relaci贸n exacta entre el concepto de descuento y el c贸digo de la CCAF, el monto no se agrupar谩 correctamente en las columnas de Previred.
2. 驴Qu茅 pasa si cambio el nombre de un concepto (ej. de "AFP" a "Descuento AFP") en el sistema? 隆Cuidado! El reporte de Previred busca "c贸digos fijos". Si renombras el c贸digo del concepto en la configuraci贸n de Rankmi, el reporte dejar谩 de encontrar los montos correspondientes. Siempre aseg煤rate de que, aunque cambies el nombre visible para el empleado, el c贸digo interno o slug se mantenga igual a los definidos en la lista t茅cnica.
3. 驴C贸mo calcula el reporte los d铆as de asistencia y licencias? El reporte utiliza los conceptos dias_considerados_asistencia y dias_con_licencia. Estos valores se extraen directamente de lo procesado en la n贸mina del mes. Si un empleado tuvo una licencia que no fue cargada en el m贸dulo de asistencia antes del cierre de mes, el reporte de Previred mostrar谩 los 30 d铆as trabajados por defecto, lo que podr铆a generar inconsistencias en el pago de cotizaciones.