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).
Comentários
0 comentário
Por favor, entre para comentar.