Recebíveis

Pré-requisitos de acesso

• Permissão (módulo): viewCredits (listar/visualizar e operar o ciclo do recebível).
• 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 Recebíveis gerencia os títulos (notas fiscais, duplicatas, contratos) que lastreiam as operações de crédito. Cada recebível pertence a um originador, opcionalmente a um sacado/devedor, e tem um tipo de recebível (que define os campos obrigatórios). É o ativo-base que, uma vez aprovado, é cedido/antecipado dentro de um Deal.

Use esta tela para revisar recebíveis, anexar/conferir documentos (NFe, contratos), gerar parcelas (installments) e mover cada recebível pelo seu ciclo: rascunho → submetido → aprovado/rejeitado.

Pré-condições

• Permissão: viewCredits (permissão dupla — enum CPM + módulo dinâmico no DB).
• Licença/Feature: CREDIT_INVESTMENTS habilitada. Sem ela o grupo nem aparece no menu.
• Dependências de outras telas: o originador (e o sacado, se houver) precisam existir em Partes; o tipo de recebível precisa estar cadastrado em Tipos de Recebível — ele é carregado para resolver o rótulo na lista.

Passo a passo

1. Acesse o menu Crédito Tokenizado → Recebíveis.
2. Filtre por Status e use a busca.
3. Abra um recebível (linha ou ⋮ → Visualizar).
4. Use ⋮ → Documentos para anexar/ver a NFe e demais arquivos.
5. Use ⋮ → Parcelas para gerar/visualizar o parcelamento (installments) a partir do valor bruto.
6. Para um recebível em rascunho, use ⋮ → Submeter para aprovação; depois Aprovar ou Rejeitar.

Filtros e colunas

Filtro/Coluna	O que mostra	Origem do dado
Referência externa	Identificador do título no sistema de origem	Receivable.externalReference
Tipo de recebível	Categoria (resolvida para o nome via mapa)	Receivable.receivableTypeId → Tipos de Recebível
Originador	Cedente do título	Receivable.originatorId
Valor bruto	Valor de face	Receivable.grossAmount (BigNumber)
Valor líquido	Valor após descontos	Receivable.netAmount
Vencimento	Data de vencimento do título	Receivable.dueDate
Status	DRAFT, PENDING_APPROVAL, APPROVED, REJECTED, CANCELLED, DISCOUNTED, SETTLED, DEFAULT	Receivable.status (filtro statusFilter)
Criado em	Data de cadastro	Receivable.createdAt

Ações e modais

• Visualizar / Editar / Criar: rotas credit-receivables/view|edit|create.
• Documentos: abre o diálogo de documentos (ReceivableDocumentsDialog) para anexar/listar arquivos (NFe, contrato) vinculados pelo receivableId.
• Parcelas (installments): abre o diálogo de parcelas (ReceivableInstallmentsDialog), que distribui o grossAmount em parcelas; cada parcela vira base para uma futura Cobrança.
• Submeter para aprovação: submitReceivableForApproval(id) — move de DRAFT para PENDING_APPROVAL. Em erro, a mensagem do backend é exibida (ex.: campos obrigatórios do tipo faltando).
• Aprovar / Rejeitar: approveReceivable(id) / rejectReceivable(id) após confirmação — disparam a avaliação das Políticas de escopo RECEIVABLE.

Aprovar/rejeitar/submeter podem disparar step-up (senha + MFA, X-Step-Up-Token) conforme o ambiente — reconfirmação de identidade, não 4-eyes.

Regras de negócio / cuidados

Atenção

• O tipo define os campos obrigatórios. Submeter pode falhar se o Tipo de Recebível exigir campos não preenchidos — a mensagem de erro vem do backend.
• Políticas de RECEIVABLE rodam na aprovação. Ex.: "NFe não validada" pode forçar revisão manual ou rejeição (ver exemplos em Políticas).
• As parcelas alimentam as cobranças. O parcelamento gerado aqui é a origem das Cobranças PIX/Boleto enviadas ao sacado.

• Valores financeiros: grossAmount/netAmount e os valores de parcela são BigNumber no backend — a soma das parcelas deve fechar com o bruto; não arredonde.

Exemplos

Cenário 1 — Recebível de NFe submetido e aprovado

1. Criar recebível com tipo "Duplicata NFe", originador, referência externa e valor bruto.
2. ⋮ → Documentos → anexar o XML/PDF da NFe.
3. ⋮ → Submeter para aprovação → status vira PENDING_APPROVAL.
4. ⋮ → Aprovar → as Políticas de RECEIVABLE rodam; passando, vai para APPROVED e fica elegível a entrar num Deal.

Cenário 2 — Parcelar um recebível antes de cobrar

1. Abra o recebível aprovado.
2. ⋮ → Parcelas → distribua o valor bruto em N parcelas com vencimentos.
3. Cada parcela gerada vira base para uma Cobrança ao sacado na tela de Cobranças.

Cenário 3 — Recebível barrado por política

1. Submeter recebível sem validação fiscal.
2. Na aprovação, a Política "NFe não validada" (escopo RECEIVABLE, ação Revisão Manual) impede a auto-aprovação e joga o item para análise humana.

Telas relacionadas

• Negócios / Deals
• Tipos de Recebível
• Cobranças
• Políticas de Crédito
• Crédito Tokenizado (índice do grupo)