Guia de integração do Epicor Kinetic para programação da produção com SkyPlanner APS

A Epicor afirma: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Todos os serviços do Kinetic, incluindo objetos de negócio, processos, relatórios, BAQs e Epicor Functions, são acessíveis por endpoints REST.) Uma integração para programação da produção se baseia em quatro tecnologias da Epicor:

1. Kinetic REST API v2 (OData v4). Os objetos de negócio são expostos como serviços com nomes no formato Erp.BO.<Name>Svc. O caminho usual é /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. A REST v1 ainda existe, mas é legada; por isso, desenvolva a integração na v2. Confirme os conjuntos de entidades e os métodos da sua versão no REST Help, em /api/help/v2/.
2. Business Activity Queries (BAQ) via REST. Uma BAQ é exposta em /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Essa é a forma prática de extrair dados para o planejamento, combinando JobHead, JobOper, JobMtl, PartWhse e PORel em uma única chamada (exemplo da comunidade).
3. Epicor Functions (EFx). Funções executadas no servidor, que podem ser chamadas em /api/v2/efx/{Company}/{Library}/{Function}. A Epicor afirma que elas “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (podem ser acionadas a partir de vários pontos de entrada, incluindo BPMs, serviços REST, agendamentos e eventos da aplicação).
4. Diretivas BPM. As Method Directives e Data Directives são acionadas quando uma ordem de produção ou operação muda e podem chamar uma função que envia os dados para fora do Kinetic.

Para arquivos, o DMT cuida das importações, e as exportações de BAQs geram os dados de saída. A Epicor também oferece o Epicor Automation Studio, que descreve como “a low-code app for integration-led automations” (um aplicativo de baixo código para automações baseadas em integração). Evite o acesso direto ao banco de dados: REST, BAQs e funções operam da mesma forma no ambiente local e no Kinetic Cloud.

A Epicor não documenta uma API genérica de webhooks de saída. Por isso, as alterações do Kinetic chegam ao SkyPlanner de uma destas duas formas:

• Por eventos. Uma BPM Data Directive em JobHead ou JobOper chama uma Epicor Function, que envia a ordem alterada para a API REST do SkyPlanner.
• Consultas periódicas. Uma BAQ filtrada pela data de alteração é executada a cada poucos minutos ou a cada hora. Essa abordagem é mais simples de manter e de recuperar em caso de falha.

No sentido inverso, o SkyPlanner envia alterações de estado e de programação por seus webhooks. Seu middleware ou um endpoint EFx recebe essas alterações e as grava no Kinetic.

1. Carga inicial de dados mestres. Leia itens, grupos de recursos, recursos, capacidades, calendários e funcionários. Crie os centros de trabalho do SkyPlanner a partir dos recursos do Kinetic e os grupos de centros de trabalho a partir dos grupos de recursos. Para grandes volumes, pagine as leituras com $top e $skip ou extraia os dados em lote por uma BAQ.

2. Sincronização de ordens. Envie as ordens liberadas e firmes com suas operações e materiais. Extraia a árvore da ordem com GetDatasetForTree ou uma BAQ, e não entidade por entidade. Mantenha no Kinetic as ordens não firmes do MRP até que sejam firmadas. Junto com a leitura do estoque, sincronize as liberações de pedidos de compra em aberto e suas datas de entrega. O SkyPlanner considera o material comprado disponível na data de entrega e atualiza o estoque quando o pedido de compra é marcado como Delivered. Assim, a programação verifica tanto o estoque quanto as compras a receber.

3. Gravação da programação no Kinetic. O webhook do SkyPlanner envia o início, o término e o centro de trabalho planejados para cada operação a um endpoint EFx (/api/v2/efx/{Company}/{Library}/{Function}). A função grava os dados pelo motor de programação do Kinetic, o mesmo objeto de negócio usado na programação do Job Entry e nos quadros de programação (exemplo da comunidade):

1. ScheduleEngine.GetNewParamsForJob monta o conjunto de dados da ordem para o motor de programação.
2. A função define o número da ordem, as sequências de montagem e de operação e a data e a hora de início planejadas. Em seguida, chama ScheduleEngine.MoveJobItem.
3. Quando o SkyPlanner aloca a operação em outro recurso do grupo, ScheduleEngine.ChangeResource a transfere para esse recurso. Usado sozinho, MoveJobItem mantém o recurso padrão do grupo.
4. A função ativa o bloqueio da programação da ordem (JobHead.SchedLocked, a opção Lock no Job Entry), para que o Global Scheduling mantenha as datas do SkyPlanner.

