Integrações / ERP / Divalto infinity
Guia de integração do Divalto para programação da produção com SkyPlanner APS
Este guia de integração do Divalto mostra aos parceiros e às equipas de TI como ligar o Divalto infinity ao SkyPlanner APS. O SkyPlanner integra-se com o Divalto nos dois sentidos, através dos próprios serviços REST do Divalto:
- São importados OF e séquences OF, gammes, nomenclatures, articles, centres de charge, postes de travail, ressources, opérateurs, outillages, stocks e encomendas a fornecedores.
- As datas de início e fim planeadas são devolvidas a cada OF e séquence, juntamente com o novo centre ou poste quando o trabalho passa para um recurso alternativo.
- Se assim o desejar, também podem ser devolvidos os tempos dos operadores e os ciclos concluídos.
Interfaces de integração do Divalto
O Divalto infinity disponibiliza três componentes na sua plataforma de API para um sistema externo de programação da produção:
- RecordSql (REST nativo). Lê tabelas do Divalto através de ficheiros de consulta declarados (DHOQ). É a via de leitura de OF, séquences, gammes, articles, postes e stocks. Uma nova declaração de consulta pode demorar até dez minutos a produzir efeito (configurações do RecordSql do Divalto).
- WEBSERVICE_INFINITY (REST). Serviços web de negócio do Divalto. Cada chamada contém um corpo JSON com a ação WEB_SERVICE_INFINITY, o token de acesso e uma cadeia de parâmetros que identifica a ação de negócio, o dossier e os dados (formato da chamada). As ações de produção incluem create_dataxml (entrega de um ficheiro ao scrutateur de produção), integration_dt (criação de dados técnicos: componentes, séquences, ressources, outillages), consultas de stock e criação de artigos (ações de produção).
- O scrutateur de produção. É um serviço de monitorização de ficheiros na produção do Divalto que importa ficheiros XML. A ação create_dataxml entrega-lhe um ficheiro em base64. Os tipos de importação incluem GG_DATES_ORDO para datas planeadas, GG_TEMPS_IMPORT para tempos, GG_FIN_DE_CYCLE para ciclos concluídos, CO_MES_IMPORT para dados MES e GG_COMPOSANT_OM para consumo de componentes (create_dataxml).
A plataforma já não suporta o serviço SOAP do Divalto, pelo que a integração deve usar apenas REST.
Autenticação
- No Divalto. A integração envia, por POST, um nome de utilizador e uma palavra-passe para o endpoint Authent/Auth do gateway da API do Divalto, usando uma conta criada no DLMT. Recebe um token de acesso que, segundo o Divalto, é válido durante quarenta e cinco minutos. Por isso, o conector renova-o de forma temporizada. O token é enviado no corpo JSON de cada chamada de negócio, e não num cabeçalho HTTP (autenticação do Divalto).
- No SkyPlanner. A autenticação na REST API é feita com um token de API no cabeçalho Authorization-Token (SkyPlanner Settings > API). A API está documentada em Swagger/OpenAPI. O tutorial de integração explica passo a passo as primeiras chamadas.
Eventos e consultas periódicas
Os webhooks do Divalto são de entrada: um sistema externo chama um webhook do Divalto para iniciar um processo. Segundo o Divalto, um webhook não se destina a devolver dados (webhooks do Divalto). O Divalto não envia eventos para sistemas externos.
Por isso, os dados do Divalto são obtidos por consultas periódicas. As consultas RecordSql, filtradas por OF abertas e alterações recentes, recolhem o novo trabalho. A frequência é definida por fábrica: de poucos em poucos minutos para as OF e de hora a hora para os stocks.
O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que a atualização dos dados no Divalto é acionada por eventos.
Mapeamento de dados
| Objeto do Divalto (interface) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Articles, características dos artigos (RecordSql) | Produtos e materiais, propriedades dos produtos | Divalto → SkyPlanner | Carga inicial, seguida de consultas periódicas |
| Nomenclatures (componentes) | Estrutura do produto, subprodutos, materiais por produto | Divalto → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Gammes: séquences, opérations standard, tempos, ressources, outillages | Etapas do processo com durações, tempos de preparação e desmontagem, ferramentas | Divalto → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Ateliers, centres de charge, postes de travail | Centros de trabalho, grupos de centros de trabalho, eficiências | Divalto → SkyPlanner | Carga inicial; raramente após essa carga |
| Opérateurs e habilitations | Pessoal e centros de trabalho autorizados | Divalto → SkyPlanner | Carga inicial e, depois, sempre que houver alterações |
| Calendários dos postes | Turnos e dias não úteis | Divalto → SkyPlanner | Diariamente, ou gestão dos turnos no SkyPlanner |
| OF (BF) e séquences OF (BH) com prazos e componentes | Ordens e tarefas com prazos e necessidades de materiais | Divalto → SkyPlanner | Consultas de poucos em poucos minutos |
| Stock por artigo e armazém | Saldos de stock | Divalto → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Encomendas a fornecedores com datas de entrega | Encomendas de compra, materiais a receber por data de entrega | Divalto → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| GG_DATES_ORDO: início e fim da OF (BF.PLANDEBDH, BF.PLANFINDH), início e fim da séquence (BH.PLANDEBDH, BH.PLANFINDH), CENTRE e POSTE | Início e fim planeados por tarefa e etapa, centro de trabalho atribuído | SkyPlanner → Divalto | Quando a programação muda, através de um webhook do SkyPlanner |
| GG_TEMPS_IMPORT: tempo por séquence | Registos de tempos e confirmações dos operadores | SkyPlanner → Divalto | Por confirmação ou por turno, se essa opção for escolhida |
| GG_FIN_DE_CYCLE: ciclos concluídos | Quantidades concluídas | SkyPlanner → Divalto | Por confirmação, se essa opção for escolhida |
| Não existe no Divalto | Matriz de tempos de preparação, ferramentas como recursos de capacidade limitada, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante o arranque |
Modelos de integração
1. Carga inicial de dados mestre. Declare as consultas RecordSql e leia articles, nomenclatures, gammes, centres de charge, postes, opérateurs, outillages e calendários. Defina criteriosamente a correspondência entre os centres e os recursos do SkyPlanner: um centre de charge com quatro postes passa a ser um grupo de centros de trabalho com quatro centros de trabalho.
2. Sincronização de OF. Leia as OF abertas com as respetivas séquences e componentes, bem como as encomendas a fornecedores em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza o stock quando esta é marcada como Delivered. Leia a OF principal e as suas sub-OF em conjunto, uma vez que o Divalto recalcula as datas apenas da OF principal.
3. Escrita da programação no Divalto. Quando o motor programa ou desloca uma tarefa, um webhook do SkyPlanner aciona uma chamada create_dataxml. O ficheiro é um documento GG_DATES_ORDO que contém, por OF, o dossier, o estabelecimento, o número da OF e as datas de início e fim planeadas. Para cada séquence, inclui o respetivo número, o início e o fim planeados, bem como o centre e o poste se o trabalho tiver passado para um recurso alternativo (formato GG_DATES_ORDO). O scrutateur do Divalto importa estes dados para o cabeçalho da OF e as linhas das séquences.
4. Confirmações na fábrica. Os operadores registam o trabalho com o SkyPlanner Mobile Confirmations ou o Production Timer, e os registos de tempos mantêm a programação atualizada. Cabe-lhe decidir se os tempos são enviados de volta para o Divalto. Se optar por fazê-lo, os tempos são enviados em ficheiros GG_TEMPS_IMPORT e os ciclos concluídos em ficheiros GG_FIN_DE_CYCLE. Caso contrário, os tempos continuam a ser introduzidos no MES do Divalto, como antes.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Articles, nomenclatures, gammes, quantidades e estado das OF | Divalto |
| Ordem das séquences, horas de início e fim, atribuição de poste | 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 do âmbito |
| Tempos, consumos e registos de conclusão | Divalto, com introdução direta ou envio a partir dos registos de tempos do SkyPlanner |
Escolha um único sistema responsável por atualizar as datas das OF. As datas planeadas passam a ser definidas pelo SkyPlanner, em vez de pelo Opcenter APS ou por recálculo manual. Se utilizar o Opcenter APS, desative a respetiva importação para as OF programadas pelo SkyPlanner, uma vez que ambos usam GG_DATES_ORDO.
Etapas habituais do projeto
A implementação fica normalmente concluída num prazo de semanas após o início do acompanhamento de arranque. Antes disso, valide a programação durante o período de avaliação gratuita de 30 dias, com postes, gammes e OF abertas exportados do Divalto 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 tempos serão enviados de volta para o Divalto.
- Acesso ao Divalto. Crie a conta de integração no DLMT, declare as consultas RecordSql e ative o scrutateur de produção. Comece por testar num ambiente de testes.
- Carga inicial. Articles, nomenclatures, gammes, centres, postes, opérateurs, outillages e calendários.
- Sincronização de OF e encomendas a fornecedores. Consulta periódica 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, número de operadores por tarefa e postes ou pessoal alternativos.
- Escrita da programação no Divalto. GG_DATES_ORDO através de create_dataxml, a partir dos webhooks do SkyPlanner, e envio dos registos de tempos, se essa opção for escolhida.
- 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 escrita no Divalto quando os dados coincidirem.
O que prever numa integração com o Divalto
- Definições do scrutateur. Os ficheiros create_dataxml só são recebidos quando o scrutateur de produção está ativo, com a caixa MES selecionada e um caminho “Interfaces” definido no dossier Production.
- Renovação do token. O token de acesso do Divalto expira ao fim de pouco tempo (ver Autenticação). Renove-o antes de cada lote de chamadas.
- Declaração de consultas. As consultas RecordSql novas ou alteradas demoram alguns minutos a ficar ativas. Declare-as antes da carga inicial.
- OF principal e sub-OF. O Divalto recalcula apenas as datas da OF principal. Programe as sub-OF como subprodutos, para que a ordem principal aguarde pelos seus componentes.
- Características dos artigos. O Divalto guarda as propriedades de programação de um artigo em dez campos de características. Estes correspondem bem às propriedades dos produtos no SkyPlanner usadas na matriz de tempos de preparação e em “Allow similarity”.
Quem configura e presta suporte à integração com o Divalto
- A equipa do SkyPlanner configura a integração durante a implementação e presta suporte após a entrada em produção, abrangendo as consultas RecordSql e as ações dos serviços web acordadas. Cada fábrica utiliza o Divalto de forma diferente, e é aqui que esse conhecimento é aplicado.
- O seu parceiro Divalto pode participar. O parceiro conhece o seu dossier, as suas surcharges e as suas definições, e pode configurar a conta DLMT, as consultas e o scrutateur em conjunto com a equipa do SkyPlanner.
- Os seus programadores podem desenvolver novas funcionalidades sobre a integração através da REST API do SkyPlanner, com um token de API. Basta um token de API para começar, e a equipa do SkyPlanner ajuda sempre que 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, em função do seu processo e das suas necessidades, juntamente com o seu plano. Consulte os preços, a página de programação da produção com o Divalto, respeitando a capacidade real das máquinas e das equipas, a página do Divalto e a área de integrações ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos de planear a produção em folhas de cálculo Excel para otimizar a produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de comutação
O planeamento da produção permite poupar 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 de TI
Laboratory & Allied · Produção farmacêutica
A eficiência na produção aumentou 90%, e a criação de um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
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% durante todo o período de utilização do SkyPlanner, desde 2021.
Menosparagens por falta de materiais
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, sobretudo para definir datas de entrega.”
Tommi Männistö, responsável pelo planeamento da produção
Eskomatic · Maquinação por subcontratação
A programação automática das cargas de trabalho permite definir datas de entrega mais rigorosas, e as paragens de produção por falta de materiais diminuíram acentuadamente.
Perguntas frequentes
O Divalto tem uma API para ordens de fabrico?
Sim. O RecordSql lê OF, séquences e outras tabelas através de REST, e o serviço WEBSERVICE_INFINITY executa ações de negócio como create_dataxml e integration_dt para a produção.
O Divalto suporta webhooks?
Os webhooks do Divalto apenas recebem pedidos e não devolvem dados. A integração consulta periodicamente o Divalto através de RecordSql, com uma frequência definida para cada fábrica, e os webhooks do próprio SkyPlanner enviam as alterações à programação assim que ocorrem.
Como são gravadas as datas planeadas no Divalto?
Através de um ficheiro XML GG_DATES_ORDO enviado com a ação create_dataxml. O ficheiro contém as datas de início e de fim planeadas para cada OF e cada séquence, bem como um centre ou poste de substituição quando o trabalho é transferido. O scrutateur de produção do Divalto importa-o.
A integração precisa do Opcenter APS?
Não. O SkyPlanner faz a programação da produção respeitando a capacidade real das máquinas e das equipas, e grava diretamente as datas planeadas. Se o Opcenter APS estiver atualmente em uso, o SkyPlanner passa a ser o único sistema a gravar as datas das OF.
Um parceiro Divalto deve propor o Opcenter APS ou o SkyPlanner?
O SkyPlanner, quando o cliente pretende ter, em poucas semanas, uma programação que respeite a capacidade real e se mantenha atualizada automaticamente. O Opcenter APS no Divalto é executado quando o responsável pelo planeamento o inicia e troca ficheiros através de uma pasta Windows (documentação do Divalto). O SkyPlanner liga-se através dos serviços REST do Divalto, 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 teste gratuito de 30 dias permite utilizar até 20 centros de trabalho, com importações de ficheiros CSV ou Excel do Divalto, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
