Integrações / ERP / Divalto infinity
Guia de integração do Divalto para planejamento da produção com SkyPlanner APS
Este guia de integração do Divalto mostra a parceiros e equipes de TI como conectar o Divalto infinity ao SkyPlanner APS. A integração entre SkyPlanner e Divalto é bidirecional e usa os próprios serviços REST do Divalto:
- O SkyPlanner recebe OF e séquences OF, gammes, nomenclatures, articles, centres de charge, postes de travail, ressources, opérateurs, outillages, estoque e pedidos a fornecedores.
- As datas planejadas de início e término são enviadas de volta para cada OF e séquence, com um novo centre ou poste quando o trabalho é transferido para um recurso alternativo.
- Se você optar, os tempos dos operadores e os ciclos concluídos também podem ser enviados de volta.
Interfaces de integração do Divalto
O Divalto infinity oferece três recursos em sua plataforma de API para integrar um sistema externo de programação da produção:
- RecordSql (REST nativo). Lê tabelas do Divalto por meio de arquivos de consulta declarados (DHOQ). É o caminho de leitura para OF, séquences, gammes, articles, postes e estoque. Uma nova declaração de consulta pode levar até dez minutos para entrar em vigor (configurações do RecordSql no Divalto).
- WEBSERVICE_INFINITY (REST). São os serviços web de negócio do Divalto. Cada chamada tem um corpo JSON com a ação WEB_SERVICE_INFINITY, o token de acesso e uma string de parâmetros que indica 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 arquivo ao scrutateur de produção), integration_dt (criação de dados técnicos: componentes, séquences, ressources, outillages), consultas de estoque e criação de articles (ações de produção).
- O scrutateur de produção. É um monitor de arquivos do módulo de produção do Divalto que importa arquivos XML. A ação create_dataxml entrega a ele um arquivo em base64. Os tipos de importação incluem GG_DATES_ORDO para datas planejadas, GG_TEMPS_IMPORT para tempos, GG_FIN_DE_CYCLE para ciclos concluídos, CO_MES_IMPORT para dados do MES e GG_COMPOSANT_OM para consumo de componentes (create_dataxml).
O serviço SOAP do Divalto não tem mais suporte na plataforma. Por isso, desenvolva a integração apenas com REST.
Autenticação
- No Divalto. A integração envia usuário e senha por POST ao endpoint Authent/Auth do gateway de API do Divalto, usando uma conta criada no DLMT. Em resposta, recebe um token de acesso que, segundo o Divalto, é válido por quarenta e cinco minutos. Por isso, o conector o renova em intervalos programados. O token é enviado no corpo JSON de cada chamada de negócio, e não em um cabeçalho HTTP (autenticação do Divalto).
- 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 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 retornar dados (WebHooks do Divalto). O Divalto não envia eventos de saída.
Por isso, a integração consulta o Divalto periodicamente. Consultas RecordSql filtradas por OF abertas e alterações recentes identificam novos trabalhos. A frequência é definida por fábrica: de alguns minutos para OF a uma hora para estoque.
O SkyPlanner envia webhooks quando há alterações de estado ou na programação. Assim, o envio de dados de volta ao Divalto é acionado por eventos.
Mapeamento de dados
| Objeto do Divalto (interface) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Articles, características dos articles (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, depois a cada alteração |
| 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, depois a cada alteração |
| Ateliers, centres de charge, postes de travail | Centros de trabalho, grupos de centros de trabalho, eficiências | Divalto → SkyPlanner | Carga inicial, raramente depois |
| Opérateurs e habilitations | Pessoal e centros de trabalho permitidos | Divalto → SkyPlanner | Carga inicial, depois a cada alteração |
| 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 operações com prazos e necessidades de materiais | Divalto → SkyPlanner | Consultas a cada poucos minutos |
| Estoque por article e depósito | Saldos de estoque | Divalto → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| Pedidos a fornecedores com datas de entrega | Pedidos de compra, entradas de materiais por data de entrega | Divalto → SkyPlanner | Consultas a cada hora ou ao executar a programação |
| GG_DATES_ORDO: início e término da OF (BF.PLANDEBDH, BF.PLANFINDH), início e término da séquence (BH.PLANDEBDH, BH.PLANFINDH), CENTRE e POSTE | Início e término planejados por operação e etapa, centro de trabalho atribuído | SkyPlanner → Divalto | A cada alteração na programação, via webhook do SkyPlanner |
| GG_TEMPS_IMPORT: tempo por séquence | Apontamentos de tempo 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 disponível no Divalto | Matriz de tempos de preparação, ferramentas como recursos finitos, máquinas e pessoal alternativos | Mantidos no SkyPlanner | Configurados durante a implantação inicial |
Fluxos de integração
1. Carga inicial de dados mestres. Declare as consultas RecordSql e leia articles, nomenclatures, gammes, centres de charge, postes, opérateurs, outillages e calendários. Defina com cuidado o mapeamento dos centres no SkyPlanner: um centre de charge com quatro postes se torna um grupo de centros de trabalho com quatro centros de trabalho.
2. Sincronização de OF. Leia as OF abertas com suas séquences e componentes, além dos pedidos a fornecedores em aberto. O SkyPlanner considera o material pedido disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered. Leia a OF principal e suas sub-OF em conjunto, pois o Divalto recalcula as datas apenas da OF principal.
3. Envio da programação de volta ao Divalto. Quando o mecanismo de programação aloca ou move uma operação, um webhook do SkyPlanner aciona uma chamada create_dataxml. O arquivo é um documento GG_DATES_ORDO que contém, para cada OF, o dossier, o estabelecimento, o número da OF e as datas planejadas de início e término. Para cada séquence, contém o número, o início e o término planejados, além do centre e do poste se o trabalho tiver sido transferido para um recurso alternativo (formato GG_DATES_ORDO). O scrutateur do Divalto importa esses dados para o cabeçalho da OF e as linhas de séquence.
4. Confirmações no chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os apontamentos de tempo mantêm a programação atualizada. Você decide se os tempos serão enviados de volta ao Divalto. Se optar pelo envio, os tempos seguem em arquivos GG_TEMPS_IMPORT e os ciclos concluídos em arquivos GG_FIN_DE_CYCLE. Caso contrário, os tempos continuam sendo registrados no MES do Divalto como antes.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Articles, nomenclatures, gammes, quantidades e status das OF | Divalto |
| Ordem das séquences, horários de início e término, 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 de escopo |
| Tempos, consumo e conclusões | Divalto, com registro direto ou envio dos apontamentos de tempo do SkyPlanner |
Defina um único responsável por gravar as datas das OF. O SkyPlanner substitui o Opcenter APS e o recálculo manual na gravação das datas planejadas. Se o Opcenter APS estiver em uso, desative a importação dele para as OF programadas pelo SkyPlanner, pois ambos usam GG_DATES_ORDO.
Etapas típicas do projeto
A implementação normalmente é concluída nas semanas seguintes ao início da implantação. Antes disso, valide a programação no teste gratuito de 30 dias com postes, gammes e OF abertas exportados do Divalto em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras sobre qual sistema controla cada dado, as frequências de sincronização e se os apontamentos de tempo serão enviados de volta ao Divalto.
- Acesso ao Divalto. Crie a conta de integração no DLMT, declare as consultas RecordSql e ative o scrutateur de produção. Faça os primeiros testes em um ambiente de testes.
- Carga inicial. Articles, nomenclatures, gammes, centres, postes, opérateurs, outillages e calendários.
- Sincronização de OF 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 postes ou pessoal alternativos.
- Gravação da programação no Divalto. Envio de GG_DATES_ORDO por create_dataxml a partir dos webhooks do SkyPlanner, além dos apontamentos de tempo, 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 mestres.
- Entrada em produção. Ative a gravação dos dados no Divalto assim que os dados estiverem consistentes entre os sistemas.
O que considerar ao planejar uma integração com o Divalto
- Configurações do scrutateur. Os arquivos de create_dataxml só são recebidos quando o scrutateur de produção está ativo, com a caixa MES marcada e um caminho de “Interfaces” definido no dossier de Production.
- Renovação do token. O token de acesso do Divalto expira em pouco tempo (consulte Autenticação). Renove-o antes de cada lote de chamadas.
- Declaração de consultas. Consultas RecordSql novas ou alteradas levam alguns minutos para entrar em vigor. Declare-as antes da carga inicial.
- OF principal e sub-OF. O Divalto recalcula as datas apenas da OF principal. Programe as sub-OF como subprodutos, para que a ordem principal aguarde seus componentes.
- Características dos articles. O Divalto armazena as propriedades de programação de um article em dez campos de características. Esses campos correspondem bem às propriedades de produto do SkyPlanner usadas na matriz de tempos de preparação e na opção “Allow similarity”.
Quem configura e dá suporte à integração com o Divalto
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, cobrindo as consultas RecordSql e as ações de web service acordadas. Cada fábrica usa o Divalto de uma maneira, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro Divalto pode participar. Ele conhece seu dossier, suas surcharges e suas configurações, e pode configurar a conta DLMT, as consultas e o scrutateur em conjunto com a equipe do 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 do 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 o plano, de acordo com seu processo e suas necessidades. Consulte os preços, a programação com capacidade finita no Divalto, a página do Divalto e a central de integrações com ERP.
Avaliações 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 · Quadros 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, diretor de TI
Laboratory & Allied · Fabricação de produtos farmacêuticos
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, leva menos de 30 minutos.
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% durante todo o período de uso do SkyPlanner, desde 2021.
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 encomenda
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 significativamente.
Perguntas frequentes
O Divalto tem uma API para ordens de produção?
Sim. O RecordSql lê OF, séquences e outras tabelas via 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 oferece suporte a webhooks?
Os webhooks do Divalto apenas recebem chamadas e não retornam dados. A integração consulta o Divalto pelo RecordSql em intervalos definidos para cada fábrica, e os webhooks do próprio SkyPlanner enviam as alterações no planejamento da produção assim que elas ocorrem.
Como as datas planejadas são gravadas de volta no Divalto?
Por meio de um arquivo XML GG_DATES_ORDO enviado pela ação create_dataxml. Ele contém as datas planejadas de início e término de cada OF e de cada séquence, além de um centre ou poste substituto quando o trabalho é transferido. O scrutateur de produção do Divalto importa esse arquivo.
A integração precisa do Opcenter APS?
Não. O próprio SkyPlanner faz o planejamento da produção com capacidade finita e grava as datas planejadas. Se o Opcenter APS estiver em uso atualmente, o SkyPlanner passa a ser o único sistema responsável por gravar as datas das OF.
Um parceiro Divalto deve propor o Opcenter APS ou o SkyPlanner?
O SkyPlanner, quando o cliente quer um planejamento da produção com capacidade finita que entre em operação em semanas e se mantenha atualizado automaticamente. O Opcenter APS no Divalto é executado quando o planejador o inicia e troca arquivos por uma pasta do Windows (documentação do Divalto). O SkyPlanner se conecta pelos serviços REST do Divalto, 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 do Divalto em CSV ou Excel, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe comercial para a definição de escopo da integração.
