---
title: 6.3. Desembolso ao Parceiro
url: https://docs.vehub.com.br/Emiss%C3%A3o%20de%20Ativos/API/Cr%C3%A9dito/6.%20Proposta/6.3.%20Desembolso%20ao%20Parceiro/
---
# 6.3. Desembolso ao Parceiro

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

!!! info "Somente CDC, e somente quando configurado"
    Esta etapa existe apenas em esteiras de **CDC** com `destinatarioDesembolso = 2` (Parceiro).
    Verifique em [3.2. Parâmetros da Esteira](../3.%20Referências/3.2.%20Parâmetros%20da%20Esteira.md).

## 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![PUT](https://img.shields.io/badge/PUT-orange) | `/credito/propostas/{idProposta}/desembolso` |

---

## 🧾 Descrição

Registra **qual parceiro originador** está envolvido na operação. É para a conta bancária dele que o
valor será liberado, em vez da conta do tomador.

### 🔀 Esta etapa substitui os dados bancários

As duas etapas são **mutuamente exclusivas**:

| `destinatarioDesembolso` | Etapa que se aplica | Etapa recusada |
|---|---|---|
| `1` Emitente, ou `null` | [4.4. Dados Bancários](../4.%20Tomador/4.4.%20Dados%20Bancários.md) | esta (`409`) |
| `2` Parceiro | **esta** | dados bancários (`409`) |

Em nenhuma configuração as duas se aplicam. Consulte `destinatarioDesembolso` no
[`GET` da proposta](6.10.%20Consultar,%20Listar%20e%20Pendências.md) para saber qual chamar — ou
simplesmente siga `proximaEtapa`.

---

## 📤 Requisição

```json
{
  "idParceiroOriginador": 42
}
```

### 🧾 Detalhamento dos Campos

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| idParceiroOriginador | integer | Sim | Identificador do parceiro, obtido em [3.3. Parceiros](../3.%20Referências/3.3.%20Parceiros.md) |

---

## 🧪 Exemplo de cURL

```bash
curl -X PUT "https://api.vehub.com.br/credito/propostas/2050/desembolso" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json" \
  -d '{ "idParceiroOriginador": 42 }'
```

---

## 📥 Responses

### ✅ 200 OK

```json
{
  "sucesso": true,
  "mensagem": "Parceiro do desembolso definido com sucesso.",
  "dados": {
    "idParceiroOriginador": 42,
    "nome": "Loja Centro LTDA",
    "documento": "12345678000199",
    "conta": {
      "idBanco": 1,
      "agencia": "12345",
      "conta": "9876543",
      "tipo": 2,
      "completa": true
    }
  }
}
```

A conta é devolvida na resposta para que você possa **exibir ao operador** a conta de destino antes de
seguir.

### ❌ 409 Conflict — esteira não configurada para parceiro

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10",
  "status": 409,
  "errors": [
    { "campo": null, "mensagem": "A etapa de desembolso não está habilitada para este tipo de contrato." }
  ]
}
```

### ❌ 409 Conflict — proposta já enviada

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10",
  "status": 409,
  "errors": [
    { "campo": null, "mensagem": "A proposta já foi enviada; o parceiro do desembolso não pode ser alterado." }
  ]
}
```

### ❌ 422 Unprocessable Entity — parceiro inválido ou sem conta

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.21",
  "status": 422,
  "errors": [
    { "campo": "idParceiroOriginador", "mensagem": "O parceiro não possui conta bancária completa. Complete o cadastro em Cadastros > Parceiros." }
  ]
}
```

---

## ✅ Critérios de aceitação do parceiro

A plataforma valida três coisas, e recusa se qualquer uma falhar:

| Critério | Erro |
|---|---|
| O parceiro existe e é do tipo parceiro | `422` — parceiro inválido |
| Está **ativo** | `422` — parceiro inativo |
| Tem conta bancária **completa** (banco, agência, conta e tipo) | `422` — conta incompleta |

Essa validação é feita **duas vezes**: aqui, e novamente no
[envio da proposta](6.8.%20Envio%20da%20Proposta.md). Se o cadastro do parceiro for alterado entre as
duas chamadas, o envio pode falhar mesmo tendo passado aqui.

!!! tip "Valide na seleção, não no envio"
    Chame [3.3. Parceiros](../3.%20Referências/3.3.%20Parceiros.md) e verifique `conta.completa` no
    momento em que o operador escolhe o parceiro. Descobrir conta incompleta no fim da jornada custa o
    retrabalho da ficha inteira.

---

## 🔒 Imutabilidade após o envio

O parceiro pode ser trocado **enquanto a proposta não foi enviada** à bancarizadora. Depois que a
proposta é registrada, o campo fica somente leitura — o desembolso já foi direcionado.

---

## ⚠️ Observações

- **O parceiro originador não assina a CCB.** Quem assina é o tomador, ou os representantes legais
  se pessoa jurídica. Ver [6.9. Assinantes e CCB](6.9.%20Assinantes%20e%20CCB.md).
- **O cadastro bancário do parceiro não é editável por esta API.** Ele é mantido na plataforma, em
  **Cadastros › Parceiros**.
- Comissionamento do parceiro **não** faz parte deste fluxo e não é calculado a partir dele.