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

18 de agosto de 2026Correção da documentaçãoAção necessária

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

***

**Step 1**

Revise a política de duplicatas e o tratamento de exceções de cada fonte antes da próxima importação.

**Step 2**

Defina `duplicate_key` apenas quando cada campo selecionado estiver mapeado; não o configure para fontes vinculadas a agregador.

**Step 3**

Use `testable` antes de expor um teste de conectividade de agregador no seu workflow.

### Prazo

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

## Recursos

***

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


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