Sylob ERP integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez

A Sylob két nyilvános REST API-t dokumentál: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (A Sylob ERP kétféle nyilvános REST API-t, más néven webszolgáltatást biztosít az adatok olvasásához és írásához.) (Forterro tudásbázis)

1. API REST Système d’information (olvasás). Az “Interroger le système d’information” funkcióban létrehozott, mentett lekérdezést (requête) futtatja. A lekérdezés saját hívási URL-je az “Autres actions” > “Afficher le web service” menüpontból érhető el, formátuma: /rest/query/{identifiantQuery}/resultat. Paraméterekkel adható meg a találatok felső korlátja, a számformátum, a lekérdezési változók és az eredmény szerkezete. Az eredmény alapértelmezés szerint XML, a Accept: application/json fejléc megadásával pedig JSON. Ez az API az ERP része.
2. API REST Action (olvasás és írás). A Sylob műveletkatalógusában, a “Gérer les actions web service” funkcióban definiált műveletet futtatja. Két hívást biztosít: a GET /rest/v2/action/{code}/describe visszaadja a művelet adatsémáját, a POST /rest/v2/action/{code}/execute pedig JSON-törzzsel végrehajtja azt. A művelettípusok közé tartoznak:

– Modification de données: a Sylob gyorsszerkesztési mechanizmusával módosítja egy rekord egy vagy több mezőjét. A Describe felsorolja a szerkeszthető mezőket. – Message EDI: EDI-üzenettel hoz létre, módosít vagy töröl rekordokat. – Scénario de saisie: kérdésről kérdésre végigfuttat egy adatbeviteli forgatókönyvet. A Sylob saját példája a “Déclarer un début ou une fin”, amely egy művelet kezdését vagy befejezését jelenti vissza (Sylob_Action_006). – Dokumentumok közzététele, feltöltése és letöltése.

1. EDI-üzenetek. Az exportálást és az importálást a Sylob EDI-motorja kezeli. A termelési visszajelentések egy szabványos üzenettel, a Sylob_Recup_Decl_Pro segítségével kérhetők le. (Forterro)
2. Fájlok és ETL. A Sylob ERP Cloud a következőt kínálja: “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Fájlintegráció SFTP-n keresztül a meglévő integrációk egyszerű migrálásához.) (Sylob) A lekérdezések eredménye Excelbe is exportálható; ezzel lehet a leggyorsabban elkezdeni a SkyPlanner kipróbálását.

A Sylob nyilvános tudásbázisa nem dokumentál kimenő webhookokra való feliratkozást. A változások mentett lekérdezések időszakos futtatásával jutnak el a SkyPlannerhez, az Ön által beállított gyakorisággal. Ezek a lekérdezések a nyitott OF-ekre és a legutóbbi változásokra szűrnek.

A Sylob védi az ERP-t a túlzott lekérdezési terheléstől. A 2025.Q2 kiadás óta a “Protection des API” vállalati paraméter bekapcsolja a felhasználónkénti híváskorlátozást és a nagy eredményhalmazok lapozását; a Sylob bejelentése szerint ez a 2026.Q2 kiadástól általánossá válik. A válaszok RateLimit fejléceket tartalmaznak, a kvótát túllépő hívásra pedig HTTP 429 Too Many Requests válasz érkezik Retry-After értékkel. (Forterro) Ennek megfelelően tervezze meg a szinkronizálást: használjon növekményes lekérdezéseket, lapozást, és 429-es válasznál várjon az újrapróbálkozással.

A másik irányban a SkyPlanner webhookokat küld, ha az állapot vagy az ütemezés megváltozik, így a Sylobba történő visszaírás eseményvezérelt.

1. A törzsadatok kezdeti betöltése. Hozzon létre objektumonként egy mentett lekérdezést (articles, nomenclatures, gammes, munkaállomások, dolgozók), majd olvassa be őket a Système d’information API-n keresztül, vagy töltse be egyszer egy Excel-exportból. Gondosan tervezze meg a munkaállomások megfeleltetését. A Sylob centre de charge erőforrások csoportja, ezért egy három gépből álló egységből a SkyPlannerben általában egy három munkaállomást tartalmazó munkaállomás-csoport lesz.

