Integrações / ERP / HELIOS
Guia de integração do HELIOS para planejamento da produção com SkyPlanner APS
Este guia de integração do HELIOS mostra a parceiros e equipes de TI como conectar HELIOS iNuvio e HELIOS Nephrite ao SkyPlanner APS. A integração entre SkyPlanner e HELIOS é bidirecional e usa as próprias interfaces do HELIOS:
- São importadas as ordens de produção (výrobní příkazy) com suas operações, peças fabricadas, listas de materiais, roteiros de produção, postos de trabalho, máquinas, funções profissionais, recursos de pessoal, estoques e pedidos de compra.
- As datas planejadas de início e término são enviadas de volta às ordens de produção.
- Se você optar por isso, os apontamentos de tempo dos operadores podem ser enviados de volta como registros de operações (evidence výrobních operací).
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Durante a implantação, a equipe SkyPlanner configura a integração de acordo com o seu ambiente HELIOS e oferece suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores HELIOS que querem participar desse trabalho ou desenvolver suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do HELIOS
Helios Inuvio Server (Inuvio REST API). A Asseco o descreve como um componente separado do HELIOS iNuvio que permite acessar os módulos do HELIOS iNuvio via REST API (ajuda do Helios Inuvio Server). Ele acompanha a distribuição do iNuvio, e a especificação OpenAPI é publicada nos formatos Rapidoc e Redoc. A API opera sobre as consultas do HELIOS (browses), cada uma com seu próprio ID e suas permissões:
- GET /browses/list e GET /browses/meta listam as consultas disponíveis e suas colunas.
- /browses/data lê as linhas de uma consulta e grava linhas quando a consulta permite criar, atualizar e excluir registros.
- /api/v1/actions/meta e /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} executam ações externas em uma consulta. Atualmente, são ações externas dos tipos Procedure, Browse e Plugin.
As consultas de produção usadas pelo planejador incluem o plano de produção (výrobní plán), as ordens de produção (výrobní příkazy), as peças das ordens de produção, os materiais e produtos semiacabados para produção, as funções profissionais, os recursos de pessoal, as predefinições de operações dos roteiros de produção e os registros de operações. Estoques, entradas, saídas e pedidos de compra emitidos (vydané objednávky) estão disponíveis da mesma forma.
HELIOS Nephrite REST API. O roteiro de evolução do Nephrite inclui o desenvolvimento da REST API (roteiro de evolução do HELIOS Nephrite). Durante a definição de escopo, a equipe SkyPlanner confirma com você e seu parceiro HELIOS quais endpoints do Nephrite estão disponíveis na sua instalação. Os fluxos de dados abaixo permanecem os mesmos.
Excel e CSV. Todas as consultas do HELIOS permitem exportar para Microsoft Office, o que é suficiente para a carga de teste.
Autenticação e licenciamento
- Duas formas de autenticação. O iNuvio oferece uma API proprietária de autenticação mais antiga (/api/token) e uma API OAuth2 mais recente, baseada na RFC 6749 (/oauth/token, /oauth/revoke). Os tokens são renovados por POST /oauth/token ou GET /api/token.
- Licenciamento. O Helios Inuvio Server em si é gratuito, mas a REST API exige licença. A partir da versão 3.0.2026.0301, as APIs de sistema e de módulos são unificadas em uma única Inuvio REST API, e o acesso à API deixa de ser limitado pelo número de usuários.
- Permissões. O usuário da integração precisa de permissão de leitura nas consultas de produção e estoque, além de permissão para executar as ações externas acordadas.
No SkyPlanner, a REST API usa 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 orienta você nas primeiras chamadas.
Eventos e consultas periódicas
O SkyPlanner consulta o HELIOS em intervalos definidos. As chamadas a /browses/data usam filtros para ordens de produção em aberto e alterações recentes, identificando novas operações. A frequência é definida por fábrica: de intervalos de poucos minutos para ordens de produção a consultas de hora em hora para estoques.
O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, o envio de dados de volta ao HELIOS é acionado por eventos.
Mapeamento de dados
| Objeto do HELIOS (consulta) | Objeto do SkyPlanner | Direção | Frequência |
|---|---|---|---|
| Cadastros de itens e peças fabricadas (vyráběné dílce), unidades | Produtos e materiais | HELIOS → SkyPlanner | Carga inicial, depois 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 |
| Roteiros de produção (technologický postup): operação, posto de trabalho, tempo de preparação da máquina e do operador, tempo unitário, tempo de finalização, 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, raramente depois |
| Funções profissionais (výrobní profese), recursos de pessoal (výrobní personální zdroje) | Pessoal e número de operadores por operação | HELIOS → SkyPlanner | Carga inicial, depois a cada alteração |
| Calendários de planejamento (plánovací kalendáře) | Turnos e dias não úteis | HELIOS → SkyPlanner | Diariamente, ou turnos próprios no SkyPlanner |
| Ordens de produção (výrobní příkazy), peças e operações das ordens, materiais para produção | Ordens e operações com prazos e necessidades de materiais | HELIOS → SkyPlanner | Consultas a cada poucos minutos |
| Estoque (stav skladu) | Saldos de estoque | HELIOS → SkyPlanner | Consultas a cada hora ou a cada execução da programação |
| Pedidos de compra emitidos (vydané objednávky) com datas de entrega | Pedidos de compra, materiais a receber por data de entrega | HELIOS → SkyPlanner | Consultas de hora em hora ou ao executar a programação |
| Início e término planejados por operação da ordem de produção (ação externa) | Início e término planejados por operação | SkyPlanner → HELIOS | A cada alteração na programação, via webhook do SkyPlanner |
| Registros de operações (evidence výrobních operací) | Apontamentos de tempo e confirmações dos operadores | SkyPlanner → HELIOS | Por confirmação ou por turno, se essa opção for escolhida |
| Não disponível no HELIOS | Matriz de tempos de preparação, ferramentas como recursos finitos, operações com vários operadores | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia peças fabricadas, listas de materiais, roteiros de produção, postos de trabalho, máquinas, funções profissionais, recursos de pessoal e calendários nas consultas TPV. Cada recurso do HELIOS tem uma marcação que o inclui no planejamento da capacidade produtiva. Por isso, defina quais recursos serão programados pelo SkyPlanner. Um posto de trabalho com quatro máquinas se torna um grupo de centros de trabalho ou quatro centros de trabalho.
2. Sincronização de ordens. Leia as ordens de produção com suas peças, operações e materiais, além dos pedidos de compra emitidos. 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. Programe as ordens de produção liberadas. As quantidades previstas no plano de produção permanecem no HELIOS até se tornarem ordens de produção.
3. Retorno da programação ao HELIOS. Quando o mecanismo de programação aloca ou move uma operação, um webhook do SkyPlanner aciona uma ação externa na consulta de ordens de produção por meio de /api/v1/actions/execute. Essa ação é um procedimento do HELIOS, acordado na definição de escopo, que define o início e o término planejados da operação da ordem. O HELIOS valida a alteração usando sua própria lógica.
4. Confirmações do chão de fábrica. Os operadores registram o trabalho no SkyPlanner Mobile Confirmations ou no Production Timer, e os apontamentos de tempo mantêm a programação atualizada. Você decide se os tempos reais serão enviados de volta ao HELIOS. Se optar pelo envio, uma ação externa os grava como registros de operações para cada operação da ordem. Caso contrário, os operadores continuam fazendo os apontamentos nos terminais HELIOS, e o SkyPlanner lê esses registros.
5. Responsabilidade pelos dados e regras de conflito. Documente essas definições antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Itens, listas de materiais, roteiros de produção, quantidades, status das ordens | HELIOS |
| Sequência das operações, horários de início e término, alocação de máquinas | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição de escopo |
| Registros de operações, saídas e entradas de materiais | HELIOS, com registros inseridos diretamente ou enviados a partir dos apontamentos de tempo do SkyPlanner |
Defina um único sistema responsável por gravar as datas das ordens. Se o planejamento da capacidade produtiva do HELIOS ou o Nephrite APS ainda gravar datas, desative essa função para as ordens programadas pelo SkyPlanner ou mantenha o plano do HELIOS apenas como plano de teste.
Etapas típicas do projeto
A implementação normalmente é concluída em poucas semanas após o início da implantação. Antes disso, valide a programação no teste gratuito de 30 dias com postos de trabalho, roteiros de produção e ordens de produção em aberto 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 registros de operações serão enviados de volta.
- Acesso ao HELIOS. Configure o Helios Inuvio Server, o usuário da integração, as credenciais OAuth2 e o licenciamento da REST API. Faça os primeiros testes em uma cópia do banco de dados.
- Carga inicial. Peças fabricadas, listas de materiais, roteiros de produção, postos de trabalho, máquinas, funções profissionais e calendários.
- Sincronização de ordens e pedidos de compra. Consultas periódicas com filtros, paginação e novas tentativas em caso de falha.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, quantidade de operadores por operação e máquinas ou pessoal alternativos.
- Retorno da programação ao HELIOS. Crie e teste as ações externas para as datas planejadas e, se essa opção for escolhida, para os registros de operações.
- Testes em paralelo. Execute o SkyPlanner em paralelo ao plano atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative o envio de dados de volta ao HELIOS quando os dados coincidirem.
O que considerar ao planejar uma integração com o HELIOS
- Marcações de planejamento. Somente os recursos marcados para planejamento da capacidade produtiva têm dados de capacidade confiáveis. Verifique as marcações dos postos de trabalho, máquinas, funções profissionais e serviços subcontratados antes da primeira carga.
- Unidades de tempo. Os tempos de preparação, por unidade e de finalização podem ser informados em horas, minutos ou segundos. Converta as unidades na importação; caso contrário, todas as durações ficarão incorretas.
- Tempo entre operações. O tempo constante entre operações é uma espera entre etapas, não tempo de máquina. Modele esse intervalo como espera, não como capacidade.
- Operações terceirizadas (kooperace). O tempo de transporte se aplica tanto à ida quanto à volta. Modele as operações terceirizadas como etapas que consideram apenas o tempo.
- Visões que permitem gravação. Todas as visões permitem leitura, mas apenas algumas permitem criar, atualizar e excluir registros. GET /browses/list com o filtro browseCreateImplemented=1 mostra quais são. As visões de ordens de produção são somente leitura, por isso as datas planejadas são enviadas de volta pela ação externa acordada.
Quem configura e dá suporte à integração com o HELIOS
- A equipe SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, abrangendo as visões e ações externas acordadas. Cada fábrica usa o HELIOS de uma forma, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro HELIOS pode participar. Ele conhece sua instalação, os procedimentos personalizados e o licenciamento, e pode configurar o Helios Inuvio Server e as ações externas junto com a equipe SkyPlanner.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API do SkyPlanner com um token de API. Basta um token de API para começar, e a equipe SkyPlanner ajuda quando necessário. Consulte a 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 seu plano, de acordo com seu processo e suas necessidades. Consulte os preços, a programação com capacidade finita no HELIOS, a página do HELIOS e a central de integrações com ERP. Para conhecer os fundamentos, consulte programação da produção.
Depoimentos 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 fica pronto em menos de 30 minutos.
Milhares (× 1.000)de ordens de produção programadas automaticamente
“Hoje temos um controle diferente da produção, e nossa compreensão da capacidade está em um patamar completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabricação sob contrato de alta tecnologia
Milhares de ordens de produção são programadas automaticamente, e toda a organização tem uma visão da produção em tempo real.
100%de pontualidade de entrega desde 2021
“O SkyPlanner nos dá visibilidade da capacidade e torna o planejamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Fabricação de produtos químicos e alimentos
A pontualidade de entrega se mantém em 100% desde 2021, durante todo o período de uso do SkyPlanner.
Perguntas frequentes
O HELIOS tem uma API para ordens de produção?
Sim. O Helios Inuvio Server oferece acesso REST às visões do HELIOS iNuvio, incluindo o plano de produção, as ordens de produção, os itens das ordens, os materiais para produção e os registros de operações. Para o HELIOS Nephrite, a equipe SkyPlanner define a abordagem para sua instalação junto com você e seu parceiro HELIOS, durante a definição de escopo da implantação.
Como o SkyPlanner identifica as alterações no HELIOS?
O SkyPlanner consulta periodicamente as visões do HELIOS, em intervalos definidos para cada fábrica, filtrando as ordens de produção em aberto e as alterações recentes. Os webhooks do próprio SkyPlanner enviam as alterações no planejamento assim que elas ocorrem.
Como as datas planejadas são gravadas de volta no HELIOS?
Por meio de uma ação externa na visão de ordens de produção, executada com /api/v1/actions/execute. Essa ação é um procedimento do HELIOS acordado na definição de escopo, de modo que o HELIOS aplica sua própria lógica a cada data recebida.
Qual autenticação a Inuvio REST API usa?
OAuth2 conforme a RFC 6749 em /oauth/token, ou o mecanismo proprietário mais antigo em /api/token. A API do próprio SkyPlanner usa 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 com frequência e precisa respeitar os limites de capacidade. O planejamento no HELIOS funciona por meio de cálculos sobre um único plano ativo, pode mudar para capacidade ilimitada para cumprir as datas e deixa a resolução de conflitos a cargo do planejador (ajuda do HELIOS). O SkyPlanner se conecta pela REST API, replaneja automaticamente, planeja trocas de produção, ferramentas, equipes e materiais, e oferece usuários ilimitados, a partir de 199 € por mês.
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 de arquivos CSV ou Excel do HELIOS, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe comercial para definir o escopo da integração.