Como funciona
O importador de pedidos do Shopify lê um CSV padrão de pedidos do Shopify, casa o cliente de cada pedido por e-mail, casa cada item de linha com um arquivo ou pacote mapeado primeiro pelo SKU e em seguida pelo título do produto, e cria linhas de Customer e Purchase no Alva para cada correspondência elegível. Ele não envia e-mails, não enfileira checagens antifraude e não atribui chaves de licença — esses efeitos colaterais são reservados para pedidos ao vivo que chegam pelo webhook regular do Shopify.
Antes de começar
Mapeie todo produto do Shopify que já vendeu um arquivo digital a um arquivo ou pacote no Alva antes de rodar a importação. Produtos não mapeados são pulados linha a linha e mostrados num resumo, mas a abordagem mais limpa é mapear primeiro e importar uma única vez.
- Arquivos mapeados aos produtos. Abra Arquivos no Alva e confirme que cada produto digital tem ao menos um arquivo ou pacote anexado. Mapeamentos por variante também funcionam.
- Defina o intervalo de datas. Escolhas comuns: os últimos 90 dias para uma loja ativa, ou o histórico completo para uma migração de outro app de fulfillment.
- Tenha um pequeno CSV de teste pronto. Exporte uma única semana recente primeiro para validar o mapeamento, depois reexporte o intervalo completo quando o ensaio parecer correto.
Exporte o CSV de pedidos pelo admin do Shopify
O Shopify expõe a exportação de pedidos em Pedidos → Exportar. O importador espera os nomes de coluna padrão do CSV — não renomeie colunas nem edite o arquivo manualmente.
- Abra o admin do Shopify → Pedidos. Use os filtros para restringir ao intervalo de datas que você quer preencher.
- Clique em Exportar. Escolha Arquivo CSV simples (não Para Excel, Numbers ou outras planilhas) e selecione Pedidos, transações e reembolsos.
- Escolha o escopo certo. "Página atual", "Pedidos selecionados", "Todos os pedidos" ou "Pedidos correspondentes à sua busca" funcionam todos. O importador só age sobre linhas cujo status financeiro é
paid. - Baixe o e-mail que o Shopify envia. Para exportações grandes, o Shopify envia o link do CSV por e-mail ao endereço do dono da loja. Salve localmente — não descompacte e recompacte.
Rode o importador
O importador fica em Pedidos → Importar pedidos históricos na barra lateral do admin do Alva. Ele divide CSVs grandes automaticamente — não há limite de número de linhas com o qual você precise se preocupar.
- Abra Pedidos no Alva e clique na ação secundária Importar pedidos históricos no cabeçalho da página.
- Solte o CSV na área de upload. O Alva valida os cabeçalhos das colunas imediatamente e rejeita o arquivo se alguma coluna obrigatória estiver faltando.
- Aguarde a prévia. O Alva resolve clientes por e-mail, casa produtos por SKU e depois por título, e mostra contagens: total de pedidos, pedidos elegíveis, pulados (cancelados / não pagos / sem e-mail), clientes encontrados vs. ausentes, produtos casados vs. não mapeados, e pedidos já importados em uma execução anterior.
- Revise os produtos não mapeados. Se a prévia trouxer títulos de produtos não mapeados, cancele a importação, mapeie-os em Arquivos → Produtos e reenvie o mesmo CSV. Pedidos já importados serão pulados automaticamente.
- Confirme e inicie. Clique em Iniciar importação. O progresso é transmitido na interface conforme cada chunk é concluído. Fechar a aba do navegador não aborta a importação — ela continua até o fim no servidor e você pode reabrir a página para ver o resultado.
Tela de prévia do importador de pedidos do Shopify do Alva, com o card de resumo de resolução mostrando contagens de elegíveis / pulados / não mapeados e o botão Iniciar importação. Sem dados reais de cliente visíveis.
O que o importador faz (e o que pula)
O importador é deliberadamente mínimo. Ele grava o menor conjunto de linhas necessário para que um cliente possa reenviar seus próprios links de download, e pula todo efeito colateral que surpreenderia um cliente que retorna.
Efeitos colaterais do importador de pedidos do Shopify comparados a um webhook ORDERS_PAID ao vivo.
| Efeito colateral | Pedido ao vivo (webhook) | Pedido importado |
|---|---|---|
| Linhas de Customer + Purchase criadas | Sim | Sim |
| Acesso a downloads habilitado | Sim | Sim |
| E-mail de entrega enviado | Sim (se habilitado) | Não — nunca |
| Checagem antifraude enfileirada | Sim (se habilitado) | Não — nunca |
| Chaves de licença atribuídas automaticamente | Sim (se mapeado) | Não — nunca |
| Triggers de POS / Flow disparados | Sim | Não — nunca |
Por baixo dos panos, toda linha de Purchase importada é criada com fraudCheckEnabled: false, fraudCheckPassed: false e accessEnabled: true. É isso que faz a página de conta do cliente mostrar o arquivo imediatamente sem nunca disparar um e-mail de download ou uma atribuição de chave de licença.
Limitações honestas
- Os clientes precisam já existir no Shopify. O importador casa por e-mail contra a sua lista de clientes do Shopify. Checkouts de convidado que nunca criaram um registro de cliente não podem ser casados, e essas linhas são reportadas no resumo de pulados.
- Clientes que mudaram o e-mail são pulados. O CSV traz o e-mail capturado no pedido original. Se um cliente trocou o e-mail no Shopify desde então, a busca não acha e o pedido é reportado como sem correspondência.
- Produtos personalizados não são importados. Arquivos sob demanda pertencem a uma Purchase específica via a tabela de arquivos por compra e precisam ser enviados manualmente. O importador só restaura o acesso aos arquivos padrão mapeados ao produto.
- Contagens de download começam em zero. Linhas de Purchase importadas não têm contagem histórica de downloads. Se você antes aplicava um limite de downloads por compra, os clientes recebem uma cota nova após a importação.
- Nenhuma notificação automática. O importador nunca avisa os clientes de que o acesso foi restaurado. Anuncie via um e-mail de marketing fora do Alva, ou aguarde pedidos individuais de reenvio.
Uma importação de pedidos antigos que enviasse e-mail para todo cliente passado, em uma loja com 50.000 pedidos, dispararia 50.000 e-mails de entrega no momento em que você clicasse em Iniciar — uma flag de spam garantida pelos provedores de caixa de entrada. O Alva inclui o importador com efeitos colaterais de e-mail, antifraude e chaves de licença desligados por código, para que o caminho seguro seja o único caminho.
FAQ
O importador enviará e-mail aos clientes antigos quando eu rodar?
Não. O importador de pedidos do Shopify nunca envia e-mails. Os clientes antigos recebem novos links de download apenas quando solicitam um reenvio ou visitam a página de conta do cliente do Shopify.
O importador roda checagem antifraude nos pedidos importados?
Não. Checagens antifraude só fazem sentido para pedidos novos onde os dados do Shopify Risk são atuais. Linhas de Purchase importadas são criadas com fraudCheckEnabled definido como false e accessEnabled como true.
O importador atribuirá chaves de licença aos pedidos importados?
Não. Chaves de licença nunca são atribuídas durante uma importação histórica. Se um pedido antigo precisar de uma chave após a importação, anexe uma manualmente pela página de detalhes do pedido no Alva.
É seguro rodar a importação duas vezes?
Sim. O importador é idempotente — rodar de novo com o mesmo CSV detecta pedidos já importados e os pula. O resumo informa quantos pedidos e itens de linha foram pulados na segunda passada.
O que acontece com pedidos de produtos que ainda não mapeei?
O importador pula itens de linha cujo produto do Shopify não pode ser casado a um arquivo ou pacote no Alva. A prévia lista cada título não mapeado com uma contagem de pedidos para que você possa mapeá-los e rodar de novo.
E sobre pedidos cancelados ou não pagos no CSV?
O Alva só importa linhas em que o status financeiro do Shopify é paid e o pedido não está cancelado. Pedidos não pagos, cancelados e reembolsados são contados no resumo de pulados e não são importados.
Veja também
Foi útil?
Última atualização 2026-05-08