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

L’integrazione utilizza due interfacce già incluse in Business Central:

1. API v2.0 per i dati commerciali e di magazzino. Espone items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers ed employees. Non include entità relative alla produzione, quindi i dati di produzione passano dalla seconda interfaccia.
2. Servizi web OData v4 per la produzione. Qualsiasi pagina di Business Central può essere pubblicata come servizio web OData v4 dalla pagina Web Services. Scegli il tipo di oggetto Page, l’ID della pagina e un nome per il servizio, quindi seleziona Published. L’endpoint è attivo, senza codice AL né estensioni da distribuire. L’integrazione pubblica le pagine standard per gli ordini di produzione rilasciati, Prod. Order Routing Lines, centri di lavoro, centri macchina e cicli di lavorazione, accessibili tramite /ODataV4/Company('{name}')/{ServiceName}.

Le pagine pubblicate consentono sia la lettura sia la scrittura. Microsoft precisa: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (se una pagina modificabile viene esposta come servizio web, una chiamata OData consente di accedere ai dati della tabella sottostante e modificarli), utilizzando PATCH per gli aggiornamenti. Le date pianificate vengono quindi riportate in Business Central attraverso la stessa pagina e con le stesse convalide utilizzate da chi pianifica la produzione.

Non utilizzate SOAP. Microsoft ha deprecato i servizi web SOAP e la pubblicazione delle pagine dell’interfaccia utente Microsoft come SOAP viene rimossa nella release wave 2 del 2026 (v29).

Business Central supporta le sottoscrizioni webhook tramite POST /api/v2.0/subscriptions sulle entità API v2.0 come items e salesOrders. Queste le regole:

• La creazione di una sottoscrizione richiede un handshake: il tuo endpoint deve restituire validationToken con stato 200 OK.
• Le sottoscrizioni scadono dopo tre giorni. Rinnovatele con PATCH: l’handshake verrà eseguito di nuovo.
• Le notifiche contengono il percorso della risorsa, changeType e il tuo clientState, non il record completo. Il record va letto successivamente.
• Le notifiche non sono immediate: Business Central online attende 30 secondi dopo la prima modifica. Se in quell’intervallo vengono modificati più di 1.000 record, le modifiche arrivano in un’unica notifica collection.
• Il limite è di 200 sottoscrizioni webhook per ambiente online.

Gli ordini di produzione, le righe dei cicli di lavorazione e gli ordini di acquisto vengono letti tramite polling ogni pochi minuti, sulle pagine pubblicate e su purchaseOrders. Il filtro sugli ordini aperti e la paginazione mantengono il numero di richieste ampiamente entro i limiti di Business Central.

SkyPlanner invia webhook quando cambia lo stato o la schedulazione; la riscrittura dei dati in Business Central è quindi basata sugli eventi.

1. Caricamento iniziale delle anagrafiche. Acquisite dalle pagine pubblicate i cicli di lavorazione e le distinte base di produzione con stato Certified, i centri di lavoro e i centri macchina; dall’API v2.0 acquisite articoli e unità di misura. Definite con attenzione la corrispondenza tra ogni centro di lavoro o centro macchina e un centro di lavoro SkyPlanner: decidete se un centro di lavoro con tre centri macchina debba diventare un gruppo di centri di lavoro oppure tre centri di lavoro distinti.

2. Sincronizzazione degli ordini. Leggete dalle pagine pubblicate gli ordini di produzione con stato Released (e Firm Planned, se li schedulate), con le relative righe del ciclo di lavorazione e i componenti. Acquisite inoltre le righe degli ordini di acquisto aperti tramite l’API v2.0. 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. La schedulazione verifica quindi sia le giacenze sia gli acquisti in arrivo.

Non schedulate mai gli ordini di produzione con stato Planned: Microsoft afferma che Business Central “deletes them the next time you run planning.” (li elimina alla successiva esecuzione della pianificazione). Il Planning Worksheet continua a proporre gli approvvigionamenti, mentre SkyPlanner schedula gli ordini confermati in base alla capacità reale.

3. Scrittura della schedulazione in Business Central. La pagina standard Prod. Order Routing viene pubblicata come servizio web OData v4. Per ogni operazione che il motore ha collocato o spostato, SkyPlanner invia un PATCH alla relativa riga del ciclo con l’ETag If-Match. Imposta Starting Date-Time ed Ending Date-Time, oltre a Type e No. quando l’operazione è stata spostata su una macchina alternativa.

