Ambientes SaaS e multi-tenant — O Midaz escopa cada Organização ao seu tenant automaticamente. Quando você lista Organizações, você vê apenas as da sua conta. A plataforma garante o isolamento de tenant para você. Você não filtra por tenant nem adiciona um identificador de tenant às suas requisições.
Sub-Organizações
As Organizações oferecem suporte a hierarquias pai-filho. Um banco as usa para representar subsidiárias, filiais regionais ou unidades de negócio separadas em um mesmo framework. Essa estrutura serve para grupos financeiros que operam várias entidades jurídicas. Cada entidade possui seus próprios Ledgers e se mantém operacionalmente independente. O vínculo pai-filho registra como as entidades se relacionam.Estrutura da Organização
- Organização > Ledgers: Cada Organização possui um ou mais Ledgers. Cada Ledger contém seus registros financeiros, como contas e transações, e pertence a uma única Organização.
Características principais
- As Organizações são o nível mais alto na hierarquia.
- Cada Organização governa seus próprios Ledgers e define seus limites operacionais.
Hierarquias flexíveis
O Midaz oferece suporte a hierarquias organizacionais para estruturas complexas. Se sua empresa possui várias localidades 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 Organização mantém seus próprios dados. Os registros de uma Organização não passam para outra.
Se um único grupo gerencia várias Organizações, 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:- Organização Pai: XPTO Ltda
- Organizações Filhas:
- XPTO New York
- XPTO São Paulo
- Definir uma função distinta para cada filial.
- Acompanhar cada filial separadamente.
- Adaptar os fluxos de trabalho a cada filial.
Benefícios da estruturação organizacional
- Escalabilidade: Adicione ou altere filiais conforme o negócio cresce.
- Eficiência: Gerencie todos os níveis a partir de uma única hierarquia.
- Personalização: Configure cada filial separadamente.
Gerenciando Organizações
Você gerencia sua Organização pela API ou pelo Lerian Console.
Via API
- Criar uma Organização — Registre uma nova Organização.
- Listar Organizações — Visualize todas as Organizações no seu workspace.
- Recuperar uma Organização — Obtenha detalhes de uma Organização específica.
- Atualizar uma Organização — Edite uma Organização existente.
- Excluir uma Organização — Marque uma Organização como excluída.
Quando você exclui uma Organização, o Midaz não a remove do sistema.Em vez disso, o Midaz define um timestamp
deletedAt. A partir daí a Organização é excluída de todas as leituras e não pode mais ser usada. O status.code dela permanece inalterado, o que preserva os dados históricos para trilhas de auditoria.
