6.12. Reabertura¶

Especificação — em construção

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

🔗 Endpoint¶

Método	URL
	`/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¶

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¶

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

❌ 409 Conflict — CCB já gerada¶

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

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

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, 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.