PS PrestaShop PrestaShop Intermédio

Migração do Shopify para o PrestaShop: guia completo

Instalação, ligação ao Shopify, configuração e procedimento completo de migração para o PrestaShop 8 e 9.

Atualizado Versão do módulo 1.0.0

Apresentação

O dfmigrateshopify importa a totalidade de uma loja Shopify para o PrestaShop 8 ou 9: produtos com variantes e imagens, clientes com moradas, encomendas históricas, coleções convertidas em categorias, redirecionamentos 301 e avaliações de clientes. O módulo funciona em leitura apenas do lado do Shopify: nenhuma escrita, nenhuma modificação da loja de origem.

Instalação

  1. Back-office PrestaShop → Módulos → Gestor de módulos → Carregar um módulo.
  2. Selecione o ficheiro dfmigrateshopify.zip e instale.
  3. Aparece um novo ecrã em Parâmetros avançados → Migração Shopify.

A instalação cria 4 tabelas com o prefixo dfmigshop_: mapping (correspondências Shopify ↔ PrestaShop), log, redirect e job.

Criar o token Shopify

Na administração da sua loja Shopify de origem:

  1. Settings → Apps and sales channels → Develop apps → Create an app.
  2. Separador Configuration → Admin API integration → Configure.
  3. Marque os scopes: read_products, read_inventory, read_product_listings, read_customers, read_orders, read_content.
  4. Instale a app na loja e copie o Admin API access token (começa por shpat_).

O token só é apresentado uma vez pelo Shopify. Guarde-o em lugar seguro.

Ligação

Separador Ligação do módulo: preencha o domínio (a-minha-loja.myshopify.com, sem https://), o token e a versão da API (por defeito 2024-10). Clique em Testar a ligação: o nome da loja deve aparecer a verde.

Configuração

  • Tamanho do lote: número de elementos processados por chamada AJAX (por defeito 50, máx. 250). Reduza se o seu alojamento for lento.
  • Descarregar as imagens: desative para uma migração de teste rápida sem imagens.
  • Rascunhos: importar ou ignorar os produtos Shopify com estado draft.
  • Categoria-mãe por defeito: as coleções Shopify serão criadas sob esta categoria.
  • Transportadora e módulo de pagamento: atribuídos às encomendas importadas.
  • Correspondência dos estados: mapeie cada estado Shopify (pending, paid, fulfilled, delivered, cancelled, refunded) para um estado de encomenda PrestaShop.

Lançar a migração

Separador Migração, respeite a ordem:

  1. Contar: verifica a ligação e mostra os volumes.
  2. Coleções custom e depois Coleções smart: cria as categorias.
  3. Produtos + variantes + imagens: a etapa mais longa. As variantes Shopify tornam-se combinações de atributos; cada variante recebe a sua imagem; as marcas são criadas a partir do campo vendor.
  4. Clientes: desduplicação automática por e-mail. É atribuída uma palavra-passe aleatória: convide os seus clientes a usar « Esqueci-me da palavra-passe ».
  5. Encomendas: apenas depois dos produtos e dos clientes. Referência no formato SH-{número}.
  6. Redirecionamentos 301: recupera os URL Redirects do Shopify. Os redirecionamentos de produtos/coleções já foram criados automaticamente nas etapas anteriores.

Cada etapa pode ser relançada sem risco: a tabela de correspondência impede os duplicados. Em caso de interrupção, volte simplesmente a clicar no botão, a migração retoma onde tinha parado.

Depois da migração, verifique dois pontos próprios de uma loja portuguesa: as regras de imposto (o Shopify guarda uma taxa por produto, o PrestaShop trabalha com grupos de impostos, a recriar para os 23 %, 13 % e 6 % do continente e para as taxas dos Açores e da Madeira), e a estrutura das moradas, já que o Shopify guarda muitas vezes um campo « province » vazio para Portugal.

Importar as avaliações

O Shopify não tem API nativa para as avaliações. Exporte em CSV a partir da sua aplicação (Judge.me, Loox, Yotpo, Product Reviews app…) e importe depois o ficheiro no separador Avaliações. O módulo deteta automaticamente o seu backend: dfreviews (prioritário) ou productcomments.

Colunas esperadas (insensíveis a maiúsculas, separador , ou ;): product_handle ou shopify_product_id ou sku, email, reviewer_name, rating, title, body, created_at, verified.

Redirecionamentos 301

Cada pedido do front-office é intercetado pelo hook actionDispatcherBefore: se o URL pedido corresponder a uma origem registada (ex. /products/o-meu-produto), o visitante é redirecionado em 301 para o URL PrestaShop equivalente. Não é necessária nenhuma configuração Apache ou Nginx. O separador Redirecionamentos 301 permite exportar a lista completa em CSV.

Correspondências e relançamento

O separador Correspondências mostra o número de elementos importados por tipo de recurso. O botão Esvaziar elimina as correspondências de um tipo: os elementos permanecem no PrestaShop, mas uma nova migração reimportá-los-á como novos (duplicados possíveis, a usar com conhecimento de causa).

Resolução de problemas

  • Erro 429 ou 503: o módulo gere automaticamente o limite de taxa do Shopify (retry com respeito do cabeçalho Retry-After). Nenhuma ação necessária.
  • Migração lenta: reduza o tamanho do lote, ou desative o descarregamento de imagens para uma primeira passagem de teste.
  • Erros no registo: o separador Registos mostra cada erro com o recurso e o identificador Shopify em causa. Corrija a causa e relance a etapa: só os elementos com erro serão reprocessados.
  • Preços das encomendas históricas: as encomendas são importadas a título de arquivo contabilístico; os totais Shopify são conservados tal como estão, sem recálculo de impostos do PrestaShop. Não substituem as faturas emitidas pelo seu software certificado pela AT, que deve conservar durante 10 anos (artigo 123.º do CIRC).

Desinstalação

A desinstalação elimina as 4 tabelas do módulo e os hooks. Os produtos, clientes, encomendas e categorias importados permanecem. Os redirecionamentos 301 deixam de funcionar (são servidos pelo módulo).

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte