Antes de começar
- Use uma identidade do Lender autorizada para as operações de cessão. O serviço deriva o tenant dessa identidade validada. Você não informa um tenant em uma requisição.
- Registre o fundo recebedor antes de criar um conjunto. O registro guarda os dados do administrador dele, a taxa de cessão, os limites de elegibilidade, o modo de documento e o layout usado no arquivo de oferta dele.
- Trate cada fato externo como evidência. Enviar um arquivo, receber uma remessa, assinar um termo, pagar, transferir e aceitar são fatos separados, com controles separados.
O fluxo da cessão
1
Registre o fundo
Crie ou atualize o registro do fundo de cessão. A configuração dele fornece a taxa de cessão e as regras de concentração e de corte repetido usadas quando o Lender avalia um pool. As configurações de documento e de registro do fundo recebedor também determinam os caminhos posteriores de documento e de aceite.
2
Revise os recebíveis elegíveis
Leia o pool de candidatos delimitado pelo fundo. O Lender avalia cada candidato contra a configuração do fundo e o contexto da cessão, devolvendo um veredito de elegibilidade em vez de descartar recebíveis inelegíveis em silêncio. Quando ele não consegue ler uma fonte obrigatória, ele informa essa condição em vez de tratar a restrição como satisfeita.
3
Monte e pontue um conjunto rascunho
Crie um rascunho a partir dos recebíveis que você selecionou. O Lender congela a composição do conjunto e as configurações de fundo de que ele precisa para aquela jornada. Pontue o rascunho contra a regra do fundo antes da aprovação. Um conjunto não aprovado pode ser pontuado de novo.
4
Aprove o conjunto
A aprovação relê o estado relevante dos recebíveis antes de registrar a decisão. Um recebível que mudou desde a montagem pode sair do conjunto, ou o Lender pode reprecificá-lo. Revise o resultado da aprovação, e não suponha que o rascunho sobrevive sem mudanças.
5
Cancele um conjunto que não pode seguir
POST /api/v1/assignment/sets/{setId}/discard cancela uma composição não vendida e libera os recebíveis dela de volta para o pool cedível. Ele preserva o conjunto, a evidência dele e a trilha de auditoria dele. Ele não desfaz uma venda. O Lender recusa a chamada quando o conjunto está aceito, parcialmente vendido ou pago, ou tem uma transferência protocolada no registro.6
Troque os arquivos do fundo
Baixe o arquivo de oferta apenas depois da aprovação, e então registre que você o enviou. Ingira a remessa do administrador do fundo contra esse mesmo conjunto. O Lender concilia o arquivo com a composição ofertada e registra o resultado.
7
Registre os fatos de conclusão
Registre o termo de endosso e os fatos de pagamento, transferência e aceite observados externamente, conforme eles ocorrem. O Lender aplica a transição de ciclo de vida de cada fato. O Lender remove um recebível aceito do caminho de posição ativa apenas quando o processamento de aceite exigido tem sucesso.
Documentos e exceções
O Lender pode produzir um dossiê do recebível a partir dos fatos que ele guarda. A primeira materialização congela o snapshot de evidências usado naquele dossiê, então uma consulta posterior representa a mesma evidência registrada. A jornada também pode trazer à tona casos de exceção. Esses casos incluem um corte repetido, um conflito ou uma divergência de remessa, um recebível que não pode ser valorado, ou uma baixa que não pode ser lançada. Resolva esses casos pelo fluxo de exceções da cessão. Não substitua a resolução ausente por um fato de ciclo de vida.
Travas operacionais
- Um conjunto não é uma cessão concluída. Rascunho, elegibilidade, aprovação, entrega da oferta, remessa, termo, pagamento, transferência e aceite são passos distintos do ciclo de vida.
- Mudanças no fundo não reescrevem um conjunto já em andamento. O Lender congela a configuração relevante do fundo na montagem do conjunto.
- A aprovação é defensiva de propósito. Ela valida o estado atual dos recebíveis antes que um fundo receba uma oferta.
- O aceite é sensível ao caminho do dinheiro. Se o Lender não conseguir completar o processamento exigido, ele recusa o aceite em vez de marcar o recebível como vendido.
Próximos passos
API REST do Lender
Comece pela API do serviço e pela referência de operações gerada.
Contabilidade e rodadas de apropriação
Veja como o Lender mantém o trabalho contábil durável separado das requisições inline.