> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versão 3.1.18

*Atualização de Novembro de 2026*

A versão 3.1.18 traz um novo endpoint para cancelar NF-e e NFC-e autorizadas, enviando o cancelamento à SEFAZ.

## **Melhorias**

### **Notas Fiscais**

* **POST /notas/\{idNota}/cancelar** - Novo endpoint que transmite à SEFAZ o evento de cancelamento da NF-e ou NFC-e autorizada, como na tela de cancelamento do ERP. Antes, a API só permitia importar um XML de cancelamento já autorizado (`POST /notas/xml/cancelar`).
  * `justificativa` (string, obrigatório) — motivo do cancelamento, entre 15 e 255 caracteres.
  * `estornarEstoque` (boolean, opcional) — estorna o estoque lançado pela nota. Ignorado quando não há estoque lançado.
  * `estornarContas` (boolean, opcional) — estorna as contas lançadas pela nota. Ignorado quando não há contas lançadas.
  * `cancelarVenda` (boolean, opcional) — cancela a venda de origem da nota. Ignorado quando a origem não é uma venda.

A resposta `200` traz o `cStat` e o `motivo` retornados pela SEFAZ para o evento de cancelamento.

**Ponto de atenção:** é preciso ter o certificado digital A1 cadastrado no ERP, e o usuário do aplicativo precisa de permissão para cancelar notas fiscais. A API retorna:

* `403` quando um estorno ou o cancelamento da venda é solicitado sem permissão.
* `409` quando a nota já está cancelada na SEFAZ.
* `422` quando a nota não pode ser cancelada ou a SEFAZ rejeita o cancelamento, com o `cStat` e o motivo da rejeição nos detalhes do erro.
* `502` quando há falha de comunicação com a SEFAZ.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.