Encapsular essas chamadas em uma única Epicor Function mantém a gravação atômica por ordem e permite adicionar suas próprias validações. Se a unidade preferir não usar uma função personalizada, a mesma sequência pode ser executada por chamadas REST diretas a Erp.BO.ScheduleEngineSvc. Nunca grave diretamente em ResourceTimeUsed nem nos campos de data de JobOper: isso contorna o motor e deixa as alocações dos quadros fora de sincronia.

4. Apontamentos de chão de fábrica. Os operadores registram o trabalho no SkyPlanner com Mobile Confirmations, Production Timer ou Quick Log Mode. Cada apontamento de tempo encerrado se torna um apontamento de mão de obra no Kinetic por meio de Erp.BO.LaborSvc: StartActivity e EndActivityByEmp para atividades em tempo real, ou Labors com Update para registros feitos após a execução. Se a sua unidade exigir aprovação, inclua submitForApproval no fluxo e no escopo de acesso.

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

As ordens programadas pelo SkyPlanner ficam com a programação bloqueada, para que o Global Scheduling não altere suas datas. Mantenha a programação do Kinetic para os recursos que não são planejados pelo SkyPlanner.

A implementação normalmente é concluída em poucas semanas após o início da implantação. Um projeto com Kinetic abrange:

1. Um teste de 30 dias com dados de ordens de produção, operações e recursos exportados em CSV ou Excel, antes de qualquer desenvolvimento.
2. Chave de API, escopo de acesso, um usuário exclusivo para a integração e as BAQs que ela consulta.
3. Mapeamento dos dados mestres: capacidades, grupos de recursos, recursos, calendários e funcionários para os postos de trabalho, grupos, turnos e pessoal do SkyPlanner.
4. Carga inicial de itens, métodos de fabricação (BOM e operações) e recursos.
5. Sincronização de ordens de produção e de pedidos de compra (datas de entrega de PORel), além do estoque de PartWhse.
6. Gravação das datas planejadas das operações no Kinetic por meio de ScheduleEngineSvc (MoveJobItem, ChangeResource) em uma Epicor Function, com o bloqueio da ordem ativado.
7. Envio dos apontamentos de chão de fábrica como apontamentos de mão de obra por meio de LaborSvc.
8. Testes em paralelo com a programação atual do Kinetic, seguidos da entrada em produção.

Cada fábrica usa o Kinetic de um jeito. Roteiros de produção baseados em capacidades, calendários dos grupos de recursos, estrutura das BAQs, diretivas BPM e métodos de gravação de retorno específicos de cada versão variam entre unidades. Configurar tudo isso corretamente faz a diferença entre uma programação em que os planejadores confiam e outra que precisam refazer.

1. A equipe do SkyPlanner configura a integração durante a implantação e oferece suporte após a entrada em produção. A equipe mapeia seus recursos, ordens de produção e liberações de pedidos de compra e configura a leitura das BAQs, os gatilhos BPM e a função de gravação de retorno. Ela conecta a API REST e os webhooks do SkyPlanner ao Kinetic REST v2. O suporte continua quando suas BAQs, seus BPMs ou a versão do Kinetic mudam.
2. Seu parceiro Epicor. Parceiros que já desenvolvem BAQs, BPMs e Epicor Functions podem trabalhar com a mesma API REST documentada do SkyPlanner, que lê e grava ordens, produtos, materiais, etapas de processo e registros de tempo.
3. Seus próprios desenvolvedores. Equipes internas com experiência em Kinetic REST podem desenvolver a integração diretamente ou usar o Automation Studio, se ele fizer parte do seu ambiente. Uma chave de API do SkyPlanner basta para começar (tutorial de integração), e a equipe do SkyPlanner ajuda quando necessário. A documentação do produto é pública e está disponível na documentação do SkyPlanner.

O mesmo padrão de API e webhooks já opera em produção com outros ERPs, como na UTU. Na Laboratory & Allied, a equipe interna de TI desenvolveu a maior parte da integração com o SAP Business One por conta própria, com ajuda do SkyPlanner.

Todos os caminhos começam da mesma forma: faça primeiro o teste grátis de 30 dias com importações CSV, valide a programação e só então desenvolva a integração. Os preços começam a partir de 199 € por mês, com 5 postos de trabalho, cobrança mensal e cancelamento a qualquer momento. O orçamento da integração é apresentado antecipadamente, junto com seu plano, de acordo com seu processo e suas necessidades. Assim, você conhece o custo total antes de começar.