Novo Módulo - Integração com Marketplaces
Patch Notes - Integração com Marketplaces
Novo
O módulo Marketplace integra sua loja Magento 1 ao magehub, um hub de marketplaces brasileiro. Com ele, você exporta seus produtos para Mercado Livre, Shopee, Amazon e outros canais, sincroniza preços e estoque automaticamente e importa os pedidos diretamente para o painel da loja — sem precisar acessar cada marketplace separadamente.
O que o módulo faz
- Exporta produtos simples e configuráveis para o magehub com imagens, atributos e markup de preço por canal
- Sincroniza preço e estoque automaticamente sempre que há alteração na loja, sem nenhuma ação manual
- Importa pedidos de todos os marketplaces conectados direto para o Magento, com cliente e endereço criados automaticamente
- Envia confirmação de pedido, dados de NF-e, código de rastreamento e confirmação de entrega ao marketplace automaticamente
- Cancela pedidos no marketplace quando cancelados no Magento, e vice-versa
- Cria e gerencia anúncios do Mercado Livre diretamente pelo painel da loja
- Exibe o canal de venda de origem em todas as telas de pedido do admin
- Registra um histórico completo de eventos por pedido e logs de todas as operações
Onde fica
Configurações
Sistema → Configuração → MageShop → Marketplace
Painel do módulo
Marketplace (menu lateral → Produtos, Mercado Livre, Fila de Pedidos, Logs)
Configurações disponíveis
Configurações — Credenciais da API
| Campo | Descrição |
| Produção | Alterna entre o ambiente de sandbox e produção da API magehub. |
| Token de Acesso | Token JWT de acesso à API. Renovado automaticamente a cada 15 horas pelo módulo. |
| Token de Atualização | Token usado para renovar o Token de Acesso automaticamente. Obtido no painel do magehub. |
| Header Secreto do Webhook | JSON com o header de autenticação do webhook. Deve conter o campo Storecode. Exemplo: {"Storecode": "minha-loja"} |
Exportação de Produtos
| Campo | Descrição |
| Ativado | Ativa o cron de exportação de produtos (executa a cada 1 minuto). |
| Loja Padrão | Loja de origem dos dados dos produtos exportados. Se vazio, usa todos os dados da loja padrão. |
| Canais de Vendas | Obrigatório. Canais de venda (marketplaces) de destino dos produtos exportados. |
| Markup por Canal | Percentual de markup de preço por canal. Exemplo: Shopee +15%, Mercado Livre +10%. |
| Ativar Markup na Exportação? | Aplica o markup configurado nos preços enviados durante a exportação. |
| Enviar imagens? | Inclui as URLs das imagens do produto no payload de exportação (GIF, JPG, PNG). |
| Obter imagens do produto principal? | Para produtos configuráveis, usa as imagens do produto pai ao invés das variações. |
| Enviar imagem em base64? | Envia as imagens em formato base64. Reduz o limite de exportação para 5 produtos por execução. |
| Limite de registros por execução | Quantos produtos são exportados por execução do cron. Máximo: 10. |
Sincronização de Preço e Estoque
| Campo | Descrição |
| Ativado | Ativa a sincronização automática de preço e estoque. |
| Sincronizar Preço | Monitora alterações de preço e preço especial nos produtos e envia ao marketplace. |
| Sincronizar Estoque | Monitora alterações de estoque e atualiza no marketplace automaticamente. |
| Obter Preço do Produto Configurável | Para produtos configuráveis, usa o preço do produto pai nas atualizações. |
| Método de Precificação | Define como o preço final é calculado. Também aplicado durante a exportação. |
| Atualizar Preços dos Anúncios Automaticamente? | Além do preço base, atualiza também os preços de listing nos marketplaces. |
| Aplicar markups na atualização? | Aplica o markup configurado nas atualizações de preço de listing. |
Anúncios do Mercado Livre
| Campo | Descrição |
| Ativado | Ativa as tarefas em segundo plano para gerenciar anúncios do Mercado Livre. |
| Seller ID | ID do vendedor no Mercado Livre, necessário para criação de anúncios. |
| Tipo de Anúncio Padrão | Tipo padrão de anúncio: CLASSICO ou PREMIUM. |
| Markup % | Margem percentual específica para ajustar preços dos anúncios do ML. |
Importação de Pedidos
| Campo | Descrição |
| Importar Pedidos | Ativa a importação automática de pedidos dos marketplaces. |
| Loja Padrão | Loja onde os pedidos e clientes importados serão criados. |
| Gerar Faturas Automaticamente | Gera fatura automaticamente para pedidos com pagamento aprovado. |
| Cancelar Automaticamente | Pedidos cancelados no marketplace também são cancelados na loja. |
| Criar Pedidos como Convidado | Cria o pedido sem criar uma conta de cliente. Útil para reduzir cadastros desnecessários. |
| Sempre Criar Pedidos | Cria o pedido mesmo que algum produto não esteja cadastrado na loja. Se Não, pedidos com SKUs não integrados são ignorados. |
| Método de Confirmação de Faturamento | Define de onde os dados de NF-e são lidos: por comentário no pedido (formato estruturado) ou via módulo MageShop_OrderFiles. |
| Canais com dados tardios do cliente | Canais que não liberam dados reais do comprador até a aprovação do pagamento (ex: SHOPEE, SHEIN). O módulo atualiza os dados do cliente automaticamente quando o pagamento é aprovado. |
| Importar os últimos 50 pedidos | Botão que força a importação imediata das últimas 50 ordens ainda não integradas. |
Mapeamento de Status do Pedido
| Campo | Descrição |
| Status para Pagamentos Pendentes | Status do Magento usado ao criar pedidos com pagamento pendente. |
| Status para Pagamentos Aprovados | Status do Magento que representa pagamento aprovado. Usado para gerar fatura automaticamente. |
| Status para Pedidos Faturados | Status do Magento que dispara o envio dos dados de NF-e ao marketplace. |
| Status para Pedidos em Envio | Status do Magento que dispara o envio do código de rastreamento ao marketplace. |
| Status para Pedidos Entregues | Status do Magento que dispara a confirmação de entrega ao marketplace. |
Principais vantagens
- Centraliza a gestão de todos os marketplaces em um único painel: sem acessar cada plataforma separadamente
- Sincronização automática de preço e estoque em tempo real, sem processos manuais
- Importação de pedidos via cron (polling) e via webhook, garantindo agilidade na integração
- Ciclo de vida completo do pedido: confirmação, NF-e, rastreamento, entrega e cancelamento bidirecional
- Suporte a Mercado Livre com gestão de anúncios, markup específico e sincronização de listings
- Markup de preço por canal de venda — cada marketplace pode ter sua própria margem configurada
- Logs detalhados de todas as operações diretamente no painel do admin, com filtragem por tipo e status
Quer integrar sua loja aos principais marketplaces?
Entre em contato com a equipe mageshop e saiba como ativar o módulo Marketplace com magehub.
Fale com a mageshop