coati-payroll 0.0.2__py3-none-any.whl

coati_payroll/vistas/planilla/association_routes.py

@@ -0,0 +1,238 @@
+# Copyright 2025 BMO Soluciones, S.A.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Routes for managing planilla associations."""
+
+from datetime import date
+from flask import flash, redirect, request, url_for
+from flask_login import current_user
+
+from coati_payroll.model import (
+    db,
+    Planilla,
+    Empleado,
+    PlanillaEmpleado,
+    PlanillaIngreso,
+    PlanillaDeduccion,
+    PlanillaPrestacion,
+    PlanillaReglaCalculo,
+)
+from coati_payroll.i18n import _
+from coati_payroll.rbac import require_write_access
+from coati_payroll.vistas.planilla import planilla_bp
+from coati_payroll.vistas.planilla.helpers.association_helpers import agregar_asociacion
+from coati_payroll.vistas.planilla.validators.planilla_validators import PlanillaValidator
+
+# Constants
+ROUTE_CONFIG_EMPLEADOS = "planilla.config_empleados"
+ROUTE_CONFIG_PERCEPCIONES = "planilla.config_percepciones"
+ROUTE_CONFIG_DEDUCCIONES = "planilla.config_deducciones"
+ROUTE_CONFIG_PRESTACIONES = "planilla.config_prestaciones"
+ROUTE_CONFIG_REGLAS = "planilla.config_reglas"
+ERROR_NOT_FOUND = "no encontrada"
+
+
+@planilla_bp.route("/<planilla_id>/empleado/add", methods=["POST"])
+@require_write_access()
+def add_empleado(planilla_id: str):
+    """Add an employee to the planilla."""
+    planilla = db.get_or_404(Planilla, planilla_id)
+    empleado_id = request.form.get("empleado_id")
+
+    if not empleado_id:
+        flash(_("Debe seleccionar un empleado."), "error")
+        return redirect(url_for(ROUTE_CONFIG_EMPLEADOS, planilla_id=planilla_id))
+
+    # Check if already exists
+    existing = db.session.execute(
+        db.select(PlanillaEmpleado).filter_by(planilla_id=planilla_id, empleado_id=empleado_id)
+    ).scalar_one_or_none()
+
+    if existing:
+        flash(_("El empleado ya está asignado a esta planilla."), "warning")
+        return redirect(url_for(ROUTE_CONFIG_EMPLEADOS, planilla_id=planilla_id))
+
+    # Validate that employee and planilla belong to the same company
+    empleado = db.get_or_404(Empleado, empleado_id)
+    is_valid, error_message = PlanillaValidator.validar_empresa_empleado(planilla, empleado)
+    if not is_valid:
+        flash(_(error_message), "error")
+        return redirect(url_for(ROUTE_CONFIG_EMPLEADOS, planilla_id=planilla_id))
+
+    association = PlanillaEmpleado(
+        planilla_id=planilla_id,
+        empleado_id=empleado_id,
+        fecha_inicio=date.today(),
+        activo=True,
+        creado_por=current_user.usuario,
+    )
+    db.session.add(association)
+    db.session.commit()
+    flash(_("Empleado agregado exitosamente."), "success")
+    return redirect(url_for("planilla.config_empleados", planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/empleado/<association_id>/remove", methods=["POST"])
+@require_write_access()
+def remove_empleado(planilla_id: str, association_id: str):
+    """Remove an employee from the planilla."""
+    association = db.get_or_404(PlanillaEmpleado, association_id)
+    db.session.delete(association)
+    db.session.commit()
+    flash(_("Empleado removido exitosamente."), "success")
+    return redirect(url_for("planilla.config_empleados", planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/percepcion/add", methods=["POST"])
+@require_write_access()
+def add_percepcion(planilla_id: str):
+    """Add a perception to the planilla."""
+    orden = request.form.get("orden", 0, type=int)
+    success, error_message, association_id = agregar_asociacion(
+        planilla_id=planilla_id,
+        tipo_componente="percepcion",
+        componente_id=request.form.get("percepcion_id"),
+        datos_extra={"orden": orden},
+        usuario=current_user.usuario,
+    )
+
+    if not success:
+        flash(_(error_message), "error" if ERROR_NOT_FOUND in error_message else "warning")
+        return redirect(url_for(ROUTE_CONFIG_PERCEPCIONES, planilla_id=planilla_id))
+
+    flash(_("Percepción agregada exitosamente."), "success")
+    return redirect(url_for(ROUTE_CONFIG_PERCEPCIONES, planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/percepcion/<association_id>/remove", methods=["POST"])
+@require_write_access()
+def remove_percepcion(planilla_id: str, association_id: str):
+    """Remove a perception from the planilla."""
+    association = db.get_or_404(PlanillaIngreso, association_id)
+    db.session.delete(association)
+    db.session.commit()
+    flash(_("Percepción removida exitosamente."), "success")
+    return redirect(url_for("planilla.config_percepciones", planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/deduccion/add", methods=["POST"])
+@require_write_access()
+def add_deduccion(planilla_id: str):
+    """Add a deduction to the planilla with priority."""
+    prioridad = request.form.get("prioridad", 100, type=int)
+    es_obligatoria = request.form.get("es_obligatoria") == "on"
+    success, error_message, association_id = agregar_asociacion(
+        planilla_id=planilla_id,
+        tipo_componente="deduccion",
+        componente_id=request.form.get("deduccion_id"),
+        datos_extra={"prioridad": prioridad, "es_obligatoria": es_obligatoria},
+        usuario=current_user.usuario,
+    )
+
+    if not success:
+        flash(_(error_message), "error" if ERROR_NOT_FOUND in error_message else "warning")
+        return redirect(url_for(ROUTE_CONFIG_DEDUCCIONES, planilla_id=planilla_id))
+
+    flash(_("Deducción agregada exitosamente."), "success")
+    return redirect(url_for(ROUTE_CONFIG_DEDUCCIONES, planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/deduccion/<association_id>/remove", methods=["POST"])
+@require_write_access()
+def remove_deduccion(planilla_id: str, association_id: str):
+    """Remove a deduction from the planilla."""
+    association = db.get_or_404(PlanillaDeduccion, association_id)
+    db.session.delete(association)
+    db.session.commit()
+    flash(_("Deducción removida exitosamente."), "success")
+    return redirect(url_for("planilla.config_deducciones", planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/deduccion/<association_id>/update-priority", methods=["POST"])
+@require_write_access()
+def update_deduccion_priority(planilla_id: str, association_id: str):
+    """Update the priority of a deduction."""
+    association = db.get_or_404(PlanillaDeduccion, association_id)
+
+    prioridad = request.form.get("prioridad", type=int)
+    if prioridad is not None:
+        association.prioridad = prioridad
+        association.modificado_por = current_user.usuario
+        db.session.commit()
+        flash(_("Prioridad actualizada."), "success")
+
+    return redirect(url_for("planilla.config_deducciones", planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/prestacion/add", methods=["POST"])
+@require_write_access()
+def add_prestacion(planilla_id: str):
+    """Add a benefit (prestacion) to the planilla."""
+    orden = request.form.get("orden", 0, type=int)
+    success, error_message, association_id = agregar_asociacion(
+        planilla_id=planilla_id,
+        tipo_componente="prestacion",
+        componente_id=request.form.get("prestacion_id"),
+        datos_extra={"orden": orden},
+        usuario=current_user.usuario,
+    )
+
+    if not success:
+        flash(_(error_message), "error" if ERROR_NOT_FOUND in error_message else "warning")
+        return redirect(url_for(ROUTE_CONFIG_PRESTACIONES, planilla_id=planilla_id))
+
+    flash(_("Prestación agregada exitosamente."), "success")
+    return redirect(url_for(ROUTE_CONFIG_PRESTACIONES, planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/prestacion/<association_id>/remove", methods=["POST"])
+@require_write_access()
+def remove_prestacion(planilla_id: str, association_id: str):
+    """Remove a benefit from the planilla."""
+    association = db.get_or_404(PlanillaPrestacion, association_id)
+    db.session.delete(association)
+    db.session.commit()
+    flash(_("Prestación removida exitosamente."), "success")
+    return redirect(url_for("planilla.config_prestaciones", planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/regla/add", methods=["POST"])
+@require_write_access()
+def add_regla(planilla_id: str):
+    """Add a calculation rule to the planilla."""
+    orden = request.form.get("orden", 0, type=int)
+    success, error_message, association_id = agregar_asociacion(
+        planilla_id=planilla_id,
+        tipo_componente="regla",
+        componente_id=request.form.get("regla_calculo_id"),
+        datos_extra={"orden": orden},
+        usuario=current_user.usuario,
+    )
+
+    if not success:
+        flash(_(error_message), "error" if ERROR_NOT_FOUND in error_message else "warning")
+        return redirect(url_for(ROUTE_CONFIG_REGLAS, planilla_id=planilla_id))
+
+    flash(_("Regla de cálculo agregada exitosamente."), "success")
+    return redirect(url_for(ROUTE_CONFIG_REGLAS, planilla_id=planilla_id))
+
+
+@planilla_bp.route("/<planilla_id>/regla/<association_id>/remove", methods=["POST"])
+@require_write_access()
+def remove_regla(planilla_id: str, association_id: str):
+    """Remove a calculation rule from the planilla."""
+    association = db.get_or_404(PlanillaReglaCalculo, association_id)
+    db.session.delete(association)
+    db.session.commit()
+    flash(_("Regla de cálculo removida exitosamente."), "success")
+    return redirect(url_for("planilla.config_reglas", planilla_id=planilla_id))

coati_payroll/vistas/planilla/config_routes.py

@@ -0,0 +1,158 @@
+# Copyright 2025 BMO Soluciones, S.A.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Configuration routes for planilla associations."""
+
+from flask import render_template
+
+from coati_payroll.model import (
+    db,
+    Planilla,
+    Empleado,
+    PlanillaEmpleado,
+    PlanillaIngreso,
+    PlanillaDeduccion,
+    PlanillaPrestacion,
+    PlanillaReglaCalculo,
+    Percepcion,
+    Deduccion,
+    Prestacion,
+    ReglaCalculo,
+)
+from coati_payroll.rbac import require_read_access, require_write_access
+from coati_payroll.vistas.planilla import planilla_bp
+
+
+@planilla_bp.route("/<planilla_id>/config/empleados")
+@require_read_access()
+def config_empleados(planilla_id: str):
+    """View employees associated with a planilla."""
+    planilla = db.get_or_404(Planilla, planilla_id)
+
+    empleados_asignados = (
+        db.session.execute(db.select(PlanillaEmpleado).filter_by(planilla_id=planilla_id)).scalars().all()
+    )
+
+    # Filter employees to only show those from the same company as the planilla
+    # CRITICAL: Only employees with matching empresa_id can be added to this planilla
+    query = db.select(Empleado).filter_by(activo=True)
+    if planilla.empresa_id:
+        # Only show employees from the same company (exact match required)
+        query = query.filter(Empleado.empresa_id == planilla.empresa_id)
+    else:
+        # If planilla has no company, show no employees (planilla must have empresa)
+        query = query.filter(db.false())
+    empleados_disponibles = db.session.execute(query.order_by(Empleado.primer_apellido)).scalars().all()
+
+    return render_template(
+        "modules/planilla/config_empleados.html",
+        planilla=planilla,
+        empleados_asignados=empleados_asignados,
+        empleados_disponibles=empleados_disponibles,
+    )
+
+
+@planilla_bp.route("/<planilla_id>/config/percepciones")
+@require_read_access()
+def config_percepciones(planilla_id: str):
+    """View perceptions associated with a planilla."""
+    planilla = db.get_or_404(Planilla, planilla_id)
+
+    percepciones_asignadas = (
+        db.session.execute(db.select(PlanillaIngreso).filter_by(planilla_id=planilla_id)).scalars().all()
+    )
+
+    percepciones_disponibles = (
+        db.session.execute(db.select(Percepcion).filter_by(activo=True).order_by(Percepcion.nombre)).scalars().all()
+    )
+
+    return render_template(
+        "modules/planilla/config_percepciones.html",
+        planilla=planilla,
+        percepciones_asignadas=percepciones_asignadas,
+        percepciones_disponibles=percepciones_disponibles,
+    )
+
+
+@planilla_bp.route("/<planilla_id>/config/deducciones")
+@require_read_access()
+def config_deducciones(planilla_id: str):
+    """View deductions associated with a planilla."""
+    planilla = db.get_or_404(Planilla, planilla_id)
+
+    deducciones_asignadas = (
+        db.session.execute(
+            db.select(PlanillaDeduccion).filter_by(planilla_id=planilla_id).order_by(PlanillaDeduccion.prioridad)
+        )
+        .scalars()
+        .all()
+    )
+
+    deducciones_disponibles = (
+        db.session.execute(db.select(Deduccion).filter_by(activo=True).order_by(Deduccion.nombre)).scalars().all()
+    )
+
+    return render_template(
+        "modules/planilla/config_deducciones.html",
+        planilla=planilla,
+        deducciones_asignadas=deducciones_asignadas,
+        deducciones_disponibles=deducciones_disponibles,
+    )
+
+
+@planilla_bp.route("/<planilla_id>/config/prestaciones")
+@require_write_access()
+def config_prestaciones(planilla_id: str):
+    """Manage benefits associated with a planilla."""
+    planilla = db.get_or_404(Planilla, planilla_id)
+
+    prestaciones_asignadas = (
+        db.session.execute(db.select(PlanillaPrestacion).filter_by(planilla_id=planilla_id)).scalars().all()
+    )
+
+    prestaciones_disponibles = (
+        db.session.execute(db.select(Prestacion).filter_by(activo=True).order_by(Prestacion.nombre)).scalars().all()
+    )
+
+    return render_template(
+        "modules/planilla/config_prestaciones.html",
+        planilla=planilla,
+        prestaciones_asignadas=prestaciones_asignadas,
+        prestaciones_disponibles=prestaciones_disponibles,
+    )
+
+
+@planilla_bp.route("/<planilla_id>/config/reglas")
+@require_read_access()
+def config_reglas(planilla_id: str):
+    """View calculation rules associated with a planilla."""
+    planilla = db.get_or_404(Planilla, planilla_id)
+
+    reglas_asignadas = (
+        db.session.execute(
+            db.select(PlanillaReglaCalculo).filter_by(planilla_id=planilla_id).order_by(PlanillaReglaCalculo.orden)
+        )
+        .scalars()
+        .all()
+    )
+
+    reglas_disponibles = (
+        db.session.execute(db.select(ReglaCalculo).filter_by(activo=True).order_by(ReglaCalculo.nombre)).scalars().all()
+    )
+
+    return render_template(
+        "modules/planilla/config_reglas.html",
+        planilla=planilla,
+        reglas_asignadas=reglas_asignadas,
+        reglas_disponibles=reglas_disponibles,
+    )

coati_payroll/vistas/planilla/export_routes.py

@@ -0,0 +1,175 @@
+# Copyright 2025 BMO Soluciones, S.A.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Routes for Excel export operations."""
+
+from flask import flash, redirect, send_file, url_for
+from flask_login import login_required
+
+from coati_payroll.model import db, Planilla, Nomina
+from coati_payroll.i18n import _
+from coati_payroll.rbac import require_read_access
+from coati_payroll.vistas.planilla import planilla_bp
+from coati_payroll.vistas.planilla.helpers import check_openpyxl_available
+from coati_payroll.vistas.planilla.services import ExportService
+
+# Constants
+ROUTE_VER_NOMINA = "planilla.ver_nomina"
+
+
+@planilla_bp.route("/<planilla_id>/nomina/<nomina_id>/exportar-excel")
+@login_required
+@require_read_access()
+def exportar_nomina_excel(planilla_id: str, nomina_id: str):
+    """Export nomina to Excel with employee details and calculations."""
+    if not check_openpyxl_available():
+        flash(_("Excel export no disponible. Instale openpyxl."), "warning")
+        return redirect(url_for(ROUTE_VER_NOMINA, planilla_id=planilla_id, nomina_id=nomina_id))
+
+    planilla = db.get_or_404(Planilla, planilla_id)
+    nomina = db.get_or_404(Nomina, nomina_id)
+
+    if nomina.planilla_id != planilla_id:
+        flash(_("La nómina no pertenece a esta planilla."), "error")
+        return redirect(url_for("planilla.listar_nominas", planilla_id=planilla_id))
+
+    try:
+        output, filename = ExportService.exportar_nomina_excel(planilla, nomina)
+        return send_file(
+            output,
+            mimetype="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            as_attachment=True,
+            download_name=filename,
+        )
+    except Exception as e:
+        flash(_("Error al exportar nómina: {}").format(str(e)), "error")
+        return redirect(url_for(ROUTE_VER_NOMINA, planilla_id=planilla_id, nomina_id=nomina_id))
+
+
+@planilla_bp.route("/<planilla_id>/nomina/<nomina_id>/exportar-prestaciones-excel")
+@login_required
+@require_read_access()
+def exportar_prestaciones_excel(planilla_id: str, nomina_id: str):
+    """Export benefits (prestaciones) to Excel separately."""
+    if not check_openpyxl_available():
+        flash(_("Excel export no disponible. Instale openpyxl."), "warning")
+        return redirect(url_for(ROUTE_VER_NOMINA, planilla_id=planilla_id, nomina_id=nomina_id))
+
+    planilla = db.get_or_404(Planilla, planilla_id)
+    nomina = db.get_or_404(Nomina, nomina_id)
+
+    if nomina.planilla_id != planilla_id:
+        flash(_("La nómina no pertenece a esta planilla."), "error")
+        return redirect(url_for("planilla.listar_nominas", planilla_id=planilla_id))
+
+    try:
+        output, filename = ExportService.exportar_prestaciones_excel(planilla, nomina)
+        return send_file(
+            output,
+            mimetype="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            as_attachment=True,
+            download_name=filename,
+        )
+    except Exception as e:
+        flash(_("Error al exportar prestaciones: {}").format(str(e)), "error")
+        return redirect(url_for(ROUTE_VER_NOMINA, planilla_id=planilla_id, nomina_id=nomina_id))
+
+
+@planilla_bp.route("/<planilla_id>/nomina/<nomina_id>/exportar-comprobante-excel")
+@login_required
+@require_read_access()
+def exportar_comprobante_excel(planilla_id: str, nomina_id: str):
+    """Export summarized accounting voucher (comprobante contable) to Excel."""
+    if not check_openpyxl_available():
+        flash(_("Excel export no disponible. Instale openpyxl."), "warning")
+        return redirect(url_for("planilla.ver_nomina", planilla_id=planilla_id, nomina_id=nomina_id))
+
+    planilla = db.get_or_404(Planilla, planilla_id)
+    nomina = db.get_or_404(Nomina, nomina_id)
+
+    if nomina.planilla_id != planilla_id:
+        flash(_("La nómina no pertenece a esta planilla."), "error")
+        return redirect(url_for("planilla.listar_nominas", planilla_id=planilla_id))
+
+    # Check if comprobante exists
+    from coati_payroll.model import ComprobanteContable
+
+    comprobante = db.session.execute(db.select(ComprobanteContable).filter_by(nomina_id=nomina_id)).scalar_one_or_none()
+
+    if not comprobante:
+        flash(_("No existe comprobante contable para esta nómina. Debe recalcular la nómina."), "error")
+        return redirect(url_for("planilla.ver_nomina", planilla_id=planilla_id, nomina_id=nomina_id))
+
+    # Check for configuration warnings
+    if comprobante.advertencias:
+        flash(
+            _("ADVERTENCIA: La configuración contable está incompleta. Revise las advertencias en el log."),
+            "warning",
+        )
+
+    try:
+        output, filename = ExportService.exportar_comprobante_excel(planilla, nomina)
+        return send_file(
+            output,
+            mimetype="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            as_attachment=True,
+            download_name=filename,
+        )
+    except Exception as e:
+        flash(_("Error al exportar comprobante: {}").format(str(e)), "error")
+        return redirect(url_for("planilla.ver_nomina", planilla_id=planilla_id, nomina_id=nomina_id))
+
+
+@planilla_bp.route("/<planilla_id>/nomina/<nomina_id>/exportar-comprobante-detallado-excel")
+@login_required
+@require_read_access()
+def exportar_comprobante_detallado_excel(planilla_id: str, nomina_id: str):
+    """Export detailed accounting voucher per employee to Excel."""
+    if not check_openpyxl_available():
+        flash(_("Excel export no disponible. Instale openpyxl."), "warning")
+        return redirect(url_for("planilla.ver_nomina", planilla_id=planilla_id, nomina_id=nomina_id))
+
+    planilla = db.get_or_404(Planilla, planilla_id)
+    nomina = db.get_or_404(Nomina, nomina_id)
+
+    if nomina.planilla_id != planilla_id:
+        flash(_("La nómina no pertenece a esta planilla."), "error")
+        return redirect(url_for("planilla.listar_nominas", planilla_id=planilla_id))
+
+    # Check if comprobante exists
+    from coati_payroll.model import ComprobanteContable
+
+    comprobante = db.session.execute(db.select(ComprobanteContable).filter_by(nomina_id=nomina_id)).scalar_one_or_none()
+
+    if not comprobante:
+        flash(_("No existe comprobante contable para esta nómina. Debe recalcular la nómina."), "error")
+        return redirect(url_for("planilla.ver_nomina", planilla_id=planilla_id, nomina_id=nomina_id))
+
+    # Check for configuration warnings
+    if comprobante.advertencias:
+        flash(
+            _("ADVERTENCIA: La configuración contable está incompleta. Revise las advertencias en el log."),
+            "warning",
+        )
+
+    try:
+        output, filename = ExportService.exportar_comprobante_detallado_excel(planilla, nomina)
+        return send_file(
+            output,
+            mimetype="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            as_attachment=True,
+            download_name=filename,
+        )
+    except Exception as e:
+        flash(_("Error al exportar comprobante detallado: {}").format(str(e)), "error")
+        return redirect(url_for("planilla.ver_nomina", planilla_id=planilla_id, nomina_id=nomina_id))

coati_payroll/vistas/planilla/helpers/__init__.py

@@ -0,0 +1,34 @@
+# Copyright 2025 BMO Soluciones, S.A.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Helper functions for planilla views."""
+
+from coati_payroll.vistas.planilla.helpers.form_helpers import (
+    populate_form_choices,
+    populate_novedad_form_choices,
+    get_concepto_ids_from_form,
+)
+from coati_payroll.vistas.planilla.helpers.excel_helpers import check_openpyxl_available
+from coati_payroll.vistas.planilla.helpers.association_helpers import (
+    agregar_asociacion,
+    get_planilla_component_counts,
+)
+
+__all__ = [
+    "populate_form_choices",
+    "populate_novedad_form_choices",
+    "get_concepto_ids_from_form",
+    "check_openpyxl_available",
+    "agregar_asociacion",
+    "get_planilla_component_counts",
+]