# API - Cancelamento da NFS-e por Id Prestador de Serviço

## API - Cancelar NFS-e por ID

<mark style="color:green;">`POST`</mark> `https://sandbox-api.invoisys.com.br/api/nfse/cancelarnfse`

Envio de cancelamento de uma NFS-e que chegou na Prefeitura

#### Request Body

| Name                                         | Type    | Description                                                                            |
| -------------------------------------------- | ------- | -------------------------------------------------------------------------------------- |
| idEmitente<mark style="color:red;">\*</mark> | integer | Id do Emitente                                                                         |
| numeroNFSe<mark style="color:red;">\*</mark> | integer | Número da NFS-e                                                                        |
| codigoCancelamento                           | string  | Padrão ABRASF. 1 = Erro na Emissão; 2 = Serviço não Prestado; 4 = Duplicidade da Nota​ |
| motivo                                       | integer | Motivo do Cancelamento                                                                 |

{% tabs %}
{% tab title="201 " %}

```javascript
{
  "id": 1520,
  "numeroNFSe": 16,
  "numeroRPS": 14,
  "serieRPS": "100",
  "status": "Cancelado",
  "sucesso": true,
  "linkImpressao": "",
  "codigoVerificacao": "EB3401FD5",
  "excecoes": null,
  "solucao": null
}
```

{% endtab %}

{% tab title="400 " %}

```
"Documento não localizado, ou com status diferente de autorizado.
```

{% endtab %}
{% endtabs %}

## APIs Relacionadas 🎈

* [Cancelamento por CNPJ Prestador de Serviço](https://integracao.gitbook.io/invoisys/endpoints/emissao-notas/nfs-e-1/api-cancelamento-da-nfs-e-por-cnpj-prestador-de-servico);

## Referências à API 📌

* [Passo-a-Passo da NFS-e](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nfs-e/passo-a-passo);
* [Fluxograma - Cancelamento da NFS-e](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/emissao/nfs-e/fluxo-operacional/fluxo-cancelamento-da-nfs-e);
