Fluxo - Cancelamento da NFS-e
A emissão de uma NFS-e abrange as operações comerciais de venda presencial ou venda para entrega em domicílio a consumidor final (delivery).
O fluxo demonstrado a seguir trata a emissão da nota dentro da integração com a InvoiSys.
API's Essenciais 💡
Cancelar documento por ID Estabelecimento: /api/nfse/cancelarnfse
Cancelar documento por CNPJ: /api/nfse/cancelarnfsecnpj
API's Opcionais 🥈
Consulta da NFS-e por Id Documento: /api/nfse/{id}
Consulta Paginada de NFS-e: /api/nfse/{pagina}/{n_itens}
Etapas e API's
Para detalharmos melhor a operação, a separamos em tópicos, porém você consegue ver o fluxo completo aqui 📝.
1) Emitindo o Cancelamento
Da mesma maneira que no Envio Síncrono da NFS-e e no Envio Assíncrono da NFS-e, também precisamos nos atentar para termos um token de acesso válido.
Tendo ele em mãos devemos então escolher qual API utilizaremos. Atualmente temos duas:
Depois de decidirmos qual API utilizaremos, devemos preparar o JSON com as informações e então realizar a chamada da API.
Prazo máximo para cancelamento!
1) Antes do recolhimento do ISS: O cancelamento da NFS-e poderá ser feito desde que não tenha ultrapassado o prazo de 6 meses contados da data de emissão da NFS-e.
2) Após o recolhimento do ISS: O prazo do cancelamento varia para cada município. O serviço deve NÃO ter sido prestado, e um processo administrativo deverá ser aberto na devida Prefeitura.
2) Retorno da chamada
Conforme falamos no tópico anterior, o retorno da chamada da API variará de acordo com o status do documento na SEFAZ. É com base nesse retorno que entendemos o que deve ser feito após a emissão do mesmo.
Assim como no Envio Síncrono e Envio Assíncrono, nele existem algumas informações que podem ser interessantes você guardar, como o id
do documento criado em nossa base, pois são utilizados em outras APIs.
Com base no retorno podemos chegar a 2 cenários:
a) Cancelamento da NFC-e (Sucesso); b) Rejeição no Cancelamento.
a) Cancelamento da NFS-e (Sucesso)
Cenário de sucesso na chamada da API. Para isso devemos observar as seguintes informações:
status
: RetornoCancelado
;sucesso
: Retornotrue
.
Veja no exemplo abaixo:
b) Rejeição no Cancelamento
Caso o cancelamento possua algum erro, iremos retornar para você o que ocorreu, seja por conta de validação interna ou por alguma validação da Prefeitura. Abaixo um exemplo de um retorno:
Terminamos esta etapa 😁. Para seguir, basta selecionar a card abaixo.
Last updated