Através deste endpoint é possível realizar o Cancelamento do Comprovante de Entrega de um evento de Comprovação de Entrega já autorizado.
Obs.: O evento de Comprovação de Entrega possui regras e prazos definidos pela Secretaria da Fazendo que devem ser considerados e respeitados. Para maiores informações clique aqui e verifique a versão mais atualizada o Manual de Orientações do Contribuinte da Sefaz.
URL
POST https://cte.ns.eti.br/cte/compentregacanc
Dados de entrada
| Campo | Descrição | Ocorrência | Tipo | Observação |
|---|---|---|---|---|
| X-AUTH-TOKEN | Token de Acesso do CT-e | 0-1 | A | Pode ser enviado no cabeçalho da requisição |
| chCTe | Chave de acesso do CT-e | 1-1 | N | |
| tpAmb | Tipo do ambiente de autorização do CT-e: 1 – Produção, 2 – Homologação | 1-1 | N | |
| dhEvento | Data e hora da ocorrência do cancelamento | 1-1 | D | Padrão Sefaz (com UTC): AAAA-MM-DDTHH:MM:SS Ex.: 2019-08-09T15:04:10-03:00 |
| nProt | Número do protocolo de autorização do CT-e | 1-1 | N | |
| nProtCE | Número do protocolo de autorização do evento de Comprovante de Entrega a ser cancelado | 1-1 | N |
Exemplo de requisição
Requisição de cancelamento de NF-e
curl -X POST
\-H "Content-Type: application/json"
\-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"chCTe": "99999999999999999999999999999999999999999999",
"tpAmb": 2,
"dhEvento": "2019-08-12T13:28:30-03:00",
"nProt": "999999999999999",
"nProtCE": "999999999999999"
}' \
https://cte.ns.eti.br/cte/compentregacanc
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status de processamento | |
| motivo | Descrição literal do status de processamento | |
| retEvento | Objeto contendo os dados de processamento do cancelamento na Sefaz | Somente em status = 200 |
| retEvento.cStat | Código de situação do evento na Sefaz | |
| retEvento.xMotivo | Descrição literal da situação do evento na Sefaz | |
| retEvento.chCte | Chave de acesso do CT-e | |
| retEvento.dhRegEvento | Data e hora de registro do evento na Sefaz | Padrão Sefaz: AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-03:00 |
| retEvento.nProt | Número do protocolo de autorização do evento pela Sefaz | |
| xml | XML do evento | Somente quando tpDown = "X" ( ou "XP" ) e status = 200 |
| json | json do XML do evento | Somente quando tpDown = "J" ( ou "JP" ) e status = 200 |
| Representação gráfica do evento em PDF | PDF em Base64 Somente quando tpDown = "P", "JP" ou "XP" em status = 200 | |
| erro | Objeto contendo as informações de erro caso o cancelamento não obteve sucesso | Somente em status diferentes de 200 |
| erro.cStat | Código do erro | |
| erro.xMotivo | Descrição literal do erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Comprovação de Entrega vinculada ao CT-e com sucesso",
"retEvento": {
"cStat": 135,
"xMotivo": "Evento registrado e vinculado a CT-e",
"chCTe": "99999999999999999999999999999999999999999999",
"dhRegEvento": "2019-08-09T19:41:09-03:00",
"nProt": "999999999999999"
},
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoCTe versao...."}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Cancelamendo do Comprovante de Entrega vinculado ao CT-e com sucesso |
| -2 | Campos obrigatórios da requisição não informado |
| -3 | Chave de acesso inválida |
| -4 | Erro de informações de acordo com o tipo de dados |
| -5 | Erro ou rejeição ao realizar o cancelamento da comprovação de entrega. Verificar os campos codigo e descricao para mais informações |