O que a importação de pedidos históricos do Shopify para o Alva faz?
Importar pedidos históricos do Shopify para o Alva Digital Downloads recria os registros de compra de pedidos feitos antes da instalação do app. O importador lê um CSV de pedidos anteriores, associa cada item de linha a um mapeamento de produto existente e grava a compra que falta. Os downloads passam então a aparecer retroativamente na página da conta do cliente e na página de status do pedido.
Pense nisso como um preenchimento retroativo. Nada nos pedidos originais muda no Shopify. O Alva simplesmente ganha os registros de entrega que nunca recebeu da primeira vez, e cada cliente associado recupera o acesso self-service aos arquivos exatos vinculados ao que comprou.
Por que os pedidos anteriores à instalação não conseguem baixar seus arquivos
O Alva entrega arquivos escutando o webhook ORDERS_PAID do Shopify. Todo pedido pago dispara esse webhook, o Alva cria um registro de compra e o cliente ganha acesso ao download. Pedidos feitos antes de você instalar o app nunca dispararam esse webhook para o Alva, então nenhum registro de compra foi criado para eles.
Sem um registro de compra, não há nada para as superfícies voltadas ao cliente mostrarem. Um comprador que abre sua página de status do pedido ou a aba de downloads em sua conta do Shopify vê um espaço vazio onde seu arquivo deveria estar. Não há link para clicar, porque o Alva não tem registro de que a venda aconteceu.
Na prática, isso vira uma enxurrada de tickets "cadê meu arquivo?" — e o impacto é maior nos dias logo após você trocar de app, quando clientes antigos voltam esperando que o botão de download que usavam antes ainda funcione.
As três garantias rígidas: sem e-mails, sem verificações de fraude, sem chaves de licença
Uma importação histórica pode tocar milhares de pedidos antigos de uma vez, então o Alva a trata como uma operação silenciosa com três garantias aplicadas no código. A importação não envia e-mails, não roda verificações de fraude e não atribui chaves de licença. Nenhuma delas pode ser reativada para a importação — são limites rígidos deliberados.
O raciocínio por trás de cada uma é simples:
- Sem e-mails. Preencher retroativamente dois anos de pedidos nunca deve disparar para dois anos de clientes notificações de entrega. Ninguém recebe um e-mail; os downloads simplesmente ficam disponíveis para a próxima vez que cada cliente visitar sua conta.
- Sem verificações de fraude. Esses pedidos já foram pagos, atendidos e liquidados há muito tempo. Passá-los de novo pelo pipeline de fraude inundaria sua fila com verificações de transações que são história antiga.
- Sem chaves de licença. A importação nunca retira do seu estoque de chaves de licença. Um preenchimento retroativo em massa atribuindo chaves a pedidos antigos poderia esgotar silenciosamente o inventário que você guarda para vendas ativas, então a atribuição de chaves é pulada por completo.
Todo o objetivo da importação histórica é restaurar o acesso silenciosamente. É um reparo em segundo plano, não um novo fulfillment. Seus clientes recuperam seus downloads sem uma única notificação, e seu inventário de chaves de licença e sua fila de fraude ficam intocados.
É idempotente, então reexecutar é seguro
A importação histórica é idempotente, o que significa que rodá-la duas vezes produz o mesmo resultado que rodá-la uma vez. Reenviar o mesmo CSV não cria compras duplicadas — o Alva reconhece registros que já existem e os pula, criando apenas as compras que realmente faltam.
Essa rede de segurança importa mais do que parece. Se um upload grande for interrompido, você pode simplesmente rodá-lo de novo. Se depois você adicionar mapeamentos de produto para um segundo lote de produtos, pode reimportar o mesmo histórico de pedidos e apenas os pedidos recém-mapeáveis serão preenchidos retroativamente. Não há penalidade por rodá-la mais de uma vez.
Como importar seus pedidos históricos, passo a passo
A importação roda a partir de um CSV que você exporta do Shopify. Em alto nível, são quatro passos: mapear seus produtos, exportar os pedidos, enviar o arquivo e importar. Antes de começar, certifique-se de que seus produtos digitais já estão mapeados para seus arquivos no Alva — o importador faz a correspondência contra esses mapeamentos.
1. Mapeie seus produtos para arquivos primeiro
O importador funciona associando os itens de linha de cada pedido histórico aos seus mapeamentos de produto existentes. Se um produto ainda não está mapeado para um arquivo, pack ou link no Alva, seus pedidos antigos não têm nada a que se prender. Configure seus mapeamentos antes de importar para que todo pedido anterior encontre sua correspondência.
2. Exporte os pedidos históricos do Shopify
No seu admin do Shopify, abra Pedidos, filtre pelo intervalo de datas que você quer preencher retroativamente e use Exportar para baixar os pedidos como um CSV. A própria documentação de exportação de pedidos do Shopify percorre os filtros e o formato do arquivo.
3. Envie o CSV no Alva e importe
De volta ao admin do Alva, abra a importação de pedidos históricos, envie seu CSV e rode a importação. O Alva lê cada linha, associa os itens de linha aos seus mapeamentos e cria as compras que faltam. Quando termina, os downloads de cada pedido associado ficam ativos nas páginas da conta do cliente e de status do pedido.
As importações por CSV são exigentes com nomes de colunas e formatos. Para as colunas exatas que o Alva espera e um passo a passo tela por tela, siga o artigo de ajuda detalhado sobre importar pedidos históricos do Shopify antes de enviar.
Migrando do SendOwl, do Gumroad ou dos downloads nativos do Shopify
Trocar de ferramenta de entrega digital é o momento em que este recurso prova seu valor. Quando você migra para o Alva vindo do SendOwl, do Gumroad ou do fluxo nativo de downloads digitais do Shopify, apenas os novos pedidos passam a fluir pelo Alva automaticamente. Toda venda anterior à troca é invisível para o novo app até você preenchê-la retroativamente.
A importação histórica é o passo que mantém seus clientes existentes inteiros durante uma migração. Importe seus pedidos anteriores e ninguém perde o acesso ao que já comprou — o comprador que adquiriu um pack de presets ano passado ainda pode baixá-lo de novo, mesmo que aquela venda tenha acontecido na sua plataforma antiga. Se você está pensando em migrar, nosso artigo sobre como é na prática migrar do SendOwl para o Alva cobre o resto da transição.
Onde os downloads importados aparecem para os clientes
Uma vez importada, uma compra histórica se comporta como qualquer outra. O download aparece na página de status do pedido do Shopify referente àquele pedido e na seção de downloads digitais da conta do cliente, para que os compradores possam se autoatender sem entrar em contato com você. Ela reutiliza as mesmas superfícies de entrega que todo pedido ativo do Alva já acende.
Como nenhum e-mail é enviado, o acesso fica ali esperando, em vez de anunciado. Isso costuma ser exatamente o que você quer depois de uma migração: da próxima vez que um cliente antigo procurar seu arquivo, ele simplesmente estará lá. Para um passeio por todos os lugares onde os clientes podem chegar aos seus arquivos, veja nosso guia sobre as formas de os clientes receberem seus downloads digitais no Shopify.
Quem pode usar a importação histórica
A importação de pedidos históricos está disponível para todas as lojas do Alva hoje, depois de sair de um beta anterior. Não há lista de espera nem sinalizador especial a solicitar — exporte seus pedidos, mapeie seus produtos e rode-a sempre que precisar preencher retroativamente. Revise seu plano quanto aos limites de armazenamento e entrega e depois importe quantos pedidos anteriores o seu histórico tiver.
Perguntas frequentes
Não. A importação de pedidos históricos no Alva Digital Downloads envia zero e-mails, por design e aplicado no código. É um preenchimento retroativo silencioso que cria os registros de compra que faltam para que os downloads apareçam na conta de cada cliente e na página de status do pedido. Nenhum cliente é notificado, então importar milhares de pedidos antigos nunca pode enviar spam aos seus compradores.
Sim. A importação é idempotente, então reenviar o mesmo CSV não cria compras duplicadas. Se uma primeira passagem falhar no meio do caminho ou você adicionar novos mapeamentos de produto e quiser preencher retroativamente de novo, pode reexecutá-la com segurança. Os registros existentes são reconhecidos e pulados, e apenas as compras realmente faltantes são criadas.
Pedidos feitos antes de você instalar o app nunca passaram pelo webhook ORDERS_PAID, então não existe registro de compra para eles. Sem esse registro, a página de status do pedido e a aba da conta do cliente não têm nada para mostrar. A importação histórica recria as compras que faltam para que esses downloads apareçam retroativamente.
Não. A importação histórica não atribui nenhuma chave de licença e não roda nenhuma verificação de fraude. As duas são puladas deliberadamente para que um preenchimento retroativo em massa de pedidos antigos nunca queime o estoque de chaves de licença nem inunde sua fila de fraude. Ela apenas cria os registros de compra que permitem aos clientes chegar aos arquivos vinculados aos seus mapeamentos de produto existentes.
Exporte seus pedidos históricos como CSV a partir do admin do Shopify, mapeie seus produtos para arquivos no Alva e depois envie o CSV no Alva e importe. A ferramenta associa os itens de linha de cada pedido aos seus mapeamentos e cria as compras que faltam, para que os clientes que compraram pelo SendOwl, pelo Gumroad ou pelo fluxo nativo do Shopify mantenham o acesso ao que já possuem.