Skip to main content
Uma Organization é a entidade de nível mais alto no Midaz. Ela representa uma instituição financeira, como um banco ou uma fintech. Uma Organization é dona e governa os dados financeiros dessa instituição. É o container principal para todas as operações financeiras. Um banco ou grupo financeiro se registra como uma Organization no Midaz.
Ambientes SaaS e multi-tenant: o Midaz vincula automaticamente cada Organization ao seu tenant. Ao listar Organizations, você vê apenas as da sua conta. A plataforma aplica o isolamento de tenant para você. Você não filtra por tenant nem adiciona um identificador de tenant às suas requisições.

​
Sub-Organizations

As Organizations aceitam hierarquias pai-filho. Um banco as usa para representar subsidiárias, filiais regionais ou unidades de negócio separadas em um único framework. Essa estrutura atende grupos financeiros que operam várias entidades legais. Cada entidade é dona dos seus próprios Ledgers e permanece operacionalmente independente. O vínculo pai-filho registra como as entidades se relacionam.

​
Estrutura da Organization

  • Organization > Ledgers: toda Organization é dona de um ou mais Ledgers. Cada Ledger guarda seus registros financeiros, como contas e transações, e pertence a uma única Organization.

​
Principais características

  • As Organizations são o nível mais alto da hierarquia.
  • Cada Organization governa seus próprios Ledgers e define seus limites operacionais.

​
Hierarquias flexíveis

O Midaz aceita hierarquias organizacionais para estruturas complexas. Se sua empresa tem vários locais ou divisões, você pode criar organizações filhas para filiais, escritórios ou subdivisões específicas. Cada organização filha se conecta a uma organização pai. Cada Organization mantém seus próprios dados. Registros de uma Organization não passam para outra.
Se um único grupo gerencia várias Organizations, use essa hierarquia para estabelecer limites claros entre elas.

​
Exemplo

A Empresa XPTO é uma empresa brasileira com filiais em São Paulo e Nova York. Sua estrutura é a seguinte:
  • Organization pai: XPTO Ltda
  • Organizations filhas:
    • XPTO Nova York
    • XPTO São Paulo
Com essa estrutura, a empresa pode:
  • Definir um papel distinto para cada filial.
  • Acompanhar cada filial separadamente.
  • Adaptar workflows a cada filial.

​
Benefícios da estruturação organizacional

  • Escalabilidade: adicione ou mude filiais conforme o negócio cresce.
  • Eficiência: gerencie todos os níveis a partir de uma única hierarquia.
  • Personalização: configure cada filial de forma independente.
Precisa de ajuda com a configuração do seu Midaz? Nosso serviço de consultoria pode ajudar você a projetar a estrutura da sua organização, do zero ou a partir de uma configuração existente.Fale conosco para saber mais.

​
Gerenciando Organizations

Você gerencia sua Organization pela API ou pelo Lerian Console.

​
Pela API

Quando você exclui uma Organization, o Midaz não a remove do sistema.Em vez disso, o Midaz define um carimbo de data/hora deletedAt. O Midaz então exclui a Organization de todas as leituras, e você não pode mais usá-la. O Midaz mantém o status.code inalterado, o que preserva os dados históricos para trilhas de auditoria.

​
Pelo Lerian Console

Você visualiza, cria, edita e exclui Organizations na página Organizations do Módulo Midaz do Lerian Console. Saiba mais no guia Gerenciando Organizations.
Ao criar sua primeira Organization no Console, você faz isso como parte do fluxo de onboarding. Para saber mais, veja o guia Onboarding do Módulo Midaz.