Fluxo - Envio Contingência da NF-e
Last updated
Was this helpful?
Last updated
Was this helpful?
A emissão em contingência é um processo criado para que, sempre que hajam problemas na autorização da nota pela SEFAZ, o contribuinte tenha um respaldo para que sua operação prossiga normalmente. Segundo o :
Cláusula décima primeira: Quando em decorrência de problemas técnicos não for possível transmitir a NF-e para a unidade federada do emitente, ou obter resposta à solicitação de Autorização de Uso da NF-e, o contribuinte poderá operar em contingência, gerando arquivos indicando este tipo de emissão, conforme definições constantes no MOC, mediante a adoção de uma das seguintes alternativas: I - transmitir a NF-e para a Sefaz Virtual de Contingência - SVC, nos termos das cláusulas quarta, quinta e sexta deste ajuste; II - transmitir Evento Prévio de Emissão em Contingência - EPEC, nos termos da cláusula décima sétima-D; III - imprimir o DANFE em formulário de segurança - Formulário de Segurança para Impressão de Documento Auxiliar de Documento Fiscal Eletrônico (FS-DA), observado o disposto no Convênio ICMS 96/09, de 11 de dezembro de 2009.
Atualmente a InvoiSys possibilita a contingência SVC e FSDA.
Para entender como é o processo de emissão em contingência, o fluxo demonstrado a seguir acoberta a emissão da nota dentro da integração com a InvoiSys.
Envio da NF-e:
Obter o DANFE da NF-e:
Consultar NF-e por Chave de Acesso:
Obter XML da NF-e:
Para detalharmos melhor a operação, a separamos em tópicos, 📝.
Quando isso ocorre, a InvoiSys consulta prontamente qual o status do SVC e nosso retorno será baseado em como ele estiver. O tratamento do retorno poderá variar de acordo com o status do SVC, podendo levar a 2 cenários:
A SEFAZ Virtual de Contingência (SVC) é um serviço que pode ser ligado pela SEFAZ autorizadora caso esta esteja com problemas na autorização dos documentos ou em uma manutenção.
Este serviço é ligado em casos extremos em que a SEFAZ ficará fora durante horas. Na prática, vemos poucas vezes este sendo ativado.
Para identificarmos se o SVC está ligado, devemos observar as seguintes informações:
acoes: enviarContingencia
: Retorno true
;
acoes: cancelar
: Retorno true
;
A seguir temos o exemplo do retorno para quando há um timeout na SEFAZ e a SVC está ligado.
Como mencionamos no tópico anterior, a SEFAZ Virtual de Contingência não estará ligada 100% do tempo, sendo assim, precisamos ter em mãos um segundo tratamento.
Caso esteja desligada, nós observaremos as seguintes tags:
acoes: tentarNovamenteMaisTarde
: Retorno true
;
excecao
: Retorno Falha de comunicação com a SEFAZ. SVC desabilitado.
O FSDA (Formulário de Segurança para Impressão de Documentos Auxiliares) é um tipo de documento utilizado para a impressão de DANFE (Documento Auxiliar da Nota Fiscal Eletrônica) em situações em que há indisponibilidade do sistema autorizador da SEFAZ. Ele serve como uma alternativa segura para emissão de documentos fiscais eletrônicos.
Estados que aceitam: Alguns dos estados que aceitam o FSDA como forma de contingência incluem São Paulo (SP), Minas Gerais (MG), Rio Grande do Sul (RS), e Paraná (PR).
É possível optar pela emissão via FSDA caso possua o beneficio no estado onde está credenciado, principalmente se sua operação ocorre na rua e não há redundância ou mesmo rede para transmissão online das NF-es
Conforme falamos anteriormente, com a SVC ligada temos a possibilidade da emissão em contingência.
Para isso, primeiramente é necessário avançar a numeração da nota. Você deve se perguntar: "Por que devo trocar a numeração se ainda não emiti a nota?". A gente te explica!
Quando ocorre uma exceção na comunicação com a SEFAZ, não temos o retorno da chamada, ou seja, não sabemos se a nota foi autorizada ou não, pois a SEFAZ não nos informou. Sendo assim, acaba sendo um risco enviar na mesma numeração, pois pode acarretar em uma um duplicidade ou rejeição da nota e, assim, atrasando a operação. Para complementar o processo e evitarmos que tenhamos duas notas acobertando a operação, devemos enviar o cancelamento da nota que não obteve retorno da SEFAZ.
Cláusula décima primeira ... § 14. É vedada a reutilização, em contingência, de número de NF-e transmitida com tipo de emissão “Normal”.
O segundo passo, é adicionar ao seu JSON de envio as seguintes tags:
contingencia
: Enviar true
;
dhCont
: Enviar o horário da entrada em contingência no formato AAAA-MM-DDThh:mm:ssTZD
(Exemplo: 2018-12-27T07:50:52-04:00);
xJust
: Enviar uma string justificando o motivo da entrada em contingência.
fsda
: Enviar true
;
dhCont
: Enviar o horário da entrada em contingência no formato AAAA-MM-DDThh:mm:ssTZD
(Exemplo: 2018-12-27T07:50:52-04:00);
xJust
: Enviar uma string justificando o motivo da entrada em contingência.
Nele existem algumas informações que podem ser interessantes você guardar, como a chaveDeAcesso
e, opcionalmente, o id
do documento criado em nossa base, pois são utilizados em outras APIs.
Atenção, pois o envio da nota em contingência ao SVC será sempre síncrono!
Resumidamente, com base no retorno podemos chegar a 4 cenários:
Mesmo estando ligada, a SVC não é à prova de falhas e também pode, algumas vezes, não retornar a comunicação.
Nesses casos, como já estamos operando em contingência, deveremos aguardar alguns minutos e tentar enviar novamente. Abaixo vemos como será o retorno para este cenário.
Caso tente fazer o envio em contingência e a SVC estiver desligada, você irá observar as seguintes informações:
corrigirDocumento
: retorno true
;
tentarNovamenteMaisTarde
: retorno true
.
Seu papel, em seguida, será modificar as seguintes tags em seu envio:
contingência
: Enviar false
;
dhCont
: Remover do envio;
xJust
: Remover do envio.
Neste cenário em específico podemos reutilizar a numeração, pois a nota não chegou a ser enviada para a SVC ou SEFAZ.
Terminamos esta etapa 😁. Para seguir, basta selecionar a card abaixo
Realizaremos os mesmos procedimentos do fluxo de , nos atentando para termos um válido e também os dados da operação.
Diferente do que vimos no , dessa vez não temos uma resposta da SEFAZ para emissão da nota, sendo assim, temos uma exceção na comunicação.
a) Emissão no SVC c) Emissão FSDA
Com o SVC ligado, podemos efetuar a do documento, ou, caso deseje, você pode optar por aguardar a estabilização da SEFAZ autorizadora e .
Caso o SVC esteja desligado, então teremos que aguardar alguns minutos e .
Além dessa explicação, também temos o sobre a não reutilização de um número emitido como normal para uma emissão em contingência.
Após ajustarmos o JSON, podemos realizar a chamada da . Também deveremos efetuar o .
Assim como no , as notas emitidas em contingência também terão uma mensagem de retorno da SEFAZ. Esta mensagem será recebida por nós, e em seguida retornaremos na mesma chamada da API juntamente com os dados do documento e suas respectivas ações. É com base nesse retorno que entendemos o que deve ser feito após a emissão da NF-e.
.
Para verificarmos se nota foi autorizada, devemos seguir os mesmos passos descritos no .
Assim como na autorização, também seguiremos o .
Por fim, o que você irá fazer é.
Não quer lidar com toda a complexidade da contingência? Confira nossos .