---
title: 8.1. Cadastrar Cedente Simplificado
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/8.%20Antecipa%C3%A7%C3%A3o%20autom%C3%A1tica%20de%20cart%C3%A3o/8.1.%20Cadastrar%20Cedente%20Simplificado/
---
Cadastro enxuto de um estabelecimento comercial já vinculado a uma operação de cartões, para uso no fluxo de **antecipação automática**.

Este endpoint é um atalho: faz, numa só chamada, o que hoje exige [criar o cedente](../2.%20Empresa%20Cedente/2.1.%20Criar%2C%20Consultar%20e%20Atualizar%20Cedente.md) e depois [vinculá-lo à operação](../7.%20V%C3%ADnculo%20com%20Opera%C3%A7%C3%B5es/7.1.%20Vincular%20Cedente%20a%20Opera%C3%A7%C3%B5es.md). Ele existe porque, para antecipar recebíveis de cartão, o conjunto de dados necessário é bem menor do que o de uma cessão de duplicatas: basta identificar o estabelecimento e a operação em que ele vai operar.

!!! info "Use o cadastro completo quando precisar de mais do que cartões"
    Sócios, representantes, avalistas, documentos, contas correntes e contatos **não** são tratados aqui. Se o cedente também vai ceder duplicatas, ou se o fundo exige ficha cadastral completa, use os endpoints das seções 2 a 5 — este atalho não os substitui.

!!! tip "É idempotente"
    Se o documento já estiver cadastrado no grupo econômico, nenhum cedente novo é criado: o existente é devolvido e apenas o vínculo com a operação é garantido. A resposta indica isso em `jaExistia`. Reexecutar a mesma chamada é seguro.

---

## Cadastrar Cedente Simplificado

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

Cria o cedente com o mínimo necessário e o vincula à operação informada.

### Request Body

| Campo                   | Tipo   | Obrigatório | Descrição                                                                                     |
| ----------------------- | ------ | ----------- | --------------------------------------------------------------------------------------------- |
| `documento`             | Texto  | Sim         | CNPJ ou CPF do estabelecimento, somente números, sem formatação.                              |
| `razaoSocial`           | Texto  | Sim         | Razão social do estabelecimento. Máximo de 200 caracteres.                                    |
| `idOperacao`            | Número | Sim         | Identificador da operação de cartões à qual o cedente será vinculado.                         |
| `nome`                  | Texto  | Não         | Nome fantasia. Quando omitido, assume o valor de `razaoSocial`.                               |
| `email`                 | Texto  | Não         | E-mail corporativo do estabelecimento.                                                         |
| `responsavelOptIn`      | Objeto | Não         | Dados do responsável pelo OPT-IN. Ver **Responsável pelo OPT-IN**.                             |

#### Responsável pelo OPT-IN

| Campo   | Tipo  | Obrigatório | Descrição                              |
| ------- | ----- | ----------- | -------------------------------------- |
| `nome`  | Texto | Não         | Nome do responsável pela autorização.  |
| `email` | Texto | Não         | E-mail do responsável pela autorização. |

!!! info "Por que o responsável pelo OPT-IN é opcional nesta API"
    Nas telas da plataforma esses dados existem para que VeHub envie o e-mail de autorização ao estabelecimento. Pela API pública, **quem obtém e responde pela autorização é o integrador** — não há e-mail a disparar, e por isso os campos deixam de ser exigidos. Informá-los apenas enriquece o cadastro e facilita o atendimento posterior.

```json title="Request Body — mínimo"
{
  "documento": "12345678000199",
  "razaoSocial": "LOJA EXEMPLO COMERCIO LTDA",
  "idOperacao": 1
}
```

```json title="Request Body — completo"
{
  "documento": "12345678000199",
  "razaoSocial": "LOJA EXEMPLO COMERCIO LTDA",
  "idOperacao": 1,
  "nome": "LOJA EXEMPLO",
  "email": "financeiro@exemplo.com.br",
  "responsavelOptIn": {
    "nome": "Maria Souza",
    "email": "maria@exemplo.com.br"
  }
}
```

```json title="Response Body — 201 Created"
{
  "idEmpresa": 4821,
  "documento": "12345678000199",
  "nome": "LOJA EXEMPLO",
  "idOperacao": 1,
  "idVinculo": 9133,
  "jaExistia": false
}
```

### Detalhamento da resposta

| Campo        | Tipo     | Descrição                                                                                         |
| ------------ | -------- | ------------------------------------------------------------------------------------------------- |
| `idEmpresa`  | Número   | Identificador do cedente. Use-o nos demais endpoints desta seção.                                 |
| `documento`  | Texto    | Documento normalizado, somente números.                                                            |
| `nome`       | Texto    | Nome fantasia gravado.                                                                             |
| `idOperacao` | Número   | Operação à qual o cedente foi vinculado.                                                          |
| `idVinculo`  | Número   | Identificador do vínculo cedente × operação.                                                      |
| `jaExistia`  | Booleano | `true` quando o cedente já estava cadastrado e a chamada apenas garantiu o vínculo.               |

### Erros

| Status | Quando acontece                                                              |
| ------ | ---------------------------------------------------------------------------- |
| `400`  | Payload inválido — documento malformado, razão social ausente, etc.          |
| `401`  | Token ausente, expirado ou sem permissão de acesso à API pública.            |
| `404`  | Operação não encontrada no grupo econômico.                                  |
| `422`  | Operação não é de cartões, ou está inativa.                                  |

---

## Próximo passo

Com o cedente criado e vinculado, habilite o ciclo automático em [8.2. Habilitar Antecipação Automática](8.2.%20Habilitar%20Antecipa%C3%A7%C3%A3o%20Autom%C3%A1tica.md).