---
title: 4.3. Detalhes 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.3.%20Detalhes%20da%20Simula%C3%A7%C3%A3o/
---
# 4.3. Detalhes da Simulação

## 🔗 Endpoint

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

---

## 🧾 Descrição

Recupera os detalhes completos de uma simulação previamente criada, incluindo os filtros utilizados, os títulos disponíveis, os títulos selecionados e os totais financeiros da operação simulada.

---

## 📥 Response

### ✅ 200 OK
```json
{
  "identificador": "534D8AAE-61E4-4264-9D15-715B9E1F1D51",
  "simulacao": {
    "cnpj": "",
    "tags": [""],
    "arranjos": [""],
    "credenciadoras": [""],
    "dataInicial": "0000-00-00",
    "dataFinal": "0000-00-00",
    "taxa": 0.00,
    "valorDesejado": {
      "valor": 0.00,
      "ordem": "ASC"
    },
    "statusAgenda": 1,
    "motivoFalha": ""
  },
  "totais": {
    "nominal": 0.00,
    "desconto": 0.00,
    "aquisicao": 0.00,
    "garantido": 0.00,
    "CET": 0.00
  },
  "titulos": [
    {
      "id": "7D121577-3C5A-494D-B052-291D9E100D0D",
      "credenciadora": {
        "cnpj": "",
        "nome": ""
      },
      "arranjo": {
        "sigla": "",
        "nome": ""
      },
      "dataPrevistaLiquidacao": "",
      "valorNominal": 0.00,
      "valorGarantido": 0.00,
      "valorDesconto": 0.00,
      "valorAquisicao": 0.00,
      "selecionado": false
    }
  ]
}
```

---

## 🧾 Detalhamento dos Campos

### 🔹 simulacao
| Campo          | Tipo        | Descrição                                                |
|----------------|-------------|----------------------------------------------------------|
| cnpj           | string      | CNPJ do estabelecimento comercial                        |
| tags           | string[]    | Lista de tags atribuídas na simulação para identificação |
| arranjos       | string[]    | Lista de arranjos utilizados na simulação                |
| credenciadoras | string[]    | Lista de CNPJs das credenciadoras utilizadas             |
| dataInicial    | string      | Data inicial da consulta                                 |
| dataFinal      | string      | Data final da consulta                                   |
| taxa           | number      | Taxa (deságio) aplicada                                  |
| valorDesejado  | objeto      | Informações sobre o valor solicitado                     |
| → valor        | number      | Valor desejado para a operação                           |
| → ordem        | string      | Ordem de priorização das URs (ASC ou DESC)               |
| statusAgenda   | integer     | Status da agenda da simulação                            |
| motivoFalha    | string-null | Motivo da falha da agenda                                |

### 🔹 totais (baseados nas URs selecionadas)
| Campo     | Tipo   | Descrição                                                                 |
|-----------|--------|---------------------------------------------------------------------------|
| nominal   | number | Soma dos valores nominais das URs selecionadas                            |
| desconto  | number | Soma dos valores de desconto aplicados (baseados na taxa)                 |
| aquisicao | number | Valor total a ser recebido após o deságio (nominal - desconto)            |
| garantido | number | Valor total a ser utilizado das URs (podendo pegar valor parcial das URs) |
| CET       | number | Custo Efetivo Total da simulação                                          |

### 🔹 titulos
| Campo                  | Tipo     | Descrição                                                           |
|------------------------|----------|---------------------------------------------------------------------|
| id                     | string   | GUID da UR                                                          |
| credenciadora.cnpj     | string   | CNPJ da credenciadora                                               |
| credenciadora.nome     | string   | Nome da credenciadora                                               |
| arranjo.sigla          | string   | Sigla do arranjo (ex: MCC, VCC)                                     |
| arranjo.nome           | string   | Nome do arranjo (ex: Mastercard Cartão Crédito)                     |
| dataPrevistaLiquidacao | string   | Data de recebimento da UR                                           |
| valorNominal           | number   | Valor original da UR                                                |
| valorGarantido         | number   | Valor utilizado da UR (podendo pegar valor parcial da UR)           |
| valorDesconto          | number   | Valor de deságio aplicado conforme taxa                             |
| valorAquisicao         | number   | Valor líquido após deságio                                          |
| selecionado            | boolean  | Indica se a UR foi usada na simulação (por valor ou seleção manual) |


### 🔢 Status das agendas

| Código | Significado                            |
|--------|----------------------------------------|
| 1      | Agenda disponível                      |
| 2      | Agenda vazia                           |
| 3      | Agenda com promessa de cessão          |
| 4      | Agenda ultrapassou tempo de publicação |
| 5      | Agenda com falha                       |
---

## 🧪 Exemplo de cURL

```bash
curl -X GET https://api.veflow.com/public/api/v1/cartao/simulacao/534D8AAE-61E4-4264-9D15-715B9E1F1D51 \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json"
```

---

## 🕒 Observações

- Os totais da simulação refletem **apenas as URs selecionadas** (manualmente ou por valor desejado).
- URs não selecionadas continuam disponíveis para uso em outras simulações.