Integracijos / ERP / Acumatica Cloud ERP
Acumatica integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame Acumatica integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti Acumatica Cloud ERP (Manufacturing Edition) su SkyPlanner APS. SkyPlanner ir Acumatica duomenimis keičiasi abiem kryptimis:
- Į SkyPlanner perduodami gamybos užsakymai su operacijomis, darbo centrai, įrenginiai, įrankiai, pamainos, sandėliuojamos prekės ir pirkimo užsakymai.
- Į gamybos užsakymo operacijas įrašomos suplanuotos pradžios ir pabaigos datos, o užsakymo planas užfiksuojamas.
- Operatorių darbo laiko įrašai grąžinami kaip darbo ir perkėlimo įrašai.
- SkyPlanner siunčia pranešimus per webhook sąsajas vos pasikeitus tvarkaraščiui.
Diegimo metu SkyPlanner komanda pritaiko integraciją prie jūsų Acumatica konfigūracijos ir prižiūri ją pradėjus eksploatuoti. Šis vadovas skirtas partneriams ir programuotojams, norintiems prisidėti prie integravimo arba patiems kurti sprendimus naudojantis dokumentuota SkyPlanner REST API (API dokumentacija).
Acumatica integravimo sąsajos
Integracija naudoja sąsajas, kurios jau yra Acumatica sistemoje. Į jūsų sistemos egzempliorių nieko diegti nereikia.
- Sutartimis pagrįsta REST API. Galiniai taškai turi versijas, suderintas su sistemos leidimais. Per Manufacturing galinį tašką (pavyzdžiui, 26.200.001, skirtą 2026 R2) pasiekiami
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryirMaterialEntry. Per Default galinį tašką pasiekiamiStockItem,PurchaseOrderirSalesOrder. URL struktūra:{instance}/entity/{Endpoint}/{version}/{Entity}. - Veiksmai per tą patį galinį tašką.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryirReleaseMaterialEntryvykdo tą pačią logiką kaip atitinkami mygtukai sistemos languose. - OData. Bet kurią Generic Inquiry (SM208000) užklausą galima pasiekti per OData. Greičiausias būdas masiškai nuskaityti duomenis – Generic Inquiry užklausa, apimanti nebaigtas gamybos operacijas ir jų datas.
- Tiesioginiai pranešimai (SM302000). Jie grindžiami Generic Inquiry arba integruota užklausa ir siunčia pridėtas bei ištrintas eilutes jūsų nurodytu URL.
- Importavimo ir eksportavimo scenarijai su CSV ir Excel duomenų teikėjais masiniam duomenų įkėlimui.
Objektai ir veiksmai pateikti lange Web Service Endpoints (SM207000) ir Acumatica REST kliento saugykloje.
Autentifikavimas ir apribojimai
Acumatica naudoja OAuth 2.0 ir OpenID Connect per klientų programas, užregistruotas lange Connected Applications (SM303010). Dokumentacijoje aprašytos Authorization Code, Implicit, Resource Owner Password Credentials ir Hybrid autentifikavimo sekos. Serverinei integracijai užregistruokite atskirą integracijos naudotoją, kuriam priskirti vaidmenys suteiktų tik būtinas teises, ir naudokite Authorization Code su atnaujinimo žetonu arba Resource Owner Password Credentials.
Apribojimus nustato jūsų licencija: lange License Monitoring Console (SM604000) rodomas leidžiamas API užklausų per minutę ir API naudotojų skaičius.
SkyPlanner REST API autentifikavimui naudoja API žetoną (SkyPlanner Settings > API), o jos dokumentacija pateikta Swagger/OpenAPI formatu. Integravimo pamokoje paaiškinama, kaip atlikti pirmąsias užklausas.
Duomenų susiejimas
| Acumatica objektas (galinis taškas / forma) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Gaminiai ir medžiagos | Acumatica → SkyPlanner | Pradinis įkėlimas, vėliau – tik pakeitimai |
BillOfMaterial (AM208000): medžiagos, operacijos | Gaminio struktūra, pusgaminiai, kiekvienam gaminiui reikalingos medžiagos | Acumatica → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| BOM operacijos: Setup, Run, Machine, Queue, Finish, Move Time | Proceso žingsniai su trukme, paruošimo ir užbaigimo laiku | Acumatica → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Darbo centrai, jų grupės, efektyvumo rodikliai, alternatyvūs darbo centrai | Acumatica → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Pamainos ir darbuotojų pajėgumai | Acumatica → SkyPlanner | Kasdien arba pamainos tvarkomos SkyPlanner sistemoje |
Tool (AM205500) | Įrankiai kaip riboto prieinamumo ištekliai | Acumatica → SkyPlanner | Pradinis įkėlimas |
ProductionOrder su OrderOperationDetail (Planned, Released, In Process) | Užsakymai ir darbai su terminais, vykdymo prioritetais ir medžiagų poreikiais | Acumatica → SkyPlanner | Tiesioginiai pranešimai arba periodinės užklausos kas kelias minutes |
PurchaseOrder eilutės (Default) | Pirkimo užsakymai su numatoma pristatymo data | Acumatica → SkyPlanner | Užklausos kas valandą arba sudarant tvarkaraštį |
| Prekių kiekiai sandėliuose | Atsargų likučiai | Acumatica → SkyPlanner | Užklausos kas valandą arba sudarant tvarkaraštį |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Kiekvienos operacijos suplanuota pradžia, pabaiga ir darbo centras | SkyPlanner → Acumatica | Pasikeitus tvarkaraščiui, per SkyPlanner webhook |
Veiksmas FirmProductionOrder | Neleidžia Acumatica APS keisti įrašytų datų | SkyPlanner → Acumatica | Po kiekvieno grįžtamojo įrašymo |
LaborEntry, MoveEntry su registravimo veiksmais | Darbo laiko įrašai, pagaminti kiekiai, operatorių patvirtinimai | SkyPlanner → Acumatica | Po kiekvieno patvirtinimo arba kiekvieną pamainą |
| Acumatica sistemoje nėra | Paruošimo laikų matrica, konkretūs operatoriai, kelių operatorių atliekami darbai | Tvarkoma SkyPlanner sistemoje | Sukonfigūruojama diegimo metu |
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. Pirmiausia nuskaitykite darbo centrus, įrenginius, įrankius, pamainas ir kalendorius. Tada nuskaitykite sandėliuojamas prekes ir gaminių specifikacijas. Nuspręskite, kaip susieti darbo centrą, kuriame yra keli įrenginiai: su viena darbo centrų grupe, kurioje kiekvienas įrenginys yra atskiras darbo centras, ar su vienu darbo centru. Acumatica nustatymas Basis for Capacity parodo, kurį modelį taiko gamykla.
2. Užsakymų sinchronizavimas. Gamybos užsakymus ir jų operacijas nuskaitykite iš užsakymo, o ne iš BOM. Operacijos nukopijuojamos į užsakymą, ir planuotojai jas keičia būtent ten. Sukonfigūruokite tiesioginius pranešimus pagal nebaigtų užsakymų ir operacijų Generic Inquiry užklausą arba periodiškai ją vykdykite. Taip pat nuskaitykite neįvykdytas pirkimo užsakymų eilutes. SkyPlanner laiko, kad užsakytos medžiagos bus prieinamos pirkimo užsakymo pristatymo dieną, ir atnaujina atsargų likučius, kai pirkimo užsakymas pažymimas būsena Delivered.
3. Tvarkaraščio grįžtamasis įrašymas. Kiekvienai operacijai, kurią planavimo variklis suplanavo arba perkėlė, SkyPlanner įrašo StartDate ir EndDate į OrderOperationDetail. Jei darbas perkeltas į alternatyvų darbo centrą, įrašomas ir darbo centras. Tada iškviečiamas FirmProductionOrder. Acumatica: „When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Sudarant gamybos užsakymų planą pagal realius įrenginių ir darbuotojų pajėgumus, sistema neperplanuoja užsakymų, kurių planas užfiksuotas.) (šaltinis)
4. Patvirtinimai iš gamybos cecho. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer. Darbo laiko įrašai tampa LaborEntry dokumentais (kiekvienos operacijos laikas ir pagamintas kiekis) arba MoveEntry dokumentais (tik kiekis), kurie registruojami atitinkamu veiksmu. Jei gamybos cechas jau teikia duomenis Acumatica sistemoje per Labor (AM301000) arba Shop Floor Kiosk, eigos duomenys perduodami priešinga kryptimi. Pasirinkite vieną kanalą, niekada nenaudokite abiejų.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami eksploatuoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Sandėliuojamos prekės, gaminių specifikacijos, kiekiai, užsakymų būsenos, savikainos skaičiavimas | Acumatica |
| Operacijų seka, pradžios ir pabaigos laikas, darbo centro priskyrimas | SkyPlanner |
| Paruošimo laikų matrica, įrankiai, reikalavimai operatoriams, alternatyvos | SkyPlanner |
| Pamainos ir neatvykimai | Viena sistema, pasirinkta apibrėžiant apimtį |
| Darbo ir perkėlimo operacijos | Acumatica; registruojama pagal SkyPlanner darbo laiko įrašus arba įvedama gamybos ceche |
Pagrindinis konfliktų šaltinis – pačios Acumatica APS. Rough Cut Planning arba APS Maintenance Process gali perskaičiuoti užsakymų, kuriems SkyPlanner jau sudarė tvarkaraštį, datas. Užfiksavus kiekvieną įrašytą užsakymą, to išvengiama. Šių užsakymų taip pat neįtraukite į APS skaičiavimus.
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo įvadinio parengimo pradžios. Prieš tai galite 30 dienų nemokamai išbandyti sistemą su savo duomenimis. Iš Generic Inquiry eksportuokite darbo centrus ir nebaigtus gamybos užsakymus su jų operacijomis į Excel, importuokite juos ir patikrinkite tvarkaraštį.
- Duomenų susiejimas. Nustatykite susiejimo lentelę, taisykles, kuri sistema valdo konkrečius duomenis, sinchronizavimo dažnį ir darbo laiko įrašų perdavimo kanalą.
- Prieiga. Užregistruokite prijungtą programą, sukurkite integracijai skirtą naudotoją bei vaidmenis ir patikrinkite galinio taško versiją lange Web Service Endpoints. Pradėkite nuo bandomosios aplinkos.
- Pradinis duomenų įkėlimas. Darbo centrai, įrenginiai, įrankiai, pamainos, sandėliuojamos prekės ir gaminių specifikacijos.
- Užsakymų sinchronizavimas. Gamybos užsakymai, operacijos ir pirkimo užsakymai perduodami siunčiamaisiais pranešimais arba gaunami periodinėmis užklausomis.
- Apribojimų nustatymas SkyPlanner sistemoje. Paruošimo trukmių matrica, konkretūs operatoriai, darbai, kuriems reikia kelių operatorių, ir alternatyvos.
- Duomenų įrašymas atgal. Operacijų datos, užsakymų fiksavimas ir darbo laiko arba perkėlimo įrašai.
- Lygiagretus veikimas. Palyginkite SkyPlanner nustatytas datas su dabartiniu planu ir pataisykite pagrindinius duomenis.
- Darbo pradžia. Kai duomenys sutampa, įjunkite duomenų įrašymą atgal.
Į ką atsižvelgti planuojant integraciją su Acumatica
- Patikrinkite, kuris APS variklis įjungtas. Classic ir Optimized nuostatas saugo atskirai, o įjungtas gali būti tik vienas iš jų. Prieš pirmą kartą įrašydami duomenis atgal, patikrinkite Enable/Disable Features (CS100000).
- Užfiksuokite galinio taško versiją. Versija yra URL dalis. Atnaujinus sistemą pridedama nauja versija, todėl po kiekvieno atnaujinimo testuokite iš naujo.
- Operacijų atnaujinimas. Kai kuriuos operacijų laukus per REST galima tik skaityti, taip pat svarbi užsakymo būsena. Bandomojoje aplinkoje patikrinkite duomenų įrašymo atgal seką užsakymams, kurių būsena yra Released ir In Process.
- Vienetai ir laiko laukai. Vykdymo laikas nurodomas pagal Run Units, o įrenginio darbo laikas – pagal Machine Units. Laukimo eilėje ir perkėlimo laikas „affect the calculated schedule but do not occupy work center capacity.“ (daro įtaką apskaičiuotam tvarkaraščiui, tačiau neužima darbo centro pajėgumų). Importuodami atidžiai perskaičiuokite reikšmes.
- Medžiagų prieinamumo vertinimas. Classic APS reikalauja, kad būtų prieinamas visas reikalingas visų medžiagų kiekis. SkyPlanner planuoja pagal atsargas ir numatomas pirkimo užsakymų pristatymo datas. Sutarkite, kurios sistemos vertinimu vadovausis planuotojai.
- API apribojimai. Užklausų per minutę skaičių nustato licencija. Naudokite tik pasikeitusių duomenų nuskaitymą ir siunčiamuosius pranešimus, o ne pakartotinį visų duomenų įkėlimą.
Kas konfigūruoja ir prižiūri integraciją su Acumatica
- SkyPlanner komanda sukonfigūruoja integraciją įvadinio parengimo metu ir teikia pagalbą pradėjus dirbti. Kiekviena gamykla Acumatica naudoja savaip, todėl čia pritaikoma sukaupta praktinė patirtis.
- Gali dalyvauti ir jūsų Acumatica partneris. Partneris žino jūsų sistemos pritaikymus, Generic Inquiries ir vaidmenis. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir webhooks.
- Jūsų programuotojai taip pat gali kurti integraciją naudodami tą pačią REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Šį kelią pasirinko Laboratory & Allied, naudojanti SAP Business One: įmonės IT komanda integraciją iš esmės sukūrė savarankiškai, padedama SkyPlanner.
SkyPlanner kaina prasideda nuo 199 € per mėnesį, įskaitant 5 darbo centrus; mokama kas mėnesį. Integracijos kaina pagal jūsų procesus ir poreikius pateikiama iš anksto kartu su pasirinktu planu, todėl visas išlaidas žinosite dar prieš pradėdami. Kaip šis sprendimas skiriasi nuo pačios Acumatica APS, skaitykite puslapyje Gamybos planavimas su Acumatica pagal realius pajėgumus. Apžvalgą rasite Acumatica puslapyje, o kitas sistemas – ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„SkyPlanner padėjo mums pereiti nuo gamybos planavimo Excel lentelėse prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros 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ų.
1 000-iais skaičiuojami gamybos užsakymai automatiškai įtraukiami į tvarkaraštį
„Gamybą dabar valdome visai kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoninės maišyklės, siurbliai ir aukštųjų technologijų sutartinė gamyba
Tūkstančiai darbo užsakymų automatiškai įtraukiami į tvarkaraštį, o visa organizacija gamybos eigą mato realiuoju laiku.
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ą.
Dažniausiai užduodami klausimai
Ar per Acumatica API pasiekiami gamybos užsakymai?
Taip. Sutartimi pagrįstos REST API galinis taškas Manufacturing suteikia prieigą prie ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool, darbo laiko ir perkėlimo įrašų, taip pat veiksmų, tokių kaip FirmProductionOrder.
Kas kuria integraciją su Acumatica?
SkyPlanner komanda įvadinio parengimo metu sukonfigūruoja abipusę integraciją pagal jūsų Acumatica konfigūraciją ir teikia pagalbą pradėjus dirbti. Jūsų Acumatica partneris arba jūsų programuotojai taip pat gali kurti integraciją naudodami dokumentuotą SkyPlanner REST API – pradžiai pakanka API prieigos rakto.
Ar šiai integracijai reikia Acumatica APS?
Ne. Pačioje Acumatica gamybos planavimas pagal realius pajėgumus vykdomas formoje Rough Cut Planning, o Classic APS užsakymus, kurių pabaiga numatyta vėliau nei po 120 dienų, planuoja neribodama pajėgumų (šaltinis). SkyPlanner pati sudaro detalų tvarkaraštį pagal realius pajėgumus, remdamasi gamybos užsakymais, operacijomis, darbo centrais, įrenginiais ir įrankiais. Todėl integracija veikia nepriklausomai nuo to, ar įjungta APS, kuri, kaip nurodo Acumatica, „is subject to licensing“ (licencijuojama). Autopilot nuolat atnaujina tvarkaraštį, o operatoriai registruoja darbą naudodami Mobile Confirmations.
Kaip neleisti Acumatica APS perrašyti SkyPlanner nustatytų datų?
Įrašiusi operacijų datas, SkyPlanner užfiksuoja kiekvieną gamybos užsakymą. Planuodama pagal realius pajėgumus, Acumatica užfiksuotų užsakymų neperplanuoja.
Ar Acumatica gali siųsti pakeitimus realiuoju laiku?
Taip. Generic Inquiry užklausai sukonfigūruoti Push notifications (SM302000) siunčia pasikeitusias eilutes nurodytu URL vos joms pasikeitus. Pačios SkyPlanner webhooks siunčia tvarkaraščio pakeitimus priešinga kryptimi.
Kokį tapatumo patvirtinimo būdą naudoti integracijai?
Naudokite OAuth 2.0 su klientu, užregistruotu lange Connected Applications (SM303010), integracijai skirtu naudotoju ir vaidmenimis, suteikiančiais tik būtinas teises. Jūsų sistemos egzemplioriui tinkama eiga patvirtinama apibrėžiant apimtį.
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š Acumatica Generic Inquiry per Excel arba CSV failus. Kredito kortelės nereikia. Išbandykite nemokamai arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
