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

Fulcrum è un unico prodotto cloud multi-tenant, quindi tutti i clienti utilizzano la stessa API. Il portale per gli sviluppatori la descrive come un’API pubblica per “REST API calls directly into your Fulcrum site.” (chiamate REST API direttamente alla propria istanza Fulcrum).

• Specifica. OpenAPI “Fulcrum PublicAPI” v1, scaricabile da https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum suggerisce di usarla per generare un client tipizzato. La pagina History elenca tutte le modifiche con le relative date.
• Host. https://api.fulcrumpro.com per le istanze standard. Le istanze ITAR utilizzano api.fulcrumpro.us; sull’host .com i token ITAR ricevono una risposta 401.
• Convenzioni. Gli elenchi si ottengono con POST .../list, specificando i filtri nel corpo della richiesta, la paginazione con Skip e Take e l’ordinamento con Sort.Field / Sort.Dir. Molti oggetti accettano PUT; le commesse accettano anche JSON Patch.

Gli endpoint utilizzati da un’integrazione per la schedulazione:

La pagina delle integrazioni di Fulcrum è chiara sul lavoro necessario: “Every system is a little bit different and requires some configuration.” (Ogni sistema è leggermente diverso e richiede qualche intervento di configurazione.) È proprio di questa configurazione che si occupa il team SkyPlanner durante l’avviamento.

Fulcrum supporta i webhook, che vengono configurati da un amministratore. Da settembre 2026, i webhook che falliscono vengono sospesi e verificati nuovamente ogni giorno, anziché ritentati all’infinito. La History dell’API riporta eventi come PurchaseOrderUpdated e ItemUpdated.

L’integrazione legge i dati da Fulcrum con queste modalità:

• Le commesse aperte vengono lette ogni pochi minuti, filtrando gli stati scheduled e inProgress con hasIncompleteOperations: true. È il filtro indicato da Fulcrum per ottenere gli stessi risultati della sua pagina di schedulazione.
• Gli ordini di acquisto e le giacenze vengono letti prima di ogni esecuzione della schedulazione, oppure alla ricezione di un webhook PurchaseOrderUpdated, se configurato.
• Gli articoli, i cicli di lavorazione, le attrezzature e i turni vengono letti a ogni modifica oppure ogni notte.

Nella direzione opposta, i webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono. La scrittura dei dati in Fulcrum è quindi basata sugli eventi.

1. Caricamento iniziale delle anagrafiche. Importate articoli, materiali, cicli di lavorazione, centri di lavoro e attrezzature, quindi i turni di reparto e i fermi. Ogni centro di lavoro Fulcrum diventa un gruppo di centri di lavoro in SkyPlanner, di cui fanno parte le relative attrezzature. Le attrezzature selezionate per ciascuna operazione del ciclo diventano i centri di lavoro ammessi per quell’operazione. Le attrezzature con Unlimited Capacity, come forni e cabine di verniciatura, vengono gestite come operazioni a lotti.

2. Sincronizzazione degli ordini. Leggete le commesse aperte con i relativi articoli da produrre e le 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 nuova schedulazione vengono verificate le giacenze e gli acquisti in arrivo.

3. Scrittura della schedulazione in Fulcrum. Fulcrum calcola autonomamente scheduledStartUtc, scheduledEndUtc e scheduledEquipmentId e li restituisce in sola lettura. L’aggiornamento delle operazioni accetta customFields. SkyPlanner scrive l’inizio previsto, la fine prevista e il centro di lavoro nei campi personalizzati di ogni operazione della commessa, e la fine prevista in un campo personalizzato della commessa. I reparti vendite e acquisti possono così vedere le date di SkyPlanner sulla commessa in Fulcrum.

4. Consuntivazione in reparto. Gli operatori registrano il lavoro in SkyPlanner con Mobile Confirmations, Production Timer o Quick Log Mode. SkyPlanner invia i tempi a Fulcrum tramite /api/job-tracking-timers/start e /stop, oppure come blocco concluso tramite /api/timers. Le quantità vengono trasmesse tramite add-quantity-completed e il conteggio finale, inclusi gli scarti, tramite complete. Il calcolo dei costi di commessa in Fulcrum resta aggiornato in tempo reale.

5. Titolarità dei dati e gestione dei conflitti. Lo schedulatore di Fulcrum “dictates the order of operations in Job Tracking.” (determina l’ordine delle operazioni in Job Tracking). Scegliete quindi un solo canale di assegnazione del lavoro per ogni operazione: la coda operatore di SkyPlanner oppure Fulcrum Job Tracking. Mettete per iscritto le regole prima della messa in produzione:

• La disponibilità di personale si riflette nei limiti per turno. Il valore Max Equipment per turno di Fulcrum “is usually determined by how many people you have working in a certain area at that time.” (è solitamente determinato dal numero di persone che lavorano in una determinata area in quel momento). I singoli operatori e i relativi turni si configurano in SkyPlanner. I nomi si ricavano dagli utenti in /api/users.
• La schedulazione avviene sui macchinari. I centri di lavoro di Fulcrum sono gruppi di macchinari intercambiabili. Mantenete corretta la selezione dei macchinari nel ciclo di lavorazione: saranno le alternative tra cui il motore potrà scegliere.
• Gli ordini di produzione raggruppano le commesse. Un ordine di produzione raggruppa operazioni di più commesse, ad esempio per un nesting. Avviando un timer su un’operazione raggruppata, si avvia invece il timer dell’ordine di produzione, che copre tutte le operazioni delle commesse incluse nel gruppo.
• Limiti dei timer. I blocchi retroattivi di /api/timers “may not be in the future, older than 30 days, or longer than 7 days.” (non possono riferirsi al futuro né superare i limiti indicati di anzianità e durata). Inviate i tempi man mano che gli operatori li registrano.
• I formati temporali sono diversi. I turni usano valori HHmm nell’ora locale, i fermi e le date schedulate sono in UTC e i tempi stimati delle operazioni sono espressi in secondi.
• L’aggiornamento di un macchinario sostituisce l’intero record. Una richiesta PUT per un macchinario cancella tutti i campi non inclusi. SkyPlanner legge i dati dei macchinari e non li scrive mai.
• Installazioni ITAR. Usate l’host .us e un token ITAR.