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.
- Com o painel aberto, acesse
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Shoppub e clique em Conectar.
- 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.
- Domínio da loja: o endereço da loja como aparece no navegador, como
- 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.