7

Fiz um emissor de NFS-e gratuito (padrão nacional) com núcleo em Rust e tela em Flutter

Com a migração dos municípios para a NFS-e do padrão nacional e as mudanças da Reforma Tributária (IBS e CBS), emitir nota de serviço ficou mais trabalhoso para quem não tem um sistema próprio. O emissor web do governo funciona, mas você redigita cliente, serviço e tributos a cada nota.

Por isso fiz o Baiacu NFS-e: um emissor para Windows, gratuito, que roda no seu computador e fala direto com o Ambiente Nacional da NFS-e.

🔗 https://github.com/williamlala/baiacu-nfse

O que ele faz

  • Você cadastra o cliente e o serviço uma vez; depois, cada nota sai em segundos.
  • Confere a DPS antes de transmitir (validação contra os XSD oficiais) e mostra o que precisa corrigir.
  • Assina com o certificado A1, transmite, gera a DANFSe em PDF e manda PDF + XML por e-mail para o cliente, saindo do seu próprio e-mail.
  • Fila de pendentes: caiu a internet, a nota espera e você envia depois.
  • Cofre de notas: busca no Ambiente Nacional todas as notas em que o CNPJ aparece, emitidas e recebidas, com exportação para Excel e relatório em PDF.
  • Vários prestadores (pensado para contadores), cada um com certificado, numeração e e-mail próprios.
  • Já traz o leiaute com IBS/CBS e as regras novas de locação de imóveis (NT 009).
  • Atualização automática pelas Releases do GitHub.

Como é por dentro

Para quem gosta da parte técnica:

Núcleo em Rust (~25 mil linhas), sem tela, compilado como nucleo.dll. Tudo o que é regra fica nele: banco, cadastros, montagem e assinatura da DPS, comunicação com a SEFIN, PDF, e-mail.

  • Banco cifrado: SQLite com SQLCipher (rusqlite com bundled-sqlcipher), com o OpenSSL ligado estaticamente. Nenhuma DLL do OpenSSL acompanha o programa.
  • Assinatura XML-DSig feita no próprio núcleo: C14N, SHA-256 e RSA-SHA256 no elemento com Id, com o certificado em <KeyInfo>.
  • Validação contra XSD com a libxml2 estática, porque as mensagens de erro dela já viram texto amigável na tela.
  • DANFSe desenhada em Rust, com o QR Code gerado localmente, sem serviço externo.
  • HTTP com ureq e e-mail com lettre.

Tela em Flutter (~36 mil linhas de Dart), falando com o núcleo por dart:ffi. A ponte é uma função só, nfse_chamar(id, metodo, args) com JSON. O trabalho roda numa thread do núcleo, e a resposta volta por um NativeCallable.listener, que o Dart aceita ser chamado de qualquer thread. Assim a tela nunca trava esperando disco, rede ou o scrypt da senha.

Atualização: o programa consulta a última release, baixa o .zip, confere o SHA-256 publicado ao lado dele, e um script espera o programa fechar, copia a versão nova por cima e reabre. Cadastros, notas e certificados ficam intocados.

Instalação: Inno Setup, para todos os usuários do Windows. O administrador é pedido só na instalação; depois, qualquer usuário usa e atualiza sem senha de admin.

O que aprendi no caminho

  • A SEFIN é exigente com o XML. A ordem dos elementos, as quebras de linha dentro da <Signature> e os campos opcionais que "não podem ir vazios" deram mais trabalho que qualquer regra de negócio.
  • Rust + Flutter por FFI funciona muito bem para desktop: a tela fica leve, e o núcleo é testável sem tela nenhuma.
  • Desenhar PDF na mão (sem biblioteca de layout) dá controle total, mas cada milímetro da DANFSe custa caro.

Avisos honestos

  • Por enquanto, só Windows 10 e 11.
  • O instalador ainda não é assinado digitalmente, então o Windows mostra o aviso do SmartScreen. Para seguir: Mais informações › Executar assim mesmo.
  • Comece pelo ambiente de homologação (testes, sem valor fiscal) antes de ir para produção.
  • O código está público para leitura, auditoria e contribuições por pull request. A licença está no repositório.

