Skip to main content
O Sherlocker expõe dois motores de análise pela mesma API /v1 — mesma base, mesma chave slhk_ e mesma feature de acesso:
  • Motor de CPF/CNPJ — análise de risco de um documento individual: você envia um CNPJ ou CPF e recebe um veredito consolidado (verdict) com o detalhamento de cada verificação (blocks) e das fontes consultadas (coverage).
  • Motor de Borderô — análise de uma operação de desconto de duplicatas a partir de um arquivo CNAB 400: o motor faz o parse dos títulos, analisa o cedente e cada sacado único, valida cada título (com cruzamento opcional contra XMLs de NFe) e devolve um veredito por título e da operação.
Os dois motores estão em beta. O acesso é liberado por workspace através da feature analysis_engine (necessária para qualquer chamada /v1) e, adicionalmente, analysis_engine_pf para análises de CPF. Sem a feature, as chamadas retornam 403 feature_not_enabled. Solicite acesso aqui.

​
Qual motor usar?

Regra prática: se a pergunta é “posso operar com esta empresa/pessoa?”, use o Motor de CPF/CNPJ. Se é “o que fazer com cada título deste borderô?”, use o Motor de Borderô.

​
Como os dois compõem

O Motor de Borderô usa o Motor de CPF/CNPJ por baixo: cada entidade única do arquivo (o cedente e cada sacado distinto) é analisada uma vez — e o detalhamento de cada entidade chega nas issues dos próprios nós cedente e sacados[] da árvore do GET /operations/{id}/result: Ambos são assíncronos (polling — no CPF/CNPJ com poll_after_seconds/Retry-After, no borderô a cada ~2s), cobram tokens do mesmo pool do workspace (com estorno automático em failed) e retornam erros no mesmo formato RFC 7807 — veja a referência comum de erros. O header Idempotency-Key é obrigatório no POST /analyses e opcional no POST /operations — veja Idempotência.
Os Motores usam a mesma base da API 221b (https://221b-api.sherlocker.com.br/api/v1), mas autenticam via Authorization: Bearer slhk_… — não via ?token=.

​
Collection do Postman

Disponibilizamos uma collection do Postman só para os Motores, com as requests dos dois motores (POST/GET /analyses e POST/GET /operations), autenticação Bearer slhk_ já configurada e captura automática do analysis_id/operation_id.
1

Baixar a collection

Faça download do arquivo sherlocker-motores-postman-collection.json.
2

Importar no Postman

No Postman, clique em Import e selecione o arquivo. Você verá a collection Sherlocker Motores de Análise v1 com as pastas Motor de CPF/CNPJ e Motor de Borderô (CNAB 400).
3

Configurar a chave slhk_

Abra a aba Variables da collection e preencha token com sua chave slhk_. A collection já usa Authorization: Bearer {{token}} — não use ?token=.
4

Testar

Rode Criar análise - CNPJ (PJ): o analysis_id é salvo automaticamente. Em seguida rode Consultar análise e repita até o status ser completed. Para o borderô, selecione o arquivo .REM no campo file de Criar operação.
As variáveis document e cedente_cnpj já vêm com valores de exemplo. Preencha apenas o token para começar.
Nunca compartilhe a collection com o token preenchido. Use a coluna Current value (que não é exportada) em vez de Initial value.

​
Próximos passos

Motor de CPF/CNPJ

Análise de risco de um CNPJ ou CPF individual

Motor de Borderô

Análise de borderôs CNAB 400 com validação de NFe

Autenticação

Uma chave slhk_, os dois motores

Solicitar acesso

Peça acesso ao beta para o seu workspace