O que é um mapeamento órfão
O Alva Digital Downloads armazena uma linha ProductMapping para cada produto do Shopify que você vincula a arquivos. Exclua esse produto no Shopify e o mapeamento fica órfão — o Alva não consegue mais buscar um título ao vivo, então recorre ao nome em cache ou a Produto desconhecido na sua lista de Produtos.
O mapeamento ainda pode ser gerenciado
Abrir um mapeamento órfão não gera mais um erro. O Alva detecta que o Shopify confirmou que o produto sumiu e carrega uma visualização de órfão com o banner O produto do Shopify não existe mais, um resumo do que está anexado, uma ação Exportar dados (ZIP) e uma ação Excluir.
Como limpar um mapeamento órfão
1. Abra o mapeamento órfão
No Alva, abra Produtos e encontre a linha rotulada Produto desconhecido. Clique nela. A visualização de órfão carrega com um banner de aviso e um card intitulado Configuração atual (será excluída permanentemente) listando contagens de arquivos, packs, links, chaves de licença, compras e downloads.
2. Exporte primeiro o ZIP de dados
Clique em Exportar dados (ZIP). O Alva transmite um pacote com um CSV por tipo de dado — compras, chaves de licença, downloads, arquivos, packs, links, variantes e histórico de e-mails. Guarde este arquivo: a exclusão é permanente e o ZIP tem tudo o que você precisa para recriar o mapeamento depois.
3. Confirme por digitação e exclua
Clique em Excluir para abrir o modal. Digite o nome do produto mostrado no rótulo Digite "…" para confirmar — ou a palavra literal DELETE se nenhum nome estiver em cache — e clique em Excluir permanentemente. O mapeamento, suas variantes, os mapas de arquivo/pack/link e o cache de ZIP são removidos em uma única transação.
Visualização de mapeamento órfão no admin do Alva: banner de aviso "O produto do Shopify não existe mais", o card de resumo da configuração e o modal de exclusão com confirmação por digitação aberto, com o campo "Digite … para confirmar" e um botão "Excluir permanentemente". Sem dados reais de cliente.
Antes de excluir, confira esta lista
O card de resumo e o modal de exclusão sinalizam as consequências. Percorra-as para que nada surpreenda um cliente:
- Links de download de clientes existentes de pedidos anteriores retornarão um 404 após a exclusão — exporte primeiro.
- Atribuições pendentes de chaves de licença são concluídas silenciosamente, sem e-mail ao cliente, depois que o mapeamento some.
- Arquivos, packs e links permanecem na sua biblioteca — apenas as linhas de mapeamento são removidas.
- Nenhum histórico de pedidos é removido do Shopify; isso apenas limpa os registros do Alva para o produto.
Perguntas frequentes
O produto subjacente do Shopify foi excluído, então o Alva não consegue mais buscar o título atual e recorre ao nome em cache ou a "Produto desconhecido". A linha de mapeamento ainda existe no Alva e pode ser totalmente gerenciada a partir da sua página de detalhes.
Não. Excluir o mapeamento remove as linhas de compra, download e configuração do Alva para esse produto. Não toca no Shopify — nenhum histórico de pedidos é removido da sua loja. Exporte primeiro o ZIP de dados se quiser um registro.
Os tokens de download existentes são removidos em cascata junto com o mapeamento, então clientes que têm links de pedidos anteriores recebem um 404 após a exclusão. Esse trade-off é destacado no modal de exclusão. Exporte primeiro o ZIP de dados para manter um registro.
Sim. Um mapeamento órfão é inofensivo deixado no lugar — ele simplesmente aparece como "Produto desconhecido". Se você recriar o produto depois, pode mapear um novo produto do zero. Reanexar o mapeamento antigo a um produto diferente não é suportado.
Veja também
Foi útil?
Última atualização 2026-06-01