Tipos de Recebível

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 Tipo de Recebível define as categorias de recebíveis que a plataforma aceita (duplicata, nota fiscal, cartão, etc.) e quais campos são obrigatórios ao cadastrar um recebível daquele tipo. É o que padroniza e valida a entrada de dados do originador.

Use esta tela para criar/manter os tipos disponíveis e controlar, por tipo, quais informações o originador é obrigado a informar.

Pré-condições

• Permissão: creditConfigManage (permissão dupla — enum CPM + módulo dinâmico no DB).
• Licença/Feature: CREDIT_INVESTMENTS habilitada.
• Dependências: nenhuma. Os tipos são consumidos depois na criação de recebíveis.

Passo a passo

1. Acesse Crédito Tokenizado → Tipos de Recebível.
2. Filtre por Ativo se necessário.
3. Clique em Criar.
4. Preencha Código e Nome.
5. No bloco de campos obrigatórios, clique em Adicionar campo e escolha entre os disponíveis: external_reference, invoice_number, invoice_key, debtor_id, issue_date, due_date, gross_amount, net_amount, currency.
6. Clique em Salvar.

Campos

Campo	O que é	Obrigatório?	Efeito no sistema/backend
Código	Identificador curto/único do tipo (ex.: DUPLICATA)	Sim	Gravado em code; usado como chave de referência do tipo.
Nome	Nome amigável do tipo	Sim	Gravado em name; aparece na listagem e nos seletores.
Campos obrigatórios	Lista dos campos que o originador deve informar para esse tipo	Não	Gravado em requiredFields (array). Cada item escolhido vira uma exigência de preenchimento ao cadastrar um recebível daquele tipo.
Ativo	Liga/desliga o tipo	Sim (default Sim)	Gravado em active; tipos inativos não devem ser oferecidos em novos cadastros.

A tela tolera tanto o formato JSON quanto o formato de array do PostgreSQL ({invoice_number,invoice_key}) ao reabrir um tipo para edição — você não precisa se preocupar com a serialização.

Ações e modais

• Criar / Atualizar: grava o tipo via createReceivableType / updateReceivableType. Botão visível só com creditConfigManage.
• Adicionar / Remover campo obrigatório: manipulam a lista requiredFields.
• Editar (ícone lápis): carrega o tipo e remonta a lista de campos obrigatórios.

Por ser configuração estrutural do crédito, salvar pode exigir step-up (senha + MFA) conforme o ambiente.

Regras de negócio / cuidados

Atenção

• Os campos obrigatórios viram validação na origem. Marcar invoice_key como obrigatório, por exemplo, impede o cadastro de um recebível desse tipo sem a chave da NFe — alinhe a exigência ao que o originador realmente consegue fornecer.
• Código deve ser estável. Como o code é a chave de referência do tipo, evite alterá-lo após já existirem recebíveis vinculados.
• Desative em vez de apagar. Use Ativo = Não para descontinuar um tipo sem quebrar recebíveis históricos.

Telas relacionadas

• Políticas de Crédito — campos como hasInvoiceValidation se conectam à exigência de NFe.
• Templates de Precificação
• Guia de Crédito
• Crédito Tokenizado (índice do grupo)