Integrācijas / ERP / ProShop ERP
ProShop ERP integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS
Šajā ProShop integrācijas ceļvedī administratoriem, konsultantiem un IT komandām ir paskaidrots, kā savienot ProShop ERP ar SkyPlanner APS. SkyPlanner nodrošina divvirzienu integrāciju ar ProShop, izmantojot ProShop API:
- No ProShop tiek saņemti Work Orders ar to operācijām, Parts, Work Order BOM ieraksti, Work Cells, Users, Tools, Fixtures un Purchase Orders.
- Plānotie sākuma un beigu datumi tiek ierakstīti atpakaļ ražošanas pasūtījumos.
- Ja izvēlaties, operatoru darba laiku var nosūtīt atpakaļ uz ProShop Time Tracking.
- SkyPlanner nosūta grafika izmaiņas ar webhook palīdzību, tiklīdz tās notiek.
Ieviešanas laikā SkyPlanner komanda pielāgo integrāciju jūsu ProShop konfigurācijai un nodrošina atbalstu arī pēc tās palaišanas. Šis ceļvedis ir paredzēts partneriem un izstrādātājiem, kuri vēlas piedalīties integrācijā vai paši veidot risinājumus, izmantojot dokumentēto SkyPlanner REST API (API uzziņa).
ProShop integrācijas saskarnes
Ārējai grafiku sastādīšanas sistēmai ProShop piedāvā divus piekļuves veidus, kas aprakstīti ProShop API izstrādātāju dokumentācijā:
- ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (ProShop nodrošina GraphQL API, kas pieejams, izmantojot HTTP(S).) Ir viens galapunkts: katrs izsaukums ir HTTP POST pieprasījums uz
<proshop root>/api/graphql, kura JSON pamatdaļā irquery,variablesunoperationName. Katram modulim ir vaicājums vienskaitļa formā viena ieraksta iegūšanai un vaicājums daudzskaitļa formā sarakstu iegūšanai. Saraksti tiek dalīti lapās, izmantojotpageSize(noklusējuma vērtība 20) unpageStart. Tie atgriežrecordsuntotalRecordsun pieņemfilterunqueryargumentus, kas atbilst katra moduļa Advanced Search iespējām. Shēmu var izpētīt ar introspekciju. (Ievads ProShop API) - Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Vienkārša REST saskarne ļauj ārējām integrācijām pieprasīt informāciju par brīvi izvēlētu laika intervālu.) Izsauciet
<proshop root>/recentlyupdatedrecordsarstart(ISO 8601) un neobligātajiem parametriemendunfilterby, piemēram,workorders,workcells,purchaseorders,timetracking,deletions. Vispirms ProShop komandai jāiespējo indekss. (Recently Updated Records API)
Dati tiek rakstīti, izmantojot GraphQL mutācijas. Dokumentācijā kā piemērs ir aprakstīts Time Tracking Login, un rakstīšanas piekļuve katram modulim tiek piešķirta ar piekļuves tiesību tvērumiem.
Autentifikācija un piekļuves tiesību tvērumi
- Piekļuves pilnvara katrā izsaukumā. Nosūtiet to kā
Authorization: Bearer <token>vai kā vaicājuma parametrutoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 un jaunākās versijās). ProShop sistēmas administrators atver System Config > Manage Authorizations, izveido Authorization, norādot Name un Maximum Scope, un atzīmē Direct Login un Active. Unique ID un Shared Secret tiek izmantoti kā
client_idunclient_secret. Lietotne nosūtagrant_type=client_credentialsar POST pieprasījumu uz<proshop root>/home/member/oauth/accesstokenun saņem Bearer pilnvaru arexpires_in. Atsvaidzināšanas pilnvaras nav, tāpēc pēc derīguma termiņa beigām jāpieprasa jauna pilnvara. (Client Credentials plūsma) - OAuth 2.0 Authorization Flow ir paredzēta izsaukumiem, kuriem nepieciešams lietotāja konteksts, piemēram, Time Tracking Login.
- Piekļuves tiesību tvērumi. Formāts ir
SCOPE_NAME:[{r|w|d|p}], kur burti apzīmē lasīšanu, rakstīšanu, dzēšanu un preferences. Grafiku sastādīšanas sistēma parasti pieprasaworkorders:rw parts:r purchaseorders:r users:r tools:r, kā arī Time Tracking, ja darba laiks tiek nosūtīts atpakaļ. Kopš ProShop 5.1.9: “a scope grant request is now required on all connections to the API.” (Visiem savienojumiem ar API tagad jāpieprasa piekļuves tiesību tvēruma piešķiršana.) (Autorizācijas tiesību tvērumi) - Audita pieraksti. Izsaukumiem, kas veikti ar klienta akreditācijas datiem, tiek rādīts lietotnes nosaukums, nevis lietotājs.
SkyPlanner REST API autentifikācijai izmanto API pilnvaru galvenē Authorization-Token (SkyPlanner Settings > API), un tā dokumentācija ir pieejama Swagger/OpenAPI. Integrācijas pamācībā soli pa solim aprakstīti pirmie izsaukumi.
Notikumi un periodiska datu pieprasīšana
ProShop izstrādātāju dokumentācijā nav aprakstīti izejošie webhook vai GraphQL abonementi. Dati no ProShop tiek iegūti ar periodiskiem pieprasījumiem, un Recently Updated Records API ļauj to darīt ar nelielu resursu patēriņu: pieprasiet visus kopš iepriekšējās izpildes izveidotos, mainītos vai dzēstos ierakstus, atlasot tikai grafikam nepieciešamos ierakstu tipus. Pēc tam iegūstiet mainītos ražošanas pasūtījumus pēc to numura, izmantojot GraphQL. ProShop norāda, ka tas ir ātrāk nekā veikt vaicājumu pēc lastModifiedTime.
Parasti ražošanas pasūtījumus un darba laika uzskaiti pārbauda ik pēc piecām minūtēm, bet detaļas un iepirkuma pasūtījumus — reizi stundā. SkyPlanner nosūta webhook paziņojumus, kad mainās stāvoklis vai grafiks, tāpēc datu rakstīšanu atpakaļ nosaka notikumi.
Datu sasaiste
| ProShop objekts (API) | SkyPlanner objekts | Virziens | Biežums |
|---|---|---|---|
Parts, COTS (GraphQL parts piekļuves tiesību tvērums) | Produkti un materiāli | ProShop → SkyPlanner | Sākotnējā ielāde, pēc tam — mainoties datiem |
| Work Order BOM ieraksti | Produkta struktūra, materiāli katram pasūtījumam | ProShop → SkyPlanner | Kopā ar katru ražošanas pasūtījumu |
| Ražošanas pasūtījuma operācijas: ražošanas šūna, paredzamais sagatavošanas un cikla laiks (normatīvie laiki) | Procesa soļi ar ilgumu, sagatavošanas un noslēguma laiku | ProShop → SkyPlanner | Kopā ar katru ražošanas pasūtījumu |
| Work Cells (iekārta, darbagalds, aprīkojums) | Darba centri, darba centru grupas, efektivitātes rādītāji | ProShop → SkyPlanner | Sākotnējā ielāde, pēc tam reti |
| Cilvēkiem piesaistītās Work Cells, Users | Personāls un operatoru piesaiste | ProShop → SkyPlanner | Sākotnējā ielāde, pēc tam izmaiņu gadījumā |
| Ražošanas šūnu grafiki (pieejamās stundas, maiņas) | Maiņas un brīvdienas | ProShop → SkyPlanner | Katru dienu vai atsevišķi uzturētas maiņas SkyPlanner |
| Work Orders (daudzums, izpildes termiņš, statuss) | Pasūtījumi un ražošanas uzdevumi ar izpildes termiņiem un prioritāti | ProShop → SkyPlanner | Periodiski pieprasījumi ik pēc dažām minūtēm |
| Tools, Toolpots, Fixtures, RTAs | Instrumenti kā ierobežoti koplietojami resursi | ProShop → SkyPlanner | Sākotnējā ielāde, pēc tam izmaiņu gadījumā |
| Purchase Orders ar piegādes termiņiem | Iepirkuma pasūtījumi, ienākošie materiāli pēc piegādes datuma | ProShop → SkyPlanner | Periodiski pieprasījumi reizi stundā vai grafika sastādīšanas laikā |
Ražošanas pasūtījuma plānotais sākums un beigas (GraphQL mutācija, workorders:w) | Plānotais sākums un beigas katram ražošanas uzdevumam | SkyPlanner → ProShop | Mainoties grafikam, ar SkyPlanner webhook palīdzību |
| Time Tracking: sagatavošanas un izpildes laiks, pabeigtās detaļas katrai ražošanas pasūtījuma operācijai | Darba laika ieraksti un operatoru apstiprinājumi | SkyPlanner → ProShop | Pēc katra apstiprinājuma vai katrā maiņā, ja tas izvēlēts |
| ProShop nav pieejams | Sagatavošanas laiku matrica, ražošanas uzdevumi ar vairākiem operatoriem, alternatīvas iekārtas un darbinieki | Tiek uzturēts SkyPlanner | Tiek konfigurēts ieviešanas laikā |
Integrācijas risinājumi
1. Sākotnējā pamatdatu ielāde. Ar GraphQL daudzskaitļa vaicājumiem iegūstiet Parts, Work Cells, Users, Tools un Fixtures datus pa lapām. Sākotnējai ielādei iestatiet lielu pageSize vērtību un turpiniet ciklu, vadoties pēc totalRecords. Nosakiet ražošanas šūnu atbilstību: iekārtu šūnas kļūst par darba centriem, bet cilvēku šūnas — par personālu. Tādējādi vienai operācijai var vienlaikus rezervēt gan iekārtu, gan tās operatoru.
2. Ražošanas pasūtījumu sinhronizācija. Nolasiet aktīvos ražošanas pasūtījumus ar to operācijām, normatīvajiem laikiem un BOM ierakstiem, kā arī atvērtos iepirkuma pasūtījumus. SkyPlanner uzskata pasūtīto materiālu par pieejamu iepirkuma pasūtījuma piegādes datumā un atjaunina krājumu atlikumu, kad pasūtījumam piešķir statusu Delivered. Izmaiņas tiek noteiktas, izmantojot Recently Updated Records ar filterby=workorders,purchaseorders,deletions.
3. Grafika ierakstīšana atpakaļ. Kad plānošanas dzinis ieplāno vai pārvieto ražošanas uzdevumu, SkyPlanner webhook aktivizē GraphQL mutāciju, kas iestata ražošanas pasūtījuma plānotos datumus, izmantojot Authorization ar workorders:w. Pēc tam ProShop izpildes savlaicīguma prognoze un datumi, kuros nepieciešami iepirktie materiāli, balstās uz SkyPlanner datumiem.
4. Apstiprinājumi no ražotnes. Operatori reģistrē darbu ar SkyPlanner Mobile Confirmations vai Production Timer, un darba laika ieraksti uztur grafiku aktuālu. Jūs izvēlaties, vai faktisko darba laiku nosūtīt atpakaļ uz ProShop Time Tracking, piesaistot to ražošanas pasūtījuma operācijai. Ja ne, operatori turpina reģistrēt laiku ProShop tāpat kā līdz šim, un SkyPlanner to nolasa ar timetracking.
5. Atbildība par datiem un konfliktu risināšanas noteikumi. Dokumentējiet tos pirms darbības uzsākšanas:
| Dati | Atbildīgā sistēma |
|---|---|
| Detaļas, operācijas, normatīvie laiki, daudzumi, ražošanas pasūtījuma statuss | ProShop |
| Operāciju secība, sākuma un beigu laiki, iekārtas un operatora piesaiste | SkyPlanner |
| Pārregulēšanas laiku matrica, prasības instrumentiem un operatoriem, alternatīvie resursi | SkyPlanner |
| Maiņas un brīvdienas | Viena sistēma, kas izvēlēta tvēruma noteikšanas laikā |
| Time Tracking, krājumi, iepirkumi, ražošanas uzdevumu izmaksu aprēķins | ProShop; dati ievadīti tajā vai nosūtīti no SkyPlanner darba laika ierakstiem |
Izvēlieties vienu sistēmu, kas rakstīs ražošanas pasūtījumu datumus. Tiklīdz SkyPlanner sastāda ražošanas šūnas grafiku, plānotāji vairs nemaina šīs šūnas darbu secību ProShop, lai abi plāni nekad nekonkurētu.
Tipiski projekta posmi
Ieviešana parasti tiek pabeigta dažu nedēļu laikā pēc tās uzsākšanas. Pirms tam pārbaudiet grafiku 30 dienu bezmaksas izmēģinājumā, izmantojot ražošanas šūnas, operācijas un atvērtos ražošanas pasūtījumus, kas eksportēti no ProShop CSV vai Excel formātā.
- Datu sasaiste. Apstipriniet atbilstību tabulu, noteikumus par atbildību par datiem, sinhronizācijas biežumu un to, vai darba laiks tiks nosūtīts atpakaļ.
- Piekļuve ProShop. Administrators izveido Authorization ar saskaņoto Maximum Scope un lūdz ProShop komandai iespējot Recently Updated Records.
- Sākotnējā ielāde. Parts, Work Cells, Users, Tools, Fixtures un ražošanas šūnu grafiki.
- Ražošanas un iepirkuma pasūtījumu sinhronizācija. Periodiska izmaiņu pārbaude ar dalījumu lapās un atkārtotiem mēģinājumiem.
- Ierobežojumu konfigurēšana SkyPlanner. Sagatavošanas laiku matrica, instrumenti, operatoru skaits katrai operācijai un alternatīvas iekārtas vai darbinieki.
- Grafika ierakstīšana atpakaļ. Mutācijas, ko aktivizē SkyPlanner webhook, un arī Time Tracking, ja tas izvēlēts.
- Paralēlā testēšana. Izmantojiet SkyPlanner paralēli pašreizējam ProShop grafikam, salīdziniet datumus un precizējiet normlaikus.
- Darba sākšana. Ieslēdziet datu ierakstīšanu atpakaļ, kad dati sakrīt.
Kas jāņem vērā, plānojot ProShop integrāciju
- Normlaiki nosaka visu. ProShop aprēķina ilgumu no paredzētā sagatavošanas un cikla laika. Iegūstiet aktuālos normlaikus, nevis sākotnējo aplēsi, un nodaliet sagatavošanas laiku no izpildes laika, lai vienu sagatavošanas laika vērtību varētu aizstāt ar sagatavošanas laiku matricu.
- Darbinieks kā ražošanas šūna. Ražošanas šūna var būt arī cilvēks. Šādas šūnas sasaistiet ar SkyPlanner personālu, nevis iekārtām, citādi katrs operators tiks uzskatīts par paralēli pieejamu iekārtu.
- Time Tracking vajadzīgs lietotājs. Kopš 2026. gada aprīļa uz Time Tracking Login mutāciju attiecas prasība “requires user context” (nepieciešams lietotāja konteksts), un tā nav atļauta ar Client Credentials. Nosūtiet operatoru darba laiku, izmantojot OAuth 2.0 Authorization Flow, vai turpiniet reģistrēt laiku ProShop un nolasiet to.
- Aktivizējiet izmaiņu indeksu. Recently Updated Records darbojas tikai pēc tam, kad to aktivizējusi ProShop komanda. Pieprasiet to pirmajā nedēļā.
- ITAR ieraksti. ProShop filtrē ierakstus, uz kuriem attiecas ITAR ierobežojumi, katram savienojumam atsevišķi. Developer System Config iestatījums nosaka, vai tie tiek atgriezti kā null vērtības vai izlaisti. Vienojieties, kuri ražošanas pasūtījumi integrācijai būs pieejami, un katrā nolasīšanas reizē apstrādājiet null vērtības.
- Ārpakalpojumu operācijas. Piegādātāju veiktās operācijas aizņem laiku, bet nenoslogo jūsu jaudu. Modelējiet tās kā posmus, kuriem ņem vērā tikai ilgumu.
Kas konfigurē ProShop integrāciju un nodrošina tās atbalstu
- SkyPlanner komanda konfigurē integrāciju ieviešanas laikā un nodrošina atbalstu pēc tās palaišanas. Tas ietver saskaņotos GraphQL vaicājumus, mutācijas un periodisku izmaiņu pārbaudi. Katrs uzņēmums izmanto ProShop atšķirīgi, un konfigurācijā šīs īpatnības tiek ņemtas vērā.
- Piedalās arī jūsu ProShop administrators vai konsultants. Viņš izveido Authorization, nosaka piekļuves tvērumus, pieprasa izmaiņu indeksu un pārzina jūsu ražošanas šūnu konfigurāciju.
- Jūsu izstrādātāji var paplašināt integrāciju, izmantojot SkyPlanner REST API ar API pilnvaru. Lai sāktu, pietiek ar API pilnvaru, un SkyPlanner komanda vajadzības gadījumā palīdzēs. Norādījumi pieejami SkyPlanner integrācijas dokumentācijā.
SkyPlanner cena sākas no 199 € mēnesī par 5 darba centriem. Norēķini notiek katru mēnesi. Integrācijas cenu piedāvājumu sagatavojam iepriekš atbilstoši jūsu procesam un vajadzībām, kopā ar izvēlēto plānu. Skatiet cenas, ProShop ražošanas plānošanu atbilstoši faktiskajai iekārtu un personāla jaudai, ProShop ERP lapu, SkyPlanner iespējas un ERP integrāciju sadaļu.
Ražotāju atsauksmes par SkyPlanner
2 hietaupītas katru nedēļu
“Ar SkyPlanner esam pārgājuši no ražošanas plānošanas Excel tabulās uz ražošanas optimizāciju reāllaikā.”
Kalle Kalliomäki, piegādes ķēdes speciālists
UTU · Elektrosadales skapji un sadaliekārtas
Ražošanas plānošana katru nedēļu ietaupa 2 darba stundas, un jaunā darbu rinda ražošanas līnijā nonāk dažu sekunžu laikā.
+90%ražošanas efektivitāte
“Ražošanas efektivitāte ir pieaugusi par 90%.”
Abdul Rucyinga, IT vadītājs
Laboratory & Allied · Farmaceitiskā ražošana
Ražošanas efektivitāte ir pieaugusi par 90%, un optimizēta trīs mēnešu plāna sagatavošana visiem darba centriem aizņem mazāk nekā 30 minūtes.
98%piegāžu savlaicīgums — iepriekš aptuveni 50%
“SkyPlanner ir izšķiroša loma mūsu piegāžu savlaicīguma uzturēšanā.”
Hannu Lahtinen, izpilddirektors
KJH-Comp · Lokšņu metāla izstrādājumi un līgumražošana
Piegāžu savlaicīgums pieauga no aptuveni 50% līdz pat 98%, un grafiku sastādīšanai tagad vajadzīgs viens meistars, nevis divi.
1 000-iemražošanas pasūtījumu grafiki sastādīti automātiski
“Tagad ražošanu pārvaldām pavisam citādi, un mūsu izpratne par jaudu ir pilnīgi citā līmenī.”
Hannu Ryynänen, izpilddirektors
Mamec · Rūpnieciskie maisītāji, sūkņi un augsto tehnoloģiju līgumražošana
Tūkstošiem ražošanas pasūtījumu tiek automātiski iekļauti grafikā, un visam uzņēmumam ir pieejams reāllaika pārskats par ražošanu.
Biežāk uzdotie jautājumi
Vai ProShop ir API?
Jā. ProShop GraphQL API ir pieejams adresē <proshop root>/api/graphql ar OAuth 2.0 vai Basic Authentication un moduļu piekļuves tvērumiem. REST galapunkts Recently Updated Records atgriež noteiktā laika intervālā izveidotos, mainītos vai dzēstos ierakstus.
Vai ProShop atbalsta tīmekļa aizķeres?
ProShop izstrādātāju dokumentācijā nav aprakstītas izejošās tīmekļa aizķeres. Integrācija periodiski pieprasa datus no Recently Updated Records API atbilstoši katram uzņēmumam iestatītajam intervālam. SkyPlanner tīmekļa aizķeres nosūta grafika izmaiņas, tiklīdz tās notiek.
Kā plānotie datumi tiek ierakstīti atpakaļ ProShop?
Ar GraphQL mutāciju ražošanas pasūtījumam, izmantojot Authorization ar rakstīšanas tiesībām workorders tvērumā. SkyPlanner to ierosina ar tīmekļa aizķeri ikreiz, kad grafiks mainās.
Kas izveido ProShop API akreditācijas datus?
ProShop sistēmas administrators sadaļā System Config > Manage Authorizations. Direct Login iespējo Client Credentials plūsmu, bet Maximum Scope ierobežo, ko integrācija drīkst nolasīt un ierakstīt.
Vai ProShop konsultantam ieteikt grafiku sastādīšanu ar ProShop vai ar SkyPlanner?
SkyPlanner — ja darbu secība klienta ražošanā nosaka piegādes termiņa ievērošanu. ProShop grafiks rāda katras ražošanas šūnas prioritātes un prognozi par termiņu ievērošanu, savukārt plānotāji pielāgo prioritātes. SkyPlanner savienojas, izmantojot GraphQL API, automātiski optimizē visu plānu un plāno pārregulēšanu, operatorus, instrumentus un materiālus. Lietotāju skaits nav ierobežots, un cena sākas no 199 € mēnesī.
Vai varam izmēģināt SkyPlanner pirms integrācijas izveides?
Jā. 30 dienu bezmaksas izmēģinājumā var izmantot līdz 20 darba centriem, importējot datus no ProShop CSV vai Excel formātā. Kredītkarte nav nepieciešama. Sāciet izmēģinājumu vai sazinieties ar pārdošanas komandu, lai noteiktu integrācijas tvērumu.
