Facilitadores

Os facilitadores atuarão simplificando o processo de integração através de configurações pré-definidas. A seguir, analisaremos quais processos podem ser otimizados:

Retentativas automáticas

É possível configurar no Portal invoiSys retentativas automáticas de forma individualizada por empresa. Em caso de falha na comunicação com a SEFAZ, o sistema realizará o reenvio do documento para autorização conforme o número de tentativas estabelecido.

Se optar pela configuração, basta reenviar a NF-e nos casos síncronos. Se a NF-e estiver sob retentativa automática e for autorizada, o sistema incluirá os dados da autorização no response code da API de envio. Para as UFs assíncronas, recomenda-se realizar consultas espaçadas para acompanhamento.

Contingência automática

Se optar por simplificar o processo de contingência, será possível configurar, individualmente por empresa, qual tipo de contingência será adotado nos casos em que a SEFAZ estiver offline, conforme indicado pelo nosso semáforo de monitoramento contínuo do status do webservice. As opções disponíveis incluem SVC (SEFAZ Virtual de Contingência) ou FSDA (Formulário de Segurança).

Com essa configuração aplicada, não será necessário mapear os fluxos de contingência anteriores. Basta incluir o campo "contingAutomatico": true no JSON de envio da nota, e a invoiSys cuidará de interpretar a situação, determinando automaticamente se o documento pode ser emitido em contingência nos casos em que o semáforo indicar instabilidade ou indisponibilidade da SEFAZ.

Caso a NF-e tenha sido incluída em uma fila de envio em contingência, a API de envio retornará:

200 - Incluído na fila de contingência

{
  "dadosDoDocumento": null,
  "acoes": {
    "corrigirDocumento": false,
    "cancelar": false,
    "enviarContingencia": false,
    "tentarMovimentoMaisTarde": false,
    "entrarEmContatoComSuporteImediatamente": false
  },
  "excecao": "NF-e colocada na fila de contingência automática"
}

Para obtenção do retorno, o recomendado é realizar o mesmo procedimento citado no tópico de Retentativas Automáticas.

Se optar pela configuração "SVC", o invoiSys enviará o documento para a fila de contingência apenas quando a SEFAZ Virtual de Contingência estiver habilitada. Caso contrário, o sistema retornará uma falha de comunicação com a SEFAZ e indicará que o SVC está desabilitado. Se o retry automático estiver configurado, o sistema realizará as tentativas de envio conforme parametrizado.