CT-e
Cancelar comprovante de entrega
Registra o evento 110181, cancelando um comprovante de entrega registrado.
POST
/openapi/v2/empresas/{empresaId}/cte/{cteId}/comprovante-entrega/{protocoloEvento}/cancelarRequer os cabeçalhos de assinatura
token, timestamp e sign, veja Autenticação.Desfaz um comprovante de entrega que havia sido registrado, por exemplo quando ele foi lançado por engano. Sem corpo; assine com string vazia. protocoloEvento deve ser o protocolo de um evento 110180 registrado neste documento (10017045). Enviado de forma síncrona; em caso de sucesso o objeto do evento é devolvido.
Parâmetros de caminho
empresaId* | string | Identificador da empresa |
cteId* | string | Identificador do documento |
protocoloEvento* | string | Protocolo do evento |
* Campo obrigatório
200
Evento registrado na SEFAZ. O objeto do evento é devolvido de forma síncrona.
chaveAcesso | string | Chave de acesso |
tipo | string | Tipo do evento |
codigo | string | Código do evento |
sequencia | int | Sequência |
status | string | Código de retorno |
motivo | string | Motivo |
protocolo | string | Protocolo |
data | string | Data do registro |
linkXml | string | Link do XML do evento |
tipoTipo do evento
| Valores | Significado |
|---|---|
| Cancelamento | Cancelamento do CT-e; código 110111 |
| CartaCorrecao | Carta de correção; código 110110 |
| Epec | Autorização prévia em contingência EPEC, registrada pela plataforma; código 110113 |
| ComprovanteEntrega | Comprovante de entrega; código 110180 |
| CancelamentoComprovanteEntrega | Cancelamento do comprovante de entrega; código 110181 |
| InsucessoEntrega | Insucesso na entrega; código 110190 |
| CancelamentoInsucessoEntrega | Cancelamento do insucesso na entrega; código 110191 |
| PrestacaoDesacordo | Prestação do serviço em desacordo; código 610110 |
| CancelamentoPrestacaoDesacordo | Cancelamento da prestação em desacordo; código 610111 |
codigoCódigo do evento
| Valores | Significado |
|---|---|
| 110111 | Cancelamento do CT-e (Cancelamento) |
| 110110 | Carta de correção (CartaCorrecao) |
| 110113 | Autorização prévia em contingência EPEC, registrada pela plataforma (Epec) |
| 110180 | Comprovante de entrega (ComprovanteEntrega) |
| 110181 | Cancelamento do comprovante de entrega (CancelamentoComprovanteEntrega) |
| 110190 | Insucesso na entrega (InsucessoEntrega) |
| 110191 | Cancelamento do insucesso na entrega (CancelamentoInsucessoEntrega) |
| 610110 | Prestação do serviço em desacordo (PrestacaoDesacordo) |
| 610111 | Cancelamento da prestação em desacordo (CancelamentoPrestacaoDesacordo) |
statusCódigo de retorno do registro
A plataforma só devolve 200 com um destes códigos; qualquer outro retorno da SEFAZ vira 10017043.
| Valores | Significado |
|---|---|
| 134 | Evento registrado; a SEFAZ o trata como sucesso |
| 135 | Evento registrado e vinculado ao CT-e |
| 136 | Evento registrado, mas não vinculado ao CT-e |
| Código | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId não encontrado ou não pertence à empresa. Verifique o id e o empresaId. |
| 10003000 | 404 | empresaId não encontrado. |
| 10017004 | 400 | A empresa não está em condição de emitir: desabilitada ou certificado indisponível. Registrar eventos também exige o certificado; reative a empresa ou vincule um certificado válido. |
| 10017040 | 400 | O status do documento não permite o evento; o CT-e precisa estar Autorizada. |
| 10017043 | 400 | A SEFAZ rejeitou o evento; mensagem traz o código de retorno e o motivo dela. |
| 10017045 | 400 | O evento referenciado por protocoloEvento não foi encontrado neste documento. |