0002 — Correlação de produto por EAN

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-06-25 · Decidido em: 2026-06-25

Contexto

O payload envia ean e codigo_erp (código X-Adm). Era preciso saber qual deles o parceiro usa para localizar o produto na base dele — e, portanto, dizer se foi atualizado ou não encontrado.

Decisão

A correlação é por ean. O codigo_erp vai no payload apenas como referência/rastreio e não participa do match.

Consequências

• Verificado contra a API real (2026-06-25): um item só com codigo_erp (sem ean) retorna o erro sem_ean_nem_sku; e a lista nao_encontrados devolve EANs, não códigos X-Adm.
• O parceiro também aceita o sku interno dele como chave, mas o X-Adm não possui esse sku — logo a chave prática é o EAN.
• Requisito de dado: todo produto a sincronizar precisa de EAN válido no X-Adm; produto sem EAN não casa (cai em erro / não-encontrado).
• Sem ambiguidade (confirmado com o parceiro): no e-commerce o EAN é chave de variante (cada variante — cor/tamanho — tem seu próprio EAN), então 1 EAN = 1 variante; o campo ambiguos da resposta tende a ficar vazio.