Partes (Cedente / Sacado / Investidor)

Pré-requisitos de acesso

• Permissão (módulo): viewCredits (listar/visualizar). Aprovar/rejeitar KYC usa a mesma permissão de gestão de crédito do tenant.
• 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

A tela de Partes cadastra e governa os participantes do crédito tokenizado: Originadores (cedentes), Investidores e Sacados (devedores). Cada parte carrega documento (CPF/CNPJ), endereço, status de KYC, status de conta BaaS e os atributos de risco (score, limite de crédito, inadimplências) que alimentam as Políticas de Crédito.

Use esta tela para revisar e aprovar/rejeitar partes após o KYC, antes que elas possam originar, investir ou figurar como devedor em uma operação.

Pré-condições

• Permissão: viewCredits cadastrado para a role do operador (permissão dupla — enum CPM no backend + módulo dinâmico no DB).
• Licença/Feature: CREDIT_INVESTMENTS habilitada. Se desabilitada, o grupo nem aparece no menu.
• Dependências de outras telas: nenhuma; porém as partes precisam existir e estar aprovadas antes de serem usadas em Negócios/Deals.

Passo a passo

1. Acesse o menu Crédito Tokenizado → Partes.
2. Filtre por Tipo (Originador / Investidor / Sacado / Todos) e Status.
3. Use a busca para localizar por nome/documento.
4. Abra a parte (linha ou ⋮ → Visualizar) para conferir KYC, endereço e atributos de risco.
5. Para partes pendentes, use ⋮ → Aprovar ou ⋮ → Rejeitar (com confirmação).

Filtros e colunas

Filtro/Coluna	O que mostra	Origem do dado
Nome	Razão social / nome da parte	Party.name
Tipo	ORIGINATOR, INVESTOR ou DEBTOR	Party.type (filtro typeFilter)
Documento	CPF/CNPJ	Party.documentNumber + documentType
Status	PENDING_KYC, KYC_APPROVED, KYC_REJECTED, ACTIVE, SUSPENDED, PENDING_APPROVAL, APPROVED, REJECTED	Party.status (filtro statusFilter)
Status KYC	Resultado do KYC da parte	Party.kycStatus
Conta BaaS	Situação da conta bancária associada	Party.baasAccountStatus
Criado em	Data de cadastro	Party.createdAt

Atributos de risco visíveis no detalhe (não na lista, mas usados pelas Políticas): riskScore, creditLimit, usedCredit, kycScore, defaultCount, totalDeals, totalVolume, riskRating.

Ações e modais

• Visualizar: abre os detalhes da parte (credit-parties/view/:id).
• Editar: abre o formulário (credit-parties/edit/:id).
• Criar: cadastra uma nova parte (credit-parties/create).
• Aprovar: approveParty(id) após confirmação (bottom-sheet) — libera a parte para operar.
• Rejeitar: rejectParty(id) após confirmação — barra a parte.

Aprovar/rejeitar partes pode disparar step-up (senha + MFA, X-Step-Up-Token, janela 5 min) conforme o ambiente — reconfirmação de identidade, não aprovação 4-eyes.

Regras de negócio / cuidados

Atenção

• Status governa o uso. Originador/investidor só entram numa operação se aprovados; o desembolso ao originador exige conta BaaS ativa e status compatível.
• Atributos de risco alimentam as Políticas. riskScore, defaultCount, creditLimit/usedCredit são lidos pelas Políticas de escopo PARTY na aprovação de deals/recebíveis — mantenha-os atualizados.
• Sacado (DEBTOR) é quem paga a Cobrança; cadastre-o corretamente para o vínculo recebível→cobrança funcionar.

• Valores financeiros: creditLimit, usedCredit e totalVolume representam montantes tratados como BigNumber no backend — não arredonde ao definir limites.
• Status APPROVED: operações financeiras a jusante exigem a parte com status aprovado.

Telas relacionadas

• Negócios / Deals
• Recebíveis
• Políticas de Crédito
• Crédito Tokenizado (índice do grupo)