Documentação

Português

English
Español

Português

English
Español

Appearance

Templates de Precificação ​

Pré-requisitos de acesso

  • Permissão (módulo): creditConfigManage (para criar/editar). Leitura liberada por viewCredits.
  • Licença/Feature: CREDIT_INVESTMENTS habilitada na licença do tenant (Vault).
  • Contêiner do menu: TOKENIZAÇÃO → grupo Crédito Tokenizado

O que é / quando usar ​

O Template de Precificação define spreads, taxas e prazos que o motor de precificação usa para calcular o desconto, as taxas e o desembolso líquido de uma operação de antecipação de recebíveis. É a "tabela de preço" do crédito: a partir dela o sistema deriva a taxa de desconto do período e quanto o originador efetivamente recebe.

Use esta tela para padronizar a precificação por produto/risco, em vez de digitar taxas manualmente a cada operação. Cada template pode ainda ajustar o spread por score de risco (ex.: AAA mais barato, D mais caro).

Pré-condições ​

  • Permissão: creditConfigManage cadastrado para a role (permissão dupla — enum CPM no backend + módulo dinâmico no DB).
  • Licença/Feature: CREDIT_INVESTMENTS habilitada; do contrário o grupo não aparece no menu.
  • Dependências: nenhuma para criar o template. Ele é consumido depois ao cotar/criar deals (o template é referenciado por pricingTemplateId).

Passo a passo ​

  1. Acesse Crédito Tokenizado → Templates de Precificação.
  2. Filtre por Ativo se necessário.
  3. Clique em Criar.
  4. Preencha Nome, Spread Base, Taxa Administrativa, % de Reserva, Prazo Mínimo e Prazo Máximo (em dias).
  5. Opcionalmente, no bloco de spread por score, adicione linhas associando um score (AAA, AA, A, BBB, BB, B, CCC, D, ou LOW/MEDIUM/HIGH) a um spread adicional.
  6. Clique em Salvar.

Campos ​

CampoO que éObrigatório?Efeito no sistema/backend
NomeIdentificação do templateSimGravado em name; usado na listagem e na seleção ao cotar deals.
Spread BaseSpread em % a.a. somado à taxa-baseSim (default 0)Gravado em baseSpread. Entra na fórmula da taxa de desconto: taxaAnual = taxaBase + spread + ajusteDeRisco, aplicada pro-rata pelo prazo (× dias/365).
Taxa AdministrativaTaxa fixa em % sobre o valor brutoSim (default 0)Gravado em adminFee. Calcula feesAmount = valorBruto × adminFee/100 — taxa plana, não anualizada.
% de ReservaPercentual retido como reservaSim (default 0)Gravado em reservePercentage. Reserva de garantia/cobertura associada à operação.
Prazo Mínimo (dias)Prazo médio mínimo aceitoSim (default 0)Gravado em minTermDays. Na precificação, se o prazo médio ponderado dos recebíveis ficar abaixo do mínimo, o cálculo é rejeitado com erro.
Prazo Máximo (dias)Prazo médio máximo aceitoSim (default 0)Gravado em maxTermDays. Se o prazo médio ponderado exceder o máximo, o cálculo é rejeitado.
Spread por Score → ScoreClassificação de risco (AAA…D, ou LOW/MEDIUM/HIGH)NãoChave do mapa spreadByScore. Permite ajustar o risco por rating.
Spread por Score → SpreadSpread adicional para aquele score, em % a.a.CondicionalValor do mapa spreadByScore. O motor de precificação usa o ajuste correspondente ao perfil de risco do originador como riskAdjustment na fórmula. Se o perfil não estiver no mapa, o ajuste é 0.
AtivoLiga/desliga o templateSim (default Sim)Gravado em active; templates inativos não devem ser usados em novas cotações.
VersãoNúmero de versãoNão (default 1)Gravado em version; rastreia revisões de preço.

