Pular para o conteúdo

Conectando a Yampi

Lojas virtuaisConexão: híbridoAtualizado em

Ver o que a Toca faz com o Yampi →

Em homologação

Abrir integrações no app

A conexão com a Yampi tem dois jeitos, no mesmo card. O principal é Entrar com a Yampi: você autoriza a Toca dentro da Yampi, vê as permissões antes de aceitar e volta conectado, sem copiar senha nem chave. O outro é colar três dados do painel da sua loja: o alias da loja, o User-Token e a User-Secret-Key. Os dois servem tanto para a loja virtual Yampi quanto para quem usa só o checkout da Yampi.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Enquanto o aplicativo da Toca passa pela análise da Yampi, Entrar com a Yampi pode não abrir para a sua loja. Nesse caso, conecte pelo User-Token: a conexão funciona igual, e você pode trocar pelo botão depois.

Antes de começar

  • Tenha acesso ao painel da sua loja na Yampi, com um usuário que possa instalar aplicativos.
  • Para o User-Token:
    • No painel, abra Perfil → Credenciais de API, no canto superior direito. Ali estão o Alias, o User-Token e a User-Secret-Key.
    • As credenciais são do seu usuário do painel e dão acesso completo à conta dele. Se o seu usuário tem mais de uma loja, a Toca usa só a do alias que você informar.

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card Yampi e clique em Conectar.
  3. Escolha um caminho:
    • Entrar com a Yampi (recomendado): clique no botão. Na tela da Yampi, entre com o usuário do painel, confira as permissões e clique em Instalar. Você volta à Toca com a loja conectada.
    • User-Token: abaixo de “ou use o token de usuário”, preencha Alias da loja (o alias que aparece em Perfil → Credenciais de API, como minha-loja), User-Token e User-Secret-Key, copiados da mesma tela. Clique em Salvar token.
  4. O card fica marcado como conectado. Entrando com a Yampi, o painel do card mostra em qual loja a Yampi autorizou a Toca.

O que a Toca acessa

Com a conexão ativa, a Toca lê os pedidos por período e por status, com itens, rastreio, notas fiscais, etiquetas e pagamentos; os produtos e SKUs, com preço de tabela, preço promocional, custo e estoque por armazém; as categorias, marcas, coleções, variações e selos; os clientes, os endereços, os clusters e os leads; os carrinhos abandonados; os cupons, promoções, combos, brindes, order bumps e o cashback; as transportadoras e o frete; as páginas, banners e o tema da loja; e os anúncios e erros em marketplaces.

A Toca também altera: muda o status do pedido, informa o rastreio, lança nota fiscal e etiqueta; muda preço e estoque de SKU, um a um ou em lote no produto; cadastra e altera produtos, SKUs, categorias, marcas e coleções; cria e altera cupons, promoções, combos, brindes e descontos; cadastra e altera clientes e leads; confirma, captura ou cancela pagamentos; e ajusta frete, checkout, páginas e banners. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat.

Algumas alterações não se desfazem, e o pedido de aprovação diz isso: cancelar ou recusar um pedido, confirmar, capturar ou cancelar um pagamento, creditar ou debitar cashback de um cliente, mudar quem recebe o split de pagamento, registrar rastreio avisando o cliente, publicar o tema e excluir qualquer cadastro.

Entrando com a Yampi, a Toca pede as permissões de Visualizar e de Gerenciar em cada módulo da loja, porque lê e, com a sua aprovação, altera em todos eles. A tela da Yampi mostra a lista antes de você aceitar.

Por segurança, a Toca não lê as APIs de frete cadastradas nem as contas de marketplace, porque essas telas trazem as senhas de acesso de outros sistemas.

Manutenção da conexão

Entrando com a Yampi, a Toca renova o acesso sozinha: o acesso dura 10 minutos e a renovação, 30 dias, e a Toca renova antes de vencer, mesmo que você passe dias sem usar. Se a Toca ficar mais de 30 dias sem conseguir renovar, ou se você desinstalar o aplicativo da Toca na Yampi, abra o card em Configurações → Integrações pelo botão Gerenciar e clique em Reconectar na Yampi.

O User-Token e a User-Secret-Key não vencem com o tempo, mas a Yampi troca os dois quando a senha do seu usuário no painel muda. Se isso acontecer, copie os novos em Perfil → Credenciais de API, abra o card pelo botão Gerenciar, preencha e clique em Atualizar. Por segurança, o User-Token e a User-Secret-Key salvos aparecem mascarados.

Para trocar de jeito: entrar com a Yampi substitui o User-Token salvo, e salvar o User-Token passa a conexão para ele.

A Yampi limita o número de consultas por minuto (de 30 a 120, conforme o tipo de dado). Em lojas grandes, uma leitura longa pode levar alguns minutos.

Problemas comuns

  • A autorização foi cancelada na Yampi — clique de novo em Entrar com a Yampi e aceite as permissões na tela da Yampi.
  • Entrar com a Yampi não abre a tela de autorização — o aplicativo da Toca ainda pode estar em análise na Yampi. Conecte pelo User-Token enquanto isso.
  • A Toca pede para conectar de novo — a renovação do acesso venceu ou o aplicativo foi desinstalado na Yampi. Clique em Reconectar na Yampi no card.
  • A Yampi recusa o acesso pelo User-Token — confira o alias, o User-Token e a User-Secret-Key, sem espaço sobrando. Se a senha do painel mudou, as credenciais mudaram junto: copie as novas.
  • A Toca diz que a loja é outra — o alias informado é de outra loja do seu usuário. Atualize o card com o alias certo.
  • A consulta demora ou para no meio — a Yampi limita as consultas por minuto. Peça períodos menores ou espere um pouco e tente de novo.
  • Conectou a loja errada — use Excluir integração no menu ⋯ do card e conecte de novo, com a loja certa.

Outras integrações de lojas virtuais

Abrir integrações no app