O Sage X3 é um ERP poderoso para industriais e distribuidores do mid-market. Gere ordens de fabrico, existências, compras e contas multi-entidade com precisão. O problema? Foi concebido numa altura em que o on-premise era a norma, e os seus dados continuam a viver inteiramente numa instância de SQL Server na rede da sua empresa — o que torna a analítica na cloud penosa.
O problema: dados presos on-premise
As equipas financeiras querem painéis no Power BI ou numa plataforma analítica dedicada. Os diretores comerciais querem o pipeline de encomendas em tempo real no telemóvel. Os CFO querem relatórios consolidados multi-entidade que não exijam uma maratona de Excel a cada fecho mensal.
Nada disso é simples quando a fonte de verdade é uma base de dados on-premise que só fala SQL Server. Todos os contornos habituais têm inconvenientes sérios.
As abordagens tradicionais — e porque ficam aquém
Os túneis VPN são a primeira coisa que o departamento de TI propõe. Abre-se uma brecha na firewall, liga-se a cloud à rede interna e consulta-se a base de dados diretamente. Funciona — até que uma auditoria de segurança o descubra, ou até que o cliente VPN avarie depois de uma atualização do Windows. A carga de manutenção é pesada e a superfície de ataque é real.
As API de middleware à medida consistem em construir uma camada REST à frente dos dados do Sage X3. Se a sua organização tem equipa de desenvolvimento, é viável. Os custos escondidos são a manutenção a longo prazo, as atualizações de versão do Sage que quebram as suas consultas e os meses de desenvolvimento até obter o primeiro gráfico.
As exportações de ficheiros por SFTP são o caminho de menor resistência: exportar CSV ou XML todas as noites, enviar para armazenamento na cloud e depois ingerir a partir daí. Fica com uma analítica sempre com 24 horas de atraso e com toda a fragilidade de esquema própria dos pipelines de ficheiros planos.
A abordagem por agente
Um binário leve a correr dentro da sua rede muda a equação por completo. O agente liga-se diretamente à base de dados SQL Server do Sage X3, lê as entidades que configurar (clientes, faturas, artigos, guias de remessa) e envia os dados para o exterior por HTTPS para a plataforma cloud que escolher.
A diferença arquitetural decisiva: todo o tráfego é de saída. Sem portas de entrada, sem exceções na firewall, sem VPN. O seu perímetro mantém-se intacto. O agente inicia a ligação segundo o seu horário e publica JSON estruturado num endpoint de API seguro.
Passo a passo: de zero a uma sincronização em direto
Passo 1 — Transferir e instalar
Transfira o binário do agente para o seu sistema operativo (o Windows Server é o anfitrião Sage X3 mais comum). O binário é um executável autónomo — sem dependências de execução, sem Node.js, sem JVM. Execute-o como serviço do Windows para que sobreviva aos reinícios.
Passo 2 — Configurar a ligação
Crie um config.json com a sua cadeia de ligação ao SQL Server, o URL do seu endpoint de API e a sua chave de API. A chave de API é guardada como hash SHA-256 do lado do servidor — o texto em claro nunca sai da sua máquina depois da configuração inicial.
Passo 3 — Executar a descoberta
Execute o agente com a opção --discover. Ele inspeciona o esquema do Sage X3, lista as entidades disponíveis e o respetivo número de linhas, e devolve o relatório. Este passo confirma a conetividade e permite-lhe decidir exatamente que dados quer sincronizar.
Passo 4 — Sincronização inicial e sincronização delta contínua
A primeira sincronização carrega o histórico até ao período configurado (normalmente 24 a 36 meses). As sincronizações seguintes são apenas em delta: o agente segue last_synced_at por entidade e só vai buscar as linhas alteradas desde a execução anterior. Isto mantém a largura de banda no mínimo e evita qualquer carga significativa no SQL Server do Sage X3.
Arquitetura de segurança
Para além do desenho exclusivamente de saída, o agente impõe credenciais de base de dados só de leitura. Crie um login de SQL Server dedicado com a permissão SELECT sobre o esquema do Sage X3 e mais nada. Mesmo que a chave de API fosse comprometida, um atacante não conseguiria escrever no seu ERP.
Todos os dados em trânsito usam TLS 1.2 ou superior (TLS 1.3 onde for suportado). A API do lado do servidor valida o hash da chave de API em cada pedido. Os pedidos sem chave válida recebem um 401, sem qualquer fuga de informação.
O que pode fazer assim que os dados estiverem na cloud
Com os dados do Sage X3 a chegar a uma plataforma cloud, os casos de utilização abrem-se de imediato:
- Painéis em tempo real para os diretores comerciais — entrada de encomendas, estado das entregas, melhores clientes por faturação
- Sinalização de anomalias em faturas e pagamentos — pagamentos em duplicado, montantes de fornecedor invulgares, desvios de calendário
- Demonstração de resultados consolidada multi-entidade sem folhas de cálculo, com conversão cambial automática
- Inteligência entre filiais — produtos vendidos numa entidade e ainda não noutra, correspondência de clientes entre sucursais
- Atribuição da faturação ligando a atividade de visitas dos comerciais de terreno às encomendas no Sage X3
A integração não é um fim em si mesma. O valor está no que passa a ser possível quando os seus dados de ERP deixam de estar fechados no seu centro de dados.