2. Rendelések szinkronizálása. Olvassa be a véglegesített OF-eket a műveleteikkel együtt, valamint a készletet és a nyitott beszerzési rendeléseket. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumán tekinti elérhetőnek, a készletet pedig akkor frissíti, amikor a rendelés Delivered állapotot kap. Az ütemezés így a készletet és a várható beszerzéseket is ellenőrzi.

A véglegesített OF-eket ütemezze, ne a CBN javaslatait. A javaslatok a nettó szükségletszámítás következő futtatásakor megváltoznak.

3. Az ütemezés visszaírása. Minden olyan műveletnél, amelyet a motor elhelyezett vagy áthelyezett, az integráció egy Modification de données műveletet hív meg az OF műveletén (Opération d’ordre de fabrication), a tervezett kezdés, a tervezett befejezés és a munkaállomás megadásával. A művelet a Sylob saját gyorsszerkesztési logikáját használja, ugyanúgy, mintha egy tervező szerkesztené az adott műveletet. A Describe visszaadja a szerkeszthető mezőket, így az integráció az első hívás előtt ellenőrzi az elküldendő adatokat. Ha a rekordot éppen egy felhasználó szerkeszti, a hívás a vártnak megfelelően hibajelzéssel tér vissza; a következő változáskor próbálja újra.

4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével rögzítik a munkát. A kezdés és a befejezés a “Déclarer un début ou une fin” forgatókönyvön keresztül kerül vissza. Az időnaplókból és a mennyiségekből ugyanazon OF-művelethez tartozó termelési visszajelentések lesznek: átállási idő, futási idő, gyártott mennyiség, selejt és a művelet befejezése. Ha az üzemben már a Sylob Apps vagy üzemi terminálok segítségével történik a visszajelentés, a kettős rögzítés elkerülése érdekében maradjon egyetlen visszajelentési csatorna.

5. Adatgazdák és ütközéskezelési szabályok. Ezeket az éles indulás előtt rögzítse:

A SkyPlanner működéséhez nincs szükség sem a CADPLAN-re, sem a Sylob véges kapacitással tervező funkcióira. A műveletek dátumait a SkyPlanner kezelje, mert ha két tervező írja ugyanazokat a dátumokat, felülírják egymás módosításait. Ha már a SkyPlanner kezeli ezeket, az Autopilot minden érdemi változáskor automatikusan újraütemez, az új dátumok pedig visszakerülnek a Sylob rendszerbe.

• Action API-licenc. A mentett lekérdezésekkel végzett adatolvasásért nem kell külön fizetni. A műveletkatalóguson keresztüli íráshoz a Sylob „Webservice” modulja vagy a MyForterro rendszerben elérhető API-licenc szükséges. Erről még a visszaírási szakasz előtt egyeztessen Sylob-kapcsolattartójával.
• A lekérdezések adják az interfész alapját. Az adatolvasás a mentett lekérdezésekre épül. Adjon nekik egyértelmű nevet, a szűrőket futásidőben adja át változó attribútumként, és a lekérdezéseket az integrációval együtt verziózza.
• Munkaállomás-csoportok. A Sylob egyetlen munkaállomása több gépet is tartalmazhat. Munkaállomásonként döntse el, hogy a SkyPlanner egy munkaállomás-csoportként vagy különálló gépekként kezelje őket.
• Visszafelé ütemezés és terhelésszámítás. A Sylob az igényelt dátumoktól visszafelé ütemez, az időzített terhelésszámítás pedig újratervezheti a késésben lévő OF-eket. Egyezzenek meg abban, hogy miután a dátumok kezelését átvette a SkyPlanner, marad-e olyan funkció, amely továbbra is írhatja a műveletek dátumait, és ha igen, melyik.
• Az átállási és megmunkálási idők mértékegységei. Importálás előtt ellenőrizze a mértékegységeket, és azt, hogy az átállási idő OF-enként vagy darabonként értendő-e. A hibás mértékegységek minden időtartamot eltorzítanak.
• Naptárak. A munkaállomások heti munkarendjének és a kivételeknek le kell fedniük a teljes ütemezési időszakot, különben kapacitás tűnik el a tervből.
• Híváskorlátozás. A Sylob felhasználónként korlátozza a hívások számát, a nagy eredményhalmazokat pedig lapozva adja vissza. Az inkrementális lekérdezés jóval a kvótán belül marad.
• CORS és böngészők. A szerverek közötti hívásokra nem vonatkozik a CORS. Böngészős kliensekhez a Sylob oldalán be kell állítani az engedélyezett eredeteket.