3.1. Criar Lote
Método | URL |
 | https://BASE_URL/recebiveis/lotes/liquidacao |
Request Body{
"idOperacao": 12345,
"idOcorrrencia": 2,
"cedente": {
"tipoPessoa": 2,
"cpfCnpj": "12345678000199"
},
"idDeposito": "123456"
}
Response Body{
"idLote": 987,
"idOcorrencia": 2,
"ocorrencia": "Repasse"
"idEmpresa": 4,
"empresa": "Empresa Exemplo LTDA",
"percentualDesagio": 2.5,
"valorNominalTotal": 44632.5,
"valorAquisicaoTotal": 39866.62,
"valorDescontoTotal": 4765.88,
"valorPagoTotal": 0,
"quantidadeTitulos": 5,
"quantidadeLiquidacoes": 0,
"dataCriacao": "2025-01-01T00:00:00",
"idStatus": 2,
"status": "Aguardando Envio",
"erros": []
}
Modelo de dados
Requisição
Campo | Tipo | Descrição |
idOperacao | Número | Id da Operação fornecido pela Vertrau |
idOcorrrencia | Número | Código da ocorrência do lote. Ver Ocorrências |
cedente | Cedente | Informações do cedente da operação. |
idDeposito | Texto (Opcional) | Identificador do pagamento realizado ao fundo. |
Cedente
Campo | Tipo | Descrição |
tipoPessoa | Número | 1 - Pessoa Física 2 - Pessoa Jurídica |
cpfCnpj | Texto | Documento do cedente (CPF ou CNPJ). |
Ocorrências
Id | Status | Descrição |
2 | Repasse | Gera um lote de REPASSE - Utilizado para informar as liquidações ao FIDC, e conciliar com os valores pagos em conta |
3 | Recompra | Gera um lote de RECOMPRA - Utilizado para comprar títulos do FIDC. É possível recomprar em dinheiro ou na troca de recebíveis |
4 | Resolução | Gera um lote de RESOLUÇÃO - Utilizado quando o pedido é cancelado por vício (cancelamento, extravio, roubo, etc). O pagamento da Resolução deverá ser realizado no fundo por parte do Cedente. |
Retorno
Campo | Tipo | Descrição |
idLote | Número | Id do lote gerado |
idOcorrencia | Número | Código da ocorrência do lote. Ver Ocorrências |
ocorrencia | Texto | Descrição literal da da ocorrência |
idEmpresa | Número | Id da empresa emissora dos títulos |
empresa | Texto | Nome da empresa emissora dos títulos |
percentualDesagio | Decimal | Percentual de deságio aplicado sobre o valor nominal (taxa ao mês) |
valorNominalTotal | Decimal | Valor total nominal dos títulos no lote |
valorAquisicaoTotal | Decimal | Valor total de aquisição dos títulos |
valorDescontoTotal | Decimal | Valor total de desconto aplicado no lote |
valorPagoTotal | Decimal | Valor total pago no lote (Somente para lotes de Liquidação) |
quantidadeTitulos | Número | Quantidade de títulos inseridos no lote |
quantidadeLiquidacoes | Número | Quantidade de liquidações realizadas |
dataCriacao | Data/Hora | Data e hora de criação do lote |
idStatus | Número | Código de status do lote. Ver Status |
status | Texto | Descrição do status atual do lote |
erros | Lista | Lista de erros associados ao lote (se houver) |
Status
Id | Status | Descrição |
1 | Em Digitação | Lote está em fase de preparação, ainda não foi enviado ao fundo. |
2 | Aguardando Envio | Lote finalizado e na fila para envio ao fundo. |
3 | Enviado ao Fundo | Lote foi enviado ao fundo e aguarda processamento. |
4 | Aprovação do Gestor | Lote está aguardando análise e aprovação por parte do gestor do fundo. |
5 | Aguardando Assinaturas | Lote aprovado e aguardando assinatura dos documentos da cessão. |
6 | Efetivação da Baixa | Em processo de efetivar a baixa dos recebíveis no sistema. (Somente lote de Liquidação) |
7 | Pagamento da Cessão | Em processo de pagamento do valor referente à cessão dos recebíveis ao Cedente. (Somente lote de Cessão) |
8 | Finalizado | Lote totalmente concluído, com todas as etapas finalizadas e valor creditado na conta do Cedente. |
9 | Cancelado | Lote foi cancelado pelo usuário e não seguirá para as próximas etapas. |
10 | Rejeitado | Lote foi rejeitado em alguma etapa do processo e não será processado. |