> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sherlocker.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Motor de CPF/CNPJ

> Análise de risco automatizada de CNPJ e CPF via API

O **Motor de CPF/CNPJ** (Motor de Análise) é a API pública para rodar análises de risco automatizadas de **CNPJ** e **CPF** — o mesmo motor usado na interface web do Sherlocker. Você envia um documento, o motor consulta as fontes de dados configuradas na sua engine e devolve um veredito consolidado com o detalhamento de cada verificação.

Foi feito para quem precisa de análise cadastral e de risco dentro do próprio fluxo:

* **FIDCs** — análise de cedentes e sacados antes da operação
* **Fintechs** — verificação de contrapartes no onboarding
* **Backoffices de crédito** — automação da esteira de cadastro

<Warning>
  O Motor de Análise está 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](/api/access).
</Warning>

## Como funciona

A API é assíncrona, com apenas dois endpoints:

1. `POST /analyses` cria a análise com o documento (CNPJ ou CPF) e retorna `202 Accepted` com o `id`. Os tokens do workspace são debitados nesse momento.
2. Você faz polling com `GET /analyses/{id}`, respeitando o `poll_after_seconds` da resposta, até o status chegar a `completed` ou `failed`.
3. No resultado, o `verdict` (`aprovado`, `alerta`, `reprovado` ou `incompleto`) resume a análise; `blocks` detalha cada verificação e `coverage` mostra o que foi consultado em cada fonte de dados.

```mermaid theme={null}
sequenceDiagram
    participant C as Seu sistema
    participant S as Motor de Analise /v1
    C->>S: POST /analyses (document + Idempotency-Key)
    S-->>C: 202 Accepted (id, status: pending)
    loop A cada poll_after_seconds (2s)
        C->>S: GET /analyses/{id}
        S-->>C: 200 (status: pending ou running)
    end
    C->>S: GET /analyses/{id}
    S-->>C: 200 (status: completed, verdict, blocks, coverage)
```

Todos os endpoints usam a base `https://221b-api.sherlocker.com.br/api/v1` e autenticação pelo header `Authorization: Bearer slhk_sua_chave_aqui`.

<Note>
  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=`.
</Note>

Análises que terminam em `failed` têm os tokens reembolsados automaticamente. A API é polling-only por enquanto: não há webhooks nem listagem de análises.

## E o Motor de Borderô?

Este é o motor de **documento individual**. Se o seu caso é analisar uma operação de desconto de duplicatas a partir de um arquivo CNAB 400 — cedente, sacados e títulos de uma vez —, use o **[Motor de Borderô](/credito/introducao)**: mesma base `/v1`, mesma chave `slhk_`, mesma feature. Os dois compõem: cada título do resultado do borderô referencia análises normais desta API, consultáveis via `GET /analyses/{id}`. A comparação completa está em [Motores de Análise](/motores/introducao).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/motor-analise/quickstart">
    Crie sua primeira análise em minutos
  </Card>

  <Card title="Autenticação" icon="key" href="/motor-analise/autenticacao">
    Chaves de API, header Bearer e rastreamento de requisições
  </Card>

  <Card title="Ciclo de vida" icon="rotate" href="/motores/ciclo-de-vida">
    Status, polling, verdict e o que cada campo do resultado significa
  </Card>
</CardGroup>