Magis5 no Konektor: conectar passo a passo

Cole a chave da API pública do Magis5, informe o canal dos pedidos e decida quem manda no estoque antes de ligar a sincronização.

Publicado em 26/10/2026
Equipe do Interago

Boa notícia para quem vende em marketplaces pelo Magis5: o hub agora tem card próprio no Konektor. Você cola a chave da API pública do Magis5, informa o canal que recebe os pedidos da loja e escolhe o que vai e o que volta: produtos, fotos, pedidos e estoque. Este guia mostra onde pegar a chave, como preencher cada aba e por onde começar com segurança.

O Magis5 é um hub de marketplaces do grupo Sankhya. No Konektor ele aparece com o logo da marca, na categoria de hubs de marketplace.

Procure este logo no card Magis5, em Integrações do Konektor.

Um aviso importante e animador: a integração com o Magis5 está em fase de testes. No Konektor, o card aparece com a etiqueta Alpha e o aviso Em testes. Use com acompanhamento. Pode conectar com tranquilidade, só acompanhe de perto os primeiros pedidos e as primeiras sincronizações. Se surgir qualquer dúvida, chame a equipe Interago, que está por perto para ajudar.

Para quem é

Para lojas que já usam o Magis5 para anunciar e vender em marketplaces e querem que o catálogo e os pedidos da loja Interago também passem pelo hub, com o estoque alinhado entre os dois lados.

Em uma frase

No Magis5 você copia a chave em Aplicativos → API pública, cola no campo Chave de API da aba Acesso do Konektor, informa o Código do canal e Quem manda no estoque? em Configurações, escolhe o que sincronizar e testa com um produto antes de ligar o resto.

Antes de começar

Conta Magis5 ativa, com acesso ao menu Aplicativos.
Um canal de venda no Magis5 para os pedidos da loja Interago. O código dele fica em Canais de venda, no painel do Magis5.
Produtos com SKU preenchido na loja e no Magis5. É o SKU que liga um produto ao outro.
Uma decisão tomada: quem manda no estoque, o Magis5 ou a loja. Veja a Parte 4 antes de salvar as configurações.
Ritual de segurança lido: Konektor: pegar token e preencher Acesso com segurança.

Mapa: Konektor: mapa e quando usar (TagPlus, Olist, iTools Hub e API).

Fluxo Interago: Como conectar um sistema no Konektor.

Parte 1: onde pegar a chave no Magis5

Entre no painel do Magis5 com um usuário que administre a conta.
Abra Aplicativos e depois API pública.
Gere ou copie a chave da API. A chave já nasce ligada a um ambiente (teste ou produção): use a de produção para a loja de verdade.
Guarde a chave só pelo tempo de colar no Konektor. Ela dá acesso aos dados da conta.

Fonte pública: documentação para desenvolvedores do Magis5, artigo sobre como conseguir um token para integrar a API.

No painel da loja, abra Extensões → Konektor (Integração com Sistemas).
Entre em Integrações e localize o card Magis5.
Clique em Conectar (ou Configurar, se já existir conexão).

Aba Acesso

Cole a chave no campo Chave de API e clique em Salvar acesso. Depois de salva, o campo mostra Já configurado. Preencha só para trocar: deixe em branco para manter a chave atual.

Aba Configurações

Campo	O que colocar
Código do canal	O código do canal que recebe os pedidos da loja, copiado de Canais de venda no Magis5. Sem ele nenhum pedido é enviado.
Situação do pedido ao entrar no hub	Aprovado (padrão), Aguardando separação ou Aguardando nota. Aguardando separação deixa o pedido pronto para o faturamento do ERP no Magis5.
ID do depósito	Opcional. Em branco, vale o estoque único do produto. Preenchido, a loja lê e envia o saldo só desse depósito.
Quem manda no estoque?	Obrigatório e sem valor padrão: A loja (Interago) ou Magis5. O lado escolhido manda, o outro só recebe. Veja a Parte 4.

Clique em Salvar configurações ao terminar.

Aba O que sincronizar

Opção	O que faz	Começa
Sincronizar produtos	Ao salvar um produto na loja, cria o SKU no Magis5 ou atualiza o que já existe. A atualização não mexe nas fotos do hub.	Ligada
Baixar produtos da integração	Importa produtos do Magis5 e vincula pelo SKU. Se o SKU já existe na loja, só cria o vínculo.	Ligada (manual)
Copiar fotos do Magis5	Copia até 6 fotos de cada produto coletado para a pasta Magis5 das mídias da loja. Não troca foto que a loja já tem.	Ligada (manual)
Sincronizar pedidos	Pedido pago na loja entra no Magis5 com a identificação ig- seguida do número do pedido. Cancelamento e envio também são avisados ao hub.	Ligada
Receber estoque	Atualiza a quantidade dos produtos já vinculados a cada 15 minutos, ou na hora pelo botão. O Magis5 passa a mandar no estoque.	Desligada
Enviar estoque da Interago	Manda o saldo da loja ao Magis5 quando ele muda. Não ligue se outro sistema também atualiza o estoque do hub.	Desligada

No topo da aba fica também a chave Dono do estoque, que é a mesma escolha de Quem manda no estoque?. Ligue o que for usar e clique em Salvar sincronizações.

