Skip to main content
O Lender usa um vocabulário preciso. Aprenda esses termos uma vez e cada guia, evento e operação da API se lê da mesma forma. Os conceitos se agrupam por domínio: o catálogo de produtos, a originação, o servicing, a contabilidade e as extensões do Brasil.

Catálogo de produtos


Produto de empréstimo

Um produto de empréstimo é o template a partir do qual um empréstimo é originado — a oferta de crédito nomeada (uma linha de CDC, uma linha de consignado) que carrega seus termos, encargos e configuração de taxa.

Versão do produto

Os termos de um produto mudam com o tempo, então um produto de empréstimo tem versões imutáveis do produto. Cada versão congela os termos como estavam, e cada contrato originado rastreia a versão exata com a qual foi criado. Você ativa o produto para fixar uma versão como sua versão atual; empréstimos existentes mantêm a versão com a qual começaram.

Encargo

Um encargo é uma tarifa ou componente de custo associado a um produto (e herdado pelos empréstimos originados a partir dele) — por exemplo, uma tarifa de originação. Encargos são definidos no produto e aplicados ao cronograma.

Taxa flutuante

Um produto pode referenciar uma tabela de taxa flutuante em vez de uma taxa fixa. O Lender resolve a taxa aplicável a partir da tabela nos momentos em que o cronograma precisa dela.

Perfil contábil

Um perfil contábil amarra uma versão do produto ao . Ele declara as regras de posting — quais lançamentos de disparam para cada evento contábil (desembolso, pagamento antecipado, apropriação) e em qual organização de ledger e ledger a transação é contabilizada. Sem perfil contábil, não há posting: o perfil é como um produto sabe como manter sua contabilidade.

Originação


Proposta de empréstimo

Uma proposta de empréstimo é um pedido para originar um empréstimo contra uma versão do produto. Ela percorre um ciclo de vida explícito:

Prévia do cronograma

A prévia do cronograma calcula o cronograma de amortização de um empréstimo prospectivo sem originar nada — você pré-visualiza as parcelas e as divulgações antes de uma proposta (ou de uma aprovação) se comprometer com elas.

Servicing


Conta de empréstimo

Uma conta de empréstimo é um empréstimo ativo e desembolsado — a visão de servicing de um contrato. Ela carrega o cronograma vivo, as transações contabilizadas contra ela, seus encargos e seu histórico de auditoria. (A superfície de leitura que as lista e cria também se chama servicing.)

Cronograma e parcela

O cronograma é o conjunto ordenado de parcelas que uma conta de empréstimo deve — cada uma com sua data de vencimento e seus componentes de principal, juros e encargos.

Repagamento e pagamento antecipado

Um repagamento registra dinheiro recebido contra o cronograma; o Lender o aloca entre as parcelas em aberto, da mais antiga para a mais recente. Um pagamento antecipado liquida antes do prazo, total ou parcialmente. Você pode pré-visualizar um repagamento para ver a alocação antes de registrá-lo.

Reprogramação

Uma reprogramação reescreve o cronograma restante de uma conta de empréstimo — por exemplo, depois de uma renegociação.

Estorno e reprocessamento

Correções nunca são destrutivas. Um estorno desfaz uma transação registrada com um lançamento compensatório; um reprocessamento re-deriva o estado da conta a partir do histórico de eventos. Ambos preservam uma linha do tempo consistente e auditável em vez de editar o passado.

Contabilidade


Intenção de posting

Uma intenção de posting é o registro durável de “este evento financeiro precisa ser contabilizado no ledger”. O Lender persiste a intenção como parte da mesma transação que muda o estado do domínio, e depois a entrega ao relay do ledger. A intenção vive no banco de dados, portanto sobrevive a um reinício.

Rotina de apropriação

Uma rotina de apropriação calcula os juros (e outros valores baseados no tempo) apropriados ao longo de um período em toda a carteira, produzindo os postings que os reconhecem. Cada reconhecimento cobre uma conta de empréstimo, um mês e um tipo de valor. Uma rotina repetida não apropria duas vezes.

Referência de lançamento

Uma referência de lançamento é o identificador contábil que uma rotina de apropriação registra para si mesma. Ela é um valor distinto do id de correlação da rotina, que o registro da referência também guarda. O id da referência de lançamento identifica uma única rotina de forma exata; uma leitura por id de correlação devolve a rotina mais recente que o compartilha.

Jurisdições


Jurisdição e perfil

Uma jurisdição é um mercado cujas regras de crédito o Lender conhece. Cada jurisdição fornece um perfil — as regras, divulgações e o calendário que aquele mercado exige. O Lender traz um perfil base genérico e um perfil profundo do Brasil (BR); a jurisdição ativa molda quais divulgações e endpoints se aplicam. Veja Jurisdições.

Termos do Brasil


O perfil brasileiro acrescenta conceitos regulados. Os termos em português são mantidos como estão — veja o Pacote regulatório do Brasil para como cada um é usado.

Próximos passos


O Lender na plataforma

Veja como esses conceitos contabilizam no ledger e emitem eventos.

Definir um produto de empréstimo

Coloque os conceitos do catálogo de produtos para trabalhar.