Shopify: guia completo da integração

A Shopify conecta por chaves de um app que você cria na sua própria loja (leva poucos minutos).

Conectar

1. No admin da Shopify, abra Configurações → Apps e canais de vendas → Desenvolver apps e crie um app (ex.: "Hub Joias").
2. Nas permissões do app, libere produtos e pedidos.
3. Instale o app na sua loja e copie o Client ID e o Client Secret.
4. No painel da Hub, abra Integrações → Shopify e preencha:

- Domínio da loja (ex.: minha-loja.myshopify.com); - Client ID; - Client Secret.

1. Clique em conectar. Integração conectada ✅

🔒 As chaves ficam guardadas cifradas e o acesso se renova sozinho. Se você apagar o app na Shopify, é só criar outro e colar as chaves novas.

---

Sincronizar produtos em lote

⏳ Teste Grátis: durante o teste o Sincronizar em Lote fica desligado. Publique até 5 produtos pela aba Lista de Produtos (botão Sincronizar). O botão Atualizar (preço e status) também só funciona com plano pago.

Sem plano ativo, os anúncios saem da plataforma e voltam sozinhos quando você contrata: Anúncios quando o plano vence

É aqui que você publica o catálogo da Hub na sua loja Shopify, do seu jeito:

1. Na página da integração, abra Sincronizar em Lote (menu à esquerda).
2. Marque as Categorias que deseja enviar (Anéis, Brincos, Colares...) e os Tipos de peça (Semijoias Douradas, Prateadas, Prata 925).
3. Confira as configurações. Elas valem para todos os produtos enviados e ficam salvas para as próximas vezes:

- Precificação: o preço de venda é calculado sozinho: custo × multiplicador. Ex.: multiplicador 2 = você vende pelo dobro do preço de catálogo. Dá para forçar os centavos (ex.: sempre ,90). - Status do produto: publicar como ativo (à venda) ou inativo (rascunho para revisar antes). - Descrição: um texto antes e um texto depois adicionados à descrição de todas as peças (ex.: sua política de troca, prazo de envio). - Imagens padrão: imagens fixas (banner da sua marca, selo de garantia...) incluídas em todos os produtos, junto das fotos da peça.

1. Se quiser, marque "Ignorar produtos já sincronizados" para enviar apenas as novidades. Mudou o preço (multiplicador ou centavos)? Deixe essa opção desmarcada para os produtos já enviados receberem o preço novo: o painel desmarca sozinho quando o preço muda e avisa se você marcar de novo.
2. Clique em Sincronizar e acompanhe o progresso na tela. Pode fechar a página: a sincronização continua sozinha.

A aba Lista de Produtos

Na aba Lista de Produtos você vê o catálogo inteiro com o status de cada peça na Shopify:

• Preço e status reais: o que está valendo lá agora;
• Sincronizar (por produto ou em seleção): cria ou atualiza a peça na plataforma;
• Atualizar: muda só o preço/status direto na Shopify, sem mexer no resto do anúncio.

💡 Particularidade da Shopify: além do preço, o painel também preenche o custo de cada peça no cadastro da Shopify. Seus relatórios de margem lá dentro ficam corretos.

Já vende na Shopify? Seus anúncios estão seguros

Se uma peça já existe na sua loja com o mesmo código (SKU), o painel adota o seu anúncio em vez de criar outro: vincula e atualiza apenas preço e status, preservando o título, a descrição e as fotos que você personalizou. Nada é duplicado, nada é apagado.

Importar pedidos

Quando alguém compra na Shopify:

1. No painel, abra Catálogo → Importar Pedidos, ou vá direto pela página da integração, no menu Importar Pedidos (à esquerda).
2. Filtre pelo status (pagos, pendentes...) e selecione a venda.
3. O pedido entra com os itens pelo preço de catálogo Hub e o endereço do comprador já preenchido.
4. Escolha a forma de envio e como pagar (PIX, cartão ou créditos) e finalize. A Hub separa, embala e posta.

Desconectar

Em Excluir Integração (menu da própria página) você remove a conexão. Fique tranquilo(a): os produtos já publicados continuam na sua loja. Só o vínculo com o painel é desfeito. Dá para reconectar quando quiser.

Problemas comuns

• "Aguardando Configurações" no topo: é só abrir Sincronizar em Lote e concluir a primeira configuração;
• Erro na conexão: as chaves deixaram de valer (revogadas ou app removido). Na própria integração aparece Atualizar credenciais: cole as chaves novas da mesma loja; os produtos e vínculos continuam;
• Produto não apareceu na loja: confira se ele foi publicado como inativo (configuração de Status) e ative-o;
• Persistiu? Abra um chamado na Central de Ajuda com um print. Resolvemos rapidinho. 💛