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

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

## 🔗 Endpoint

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

---

## 🧾 Descrição

Devolve uma proposta em **estado de falha** para *Em digitação*, limpando os erros, para que você
possa corrigir os dados e tentar de novo.

Sem esta operação, uma falha de cálculo ou de registro deixaria a proposta travada: nesses estados ela
não aceita nova simulação nem novo envio.

Sem corpo.

---

## Quando usar

| Status atual | Situação |
|---|---|
| `10` Falha na simulação | O cálculo foi recusado pela bancarizadora |
| `9` Falha na inclusão da proposta | O registro da operação foi recusado |

Depois da reabertura, a proposta volta para `1` — **Em digitação** — e aceita nova simulação, ajuste
de tomador, de desembolso, de avalistas, de garantias e de documentos.

---

## 🔒 Só antes da CCB

A reabertura é permitida **enquanto não houver CCB gerada**. Uma vez emitida a cédula, a operação
existe na bancarizadora e o tratamento deixa de ser de digitação: passa a ser operacional, conduzido
pelo time de operações na plataforma.

| Condição | Reabertura |
|---|---|
| `numeroCcb` e `dataGeracaoProposta` nulos | ✅ permitida |
| Qualquer um dos dois preenchido | ❌ `409` |

---

## 🧪 Exemplo de cURL

```bash
curl -X POST "https://api.vehub.com.br/credito/propostas/1001/reabertura" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"
```

---

## 📥 Responses

### ✅ 200 OK

```json
{
  "sucesso": true,
  "mensagem": "Proposta reaberta com sucesso.",
  "dados": {
    "status": { "id": 1, "nome": "Em digitação" },
    "proximaEtapa": "simulacao"
  }
}
```

### ❌ 409 Conflict — CCB já gerada

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10",
  "status": 409,
  "errors": [
    { "campo": null, "mensagem": "A proposta já possui CCB gerada e não pode ser reaberta." }
  ]
}
```

### ❌ 409 Conflict — status não permite

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10",
  "status": 409,
  "errors": [
    { "campo": null, "mensagem": "A reabertura só se aplica a propostas em falha. Situação atual: Em digitação." }
  ]
}
```

---

## 🧭 Fluxo de recuperação

```mermaid
flowchart TD
    A[POST /simulacao] --> B{Resultado}
    B -- ok --> C[Seguir a jornada]
    B -- falha --> D[Status 10<br/>temErro true]
    D --> E[Ler a mensagem em erros]
    E --> F[POST /reabertura]
    F --> G[Status 1<br/>Em digitação]
    G --> H[Corrigir os dados]
    H --> A
```

O mesmo desenho vale para a falha no envio (`9`), trocando o `POST /simulacao` pelo `POST /envio`.

---

## ⚠️ Observações

- **Leia `erros` antes de reabrir.** A mensagem vem da bancarizadora e diz o que precisa ser
  corrigido — prazo fora da política, valor acima do limite, dado cadastral recusado. Reabrir e
  repetir a mesma requisição vai falhar de novo.
- A reabertura **não desfaz** o que já foi informado: tomador, documentos, avalistas e garantias
  permanecem. Apenas o estado de falha é limpo.
- Cada reabertura fica registrada no [histórico](6.11.%20Histórico.md), com
  `origem: api` e a observação correspondente.
- Não há limite de reaberturas, mas propostas que falham repetidamente indicam um problema de
  configuração ou de dados que vale investigar em vez de repetir.