La chiamata PATCH esegue i trigger della pagina e della tabella. Business Central convalida quindi i campi con la propria logica, esattamente come quando un pianificatore modifica la pagina Prod. Order Routing. I campi Starting Date-Time e Ending Date-Time della riga dell’ordine di produzione si aggiornano di conseguenza. Quantità, stato e costi restano gestiti da Business Central.

4. Consuntivazione in reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer e le registrazioni dei tempi mantengono aggiornata la schedulazione. La produzione può essere consuntivata in Business Central come prima, tramite Production Journal o Output Journal.

Se volete registrare produzione e consumi in modo completamente automatico, viene aggiunta una pagina API standard di Business Central per la registrazione tramite Output Journal. SkyPlanner registra quindi il tempo di attrezzaggio, il tempo di lavorazione e la quantità prodotta per ogni operazione. La registrazione aggiorna le Capacity Ledger Entries e la produzione registrata sull’ultima operazione del ciclo carica l’articolo a magazzino.

Scegliete un solo canale per registrare la produzione. Registrarla sia da SkyPlanner sia dal Production Journal di Business Central genera movimenti duplicati.

5. Responsabilità sui dati e regole per i conflitti. Definitele per iscritto prima della messa in produzione:

La principale fonte di conflitti sono le azioni Refresh e Replan sugli ordini di produzione. Microsoft precisa: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Se si usa l’azione Refresh per ricalcolare le righe dell’ordine di produzione, Business Central elimina quelle esistenti e ne calcola di nuove.) Anche Replan può modificare il fabbisogno di capacità; inoltre, il ricalcolo dei componenti “deletes previous changes in the components.” (elimina le modifiche precedenti ai componenti).

Trattate un ordine aggiornato con Refresh come una nuova versione, sincronizzatelo di nuovo e lasciate che SkyPlanner lo rischeduli. Con Autopilot, SkyPlanner rischedula automaticamente quando cambia la produzione.

• Unità di misura nei cicli di lavorazione. Setup Time si riferisce all’ordine di produzione, Run Time al singolo articolo prodotto, e ciascuno ha il proprio Unit of Measure Code. Wait Time e Move Time non impegnano la capacità del centro di lavoro. Se l’unità di misura del centro di lavoro è Days, un giorno equivale a 24 ore, non a un turno di otto ore. Convertite le unità durante l’importazione, altrimenti tutte le durate saranno errate.
• Calendari non aggiornati. La capacità è disponibile solo dopo aver eseguito Calculate Work Center Calendar per l’orizzonte di pianificazione. Controllate il campo Calendar Entries Available Until prima del caricamento iniziale.
• Capacità dei centri macchina non visibile. Con Consolidated Calendar disattivato viene pianificata solo la capacità propria del centro di lavoro: “The machine center capacity is excluded.” (La capacità del centro macchina è esclusa.) Leggete direttamente la capacità dei centri macchina, anziché affidarvi ai totali del centro di lavoro.
• Capacity ed Efficiency. Business Central calcola la durata come Run Time / Efficiency / Capacity e i movimenti di calendario calcolati includono già entrambi i fattori. Applicate Efficiency all’efficienza del centro di lavoro SkyPlanner una sola volta, non due.
• Alternate Work Center ha solo valore informativo. Microsoft precisa che “isn’t automatically included in planning processes.” (non viene incluso automaticamente nei processi di pianificazione). Configurate esplicitamente le alternative come centri di lavoro alternativi in SkyPlanner.
• Limiti alle richieste. I limiti online si applicano per utente e un’entità servizio conta come un utente: 6.000 richieste OData in una finestra mobile di 5 minuti e 5 richieste simultanee. La dimensione massima di una pagina è di 20.000 record, un $batch può contenere al massimo 100 operazioni e un’operazione va in timeout dopo 8 minuti. Il superamento della frequenza consentita restituisce 429. Usa batch, paginazione e polling delle sole modifiche invece di ricaricare tutti i dati.
• Licenze. Le funzionalità di produzione sono disponibili solo nell’esperienza Premium. Gli utenti con Essentials non possono accedere a una società impostata su Premium.