Substituir NFS-e

Gera uma nova NFS-e em substituição à nota original, registrando o vínculo da chave substituída no Ambiente de Dados Nacional.

POSThttps://api.nfer.me/v1/nfse/:id/substituir

Headers da Requisição

X-API-Keystringobrigatório

Chave de API.

Content-Typestringobrigatório

application/json

Parâmetros de Rota (Path Parameters)

idstringobrigatório

UUID da NFS-e original que será substituída.

Exemplo: e9b5a201-9231-4828-b0a3-a7c3df95a001

Corpo da Requisição (JSON Body)

codigoServicostringopcional

Novo cTribNac de 6 dígitos se alterado.

descricaostringopcional

Nova discriminação dos serviços.

valorServiconumberopcional

Novo valor dos serviços se alterado.

cMotivostringopcional

Código do motivo da substituição no ADN (ex: "01" - Desenquadramento do tomador).

xMotivostringopcional

Justificativa textual detalhada da substituição.

sendImmediatebooleanopcionalpadrão: false

Se true, enfileira o envio imediato da nova nota ao ADN.

Substituir NFS-e

curl --request POST \
  --url https://api.nfer.me/v1/nfse/:id/substituir \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "codigoServico": "<codigoServico>",
  "descricao": "<descricao>",
  "valorServico": 1,
  "cMotivo": "<cMotivo>",
  "xMotivo": "<xMotivo>",
  "sendImmediate": "false"
}'

{
  "id": "f1c2930a-99b1-4cd8-888e-4a671cfbd993",
  "substitui_nfse_id": "e9b5a201-9231-4828-b0a3-a7c3df95a001",
  "status": "rascunho",
  "numero": 330
}