Migrar do Magento para o Shopify
O DataEase move uma loja Magento 2 (Magento Open Source, Adobe Commerce ou Mage-OS) para o Shopify diretamente pela REST API do Magento - sem extensões, sem exportações CSV, sem planilhas. Você cria uma integração no Magento, cola as chaves dela, escolhe o que mover, e o DataEase faz o resto. Ele também cria redirecionamentos das URLs antigas, para que os links e o posicionamento nas buscas continuem funcionando depois que você trocar o domínio.
O que é migrado
Section titled “O que é migrado”| Magento | Shopify | Detalhes |
|---|---|---|
| Produtos simples, virtuais e para download | Produtos | Nome, descrição, status, visibilidade, primeira categoria como tipo de produto, imagens (a imagem principal primeiro), SKU, preço e preço especial (como preço comparativo), custo, peso, classe de imposto, quantidade em estoque (na sua localização principal), encomendas pendentes, marca (manufacturer), país de fabricação, título e descrição de SEO. |
| Produtos configuráveis | Produtos com variantes | Os atributos configuráveis (Color, Size, …) viram opções (até 3), e cada produto filho ativado vira uma variante com SKU, preço, estoque e imagem próprios. |
| Categorias | Coleções | Coleções manuais com os produtos, a descrição, a imagem e o SEO da categoria. Categorias aninhadas viram coleções separadas. |
| Clientes | Clientes | Nome, e-mail, telefone, todos os endereços (o endereço de entrega padrão primeiro), inscrição na newsletter. O grupo do cliente é adicionado como tag, por exemplo magento-group-wholesale. |
| Pedidos | Pedidos | Cópia histórica com itens (vinculados às variantes migradas por SKU), opções das variantes, frete, desconto, impostos, pagamento e reembolsos. Nenhum e-mail é enviado aos clientes. |
| Regras de preço do carrinho | Descontos | Regras com cupom viram códigos de desconto, e regras sem cupom viram descontos automáticos: porcentagem, valor fixo por item ou por carrinho, frete grátis, subtotal ou quantidade mínima, país de entrega, condições de produtos e categorias, datas e limites de uso. |
| Páginas CMS | Páginas | Título, conteúdo, status, SEO. |
| URLs antigas | Redirecionamentos de URL | Produtos e categorias (com o sufixo .html das configurações da sua loja), páginas CMS, o carrinho, a conta do cliente e a busca redirecionam para seus endereços no Shopify. |
- As imagens dentro de descrições e páginas são copiadas para Shopify → Content → Files, e os links são atualizados, para que nada quebre quando a loja antiga sair do ar.
- As tags de template do Magento são convertidas:
{{media url="…"}}vira o endereço da imagem,{{store url="…"}}vira um link; widgets e blocos CMS são removidos. - O ID do Magento de cada registro é salvo no metacampo
magento.id. - Produtos desativados são migrados como rascunhos. Produtos que não são visíveis individualmente, ou que não estão atribuídos ao website da loja, são migrados, mas não publicados na Online Store.
Não é migrado: temas e design, extensões e seus dados (blogs, avaliações, pontos de fidelidade), produtos do tipo bundle, agrupados e vale-presente, opções personalizáveis (customizable options), preços escalonados e preços de catálogo, store views em outros idiomas, configurações de pagamento, frete e impostos, senhas de clientes (os clientes definem uma nova senha no Shopify).
Antes de começar
Section titled “Antes de começar”- Magento 2.3 ou mais recente (Magento Open Source, Adobe Commerce ou Mage-OS).
- Um usuário do painel do Magento que possa criar integrações (System → Extensions → Integrations).
- A loja precisa estar acessível pela internet - o DataEase não consegue se conectar a
localhostou a um endereço de intranet. Mantenha-a no ar até a migração terminar: as imagens são baixadas dela. - Sua loja Shopify deve usar a mesma moeda do Magento - os preços são copiados como estão, sem conversão.
Passo 1. Crie uma integração no Magento
Section titled “Passo 1. Crie uma integração no Magento”- No painel do Magento, abra System → Extensions → Integrations e clique em Add New Integration.
- Digite um nome, por exemplo
DataEase, e sua senha de administrador em Your Password. - Abra a aba API e defina Resource Access como All.
- Clique em Save, depois em Activate ao lado da nova integração e em Allow.
- O Magento mostra quatro chaves: Consumer Key, Consumer Secret, Access Token e Access Token Secret. Copie as quatro.
As chaves só dão acesso à API e podem ser revogadas a qualquer momento. O DataEase apenas lê os dados - ele nunca altera nada no Magento.
Prefere conceder menos acesso? Em vez de All, você pode selecionar recursos específicos: lojas (stores), catálogo (produtos, categorias e estoque), clientes e grupos de clientes, pedidos de venda, regras de preço do carrinho e páginas CMS. Se faltar algo, o DataEase mostra qual recurso do Magento adicionar.
Passo 2. Conecte a loja no DataEase
Section titled “Passo 2. Conecte a loja no DataEase”- No Shopify, abra DataEase → Store transfers.
- Escolha a aba From Magento.
- Informe o endereço da loja (por exemplo
https://myshop.com) e as quatro chaves da integração. - Clique em Check connection.
O DataEase mostra o nome da loja, a store view da qual os dados são lidos e quantos registros de cada tipo a loja possui.
Passo 3. Escolha o que migrar e inicie
Section titled “Passo 3. Escolha o que migrar e inicie”- Marque os dados que deseja mover - tudo o que foi encontrado na loja vem selecionado por padrão.
- Clique em Start migration.
A migração é executada em segundo plano - você pode fechar a página. A lista Transfers mostra quais dados estão sendo migrados no momento, e você pode clicar em Cancel a qualquer instante.
Passo 4. Verifique o resultado
Section titled “Passo 4. Verifique o resultado”Quando a migração termina, a lista mostra quantos registros foram migrados de cada tipo, com avisos e erros e seus motivos - por exemplo Orders: 1250 ⚠3. Avisos típicos são regras de preço do carrinho com condições que o Shopify não suporta ou registros que já foram migrados antes.
Após a migração
Section titled “Após a migração”- Revise produtos, coleções e preços no painel do Shopify.
- Configure pagamentos, frete e impostos - eles não são migrados.
- Escolha e personalize um tema e depois adicione as páginas e coleções migradas ao menu de navegação.
- Conecte seu domínio ao Shopify. Links antigos como
/joust-duffle-bag.htmlagora redirecionam para/products/joust-duffle-bag. - Exclua a integração no Magento (System → Extensions → Integrations). O DataEase exclui as chaves do próprio banco de dados assim que a migração termina.
Executar a migração novamente
Section titled “Executar a migração novamente”Você pode executar a migração novamente a qualquer momento - por exemplo, logo antes de trocar o domínio, para trazer os pedidos novos. Os registros existentes são atualizados, não duplicados:
- produtos, coleções, clientes e páginas são identificados por handle ou e-mail e atualizados;
- pedidos já migrados, códigos de desconto existentes, descontos automáticos com o mesmo nome e redirecionamentos existentes são ignorados (você verá um aviso com a quantidade);
- as imagens já copiadas para o Shopify Files são reutilizadas.
Como os dados são mapeados
Section titled “Como os dados são mapeados”Produtos
Section titled “Produtos”- Handle: a chave de URL do produto, para que os endereços dos produtos continuem reconhecíveis.
- Status: Enabled → Active; Disabled → Draft.
- Preços: um preço especial ativo se torna o preço no Shopify, e o preço normal se torna o preço comparativo. As datas do preço especial são consideradas no momento da migração.
- Estoque: as quantidades vão para a sua localização principal. Produtos com encomendas pendentes (backorders) permitidas continuam sendo vendidos quando estão sem estoque.
- Opções: os atributos de um produto configurável viram opções na mesma ordem, e os valores seguem a ordem das opções do atributo. O Shopify suporta até 3 opções e 2048 variantes por produto; produtos com mais opções são ignorados com um aviso. Produtos filhos desativados não são migrados.
- Impostos: produtos com a classe de imposto None não são tributáveis.
- A descrição curta é salva no metacampo
magento.short_description.
Pedidos
Section titled “Pedidos”| Estado no Magento | Status de pagamento no Shopify | Processamento |
|---|---|---|
| Pending (new), On hold | Pending (ou Paid, se faturado) | Unfulfilled |
| Processing | Paid (ou Partially paid) | Unfulfilled, ou Fulfilled quando tudo foi enviado |
| Complete | Paid | Fulfilled |
| Closed | Refunded (ou Partially refunded) | - |
| Canceled | Voided | - |
O status de pagamento é calculado a partir dos valores que o Magento registrou como pagos e reembolsados. Pedidos com Pending payment ou Payment review não são migrados. Cada pedido migrado recebe a tag magento e uma tag magento-<status> (por exemplo magento-complete), e mantém seu número do Magento (#000000145).
Regras de preço do carrinho
Section titled “Regras de preço do carrinho”| Magento | Shopify |
|---|---|
| Regra com um cupom específico (Specific Coupon) | Código de desconto |
| Regra sem cupom | Desconto automático |
| Percent of product price discount | Porcentagem de desconto |
| Fixed amount discount | Valor fixo de desconto em cada item elegível |
| Fixed amount discount for whole cart | Valor fixo de desconto no pedido |
| Frete grátis (valor do desconto 0) | Desconto de frete grátis |
| Condição Subtotal equals or greater than | Valor mínimo de compra |
| Condição Total items quantity | Quantidade mínima de itens |
| Condição Shipping country (frete grátis) | Entrega para países selecionados |
| Condição de ação SKU ou Category | Produtos ou coleções específicos |
| Uses per coupon / Uses per customer = 1 | Limite de uso / Limitar a um uso por cliente |
| Discard subsequent rules | Não se combina com outros descontos |
O DataEase nunca torna um desconto mais amplo do que era no Magento. Regras limitadas a alguns grupos de clientes, regras com condições que o Shopify não consegue expressar (forma de pagamento, atributos do carrinho, condições combinadas) e regras Buy X get Y são ignoradas com um aviso - recrie-as manualmente. Regras inativas e códigos de cupom gerados automaticamente não são migrados.
Solução de problemas
Section titled “Solução de problemas”| Mensagem | O que fazer |
|---|---|
| Magento rejected the integration keys | Verifique as quatro chaves e confirme que a integração está ativa. Se você a reautorizou, copie o novo access token e o secret. |
| The consumer isn’t authorized to access … | Edite a integração, defina Resource Access como All (ou adicione o recurso indicado na mensagem) e salve. |
| Magento REST API endpoint … was not found | Verifique o endereço da loja - use o endereço da vitrine, e não a URL do painel administrativo. |
| returned a non-JSON response | Um firewall, o modo de manutenção ou um cache está bloqueando a REST API. Permita as requisições a /rest/ durante a migração. |
| must be reachable from the internet | Use o endereço público da loja, e não localhost ou um IP interno. |
| Image … was not copied | A URL da imagem não estava acessível. A página mantém o link antigo - envie a imagem manualmente em Content → Files. |
Perguntas frequentes
Section titled “Perguntas frequentes”Os clientes recebem e-mails? Não. Clientes e pedidos são criados sem notificações nem convites.
Minha loja Magento é alterada? Não. O DataEase apenas lê os dados dela.
As chaves da integração ficam armazenadas? Somente enquanto a migração é executada, de forma criptografada. Elas são excluídas quando a migração termina, falha ou é cancelada.
Tenho vários websites ou store views. Qual deles é migrado? A store view padrão do website padrão: seus nomes, descrições, preços e URLs.
Vai migrar do WordPress ou mover dados entre duas lojas Shopify? Consulte Migrar do WordPress / WooCommerce e Transferências entre lojas.