4.2. Pessoa Física e Situação de Renda¶

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
Complemento da ficha	`PUT /credito/propostas/{idProposta}/tomador`

📤 Payload¶

{
  "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:

{
  "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:

{
  "situacaoRenda": 2,
  "salario": 4200.00
}

Sem renda:

{
  "situacaoRenda": 3
}

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.

⚠️ 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.
Em esteiras de EP, apenas pessoa física é aceita quando tipoPessoaPermitida = 1. Verifique em 3.2 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).