Como funciona
O importador de pedidos do Shopify lê um CSV padrão de pedidos do Shopify, identifica o cliente de cada pedido pelo e-mail, relaciona cada item de linha a um arquivo ou pack mapeado pelo SKU em primeiro lugar e pelo título do produto em segundo, e cria registros de pedidos no Alva para cada correspondência válida. Não envia e-mails, não coloca verificações de fraude na fila e não atribui chaves de licença — esses efeitos colaterais são exclusivos para pedidos ao vivo que chegam pelo fluxo normal de pagamento 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.
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 em comparação com um pedido pago ao vivo chegando em tempo real.
| Efeito colateral | Pedido ao vivo (webhook) | Pedido importado |
|---|---|---|
| Registros de pedidos criados | 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 |
Cada pedido importado é criado com a verificação de fraude desativada e o acesso para download habilitado imediatamente — nenhuma revisão de fraude é colocada na fila. É isso que faz com que a página da conta do cliente exiba o arquivo imediatamente, sem acionar 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.
- Os contadores de download começam em zero. Pedidos importados não têm histórico de contagem de downloads. Se você aplicava anteriormente um limite de download por pedido, os clientes terão 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. As verificações de fraude só fazem sentido para pedidos novos, em que os dados de risco do Shopify são atuais. Pedidos importados ignoram as verificações de fraude e dão ao cliente acesso imediato para download — nenhuma revisão é acionada.
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