Como o template é aplicado (visão do motor) ​

Ao cotar/precificar uma operação, o motor de precificação:

  1. Soma o valor bruto dos recebíveis.
  2. Calcula o prazo médio ponderado (cada recebível pesa pela sua participação no valor bruto) e valida contra minTermDays/maxTermDays.
  3. Obtém a taxa-base (CDI/Selic) da configuração do tenant — se não houver, usa 12% a.a. como padrão.
  4. Aplica o ajuste de risco vindo de spreadByScore conforme o perfil do originador.
  5. taxaDesconto = (taxaBase + baseSpread + ajusteRisco) × (dias/365).
  6. desconto = bruto × taxaDesconto/100; taxas = bruto × adminFee/100; líquido = bruto − desconto − taxas.

Ações e modais ​

  • Criar / Atualizar: grava o template via createPricingTemplate / updatePricingTemplate. Botão visível só com creditConfigManage.
  • Adicionar / Remover linha de spread: manipulam o mapa spreadByScore (gerado automaticamente — você não edita o JSON manualmente).
  • Editar: carrega o template e remonta as linhas de spread a partir do spreadByScore salvo.

Por ser configuração que define preço, salvar pode exigir step-up (senha + MFA) conforme o ambiente.

Regras de negócio / cuidados ​

Atenção

  • Prazo médio fora da faixa rejeita o cálculo. Se o prazo médio ponderado dos recebíveis ficar abaixo de minTermDays ou acima de maxTermDays, a precificação falha — ajuste a faixa ou os recebíveis.
  • Taxa-base default é 12% a.a. Se o tenant não tiver a taxa-base configurada, o motor assume 12% a.a. e registra aviso. Não confie no default para produção: configure a taxa-base real.
  • adminFee é plana, baseSpread é anualizada. A taxa administrativa incide direto sobre o bruto; o spread é anualizado e ratado pelo prazo. Não confunda as duas ao calibrar o preço.
  • Score ausente = ajuste 0. Se o perfil de risco do originador não tiver linha em spreadByScore, o ajuste de risco é zero — pode subprecificar risco alto.
  • Valores financeiros: os percentuais e montantes derivados (desconto, taxas, líquido) são tratados como BigNumber no domínio de crédito — não arredonde manualmente; confira casas decimais.

Exemplos ​

Cenário 1 — Template padrão de antecipação de duplicatas
  1. Nome: "Duplicatas 30-90d". Spread Base: 6 (% a.a.). Taxa Adm.: 1 (%). % Reserva: 5. Prazo Mín./Máx.: 30 / 90.
  2. Sem ajustes por score.
  3. Salvar.

Resultado para um lote de R$ 100.000 com prazo médio de 60 dias e taxa-base 12% a.a.: taxa anual = 12 + 6 + 0 = 18%; taxa do período = 18 × 60/365 ≈ 2,96%; desconto ≈ R$ 2.959; taxas = 1% = R$ 1.000; líquido ≈ R$ 96.041.

Cenário 2 — Precificação com ajuste por rating
  1. Nome: "Pool Risco Variável". Spread Base: 4. Taxa Adm.: 0,5. Prazo Mín./Máx.: 15 / 180.
  2. Spread por score:
    • AAA → 0
    • BBB → 2
    • D → 8
  3. Salvar.

Resultado: um originador rating BBB recebe taxa anual = base + 4 + 2; o mesmo lote para um rating D paga base + 4 + 8 — o risco mais alto encarece automaticamente.

Cenário 3 — Template de prazo curto (cartão/PIX agendado)
  1. Nome: "Curtíssimo Prazo". Spread Base: 3. Taxa Adm.: 0. Prazo Mín./Máx.: 1 / 30.
  2. Salvar.

Resultado: operações de prazo médio acima de 30 dias são rejeitadas por este template (excede maxTermDays), forçando o uso de outro template para prazos maiores.

Telas relacionadas ​