Pular para o conteúdo principal
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 uma versão para torná-la originável; 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 financeiro (desembolso, repagamento, apropriação, estorno) 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 de produto ativa. Ela percorre um ciclo de vida explícito:
AçãoSignificado
EnviarCria a proposta em estado pendente.
AprovarAceita a proposta; um registro de decisão é guardado.
RecusarRecusa a proposta, com um registro de decisão.
RetirarRetira uma proposta antes de ela ser decidida.
DesembolsarLibera os recursos; os fatos do desembolso e a conta de empréstimo resultante são registrados.

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. 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 contabilizada 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 — assim uma contabilização nunca é perdida, mesmo entre reinícios.

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. Rotinas podem ser reexecutadas se uma etapa downstream falhar.

Referência de lançamento

Uma referência de lançamento liga um evento financeiro do Lender à transação do ledger que o registrou, para que você possa rastrear qualquer posting de e para o por id de correlação.

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.
TermoSignificado
CETCusto Efetivo Total — o custo efetivo total do crédito divulgado ao tomador, cobrindo juros, tributos e tarifas.
IOFImposto sobre Operações Financeiras — o tributo federal sobre operações de crédito, pré-visualizável antes da originação.
Consentimento de capitalizaçãoO consentimento registrado do tomador à capitalização de juros compostos no contrato.
Estágio de PDDProvisão para Devedores Duvidosos — o estágio de provisionamento para perdas em que uma conta de empréstimo está, com transições rastreadas.
Descritor de créditoO descritor de operação de crédito no estilo SCR de uma conta de empréstimo (o perfil regulado da operação).
Cotação de pagamento antecipadoUma cotação vinculante para liquidar uma conta de empréstimo antes do prazo, antes de registrar o pagamento antecipado.
CCBCédula de Crédito Bancário — o instrumento de crédito bancário emitido e assinado para um contrato de consignado.
AverbaçãoRegistro do desconto em folha junto à entidade pagadora, para que as parcelas sejam retidas na fonte.

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.