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

> Consulte os campos do Tracer usados na validação de transações em tempo real: payloads de requisição, regras, limites de gastos e respostas de decisão retornadas aos chamadores.

Esta página cobre os campos específicos do Tracer, o motor de validação de transações em tempo real da Lerian. Esses campos aparecem em requisições de validação, regras, limites de gastos e respostas de decisão.

## 1. Requisições de validação

***

| Campo                | Descrição                                                                                           | Usado em |
| -------------------- | --------------------------------------------------------------------------------------------------- | -------- |
| requestId            | ID único gerado pelo cliente para idempotência e correlação de auditoria                            | Tracer   |
| transactionType      | Tipo de transação: CARD, WIRE, PIX ou CRYPTO                                                        | Tracer   |
| subType              | Subtipo da transação para contexto adicional (por exemplo, débito, crédito)                         | Tracer   |
| amount               | Valor da transação como string decimal, por exemplo `"100.00"` (deve ser positivo)                  | Tracer   |
| asset                | Código de ativo ISO 4217 de três letras maiúsculas usado pela transação, por exemplo `BRL` ou `USD` | Tracer   |
| transactionTimestamp | Quando a transação ocorreu (formato RFC 3339 com fuso horário)                                      | Tracer   |

## 2. Respostas de validação

***

| Campo            | Descrição                                                             | Usado em |
| ---------------- | --------------------------------------------------------------------- | -------- |
| validationId     | Identificador único gerado pelo servidor para o registro de validação | Tracer   |
| decision         | Decisão da validação: ALLOW, DENY ou REVIEW                           | Tracer   |
| reason           | Motivo da decisão, em texto legível                                   | Tracer   |
| matchedRuleIds   | IDs das regras que corresponderam e acionaram a decisão               | Tracer   |
| evaluatedRuleIds | IDs de todas as regras avaliadas                                      | Tracer   |
| processingTimeMs | Tempo de processamento em milissegundos                               | Tracer   |
| totalRulesLoaded | Número total de regras carregadas para avaliação                      | Tracer   |
| truncated        | Indica se a resposta foi truncada devido a limites de tamanho         | Tracer   |

## 3. Regras

***

| Campo         | Descrição                                                                               | Usado em |
| ------------- | --------------------------------------------------------------------------------------- | -------- |
| ruleId        | Identificador único da regra                                                            | Tracer   |
| name          | Nome da regra em texto legível (único dentro do seu contexto, máximo de 255 caracteres) | Tracer   |
| description   | Explicação do propósito e da lógica da regra (máximo de 1000 caracteres)                | Tracer   |
| expression    | Expressão CEL que deve ser avaliada como booleano (máximo de 5000 caracteres)           | Tracer   |
| action        | Ação tomada quando a expressão é avaliada como verdadeira: ALLOW, DENY ou REVIEW        | Tracer   |
| scopes        | Array de escopos que determinam a quais transações essa regra se aplica                 | Tracer   |
| status        | Status do ciclo de vida da regra: DRAFT, ACTIVE, INACTIVE ou DELETED                    | Tracer   |
| activatedAt   | Quando a regra foi ativada pela última vez (null se nunca foi ativada)                  | Tracer   |
| deactivatedAt | Quando a regra foi desativada pela última vez (null se nunca foi desativada)            | Tracer   |

## 4. Limites de gastos

***

| Campo           | Descrição                                                                                    | Usado em |
| --------------- | -------------------------------------------------------------------------------------------- | -------- |
| limitId         | Identificador único do limite                                                                | Tracer   |
| name            | Nome do limite em texto legível (único globalmente, máximo de 255 caracteres)                | Tracer   |
| description     | Explicação do propósito e uso do limite (máximo de 1000 caracteres)                          | Tracer   |
| limitType       | Tipo de limite: DAILY, WEEKLY, MONTHLY, CUSTOM ou PER\_TRANSACTION (imutável após a criação) | Tracer   |
| maxAmount       | Valor decimal máximo como string, por exemplo `"1000.00"`                                    | Tracer   |
| asset           | Código de ativo ISO 4217 de três letras maiúsculas do limite (imutável após a criação)       | Tracer   |
| scopes          | Array de escopos que determinam a quais transações esse limite se aplica                     | Tracer   |
| status          | Status do ciclo de vida do limite: DRAFT, ACTIVE, INACTIVE ou DELETED                        | Tracer   |
| activeTimeStart | Início da janela ativa diária no formato `HH:mm`                                             | Tracer   |
| activeTimeEnd   | Fim da janela ativa diária no formato `HH:mm`                                                | Tracer   |
| customStartDate | Data-hora de início para limites CUSTOM                                                      | Tracer   |
| customEndDate   | Data-hora de término para limites CUSTOM                                                     | Tracer   |

## 5. Uso do limite

***

| Campo           | Descrição                                                                          | Usado em |
| --------------- | ---------------------------------------------------------------------------------- | -------- |
| limitAmount     | Valor total do limite como string decimal                                          | Tracer   |
| currentUsage    | Uso projetado após aplicar a transação, como string decimal                        | Tracer   |
| exceeded        | Indica se o limite foi excedido durante a validação                                | Tracer   |
| period          | Tipo de período do limite: DAILY, WEEKLY, MONTHLY, CUSTOM ou PER\_TRANSACTION      | Tracer   |
| scope           | Descrição do escopo em texto legível (por exemplo, "account:uuid", "segment:uuid") | Tracer   |
| attemptedAmount | Valor da transação sendo validada, como string decimal                             | Tracer   |

## 6. Escopos e direcionamento

***

| Campo           | Descrição                                                                    | Usado em |
| --------------- | ---------------------------------------------------------------------------- | -------- |
| accountId       | Identificador de conta para direcionamento de escopo                         | Tracer   |
| segmentId       | Identificador de segmento para direcionamento de escopo                      | Tracer   |
| portfolioId     | Identificador de portfólio para direcionamento de escopo                     | Tracer   |
| merchantId      | Identificador de estabelecimento para direcionamento de escopo               | Tracer   |
| transactionType | Filtro de tipo de transação: CARD, WIRE, PIX ou CRYPTO                       | Tracer   |
| category        | Código de Categoria do Estabelecimento (MCC de 4 dígitos conforme ISO 18245) | Tracer   |
| country         | País do estabelecimento (ISO 3166-1 alpha-2, 2 letras maiúsculas)            | Tracer   |