Sprievodca integráciou Sylob ERP so SkyPlanner APS na rozvrhovanie výroby

Sylob dokumentuje dve verejné REST API: „L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \“webservices\“) qui autorise la lecture et l’écriture de données.“ (ERP Sylob sprístupňuje dva typy verejných REST API, nazývaných aj webové služby, ktoré umožňujú čítanie a zápis dát.) (Znalostná báza Forterro)

1. API REST Système d’information (čítanie). Spúšťa uložený dopyt (requête) vytvorený v aktivite „Interroger le système d’information“. URL na volanie konkrétneho dopytu získate cez „Autres actions“ > „Afficher le web service“. Má tvar /rest/query/{identifiantQuery}/resultat. Parametre určujú limit výsledkov, formátovanie čísel, premenné dopytu a štruktúru výsledkov. Výsledky sa štandardne vracajú vo formáte XML, prípadne vo formáte JSON pri použití hlavičky Accept: application/json. Toto API je súčasťou ERP.
2. API REST Action (čítanie a zápis). Spúšťa akciu definovanú v aktivite „Gérer les actions web service“, teda v katalógu akcií Sylob. Sprístupňuje dve operácie: GET /rest/v2/action/{code}/describe vracia dátovú schému akcie a POST /rest/v2/action/{code}/execute ju spúšťa s telom vo formáte JSON. K typom akcií patria:

– Modification de données: mení jedno alebo viac polí záznamu prostredníctvom mechanizmu rýchlych úprav v Sylob. Describe uvádza zoznam upraviteľných polí. – Message EDI: vytvára, mení alebo odstraňuje záznamy prostredníctvom správy EDI. – Scénario de saisie: spúšťa scenár zadávania údajov, otázku po otázke. Sylob uvádza ako príklad „Déclarer un début ou une fin“, ktorý hlási začiatok alebo koniec operácie (Sylob_Action_006). – Publikovanie, nahrávanie a sťahovanie dokumentov.

1. Správy EDI. Modul EDI v Sylob zabezpečuje exporty a importy. Štandardná správa Sylob_Recup_Decl_Pro načítava výrobné hlásenia. (Forterro)
2. Súbory a ETL. Sylob ERP Cloud ponúka „Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.“ (Integráciu súborov cez SFTP na jednoduchú migráciu existujúcich integrácií.) (Sylob) Výsledky dopytov možno exportovať aj do Excelu, čo je rýchly spôsob, ako začať so skúšobnou verziou SkyPlanner.

Verejná znalostná báza Sylob neuvádza možnosť prihlásiť sa na odber odchádzajúcich webhookov. Zmeny sa do SkyPlanner dostávajú pravidelným spúšťaním uložených dopytov, ktoré filtrujú otvorené OF a nedávne zmeny. Interval si nastavíte sami.

Sylob chráni ERP pred nadmernou záťažou z dopytov. Od verzie 2025.Q2 parameter spoločnosti „Protection des API“ zapína obmedzovanie volaní pre jednotlivých používateľov a stránkovanie rozsiahlych výsledkov. Sylob uvádza, že od verzie 2026.Q2 sa táto ochrana bude uplatňovať systematicky. Odpovede obsahujú hlavičky RateLimit a volanie nad rámec kvóty vráti HTTP 429 Too Many Requests s hodnotou Retry-After. (Forterro) Pri návrhu synchronizácie s tým počítajte: používajte inkrementálne dopyty, stránkovanie a pri odpovedi 429 odložte opakované volanie.

SkyPlanner naopak pri zmene stavu alebo rozvrhu odosiela webhooky, takže spätný zápis do Sylob sa riadi udalosťami.

1. Úvodné načítanie kmeňových dát. Pre každý objekt (položky, kusovníky, technologické postupy, pracoviská, zamestnanci) vytvorte jeden uložený dopyt a načítajte dáta cez API Système d’information alebo ich jednorazovo importujte z exportu do Excelu. Mapovanie pracovísk si dôkladne premyslite. Centre de charge v Sylob predstavuje skupinu zdrojov, takže stredisko s tromi strojmi sa v SkyPlanner zvyčajne zmení na skupinu pracovísk s tromi pracoviskami.

