> ## 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 ingesta de duplicados de Matcher

> La documentación de Matcher ahora describe las claves de duplicados configurables por fuente, el valor predeterminado FLAG_AS_EXCEPTION y la capacidad de probar las conexiones de agregadores.

<Badge stroke icon="calendar-days" iconType="regular">18 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 a

***

Equipos que importan archivos de conciliación, configuran fuentes de Matcher u operan conexiones de agregadores.

## Qué cambió

***

Una fuente puede definir `duplicate_key` como una lista ordenada de campos mapeados cuando `external_id` por sí solo no es suficiente. Las fuentes vinculadas a un agregador no pueden usar una clave personalizada. La política de duplicados predeterminada es `FLAG_AS_EXCEPTION`, no `KEEP_FIRST`, y cambiar una clave de duplicados afecta solo a las importaciones posteriores.

La guía de conexiones de agregadores ahora también exige que los clientes usen el campo `testable` de la respuesta de lista antes de ofrecer una prueba de conectividad.

Esta es una corrección de documentación que se alinea con el contrato implementado. No anuncia un release de runtime.

## Impacto

***

**Clasificación: Acción requerida.** Los controles de importación existentes que suponen descartes silenciosos de duplicados pueden producir o manejar excepciones de forma distinta al valor predeterminado documentado.

## Qué debes hacer

***

<Steps>
  <Step>Revisa la política de duplicados y el manejo de excepciones de cada fuente antes de la próxima importación.</Step>
  <Step>Define `duplicate_key` solo cuando cada campo seleccionado esté mapeado; no lo configures para fuentes vinculadas a un agregador.</Step>
  <Step>Usa `testable` antes de exponer una prueba de conectividad de agregador en tu workflow.</Step>
</Steps>

### Plazo

Completa la revisión antes de la próxima importación de conciliación en producción.

## Recursos

***

* [Subir archivos a Matcher](/es/products/matcher/daily-reconciliation/matcher-uploading-files)
* [Gestionar conexiones de agregadores](/es/products/matcher/integrations/matcher-aggregator-connections)