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

# Configurar regras e limites de gastos (API)

> Crie as regras e os limites de gastos com que o Tracer decide, ative os dois e leia o uso de um limite.

Crie as regras e os limites de gastos com que o Tracer decide e ative esses itens.

## Participantes

***

* **Sua instituição.** Seu sistema grava sua política no Tracer como regras e limites de gastos.
* **Tracer.** Guarda as regras e os limites e usa os que estão em ACTIVE em cada decisão.

## Antes de começar

***

* Seu sistema pode chamar a API do Tracer com uma credencial válida. Veja o [guia de integração do Tracer](https://docs.lerian.studio/pt/products/tracer/integration-guide.md).
* Você conhece sua política: a condição e a ação de cada regra, e o valor, o período e o escopo de cada limite. Veja [motor de regras](https://docs.lerian.studio/pt/products/tracer/rule-engine.md) e [limites de gastos](https://docs.lerian.studio/pt/products/tracer/spending-limits.md).

## Diagrama

***

![Configurar regras e limites de gastos](https://mintcdn.com/lerian-49cb71fc/WuRfbo_y9uSbzyyX/images/pt/d2/id-tracer-set-up-rules-and-limits.svg?fit=max\&auto=format\&n=WuRfbo_y9uSbzyyX\&q=85\&s=8990c04db4a662c97d10e51dfb842609)

## Passo a passo

***

| # | Origem | Destino | Mensagem | API da Lerian | O que acontece |
| - | - | - | - | - | - |
| 1 | Sua instituição | Tracer | API da Lerian | [`POST /v1/rules`](https://docs.lerian.studio/pt/reference/products/tracer/create-rule) | Crie uma regra com um nome, uma expressão CEL, uma ação e escopos opcionais. |
| 2 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 1 | O Tracer compila a expressão e devolve a regra em `DRAFT` com `201`. |
| 3 | Sua instituição | Tracer | API da Lerian | [`POST /v1/rules/{rule_id}/activate`](https://docs.lerian.studio/pt/reference/products/tracer/activate-rule) | Ative a regra. |
| 4 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 3 | O Tracer devolve a regra em `ACTIVE`. |
| 5 | Sua instituição | Tracer | API da Lerian | [`POST /v1/limits`](https://docs.lerian.studio/pt/reference/products/tracer/create-limit) | Crie um limite de gastos com um período, um valor máximo, um ativo e escopos. |
| 6 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 5 | O Tracer devolve o limite em `DRAFT` com `201`. |
| 7 | Sua instituição | Tracer | API da Lerian | [`POST /v1/limits/{limit_id}/activate`](https://docs.lerian.studio/pt/reference/products/tracer/activate-limit) | Ative o limite. |
| 8 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 7 | O Tracer devolve o limite em `ACTIVE`. |
| 9 | Sua instituição | Tracer | API da Lerian | [`GET /v1/limits/{limit_id}/usage`](https://docs.lerian.studio/pt/reference/products/tracer/retrieve-limit-usage) | Leia o uso do limite. |
| 10 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 9 | O Tracer devolve o uso atual, com os valores reservados incluídos, e o valor do limite. |

## Como saber que terminou

***

A regra e o limite mostram `ACTIVE`.

## Regras

***

* O período de um limite é `DAILY`, `WEEKLY`, `MONTHLY`, `PER_TRANSACTION` ou `CUSTOM`. Um escopo indica uma conta, um segmento, um portfólio, um estabelecimento, um esquema ou um `subType`.

## O que pode dar errado

***

| Situação | O que você vê | O que fazer |
| - | - | - |
| A expressão CEL não compila. | Uma resposta de erro ao passo 1. | Corrija a expressão e crie a regra de novo. |
| Você ativa uma regra ou um limite que excluiu. | Uma resposta de erro ao passo 3 ou 7. | Crie uma nova regra ou um novo limite. |

## Relacionados

***

* [Validar uma transação antes do ledger](https://docs.lerian.studio/pt/diagrams/lerian-products/tracer-validate-before-ledger.md)
* [Verificar transações do Midaz com o Tracer](https://docs.lerian.studio/pt/diagrams/lerian-products/tracer-check-ledger-transactions.md)
* [Motor de regras](https://docs.lerian.studio/pt/products/tracer/rule-engine.md)
* [Limites de gastos](https://docs.lerian.studio/pt/products/tracer/spending-limits.md)


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