---
title: "Nfse substitute"
method: POST
path: "/api/v1/nfse/{nfse}/substitute"
tags: ["nfse"]
---

# Nfse substitute

`POST /api/v1/nfse/{nfse}/substitute`

## Request

- Base URL: `https://www.foxnfe.com.br`
- URL: `https://www.foxnfe.com.br/api/v1/nfse/{nfse}/substitute`
- Auth: HTTP bearer

## Path parameters

- `nfse` integer, required

## Request body

- PostApiV1NfseNfseSubstituteRequest
  - `motivo` string, required
  - `competencia` string, required
  - `descricao_servico` string, required
  - `codigo_tributacao_nacional` string, required
  - `codigo_tributacao_municipal` string, required
  - `codigo_municipio_prestacao` string, required
  - `codigo_nbs` string, nullable
  - `valor_servico` number, required
  - `valor_deducoes` number, nullable
  - `aliquota_iss` number, required
  - `inscricao_municipal` string, required
  - `informacoes_adicionais` string, nullable
  - `tomador` object, required
    - `cnpj` string, nullable
    - `cpf` string, nullable
    - `nome` string, required
    - `endereco` union
      - unknown[]
        - unknown
      - object
  - `prestador` object, required
    - `endereco` object, required
      - `logradouro` string, required
      - `numero` string, required
      - `bairro` string, required
      - `codigo_municipio` string, required
      - `uf` string, required
      - `cep` string, required

## Response `202`

Resposta implementada pelo controlador.

- object
  - `nfse_id` integer
  - `message` string

## Other responses

- `409`: Resposta implementada pelo controlador.
- `422`: Resposta implementada pelo controlador.

---

[API](https://skmtc.dev/foxnfe/apis/fox-nf-e-api.md) · [All operations](https://skmtc.dev/foxnfe/apis/fox-nf-e-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foxnfe/apis/fox-nf-e-api/revisions/8820a6e016b0?raw)