5. Módulo Laboral

Nóminas, contratos, validaciones por convenio y generación de documentación.

CálculoNómina

CalidadReglas/Topes

EntregaPortal

Visión del módulo

Gestión laboral completa: trabajadores, contratos, nóminas y obligaciones asociadas. Diseñado para reducir incidencias y llamadas.

Objetivos

Calcular nóminas de forma consistente por convenio y configuración.
Generar documentación y salidas necesarias (ficheros/procesos externos).
Controlar cambios (altas/bajas/variaciones) con audit y aprobaciones.
Facilitar portal empleado opcional.

Alcance

Fichas de trabajadores y contratos.
Parámetros de nómina (conceptos, pagas, IRPF, embargos).
Cálculo mensual, pagas extras y atrasos.
Generación de documentos y modelos asociados.

Personas y roles

Rol	Necesidad / uso principal
Gestor laboral	Calcular nóminas rápido y sin errores; gestionar variaciones.
Supervisor	Validar cambios sensibles (salario, jornada) y cierres.
Cliente (empresa)	Acceder a informes de costes y nóminas (si procede).
Empleado (opcional)	Descargar nómina y certificados.

Diseño funcional

Flujos principales

Alta de trabajador

Nueva contratación.

Crear ficha trabajador (datos, cuenta, domicilio, situación).
Crear contrato (tipo, jornada, convenio, categoría).
Validar topes y coherencia de convenio.
Aprobar alta si requiere supervisor.
Incluir en ciclo de nómina.

Salida: Trabajador activo con contrato válido.

Cálculo de nómina mensual

Cierre de mes.

Cargar incidencias (horas, bajas, variables).
Calcular nómina con conceptos y reglas.
Ejecutar validaciones (bases, topes, coherencia).
Aprobación supervisor (opcional por política).
Generar documentos (nóminas, resumen costes) y exportaciones.

Salida: Nóminas emitidas con trazabilidad y documentos listos.

Pantallas (UI)

Fichas de trabajador y contrato.
Incidencias del mes (variables).
Ejecución de nómina: validaciones y aprobaciones.
Generación y entrega de nóminas (portal/emails).

Diseño técnico

Entidades y modelo de datos (mínimo)

Entidad	Campos principales / notas
Employee	id, company_id, nif, name, iban, address, status
Contract	employee_id, type, start/end, hours, category, agreement_id
PayrollRun	id, company_id, period, status, totals, approvals
Payslip	id, payroll_run_id, employee_id, lines[], net, gross
PayrollConcept	code, name, taxable, cotizable, formula
Agreement	code, name, rules, tables

Permisos y seguridad (RBAC)

Solo laboral puede editar conceptos y incidencias; supervisor aprueba cambios sensibles.
Cliente accede según contrato: lectura de informes y nóminas.
Empleado (portal) solo ve su propia nómina.

Validaciones y reglas

Control de topes de cotización y coherencia de bases.
Reglas por convenio (tablas salariales) y avisos si fuera de rango.
Bloqueo de nóminas emitidas; correcciones por 'recalcular' con versión.

APIs sugeridas (API-first)

POST /api/v1/payroll/employees PATCH /api/v1/payroll/employees/{id} POST /api/v1/payroll/contracts POST /api/v1/payroll/runs/calculate # {company_id, period} POST /api/v1/payroll/runs/{id}/approve GET /api/v1/payroll/payslips?run_id=... GET /api/v1/payroll/reports/costs?period=...

Eventos y auditoría

employee.created/updated
payroll.run.calculated
payroll.run.approved
payslip.generated

Impacto de negocio

Beneficio para la gestoría

Menos incidencias por validaciones y control supervisor.
Cálculo más rápido y estandarizado.
Reducción de llamadas gracias a portal/entregas estructuradas.

Beneficio para el cliente

Coste laboral claro y documentación ordenada.
Menos riesgo por errores y cambios sin control.

Riesgos / puntos críticos

Reglas por convenio requieren mantenimiento y versionado.
Gestión de incidencias debe ser muy usable para no crear trabajo extra.

5. 劳工模块

工资单、合同、协议验证和文档生成。

计算工资单

质量规则/上限

交付门户

模块愿景

完整的劳工管理：员工、合同、工资单和相关义务。旨在减少事件和电话。

目标

按协议和配置一致地计算工资单。
生成必要的文档和输出（文件/外部流程）。
通过审计和审批控制变更（入职/离职/变更）。
促进可选的员工门户。

范围

员工档案和合同。
工资单参数（概念、工资、个人所得税、扣押）。
月度计算、额外工资和欠款。
生成相关文档和模型。

人员和角色

角色	需求 / 主要用途
劳工经理	快速无误地计算工资单；管理变更。
主管	验证敏感变更（工资、工作时间）和关闭。
客户（公司）	访问成本报告和工资单（如适用）。
员工（可选）	下载工资单和证书。

功能设计

主要流程

员工入职

新招聘。

