Yampi: guia completo da integração

A Yampi conecta por chaves de API: você copia 3 informações do painel dela e cola aqui. Leva 2 minutos.

1. Pegue as chaves na Yampi

1. Entre no painel da Yampi.
2. Vá em Configurações → Credenciais de API.
3. Copie o Alias da loja, o User-Token e a User-Secret-Key.

2. Cole no painel Hub

1. Abra Integrações → Yampi.
2. Preencha os três campos e clique em Conectar.
3. Chaves corretas = integração conectada na hora. ✅

⚠️ As chaves são como senhas: não as compartilhe fora do painel.

---

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 Yampi, 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 Yampi:

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

💡 Particularidades da Yampi: o painel cria automaticamente a marca "Hub Joias", as categorias e a variação Tamanho (para anéis) na sua loja. A Yampi pode levar alguns segundos para refletir mudanças na listagem. Se acabou de sincronizar, dê um refresh.

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

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