--- title: 5.4. Remover URs do Contrato url: https://docs.vehub.com.br/API/VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/5.%20Contrato%20de%20receb%C3%ADveis/v1/5.4.%20Remover%20UR%20do%20contrato/ --- # 5.4. Remover URs do Contrato ## 🔗 Endpoint | Método | URL | |--------------------------------------------------|-----| | ![DELETE](https://img.shields.io/badge/DELETE-red) | `/public/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) ```json { "idTitulos": [ "29E8F0CE-3391-4A65-8091-2331802CEABE" ] } ``` | Campo | Tipo | Obrigatório | Descrição | |-------------|------------|-------------|-----------| | idTitulos | string[] | Sim | Lista de GUIDs das URs a serem removidas do contrato | --- ## 🧪 Exemplo de cURL ```bash curl -X DELETE https://api.veflow.com/public/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 ```json { "identificador": "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6", "mensagem": "Solicitação de remoção de URs enviada com sucesso!" } ``` --- ### ❌ Possíveis Erros #### 🔸 400 Bad Request ```json { "status": 400, "erros": [ "A UR já está liquidada e não pode ser removida." ] } ``` ```json { "status": 400, "erros": [ "A data de liquidação da UR deve ser ao menos D+3 dias úteis." ] } ``` ```json { "status": 400, "erros": [ "Contrato não encontrado ou não permite remoção." ] } ``` #### 🔸 403 Fora da Janela de Operação ```json { "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).