> ## 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.

# Organizations

> Defina a Organization de nível mais alto que é dona dos seus Ledgers do Midaz. Represente bancos, fintechs e hierarquias pai-filho para subsidiárias.

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.

<Note>
  **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](/pt/platform/multi-tenancy) para você. Você não filtra por tenant nem adiciona um identificador de tenant às suas requisições.
</Note>

### 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](/pt/products/midaz/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.

<Note>
  Se um único grupo gerencia várias Organizations, use essa hierarquia para estabelecer limites claros entre elas.
</Note>

### 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.

<Tip>
  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](https://lerian.studio/contact) para saber mais.
</Tip>

## Gerenciando Organizations

***

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

### Pela API

* [Criar uma Organization](/pt/reference/products/midaz/v2/create-organization): registre uma nova Organization.
* [Listar Organizations](/pt/reference/products/midaz/v2/list-organizations): veja todas as Organizations no seu workspace.
* [Recuperar uma Organization](/pt/reference/products/midaz/v2/get-organization-by-id): obtenha detalhes de uma Organization específica.
* [Atualizar uma Organization](/pt/reference/products/midaz/v2/update-organization): edite uma Organization existente.
* [Excluir uma Organization](/pt/reference/products/midaz/v2/delete-organization): marque uma Organization como excluída.

<Note>
  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.
</Note>

### 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.**](/pt/products/midaz/console/managing-organizations)

<Tip>
  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](/pt/products/midaz/console/midaz-console-onboarding).
</Tip>