Guia de conectividade - Sistema ERP via magehub
Este guia explica, de forma simples e direta, como funciona a conexão entre a sua loja virtual mageshop e o seu sistema de gestão (ERP) quando a integração é feita através do magehub, plataforma da tryideas que funciona como ponte entre os dois sistemas. Você vai entender as opções disponíveis e o que precisa providenciar.
Não é necessário conhecimento técnico para ler este documento. Se tiver dúvidas, a equipe mageshop está à disposição.
1. Como funciona esta integração
A loja virtual e o Sistema ERP precisam trocar informações em tempo real: pedidos, estoque, preços, cadastros e notas fiscais.
Neste modelo, a comunicação é feita por uma plataforma chama magehub. Que funciona como uma ponte inteligente entre os dois sistemas. A loja virtual abre a API (portão) e o Sistema ERP também (API ou Webservice), e esta plataforma se conecta em ambos os sistemas/plataformas, para realizar a comunicação e toda a troca de dados com a loja virtual.
Para que o magehub consiga acessar o webservice/API, ele precisa saber o endereço do seu servidor — ou seja, o seu IP público (externo). O fluxo fica: Loja virtual (API) ↔ magehub ↔ Sistema ERP (via webservice ou API).
2. Onde o ERP deve estar hospedado
Antes de escolher o tipo de IP, existe uma decisão importante: onde o webservice/API do ERP vai estar instalado/rodar.
2.1 Servidor local (na empresa)
O ERP roda em um computador ou servidor físico dentro da sua empresa.
-
Depende da energia elétrica e do link de internet da empresa.
-
Se a máquina for desligada (falta de luz, manutenção, falha de hardware), a integração para.
-
Se o servidor estiver desligado (por estar fora do horário comercial), a sincronização automática em minutos não acontece. Então pedidos, estoque, preços não serão processados entre o Sistema ERP e a loja virtual.
Cenário real — Desempenho: já tivemos clientes cujo servidor local não suportava o volume de consultas da API, causando lentidão e quedas. Vendas de madrugada e finais de semana só eram processadas na segunda-feira, gerando atrasos na separação e no faturamento.
Cenário real — Estoque: se a integração for interrompida e ninguém perceber, um produto pode ser vendido fisicamente na loja e continuar disponível no site. Isso gera venda duplicada, frustração do cliente online e retrabalho para cancelar/estornar o pedido.
2.2 Servidor em nuvem (recomendado)
O ERP roda em um servidor hospedado em um datacenter profissional, acessível 24h por dia, 7 dias por semana.
-
Servidor sempre online, mesmo fora do horário comercial
-
Vendas de madrugada e finais de semana processadas em tempo real
-
Maior capacidade para suportar consultas da API sem lentidão
-
Infraestrutura com energia redundante e links dedicados
-
Estoque sempre sincronizado, reduzindo risco de venda duplicada
Recomendação: para operações de e-commerce, recomendamos fortemente que o ERP esteja em nuvem. Garante disponibilidade contínua e elimina riscos de infraestrutura local.
3. Opções de conectividade
O magehub precisa de um endereço para acessar o webservice/API do ERP. Existem duas opções:
3.1 Opção A — IP Dinâmico com DDNS
Na maioria dos planos de internet, o provedor atribui um IP público que pode mudar automaticamente ao reiniciar o roteador ou por renovação periódica.
Como contornar: com um serviço chamado DDNS (DNS Dinâmico). A integração aponta para um endereço fixo (ex: suaempresa.ddns.net) em vez de um número de IP. Quando o IP muda, o DDNS atualiza automaticamente.
O que é configurado
- Port Forwarding (feito pelo Sistema ERP): uma porta específica no roteador é direcionada ao servidor do ERP.
- DDNS (responsabilidade do lojista): a configuração do DNS dinâmico no roteador deve ser feita por um técnico de rede contratado pelo lojista.
-
magehub (feito pela mageshop): configuramos o magehub para se conectar ao endereço DDNS informado pelo lojista.
Vantagens
-
Sem custo mensal adicional de IP.
-
Funciona na maioria dos provedores e roteadores.
Pontos de atenção
-
Quando o IP muda, pode haver indisponibilidade (segundos a minutos) até o DDNS propagar.
-
Se o roteador for resetado, a configuração de DDNS pode ser perdida.
-
Requer contratação de técnico de rede para configurar o DDNS.
-
Menor segurança — mais difícil restringir acessos por IP.
Cenário real: já tivemos clientes cuja integração parou após queda de energia ou reinicio do roteador. O IP mudou, ninguém percebeu, e os pedidos pararam de chegar ao ERP via magehub. O estoque online ficou desatualizado, com risco de vender produtos já esgotados fisicamente.
3.2 Opção B — IP Fixo (recomendado)
O IP fixo é um endereço público estático contratado junto ao provedor de internet. Nunca muda.
O que é configurado
-
Port Forwarding (feito pelo Sistema ERP): configuração única no roteador.
-
magehub (feito pela mageshop): configuramos o magehub apontando diretamente para o IP fixo. Sem necessidade de DDNS.
Vantagens
-
Integração 100% estável — endereço nunca muda.
-
Configuração única e permanente.
-
Maior segurança — firewall liberado apenas para os IPs da mageshop.
-
Sem dependência de DDNS ou serviços externos.
-
Estoque e pedidos sempre sincronizados em tempo real.
Pontos de atenção
- Custo mensal adicional com o provedor.
- Requer solicitação formal ao provedor de internet.
Recomendação Mageshop: o IP fixo oferece a melhor estabilidade e segurança para e-commerce. O custo mensal é baixo comparado ao risco de pedidos perdidos, estoque desatualizado e retrabalho.
4. Segurança: liberação de acesso
O webservice/API precisa estar acessível pela internet, mas recomendamos restringir o acesso apenas aos servidores da mageshop. Solicite para nossa equipe o IP para liberação de acesso.
Instrução: solicite ao seu técnico de rede ou ao Sistema ERP que libere o acesso ao webservice/API apenas para o IP repassado pela equipe mageshop.
5. Responsabilidades
- Sistema ERP: Setup e hospedagem do webservice; configuração de Port Forwarding; suporte técnico ao ERP.
- mageshop: Configuração do magehub e da integração com a loja virtual; apontamento para o IP ou endereço DDNS; monitoramento do lado da loja e do hub.
- Lojista: Infraestrutura de rede (roteador, link de internet); contratação de IP fixo ou técnico para DDNS; manutenção do servidor/ambiente do ERP.
6. Checklist: IP Fixo
Se você optou pela opção recomendada (IP Fixo), siga este plano de ação:
- Definir onde o ERP (webservice/API) ficará hospedado (servidor local ou nuvem). ✅
- Solicitar ao provedor de internet a ativação do IP fixo.✅
- Aguardar confirmação e anotar o IP fixo atribuído pelo provedor.✅
- Informar o IP fixo para a equipe mageshop (para configuração do magehub).✅
- Confirmar com o Sistema ERP que o webservice/API está ativo e o Port Forwarding configurado. ✅
- Solicitar ao ERP ou ao seu técnico que libere no firewall os IPs da mageshop.✅
- Testar a integração em conjunto com a equipe mageshop. ✅
7. Checklist: IP Dinâmico + DDNS
Se você optou pelo IP dinâmico com DDNS, siga este plano de ação:
- Definir onde o ERP (webservice/API) ficará hospedado (servidor local ou nuvem).✅
- Contratar um técnico de rede para configurar o DDNS no seu roteador.✅
- Escolher um serviço de DDNS (ex: No-IP, DynDNS) e criar a conta.✅
- Confirmar que o DDNS está funcionando e anotar o endereço gerado (ex: suaempresa.ddns.net).✅
- Informar o endereço DDNS para a equipe mageshop (para configuração do magehub).✅
- Confirmar com o Sistema ERP que o webservice está ativo e o Port Forwarding configurado.✅
- Solicitar ao seu técnico que libere no firewall os IPs da mageshop.✅
- Testar a integração em conjunto com a equipe mageshop.✅
- Orientar a equipe interna: se o roteador for reiniciado ou trocado, verificar se o DDNS continua ativo.✅
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br