> ## 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 da 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 regras de tarifas, nomes de schemas, campos e referências de erro.

8 de maio de 2026Atualização da documentaçãoRevisão recomendada

## Afeta

***

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

***

### Rotas de regras de tarifas

A referência pública da API agora mostra as rotas reais de regras de tarifas do Matcher.

Cinco endpoints de regras de tarifas estavam 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 schemas e de campos

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

Principais limpezas:

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

### Wrappers fantasmas removidos

A documentação não mostra mais wrappers nem schemas duplicados que a API não retorna.

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

### Campos e schemas ausentes

Campos e schemas presentes nos DTOs em Go foram adicionados ao portal de documentação, incluindo campos de log de auditoria, campos de ponte da requisição de extração, campos do relatório de variação e schemas auxiliares de exportação.

## Impacto

***

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

Se sua integração já funciona, nenhuma migração é necessária apenas por esta nota de release. Se você usa a documentação para gerar exemplos, revisar rotas ou conferir nomes de campos, use o portal de documentação atualizado.

## O que você precisa fazer

***

**Step 1**

Revise as rotas de regras de tarifas do Matcher antes da sua próxima mudança de integração.

**Step 2**

Use os nomes atualizados de campos e schemas ao ler a documentação pública.

**Step 3**

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 referência anterior misturava o comportamento real do Matcher com rotas obsoletas, schemas duplicados e campos que não correspondiam aos DTOs publicados. A nova versão é mais clara e mais difícil de ler errado.

## Recursos

***

* [Listar regras de tarifas](https://docs.lerian.studio/pt/reference/products/matcher/list-fee-rules.md)
* [Guia de regras de tarifas](https://docs.lerian.studio/pt/products/matcher/configuration/matcher-fee-rules.md)
* [Lista de erros do Matcher](https://docs.lerian.studio/pt/reference/products/matcher/matcher-error-list.md)


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