# API - Cancelar NF-e por Id Estabelecimento

## API - Cancelamento de NF-e

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

#### Headers

| Name          | Type   | Description                           |
| ------------- | ------ | ------------------------------------- |
| Content-Type  | string | `application/x-www-form-urlencoded`​​ |
| Accept        | string | `application/jso​n​`                  |
| Authorization | string | `bearer <valor​>​`                    |

#### Request Body

| Name                    | Type    | Description                                     |
| ----------------------- | ------- | ----------------------------------------------- |
| ambiente                | integer | Informa se será em produção ou homologação      |
| idEmpresaEmitente       | integer | Identificador da empresa&#xD;                   |
| numeroNFe               | integer | Numeração da NF-e                               |
| serie                   | integer | Série da NF-e                                   |
| justificativa           | string  | Texto explicando o motivo do cancelamento       |
| chaveDeAcessoSubstituta | string  | Chave de Acesso da NF-e que acobertou esta nota |

{% tabs %}
{% tab title="201 " %}
{% tabs %}
{% tab title="Cancelamento" %}
```javascript
{
  "dadosDoDocumento": {
    "id": 1121,
    "chaveDeAcesso": "35191117921427000125550010000000011123412343",
    "dataHoraEmissao": "2019-11-12T14:05:01.423",
    "dataDeAutorizacao": "2019-11-12T14:22:31Z",
    "documentoComErro": false,
    "codigoStatusSEFAZ": "101",
    "descricaoStatusSEFAZ": "Cancelamento de NF-e homologado",
    "protocoloSEFAZ": "135190008127419",
    "urlConsultaViaQRCode": null,
    "urlConsultaViaChaveDeAcesso": null
  },
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": null
}
```
{% endtab %}

{% tab title="Inutilização" %}
```javascript
{
  "dadosDoDocumento": {
    "id": 1319,
    "chaveDeAcesso": "35191117921427000125550010000000021000000001",
    "dataHoraEmissao": "2019-11-12T14:24:27.79926Z",
    "dataDeAutorizacao": null,
    "documentoComErro": false,
    "codigoStatusSEFAZ": "102",
    "descricaoStatusSEFAZ": "Inutilização de número homologado",
    "protocoloSEFAZ": "135190008127706",
    "urlConsultaViaQRCode": null,
    "urlConsultaViaChaveDeAcesso": null
  },
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": null
}
```
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
#### Swagger

[Você poderá acessar a nossa API e o seu respectivo modelo de envio em nossa plataforma Swagger!](https://sandbox-api.invoisys.com.br/swagger/ui/index#!/NFe/NFe_CancelarNFe)
{% endhint %}

## Modelo de Envio 📝

```javascript
{
 "ambiente": 0,
 "idEmpresaEmitente": 0,
 "numeroNFe": 0,
 "serie": 0,
 "justificativa": "string"
}
```

## Exemplo de Requisição via Postman

{% file src="https://3525778293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lmo0dH8REcSzSboskDA%2Fuploads%2F9tYARgJlYXgNSnrXcUeQ%2FCancelamento%20NF-e.json?alt=media&token=be5d161e-d1ef-46c9-8bbc-d4025c335d83" %}

## APIs Relacionadas 🎈

* [API Cancelamento por CNPJ Estabelecimento](api-cancelar-nf-e)

## Referências à API 📌

* [Passo-a-Passo da NF-e](../../../../getting-started/documentos-fiscais/emissao/nf-e/integracao-passo-a-passo#conhecendo-as-apis)
* [Fluxograma - Cancelamento](../../../getting-started/documentos-fiscais/emissao/nf-e/teste-fluxos-operacionais/cancelamento-modelo-completo)
