coati-payroll 0.0.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of coati-payroll might be problematic. Click here for more details.

Files changed (243) hide show
  1. coati_payroll/__init__.py +415 -0
  2. coati_payroll/app.py +95 -0
  3. coati_payroll/audit_helpers.py +904 -0
  4. coati_payroll/auth.py +123 -0
  5. coati_payroll/cli.py +1318 -0
  6. coati_payroll/config.py +219 -0
  7. coati_payroll/demo_data.py +813 -0
  8. coati_payroll/enums.py +278 -0
  9. coati_payroll/forms.py +1769 -0
  10. coati_payroll/formula_engine/__init__.py +81 -0
  11. coati_payroll/formula_engine/ast/__init__.py +110 -0
  12. coati_payroll/formula_engine/ast/ast_visitor.py +259 -0
  13. coati_payroll/formula_engine/ast/expression_evaluator.py +228 -0
  14. coati_payroll/formula_engine/ast/safe_operators.py +131 -0
  15. coati_payroll/formula_engine/ast/type_converter.py +172 -0
  16. coati_payroll/formula_engine/data_sources.py +752 -0
  17. coati_payroll/formula_engine/engine.py +247 -0
  18. coati_payroll/formula_engine/exceptions.py +52 -0
  19. coati_payroll/formula_engine/execution/__init__.py +24 -0
  20. coati_payroll/formula_engine/execution/execution_context.py +52 -0
  21. coati_payroll/formula_engine/execution/step_executor.py +62 -0
  22. coati_payroll/formula_engine/execution/variable_store.py +59 -0
  23. coati_payroll/formula_engine/novelty_codes.py +206 -0
  24. coati_payroll/formula_engine/results/__init__.py +20 -0
  25. coati_payroll/formula_engine/results/execution_result.py +59 -0
  26. coati_payroll/formula_engine/steps/__init__.py +30 -0
  27. coati_payroll/formula_engine/steps/assignment_step.py +71 -0
  28. coati_payroll/formula_engine/steps/base_step.py +48 -0
  29. coati_payroll/formula_engine/steps/calculation_step.py +42 -0
  30. coati_payroll/formula_engine/steps/conditional_step.py +122 -0
  31. coati_payroll/formula_engine/steps/step_factory.py +58 -0
  32. coati_payroll/formula_engine/steps/tax_lookup_step.py +45 -0
  33. coati_payroll/formula_engine/tables/__init__.py +24 -0
  34. coati_payroll/formula_engine/tables/bracket_calculator.py +51 -0
  35. coati_payroll/formula_engine/tables/table_lookup.py +161 -0
  36. coati_payroll/formula_engine/tables/tax_table.py +32 -0
  37. coati_payroll/formula_engine/validation/__init__.py +24 -0
  38. coati_payroll/formula_engine/validation/schema_validator.py +37 -0
  39. coati_payroll/formula_engine/validation/security_validator.py +52 -0
  40. coati_payroll/formula_engine/validation/tax_table_validator.py +205 -0
  41. coati_payroll/formula_engine_examples.py +153 -0
  42. coati_payroll/i18n.py +54 -0
  43. coati_payroll/initial_data.py +613 -0
  44. coati_payroll/interes_engine.py +450 -0
  45. coati_payroll/liquidacion_engine/__init__.py +25 -0
  46. coati_payroll/liquidacion_engine/engine.py +267 -0
  47. coati_payroll/locale_config.py +165 -0
  48. coati_payroll/log.py +138 -0
  49. coati_payroll/model.py +2410 -0
  50. coati_payroll/nomina_engine/__init__.py +87 -0
  51. coati_payroll/nomina_engine/calculators/__init__.py +30 -0
  52. coati_payroll/nomina_engine/calculators/benefit_calculator.py +79 -0
  53. coati_payroll/nomina_engine/calculators/concept_calculator.py +254 -0
  54. coati_payroll/nomina_engine/calculators/deduction_calculator.py +105 -0
  55. coati_payroll/nomina_engine/calculators/exchange_rate_calculator.py +51 -0
  56. coati_payroll/nomina_engine/calculators/perception_calculator.py +75 -0
  57. coati_payroll/nomina_engine/calculators/salary_calculator.py +86 -0
  58. coati_payroll/nomina_engine/domain/__init__.py +27 -0
  59. coati_payroll/nomina_engine/domain/calculation_items.py +52 -0
  60. coati_payroll/nomina_engine/domain/employee_calculation.py +53 -0
  61. coati_payroll/nomina_engine/domain/payroll_context.py +44 -0
  62. coati_payroll/nomina_engine/engine.py +188 -0
  63. coati_payroll/nomina_engine/processors/__init__.py +28 -0
  64. coati_payroll/nomina_engine/processors/accounting_processor.py +171 -0
  65. coati_payroll/nomina_engine/processors/accumulation_processor.py +90 -0
  66. coati_payroll/nomina_engine/processors/loan_processor.py +227 -0
  67. coati_payroll/nomina_engine/processors/novelty_processor.py +42 -0
  68. coati_payroll/nomina_engine/processors/vacation_processor.py +67 -0
  69. coati_payroll/nomina_engine/repositories/__init__.py +32 -0
  70. coati_payroll/nomina_engine/repositories/acumulado_repository.py +83 -0
  71. coati_payroll/nomina_engine/repositories/base_repository.py +40 -0
  72. coati_payroll/nomina_engine/repositories/config_repository.py +102 -0
  73. coati_payroll/nomina_engine/repositories/employee_repository.py +34 -0
  74. coati_payroll/nomina_engine/repositories/exchange_rate_repository.py +58 -0
  75. coati_payroll/nomina_engine/repositories/novelty_repository.py +54 -0
  76. coati_payroll/nomina_engine/repositories/planilla_repository.py +52 -0
  77. coati_payroll/nomina_engine/results/__init__.py +24 -0
  78. coati_payroll/nomina_engine/results/error_result.py +28 -0
  79. coati_payroll/nomina_engine/results/payroll_result.py +53 -0
  80. coati_payroll/nomina_engine/results/validation_result.py +39 -0
  81. coati_payroll/nomina_engine/services/__init__.py +22 -0
  82. coati_payroll/nomina_engine/services/accounting_voucher_service.py +708 -0
  83. coati_payroll/nomina_engine/services/employee_processing_service.py +173 -0
  84. coati_payroll/nomina_engine/services/payroll_execution_service.py +374 -0
  85. coati_payroll/nomina_engine/services/snapshot_service.py +295 -0
  86. coati_payroll/nomina_engine/validators/__init__.py +31 -0
  87. coati_payroll/nomina_engine/validators/base_validator.py +48 -0
  88. coati_payroll/nomina_engine/validators/currency_validator.py +50 -0
  89. coati_payroll/nomina_engine/validators/employee_validator.py +87 -0
  90. coati_payroll/nomina_engine/validators/period_validator.py +44 -0
  91. coati_payroll/nomina_engine/validators/planilla_validator.py +136 -0
  92. coati_payroll/plugin_manager.py +176 -0
  93. coati_payroll/queue/__init__.py +33 -0
  94. coati_payroll/queue/driver.py +127 -0
  95. coati_payroll/queue/drivers/__init__.py +22 -0
  96. coati_payroll/queue/drivers/dramatiq_driver.py +268 -0
  97. coati_payroll/queue/drivers/huey_driver.py +390 -0
  98. coati_payroll/queue/drivers/noop_driver.py +54 -0
  99. coati_payroll/queue/selector.py +121 -0
  100. coati_payroll/queue/tasks.py +764 -0
  101. coati_payroll/rate_limiting.py +83 -0
  102. coati_payroll/rbac.py +183 -0
  103. coati_payroll/report_engine.py +512 -0
  104. coati_payroll/report_export.py +208 -0
  105. coati_payroll/schema_validator.py +167 -0
  106. coati_payroll/security.py +77 -0
  107. coati_payroll/static/styles.css +1044 -0
  108. coati_payroll/system_reports.py +573 -0
  109. coati_payroll/templates/auth/login.html +189 -0
  110. coati_payroll/templates/base.html +283 -0
  111. coati_payroll/templates/index.html +227 -0
  112. coati_payroll/templates/macros.html +146 -0
  113. coati_payroll/templates/modules/calculation_rule/form.html +78 -0
  114. coati_payroll/templates/modules/calculation_rule/index.html +102 -0
  115. coati_payroll/templates/modules/calculation_rule/schema_editor.html +1159 -0
  116. coati_payroll/templates/modules/carga_inicial_prestacion/form.html +170 -0
  117. coati_payroll/templates/modules/carga_inicial_prestacion/index.html +170 -0
  118. coati_payroll/templates/modules/carga_inicial_prestacion/reporte.html +193 -0
  119. coati_payroll/templates/modules/config_calculos/index.html +44 -0
  120. coati_payroll/templates/modules/configuracion/index.html +90 -0
  121. coati_payroll/templates/modules/currency/form.html +47 -0
  122. coati_payroll/templates/modules/currency/index.html +64 -0
  123. coati_payroll/templates/modules/custom_field/form.html +62 -0
  124. coati_payroll/templates/modules/custom_field/index.html +78 -0
  125. coati_payroll/templates/modules/deduccion/form.html +1 -0
  126. coati_payroll/templates/modules/deduccion/index.html +1 -0
  127. coati_payroll/templates/modules/employee/form.html +254 -0
  128. coati_payroll/templates/modules/employee/index.html +76 -0
  129. coati_payroll/templates/modules/empresa/form.html +74 -0
  130. coati_payroll/templates/modules/empresa/index.html +71 -0
  131. coati_payroll/templates/modules/exchange_rate/form.html +47 -0
  132. coati_payroll/templates/modules/exchange_rate/import.html +93 -0
  133. coati_payroll/templates/modules/exchange_rate/index.html +114 -0
  134. coati_payroll/templates/modules/liquidacion/index.html +58 -0
  135. coati_payroll/templates/modules/liquidacion/nueva.html +51 -0
  136. coati_payroll/templates/modules/liquidacion/ver.html +91 -0
  137. coati_payroll/templates/modules/payroll_concepts/audit_log.html +146 -0
  138. coati_payroll/templates/modules/percepcion/form.html +1 -0
  139. coati_payroll/templates/modules/percepcion/index.html +1 -0
  140. coati_payroll/templates/modules/planilla/config.html +190 -0
  141. coati_payroll/templates/modules/planilla/config_deducciones.html +129 -0
  142. coati_payroll/templates/modules/planilla/config_empleados.html +116 -0
  143. coati_payroll/templates/modules/planilla/config_percepciones.html +113 -0
  144. coati_payroll/templates/modules/planilla/config_prestaciones.html +118 -0
  145. coati_payroll/templates/modules/planilla/config_reglas.html +120 -0
  146. coati_payroll/templates/modules/planilla/ejecutar_nomina.html +106 -0
  147. coati_payroll/templates/modules/planilla/form.html +197 -0
  148. coati_payroll/templates/modules/planilla/index.html +144 -0
  149. coati_payroll/templates/modules/planilla/listar_nominas.html +91 -0
  150. coati_payroll/templates/modules/planilla/log_nomina.html +135 -0
  151. coati_payroll/templates/modules/planilla/novedades/form.html +177 -0
  152. coati_payroll/templates/modules/planilla/novedades/index.html +170 -0
  153. coati_payroll/templates/modules/planilla/ver_nomina.html +477 -0
  154. coati_payroll/templates/modules/planilla/ver_nomina_empleado.html +231 -0
  155. coati_payroll/templates/modules/plugins/index.html +71 -0
  156. coati_payroll/templates/modules/prestacion/form.html +1 -0
  157. coati_payroll/templates/modules/prestacion/index.html +1 -0
  158. coati_payroll/templates/modules/prestacion_management/dashboard.html +150 -0
  159. coati_payroll/templates/modules/prestacion_management/initial_balance_bulk.html +195 -0
  160. coati_payroll/templates/modules/prestamo/approve.html +156 -0
  161. coati_payroll/templates/modules/prestamo/condonacion.html +249 -0
  162. coati_payroll/templates/modules/prestamo/detail.html +443 -0
  163. coati_payroll/templates/modules/prestamo/form.html +203 -0
  164. coati_payroll/templates/modules/prestamo/index.html +150 -0
  165. coati_payroll/templates/modules/prestamo/pago_extraordinario.html +211 -0
  166. coati_payroll/templates/modules/prestamo/tabla_pago_pdf.html +181 -0
  167. coati_payroll/templates/modules/report/admin_index.html +125 -0
  168. coati_payroll/templates/modules/report/detail.html +129 -0
  169. coati_payroll/templates/modules/report/execute.html +266 -0
  170. coati_payroll/templates/modules/report/index.html +95 -0
  171. coati_payroll/templates/modules/report/permissions.html +64 -0
  172. coati_payroll/templates/modules/settings/index.html +274 -0
  173. coati_payroll/templates/modules/shared/concept_form.html +201 -0
  174. coati_payroll/templates/modules/shared/concept_index.html +145 -0
  175. coati_payroll/templates/modules/tipo_planilla/form.html +70 -0
  176. coati_payroll/templates/modules/tipo_planilla/index.html +68 -0
  177. coati_payroll/templates/modules/user/form.html +65 -0
  178. coati_payroll/templates/modules/user/index.html +76 -0
  179. coati_payroll/templates/modules/user/profile.html +81 -0
  180. coati_payroll/templates/modules/vacation/account_detail.html +149 -0
  181. coati_payroll/templates/modules/vacation/account_form.html +52 -0
  182. coati_payroll/templates/modules/vacation/account_index.html +68 -0
  183. coati_payroll/templates/modules/vacation/dashboard.html +156 -0
  184. coati_payroll/templates/modules/vacation/initial_balance_bulk.html +149 -0
  185. coati_payroll/templates/modules/vacation/initial_balance_form.html +93 -0
  186. coati_payroll/templates/modules/vacation/leave_request_detail.html +158 -0
  187. coati_payroll/templates/modules/vacation/leave_request_form.html +61 -0
  188. coati_payroll/templates/modules/vacation/leave_request_index.html +98 -0
  189. coati_payroll/templates/modules/vacation/policy_detail.html +176 -0
  190. coati_payroll/templates/modules/vacation/policy_form.html +152 -0
  191. coati_payroll/templates/modules/vacation/policy_index.html +79 -0
  192. coati_payroll/templates/modules/vacation/register_taken_form.html +178 -0
  193. coati_payroll/translations/en/LC_MESSAGES/messages.mo +0 -0
  194. coati_payroll/translations/en/LC_MESSAGES/messages.po +7283 -0
  195. coati_payroll/translations/es/LC_MESSAGES/messages.mo +0 -0
  196. coati_payroll/translations/es/LC_MESSAGES/messages.po +7374 -0
  197. coati_payroll/vacation_service.py +451 -0
  198. coati_payroll/version.py +18 -0
  199. coati_payroll/vistas/__init__.py +64 -0
  200. coati_payroll/vistas/calculation_rule.py +307 -0
  201. coati_payroll/vistas/carga_inicial_prestacion.py +423 -0
  202. coati_payroll/vistas/config_calculos.py +72 -0
  203. coati_payroll/vistas/configuracion.py +87 -0
  204. coati_payroll/vistas/constants.py +17 -0
  205. coati_payroll/vistas/currency.py +112 -0
  206. coati_payroll/vistas/custom_field.py +120 -0
  207. coati_payroll/vistas/employee.py +305 -0
  208. coati_payroll/vistas/empresa.py +153 -0
  209. coati_payroll/vistas/exchange_rate.py +341 -0
  210. coati_payroll/vistas/liquidacion.py +205 -0
  211. coati_payroll/vistas/payroll_concepts.py +580 -0
  212. coati_payroll/vistas/planilla/__init__.py +38 -0
  213. coati_payroll/vistas/planilla/association_routes.py +238 -0
  214. coati_payroll/vistas/planilla/config_routes.py +158 -0
  215. coati_payroll/vistas/planilla/export_routes.py +175 -0
  216. coati_payroll/vistas/planilla/helpers/__init__.py +34 -0
  217. coati_payroll/vistas/planilla/helpers/association_helpers.py +161 -0
  218. coati_payroll/vistas/planilla/helpers/excel_helpers.py +29 -0
  219. coati_payroll/vistas/planilla/helpers/form_helpers.py +97 -0
  220. coati_payroll/vistas/planilla/nomina_routes.py +488 -0
  221. coati_payroll/vistas/planilla/novedad_routes.py +227 -0
  222. coati_payroll/vistas/planilla/routes.py +145 -0
  223. coati_payroll/vistas/planilla/services/__init__.py +26 -0
  224. coati_payroll/vistas/planilla/services/export_service.py +687 -0
  225. coati_payroll/vistas/planilla/services/nomina_service.py +233 -0
  226. coati_payroll/vistas/planilla/services/novedad_service.py +126 -0
  227. coati_payroll/vistas/planilla/services/planilla_service.py +34 -0
  228. coati_payroll/vistas/planilla/validators/__init__.py +18 -0
  229. coati_payroll/vistas/planilla/validators/planilla_validators.py +40 -0
  230. coati_payroll/vistas/plugins.py +45 -0
  231. coati_payroll/vistas/prestacion.py +272 -0
  232. coati_payroll/vistas/prestamo.py +808 -0
  233. coati_payroll/vistas/report.py +432 -0
  234. coati_payroll/vistas/settings.py +29 -0
  235. coati_payroll/vistas/tipo_planilla.py +134 -0
  236. coati_payroll/vistas/user.py +172 -0
  237. coati_payroll/vistas/vacation.py +1045 -0
  238. coati_payroll-0.0.2.dist-info/LICENSE +201 -0
  239. coati_payroll-0.0.2.dist-info/METADATA +581 -0
  240. coati_payroll-0.0.2.dist-info/RECORD +243 -0
  241. coati_payroll-0.0.2.dist-info/WHEEL +5 -0
  242. coati_payroll-0.0.2.dist-info/entry_points.txt +2 -0
  243. coati_payroll-0.0.2.dist-info/top_level.txt +1 -0
