Integrações / ERP / HELIOS
Guia de integração do HELIOS para programação da produção com SkyPlanner APS
Este guia de integração do HELIOS mostra aos parceiros e às equipas de TI como ligar o HELIOS iNuvio e o HELIOS Nephrite ao SkyPlanner APS. O SkyPlanner integra-se com o HELIOS nos dois sentidos, através das interfaces do próprio HELIOS:
- São importadas as ordens de fabrico (výrobní příkazy) com as respetivas operações, peças fabricadas, listas de materiais, gamas operatórias, postos de trabalho, máquinas, profissões, recursos humanos, existências e encomendas de compra.
- As datas previstas de início e fim são enviadas de volta para as ordens de fabrico.
- Se assim o pretender, os registos de tempos dos operadores podem ser enviados de volta como registos de operações (evidence výrobních operací).
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua instalação HELIOS e assegura o suporte após a entrada em produção. Este guia destina-se aos parceiros e programadores HELIOS que pretendem participar ou desenvolver a integração por conta própria com base na REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do HELIOS
Helios Inuvio Server (Inuvio REST API). A Asseco descreve-o como um componente separado do HELIOS iNuvio que permite aceder às áreas funcionais do HELIOS iNuvio através de uma REST API (ajuda do Helios Inuvio Server). É fornecido com a distribuição iNuvio e a especificação OpenAPI está publicada nos formatos Rapidoc e Redoc. A API trabalha com as vistas do HELIOS (browses), cada uma com o seu próprio ID e permissões:
- GET /browses/list e GET /browses/meta listam as vistas disponíveis e as respetivas colunas.
- /browses/data lê as linhas de uma vista e permite escrevê-las quando a vista admite criação, atualização e eliminação.
- /api/v1/actions/meta e /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} executam ações externas numa vista. Atualmente, são suportadas ações externas dos tipos Procedure, Browse e Plugin.
As vistas de produção utilizadas por quem programa a produção incluem o plano de produção (výrobní plán), as ordens de fabrico (výrobní příkazy), as peças das ordens de fabrico, os materiais e produtos semiacabados para produção, as profissões, os recursos humanos, as predefinições das operações das gamas operatórias e os registos de operações. As existências, as entradas, as saídas e as encomendas de compra emitidas (vydané objednávky) estão disponíveis da mesma forma.
HELIOS Nephrite REST API. O plano de evolução do Nephrite inclui o desenvolvimento da REST API (plano de evolução do HELIOS Nephrite). Durante a definição do âmbito, a equipa SkyPlanner confirma consigo e com o seu parceiro HELIOS os endpoints Nephrite da sua instalação. Os fluxos de dados apresentados abaixo mantêm-se.
Excel e CSV. Todas as vistas do HELIOS permitem exportar para Microsoft Office, o que é suficiente para carregar os dados do período de avaliação.
Autenticação e licenciamento
- Duas opções de autenticação. O iNuvio disponibiliza uma API de autenticação proprietária mais antiga (/api/token) e uma API OAuth2 mais recente, baseada no RFC 6749 (/oauth/token, /oauth/revoke). Os tokens são renovados através de POST /oauth/token ou GET /api/token.
- Licenciamento. O Helios Inuvio Server é gratuito, mas a REST API está sujeita a licenciamento. A partir da versão 3.0.2026.0301, as APIs de sistema e das áreas funcionais estão reunidas numa única Inuvio REST API e o acesso à API deixa de estar limitado pelo número de utilizadores.
- Permissões. O utilizador da integração precisa de permissões de leitura nas vistas de produção e de existências, bem como de permissão para executar as ações externas acordadas.
Do lado do SkyPlanner, a REST API utiliza um token de API no cabeçalho Authorization-Token para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica passo a passo as primeiras chamadas.
Eventos e consultas periódicas
O SkyPlanner lê os dados do HELIOS a intervalos definidos. As chamadas a /browses/data, filtradas pelas ordens de fabrico abertas e pelas alterações recentes, recolhem os novos trabalhos. A frequência é definida por fábrica: de poucos em poucos minutos para as ordens de fabrico e de hora a hora para as existências.
O SkyPlanner envia webhooks quando há alterações no estado ou na programação, pelo que a escrita de dados de volta no HELIOS é desencadeada por eventos.
Mapeamento de dados
| Objeto HELIOS (vista) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Fichas de artigos e peças fabricadas (vyráběné dílce), unidades | Produtos e materiais | HELIOS → SkyPlanner | Carregamento inicial, seguido de consultas periódicas |
| Listas de materiais (kusovník, kusovníkové vazby) com datas de validade | Estrutura do produto, subprodutos, materiais por produto | HELIOS → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Gamas operatórias (technologický postup): operação, posto de trabalho, tempo de preparação da máquina e do operador, tempo unitário, tempo de finalização e tempo entre operações | Etapas do processo com durações e tempos de preparação e desmontagem | HELIOS → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Postos de trabalho (pracoviště), máquinas (stroje), postos de trabalho alternativos | Centros de trabalho, grupos de centros de trabalho, centros de trabalho alternativos | HELIOS → SkyPlanner | Carga inicial e, depois, raramente |
| Profissões (výrobní profese), recursos humanos (výrobní personální zdroje) | Pessoal e número de operadores por tarefa | HELIOS → SkyPlanner | Carregamento inicial, depois a cada alteração |
| Calendários de planeamento (plánovací kalendáře) | Turnos e dias não úteis | HELIOS → SkyPlanner | Diariamente, ou turnos próprios no SkyPlanner |
| Ordens de fabrico (výrobní příkazy), peças e operações das ordens, materiais para produção | Ordens e tarefas com datas-limite e necessidades de materiais | HELIOS → SkyPlanner | Consultas de poucos em poucos minutos |
| Existências (stav skladu) | Saldos de existências | HELIOS → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Encomendas de compra emitidas (vydané objednávky) com datas de entrega | Encomendas de compra, materiais a receber por data de entrega | HELIOS → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Início e fim previstos por operação da ordem de fabrico (ação externa) | Início e fim previstos por tarefa | SkyPlanner → HELIOS | A cada alteração da programação, através de um webhook do SkyPlanner |
| Registos de operações (evidence výrobních operací) | Registos de tempos e confirmações dos operadores | SkyPlanner → HELIOS | Por confirmação ou por turno, se optar por esta funcionalidade |
| Não existe no HELIOS | Matriz de tempos de preparação, ferramentas como recursos de capacidade limitada, tarefas com vários operadores | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carregamento inicial dos dados mestre. Leia as peças fabricadas, listas de materiais, gamas operatórias, postos de trabalho, máquinas, profissões, recursos humanos e calendários a partir das vistas TPV. Cada recurso do HELIOS tem um indicador que permite incluí-lo no planeamento da capacidade. Decida, por isso, quais os recursos que o SkyPlanner irá programar. Um posto de trabalho com quatro máquinas dá origem a um grupo de centros de trabalho ou a quatro centros de trabalho.
2. Sincronização das ordens. Leia as ordens de fabrico com as respetivas peças, operações e materiais, bem como as encomendas de compra emitidas. O SkyPlanner considera que o material encomendado fica disponível na data de entrega da encomenda de compra e atualiza as existências quando esta é marcada como Delivered. Programe as ordens de fabrico lançadas. As quantidades previstas no plano de produção permanecem no HELIOS até se tornarem ordens de fabrico.
3. Escrita da programação no HELIOS. Quando o motor posiciona ou desloca uma tarefa, um webhook do SkyPlanner desencadeia uma ação externa na vista de ordens de fabrico através de /api/v1/actions/execute. A ação é um procedimento HELIOS, acordado durante a definição do âmbito, que define o início e o fim previstos da operação da ordem. O HELIOS valida a alteração segundo a sua própria lógica.
4. Confirmações na fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempos mantêm a programação atualizada. Pode optar por enviar ou não os tempos reais de volta para o HELIOS. Se optar pelo envio, uma ação externa grava-os como registos de operações, por operação da ordem. Caso contrário, os operadores continuam a registar o trabalho nos terminais HELIOS e o SkyPlanner lê esses registos.
5. Responsabilidade pelos dados e regras de resolução de conflitos. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos, listas de materiais, gamas operatórias, quantidades, estado das ordens | HELIOS |
| Sequência das operações, horas de início e fim, atribuição de máquinas | SkyPlanner |
| Matriz de tempos de preparação, necessidades de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição do âmbito |
| Registos de operações, saídas e entradas de materiais | HELIOS, com introdução direta ou envio a partir dos registos de tempos do SkyPlanner |
Escolha um único sistema para escrever as datas das ordens. Se o planeamento da capacidade do HELIOS ou o Nephrite APS ainda escrever datas, desative essa função para as ordens programadas pelo SkyPlanner ou mantenha o plano do HELIOS apenas como plano de teste.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, valide a programação durante o período de avaliação gratuita de 30 dias, com postos de trabalho, gamas operatórias e ordens de fabrico abertas exportados do HELIOS em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e se os registos de operações serão enviados de volta para o HELIOS.
- Acesso ao HELIOS. Configure o Helios Inuvio Server, o utilizador da integração, as credenciais OAuth2 e o licenciamento da REST API. Teste primeiro numa cópia da base de dados.
- Carregamento inicial. Peças fabricadas, listas de materiais, gamas operatórias, postos de trabalho, máquinas, profissões e calendários.
- Sincronização de ordens de fabrico e encomendas de compra. Consultas periódicas com filtros, paginação e novas tentativas.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
- Escrita da programação no HELIOS. Crie e teste as ações externas para as datas previstas e, se optar por essa funcionalidade, para os registos de operações.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare as datas e corrija os dados mestre.
- Entrada em produção. Ative a gravação dos dados no HELIOS quando os dados coincidirem.
O que prever numa integração com o HELIOS
- Indicadores de planeamento. Apenas os recursos assinalados para planeamento da capacidade têm dados de capacidade fiáveis. Verifique esses indicadores nos postos de trabalho, máquinas, profissões e subcontratações antes do primeiro carregamento.
- Unidades de tempo. Os tempos de preparação, unitários e de finalização podem ser introduzidos em horas, minutos ou segundos. Converta-os durante a importação; caso contrário, todas as durações ficarão erradas.
- Tempo entre operações. O tempo constante entre operações é tempo de espera, não tempo de máquina. Modele-o como espera, não como capacidade.
- Operações subcontratadas (kooperace). O tempo de transporte aplica-se tanto à ida como à volta. Modele as operações subcontratadas como etapas que apenas consomem tempo.
- Vistas com permissão de escrita. Todas as vistas permitem a leitura, mas só algumas permitem criar, atualizar e eliminar registos. GET /browses/list com o filtro browseCreateImplemented=1 mostra quais. As vistas das ordens de produção são apenas de leitura, pelo que as datas planeadas são enviadas de volta através da ação externa acordada.
Quem configura e dá suporte à integração com o HELIOS
- A equipa SkyPlanner configura a integração durante a implementação e dá suporte após a entrada em produção, abrangendo as vistas e as ações externas acordadas. Cada fábrica utiliza o HELIOS de forma diferente, e é nesta fase que esse conhecimento é aplicado.
- O seu parceiro HELIOS pode participar. O parceiro conhece a sua instalação, os procedimentos personalizados e o licenciamento, e pode configurar o Helios Inuvio Server e as ações externas em conjunto com a equipa SkyPlanner.
- Os seus próprios programadores podem ampliar esta integração utilizando a REST API do SkyPlanner com um token de API. Basta um token de API para começar, e a equipa SkyPlanner presta apoio quando necessário. Consulte a documentação de integração do SkyPlanner.
O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. O orçamento da integração é apresentado antecipadamente, juntamente com o seu plano, de acordo com os seus processos e necessidades. Consulte os preços, a programação da produção com HELIOS que respeita a capacidade real de máquinas e equipas, a página HELIOS e a área de integrações ERP. Para conhecer os conceitos básicos, consulte a página sobre programação da produção.
Testemunhos de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos de planear a produção em folhas de 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 permite poupar 2 horas de trabalho por semana, e uma nova fila de tarefas 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 · Produção farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado para três meses que abrange todos os centros de trabalho demora menos de 30 minutos.
1 000sordens de fabrico programadas automaticamente
“Temos um controlo diferente sobre a produção, e a nossa compreensão da capacidade está num nível completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabrico por contrato de alta tecnologia
Milhares de ordens de fabrico são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
100%de fiabilidade das entregas desde 2021
“O SkyPlanner dá-nos visibilidade sobre a capacidade e torna o planeamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Indústria química e alimentar
A fiabilidade das entregas tem sido de 100% desde que o SkyPlanner começou a ser utilizado, em 2021.
Perguntas frequentes
O HELIOS tem uma API para ordens de produção?
Sim. O Helios Inuvio Server permite aceder via REST às vistas do HELIOS iNuvio, incluindo o plano de produção, as ordens de produção, as peças das ordens, os materiais para produção e os registos de operações. No caso do HELIOS Nephrite, a equipa SkyPlanner define a abordagem para a sua instalação consigo e com o seu parceiro HELIOS, durante a definição do âmbito da implementação.
Como é que o SkyPlanner deteta as alterações no HELIOS?
O SkyPlanner consulta periodicamente as vistas do HELIOS, com uma frequência definida para cada fábrica e filtros para ordens de produção em aberto e alterações recentes. Os webhooks do próprio SkyPlanner enviam as alterações à programação assim que estas ocorrem.
Como são enviadas e gravadas no HELIOS as datas planeadas?
Através de uma ação externa na vista das ordens de produção, executada com /api/v1/actions/execute. Esta ação é um procedimento do HELIOS acordado durante a definição do âmbito, pelo que o HELIOS aplica a sua própria lógica a cada data que recebe.
Que autenticação utiliza a REST API do Inuvio?
OAuth2 segundo a RFC 6749 em /oauth/token, ou o mecanismo proprietário mais antigo em /api/token. A API do próprio SkyPlanner utiliza um token de API no cabeçalho Authorization-Token.
Um parceiro HELIOS deve propor o HELIOS APS ou o SkyPlanner?
O SkyPlanner, quando o plano do cliente muda frequentemente e é necessário respeitar os limites reais de capacidade. O planeamento do HELIOS baseia-se em cálculos sobre um único plano ativo, pode passar a capacidade ilimitada para cumprir as datas e deixa a resolução dos conflitos ao responsável pelo planeamento (ajuda do HELIOS). O SkyPlanner liga-se através da REST API, replaneia automaticamente, planeia mudanças de série, ferramentas, equipas e materiais, e inclui utilizadores ilimitados, a partir de 199 € por mês.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O período experimental gratuito de 30 dias permite utilizar até 20 centros de trabalho, com importações de ficheiros CSV ou Excel do HELIOS, sem necessidade de cartão de crédito. Experimente grátis ou fale com a equipa comercial para definir o âmbito da integração.