---
title: 4.1. Consultar por Documento
url: https://docs.vehub.com.br/Emiss%C3%A3o%20de%20Ativos/API/Cr%C3%A9dito/4.%20Tomador/4.1.%20Consultar%20por%20Documento/
---
# 4.1. Consultar por Documento

!!! warning "Especificação — em construção"
    Os serviços descritos nesta área ainda não estão disponíveis.

## 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-green) | `/credito/tomadores/{documento}` |

---

## 🧾 Descrição

Consulta um tomador já cadastrado pelo CPF ou CNPJ. Serve para **pré-preencher** a criação da
proposta e evitar pedir ao cliente dados que a plataforma já tem.

Responde **`204 No Content`** quando o documento não existe — o que é uma resposta normal, não um
erro: significa que o tomador é novo e você deve montar a ficha completa.

### 🔹 Path Parameter

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| documento | string | CPF ou CNPJ, **somente dígitos**, sem máscara |

---

## 🧪 Exemplo de cURL

```bash
curl -X GET "https://api.vehub.com.br/credito/tomadores/12345678900" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"
```

---

## 📥 Responses

### ✅ 200 OK — Pessoa física

```json
{
  "id": 7788,
  "tipo": 1,
  "nome": "João da Silva",
  "documento": "12345678900",
  "data": "1988-04-12",
  "rg": "123456789",
  "telefone": "47999998888",
  "email": "joao@exemplo.com",
  "paisNacionalidade": "Brasil",
  "sexo": 1,
  "nomeMae": "Maria da Silva",
  "pessoaPoliticamenteExposta": false,
  "estadoCivil": 2,
  "conjuge": { "nome": "Ana da Silva", "cpf": "98765432100" },
  "escolaridade": 5,
  "cnh": 2,
  "vinculoEmpregaticio": {
    "situacaoRenda": 1,
    "empresa": { "cnpj": "12345678000199", "razaoSocial": "Empresa X LTDA" },
    "dataAdmissao": "2020-03-01",
    "cargo": 252105,
    "salario": 6500.00
  },
  "endereco": {
    "cep": "89010000",
    "endereco": "Rua das Flores",
    "numero": "120",
    "complemento": "Apto 302",
    "bairro": "Centro",
    "cidade": "Blumenau",
    "uf": "SC",
    "tipoEndereco": 1
  }
}
```

### ✅ 200 OK — Pessoa jurídica

Os campos de PJ substituem os de PF, e `pessoas` traz os sócios e representantes legais:

```json
{
  "id": 9012,
  "tipo": 2,
  "nome": "Comércio Silva LTDA",
  "documento": "12345678000199",
  "data": "2012-05-20",
  "telefone": "4733334444",
  "email": "financeiro@silva.com.br",
  "nomeFantasia": "Silva Materiais",
  "quantidadeFilial": 2,
  "quantidadeFuncionario": 35,
  "inscricaoMunicipal": "123456",
  "inscricaoEstadual": "2547896321",
  "faturamento": [ { "data": "2026-07-01", "valor": 480000.00 } ],
  "cnae": [ { "codigo": "4744001", "principalAtividade": true } ],
  "pessoas": [
    {
      "tipo": 1,
      "nome": "José Silva",
      "documento": "11122233344",
      "socio": true,
      "socioPercentualParticipacao": 60.00,
      "representanteLegal": true,
      "socioDesde": "2012-05-20"
    }
  ],
  "endereco": { }
}
```

### 🧾 Detalhamento dos Campos comuns

| Campo | Tipo | Descrição |
|-------|------|-----------|
| id | integer | Identificador do tomador na plataforma |
| tipo | integer | `1` pessoa física, `2` pessoa jurídica |
| nome | string | Nome completo (PF) ou razão social (PJ) |
| documento | string | CPF ou CNPJ, sem máscara |
| data | string | Data de nascimento (PF) ou de fundação (PJ) |
| telefone | string | Somente dígitos, com DDD |
| email | string | E-mail de contato |
| endereco | object | Endereço completo — ver [4.2](4.2.%20Pessoa%20Física%20e%20Situação%20de%20Renda.md) |

Os campos específicos de cada tipo estão detalhados em
[4.2. Pessoa Física e Situação de Renda](4.2.%20Pessoa%20Física%20e%20Situação%20de%20Renda.md) e
[4.3. Pessoa Jurídica e Representantes](4.3.%20Pessoa%20Jurídica%20e%20Representantes.md).

### ⚪ 204 No Content

Tomador não cadastrado. Monte a ficha completa na criação da proposta.

---

## 🧭 Como usar no fluxo

```mermaid
flowchart LR
    A[Cliente informa CPF/CNPJ] --> B[GET /credito/tomadores/documento]
    B --> C{Resposta}
    C -- 200 --> D[Pré-preencher o formulário<br/>e confirmar com o cliente]
    C -- 204 --> E[Coletar a ficha completa]
    D --> F[POST propostas]
    E --> F
```

---

## ⚠️ Observações

- **Confirme os dados com o cliente antes de reaproveitar.** O cadastro pode estar desatualizado
  (endereço, telefone, renda), e o que você enviar na criação da proposta **sobrescreve** o que
  existia.
- Documentos já enviados por esse tomador e ainda dentro da validade são **reaproveitados** na
  proposta nova. Por isso uma proposta pode nascer com itens marcados como enviados — ver
  [6.6. Documentos](../6.%20Proposta/6.6.%20Documentos.md).
- A consulta é restrita ao **grupo econômico** da sua credencial.