Integração - InvoiSys
  • Introdução👨‍💻
  • Processo de Integração 🚀
  • Soluções
    • Notas Fiscais
      • Emissão 📃
        • NF-e
          • Passo a Passo
          • Fluxos Operacionais
            • Fluxo - Envio Normal da NF-e
            • Fluxo - Envio Contingência da NF-e
            • Fluxo - Cancelamento/Inutilização da NF-e
          • Facilitadores
        • NFC-e
          • Passo-a-Passo
          • Fluxos Operacionais
            • Fluxo - Envio Normal NFC-e
            • Fluxo - Envio Contingência SEFAZ NFC-e
            • Fluxo - Envio Contingência Off-Line NFC-e
            • Fluxo - Cancelamento/Inutilização da NFC-e
        • NFS-e
          • Passo a Passo
          • Fluxos Operacionais
            • Fluxo - Envio Assíncrono da NFS-e
            • Fluxo - Cancelamento da NFS-e
      • Recebimento 🚚
        • NF-e
          • Passo a Passo
          • Fluxos Operacionais
            • Fluxo - Recebimento NF-e
        • CT-e
          • Passo a Passo
          • Fluxos Operacionais
            • Fluxo - Recebimento CT-e
        • NFS-e
          • Passo a Passo
          • Fluxos Operacionais
            • Fluxo - Recebimento NFS-e
        • Captura de Pedido de Compra
          • Fluxo de captura do pedido de compra nos documentos fiscais
  • Endpoints
    • Autorização 🔑
      • Token de Acesso (2.0)
      • Token de Acesso (3.0)
    • Emissão Notas 📄
      • NF-e
        • Enviar NF-e
        • Cancelar NF-e por CNPJ, número e série
        • Enviar CC-e
        • Obter PDF da CC-e
        • Consultar NF-e por Chave de Acesso
        • Obter DANFE
        • Obter XML
      • NFC-e
        • Enviar NFC-e (Completo)
        • Enviar NFC-e (Híbrido)
        • Enviar Contingência NFC-e (Completo)
        • Enviar Contingência NFC-e (Híbrido)
        • Consultar NFC-e por Número e Série
        • Consultar NFC-e por Chave de Acesso
        • Cancelar/Inutilizar NFC-e por CNPJ
      • NFS-e
        • Enviar RPS assíncrono
        • Consultar o lote RPS na Prefeitura
        • Consultar NFS-e por ID
        • Cancelar da NFS-e por CNPJ
        • Obter PDF
    • Recebimento Notas 🚚
      • NF-e
        • Consultar NSUi (Número Sequencial Único Invoisys)
        • Consultar NSUi (Número Sequencial Único InvoiSys) com Campos Customizados
        • Manifestar NF-e
        • Realizar Download de NF-e na SEFAZ
        • Importar NF-e por Chave de Acesso
        • Importar XML
        • Consultar XML importado
        • Consultar PDF importado
        • Importar anexo
        • Consultar anexo
      • CT-e
        • Consultar NSUi (Número Sequencial Único)
        • Consultar NSUi (Número Sequencial Único InvoiSys) com Campos Customizados
        • Importar de XML
        • Consultar XML importado
        • Consultar PDF importado
        • Importar de anexo
        • Consultar anexo
      • NFS-e
        • Consultar NSUi - Número Sequencial Único
        • Consultar NSUi (Número Sequencial Único InvoiSys) com Campos Customizados
        • Importar XML
        • Consultar XML importado
        • Consultar PDF importado
        • Importar anexo
        • Consultar anexo
    • Pedidos e Transporte 📫
      • Pedido de Compra
        • Criar Pedido de Compra
        • Editar Pedido de Compra
        • Consultar Pedido de Compra
        • Atualizar dados do Pedido de Compra vinculado
    • Outras consultas
      • Município
        • API - Município por UF e Nome
      • UF
        • API - UF
      • Enumeradores
        • API - Bandeira Cartão
        • API - Indicador Forma de Pagamento
        • API - Meio de Pagamento
        • API - Finalidade de Emissão
        • API - Modalidade de Frete
        • API - CRT
        • API - Tipo de Impressão do DANFE
        • API - Tipo Integração Pagamento
        • API - Natureza da Operação
        • API - Local de Destino da Operação
        • API - Unidade de Medida
        • API - Indicador de Presença
        • API - Tipo de Operação
        • API - Tipo Específico
        • API - Origem do Material
        • API - Tipo de Material
        • API - Tipo de Ambiente
        • API - Tipo de Manifesto
  • Extra
    • Dúvidas Frequentes e Outras Especificações
