Integrações / ERP / Infor CloudSuite Industrial
Guia de integração do Infor CloudSuite Industrial para programação da produção com SkyPlanner APS
Este guia mostra aos parceiros e às equipes de TI do Infor CloudSuite Industrial (CSI, anteriormente SyteLine) como conectar o CSI ao SkyPlanner APS. O SkyPlanner se integra ao CSI nos dois sentidos, por meio do Infor OS:
- Ordens de produção, operações, recursos, estoque e pedidos de compra entram no SkyPlanner.
- As datas planejadas das operações retornam às ordens de produção no CSI.
- Os apontamentos de mão de obra dos operadores retornam como transações das ordens de produção para lançamento no CSI.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe do SkyPlanner configura a integração de acordo com o seu ambiente CSI durante a implantação e oferece suporte após a entrada em operação. Este guia é voltado a parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver por conta própria com a API REST documentada do SkyPlanner.
O que define cada integração com o CSI
O SkyPlanner roda na nuvem, portanto nenhum software do SkyPlanner é instalado dentro do CSI. No CSI multitenant, as integrações passam pelo Infor OS por um de dois caminhos:
- Mongoose IDO REST API via ION API Gateway. Os objetos de negócio do CSI são IDOs (Intelligent Data Objects) no framework Mongoose. O serviço REST fica em
IDORequestService, e a Infor o publica no repositório ION API. A versão 1 da API REST ofereceLoadCollection,AddItem(s),UpdateItem(s),DeleteItem(s),InvokeMethod,IDOInfoeFireAESEvent, com respostas em XML ou JSON. Também existe um conjunto de endpoints da versão 2 da API REST. - ION BODs (Business Object Documents) encaminhados pelo ION por meio de pontos de conexão. O CSI publica BODs
Syncde saída paraProductionOrder,ItemMasterePurchaseOrder, além de documentos de estoque comoInventoryAdjustment,InventoryCounteInventoryHold.
A lista de BODs de saída da versão 2026.10 não inclui listas de materiais, roteiros de produção nem centros de trabalho. Por isso, a integração para programação se baseia principalmente em IDOs, com BODs como sinal opcional de alterações nas ordens de produção.
Autenticação e licenciamento
Ao acessar pelo gateway, o CSI usa tokens bearer OAuth 2.0 emitidos pela ION API:
- Crie uma aplicação do tipo Backend Service no ION API e baixe o arquivo
.ionapi. Ele contém as credenciais do cliente e as chaves da conta de serviço (saak,sask). Sem elas, as solicitações de token falham. - Envie o cabeçalho
X-Infor-MongooseConfigem todas as chamadas feitas pelo ION. Ele identifica a configuração do CSI (site) de destino. - Mantenha arquivos
.ionapiseparados para cada ambiente. Um arquivo de produção não autentica no tenant de sandbox.
O SyteLine instalado localmente usa o mesmo padrão de IDO. A documentação do Mongoose descreve chamadas diretas à IDO REST API com um token de segurança obtido por GetSecurityToken, sem o ION API Gateway.
Aplicações externas que se conectam pela camada IDO usam 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 conexão do SkyPlanner usa uma dessas licenças, além de acesso à ION API no seu tenant.
Do lado do SkyPlanner, a API REST lê e grava ordens, produtos, materiais, etapas de processo, pedidos de compra e registros de tempo. Ela usa autenticação JWT e está documentada em Swagger/OpenAPI (referência da API); consulte também a documentação do SkyPlanner.
Detecção de alterações: gatilhos BOD, AES e consultas periódicas
As alterações saem do CSI como ION BODs, e o BOD relevante para a programação é o ProductionOrder. Ele é configurado no formulário Replication Document Outbound Cross References, com definições de publicação:
| Gatilho | O que publica |
|---|---|
TriggerProductionOrderSyncSp | Todas as ordens de produção, somente em primeiro plano |
TriggerProductionOrderBGSyncSp | Ordens recém-programadas; 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 status da ordem: 'Firm' para alterações na programação e, opcionalmente, 'Released' para alterações de materiais e mão de obra. Também filtram por RecordDate posterior à 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 evento, e a API REST expõe FireAESEvent. O padrão básico é a consulta periódica aos IDOs: a cada poucos minutos, executar LoadCollection em SLJobs e SLJobRoutes, filtrando pela data do registro. O BOD ProductionOrder é acrescentado quando o site quer receber notificações das alterações.
No sentido inverso, os webhooks do SkyPlanner enviam as alterações da programação assim que elas ocorrem, e cada um aciona a gravação de retorno no CSI.
Mapeamento de dados
Os nomes abaixo são os IDOs padrão. Tenants que estendem os IDOs mantêm os mesmos objetos com propriedades adicionais, que a equipe do SkyPlanner mapeia durante a implantação.
| Objeto do CSI (IDO / BOD / formulário) | Objeto do SkyPlanner | Direção | Frequência |
|---|---|---|---|
Itens (SLItems), BOD Sync ItemMaster | Produtos e materiais | CSI → SkyPlanner | Carga inicial; depois, por BOD ou carga incremental diária |
Roteiro de produção do item (SLItemRoutes) | Etapas do processo com tempos de preparação e execução | CSI → SkyPlanner | Carga inicial; depois, a cada alteração |
| Grupos de recursos de preparação e tabelas de consulta de preparação | Matriz de tempos de preparação (trocas de produção entre produtos que dependem da sequência de produção) | CSI → SkyPlanner; depois, gerenciado no SkyPlanner | Carga inicial |
BOM do item, materiais da ordem (SLJobmatls) | Estrutura do produto, subprodutos e necessidades de materiais por ordem de produção | CSI → SkyPlanner | Carga inicial; depois, com cada ordem |
| Grupos de recursos e recursos (com a sequência dos membros) | Grupos de centros de trabalho, centros de trabalho e centros de trabalho alternativos | CSI → SkyPlanner | Carga inicial; raramente depois disso |
| Ferramentas e tamanho da equipe por operação | Ferramentas como recursos compartilhados de capacidade finita, número de operadores por centro de trabalho | Mantido no SkyPlanner | Configurado durante a implantação |
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 gerenciado no SkyPlanner |
Ordens de produção (SLJobs), BOD Sync ProductionOrder | Ordens com prazos de entrega e prioridade | CSI → SkyPlanner | Gatilho de BOD ou consulta periódica a cada poucos minutos |
Operações da ordem (SLJobRoutes) | Operações por etapa do processo, grupo de recursos por etapa | CSI → SkyPlanner | Com cada ordem |
Linhas de pedidos de clientes (SLCoItems), clientes (SLCustomers) | Prazos de entrega e prioridade do cliente | CSI → SkyPlanner | Consulta periódica |
| Estoque do item por armazém, BODs de estoque | Estoque (saldos) | CSI → SkyPlanner | A cada hora ou antes de cada execução da programação |
Pedidos de compra (linhas em aberto), BOD Sync PurchaseOrder | Pedidos de compra e materiais a receber com data prevista de entrega | CSI → SkyPlanner | A cada hora ou ao receber um BOD, antes de cada execução da programação |
Programação das operações da ordem (início e término por operação) e datas Start e End da ordem em SLJobs, via UpdateItems | Início e término planejados por operação | SkyPlanner → CSI | A cada alteração na programação, acionado por um webhook do SkyPlanner |
Transações da ordem ainda não contabilizadas (SLJobtrans) via AddItems, funcionários (SLEmployees), motivos (SLReasons) | Apontamentos de tempo, quantidades boas e de refugo, códigos de motivo | SkyPlanner → CSI | A cada confirmação |
Padrões de integração
1. Carga inicial de dados mestres. Leia itens, roteiros de produção dos itens, BOMs, grupos de recursos, recursos e turnos por meio de LoadCollection. Crie os centros de trabalho do SkyPlanner a partir de 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.” (registra apenas custos e não afeta o planejamento nem a programação de fato).
2. Sincronização de ordens. Envie as ordens de produção firmes e liberadas com suas operações e materiais. Mantenha no CSI as ordens planejadas pelo APS. O APS Planning exclui e gera novamente seu plano a cada execução, de modo que as ordens planejadas não têm uma identidade estável para a programação. Primeiro, converta-as em ordens de produção firmes em Planning Detail.
3. Gravação da programação no CSI. Um webhook de programação do SkyPlanner aciona a gravação. A integração lê o novo início e término planejados de cada operação pela API REST do SkyPlanner. Em seguida, grava esses dados com UpdateItems na programação das operações da ordem, usando como chave a ordem, o sufixo e o número da operação. São as mesmas datas de operação definidas pelo Scheduler e editadas no Resource Gantt, e as datas Start e End da ordem em SLJobs acompanham essas alterações.
Alguns sites protegem os campos de programação ou exigem a aplicação de lógica no CSI a cada alteração. Nesses casos, a gravação 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 do chão de fábrica. Os operadores registram tempos e quantidades pelo celular ou tablet (Mobile Confirmations, Production Timer, Quick Log Mode). Cada apontamento de tempo encerrado gera uma linha ainda não contabilizada em SLJobtrans, criada com AddItems, contendo ordem, sufixo, operação, funcionário, horas e quantidades boas e de refugo. Depois, o Job Labor Transaction Posting do CSI contabiliza o custo de mão de obra e os custos indiretos no estoque em processo (WIP) da ordem, na frequência que você escolher.
5. Responsabilidade pelos dados, novas tentativas e regras de conflito.
Cada registro usa como chave os identificadores do próprio CSI (job, suffix, operation number, transaction ID). Assim, um webhook ou uma consulta repetida atualiza o mesmo registro em vez de criar uma duplicata. As gravações que falham são repetidas e registradas em log com o texto do erro do CSI. Uma ordem de produção com status Complete ou History no CSI sai da programação do SkyPlanner na próxima sincronização, e uma operação cancelada no SkyPlanner nunca é gravada de volta no CSI.
| Dados | Sistema responsável |
|---|---|
| Itens, roteiros de produção, listas de materiais, quantidades, status das ordens de produção, custeio | CSI |
| Sequência das operações, horários de início e término, alocação de recursos | SkyPlanner |
| Plano de materiais de longo prazo, Get CTP/ATP | CSI APS, se licenciado |
| Turnos e feriados | Um único sistema, escolhido na definição de escopo |
| Mão de obra e produção realizada | Gravados no CSI a partir dos registros de tempo do SkyPlanner |
Os sistemas nativos de programação são a principal fonte de conflitos. O APS Planning trata as operações programadas como congeladas, mas execuções posteriores do Scheduler (geralmente uma execução diária com horizonte de um dia) podem movê-las novamente. Quando o SkyPlanner for responsável pelo sequenciamento detalhado de um conjunto de grupos de recursos, exclua esses grupos do escopo do Scheduler do CSI. Em seguida, desative em Shop Floor Control Parameters a configuração que faz o Scheduler tratar ordens planejadas como demanda. O MRP, o planejamento de ordens do APS e o Get CTP podem continuar no CSI. O Running Time Lock do SkyPlanner mantém fixas as operações já iniciadas. No SkyPlanner, o Autopilot reprograma automaticamente quando há mudanças na produção, respeitando os bloqueios e as prioridades que você define.
Etapas típicas do projeto
A implementação normalmente é concluída em semanas após o início da implantação, mesmo em grandes empresas. Um projeto com o CSI inclui:
- Teste com dados exportados. Use Save to Excel nas listas de ordens de produção, operações e recursos do CSI, converta para CSV e importe no SkyPlanner. Valide a programação antes de trabalhar nas interfaces.
- Definição de escopo e mapeamento de dados mestres. Defina a tabela de mapeamento, o sistema responsável por cada campo, a frequência de sincronização, o canal de lançamento e como limitar o escopo do Scheduler nativo.
- Configuração do Infor OS. Aplicação Backend Service, arquivos
.ionapipor tenant, licença Automation e acesso à IDO REST API. Solicite o provisionamento do acesso à IDO REST API ao suporte da Infor Cloud logo no início, pois alguns tenants precisam dessa habilitação. - Carga inicial. Itens, BOMs, roteiros de produção dos itens, recursos, grupos de recursos e turnos por meio de
LoadCollection, além da matriz de tempos de preparação, das ferramentas e dos tamanhos de equipe no SkyPlanner. - Sincronização de ordens de produção e pedidos de compra. Primeiro, consulta periódica aos IDOs de ordens, operações, materiais e pedidos de compra em aberto; depois, o gatilho do BOD
ProductionOrder, se necessário. - Teste em paralelo com o plano atual. Execute o SkyPlanner em paralelo com a lista de despacho e corrija os tempos dos roteiros de produção e os dados dos recursos.
- Gravação da programação no CSI e confirmações do chão de fábrica. Ative a gravação da programação e dos apontamentos de mão de obra em
SLJobtransquando as datas e os dados estiverem consistentes entre os sistemas. - Entrada em operação para os grupos de recursos sob responsabilidade do SkyPlanner.
Pontos de atenção no CSI
- Mapear centros de trabalho como máquinas.
SLWcsé o IDO mais óbvio, mas não é o correto para capacidade. A programação se baseia em recursos e grupos de recursos (com a sequência dos membros). - Filtros de BOD que deixam ordens de fora ou as repetem. A publicação de
ProductionOrderdepende do gatilho escolhido e dos filtros de status. Filtrar apenas por'Firm'deixa de fora as alterações de materiais e mão de obra em ordens liberadas; sem o filtro de data da última publicação, tudo é reenviado. - Mão de obra rejeitada na gravação de retorno. O CSI rejeita apontamentos de mão de obra quando a ordem de produção não está com status Released ou Scheduled, quando a operação já foi concluída ou quando o funcionário está inativo. Valide antes e registre as rejeições em log.
- Presumir que uma linha equivale a uma transação contabilizada. Uma linha em
SLJobtranspermanece não contabilizada até a execução do Job Labor Transaction Posting. Defina a frequência de contabilização com a equipe financeira para que o estoque em processo (WIP) e a folha de pagamento recebam os dados de mão de obra no momento esperado. - Ordens atrasadas vindas do APS. O APS planeja de trás para frente a partir da data de entrega e, se isso não funcionar, de hoje em diante; ele nunca planeja no passado. Deixe o SkyPlanner programar as ordens atrasadas com base na capacidade real, em vez de confiar na data de início recebida.
- Detalhes do Mongoose. Nos valores dos parâmetros de
InvokeMethod, use a sequência de escape\x2cpara as vírgulas.
Quem configura a integração com o CloudSuite Industrial
- A equipe do SkyPlanner configura a integração durante a implantação e oferece suporte após a entrada em operação. Isso abrange o lado do SkyPlanner e a interface IDO e BOD, com o mapeamento adequado ao seu tenant. A equipe mantém a integração quando seus grupos de recursos, extensões de IDO ou status de ordens de produção mudam. Cada fábrica usa o CSI de uma maneira, e esse mapeamento é a especialidade da equipe.
- Seu parceiro Infor pode participar. Ele conhece suas extensões de IDO e sua configuração do ION, desenvolve com base na documentação Swagger/OpenAPI do SkyPlanner e se inscreve nos webhooks.
- Seus próprios desenvolvedores podem desenvolver a integração com a mesma API REST autenticada por JWT. Uma chave de API do SkyPlanner basta para começar (tutorial de integração), e a equipe do SkyPlanner ajuda quando necessário.
Por que as equipes que usam CSI adotam o SkyPlanner em vez de ajustar mais uma execução em lote
O SkyPlanner mantém enxuta a parte da integração no CSI. Ele lê ordens, operações, materiais e recursos e grava de volta duas coisas: os horários planejados das operações e os apontamentos de mão de obra em SLJobtrans. Entre a leitura e a gravação, faz o replanejamento que o CSI deixa a cargo das edições do planejador no Resource Gantt e da próxima execução do Scheduler:
- Programação orientada a eventos. O Arcturus gera a programação da produção em segundos, respeitando a capacidade real das máquinas e da equipe, e o Autopilot reprograma automaticamente quando há mudanças na produção, seja ao receber uma ordem alterada do CSI ou quando um operador registra o andamento do trabalho. Os webhooks então enviam os novos horários.
- Mão de obra registrada na origem. Mobile Confirmations, Production Timer e Quick Log Mode transformam os dados inseridos pelos operadores em apontamentos de tempo mapeados para linhas de
SLJobtrans. Assim, os dados de mão de obra chegam ao CSI sem redigitação. - Restrições fiéis ao chão de fábrica. Uma matriz de tempos de preparação escolhe a sequência de trocas de produção que exige menos preparação. As ferramentas são recursos compartilhados com capacidade finita, vários operadores podem atuar no mesmo centro de trabalho ao mesmo tempo, e outras máquinas e outros profissionais assumem quando o recurso principal está ocupado.
- Sequenciamento conforme os materiais. Com os materiais das ordens de produção, o estoque e os pedidos de compra em aberto do CSI no fluxo de dados, a disponibilidade de materiais é verificada na programação. O material comprado é considerado disponível na data de entrega do pedido de compra, e o estoque é atualizado quando o pedido recebe o status Delivered.
- Um teste que reduz os riscos do projeto. Carregue uma exportação do Save to Excel no teste de 30 dias e veja suas próprias operações em uma programação da produção que respeita a capacidade real das máquinas e da equipe. Pare um gargalo, adicione uma ordem urgente e atrase um pedido de compra. O mapeamento validado nesse teste se torna o escopo do trabalho com IDOs.
Escolha o SkyPlanner quando o CSI precisar continuar sendo o sistema de referência para itens, ordens de produção e custos. Você terá um sistema de programação e um aplicativo para o chão de fábrica com uma interface de integração enxuta e clara: entram ordens de produção e dados mestres; saem horários planejados e apontamentos de mão de obra. O SkyPlanner custa a partir de 199 € por mês, com 5 centros de trabalho incluídos, cobrança mensal e cancelamento a qualquer momento. O orçamento da integração é apresentado antecipadamente junto com o plano, de acordo com seu processo e suas necessidades, para que você conheça o custo total antes de começar.
Consulte os preços, os recursos e a documentação do SkyPlanner. Compare o CSI APS e o Scheduler com um sistema de programação na nuvem em Programação da produção no Infor CloudSuite Industrial. Ou acesse a página do Infor CloudSuite Industrial e a central de integrações com ERP.
Avaliações de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção passou das planilhas do Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Painéis elétricos e equipamentos de manobra
O planejamento da produção economiza 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 por TI
Laboratory & Allied · Fabricação de produtos farmacêuticos
A eficiência na produção aumentou 90%, e um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos para ser gerado.
98%de pontualidade de entrega, ante cerca de 50%
“O SkyPlanner tem um papel decisivo na manutenção da nossa pontualidade de entrega.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Fabricação de peças em chapa metálica e manufatura sob contrato
A pontualidade de entrega passou de cerca de 50% para até 98%, e a programação agora precisa de um supervisor em vez de dois.
6 mesesde capacidade disponível visível para a equipe de vendas
“O SkyPlanner oferece a base e a confiabilidade para todo o planejamento da produção.”
Anu Järvinen, gerente de produção
Fredman Operations · Papéis para embalagens próprias para contato com alimentos
A equipe de vendas visualiza a capacidade disponível com seis meses de antecedência, e as solicitações de alteração na programação que levavam uma hora ou mais agora são respondidas em segundos.
Perguntas frequentes
Quem desenvolve a integração com o CloudSuite Industrial ou o SyteLine?
Durante a implantação, a equipe do SkyPlanner configura a integração bidirecional para o seu ambiente CSI, usando a IDO REST API e os ION BODs, e oferece suporte após a entrada em produção. Seu parceiro Infor ou seus próprios desenvolvedores também podem criar a integração usando a API REST documentada do SkyPlanner, apenas com uma chave de API. Durante o período de teste, você pode começar com arquivos exportados em CSV ou Excel.
Qual API deve ser usada para integrar a programação da produção ao CSI?
A Mongoose IDO REST API via ION API Gateway, com OAuth 2.0 a partir de um arquivo .ionapi de uma aplicação Backend Service. Acrescente o BOD ProductionOrder para detectar alterações nas ordens se a consulta periódica não for rápida o suficiente.
Como as datas planejadas e os dados de mão de obra são gravados de volta no CSI?
O início e o término planejados das operações são gravados de volta por meio de UpdateItems do IDO na programação das operações da ordem, com atualização das datas Start e End da ordem em SLJobs. Os sites que protegem esses campos usam um método IDO personalizado por meio de InvokeMethod. Os apontamentos de mão de obra entram com AddItems como linhas ainda não contabilizadas em SLJobtrans, e o Job Labor Transaction Posting os contabiliza no estoque em processo (WIP).
Precisamos de uma licença adicional da Infor para conectar um sistema externo de programação da produção?
Sim, uma licença Automation. A documentação de licenciamento da Infor informa que aplicações externas conectadas pela camada IDO usam essa licença, com o tipo de sessão IDO.
Podemos manter o CSI APS e adicionar o SkyPlanner?
Sim. O CSI APS continua responsável pelo plano de materiais e pelo Get CTP/ATP, e o SkyPlanner assume o sequenciamento nos grupos de recursos que você transferir para ele.
Quanto tempo leva um projeto de integração com o CSI?
A implementação normalmente é concluída em semanas após o início da implantação. O projeto passa pelo mapeamento, pela carga inicial, pela sincronização de ordens de produção e pedidos de compra, pela gravação 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 teste gratuito de 30 dias inclui até 20 centros de trabalho e todos os recursos do plano Basic, sem exigir cartão de crédito. Comece com arquivos CSV ou Excel exportados do CSI. Inicie o teste gratuito ou fale com a equipe de vendas sobre o seu ambiente.