Skip to main content
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.