6.3. Desembolso ao Parceiro¶

Especificação — em construção

Os serviços descritos nesta área ainda não estão disponíveis.

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.

🔗 Endpoint¶

Método	URL
	`/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	esta (`409`)
`2` Parceiro	esta	dados bancários (`409`)

Em nenhuma configuração as duas se aplicam. Consulte destinatarioDesembolso no GET da proposta para saber qual chamar — ou simplesmente siga proximaEtapa.

📤 Requisição¶

{
  "idParceiroOriginador": 42
}

🧾 Detalhamento dos Campos¶

Campo	Tipo	Obrigatório	Descrição
idParceiroOriginador	integer	Sim	Identificador do parceiro, obtido em 3.3. Parceiros

🧪 Exemplo de cURL¶

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¶

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

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

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

{
  "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. Se o cadastro do parceiro for alterado entre as duas chamadas, o envio pode falhar mesmo tendo passado aqui.

Valide na seleção, não no envio

Chame 3.3. Parceiros 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.
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.