Setembro

Melhorias entregues em 22/09/2026

Substituição de nota fiscal agora se integra ao Ambiente de Dados Nacional (ADN)

A funcionalidade de substituição de nota fiscal do e-Nota Fly passou por uma atualização importante: agora ela integra diretamente com o Ambiente de Dados Nacional (ADN), seguindo o fluxo de cadastro e suas respectivas regras definidas pelo ADN. Isso significa que, quando uma nota fiscal é substituída, o sistema passa a avaliar automaticamente se essa substituição também precisa ser compartilhada em nível nacional.

A substituição deixa de ser feita por uma tela específica e passa a fazer parte exclusivamente do próprio fluxo de emissão de uma nova DPS, processo este realizado pelo contribuinte. Ou seja, substituir uma nota fiscal significa emitir uma nova DPS - que será considerada para o ADN, a nota substituta - indicando, junto a ela, qual nota será substituída.

Para isso, a tela de emissão da DPS ganha uma nova opção, que permite ao prestador indicar se a nova DPS está sendo emitida para fins de substituição de uma nota fiscal.

Importante: essa opção só fica disponível para uso quando o sistema estiver parametrizado com a permissão Permitir ao contribuinte efetuar a substituição de notas fiscais. Sem essa parametrização ativa, a opção não aparece na tela de emissão.

Se a opção não for marcada, a DPS é emitida normalmente, seguindo o fluxo individual já conhecido, sem qualquer vínculo de substituição.

Se a opção for marcada — juntamente com o checkbox Esta DPS será utilizada em substituição a uma nota fiscal já existente e válida no ADN? — o sistema passa a exigir informações adicionais para concluir a emissão, incluindo a Nota fiscal substituída, que aceita apenas uma nota.

Com a integração ao ADN, duas situações novas passam a impedir a substituição de uma nota fiscal. A primeira é quando a nota em questão teve origem em uma captura do próprio Ambiente de Dados Nacional: como ela já nasce vinculada a esse ambiente, o e-Nota Fly não permite que ela seja substituída por ali, nem que seja usada como nota substituta de outra.

A segunda situação ocorre quando a nota que se pretende substituir já está com um compartilhamento em andamento junto ao ADN — nesse caso, é preciso aguardar essa etapa ser concluída antes de iniciar uma nova substituição.

Um dos ajustes mais visíveis na tela é a inclusão do campo Justificativa, ao lado do campo Motivo já existente. O Motivo continua sendo escolhido entre um conjunto fechado de opções fornecidas pelo layout nacional — como desenquadramento ou enquadramento de NFS-e no Simples Nacional, inclusão ou exclusão retroativa de imunidade e isenção, rejeição da nota pelo tomador ou intermediário responsável pelo tributo, ou ainda a opção genérica Outros — mas agora esse Motivo precisa ser complementado pela Justificativa, um texto descritivo de no mínimo 15 e no máximo 255 caracteres.

Ambos os campos se tornam obrigatórios: não é mais possível concluir uma substituição sem informá-los. Esse detalhamento passa a acompanhar o histórico da substituição, tornando mais claro o motivo por trás de cada troca de nota.

A nota fiscal substituída também precisa possuir chave de acesso vinculada e já ter sido compartilhada com sucesso com o ADN. Atendidas essas condições, o e-Nota Fly envia a substituição ao ADN e as duas notas — substituída e substituta — assumem o status Aguardando ADN enquanto esse compartilhamento é processado.

Caso a substituição seja rejeitada pelas validações feitas no ADN, a situação da nota passa a constar como Rejeitada, com o motivo exibido logo abaixo. Caso seja compartilhada com sucesso, ocorre a substituição do PDF e a nota constará com a situação Substituída.

Outra mudança relevante é o fim da substituição de notas em lote, que deixa de existir no sistema. Para poder atender o layout nacional, cada processo de substituição agora trata exclusivamente um par de notas — uma substituída e uma substituta — o que acompanha diretamente a exigência de que as duas notas estejam sempre vinculadas por suas chaves de acesso para que o envio ao ADN seja possível. Também não é mais permitido usar a mesma nota fiscal como substituta de mais de uma nota substituída, ainda que isso ocorra em transações diferentes: cada nota substituta só pode responder por uma única substituição.

Na prática, o dia a dia do prestador ao registrar uma substituição muda: em vez de acessar uma tela separada no Módulo Contribuinte, ele passa a fazer isso no momento em que emite a nova DPS, marcando a opção correspondente e indicando a nota substituída. O que continua por trás dessa confirmação é a mesma verificação automática — agora o e-Nota Fly verifica a origem da nota, o andamento do compartilhamento com o ADN e a presença de chave de acesso para decidir se a substituição pode ser concluída.

