“Quem procura, acha.”
Se você trabalha com automação comercial ou no departamento fiscal de empresas em São Paulo, sabe que a recuperação de XMLs de Notas Fiscais de Consumidor Eletrônicas (NFC-e) perdidas sempre foi uma dor de cabeça.
Recentemente, a SEFAZ-SP lançou o projeto SAE (Serviços de Apoio à Escrituração), disponibilizando novos Webservices que permitem finalmente automatizar essa tarefa.
Para facilitar o acesso a esses serviços sem que você precise desenvolver uma solução do zero, foi criado o aplicativo DJSAE-NFCe, um utilitário gratuito que consome essa nova API oficial.
O Novo Serviço: SAE-NFC-e
Conforme a Nota Técnica 2026.001, a Secretaria da Fazenda de São Paulo disponibilizou dois métodos principais de webservice:
- NFCeListagemChaves: Permite consultar a relação de chaves emitidas em um determinado período.
- NFCeDownloadXML: Permite baixar o XML completo (assinado) de uma nota específica a partir de sua chave.
Regras e Limitações da SEFAZ
É importante entender as regras para não ter surpresas:
- Janela de Tempo: A consulta está limitada a um período histórico de 100 dias.
- Paginação: O serviço retorna no máximo 2.000 chaves por consulta. Se houver mais notas, o serviço retorna um código específico (
cStat=101), indicando que a lista está incompleta e que o período de busca deve ser ajustado. - Segurança: É exigido o certificado digital (e-CNPJ) do contribuinte consultado.
O Utilitário: DJSAE-NFCe
Para abstrair a complexidade de comunicação SOAP, paginação e validação, foi criado o aplicativo DJSAE-NFCe. O objetivo é simples: você configura o certificado, define o período e o programa baixa tudo para você.
Principais Recursos
- Download em Lote: O sistema consulta a listagem e, marcando a opção “Baixar XMLs”, já realiza o download de todos os arquivos automaticamente.
- Tratamento de Paginação: O software identifica quando o retorno da SEFAZ está incompleto (mais de 2.000 notas) e ajuda a continuar a consulta a partir da última nota localizada.
- Organização: Possui a opção “Separar por mês da emissão”, que cria pastas automaticamente (ex:
2602) para salvar os arquivos organizados. - Consulta pela chave: permite recuperar o protocolo de autorização da nota realizando a consulta pela chave e atualizando o XML com a situação atual da nota.
- Visualização de DANFCe: Além do XML, é possível visualizar e imprimir o DANFCe (Documento Auxiliar).
- Suporte a Certificados: Compatível com certificados A1 (arquivo PFX) e A3 (cartão/token).
Como Utilizar
- Configuração
Na aba Configurações, selecione o tipo de biblioteca (OpenSSL para arquivos A1 é recomendado; WinCrypt para A3). Aponte o caminho do certificado ou número de série e a senha. Defina também os diretórios onde os XMLs das notas e eventos serão salvos. - Consulta por Período
Na aba principal, defina a Data Inicial e Data Final (respeitando o limite de 100 dias da SEFAZ). Clique em Consultar. O sistema listará as chaves e baixará os XMLs se a opção estiver marcada. Com a lista criada é possível dar um duplo clique e visualizar o XML da NFCe selecionada. - Consulta Individual
Se você já tem a chave de acesso, vá até a aba Consulta por Chave, cole os 44 dígitos e clique em Download XML.
Registro Gratuito
O aplicativo é gratuito. Ao executá-lo pela primeira vez, será necessário informar o CNPJ, e-mail e telefone para liberar o uso. Um código de verificação (2FA) será enviado ao seu e-mail para garantir a segurança e evitar o uso indevido. Faça o download clicando aqui e descompacte numa pasta de sua preferência.
Conclusão
A disponibilização do serviço de download pela SEFAZ-SP foi um grande avanço, mas o consumo de Webservices complexos ainda é uma barreira para muitos. Com o novo serviço da SEFAZ e este utilitário em mãos, a recuperação fiscal deixa de ser um mistério. Afinal, no mundo da automação comercial, a máxima agora é verdadeira: quem procura, acha.
