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

Sylob documenta due REST API pubbliche: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (L’ERP Sylob espone due tipi di REST API pubbliche, dette anche web service, che consentono di leggere e scrivere dati.) (Knowledge base di Forterro)

1. API REST Système d’information (lettura). Esegue una query salvata (requête), creata nell’attività “Interroger le système d’information”. L’URL per richiamare la query si ottiene da “Autres actions” > “Afficher le web service” ed è nel formato /rest/query/{identifiantQuery}/resultat. I parametri definiscono il limite dei risultati, il formato dei numeri, le variabili della query e la struttura dei risultati. I risultati vengono restituiti per impostazione predefinita in XML, oppure in JSON con l’intestazione Accept: application/json. Questa API è inclusa nell’ERP.
2. API REST Action (lettura e scrittura). Esegue un’azione definita nell’attività “Gérer les actions web service”, il catalogo delle azioni di Sylob. Espone due operazioni: GET /rest/v2/action/{code}/describe restituisce lo schema dei dati di un’azione e POST /rest/v2/action/{code}/execute la esegue con un corpo JSON. I tipi di azione comprendono:

– Modification de données: modifica uno o più campi di un record tramite il meccanismo di modifica rapida di Sylob. Describe elenca i campi modificabili. – Message EDI: crea, modifica o elimina record tramite un messaggio EDI. – Scénario de saisie: esegue uno scenario di immissione, una domanda alla volta. L’esempio fornito da Sylob è “Déclarer un début ou une fin”, che dichiara l’inizio o la fine di un’operazione (Sylob_Action_006). – Pubblicazione, caricamento e download di documenti.

1. Messaggi EDI. Il motore EDI di Sylob gestisce esportazioni e importazioni. Il messaggio standard Sylob_Recup_Decl_Pro recupera le dichiarazioni di produzione. (Forterro)
2. File ed ETL. Sylob ERP Cloud offre “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Integrazione di file tramite SFTP per migrare facilmente le integrazioni esistenti.) (Sylob) I risultati delle query possono anche essere esportati in Excel: è la via più rapida per provare SkyPlanner.

La knowledge base pubblica di Sylob non documenta alcuna sottoscrizione a webhook in uscita. Le modifiche arrivano a SkyPlanner tramite il polling di query salvate che filtrano gli OF aperti e le modifiche recenti, con una frequenza impostata da voi.

Sylob protegge l’ERP da un carico eccessivo di query. Dalla versione 2025.Q2, il parametro aziendale “Protection des API” attiva la limitazione delle chiamate per utente e la paginazione dei risultati di grandi dimensioni. Sylob ne annuncia l’applicazione sistematica dalla versione 2026.Q2. Le risposte includono intestazioni RateLimit e una chiamata che supera la quota restituisce HTTP 429 Too Many Requests con un valore Retry-After. (Forterro) Progettate la sincronizzazione di conseguenza: query incrementali, paginazione e attesa progressiva prima di riprovare in caso di risposta 429.

Nella direzione opposta, SkyPlanner invia webhook quando cambia lo stato o la schedulazione: la scrittura di ritorno in Sylob è quindi attivata dagli eventi.

1. Caricamento iniziale delle anagrafiche. Create una query salvata per ogni oggetto (articoli, distinte base, cicli di lavorazione, centri di lavoro, dipendenti) e leggetene i dati tramite l’API Système d’information, oppure caricateli una sola volta da un’esportazione Excel. Definite con attenzione la corrispondenza dei centri di lavoro. In Sylob, un centre de charge è un gruppo di risorse: un centro con tre macchine diventa quindi di norma un gruppo con tre centri di lavoro in SkyPlanner.

2. Sincronizzazione degli ordini. Leggete gli OF confermati con le relative operazioni, oltre alle giacenze e agli ordini di acquisto aperti. 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.

Schedulate gli OF confermati, non le proposte del CBN. Le proposte cambiano alla successiva esecuzione del calcolo dei fabbisogni netti.

3. Scrittura della schedulazione in Sylob. Per ogni operazione inserita o spostata dal motore, l’integrazione richiama un’azione Modification de données sull’operazione dell’OF (Opération d’ordre de fabrication), passando inizio pianificato, fine pianificata e centro di lavoro. L’azione utilizza la logica di modifica rapida di Sylob, la stessa usata da un pianificatore che modifica l’operazione. Describe restituisce i campi modificabili, così l’integrazione convalida il payload prima della prima chiamata. Se un utente sta modificando un record, la chiamata restituisce un errore previsto: riprovate alla modifica successiva.

4. Dichiarazioni dal reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer. L’inizio e la fine vengono riportati in Sylob tramite lo scenario “Déclarer un début ou une fin”. I tempi registrati e le quantità diventano dichiarazioni di produzione sulla stessa operazione dell’OF: tempo di attrezzaggio, tempo di lavorazione, quantità prodotta, scarti e operazione conclusa. Se nello stabilimento le dichiarazioni vengono già registrate tramite Sylob Apps o terminali di reparto, mantenete un solo canale per evitare registrazioni doppie.

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

SkyPlanner non richiede CADPLAN né le attività di pianificazione a capacità finita di Sylob. Affidate a SkyPlanner la gestione delle date delle operazioni: se due sistemi di schedulazione scrivono le stesse date, si sovrascrivono a vicenda. Una volta affidata questa gestione a SkyPlanner, Autopilot rischedula automaticamente a ogni cambiamento significativo e le nuove date vengono inviate a Sylob.

• Licenza Action API. La lettura tramite query salvate è inclusa. Per scrivere tramite il catalogo delle azioni serve il modulo “Webservice” di Sylob oppure una licenza API su MyForterro. Concordatene l’attivazione con il vostro referente Sylob prima della fase di scrittura dei dati.
• Le query definiscono il contratto di integrazione. La lettura dipende dalle query salvate. Assegnate loro nomi chiari, passate i filtri come attributi variabili in fase di esecuzione e gestite le versioni delle query insieme a quelle dell’integrazione.
• Gruppi di centri di lavoro. Un centro di lavoro Sylob può comprendere più macchine. Decidete per ciascun centro se rappresentarlo in SkyPlanner come un gruppo di centri di lavoro o come singole macchine.
• Schedulazione a ritroso e calcolo dei carichi. Sylob schedula a ritroso dalle date di fabbisogno e un calcolo dei carichi programmato può ripianificare gli OF in ritardo. Concordate se e quale attività potrà ancora scrivere le date delle operazioni una volta affidata questa gestione a SkyPlanner.
• Unità dei tempi di attrezzaggio e lavorazione. Prima dell’importazione, verificate le unità di misura e se l’attrezzaggio è calcolato per OF o per pezzo. Unità errate falsano tutte le durate.
• Calendari. Gli schemi settimanali e le eccezioni dei centri di lavoro devono coprire l’intero orizzonte di schedulazione, altrimenti la capacità scompare dal piano.
• Limiti alle chiamate. Sylob limita le chiamate per utente e suddivide in pagine i risultati voluminosi. Il polling incrementale resta ampiamente entro la quota disponibile.
• CORS e browser. Le chiamate da server a server non sono soggette alle restrizioni CORS. Per i client browser occorre configurare le origini consentite sul lato Sylob.