Fluxo - Envio Contingência Off-Line NFC-e

O que é a emissão em contingência off-line?

A emissão em contingência off-line é um processo criado para que, sempre que hajam problemas de comunicação entre a solução integradora e a solução InvoiSys, o contribuinte tenha um respaldo para que sua operação prossiga normalmente.

Modelo de Integração Completo Este fluxo é específico para quem estiver integrando com a nossa solução utilizando o Modelo Completo!

API's Essenciais 💡

• Envio Completo em contingência do documento: /api/nfce/envioxmlcontingencia

• Gerar DANFE: /api/nfce/getdanfe/{id}

• Cancelar documento por ID Estabelecimento: /api/nfce/cancelarnfce

• Cancelar documento por CNPJ: /api/nfce/cancelarnfcecnpj

API's Opcionais 🥈

• Envio Completo do documento: /api/nfce/envioxmlnormal

• Consulta do documento por Chave de Acesso: /api/nfce/getbychavedeacesso/{chave}

• Consulta do documento por Número/Série: /api/nfce/getby_numero_serie_cnpj/{numero}/{serie}/{cnpj}/{ambiente}

• Consulta do documento por ID: /api/nfce/{id}

Etapas e suas API's

Para detalharmos melhor a operação, a separamos em tópicos, porém você consegue ver o fluxo completo aqui 📝.

1) Emissão da NFC-e

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 API de Envio. Tendo ele em mãos, podemos partir para a emissão da nota.

A sua missão é gerar os dados da operação, como Produtos e Pagamentos, e criar um XML (Modelo Completo) que será mandado em nossas APIs.

2) Retorno da Chamada (Falha de Comunicação)

Diferentemente do que ocorre com outros fluxos, você não terá uma resposta de nossa solução, seja por queda da conexão ou intermitência de nosso serviço. Esta comunicação resultará em um Timeout.

Em caso intermitência do serviço da invoiSys, a rota de emissão retornará o response code 404 (not found) ou 500 (internal server error) dentro do time out de 5 minutos da API. Se obter esses retornos em mais de 5 chamadas subsequentes, recomendamos a entrada em contingência offline, como descrito no próximo tópico, e nova tentativa de emissão online após 30 minutos, reenviando todas as NFC-es represadas durante o período.

3) Emissão em Contingência Off-Line

Os documentos emitidos Normal que forem pegos com este Timeout não poderão ser reutilizados para a emissão em contingência. Também temos o embasamento legal sobre a não reutilização de um número emitido como normal para uma emissão em contingência.

Cláusula décima primeira ... § 2º É vedada: A reutilização, em contingência, de número de NFC-e transmitida com tipo de emissão “Normal”;

Resumindo Se eu emitir a nota 1/1 e receber um timeout, então deverei emiti-lá novamente na numeração 2/1. Depois, preciso fazer o cancelamento da nota 1/1.

Por estarmos trabalhando com um envio completo, você já deverá ter toda a validação básica necessária. Desta forma, podemos trabalhar com a operação off-line até que a conexão entre a solução integradora e InvoiSys seja reestabelecida.

Esta etapa da operação pode ser separada em três etapas:

a) Emissão em Contingência Off-Line; b) Impressão do DANFE; c) Armazenamento da NFC-e.

Emissão em Contingência Off-Line

Sem a conexão, os documentos precisam ser emitidos em contingência. Isto significa que, dentro de seu XML, deverá ser preenchido as tags:

• dhCont que terá a data e hora de entrada em contingência;

• xJust que terá a justificativa da entrada em contingência.

Impressão do DANFE

Como você já possui todos os dados básicos da operação e de validação, será realizado a impressão do DANFE com a sua solução. Todos os dados no DANFE disponíveis para o cliente poderão ser acessadas posteriormente, quando a NFC-e for transmitida à SEFAZ.

Armazenamento da NFC-e

Até que a conexão seja restabelecida, todos os documentos emitidos neste intervalo deverão ser guardados por você, integrador.

4) Consulta da Disponibilidade

Esta etapa pode causar uma dúvida pontual no integrador:

"Mas como eu posso checar a disponibilidade do serviço?"

As possibilidades são grandes aqui!

Podemos, desde tentar periodicamente utilizar alguma API básica e observar se ela irá retornar um Timeout, ou você poderá criar algum procedimento interno que irá checar a disponibilidade. Neste etapa deixamos em aberto qual o método que você melhor achar.

"Mas e depois de consultar a disponibilidade, o que eu faço?"

Não se preocupe, pois esta consulta irá sempre resultar em um dos dois cenários:

a) Sem Conexão; b) Conexão Restabelecida.

Sem Conexão

Ainda não é possível transmitir os documentos presos para a InvoiSys. Você ainda deverá emitir em contingência Off-Line!

Conexão Restabelecida

O link de conexão foi novamente criado, e você poderá nos enviar os documentos armazenados em sua solução.

5) Transmissão das Notas para a InvoiSys

Assim como no envio normal, 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.

Nele existem algumas informações que podem ser interessantes você guardar, como a chaveDeAcesso e o id do documento criado em nossa base, pois são utilizados em outras APIs.

{
  "dadosDoDocumento": {
    ...
    "documentoComErro": false,
    "codigoStatusSEFAZ": null,
    "descricaoStatusSEFAZ": null,
    ...
    "documentoJaEmitidoAnteriormente": false,
    "status": {
      "key": 4,
      "value": "Aguardando envio para SEFAZ"
    }
  },
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false,
    "emitirProximoDocumentoNormal": true
  },
  "excecao": null
}

Resumidamente, com base no retorno podemos chegar a 3 cenários:

a) Autorização da NFC-e; b) Rejeição da NFC-e; c) Exceção na comunicação com a SEFAZ;

a) Autorização

Para verificarmos se nota foi autorizada, devemos seguir os mesmos passos descritos no fluxo do envio normal.

Cancelamento por Substituição A NFC-e emitida em contingência serve para acobertar a NFC-e que não teve retorno. Nós explicamos no fluxo de Cancelamento/Inutilização da NFC-e

b) Rejeição

Assim como na autorização, também seguiremos o mesmos passos do Fluxo de Envio Normal para identificar se a nota foi rejeitada e qual rejeição a nota recebeu.

c) Exceção na Comunicação com a SEFAZ

Este cenário é tratado por nossa solução. Quando ocorre o Timeout no envio deste documento, nós fazemos o reagendamento automático.

Neste caso, você poderá utilizar a nossa API de Consultar NFC-e, API de Consultar NFC-e por Númeoro e Série ou API de Consultar NFC-e por Chave de Acesso para checar periodicamente se o documento teve o status atualizado.

Terminamos esta etapa 😁. Para seguir, basta selecionar a card abaixo.