6. Módulo Renta

IRPF PF: datos, simulación y presentación con evidencias.

CampañaIRPF

FlujoWizard

ValorSimulación

Visión del módulo

Campaña IRPF (personas físicas): entrada/organización de datos, simulación y presentación, con archivo de evidencias.

Objetivos

Estandarizar la campaña de renta con flujos repetibles.
Permitir simulación y comparación de escenarios.
Guardar justificantes y trazabilidad por contribuyente.

Alcance

Gestión de contribuyentes (clientes PF).
Rentas: trabajo, capital, actividades, inmuebles, patrimonio.
Simulación individual/conjunta.
Presentación y archivo.

Personas y roles

Rol	Necesidad / uso principal
Gestor renta	Procesar volumen con checklist y simulación.
Cliente PF	Entender resultado, documentación y justificante.

Diseño funcional

Flujos principales

Preparación renta

Campaña anual.

Crear expediente de renta (año).
Cargar datos (manual/importaciones) y documentación.
Simular escenarios (individual/conjunta).
Revisión y aprobación interna.
Presentación y archivo del justificante.

Salida: Renta presentada con informe y evidencias.

Pantallas (UI)

Wizard de renta: datos + documentación + simulación.
Comparativa de escenarios.
Entrega de informe y justificante.

Diseño técnico

Entidades y modelo de datos (mínimo)

Entidad	Campos principales / notas
TaxReturn	id, client_id, year, status, totals, versions
IncomeItem	type, source, amount, attachments[]
Property	address, ref_catastral, usage, income/expenses
ReturnFiling	tax_return_id, filed_at, receipt, logs

Permisos y seguridad (RBAC)

Gestor renta edita; supervisor aprueba; cliente solo lectura del resultado/justificante.

Validaciones y reglas

Checklist documental por tipo de renta.
Validaciones de coherencia (inmuebles, rendimientos, duplicados).

APIs sugeridas (API-first)

POST /api/v1/renta/returns PATCH /api/v1/renta/returns/{id} POST /api/v1/renta/returns/{id}/simulate POST /api/v1/renta/returns/{id}/submit GET /api/v1/renta/returns/{id}/receipt

Eventos y auditoría

renta.return.simulated
renta.return.submitted
renta.receipt.saved

Impacto de negocio

Beneficio para la gestoría

Procesa más declaraciones con menos fricción y mayor calidad.

Beneficio para el cliente

Entiende mejor el resultado y tiene acceso al justificante.

Riesgos / puntos críticos

Dependencia de fuentes de datos; requiere checklist y control de calidad.

6. 所得税模块

个人所得税：数据、模拟和带证据的提交。

活动个人所得税

流程向导

价值模拟

模块愿景

个人所得税活动（个人）：数据输入/组织、模拟和提交，带证据归档。

目标

通过可重复流程标准化所得税活动。
允许模拟和场景比较。
按纳税人保存证明和可追溯性。

范围

纳税人管理（个人客户）。
收入：工作、资本、活动、房地产、资产。
个人/联合模拟。
提交和归档。

人员和角色

角色	需求 / 主要用途
所得税经理	通过清单和模拟处理批量。
个人客户	理解结果、文档和证明。

功能设计

主要流程

所得税准备

年度活动。

创建所得税档案（年份）。
加载数据（手动/导入）和文档。
模拟场景（个人/联合）。
内部审查和审批。
提交和证明归档。

输出：已提交的所得税，带报告和证据。

屏幕（UI）

所得税向导：数据 + 文档 + 模拟。
场景比较。
报告和证明交付。

技术设计

实体和数据模型（最小）

实体	主要字段 / 注释
TaxReturn	id, client_id, year, status, totals, versions
IncomeItem	type, source, amount, attachments[]
Property	address, ref_catastral, usage, income/expenses
ReturnFiling	tax_return_id, filed_at, receipt, logs

权限和安全性（RBAC）

所得税经理编辑；主管批准；客户仅读取结果/证明。

验证和规则

按收入类型的文档清单。
一致性验证（房地产、收益、重复）。

建议的API（API优先）

POST /api/v1/renta/returns PATCH /api/v1/renta/returns/{id} POST /api/v1/renta/returns/{id}/simulate POST /api/v1/renta/returns/{id}/submit GET /api/v1/renta/returns/{id}/receipt

事件和审计

renta.return.simulated
renta.return.submitted
renta.receipt.saved

业务影响

对管理办公室的好处

以更少的摩擦和更高的质量处理更多申报。

对客户的好处

更好地理解结果并可以访问证明。

风险 / 关键点

对数据源的依赖；需要清单和质量控制。

6. Income Tax Module

Personal Income Tax: data, simulation and filing with evidence.

CampaignIncome Tax

FlowWizard

ValueSimulation

Module Vision

Personal Income Tax campaign (individuals): data entry/organization, simulation and filing, with evidence archiving.

Objectives

Standardize the income tax campaign with repeatable flows.
Allow simulation and scenario comparison.
Save receipts and traceability per taxpayer.

Scope

Taxpayer management (PF clients).
Income: work, capital, activities, real estate, assets.
Individual/joint simulation.
Filing and archiving.

People and roles

Role	Need / main use
Income tax manager	Process volume with checklist and simulation.
PF client	Understand result, documentation and receipt.

Functional Design

Main flows

Income tax preparation

Annual campaign.

Create income tax file (year).
Load data (manual/imports) and documentation.
Simulate scenarios (individual/joint).
Internal review and approval.
Filing and receipt archiving.

Output: Filed income tax with report and evidence.

Screens (UI)

Income tax wizard: data + documentation + simulation.
Scenario comparison.
Report and receipt delivery.

Technical Design

Entities and data model (minimum)

Entity	Main fields / notes
TaxReturn	id, client_id, year, status, totals, versions
IncomeItem	type, source, amount, attachments[]
Property	address, ref_catastral, usage, income/expenses
ReturnFiling	tax_return_id, filed_at, receipt, logs

Permissions and security (RBAC)

Income tax manager edits; supervisor approves; client read-only of result/receipt.

Validations and rules

Document checklist by income type.
Consistency validations (properties, yields, duplicates).

Suggested APIs (API-first)

POST /api/v1/renta/returns PATCH /api/v1/renta/returns/{id} POST /api/v1/renta/returns/{id}/simulate POST /api/v1/renta/returns/{id}/submit GET /api/v1/renta/returns/{id}/receipt

Events and audit

renta.return.simulated
renta.return.submitted
renta.receipt.saved

Business Impact

Benefit for the office

Process more returns with less friction and higher quality.

Benefit for the client

Better understand the result and has access to receipt.

Risks / critical points

Dependency on data sources; requires checklist and quality control.