Cancelamento por substituição de nota fiscal passa a ser recebido via WebService

O e-Nota Fly agora recebe, por WebService, pedidos de substituição de nota fiscal. Ao receber o XML da DPS, o sistema registra a substituição usando exatamente os dados enviados pelo contribuinte, sem alterações.

Antes de registrar, o sistema valida o pedido: confere se o CPF/CNPJ do XML corresponde ao da nota no e-nota, aplica as regras de negócio, scripts e configurações já existentes, e verificar as restrições ligadas ao ADN — notas de origem ADN não podem ser substituídas nem usadas como substitutas, notas com compartilhamento em andamento não podem ser substituídas novamente, e uma nota não pode ser substituta de mais de uma nota. Havendo qualquer bloqueio, a integração não é efetivada e o contribuinte é notificado. Essa integração só funciona para entidades parametrizadas para recebê-la.

Cada pedido tem data e hora de início e fim registradas e passa por três status: Aguardando validação do ambiente nacional ao receber o XML, Processado com sucesso quando a substituição é concluída, ou Processado com erro em caso de falha de validação ou comunicação.

Com a conclusão da substituição, a situação da nota substituída é alterada para Substituída, seu PDF é atualizado e disponibilizado para o sistema Livro Eletrônico, e o tomador recebe um e-mail automático informando sobre a substituição. O layout do XML para envio da substituição, bem como o arquivo Schema (XSD), está disponível em nossa Central de Ajuda.

Compartilhamento do cancelamento por substituição com o Ambiente de Dados Nacional (ADN)

O e-Nota Fly passa a compartilhar com o ADN o evento de cancelamento por substituição de toda nota fiscal substituída no sistema, seja pela tela dos módulos Contribuinte ou Fiscal, seja por substituições recebidas via webservice.

O compartilhamento segue o layout do evento definido pela ADN, usando os campos do grupo específico de cancelamento de NFS-e por substituição.

Se a nota nacional retornar alguma validação que impeça o compartilhamento, nenhuma substituição é efetivada: a nota substituída se mantém com seu status original, a nota substituta não é compartilhada, e o sistema exibe em tela a mensagem de rejeição retornada pelo ADN.

Não havendo impedimento, a substituição é efetivada no e-nota, registrando o histórico e o vínculo entre as notas substituída e substituta. A nota substituída passa para a situação Substituída, com o PDF atualizado, fica disponível para integração com o Livro Eletrônico, tem o XML original armazenado para consultas futuras, e o tomador do serviço recebe e-mail automático avisando da substituição.

Captura automática de Cancelamento por Substituição de NFS-e (ADN)

Agora o sistema realiza a integração com o Ambiente de Dados Nacional (ADN) para capturar automaticamente o evento de Cancelamento por Substituição de notas fiscais emitidas pelo Emissor Web Nacional.

Ao identificar uma nota fiscal substituída, o sistema passa a:

• Atualizar automaticamente a situação da nota para Substituída;
• Atualizar o PDF da nota com as informações mais recentes;
• Manter o histórico completo da substituição, com o vínculo entre a nota substituta e a substituída;
• Disponibilizar a nota substituída para integração com o Livro Eletrônico;
• Armazenar o XML original recebido do ambiente nacional, garantindo rastreabilidade para consultas futuras.

Se o sistema não localizar a nota fiscal a ser substituída, uma mensagem é registrada automaticamente, podendo ser consultada na tela de Importação de Nota Nacional, facilitando o acompanhamento e a correção quando necessário.

Essa melhoria aumenta a confiabilidade e a rastreabilidade do processo de substituição de notas fiscais, alinhando o sistema às novas regras do padrão nacional de NFS-e.

Importante: Ressaltamos que o processo de estorno da substituição não estará disponível no sistema, pois o ambiente nacional não disponibiliza um recurso que permita fazer este tipo de integração.

Comunicado realizado em 21/09/2026

Manutenção técnica programada

Informamos que será realizada uma manutenção técnica no sistema e-Nota, com o objetivo de realizar melhorias e garantir a estabilidade dos serviços e funcionalidades.

A manutenção ocorrerá no seguinte período:

Data: 05/10/2026

Horário: das 22h às 01h

Ressaltamos que, dependendo do andamento dos trabalhos, a manutenção poderá se estender até o período da manhã de 06/10/2026.

Durante esse período, o sistema ficará inacessível.

Recomendamos que os usuários se programem para realizar atividades importantes antes do início da manutenção.

Agradecemos a compreensão de todos.