Quero a sua opinião

Se você emite NFS-e, cuida de empresas como contador ou já brigou com a SEFIN, eu adoraria saber:

  • o que faltou ou atrapalhou no seu município;
  • erros que encontrar (pode abrir uma issue);
  • ideias de melhoria.

Se o programa te ajudar, uma ⭐ no repositório ajuda outras pessoas a encontrá-lo.

Demonstração do fluxo básico do emissor Baiacu NFS-e

Carregando publicação patrocinada...
3

Projeto bem amarrado, e a parte de "avisos honestos" ajuda muito quem vai decidir instalar. Dois pontos sobre atualização e permissões, que costumam aparecer quando o programa começa a ter usuários:

  1. SHA-256 publicado ao lado do .zip protege contra download corrompido, mas não contra release adulterada: quem conseguir publicar na sua conta do GitHub troca o zip e o hash juntos. Uma assinatura com chave que fica fora do GitHub (minisign, que usa Ed25519, com a chave pública embutida no binário) fecha isso com pouco código e compensa em parte o instalador ainda não assinado.

  2. Pasta do programa gravável por todos os usuários resolve a atualização sem admin, mas qualquer processo rodando como usuário comum pode trocar o nucleo.dll que outro usuário da mesma máquina vai carregar (pense no contador com vários certificados A1). Duas saídas comuns: instalar por usuário em %LOCALAPPDATA% (cada um atualiza a própria cópia, sem admin), ou manter a pasta só leitura e atualizar por um serviço ou tarefa agendada que confere a assinatura antes de copiar.

Uma dica do lado do XML, que vale para qualquer documento fiscal assinado: guarde alguns XML assinados de referência por versão de NT e rode no CI uma comparação byte a byte depois da canonicalização. Quando a SEFIN muda o leiaute, é esse teste que avisa antes do usuário.

1

Muito obrigado pelas sugestões e pela explicação! Fui conferir a implementação e os pontos que você levantou procedem.

Vou ajustar essa arquitetura: manter o programa em Program Files com os binários protegidos, mover os bancos para ProgramData e usar a pasta temporária local de cada usuário para baixar as atualizações. Também Vou incluir um pequeno serviço de atualização, instalado inicialmente com elevação, que verificará a assinatura dos pacotes antes de substituir os arquivos. A chave privada de assinatura ficará fora do GitHub.

Sobre os XMLs de referência e os testes de canonicalização no CI, vou estudar isso ainda e como incorporar isso aos testes que já temos.

Agradeço muito pela contribuição! São melhorias importantes para distribuir o programa com mais segurança.

1

