Integracijos / ERP / ProShop ERP
ProShop ERP integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS
Šiame ProShop integravimo vadove administratoriams, konsultantams ir IT komandoms paaiškinama, kaip sujungti ProShop ERP su SkyPlanner APS. SkyPlanner su ProShop keičiasi duomenimis abiem kryptimis per pačios ProShop API:
- Į SkyPlanner perduodami Work Orders su jų operacijomis, Parts, Work Order BOM įrašai, Work Cells, Users, Tools, Fixtures ir Purchase Orders.
- Suplanuotos pradžios ir pabaigos datos įrašomos atgal į gamybos užsakymus.
- Jei pasirinksite, operatorių darbo laikas gali būti įrašomas atgal į ProShop Time Tracking.
- SkyPlanner per webhook sąsajas iškart perduoda tvarkaraščio pakeitimus.
Diegimo metu SkyPlanner komanda pritaiko integraciją prie jūsų ProShop konfigūracijos, o pradėjus naudoti sistemą teikia palaikymą. Šis vadovas skirtas partneriams ir programuotojams, norintiems prisidėti arba patiems kurti sprendimus naudojant dokumentuotą SkyPlanner REST API (API žinynas).
ProShop integravimo sąsajos
Išorinei tvarkaraščių sudarymo sistemai ProShop siūlo du būdus, aprašytus ProShop API dokumentacijoje programuotojams:
- ProShop GraphQL API. „ProShop provides a GraphQL API, available via HTTP(S).” (ProShop teikia GraphQL API, pasiekiamą per HTTP(S).) Naudojamas vienas galinis taškas: kiekvienas iškvietimas yra HTTP POST užklausa adresu
<proshop root>/api/graphql, kurios JSON turinyje pateikiamiquery,variablesiroperationName. Kiekvienas modulis turi vienaskaitos užklausą vienam įrašui ir daugiskaitos užklausą sąrašams gauti. Sąrašai skaidomi į puslapius naudojantpageSize(numatytoji reikšmė – 20) irpageStart. GrąžinamirecordsirtotalRecords, o priimami argumentaifilterirqueryatitinka kiekvieno modulio Advanced Search paiešką. Schemą galima ištirti introspekcijos užklausomis. (Įvadas į ProShop API) - Recently Updated Records API. „A simple REST interface allows external integrations to request information between arbitrary points in time.” (Paprasta REST sąsaja leidžia išorinėms integracijoms užklausti informacijos už bet kurį pasirinktą laikotarpį.) Kreipkitės į
<proshop root>/recentlyupdatedrecords, nurodydamistart(ISO 8601), neprivalomąendirfilterby, pavyzdžiui,workorders,workcells,purchaseorders,timetracking,deletions. Pirmiausia ProShop komanda turi įjungti indeksą. (Recently Updated Records API)
Duomenys įrašomi naudojant GraphQL mutacijas. Dokumentacijoje pateiktas Time Tracking Login pavyzdys, o įrašymo teisės suteikiamos atskiriems moduliams, nustatant prieigos apimtis.
Autentifikavimas ir prieigos apimtys
- Prieigos žetonas kiekviename iškvietime. Siųskite jį kaip
Authorization: Bearer <token>arba kaip užklausos parametrątoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 ir naujesnės versijos). ProShop sistemos administratorius atveria System Config > Manage Authorizations, sukuria Authorization, nurodo Name bei Maximum Scope ir pažymi Direct Login bei Active. Unique ID ir Shared Secret naudojami kaip
client_idirclient_secret. Programa POST užklausa siunčiagrant_type=client_credentialsadresu<proshop root>/home/member/oauth/accesstokenir gauna Bearer žetoną suexpires_in. Atnaujinimo žetono nėra, todėl pasibaigus galiojimui reikia paprašyti naujo žetono. (Client Credentials autentifikavimo eiga) - OAuth 2.0 Authorization Flow naudojamas iškvietimams, kuriems reikia naudotojo konteksto, pavyzdžiui, Time Tracking Login.
- Prieigos apimtys. Naudojamas formatas
SCOPE_NAME:[{r|w|d|p}], žymintis skaitymo, įrašymo, trynimo ir nuostatų teises. Tvarkaraščių sudarymo sistemai paprastai reikiaworkorders:rw parts:r purchaseorders:r users:r tools:r, taip pat Time Tracking teisių, jei darbo laikas įrašomas atgal. Nuo ProShop 5.1.9 „a scope grant request is now required on all connections to the API.” (Visiems prisijungimams prie API dabar būtina užklausa dėl prieigos apimties suteikimo.) (Autorizavimo prieigos apimtys) - Audito žurnalas. Iškvietimams, atliktiems naudojant kliento kredencialus, nurodomas programos, o ne naudotojo vardas.
SkyPlanner pusėje REST API autentifikavimui naudojamas API žetonas antraštėje Authorization-Token (SkyPlanner Settings > API). Sąsaja dokumentuota Swagger/OpenAPI formatu. Integravimo pamokoje žingsnis po žingsnio paaiškinti pirmieji iškvietimai.
Įvykiai ir periodinės užklausos
ProShop dokumentacijoje programuotojams neaprašyti nei siunčiamieji webhook pranešimai, nei GraphQL prenumeratos. ProShop duomenys tikrinami periodinėmis užklausomis, o Recently Updated Records API leidžia tai daryti su nedidelėmis sąnaudomis: užklauskite visko, kas sukurta, pakeista ar ištrinta nuo paskutinio tikrinimo, atsirinkdami tik tvarkaraščiui reikalingus įrašų tipus. Tada per GraphQL pagal numerį gaukite pakeistus gamybos užsakymus. ProShop nurodo, kad tai greičiau nei užklausa pagal lastModifiedTime.
Gamybos užsakymus ir darbo laiko apskaitos duomenis įprasta tikrinti kas penkias minutes, o detales ir pirkimo užsakymus – kas valandą. Pasikeitus būsenai ar tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, todėl įrašymas atgal vykdomas pagal įvykius.
Duomenų susiejimas
| ProShop objektas (API) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Parts, COTS (GraphQL prieigos apimtis parts) | Gaminiai ir medžiagos | ProShop → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Work Order BOM įrašai | Gaminio struktūra, kiekvieno užsakymo medžiagos | ProShop → SkyPlanner | Su kiekvienu gamybos užsakymu |
| Gamybos užsakymo operacijos: darbo centras, numatomas paruošimo ir ciklo laikas (norminiai laikai) | Proceso etapai su trukme, paruošimo ir sutvarkymo laiku | ProShop → SkyPlanner | Su kiekvienu gamybos užsakymu |
| Work Cells (staklės, darbastalis, įranga) | Darbo centrai, jų grupės ir efektyvumo rodikliai | ProShop → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
| Žmonėms priskirti Work Cells, Users | Personalas ir operatorių priskyrimas | ProShop → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Darbo centrų grafikai (galimos darbo valandos, pamainos) | Pamainos ir nedarbo dienos | ProShop → SkyPlanner | Kasdien arba pamainos tvarkomos pačioje SkyPlanner |
| Work Orders (kiekis, terminas, būsena) | Užsakymai ir užduotys su terminais bei prioritetu | ProShop → SkyPlanner | Tikrinimas užklausomis kas kelias minutes |
| Tools, Toolpots, Fixtures, RTAs | Įrankiai kaip riboti bendro naudojimo ištekliai | ProShop → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Purchase Orders su pristatymo terminais | Pirkimo užsakymai, gaunamos medžiagos pagal pristatymo datą | ProShop → SkyPlanner | Tikrinimas užklausomis kas valandą arba sudarant tvarkaraštį |
Suplanuota gamybos užsakymo pradžia ir pabaiga (GraphQL mutacija, workorders:w) | Suplanuota kiekvienos užduoties pradžia ir pabaiga | SkyPlanner → ProShop | Pasikeitus tvarkaraščiui, per SkyPlanner webhook pranešimą |
| Time Tracking: kiekvienos gamybos užsakymo operacijos paruošimo ir vykdymo laikas, pagamintų detalių kiekis | Darbo laiko įrašai ir operatorių patvirtinimai | SkyPlanner → ProShop | Po kiekvieno patvirtinimo arba kiekvieną pamainą, jei pasirinkta |
| ProShop sistemoje nėra | Paruošimo laikų matrica, kelių operatorių užduotys, alternatyvios staklės ir darbuotojai | Tvarkoma SkyPlanner sistemoje | Konfigūruojama diegimo metu |
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. GraphQL daugiskaitos užklausomis puslapiais gaukite Parts, Work Cells, Users, Tools ir Fixtures duomenis. Pirmajam įkėlimui nustatykite didelę pageSize reikšmę ir kartokite užklausas pagal totalRecords. Nuspręskite, kaip susieti darbo centrus: stakles atitinkantys darbo centrai tampa SkyPlanner darbo centrais, o žmones atitinkantys – personalu. Taip tai pačiai operacijai galima kartu rezervuoti stakles ir jų operatorių.
2. Gamybos užsakymų sinchronizavimas. Nuskaitykite aktyvius gamybos užsakymus su jų operacijomis, norminiais laikais ir BOM įrašais, taip pat dar neįvykdytus pirkimo užsakymus. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakymo pristatymo dieną ir atnaujina atsargas, kai pirkimo užsakymas pažymimas Delivered. Pakeitimai aptinkami per Recently Updated Records, naudojant filterby=workorders,purchaseorders,deletions.
3. Tvarkaraščio įrašymas atgal. Kai planavimo variklis įtraukia ar perkelia užduotį, SkyPlanner webhook pranešimas inicijuoja GraphQL mutaciją, kuri nustato planuojamas gamybos užsakymo datas. Tam naudojama Authorization su workorders:w. Tuomet ProShop įvykdymo laiku prognozė ir pirkimų poreikio datos remiasi SkyPlanner datomis.
4. Darbo patvirtinimai gamyboje. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer, o pagal darbo laiko įrašus atnaujinamas tvarkaraštis. Jūs pasirenkate, ar faktinis darbo laikas įrašomas atgal į ProShop Time Tracking prie atitinkamos gamybos užsakymo operacijos. Jei ne, operatoriai ir toliau registruoja laiką ProShop sistemoje, o SkyPlanner jį nuskaito per timetracking.
5. Duomenų valdymo ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti sistemą:
| Duomenys | Atsakinga sistema |
|---|---|
| Parts, operacijos, norminiai laikai, kiekiai, gamybos užsakymo būsena | ProShop |
| Operacijų seka, pradžios ir pabaigos laikas, staklių ir operatoriaus priskyrimas | SkyPlanner |
| Perderinimo laikų matrica, įrankių ir operatorių poreikis, alternatyvūs ištekliai | SkyPlanner |
| Pamainos ir nedarbo dienos | Viena sistema, pasirinkta apibrėžiant apimtį |
| Time Tracking, atsargos, pirkimai, užduočių savikainos apskaita | ProShop: duomenys įvedami joje arba perduodami iš SkyPlanner darbo laiko įrašų |
Pasirinkite vieną sistemą, kuri įrašo gamybos užsakymų datas. Kai darbo centro tvarkaraštį pradeda sudaryti SkyPlanner, planuotojai nebekeičia to darbo centro sąrašo eiliškumo ProShop sistemoje. Taip du planai niekada nekonkuruoja tarpusavyje.
Įprasti projekto etapai
Integracija paprastai įdiegiama per kelias savaites nuo diegimo darbų pradžios. Prieš tai patikrinkite tvarkaraštį per 30 dienų nemokamą bandomąjį laikotarpį, naudodami iš ProShop CSV arba Excel formatu eksportuotus darbo centrus, operacijas ir dar neįvykdytus gamybos užsakymus.
- Duomenų susiejimas. Sutarkite dėl susiejimo lentelės, atsakomybės už duomenis taisyklių, sinchronizavimo dažnumo ir to, ar darbo laikas bus įrašomas atgal.
- Prieiga prie ProShop. Administratorius sukuria Authorization su sutarta Maximum Scope reikšme ir paprašo ProShop komandos įjungti Recently Updated Records.
- Pradinis įkėlimas. Parts, Work Cells, Users, Tools, Fixtures ir darbo centrų grafikai.
- Gamybos ir pirkimo užsakymų sinchronizavimas. Pakeitimai tikrinami užklausomis, duomenis skaidant į puslapius ir pakartojant nepavykusias užklausas.
- Apribojimų konfigūravimas SkyPlanner sistemoje. Paruošimo laikų matrica, įrankiai, kiekvienai operacijai reikalingas operatorių skaičius ir alternatyvios staklės ar darbuotojai.
- Tvarkaraščio įrašymas atgal. SkyPlanner webhook pranešimų inicijuojamos mutacijos ir, jei pasirinkta, Time Tracking duomenys.
- Lygiagretus testavimas. Naudokite SkyPlanner greta esamo ProShop tvarkaraščio, palyginkite datas ir pakoreguokite normines trukmes.
- Paleidimas. Kai duomenys sutaps, įjunkite duomenų grąžinimą.
Į ką atsižvelgti planuojant ProShop integraciją
- Viską lemia norminės trukmės. ProShop apskaičiuoja trukmę pagal numatytą paruošimo ir ciklo laiką. Nuskaitykite dabartines normines trukmes, o ne pradinį įvertį. Atskirkite paruošimo laiką nuo vykdymo laiko, kad paruošimo laikų matrica galėtų pakeisti vieną paruošimo trukmės reikšmę.
- Darbo celės, žyminčios žmones. Darbo celė gali reikšti žmogų. Tokias celes susiekite su SkyPlanner darbuotojais, o ne su įrenginiais, antraip kiekvienas operatorius taps lygiagrečiai veikiančiu įrenginiu.
- Time Tracking būtinas naudotojas. Nuo 2026 m. balandžio Time Tracking Login mutacija „requires user context“ (reikalauja naudotojo konteksto), todėl jos negalima vykdyti naudojant Client Credentials. Operatorių darbo laiką siųskite per OAuth 2.0 Authorization Flow arba toliau registruokite laiką ProShop ir jį nuskaitykite.
- Įjunkite pakeitimų indeksą. Recently Updated Records veikia tik tada, kai šią funkciją įjungia ProShop komanda. Paprašykite tai padaryti pirmąją savaitę.
- ITAR įrašai. ProShop filtruoja įrašus, kuriems taikomi ITAR apribojimai, pagal kiekvieną ryšį. Developer System Config parinktis nustato, ar jie grąžinami kaip null reikšmės, ar visai neįtraukiami į atsakymą. Susitarkite, kuriuos gamybos užsakymus integracija galės pasiekti, ir kiekvieno nuskaitymo metu numatykite null reikšmių apdorojimą.
- Subrangovų atliekamos operacijos. Tiekėjų atliekamoms operacijoms svarbi trukmė, o ne jūsų pajėgumai. Modeliuokite jas kaip etapus, kuriems priskiriamas tik laikas.
Kas konfigūruoja ir prižiūri ProShop integraciją
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją pradėjus naudoti. Priežiūra apima sutartas GraphQL užklausas, mutacijas ir periodinį pakeitimų tikrinimą. Kiekviena gamybos įmonė ProShop naudoja skirtingai, todėl šiame etape pritaikomos žinios apie jos darbo specifiką.
- Dalyvauja jūsų ProShop administratorius arba konsultantas. Jis sukuria Authorization, nustato prieigos teises, paprašo įjungti pakeitimų indeksą ir žino, kaip sukonfigūruotos jūsų darbo celės.
- Jūsų programuotojai gali plėsti integraciją naudodami SkyPlanner REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Techninę informaciją rasite SkyPlanner integracijos dokumentacijoje.
SkyPlanner kainuoja nuo 199 € per mėnesį, įskaitant 5 darbo centrus. Mokama kas mėnesį. Integracijos kaina pateikiama iš anksto kartu su pasirinktu planu, atsižvelgiant į jūsų procesus ir poreikius. Peržiūrėkite kainas, informaciją apie ProShop gamybos planavimą pagal realius įrenginių ir darbuotojų pajėgumus, ProShop ERP puslapį, SkyPlanner funkcijas ir ERP integracijų skiltį.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skirstomieji skydai ir skirstymo įranga
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
98%pristatymo patikimumas, padidėjęs nuo maždaug 50%
„SkyPlanner atlieka lemiamą vaidmenį užtikrinant mūsų pristatymo patikimumą.“
Hannu Lahtinen, generalinis direktorius
KJH-Comp · Lakštinio metalo gaminiai ir sutartinė gamyba
Pristatymo patikimumas padidėjo nuo maždaug 50% iki net 98%, o tvarkaraščiams sudaryti dabar pakanka vieno vadovo vietoj dviejų.
1 000 ir daugiaugamybos užsakymų suplanuojami automatiškai
„Dabar gamybą valdome kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoniniai maišytuvai, siurbliai ir aukštųjų technologijų sutartinė gamyba
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija mato gamybos būklę realiuoju laiku.
Dažniausiai užduodami klausimai
Ar ProShop turi API?
Taip. ProShop turi GraphQL API adresu <proshop root>/api/graphql. Ji naudoja OAuth 2.0 arba Basic Authentication ir modulių prieigos teises. REST prieigos taškas Recently Updated Records grąžina per nurodytą laikotarpį sukurtus, pakeistus arba ištrintus įrašus.
Ar ProShop palaiko „webhook“ pranešimus?
ProShop programuotojų dokumentacijoje siunčiami „webhook“ pranešimai neaprašyti. Integracija periodiškai tikrina Recently Updated Records API pagal kiekvienai gamybos įmonei nustatytą grafiką. Pati SkyPlanner per „webhook“ pranešimus išsiunčia tvarkaraščio pakeitimus vos jiems įvykus.
Kaip suplanuotos datos įrašomos atgal į ProShop?
Naudojama gamybos užsakymo GraphQL mutacija ir Authorization, suteikiantis teisę rašyti į workorders. SkyPlanner ją paleidžia per „webhook“ pranešimą kaskart pasikeitus tvarkaraščiui.
Kas sukuria ProShop API prisijungimo duomenis?
ProShop sistemos administratorius skiltyje System Config > Manage Authorizations. Direct Login įjungia Client Credentials srautą, o Maximum Scope nustato, ką integracija gali skaityti ir rašyti.
Ką ProShop konsultantui siūlyti: ProShop tvarkaraščių sudarymą ar SkyPlanner?
SkyPlanner, kai nuo kliento darbų sekos priklauso pristatymas. ProShop tvarkaraštyje rodomi kiekvienos darbo celės prioritetai ir prognozės, ar darbai bus baigti laiku, o planuotojai koreguoja prioritetus. SkyPlanner prisijungia per GraphQL API, automatiškai optimizuoja visą planą, planuoja perderinimus, operatorių darbą, įrankius ir medžiagas. Naudotojų skaičius neribojamas, o kaina prasideda nuo 199 € per mėnesį.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti duomenis iš ProShop CSV arba Excel failais. Kredito kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
