Pular para o conteúdo principal
Os Tipos de Conta no Midaz permitem que você classifique sistematicamente as contas de acordo com as necessidades da estrutura financeira da sua organização. Essas classificações definem a natureza e o propósito das contas dentro do design do seu ledger, permitindo o roteamento adequado de transações e a validação operacional entre diferentes categorias de contas. Os Tipos de Conta podem ser customizados via API de Tipos de Conta para atender aos seus requisitos de negócio e fluxos de trabalho financeiros específicos, fornecendo a base para o processamento estruturado de transações enquanto mantém a integridade dos dados.

​
Habilitando a validação de Tipo de Conta

Caso você queira ativar a validação de tipo de conta para um ledger específico, você deve configurá-la no serviço de Onboarding. Isso significa atualizar a variável no arquivo .env do serviço Midaz Onboarding onde você deseja usar a validação de tipo. Sua configuração deve ficar assim: 
# List of <organization-id>:<ledger-id> separated by comma
ACCOUNT_TYPE_VALIDATION=

​
Comportamento do campo type na API de Contas

Ao criar uma Conta, o comportamento do campo type se adapta com base na ativação do recurso de Validação de Tipo de Conta:
  • Validação de Tipo de Conta Desabilitada (Padrão): O campo type é opcional e aceita qualquer string livre.
  • Validação de Tipo de Conta Habilitada: O campo type se torna obrigatório e deve corresponder a um dos Tipos de Conta previamente registrados via API de Tipos de Conta. Se um tipo inválido ou não registrado for enviado, o sistema retornará um erro de validação.
Se sua organização está habilitando o recurso de Validação de Tipo de Conta, recomendamos revisar as contas existentes. Pode ser necessário recriá-las ou atribuir retroativamente o Tipo de Conta apropriado para alinhar com sua estrutura contábil.
Essa dinâmica garante que cada conta esteja alinhada com as categorias contábeis formais exigidas pelo seu negócio, fortalecendo a governança e os relatórios financeiros.

​
Gerenciando Tipos de Conta

Você pode gerenciar seus Tipos de Conta exclusivamente via API.