Treeunfe API B2C home pagelight logo
  1. Eventos de NFS-e
  2. Substituir NFS-e
POST
/nfse/substitute
curl --request POST \
     --url https://api.treeunfe.com.br/api/v1/nfse/substitute \
     --header 'x-api-key: <api-key>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "originalDpsId": "<string>",
  "chaveAcesso": "<string>",
  "vServ": 123.45
}'

Substitui uma NFS-e autorizada por uma nova. A Treeunfe copia a nota original, aplica as correções enviadas e emite a substituta na mesma requisição.

Informe a nota original por originalDpsId ou chaveAcesso, junto com os campos que mudaram. Os campos corrigíveis são os mesmos de Emitir NFS-e.

​
Autenticação

x-api-key
required
string

API Key da empresa.

​
Body

application/json

originalDpsId
string

ID (UUID) da nota original na Treeunfe.

chaveAcesso
string

Chave de acesso da nota original.

vServ
number

Exemplo de campo corrigido: o novo valor do serviço.

​
Respostas

StatusDescrição
200Substituição concluída ou recusada de forma definitiva. Confira outcome.
401x-api-key ausente ou inválida.
curl -X POST "https://api.treeunfe.com.br/api/v1/nfse/substitute" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "originalDpsId": "123e4567-e89b-12d3-a456-426614174000",
    "vServ": 250
  }'