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

# Tracer: atualização da documentação de limites de gastos

> A documentação pública do Tracer agora explica o modelo completo de limite de gastos, incluindo períodos, campos de agendamento, formato do valor e tempo de validação.

14 de maio de 2026Atualização da documentaçãoNenhuma migração necessária

## Afeta

***

Clientes e equipes que leem a documentação pública do Tracer para configurar limites de gastos ou entender as respostas de validação.

Esta atualização se aplica ao portal público de documentação. Ela não muda o comportamento da API em runtime.

> [!NOTE]
>
> O portal público de documentação é a referência voltada ao cliente. Recomenda-se que os arquivos-fonte do repositório não sejam tratados como artefatos de integração nem como especificações de API baixadas para uso do cliente.

## O que mudou

***

### Períodos de limite de gastos

A documentação pública agora mostra o conjunto completo de períodos de limite de gastos aceitos:

| Valor | Descrição |
| - | - |
| `PER_TRANSACTION` | Aplica-se a cada transação individual |
| `DAILY` | Aplica-se sobre um período diário |
| `WEEKLY` | Aplica-se sobre um período semanal |
| `MONTHLY` | Aplica-se sobre um período mensal |
| `CUSTOM` | Aplica-se sobre um intervalo de datas personalizado |

### Campos de agendamento

A documentação agora explica os campos opcionais de agendamento usados para controlar quando um limite se aplica:

| Campo | Descrição |
| - | - |
| `activeTimeStart` | Hora do dia em que o limite começa a valer, no formato `HH:mm` |
| `activeTimeEnd` | Hora do dia em que o limite deixa de valer, no formato `HH:mm` |
| `customStartDate` | Data de início de um limite de período personalizado |
| `customEndDate` | Data de fim de um limite de período personalizado |

> [!NOTE]
>
> Para limites `CUSTOM`, informe tanto `customStartDate` quanto `customEndDate`.

### Valor do limite

A documentação agora deixa explícito o formato do valor.

Para limites de gastos, envie `maxAmount` como uma string decimal:

**Antes**

```json theme={null}
{
  "limitType": "DAILY",
  "maxAmount": 100000
}
```

**Depois**

```json theme={null}
{
  "limitType": "DAILY",
  "maxAmount": "1000.00"
}
```

Para um limite de período personalizado:

```json theme={null}
{
  "limitType": "CUSTOM",
  "maxAmount": "5000.00",
  "customStartDate": "2026-06-01T00:00:00Z",
  "customEndDate": "2026-06-30T23:59:59Z"
}
```

### Tempo de resposta da validação

Os campos de tempo na resposta de validação agora aceitam valores decimais porque o tempo de processamento pode incluir frações de milissegundo.

## Impacto

***

Esta é uma atualização de documentação. Ela esclarece o portal público de documentação sobre os limites do Tracer.

Nenhuma migração é necessária se sua integração atual com o Tracer já funciona. Use a documentação atualizada ao configurar novos limites ou revisar os existentes.

## O que você precisa fazer

***

**Step 1**

Use um dos períodos de limite documentados: `PER_TRANSACTION`, `DAILY`, `WEEKLY`, `MONTHLY` ou `CUSTOM`.

**Step 2**

Envie `maxAmount` como uma string decimal, como `"1000.00"`.

**Step 3**

Use `activeTimeStart` e `activeTimeEnd` no formato `HH:mm` quando um limite se aplica apenas durante parte do dia.

**Step 4**

Inclua tanto `customStartDate` quanto `customEndDate` para limites `CUSTOM`.

**Step 5**

Mantenha os valores de transação e os contadores de uso na menor unidade monetária onde a documentação diz que esses campos são valores inteiros.

**Step 6**

Não trate os arquivos-fonte do repositório como artefatos de integração do cliente. Use o portal de documentação como a referência voltada ao cliente.

### Prazo

Nenhum.

### Por quê

A documentação anterior não mostrava o modelo completo de limites do Tracer. Esta atualização evita que os leitores implementem limites a partir de exemplos incompletos.

## Recursos

***

* [Criar limite](https://docs.lerian.studio/pt/reference/products/tracer/create-limit.md)
* [Guia de limites de gastos](https://docs.lerian.studio/pt/products/tracer/spending-limits.md)
* [Início rápido da API do Tracer](https://docs.lerian.studio/pt/reference/products/tracer/tracer-api-quick-start.md)


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