Guida all’integrazione di MRPeasy per la schedulazione della produzione con SkyPlanner APS

MRPeasy è un unico prodotto cloud, senza versioni on-premises: tutti i clienti utilizzano quindi la stessa API. Ne esistono due versioni:

1. REST API v1 (OpenAPI 1.0, server https://api.mrpeasy.com/rest/v1) è l’API in produzione. Comprende /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units e report di produzione come /report/production/operations.
2. REST API v2 (OpenAPI 2.0.0, server https://api.mrpeasy.com/rest/v2) è nelle prime fasi di sviluppo. Aggiunge /workstation-groups con work_hours e holidays, /workstations con productivity e idle, /inventory, /stock-movement e PATCH. Gli ordini di produzione restano sulla v1.

Attenzione ai nomi. Nell’interfaccia di MRPeasy, un Workstation group corrisponde a work-center-types nella v1 (type_id). Un Workstation corrisponde a work-centers (center_id). Le operazioni del ciclo di lavorazione fanno riferimento a un gruppo tramite type_id, non a una macchina.

L’API è inclusa nel piano Unlimited di MRPeasy, per gli account a pagamento. MRPeasy dichiara inoltre: “Our Support Department cannot help you using the API.” (Il nostro reparto di assistenza non può aiutarti a utilizzare l’API.) L’integrazione deve quindi avere un responsabile: SkyPlanner, il tuo consulente MRPeasy o il tuo sviluppatore. È proprio questo il lavoro di cui si occupa il team SkyPlanner durante l’avviamento.

La pagina dei prezzi di MRPeasy elenca “API, webhooks (for paid accounts)” (API e webhook per gli account a pagamento), ma le specifiche v1 e v2 non documentano eventi webhook per gli ordini di produzione. L’integrazione interroga quindi MRPeasy in modo incrementale:

• Ordini di produzione filtrati per stato: Not scheduled (15), Scheduled (20), In progress (30) e Paused (35).
• Ordini di acquisto e giacenze a intervalli prestabiliti o prima di ogni esecuzione della schedulazione.
• Anagrafiche a ogni modifica o ogni notte.

Il polling sequenziale con filtri resta ampiamente entro il limite di 100 richieste ogni 10 secondi. Nella direzione opposta, i webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono: la riscrittura dei dati in MRPeasy è quindi basata sugli eventi.

1. Caricamento iniziale delle anagrafiche. Importa articoli, unità, BOM e cicli di lavorazione dalla v1 e gruppi di centri di lavoro e centri di lavoro dalla v1 o dalla v2. Recupera i calendari da /workstation-groups della v2 (work_hours, holidays) oppure imposta i turni direttamente in SkyPlanner. Associa ogni gruppo Active processing a un gruppo di centri di lavoro di SkyPlanner, includendovi i relativi centri di lavoro.

2. Sincronizzazione degli ordini. Leggi gli ordini di produzione aperti con le relative operazioni, insieme agli ordini di acquisto aperti e alle giacenze. SkyPlanner considera il materiale ordinato disponibile alla data di consegna dell’ordine di acquisto e aggiorna le giacenze quando l’ordine viene contrassegnato come Delivered. A ogni ricalcolo, la schedulazione verifica sia le giacenze sia gli acquisti in arrivo.

3. Riscrittura della schedulazione in MRPeasy. PUT /manufacturing-orders/{id} supporta code, quantity, due_date e assigned_id, oltre ai campi personalizzati nel formato custom_<id>. Dove concordato, SkyPlanner scrive la fine pianificata in due_date e riporta inizio pianificato, fine pianificata e avanzamento nei campi personalizzati di MRPeasy. In questo modo, vendite e acquisti vedono la schedulazione effettiva in MRPeasy. La sequenza dettagliata delle operazioni e il centro di lavoro assegnato a ciascuna restano in SkyPlanner, che costituisce la vista operativa per il reparto.

4. Ordini creati al di fuori di MRPeasy. Se vengono creati ordini tramite API, POST /manufacturing-orders accetta no_scheduling e no_bookings. Usali per evitare che MRPeasy impegni centri di lavoro già schedulati da SkyPlanner.

5. Consuntivazione in reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations, Production Timer o Quick Log Mode e le registrazioni dei tempi mantengono aggiornata la schedulazione. Scegli un solo canale di consuntivazione. Usare in parallelo Internet-kiosk di MRPeasy e SkyPlanner per le stesse operazioni crea due versioni della realtà.

6. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima della messa in esercizio:

Flusso Engineer To Order. In un progetto MRPeasy già realizzato, ogni progetto cliente si traduce in un prodotto principale più un numero di semilavorati da uno a tre. Ciascuno ha la propria BOM e il proprio ciclo di lavorazione in MRPeasy, e l’ordine di produzione esiste in entrambi i sistemi. Mantieni un identificativo condiviso e stabile su ogni ordine, in modo che gli aggiornamenti non creino mai duplicati.

• I campi dei tempi cambiano a seconda dell’interfaccia. I campi Setup time, Cycle time e Capacity dell’interfaccia utente corrispondono rispettivamente a fixed_time, variable_time e variable_quantity nell’API. Un valore di Capacity superiore a 1 indica una lavorazione a lotti, come in un forno. Mappatela come un’operazione a lotti, non come un ciclo più lungo.
• Gruppi di lavorazione passiva. I gruppi di essiccazione e raffreddamento operano 24/7 senza limiti di capacità. Mappateli come tempi di attesa, non come centri di lavoro a capacità finita.
• La v1 non include i calendari. work-centers restituisce solo center_id, type_id, code e title. Usate la v2 oppure gestite i turni in SkyPlanner.
• Tempi di inattività. I tempi di inattività dei centri di lavoro comprendono manutenzione e fermi. Sincronizzateli, altrimenti SkyPlanner pianificherà lavorazioni su una macchina ferma.
• I cicli di lavorazione fanno riferimento ai gruppi. MRPeasy sceglie la macchina con la migliore disponibilità. In SkyPlanner, i centri di lavoro del gruppo diventano alternative effettive tra cui il motore può scegliere.