cd ..

[ project / 02 ] · Platform, in active development

FiscalHub.

A multi-tenant platform for Brazilian NFS-e management, architected for SaaS scale from day one.

private codebase
Node.jsTypeScriptPostgreSQLBullMQRedisPrismaReactDocker
fiscalhub: dashboard

NFS-e

781

processadas

orgs

12

ativas

SPED

3

gerados

intake
parse
validate
store
live
documentos recentes
31250...2204R$ 980,00processed
31250...8821R$ 4.820,00processed
31250...3317R$ 12.440,00processing
31250...9102R$ 650,00queued

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

01

Multi-tenant NFS-e management

NFS-e ingestion, parsing and storage across multiple organizations, fully isolated, in a single platform.

02

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.

03

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.

04

Async processing pipeline

BullMQ workers handle ingestion, parsing and sync off the request path: retryable, observable and isolated per tenant.