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

# Buscar por Número CNJ

> Inicie a recuperação de autos processuais com base no número do processo e credenciais do advogado.

# 🔐 Buscar por Número CNJ

Este endpoint inicia a extração de autos processuais sigilosos, acessando diretamente os sistemas dos tribunais — como ESAJ, PJe, Eproc, Projudi — com as credenciais do advogado que possui acesso ao processo.

***

## 🔗 Endpoint

```
POST https://api.predictus.com.br/predictus-api/processos/judiciais/autos/buscarPorNumeroCNJ
```

***

## 📥 Corpo da requisição (exemplo)

```json theme={null}
{
  "numeroProcessoUnico": "50379103520218130702",
  "sistema": "EPROC-TRF2",
  "usuario": "08108732905",
  "senha": "senhaSegura",
  "tokenMFA": "GI2GGYZQGY3GMZRSG44TQOJTGUYWIZJV",
  "email": "redirecionamento@cliente.com"
}
```

***

## 📌 Campos obrigatórios

| Campo                 | Descrição                                                               |
| --------------------- | ----------------------------------------------------------------------- |
| `numeroProcessoUnico` | Número do processo no formato CNJ (sem traços ou pontos)                |
| `sistema`             | Código do sistema judicial. Veja a tabela abaixo                        |
| `usuario`             | Credencial de login (CPF, OAB ou e-mail, conforme exigência do sistema) |
| `senha`               | Senha de acesso ao sistema                                              |

***

## 🧩 Campos opcionais

| Campo      | Quando usar                                                                 |
| ---------- | --------------------------------------------------------------------------- |
| `tokenMFA` | Necessário somente quando o tribunal exige 2FA via aplicativo OTP (TOTP/QR) |
| `email`    | Necessário somente quando o 2FA do tribunal for enviado por e-mail          |

> ℹ️ Se o sistema exigir **2FA por e-mail**, o campo `email` **é obrigatório**. Esse e-mail deve estar com redirecionamento automático configurado para: [**predictus-docket@mailbox.org**](mailto:predictus-docket@mailbox.org).\
> Você pode criar uma **regra automática** (recomendado) ou reenviar manualmente o código recebido — mas atenção: o código expira em **menos de 1 minuto**, então é **fundamental** que a entrega seja rápida.

***

## ✅ Respostas possíveis

| Código | Significado                                  |
| ------ | -------------------------------------------- |
| `200`  | Solicitação iniciada com sucesso             |
| `400`  | Payload inválido                             |
| `401`  | Credenciais incorretas ou OTP inválido       |
| `429`  | Limite de tentativas excedido (aguarde)      |
| `500`  | Erro interno ou indisponibilidade do sistema |

***

## 📦 Após iniciar

Você receberá um `id` da solicitação. Use esse ID para acompanhar e consultar os autos:

➡️ [Buscar Resultado](./buscar-resultado)

> ⚠️ **Atenção**: Nos sistemas com 2FA via e-mail, o advogado deve configurar o redirecionamento automático para o endereço fornecido pela Predictus. O campo `email` na requisição ajuda a identificar e correlacionar corretamente o token recebido.