Integrações / ERP / Infor CloudSuite Industrial
Guia de integração do Infor CloudSuite Industrial para programação da produção com o SkyPlanner APS
Este guia mostra aos parceiros e às equipas de TI do Infor CloudSuite Industrial (CSI, anteriormente SyteLine) como ligar o CSI ao SkyPlanner APS. O SkyPlanner integra-se com o CSI nos dois sentidos, através do Infor OS:
- As tarefas, operações, recursos, existências e encomendas de compra são recebidos no SkyPlanner.
- As datas previstas das operações são devolvidas às tarefas no CSI.
- O trabalho dos operadores é devolvido sob a forma de transações de tarefas, para lançamento no CSI.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
A equipa SkyPlanner configura a integração de acordo com a configuração do seu CSI durante a implementação inicial e presta apoio após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver as suas próprias soluções com base na API REST documentada do SkyPlanner.
O que determina cada integração com o CSI
O SkyPlanner funciona na nuvem, pelo que não é instalado qualquer software SkyPlanner no CSI. No CSI multi-tenant, as integrações passam pelo Infor OS, por uma de duas vias:
- Mongoose IDO REST API através do ION API Gateway. Os objetos de negócio do CSI são IDOs (Intelligent Data Objects) da plataforma Mongoose. O serviço REST está disponível em
IDORequestServicee a Infor publica-o no repositório ION API. A versão 1 de REST disponibilizaLoadCollection,AddItem(s),UpdateItem(s),DeleteItem(s),InvokeMethod,IDOInfoeFireAESEvent, com respostas em XML ou JSON. Existe também um conjunto de endpoints da versão 2 de REST. - BODs (Business Object Documents) do ION encaminhados pelo ION através de pontos de ligação. O CSI publica BODs
Syncde saída paraProductionOrder,ItemMasterePurchaseOrder, além de documentos de inventário comoInventoryAdjustment,InventoryCounteInventoryHold.
A lista de BODs de saída da versão 2026.10 não inclui listas de materiais, gamas operatórias nem centros de trabalho. Por isso, uma integração para programação assenta sobretudo em IDOs, podendo os BODs sinalizar alterações nas tarefas de forma opcional.
Autenticação e licenciamento
Através do gateway, o CSI utiliza tokens bearer OAuth 2.0 emitidos pela ION API:
- Crie uma aplicação Backend Service no ION API e descarregue o respetivo ficheiro
.ionapi. Este contém as credenciais do cliente e as chaves da conta de serviço (saak,sask). Sem estas credenciais e chaves, os pedidos de token falham. - Envie o cabeçalho
X-Infor-MongooseConfigem todas as chamadas efetuadas através do ION. Este identifica a configuração do CSI (site) a que se destina a chamada. - Mantenha ficheiros
.ionapiseparados para cada ambiente. Um ficheiro de produção não permite a autenticação no tenant de testes.
O SyteLine instalado localmente utiliza o mesmo modelo baseado em IDOs. A documentação do Mongoose descreve chamadas diretas à IDO REST API com um token de segurança obtido através de GetSecurityToken, sem passar pelo ION API Gateway.
As aplicações externas que se ligam através da camada IDO utilizam o módulo de licença Automation, ao qual é sempre atribuído o tipo de sessão IDO. As aplicações da própria Infor, como o APS, não precisam de uma licença adicional. A ligação ao SkyPlanner utiliza uma destas licenças, além de acesso à ION API no seu tenant.
Do lado do SkyPlanner, a API REST permite ler e escrever ordens, produtos, materiais, etapas do processo, encomendas de compra e registos de tempo. Utiliza autenticação JWT e está documentada em Swagger/OpenAPI (referência da API); consulte também a documentação do SkyPlanner.
Deteção de alterações: acionadores BOD, AES e consultas periódicas
As alterações saem do CSI sob a forma de BODs do ION. Para a programação, o BOD relevante é ProductionOrder. A sua configuração é feita no formulário Replication Document Outbound Cross References, com definições de publicação:
| Acionador | Dados publicados |
|---|---|
TriggerProductionOrderSyncSp | Todas as ordens de produção; execução apenas em primeiro plano |
TriggerProductionOrderBGSyncSp | Ordens acabadas de programar; pode ser executado como tarefa em segundo plano |
TriggerProductionOrderBGSchSyncSp | Ordens de produção alteradas; pode ser executado como tarefa em segundo plano |
Os exemplos da Infor filtram pelo estado da ordem de fabrico: 'Firm' para alterações à programação e, opcionalmente, 'Released' para alterações de materiais e mão de obra. Também filtram por valores de RecordDate posteriores à data da última publicação manual da tarefa em segundo plano.
O Application Event System (AES) do Mongoose também pode executar ações de eventos, e a REST API disponibiliza FireAESEvent. O modelo de base consiste na consulta periódica dos IDOs: a cada poucos minutos, executa-se LoadCollection em SLJobs e SLJobRoutes, com um filtro pela data do registo. Acrescenta-se o BOD ProductionOrder quando a instalação pretende receber as alterações por envio automático.
No sentido inverso, os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem, e cada um desencadeia a gravação dessas alterações no CSI.
Mapeamento de dados
Os nomes abaixo correspondem aos IDOs padrão. Nos tenants com extensões dos IDOs, os objetos são os mesmos, mas têm propriedades adicionais, que a equipa SkyPlanner mapeia durante a implementação inicial.
| Objeto do CSI (IDO / BOD / formulário) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Artigos (SLItems), BOD Sync ItemMaster | Produtos e materiais | CSI → SkyPlanner | Carregamento inicial, depois por BOD ou atualização incremental diária |
Gama operatória do artigo (SLItemRoutes) | Etapas do processo com tempos de preparação e execução | CSI → SkyPlanner | Carregamento inicial, depois a cada alteração |
| Grupos de recursos para preparação e tabelas de consulta para a preparação | Matriz de tempos de preparação (mudanças de produção entre produtos em função da sequência) | CSI → SkyPlanner, depois sob gestão do SkyPlanner | Carregamento inicial |
BOM do artigo, materiais da ordem de fabrico (SLJobmatls) | Estrutura do produto, subprodutos, necessidades de materiais por tarefa | CSI → SkyPlanner | Carregamento inicial, depois com cada ordem de fabrico |
| Grupos de recursos e recursos (com sequência dos membros) | Grupos de centros de trabalho, centros de trabalho e centros de trabalho alternativos | CSI → SkyPlanner | Carregamento inicial, raramente depois |
| Ferramentas e número de operadores por operação | Ferramentas como recursos partilhados com capacidade finita, número de operadores por centro de trabalho | Mantidos no SkyPlanner | Configurados durante a implementação inicial |
Centros de trabalho (SLWcs) | Não é um objeto de programação; manter apenas como referência de custos | CSI → SkyPlanner | Opcional |
| Turnos e feriados | Turnos e ausências | CSI → SkyPlanner | Semanalmente, ou sob gestão do SkyPlanner |
Ordens de fabrico (SLJobs), BOD Sync ProductionOrder | Ordens com datas de entrega e prioridade | CSI → SkyPlanner | Acionador BOD ou consulta periódica a cada poucos minutos |
Operações da ordem de fabrico (SLJobRoutes) | Tarefas por etapa do processo, grupo de recursos por etapa | CSI → SkyPlanner | Com cada ordem de fabrico |
Linhas de encomendas de clientes (SLCoItems), clientes (SLCustomers) | Datas de entrega ao cliente e prioridade do cliente | CSI → SkyPlanner | Consulta periódica |
| Stock de artigos por armazém, BODs de inventário | Inventário (saldos de stock) | CSI → SkyPlanner | De hora a hora ou antes de cada execução da programação |
Encomendas de compra (linhas em aberto), BOD Sync PurchaseOrder | Encomendas de compra e materiais a receber com data de entrega prevista | CSI → SkyPlanner | De hora a hora ou por BOD, antes de cada execução da programação |
Programação das operações da ordem de fabrico (início e fim por operação) e datas Start e End da ordem em SLJobs, através de UpdateItems | Início e fim planeados por operação | SkyPlanner → CSI | A cada alteração à programação, com a atualização acionada por um webhook do SkyPlanner |
Movimentos de ordens de fabrico por contabilizar (SLJobtrans) através de AddItems, funcionários (SLEmployees), motivos (SLReasons) | Registos de tempo, quantidades boas e de refugo, códigos de motivo | SkyPlanner → CSI | A cada confirmação |
Modelos de integração
1. Carregamento inicial dos dados mestre. Leia artigos, gamas operatórias dos artigos, BOMs, grupos de recursos, recursos e turnos através de LoadCollection. Crie os centros de trabalho do SkyPlanner a partir dos recursos e grupos de recursos, não dos centros de trabalho do CSI. A Infor afirma claramente que o centro de trabalho “captures costs only and does not affect the actual planning or scheduling.” (regista apenas custos e não afeta o planeamento nem a programação propriamente ditos).
2. Sincronização de ordens. Envie as ordens de fabrico firmes e lançadas, com as respetivas operações e materiais. Mantenha no CSI as ordens planeadas pelo APS. O APS Planning elimina e volta a gerar o plano em cada execução, pelo que as ordens planeadas não têm uma identidade estável que permita programá-las. Primeiro, converta-as em ordens de fabrico firmes em Planning Detail.
3. Escrita da programação no CSI. Um webhook de programação do SkyPlanner aciona a escrita. A integração lê o novo início e fim planeados de cada operação através da REST API do SkyPlanner. Escreve-os com UpdateItems na programação das operações da ordem de fabrico, usando como chave a ordem, o sufixo e o número da operação. São as mesmas datas de operação que o Scheduler define e que o Resource Gantt permite editar. As datas Start e End da ordem em SLJobs são atualizadas em conformidade.
Algumas instalações protegem os campos de programação ou exigem a execução de lógica no CSI a cada alteração. Nesses casos, a escrita passa por um método IDO personalizado, chamado com InvokeMethod, que aplica a mesma atualização com a validação do próprio CSI.
4. Confirmações no chão de fábrica. Os operadores registam tempos e quantidades num telemóvel ou tablet (Mobile Confirmations, Production Timer, Quick Log Mode). Cada registo de tempo encerrado dá origem a uma linha SLJobtrans por contabilizar, criada com AddItems, que inclui ordem de fabrico, sufixo, operação, funcionário, horas e quantidades boas e de refugo. O Job Labor Transaction Posting do CSI contabiliza depois os custos de mão de obra e os gastos gerais na produção em curso (WIP) da ordem, com a periodicidade que definir.
5. Responsabilidade pelos dados, novas tentativas e regras de conflito.
A chave de cada registo baseia-se nos identificadores do próprio CSI (job, suffix, número da operação e ID da transação). Assim, a repetição de um webhook ou de uma consulta atualiza a mesma linha em vez de criar um duplicado. As escritas que falham são repetidas e registadas com o texto do erro do CSI. Uma tarefa com o estado Complete ou History no CSI sai da programação do SkyPlanner na sincronização seguinte, e os dados de uma tarefa cancelada no SkyPlanner nunca são enviados para gravação no CSI.
| Dados | Sistema responsável |
|---|---|
| Artigos, gamas operatórias, listas de materiais, quantidades, estado das tarefas, cálculo de custos | CSI |
| Sequência das operações, horas de início e de fim, atribuição de recursos | SkyPlanner |
| Plano de materiais a longo prazo, Get CTP/ATP | CSI APS, se licenciado |
| Turnos e feriados | Um único sistema, escolhido na definição do âmbito |
| Mão de obra e produção realizada | Registadas no CSI a partir dos registos de tempo do SkyPlanner |
As ferramentas de programação nativas são a principal fonte de conflitos. O APS Planning considera fixas as operações programadas, mas as execuções posteriores do Scheduler (normalmente uma execução diária com um horizonte de um dia) podem voltar a deslocá-las. Quando o SkyPlanner é responsável pela sequenciação detalhada de um conjunto de grupos de recursos, exclua-os do âmbito do CSI Scheduler. Em seguida, desative a opção de Shop Floor Control Parameters que faz com que o Scheduler trate as ordens planeadas como procura. O MRP, o planeamento de ordens do APS e o Get CTP podem continuar no CSI. A funcionalidade Running Time Lock do SkyPlanner mantém fixas as operações já iniciadas. No SkyPlanner, o Autopilot reprograma automaticamente quando a produção muda, respeitando os bloqueios e as prioridades que definir.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o arranque, mesmo em grandes empresas. Um projeto CSI inclui:
- Teste com dados exportados. Utilize Save to Excel nas listas de tarefas, operações e recursos do CSI, converta os ficheiros para CSV e importe-os para o SkyPlanner. Valide a programação antes de desenvolver a interface.
- Definição do âmbito e mapeamento dos dados mestre. Defina a tabela de mapeamento, o sistema responsável por cada campo, a frequência de sincronização, o canal de lançamento e a forma de limitar o âmbito do Scheduler nativo.
- Configuração do Infor OS. Aplicação Backend Service, ficheiros
.ionapipor tenant, licença Automation e acesso IDO REST. Solicite logo no início o aprovisionamento de IDO REST ao suporte da Infor Cloud, pois alguns tenants precisam que este seja ativado. - Carregamento inicial. Artigos, BOMs, gamas operatórias dos artigos, recursos, grupos de recursos e turnos através de
LoadCollection, além da matriz de tempos de preparação, das ferramentas e do número de operadores por equipa no SkyPlanner. - Sincronização de ordens de fabrico e encomendas de compra. Comece pela consulta periódica dos IDOs de ordens de fabrico, operações, materiais e encomendas de compra em aberto. Depois, acrescente o acionador do BOD
ProductionOrder, se necessário. - Testes em paralelo com o plano atual. Execute o SkyPlanner em paralelo com a lista de trabalhos a executar e corrija os tempos das gamas operatórias e os dados dos recursos.
- Escrita da programação no CSI e confirmações no chão de fábrica. Ative a escrita da programação e os registos de mão de obra em
SLJobtransquando as datas e os dados coincidirem. - Entrada em produção para os grupos de recursos sob a responsabilidade do SkyPlanner.
Problemas a evitar no CSI
- Mapear centros de trabalho como máquinas.
SLWcsé o IDO mais óbvio, mas é o errado para representar a capacidade. A programação assenta nos recursos e grupos de recursos (com sequência dos membros). - Filtros de BOD que omitem ou repetem ordens de fabrico. A publicação de
ProductionOrderdepende do acionador escolhido e dos filtros de estado. Filtrar apenas por'Firm'deixa de fora as alterações de materiais e mão de obra nas ordens lançadas; sem um filtro pela data da última publicação, todos os dados são reenviados. - Registos de mão de obra rejeitados ao gravar no CSI. O CSI rejeita os registos de mão de obra quando a tarefa não está no estado Released ou Scheduled, quando a operação já está concluída ou quando o funcionário está inativo. Valide os dados primeiro e registe as rejeições.
- Pressupor que uma linha equivale a um movimento contabilizado. Uma linha
SLJobtransfica por contabilizar até à execução de Job Labor Transaction Posting. Defina a periodicidade de contabilização com a equipa financeira, para que a mão de obra se reflita na produção em curso e no processamento salarial no momento esperado. - Tarefas em atraso provenientes do APS. O APS planeia de trás para a frente a partir da data de entrega e, se não conseguir, de hoje para a frente; nunca planeia para o passado. Deixe o SkyPlanner programar as ordens em atraso com base na capacidade real, em vez de confiar na data de início recebida.
- Pormenores do Mongoose. Nos valores dos parâmetros de
InvokeMethod, use a sequência de escape\x2cpara representar vírgulas.
Quem configura a integração com o CloudSuite Industrial
- A equipa SkyPlanner configura a integração durante a implementação inicial e presta apoio após a entrada em produção. Isto abrange o lado do SkyPlanner e a interface IDO e BOD, com o mapeamento adaptado ao seu tenant. A equipa mantém a integração quando os grupos de recursos, as extensões dos IDOs ou os estados das tarefas mudam. Cada fábrica utiliza o CSI de forma diferente, e é neste mapeamento que a equipa é especializada.
- O seu parceiro Infor pode participar. O parceiro conhece as extensões dos seus IDOs e a configuração do ION, desenvolve com base na documentação Swagger/OpenAPI do SkyPlanner e subscreve os respetivos webhooks.
- Os seus próprios programadores podem desenvolver soluções com base na mesma API REST com autenticação JWT. Basta uma chave da API do SkyPlanner para começar (tutorial de integração), e a equipa SkyPlanner ajuda quando necessário.
Por que motivo as equipas CSI optam pelo SkyPlanner em vez de afinar mais uma execução em lote
O SkyPlanner mantém reduzida a intervenção no CSI. Lê ordens de fabrico, operações, materiais e recursos, e escreve de volta dois elementos: os horários planeados das operações e os registos de mão de obra em SLJobtrans. Pelo meio, faz o replaneamento que o CSI deixa a cargo das edições do planeador no Resource Gantt e da próxima execução do Scheduler:
- Programação que reage aos eventos. O Arcturus cria a programação da produção em segundos, respeitando a capacidade real das máquinas e das equipas, e o Autopilot reprograma automaticamente quando a produção muda, quer chegue uma tarefa alterada do CSI, quer um operador registe o progresso. Os webhooks enviam então os novos horários.
- Mão de obra registada na origem. Mobile Confirmations, Production Timer e Quick Log Mode transformam os dados introduzidos pelos operadores em registos de tempo que correspondem a linhas
SLJobtrans. Assim, os dados de mão de obra chegam ao CSI sem terem de ser introduzidos novamente. - Restrições fiéis ao chão de fábrica. Uma matriz de tempos de preparação seleciona a sequência de mudanças de produção que exige menos preparação. As ferramentas são recursos partilhados de capacidade limitada, vários operadores podem trabalhar no mesmo centro de trabalho em simultâneo, e as máquinas e o pessoal alternativos entram em ação quando o recurso principal está ocupado.
- Sequenciação guiada pelos materiais. Com os materiais das tarefas, as existências e as encomendas de compra em aberto do CSI a alimentar a integração, a disponibilidade dos materiais é verificada na programação. O material encomendado é considerado disponível na data de entrega da encomenda de compra, e as existências são atualizadas quando esta passa ao estado Delivered.
- Um teste que reduz o risco do projeto. Carregue uma exportação de Save to Excel na versão de teste de 30 dias e veja as suas próprias tarefas numa programação da produção que respeita a capacidade real das máquinas e das equipas. Pare o recurso que constitui um gargalo, acrescente uma encomenda urgente e atrase uma encomenda de compra. O mapeamento que validar neste teste define o âmbito do trabalho com os IDOs.
Escolha o SkyPlanner quando o CSI deva continuar a ser o sistema de referência para artigos, tarefas e custos. Obtém uma ferramenta de programação e uma aplicação para o chão de fábrica, com uma interface de integração reduzida e clara: recebe tarefas e dados mestre, devolve horários planeados e registos de mão de obra. O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos, faturação mensal e cancelamento a qualquer momento. A integração é orçamentada antecipadamente em função do seu processo e das suas necessidades, juntamente com o plano, para que conheça o custo total antes de começar.
Consulte os preços, as funcionalidades e a documentação do SkyPlanner. Compare o CSI APS e o Scheduler com uma ferramenta de programação na nuvem em Programação da produção no Infor CloudSuite Industrial. Pode também visitar a página do Infor CloudSuite Industrial e a área de integrações com ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos das folhas de Excel no planeamento da produção para a otimização da 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 criar um plano otimizado de três meses para 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 para manter a 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 exige agora apenas um supervisor em vez de dois.
6 mesesde capacidade disponível visível para a equipa comercial
“O SkyPlanner dá uma base sólida e fiável a todo o planeamento da produção.”
Anu Järvinen, Diretora de Produção
Fredman Operations · Papéis de embalagem seguros para contacto com alimentos
A equipa comercial consegue ver a capacidade disponível com seis meses de antecedência, e os pedidos de alteração à programação que demoravam uma hora ou mais recebem agora resposta em segundos.
Perguntas frequentes
Quem desenvolve a integração com o CloudSuite Industrial ou o SyteLine?
Durante a implementação inicial, a equipa SkyPlanner configura a integração bidirecional de acordo com a sua configuração do CSI, recorrendo à IDO REST API e aos ION BODs, e presta suporte após a entrada em produção. O seu parceiro Infor ou os seus próprios programadores também podem desenvolver a integração através da REST API documentada do SkyPlanner, bastando uma chave de API. Durante o período experimental, pode começar com exportações em CSV ou Excel.
Que API deve ser usada para integrar a programação da produção com o CSI?
A Mongoose IDO REST API através do ION API Gateway, com OAuth 2.0 a partir de um ficheiro .ionapi de uma aplicação Backend Service. Acrescente o BOD ProductionOrder para detetar alterações nas ordens de fabrico se a consulta periódica não for suficientemente rápida.
Como são enviadas para gravação no CSI as datas planeadas e os registos de mão de obra?
O início e o fim planeados das operações são escritos na programação das operações da ordem de fabrico através de UpdateItems do IDO, com atualização das datas Start e End da ordem em SLJobs. As instalações que protegem esses campos utilizam um método IDO personalizado através de InvokeMethod. Os dados de mão de obra são inseridos com AddItems como linhas SLJobtrans por contabilizar, e o Job Labor Transaction Posting contabiliza-os na produção em curso (WIP).
Precisamos de uma licença Infor adicional para ligar um sistema externo de programação da produção?
Sim, de uma licença Automation. Segundo a documentação de licenciamento da Infor, as aplicações externas que se ligam através da camada IDO utilizam uma licença deste tipo, com o tipo de sessão IDO.
Podemos manter o CSI APS e acrescentar o SkyPlanner?
Sim. O CSI APS continua a gerir o plano de materiais e o Get CTP/ATP, e o SkyPlanner fica responsável pela sequenciação nos grupos de recursos que lhe atribuir.
Quanto tempo demora um projeto de integração com o CSI?
A implementação fica normalmente concluída em poucas semanas após o arranque dos trabalhos de integração. O projeto passa pelo mapeamento, pelo carregamento inicial, pela sincronização de ordens de fabrico e encomendas de compra, pela escrita da programação no CSI, pelas confirmações em SLJobtrans, pela execução em paralelo e pela entrada em produção.
Podemos testar o SkyPlanner antes de desenvolver qualquer integração?
Sim. O período experimental gratuito de 30 dias inclui até 20 centros de trabalho e todas as funcionalidades do plano Basic, sem necessidade de cartão de crédito. Comece com ficheiros CSV ou Excel exportados do CSI. Inicie o período experimental gratuito ou fale com a equipa comercial sobre o seu tenant.