> ## 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 ingestão de duplicatas do Matcher

> A documentação do Matcher agora descreve chaves de duplicata configuráveis por fonte, o padrão FLAG_AS_EXCEPTION e a testabilidade das conexões de agregador.

<Badge stroke icon="calendar-days" iconType="regular">18 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção da documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Afeta

***

Equipes que importam arquivos de conciliação, configuram fontes do Matcher ou operam conexões de agregador.

## O que mudou

***

Uma fonte pode definir `duplicate_key` como uma lista ordenada de campos mapeados quando `external_id` sozinho não é suficiente. Fontes vinculadas a agregador não podem usar uma chave personalizada. A política padrão de duplicatas é `FLAG_AS_EXCEPTION`, e não `KEEP_FIRST`, e mudar uma chave de duplicata afeta apenas as importações seguintes.

O guia de conexões de agregador agora também exige que os clientes usem o campo `testable` da resposta de listagem antes de oferecer um teste de conectividade.

Esta é uma correção da documentação que se alinha ao contrato implementado. Ela não anuncia um release de runtime.

## Impacto

***

**Classificação: Ação necessária.** Os controles de importação existentes que supõem o descarte silencioso de duplicatas podem produzir ou tratar exceções de forma diferente do padrão documentado.

## O que você precisa fazer

***

<Steps>
  <Step>Revise a política de duplicatas e o tratamento de exceções de cada fonte antes da próxima importação.</Step>
  <Step>Defina `duplicate_key` apenas quando cada campo selecionado estiver mapeado; não o configure para fontes vinculadas a agregador.</Step>
  <Step>Use `testable` antes de expor um teste de conectividade de agregador no seu workflow.</Step>
</Steps>

### Prazo

Conclua a revisão antes da próxima importação de conciliação em produção.

## Recursos

***

* [Enviar arquivos para o Matcher](/pt/products/matcher/daily-reconciliation/matcher-uploading-files)
* [Gerenciar conexões de agregador](/pt/products/matcher/integrations/matcher-aggregator-connections)