Introducción

TributaPro — Documentación técnica de la suite

TributaPro es una suite de impuestos para Costa Rica compuesta por dos aplicaciones que comparten el mismo proyecto Firebase (Firestore):

AppQué haceSección
Facturación electrónica (App B — “Facturador”)Emite comprobantes electrónicos integrándose con Hacienda (v4.4): POS, facturas, tiquetes, notas, FEC, exportación.Facturación electrónica
Contabilidad y declaraciones (App A — repo principal)Procesa facturas, arma libros de IVA y genera declaraciones (D-104 / D-153), con conciliación y ajustes de IVA.Contabilidad y declaraciones

Stack común

  • Next.js + TypeScript + Tailwind CSS, desplegado en Vercel.
  • Firebase: Firestore (datos), Auth, Storage, Cloud Functions.
  • Dominio: Costa Rica, idioma español, moneda base CRC.

Cómo se conectan

Ambas apps usan el mismo Firestore. La facturación (App B) emite comprobantes y la contabilidad (App A) los consume/procesa para los libros y declaraciones. No se integran por HTTP, sino por los datos compartidos.

Cómo leer esta documentación

  • Facturación electrónica — arquitectura, cálculos de IVA/exoneración/MAG, flujos (POS, NC/ND, anulación, plantillas, FEC) y el XML v4.4.
  • Contabilidad y declaraciones — arquitectura, cálculos de los libros y formularios, ingesta de facturas, overrides de IVA y modelo de datos.

Referencia para desarrolladores y para auditar el cumplimiento con Hacienda. Describe comportamiento y reglas de negocio (no incluye secretos ni datos de clientes).