> ## 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 spending limit

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

<Badge stroke icon="calendar-days" iconType="regular">14 de maio de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="green" size="lg" stroke icon="circle-check" iconType="regular">Sem migração necessária</Badge>

## Afeta

***

Clientes e times que leem a documentação pública do Tracer para configurar spending limits ou entender respostas de validação.

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

<Note>
  O portal público de documentação é a referência voltada ao cliente. Arquivos de origem do repositório não devem ser tratados como artefatos de integração ou especificações de API baixadas para uso em cliente.
</Note>

## O que mudou

***

### Períodos de spending limit

A documentação pública agora exibe o conjunto completo de períodos de spending limit suportados:

| Valor             | Descrição                                        |
| ----------------- | ------------------------------------------------ |
| `PER_TRANSACTION` | Aplica-se a cada transação individual            |
| `DAILY`           | Aplica-se em um período diário                   |
| `WEEKLY`          | Aplica-se em um período semanal                  |
| `MONTHLY`         | Aplica-se em um período mensal                   |
| `CUSTOM`          | Aplica-se em 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` | Horário do dia em que o limite começa a se aplicar, no formato `HH:mm` |
| `activeTimeEnd`   | Horário do dia em que o limite para de se aplicar, no formato `HH:mm`  |
| `customStartDate` | Data de início para um limite de período personalizado                 |
| `customEndDate`   | Data de fim para um limite de período personalizado                    |

<Note>
  Para limites `CUSTOM`, forneça tanto `customStartDate` quanto `customEndDate`.
</Note>

### Valor do limite

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

Para spending limits, 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"
}
```

### Timing de resposta de validação

Os campos de timing de resposta de validação agora permitem 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 para limites do Tracer.

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

## O que você precisa fazer

***

<Steps>
  <Step>
    Use um dos períodos de limite documentados: `PER_TRANSACTION`, `DAILY`, `WEEKLY`, `MONTHLY` ou `CUSTOM`.
  </Step>

  <Step>
    Envie `maxAmount` como uma string decimal, como `"1000.00"`.
  </Step>

  <Step>
    Use `activeTimeStart` e `activeTimeEnd` no formato `HH:mm` quando um limite se aplica somente em parte do dia.
  </Step>

  <Step>
    Inclua tanto `customStartDate` quanto `customEndDate` para limites `CUSTOM`.
  </Step>

  <Step>
    Mantenha os valores de transação e contadores de uso na menor unidade de moeda onde a documentação diz que esses campos são valores inteiros.
  </Step>

  <Step>
    Não trate arquivos de origem do repositório como artefatos de integração de cliente. Use o portal de documentação como a referência voltada ao cliente.
  </Step>
</Steps>

### Prazo

Nenhum.

### Por quê

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

## Recursos

***

* [Create limit](/pt/reference/tracer/create-limit)
* [Spending limits guide](/pt/tracer/spending-limits)
* [Tracer API quick start](/pt/reference/tracer/tracer-api-quick-start)