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

# Matcher: referência de API alinhada com a v2.1.1

> A referência pública da API do Matcher agora reflete o release v2.1.1, incluindo rotas de fee-rule, nomes de schema, campos e referências de erro.

<Badge stroke icon="calendar-days" iconType="regular">8 de maio de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisão recomendada</Badge>

## Afeta

***

Times que usam a documentação pública do Matcher para implementar, revisar ou manter integrações.

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

***

### Rotas de fee-rule

A referência pública da API agora exibe as rotas reais de fee-rule do Matcher.

Cinco endpoints de fee-rule eram anteriormente documentados sob um prefixo fantasma `/v1/config/...`. O portal de documentação agora aponta para as rotas funcionais `/v1/contexts/...` e `/v1/fee-rules/...`.

### Nomes de schema e campos

A referência agora segue as DTOs em Go e as tags JSON usadas pelo binário `v2.1.1` lançado.

Limpezas principais:

* 36 nomes de campos movidos de `snake_case` para `camelCase`.
* 9 schemas foram renomeados para nomes canônicos de Go.
* Schemas `Input` foram renomeados para `Request` onde isso corresponde à convenção de Go.
* Links `$ref` e arrays `required` foram atualizados.

### Wrappers fantasmas removidos

A documentação não exibe mais wrappers ou schemas duplicados que a API não retorna.

Por exemplo, `AdjustmentResponse` agora exibe os campos inline em vez de um wrapper `adjustment` inexistente. `CloneContextResponse` agora aponta para o schema canônico de contexto de reconciliação e usa `feeRulesCloned`.

### Campos e schemas faltantes

Campos e schemas presentes nas DTOs de Go foram adicionados ao portal de documentação, incluindo campos de audit log, campos de extraction request bridge, campos de variance report e schemas auxiliares de export.

## Impacto

***

Esta é uma atualização de documentação. Ela reduz a divergência entre a referência pública e a API do Matcher lançada.

Se sua integração já funciona, nenhuma migração é necessária apenas com base nesta release note. Se você usa a documentação para gerar exemplos, revisar rotas ou verificar nomes de campo, use o portal de documentação atualizado.

## O que você precisa fazer

***

<Steps>
  <Step>
    Revise as rotas de fee-rule do Matcher antes da sua próxima alteração de integração.
  </Step>

  <Step>
    Use os nomes atualizados de campos e schemas ao ler a documentação pública.
  </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 referência anterior misturava comportamento real do Matcher com rotas obsoletas, schemas duplicados e campos que não correspondiam às DTOs lançadas. A nova versão é mais clara e mais difícil de interpretar errado.

## Recursos

***

* [List fee rules](/pt/reference/matcher/list-fee-rules)
* [Fee rules guide](/pt/matcher/configuration/matcher-fee-rules)
* [Matcher error list](/pt/reference/matcher/matcher-error-list)