2. Synchronizácia zákaziek. Načítajte pevné OF s ich operáciami spolu so zásobami a otvorenými nákupnými objednávkami. SkyPlanner považuje objednaný materiál za dostupný v deň dodania nákupnej objednávky a aktualizuje zásoby, keď je objednávka označená stavom Delivered. Rozvrh tak zohľadňuje skladové zásoby aj očakávané dodávky z nákupu.

Rozvrhujte pevné OF, nie návrhy CBN. Návrhy sa pri ďalšom výpočte čistých potrieb zmenia.

3. Spätný zápis rozvrhu. Pre každú operáciu, ktorú plánovací mechanizmus zaradil alebo presunul, integrácia zavolá akciu Modification de données na operácii OF (Opération d’ordre de fabrication) s plánovaným začiatkom, plánovaným koncom a pracoviskom. Akcia používa vlastnú logiku rýchlych úprav Sylob, rovnako ako keď operáciu upravuje plánovač. Describe vracia upraviteľné polia, takže integrácia pred prvým volaním overí odosielané dáta. Ak záznam práve upravuje používateľ, volanie skončí očakávanou chybou; zopakujte ho pri nasledujúcej zmene.

4. Hlásenia z výroby. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer. Začiatok a koniec sa prenášajú späť cez scenár „Déclarer un début ou une fin“. Časové záznamy a množstvá sa zapisujú ako výrobné hlásenia k tej istej operácii OF: čas nastavenia, čas spracovania, vyrobené množstvo, nepodarky a dokončenie operácie. Ak už váš závod zadáva hlásenia cez Sylob Apps alebo výrobné terminály, ponechajte na hlásenia jediný kanál, aby nevznikali duplicitné záznamy.

5. Pravidlá zodpovednosti za dáta a riešenia konfliktov. Zdokumentujte ich pred spustením do ostrej prevádzky:

SkyPlanner nepotrebuje CADPLAN ani funkcie plánovania výroby s obmedzenou kapacitou v systéme Sylob. Správu termínov operácií prenechajte systému SkyPlanner, pretože dva plánovacie systémy zapisujúce tie isté termíny si ich navzájom prepisujú. Keď ich spravuje SkyPlanner, Autopilot pri každej významnej zmene automaticky preplánuje rozvrh a nové termíny sa prenesú späť do systému Sylob.

• Licencia na Action API. Čítanie cez uložené dopyty je zahrnuté. Zápis cez katalóg akcií vyžaduje modul Sylob „Webservice“ alebo licenciu API v MyForterro. Vyriešte to so svojím kontaktom pre Sylob ešte pred fázou spätného zápisu.
• Dopyty určujú dohodnuté rozhranie. Čítanie údajov závisí od uložených dopytov. Jasne ich pomenujte, filtre pri spustení odovzdávajte ako premenné atribúty a dopyty verziujte spolu s integráciou.
• Skupiny pracovísk. Jedno pracovisko v systéme Sylob môže zahŕňať viacero strojov. Pri každom rozhodnite, či sa má v systéme SkyPlanner zobrazovať ako jedna skupina pracovísk alebo ako jednotlivé stroje.
• Spätné rozvrhovanie a výpočty zaťaženia. Sylob rozvrhuje spätne od požadovaných termínov a naplánovaný výpočet zaťaženia môže preplánovať oneskorené OF. Dohodnite sa, či má niektorá z týchto činností naďalej zapisovať termíny operácií aj po tom, ako ich správu prevezme SkyPlanner, a ak áno, ktorá.
• Jednotky času nastavenia a výrobného času. Pred importom skontrolujte jednotky aj to, či sa čas nastavenia vzťahuje na OF alebo na kus. Nesprávne jednotky skreslia všetky doby trvania.
• Kalendáre. Týždenné režimy pracovísk a výnimky musia pokrývať celý horizont rozvrhovania, inak z plánu zmizne kapacita.
• Obmedzovanie počtu volaní. Sylob obmedzuje počet volaní na používateľa a rozsiahle výsledky rozdeľuje na stránky. Prírastkové zisťovanie zmien zostáva s dostatočnou rezervou pod limitom.
• CORS a prehliadače. Na volania medzi servermi sa CORS nevzťahuje. Pre klientov v prehliadači treba na strane systému Sylob nastaviť povolené zdroje.