Shopify — guia completo da integração

A integração com a Shopify usa o app oficial Hub Joias — instalação segura, sem copiar chave nenhuma.

Conectar

A conexão começa pela Shopify (regra da própria plataforma):

1. No painel, abra Integrações → Shopify — a tela mostra o botão/instruções de instalação do app.
2. Instale o app Hub Joias na sua loja: você entra na sua conta Shopify e confirma a instalação.
3. Ao concluir, a Shopify te devolve automaticamente para o painel, já conectado. ✅

🔒 O app é oficial e passa pela revisão da própria Shopify. A autorização se renova sozinha — você não precisa fazer nada.

---

Sincronizar produtos em lote

É 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.
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 — desconecte e conecte de novo (a autorização pode ter expirado);
• 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. 💛