@@ -0,0 +1,752 @@
1
+ # Copyright 2025 BMO Soluciones, S.A.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+ """Available data sources for formula engine calculations.
15
+
16
+ This module defines all available data sources that can be accessed
17
+ when creating calculation rules in the formula engine.
18
+ """
19
+
20
+ AVAILABLE_DATA_SOURCES = {
21
+ "empleado": {
22
+ "label": "Empleado",
23
+ "description": "Datos del registro de empleado",
24
+ "fields": {
25
+ # Identificación
26
+ "primer_nombre": {
27
+ "type": "string",
28
+ "label": "Primer Nombre",
29
+ "description": "Primer nombre del empleado",
30
+ },
31
+ "segundo_nombre": {
32
+ "type": "string",
33
+ "label": "Segundo Nombre",
34
+ "description": "Segundo nombre del empleado",
35
+ },
36
+ "primer_apellido": {
37
+ "type": "string",
38
+ "label": "Primer Apellido",
39
+ "description": "Primer apellido del empleado",
40
+ },
41
+ "segundo_apellido": {
42
+ "type": "string",
43
+ "label": "Segundo Apellido",
44
+ "description": "Segundo apellido del empleado",
45
+ },
46
+ "identificacion_personal": {
47
+ "type": "string",
48
+ "label": "Identificación Personal",
49
+ "description": "Número de cédula o documento de identidad",
50
+ },
51
+ "id_seguridad_social": {
52
+ "type": "string",
53
+ "label": "ID Seguridad Social",
54
+ "description": "Número de seguro social (INSS)",
55
+ },
56
+ "id_fiscal": {
57
+ "type": "string",
58
+ "label": "ID Fiscal",
59
+ "description": "Número de identificación fiscal (RUC/NIT)",
60
+ },
61
+ "genero": {
62
+ "type": "string",
63
+ "label": "Género",
64
+ "description": "Género del empleado",
65
+ },
66
+ "nacionalidad": {
67
+ "type": "string",
68
+ "label": "Nacionalidad",
69
+ "description": "Nacionalidad del empleado",
70
+ },
71
+ "estado_civil": {
72
+ "type": "string",
73
+ "label": "Estado Civil",
74
+ "description": "Estado civil del empleado",
75
+ },
76
+ # Fechas
77
+ "fecha_nacimiento": {
78
+ "type": "date",
79
+ "label": "Fecha de Nacimiento",
80
+ "description": "Fecha de nacimiento del empleado",
81
+ },
82
+ "fecha_alta": {
83
+ "type": "date",
84
+ "label": "Fecha de Ingreso",
85
+ "description": "Fecha de inicio de labores del empleado",
86
+ },
87
+ "fecha_baja": {
88
+ "type": "date",
89
+ "label": "Fecha de Baja",
90
+ "description": "Fecha de terminación de labores",
91
+ },
92
+ "fecha_ultimo_aumento": {
93
+ "type": "date",
94
+ "label": "Fecha Último Aumento",
95
+ "description": "Fecha del último aumento de salario",
96
+ },
97
+ # Información laboral
98
+ "cargo": {
99
+ "type": "string",
100
+ "label": "Cargo",
101
+ "description": "Cargo o puesto del empleado",
102
+ },
103
+ "area": {
104
+ "type": "string",
105
+ "label": "Área",
106
+ "description": "Área o departamento del empleado",
107
+ },
108
+ "centro_costos": {
109
+ "type": "string",
110
+ "label": "Centro de Costos",
111
+ "description": "Centro de costos asignado al empleado",
112
+ },
113
+ "tipo_contrato": {
114
+ "type": "string",
115
+ "label": "Tipo de Contrato",
116
+ "description": "Tipo de contrato (indefinido, temporal, etc.)",
117
+ },
118
+ "activo": {
119
+ "type": "boolean",
120
+ "label": "Empleado Activo",
121
+ "description": "Indica si el empleado está activo",
122
+ },
123
+ # Salario y compensación
124
+ "salario_base": {
125
+ "type": "decimal",
126
+ "label": "Salario Base",
127
+ "description": "Salario mensual base del empleado",
128
+ },
129
+ # Datos bancarios
130
+ "banco": {
131
+ "type": "string",
132
+ "label": "Banco",
133
+ "description": "Nombre del banco para depósito",
134
+ },
135
+ "numero_cuenta_bancaria": {
136
+ "type": "string",
137
+ "label": "Número de Cuenta Bancaria",
138
+ "description": "Número de cuenta para depósito de nómina",
139
+ },
140
+ # Implementation initial fields - for when system starts mid-fiscal-year
141
+ "anio_implementacion_inicial": {
142
+ "type": "integer",
143
+ "label": "Año de Implementación Inicial",
144
+ "description": "Año fiscal cuando se implementó el sistema",
145
+ },
146
+ "mes_ultimo_cierre": {
147
+ "type": "integer",
148
+ "label": "Último Mes Cerrado",
149
+ "description": "Último mes cerrado antes de pasar al sistema",
150
+ },
151
+ "salario_acumulado": {
152
+ "type": "decimal",
153
+ "label": "Salario Acumulado (Implementación)",
154
+ "description": "Suma de salarios del año fiscal antes del sistema",
155
+ },
156
+ "impuesto_acumulado": {
157
+ "type": "decimal",
158
+ "label": "Impuesto Acumulado (Implementación)",
159
+ "description": "Suma de impuestos pagados antes del sistema",
160
+ },
161
+ "ultimos_tres_salarios": {
162
+ "type": "json",
163
+ "label": "Últimos Tres Salarios",
164
+ "description": "JSON con los últimos 3 salarios mensuales previos",
165
+ },
166
+ # Datos adicionales (campos personalizados)
167
+ "datos_adicionales": {
168
+ "type": "json",
169
+ "label": "Datos Adicionales",
170
+ "description": "Campos personalizados definidos para el empleado",
171
+ },
172
+ },
173
+ },
174
+ "nomina": {
175
+ "label": "Nómina / Cálculo",
176
+ "description": "Datos del período de nómina actual",
177
+ "fields": {
178
+ "fecha_calculo": {
179
+ "type": "date",
180
+ "label": "Fecha de Cálculo",
181
+ "description": "Fecha en que se ejecuta/genera la nómina",
182
+ },
183
+ "periodo_inicio": {
184
+ "type": "date",
185
+ "label": "Inicio del Período",
186
+ "description": "Fecha de inicio del período de nómina",
187
+ },
188
+ "periodo_fin": {
189
+ "type": "date",
190
+ "label": "Fin del Período",
191
+ "description": "Fecha de fin del período de nómina",
192
+ },
193
+ "dias_periodo": {
194
+ "type": "integer",
195
+ "label": "Días del Período",
196
+ "description": "Número de días del período de nómina",
197
+ },
198
+ "mes_nomina": {
199
+ "type": "integer",
200
+ "label": "Mes de Nómina",
201
+ "description": "Mes del período de nómina (1-12)",
202
+ },
203
+ "anio_nomina": {
204
+ "type": "integer",
205
+ "label": "Año de Nómina",
206
+ "description": "Año del período de nómina",
207
+ },
208
+ "numero_periodo": {
209
+ "type": "integer",
210
+ "label": "Número de Período",
211
+ "description": "Número de período en el año fiscal (1, 2, 3...)",
212
+ },
213
+ "es_ultimo_periodo_anual": {
214
+ "type": "boolean",
215
+ "label": "Es Último Período del Año",
216
+ "description": "Indica si es el último período del año fiscal",
217
+ },
218
+ },
219
+ },
220
+ "tipo_planilla": {
221
+ "label": "Tipo de Planilla",
222
+ "description": "Configuración del tipo de planilla",
223
+ "fields": {
224
+ "codigo": {
225
+ "type": "string",
226
+ "label": "Código",
227
+ "description": "Código del tipo de planilla",
228
+ },
229
+ "periodicidad": {
230
+ "type": "string",
231
+ "label": "Periodicidad",
232
+ "description": "Frecuencia de pago (mensual, quincenal, semanal)",
233
+ },
234
+ "dias": {
235
+ "type": "integer",
236
+ "label": "Días del Período",
237
+ "description": "Días usados para prorrateos",
238
+ },
239
+ "periodos_por_anio": {
240
+ "type": "integer",
241
+ "label": "Períodos por Año",
242
+ "description": "Número de períodos de pago por año fiscal",
243
+ },
244
+ "mes_inicio_fiscal": {
245
+ "type": "integer",
246
+ "label": "Mes Inicio Fiscal",
247
+ "description": "Mes de inicio del período fiscal (1-12)",
248
+ },
249
+ "dia_inicio_fiscal": {
250
+ "type": "integer",
251
+ "label": "Día Inicio Fiscal",
252
+ "description": "Día de inicio del período fiscal",
253
+ },
254
+ "acumula_anual": {
255
+ "type": "boolean",
256
+ "label": "Acumula Anual",
257
+ "description": "Si acumula valores anuales para cálculos",
258
+ },
259
+ },
260
+ },
261
+ "planilla": {
262
+ "label": "Planilla",
263
+ "description": "Datos de la planilla actual",
264
+ "fields": {
265
+ "nombre": {
266
+ "type": "string",
267
+ "label": "Nombre de Planilla",
268
+ "description": "Nombre de la planilla",
269
+ },
270
+ "periodo_fiscal_inicio": {
271
+ "type": "date",
272
+ "label": "Inicio Período Fiscal",
273
+ "description": "Fecha de inicio del período fiscal de la planilla",
274
+ },
275
+ "periodo_fiscal_fin": {
276
+ "type": "date",
277
+ "label": "Fin Período Fiscal",
278
+ "description": "Fecha de fin del período fiscal de la planilla",
279
+ },
280
+ "prioridad_prestamos": {
281
+ "type": "integer",
282
+ "label": "Prioridad Préstamos",
283
+ "description": "Prioridad de deducción de préstamos",
284
+ },
285
+ "prioridad_adelantos": {
286
+ "type": "integer",
287
+ "label": "Prioridad Adelantos",
288
+ "description": "Prioridad de deducción de adelantos",
289
+ },
290
+ },
291
+ },
292
+ "acumulado_anual": {
293
+ "label": "Acumulados del Período Fiscal",
294
+ "description": "Valores acumulados en el año fiscal actual",
295
+ "fields": {
296
+ "salario_bruto_acumulado": {
297
+ "type": "decimal",
298
+ "label": "Salario Bruto Acumulado",
299
+ "description": "Total de salario bruto en el período fiscal",
300
+ },
301
+ "salario_gravable_acumulado": {
302
+ "type": "decimal",
303
+ "label": "Salario Gravable Acumulado",
304
+ "description": "Total de salario gravable en el período fiscal",
305
+ },
306
+ "deducciones_antes_impuesto_acumulado": {
307
+ "type": "decimal",
308
+ "label": "Deducciones Pre-Impuesto Acumuladas",
309
+ "description": "Total de deducciones antes de impuesto",
310
+ },
311
+ "impuesto_retenido_acumulado": {
312
+ "type": "decimal",
313
+ "label": "Impuesto Retenido Acumulado",
314
+ "description": "Total de impuesto retenido en el período",
315
+ },
316
+ "periodos_procesados": {
317
+ "type": "integer",
318
+ "label": "Períodos Procesados",
319
+ "description": "Número de nóminas procesadas en el período fiscal",
320
+ },
321
+ "total_percepciones_acumulado": {
322
+ "type": "decimal",
323
+ "label": "Total Percepciones Acumulado",
324
+ "description": "Total de percepciones en el período fiscal",
325
+ },
326
+ "total_deducciones_acumulado": {
327
+ "type": "decimal",
328
+ "label": "Total Deducciones Acumulado",
329
+ "description": "Total de deducciones en el período fiscal",
330
+ },
331
+ "total_neto_acumulado": {
332
+ "type": "decimal",
333
+ "label": "Total Neto Acumulado",
334
+ "description": "Total neto pagado en el período fiscal",
335
+ },
336
+ "salario_acumulado_mes": {
337
+ "type": "decimal",
338
+ "label": "Salario Acumulado del Mes",
339
+ "description": "Total de salario bruto acumulado en el mes calendario actual.",
340
+ },
341
+ },
342
+ },
343
+ "prestamos_adelantos": {
344
+ "label": "Préstamos y Adelantos (Automático)",
345
+ "description": "Valores calculados automáticamente desde la tabla Adelanto",
346
+ "fields": {
347
+ "total_cuotas_prestamos": {
348
+ "type": "decimal",
349
+ "label": "Total Cuotas de Préstamos",
350
+ "description": "Suma de cuotas de préstamos activos a descontar",
351
+ },
352
+ "total_adelantos_pendientes": {
353
+ "type": "decimal",
354
+ "label": "Total Adelantos Pendientes",
355
+ "description": "Suma de adelantos salariales pendientes",
356
+ },
357
+ "cantidad_prestamos_activos": {
358
+ "type": "integer",
359
+ "label": "Cantidad de Préstamos Activos",
360
+ "description": "Número de préstamos activos del empleado",
361
+ },
362
+ "saldo_total_prestamos": {
363
+ "type": "decimal",
364
+ "label": "Saldo Total de Préstamos",
365
+ "description": "Saldo pendiente total de todos los préstamos",
366
+ },
367
+ },
368
+ },
369
+ "vacaciones": {
370
+ "label": "Vacaciones",
371
+ "description": "Datos de vacaciones del empleado",
372
+ "fields": {
373
+ "dias_vacaciones_acumulados": {
374
+ "type": "decimal",
375
+ "label": "Días de Vacaciones Acumulados",
376
+ "description": "Días de vacaciones acumulados pendientes de disfrutar",
377
+ },
378
+ "dias_vacaciones_tomados": {
379
+ "type": "decimal",
380
+ "label": "Días de Vacaciones Tomados",
381
+ "description": "Días de vacaciones ya disfrutados",
382
+ },
383
+ "dias_vacaciones_disponibles": {
384
+ "type": "decimal",
385
+ "label": "Días de Vacaciones Disponibles",
386
+ "description": "Días de vacaciones disponibles para disfrutar",
387
+ },
388
+ "provision_vacaciones": {
389
+ "type": "decimal",
390
+ "label": "Provisión de Vacaciones",
391
+ "description": "Monto provisionado para vacaciones",
392
+ },
393
+ },
394
+ },
395
+ "novedad": {
396
+ "label": "Novedades del Período",
397
+ "description": "Valores de novedades registradas para el empleado en el período actual",
398
+ "fields": {
399
+ # A. Compensación Base y Directa
400
+ "horas_extra": {
401
+ "type": "decimal",
402
+ "label": "Horas Extraordinarias",
403
+ "description": "Horas trabajadas más allá de la jornada estándar",
404
+ "codigo_concepto": "HORAS_EXTRA",
405
+ "tipo_valor": "horas",
406
+ "gravable": True,
407
+ },
408
+ "horas_extra_dobles": {
409
+ "type": "decimal",
410
+ "label": "Horas Extra Dobles/Festivas",
411
+ "description": "Horas extra en feriados, domingos o nocturnas",
412
+ "codigo_concepto": "HORAS_EXTRA_DOBLES",
413
+ "tipo_valor": "horas",
414
+ "gravable": True,
415
+ },
416
+ "comisiones": {
417
+ "type": "decimal",
418
+ "label": "Comisiones",
419
+ "description": "Porcentaje sobre ventas o negocios concretados",
420
+ "codigo_concepto": "COMISION",
421
+ "tipo_valor": "monto",
422
+ "gravable": True,
423
+ },
424
+ "bono_objetivos": {
425
+ "type": "decimal",
426
+ "label": "Bono por Objetivos",
427
+ "description": "Pago variable por cumplimiento de metas específicas",
428
+ "codigo_concepto": "BONO_OBJETIVOS",
429
+ "tipo_valor": "monto",
430
+ "gravable": True,
431
+ },
432
+ "bono_anual": {
433
+ "type": "decimal",
434
+ "label": "Bono Anual/Trimestral",
435
+ "description": "Compensación discrecional o por resultados generales",
436
+ "codigo_concepto": "BONO_ANUAL",
437
+ "tipo_valor": "monto",
438
+ "gravable": True,
439
+ },
440
+ "plus_peligrosidad": {
441
+ "type": "decimal",
442
+ "label": "Plus por Peligrosidad/Toxicidad",
443
+ "description": "Adicional por trabajar en entornos de riesgo",
444
+ "codigo_concepto": "PLUS_PELIGROSIDAD",
445
+ "tipo_valor": "monto",
446
+ "gravable": True,
447
+ },
448
+ "plus_nocturno": {
449
+ "type": "decimal",
450
+ "label": "Plus por Trabajo Nocturno",
451
+ "description": "Adicional por laborar en horarios nocturnos",
452
+ "codigo_concepto": "PLUS_NOCTURNO",
453
+ "tipo_valor": "monto",
454
+ "gravable": True,
455
+ },
456
+ "plus_antiguedad": {
457
+ "type": "decimal",
458
+ "label": "Plus por Antigüedad",
459
+ "description": "Compensación por años de servicio",
460
+ "codigo_concepto": "PLUS_ANTIGUEDAD",
461
+ "tipo_valor": "monto",
462
+ "gravable": True,
463
+ },
464
+ # B. Compensaciones en Especie y Beneficios
465
+ "uso_vehiculo": {
466
+ "type": "decimal",
467
+ "label": "Uso de Vehículo de Empresa",
468
+ "description": "Valor del beneficio de vehículo para uso personal",
469
+ "codigo_concepto": "USO_VEHICULO",
470
+ "tipo_valor": "monto",
471
+ "gravable": True,
472
+ },
473
+ "seguro_salud": {
474
+ "type": "decimal",
475
+ "label": "Seguro de Salud Privado",
476
+ "description": "Cobertura médica pagada por la empresa",
477
+ "codigo_concepto": "SEGURO_SALUD",
478
+ "tipo_valor": "monto",
479
+ "gravable": False,
480
+ },
481
+ "aporte_pension": {
482
+ "type": "decimal",
483
+ "label": "Aporte a Pensión/Retiro",
484
+ "description": "Aportaciones de la empresa a fondo de pensión",
485
+ "codigo_concepto": "APORTE_PENSION",
486
+ "tipo_valor": "monto",
487
+ "gravable": False,
488
+ },
489
+ "stock_options": {
490
+ "type": "decimal",
491
+ "label": "Opciones de Acciones",
492
+ "description": "Valor de opciones de compra de acciones",
493
+ "codigo_concepto": "STOCK_OPTIONS",
494
+ "tipo_valor": "monto",
495
+ "gravable": True,
496
+ },
497
+ "subsidio_alimentacion": {
498
+ "type": "decimal",
499
+ "label": "Subsidio de Alimentación",
500
+ "description": "Vales, tarjetas o servicio de comedor",
501
+ "codigo_concepto": "SUBSIDIO_ALIMENTACION",
502
+ "tipo_valor": "monto",
503
+ "gravable": False,
504
+ },
505
+ "subsidio_transporte": {
506
+ "type": "decimal",
507
+ "label": "Subsidio de Transporte",
508
+ "description": "Compensación por gastos de desplazamiento",
509
+ "codigo_concepto": "SUBSIDIO_TRANSPORTE",
510
+ "tipo_valor": "monto",
511
+ "gravable": False,
512
+ },
513
+ "subsidio_guarderia": {
514
+ "type": "decimal",
515
+ "label": "Subsidio de Guardería",
516
+ "description": "Ayuda para costes de cuidado infantil",
517
+ "codigo_concepto": "SUBSIDIO_GUARDERIA",
518
+ "tipo_valor": "monto",
519
+ "gravable": False,
520
+ },
521
+ # C. Compensaciones por Tiempo y Bienestar
522
+ "vacaciones_dias": {
523
+ "type": "decimal",
524
+ "label": "Días de Vacaciones",
525
+ "description": "Días de vacaciones pagadas en el período",
526
+ "codigo_concepto": "VACACIONES",
527
+ "tipo_valor": "dias",
528
+ "gravable": True,
529
+ },
530
+ "pago_festivos": {
531
+ "type": "decimal",
532
+ "label": "Pago por Días Festivos",
533
+ "description": "Compensación por trabajar en días de asueto",
534
+ "codigo_concepto": "PAGO_FESTIVOS",
535
+ "tipo_valor": "monto",
536
+ "gravable": True,
537
+ },
538
+ "aguinaldo": {
539
+ "type": "decimal",
540
+ "label": "Aguinaldo/Gratificación Anual",
541
+ "description": "Pago extra en época específica del año",
542
+ "codigo_concepto": "THIRTEENTH_SALARY",
543
+ "tipo_valor": "monto",
544
+ "gravable": True,
545
+ },
546
+ "participacion_utilidades": {
547
+ "type": "decimal",
548
+ "label": "Participación en Utilidades",
549
+ "description": "Porcentaje de beneficios anuales de la empresa",
550
+ "codigo_concepto": "UTILIDADES",
551
+ "tipo_valor": "monto",
552
+ "gravable": True,
553
+ },
554
+ "permiso_pagado_dias": {
555
+ "type": "decimal",
556
+ "label": "Permisos Pagados (días)",
557
+ "description": "Días de permiso pagado (enfermedad, maternidad, etc.)",
558
+ "codigo_concepto": "PERMISO_PAGADO",
559
+ "tipo_valor": "dias",
560
+ "gravable": True,
561
+ },
562
+ "fondo_ahorro_empresa": {
563
+ "type": "decimal",
564
+ "label": "Aporte Empresa a Fondo de Ahorro",
565
+ "description": "Aporte de la empresa al fondo de ahorro del empleado",
566
+ "codigo_concepto": "FONDO_AHORRO_EMPRESA",
567
+ "tipo_valor": "monto",
568
+ "gravable": False,
569
+ },
570
+ # D. Reembolsos y Dietas
571
+ "viaticos": {
572
+ "type": "decimal",
573
+ "label": "Viáticos",
574
+ "description": "Gastos de alojamiento, comida y transporte en viajes",
575
+ "codigo_concepto": "VIATICO",
576
+ "tipo_valor": "monto",
577
+ "gravable": False,
578
+ },
579
+ "gastos_representacion": {
580
+ "type": "decimal",
581
+ "label": "Gastos de Representación",
582
+ "description": "Costes de entretenimiento y relaciones con clientes",
583
+ "codigo_concepto": "GASTOS_REPRESENTACION",
584
+ "tipo_valor": "monto",
585
+ "gravable": False,
586
+ },
587
+ "reembolso_formacion": {
588
+ "type": "decimal",
589
+ "label": "Reembolso de Formación",
590
+ "description": "Cursos, certificaciones, maestrías, etc.",
591
+ "codigo_concepto": "REEMBOLSO_FORMACION",
592
+ "tipo_valor": "monto",
593
+ "gravable": False,
594
+ },
595
+ "reembolso_medico": {
596
+ "type": "decimal",
597
+ "label": "Reembolso de Gastos Médicos",
598
+ "description": "Tratamientos o medicamentos no cubiertos",
599
+ "codigo_concepto": "REEMBOLSO_MEDICO",
600
+ "tipo_valor": "monto",
601
+ "gravable": False,
602
+ },
603
+ # E. Pagos por Eventos Específicos
604
+ "indemnizacion_despido": {
605
+ "type": "decimal",
606
+ "label": "Indemnización por Despido",
607
+ "description": "Pago por terminación de relación laboral",
608
+ "codigo_concepto": "INDEMNIZACION",
609
+ "tipo_valor": "monto",
610
+ "gravable": True,
611
+ },
612
+ "compensacion_reubicacion": {
613
+ "type": "decimal",
614
+ "label": "Compensación por Reubicación",
615
+ "description": "Ayuda para mudanza o cambio de residencia",
616
+ "codigo_concepto": "COMPENSACION_REUBICACION",
617
+ "tipo_valor": "monto",
618
+ "gravable": False,
619
+ },
620
+ "premio_puntualidad": {
621
+ "type": "decimal",
622
+ "label": "Premio por Puntualidad/Asistencia",
623
+ "description": "Premio por asistencia perfecta o puntualidad",
624
+ "codigo_concepto": "PREMIO_PUNTUALIDAD",
625
+ "tipo_valor": "monto",
626
+ "gravable": True,
627
+ },
628
+ "premio_innovacion": {
629
+ "type": "decimal",
630
+ "label": "Premio por Ideas/Innovación",
631
+ "description": "Reconocimiento por ideas innovadoras",
632
+ "codigo_concepto": "PREMIO_INNOVACION",
633
+ "tipo_valor": "monto",
634
+ "gravable": True,
635
+ },
636
+ "ayuda_fallecimiento": {
637
+ "type": "decimal",
638
+ "label": "Ayuda por Fallecimiento",
639
+ "description": "Apoyo económico en situaciones de luto",
640
+ "codigo_concepto": "AYUDA_FALLECIMIENTO",
641
+ "tipo_valor": "monto",
642
+ "gravable": False,
643
+ },
644
+ # Deducciones comunes
645
+ "dias_ausencia": {
646
+ "type": "decimal",
647
+ "label": "Días de Ausencia",
648
+ "description": "Días de ausencia no justificada a descontar",
649
+ "codigo_concepto": "AUSENCIA",
650
+ "tipo_valor": "dias",
651
+ "gravable": False,
652
+ },
653
+ "dias_incapacidad": {
654
+ "type": "decimal",
655
+ "label": "Días de Incapacidad",
656
+ "description": "Días de incapacidad médica",
657
+ "codigo_concepto": "INCAPACIDAD",
658
+ "tipo_valor": "dias",
659
+ "gravable": False,
660
+ },
661
+ "adelanto_salario": {
662
+ "type": "decimal",
663
+ "label": "Adelanto de Salario",
664
+ "description": "Monto de adelanto de salario a descontar",
665
+ "codigo_concepto": "ADELANTO",
666
+ "tipo_valor": "monto",
667
+ "gravable": False,
668
+ },
669
+ "prestamo_cuota": {
670
+ "type": "decimal",
671
+ "label": "Cuota de Préstamo",
672
+ "description": "Cuota de préstamo a descontar",
673
+ "codigo_concepto": "PRESTAMO",
674
+ "tipo_valor": "monto",
675
+ "gravable": False,
676
+ },
677
+ "fondo_ahorro_empleado": {
678
+ "type": "decimal",
679
+ "label": "Aporte Empleado a Fondo de Ahorro",
680
+ "description": "Aporte del empleado al fondo de ahorro",
681
+ "codigo_concepto": "FONDO_AHORRO_EMPLEADO",
682
+ "tipo_valor": "monto",
683
+ "gravable": False,
684
+ },
685
+ },
686
+ },
687
+ "calculado": {
688
+ "label": "Valores Calculados",
689
+ "fields": {
690
+ "meses_restantes_fiscal": {
691
+ "type": "integer",
692
+ "label": "Meses Restantes en Período Fiscal",
693
+ "description": "Meses que faltan para terminar el período fiscal",
694
+ },
695
+ "periodos_restantes_fiscal": {
696
+ "type": "integer",
697
+ "label": "Períodos Restantes",
698
+ "description": "Períodos de pago restantes en el año fiscal",
699
+ },
700
+ "dias_trabajados_periodo": {
701
+ "type": "integer",
702
+ "label": "Días Trabajados en Período",
703
+ "description": "Días efectivamente trabajados en el período actual",
704
+ },
705
+ "es_primer_periodo_sistema": {
706
+ "type": "boolean",
707
+ "label": "Es Primer Período del Sistema",
708
+ "description": "Indica si es el primer período procesado por el sistema",
709
+ },
710
+ "salario_diario": {
711
+ "type": "decimal",
712
+ "label": "Salario Diario",
713
+ "description": "Salario base dividido entre días del período",
714
+ },
715
+ "salario_hora": {
716
+ "type": "decimal",
717
+ "label": "Salario por Hora",
718
+ "description": "Salario base dividido entre horas laborales del período",
719
+ },
720
+ "antiguedad_dias": {
721
+ "type": "integer",
722
+ "label": "Antigüedad (Días)",
723
+ "description": "Días transcurridos desde la fecha de ingreso",
724
+ },
725
+ "antiguedad_meses": {
726
+ "type": "integer",
727
+ "label": "Antigüedad (Meses)",
728
+ "description": "Meses completos desde la fecha de ingreso",
729
+ },
730
+ "antiguedad_anios": {
731
+ "type": "integer",
732
+ "label": "Antigüedad (Años)",
733
+ "description": "Años completos desde la fecha de ingreso",
734
+ },
735
+ "edad_anios": {
736
+ "type": "integer",
737
+ "label": "Edad (Años)",
738
+ "description": "Edad del empleado en años cumplidos",
739
+ },
740
+ "es_nuevo_ingreso": {
741
+ "type": "boolean",
742
+ "label": "Es Nuevo Ingreso",
743
+ "description": "Indica si el empleado ingresó durante el período actual",
744
+ },
745
+ "dias_proporcional": {
746
+ "type": "integer",
747
+ "label": "Días para Cálculo Proporcional",
748
+ "description": "Días a considerar para prorrateo de nuevo ingreso/baja",
749
+ },
750
+ },
751
+ },
752
+ }