Guia de integração do Sage X3 para programação da produção com o SkyPlanner APS

O modelo de implantação define o caminho. O Sage X3 na nuvem não disponibiliza o sistema de arquivos da aplicação nem o banco de dados para aplicações de terceiros. Por isso, a integração usa APIs ou transferência de arquivos em ambiente hospedado. Em instalações locais, também é possível importar arquivos diretamente e usar tabelas intermediárias no banco de dados do X3.

Para usar GraphQL em ambiente local, é necessário adicionar "bearer" ao array session.auth em nodelocal.js. No Sage X3 SaaS, a autenticação de aplicativos conectados é habilitada por padrão. No Sage X3 Cloud, o aplicativo conectado não pode usar o usuário admin: crie um usuário do Syracuse com autenticação Standard.

Qual interface usar em cada fluxo

• Produtos, estabelecimentos, compras e estoque: GraphQL, conforme os exemplos oficiais da Sage.
• Ordens de produção, operações, roteiros de produção e centros de trabalho: representações REST api1 ou modelos de exportação executados via AOWSEXPORT. Nas versões em que o esquema GraphQL expõe o domínio de manufatura (xtremX3Manufacturing), a integração lê os mesmos dados por essa interface.
• Gravação das datas das operações e dos centros de trabalho no X3: serviço web SOAP de Work order (GESMFG), operação modify. Alternativa: modelo de importação via AOWSIMPORT.
• Apontamentos de produção: serviço web SOAP de Production tracking (GESMTK), operação save.

A mesma arquitetura funciona com o X3 na nuvem e em instalações locais, pois não exige acesso direto ao sistema de arquivos nem ao banco de dados. Nada é instalado no X3: a integração usa uma aplicação conectada, um usuário Syracuse e serviços web publicados em GESAWE.

Eventos: planeje consultas periódicas

A documentação pública da Sage para desenvolvedores X3 não descreve nenhum recurso de webhook de saída ou de eventos de negócio. A configuração “Callback URL”, adicionada na versão 2024 R1, atende ao Mobile Automation e ao Web Scheduling quando chamam serviços web SOAP. Não se trata de um sistema genérico de eventos. Detecte alterações com leituras agendadas: consultas GraphQL, o cursor de timestamp da Sync API na nuvem ou exportações periódicas por modelo.

1. Carga inicial de dados mestres. Carregue primeiro os centros de trabalho e os calendários. Depois, carregue produtos, BOMs e roteiros de produção, pois os roteiros fazem referência aos centros de trabalho.

2. Sincronização de ordens. Consulte MFGHEAD e MFGOPE periodicamente para identificar ordens de produção novas e alteradas. Mapeie cada linha de MFGOPE para uma etapa do processo no SkyPlanner, no centro de trabalho indicado pelo código WST. Sincronize os pedidos de compra em aberto no mesmo ciclo. O SkyPlanner considera o material comprado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido recebe o status Delivered. Assim, a verificação de materiais abrange tanto o estoque quanto os recebimentos previstos.

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. Ela atualiza Start (OPESTR), End (OPEEND) e o centro de trabalho de cada operação alterada. Para atualizações em lote, os mesmos campos são enviados por um modelo de importação de ordens de produção via AOWSIMPORT. Grave apenas datas e centros de trabalho, nunca quantidades, linhas de BOM ou roteiros de produção.

4. Retorno da máquina escolhida ao X3. Quando o mapeamento entre centros de trabalho é um para um, a máquina escolhida pelo motor entre as alternativas é gravada no X3 como o centro de trabalho da operação. Assim, o X3 registra a máquina que realmente executa a operação. Quando um centro de trabalho do X3 representa um grupo de máquinas, a fila do operador mostra a máquina individual. O X3 recebe o centro de trabalho do grupo com as datas programadas.

