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

A ProShop két kapcsolódási lehetőséget kínál a külső ütemezőrendszereknek. Ezeket a ProShop API fejlesztői dokumentációja ismerteti:

1. ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (A ProShop HTTP(S)-en keresztül elérhető GraphQL API-t biztosít.) Egyetlen végpont van: minden hívás HTTP POST kérés a <proshop root>/api/graphql címre, amelynek JSON-törzsében a query, variables és operationName szerepel. Minden modulhoz tartozik egyes számú lekérdezés egy rekordhoz és többes számú lekérdezés a listákhoz. A listák lapozását a pageSize (alapértéke 20) és a pageStart szabályozza. A válaszban records és totalRecords szerepel; a lekérdezések a modul Advanced Search funkciójának megfelelő filter és query argumentumokat fogadnak. A séma introspekcióval lekérdezhető. (Bevezetés a ProShop API használatába)
2. Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Egy egyszerű REST interfészen a külső integrációk tetszőleges időpontok közötti adatokat kérhetnek le.) Hívja meg a <proshop root>/recentlyupdatedrecords végpontot a start (ISO 8601), valamint az opcionális end és filterby paraméterekkel; utóbbira példa: workorders,workcells,purchaseorders,timetracking,deletions. Az indexet először a ProShop csapatának kell engedélyeznie. (A Recently Updated Records API használata)

Az írás GraphQL-mutációkkal történik. A dokumentált példa a Time Tracking Login; az írási hozzáférést modulonként, jogosultsági hatókörökkel (scope-okkal) lehet megadni.

A ProShop fejlesztői dokumentációja nem ismertet kimenő webhookokat vagy GraphQL-feliratkozásokat. A ProShop oldalát ezért rendszeresen le kell kérdezni. Ezt a Recently Updated Records API kis erőforrásigénnyel teszi lehetővé: kérje le az előző futás óta létrehozott, módosított vagy törölt rekordokat, az ütemezéshez szükséges rekordtípusokra szűrve. Ezután GraphQL-lel, a számuk alapján kérje le a megváltozott gyártási rendeléseket. A ProShop szerint ez gyorsabb, mint a lastModifiedTime szerinti lekérdezés.

A gyártási rendeléseknél és a munkaidő-adatoknál jellemzően ötpercenkénti, az alkatrészeknél és a beszerzési rendeléseknél óránkénti lekérdezést állítanak be. A SkyPlanner webhookot küld, ha változik az állapot vagy az ütemterv, így a visszaírás eseményvezérelt.

1. A törzsadatok kezdeti betöltése. GraphQL többes számú lekérdezésekkel, lapozva olvassa be a Parts, Work Cells, Users, Tools és Fixtures rekordjait. Az első betöltéshez állítsa magasra a pageSize értékét, és a totalRecords alapján ismételje a lekérdezést. Határozza meg a gyártócellák megfeleltetését: a gépet jelölő gyártócellákból munkaállomások, a személyt jelölőkből munkatársak lesznek. Így ugyanaz a művelet egyszerre foglalhatja le a gépet és annak kezelőjét.

2. A gyártási rendelések szinkronizálása. Olvassa be az aktív gyártási rendeléseket a műveleteikkel, célidőikkel és BOM-rekordjaikkal együtt, valamint 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, és frissíti a készletet, amikor a rendelés Delivered állapotot kap. A változások észlelése a Recently Updated Records segítségével történik, a filterby=workorders,purchaseorders,deletions beállítással.

3. Az ütemterv visszaírása. Amikor az ütemezőmotor elhelyez vagy áthelyez egy gyártási feladatot, egy SkyPlanner-webhook GraphQL-mutációt indít. Ez beállítja a gyártási rendelés tervezett dátumait egy workorders:w jogosultságú Authorization használatával. A ProShop ezután a SkyPlanner dátumai alapján jelzi előre, hogy tarthatók-e a határidők, és határozza meg a beszerzendő anyagok szükséges rendelkezésre állásának dátumait.

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, az időnaplók pedig naprakészen tartják az ütemtervet. Ön dönti el, hogy a tényleges munkaidő visszakerüljön-e a ProShop Time Tracking moduljába, a gyártási rendelés megfelelő műveletéhez. Ha nem, a gépkezelők továbbra is a ProShopban rögzítik az időt, a SkyPlanner pedig a timetracking segítségével olvassa be.

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

Jelöljön ki egyetlen rendszert, amely módosíthatja a gyártási rendelések dátumait. Amint egy gyártócella ütemezését a SkyPlanner végzi, a tervezők már nem módosítják a cella listájának sorrendjét a ProShopban. Így a két ütemterv soha nem kerül ellentmondásba.

• A normaidőkön múlik minden. A ProShop a becsült beállítási és ciklusidőkből számítja az időtartamot. Az aktuális normaidőket kérdezze le, ne az eredeti becslést. A beállítási időt különítse el a futási időtől, hogy a beállításiidő-mátrix átvehesse az egyetlen beállítási érték helyét.
• Személyként kezelt gyártócellák. Egy gyártócella személyt is jelölhet. Ezeket a SkyPlannerben a munkatársakhoz rendelje, ne a gépekhez, különben minden gépkezelő párhuzamos gépként jelenik meg.
• A Time Tracking használatához felhasználó szükséges. A Time Tracking Login mutáció 2026 áprilisa óta „requires user context” (felhasználói környezetet igényel), és Client Credentials használatával nem engedélyezett. A gépkezelők munkaidejét az OAuth 2.0 Authorization Flow használatával küldje be, vagy továbbra is a ProShopban rögzítse, és onnan olvassa ki.
• Engedélyeztesse a változásindexet. A Recently Updated Records csak akkor működik, ha a ProShop csapata engedélyezte. Ezt már az első héten kérje.
• ITAR-korlátozás alá eső rekordok. A ProShop kapcsolatonként szűri az ITAR-korlátozás alá eső rekordokat. A Developer System Config egyik beállítása határozza meg, hogy ezek null értékként jelennek-e meg, vagy kimaradnak az eredményből. Egyeztessék, mely gyártási rendeléseket láthatja az integráció, és minden olvasásnál kezelje a null értékeket.
• Külső megmunkálás. A beszállítóknál végzett műveletek átfutási időt jelentenek, nem a saját kapacitást terhelik. Olyan lépésekként modellezze őket, amelyekhez csak időtartam tartozik.