> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Ceder recebíveis

> Conduza uma jornada de cessão de recebíveis: registre um fundo, avalie um pool, aprove um conjunto, troque arquivos e registre os fatos externos que completam a cessão.

Uma **cessão de recebíveis** (*cessão*) transfere um conjunto selecionado de recebíveis para um fundo. O Lender mantém juntos o conjunto, a decisão de elegibilidade dele, os documentos dele e os fatos de ciclo de vida observados externamente. Um operador pode, assim, conduzir a jornada sem tratar uma troca de arquivos como prova de uma transferência completa.

Este guia descreve o fluxo operacional. A [API REST do Lender](https://docs.lerian.studio/pt/products/lender/lender-rest-api.md) e a referência gerada dela definem os contratos de requisição e resposta.

## 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 (`null` nã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`, `prefilter` ou `none`). 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

***

> [card] [API REST do Lender](https://docs.lerian.studio/pt/products/lender/lender-rest-api.md)
>
> Comece pela API do serviço e pela referência de operações gerada.

> [card] [Contabilidade e rodadas de apropriação](https://docs.lerian.studio/pt/products/lender/accounting-and-accrual-runs.md)
>
> Veja como o Lender mantém o trabalho contábil durável separado das requisições inline.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.