Ir para o conteúdo
Método URL
DELETE 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.