Integrações / ERP / Sage X3
Guia de integração do Sage X3 com o SkyPlanner APS para programação da produção
Este guia mostra aos parceiros Sage e às equipas de TI como ligar o Sage X3 ao SkyPlanner APS. Explica que interfaces do X3 utilizar, que objetos contêm os dados e onde surgem problemas nos projetos. O SkyPlanner integra-se com o Sage X3 nos dois sentidos, tanto na cloud como em instalações locais:
- São importados ordens de fabrico, operações, gamas operatórias, centros de trabalho, calendários, stock e encomendas de compra em aberto.
- As datas planeadas das operações e os centros de trabalho são gravados nas ordens de fabrico do X3 (GESMFG).
- Os registos de tempos dos operadores são lançados como acompanhamento da produção (GESMTK).
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
A equipa SkyPlanner configura a integração de acordo com a sua instalação do X3 durante a implementação e presta suporte após a entrada em produção.
Se ainda está a avaliar se o X3 precisa de uma ferramenta de programação da produção que respeite a capacidade real das máquinas e dos trabalhadores, comece por ler O Sage X3 dispõe de programação da produção? Para conhecer o produto, consulte SkyPlanner APS para Sage X3. Para outros ERP, consulte a página de integrações com ERP.
O papel do SkyPlanner num ambiente X3
A programação padrão do Sage X3 (FUNMAUTJ) sequencia as operações com base nos dados das gamas operatórias, mas programa cada ordem de fabrico de forma independente. Um guia de suporte da Sage UK é claro: “does not delay or stagger work orders based on overall resource load.” (não adia nem escalona as ordens de fabrico em função da carga global dos recursos.) A programação da produção que respeita a capacidade disponível dos recursos constitui uma camada separada, para a qual a Sage oferece duas opções:
- Production Scheduler (código de atividade POPS), apenas para instalações locais.
- A interface genérica Finite scheduler (código de atividade GFS), que liga o X3 na cloud ou numa instalação local ao Sage X3 Web Scheduling ou a uma ferramenta de programação de um ISV.
O SkyPlanner assume esse papel como ferramenta externa de programação na cloud, através das API padrão do X3. Por isso, funciona da mesma forma com o X3 na cloud e em instalações locais. O MRP (FUNMRP) continua a criar sugestões de ordens de fabrico e de encomendas de compra. O SkyPlanner sequencia as ordens de fabrico firmes e planeadas em função da capacidade real.
Opções de integração com o Sage X3
O modelo de implementação determina a via a seguir. O Sage X3 na cloud não disponibiliza às aplicações de terceiros nem o sistema de ficheiros da aplicação nem a base de dados. Assim, a integração faz-se através de API ou de um serviço alojado de transferência de ficheiros. Nas instalações locais, é também possível importar ficheiros diretamente e utilizar tabelas intermédias na base de dados do X3.
| Opção | Descrição | Autenticação | Quando utilizar |
|---|---|---|---|
| GraphQL API (Sage X3 Web API) | A “technology of choice” (tecnologia de eleição) da Sage para as APIs do X3; evolui sem versões | JWT (HS256) assinado com o Secret de uma Connected application, com Client ID como iss, URL como aud e um utilizador Syracuse dedicado | Produtos, estabelecimentos, compras e stocks; nós de produção, quando expostos |
| REST api1 | REST baseado em representações: .../api1/x3/$$prod/<FOLDER>.<ENTITY>?representation=<REP>.$query | Autenticação Syracuse | Entidades não abrangidas pelo GraphQL |
| Serviços web SOAP de objetos | Objetos publicados em Web services (GESAWE); os campos correspondem aos campos do ecrã do objeto; leitura, gravação e alteração | OAuth2 nos pools de ligações Syracuse | Gravação dos dados de retorno em Work order (GESMFG) e Production tracking (GESMTK) |
| SOAP Template Services | Modelos de importação/exportação por SOAP através de AOWSIMPORT e AOWSEXPORT | OAuth2; o X3 não permite autenticação básica para SOAP | Execução de modelos a partir de middleware |
| Modelos de importação/exportação | Ficheiros para processamento em lote com base em modelos | Sistema de ficheiros (instalação local) ou serviço alojado de transferência de ficheiros (cloud) | Carregamentos iniciais e sincronização noturna de grandes volumes de dados |
| Sync API (Cloud BI) | Apenas na cloud: extração incremental só de leitura e fluxo NDJSON; disponível mediante pedido ao seu representante Sage ISV | Token Bearer e X-API-KEY por tenant | Leitura de grandes volumes de alterações na cloud |
Numa instalação local, o GraphQL exige que se adicione "bearer" ao array session.auth em nodelocal.js. No Sage X3 SaaS, a autenticação de aplicações ligadas está ativa por predefinição. No Sage X3 Cloud, a aplicação ligada não pode utilizar o utilizador admin: em vez disso, crie um utilizador Syracuse com autenticação Standard.
Que interface usar para cada fluxo
- Produtos, estabelecimentos, compras e stock: GraphQL, tal como nos exemplos oficiais da Sage.
- Ordens de fabrico, operações, gamas operatórias e centros de trabalho: representações REST api1 ou modelos de exportação executados através de AOWSEXPORT. Nas versões cujo esquema GraphQL expõe o domínio de produção (
xtremX3Manufacturing), a integração lê os mesmos dados por essa via. - Gravação de datas das operações e centros de trabalho no X3: serviço Web SOAP de Work order (GESMFG), operação modify. Alternativa: modelo de importação através de AOWSIMPORT.
- Acompanhamento da produção: serviço Web SOAP de Production tracking (GESMTK), operação save.
Esta arquitetura funciona tanto com o X3 na cloud como em instalações locais, pois não exige acesso direto ao sistema de ficheiros nem à base de dados. Não é instalado nada no X3: a integração utiliza uma aplicação ligada, um utilizador Syracuse e serviços Web publicados em GESAWE.
Eventos: conte com consultas periódicas
A documentação pública da Sage para programadores X3 não descreve qualquer funcionalidade de webhooks de saída ou de eventos de negócio. A definição “Callback URL”, adicionada em 2024 R1, serve o Mobile Automation e o Web Scheduling quando estes chamam serviços Web SOAP. Não é um sistema genérico de eventos. Detete alterações através de leituras agendadas: consultas GraphQL, o cursor temporal da Sync API na cloud ou exportações periódicas por modelos.
Mapeamento de dados: do Sage X3 para o SkyPlanner
| Objeto Sage X3 (tabela, função) | Objeto SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Produto, ITMMASTER | Produto | X3 → SkyPlanner | Carga inicial, depois por agendamento |
| BOM de produção (GESBODP) | Estrutura de produto multinível, materiais | X3 → SkyPlanner | Carga inicial, depois a cada alteração |
| Gama operatória (GESROU): OPENUM, centro de trabalho WST, SETTIM, OPETIM, unidade de tempo TIMUOMCOD | Etapas do processo com tempos de preparação e execução | X3 → SkyPlanner | Carga inicial, depois a cada alteração |
| Centro de trabalho (GESMWS, WORKSTATIO): WST, WSTTYP, WSTNBR, EFF, SHR, substitutos com prioridade | Centro de trabalho, eficiência, alternativas | X3 → SkyPlanner | Carga inicial, raramente depois |
| Grupo de centros de trabalho (WCR) | Grupos de centros de trabalho | X3 → SkyPlanner | Carga inicial |
| Estrutura semanal (TWD), horários, grelha de variação de capacidade, DEFDIH | Turnos, turnos de horas extraordinárias, ausências | X3 → SkyPlanner | Carga inicial, depois a cada alteração |
| Ordens de fabrico: MFGHEAD, MFGOPE, com produtos e materiais | Ordem, materiais, etapas do processo | X3 → SkyPlanner | Consulta periódica, 5 a 15 min |
| Stock por estabelecimento | Saldos de stock | X3 → SkyPlanner | Consulta periódica |
| Encomendas de compra (POH): linhas em aberto, data prevista de receção | Material a receber com data prevista de entrega | X3 → SkyPlanner | Consulta periódica, 5 a 15 min |
| Separador Operations de GESMFG: início OPESTR, fim OPEEND, centro de trabalho | Início e fim programados e centro de trabalho escolhido | SkyPlanner → X3 | A cada alteração da programação (webhook) |
| Acompanhamento da produção (GESMTK): tempos das operações, quantidades, acompanhamento de materiais, declaração de produção | Registos de tempos, quantidades, consumo de materiais | SkyPlanner → X3 | A cada confirmação (webhook) |
Importe sempre as ordens de fabrico firmes. Importe também as planeadas se os responsáveis pelo planeamento as quiserem ver no Gantt como carga provisória. As sugestões permanecem no MRP até serem convertidas em ordens de fabrico.
Padrões de integração
1. Carga inicial de dados mestre. Carregue primeiro os centros de trabalho e os calendários e, depois, os produtos, as BOM e as gamas operatórias, pois estas fazem referência aos centros de trabalho.
2. Sincronização de ordens. Consulte periodicamente MFGHEAD e MFGOPE para obter ordens de fabrico novas e alteradas. Faça corresponder cada linha de MFGOPE a uma etapa do processo no SkyPlanner, no centro de trabalho indicado pelo respetivo código WST. Sincronize as encomendas de compra em aberto no mesmo ciclo. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza o stock quando esta é marcada como Delivered. Assim, as verificações de materiais abrangem tanto o stock como os fornecimentos a receber.
3. Gravação da programação no X3. O webhook do SkyPlanner é acionado quando a programação muda. A integração chama a operação modify do objeto Work order (GESMFG), publicado como serviço Web SOAP em GESAWE. Atualiza os campos Start (OPESTR), End (OPEEND) e o centro de trabalho de cada operação alterada. Nas atualizações em lote, os mesmos campos são enviados através de um modelo de importação de ordens de fabrico via AOWSIMPORT. Grave apenas datas e centros de trabalho, nunca quantidades, linhas de BOM ou gamas operatórias.
4. Devolução da máquina escolhida ao X3. Quando existe uma correspondência de um para um entre centros de trabalho, a máquina que o motor escolhe entre as alternativas é devolvida como centro de trabalho da operação. Assim, o X3 regista a máquina que efetivamente executa a tarefa. Quando um centro de trabalho do X3 representa um grupo de máquinas, a fila de trabalho do operador mostra a máquina individual. O X3 recebe o centro de trabalho do grupo e as datas programadas.
5. Confirmações no chão de fábrica. Os operadores registam o trabalho com Mobile Confirmations ou Production Timer. A integração lança cada confirmação através da operação save do objeto Production tracking (GESMTK): o tempo e a quantidade da operação no acompanhamento de operações e, se também o registar aí, o consumo de materiais. O X3 só aceita registos de acompanhamento em ordens de fabrico com o estado Firm. Os componentes têm de estar disponíveis, a menos que a opção Release if shortage (MFGSHTCOD) esteja selecionada na ficha produto-estabelecimento.
6. Sincronização fiável. Use o ID do registo de tempos do SkyPlanner como chave de cada lançamento de acompanhamento e guarde o número de acompanhamento criado no X3, para que um webhook repetido nunca origine um lançamento duplicado. Na consulta periódica seguinte, retire da programação as ordens de fabrico encerradas ou canceladas no X3. Registe as chamadas rejeitadas com a mensagem de erro do X3, em vez de repetir as tentativas sem analisar a causa. Enquanto o X3 estiver inacessível, coloque as alterações em fila para que sejam lançadas por ordem quando voltar a estar disponível.
7. Regras de responsabilidade pelos dados. O X3 é responsável pelo que se fabrica: produto, quantidade, BOM, gama operatória e estabelecimento. O SkyPlanner é responsável por quando e onde: sequência, centro de trabalho e horas de início e fim. Acorde com os responsáveis pelo planeamento que deixem de reprogramar no Planning workbench e de executar FUNMAUTJ nas ordens geridas pelo SkyPlanner. Caso contrário, as suas alterações serão substituídas na próxima gravação no X3.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o arranque do processo. Um projeto Sage X3 inclui:
- Teste com os seus próprios dados. Exporte os centros de trabalho, as gamas operatórias e uma cópia das ordens de fabrico em aberto nesse momento, utilizando os modelos de exportação do X3 ou o Excel, e importe-os em CSV. Ajuste os turnos, as eficiências e as prioridades até o Gantt refletir a realidade.
- Mapeamento de dados mestre. Faça corresponder os centros de trabalho de GESMWS aos centros de trabalho do SkyPlanner e as operações de GESROU às etapas do processo. Mapeie também as unidades de tempo e as estruturas semanais para os turnos. Durante este trabalho, corrija as operações de gamas operatórias sem centro de trabalho, os dias sem horário e as unidades de tempo incorretas.
- Carga inicial. Produtos, BOM de produção, gamas operatórias e centros de trabalho; depois, calendários.
- Sincronização de ordens e encomendas de compra. Aplicação ligada, utilizador Syracuse, consultas GraphQL ou exportações por modelo, e uma tarefa de consulta periódica para ordens de fabrico, stock e encomendas de compra em aberto.
- Escrita da programação no X3. Serviço web SOAP de Work order publicado em GESAWE, com tratamento de erros e registo de eventos.
- Confirmações do chão de fábrica. Envio das Mobile Confirmations para o X3 através do serviço web Production tracking (GESMTK).
- Testes em paralelo com o plano atual. Os responsáveis pelo planeamento comparam os dois planos antes da mudança.
- Entrada em produção. Desative a reprogramação manual no X3 para as ordens geridas pelo SkyPlanner.
Pontos a ter em atenção no Sage X3
- As sugestões não são ordens de fabrico. As sugestões do MRP não têm linhas de operação MFGOPE até serem convertidas em ordens de fabrico planeadas ou firmes. Por isso, programe as ordens convertidas, não as sugestões.
- Lacunas nos calendários. Um dia de trabalho sem horário usa o esquema predefinido DEFDIH. Um dia em branco sem predefinição gera datas e cargas incorretas. Antes de exportar os calendários, atribua um horário a cada dia de trabalho de cada estrutura semanal.
- Cargas por período desatualizadas. Após uma alteração de capacidade ou de calendário, as cargas existentes por período no X3 só são ajustadas depois de reprogramar e executar Recalculate loads (FUNMIWL). Não valide o SkyPlanner com base numa consulta Loads inquiry (CONSMWK) desatualizada.
- No. of resources corresponde à dimensão da equipa. WSTNBR é o número de recursos de que uma operação necessita no centro de trabalho, por exemplo, três pessoas num centro de trabalho de mão de obra. Faça a correspondência com o número de operadores do centro de trabalho no SkyPlanner, que permite programar várias pessoas na mesma tarefa em simultâneo. Nos estabelecimentos que usavam a interface avançada GFS, este valor está definido como 1, conforme exigido pela Sage. Verifique, por isso, onde está registada a dimensão real da equipa.
- As operações de uma gama operatória sem centro de trabalho não podem ser atribuídas a um centro de trabalho no SkyPlanner. Estas operações são sinalizadas na etapa de mapeamento.
- Unidades de tempo e centros de trabalho de substituição. Os tempos das gamas operatórias têm a sua própria unidade de tempo (TIMUOMCOD), e os centros de trabalho de substituição têm uma prioridade. Mapeie ambos explicitamente e repita a verificação do mapeamento após cada atualização do X3.
- Ordens bloqueadas. Se o estabelecimento também usava o Production Scheduler, as ordens aí submetidas têm o estado Being optimized e não podem ser alteradas até serem retiradas da programação (PSOPTFREE). Liberte-as antes da transição.
Quem configura a integração com o Sage X3
O trabalho inclui mapear para o SkyPlanner as suas pastas, convenções das gamas operatórias, estruturas dos centros de trabalho e desenvolvimentos específicos. Inclui também as restrições que o X3 não guarda como dados utilizáveis na programação: matriz de tempos de preparação, ferramentas, número de operadores e recursos alternativos.
- A equipa SkyPlanner configura a integração durante a implementação inicial e presta suporte após a entrada em produção. Cada fábrica usa o X3 de forma diferente, e é aqui que esse conhecimento é aplicado. A equipa liga o seu endpoint X3, na cloud ou em instalações próprias, valida os dados mestre na etapa de mapeamento e regista as rejeições do X3 para acompanhamento. A integração tem um responsável definido desde o primeiro dia, e não precisa de um programador de integração interno.
- O seu parceiro Sage pode participar. O parceiro conhece as suas pastas, códigos de atividade e desenvolvimentos específicos, e pode rever a aplicação ligada, o utilizador Syracuse e as publicações GESAWE em conjunto com a equipa.
- Os seus programadores podem desenvolver a partir desta base. A API REST do SkyPlanner permite ler e escrever ordens, produtos, materiais, etapas do processo e registos de tempo, com autenticação JWT e documentação Swagger/OpenAPI (referência da API). Basta uma chave de API para começar, e o tutorial de integração orienta as primeiras chamadas. A equipa SkyPlanner ajuda quando necessário. A documentação do SkyPlanner abrange produtos e materiais e encomendas de compra. Na Laboratory & Allied, a equipa interna de TI fez grande parte da ligação entre o SkyPlanner e o SAP Business One pelos seus próprios meios, com a ajuda do SkyPlanner.
Porque escolhem as equipas que usam X3 o SkyPlanner para a programação
Escolha o SkyPlanner se quer entrar em produção em semanas, e não após um projeto APS de vários meses.
Escolha o SkyPlanner se quer ter a programação a funcionar antes de concluir a integração.
Durante o período experimental, os responsáveis pelo planeamento programam a partir de ficheiros CSV, enquanto se configura a leitura e a escrita de dados no X3. Assim que a integração entra em funcionamento, substitui a importação de ficheiros.
Escolha o SkyPlanner se quer uma integração com pouca infraestrutura.
Os webhooks enviam alterações de programação e de estado em tempo real, pelo que o middleware só precisa de consultar periodicamente o X3. O motor Arcturus AI calcula a programação em segundos, e o Autopilot reprograma automaticamente quando há alterações na produção.
Escolha o SkyPlanner se precisa de usar os dados do X3 num modelo que represente as restrições reais.
A dimensão das equipas traduz-se em vários operadores num centro de trabalho, e os centros de trabalho de substituição tornam-se máquinas alternativas. A matriz de tempos de preparação permite incluir mudanças de produto dependentes da sequência. As ferramentas são recursos de capacidade finita, pelo que um dispositivo de fixação em uso numa máquina nunca é reservado noutra.
Escolha o SkyPlanner se o acompanhamento da produção deve começar no chão de fábrica.
Os operadores registam o trabalho no telemóvel ou tablet com Mobile Confirmations, Production Timer e Quick Log Mode. Os mesmos registos de tempo são enviados para o X3 como registos de acompanhamento da produção.
Os preços começam nos 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. A integração é orçamentada antecipadamente de acordo com o seu processo e as suas necessidades, juntamente com o plano, para que conheça o custo total antes de começar. Consulte os preços e as funcionalidades, ou inicie o período experimental gratuito de 30 dias, com até 20 centros de trabalho e sem cartão de crédito.
Testemunhos de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos de planear a produção em folhas de cálculo Excel para otimizar a produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de manobra
O planeamento da produção poupa 2 horas de trabalho por semana, e uma nova fila de trabalho chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável de TI
Laboratory & Allied · Fabrico de produtos farmacêuticos
A eficiência na produção aumentou 90%, e a criação de um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
98%de fiabilidade das entregas, face a cerca de 50% anteriormente
“O SkyPlanner tem um papel decisivo na manutenção da fiabilidade das nossas entregas.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Metalomecânica de chapa e fabrico por contrato
A fiabilidade das entregas passou de cerca de 50% para valores que chegam aos 98%, e a programação precisa agora de um supervisor em vez de dois.
99,2%de fiabilidade das entregas
“O SkyPlanner deu-nos visibilidade para identificar estrangulamentos e tornou a gestão da produção mais clara.”
Toni Tuori, responsável de produção
Piristeel · Sistemas de segurança para coberturas e de drenagem de águas pluviais
A fiabilidade das entregas atingiu 99,2% este ano, e a programação permite poupar até quatro horas de trabalho por dia.
Perguntas frequentes
Como se integra o SkyPlanner APS com o Sage X3?
Nos dois sentidos, através de GraphQL, REST api1, serviços web SOAP e modelos. São importados ordens de fabrico, gamas operatórias e centros de trabalho. As datas planeadas das operações e as horas registadas são devolvidas ao X3, enviadas por webhooks à medida que a programação muda. A equipa SkyPlanner configura a integração durante a implementação inicial, ou o seu parceiro Sage X3 ou os seus programadores desenvolvem-na com base na API REST do SkyPlanner.
Como são escritas no Sage X3 as datas das operações?
Através do objeto Work order (GESMFG), publicado como serviço web SOAP na função Web services (GESAWE). A operação modify atualiza Start (OPESTR), End (OPEEND) e o centro de trabalho de cada operação. Para atualizações em lote, é executado um modelo de importação de ordens de fabrico através de AOWSIMPORT. As horas e quantidades são enviadas através do objeto Production tracking (GESMTK).
Devemos usar GraphQL ou serviços web SOAP?
Ambos, cada um onde é mais eficaz. GraphQL é a API recomendada pela Sage e permite ler produtos, estabelecimentos, compras e stock, tanto na cloud como em instalações próprias. Os serviços web SOAP de objetos escrevem a programação e os registos de acompanhamento da produção, e os SOAP Template Services executam modelos de importação e exportação para cargas em massa.
Como evitamos registos duplicados ou a perda de alterações?
Use o ID do registo de tempo do SkyPlanner como chave de cada envio para Production tracking e guarde o número de acompanhamento devolvido pelo X3, para que um webhook repetido seja reconhecido e ignorado. Coloque as alterações em fila enquanto o X3 estiver inacessível e envie-as por ordem quando voltar a estar disponível. Registe as rejeições, como o acompanhamento de uma ordem de fabrico que não esteja no estado Firm, juntamente com a mensagem de erro do X3.
Precisamos dos códigos de atividade POPS ou GFS para o SkyPlanner?
Não. Esses códigos ativam o Production Scheduler da Sage e a interface genérica para o Web Scheduling. O SkyPlanner lê ordens de fabrico através de GraphQL, REST api1 ou modelos e devolve os dados ao X3 através dos serviços web SOAP Work order e Production tracking.
Como deteta o SkyPlanner novas ordens de fabrico no Sage X3?
A integração consulta o X3 a intervalos curtos, através de GraphQL, REST api1 ou exportações por modelo, ou da Sync API na cloud. No sentido inverso, os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Podemos testar com dados do Sage X3 antes de desenvolver seja o que for?
Sim. Importe ficheiros CSV com centros de trabalho, gamas operatórias e ordens de fabrico em aberto durante o período de avaliação de 30 dias. Para definir o âmbito da integração com o X3, contacte a equipa comercial.
