[ project / 02 ] · Platform, in active development
FiscalHub.
A multi-tenant platform for Brazilian NFS-e management, architected for SaaS scale from day one.
organizações
NFS-e
781
processadas
orgs
12
ativas
SPED
3
gerados
interface sketch · production system, private codebase
about the project
FiscalHub is a platform for companies that need to centralize, monitor and export Brazilian NFS-e (Nota Fiscal de Serviço Eletrônica) across multiple sources for Receita Federal compliance. The foundation was deliberately built for SaaS scale (multi-tenancy, async pipelines, isolated per-org data), even though it is not a commercial SaaS product yet. Core modules are already working: XML ingestion, NFS-e parser, SPED EFD generation, email-based document intake and an analytics dashboard. This is a live build, not a prototype.
Multi-tenancy is enforced at two independent levels: the application layer and the database layer. Both work together so that no organization can ever access another's data, even under edge cases. The architecture was a deliberate early decision: retrofitting tenant isolation into a running system is far more expensive than building it correctly from the start.
Authentication is session-based with instant revocation support: logging out or changing a password invalidates access immediately, without waiting for token expiry. The frontend handles session refresh transparently, holding concurrent requests in a queue during renewal so users never see interruptions. The fiscal XML parsers were written with correctness as a priority: Brazilian fiscal documents have several subtle formatting requirements that off-the-shelf parsers get wrong, so the parsing logic was built and validated manually against real documents.
The SPED EFD ICMS/IPI generator produces the pipe-delimited, ISO-8859-1 encoded file required by the Receita Federal specification: no external library, built directly to the official layout manual. Each organization can also receive documents via email: send an XML to a dedicated address and it lands in the processing queue automatically.
project.meta
- type
- Platform, in active development
- stack
- Node.js · TypeScript · PostgreSQL · BullMQ · Redis · Prisma · React · Docker
- source
- private
what it does
Key features
Multi-tenant NFS-e management
NFS-e ingestion, parsing and storage across multiple organizations, fully isolated, in a single platform.
SPED EFD ICMS/IPI generator
Produces the official pipe-delimited file built to Receita Federal spec, covering all required blocks, with a preview endpoint that validates before generating.
Email-based document intake
Each organization gets a dedicated email address. Attach XMLs and they land automatically in the processing queue, no manual upload needed.
Async processing pipeline
BullMQ workers handle ingestion, parsing and sync off the request path: retryable, observable and isolated per tenant.