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

A QAD oferece três opções para integrar um sistema externo de programação da produção:

1. QAD QXtend Inbound (QXI). A QAD o descreve como “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (um framework XML baseado 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 solicitação é um QDoc que executa um programa QAD com as mesmas validações da tela correspondente e retorna um QDoc de resposta. Entre os QDocs disponibilizados estão maintainItemMaster, maintainRouting e maintainPurchaseOrder. Para programas sem um QDoc disponível, a ferramenta QGen da 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 é usado para mapear programas personalizados ou programas do QAD Enterprise Applications que não têm esquemas QDoc e arquivos de eventos disponibilizados). A própria QAD usa essa opção: “QAD Production Scheduler uses QAD QXtend to update work orders.” (O QAD Production Scheduler usa o QAD QXtend para atualizar ordens de produção). (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 usuário dos produtos QAD na 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,” (REST APIs de consulta estão disponíveis para documentos de negócio), com filtros, ordenação, paginação e dados parciais. A documentação está no Swagger da sua instância (notas de versão).

O QXtend faz as gravações. O QXO e as REST APIs de consulta fazem as leituras.

O QXtend Outbound é o mecanismo da QAD para capturar alterações de dados. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Quando há uma alteração nos dados monitorados no QAD Enterprise Applications, as notificações são gravadas no banco de dados qxevents). Em seguida, o QXO gera os QDocs e os entrega “to a directory location where the subscriber polls for and picks up new QDocs,” (em um diretório que o assinante consulta periodicamente para buscar novos QDocs) ou a um serviço web que recebe solicitações em uma URL.

O SkyPlanner se registra como assinante por meio de um serviço web no qual o QXO publica os dados e consulta periodicamente as REST APIs para obter o que o QXO não cobre. 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 às tabelas de ordens de produção (wo_mstr, wr_route) ou consulta as ordens pelas REST APIs a cada poucos minutos.

O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, o envio de dados de volta ao QAD é orientado a eventos.

1. Carga inicial de dados mestres. Leia itens, estruturas de produto, roteiros de produção, centros de trabalho e calendários pelo QXO ou pelas REST APIs de consulta. Defina com cuidado o mapeamento dos centros de trabalho: um centro com quatro máquinas se torna um grupo de centros de trabalho ou quatro centros de trabalho. As linhas de produção repetitiva do Production Line Maintenance também podem se tornar centros de trabalho.

2. Sincronização das ordens de produção. Leia as ordens de produção planejadas firmes e liberadas, com seus roteiros e componentes, além dos pedidos de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered.

Programe ordens de produção, não ordens planejadas pelo MRP. Primeiro, as ordens planejadas devem se tornar ordens de produção planejadas firmes ou liberadas no QAD.

3. Envio da programação de volta ao QAD. Quando o motor de programação aloca ou move uma ordem, um webhook do SkyPlanner aciona um QDoc do QXtend Inbound no Work Order Maintenance (16.1). A data de liberação é definida pela primeira operação programada, e a data de entrega, pela última. O QXtend executa o programa com as próprias validações do QAD e retorna um QDoc de resposta, que é verificado pela integração.

A sequência de operações de cada máquina permanece no SkyPlanner e chega aos operadores pelo Mobile Confirmations. Assim, a integração não interfere no bloqueio dos roteiros de ordens liberadas no QAD.

4. Apontamentos do chão de fábrica. Os operadores registram o trabalho pelo SkyPlanner Mobile Confirmations ou pelo Production Timer, e os apontamentos de tempo mantêm a programação atualizada. Você escolhe se os tempos reais serão enviados de volta ao QAD. Se sim, os tempos de preparação e execução são enviados por operação ao Labor Feedback by Work Order, e as quantidades concluídas, ao Work Order Receipt. Se não, a mão de obra continua sendo registrada no QAD como antes.

5. Responsabilidade pelos dados e regras de conflito. Documente essas definições antes da entrada em produção:

Escolha um único sistema para gravar as datas das ordens de produção. O SkyPlanner não precisa de nenhum módulo de programação da produção do QAD. Por isso, ele substitui as ferramentas de programação do QAD ou outros sistemas de programação como responsável por gravar as datas das ordens que programa.

• Novas execuções do CRP. O CRP reprograma todas as operações em aberto das ordens de produção selecionadas. O QAD só mantém as datas manuais quando “you also adjusted the work order release and due date to match,” (você também ajustou as datas de liberação e entrega da ordem de produção para que coincidam). São justamente essas datas que o SkyPlanner grava. Execute o CRP após a gravação no ERP ou exclua as ordens programadas pelo SkyPlanner.
• Roteiros liberados não podem ser alterados. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Quando o status da ordem de produção é Exploded, Allocated ou Released, não é mais possível alterar o roteiro.) Leia o roteiro de produção no momento da liberação e altere roteiros apenas em ordens planejadas ou planejadas firmes.
• Unidades de tempo do roteiro de produção. Os tempos de preparação e execução compõem a carga, enquanto “queue, wait, and move times are excluded from load calculations.” (os tempos de fila, espera e movimentação são excluídos dos cálculos de carga). No SkyPlanner, modele fila, espera e movimentação como etapas que consideram apenas o 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 ordens alteradas, em lotes, e use QDocs nativos quando disponíveis.
• Domínios e unidades. As instalações QAD com múltiplos domínios mantêm centros de trabalho e ordens de produção por domínio e unidade. Mapeie cada unidade incluída no escopo para um grupo próprio de centros de trabalho.
• Produção repetitiva e discreta na mesma operação. As linhas do Advanced Repetitive usam programas de produção repetitiva, não ordens de produção. Na definição de escopo, determine quais linhas o SkyPlanner vai programar.