Excluir um produto na loja só desfaz o vínculo com o Magis5. O cadastro no hub continua lá.

Abas Webhook e Situação

Webhook: o Magis5 não envia avisos automáticos para a loja. O estoque chega pela agenda de 15 minutos ou pelo botão, e não há nada para configurar nesta aba.
Situação: use depois de salvar para ver a saúde da conexão e os eventos de cada envio. Guia: Konektor: como ler a aba Situação e eventos sem pânico.

Parte 3: salvar e primeiras ações

Confira se Salvar configurações e Salvar sincronizações foram clicados.
Se o catálogo nasce no Magis5, use Coletar produtos do Magis5 no bloco Ações manuais. A lista mostra o que já está vinculado à loja; escolha os itens e importe, até 100 por vez.
Depois da coleta, use Copiar fotos agora se quiser trazer as fotos dos anúncios.
Se o catálogo nasce na loja, use Enviar produtos, escolha os itens e envie.
Teste com um produto: confira o vínculo, o estoque e, se possível, faça um pedido de teste e veja se ele aparece no canal certo do Magis5.

Ritual completo de catálogo: Konektor: sincronizar produtos (coletar do ERP e enviar da loja).

Parte 4: estoque, decida quem manda

O ponto mais importante desta integração é não deixar dois sistemas brigando pelo mesmo saldo. Por isso o campo Quem manda no estoque? vem sem valor padrão: enquanto ninguém escolher, o Konektor não sincroniza o estoque em nenhuma direção e o painel avisa Defina quem manda no estoque nas configurações desta integração.

O Magis5 manda: escolha Magis5 e ligue Receber estoque. A loja passa a copiar a quantidade do hub a cada 15 minutos. Para atualizar na hora, use Receber estoques em Ações manuais. Nesse caso, Enviar estoque da Interago fica bloqueada, porque enviar sobrescreveria o saldo correto.
A loja manda: escolha A loja (Interago) e ligue Enviar estoque da Interago. Cada mudança de saldo na loja vai para o Magis5, e Receber estoque fica bloqueada. Só faça isso se nenhum outro sistema, como o ERP, também atualiza o estoque do hub.

Estoque só anda para produtos vinculados: veja Konektor: o que é produto vinculado e por que estoque e pedido dependem disso.

Parte 5: pedidos e produtos com variações

Pedidos

Só pedido pago entra no Magis5, na situação escolhida em Situação do pedido ao entrar no hub.
Cada item precisa ter SKU e estar vinculado ao Magis5. Se faltar, o envio daquele pedido falha e o evento diz qual produto importar ou enviar antes.
Pedido cancelado antes de chegar ao hub não é enviado.
Sem o Código do canal, o evento pede para informar o canal na conexão.

Variações (tamanho, cor, voltagem)

A coleta não monta grade sozinha. Cadastre na loja o produto com as opções e dê a cada opção final o mesmo SKU da variação no Magis5. Depois colete de novo: o Konektor liga cada variação à opção com o mesmo SKU, e o estoque passa a andar por opção.

Checklist

Chave da API pública colada e Salvar acesso feito.
Código do canal preenchido em Configurações.
Quem manda no estoque? escolhido, com a opção de estoque do lado certo ligada.
Produtos com SKU igual na loja e no Magis5.
Um produto testado do começo ao fim, com a aba Situação sem erro.

O que este artigo não cobre

Nota fiscal e código de rastreio vindos do Magis5.
Pedidos feitos nos marketplaces entrando na loja Interago. Nesta versão, o caminho é da loja para o hub.
Configuração dos anúncios dentro do Magis5. Para isso, use a central de ajuda do próprio Magis5.

Mais em Integrações

Ver todos

Ritual semanal de estoque com integração ligadaUma conferência semanal de poucos produtos ajuda a perceber diferenças de estoque cedo e a agir somente no...Abrir Como ler um retorno de sincronização sem pânicoSituação, Eventos e um produto piloto ajudam o operador a entender o retorno da integração sem repetir ações...Abrir Como preparar o catálogo Interago antes de conectar qualquer ERPUma revisão simples de produtos, códigos, preços e estoque deixa a loja pronta para conectar um sistema de...Abrir Konektor: como escolher entre coletar do ERP ou enviar da lojaEscolher a origem do catálogo antes da primeira sincronização ajuda a evitar duplicidade, retrabalho e...Abrir Como pausar todos os marketplaces em uma emergência de estoque ou preçoQuando o saldo fica incerto ou um preço errado aparece, a prioridade é interromper novas vendas com calma e...Abrir Como evitar anúncio duplicado no mesmo canalUm produto pode aparecer duas vezes no mesmo marketplace quando a equipe cria um novo cadastro para contornar...Abrir

Relacionados a este artigo

CheckoutCorrigir o endereço de entrega do pedido e do cadastro do clienteAbrir Updates19 a 25 de outubro: Produtos relacionados, Melhor Envio, recusa de cartão explicada e Konektor Magis5Abrir Updates12 a 18 de outubro: Avise-me quando chegar, busca da vitrine, estoque sem saldo negativo e catálogo Bling no KonektorAbrir

Explorar a Central de Ajuda

Updates Todos os tópicos