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, a taxa de cessão, os limites de elegibilidade, o modo do termo, o modo de documento e o layout usado para o arquivo de oferta. Uma chamada de registro substitui o registro guardado, então cada chamada informa todos os campos: os limites de concentração (
nullnão registra nenhum), se um recebível com atraso aberto ou com registro suspenso é cortado, o limite de cortes repetidos e o modo de elegibilidade (full,prefilterounone). O fundo também pode definir uma tolerância de pagamento e as janelas do detector de órfãos. - 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 cortes repetidos usadas quando o Lender avalia um conjunto. As configurações de documento do fundo recebedor também determinam o caminho de documento posterior.
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
Obtenha o arquivo de oferta somente após a aprovação, depois registre que você o enviou. Quando o layout do fundo é um template do Reporter,
POST /api/v1/assignment/sets/{setId}/offer-file/generation inicia a geração, e GET /api/v1/assignment/sets/{setId}/offer-file responde 409 até o arquivo ficar pronto. Um fundo em layout nativo baixa o arquivo diretamente. Gerar nunca registra a oferta como enviada. Ingira a remessa do administrador do fundo contra esse mesmo lote. Ela deve ser um arquivo lerian-remessa-v2 que dá um veredito a cada recebível do conjunto. Outro layout responde 409 (LENDER-0520), e um arquivo que deixa um recebível sem veredito responde 409 (LENDER-1507). 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, à medida que ocorrem. Um fato
paid informa o amountPaid (LENDER-0510). Quando esse valor, líquido dos reembolsos da mesa, difere dos preços congelados além da tolerância do fundo, o Lender retém o aceite e abre um caso fund_payment_divergence (LENDER-0511). Depois que uma linha é aceita, um paid que informa outro valor responde 409 (LENDER-0515), e um lote só é aceito quando toda linha dele está paga (LENDER-0516). O Lender impõe a transição de ciclo de vida de cada fato. O Lender só retira um recebível aceito do caminho de posse ativa 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 gerar casos de exceção. Esses casos incluem um corte repetido, um conflito ou divergência de remessa, um recebível que não pode ser avaliado, um desreconhecimento que não pode ser lançado e um item de integração preso. Resolva esses casos pelo fluxo de exceções da cessão, que oferece as ações accept-payment, delivered-outside, remove-line e resend além de resolve. Não substitua um fato de ciclo de vida pela resolução que falta.
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.