A conexão com o marketplace Magalu é feita por login (OAuth) no Magalu ID (id.magalu.com): você autoriza a Toca na tela do próprio Magalu e escolhe ali qual seller a conexão vai representar, sem digitar chave ou token.

Antes de começar

• Tenha em mãos o login do Magalu ID que administra o seller no marketplace.
• Se o seu usuário responde por mais de um seller, saiba qual deles quer conectar — a escolha é feita na tela de autorização do Magalu.
• Verifique se o navegador não está bloqueando pop-ups ou redirecionamentos.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Magalu e clique no botão de conexão.
3. Você será redirecionado para o login do Magalu ID. Entre com sua conta, se ainda não estiver conectado.
4. Escolha o seller que a Toca vai representar e autorize as permissões de leitura solicitadas.
5. Você volta automaticamente para a Toca com o card marcado como conectado. O seller escolhido fica gravado com a conexão.

O que a Toca acessa

Com a conexão ativa, a Toca lê o catálogo (SKUs), preço, estoque, pedidos, entregas, notas fiscais e a análise financeira do seller — receita líquida, comissões, taxas e subsídios. O acesso é somente leitura: a conexão pede apenas permissões de leitura, e a Toca não cria nem altera nada no Magalu. A publicidade do Magalu (Magalu Ads) não entra nesta integração: a plataforma não expõe esses dados por API.

Manutenção da conexão

O token de acesso do Magalu tem validade curta e a Toca o renova automaticamente — você não precisa reconectar de tempos em tempos. Se a autorização for revogada no Magalu, o card em Configurações → Integrações passa a indicar que a conexão precisa ser refeita — basta autorizar novamente e escolher o seller de novo.

Problemas comuns

• Escolheu o seller errado na autorização — o seller selecionado fica gravado com a conexão. Refaça a conexão pelo card e escolha o seller correto na tela do Magalu ID.
• Consultas retornam acesso negado — acesso negado costuma ser permissão de escopo ou de seller no Magalu, não conexão vencida. Confira no Magalu se o seu usuário tem acesso ao seller conectado antes de refazer a conexão.
• A tela de login do Magalu ID não abre — desative o bloqueio de pop-ups e redirecionamentos do navegador e tente novamente.
• O card indica que a conexão precisa ser refeita — a autorização foi revogada no Magalu. Reconecte pelo card.