Se o sistema contábil pediu um “ajuste no XML” de uma NF-e autorizada, não altere o arquivo para forçar a importação. Preserve o original, registre a mensagem exibida e descubra o que o importador está exigindo.
A NF-e (Nota Fiscal Eletrônica) é o documento fiscal digital da operação, e o XML é o arquivo que carrega seus dados e a assinatura digital. Depois da autorização da SEFAZ — a Secretaria da Fazenda do estado —, esse arquivo é o documento. Não é uma minuta que se ajusta até agradar o software.
A recusa do importador é um problema de leitura, não uma rejeição fiscal. São dois assuntos, com responsáveis e caminhos diferentes, e tratá-los juntos é o que transforma uma falha simples de software em discussão sobre a nota.
Por que preservar o XML original
O Ajuste SINIEF 07/05, norma nacional que disciplina a NF-e, determina na cláusula sétima, § 1º, que o documento não pode ser alterado depois da autorização de uso. A Resposta à Consulta Tributária paulista 33544/2026 reafirma a mesma regra no item 4.
A assinatura digital cobre o conteúdo do arquivo. Alterar qualquer campo quebra essa assinatura e produz um arquivo que não corresponde a nada: nem ao documento autorizado, nem a um documento novo válido. O escritório passa a guardar uma cópia divergente da que a SEFAZ tem, e a divergência aparece justamente quando alguém precisa comprovar a operação.
Mantenha o arquivo íntegro, como recebido ou obtido de fonte confiável. Se houver suspeita de arquivo incompleto ou corrompido, obtenha outra cópia íntegra do mesmo documento — não reconstrua o arquivo manualmente. As anotações da investigação ficam em um registro separado, fora do XML.
O original íntegro também rende atendimento técnico melhor: o suporte analisa exatamente o arquivo que provocou a falha, sem as alterações introduzidas por tentativas de resolver no improviso.
Primeiro, descubra o que significa “ajustar”
Antes de encaminhar qualquer providência, peça ao suporte que traduza a solicitação em algo verificável:
- Qual é a mensagem completa e o código do erro?
- A falha acontece com uma NF-e específica ou com vários documentos?
- Qual versão do sistema e qual rotina de importação foram utilizadas?
- O arquivo está completo e corresponde ao documento esperado?
- O suporte pede configuração do importador ou alteração de informação fiscal?
“Ajustar o XML” é uma expressão vaga. Na prática, ela costuma significar atualização do leitor, liberação de permissão na pasta ou troca de leiaute aceito pelo importador — nada disso exige editar a nota.
Peça a orientação por escrito, com a causa identificada e o procedimento proposto. Se a recomendação for modificar o conteúdo da NF-e autorizada, interrompa a tentativa e peça uma alternativa que preserve o documento.
Tabela de triagem: para onde encaminhar o problema
| Situação observada | O que ela permite concluir | Próximo passo |
|---|---|---|
| Mensagem “XML inválido” ou “formato não suportado” | Há uma falha de leitura, ainda sem causa comprovada | Registrar o erro e consultar o suporte sobre leiaute, versão e rotina |
| Falha em vários documentos após atualização | Existe um padrão técnico a investigar | Informar versões, momento da mudança e exemplos ao suporte |
| Apenas um arquivo apresenta falha | O problema está naquele arquivo ou em uma particularidade de leitura | Solicitar análise técnica e, se necessário, outra cópia íntegra |
| Documento disponível, mas não chega à rotina contábil | Disponibilização e importação são etapas distintas | Conferir configuração, permissões e funcionamento do canal utilizado |
| Suspeita concreta de informação fiscal incorreta | É necessária avaliação fiscal, não edição para importação | Encaminhar ao responsável fiscal e ao emitente |
Cada linha encaminha o problema para o responsável certo: suporte do sistema, responsável fiscal ou emitente.
Exemplo: o aviso não justificava mexer na nota
O cenário abaixo é ilustrativo e usa um escritório fictício.
O escritório Ponte recebeu uma NF-e de um fornecedor e tentou importá-la. O sistema exibiu “Estrutura do documento não reconhecida”. Um integrante da equipe sugeriu alterar o arquivo para aproximá-lo de outro XML que havia sido importado.
A responsável pelo atendimento preservou o original e abriu um chamado com a mensagem completa, a versão do sistema e a rotina utilizada. O suporte identificou uma incompatibilidade naquela versão do importador e orientou a atualização. O mesmo arquivo original foi aceito em seguida, sem que nada fosse alterado.
O diagnóstico apontou o software que lia o documento, não a nota. Esse é o caminho que preserva o documento fiscal e resolve a importação.
Quando existe erro fiscal, a CC-e não reescreve o XML
Se a investigação apontar uma informação fiscal incorreta, o responsável fiscal avalia o caso junto com o emitente. A mensagem do importador, sozinha, não define o procedimento.
A Carta de Correção Eletrônica (CC-e) é o evento previsto na cláusula décima quarta-A do Ajuste SINIEF 07/05 para corrigir erros que não alterem o valor do imposto. Ela não alcança as variáveis que determinam o valor do tributo, as mudanças cadastrais que impliquem troca de remetente ou destinatário, nem a data de emissão ou de saída.
No Manual de Orientação do Contribuinte (MOC), a CC-e é o evento 110110, de autoria do emitente. O arquivo digital do evento, com o registro da SEFAZ, integra a NF-e e é disponibilizado ao destinatário e ao transportador.
A CC-e é, portanto, um evento vinculado ao documento — não uma licença para editar o XML autorizado. Ela corrige a informação na NF-e; a leitura desse evento pelo sistema contábil é uma etapa própria da importação.
A consulta paulista 33544/2026 trata de um caso concreto. Cada situação deve ser avaliada com o responsável fiscal e o emitente, no âmbito da unidade federada em que ocorreu.
Onde a Fluvi entra nessa investigação
A captura e a integração de documentos são duas etapas distintas, e é essa separação que permite localizar a falha.
Na Fluvi, a captura roda em nuvem, com o certificado A1 do cliente. O certificado A1 é a identidade digital da empresa, com validade de um ano, que autoriza o acesso aos documentos. Nenhum computador precisa ficar ligado, nenhum robô é instalado e nenhuma pasta local é lida: os documentos chegam e ficam disponíveis na plataforma, inclusive fora do horário comercial.
A entrega ao sistema contábil é a etapa seguinte, e a Fluvi publica os caminhos de integração com sistemas contábeis: SCI por API direta; Domínio pelo Integrador Fluvi com importação por pasta; Alterdata pelo Integrador com importação por pasta ou API via NFStock; e Fortes por API via NFStock.
Vale entender os três termos. API é a conexão direta entre a Fluvi e o sistema contábil, sem arquivo intermediário. NFStock é o serviço que faz essa ponte em sistemas que não expõem API própria. Integrador é o programa da Fluvi que deposita os XMLs na pasta que o sistema do escritório já lê.
Como a Fluvi entrega o XML exatamente como foi autorizado, o que chega ao sistema contábil é o documento íntegro, nunca uma versão reescrita. Quando o importador recusa esse arquivo, a investigação é de leitura e de configuração, exatamente como no exemplo acima. Os formatos de exportação — XML, PDF e relatórios em Excel — atendem a finalidades diferentes da rotina e estão descritos nas vantagens da Fluvi.
O escopo da captura está na cobertura da Fluvi: NF-e de entrada e de saída em todas as UFs, capturadas em nuvem com o A1 do cliente.
Checklist antes de tentar novamente
- [ ] Preservei o XML original sem alterar seu conteúdo.
- [ ] Registrei a mensagem completa, o código e a rotina utilizada.
- [ ] Identifiquei se a falha afeta um documento ou vários.
- [ ] Conferi com o suporte a versão e a configuração do importador.
- [ ] Solicitei outra cópia íntegra se houver suspeita de arquivo incompleto.
- [ ] Separei a investigação técnica de eventual avaliação fiscal.
- [ ] Encaminhei possível erro fiscal ao responsável e ao emitente.
- [ ] Confirmei o resultado da nova tentativa sem substituir o original por uma versão editada.
Defina o fluxo do seu escritório
O próximo passo é localizar onde a falha ocorre: na obtenção do arquivo, na entrega ao sistema ou na leitura pelo importador.
Consulte a equipe da Fluvi para avaliar as opções de captura e integração aplicáveis ao seu ambiente. Informe o sistema, a versão e a mensagem do erro: esses três dados aceleram o diagnóstico. Compartilhe XMLs e identificações empresariais apenas por canal autorizado de atendimento, nunca em comentários públicos, e não envie certificado A1 ou senha por canais públicos.
Fontes oficiais
Consultadas em 22 de outubro de 2026:
- Ajuste SINIEF 07/05, de 30/09/2005, publicado no DOU de 05/10/2005. Norma nacional da NF-e; a cláusula sétima, § 1º, foi conferida também na consulta oficial paulista abaixo.
- MOC: recepção do evento Carta de Correção. Cabeçalho da página: “Atualizado até a NT 2026.007 v.1.10 publicada em 01/10/2026”. Consultados autoria, código, limites e disponibilização do evento.
- Resposta à Consulta Tributária 33544/2026, SEFAZ-SP, de 24/04/2026, publicada em 27/04/2026, página atualizada em 07/05/2026. Itens 4 e 5, no âmbito do caso concreto.
Tema NF-e
