Falha de Processamento

Durante o processamento dos callbacks podem ocorrer falhas, por exemplo, quando o serviço atinge o limite máximo de tentativas sem sucesso.

Nesses casos, o serviço trata os erros de forma controlada, garantindo rastreabilidade, integridade do fluxo e evitando reprocessamentos infinitos.

Pasta quarentena

Quando ocorre falha de processamento, o arquivo correspondente é movido automaticamente para a pasta de quarentena (\failed) para análise manual.
Isso assegura que o mesmo arquivo não seja processado repetidamente de forma incorreta.

O serviço moverá o arquivo para a pasta de quarentena quando:

• O limite de tentativas for atingido.
• O fluxo em andamento informado não existir.
• A estrutura do arquivo JSON for inválida.

O serviço excluirá o arquivo JSON em casos específicos:

• Quando o callback já tiver sido processado anteriormente.
• Quando a propriedade action contiver um valor que não esteja configurado para realizar avanço de fluxo.

Comportamento de logs em caso de falha

O serviço registra todas as falhas em log de forma detalhada, tanto em arquivos de log locais quanto no banco de dados do SmartShare, permitindo auditoria e monitoramento.

• Logs em arquivo (texto):
  • Quando a propriedade action não for informada.

• Quando a propriedade envelopeID ou documentID não for informada.

• Quando o arquivo já tiver sido processado.

• Logs em banco de dados (tabela LOG_APLICACAO do SmartShare) com a seguinte identificação:
  • cd_tipo_aplicacao = 111 (SmartSigner);
  • cd_tipo_acao = 60 (Processamento de Callback).