Manual Técnico: Integração de Download XML NFC-e (SEFAZ SP)

1. Descrição do Recurso e Conceito Operacional O recurso consiste na integração nativa do sistema com o novo Serviço de Apoio à Escrituração (SAE-NFC-e), lançado oficialmente em fevereiro de 2026 pela Secretaria da Fazenda de São Paulo por meio da Nota Técnica 2026. A funcionalidade encerra a necessidade de processos paralelos para recuperação de XMLs, permitindo listar e baixar a estrutura completa das NFC-e autorizadas diretamente do repositório da SEFAZ-SP. É importante ressaltar que a funcionalidade é válida, no momento, apenas para o Estado de São Paulo e exige o uso do certificado digital e-CNPJ.

2. Fluxo Lógico do Sistema (Back-end & Aplicação Local) A solicitação feita pelo usuário no painel aciona os novos webservices da SEFAZ em uma rotina de duas etapas:

• Webservice NFCeListagemChaves: O sistema envia uma requisição autenticada pelo certificado para listar as chaves emitidas em um intervalo de tempo. Há um limite estrito: a janela de pesquisa máxima é de 100 dias retroativos, com retorno máximo de 2.000 chaves por vez. Se o volume for maior, a SEFAZ retorna o código cStat 101 (lista incompleta), e o back-end da aplicação precisa fragmentar a busca.
• Webservice NFCeDownloadXML: Com a lista de chaves obtida, o sistema dispara requisições individuais e sincroniza os XMLs completos, incluindo as tags de eventos associados, como cancelamentos.
• Controle de Tráfego e Consumo Indevido: Para proteger sua infraestrutura, a SEFAZ implementou bloqueio por IP. O sistema local está programado para enfileirar e cadenciar os downloads, pois requisições massivas simultâneas ou em repetição causarão rejeição e bloqueio temporário do emissor.

3. Guia de Configuração e Ativação O processo de acionamento é direto pela interface da aplicação web:

1. Acesse o painel do sistema administrativo com credenciais ativas.
2. No menu superior, certifique-se de que a unidade/empresa emissora correta está selecionada no dropdown
3. Clique no nome do usuário ou na engrenagem ao lado do seletor para abrir o menu contextual do sistema.
4. Clique na opção “Download NFC-e SEFAZ” (acompanhada do ícone de nuvem com seta).
5. Pré-requisito: Para que essa opção funcione sem erros, o passo “Importar certificado” já deve ter sido realizado com um e-CNPJ válido pertencente à empresa ativa.

4. Resultado Esperado (Critérios de Sucesso na Implantação) A operação será considerada 100% validada pelos analistas ao observarem:

• Visuais: Mensagem de sucesso na interface do ERP após o término da sincronização com o período.
• Sistema: O preenchimento da base de dados e/ou a disponibilização em pasta física dos arquivos .xml correspondentes ao lote da SEFAZ, prontos para exportação ao contador.
• Físicos/Técnicos: Validação de que os arquivos baixados não estão corrompidos e contêm todo o histórico do ciclo de vida da nota (autorização e, quando aplicável, o evento de cancelamento).
• ATENÇÃO: Atentar que a SEFAZ disponibiliza somente os últimos 100 dias, e como em toda consulta, quanto maior o range de pesquisa, mais lenta a busca e tbm lembrar que executar a mesma consulta no mesmo CNPJ, pode gerar consumo indevido na SEFAZ

5. Resolução de Problemas (Troubleshooting)