Skip to main content
Aprenda estes termos uma vez e cada guia, evento e operação de API passa a ser lido do mesmo jeito. Os conceitos se agrupam por domínio: o catálogo de produtos, a originação, a gestão da carteira, 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 CDC, uma linha consignado) que carrega os termos, os encargos e a configuração de taxa dela.

Versão de produto

Os termos de um produto mudam com o tempo, então um produto de empréstimo é dono de versões de produto imutáveis. Cada versão congela os termos como eles estavam, e todo contrato originado remete à versão exata que ele usou na originação. Você ativa o produto para fixar uma versão como a versão atual dele. Os empréstimos existentes ficam com a versão em que começaram.

Encargo

Um encargo é uma tarifa ou um componente de custo preso a um produto (e herdado pelos empréstimos originados dele), por exemplo uma tarifa de originação. Um encargo fica no produto e se aplica ao cronograma.

Taxa flutuante

Um produto pode referenciar uma tabela de taxas flutuantes em vez de uma taxa fixa. O Lender resolve a taxa aplicável na tabela nos momentos em que o cronograma exige.

Perfil contábil

Um perfil contábil vincula uma versão de produto ao . Ele declara as regras de lançamento: quais pernas de disparam para cada evento contábil (desembolso, pagamento antecipado, apropriação). Ele também declara em qual organização de ledger e em qual ledger a transação é contabilizada. Sem um perfil contábil, um produto não pode lançar no ledger.

Originação


Proposta de empréstimo

Uma proposta de empréstimo é um pedido para originar um empréstimo contra uma versão de 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 em estudo sem originar nada. Você pré-visualiza as parcelas e as divulgações antes que uma proposta (ou uma aprovação) se comprometa com elas.

Gestão da carteira


Conta de empréstimo

Uma conta de empréstimo é um empréstimo ativo e desembolsado, a visão de gestão da carteira de um contrato. Ela carrega o cronograma vivo, as transações lançadas contra ela, os encargos dela e o histórico de auditoria dela. (Gestão da carteira é também o nome da superfície de leitura que lista e cria essas contas.)

Cronograma e parcela

O cronograma é o conjunto de parcelas que uma conta de empréstimo deve, em ordem. Cada parcela carrega o vencimento dela e os componentes de principal, juros e encargos dela.

Pagamento e pagamento antecipado

Um pagamento registra dinheiro recebido contra o cronograma. O Lender o distribui entre as parcelas em aberto, das mais antigas para as mais novas. Um pagamento antecipado liquida antes do cronograma, no todo ou em parte. Você pode pré-visualizar um pagamento para ver a distribuiçã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 replay

As correções nunca são destrutivas. Um estorno desfaz uma transação registrada com um lançamento compensatório. Um replay deriva de novo o estado da conta a partir do histórico de eventos dela. Os dois preservam uma linha do tempo consistente e auditável, em vez de editar o passado.

Contabilidade


Intenção de lançamento

Uma intenção de lançamento é o registro durável de um evento financeiro que deve ser contabilizado no ledger. O Lender persiste a intenção como parte da mesma transação que muda o estado do domínio. Ele então entrega a intenção ao relay do ledger. A intenção fica no banco de dados, então ela sobrevive a um reinício.

Rodada de apropriação

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

Referência de diário

Uma referência de diário é o identificador contábil da própria rodada de apropriação. Ela é um valor separado do id de correlação da rodada, que o registro da referência também guarda. O id da referência de diário identifica exatamente uma rodada. Uma leitura por id de correlação retorna a rodada 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, as divulgações e o calendário que aquele mercado exige. O Lender entrega um perfil base genérico e um perfil Brasil (BR) profundo. A jurisdição ativa molda quais divulgações e endpoints se aplicam. Veja Jurisdições.

Termos do Brasil


O perfil brasileiro adiciona conceitos regulados. Os termos em português ficam como são, com uma explicação. Para o uso de cada termo, veja o Pacote regulatório Brasil.

Próximos passos


O Lender na plataforma

Veja como esses conceitos são contabilizados no ledger e emitem eventos.

Defina um produto de empréstimo

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