Responsabilidades separadas
Manter um único host de captura, enquanto a interface consulta e controla o serviço.
Desktop · Integração fiscal
Agente Desktop Fiscal
Captura fiscal no ambiente do cliente, com serviço Windows independente da interface.
01 / Contexto
O problema
A captura depende de certificados e recursos da máquina do cliente. Vincular todo o processamento à janela da aplicação comprometeria a continuidade e misturaria interface com responsabilidade operacional.
02 / Implementação
A solução
Separação entre uma interface Electron/Next.js e um serviço Windows em Python. A aplicação permite configurar o acesso, selecionar certificados e CNPJs, verificar o ambiente e acompanhar a captura.
03 / Conexões
Como as partes se conectam
A interface é cliente do serviço local. O serviço concentra certificados A1, consultas NF-e/NFS-e, persistência de progresso e comunicação com a plataforma. A captura continua independente da janela da aplicação.
- 01Interface
Login, certificados e diagnóstico
- 02Serviço Windows
Captura e estado da execução
- 03Fontes fiscais
NF-e e NFS-e com certificado A1
- 04Plataforma
Sincronização e acompanhamento
Desafios de engenharia
Certificados locais
Preservar o certificado e sua senha no ambiente do cliente durante a comunicação com a plataforma.
Retomada do processamento
Persistir o progresso de captura e sincronização para lidar com reinícios e interrupções.
04 / Entrega
O que a solução oferece
Uma aplicação desktop com responsabilidades claras entre experiência de uso, captura fiscal e integração com o backend multi-tenant.
Arquitetura e tecnologias verificadas no README e na documentação técnica do agente local.