Análise e Auditoria EFD Fiscal em Go
Uma solução moderna e eficiente para análise e auditoria do SPED Fiscal, desenvolvida em Go.
O que é o SPED Fiscal?
A Escrituração Fiscal Digital (EFD) representa uma revolução na forma como as empresas prestam informações ao fisco. É um arquivo digital que reúne a escrituração de documentos fiscais e outras informações de interesse dos fiscos estaduais e da Receita Federal do Brasil, bem como registros de apuração de impostos referentes às operações das empresas.
Motivação
No complexo cenário tributário brasileiro, as empresas enfrentam diariamente o desafio de manter-se em conformidade com uma legislação em constante evolução. O calendário fiscal é extenso, com múltiplas obrigações e prazos rigorosos estabelecidos pelo FISCO.
A Realidade das Empresas
- Pressão por Prazos: Muitas vezes, o cumprimento dos prazos se sobrepõe à qualidade das informações
- Complexidade Operacional: Mudanças frequentes na legislação exigem adaptação constante
- Riscos Fiscais: Erros nas declarações podem resultar em multas significativas
- Custo de Conformidade: Manter uma estrutura para atender todas as exigências fiscais é dispendioso
Nossa Solução
Este projeto nasce da necessidade de simplificar e automatizar o processo de análise fiscal, oferecendo:
- Prevenção de Problemas: Identificação proativa de inconsistências antes de auditorias fiscais
- Economia de Tempo: Automatização de processos que levariam dias para serem feitos manualmente
- Redução de Riscos: Minimização de erros humanos através de validações automáticas
- Conformidade Contínua: Monitoramento constante da qualidade das informações fiscais
Impacto no Negócio
- Segurança Fiscal: Maior confiabilidade nas informações prestadas ao fisco
- Eficiência Operacional: Redução do tempo gasto em análises manuais
- Economia: Prevenção de multas e penalidades através da detecção prévia de inconsistências
- Governança: Melhor controle e visibilidade das obrigações fiscais
Funcionalidades
Implementadas
- Importação e parsing de arquivos SPED e XMLs
- Análise de movimentação de estoque
- Geração de relatórios em Excel
- Validações básicas de consistência
Em Desenvolvimento
- Microserviço de processamento de movimentação e correção de estoques
- Análises baseadas em critérios dos fiscos estaduais
- Integração com sistema Fix Auditoria
- Sistema de notificações e alertas
- Dashboard de acompanhamento fiscal
Como compilar
clonar o projeto
Acessar pasta do projeto
go build
Validação para desenvolvimento
Antes de enviar alterações, execute:
go test ./...
go build ./...
go test -race ./...
O repositório também possui GitHub Actions para testes, build, race detector e govulncheck.
Uso como biblioteca Go
Além do CLI legado, o projeto agora começa a expor uma API pública em pkg/efd para parse e validação sem dependência de banco de dados:
doc, report, err := efd.ParseAndValidate(ctx, reader, efd.ParseOptions{}, efd.ValidateOptions{ValidateBlock9: true})
Veja docs/roadmap/LIBRARY_USAGE.md para um exemplo completo.
Como utilizar
-
Edite o arquivo .env e adicione as configurações de conexão do banco de dados mysql
-
Crie o banco de dados que pretende adicionar as informacoes dos xmls e speds
-
Adicione todos xmls próprios e speds do periodo onde pretende fazer a importação na pasta speds
-
Opcionalmente informe o CNPJ próprio com CNPJ no .env ou com a flag -cnpj. Quando informado, SPEDs/XMLs de outro contribuinte são ignorados na importação.
-
Criar estrutura do banco de dados
parse-efd-fiscal -schema
parse-efd-fiscal -importar-sped
- Importar os xmls de notas fiscais e cupons fiscais
parse-efd-fiscal -importar-xml
- Gerar inventário de um determinado ano (2016)
parse-efd-fiscal -inventario -anoInicial=2016 -anoFinal=2016
- Gerar inventário de mais de um ano
parse-efd-fiscal -inventario -anoInicial=2012 -anoFinal=2016
- Gerar relatório de inventário em Excel
parse-efd-fiscal -excel
- Gerar arquivo no layout do SPED Fiscal para os inventários sugeridos
parse-efd-fiscal -h010 -anoInicial=2016
Depois disso sera criado um arquivo com o nome AnaliseInventario.xlsx na pasta que foi executado.
Utilizando Docker
Você também pode usar o Docker para subir o banco de dados. Para isso, execute o comando abaixo:
docker-compose -f docker/docker-compose.yml --env-file .env up -d
Segurança e dados fiscais
- Copie
.env.example para .env e nunca commite .env real.
- Não commite SPEDs, XMLs, planilhas, dumps de banco ou logs com dados fiscais reais.
- Use apenas fixtures sintéticas em testes e issues públicos.
- Consulte
SECURITY.md para a política completa.
Funcionalidades que serão desenvolvidas no sistema:
- Importar todos Speds e Xmls de um determinado CNPJ para um banco de dados relacional;
- Fazer o processamento da movimentação desse CNPJ e apontar as diferenças dos estoques e criar um arquivo no layout do sped com a sugestão do estoque inicial e do estoque final para fica correto; (microservico)
- Fazer analise de acordo com os feitos pelo fiscos estaduais e apontar possiveis correções; (microservico)
- Fazer comunicação com o sistema Fix Auditoria (http://www.fixauditoria.com.br) e importar automaticamente todos os xmls e speds;
- Enviar relatórios e arquivos dos novos inventários por email;
Dúvidas?
Abra um issue na página do projeto no GitHub ou clique aqui.
Donate
Ajude a acabar com as injustiça feita pela SEFAZ devido a tantas obrigações a serem entregues.
Donate via PayPal
Colaboradores
FixAuditoria - www.fixauditoria.com.br
License
The project Go Auditoria Fiscal is available under the MIT license.
Imagem exemplo da planilha gerada
评论