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

# Gerenciando limites

> Crie, filtre, ative e edite limites de gastos do Tracer no Lerian Console com tetos baseados em período, condições de escopo e controles de ciclo de vida de DRAFT a ACTIVE.

Use a página **Limits** para definir tetos de gastos por período e contexto de transação.

## Acessando a página Limits

***

Na barra lateral do Tracer, selecione **Limits**. A página abre como **Transaction Limits**, com o texto de apoio **What is a Limit?**.

## Filtros disponíveis

***

| Filtro | Opções |
| - | - |
| **Search** | Busca por nome e ID da conta |
| **Status** | All, Active, Inactive, Draft |
| **Period** | All Periods, Daily, Weekly, Monthly, Custom, Per Transaction |
| **Type** | All Types, PIX, Card, Wire, Crypto |

Items per page também é configurável.

## Cards de limite

***

Cada card mostra:

* Nome e tipo do limite.
* Valor máximo e ativo.
* Status do limite (`ACTIVE`, `INACTIVE`, `DRAFT`).
* Badges de escopo (quando configurados).
* Menu de ações.

## Ações do limite

***

| Ação | Comportamento |
| - | - |
| **Details** | Abre o painel lateral do limite |
| **Activate** | Move o limite para `ACTIVE` |
| **Deactivate** | Move o limite para `INACTIVE` |
| **Move to Draft** | Disponível para limites `INACTIVE`; retorna para `DRAFT` |
| **Delete** | Exclui o limite permanentemente, com confirmação |

> [!WARNING]
>
> Desative um limite `ACTIVE` antes de movê-lo de volta para `DRAFT`.

## Criando um novo limite

***

**Step 1**

Clique em **New Limit**.

**Step 2**

Preencha o painel lateral:

| Campo | Obrigatório | Notas |
| - | - | - |
| **Name** | Sim | Nome do limite |
| **Description** | Não | Contexto do limite |
| **Limit Type** | Sim | `DAILY`, `WEEKLY`, `MONTHLY`, `CUSTOM`, `PER_TRANSACTION`. `CUSTOM` revela os campos **Start Date** e **End Date**. |
| **Reset Time (UTC)** | Não | Aparece para `DAILY`, `WEEKLY` e `MONTHLY`. O horário do dia em que cada período começa. Vazio significa 00:00 UTC. Veja [Horário de reinício](https://docs.lerian.studio/pt/products/tracer/spending-limits.md#reset-time). |
| **Asset** | Sim | `BRL`, `USD`, `EUR` |
| **Max Amount** | Sim | Valor máximo numérico |
| **Active Time Window** | Não | Mostra **Start Time (UTC)** e **End Time (UTC)**. O Tracer ignora o limite para transações fora da janela. |
| **Scope** | Sim | Grupos de condições. Veja [Escopo](#scope). |

**Step 3**

Clique em **Create**.

Novos limites começam com status `DRAFT`.

## Editando um limite

***

Abra **Details** para editar. O Console permite salvar alterações apenas para limites `DRAFT` e mostra **Only draft limits can be edited** caso contrário.

Você não pode alterar `Limit Type`, `Asset` e **Reset Time (UTC)** em um limite existente.

## Escopo

***

Um limite precisa de pelo menos um grupo. **Add Group** adiciona um grupo de condições. Dentro de um grupo, **Add Condition** adiciona uma linha com um tipo de escopo e um valor. Cada tipo de escopo aparece uma vez por grupo.

| Tipo de escopo | Entrada |
| - | - |
| Account | UUID |
| Merchant | UUID |
| Segment | UUID |
| Portfolio | UUID |
| Transaction type | Seletor (`CARD`, `PIX`, `WIRE`, `CRYPTO`) |
| Sub type | Texto |

Todas as condições de um grupo devem corresponder. Um grupo correspondente basta, e o Console mostra **OR** entre os grupos. Cada grupo é salvo como um objeto de escopo.

Para todo tipo de limite, exceto `PER_TRANSACTION`, o Console avisa que o uso é contado separadamente para as contas, os portfólios, os segmentos e os merchants que cada grupo nomeia. O tipo de transação não divide a contagem.

## Relacionados

***

* [Limites de gastos](https://docs.lerian.studio/pt/products/tracer/spending-limits.md) - Guia conceitual
* [Criar limite](https://docs.lerian.studio/pt/reference/products/tracer/create-limit.md) - Referência da API
* [Atualizar limite](https://docs.lerian.studio/pt/reference/products/tracer/update-limit.md) - Referência da API
* [Consultar uso do limite](https://docs.lerian.studio/pt/reference/products/tracer/retrieve-limit-usage.md) - Referência da API


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