Achei bem interessante a escolha da stack, foge totalmente do padraozão que a gente ve em sistema fiscal no Brasil (geralmente um C# legado ou Delphi da vida). Rust no core pra lidar com XML, assinatura e PDF deve ter deixado o negocio voando, e o Flutter pra desktop da um visual bem mais moderno mesmo.

Sucesso com o projeto!

1

Muito obrigado pelo feedback!

Desde o início, um dos principais objetivos foi priorizar o desempenho, para que o sistema pudesse rodar com fluidez até mesmo em computadores mais antigos, mas sem abrir mão de uma interface moderna e agradável.

Foram realizados testes extensivos de desempenho, reaproveitamento de camadas visuais, otimizações de renderização e processamento de dados, buscando garantir respostas praticamente instantâneas, com carregamentos e atualizações visuais na casa dos milissegundos.

A combinação de Rust com Flutter foi justamente para conseguir o melhor dos dois mundos: desempenho e eficiência no processamento, aliados a uma interface moderna e responsiva.

Ainda há bastante espaço para melhorias, e é justamente por isso que gostaria que outras pessoas experimentassem o sistema. A ideia é validar esses resultados em diferentes computadores e cenários de uso, identificar possíveis limitações e receber sugestões que ajudem a aprimorar o projeto.

Valeu pela força!

1

Excelente ponto sobre simplicidade em producao. Na minha experiencia rodando servicos pequenos em VPS de 2GB de RAM, o maior ganho veio de ativar SQLite em modo WAL (PRAGMA journal_mode = WAL; PRAGMA synchronous = NORMAL;) e limitar memoria por container no Docker Compose. Evita OOM killer sem precisar manter banco pesado.

1

Boa observação! Inclusive já utilizei SQLite com WAL em outro projeto desenvolvido em Rust, justamente para permitir consultas e gravações simultâneas sem tanta contenção.

No caso do Baiacu, a arquitetura é um pouco diferente: ele é uma aplicação desktop, com processamento local, então não depende de uma VPS ou de containers Docker para funcionar.

Concordo que o SQLite é uma excelente opção para projetos que não precisam da complexidade de um banco de dados servidor. Muitas vezes conseguimos desempenho muito bom com uma arquitetura bem mais simples.

Obrigado pela contribuição!

1

Parabéns pelo projeto e pela transparência técnica. É raro ver um software fiscal que cobre o ciclo inteiro — validação, assinatura, transmissão, PDF, e-mail, contingência e atualização — e ainda documenta claramente as limitações atuais.

A discussão sobre o atualizador levantou um ponto importante de segurança. Como sugestão complementar, eu também testaria cenários de interrupção durante download, validação e substituição dos binários, garantindo rollback para a versão anterior e evitando iniciar uma atualização parcialmente aplicada. Um teste automatizado que simule queda de energia nesses pontos pode valer bastante para quem vai confiar o trabalho fiscal ao programa.

Rust no núcleo + Flutter via FFI parece uma escolha bem coerente para manter a interface responsiva sem abrir mão de um núcleo testável. Parabéns pela execução e pela disposição de incorporar feedback!

1

Muito obrigado pelo comentário e pela sugestão! Estou revendo o atualizador para incorporar os pontos levantados aqui.

No novo pacote, também vou incluir um mecanismo de rollback para que a atualização só seja considerada concluída depois de aplicada por completo. A ideia é preservar a versão anterior e, em caso de falha ou interrupção, permitir a recuperação sem abrir o programa com uma mistura de arquivos de versões diferentes.

Vou incluir testes de interrupção nas etapas de download, validação e instalação. A simulação de queda de energia é especialmente importante, porque exige verificar a recuperação na próxima abertura, além de tratar os erros durante a atualização.

Agradeço muito pela contribuição! Esse cuidado faz bastante sentido para um programa usado no trabalho fiscal.

1

Eu não emito notas, mas achei curioso o uso de Rust nesse projeto.
Imagino que foi algo para você treinar e se desenvolver nessa tecnologia, certo ?

Também achei a adoção do Flutter para desktop, outra escolha fora do mainstream.
Acho que outros teriam usado .Net ou até Java (Swing), mas não Flutter.
Flutter é ótima para interfaces, e Dart é uma delicinha de se programar.

Enfim, achei que você pensou em várias coisas (inclusive InnoSetup), o que demonstra que procurou resolver todo o ciclo de dor de um usuário.

Só não entendi como um software que foi instalado como admin, depois cada usuário comum conseguirá atualizar a versão sem precisar de elevação de privilégio.

Parabéns pelo projeto!

1

Valeu, Caio! Obrigado pelo comentário!

Escolhi Rust principalmente pelo desempenho. Por ser uma linguagem de baixo nível, permite uma execução extremamente rápida, mesmo em computadores mais modestos. Isso fica evidente nos testes com pesquisas envolvendo centenas de milhares de notas, mantendo o programa bastante responsivo.

O Flutter foi escolhido principalmente pelo visual moderno e pela flexibilidade na construção da interface.

Quanto às atualizações, o Inno Setup solicita privilégios administrativos apenas na primeira instalação e configura as permissões da pasta do programa para permitir alterações por usuários comuns. Assim, o atualizador consegue substituir os arquivos sem solicitar nova elevação.
Mas irei conferir novamente essa parte já que tu comentou.

Obrigado novamente pelo feedback!