创建员工档案（数据、账户、地址、情况）。
创建合同（类型、工作时间、协议、类别）。
验证上限和协议一致性。
如果需要主管，则批准入职。
纳入工资单周期。

输出：具有有效合同的活跃员工。

月度工资单计算

月末。

加载事件（小时、请假、变量）。
使用概念和规则计算工资单。
执行验证（基数、上限、一致性）。
主管审批（根据政策可选）。
生成文档（工资单、成本摘要）和导出。

输出：已发出的工资单，具有可追溯性和准备好的文档。

屏幕（UI）

员工和合同档案。
月度事件（变量）。
工资单执行：验证和审批。
工资单的生成和交付（门户/电子邮件）。

技术设计

实体和数据模型（最小）

实体	主要字段 / 注释
Employee	id, company_id, nif, name, iban, address, status
Contract	employee_id, type, start/end, hours, category, agreement_id
PayrollRun	id, company_id, period, status, totals, approvals
Payslip	id, payroll_run_id, employee_id, lines[], net, gross
PayrollConcept	code, name, taxable, cotizable, formula
Agreement	code, name, rules, tables

权限和安全性（RBAC）

只有劳工可以编辑概念和事件；主管批准敏感变更。
客户根据合同访问：读取报告和工资单。
员工（门户）只能看到自己的工资单。

验证和规则

控制缴费上限和基数一致性。
按协议的规则（工资表）和超出范围的警告。
锁定已发出的工资单；通过"重新计算"和版本进行更正。

建议的API（API优先）

事件和审计

employee.created/updated
payroll.run.calculated
payroll.run.approved
payslip.generated

业务影响

对管理办公室的好处

通过验证和主管控制减少事件。
更快和标准化的计算。
通过门户/结构化交付减少电话。

对客户的好处

清晰的劳动力成本和有序的文档。
减少因错误和不受控制的变更而带来的风险。

风险 / 关键点

按协议的规则需要维护和版本控制。
事件管理必须非常易用，以免产生额外工作。

5. Labor Module

Payrolls, contracts, agreement validations and documentation generation.

CalculationPayroll

QualityRules/Limits

DeliveryPortal

Module Vision

Complete labor management: workers, contracts, payrolls and associated obligations. Designed to reduce incidents and calls.

Objectives

Calculate payrolls consistently by agreement and configuration.
Generate necessary documentation and outputs (files/external processes).
Control changes (hires/terminations/variations) with audit and approvals.
Facilitate optional employee portal.

Scope

Worker records and contracts.
Payroll parameters (concepts, payments, IRPF, attachments).
Monthly calculation, extra payments and arrears.
Generation of associated documents and models.

People and roles

Role	Need / main use
Labor manager	Calculate payrolls quickly and without errors; manage variations.
Supervisor	Validate sensitive changes (salary, hours) and closures.
Client (company)	Access cost reports and payrolls (if applicable).
Employee (optional)	Download payslip and certificates.

Functional Design

Main flows

Worker registration

New hire.

Create worker record (data, account, address, situation).
Create contract (type, hours, agreement, category).
Validate limits and agreement consistency.
Approve registration if supervisor required.
Include in payroll cycle.

Output: Active worker with valid contract.

Monthly payroll calculation

Month end.

Load incidents (hours, leaves, variables).
Calculate payroll with concepts and rules.
Execute validations (bases, limits, consistency).
Supervisor approval (optional by policy).
Generate documents (payslips, cost summary) and exports.

Output: Issued payrolls with traceability and ready documents.

Screens (UI)

Worker and contract records.
Monthly incidents (variables).
Payroll execution: validations and approvals.
Generation and delivery of payrolls (portal/emails).

Technical Design

Entities and data model (minimum)

Entity	Main fields / notes
Employee	id, company_id, nif, name, iban, address, status
Contract	employee_id, type, start/end, hours, category, agreement_id
PayrollRun	id, company_id, period, status, totals, approvals
Payslip	id, payroll_run_id, employee_id, lines[], net, gross
PayrollConcept	code, name, taxable, cotizable, formula
Agreement	code, name, rules, tables

Permissions and security (RBAC)

Only labor can edit concepts and incidents; supervisor approves sensitive changes.
Client accesses according to contract: read reports and payrolls.
Employee (portal) only sees own payslip.

Validations and rules

Control of contribution limits and base consistency.
Rules by agreement (salary tables) and warnings if out of range.
Lock of issued payrolls; corrections by 'recalculate' with version.

Suggested APIs (API-first)

Events and audit

employee.created/updated
payroll.run.calculated
payroll.run.approved
payslip.generated

Business Impact

Benefit for the office

Fewer incidents through validations and supervisor control.
Faster and standardized calculation.
Reduction of calls thanks to portal/structured deliveries.

Benefit for the client

Clear labor cost and organized documentation.
Less risk from errors and uncontrolled changes.

Risks / critical points

Rules by agreement require maintenance and versioning.
Incident management must be very usable to avoid extra work.