A chave da Shopify que move a sua loja
A mudança de uma loja Shopify para o Omniterra acontece pela própria API da Shopify, por isso nada é exportado, recarregado ou escrito outra vez. Para isso precisamos de uma única chave, e a Shopify só a dá a uma app criada por si, na sua própria loja. Leva cerca de três minutos, e esta página percorre todo o caminho.
O que é esta chave e porque é você que a cria
A Shopify não distribui palavras-passe que permitam a outro serviço ler a sua loja. Em vez disso, você cria uma pequena app na sua própria loja, marca exatamente o que ela pode ler, e a Shopify entrega-lhe um token. Cola esse token no Omniterra e nós lemos o seu catálogo através dele.
Daí decorrem duas coisas, ambas a seu favor:
- É você que decide o que vemos. Só obtemos as permissões que marcar. Pedimos acesso de leitura, nada que escreva na sua loja Shopify.
- Pode cortar a qualquer momento. Apague a app na Shopify e o token deixa de funcionar de imediato, sem aviso a ninguém.
A sua loja Shopify continua a funcionar todo o tempo. Nada do que fazemos a altera.
Passo 1 — abrir as definições de apps
No painel da Shopify, vá a Definições → Apps e canais de vendas → Desenvolver apps.
Se aparecer um botão a dizer Permitir o desenvolvimento de apps personalizadas, carregue nele. A Shopify pergunta uma vez por loja, e só quem é proprietário o pode fazer.
Passo 2 — criar a app
Carregue em Criar uma app, dê-lhe um nome que reconheça mais tarde — «migração Omniterra» serve — e confirme.
Neste ponto a app está vazia. Ainda não consegue ler nada.
Passo 3 — marcar as permissões
Abra o separador Configuração e depois Integração da Admin API → Editar.
Marque o acesso de leitura para tudo o que quiser trazer:
| O que quer mover | Permissão a marcar |
|---|---|
| Produtos, variantes, imagens | `read_products` |
| Coleções | `read_products` |
| Clientes | `read_customers` |
| Encomendas | `read_orders`, `read_all_orders` |
| Descontos | `read_discounts`, `read_price_rules` |
| Páginas, artigos do blogue | `read_content` |
| Menus | `read_online_store_navigation` |
| Redirecionamentos (importante para SEO) | `read_online_store_pages` |
| Ficheiros e imagens | `read_files` |
| Stock e localizações | `read_inventory`, `read_locations` |
Carregue em Guardar.
O Omniterra mostra-lhe esta mesma lista no ecrã de importação, pronta a copiar, e diz-lhe quais faltam ainda se a ligação voltar incompleta.
Passo 4 — instalar a app e copiar o token
Vá ao separador Credenciais de API e carregue em Instalar app.
A Shopify mostra agora o token de acesso da Admin API, uma cadeia que começa por `shpat_`. Copie-o.
Leia bem esta parte: a Shopify mostra esse token uma única vez. Se fechar a página sem o copiar, não volta a vê-lo — terá de desinstalar e reinstalar a app para obter um novo. Não se perde trabalho, mas são cinco minutos irritantes.
Passo 5 — colá-lo no Omniterra
No painel do Omniterra, vá a Produtos → Importar / Exportar, escolha Shopify, escreva o endereço da sua loja (`a-minha-loja.myshopify.com`) e cole o token.
Carregue em Ligar. Lemos o seu catálogo e mostramos-lhe o que encontrámos antes de escrever seja o que for: quantos produtos, clientes, encomendas, páginas. Nada se move até você dizer.
Se disser que faltam permissões
Esta apanha muita gente de surpresa, por isso vale a pena saber de antemão: a Shopify comunica as permissões concedidas quando a app foi instalada, não o que a configuração diz agora. Se marcar mais caixas depois de instalar, a app mantém o acesso antigo, mais estreito.
A solução é reinstalar: Configuração → Integração da Admin API → Editar, marque o que falta, Guardar, e depois Credenciais de API → Reinstalar app. O token mantém-se o mesmo.
Se criou a app no Dev Dashboard
Algumas lojas têm uma app feita em `dev.shopify.com` em vez de dentro do painel da loja. A ideia é a mesma, com dois pormenores a mais:
- Edite `access_scopes` na configuração da app e carregue em Guardar.
- Carregue em Publicar. Sem publicação, a sua alteração fica numa versão não publicada e a loja nunca a vê.
- Reinstale a app na loja, para que as novas permissões sejam de facto concedidas.
O que se move e o que não pode
Produtos com as suas variantes, imagens, coleções, clientes, encomendas, descontos, páginas, artigos do blogue, menus, redirecionamentos e ficheiros passam todos.
Algumas coisas não podem passar, e dizemos-lhe quais antes de começar em vez de depois: os códigos de cartões-presente (a Shopify nunca os expõe), os dados de cartões guardados (pertencem ao seu fornecedor de pagamentos, não à sua loja) e as apps de terceiros instaladas, com os dados que guardam dentro de si.
Se chegarem menos produtos do que esperava
Três coisas explicam quase todos os casos, e nenhuma significa que a importação falhou.
Os rascunhos e os produtos arquivados ficam para trás por predefinição. A Shopify mantém-nos fora do catálogo ativo, e nós também. Se os quiser, publique-os na Shopify antes de correr a importação, ou traga-os e passe-os a rascunho aqui depois.
Os produtos sem preço ou sem variante são saltados, porque assim não podem ser vendidos. Aparecem no relatório final, pelo nome, para ver exatamente quais e porquê.
Uma permissão marcada depois da instalação só vale depois de reinstalar a app; é a mesma armadilha de cima. Reinstale e carregue em Verificar de novo no ecrã de importação — lemos o seu catálogo outra vez sem tocar no que já veio.
Pode correr a importação duas vezes, se for preciso. Os produtos são emparelhados pelo identificador da Shopify, por isso uma segunda passagem atualiza o que já cá está em vez de criar duplicados.
Quanto tempo demora
Um catálogo de algumas centenas de produtos costuma ficar pronto em dois minutos. Lojas grandes correm por lotes e pode sair da página: a importação continua e vê o progresso quando voltar.
Perguntas frequentes
Isto muda alguma coisa na minha loja Shopify?
Não. Apenas lemos. As permissões que concede são de leitura, e a sua loja Shopify continua a vender exatamente como antes enquanto experimenta o Omniterra.
E se perder o token?
Desinstale e reinstale a app na Shopify — Credenciais de API → Desinstalar, depois Instalar app. A Shopify mostra um token novo. O antigo deixa de funcionar no momento em que desinstala.
Posso impedir-vos de ler a loja mais tarde?
Sim, a qualquer momento. Apague a app na Shopify → Definições → Apps e canais de vendas → Desenvolver apps. O token morre com ela, de imediato.
Marquei as permissões e continua a dizer que faltam.
A Shopify concede as permissões na instalação, não quando guarda a configuração. Reinstale a app e passam a valer.
Preciso de um programador para isto?
Não. Todos os passos estão no painel da Shopify, com botões. A única coisa a que deve ter cuidado é copiar o token antes de fechar a página.
Fontes
Informações dos concorrentes em outubro de 2026, retiradas das páginas públicas abaixo. Os preços podem mudar e variar por país; confira a página indicada antes de decidir.
- Shopify — Create and manage custom apps — help.shopify.com/en/manual/apps/app-types/custom-apps
- Shopify — Admin API access scopes — shopify.dev/docs/api/usage/access-scopes
Experimente com os seus próprios produtos
Plano gratuito, 0% de comissão, sem cartão. Importe do Shopify ou WooCommerce em minutos.