Skip to main content
Uma implementação confiável do Midaz depende de algumas decisões estruturais que você toma no início. Evite os erros comuns abaixo para manter os saldos exatos e o acesso sob controle.

​
Estruturação inadequada de Ledgers

  • Erro: Você projeta ledgers complexos demais ou simples demais. Por exemplo, um ledger por cliente gera fragmentação. Agrupar processos não relacionados gera confusão.
  • Boa prática: Estruture ledgers em torno de áreas-chave do negócio ou entidades legais. Use agrupamentos organizados em vez de uma abordagem um-para-um. Isso melhora a gerenciabilidade e as transferências internas.

​
Não usar Portfólios para clientes

  • Erro: Você trata cada conta isoladamente em vez de agrupá-la sob um portfolio. Isso dificulta o rastreamento de todas as contas vinculadas a um único cliente.
  • Boa prática: Crie um portfolio para cada cliente. Agrupe suas contas para consultas simples, gestão de relacionamento e relatórios.

​
Misturar Assets em uma única Conta

  • Erro: Você gerencia múltiplas moedas ou tipos de ativos em uma única conta, muitas vezes por meio de sobrescritas de metadata. Isso leva a saldos pouco claros e inconsistências nos relatórios.
  • Boa prática: Atribua um asset por conta. Se um cliente precisa de suporte multimoeda, crie contas separadas. Use convenções de nomenclatura ou portfolios para estruturá-las.

​
Rotas Contábeis inadequadas

  • Erro: Você submete transações sem Operation Routes ou Rotas Contábeis (Transaction Routes na API) devidamente configuradas. Isso causa validações inconsistentes, fundos mal direcionados e dados de ledger não confiáveis.
  • Boa prática: Defina Rotas Contábeis que reflitam sua lógica de negócio e requisitos de conformidade e então defina a configuração do Ledger accounting.validateRoutes como true para impô-las. O padrão é false. Use Operation Routes para validar a origem e o destino de cada operation quando a validação de rotas estiver habilitada. Rotas estruturadas mantêm cada transação auditável.

​
Negligenciar o tratamento de Contas Externas

  • Erro: Você lida incorretamente com transações externas. Por exemplo, você exclui uma conta quando os fundos saem do banco, o que causa desequilíbrios.
  • Boa prática: Use a Conta externa canônica @external/<asset-code> de cada Ativo (por exemplo, @external/BRL) para todo o dinheiro que entra e sai do Midaz. Isso mantém o ledger equilibrado e corresponde aos extratos bancários reais.

​
Falhas de segurança no controle de acesso

  • Erro: Você concede privilégios excessivos a administradores ou usa contas compartilhadas. Isso compromete a segurança e a rastreabilidade.
  • Boa prática: Implemente controle de acesso baseado em papéis (RBAC) desde o início. Não use contas root ou admin para operações diárias. Aplique uma gestão rigorosa de credenciais. Audite as permissões regularmente para prevenir a escalação não autorizada de privilégios.

​
Tratamento inadequado de erros em transações

  • Erro: Você não trata as transações com falha na camada de integração. Isso leva a suposições incorretas sobre operações bem-sucedidas.
  • Boa prática: Sempre valide as respostas da API de transações. Implemente mecanismos de retry com backoff para erros transitórios. Registre as falhas permanentes em log. Garanta que os sistemas upstream, como aplicações de core banking, tratem as transações rejeitadas e notifiquem o usuário.

​
Garantindo uma implementação robusta do Midaz

Enfrente essas armadilhas cedo e o Midaz continua sendo uma base financeira confiável. Sua equipe dedica tempo a novas funcionalidades, não a problemas evitáveis.