> For the complete documentation index, see [llms.txt](https://integracao.gitbook.io/invoisys/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integracao.gitbook.io/invoisys/endpoints/emissao-notas/nf-e-1/api-cancelar-nf-e-por-cnpj-estabelecimento.md).

# Cancelar CT-e por CNPJ, número e série

Responsável por possibilitar ao integrador o envio do cancelamento/inutilização para um CT-e, utilizando o número e série da nota ou sua chave de acesso.

## Endpoint

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

#### 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 | <p>Ambiente da requisição<br>1 - Produção<br>2 - Homologação</p> |
| `cnpj`          | integer | CNPJ da empresa                                                  |
| `numeroCTe`     | integer | Número do CT-e                                                   |
| `serie`         | integer | Série do CT-e                                                    |
| `justificativa` | string  | Texto explicando o motivo do cancelamento                        |

#### Response

{% tabs %}
{% tab title="201 " %}
{% tabs %}
{% tab title="CT-e Cancelado" %}

```javascript
{
  "dadosDoDocumento": {
    "id": 1321,
    "chaveDeAcesso": "35191117921427000125550010000000041123412345",
    "dataHoraEmissao": "2019-11-12T14:32:19.88",
    "dataDeAutorizacao": "2019-11-12T14:33:05Z",
    "documentoComErro": false,
    "codigoStatusSEFAZ": "101",
    "descricaoStatusSEFAZ": "Cancelamento de CT-e homologado",
    "protocoloSEFAZ": "135190008128990",
    "urlConsultaViaQRCode": null,
    "urlConsultaViaChaveDeAcesso": null
  },
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": null
}
```

{% endtab %}

{% tab title="CT-e Inutilizado" %}

```javascript
{
  "dadosDoDocumento": {
    "id": 1322,
    "chaveDeAcesso": "35191117921427000125550010000000051000000003",
    "dataHoraEmissao": "2019-11-12T14:33:51.1063365Z",
    "dataDeAutorizacao": null,
    "documentoComErro": false,
    "codigoStatusSEFAZ": "102",
    "descricaoStatusSEFAZ": "Inutilização de número homologado",
    "protocoloSEFAZ": "135190008129068",
    "urlConsultaViaQRCode": null,
    "urlConsultaViaChaveDeAcesso": null
  },
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": null
}
```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400 " %}
{% tabs %}
{% tab title="CTe já cancelado na invoiSys" %}

```
"Status do documento não aceita cancelamento (101)."
```

{% endtab %}

{% tab title="CT-e já Inutilizado na invoiSys" %}

```
"Documento inutilizado não pode ser consultado!"
```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

## Modelo de Envio 📝

```javascript
{
 "ambiente": 0,
 "cnpj": 0,
 "numeroCTe": 0,
 "serie": 0,
 "justificativa": "string"
}
```

{% hint style="info" %}

#### Swagger

[Você pode acessar nossa API e realizar testes diretamente na nossa plataforma Swagger!](https://sandbox-api.invoisys.com.br/swagger/ui/index#/)
{% endhint %}