Wake: relacionamento de variações de produto por parentId

A integração com a Wake permite relacionar as variações de um produto (por exemplo, cor) de duas formas: pelo produtoId (comportamento padrão) ou pelo parentId, campo gerado automaticamente pela Wake em todo produto. Este artigo descreve o parâmetro que ativa esse relacionamento por parentId, e como ele se reflete na importação por SKU, na importação em massa e na atualização (polling) de produtos.

 

Neste artigo:

• Pré-requisitos
• O que é o parentId e para que serve o parâmetro
• Ativação do parâmetro
• Importação por SKU
• Importação em massa
• Atualização de produtos (polling)
• Regras importantes
• Dúvidas comuns

 

Pré-requisitos

• Acesso à tela de configuração da integração com a Wake no ANYMARKET.
• Produtos já cadastrados na Wake, com o campo parentId preenchido conforme o agrupamento desejado entre os produtoId (o parentId é gerado automaticamente pela Wake em todo produto; não existe produto sem parentId).

O que é o parentId e para que serve o parâmetro

Alguns sellers cadastram cada variação de apresentação (geralmente cor) como um produto distinto na Wake, ou seja, com um produtoId diferente para cada cor. Para indicar que esses produtos fazem parte do mesmo item, a Wake disponibiliza o campo parentId, que pode ser compartilhado entre os produtoId relacionados.

Por padrão, o ANYMARKET relaciona as variações de um produto exclusivamente pelo produtoId, independentemente do valor do parentId. Isso significa que, para esses sellers, cada cor é importada como um produto separado, o que impede vincular o produto a um anúncio único no marketplace e pode gerar bloqueio de operações (pausa de anúncios).

O parâmetro Relacionar variações por parentId permite que o seller ative, na integração com a Wake, o relacionamento de variações priorizando o parentId em vez do produtoId, sem prejudicar produtos cujo parentId não é compartilhado com nenhum outro produto — nesse caso, eles continuam sendo tratados individualmente por produtoId.

Ativação do parâmetro

Para ativar o relacionamento por parentId, o seller deve:

1. Acessar a tela de configuração da integração com a Wake no ANYMARKET.
2. Ativar a opção Relacionar variações por parentId (desativada por padrão).
3. Salvar a configuração.

Uma vez salvo, o valor passa a ser considerado pelos fluxos de importação por SKU e de importação em massa.

⚠️ Atenção: quando o parâmetro está desativado (comportamento padrão), o ANYMARKET continua relacionando as variações pelo produtoId, independentemente do valor do parentId retornado pela Wake.

Importação por SKU

Na importação por SKU, o ANYMARKET consulta os produtos relacionados ao SKU pesquisado na Wake. Com o parâmetro ativado:

• Todos os produtoId retornados que compartilham o mesmo parentId são agrupados em um único produto no ANYMARKET.
• O produtoId principal do agrupamento é, por padrão, o primeiro produtoId retornado. Caso algum dos produtoId do agrupamento já exista no ANYMARKET, esse passa a ser o principal, independentemente da ordem de retorno da Wake.
• Produtos cujo parentId não é compartilhado com nenhum outro produto continuam sendo tratados individualmente por produtoId.
• SKUs novos do agrupamento — sejam de um produto novo ou de um produtoId já existente individualmente no ANYMARKET — são sempre incluídos no produto do produtoId principal, sem bloquear a importação.
• Se os produtos agrupados não possuírem nenhum atributo de variação (visual ou não-visual) entre eles, o agrupamento por parentId é ignorado: cada produto é importado normalmente como produto simples, respeitando a estrutura cadastrada pelo seller, sem gerar erro no relatório de importação.

Importação em massa

Na importação em massa, o ANYMARKET consulta a listagem paginada de produtos do seller na Wake, acumulando a lista completa antes de processar a importação. Com o parâmetro ativado, o mesmo critério da importação por SKU se aplica:

