Manual completo — GP Nómina

1. Introducción

GP Nómina es el módulo de nóminas del ecosistema OEM. Está pensado para reemplazar de forma realista a a3NOM o Sage Nominaplus en gestorías laborales españolas, y crecer hasta cubrir el segmento de empresa media y grande.

2. Posicionamiento competitivo

Diferenciadores GP Nómina

• Precio competitivo: ~150-500 €/mes por gestoría (vs 800+ €/mes de a3).
• Portal cliente moderno en Blazor, no ASP legacy de 2005.
• Dictado por voz de incidencias con Whisper local + Mistral.
• Integración nativa con marcaje propio de OEM: fichajes → incidencias automáticas.
• Pipeline IA de convenios — OCR Tesseract + LLM + revisor humano firmante.
• Integración con Gestión Profesional: asientos de nómina automáticos.
• UI coherente con gespro y gp_legal.

3. Alcance del producto

Objetivo

Producto de nómina española serio, con catálogo de convenios mantenido, integraciones oficiales (SILTRA/CRETA/RED/AEAT) y portal cliente. Vendido a gestorías laborales en Fase 1 y ampliado a empresas grandes en Fase 3.

No-objetivos explícitos

Qué SÍ entra en el MVP (Fase 1)

• Alta de gestoría + N empresas cliente (multi-empresa nativo).
• Alta de centros de trabajo y CCC (código cuenta cotización).
• Alta de empleados con datos personales + fiscales (IRPF con hijos y situación familiar).
• Alta de contratos — tipo contrato SEPE (100, 289, 401…), jornada, categoría, salario pactado.
• Emisión de nómina mensual con motor completo (ver sección 5).
• PDF de recibo de salarios modelo oficial (RD 1620/2011).
• Modelo 111 (retenciones trimestrales) y Modelo 190 (resumen anual IRPF).
• Ficheros CRETA/SILTRA para bases mensuales a SS.
• Fichero SEPA XML (pain.001) para transferencias de nómina.
• 10-15 convenios cargados a mano y validados.
• Multi-usuario con roles.
• Portal cliente básico en Blazor.

Qué NO entra en el MVP (parking explícito)

• Retribución variable compleja (bonus multi-tramo, RSU).
• Planes de pensiones de empresa.
• Retribución en especie (ticket restaurante / guardería) con lógica fiscal específica.
• Portal empleado individual (Fase 2).
• Gestión de tiempo integrada con circuito de aprobación (Fase 2).
• Firma electrónica del recibo (Fase 2).
• Conectores ERP (SAP, D365, Business Central) — Fase 3.
• Pipeline IA totalmente automático — Fase 2.

4. Modelo de datos

Todo el esquema usa prefijo Nom* para no colisionar con Lex* (gp_legal) ni tablas de gespro. Convive en la misma BD oem2026 cuando el cliente ya tiene gespro, o BD propia oem_nominas.

Núcleo

Convenios y categorías

Nómina y cierre

5. Motor de cálculo

Piezas técnicas, todas deterministas y testables aisladas. Cada una con tests unitarios contra casos oficiales SS/AEAT + comparación cruzada con recibos reales de a3/Sage antes de vender.

5.1 Bases de cotización SS

• Base contingencias comunes — salario bruto + prorrata pagas extras, respetando topes (base máxima 2026: 4.909,50 €).
• Base AT/EP (accidentes) = base comunes.
• MEI (Mecanismo Equidad Intergeneracional) — 0,7% en 2026.
• Cuotas empresa: 23,60% común + AT/EP variable + 5,50% FP + 0,20% FoGaSa.
• Cuotas trabajador: 4,70% común + 1,55% FP + 0,10% MEI.

5.2 Cálculo IRPF

• Tablas oficiales AEAT.
• Situaciones familiares (art. 81 bis LIRPF).
• Regularización mensual cuando cambian condiciones.
• Regularización anual en diciembre — cuadre con Modelo 190.

5.3 Incapacidad temporal (IT)

• Enfermedad común: días 1-3 sin pago, 4-15 empresa (60% base), 16+ INSS (60-75%).
• Accidente: desde día 1, 75% INSS/Mutua.
• Complementos IT de convenio (muchos suben al 100%).

5.4 Otros

• Prorrata pagas extras (2 pagas o mensualizadas).
• Vacaciones, permisos ET art. 37, horas extras.
• Finiquitos e indemnizaciones (despido objetivo, improcedente, fin contrato).
• Embargos (importe inembargable art. 607 LEC) y pensión alimentos.
• Anticipos y adelantos.

6. Catálogo de convenios asistido por IA

Fase 1 — manual asistido por IA

1. Se carga un convenio (PDF del BOE) al sistema.
2. OCR si es escaneado (Tesseract).
3. LLM extrae JSON estructurado (categorías, tablas salariales, complementos).
4. UI muestra el JSON lado-a-lado con el PDF original.
5. Revisor valida cada categoría o corrige.
6. Al aprobar → nueva NomConvenioVersion firmada con fecha + revisor.
7. El motor usa la versión activa correspondiente al período.

Fase 2 — pipeline automático

• Monitor de REGCON (polling diario).
• Detección de convenio nuevo → descarga automática.
• Pipeline OCR + LLM sin intervención humana en primera pasada.
• Cola de revisión (bandeja tipo email).

Modelos LLM

7. Integraciones oficiales

8. Portales

Portal cliente (para la gestoría)

Blazor Server, mismo stack que gp_legal_portal. Login por magic-link email.

• Bandeja de incidencias del mes.
• Fecha de corte configurable.
• Descarga masiva de recibos.
• Notificaciones por email al cerrar nóminas.

Portal empleado (Fase 2)

