> ## 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: referencia API alineada con v2.1.1

> La referencia API pública de Matcher ahora refleja la versión v2.1.1, incluyendo rutas de fee-rule, nombres de esquemas, campos y referencias de errores.

<Badge stroke icon="calendar-days" iconType="regular">8 de mayo de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de documentación</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisión recomendada</Badge>

## Afecta

***

Equipos que usan la documentación pública de Matcher para implementar, revisar o mantener integraciones.

Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento del API en tiempo de ejecución.

<Note>
  El portal de documentación pública es la referencia orientada al cliente. Los archivos fuente del repositorio no deben tratarse como artefactos de integración ni como especificaciones API descargadas para uso de clientes.
</Note>

## Qué cambió

***

### Rutas de fee-rule

La referencia API pública ahora muestra las rutas reales de fee-rule de Matcher.

Cinco endpoints de fee-rule estaban documentados previamente bajo un prefijo fantasma `/v1/config/...`. El portal de documentación ahora apunta a las rutas funcionales `/v1/contexts/...` y `/v1/fee-rules/...`.

### Nombres de esquemas y campos

La referencia ahora sigue los DTOs de Go y los tags JSON usados por el binario `v2.1.1` lanzado.

Limpieza clave:

* 36 nombres de campos pasaron de `snake_case` a `camelCase`.
* 9 esquemas fueron renombrados a nombres canónicos de Go.
* Los esquemas `Input` se renombraron a `Request` donde eso coincide con la convención de Go.
* Los enlaces `$ref` y los arrays `required` se actualizaron.

### Wrappers fantasma eliminados

La documentación ya no muestra wrappers ni esquemas duplicados que la API no devuelve.

Por ejemplo, `AdjustmentResponse` ahora muestra los campos en línea en lugar de un wrapper inexistente `adjustment`. `CloneContextResponse` ahora apunta al esquema canónico de contexto de reconciliación y usa `feeRulesCloned`.

### Campos y esquemas faltantes

Los campos y esquemas presentes en los DTOs de Go se agregaron al portal de documentación, incluyendo campos de logs de auditoría, campos de bridge de solicitud de extracción, campos de informes de varianza y esquemas auxiliares de exportación.

## Impacto

***

Esta es una actualización de documentación. Reduce el desfase entre la referencia pública y la API de Matcher lanzada.

Si tu integración ya funciona, no se requiere migración solo por esta nota de versión. Si usas la documentación para generar ejemplos, revisar rutas o comprobar nombres de campos, usa el portal de documentación actualizado.

## Qué necesitas hacer

***

<Steps>
  <Step>
    Revisa las rutas de fee-rule de Matcher antes de tu próximo cambio de integración.
  </Step>

  <Step>
    Usa los nombres de campo y esquema actualizados al leer la documentación pública.
  </Step>

  <Step>
    No trates los archivos fuente del repositorio como artefactos de integración del cliente. Usa el portal de documentación como referencia orientada al cliente.
  </Step>
</Steps>

### Plazo

Ninguno.

### Por qué

La referencia anterior mezclaba el comportamiento real de Matcher con rutas obsoletas, esquemas duplicados y campos que no coincidían con los DTOs lanzados. La nueva versión es más clara y más difícil de malinterpretar.

## Recursos

***

* [List fee rules](/es/reference/matcher/list-fee-rules)
* [Guía de fee rules](/es/matcher/configuration/matcher-fee-rules)
* [Lista de errores de Matcher](/es/reference/matcher/matcher-error-list)