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