--- title: 4.2. Pessoa Física e Situação de Renda url: https://docs.vehub.com.br/Emiss%C3%A3o%20de%20Ativos/API/Cr%C3%A9dito/4.%20Tomador/4.2.%20Pessoa%20F%C3%ADsica%20e%20Situa%C3%A7%C3%A3o%20de%20Renda/ --- # 4.2. Pessoa Física e Situação de Renda !!! warning "Especificação — em construção" Os serviços descritos nesta área ainda não estão disponíveis. Esta página detalha o objeto `tomador` para **pessoa física**. Ele é usado em dois lugares, com o mesmo formato: | Onde | Endpoint | |---|---| | Criação da proposta | `POST /credito/esteiras/{idEsteira}/propostas` — ver [6.1](../6.%20Proposta/6.1.%20Criar%20Proposta.md) | | Complemento da ficha | `PUT /credito/propostas/{idProposta}/tomador` | --- ## 📤 Payload ```json { "tomador": { "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 } } } ``` --- ## 🧾 Detalhamento dos Campos ### Identificação | Campo | Tipo | Obrigatório | Descrição | |-------|------|-------------|-----------| | tipo | integer | Sim | `1` para pessoa física | | nome | string | Sim | Nome completo | | documento | string | Sim | CPF, **somente dígitos**. Validado | | data | string | Sim | Data de nascimento (`YYYY-MM-DD`) | | rg | string | Não | Número do RG | | telefone | string | Sim | Somente dígitos, com DDD | | email | string | Sim | E-mail válido | | paisNacionalidade | string | Não | Ver `GET /enumeracoes/nacionalidade` | | sexo | integer | Não | Ver `GET /enumeracoes/sexo` | | nomeMae | string | Sim | Nome completo da mãe | | pessoaPoliticamenteExposta | boolean | Sim | Declaração de PPE | | escolaridade | integer | Sim | Ver `GET /enumeracoes/escolaridade` | | cnh | integer | Sim | Categoria da CNH. Ver `GET /enumeracoes/cnh` | ### Estado civil e cônjuge | Campo | Tipo | Obrigatório | Descrição | |-------|------|-------------|-----------| | estadoCivil | integer | Sim | Ver `GET /enumeracoes/estado-civil` | | conjuge | object | **Condicional** | Obrigatório quando o estado civil indica união (casado, união estável) | | conjuge.nome | string | Sim, se `conjuge` | Nome completo do cônjuge | | conjuge.cpf | string | Sim, se `conjuge` | CPF do cônjuge, somente dígitos | > O cônjuge **não** entra como assinante da CCB no fluxo atual. ### Endereço | Campo | Tipo | Obrigatório | Descrição | |-------|------|-------------|-----------| | cep | string | Sim | Somente dígitos | | endereco | string | Sim | Logradouro | | numero | string | Sim | Número | | complemento | string | Não | Complemento | | bairro | string | Sim | Bairro | | cidade | string | Sim | Município | | uf | string | Sim | Sigla de 2 letras. Validada | | tipoEndereco | integer | Não | Ver `GET /enumeracoes/tipo-endereco` | --- ## Situação de renda O bloco `vinculoEmpregaticio` descreve como o tomador comprova renda. O campo `situacaoRenda` determina **quais campos do bloco são obrigatórios**: | `situacaoRenda` | Significado | `empresa` | `dataAdmissao` | `cargo` | `salario` | |---|---|---|---|---|---| | `1` | Com vínculo empregatício | **Obrigatório** | **Obrigatório** | **Obrigatório** | **Obrigatório** | | `2` | Sem vínculo empregatício | Opcional | Opcional | Opcional | Opcional | | `3` | Sem renda | Opcional | Opcional | Opcional | Opcional | ### 🧾 Campos do bloco | Campo | Tipo | Descrição | |-------|------|-----------| | situacaoRenda | integer | Ver tabela acima | | empresa.cnpj | string | CNPJ do empregador, somente dígitos. Validado | | empresa.razaoSocial | string | Razão social do empregador | | dataAdmissao | string | Data de admissão (`YYYY-MM-DD`) | | cargo | integer | Código CBO da ocupação. Ver `GET /enumeracoes/ocupacoes` | | salario | number | Renda mensal declarada | ### Exemplos por situação **Com vínculo empregatício** — bloco completo: ```json { "situacaoRenda": 1, "empresa": { "cnpj": "12345678000199", "razaoSocial": "Empresa X LTDA" }, "dataAdmissao": "2020-03-01", "cargo": 252105, "salario": 6500.00 } ``` **Sem vínculo empregatício** — autônomo que declara renda, sem empregador: ```json { "situacaoRenda": 2, "salario": 4200.00 } ``` **Sem renda**: ```json { "situacaoRenda": 3 } ``` !!! tip "A renda declarada não substitui o comprovante" Independente da situação, o **comprovante de renda** continua na lista de documentos exigidos para pessoa física. A situação de renda define o que você informa; o documento é o que comprova. Ver [6.6. Documentos](../6.%20Proposta/6.6.%20Documentos.md). --- ## ⚠️ Observações - **A conta bancária não faz parte deste objeto.** Ela é informada separadamente e pertence ao tomador, não à proposta — ver [4.4. Dados Bancários](4.4.%20Dados%20Bancários.md). - Em esteiras de **EP**, apenas pessoa física é aceita quando `tipoPessoaPermitida = 1`. Verifique em [3.2](../3.%20Referências/3.2.%20Parâmetros%20da%20Esteira.md) antes de criar a proposta. - Erros de validação vêm com o **nome do campo** em `errors[].campo`, inclusive para campos aninhados (ex.: `vinculoEmpregaticio.empresa.cnpj`).