---
title: 3.1. Sócios, Representantes e Avalistas
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/3.%20Pessoas%20Vinculadas/3.1.%20S%C3%B3cios%2C%20Representantes%20e%20Avalistas/
---
Gerenciamento das pessoas vinculadas ao cedente: **sócios**, **representantes legais** e **avalistas**.

Uma mesma pessoa pode acumular múltiplos papéis (ex.: sócio e representante legal ao mesmo tempo).

---

## Adicionar Pessoa

| Método                                           | URL                                                 |
| ------------------------------------------------ | --------------------------------------------------- |
| ![POST](https://img.shields.io/badge/POST-green) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/pessoas` |

```json title="Request Body"
{
  "nome": "João da Silva",
  "cpfCnpj": "12345678901",
  "email": "joao.silva@email.com",
  "rg": "1234567",
  "estadoCivil": 2,
  "tipoPessoa": 1,
  "nacionalidade": "BRA",
  "profissao": "Empresário",
  "endereco": {
    "logradouro": "Rua das Flores",
    "numero": "100",
    "complemento": "Apto 301",
    "bairro": "Jardim Europa",
    "cep": "89020-000",
    "cidade": "Blumenau",
    "uf": "SC",
    "pais": "BRA"
  },
  "telefone": {
    "ddi": "+55",
    "ddd": "47",
    "numero": "999887766"
  },
  "papelSocio": true,
  "papelRepresentante": true,
  "papelAvalista": false,
  "participacao": 50.0,
  "tipoParteRelacionada": 2,
  "beneficiarioDireto": true,
  "ehRepresentante": true,
  "regimeBens": 1,
  "assinaIsoladamente": true,
  "emiteDuplicata": false,
  "assinaPorEndosso": true,
  "assinaTermoCessao": true
}
```

```json title="Response Body"
{
  "idPessoa": 45,
  "idEmpresa": 123,
  "nome": "João da Silva",
  "status": "Pessoa adicionada com sucesso."
}
```

---

## Atualizar Pessoa

| Método                                          | URL                                                            |
| ----------------------------------------------- | -------------------------------------------------------------- |
| ![PUT](https://img.shields.io/badge/PUT-orange) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/pessoas/{idPessoa}` |

O payload possui a mesma estrutura da [adição](#adicionar-pessoa). Somente os campos enviados serão atualizados.

```json title="Request Body"
{
  "participacao": 60.0,
  "papelAvalista": true
}
```

```json title="Response Body"
{
  "idPessoa": 45,
  "status": "Pessoa atualizada com sucesso."
}
```

---

## Remover Pessoa

| Método                                             | URL                                                            |
| -------------------------------------------------- | -------------------------------------------------------------- |
| ![DELETE](https://img.shields.io/badge/DELETE-red) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/pessoas/{idPessoa}` |

```json title="Response Body"
{
  "status": "Pessoa removida com sucesso."
}
```

---

# Modelo de Dados

## Requisição — Pessoa

| Campo                  | Tipo                                                                                                    | Obrigatório | Descrição                                                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------- | :---------: | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `nome`                 | Texto (200)                                                                                             |     ✅      | Nome completo da pessoa                                                                                                                          |
| `cpfCnpj`              | Texto (18)                                                                                              |     ✅      | CPF (PF) ou CNPJ (PJ avalista)                                                                                                                   |
| `email`                | Texto (200)                                                                                             |     ✅      | E-mail da pessoa                                                                                                                                 |
| `rg`                   | Texto (20)                                                                                              |  Opcional   | Número do RG                                                                                                                                     |
| `estadoCivil`          | Número                                                                                                  |  Opcional   | Estado civil. Ver [Estado Civil](../1.%20In%C3%ADcio/1.3.%20Dicion%C3%A1rio%20de%20Dados.md#estado-civil)                                        |
| `tipoPessoa`           | Número                                                                                                  |  Opcional   | Tipo de pessoa (1=PF, 2=PJ). Ver [Tipo de Pessoa](../1.%20In%C3%ADcio/1.3.%20Dicion%C3%A1rio%20de%20Dados.md#tipo-de-pessoa). Default: `1`       |
| `nacionalidade`        | Texto (3)                                                                                               |  Opcional   | Nacionalidade (ISO 3166-1 alpha-3). Default: `BRA`                                                                                               |
| `passaporte`           | Texto (20)                                                                                              |  Opcional   | Número do passaporte (para estrangeiros sem CPF)                                                                                                 |
| `profissao`            | Texto (100)                                                                                             |  Opcional   | Profissão                                                                                                                                        |
| `endereco`             | [Endereço](../2.%20Empresa%20Cedente/2.1.%20Criar%2C%20Consultar%20e%20Atualizar%20Cedente.md#endereco) |     ✅¹     | Endereço residencial                                                                                                                             |
| `telefone`             | [Telefone](../2.%20Empresa%20Cedente/2.1.%20Criar%2C%20Consultar%20e%20Atualizar%20Cedente.md#telefone) |  Opcional   | Telefone de contato                                                                                                                              |
| `papelSocio`           | Booleano                                                                                                |     ✅      | Se a pessoa é sócio/acionista                                                                                                                    |
| `papelRepresentante`   | Booleano                                                                                                |     ✅      | Se a pessoa é representante legal                                                                                                                |
| `papelAvalista`        | Booleano                                                                                                |     ✅      | Se a pessoa é avalista                                                                                                                           |
| `participacao`         | Decimal                                                                                                 |  Opcional²  | Percentual de participação societária (0 a 100)                                                                                                  |
| `tipoParteRelacionada` | Número                                                                                                  |  Opcional   | Tipo da parte relacionada. Ver [Tipo de Parte Relacionada](../1.%20In%C3%ADcio/1.3.%20Dicion%C3%A1rio%20de%20Dados.md#tipo-de-parte-relacionada) |
| `beneficiarioDireto`   | Booleano                                                                                                |  Opcional   | Se é beneficiário direto (`true`) ou indireto (`false`)                                                                                          |
| `ehRepresentante`      | Booleano                                                                                                |  Opcional   | Se é representante assinante                                                                                                                     |
| `regimeBens`           | Número                                                                                                  |  Opcional   | Regime de bens. Ver [Regime de Bens](../1.%20In%C3%ADcio/1.3.%20Dicion%C3%A1rio%20de%20Dados.md#regime-de-bens)                                  |
| `assinaIsoladamente`   | Booleano                                                                                                |  Opcional   | Se assina isoladamente (representante). Default: `false`                                                                                         |
| `emiteDuplicata`       | Booleano                                                                                                |  Opcional   | Se emite duplicata (representante). Default: `false`                                                                                             |
| `assinaPorEndosso`     | Booleano                                                                                                |  Opcional   | Se assina por endosso (representante). Default: `false`                                                                                          |
| `assinaTermoCessao`    | Booleano                                                                                                |  Opcional   | Se assina termo de cessão (representante). Default: `false`                                                                                      |

!!! note "Notas"
¹ _Obrigatório_ para avalistas.  
² _Obrigatório_ quando `papelSocio = true`.

---

## Pessoa Jurídica como Avalista

Quando o avalista é uma **Pessoa Jurídica** (`tipoPessoa = 2`), é possível vincular seus representantes como **pessoas filhas**. Para isso, adicione os representantes com o campo `idPessoaPai` referenciando o ID do avalista PJ:

```json title="Request Body — Representante de Avalista PJ"
{
  "nome": "Carlos Representante",
  "cpfCnpj": "98765432100",
  "email": "carlos@avalistapj.com.br",
  "tipoPessoa": 1,
  "nacionalidade": "BRA",
  "papelSocio": false,
  "papelRepresentante": true,
  "papelAvalista": false,
  "idPessoaPai": 45
}
```

Na consulta do cedente, os representantes de avalistas PJ são retornados no array `pessoasFilhas` dentro do objeto do avalista.

---

## Retorno

| Campo       | Tipo   | Descrição                      |
| ----------- | ------ | ------------------------------ |
| `idPessoa`  | Número | ID da pessoa criada/atualizada |
| `idEmpresa` | Número | ID da empresa cedente          |
| `nome`      | Texto  | Nome da pessoa                 |
| `status`    | Texto  | Mensagem de status da operação |