Integratsioonid / ERP / ProShop ERP
ProShop ERP liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See ProShopi liidestamise juhend näitab administraatoritele, konsultantidele ja IT-meeskondadele, kuidas ühendada ProShop ERP SkyPlanner APS-iga. SkyPlanner vahetab ProShopiga andmeid mõlemas suunas ProShopi enda API kaudu:
- SkyPlannerisse tuuakse Work Orders koos operatsioonidega, Parts, Work Order BOM-i kirjed, Work Cells, Users, Tools, Fixtures ja Purchase Orders.
- Planeeritud algus- ja lõppkuupäevad kirjutatakse tagasi tootmistellimustele.
- Soovi korral saab operaatorite tööaja saata tagasi ProShop Time Trackingusse.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab liidestuse juurutamise käigus teie ProShopi seadistuse järgi ja pakub tuge ka pärast kasutuselevõttu. See juhend on partneritele ja arendajatele, kes soovivad töös osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
ProShopi liidestusvõimalused
ProShop pakub välisele ajakava koostamise tarkvarale kahte võimalust, mida kirjeldab ProShopi API arendajadokumentatsioon:
- ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (ProShop pakub HTTP(S) kaudu kasutatavat GraphQL API-t.) Lõpp-punkte on üks: iga kutse on HTTP POST aadressile
<proshop root>/api/graphql, mille JSON-keha sisaldab väljuquery,variablesjaoperationName. Igal moodulil on ainsusevormis päring ühe kirje ning mitmusevormis päring loendite jaoks. Loendid jaotatakse lehtedeks parameetritegapageSize(vaikimisi 20) japageStart. Vastuses tagastatakserecordsjatotalRecords. Loendipäringud võtavad vastu argumentefilterjaquery, mis vastavad iga mooduli Advanced Searchi võimalustele. Skeemi saab uurida introspektsiooni abil. (ProShopi API sissejuhatus) - Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Lihtne REST-liides võimaldab välistel liidestustel küsida teavet vabalt valitud ajavahemiku kohta.) Kutsuge välja
<proshop root>/recentlyupdatedrecordsparameetrigastart(ISO 8601) ning valikuliste parameetritegaendjafilterby, näiteksworkorders,workcells,purchaseorders,timetracking,deletions. ProShopi meeskond peab esmalt indeksi lubama. (Recently Updated Records API)
Andmeid kirjutatakse GraphQL-i mutatsioonidega. Dokumentatsioonis on näiteks toodud Time Tracking Login. Kirjutusõigus antakse igale moodulile eraldi pääsuulatuste kaudu.
Autentimine ja pääsuulatused
- Pääsutõend igas kutses. Saatke see kujul
Authorization: Bearer <token>või päringuparameetrinatoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 ja uuemad versioonid). ProShopi süsteemiadministraator avab System Config > Manage Authorizations, loob Authorizationi, määrates väljad Name ja Maximum Scope, ning märgib ruudud Direct Login ja Active. Unique ID ja Shared Secret lähevad vastavalt väljadele
client_idjaclient_secret. Rakendus saadab POST-päringugagrant_type=client_credentialsaadressile<proshop root>/home/member/oauth/accesstokenning saab Bearer-tõendi koos väljagaexpires_in. Värskendustõendit ei ole, seega tuleb tõendi aegumisel küsida uus. (Kliendi autentimisandmetega autentimise voog) - OAuth 2.0 Authorization Flow on mõeldud kutsetele, mis vajavad kasutajakonteksti, näiteks Time Tracking Login.
- Pääsuulatused. Vorming on
SCOPE_NAME:[{r|w|d|p}], kus tähed tähistavad lugemist, kirjutamist, kustutamist ja eelistusi. Ajakava koostamise tarkvara vajab tavaliselt õigusiworkorders:rw parts:r purchaseorders:r users:r tools:rning lisaks Time Trackingu õigusi, kui tööaeg saadetakse tagasi. Alates ProShopi versioonist 5.1.9 kehtib nõue: “a scope grant request is now required on all connections to the API.” (Nüüd tuleb kõigi API-ühenduste puhul taotleda pääsuulatuse lubamist.) (Autoriseerimise pääsuulatused) - Auditijälg. Kliendi autentimisandmetega tehtud kutsete juures kuvatakse rakenduse nimi, mitte kasutaja.
SkyPlanneri REST API kasutab autentimiseks API-tõendit päises Authorization-Token (SkyPlanner Settings > API). API on dokumenteeritud Swagger/OpenAPI abil. Liidestamise õpetus juhendab esimeste kutsete tegemist.
Sündmused ja perioodilised päringud
ProShopi arendajadokumentatsioon ei kirjelda väljaminevaid veebihaake ega GraphQL-i tellimusi. Seetõttu küsitakse ProShopist andmeid perioodiliselt. Recently Updated Records API hoiab päringute ressursikulu väikese: küsige kõiki pärast viimast käivitust loodud, muudetud või kustutatud kirjeid ning filtreerige need ajakava jaoks vajalike kirjetüüpide järgi. Seejärel lugege muudetud tootmistellimused GraphQL-i kaudu numbri alusel. ProShopi sõnul on see kiirem kui pärimine välja lastModifiedTime järgi.
Tavaliselt küsitakse tootmistellimuste ja tööaja andmeid iga viie minuti järel ning artiklite ja ostutellimuste andmeid kord tunnis. SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega toimub tagasikirjutamine sündmuspõhiselt.
Andmete vastendamine
| ProShopi objekt (API) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Parts, COTS (GraphQL-i pääsuulatus parts) | Tooted ja materjalid | ProShop → SkyPlanner | Esialgne laadimine, seejärel muudatuste korral |
| Work Order BOM-i kirjed | Toote struktuur, materjalid tellimuste kaupa | ProShop → SkyPlanner | Koos iga tootmistellimusega |
| Tootmistellimuse operatsioonid: töörakk, hinnanguline seadistus- ja tsükliaeg (normajad) | Protsessietapid koos kestuse ning seadistus- ja lõpetamisaegadega | ProShop → SkyPlanner | Koos iga tootmistellimusega |
| Work Cells (masin, tööpink, seadmed) | Töökeskused, töökeskuste rühmad, efektiivsusnäitajad | ProShop → SkyPlanner | Esmane laadimine, hiljem harva |
| Inimestele määratud Work Cells, Users | Personal ja operaatorite määrangud | ProShop → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Töörakkude töögraafikud (saadaolevad töötunnid, vahetused) | Vahetused ja töövabad päevad | ProShop → SkyPlanner | Iga päev või vahetuste haldamine SkyPlanneris |
| Work Orders (kogus, tähtaeg, olek) | Tellimused ja tööd koos tähtaegade ning prioriteediga | ProShop → SkyPlanner | Päringud iga paari minuti järel |
| Tools, Toolpots, Fixtures, RTAs | Tööriistad kui piiratud saadavusega jagatud ressursid | ProShop → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Purchase Orders koos tähtaegadega | Ostutellimused, saabuv materjal tarnekuupäeva järgi | ProShop → SkyPlanner | Päringud kord tunnis või ajakava koostamise käivitamisel |
Tootmistellimuse planeeritud algus ja lõpp (GraphQL-i mutatsioon, workorders:w) | Iga töö planeeritud algus ja lõpp | SkyPlanner → ProShop | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
| Time Tracking: seadistus- ja tööaeg ning valminud detailid tootmistellimuse operatsioonide kaupa | Ajaregistreeringud ja operaatorite kinnitused | SkyPlanner → ProShop | Soovi korral iga kinnituse või vahetuse järel |
| ProShopis puudub | Seadistusaegade maatriks, mitme operaatoriga tööd, alternatiivsed masinad ja töötajad | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Liidestuse töövood
1. Põhiandmete esmane laadimine. Lugege Parts, Work Cells, Users, Tools ja Fixtures lehtede kaupa GraphQL-i mitmusevormis päringutega. Määrake esimeseks laadimiseks suur pageSize ja jätkake tsüklit väärtuse totalRecords alusel. Otsustage, kuidas töörakud vastendatakse: masinate töörakkudest saavad töökeskused ja inimeste töörakkudest personal. Nii saab sama operatsiooni jaoks broneerida korraga nii masina kui ka selle operaatori.
2. Tootmistellimuste sünkroonimine. Lugege aktiivsed tootmistellimused koos operatsioonide, normaegade ja BOM-i kirjetega ning lisaks avatud ostutellimused. SkyPlanner käsitleb tellitud materjali ostutellimuse tarnekuupäeval saadaolevana ja uuendab laoseisu, kui ostutellimus märgitakse olekusse Delivered. Muudatused tuvastatakse Recently Updated Recordsi kaudu parameetriga filterby=workorders,purchaseorders,deletions.
3. Ajakava tagasikirjutamine. Kui mootor paigutab töö ajakavasse või muudab selle aega, käivitab SkyPlanneri veebihaak GraphQL-i mutatsiooni, mis määrab tootmistellimuse planeeritud kuupäevad. Selleks kasutatakse Authorizationit õigusega workorders:w. ProShopi tähtajaks valmimise prognoos ja ostude vajaduskuupäevad lähtuvad seejärel SkyPlanneri kuupäevadest.
4. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmationsi või Production Timeri abil ning ajaregistreeringud hoiavad ajakava ajakohasena. Teie otsustate, kas tegelik tööaeg saadetakse tagasi ProShop Time Trackingusse vastava tootmistellimuse operatsiooni juurde. Kui mitte, registreerivad operaatorid tööaega ProShopis nagu varem ning SkyPlanner loeb seda timetracking kaudu.
5. Andmete haldamise ja vastuolude lahendamise reeglid. Pange need enne töölerakendamist kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Artiklid, operatsioonid, normajad, kogused, tootmistellimuse olek | ProShop |
| Operatsioonide järjekord, algus- ja lõpuajad, masina ja operaatori määramine | SkyPlanner |
| Ümberseadistusaegade maatriks, nõuded tööriistadele ja operaatoritele, alternatiivsed ressursid | SkyPlanner |
| Vahetused ja puhkepäevad | Üks süsteem, mis valitakse ulatuse määramisel |
| Time Tracking, laoseis, ostud, tööde kuluarvestus | ProShop; andmed sisestatakse seal või saadetakse SkyPlanneri ajaregistreeringutest |
Valige üks süsteem, mis kirjutab tootmistellimuste kuupäevi. Kui tööraku ajakava koostab SkyPlanner, lõpetavad planeerijad selle tööraku loendi ümberjärjestamise ProShopis. Nii ei satu kaks plaani kunagi omavahel vastuollu.
Projekti tavapärased etapid
Juurutamine viiakse tavaliselt lõpule mõne nädala jooksul pärast selle algust. Enne seda kontrollige ajakava 30-päevase tasuta prooviperioodi jooksul, kasutades ProShopist CSV- või Exceli vormingus eksporditud töörakke, operatsioone ja avatud tootmistellimusi.
- Vastendamine. Pange paika vastendustabel, andmete haldamise vastutus, sünkroonimise sagedused ja see, kas tööaeg saadetakse tagasi.
- Juurdepääs ProShopile. Administraator loob Authorizationi kokkulepitud Maximum Scope’i väärtusega ja palub ProShopi meeskonnal lubada Recently Updated Recordsi.
- Esmane laadimine. Parts, Work Cells, Users, Tools, Fixtures ja töörakkude töögraafikud.
- Tootmis- ja ostutellimuste sünkroonimine. Muudatuste perioodiline pärimine koos lehekülgedeks jaotamise ja korduskatsetega.
- Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, tööriistad, operaatorite arv iga operatsiooni kohta ning alternatiivsed masinad või töötajad.
- Ajakava tagasikirjutamine. SkyPlanneri veebihaakide käivitatud mutatsioonid ning soovi korral ka Time Tracking.
- Paralleeltestimine. Kasutage SkyPlannerit senise ProShopi ajakava kõrval, võrrelge kuupäevi ja korrigeerige normatiivseid aegu.
- Kasutuselevõtt. Lülitage tagasikirjutamine sisse, kui andmed ühtivad.
Millega ProShopi integratsiooni kavandamisel arvestada
- Normatiivsed ajad määravad kõik. ProShop arvutab kestuse hinnanguliste seadistus- ja tsükliaegade põhjal. Lugege sisse kehtivad normatiivsed ajad, mitte algne hinnang. Hoidke seadistusaeg töötlusajast eraldi, et seadistusaegade maatriks saaks asendada ühe kindla seadistusaja.
- Inimene töökeskusena. Töökeskus võib olla ka inimene. Siduge sellised töökeskused SkyPlanneri töötajatega, mitte masinatega, muidu käsitletakse iga operaatorit paralleelselt töötava masinana.
- Time Tracking vajab kasutajat. Alates 2026. aasta aprillist kehtib Time Tracking Login mutatsioonile nõue “requires user context” (vajab kasutajakonteksti) ning Client Credentials ei anna selle kasutamiseks õigust. Saatke operaatorite tööajad OAuth 2.0 Authorization Flow kaudu või jätkake aja registreerimist ProShopis ja lugege andmed sealt.
- Laske muudatuste indeks sisse lülitada. Recently Updated Records töötab alles siis, kui ProShopi meeskond on selle lubanud. Taotlege seda esimesel nädalal.
- ITAR-piiranguga kirjed. ProShop filtreerib ITAR-piiranguga kirjeid ühenduse kaupa. Developer System Config seadistus määrab, kas need tagastatakse null-väärtustena või jäetakse tulemusest välja. Leppige kokku, milliseid tootmistellimusi integratsioon näeb, ja arvestage null-väärtustega igal lugemisel.
- Allhange. Tarnijate juures tehtavad operatsioonid võtavad aega, kuid ei koorma teie tootmisvõimsust. Modelleerige need etappidena, millel on ainult kestus.
Kes seadistab ProShopi integratsiooni ja pakub tuge
- SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus ja pakub tuge ka pärast kasutuselevõttu. See hõlmab kokkulepitud GraphQL päringuid, mutatsioone ja muudatuste perioodilist pärimist. Iga tootmisettevõte kasutab ProShopi omamoodi ning seadistamisel rakendatakse just neid teadmisi.
- Osaleb ka teie ProShopi administraator või konsultant. Ta loob Authorization objekti, määrab juurdepääsuõigused, taotleb muudatuste indeksi lubamist ja tunneb teie töökeskuste seadistust.
- Teie arendajad saavad integratsiooni edasi arendada, kasutades SkyPlanneri REST API liidest ja API pääsutõendit. Alustamiseks piisab API pääsutõendist ning SkyPlanneri meeskond aitab vajaduse korral. Tehnilised juhised leiate SkyPlanneri integratsiooni dokumentatsioonist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub kord kuus. Integratsiooni hinnapakkumine koostatakse ette koos paketiga, lähtudes teie protsessist ja vajadustest. Vaadake hindu, ProShopi tootmise planeerimist tegeliku masina- ja personalivõimsuse piires, ProShop ERP lehte, SkyPlanneri funktsioone ja ERP integratsioonide ülevaadet.
Tootmisettevõtete kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel hoitakse igal nädalal kokku 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhususe kasv
„Tootmise tõhusus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise tõhusus on kasvanud 90% ning kõiki töökeskusi hõlmiva optimeeritud kolme kuu plaani koostamine võtab alla 30 minuti.
98%tarnekindlus varasema ligikaudu 50% asemel
„SkyPlanneril on meie tarnekindluse hoidmisel otsustav roll.”
Hannu Lahtinen, tegevjuht
KJH-Comp · Lehtmetallitööd ja lepinguline tootmine
Tarnekindlus kasvas ligikaudu 50% pealt koguni 98% peale ning ajakava koostamiseks on nüüd kahe tööjuhi asemel vaja ühte.
1 000-te kaupaautomaatselt ajakavasse paigutatud tootmistellimusi
„Tootmine on hoopis teistmoodi kontrolli all ja meie arusaam tootmisvõimsusest on täiesti uuel tasemel.”
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline lepinguline tootmine
Tuhanded tootmistellimused paigutatakse ajakavasse automaatselt ning kogu organisatsioonil on tootmisest reaalajas ülevaade.
Korduma kippuvad küsimused
Kas ProShopil on API?
Jah. ProShopil on GraphQL API aadressil <proshop root>/api/graphql, mis kasutab OAuth 2.0 või Basic Authentication autentimist ja moodulipõhiseid juurdepääsuõigusi. REST-liidese otspunkt Recently Updated Records tagastab määratud ajavahemikus loodud, muudetud või kustutatud kirjed.
Kas ProShop toetab veebihaake?
ProShopi arendajadokumentatsioonis ei kirjeldata väljaminevaid veebihaake. Integratsioon pärib Recently Updated Records API kaudu muudatusi iga tootmisettevõtte jaoks määratud sagedusega. SkyPlanneri enda veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
Kuidas kirjutatakse planeeritud kuupäevad ProShopi tagasi?
Tootmistellimusele rakendatava GraphQL mutatsiooniga, kasutades Authorization objekti, millel on workorders kirjutusõigus. SkyPlanner käivitab selle veebihaagi kaudu iga kord, kui ajakava muutub.
Kes loob ProShopi API juurdepääsuandmed?
ProShopi süsteemiadministraator menüüs System Config > Manage Authorizations. Direct Login lubab Client Credentials voo ning Maximum Scope piirab seda, mida integratsioon saab lugeda ja kirjutada.
Kas ProShopi konsultant peaks soovitama ajakava koostamiseks ProShopi või SkyPlannerit?
SkyPlannerit, kui kliendi tööde järjekord määrab tarnetähtajast kinnipidamise. ProShopi ajakava näitab iga töökeskuse prioriteete ja tähtajaks valmimise prognoose ning planeerijad kohandavad prioriteete. SkyPlanner ühendub GraphQL API kaudu, optimeerib kogu plaani automaatselt ning planeerib ümberseadistusi, operaatorite tööd, tööriistade kasutust ja materjalivajadust. Kasutajate arv on piiramatu ja hind algab 199 € kuus.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevase tasuta prooviperioodi jooksul saab kasutada kuni 20 töökeskust ja importida ProShopist andmeid CSV- või Exceli failidena. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
