Skip to main content
18 de agosto de 2026 Correção da documentação Açã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


1
Revise a política de duplicatas e o tratamento de exceções de cada fonte antes da próxima importação.
2
Defina duplicate_key apenas quando cada campo selecionado estiver mapeado; não o configure para fontes vinculadas a agregador.
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