Integracijos / ERP / Fulcrum
Fulcrum integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS
Šiame Fulcrum integravimo vadove konsultantams ir IT komandoms paaiškinama, kaip sujungti Fulcrum (Fulcrum Pro) su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Fulcrum abiem kryptimis per Fulcrum Public API:
- Į SkyPlanner perduodamos užduotys su gaminamais gaminiais ir operacijomis, gaminių technologiniai maršrutai, darbo centrai, įranga, padalinių pamainos, prastovos, atsargos ir pirkimo užsakymai.
- Planuojama pradžia, planuojama pabaiga ir darbo centras įrašomi į kiekvienos užduoties operacijos pasirinktinius laukus.
- Operatorių darbo laikas ir pagaminti kiekiai grąžinami į Fulcrum kaip laikmačių įrašai ir kiekių atnaujinimai.
- SkyPlanner siunčia pranešimus per webhook sąsajas vos pasikeitus tvarkaraščiui.
Diegimo metu SkyPlanner komanda sukonfigūruoja integraciją pagal jūsų Fulcrum aplinką ir ją prižiūri pradėjus naudoti sistemą. Šis vadovas skirtas konsultantams ir programuotojams, norintiems prisidėti arba patiems kurti sprendimus naudojant dokumentuotą SkyPlanner REST API (API žinynas).
Fulcrum Public API
Fulcrum yra bendras debesijos produktas, aptarnaujantis kelis klientus, todėl visi klientai naudoja tą pačią API. Kūrėjų portale ji apibūdinama kaip vieša API, skirta „REST API calls directly into your Fulcrum site.“ (REST API užklausoms tiesiai į jūsų Fulcrum aplinką).
- Specifikacija. OpenAPI „Fulcrum PublicAPI“ v1 galima atsisiųsti adresu
https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum siūlo pagal ją sugeneruoti klientą su apibrėžtais duomenų tipais. Puslapyje History pateikiami visi pakeitimai su datomis. - Serveriai. Standartinėms aplinkoms naudojamas
https://api.fulcrumpro.com. ITAR aplinkos naudojaapi.fulcrumpro.us, o užklausos su ITAR žetonais į .com serverį gauna 401 atsakymą. - Užklausų struktūra. Sąrašai gaunami per
POST .../list, užklausos turinyje nurodant filtrą. Puslapiavimui naudojamiSkipirTake, rūšiavimui –Sort.Field/Sort.Dir. Daugelis objektų palaiko PUT, o užduotys – ir JSON Patch.
Gamybos tvarkaraščių sudarymo integracijoje naudojami šie API galiniai taškai:
| Sritis | API galiniai taškai |
|---|---|
| Gaminiai ir technologiniai maršrutai | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| Gamybos cecho konfigūracija | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| Užduotys | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| Medžiagos | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| Gamybos cechas | /api/job-tracking-timers/start ir /stop, /api/timers, .../operations/{operationId}/add-quantity-completed, .../complete |
Fulcrum integracijų puslapyje aiškiai įvardijama, kokio darbo reikia: „Every system is a little bit different and requires some configuration.“ (Kiekviena sistema šiek tiek skiriasi, todėl ją reikia atitinkamai sukonfigūruoti.) Būtent šį konfigūravimą diegimo metu atlieka SkyPlanner komanda.
Autentifikavimas
Fulcrum naudoja Bearer žetoną Authorization antraštėje. „A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.“ (Viešosios API žetoną galite sugeneruoti savo Fulcrum aplinkoje pasirinkę Business Setup -> System Data -> Public Api.) Kiekvienas žetonas turi pavadinimą, aprašą ir galiojimo pabaigos datą. Galite sukurti tiek žetonų, kiek reikia, o norėdami atšaukti žetoną, jį ištrinkite. SkyPlanner integracijai skirkite atskirą žetoną ir nustatykite priminimą prieš jam baigiant galioti.
SkyPlanner REST API autentifikavimui naudoja API žetoną Authorization-Token antraštėje (SkyPlanner Settings > API). Ši API aprašyta Swagger/OpenAPI dokumentacijoje. Integravimo pamokoje paaiškinama, kaip atlikti pirmąsias užklausas.
Įvykiai ir periodinės užklausos
Fulcrum palaiko administratoriaus konfigūruojamus webhook pranešimus. Nuo 2026 m. rugsėjo, jei jų nepavyksta pristatyti, siuntimas pristabdomas ir kasdien bandomas iš naujo, užuot be galo kartojus bandymus. API History puslapyje nurodomi tokie įvykiai kaip PurchaseOrderUpdated ir ItemUpdated.
Integracija nuskaito Fulcrum duomenis taip:
- Nebaigtos užduotys nuskaitomos kas kelias minutes, filtruojant pagal
scheduledirinProgressbeihasIncompleteOperations: true. Būtent šį filtrą rekomenduoja Fulcrum, kad rezultatai atitiktų jos tvarkaraščio puslapį. - Pirkimo užsakymai ir atsargos nuskaitomi prieš kiekvieną tvarkaraščio sudarymą arba gavus
PurchaseOrderUpdatedwebhook pranešimą, jei jis sukonfigūruotas. - Gaminiai, technologiniai maršrutai, įranga ir pamainos nuskaitomi jiems pasikeitus arba kas naktį.
Kita kryptimi pačios SkyPlanner webhook pranešimai perduoda tvarkaraščio pakeitimus vos jiems įvykus, todėl duomenų įrašymą atgal į Fulcrum inicijuoja įvykiai.
Duomenų susiejimas
| Fulcrum objektas (API galinis taškas) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Item, Materials (/api/items, /api/materials) | Gaminiai ir medžiagos | Fulcrum → SkyPlanner | Pradinis įkėlimas, vėliau kas naktį |
Technologiniam maršrutui reikalingi gaminiai ir medžiagos (/routing/input-items, /input-materials) | Gaminio struktūra, tarpiniai gaminiai, gaminiui reikalingos medžiagos | Fulcrum → SkyPlanner | Pradinis įkėlimas, vėliau pasikeitus duomenims |
Technologinio maršruto operacijos (/routing/operations): setupTime, laborTime, machineTime (fiksuota trukmė arba trukmė vienam vienetui), selectedEquipmentIds | Proceso etapai, paruošimo laikai, trukmės, leidžiami darbo centrai | Fulcrum → SkyPlanner | Pradinis įkėlimas, vėliau pasikeitus duomenims |
Work Center (/api/work-centers) | Darbo centrų grupė | Fulcrum → SkyPlanner | Pradinis įkėlimas, vėliau retai |
Equipment (/api/equipment): unlimitedCapacity, canRunUnattended, status | Darbo centrai, partijų užduotys, veikimas be priežiūros | Fulcrum → SkyPlanner | Pradinis įkėlimas, būsena atnaujinama kasdien |
Department Shifts (/api/department-shifts), Equipment Downtimes | Pamainos ir neatvykimai | Fulcrum → SkyPlanner | Pradinis įkėlimas, vėliau kasdien |
Užduotis ir jos operacijos (/api/jobs, .../items-to-make/{id}/operations): priority, productionDueDate, earliestStartDate, numatomos trukmės | Užsakymai ir užduotys | Fulcrum → SkyPlanner | Užklausos kas kelias minutes |
| Inventory, Purchase Orders su Expected Receive datomis | Atsargos ir laukiamos medžiagos | Fulcrum → SkyPlanner | Prieš kiekvieną tvarkaraščio sudarymą |
Užduoties operacijos customFields (POST .../operations/{operationId}) | Planuojama pradžia, planuojama pabaiga, darbo centras | SkyPlanner → Fulcrum | Pasikeitus tvarkaraščiui, per SkyPlanner webhook pranešimą |
Užduoties customFields (PUT /api/jobs/{jobId}/custom-fields) | Planuojama užduoties pabaiga | SkyPlanner → Fulcrum | Pasikeitus tvarkaraščiui |
Užduočių laiko apskaitos laikmačiai, /api/timers, add-quantity-completed, complete | Darbo laiko įrašai, pagamintos produkcijos ir broko kiekiai | SkyPlanner → Fulcrum | Operatoriams registruojant darbą |
| Fulcrum sistemoje nėra | Vardiniai operatoriai, paruošimo laikų matrica, ribotas įrankių kiekis, alternatyvūs darbo centrai | Tvarkoma SkyPlanner sistemoje | Sukonfigūruojama diegimo metu |
Integravimo scenarijai
1. Pradinis pagrindinių duomenų įkėlimas. Pirmiausia nuskaitykite gaminius, medžiagas, technologinius maršrutus, darbo centrus ir įrangą, tada – padalinių pamainas ir prastovas. Kiekvienas Fulcrum darbo centras tampa SkyPlanner darbo centrų grupe, kuriai priklauso jo įranga. Kiekvienai technologinio maršruto operacijai parinkta įranga tampa leidžiamais tos operacijos darbo centrais. Įranga su Unlimited Capacity nuostata, pavyzdžiui, krosnys ir dažymo kameros, modeliuojama kaip partijų užduotys.
2. Užsakymų sinchronizavimas. Nuskaitykite nebaigtas užduotis su gaminamais gaminiais ir operacijomis, taip pat neįvykdytus pirkimo užsakymus ir atsargas. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakymo pristatymo dieną ir atnaujina atsargas, kai pirkimo užsakymas pažymimas Delivered. Kiekvieną kartą iš naujo sudarant tvarkaraštį tikrinamos atsargos ir laukiami užsakytų medžiagų pristatymai.
3. Tvarkaraščio duomenų įrašymas atgal. Fulcrum pati apskaičiuoja scheduledStartUtc, scheduledEndUtc ir scheduledEquipmentId ir grąžina juos tik skaitymui. Atnaujinant operaciją galima perduoti customFields. SkyPlanner įrašo planuojamą pradžią, planuojamą pabaigą ir darbo centrą į kiekvienos užduoties operacijos pasirinktinius laukus, o planuojamą pabaigą – į užduoties pasirinktinį lauką. Pardavimo ir pirkimo komandos mato SkyPlanner datas Fulcrum užduotyje.
4. Atliktų darbų patvirtinimas gamybos ceche. Operatoriai registruoja darbą SkyPlanner naudodami Mobile Confirmations, Production Timer arba Quick Log Mode. SkyPlanner perduoda darbo laiką į Fulcrum per /api/job-tracking-timers/start ir /stop arba kaip užbaigtą laiko intervalą per /api/timers. Kiekiai perduodami per add-quantity-completed, o galutinis kiekis, įskaitant broką, – per complete. Užduočių savikaina Fulcrum sistemoje išlieka aktuali.
5. Atsakomybė už duomenis ir konfliktų sprendimo taisyklės. Fulcrum planavimo modulis „dictates the order of operations in Job Tracking.“ (nustato operacijų eiliškumą Job Tracking modulyje). Todėl kiekvienai operacijai pasirinkite vieną užduočių perdavimo kanalą: SkyPlanner operatoriaus užduočių eilę arba Fulcrum Job Tracking. Prieš pradėdami naudoti integraciją, užrašykite taisykles:
| Duomenys | Atsakinga sistema |
|---|---|
| Prekės, technologiniai maršrutai, numatomos trukmės, atsargos, pirkimai, savikainos skaičiavimas | Fulcrum |
| Operacijų eiliškumas, pradžios ir pabaigos laikas, darbo centro priskyrimas | SkyPlanner |
| Operatoriai, paruošimo trukmės matrica, įrankiai, alternatyvūs ištekliai | SkyPlanner |
| Pamainos ir prastovos | Viena sistema, pasirinkta apibrėžiant projekto apimtį |
| Užregistruotas darbo laikas ir pagaminti kiekiai | SkyPlanner, duomenys perduodami į Fulcrum |
Įprasti projekto etapai
Diegimas paprastai baigiamas per kelias savaites nuo įvadinių darbų pradžios. Prieš tai per 30 dienų nemokamą bandomąjį laikotarpį sistemą išbandote su savo duomenimis. Eksportuokite prekes, technologinius maršrutus ir nebaigtas užduotis iš Fulcrum lentelių į CSV, importuokite šiuos duomenis ir patikrinkite tvarkaraštį.
Projektą sudaro šie etapai:
- Prieigos raktas ir apimtis. Sukurkite Public API prieigos raktą ir susitarkite, į kuriuos pasirinktinius laukus bus įrašomi grąžinami duomenys.
- Duomenų susiejimas. Patvirtinkite duomenų atitikmenų lentelę, atsakomybės už duomenis taisykles ir užduočių perdavimo kanalą.
- Pradinis duomenų įkėlimas. Prekės, medžiagos, technologiniai maršrutai, darbo centrai, įranga, pamainos ir prastovos.
- Užsakymų ir pirkimo užsakymų sinchronizavimas. Periodiškai užklausomis gaunami užduočių pakeitimai, taip pat pirkimo užsakymų ir atsargų duomenys.
- Apribojimų nustatymas SkyPlanner sistemoje. Operatoriai ir jų pamainos, paruošimo trukmės matrica, įrankiai ir alternatyvūs darbo centrai.
- Duomenų įrašymas atgal. Pasirinktiniai užduočių operacijų ir pačių užduočių laukai.
- Gamybos cecho duomenų perdavimas. Laiko apskaitos įrašai ir kiekiai perduodami į Fulcrum.
- Lygiagretus testavimas ir naudojimo pradžia. Naudokite SkyPlanner lygiagrečiai su Fulcrum tvarkaraščiu, palyginkite datas, pataisykite pagrindinius duomenis, o tada užduotis vykdyti perduokite pagal SkyPlanner tvarkaraštį.
Į ką atsižvelgti planuojant integraciją su Fulcrum
- Darbuotojų skaičius atsispindi pamainų nustatymuose. Fulcrum pamainos parametras Max Equipment „is usually determined by how many people you have working in a certain area at that time.“ (paprastai nustatomas pagal tai, kiek žmonių tuo metu dirba konkrečioje zonoje). Konkretūs operatoriai ir jų pamainos nustatomi SkyPlanner sistemoje. Jų vardai gaunami iš
/api/usersnaudotojų duomenų. - Užduotys planuojamos konkrečiai įrangai. Fulcrum darbo centrai yra tarpusavyje pakeičiamos įrangos grupės. Technologiniame maršrute tiksliai nurodykite tinkamą įrangą, nes būtent iš šių alternatyvų rinksis planavimo variklis.
- Gamybos užsakymai sujungia užduotis. Gamybos užsakymas sujungia kelių užduočių operacijas, pavyzdžiui, bendram detalių išdėstymui lakšte. Paleidus sugrupuotos operacijos laikmatį, vietoj jo paleidžiamas gamybos užsakymo laikmatis, apimantis visas grupės užduočių operacijas.
- Laiko apskaitos apribojimai. Atgaline data įrašomi
/api/timerslaiko intervalai „may not be in the future, older than 30 days, or longer than 7 days.“ (negali būti ateityje ar viršyti nurodytų senumo ir trukmės ribų). Perduokite darbo laiką iškart, kai operatoriai jį užregistruoja. - Laiko formatai skiriasi. Pamainoms naudojamas vietos laikas HHmm formatu, prastovoms ir suplanuotoms datoms – UTC, o numatoma operacijų trukmė pateikiama sekundėmis.
- Atnaujinant įrangos duomenis pakeičiamas visas įrašas. Įrangos PUT užklausa išvalo visus joje nepateiktus laukus. SkyPlanner įrangos duomenis tik skaito ir niekada jų nerašo.
- ITAR aplinkos. Naudokite
.usserverį ir ITAR prieigos raktą.
Kas konfigūruoja ir prižiūri integraciją su Fulcrum
Atliekant šiuos darbus susiejami jūsų padaliniai, darbo centrai, įranga ir technologiniai maršrutai. Taip pat nustatomi apribojimai, kurių duomenų Fulcrum nesaugo: konkretūs operatoriai, paruošimo trukmės matrica, įrankiai ir alternatyvūs ištekliai.
- SkyPlanner komanda integraciją sukonfigūruoja pradiniame diegimo etape ir prižiūri pradėjus ją naudoti. Kiekviena gamybos įmonė Fulcrum naudoja savaip, todėl čia pritaikomos žinios apie jūsų darbo specifiką.
- Integraciją gali sukurti jūsų Fulcrum konsultantas arba integravimo partneris. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir „webhook“ pranešimus.
- Sprendimą gali plėtoti ir jūsų programuotojai. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Produkto dokumentaciją, įskaitant pirkimo užsakymus ir produktų bei medžiagų API, rasite SkyPlanner dokumentacijoje.
SkyPlanner kaina prasideda nuo 199 € per mėnesį, įskaitant 5 darbo centrus, mokant kas mėnesį. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su plano kaina, todėl visas išlaidas žinote dar prieš pradėdami. Peržiūrėkite kainas, funkcijas ir palyginimą su pačios Fulcrum planavimo moduliu puslapyje Fulcrum gamybos planavimas pagal realius įrangos ir darbuotojų pajėgumus. Apžvalgą rasite Fulcrum puslapyje, o kitas ERP sistemas – ERP integracijų skiltyje.
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 skydai ir skirstomieji įrenginiai
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja užduočių 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ų.
99,2%pristatymo patikimumas
„SkyPlanner padėjo aiškiau matyti gamybos kliūtis ir suteikė daugiau aiškumo valdant gamybą.“
Toni Tuori, gamybos vadovas
Piristeel · Stogo saugos ir lietaus vandens nuvedimo sistemos
Šiemet pristatymo patikimumas pasiekė 99,2%, o sudarant gamybos tvarkaraščius sutaupoma iki keturių darbo valandų per dieną.
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 apdirbimas ir gamyba pagal užsakymą
Pristatymo patikimumas padidėjo nuo maždaug 50% iki net 98%, o gamybos tvarkaraščiams sudaryti dabar pakanka vieno meistro vietoj dviejų.
Dažniausiai užduodami klausimai
Ar Fulcrum turi API?
Taip. Fulcrum Public API yra REST API su OpenAPI v1 specifikacija. Autentifikavimui naudojamas Bearer prieigos raktas, sugeneruotas skiltyje Business Setup > System Data > Public Api. ITAR aplinkos naudoja atskirą .us serverį.
Ar SkyPlanner gali įrašyti tvarkaraštį atgal į Fulcrum?
Taip. Pačios Fulcrum suplanuotos datos yra tik skaitomos, todėl SkyPlanner įrašo planuojamą pradžią, pabaigą ir darbo centrą į kiekvienos užduoties operacijos pasirinktinius laukus, o planuojamą pabaigą – ir į pačią užduotį. Operatorių darbo laikas ir pagaminti kiekiai perduodami atgal kaip laiko apskaitos įrašai ir kiekių atnaujinimai.
Ar Fulcrum siunčia pakeitimus realiuoju laiku?
Fulcrum turi administratoriaus konfigūruojamus „webhook“ pranešimus, siunčiamus įvykus tokiems įvykiams kaip PurchaseOrderUpdated. Nebaigtų užduočių duomenys užklausomis tikrinami kas kelias minutes, naudojant tą patį filtrą kaip Fulcrum tvarkaraščio puslapyje. Pačios SkyPlanner „webhook“ pranešimai perduoda tvarkaraščio pakeitimus iškart, kai jie įvyksta.
Kas kuria integraciją su Fulcrum?
SkyPlanner komanda sukonfigūruoja dvikryptę integraciją pradiniame diegimo etape ir prižiūri ją pradėjus naudoti. Jūsų Fulcrum konsultantas, integravimo partneris ar jūsų programuotojai taip pat gali kurti sprendimą naudodami dokumentuotą SkyPlanner REST API.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti CSV duomenis iš Fulcrum. Kredito kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
