Pular para o conteúdo

Conectando a Irroba

Lojas virtuaisConexão: credenciaisAtualizado em

Ver o que a Toca faz com o Irroba →

Em homologação

Abrir integrações no app

A conexão com a Irroba usa três dados: o ID da loja e um usuário e uma senha de API. Os três saem do próprio painel da Irroba, sem precisar falar com o suporte. Com eles, a Toca entra na API da sua loja a cada consulta.

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 Irroba.
  • Crie um usuário de API só para a Toca, em APS → Usuários → Usuário API, com Adicionar. Anote o usuário e a senha. Não reaproveite o usuário de outro sistema (ERP, hub de marketplaces): se os dois usarem o mesmo, um pode derrubar o acesso do outro.
  • Anote o número do Minha Loja ID, que aparece no topo do painel da Irroba (por exemplo, 14444).

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card Irroba e clique em Conectar.
  3. Preencha os três campos:
    • ID da loja — só os números do Minha Loja ID, como 14444.
    • Usuário de API — o usuário que você criou em APS → Usuários → Usuário API.
    • Senha de API — a senha desse usuário.
  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 e por status, com itens, totais, frete, rastreio, histórico de status e notas fiscais; os produtos, com grade, estoque de cada variação, preço, custo, promoções e preços por marketplace; as categorias, marcas e opções de estoque; os clientes, os grupos de clientes e os endereços; os carrinhos abandonados; os cupons; os afiliados; as notas fiscais emitidas; e a lista de separação.

A Toca também altera: muda preço, custo e preços por marketplace; muda o estoque de uma variação, por referência ou em lote, e a grade do produto; muda o status do pedido, com rastreio e aviso ao cliente; anexa nota fiscal, nota de devolução e declaração de conteúdo ao pedido; registra trocas e devoluções; cadastra, altera, exclui e restaura produtos e imagens; cria e altera categorias, marcas e opções; cria cupons; cadastra e altera clientes, grupos e endereços; e cadastra e altera afiliados. 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, negar, devolver ou estornar um pedido, excluir um produto de vez, excluir imagem ou variação, alterar produto mandando imagens, promoções ou categorias novas (as atuais são substituídas), enviar a nota fiscal por e-mail ao cliente e mudar a conta ou o PIX de um afiliado.

Manutenção da conexão

A Toca troca o usuário e a senha por um acesso temporário da Irroba, que vale 30 minutos, e renova sozinha. A conexão vale enquanto o usuário de API existir e a senha for a mesma. Se você trocar a senha ou o usuário no painel da Irroba, abra o card em Configurações → Integrações pelo botão Gerenciar, preencha os dados novos e clique em Atualizar. Por segurança, a senha salva aparece mascarada.

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

Problemas comuns

  • A Irroba não aceita o login — confira o ID da loja (só números), o usuário e a senha de API, sem espaço sobrando. O usuário precisa ser um usuário de API (APS → Usuários → Usuário API), não o login do painel.
  • A conexão cai de vez em quando — provavelmente outro sistema usa o mesmo usuário de API. Crie um usuário só para a Toca e atualize o card.
  • A consulta demora ou para no meio — o plano da loja 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 ID da loja certa.

Outras integrações de lojas virtuais

Abrir integrações no app