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:engine_idinformado no body: precisa existir, pertencer ao workspace (ou ser template do sistema) e ser compatível com osubject_typeda análise.engine_idomitido: usa a engine padrão do workspace.- Sem engine padrão: usa o template do sistema do
subject_type(PJ ou PF).
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_idde uma engine arquivada.engine_idde uma engine PJ usada em análise de CPF (ou vice-versa): osubject_typeda 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_idenviado: 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-padraotem 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
detail varia conforme a causa.