FacturaScripts — Facturación y contabilidad¶

Emite facturas, gestiona ingresos y gastos, y cumple con la normativa Verifactu de la Agencia Tributaria. Sustituiría a Holded, Contasimple y Sage.

Como usuario¶

Qué podrás hacer¶

Emitir facturas y presupuestos
Gestionar ingresos y gastos
Generar modelos tributarios
Cumplir con Verifactu (obligatorio en España)
Conectar con la tienda de la finca
Automatizar facturación recurrente

Cómo se accederá¶

Navegador	Ubuntu	Android	FireTV
https://facturacion.sc (solo empresa/admin)	Navegador	Navegador	No aplica

Primeros pasos (previstos)¶

Abre https://facturacion.sc, inicia sesión. Configura los datos fiscales de la empresa y verifica que la conexión Verifactu está activa. Crearía tu primera factura desde el panel.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Mautic	Datos de clientes
n8n	Facturación automática tras completar un flujo
Drupal Commerce	Tienda de la finca
Nextcloud	Guardar facturas como PDF

Servicios que lo hacen posible¶

Docker — contenedor facturascripts
Caddy — proxy inverso (intermediario que recibe peticiones y las deriva) con TLS (cifrado de comunicaciones)
Authentik — autenticación Proxy (grupo empresa)
Verifactu — cumplimiento normativo AEAT

Para el administrador (diseño previsto)

Datos	Valor
LXC (contenedor ligero de Proxmox)	Pendiente de asignación
IP	Pendiente de asignación
Tier	B
Impacto	🟡 Medio

Docker: facturascripts
Healthcheck: curl https://facturacion.sc
ZFS persistente: rpool/datos/facturascripts → /opt/facturascripts/
Logs: docker logs facturascripts
Backup: PBS (sistema de copias de seguridad de Proxmox) diario + dump SQL
Problemas comunes:
- "No cumple Verifactu" → verificar configuración de Verifactu

Para el arquitecto (diseño previsto)

graph LR
    FS[FacturaScripts]
    MT[Mautic]
    N8[n8n]
    DC[Drupal Commerce]
    NC[Nextcloud]
    FS --> MT
    N8 --> FS
    DC --> FS
    FS --> NC

Red: vmbr2
Puerto: 80
Pi-hole: facturacion.sc → IP pendiente
Caddy: forward_auth + reverse_proxy
Authentik: provider Proxy, grupo empresa
Orquestación:

Componente	Recurso
Rol Ansible	`roles/facturascripts/`
Playbook	`deploy-facturascripts.yml`
Módulo OpenTofu	`modules/facturascripts/`
Semaphore	✓
Forgejo Actions	✓
Repo	`ansible/playbooks/deploy-facturascripts.yml`