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

# Contrato de errores e idempotencia de Matcher

> La documentación de Matcher ahora describe el sobre de errores RFC 9457 y los requisitos de reintento con idempotencia.

<Badge stroke icon="calendar-days" iconType="regular">10 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Corrección de documentación</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Acción requerida</Badge>

## Afecta

***

Equipos que integran con la API de **Matcher**, especialmente clientes que parsean errores o reintentan solicitudes con claves de idempotencia.

## Qué cambió

***

La documentación ahora indica correctamente que los errores de Matcher usan un sobre de problema RFC 9457 con `title`, `status`, `detail` y un `code` estable; los detalles de validación por campo usan un array `errors`. También documenta el formato de la clave de idempotencia (de 1 a 128 caracteres que coinciden con `^[A-Za-z0-9:_-]+$`) y el comportamiento de reintento para `MTCH-0015` y `MTCH-0018`.

Es una corrección de documentación; el comportamiento de runtime no cambió.

## Impacto

***

**Clasificación: Acción requerida.** Los clientes que parsean los campos anteriores `message` o `details`, o generan claves sin esas restricciones, deben alinearse con el contrato real.

## Qué necesitas hacer

***

<Steps>
  <Step>Actualiza el manejo de errores para leer `detail`, `status` y `errors` cuando corresponda.</Step>
  <Step>Valida las claves de idempotencia generadas contra las restricciones documentadas.</Step>
  <Step>Revisa los reintentos de `MTCH-0015` y `MTCH-0018` antes de tu próxima versión de integración.</Step>
</Steps>

### Plazo

No hay plazo impuesto por el producto. Completa la revisión antes de tu próxima versión del cliente de Matcher.

## Recursos

***

* [Lista de errores de Matcher](/es/reference/matcher/matcher-error-list)
* [Reintentos e idempotencia](/es/reference/retries-idempotency)