Motivos de erro na atualização de processos – Suporte da API

A atualização de processos pela API ocorre de forma assíncrona, e o andamento da solicitação pode ser acompanhado por meio da consulta de status.

Caso o processamento não seja concluído com sucesso, a solicitação será apresentada com o status ERRO. Nessas situações, o campo motivo_erro informa a causa identificada e pode assumir diferentes valores.

Veja abaixo um exemplo desse retorno:

{
    "numero_cnj": "0000000-00.0000.0.00.0000",
    "data_ultima_verificacao": "2025-03-01T04:26:25+00:00",
    "tempo_desde_ultima_verificacao": "há 1 ano",
    "ultima_verificacao": {
        "id": 00000000,
        "status": "ERRO",
        "motivo_erro": "CAPTCHA_ERROR",
        "criado_em": "2026-09-03T16:01:40+00:00",
        "numero_cnj": "0000000-00.0000.0.00.0000",
        "concluido_em": "2026-09-03T22:18:45+00:00",
        "opcoes": {
            "documentos_publicos": true
        },
        "enviar_callback": "SIM"
    },
    "opcoes": {
        "atualizar_resumo": null
    }
}

A seguir, apresentamos alguns dos valores que podem ser retornados e as recomendações para cada caso:

CAPTCHA_ERROR

O CAPTCHA_ERROR indica uma falha durante o fluxo de resolução do CAPTCHA ao acessar o sistema do tribunal.

Como essa falha pode estar relacionada a uma condição temporária de acesso, recomendamos realizar uma nova solicitação de atualização posteriormente.

Caso o erro persista após novas tentativas, entre em contato com o nosso suporte técnico para que possamos realizar uma análise mais detalhada.

LOGIN_ERROR

O LOGIN_ERROR está relacionado à etapa inicial de autenticação no sistema do Tribunal. Esse erro pode ocorrer quando as credenciais utilizadas, como usuário e senha ou certificado digital, não são aceitas pelo tribunal.

Nesses casos, recomendamos verificar diretamente no sistema do tribunal se as credenciais utilizadas para acesso continuam válidas. Se necessário, atualize a autenticação cadastrada no Escavador e faça uma nova solicitação de atualização.

Para mais informações sobre as formas de autenticação e o uso de certificado digital na atualização de processos, consulte:

SECRET_ERROR

O SECRET_ERROR indica uma falha relacionada à autenticação em dois fatores (2FA/MFA) utilizada para acesso ao sistema do tribunal que possui essa exigência.

Nesses casos, recomendamos verificar se a autenticação em dois fatores continua válida no sistema do tribunal. Se necessário, configure novamente o método de autenticação associado ao certificado digital no Escavador e faça uma nova solicitação de atualização.

Para mais informações sobre essa configuração, consulte:

PROCESSO_EM_SEGREDO

O PROCESSO_EM_SEGREDO é retornado quando a tramitação sob segredo de justiça impede a obtenção das informações solicitadas.

Processos sob segredo de justiça possuem restrições de acesso definidas pelo Tribunal e não devem ser confundidos com aqueles que possuem apenas autos ou documentos restritos. Para estes, infelizmente a API do Escavador ainda não possui suporte, ainda que seu usuário possua acesso específico ao processo relacionado, mas nossa equipe continua trabalhando constantemente para evoluir o produto.

PROCESSO_FISICO

O PROCESSO_FISICO informa que os autos estão disponíveis apenas em meio físico, impossibilitando a obtenção completa do arquivo digital da documentação pela API.

Nesses casos, pode ser possível atualizar as informações do processo e, eventualmente, obter alguns documentos digitalizados que estão disponíveis nos sistemas do Tribunal, mas a captura integral dos documentos do processo não está disponível. Uma nova tentativa de atualização, portanto, não deve alterar o resultado enquanto o processo permanecer nessa condição e não seja migrado para algum sistema virtual/digital.

2FA_NOT_FOUND

O 2FA_NOT_FOUND indica que não foi possível concluir a autenticação em dois fatores (2FA) exigida pelo sistema do Tribunal porque a chave de 2FA necessária para realizar a autenticação não foi fornecida.

Essa situação pode ocorrer quando a solicitação não possui a configuração de 2FA necessária para realizar o acesso. Para verificar quais sistemas dos Tribunais utilizam autenticação em dois fatores e quais as formas de acesso disponíveis, consulte a rota de listagem de sistemas dos Tribunais.

Caso esteja disponível o acesso por certificado, siga o passo a passo de como obter o QR Code para Autenticação Multifator (MFA) e cadastrar no Escavador. Após concluir a configuração, realize uma nova solicitação de atualização.

Se o erro persistir mesmo após a configuração, entre em contato conosco para que possamos realizar uma análise mais detalhada.

INTERNAL_ERROR

O INTERNAL_ERROR representa um erro genérico ocorrido durante o processamento da atualização, sem a identificação de uma causa específica.

Como essa ocorrência pode estar relacionada a uma condição temporária durante o processamento, recomendamos realizar uma nova solicitação de atualização posteriormente.