Manual completo — Gestión Profesional

1. Introducción

Gestión Profesional es un ERP integral para pymes y despachos españoles: clientes, ventas, compras, almacén, contabilidad, banking PSD2, informes y asistente IA en una única aplicación WinForms sobre SQL Server.

2. Instalación

Requisitos

• Windows 10/11 x64 o Windows Server 2019+.
• SQL Server 2019+ (Express es suficiente para <10 usuarios). Instancia con nombre — típicamente USER-PC\SQLEXPRESS.
• 4 GB RAM mínimo, 8 GB recomendado.
• 2 GB de disco libre.

Proceso

1. Ejecutar el instalador Inno Setup (GestionProfesionalSetup_AAAA.M.D.N.exe).
2. Elegir carpeta destino (por defecto C:\Program Files\GestionProfesional\).
3. Elegir modo: servidor (crea BD) o cliente (conecta a servidor existente).
4. Introducir cadena de conexión SQL. Se guarda cifrada con DPAPI LocalMachine en conexion.dat.
5. Al primer arranque se ejecutan las migraciones idempotentes que crean/actualizan el esquema.

3. Primer arranque

1. Al abrir por primera vez se pide crear un usuario administrador (queda como admin por defecto).
2. Se accede al menú principal con las tarjetas de módulo disponibles según licencia.
3. Antes de operar, configurar en Mantenimiento → Datos de la empresa: NIF, razón social, domicilio, IAE, forma jurídica.
4. Configurar series de venta y compra en Mantenimiento → Series. La serie por defecto se marca aquí — todo el sistema la consulta desde Sesion.SerieDefecto().
5. Configurar IVA (tipos vigentes 21% / 10% / 4% / 0%) y recargos de equivalencia.

4. Licencia y activación

Desde 2026 GP usa el sistema de licencia v2: un fichero .key firmado con RSA/Ed25519 que declara los módulos activos y el vencimiento.

Módulos disponibles

Cómo se activa

1. Se abre FrmActivacion (menú Ayuda → Licencia).
2. La app calcula la huella de hardware: MachineGuid + MachineName + serial del disco.
3. El botón Enviar huella abre correo SMTP a licencias@oem-informatica.com con la huella y los datos del cliente.
4. OEM emite el .key firmado usando la herramienta --gen-lic y lo devuelve.
5. El cliente pega el contenido del .key en la ventana o carga el fichero. Al aceptar, se valida la firma y se activan los módulos.

5. Clientes y proveedores

Ficha 360 unificada: datos fiscales, contactos, dirección de envío/facturación, condiciones de pago, IBAN SEPA, formas de contacto (email, teléfono, WhatsApp).

Vista rápida

• Buscador incremental por NIF, nombre, teléfono o email.
• Timeline unificado: presupuestos, facturas, comunicaciones, seguimiento comercial.
• Botón WhatsApp integrado (usa la convención MOVIL = TELEFONO2).
• Enlace a documentos comerciales, contratos y facturas.
• Datos de contacto secundarios (personas de contacto por rol: administración, técnico, dirección).

Seguimiento comercial

En FrmSeguimientoCliente se registra cada interacción con el cliente (llamada, email, visita, mensaje WhatsApp). Cada interacción tiene tipo, fecha, comentario y usuario responsable. El asistente IA puede resumir el histórico con un click.

6. Ventas y facturación

Circuito documental

El circuito estándar de venta sigue la cadena: Presupuesto → Pedido → Albarán → Factura. Cada documento genera el siguiente conservando la trazabilidad completa.

Series y numeración

• Cada tipo de documento tiene su serie configurable en Mantenimiento → Series.
• La serie por defecto se lee siempre desde Sesion.SerieDefecto().
• Rectificativas usan Sesion.SerieRectificativaDefecto().

Facturas simplificadas

Para venta al por menor, el sistema soporta factura simplificada (ticket) con emisión Verifactu.

Cobros

• Cobro contado desde la propia factura.
• Vencimientos configurables (30/60/90 días, fin de mes, etc.).
• Remesas SEPA pain.008 para cargo directo.
• Conciliación con extracto bancario N43 o directamente con el módulo Banking (PSD2).

7. Compras

Documentos

Pedidos, albaranes y facturas de proveedor con el mismo esquema que ventas (Presupuesto → Pedido → Albarán → Factura).

Importación de facturas PDF

Desde FrmImportarFacturasPdf se procesa por lotes un directorio de PDFs de proveedores. El pipeline es:

1. Extracción de texto con PdfPig (o OCR con Tesseract si es escaneado).
2. El LLM identifica proveedor, base, IVA, total, número, fecha y líneas.
3. La UI muestra el JSON extraído con el PDF al lado para validar/corregir.
4. Confirmar → crea la factura de compra en la BD.

8. Almacén

• Multi-almacén con traspasos entre almacenes.
• Series y lotes (obligatorio para farmacia, alimentación, cosmética).
• Inventario físico con captura por lector código de barras (compatible con escáneres USB HID estándar).
• Regularización de existencias con generación automática de asiento contable de ajuste.
• Valoración por precio medio ponderado, FIFO o coste real.
• Alertas de stock mínimo y punto de pedido.

9. Contabilidad

Requiere licencia del módulo finanzas.

Plan contable

• PGC 2007 español precargado (grupos 1-9 con desglose).
• Personalización de cuentas por empresa.
• Multi-nivel: cuenta, subcuenta, auxiliar.

Asientos automáticos

Los asientos contables se generan automáticamente desde:

• Facturas de venta y de compra (con desglose de IVA).
• Cobros y pagos.
• Nóminas emitidas por GP Nómina (cuando ambos módulos están instalados).
• Movimientos bancarios importados por el módulo Banking.

