Fluxo - Envio Síncrono da NFS-e
Last updated
Was this helpful?
Last updated
Was this helpful?
A emissão de uma NFS-e abrange as operações comerciais de uma prestação de serviços.
O fluxo demonstrado a seguir trata a emissão da nota dentro da integração com a InvoiSys.
Envio Completo do documento:
Envio Híbrido do documento:
Consulta da NFS-e por Id Documento:
Consulta Paginada de NFS-e:
Para detalharmos melhor a operação, a separamos em tópicos, 📝.
Antes de iniciamos a emissão da nota, é necessário estar com um token de acesso válido, pois este será utilizado no cabeçalho da chamada da ou a . Tendo ele em mãos, podemos partir para a emissão da nota.
A sua missão é gerar os dados da operação, como Serviço, Número/Série do RPS, etc., e criar um JSON que será repassado para nós.
Assim que recebermos a chamada, faremos algumas validações, e se estiver correto, assinaremos o mesmo e o transmitiremos à Prefeitura.
Todo documento enviado para a SEFAZ gera um mensagem de retorno. Esta mensagem será recebida por nós, e, na mesma chamada, iremos retorna-lo para você junto dos dados do documento.
Aqui existem algumas informações que podem ser interessantes você guardar, como o id
do documento. Estas informações são importante, já que elas são utilizados em outras APIs.
Para identificarmos que foi um sucesso, podemos observar as seguintes tags:
status
: Retorno Autorizado
;
sucesso
: Retorno true
.
A seguir temos um exemplo de um retorno após a autorização de um documento:
Se a nota estiver autorizada, então podemos realizar a impressão do PDF. Nós deixamos disponível no campo: linkImpressao
um link de acesso criado pela Prefeitura que possuirá este recibo.
Caso a prefeitura não forneça link para impressão do PDF, a Invoisys disponibiliza a opção de utilizar nosso PDF, que contempla a impressão em todas as prefeituras!
Neste caso, a opção é realizar o cancelamento do documento, e realizar a emissão de uma nova NFS-e.
Alguns imprevistos ocorrem. Para identificarmos se o documento apresentou uma rejeição, devemos observar seguintes tags:
sucesso
: Retorno false
;
status
: Retorno Erro
.
Realmente houve um erro com o seu documento? Então podemos checar a seguintes informações retornada para você:
excecoes
: Retorno da rejeição, informado pela Prefeitura;
solucao
: Caso a Prefeitura disponibilize, informando como corrigir a rejeição.
No exemplo a seguir vemos uma nota que foi rejeitada por estar com um código de serviço inválido:
Terminamos esta etapa 😁. Para seguir, basta selecionar a card abaixo.
Posteriormente você poderá realizar a consulta destes documentos por nossas APIs de ou de para também obter informações sobre estas NFS-es.
Corrigido? Então vamos voltar para . Se desta vez tudo estiver certo, a Prefeitura irá autorizar esta NFS-e.