br__cancel_cte
Cancel an authorized CT-e by submitting a signed cancellation event to SEFAZ. Provide CT-e key, CNPJ, protocol number, and justification.
Instructions
Solicita o cancelamento de um CT-e autorizado (evento 110111, CTeRecepcaoEventoV4).
Constrói, assina (build_cte_event_signer, alvo infEvento) e submete
o evento de cancelamento. cStat=135 indica cancelamento homologado
[Verified locally] — MOC CT-e Visão Geral v4.00 §6.2.2.
Cancelamento é uma operação irreversível em produção e exige
confirmação em duas etapas (ConfirmationGate). Define
BR_CTE_READ_ONLY=1 para desabilitar. endpoint_override é
obrigatório — nenhuma URL de endpoint CT-e está embutida/verificada
nesta versão.
Retorna cStat/xMotivo ou error.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cnpj | Yes | CNPJ do emitente do CT-e (autor do evento) | |
| ch_cte | Yes | Chave de acesso do CT-e a cancelar (chCTe), 44 caracteres | |
| n_prot | Yes | Número do protocolo de autorização do CT-e original (nProt) | |
| tp_amb | No | Identificação do Ambiente (tpAmb): '1' = produção, '2' = homologação | 2 |
| x_just | Yes | Justificativa do cancelamento | |
| c_orgao | Yes | Código IBGE da UF do autorizador (cOrgao), 2 dígitos (ou '90' para SUFRAMA) | |
| cert_path | Yes | Caminho local para o certificado ICP-Brasil A1 (.p12/.pfx) | |
| dh_evento | Yes | Data e hora do evento (ISO 8601, UTC) | |
| cert_password | No | Senha do certificado A1, se houver | |
| endpoint_override | Yes | URL completa do webservice CTeRecepcaoEventoV4 — obrigatório, ver docstring do módulo. | |
| confirmation_token | No | Token de confirmação obtido de uma chamada anterior pendente. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||