5.4. Remover URs do Contrato¶

🔗 Endpoint¶

Método	URL
	/api/v1/cartao/contrato/{identificador}/titulos

🧾 Descrição¶

Solicita a remoção de uma ou mais URs (Unidades de Recebíveis) vinculadas a um contrato de cartão. A operação respeita regras de elegibilidade e é processada de forma assíncrona.

⚠ Regras de Remoção¶

• Cada UR só poderá ser removida se não estiver liquidada.
• A data de liquidação da UR deve ser ao menos D+3 dias úteis em relação à data atual.
• A requisição será processada somente dentro do horário operacional: 09h às 18h em dias úteis.
• A operação será executada de forma assíncrona; o resultado será informado via notificação.

📤 Requisição¶

📋 Payload (JSON)¶

{
  "idTitulos": [
    "29E8F0CE-3391-4A65-8091-2331802CEABE"
  ]
}

🧪 Exemplo de cURL¶

curl -X DELETE https://api.veflow.com/api/v1/cartao/contrato/5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6/titulos \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "idTitulos": ["29E8F0CE-3391-4A65-8091-2331802CEABE"]
  }'

📥 Responses¶

✅ 200 OK¶

{
  "identificador": "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6",
  "mensagem": "Solicitação de remoção de URs enviada com sucesso!"
}

❌ Possíveis Erros¶

🔸 400 Bad Request¶

{
  "status": 400,
  "erros": [
    "A UR já está liquidada e não pode ser removida."
  ]
}

{
  "status": 400,
  "erros": [
    "A data de liquidação da UR deve ser ao menos D+3 dias úteis."
  ]
}

{
  "status": 400,
  "erros": [
    "Contrato não encontrado ou não permite remoção."
  ]
}

🔸 403 Fora da Janela de Operação¶

{
  "mensagem": "Operação permitida apenas entre 09h e 18h em dias úteis."
}

🕒 Observações¶

• A resposta 200 OK indica apenas que a solicitação passou pelas validações iniciais.
• A efetivação da remoção será notificada posteriormente (via callback, webhook ou fila).