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 (
rusqlitecombundled-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
ureqe e-mail comlettre.
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.
