> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizações

> Defina a Organização de nível mais alto que possui seus Ledgers no Midaz — represente bancos, fintechs e hierarquias pai-filho para subsidiárias.

Uma **Organização** é a entidade de nível mais alto no Midaz, representando uma instituição financeira como um banco ou fintech. Ela possui e governa os dados financeiros dentro da plataforma, atuando como o contêiner principal para todas as operações financeiras.

Em termos práticos, um banco ou grupo financeiro se registra como uma Organização no Midaz, estabelecendo um ambiente estruturado para suas operações.

<Note>
  **Ambientes SaaS e multi-tenant** — Toda organização é automaticamente escopada ao seu tenant. Quando você lista organizações, só enxerga as que pertencem à sua conta — o [isolamento de tenant](/pt/multi-tenancy) é garantido no nível da plataforma. Você não precisa filtrar por tenant nem incluir identificadores de tenant nas suas requisições.
</Note>

### Sub-Organizações

As Organizações podem estabelecer **hierarquias pai-filho**, permitindo que bancos representem subsidiárias, filiais regionais ou diferentes unidades de negócio dentro do mesmo framework.

Essa estrutura hierárquica é ideal para grupos financeiros que operam múltiplas entidades jurídicas, mas ainda precisam de supervisão centralizada. Cada entidade pode ter seu próprio conjunto de [Ledgers](/pt/midaz/ledgers), garantindo independência operacional enquanto mantém uma visão consolidada no nível do grupo.

### Estrutura da Organização

* **Organização > Ledgers:** Cada Organização pode possuir múltiplos Ledgers. Todos os registros financeiros — como contas e transações — são mantidos dentro de Ledgers que pertencem a uma Organização específica.

### Características principais

* As Organizações são o nível mais alto na hierarquia.
* Cada Organização governa seus próprios Ledgers, definindo limites operacionais.

## Hierarquias flexíveis

***

O Midaz capacita empresas com hierarquias organizacionais dinâmicas, permitindo o gerenciamento fluido de estruturas complexas.

Se sua empresa possui múltiplas localidades ou divisões distintas, você pode criar **organizações filhas** para representar filiais, escritórios ou subdivisões específicas. Essas organizações filhas se conectam a uma **organização pai**, que fornece um framework unificado para manter a consistência, aplicar governança e otimizar operações.

Essa estrutura garante **integridade dos dados, previne interações não autorizadas entre organizações e reforça a autonomia operacional**.

<Note>
  Para empresas que gerenciam múltiplas organizações, recomendamos usar essa hierarquia para estabelecer limites claros enquanto permite colaboração controlada quando necessário.
</Note>

### Exemplo

A **Empresa XPTO** é uma empresa brasileira com filiais em São Paulo e Nova York. Nesse caso, a estrutura seria a seguinte:

* **Organização Pai**: XPTO Ltda
* **Organizações Filhas**:
  * XPTO New York
  * XPTO São Paulo

Usando essa estrutura, a empresa pode:

* Atribuir funções operacionais distintas a cada filial.
* Monitorar o desempenho nos níveis local e global.
* Customizar fluxos de trabalho para atender às necessidades únicas de cada filial.

## Benefícios da estruturação organizacional

***

* **Escalabilidade**: Adicione ou modifique filiais facilmente conforme seu negócio cresce.
* **Eficiência**: Otimize processos em todos os níveis da sua organização.
* **Personalização**: Adapte configurações para cada filial para aumentar a relevância e o impacto.

Ao oferecer essa flexibilidade, o Midaz se adapta à estrutura da sua empresa, não importa quão simples ou complexa ela seja.

<Tip>
  Precisa de ajuda para projetar sua configuração no Midaz? Nosso serviço de consultoria pode ajudar a adaptar a estrutura às necessidades únicas da sua organização — seja começando do zero ou otimizando uma configuração existente.

  [Fale conosco](https://lerian.studio/contact) para saber mais.
</Tip>

## Gerenciando Organizações

***

Você pode gerenciar sua Organização via API ou através do Lerian Console.

### Via API

* [Criar uma Organização](/pt/reference/midaz/create-an-organization) — Registre uma nova Organização.
* [Listar Organizações](/pt/reference/midaz/list-organizations) — Visualize todas as Organizações no seu workspace.
* [Recuperar uma Organização](/pt/reference/midaz/retrieve-an-organization) — Obtenha detalhes de uma Organização específica.
* [Atualizar uma Organização](/pt/reference/midaz/update-an-organization) — Edite os detalhes de uma Organização existente.
* [Excluir uma Organização](/pt/reference/midaz/delete-an-organization) — Marque uma Organização como excluída.

<Note>
  Quando você exclui uma Organização, ela não é permanentemente removida do sistema.

  Uma tag de exclusão com timestamp é adicionada, e a Organização se torna inativa e inutilizável — ajudando a preservar dados históricos para trilhas de auditoria.
</Note>

### Via Lerian Console

Todas as ações de gerenciamento de Organizações, incluindo visualização, criação, edição e exclusão, podem ser feitas através da página de **Organizações** no Módulo Midaz do Lerian Console.

[**Saiba mais no guia de Gerenciamento de Organizações.**](/pt/midaz/console/managing-organizations)

<Tip>
  Se você está criando sua **primeira Organização** no Console, fará isso como parte do fluxo de onboarding. Para saber mais, confira o guia de [onboarding do Módulo Midaz](/pt/midaz/console/midaz-console-onboarding).
</Tip>