---
title: "Substituição de NFS-e"
description: "Como o fluxo de substituição de NFS-e aparece na recepção: a nota substituta, o evento na original e como correlacioná-las."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-substituicao/
last_updated: 2026-07-30
---

# Substituição de NFS-e

Quando uma NFS-e é substituída, dois documentos distintos chegam à recepção e precisam ser correlacionados.

## O que chega

1. **A NFS-e substituta** chega como um documento novo (`received`). No seu XML, o elemento `chSubstda` aponta para a chave da nota **substituída** (a original).
2. **A NFS-e original** recebe um **evento de cancelamento por substituição** (código `105102`). No XML do evento, `chSubstituta` aponta para a chave da nota **nova**.

Os dois podem chegar em **qualquer ordem**.

## Como correlacionar

A correlação é feita pelas **chaves no XML/JSON** dos documentos:

- Na substituta: `chSubstda` → chave da original.
- No evento da original (`105102`): `chSubstituta` → chave da substituta.

:::caution Vínculo no payload do webhook
O vínculo de substituição é exposto no **conteúdo (XML/JSON)** dos documentos. Se o seu fluxo depende de um campo de vínculo direto no payload do webhook, confirme a disponibilidade — ver [issue #210](https://github.com/nfe/dfetech-distribution-api/issues/210).
:::

## Veja também

- [Códigos de evento](../reference/codigos-evento.md)
- [Ciclo de vida do DFe](../../comum/ciclo-de-vida-dfe.md)