---
title: 4.2. Vincular URs ou Valor da Simulação
url: https://docs.vehub.com.br/API/VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/4.%20Agenda%20de%20receb%C3%ADveis/v1/4.2.%20Vincular%20URs%20ou%20Valor%20na%20simula%C3%A7%C3%A3o/
---
# 4.2. Vincular URs ou Valor da Simulação

## 🔗 Endpoint

| Método                                          | URL |
|-------------------------------------------------|-----|
| ![POST](https://img.shields.io/badge/POST-blue) | `/public/api/v1/cartao/simulacao/{identificador}/vinculo` |

---

## 🧾 Descrição

Permite ao usuário especificar a simulação por valor desejado ou selecionar manualmente as URs a serem vinculadas à simulação de antecipação.

Com base no `tipoVinculo`, a plataforma vinculará as URs automaticamente até atingir o valor informado ou usará os identificadores de títulos fornecidos.

---

## 📤 Requisição

### 📋 Payload (JSON)

#### ✅ Vincular por valor
```json
{
  "tipoVinculo": 1,
  "valor": 30000.00,
  "ordem": "ASC"
}
```

#### ✅ Vincular por URs
```json
{
  "tipoVinculo": 2,
  "idTitulos": ["29E8F0CE-3391-4A65-8091-2331802CEABE"]
}
```

### 🧾 Detalhamento dos Campos

| Campo       | Tipo     | Obrigatório | Descrição |
|-------------|----------|-------------|-----------|
| tipoVinculo | integer  | Sim         | Define a forma de vinculação: `1` para valor, `2` para UR específica |
| valor       | number   | Condicional | Valor total a ser simulado (obrigatório se `tipoVinculo` = 1) |
| ordem       | string   | Opcional    | Ordem de seleção das URs: `ASC` (padrão) ou `DESC` (usado com `tipoVinculo` = 1) |
| idTitulos   | string[] | Condicional | Lista de GUIDs das URs a serem vinculadas (obrigatório se `tipoVinculo` = 2) |

---

## 🧪 Exemplo de cURL

### ▶ Vincular por valor
```bash
curl -X POST https://api.veflow.com/public/api/v1/cartao/simulacao/534D8AAE-61E4-4264-9D15-715B9E1F1D51/vinculo \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "tipoVinculo": 1,
    "valor": 30000.00,
    "ordem": "ASC"
  }'
```

### ▶ Vincular por UR
```bash
curl -X POST https://api.veflow.com/public/api/v1/cartao/simulacao/534D8AAE-61E4-4264-9D15-715B9E1F1D51/vinculo \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "tipoVinculo": 2,
    "idTitulos": ["29E8F0CE-3391-4A65-8091-2331802CEABE"]
  }'
```

---

## 📥 Responses

### ✅ 200 OK
```json
{
  "identificador": "534D8AAE-61E4-4264-9D15-715B9E1F1D51",
  "mensagem": "URs vinculadas na simulação!"
}
```
Indica que as URs foram vinculadas com sucesso à simulação.

---

### ❌ 400 Bad Request (exemplo)
```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Campo 'valor' é obrigatório quando tipoVinculo = 1.",
    "Campo 'idTitulos' é obrigatório quando tipoVinculo = 2."
  ]
}
```

---

## 🕒 Observações

- URs não utilizadas na simulação continuam disponíveis para outras simulações ou vínculos.