Facturalandia

Plataforma SaaS de facturación electrónica CFDI 4.0, genuinamente multi-tenant por organizaciones, con auth in-house y sync en tiempo real.

Contexto

Facturalandia es una plataforma de facturación electrónica para México conforme a CFDI 4.0. Es el único producto del ecosistema genuinamente multi-tenant: cada organización opera con su propia llave de Facturapi cifrada con AES-256-GCM, su webhook firmado auto-registrado y sus propios buckets de almacenamiento.

Arquitectura

Monorepo TypeScript (Turborepo) con 5 aplicaciones y una capa compartida:

apps/ — api (Express 5 + Mongoose), auth (login + 2FA), invoicing (app principal), materialization (read-only) y purchases.
domains/ — lógica de negocio organizada como vertical slices.
shared/ — 10 paquetes: cliente API, design system, catálogos SAT, tipos Zod y utilidades.

La autenticación es 100% in-house con argon2id (sin servicios de terceros). La sincronización en tiempo real ocurre por webhooks firmados de Facturapi más SSE hacia los clientes — no hay Firebase.

Stack

Runtime: Node 22. Backend: Express 5 + Mongoose (MongoDB).
Frontend: React 19 + Vite 6 + TanStack Query + React Hook Form + Zod, en un monorepo Turborepo.
Facturación: FACTURAPI (CFDI 4.0). Pagos: Stripe.
Almacenamiento: Google Cloud Storage (PDFs y evidencias).
Deploy en Heroku; monorepo orquestado con Turborepo.

Retos técnicos

Emisión de CFDI 4.0 de Ingreso (I), Egreso (E) y Pago (P), cancelación con los motivos del SAT, descarga de PDF/XML, certificados FIEL y captura masiva pegando filas desde Excel.
Ciclo de cancelación SAT completo, con notificaciones en tiempo real por webhooks firmados + SSE.
Transacciones Mongo sobre replica set y backfill idempotente de facturas históricas.
Spotlight search transversal y jobs en segundo plano con logs streameados por SSE.
Aislamiento real entre organizaciones: llaves cifradas, webhooks y buckets por tenant.

Resultado

El tiempo de emisión por factura bajó de 13 a 4.5 minutos y los errores fiscales de 12 a 3 por mes, con más del 85 % de las operaciones ya corriendo en la plataforma.

Un SaaS de facturación multi-tenant en producción, donde la misma capa compartida (cliente HTTP, design system, catálogos SAT y tipos Zod) alimenta autenticación, facturación, compras y materialización.