Cancelando uma nota | NFS-e – Central de Atendimento

Caso necessite realizar o cancelamento de uma nota, isso é possível tanto pela Rota de Cancela, quando pela interface web.

Cancelando via Interface

O cancelamento via interface, é feito da seguinte forma: selecione a nota desejada e, em seguida, clique em "Cancelar" conforme exemplo abaixo:

Após clicar em "Cancelar", uma mensagem de confirmação irá exibir conforme exemplo abaixo:

Cancelando via API

A rota cancela será utilizada para cancelarmos uma NFS-e que esteja autorizada na Prefeitura, a comunicação é síncrona, portanto o retorno da requisição que fizermos, será a resposta do SaaS dizendo se a nota foi cancelada ou se não foi cancelada.

POST

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfse/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 acessar a interface Web do grupo desejado do SaaS, localizado em https://managersaas.tecnospeed.com.br:8081

Este parâmetro deve ser gerado a partir de um Base64 da seguinte informação: usuario:senha

Para o exemplo de usuario:senha = admin:1234, o valor gerado é:

Basic YWRtaW46MTIzNA==

Body

Nome	Descrição
Grupo	Nome do grupo
CNPJ	CNPJ do emitente da NFe, apenas números
NomeCidade	Nome da cidade do emitente (Ex: CidadeUF)
NumRPS	Número do RPS
SerieRPS	Serie do RPS
TipoRPS	Tipo do RPS
encode	Tratamento de encode da resposta do manager SaaS. Enviar com o valor true

Retorno

Exemplo de retorno:

"Handle", "Número NFSe", "Protocolo de cancelamento quando disponibilizado pela prefeitura", "Mensagem"

713,1455,,Cancelamento de NFS-e Homologado

Exemplo de retorno com erro:

"Palavra Exception", "Classe da Exception", "Mensagem de Exception"

EXCEPTION,EspdManNFSeCheckParamsException,Erro ao Cancelar - Nenhuma NFS-e foi encontrada com estes critérios: nrps='542' and serie='894' and tipo='0' and cidade='MARINGA' and CNPJ='29062609000177' and ambiente='2'

Caso queira saber mais sobre essa rota, acesse aqui.

OBS: Nesta etapa, dependendo do padrão da prefeitura, poderá aparecer uma tela solicitando o "Motivo do Cancelamento". Caso isto ocorra, preencha o campo com o Motivo que ocasionou o cancelamento e confirme.

Obs2: Em anexo você encontra o json dessa requisição que pode ser importado no seu Postman (ou outra aplicação de requisições).