Skip to main content
Status HTTP: 422

O que significa

A API não conseguiu resolver uma engine utilizável para a requisição. No Motor de CPF/CNPJ, a resolução segue esta ordem:
  1. engine_id informado no body: precisa existir, pertencer ao workspace (ou ser template do sistema) e ser compatível com o subject_type da análise.
  2. engine_id omitido: usa a engine padrão do workspace.
  3. Sem engine padrão: usa o template do sistema do subject_type (PJ ou PF).
No Motor de Borderô, a resolução é: engine_id explícito (parte de texto do multipart — engine de borderô do workspace ou template do sistema) ou, omitido/template-padrao, a engine template de borderô do sistema. Quando a engine encontrada não pode ser usada — arquivada, incompatível com a requisição ou indisponível — ou quando nenhuma etapa resolve uma engine, a API retorna 422 no_engine.
No Motor de CPF/CNPJ, engine_id inexistente ou de outro workspace retorna 404 not_found, não 422 no_engine.

Causas comuns

  • engine_id/engine_id de uma engine arquivada.
  • engine_id de uma engine PJ usada em análise de CPF (ou vice-versa): o subject_type da engine precisa bater com o do documento.
  • Engine de borderô não utilizável (nada para avaliar).
  • Workspace sem engine configurada e sem template do sistema aplicável.

Como corrigir

  • Confira o engine_id/engine_id enviado: ele deve ser o ID de uma engine ativa do seu workspace, compatível com a requisição.
  • Se não precisa de uma engine específica, omita o campo: a API usa a engine padrão do workspace ou o template do sistema (no borderô, template-padrao tem o mesmo efeito).
  • Engines são criadas e configuradas no app Sherlocker (não há CRUD de engines pela API /v1). Verifique a configuração no app.
  • Se a configuração parece correta e o erro persiste, acione o suporte em /support.

Exemplo

O texto de detail varia conforme a causa.

Relacionado