Powered by GitBook
On this page
  • O que é a emissão em contingência?
  • Endpoints Essenciais 💡
  • Endpoints Opcionais 🥈
  • Etapas e Endpoints
  • 1) Emissão da NF-e (Normal)
  • 2) Retorno da Chamada (Exceção na comunicação com a SEFAZ)
  • a) SVC Ligada
  • b) SVC Desligada
  • c) FSDA (Formulário de Segurança – Documento Auxiliar)
  • 3) Emissão em contingência
  • 4) Retorno da chamada

Was this helpful?

  1. Soluções
  2. Notas Fiscais
  3. Emissão 📃
  4. NF-e
  5. Fluxos Operacionais

Fluxo - Envio Contingência da NF-e

PreviousFluxo - Envio Normal da NF-eNextFluxo - Cancelamento/Inutilização da NF-e

Last updated 7 months ago

Was this helpful?

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

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.

Endpoints Essenciais 💡

  • Envio da NF-e:

  • Obter o DANFE da NF-e:

Endpoints Opcionais 🥈

  • Consultar NF-e por Chave de Acesso:

  • Obter XML da NF-e:

Etapas e Endpoints

Para detalharmos melhor a operação, a separamos em tópicos, 📝.

1) Emissão da NF-e (Normal)

2) Retorno da Chamada (Exceção na comunicação com a SEFAZ)

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:

Vale ressaltar que a escolha pelo método de contingência fica a critério do integrador.

a) SVC Ligada

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.

{
  "dadosDoDocumento": null,
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": true,
    "enviarContingencia": true,
    "tentarNovamenteMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": "The operation has timed out"
}

b) SVC Desligada

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.

{
  "dadosDoDocumento": null,
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": true,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": "Falha de comunicação com a SEFAZ. SVC desabilitado. - The operation has timed out"
}

c) FSDA (Formulário de Segurança – Documento Auxiliar)

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.

Legislação: O FSDA está regulamentado pelo Ajuste SINIEF 07/2005, que estabelece regras para a emissão de NF-e, incluindo situações de contingência.

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

3) Emissão em contingência

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”.

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

O segundo passo, é adicionar ao seu JSON de envio as seguintes tags:

Para SVC

  • 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.

Para FSDA

  • 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.

4) Retorno da chamada

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:

a) Autorização

b) Rejeição

c) Exceção na comunicação com a SVC

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.

{
  "dadosDoDocumento": null,
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": true,
    "tentarNovamenteMaisTarde": true,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": "The operation has timed out"
}

d) SVC desligada

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.

{
  "dadosDoDocumento": null,
  "acoes": {
    "corrigirDocumento": true,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarNovamenteMaisTarde": true,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": "Sefaz de contingência não está habilitada. (SVCXX), tente novamente mais tarde enviando de forma 'Normal(Contingencia=false)'."
}

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 .

Ajuste SINIEF 07/05
/api/nfe/envio
/api/nfe/obterpdf
/api/nfe/getbychavesSTD/{chave}
/api/nfe/obterxml
porém você consegue ver o fluxo completo aqui
embasamento legal
API para envio da nota
cancelamento da nota que apresentou uma exceção na comunicação com a SEFAZ
facilitadores
a) Autorização da NF-e;
b) Rejeição da NF-e;
c) Exceção na comunicação com a SVC;
d) SVC desligada
token de acesso
Emissão em Contingência
Envio Normal da NF-e
Retorno do Envio Normal
b) Tentar emitir a nota novamente como normal em um momento posterior
enviá-la novamente como normal em um momento posterior
tentar reenviar o documento novamente como normal
envio normal
fluxo do envio normal
mesmos passos para identificar se a nota foi rejeitada e qual rejeição a nota recebeu
enviar novamente o documento como "normal" sem alterar a numeração