Como a Automação Funciona?
Esta ferramenta simplifica e automatiza a apuração de ICMS ST a partir de notas fiscais eletrônicas em lote. Ela processa arquivos de entrada, higieniza e cruza os dados com o cadastro de fornecedores fornecido, entregando relatórios e gráficos refinados de conferência tributária.
As 4 Etapas do Processamento
1
Upload e Segurança
O sistema recebe os arquivos e realiza verificações automáticas de integridade e segurança. Arquivos corrompidos ou suspeitos são barrados para garantir a proteção do sistema.
2
Leitura e Limpeza de Dados
O motor de apuração descompacta os lotes em segundo plano, remove notas duplicadas por meio da assinatura digital e da chave de acesso e aplica as Regras de Exclusão de produtos.
3
Cruzamento de Fornecedores
Os emissores de cada nota fiscal são confrontados com a planilha de fornecedores fornecida. Esse enquadramento dita se a nota fiscal entra no cálculo considerado da apuração de substituição tributária.
4
Geração de Relatórios
Os dados apurados alimentam planilhas organizadas por empresa, com resumos e gráficos analíticos incorporados, disponibilizados de forma compactada para download rápido do lote.
Guia de Preenchimento da Tela
Empresa e Período de Referência
Preencha o nome da empresa e o mês/ano de referência (ex: 05/2026) para catalogar o seu processamento e identificá-lo facilmente no histórico.
Planilha de Fornecedores (XLSX)
Este arquivo é fundamental para classificar os CNPJs emissores dos XMLs e ditar o comportamento do cálculo. Requisitos para a planilha:
- Formato de arquivo Excel com extensão
.xlsx.
- Deve conter obrigatoriamente duas abas com nomes exatos: ST INTERNA e DECRETO.
- Em cada aba, é obrigatório haver uma coluna chamada CNPJ (os números de CNPJ podem ter pontos e traços, ou conter apenas dígitos).
Recurso de Reuso: Ao carregar uma planilha, você pode marcar a opção "Salvar esta planilha no sistema para execuções futuras" e nomeá-la de forma amigável. Nas próximas execuções, basta escolher a opção "Selecionar Base Cadastrada". Se desejar remover uma base do sistema, selecione-a e clique no botão de lixeira vermelha ao lado do campo.
Notas Fiscais (XML / ZIP)
Você pode arrastar ou selecionar múltiplos arquivos .xml avulsos de notas fiscais, ou simplificar o envio compactando todas as notas em um arquivo comprimido .zip. O sistema abrirá e processará cada XML em lote.
Regras de Exclusão de Notas
Na coluna lateral da tela de apuração, você pode cadastrar regras personalizadas combinando uma palavra-chave do produto e o NCM. O sistema ignorará automaticamente qualquer produto do lote de XMLs que atenda simultaneamente a esses filtros.
Entendendo as Regras de Negócio da Apuração
Filtros de Entrada
Para garantir a precisão, o motor de apuração avalia as notas de acordo com as regras internas parametrizadas, considerando apenas as notas contendo CFOPs e códigos de tributação (CST ou CSOSN) típicos de apuração de substituição tributária. Registros fora desse escopo fiscal são ignorados.
Alíquotas de Referência
O sistema aplica alíquotas de referência com base no enquadramento fiscal e regime tributário da nota. Alíquotas comuns como 4%, 7%, entre outras parametrizadas, são aplicadas de forma dinâmica e automatizada conforme o enquadramento tributário do produto e do fornecedor.
Base de Cálculo ST
A base de cálculo de substituição tributária considerada é computada a partir do valor comercial do produto, subtraindo os descontos obtidos e adicionando valores adicionais informados na nota (como frete, seguro, outras despesas acessórias e IPI).
Status do Fornecedor
O cruzamento de CNPJ com as abas da planilha de fornecedores gera os enquadramentos:
ST Interna: O cálculo de ICMS ST é ativado e considerado na apuração final.
Decreto ou Não Encontrado: A base de cálculo considerada e o ICMS ST são zerados automaticamente.
Conflito: Ocorre se o CNPJ constar em ambas as abas, sendo zerado por segurança operacional.
Relatórios e Arquivos Entregues
Ao término do processamento, a automação compila os resultados fiscais em um pacote completo pronto para download, contendo os seguintes arquivos estruturados:
Planilhas Fiscais por Destinatário
Para cada empresa destinatária identificada no lote de XMLs, é criado um relatório Excel estilizado e estruturado em abas para permitir conferência detalhada (Itens no Cálculo, Não Encontrados, Conflitos, ZIPs Lidos e Erros).
Aba de "Resumo" com 4 Gráficos Dinâmicos
Cada planilha individual conta com uma aba inicial sofisticada contendo indicadores financeiros de resumo do lote e 4 gráficos dinâmicos incorporados:
- Empresas por Regime: Proporção de fornecedores Simples Nacional e Normal.
- ICMS ST por Regime: Comparativo do imposto calculado por regime tributário.
- Base de Cálculo por Regime: Proporção das bases fiscais consideradas.
- Total Base x Total ICMS ST: Comparação visual rápida dos totais acumulados.
Planilha de Resumo Geral
O arquivo Resumo_Geral.xlsx consolida as estatísticas e os totais financeiros de todas as empresas destinatárias em uma visualização única de alto nível, ideal para envio rápido a gestores e auditores.
Pacote Completo (.ZIP)
Todos os relatórios Excel de conferência individuais e o resumo geral são compactados em um único arquivo compactado para download imediato em lote, otimizando o seu tempo de download e organização local de arquivos.
Limites do seu Plano (Starter)
Sua conta está sujeita aos limites operacionais abaixo com base no plano contratado para o seu tenant. Para aumentar esses limites, entre em contato com o suporte ou realize o upgrade do plano.
Tamanho Máximo por Lote
-- MB (Upload total combinado)
Tamanho Máximo por ZIP
-- MB (Por arquivo descompactado)
Tamanho Máximo por XML
-- KB (Por arquivo XML individual)
Quantidade Máxima de XMLs
-- XMLs permitidos por processamento
Processamentos Simultâneos
Até -- execuções concorrentes permitidas
Retenção de Arquivos
Os relatórios finais ficam disponíveis por -- horas para download