Integracije / ERP / Acumatica Cloud ERP
Vodnik za integracijo Acumatica s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako povezati Acumatica Cloud ERP (Manufacturing Edition) s SkyPlanner APS. Integracija med SkyPlanner in Acumatica deluje v obe smeri:
- V SkyPlanner se prenašajo proizvodni nalogi z operacijami, delovni centri, stroji, orodja, izmene, skladiščni artikli in nabavna naročila.
- Planirani datumi začetka in konca se zapišejo v operacije proizvodnega naloga, nalog pa se fiksira.
- Časovni zapisi operaterjev se vračajo kot knjižbe dela in premikov.
- SkyPlanner prek webhookov pošilja spremembe terminskega plana takoj, ko se zgodijo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši konfiguraciji sistema Acumatica in zanjo zagotavlja podporo tudi po prehodu v produkcijo. Ta vodnik je namenjen partnerjem in razvijalcem, ki želijo sodelovati ali sami razvijati rešitve na podlagi dokumentiranega vmesnika REST API sistema SkyPlanner (referenčna dokumentacija API).
Vmesniki za integracijo v sistemu Acumatica
Integracija uporablja vmesnike, ki so že vključeni v Acumatica. V instanco se nič ne namešča.
- Pogodbeno zasnovan REST API. Končne točke imajo različice, ki sledijo izdajam sistema. Končna točka Manufacturing (na primer 26.200.001 za 2026 R2) omogoča dostop do
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryinMaterialEntry. Končna točka Default pokrivaStockItem,PurchaseOrderinSalesOrder. URL-ji sledijo obliki{instance}/entity/{Endpoint}/{version}/{Entity}. - Dejanja na isti končni točki.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryinReleaseMaterialEntryizvajajo isto logiko kot gumbi na zaslonih. - OData. Vsako poizvedbo Generic Inquiry (SM208000) lahko izpostavite prek OData. Generic Inquiry z odprtimi proizvodnimi operacijami in datumi omogoča najhitrejše množično branje.
- Potisna obvestila (SM302000). Temeljijo na poizvedbi Generic Inquiry ali vgrajeni poizvedbi ter pošiljajo vstavljene in izbrisane vrstice na URL, ki ga nastavite.
- Scenariji uvoza in izvoza s ponudniki podatkov CSV in Excel za množično nalaganje.
Entitete in dejanja so navedeni na zaslonu Web Service Endpoints (SM207000) in v repozitoriju odjemalca REST za Acumatica.
Avtentikacija in omejitve
Acumatica uporablja OAuth 2.0 in OpenID Connect prek odjemalskih aplikacij, registriranih na zaslonu Connected Applications (SM303010). Dokumentirani tokovi so Authorization Code, Implicit, Resource Owner Password Credentials in Hybrid. Za strežniško integracijo registrirajte namenskega integracijskega uporabnika z vlogami, ki imajo le nujne pravice, in uporabite Authorization Code z osvežitvenim žetonom ali Resource Owner Password Credentials.
Zgornje meje določa vaša licenca: License Monitoring Console (SM604000) prikazuje dovoljeno število zahtev API na minuto in uporabnikov API.
Na strani sistema SkyPlanner se za avtentikacijo vmesnika REST API uporablja žeton API (SkyPlanner Settings > API), dokumentacija pa je na voljo v Swagger/OpenAPI. Vodič za integracijo vas popelje skozi prve klice.
Preslikava podatkov
| Objekt v sistemu Acumatica (končna točka / obrazec) | Objekt v sistemu SkyPlanner | Smer | Pogostost |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Izdelki in materiali | Acumatica → SkyPlanner | Začetno nalaganje, nato le spremembe |
BillOfMaterial (AM208000): materiali, operacije | Struktura izdelka, podizdelki, materiali za posamezen izdelek | Acumatica → SkyPlanner | Začetno nalaganje, nato ob spremembah |
| Operacije BOM: Setup, Run, Machine, Queue, Finish, Move Time | Procesni koraki s trajanjem ter časi priprave in pospravljanja | Acumatica → SkyPlanner | Začetno nalaganje, nato ob spremembah |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Delovni centri, skupine delovnih centrov, učinkovitosti, alternativni delovni centri | Acumatica → SkyPlanner | Začetno nalaganje, pozneje redko |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Izmene in kadrovske zmogljivosti | Acumatica → SkyPlanner | Dnevno ali vzdrževanje izmen v sistemu SkyPlanner |
Tool (AM205500) | Orodja kot viri z omejeno zmogljivostjo | Acumatica → SkyPlanner | Začetno nalaganje |
ProductionOrder z OrderOperationDetail (Planned, Released, In Process) | Nalogi in opravila z roki, prioritetami izvajanja in potrebami po materialu | Acumatica → SkyPlanner | Potisno obvestilo ali poizvedovanje vsakih nekaj minut |
Postavke PurchaseOrder (Default) | Nabavna naročila s predvidenim datumom dobave | Acumatica → SkyPlanner | Poizvedovanje vsako uro ali ob zagonu terminiranja |
| Količine artiklov v skladiščih | Stanje zalog | Acumatica → SkyPlanner | Poizvedovanje vsako uro ali ob zagonu terminiranja |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Planirani začetek, konec in delovni center za posamezno operacijo | SkyPlanner → Acumatica | Ob spremembi terminskega plana prek webhooka sistema SkyPlanner |
Dejanje FirmProductionOrder | Zaklene zapisane datume, da jih Acumatica APS ne more spreminjati | SkyPlanner → Acumatica | Po vsakem povratnem zapisu |
LaborEntry, MoveEntry z dejanji za sprostitev | Časovni zapisi, izdelane količine, potrditve operaterjev | SkyPlanner → Acumatica | Ob vsaki potrditvi ali za vsako izmeno |
| Ni v sistemu Acumatica | Matrika pripravljalnih časov, poimensko določeni operaterji, opravila z več operaterji | Vzdrževanje v sistemu SkyPlanner | Nastavitev med uvajanjem |
Vzorci integracije
1. Začetno nalaganje matičnih podatkov. Najprej preberite delovne centre, stroje, orodja, izmene in koledarje. Nato preberite skladiščne artikle in kosovnice. Določite, kako boste preslikali delovni center z več stroji: v eno skupino delovnih centrov, v kateri je vsak stroj delovni center, ali v en sam delovni center. Polje Basis for Capacity v sistemu Acumatica pokaže, kateri pristop uporablja proizvodni obrat.
2. Sinhronizacija nalogov. Proizvodne naloge z operacijami berite iz naloga, ne iz BOM. Operacije se kopirajo v nalog, planerji pa jih nato spreminjajo tam. Za Generic Inquiry z odprtimi nalogi in operacijami nastavite potisna obvestila ali jo periodično preverjajte. Preberite tudi odprte postavke nabavnih naročil. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko naročilo dobi oznako Delivered.
3. Povratni zapis terminskega plana. Za vsako operacijo, ki jo je mehanizem razporedil ali premaknil, SkyPlanner zapiše StartDate in EndDate v OrderOperationDetail. Če je bilo delo prestavljeno na alternativni delovni center, zapiše tudi tega. Nato pokliče FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Ko zaženete terminiranje proizvodnih nalogov z upoštevanjem omejenih zmogljivosti, sistem fiksiranih proizvodnih nalogov ne terminira ponovno.) (vir)
4. Potrditve iz proizvodnje. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer. Iz časovnih zapisov nastanejo dokumenti LaborEntry (čas in izdelana količina za posamezno operacijo) ali MoveEntry (samo količina), ki se sprostijo z ustreznim dejanjem. Če v proizvodnji že poročate v Acumatica prek Labor (AM301000) ali Shop Floor Kiosk, se podatki o napredku prenašajo v nasprotni smeri. Izberite en kanal, nikoli obeh.
5. Pravila o skrbništvu podatkov in reševanju neskladij. Zapišite jih pred prehodom v produkcijo:
| Podatki | Skrbniški sistem |
|---|---|
| Skladiščni artikli, kosovnice, količine, status nalogov, obračun stroškov | Acumatica |
| Zaporedje operacij, časi začetka in konca, dodelitev delovnih centrov | SkyPlanner |
| Matrika pripravljalnih časov, orodja, zahteve glede operaterjev, alternative | SkyPlanner |
| Izmene in odsotnosti | En sistem, izbran pri opredelitvi obsega |
| Transakcije dela in premikov | Acumatica; knjiženje iz časovnih zapisov SkyPlanner ali vnos v proizvodnji |
Glavni vir navzkrižij je lastni APS sistema Acumatica. Rough Cut Planning ali APS Maintenance Process lahko znova izračuna datume nalogov, ki jih je terminiral SkyPlanner. To preprečite tako, da po vsakem zapisu nalog fiksirate. Terminirane naloge izključite tudi iz obdelav APS.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko v 30-dnevnem brezplačnem preizkusu uporabite svoje podatke. Iz poizvedbe Generic Inquiry izvozite delovne centre in odprte proizvodne naloge z operacijami v Excel, jih uvozite in preverite terminski plan.
- Preslikava. Določite tabelo preslikav, pravila o tem, kateri sistem je pristojen za posamezne podatke, pogostost sinhronizacije in kanal za knjiženje dela.
- Dostop. Registrirajte povezano aplikacijo, ustvarite uporabnika in vloge za integracijo ter na zaslonu Web Service Endpoints potrdite različico končne točke. Najprej v preizkusnem okolju.
- Začetni uvoz. Delovni centri, stroji, orodja, izmene, zalogovni artikli in kosovnice.
- Sinhronizacija nalogov in naročil. Proizvodni nalogi, operacije in nabavna naročila prek potisnih obvestil ali periodičnega poizvedovanja.
- Nastavitev omejitev v SkyPlanner. Matrika pripravljalnih časov, poimensko določeni operaterji, opravila z več operaterji in alternative.
- Povratni zapis. Datumi operacij, fiksiranje nalogov ter knjižbe dela ali premikov.
- Vzporedno delovanje. Primerjajte datume iz SkyPlanner s trenutnim planom in popravite matične podatke.
- Prehod v produkcijo. Ko se podatki ujemajo, vklopite povratni zapis.
Kaj upoštevati pri integraciji s sistemom Acumatica
- Preverite, kateri pogon APS je vklopljen. Classic in Optimized shranjujeta nastavitve ločeno, omogočen pa je lahko le eden. Pred prvim povratnim zapisom preverite nastavitve na zaslonu Enable/Disable Features (CS100000).
- Fiksirajte različico končne točke. Različica je del URL-ja. Nadgradnja doda novo različico, zato ob vsaki nadgradnji ponovite preizkuse.
- Posodabljanje operacij. Nekatera polja operacij so prek REST na voljo le za branje, pomemben pa je tudi status naloga. V preizkusnem okolju preverite zaporedje povratnega zapisovanja za naloge s statusoma Released in In Process.
- Enote in časovna polja. Čas izvajanja je podan glede na Run Units, strojni čas pa glede na Machine Units. Čakalni čas in čas premika “affect the calculated schedule but do not occupy work center capacity.” (vplivata na izračunani terminski plan, vendar ne zasedata zmogljivosti delovnega centra). Pri uvozu pazite na pretvorbe.
- Razpoložljivost materiala. Classic APS zahteva, da je ves material na voljo v celoti. SkyPlanner pri planiranju upošteva zalogo in pričakovane dobave po nabavnih naročilih glede na datume. Dogovorite se, katere rezultate bodo upoštevali planerji.
- Omejitve API. Dovoljeno število zahtevkov na minuto je odvisno od licence. Berite le spremembe in uporabljajte potisna obvestila namesto ponovnega nalaganja vseh podatkov.
Kdo nastavi integracijo s sistemom Acumatica in zagotavlja podporo
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in zanjo zagotavlja podporo po prehodu v produkcijo. Vsak obrat uporablja sistem Acumatica drugače, zato pri nastavitvi upoštevamo te posebnosti.
- Sodeluje lahko tudi vaš partner za Acumatica. Partner pozna vaše prilagoditve, poizvedbe Generic Inquiries in vloge. SkyPlanner zagotavlja REST API, dokumentacijo Swagger/OpenAPI in spletne kavlje.
- Integracijo lahko razvijejo tudi vaši razvijalci, ki uporabijo isti REST API z žetonom API. Za začetek zadošča žeton API, ekipa SkyPlanner pa po potrebi pomaga. To pot je pri sistemu SAP Business One izbralo podjetje Laboratory & Allied: njihova interna ekipa IT je integracijo večinoma razvila sama, ob pomoči ekipe SkyPlanner.
Cena za SkyPlanner se začne pri 199 € na mesec, vključuje 5 delovnih centrov in se obračunava mesečno. Ponudbo za integracijo pripravimo vnaprej glede na vaše procese in potrebe, skupaj z vašim paketom, zato celoten strošek poznate že pred začetkom. Primerjavo z lastnim APS sistema Acumatica najdete na strani Terminiranje proizvodnje z upoštevanjem zmogljivosti v sistemu Acumatica, pregled na strani Acumatica, druge sisteme pa v pregledu integracij ERP.
Mnenja proizvodnih podjetij o SkyPlannerju
2 hprihranka vsak teden
»S SkyPlannerjem smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, specialist za dobavno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri delovnega časa, nov vrstni red dela pa proizvodna linija prejme v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
Več 1.000samodejno terminiranih delovnih nalogov
»Proizvodnjo imamo pod nadzorom na drugačen način, naše razumevanje zmogljivosti pa je na povsem drugi ravni.«
Hannu Ryynänen, direktor
Mamec · Industrijski mešalniki, črpalke in visokotehnološka pogodbena proizvodnja
Na tisoče delovnih nalogov se terminira samodejno, celotna organizacija pa ima vpogled v proizvodnjo v realnem času.
99,2%zanesljivost dobav
»S SkyPlannerjem lažje prepoznavamo ozka grla, vodenje proizvodnje pa je preglednejše.«
Toni Tuori, vodja proizvodnje
Piristeel · Strešna varnostna oprema in sistemi za odvajanje deževnice
Zanesljivost dobav je letos dosegla 99,2%, pri terminiranju pa vsak dan prihranijo do štiri ure delovnega časa.
Pogosta vprašanja
Ali API sistema Acumatica vključuje proizvodne naloge?
Da. Končna točka Manufacturing v pogodbeno zasnovanem REST API omogoča dostop do objektov ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool ter knjižb dela in premikov, pa tudi do dejanj, kot je FirmProductionOrder.
Kdo vzpostavi integracijo s sistemom Acumatica?
Ekipa SkyPlanner med uvajanjem nastavi dvosmerno integracijo glede na vašo konfiguracijo sistema Acumatica in zanjo zagotavlja podporo po prehodu v produkcijo. Integracijo lahko prek dokumentiranega REST API sistema SkyPlanner razvije tudi vaš partner za Acumatica ali vaši razvijalci. Za začetek zadošča žeton API.
Ali za to integracijo potrebujemo Acumatica APS?
Ne. Acumatica izvaja terminiranje z upoštevanjem razpoložljivih zmogljivosti prek obrazca Rough Cut Planning, Classic APS pa naloge, ki se končajo čez več kot 120 dni, planira brez omejitev zmogljivosti (vir). SkyPlanner sam izdela podroben terminski plan ob upoštevanju razpoložljivih zmogljivosti na podlagi proizvodnih nalogov, operacij, delovnih centrov, strojev in orodij. Integracija zato deluje ne glede na to, ali je omogočen APS, za katerega Acumatica navaja, da “is subject to licensing” (je zanj potrebna licenca). Autopilot ohranja terminski plan ažuren, operaterji pa beležijo delo s funkcijo Mobile Confirmations.
Kako preprečimo, da bi Acumatica APS prepisal datume iz SkyPlannerja?
SkyPlanner po zapisu datumov operacij fiksira vsak proizvodni nalog. Terminiranje z upoštevanjem razpoložljivih zmogljivosti v sistemu Acumatica fiksiranih nalogov ne terminira ponovno.
Ali lahko Acumatica pošilja spremembe v realnem času?
Da. Potisna obvestila (SM302000) za poizvedbo Generic Inquiry pošljejo spremenjene vrstice na URL takoj ob spremembi. Lastni spletni kavlji sistema SkyPlanner pošiljajo spremembe terminskega plana v nasprotno smer.
Kateri način avtentikacije naj uporablja integracija?
OAuth 2.0 prek odjemalca, registriranega na zaslonu Connected Applications (SM303010), z namenskim uporabnikom za integracijo in vlogami z najmanjšimi potrebnimi pravicami. Potek za vašo instanco potrdimo med opredelitvijo obsega.
Ali lahko SkyPlanner preizkusimo pred vzpostavitvijo integracije?
Da. 30-dnevni brezplačni preizkus podpira do 20 delovnih centrov z uvozom datotek Excel ali CSV iz poizvedbe Generic Inquiry v sistemu Acumatica. Kreditna kartica ni potrebna. Začnite preizkus ali stopite v stik s prodajo, da opredelite obseg integracije.