• Consulta de recibos personales.
• Solicitud de permisos con circuito de aprobación.
• Vacaciones disponibles.
• Firma electrónica del recibo.

9. Flujo mensual típico

1. Días 20-25: clientes suben incidencias al portal.
2. Día 25: cierre de incidencias (fecha configurable).
3. Días 26-27: gestor revisa/completa desde FrmIncidencias.
4. Día 28: ejecuta FrmCierreMes — calcula todas las nóminas en batch.
5. Días 28-29: revisión de nóminas anómalas.
6. Día 29: emite recibos PDF y los publica en portal.
7. Días 30-31: genera SEPA, SILTRA FAN, CRETA. Envío a SS.
8. Trimestral: Modelo 111.
9. Enero: Modelo 190 anual.

10. Cierre de mes

La ventana FrmCierreMes permite:

• Seleccionar período (mes/año) y empresas.
• Recalcular en batch todas las nóminas activas.
• Filtros: solo con incidencias, solo variaciones >X%, solo bajas.
• Vista preliminar en tabla con delta vs mes anterior.
• Cerrar período — bloqueo de modificaciones sin desbloqueo explícito.

11. Emisión de recibos

Recibo de salarios generado con QuestPDF (sin licencia limitada) siguiendo el modelo oficial actualizado (RD 1620/2011).

• Cabecera empresa (denominación, CCC, CIF).
• Datos empleado (nombre, NIF, NAF, categoría, antigüedad).
• Período de liquidación.
• Detalle de devengos y deducciones (una línea por concepto).
• Bases de cotización SS y tipo IRPF aplicado.
• Líquido total.
• Firma electrónica (opcional, con AutoFirma).
• Huella SHA-256 guardada en NomNomina para trazabilidad legal.

12. Envíos oficiales

SILTRA FAN

1. Desde FrmEnvioSs, seleccionar empresa + período cerrado.
2. Se genera fichero FAN con bases mensuales.
3. Validado localmente antes de exportar.
4. Se abre carpeta con el .fan listo para subir al ejecutable SILTRA oficial.

CRETA (SOAP)

Servicio web con certificado del autorizado. Envío directo desde la app. Respuesta almacenada con estado y reintento manual/programado.

SEPA pain.001

Un click desde FrmSepa: seleccionar cuenta emisora, período y modo (todas o subset). Genera XML pain.001 válido para todos los bancos españoles.

Modelos 111 y 190

FrmModelo111 y FrmModelo190 generan CSV/XML compatible con el portal AEAT.

13. Arquitectura técnica

14. Integración con el ecosistema OEM

15. Seguridad y trazabilidad

• DPAPI LocalMachine para conexión BD.
• Backup automático diario + subida opcional Cloudflare R2 vía rclone.
• Firma SHA-256 del recibo PDF en NomNomina.
• Firma de convenio en NomFirmaVersion con TSA RFC 3161 opcional.
• Auditoría completa en NomAuditoria.
• Cierre de período bloquea modificaciones sin desbloqueo explícito.
• Roles: gestor, supervisor, solo consulta.

16. Roadmap por fases

✓ Completada Fase 0 — Andamiaje (2026-08-03)

• csproj, Program, AppSettings con DPAPI.
• Helpers copiados de gp_legal.
• Login SSO con USUARIOS_GP.
• FrmPrincipal con 4 tarjetas.
• I18n día 1 (es/ca/en).
• N001_schema_base.sql con 8 tablas base.

▶ En curso Fase 1 — Motor + convenio piloto (~6 semanas)

• Modelo de datos completo.
• Motor: bases SS, IRPF, prorratas, IT básica.
• 1 convenio piloto validado a mano.
• UI: alta empresa, empleado, contrato, incidencias, emisión individual.
• FrmCierreMes emisión batch.
• Recibo PDF con QuestPDF.

Hito de aceptación: emitir la nómina real de un empleado real y compararla contra el recibo que le sacó a3 el mes pasado. Cero desviación o no se avanza a Fase 2.

Pendiente Fase 2 — Convenios masivos + integraciones (~4 semanas)

• FrmConvenios con revisor humano asistido por IA.
• Precarga inicial 10-15 convenios.
• Generadores FAN (SILTRA), CRETA, SEPA, 111, 190.
• Sistema RED (afiliación) — export AFI.
• Homologación SILTRA con banco de pruebas TGSS.
• Portal cliente Blazor.

Pendiente Fase 3 — Escalado + gran empresa (~4 semanas)

• Retribución variable compleja.
• Retribución en especie con lógica fiscal.
• Planes de pensiones de empresa.
• Conectores import a3/Sage y export SAP/D365.
• Portal empleado.
• Firma electrónica del recibo (AutoFirma).
• Pipeline IA automatizado.
• API pública .NET 8.
• Cloud SaaS opcional.

Recurrente Fase 4 — Mantenimiento continuo

• Parche obligatorio primera semana enero (SMI, tablas IRPF, MEI).
• Actualización mensual convenios (pipeline IA + revisor).

Total Fase 0-3: ~15 semanas full-time. MVP vendible al final de Fase 1 (~7 semanas).

17. Modelo comercial

Break-even estimado con 8-12 gestorías activas. Precios sujetos a revisión — pídenos oferta.

18. Soporte y contacto

• Soporte técnico incluido en cualquier plan de pago.
• Parche obligatorio primera semana enero (SMI, tablas IRPF, MEI).
• Actualización mensual de convenios (pipeline IA + revisor).
• Homologación SILTRA gestionada por OEM con banco de pruebas TGSS.
• Migración desde a3/Sage en Fase 3.

Contacto: info@oem-informatica.com · Web: www.oem-informatica.com