Estrutura do Ledger
- Ledger > Organização: Cada Organização pode possuir múltiplos Ledgers, mas cada Ledger pertence a apenas uma Organização. Isso garante separação financeira e responsabilidade.
- Múltiplos Ledgers devem ser usados apenas quando a segregação de dados ou operações é necessária — por exemplo, para operações de tesouraria interna versus contas de clientes.
Como orquestrar transações entre Ledgers
Para mover fundos entre dois Ledgers, você precisará criar um fluxo de trabalho orquestrado que divide a transferência em duas transações separadas:- Débito do Ledger de origem: Comece transferindo o valor desejado de uma conta no Ledger 1 para uma Conta Externa. Essa conta atua como uma ponte e está sempre vinculada a um Ativo específico.
- Crédito no Ledger de destino: Em seguida, crie uma segunda transação que move o mesmo valor da Conta Externa para a conta de destino no Ledger 2.
NotaEm breve você poderá usar o Flowker para automatizar essa orquestração e incluir validações, condições e lógica de rollback conforme necessário.
Características principais
- Os Ledgers garantem integridade financeira e transparência operacional.
- Todas as Contas e Transações existem dentro de um Ledger, formando um sistema financeiro completo.
- Cada Ledger mantém um conjunto balanceado de Contas.
- Múltiplos Ledgers podem ser usados para segmentação, mas transações entre Ledgers requerem tratamento explícito.
Múltiplos Ledgers
O Midaz oferece a capacidade de criar múltiplos Ledgers para cada organização, proporcionando flexibilidade e controle aprimorados. Esse recurso é particularmente benéfico para empresas com necessidades operacionais diversas, como separar registros financeiros por país, departamento ou função de negócio específica.
Exemplo de caso de uso
Considere uma empresa global com negócios em múltiplas regiões:- Ledger 1: Negócios nos EUA
- Ledger 2: Negócios na UE
- Ledger 3: Negócios na APAC
Customizando Ledgers
Uma das funcionalidades de destaque dos Ledgers no Midaz é a capacidade de personalizar configurações com base em requisitos individuais. Por exemplo, o mesmo ativo pode ser configurado de forma diferente em Ledgers separados: Exemplo Para representar o Bitcoin (BTC) com configurações únicas em diferentes Ledgers:
- Ledger 1: BTC com 10 casas decimais.
- Ledger 2: BTC com 20 casas decimais.
Benefícios de usar Ledgers no Midaz
- Organização aprimorada: Mantenha registros financeiros claros e distintos, adaptados a diversos aspectos do seu negócio.
- Configurações customizadas: Ajuste configurações de ativos, moedas ou outros parâmetros por Ledger para atender necessidades locais ou departamentais.
- Escalabilidade: Adicione ou modifique Ledgers facilmente conforme sua organização cresce ou se diversifica.
- Transparência: Obtenha insights abrangentes sobre todas as atividades financeiras, com cada Ledger contribuindo para um panorama operacional coeso.
Configurações do ledger
Cada Ledger possui configurações ajustáveis que controlam como as transações são validadas. Por exemplo, você pode exigir que cada transação siga uma rota predefinida, ou que os tipos de conta correspondam às suas regras de negócio — de modo que o ledger rejeite movimentações inválidas antes de serem registradas. Essas configurações podem ser alteradas a qualquer momento pela API, sem necessidade de reiniciar o serviço ou fazer alterações no código.
Configurações disponíveis
As seguintes configurações estão disponíveis:| Configuração | Valor padrão | Descrição |
|---|---|---|
validateAccountType | false | Quando habilitada, valida que os tipos de conta em cada operação correspondam às regras definidas nas rotas de operação associadas. |
validateRoutes | false | Quando habilitada, cada transação deve incluir uma rota de transação associada. Cada operação também é validada contra as regras da sua rota de operação. |
Como as configurações afetam as transações
QuandovalidateRoutes está habilitada para um Ledger:
- Cada transação submetida a esse Ledger deve referenciar uma rota de transação válida.
- Cada operação dentro da transação é validada contra as regras da rota de operação correspondente.
- Transações que não estejam em conformidade são rejeitadas antes do registro — protegendo a integridade do seu ledger.
validateAccountType está habilitada:
- A conta de cada operação é verificada contra as regras de tipo de conta definidas na rota de operação.
- Se o tipo de conta não corresponder à regra esperada, a transação é rejeitada.
Gerenciando configurações via API
Use os endpoints de Configurações do Ledger para recuperar e atualizar essas configurações:- Recuperar Configurações do Ledger — Visualize as configurações atuais de um Ledger.
- Atualizar Configurações do Ledger — Altere uma ou mais configurações usando uma atualização parcial (deep merge).
As atualizações de configurações entram em vigor imediatamente. As alterações são aplicadas por deep merge — apenas os campos incluídos na requisição são modificados.
Gerenciando Ledgers
Você pode gerenciar seus Ledgers via API ou através do Lerian Console.
Via API
- Listar Ledgers - Visualize os detalhes de todos os Ledgers.
- Recuperar um Ledger - Obtenha detalhes de um Ledger específico.
- Criar um Ledger - Registre um novo Ledger.
- Atualizar um Ledger - Edite os detalhes de um Ledger existente.
- Excluir um Ledger - Marque um Ledger como excluído.
Quando você exclui um Ledger, ele não é permanentemente removido do sistema.Uma tag de exclusão com timestamp é adicionada, e o Ledger se torna inativo e inutilizável — ajudando a preservar dados históricos para trilhas de auditoria.