Documentação

Importar produtos de venda adicional não atualiza os links de produto no Adobe Commerce na infraestrutura em nuvem

Last update: Fri Mar 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Ao importar várias configurações de venda adicional, venda cruzada ou produto relacionado usando um arquivo CSV no Adobe Commerce, o processo de importação pode ser concluído sem erros, mas não atualiza os links do produto conforme esperado. Para corrigir isso, confirme se o formato de arquivo CSV está correto.

Descrição description

Ambiente

  • Adobe Commerce na infraestrutura em nuvem
  • Adobe Commerce no local

Problema/Sintomas

  • A importação de um arquivo CSV com produtos de venda adicional, relacionados ou venda cruzada não resulta em alterações nos dados do produto.
  • O processo de importação não mostra erros, mas os relacionamentos de produto não são atualizados.

No arquivo CSV, os valores de relações de produtos devem ser separados por vírgulas. Somente uma linha é necessária por SKU, e cada tipo de relação de produto deve usar sua própria coluna.

Resolução resolution

Para garantir que o Adobe Commerce processe as atualizações de relação de produto corretamente, verifique se o arquivo CSV segue o formato padrão de exportação do produto. Use estas etapas para confirmar sua estrutura:

  1. Exporte um arquivo CSV de produto de amostra. Isso é recomendado se os dados de amostra estiverem instalados. (Para ver as etapas detalhadas, consulte Exportar dados).

    1. Ir para Sistema > Transferência De Dados > Exportar.

    2. Selecione Tipo de entidade = Produtos.

    3. Selecione Baixar Arquivo de Exemplo.

    4. Revise os cabeçalhos da coluna CSV:

      • related_skus
      • upsell_skus
      • crosssell_skus

  2. Exporte um SKU configurado manualmente se os dados de amostra não estiverem instalados. (Para obter etapas detalhadas, consulte Exportar filtros).

    1. Ir para Catálogo > Produtos.
    2. Edite o SKU do produto que deseja usar como amostra.
    3. Em Produtos Relacionados, Vendas Suplementares e Vendas Cruzadas, atribua várias SKUs.
    4. Retornar ao Sistema > Transferência De Dados > Exportar.
    5. Filtre pelo SKU e exporte o arquivo CSV.
    6. Baixe o CSV após a conclusão do processamento.

  3. Formate o CSV corretamente:

    • Use apenas uma linha por SKU no arquivo CSV.

    • Coloque vários SKUs relacionados como valores separados por vírgulas nas colunas apropriadas.

    • Verifique se os cabeçalhos de coluna correspondem exatamente aos seguintes valores:

      • related_skus
      • upsell_skus
      • crosssell_skus

    • Remova quaisquer colunas desnecessárias que não sejam necessárias para a operação de importação.

    • Salve o arquivo CSV usando a codificação UTF-8.

  4. Teste seu CSV com uma importação de um SKU primeiro para confirmar se os relacionamentos do produto foram atualizados corretamente. Após a validação, continue com o arquivo completo.

Causa

A formatação incorreta de CSV impede que o Adobe Commerce interprete as atualizações de relações de produto. Problemas comuns incluem várias linhas por SKU (veja a primeira tabela abaixo) ou ausência das skus_relacionados, skus_de_venda_cruzada e colunas de {crosssell_skus necessárias. Cada SKU pode aparecer apenas uma vez, com relações de produto separadas por vírgulas incluídas nas colunas apropriadas (consulte a segunda tabela abaixo).

sku
link_type
linked_sku
position
SKU A
venda adicional
upsell_SKU-1
1
SKU A
venda adicional
upsell_SKU-2
2
SKU B
relacionado
related_SKU-3
1
…
sku
related_skus
venda_adicional
crosssell_skus
SKU A
related_SKU-1,related_SKU-2
SKU B
upsell_SKU-1,upsell_SKU-2
SKU C
related_SKU-3,related_SKU-4
crosssell_SKU-1,crosssell_SKU-2

Leitura relacionada

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f