Guia de integração do QAD Adaptive ERP para programação da produção com SkyPlanner APS

O QAD oferece três vias para integrar um sistema externo de programação da produção:

1. QAD QXtend Inbound (QXI). O QAD descreve-o como “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (uma estrutura XML baseada em serviços Web e compatível com SOAP, que permite acesso completo às funcionalidades de negócio do QAD Enterprise Applications, independentemente da plataforma). Cada pedido é um QDoc que executa um programa QAD com as mesmas validações do respetivo ecrã e devolve um QDoc de resposta. Os QDocs disponibilizados incluem maintainItemMaster, maintainRouting e maintainPurchaseOrder. Para programas sem um QDoc disponibilizado, a ferramenta QGen do QAD mapeia o programa do menu: “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (O QGen permite mapear programas personalizados ou programas QAD Enterprise Applications sem esquemas QDoc e ficheiros de eventos disponibilizados). O próprio QAD utiliza esta via: “QAD Production Scheduler uses QAD QXtend to update work orders.” (O QAD Production Scheduler utiliza o QAD QXtend para atualizar ordens de fabrico). (Guia do QXtend)
2. QAD QXtend Outbound (QXO). O QXO “exports user-configurable business objects as XML QDocs out of QAD products.” (exporta objetos de negócio configuráveis pelo utilizador a partir dos produtos QAD, sob a forma de QDocs XML). Os objetos de negócio padrão incluem Item, Product Structure, Routing, Work Center, Department, Inventory Transaction e Inventory Status.
3. REST APIs para documentos de negócio. Desde o Adaptive ERP 2022.1, “Query REST APIs are now available for business documents,” (estão disponíveis REST APIs de consulta para documentos de negócio), com filtragem, ordenação, paginação e dados parciais. Estas APIs estão documentadas no Swagger da sua instância (notas de versão).

As operações de escrita passam pelo QXtend. As operações de leitura passam pelo QXO e pelas REST APIs de consulta.

O QXtend Outbound é o mecanismo do QAD para comunicar alterações de dados. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Quando os dados monitorizados no QAD Enterprise Applications são alterados, as notificações de alteração são gravadas na base de dados qxevents). O QXO gera então os QDocs e envia-os “to a directory location where the subscriber polls for and picks up new QDocs,” (para uma diretoria que o subscritor consulta periodicamente para recolher novos QDocs) ou para um serviço Web à escuta num URL.

O SkyPlanner subscreve as publicações do QXO como serviço Web e consulta periodicamente as REST APIs de consulta para obter o que o QXO não abrange. Work Order não é um dos objetos de negócio padrão do QXO. Por isso, a integração adiciona um objeto de negócio QXO sobre as tabelas de ordens de fabrico (wo_mstr, wr_route) ou consulta as ordens de fabrico através das REST APIs de consulta em intervalos de poucos minutos.

O SkyPlanner envia webhooks quando o estado ou a programação se alteram, pelo que a escrita de dados de volta no QAD é acionada por eventos.

1. Carga inicial dos dados mestre. Leia artigos, estruturas de produto, gamas operatórias, centros de trabalho e calendários através do QXO ou das REST APIs de consulta. Defina cuidadosamente o mapeamento dos centros de trabalho: um centro com quatro máquinas passa a um grupo de centros de trabalho ou a quatro centros de trabalho. As linhas de produção repetitiva de Production Line Maintenance também podem tornar-se centros de trabalho.

2. Sincronização das ordens de fabrico. Leia as ordens de fabrico com planeamento firme e as já lançadas, com as respetivas gamas operatórias e componentes, bem como as encomendas de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza as existências quando esta é marcada como Delivered.

Programe ordens de fabrico, não ordens planeadas pelo MRP. Primeiro, as ordens planeadas têm de passar a ordens de fabrico com planeamento firme ou lançadas no QAD.

3. Escrita da programação no QAD. Quando o motor posiciona ou desloca uma ordem, um webhook do SkyPlanner aciona um QDoc QXtend Inbound em Work Order Maintenance (16.1). A data de lançamento é definida com base na primeira operação programada e a data de conclusão com base na última. O QXtend executa o programa com as validações do próprio QAD e devolve um QDoc de resposta que a integração verifica.

A sequência das operações em cada máquina permanece no SkyPlanner e chega aos operadores através de Mobile Confirmations. Assim, a integração não interfere com o bloqueio das gamas operatórias que o QAD aplica às ordens lançadas.

4. Confirmações na produção. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempos mantêm a programação atualizada. Cabe-lhe decidir se os tempos reais são enviados de volta para o QAD. Se optar pelo envio, os tempos de preparação e de execução são enviados para Labor Feedback by Work Order por operação, e as quantidades concluídas para Work Order Receipt. Caso contrário, a mão de obra continua a ser registada no QAD como até aqui.

5. Regras de responsabilidade e de resolução de conflitos. Documente-as antes da entrada em produção:

Escolha um único sistema para escrever as datas das ordens de fabrico. O SkyPlanner não precisa de nenhum módulo de programação do QAD, pelo que substitui as ferramentas de programação ou outros sistemas como responsável pela escrita das datas das ordens que programa.

• Novas execuções do CRP. O CRP reprograma todas as operações em aberto das ordens de fabrico selecionadas. O QAD só mantém as datas manuais quando “you also adjusted the work order release and due date to match,” (também ajustou as datas de lançamento e de conclusão da ordem de fabrico para que coincidam), que é precisamente o que o SkyPlanner grava. Execute o CRP depois de gravar os dados no QAD ou exclua as ordens que o SkyPlanner programa.
• As gamas operatórias ficam fixas após o lançamento. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Assim que a ordem de fabrico passa ao estado Exploded, Allocated ou Released, deixa de ser possível alterar a gama operatória.) Leia a gama operatória no momento do lançamento e altere apenas as gamas de ordens planeadas ou planeadas firmes.
• Unidades de tempo das gamas operatórias. Os tempos de preparação e de execução contam para a carga, enquanto “queue, wait, and move times are excluded from load calculations.” (os tempos em fila, de espera e de movimentação são excluídos dos cálculos de carga). No SkyPlanner, modele a fila, a espera e a movimentação como etapas que apenas consomem tempo e verifique se o tempo de execução é por unidade ou por ordem.
• Capacidade de processamento do QXtend. A QAD alerta que “UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (o desempenho do adaptador UI API pode ser inaceitável ao processar grandes volumes de dados ou transações em tempo real). Envie apenas as ordens alteradas, em lotes, e utilize QDocs nativos quando existirem.
• Domínios e unidades. As instalações QAD com vários domínios mantêm os centros de trabalho e as ordens de fabrico por domínio e unidade. Associe cada unidade abrangida pelo projeto a um grupo próprio de centros de trabalho.
• Produção repetitiva e discreta na mesma instalação. As linhas Advanced Repetitive utilizam programas de produção repetitiva, não ordens de fabrico. Durante a definição do âmbito, decida quais as linhas que o SkyPlanner irá programar.