O que o mapeamento em massa faz
O Alva Digital Downloads vincula arquivos que já estão no armazenamento a produtos Shopify a partir de um único CSV. Abra a página Products e clique na ação secundária Bulk Product-File Mapping. A tela está disponível apenas em planos pagos — fica desabilitada no plano Free.
O que o CSV precisa ter
O parser lê a linha de cabeçalho e corresponde as colunas pelo nome, sem diferenciar maiúsculas de minúsculas. Ele requer uma coluna PRODUCT_ID e pelo menos uma coluna FILE_1. As colunas de variante são opcionais. A ordem das colunas não importa, e você pode adicionar quantas colunas FILE_ e VARIANT_ precisar.
- PRODUCT_ID — o ID do produto Shopify. Use o número puro (
1234567890) ou a forma completagid://shopify/Product/1234567890. - FILE_1, FILE_2, … — cada uma contém o título de um arquivo no armazenamento do Alva, opcionalmente prefixado com
@(o@é removido). Toda linha precisa de pelo menos um arquivo. - VARIANT_1, VARIANT_2, … — IDs de variante do Shopify opcionais. Deixe-as de fora para mapear para a variante padrão em todo o produto.
Como mapear arquivos em massa
1. Abra a tela de mapeamento em massa
Na página Products, clique em Bulk Product-File Mapping. A página abre com um card de instruções — incluindo um CSV de exemplo já preenchido — e um uploader de arrastar e soltar. Não há template para download; copie o layout do exemplo para a sua planilha.
2. Monte e salve o CSV
Coloque um produto por linha. Preencha PRODUCT_ID com o ID do Shopify e cada coluna FILE_ com um título de arquivo. Uma linha simples como 123456789,,,,@User Manual,, mapeia um arquivo para a variante padrão de um produto. Salve a planilha como .csv.
A tabela de pré-visualização do Bulk Product-File Mapping após um envio de CSV. Mostre as quatro colunas — File, Product, Variants, Status — com 3 a 4 linhas de exemplo: selos verdes de "success", uma linha vermelha de "error" e um produto com um selo "Existing". Use nomes de produto fictícios, sem dados reais de cliente.
3. Envie e revise a pré-visualização
Solte o arquivo no uploader. O Alva confere cada título de arquivo no armazenamento e valida os IDs de produto e variante no Shopify. A pré-visualização lista cada linha com um selo de Status — success, error ou pending — e sinaliza com um selo Existing os produtos que já têm mapeamentos.
4. Processe os mapeamentos
Clique em Process CSV. As linhas válidas são salvas como mapeamentos de produto e as linhas com erro são ignoradas. Se mais de 30% das linhas forem inválidas, o Alva bloqueia a execução. Abaixo desse limite, um diálogo de confirmação informa quantas linhas serão ignoradas antes de prosseguir.
5. Verifique a cobertura
Após uma execução bem-sucedida, clique em View Products para voltar à lista de produtos. Cada produto mostra sua contagem de anexos, então você pode procurar qualquer um que ainda apareça com zero arquivos. Corrija essas linhas e execute-as novamente com Retry failed mappings.
Perguntas frequentes
Abra o produto no admin do Shopify e copie o ID numérico no fim da URL, como 1234567890. O Alva aceita esse número puro ou a forma completa gid://shopify/Product/1234567890 na coluna PRODUCT_ID.
Não. A tela de mapeamento em massa mostra um CSV de exemplo já preenchido dentro do card de instruções. Copie esse layout para a sua planilha — uma coluna PRODUCT_ID mais colunas FILE_1, FILE_2 — em vez de baixar um arquivo de template.
Pelo título do arquivo no armazenamento do Alva, correspondido sem diferenciar maiúsculas de minúsculas. Você pode prefixar o título com um símbolo @, que o Alva remove. O arquivo já precisa estar enviado — o mapeamento em massa vincula arquivos existentes, ele não os envia.
As linhas com erro são ignoradas e as linhas válidas ainda são salvas. Se mais de 30 por cento das linhas forem inválidas, o Alva bloqueia toda a execução. Abaixo disso, um modal de confirmação avisa quais linhas serão ignoradas antes do processamento.
Adicione colunas VARIANT_1, VARIANT_2 e coloque um ID de variante do Shopify em cada uma. Linhas sem colunas de variante são mapeadas para a variante padrão e se aplicam a todo o produto. Não há limite para o número de colunas de variante.
Veja também
Foi útil?
Última atualização 2026-06-01