Pular para o conteúdo

Conectando a Shoppub

Lojas virtuaisConexão: credenciaisAtualizado em

Ver o que a Toca faz com o Shoppub →

Em homologação

Abrir integrações no app

A conexão com a Shoppub usa dois dados: o domínio da sua loja e um token de API. O token sai do próprio painel da Shoppub, sem precisar falar com o suporte, e é você quem decide, bloco a bloco, o que ele pode ler e alterar. A API da Shoppub fica no domínio da sua loja, e a Toca só conversa com o domínio que você cadastrar.

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

Antes de começar

  • Tenha acesso de administrador ao painel da sua loja na Shoppub.
  • Anote o domínio da loja exatamente como ele aparece no navegador, com ou sem www (por exemplo, www.sualoja.com.br). A loja responde num dos dois e só redireciona o outro.
  • Crie o token de API:
    • Com o painel aberto, acesse https://www.sualoja.com.br/shoppub-v2/clientes/clienteapiproxy/, trocando pelo domínio da sua loja, e clique em Adicionar Usuário API.
    • Em Loja, escolha a sua loja. Em Nome completo, use um nome que identifique o acesso, como Toca. Deixe Seller em branco.
    • Nas permissões, marque Obter em todos os blocos que a Toca vai ler (Produtos, Pedidos, Clientes, Carrinhos, Cupons, Inventário e os demais). Se quiser que a Toca também altere, marque Adicionar, Editar ou Excluir só nos blocos em que isso fizer sentido para você.
    • Clique em Salvar e copie o token que o painel mostra. Trate o token como uma senha.

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card Shoppub e clique em Conectar.
  3. Preencha os dois campos:
    • Domínio da loja: o endereço da loja como aparece no navegador, como www.sualoja.com.br.
    • Token de API: o token que você copiou do painel da Shoppub.
  4. Clique em Salvar. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê os pedidos por período de criação, de pagamento e por status, com itens, valores, frete, rastreio e notas fiscais; os produtos e as variações, com preço de e por, custo e estoque; o estoque por centro de distribuição; as categorias, marcas, cores e grupos de produtos; os clientes e os grupos de clientes; os carrinhos abandonados; os cupons; e os contatos da newsletter e do formulário de contato da loja.

A Toca também altera: muda preço, estoque e outros dados de um ou de vários produtos de uma vez (até 50 por envio), pelo SKU; ajusta o estoque por centro de distribuição; cadastra e exclui produtos e imagens; cria, altera e exclui categorias, marcas, cores e grupos; cria, altera, desativa e exclui cupons; cadastra clientes e altera ou bloqueia um cliente; muda o status do pedido; envia e tira o código de rastreio, marcando o pedido como despachado; anexa a nota fiscal ao pedido; e cria pedidos. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat, e só nos blocos em que o token tem permissão.

Algumas alterações não se desfazem, e o pedido de aprovação diz isso: cancelar um pedido (a Shoppub não volta pedido cancelado para outro status) e excluir produto, imagem, categoria, marca, cor, grupo ou cupom.

Manutenção da conexão

O token da Shoppub não expira: a conexão vale enquanto o usuário de API existir no painel. Se você apagar o usuário, criar um token novo ou mudar o domínio da loja, abra o card em Configurações → Integrações pelo botão Gerenciar, preencha os dados novos e clique em Atualizar. Por segurança, o token salvo aparece mascarado.

Para liberar ou tirar uma permissão, edite o usuário de API no painel da Shoppub. Não precisa reconectar na Toca.

A Shoppub aceita até 120 consultas por minuto. Em lojas grandes, uma leitura longa pode levar alguns minutos.

Problemas comuns

  • A Shoppub recusa o token: confira se o token foi colado inteiro, sem espaço sobrando, e se o usuário de API ainda existe no painel.
  • A Toca não encontra a loja: confira o domínio. Use o endereço exatamente como abre no navegador, com ou sem www, sem / no fim.
  • A Toca lê, mas não consegue alterar: o token não tem a permissão daquele bloco. No painel, edite o usuário de API e marque Editar ou Adicionar onde quiser que a Toca altere.
  • A consulta demora ou para no meio: a Shoppub 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 o domínio e o token da loja certa.

Outras integrações de lojas virtuais

Abrir integrações no app