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

# Criando uma Transação

> Registre uma nova Transação no Console para mover saldos de Ativo entre Contas no seu Ledger.

Uma Transação movimenta valor entre Contas em um Ledger. Crie uma somente após o Ativo, a conta de origem, a conta de destino e qualquer Rota Contábil necessária estarem prontos.

## Antes de começar

***

Confirme que:

* As Contas de origem e destino existem no Ledger selecionado.
* Ambas as Contas usam o Ativo selecionado para a Transação.
* Você conhece o alias de cada Conta, incluindo o prefixo `@`.
* As contas de origem permitem envio e as contas de destino permitem recebimento.
* Se **Validar Rotas** estiver habilitado, a Transação corresponde a uma Rota Contábil existente.

## Criar a Transação

***

<Steps>
  <Step>
    Na página **Transações**, clique no botão **Nova Transação**.
  </Step>

  <Step>
    O modal **Nova Transação** será aberto. Selecione o tipo de transação que deseja criar:

    * **Simples 1:1** - Transações com uma origem e um destino
    * **Complexa n:n** - Transações com mais de uma origem ou destino
  </Step>

  <Step>
    Após selecionar o tipo de transação, a página **Nova Transação** abre com um formulário passo a passo:

    <Steps>
      <Step title="Dados da Transação">
        Preencha as informações básicas da transação:

        * (Opcional) Adicione uma **Descrição** para a transação
        * (Opcional) Especifique um **Grupo de Rota Contábil** para classificação
        * Informe o **Valor** a ser transferido
        * Selecione o **Ativo** que será usado na transação
      </Step>

      <Step>
        Clique em **Próximo** para avançar para a etapa de seleção de contas.
      </Step>

      <Step title="Origem e Destino">
        Especifique as contas envolvidas:

        * Pesquise a **conta de origem** pelo alias e selecione-a
        * Pesquise a **conta de destino** pelo alias e selecione-a
        * Em transações complexas, você pode adicionar várias origens e/ou destinos

        <Warning>
          Você **precisa** usar o alias da conta para realizar transações. Certifique-se de salvá-lo ao criar a conta.

          Se esquecer o alias, você pode encontrá-lo [editando as informações da conta](/pt/lerian-console/midaz-console/editing-account-information).
        </Warning>
      </Step>

      <Step>
        Clique em **Próximo** para avançar para a etapa de operações.
      </Step>

      <Step title="Operações">
        Revise e ajuste os detalhes da operação:

        * Em transações simples (1:1), os valores são preenchidos automaticamente
        * Em transações complexas (n:n), especifique o valor para cada origem (débito) e destino (crédito)
        * Expanda cada operação para adicionar descrições e metadados opcionais

        <Note>
          Em transações complexas, a soma de todos os valores de origem deve ser igual à soma de todos os valores de destino.
        </Note>
      </Step>
    </Steps>
  </Step>

  <Step>
    Quando todas as informações estiverem corretas, clique no botão **Continuar para Revisão**.
  </Step>

  <Step>
    Uma página de revisão será exibida mostrando um resumo de todas as informações da transação:

    * Valor e Ativo da transação
    * Contas de origem e destino
    * Operações individuais de débito e crédito
    * Registros de metadados (se houver)
  </Step>

  <Step>
    Revise as informações com atenção. Se tudo estiver correto:

    * Clique em **Enviar Transação** para enviar e ver os detalhes da transação
    * Clique em **Enviar e Criar outra** para enviar e iniciar imediatamente uma nova transação
  </Step>

  <Step>
    Em caso de sucesso, você será redirecionado para a página de detalhes da transação mostrando o resumo, os dados e o status.
  </Step>
</Steps>

## Guia de campos

***

**Dados da Transação**

| Campo                  | O que informar                                                                                          | Exemplo                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------ |
| Descrição da transação | Descrição de negócio opcional da movimentação.                                                          | `Customer payment to merchant` |
| Grupo de Rota Contábil | Classificação opcional de rota quando sua configuração usa validação ou agrupamento de rotas.           | `Pix Transfer Group`           |
| Rota de Transação      | Selecione a Rota de Transação associada à transação.                                                    | `Pix Transfer Route`           |
| Ativo                  | Ativo usado pela Transação. Deve corresponder às Contas selecionadas.                                   | `BRL`                          |
| Valor                  | Valor total a movimentar. Em transações complexas, os totais de origem devem ser iguais aos de destino. | `100.00`                       |

**Origem/Destino**

| Campo   | O que informar                                           | Exemplo         |
| ------- | -------------------------------------------------------- | --------------- |
| Origem  | Alias da conta que será debitada. Inclua o prefixo `@`.  | `@customer_123` |
| Destino | Alias da conta que será creditada. Inclua o prefixo `@`. | `@merchant_456` |

**Operações**

| Campo                 | O que informar                                                | Exemplo                               |
| --------------------- | ------------------------------------------------------------- | ------------------------------------- |
| Descrição da operação | Descrição opcional para a operação.                           | `Debit for the source account`        |
| Plano de Contas       | Nome opcional do Plano de Contas ao qual a operação pertence. | `Pix debit - source`                  |
| Rota de Operação      | Rota de operação opcional para esta parte da transação.       | `Checking account validation for Pix` |
| Chave de Metadados    | Nome opcional de campo para classificação ou integração.      | `externalReference`                   |
| Valor de Metadados    | Valor para a chave de metadados.                              | `order_98765`                         |

## Tipos de transação explicados

***

### Transação Simples (1:1)

Use para transferências diretas entre duas contas:

* Uma conta de origem (débito)
* Uma conta de destino (crédito)
* Mesmo valor debitado e creditado

**Exemplo**: Transferir \$100 do Customer A para o Merchant B.

### Transação Complexa (n:n)

Use para transações que envolvem múltiplas partes:

* Várias contas de origem (débitos) e/ou várias contas de destino (créditos)
* Os valores podem ser distribuídos entre contas
* O total de débitos deve ser igual ao total de créditos

**Exemplos**:

* Pagamento com taxas:
  * O cliente paga \$103
  * O estabelecimento recebe \$100
  * A conta de taxas recebe \$3
* Pagamento consolidado: Vários clientes financiam um único pagamento a fornecedor

<Tip>
  Os campos na aba Metadados são abertos. Não há chaves ou valores pré-definidos. Use nomes de chaves consistentes em toda a sua Organização, como `externalReference`, `orderId` ou `channel`, para vincular as Transações aos sistemas de origem para reconciliação e auditoria.
</Tip>

## O que fazer em seguida

***

Após enviar a Transação, revise a página de detalhes e confirme o status, a operação de origem, a operação de destino e os saldos das contas.

<CardGroup cols={2}>
  <Card title="Criar uma Transação usando JSON" icon="code" href="/pt/reference/midaz/create-a-transaction-using-json">
    Crie uma Transação programaticamente com o endpoint JSON.
  </Card>

  <Card title="Recuperar uma Transação" icon="file-search" href="/pt/reference/midaz/retrieve-a-transaction">
    Inspecione o status e as operações da Transação pela API.
  </Card>
</CardGroup>