Integrações / ERP / IFS Cloud
Guia de integração do IFS Cloud para programação da produção com SkyPlanner APS
Este guia de integração do IFS Cloud mostra a parceiros e equipes de TI como conectar o IFS Cloud ao SkyPlanner APS. A integração entre SkyPlanner e IFS Cloud é bidirecional e usa as APIs do próprio IFS:
- O SkyPlanner recebe ordens de produção com operações e materiais, roteiros de produção, estruturas de produtos, centros de trabalho, classes de mão de obra, ferramentas, disponibilidade de itens em estoque e pedidos de compra.
- Os horários planejados de início e término e o recurso escolhido do centro de trabalho são gravados de volta nas operações das ordens de produção.
- 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 IFS Cloud durante a implantação e oferece suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver por conta própria com a REST API documentada do SkyPlanner (referência da API).
Opções de integração com o IFS Cloud
Projeções OData (APIs RESTful).
O IFS Cloud expõe sua lógica de negócio por meio de projeções OData. “Projections are exposed in the /ifsapplications/projection/ endpoint,” (As projeções são expostas no endpoint /ifsapplications/projection/), no endpoint main, int ou b2b, dependendo do tipo de projeção. Um caminho típico parte de /main/ifsapplications/, passa pela versão da projeção e chega ao serviço .svc da projeção e ao seu conjunto de entidades. Cada projeção publica metadados OData: “a machine-readable description of the data model of the APIs.” (uma descrição do modelo de dados das APIs legível por máquina). (fonte)
API Explorer.
O cliente web do IFS Cloud lista todas as projeções com a documentação da API e uma especificação OpenAPI para o seu ambiente. Use Premium APIs e Entity Service APIs na integração, não as projeções de interface usadas pelas páginas do cliente. As Premium APIs são versionadas: “The old version of the projection will still be retained along with the new version till the next release.” (A versão antiga da projeção será mantida junto com a nova até a próxima versão do sistema.) (fonte)
IFS Connect.
O intermediador de integração encaminha mensagens para endereços HTTP/REST, arquivos e outros destinos. Segundo a IFS: “Modern integration use web services together with IFS Connect and/or 3rd party integration tools.” (As integrações modernas usam serviços web em conjunto com o IFS Connect e/ou ferramentas de integração de terceiros.) (fonte) A IFS também documenta opções com middleware, como o Boomi.
Arquivos.
As tarefas do Data Migration Manager, File Migration e Excel Migration atendem às cargas em massa. Durante o período de teste, basta uma exportação simples em Excel.
Autenticação
As integrações externas se autenticam pelo IFS Identity and Access Manager (IAM), com OAuth 2.0 e OpenID Connect:
- Cadastre um IAM Client para o SkyPlanner e use o fluxo Client Credentials. Ele “allows for a non-interactive authentication of a service account” (permite a autenticação não interativa de uma conta de serviço) e “yields an access token associated with a service user.” (gera um token de acesso associado a um usuário de serviço).
- Solicite os tokens em
POST https://<SYSTEM_URL>/auth/realms/<NAMESPACE>/protocol/openid-connect/token. - Atribua ao usuário de serviço conjuntos de permissões apenas para as projeções que a integração lê e grava, e nada além disso.
(fonte)
No SkyPlanner, a REST API usa um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta as primeiras chamadas.
Eventos e detecção de alterações
O IFS Cloud tem uma estrutura de eventos: “Events can be used to automate actions within IFS Cloud.” (Eventos podem ser usados para automatizar ações no IFS Cloud.) Eventos personalizados são disparados quando uma entidade é criada, atualizada ou removida, e suas ações são executadas por meio do IFS Connect. (fonte)
O envio é feito pelo REST Sender: “Outbound messages can be sent either synchronously or asynchronously,” (As mensagens de saída podem ser enviadas de forma síncrona ou assíncrona), com o roteamento configurado no IFS Connect. (fonte) O Workflow Manager também pode chamar endpoints REST.
Duas abordagens funcionam:
- Orientada a eventos. Um evento personalizado para alterações em ordens de produção e suas operações dispara uma mensagem do REST Sender para a REST API do SkyPlanner.
- Consulta periódica. A cada poucos minutos, o SkyPlanner lê as ordens de produção em aberto nas projeções, filtrando apenas os registros alterados.
Comece com consultas periódicas e adicione eventos para os objetos que mudam com mais frequência. O SkyPlanner envia webhooks quando o estado ou a programação muda, portanto a gravação de volta no IFS é orientada a eventos.
Mapeamento de dados
Os nomes das projeções variam conforme a versão. Consulte os nomes exatos no seu API Explorer.
| Objeto do IFS Cloud | Objeto do SkyPlanner | Direção | Frequência |
|---|---|---|---|
| Inventory Part (por unidade) | Produtos e materiais | IFS → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Product Structure (cabeçalho, alternativa, linhas) | Estrutura do produto, subprodutos, materiais por produto | IFS → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Routing, Routing Operations: tempos de preparação, execução e movimentação, eficiência | Etapas do processo com durações e tempos de preparação e desmontagem | IFS → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Work Center, Work Center Resource: calendário, utilização, eficiência | Centros de trabalho, grupos de centros de trabalho, eficiências | IFS → SkyPlanner | Carga inicial; raramente depois |
| Pessoas da Labor Class; tamanho da equipe na operação | Pessoal com turnos; operadores por operação | IFS → SkyPlanner | Carga inicial; turnos mantidos em um único sistema |
| Manufacturing Tool, grupos de ferramentas | Ferramentas como recursos compartilhados de capacidade limitada | IFS → SkyPlanner | Carga inicial |
| Shop Order (Released, Reserved, Started) com Shop Order Operations e materiais: Need Date, Earliest Start Date, prioridade | Ordens e operações com prazos e necessidades de materiais | IFS → SkyPlanner | Por evento ou consulta a cada poucos minutos |
| Disponibilidade de itens em estoque | Saldos de estoque | IFS → SkyPlanner | Consulta a cada hora ou ao executar a programação |
| Linhas de pedidos de compra com recebimento previsto | Pedidos de compra com data prevista de entrega; estoque atualizado quando marcados como Delivered | IFS → SkyPlanner | Consulta a cada hora ou ao executar a programação |
| Shop Order Operation: início, término, recurso do centro de trabalho | Início e término planejados e centro de trabalho por operação | SkyPlanner → IFS | A cada alteração na programação, via webhook do SkyPlanner |
| Apontamento de operações (tempo de máquina, tempo de mão de obra, quantidade) | Registros de tempo e confirmações dos operadores | SkyPlanner → IFS | A cada confirmação ou por turno, se escolhido na definição de escopo |
| Configurado no SkyPlanner | Matriz de tempos de preparação, máquinas e pessoal alternativos | Mantido no SkyPlanner | Configurado durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Importe itens de estoque, estruturas de produtos que podem ser fabricados, roteiros de produção com operações, centros de trabalho e seus recursos, classes de mão de obra e ferramentas. Defina com cuidado o mapeamento de cada recurso de centro de trabalho para um centro de trabalho do SkyPlanner. Decida se um centro de trabalho com três recursos será representado por um grupo de centros de trabalho ou por três centros de trabalho.
2. Sincronização de ordens de produção. Leia as ordens de produção nos estados Released, Reserved e Started com suas operações e materiais. Deixe as ordens no estado Planned a cargo do MRP; elas mudam a cada execução do planejamento. Inclua a disponibilidade dos itens em estoque e as linhas de pedidos de compra em aberto para que a programação verifique tanto o estoque quanto as compras a receber. O SkyPlanner considera o material comprado disponível na data de entrega do pedido de compra.
3. Gravação da programação no IFS. Para cada operação que o mecanismo programou ou moveu, o SkyPlanner grava o início e o término planejados e o recurso do centro de trabalho na operação da ordem de produção. A gravação passa pela projeção de operações de ordens de produção listada no seu API Explorer, para que o IFS execute suas próprias validações. Quantidades, estados e custos continuam sob o controle do IFS.
4. Confirmações no chão de fábrica. Escolha um único canal por unidade. Os operadores podem continuar fazendo apontamentos no Shop Floor Workbench, e o SkyPlanner lê o andamento. Outra opção é registrar o trabalho com SkyPlanner Mobile Confirmations e Production Timer. Nesse caso, os registros de tempo são enviados ao IFS pela projeção de apontamento de operações acordada na definição de escopo.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Itens de estoque, estruturas de produtos, roteiros de produção, quantidades, estado das ordens de produção | IFS Cloud |
| Sequência das operações, horários de início e término, alocação de recursos | SkyPlanner |
| Matriz de tempos de preparação e transição, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e ausências | Um único sistema, escolhido na definição de escopo |
| Apontamentos de operações e recebimentos | IFS Cloud, a partir do Shop Floor Workbench ou dos apontamentos de horas do SkyPlanner |
A principal fonte de conflitos é a reprogramação dentro do IFS. Se um planejador reprogramar uma ordem de produção com o Infinite Scheduler, trate-a como uma nova versão, sincronize-a novamente e deixe o SkyPlanner refazer o planejamento. Com o Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção. As unidades que também usam o MSO definem quais centros de trabalho ficam sob a responsabilidade de cada sistema de programação.
Etapas típicas do projeto
A implementação normalmente é concluída nas semanas seguintes ao início da implantação, mesmo em grandes empresas. Antes disso, o teste gratuito de 30 dias usa seus próprios dados: exporte centros de trabalho, roteiros de produção e ordens de produção em aberto do IFS Cloud para o Excel e importe-os.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e o canal de apontamento.
- IAM e permissões. Registre o cliente IAM, crie o usuário de serviço e conceda os conjuntos de permissões das projeções. Primeiro no ambiente de testes, depois em produção.
- Carga inicial. Itens de estoque, estruturas de produtos, roteiros de produção, centros de trabalho, classes de mão de obra e ferramentas.
- Sincronização de ordens de produção e pedidos de compra. Comece com consultas periódicas e use eventos personalizados onde o volume de alterações for alto.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, quantidades de operadores e máquinas ou pessoal alternativos.
- Gravação da programação no IFS. Grave as datas e os recursos nas operações das ordens de produção.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative a gravação no IFS quando os dados coincidirem.
O que considerar ao planejar uma integração com o IFS Cloud
- Tempo de máquina e tempo de mão de obra. As operações das ordens de produção têm tempos separados de preparação e execução para máquina e mão de obra, além do tamanho da equipe. Defina qual deles determina a duração em cada centro de trabalho; caso contrário, todas as operações ficarão incorretas.
- Utilização e eficiência contabilizadas em duplicidade. A utilização do centro de trabalho, a eficiência da operação e a eficiência do recurso reduzem o tempo disponível no IFS. Ao mapeá-las para a eficiência do centro de trabalho no SkyPlanner, aplique esses fatores uma única vez.
- Capacidade desatualizada. A capacidade dos recursos só existe após a execução de Calculate Work Center Resource Capacity. Confira os calendários e os períodos de validade antes da carga inicial.
- Preferred Resource indica uma preferência. Cadastre explicitamente as alternativas reais como centros de trabalho alternativos no SkyPlanner.
- As projeções da interface mudam. Desenvolva a integração com as APIs Premium ou Entity Service, que mantêm a versão anterior até a próxima versão ser lançada. Repita os testes a cada lançamento semestral.
- As projeções do Shop Floor Workbench são fluxos de interface. As projeções criadas para o assistente do Shop Floor Workbench não se destinam à integração transacional direta. Escolha a projeção de apontamento durante a definição de escopo.
Quem configura a integração
O trabalho inclui o mapeamento dos seus roteiros de produção, centros de trabalho e configurações do IFS. Também abrange as restrições que o SkyPlanner considera ao programar dentro da capacidade real de máquinas e equipes: matriz de tempos de preparação, ferramentas, quantidades de operadores e recursos alternativos.
- A equipe do SkyPlanner configura a integração durante a implantação e oferece suporte após a entrada em produção, tanto no lado do SkyPlanner quanto nas projeções do IFS acordadas. Cada fábrica usa o IFS Cloud de uma forma diferente, e é nessa configuração que esse conhecimento é aplicado.
- Seu parceiro IFS pode participar. O parceiro conhece sua configuração e pode configurar o cliente IAM, os conjuntos de permissões e os eventos junto com a equipe. O SkyPlanner fornece a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Seus próprios desenvolvedores podem desenvolver a integração usando a mesma REST API documentada, com um token de API. Um token de API basta para começar, e a equipe do SkyPlanner ajuda quando necessário. A documentação pública está na documentação de integração do SkyPlanner.
O SkyPlanner custa a partir de 199 € por mês, com 5 centros de trabalho incluídos e cobrança mensal. O orçamento da integração é apresentado antecipadamente, junto com o seu plano, de acordo com seu processo e suas necessidades. Assim, você conhece o custo total antes de começar. Veja como a programação do próprio IFS se compara em programação da produção no IFS Cloud com capacidade real de máquinas e equipes. A visão geral está na página do IFS Cloud, e os demais ERPs estão na central de integrações com ERP.
Depoimentos de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu 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 operações 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 fica pronto em menos de 30 minutos.
99,2%de pontualidade de entrega
“O SkyPlanner trouxe visibilidade para identificar gargalos e tornou a gestão da produção mais clara.”
Toni Tuori, gerente de produção
Piristeel · Sistemas de segurança para telhados e de captação de águas pluviais
A pontualidade de entrega atingiu 99,2% neste ano, e a programação economiza até quatro horas de trabalho por dia.
Menosparadas por falta de materiais
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, especialmente para definir datas de entrega.”
Tommi Männistö, gerente de planejamento da produção
Eskomatic · Usinagem sob contrato
A programação automática da carga de trabalho permite definir datas de entrega mais precisas, e as paradas de produção por falta de materiais diminuíram drasticamente.
Perguntas frequentes
Qual API do IFS Cloud deve ser usada em uma integração para programação da produção?
As projeções OData em /ifsapplications/projection/, de preferência as APIs Premium ou Entity Service listadas no seu API Explorer. Elas incluem especificações OpenAPI por ambiente e mantêm a versão anterior até o próximo lançamento.
Quem desenvolve a integração com o IFS Cloud?
A equipe do SkyPlanner configura a integração bidirecional de acordo com sua configuração do IFS durante a implantação e oferece suporte após a entrada em produção. Seu parceiro IFS ou seus próprios desenvolvedores também podem desenvolver a integração usando a REST API documentada do SkyPlanner. Um token de API basta para começar.
Qual autenticação a integração usa?
Um cliente IFS IAM com o fluxo OAuth 2.0 Client Credentials, vinculado a um usuário de serviço com conjuntos de permissões para as projeções necessárias. A API do próprio SkyPlanner usa um token de API.
O IFS Cloud pode enviar alterações de ordens de produção em tempo real?
Sim, com eventos personalizados para alterações de entidades e o REST Sender, ambos configurados no IFS Connect. Comece com consultas periódicas a cada poucos minutos e adicione eventos onde o volume de alterações for alto. Os webhooks do SkyPlanner enviam as alterações da programação assim que elas ocorrem.
Precisamos do MSO ou do PSO para essa integração?
Não. O SkyPlanner lê ordens de produção, operações e centros de trabalho diretamente das projeções do IFS e cria a programação respeitando a capacidade real de máquinas e equipes. Você dispensa o acesso ao MSO, o PSO Cloud Service ou o IFS.ai Activation Pass e o planejamento do consumo de tokens. O Autopilot refaz o planejamento automaticamente a cada alteração.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite usar até 20 centros de trabalho com importações do IFS Cloud em Excel ou CSV, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