• Produtos com produtoId diferentes que compartilham o mesmo parentId são importados como um único produto.
• O produtoId principal é o primeiro retornado na paginação, exceto se algum produtoId do agrupamento já existir no ANYMARKET — nesse caso, esse passa a ser o principal.
• Produtos cujo parentId não é compartilhado com outros continuam sendo importados individualmente.
• Agrupamentos sem nenhum atributo de variação real são importados normalmente como produto simples, sem gerar erro no relatório.

Com o parâmetro desativado, a importação em massa mantém o agrupamento por produtoId, independentemente do parentId.

Atualização de produtos (polling)

O fluxo de atualização de produtos (polling) processa individualmente cada produto alterado na Wake. Para produtos que já foram importados agrupados por parentId, a atualização considera somente as informações do produtoId principal definido na importação:

• Alterações de informações não-variáveis (nome, marca, categoria etc.) vindas de um produtoId secundário do agrupamento são ignoradas; o estoque e o SKU dessa variante continuam sendo atualizados normalmente.
• Alterações vindas do produtoId principal são aplicadas normalmente ao produto correspondente.
• Produtos importados por produtoId simples continuam sendo atualizados normalmente por produtoId.

Regras importantes

Uma vez importado por parentId, sempre por parentId.
Um produto importado agrupado por parentId continua sendo atualizado respeitando apenas o produtoId principal definido na importação, mesmo que o parâmetro seja desativado depois.

Alterações de parentId feitas na Wake após a importação não são refletidas no ANYMARKET.
Se o seller alterar, reorganizar ou desvincular o parentId de um produto já importado, essa mudança não é lida nem aplicada pela rotina de atualização — o produto continua agrupado exatamente como foi importado.

Produto importado como produtoId simples não é reestruturado automaticamente.
Se, depois da importação, outro produto passar a compartilhar o mesmo parentId (ou o parâmetro for ativado depois), a rotina de atualização não reagrupa esse produto sozinha; o seller precisa rodar a importação manualmente.

Ausência de variação real.
Quando os produtos agrupados por parentId não possuem nenhum atributo de variação (visual ou não-visual) entre eles, o ANYMARKET não agrupa esses produtos por parentId — cada um é importado normalmente como produto simples, sem gerar erro no relatório de importação.

Dúvidas comuns

O parentId precisa ser cadastrado manualmente para o produto ser importado?
Não. O parentId é gerado automaticamente pela Wake na criação de todo produto — ele sempre existe. O que determina o agrupamento é se esse valor foi compartilhado entre produtoId diferentes e se o parâmetro está ativado.

Ativar o parâmetro afeta produtos que já foram importados anteriormente?
Produtos já importados por produtoId simples continuam sendo atualizados dessa forma; a ativação do parâmetro não reestrutura esses produtos automaticamente. Para que passem a ser agrupados por parentId, é necessário rodar uma nova importação.

Se eu desativar o parâmetro depois, os produtos que já foram agrupados por parentId voltam a ser separados?
Não. Produtos já importados agrupados por parentId continuam sendo atualizados respeitando apenas o produtoId principal, independentemente do estado atual do parâmetro.

Como o ANYMARKET decide qual produtoId é o principal do agrupamento?
Por padrão, é o primeiro produtoId retornado pela Wake (na consulta de relacionados, na importação por SKU, ou na paginação, na importação em massa). Se algum dos produtoId do agrupamento já existir individualmente no ANYMARKET, esse passa a ter prioridade e se torna o principal.

O que acontece se eu desvincular um produto do agrupamento diretamente na Wake, depois de já ter importado?
O ANYMARKET não reflete essa mudança de estrutura; o produto permanece agrupado como foi importado. A correção da estrutura, nesse caso, é de responsabilidade do seller, por meio de uma nova importação.

Meus produtos não têm variação de cor/tamanho entre eles, mas compartilham parentId. O que acontece?
Se não houver nenhum atributo de variação real (visual ou não-visual) entre os produtos do agrupamento, o ANYMARKET não os agrupa por parentId — cada um é importado normalmente como produto simples, sem gerar erro no relatório.