WooCommerce — guia completo da integração

O WooCommerce (a loja do seu WordPress) conecta por chaves de API geradas dentro do seu próprio site.

1. Gere as chaves no WordPress

1. Entre no admin do seu WordPress.
2. Vá em WooCommerce → Configurações → Avançado → API REST.
3. Clique em Adicionar chave:

- Descrição: Hub Joias; - Permissões: Leitura/Escrita; - Clique em Gerar chave de API.

1. Copie a Consumer Key (ck_...) e o Consumer Secret (cs_...).

⚠️ As chaves aparecem uma única vez — copie na hora! Se perder, é só gerar um novo par.

2. Cole no painel Hub

1. Abra Integrações → WooCommerce.
2. Preencha a URL da loja (ex.: https://minhaloja.com.br), a Consumer Key e o Consumer Secret.
3. Clique em Conectar. ✅

💡 Sua loja precisa estar com HTTPS ativo (cadeado) — padrão em qualquer hospedagem atual.

---

Sincronizar produtos em lote

É aqui que você publica o catálogo da Hub na sua loja WooCommerce, 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 WooCommerce:

• 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 WooCommerce, sem mexer no resto do anúncio.

Já vende na WooCommerce? 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 WooCommerce:

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. 💛