5. Confirmações no chão de fábrica. Os operadores registram o trabalho com Mobile Confirmations ou Production Timer. A integração lança cada confirmação com a operação save do objeto Production tracking (GESMTK): tempo e quantidade no apontamento da operação e, se você fizer esse controle ali, consumo de materiais. O X3 só aceita apontamentos em ordens de produção com status Firm. Os componentes precisam estar disponíveis, a menos que a opção Release if shortage (MFGSHTCOD) esteja selecionada no cadastro do produto por estabelecimento.

6. Sincronização confiável. Use o ID do registro de tempo do SkyPlanner como chave de cada lançamento de apontamento e armazene o número de apontamento criado no X3. Assim, um webhook repetido nunca gera um lançamento duplicado. Na próxima consulta periódica, remova da programação as ordens de produção encerradas ou canceladas no X3. Registre as chamadas rejeitadas junto com a mensagem de erro do X3, em vez de tentar novamente sem avaliar a causa. Mantenha as alterações em fila enquanto o X3 estiver inacessível, para que sejam lançadas na ordem quando ele voltar a estar disponível.

7. Regras de responsabilidade pelos dados. O X3 define o que é produzido: produto, quantidade, BOM, roteiro de produção e estabelecimento. O SkyPlanner define quando e onde: sequência, centro de trabalho e horários de início e término. Combine com os planejadores que deixem de reprogramar no Planning workbench e de executar FUNMAUTJ para ordens gerenciadas pelo SkyPlanner. Caso contrário, as alterações deles serão sobrescritas na próxima gravação da programação no X3.

• Sugestões não são ordens de produção. As sugestões do MRP não têm linhas de operação MFGOPE até serem convertidas em ordens de produção planejadas ou firmes. Por isso, programe as ordens convertidas, não as sugestões.
• Lacunas nos calendários. Um dia útil sem tabela de horários usa o esquema padrão DEFDIH. Um dia em branco sem esse padrão gera datas e cargas incorretas. Antes de exportar os calendários, atribua uma tabela de horários a todos os dias úteis de cada estrutura semanal.
• Cargas por período desatualizadas. Após uma alteração de capacidade ou calendário, as cargas por período existentes no X3 só são ajustadas quando você reprograma e executa Recalculate loads (FUNMIWL). Não valide o SkyPlanner com base em uma consulta Loads inquiry (CONSMWK) desatualizada.
• No. of resources indica o tamanho da equipe. WSTNBR é o número de recursos que uma operação exige no centro de trabalho, por exemplo, três pessoas em um centro de trabalho de mão de obra. Mapeie esse valor para o número de operadores no centro de trabalho do SkyPlanner, que permite programar várias pessoas na mesma operação ao mesmo tempo. Nas unidades que usavam a interface avançada GFS, esse valor está definido como 1, conforme exigido pela Sage. Portanto, verifique onde está registrado o tamanho real da equipe.
• Operações do roteiro de produção sem centro de trabalho não podem ser alocadas a um centro de trabalho no SkyPlanner. A etapa de mapeamento sinaliza essas operações.
• Unidades de tempo e centros de trabalho substitutos. Os tempos do roteiro de produção têm sua própria unidade de tempo (TIMUOMCOD), e os centros de trabalho substitutos têm uma prioridade. Mapeie ambos explicitamente e execute novamente a verificação do mapeamento após cada atualização do X3.
• Ordens bloqueadas. Se a unidade também usava o Production Scheduler, as ordens enviadas para ele ficam com o status Being optimized e não podem ser alteradas até serem removidas da programação (PSOPTFREE). Libere essas ordens antes da transição.

Escolha o SkyPlanner quando quiser entrar em produção em semanas, e não depois de um projeto de APS que leva meses.

Os preços começam em 199 € por mês, com 5 centros de trabalho incluídos e cobrança mensal. A integração é orçada antecipadamente de acordo com seu processo e suas necessidades, junto com o plano, para que você conheça o custo total antes de começar. Confira os preços e recursos ou inicie o teste grátis de 30 dias com até 20 centros de trabalho, sem cartão de crédito.