Modelos AEAT

Cierre de ejercicio

Bloqueo por períodos (mes/trimestre/año). Regularización de existencias, amortizaciones, apertura del ejercicio siguiente asistida.

10. Módulo Banking (PSD2)

El módulo Banking (introducido en 2026-08) realiza pull PSD2 diario de movimientos bancarios usando Afterbanks como integrador ServicePK. Se ejecuta como servicio Windows .NET 10.

Tablas

• BANCOS_CUENTAS — cuentas monitorizadas por empresa.
• BANCOS_MOVIMIENTOS — extracto normalizado con estado (pendiente / contabilizado).
• BANCOS_REGLAS — reglas de auto-contabilización (patrón concepto → cuenta contable + centro de coste).
• BANCOS_LOG — histórico de peticiones al agregador.

Reglas de contabilización

Cada movimiento importado se contrasta con las reglas activas. Las que hacen match generan asientos en estado BORRADOR=1 — el contable revisa y confirma en bloque.

11. Enlace con GP Nómina

Si el cliente instala también GP Nómina, el enlace es automático:

• Login único (SSO) sobre la tabla compartida USUARIOS_GP.
• Al cerrar el mes en GP Nómina se exportan los asientos de nómina a la contabilidad de GP.
• Los asientos entran en la Contabilidad como BORRADOR=1 y quedan pendientes de validar.
• Cuentas y centros de coste del PGC son coherentes en ambos módulos.

12. Asistente IA

El asistente IA está integrado en varias pantallas y ofrece:

• Dictado por voz (Whisper local) para notas, seguimientos, incidencias.
• Chat con tus datos: preguntas en lenguaje natural que se resuelven con introspección de la BD.
• Plantillas inteligentes: redacción asistida de emails, presupuestos, cartas de reclamación.
• Resumen de cliente: síntesis del histórico comercial en 3 líneas.
• Descubrimiento automático de formularios y mappings — pieza clave del plan de asistente auto-extensible.

Modelos

13. WhatsApp Business (API oficial Meta)

Desde 2026, el envío de mensajes/documentos por WhatsApp usa la API oficial de Meta (Cloud API) — reemplazando la integración anterior con open-wa que quedó obsoleta.

Puntos donde aparece

• FrmCliente — botón "Enviar mensaje" al móvil del cliente.
• FrmVentaDoc — botón "Enviar factura/albarán" que sube el PDF como media y envía documento.
• FrmSeguimientoCliente — registro automático de las comunicaciones enviadas.

Modo TEST local

Con tokens que empiezan por TEST-* se activa el modo TEST: los mensajes se registran en log pero no se envían realmente. Útil para desarrollo y demo.

14. Verifactu

Verifactu es el sistema oficial de facturación electrónica de la AEAT (Real Decreto 1007/2023). GP lo implementa de forma nativa.

Componentes

• Cálculo del huella + encadenamiento obligatorio.
• Firma XAdES con certificado de la empresa.
• Envío al servicio web AEAT — modo Verifactu (envío inmediato) o no Verifactu (conservación local para posible requerimiento).
• Generación del QR obligatorio en la factura.
• Log completo de envíos con estado (aceptada / rechazada / mensaje).

15. Informes

El módulo Informes (portado en 2026-07 desde GesPro Pyme) contiene 36 informes catalogados por área (ventas, compras, almacén, contabilidad, gestión, IVA).

Motor

• Plantillas .frx generadas programáticamente con FastReport OpenSource.
• Preview integrado, exportación a PDF, Excel, Word.
• Cero MSChart (usa gráficos nativos de FastReport para respetar la licencia OpenSource).

Catálogo

El catálogo completo está documentado en Reports/Informes/CATALOGO_INFORMES.md. Cada informe tiene código, área, descripción y parámetros.

16. Multi-empresa

GP soporta multi-empresa nativo: una única instalación gestiona N empresas cliente (útil para gestorías o grupos empresariales).

• Cambio de empresa desde el menú principal sin reiniciar.
• BD compartida con separación por columna Id_Empresa.
• Contabilidad independiente por empresa (planes contables separados si se desea).
• Series y numeraciones independientes por empresa.
• Permisos por usuario × empresa.

17. Acceso remoto (Cloudflare Tunnel)

Para acceso remoto seguro sin exponer SQL Server a internet, GP usa Cloudflare Tunnel + Access con Service Token.

Arquitectura

Cliente remoto  →  túnel Cloudflare (SSL)  →  gestionprofesional.controlhorarios.net
                                          →  Cloudflare Access valida Service Token
                                          →  cloudflared en la LAN del cliente
                                          →  SQL Server en 127.0.0.1:1433

Uso en el cliente

1. Se ejecuta abrir_tunel_sql.bat incluido en la instalación.
2. El túnel expone SQL Server en 127.0.0.1:23501.
3. GP conecta como si fuera un SQL local en el 23501.

18. Backup y seguridad

• Backup diario automático con verificación de restauración periódica.
• Subida opcional a Cloudflare R2 / AWS S3 vía rclone.
• DPAPI LocalMachine para cifrar cadenas de conexión y secretos.
• Log de auditoría — quién hizo qué cuándo con IP y sesión.
• Roles configurables por módulo y por operación (crear/editar/borrar/imprimir).

19. Actualizaciones y build

Versionado

Formato AAAA.M.D.N: año.mes.día.número de build del día. El script _version.ps1 autoincrementa el número al compilar.

Distribución

20. Soporte

• Email: info@oem-informatica.com
• Licencias: licencias@oem-informatica.com
• SAT remoto: descarga Supremo y comparte el ID+contraseña.
• Actualización continua incluida en el mantenimiento anual.