> ## 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]
>
> **Na Lerian Cloud**: o Midaz vincula automaticamente cada Organization ao seu tenant. Ao listar Organizations, você vê apenas as da sua conta. 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](https://docs.lerian.studio/pt/products/midaz/ledgers.md) e permanece operacionalmente independente. O vínculo pai-filho registra como as entidades se relacionam.

### Estrutura da Organization

* **Organization > Ledgers:** uma Organization pode ser dona de vários 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.

> [!NOTE]
>
> 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.

> [!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.

## Gerenciando Organizations

***

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

### Pela API

* [Criar uma Organization](https://docs.lerian.studio/pt/reference/products/midaz/v2/create-organization.md): registre uma nova Organization.
* [Listar Organizations](https://docs.lerian.studio/pt/reference/products/midaz/v2/list-organizations.md): veja todas as Organizations no seu workspace.
* [Recuperar uma Organization](https://docs.lerian.studio/pt/reference/products/midaz/v2/get-organization-by-id.md): obtenha detalhes de uma Organization específica.
* [Atualizar uma Organization](https://docs.lerian.studio/pt/reference/products/midaz/v2/update-organization.md): edite uma Organization existente.
* [Excluir uma Organization](https://docs.lerian.studio/pt/reference/products/midaz/v2/delete-organization.md): 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. O Midaz rejeita a exclusão de Organization em um ambiente de produção.

### 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.**](https://docs.lerian.studio/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](https://docs.lerian.studio/pt/products/midaz/console/midaz-console-onboarding.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.