| Método | URL |
|---|---|
https://BASE_URL/public/v1/recebiveis/lotes/{idOperacao}/titulos/avulsos |
Exclui um ou mais títulos da operação informada. Somente títulos em carteira do cedente (ainda não cedidos ao fundo) e disponíveis para movimentação (não vinculados a um lote em andamento) são elegíveis para exclusão. A exclusão é lógica: os títulos deixam de aparecer nas consultas, mas permanecem registrados para fins de auditoria.
Path Params¶
| Campo | Tipo | Descrição |
|---|---|---|
idOperacao | Número | Identificador da operação fornecido pela Vertrau. |
Request Body
{
"idTitulos": [101, 102, 103]
}
Response Body — 200 OK
{
"status": "sucesso",
"mensagem": "3 título(s) excluído(s) com sucesso.",
"titulos": null
}
Response Body — 400 Bad Request
{
"status": "erro",
"mensagem": "Não foram encontrados titulos elegiveis para exclusão.",
"titulos": null
}
Modelo de dados¶
Requisição¶
| Campo | Tipo | Descrição |
|---|---|---|
idTitulos | Lista de números | Identificadores dos títulos a serem excluídos. Os identificadores são retornados na importação (ver Importar Títulos Avulsos) e nas consultas de títulos. |
Retorno¶
| Campo | Tipo | Descrição |
|---|---|---|
status | Texto | sucesso ou erro. |
mensagem | Texto | Mensagem com a quantidade de títulos excluídos ou o motivo do erro. |
titulos | Lista | Sempre null neste endpoint. |
Observações¶
- Títulos que não pertencem à operação informada, já cedidos ao fundo ou vinculados a um lote em andamento são ignorados silenciosamente — a mensagem de sucesso informa a quantidade efetivamente excluída.
- Se nenhum dos títulos informados for elegível, a API retorna
400 Bad Request. - Para remover títulos que já estão vinculados a um lote em digitação, utilize a remoção de títulos do lote (ver Remover Títulos na seção de Cessão de Direitos Creditórios) antes de excluí-los.