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

O MRPeasy é um produto único em nuvem, sem versões para instalação local. Por isso, todos os clientes usam a mesma API. Existem duas versões:

1. A REST API v1 (OpenAPI 1.0, servidor https://api.mrpeasy.com/rest/v1) é a API em produção. Ela abrange /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units e relatórios de produção, como /report/production/operations.
2. A REST API v2 (OpenAPI 2.0.0, servidor https://api.mrpeasy.com/rest/v2) está em fase inicial de desenvolvimento. Ela acrescenta /workstation-groups com work_hours e holidays, /workstations com productivity e idle, /inventory, /stock-movement e PATCH. As ordens de produção continuam na v1.

Preste atenção à nomenclatura. Na interface do MRPeasy, Workstation group corresponde a work-center-types na v1 (type_id). Já Workstation corresponde a work-centers (center_id). As operações do roteiro de produção apontam para um grupo por meio de type_id, e não para uma máquina.

A API está incluída no plano Unlimited do MRPeasy para contas pagas. O MRPeasy também informa: “Our Support Department cannot help you using the API.” (Nosso departamento de suporte não pode ajudar você a usar a API.) Por isso, a integração precisa de um responsável: o SkyPlanner, seu consultor de MRPeasy ou seu desenvolvedor. É exatamente esse trabalho que a equipe do SkyPlanner assume durante a implantação.

A página de preços do MRPeasy lista “API, webhooks (for paid accounts)” (API e webhooks para contas pagas), mas as especificações da v1 e da v2 não documentam eventos de webhook para ordens de produção. Por isso, a integração consulta o MRPeasy de forma incremental:

• Ordens de produção filtradas pelos status Not scheduled (15), Scheduled (20), In progress (30) e Paused (35).
• Pedidos de compra e estoques em intervalos definidos ou antes de cada execução da programação.
• Dados mestres quando há alterações ou todas as noites.

As consultas sequenciais com filtros ficam bem abaixo do limite de 100 requisições a cada 10 segundos. No sentido inverso, os webhooks do próprio SkyPlanner enviam as alterações na programação assim que elas ocorrem. Assim, a gravação de retorno é orientada a eventos.

1. Carga inicial dos dados mestres. Obtenha itens, unidades, BOMs e roteiros de produção pela v1, e grupos de centros de trabalho e centros de trabalho pela v1 ou v2. Obtenha os calendários em /workstation-groups da v2 (work_hours, holidays) ou configure os turnos diretamente no SkyPlanner. Mapeie cada grupo Active processing para um grupo de centros de trabalho do SkyPlanner, incluindo seus centros de trabalho como membros.

2. Sincronização de ordens e pedidos. Leia as ordens de produção em aberto com suas operações, além dos pedidos de compra em aberto e do estoque. O SkyPlanner considera o material comprado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered. A cada reprogramação, são verificados tanto o estoque quanto as compras a receber.

3. Gravação da programação de volta no MRPeasy. PUT /manufacturing-orders/{id} aceita code, quantity, due_date e assigned_id, além de campos personalizados no formato custom_<id>. Quando acordado, o SkyPlanner grava o término planejado em due_date. Também grava o início planejado, o término planejado e o andamento em campos personalizados do MRPeasy. Assim, as equipes de vendas e compras passam a visualizar a programação real no MRPeasy. A sequência detalhada das operações e o centro de trabalho de cada operação ficam no SkyPlanner, cuja tela orienta a execução das operações no chão de fábrica.

4. Ordens criadas fora do MRPeasy. Se houver criação de ordens pela API, POST /manufacturing-orders aceita no_scheduling e no_bookings. Use esses parâmetros para que o MRPeasy não reserve centros de trabalho que o SkyPlanner já programa.

5. Apontamentos no chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations, Production Timer ou Quick Log Mode, e os registros de tempo mantêm a programação atualizada. Escolha um único canal de apontamento. Usar o Internet-kiosk do MRPeasy e o SkyPlanner em paralelo para as mesmas operações cria duas versões da verdade.

6. Responsabilidades e regras para conflitos. Documente essas definições antes da entrada em produção:

Fluxo de engenharia sob encomenda. Em um projeto já entregue com MRPeasy, cada projeto de cliente dá origem a um produto principal e a um a três produtos semiacabados. Cada um tem sua própria BOM e seu próprio roteiro de produção no MRPeasy, e a ordem de produção existe nos dois sistemas. Mantenha um identificador compartilhado estável em cada ordem para que as atualizações nunca criem duplicatas.

• Os campos de tempo variam conforme a interface. Os campos Setup time, Cycle time e Capacity da interface correspondem a fixed_time, variable_time e variable_quantity na API. Capacity acima de 1 indica processamento em lote, como em um forno. Faça o mapeamento como uma operação em lote, não como um ciclo mais longo.
• Grupos de processamento passivo. Os grupos de secagem e resfriamento funcionam 24/7 sem limites de capacidade. Mapeie-os como tempos de espera, não como centros de trabalho com capacidade limitada.
• A v1 não inclui calendários. work-centers retorna apenas center_id, type_id, code e title. Use a v2 ou mantenha os turnos no SkyPlanner.
• Tempo de inatividade. O tempo de inatividade do centro de trabalho registra manutenções e paradas. Sincronize esses dados; caso contrário, o SkyPlanner programará operações em uma máquina parada.
• Os roteiros de produção apontam para grupos. O MRPeasy escolhe a máquina com a melhor disponibilidade. No SkyPlanner, os centros de trabalho do grupo se tornam alternativas reais entre as quais o mecanismo de programação pode escolher.