Para realizar um cancelamento por substituição utilize a mesma rota do cancelamento normal, porém adicionando alguns parâmetros. Veja os exemplos abaixo.
POST
https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfce/cancela
Headers
| Nome | Descrição | Exemplo |
| Content-Type | Indica o tipo de arquivo | application/x-www-form-urlencoded |
| Authorization | Este usuário e senha são os seus dados para logar como administrador em um grupo do SaaS | Basic YWRtaW46MTIzbXVkYXI= |
Body
| Nome | Descrição |
| Grupo | Nome do grupo |
| CNPJ | CNPJ do emitente da NFe, apenas números |
| ChaveNota | Chave da NF-e (44 dígitos) |
| Justificativa | Mensagem explicando o motivo do cancelamento, deve conter pelo menos 15 caracteres |
| ChaveNotaReferenciada | Chave da NFC-e emitida em contingência que substitui a que está sendo cancelada. |
| Orgao | Código IBGE da UF. Exemplo: 41 |
| Autor | Tipo do autor que esta realizando o cancelamento. Ex: 1 |
| VersaoAplicativo | Versão do aplicativo do emissor. Ex: 1.0 |
Os campos Orgao, Autor e VersaoAplicativo não são obrigatórios.
Retorno
Exemplo de retorno:
"Protocolo de autorização", "cStat (Código de status do retorno da Sefaz)", "Mensagem da Sefaz"
151150001669135, 135, Evento registrado e vinculado a NF-e
Exemplo de retorno com erro:
"Palavra Exception", "Classe da Exception", "Mensagem de Exception"
EXCEPTION,EspdCheckParamsException,NFCe 41180408187168000160653690000000041000005694 não esta AUTORIZADA.
Utilização da rota no POSTMAN
Colocamos um exemplo de como funciona a rota de CANCELAMENTO DE NOTAS POR SUBSTITUIÇÃO utilizando requisição HTTPS via POSTMAN.
Basta baixar nosso exemplo se encontra no final desta documentação e importar para seu postman ou para outro software de requisição de rota.
Comentários
2 comentários
Boa tarde.
Preciso cancelar a NFE 33.065 por estar sendo substituida pela NFE 33.159 e CANCELAR a NFE 33.160 por ter gerado em duplicidade, hoje, em meu sistema interno.
Aguardo retorno URGENTE.
Grata.
O programador da empresa está ausente e preciso resolver esse assunto.
Por favor, entre para comentar.