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.
Cronograma de Gantt do SkyPlanner APS com tarefas programadas por centro de trabalho e uma lista de ordens em baixo.

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 SkyPlannerSentidoFrequência
Fichas de artigos e peças fabricadas (vyráběné dílce), unidadesProdutos e materiaisHELIOS → SkyPlannerCarregamento inicial, seguido de consultas periódicas
Listas de materiais (kusovník, kusovníkové vazby) com datas de validadeEstrutura do produto, subprodutos, materiais por produtoHELIOS → SkyPlannerCarga 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çõesEtapas do processo com durações e tempos de preparação e desmontagemHELIOS → SkyPlannerCarga inicial e, depois, a cada alteração
Postos de trabalho (pracoviště), máquinas (stroje), postos de trabalho alternativosCentros de trabalho, grupos de centros de trabalho, centros de trabalho alternativosHELIOS → SkyPlannerCarga inicial e, depois, raramente
Profissões (výrobní profese), recursos humanos (výrobní personální zdroje)Pessoal e número de operadores por tarefaHELIOS → SkyPlannerCarregamento inicial, depois a cada alteração
Calendários de planeamento (plánovací kalendáře)Turnos e dias não úteisHELIOS → SkyPlannerDiariamente, ou turnos próprios no SkyPlanner
Ordens de fabrico (výrobní příkazy), peças e operações das ordens, materiais para produçãoOrdens e tarefas com datas-limite e necessidades de materiaisHELIOS → SkyPlannerConsultas de poucos em poucos minutos
Existências (stav skladu)Saldos de existênciasHELIOS → SkyPlannerConsultas de hora a hora ou ao executar a programação
Encomendas de compra emitidas (vydané objednávky) com datas de entregaEncomendas de compra, materiais a receber por data de entregaHELIOS → SkyPlannerConsultas 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 tarefaSkyPlanner → HELIOSA 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 operadoresSkyPlanner → HELIOSPor confirmação ou por turno, se optar por esta funcionalidade
Não existe no HELIOSMatriz de tempos de preparação, ferramentas como recursos de capacidade limitada, tarefas com vários operadoresGerido no SkyPlannerConfigurado 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:

DadosSistema responsável
Artigos, listas de materiais, gamas operatórias, quantidades, estado das ordensHELIOS
Sequência das operações, horas de início e fim, atribuição de máquinasSkyPlanner
Matriz de tempos de preparação, necessidades de ferramentas e operadores, recursos alternativosSkyPlanner
Turnos e dias não úteisUm único sistema, escolhido na definição do âmbito
Registos de operações, saídas e entradas de materiaisHELIOS, 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.

  1. 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.
  2. 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.
  3. Carregamento inicial. Peças fabricadas, listas de materiais, gamas operatórias, postos de trabalho, máquinas, profissões e calendários.
  4. Sincronização de ordens de fabrico e encomendas de compra. Consultas periódicas com filtros, paginação e novas tentativas.
  5. 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.
  6. 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.
  7. Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare as datas e corrija os dados mestre.
  8. 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

  1. 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.
  2. 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.
  3. 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

Kalle Kalliomäki, especialista em cadeia de abastecimento na UTU, na área de produção de quadros elétricos em Ulvila

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.

Ler o testemunho da UTU

Operadores com vestuário de sala limpa numa linha de enchimento de frascos da fábrica farmacêutica da Laboratory & Allied, em Nairobi

+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.

Ler o testemunho da Laboratory & Allied

Hannu Ryynänen, diretor executivo da Mamec, no pavilhão de produção da empresa em Lohja

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.

Ler o testemunho da Mamec

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.

Ler o testemunho da Opes Corporation

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.