Liidestused / ERP / Acumatica Cloud ERP
Acumatica liidestamise juhend: tootmise ajakava koostamine SkyPlanner APS-iga
See Acumatica liidestamise juhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Acumatica Cloud ERP (Manufacturing Edition) SkyPlanner APS-iga. SkyPlanneri ja Acumatica vaheline andmevahetus on kahesuunaline:
- SkyPlannerisse jõuavad tootmistellimused koos operatsioonidega, töökeskused, masinad, tööriistad, vahetused, laoartiklid ja ostutellimused.
- Planeeritud algus- ja lõppkuupäevad kirjutatakse tootmistellimuse operatsioonidele ning tellimus kinnistatakse.
- Operaatorite ajakirjed saadetakse tagasi tööaja- ja liikumiskannetena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus teie Acumatica seadistuse järgi ja pakub tuge ka pärast käivitamist. See juhend on partneritele ja arendajatele, kes soovivad töös osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
Acumatica integratsiooniliidesed
Liidestus kasutab Acumatica olemasolevaid liideseid. Acumatica instantsi ei paigaldata midagi.
- Lepingupõhine REST API. Lõpp-punktidel on versioonid, mis vastavad tarkvaraväljalaskele. Lõpp-punkt Manufacturing (näiteks 26.200.001 väljalaske 2026 R2 puhul) võimaldab kasutada objekte
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryjaMaterialEntry. Lõpp-punkt Default hõlmab objekteStockItem,PurchaseOrderjaSalesOrder. URL-ide kuju on{instance}/entity/{Endpoint}/{version}/{Entity}. - Sama lõpp-punkti toimingud.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryjaReleaseMaterialEntrykäivitavad sama loogika nagu vastavad nupud kasutajaliideses. - OData. Iga Generic Inquiry (SM208000) päringu saab OData kaudu kättesaadavaks teha. Kiireim viis andmeid hulgi lugeda on Generic Inquiry päring, mis tagastab avatud tootmisoperatsioonid koos kuupäevadega.
- Tõuketeated (SM302000). Need põhinevad Generic Inquiry päringul või sisseehitatud päringul ning saadavad lisatud ja kustutatud read teie määratud URL-ile.
- Impordi- ja ekspordistsenaariumid CSV ja Exceli andmepakkujatega andmete hulgilaadimiseks.
Objektid ja toimingud on loetletud vormil Web Service Endpoints (SM207000) ning Acumatica REST-kliendi repositooriumis.
Autentimine ja piirangud
Acumatica kasutab OAuth 2.0 ja OpenID Connecti vormil Connected Applications (SM303010) registreeritud klientrakenduste kaudu. Dokumenteeritud autentimisvood on Authorization Code, Implicit, Resource Owner Password Credentials ja Hybrid. Serveriliidestuse jaoks registreerige eraldi integratsioonikasutaja, kelle rollid annavad vaid minimaalsed vajalikud õigused. Kasutage kas Authorization Code’i koos värskendustõendiga või Resource Owner Password Credentialsi.
Piirangud määrab teie litsents: License Monitoring Console (SM604000) näitab lubatud API-päringute arvu minutis ja API-kasutajate arvu.
SkyPlanneri REST API kasutab autentimiseks API-pääsutõendit (SkyPlanner Settings > API) ja on dokumenteeritud Swagger/OpenAPI vormingus. Liidestamise õpetus selgitab, kuidas teha esimesed päringud.
Andmete vastendamine
| Acumatica objekt (lõpp-punkt / vorm) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Tooted ja materjalid | Acumatica → SkyPlanner | Esmane laadimine, seejärel muudatused |
BillOfMaterial (AM208000): materjalid, operatsioonid | Toote struktuur, alamtooted, materjalid toote kohta | Acumatica → SkyPlanner | Esmane laadimine, seejärel muudatuse korral |
| BOM-i operatsioonid: Setup, Run, Machine, Queue, Finish, Move Time | Protsessietapid koos kestuse, seadistus- ja lõpetusaegadega | Acumatica → SkyPlanner | Esmane laadimine, seejärel muudatuse korral |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Töökeskused, töökeskuste rühmad, efektiivsusnäitajad, alternatiivsed töökeskused | Acumatica → SkyPlanner | Esmane laadimine, edaspidi harva |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Vahetused ja töötajate töövõimsus | Acumatica → SkyPlanner | Iga päev või hallatakse vahetusi SkyPlanneris |
Tool (AM205500) | Tööriistad kui piiratud ressursid | Acumatica → SkyPlanner | Esmane laadimine |
ProductionOrder koos objektiga OrderOperationDetail (Planned, Released, In Process) | Tellimused ja tööd koos tähtaegade, täitmisprioriteedi ja materjalivajadusega | Acumatica → SkyPlanner | Tõuketeade või päring iga mõne minuti järel |
PurchaseOrder read (Default) | Ostutellimused koos eeldatava tarnekuupäevaga | Acumatica → SkyPlanner | Päring kord tunnis või ajakava koostamise käivitamisel |
| Artiklite kogused ladudes | Laoseisud | Acumatica → SkyPlanner | Päring kord tunnis või ajakava koostamise käivitamisel |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Iga operatsiooni planeeritud algus, lõpp ja töökeskus | SkyPlanner → Acumatica | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
Toiming FirmProductionOrder | Lukustab salvestatud kuupäevad, et Acumatica APS neid ei muudaks | SkyPlanner → Acumatica | Pärast iga tagasikirjutust |
LaborEntry, MoveEntry koos vabastamistoimingutega | Ajakirjed, valminud kogused, operaatorite kinnitused | SkyPlanner → Acumatica | Iga kinnituse korral või kord vahetuses |
| Acumaticas puudub | Seadistusaegade maatriks, nimelised operaatorid, mitme operaatoriga tööd | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Liidestuse töövood
1. Põhiandmete esmane laadimine. Lugege esmalt töökeskuste, masinate, tööriistade, vahetuste ja kalendrite andmed. Seejärel lugege laoartiklid ja tootespetsifikatsioonid. Otsustage, kuidas vastendada mitme masinaga töökeskus: kas ühe töökeskuste rühmana, kus iga masin on omaette töökeskus, või ühe töökeskusena. Acumatica väli Basis for Capacity näitab, millist lähenemist tehas kasutab.
2. Tellimuste sünkroonimine. Lugege tootmistellimused koos operatsioonidega tellimuselt, mitte BOM-ist. Operatsioonid kopeeritakse tellimusele ja planeerijad muudavad neid seal. Seadistage avatud tellimuste ja operatsioonide Generic Inquiry päringule tõuketeavitus või tehke seda päringut perioodiliselt. Lugege ka avatud ostutellimuste read. SkyPlanner loeb tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ja uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered.
3. Ajakava tagasikirjutamine. Iga operatsiooni puhul, mille ajastamismootor ajakavasse paigutas või ümber tõstis, kirjutab SkyPlanner väljade StartDate ja EndDate väärtused objektile OrderOperationDetail. Kui töö viidi alternatiivsesse töökeskusse, kirjutatakse ka töökeskus. Seejärel käivitatakse FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Kui koostate tootmistellimuste ajakava tegelikku tootmisvõimsust arvestades, ei ajasta süsteem kinnistatud tootmistellimusi ümber.) (allikas)
4. Kinnitused tootmissaalist. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmationsi või Production Timeri abil. Ajakirjetest saavad LaborEntry dokumendid (aeg ja valminud kogus operatsiooni kohta) või MoveEntry dokumendid (ainult kogus), mis vabastatakse vastava toiminguga. Kui teie tootmissaalis sisestatakse tööandmed juba Acumaticasse vormi Labor (AM301000) või Shop Floor Kioski kaudu, liiguvad edenemisandmed vastupidises suunas. Valige üks kanal, mitte kunagi mõlemad.
5. Andmete haldamise ja konfliktide lahendamise reeglid. Pange need enne käivitamist kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Laoartiklid, BOM-id, kogused, tellimuse olek, kuluarvestus | Acumatica |
| Operatsioonide järjekord, algus- ja lõppajad, töökeskuse määramine | SkyPlanner |
| Seadistusaegade maatriks, tööriistad, nõuded operaatoritele, alternatiivid | SkyPlanner |
| Vahetused ja puudumised | Üks süsteem, mis valitakse ulatuse määramisel |
| Tööaja- ja liikumiskanded | Acumatica; kanded luuakse SkyPlanneri ajakirjetest või sisestatakse tootmissaalis |
Peamine konfliktide allikas on Acumatica enda APS. Rough Cut Planning või APS Maintenance Process võib SkyPlanneris ajakavasse paigutatud tellimuste kuupäevad ümber arvutada. Iga tellimuse fikseerimine pärast kuupäevade tagasikirjutamist välistab selle. Jätke ajakavasse paigutatud tellimused ka APS-i käivitustest välja.
Projekti tavapärased etapid
Juurutamine valmib tavaliselt mõne nädala jooksul pärast kasutuselevõtu alustamist. Enne seda saate 30-päevasel tasuta prooviperioodil kasutada oma andmeid. Eksportige töökeskused ja avatud tootmistellimused koos operatsioonidega Generic Inquiry kaudu Excelisse, importige need SkyPlannerisse ning kontrollige ajakava.
- Andmete vastendamine. Leppige kokku vastendustabel, milline süsteem milliseid andmeid haldab, sünkroonimise sagedused ja tööaja kirjendamise kanal.
- Juurdepääs. Registreerige ühendatav rakendus, looge integratsiooni kasutaja ja rollid ning kinnitage lõpp-punkti versioon vaates Web Service Endpoints. Alustage testkeskkonnast.
- Esmane andmete laadimine. Töökeskused, masinad, tööriistad, vahetused, laoartiklid ja tootestruktuurid.
- Tellimuste sünkroonimine. Tootmistellimused, operatsioonid ja ostutellimused tõuketeavituste või perioodiliste päringute kaudu.
- Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, nimeliselt määratud operaatorid, mitme operaatoriga tööd ja alternatiivid.
- Tagasikirjutamine. Operatsioonide kuupäevad, tellimuste fikseerimine ning töötundide või liikumiste kanded.
- Paralleelne kasutamine. Võrrelge SkyPlanneri kuupäevi senise plaaniga ja parandage põhiandmed.
- Töösse rakendamine. Kui andmed klapivad, lülitage tagasikirjutamine sisse.
Millega Acumatica integratsiooni kavandamisel arvestada
- Kontrollige, milline APS-i mootor on kasutusel. Classic ja Optimized salvestavad seadeid eraldi ning korraga saab lubatud olla ainult üks neist. Enne esimest tagasikirjutamist kontrollige vaadet Enable/Disable Features (CS100000).
- Fikseerige lõpp-punkti versioon. Versioon on osa URL-ist. Tarkvarauuendus lisab uue versiooni, seega testige integratsiooni iga uuenduse järel uuesti.
- Operatsioonide uuendamine. Mõned operatsioonide väljad on REST-i kaudu ainult loetavad ning oluline on ka tellimuse olek. Testige testkeskkonnas tagasikirjutamise järjekorda tellimustega, mille olek on Released või In Process.
- Ühikud ja ajaväljad. Tööaeg on antud väljal Run Units määratud ühikute arvu kohta ja masina tööaeg väljal Machine Units määratud ühikute arvu kohta. Oote- ja teisaldusaja kohta öeldakse: “affect the calculated schedule but do not occupy work center capacity.” (Need mõjutavad arvutatud ajakava, kuid ei hõiva töökeskuse tootmisvõimsust.) Teisendage need importimisel hoolikalt.
- Materjalide saadavuse arvestamine. Classic APS nõuab, et kõik materjalid oleksid täies mahus saadaval. SkyPlanner arvestab planeerimisel laoseisu ja saabuvaid ostutellimusi kuupäevade kaupa. Leppige kokku, kumma tulemusest planeerijad lähtuvad.
- API piirangud. Lubatud päringute arvu minutis määrab litsents. Kasutage täieliku taaslaadimise asemel muutunud andmete päringuid ja tõuketeavitusi.
Kes seadistab Acumatica integratsiooni ja pakub tuge
- SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu käigus ja pakub tuge ka pärast töösse rakendamist. Iga tehas kasutab Acumaticat omal moel ning seadistamisel arvestatakse just nende eripäradega.
- Kaasata saab ka teie Acumatica partneri. Partner tunneb teie kohandusi, Generic Inquiries päringuid ja rolle. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Ka teie enda arendajad saavad integratsiooni luua, kasutades sama REST API-t ja API tokenit. Alustamiseks piisab API tokenist ning vajaduse korral aitab SkyPlanneri meeskond. Laboratory & Allied valis selle tee SAP Business One puhul: ettevõtte enda IT-meeskond ehitas integratsiooni suuresti iseseisvalt, SkyPlanneri abiga.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub igakuiselt. Integratsiooni hinnapakkumine koostatakse teie protsessi ja vajaduste järgi koos paketiga juba ette, et näeksite kogukulu enne alustamist. Acumatica enda APS-i võrdluse leiate lehelt Acumatica tootmise planeerimine tegeliku tootmisvõimsuse piires, üldülevaate Acumatica lehelt ja teised süsteemid ERP-integratsioonide ülevaatest.
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 säästetakse igal nädalal 2 tundi tööaega ja uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhusus
„Tootmise tõhusus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimite tootmine
Tootmise tõhusus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud kolme kuu plaani koostamine võtab alla 30 minuti.
1 000-te kaupaautomaatselt ajakavasse paigutatud töökäske
„Tootmine on hoopis teistmoodi kontrolli all ja meie arusaam tootmisvõimsusest on täiesti teisel tasemel.”
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline lepinguline tootmine
Tuhanded töökäsud paigutatakse ajakavasse automaatselt ning kogu organisatsioonil on tootmisest reaalajas ülevaade.
99,2%tarnekindlus
„SkyPlanner on aidanud kitsaskohad nähtavale tuua ja muutnud tootmise juhtimise selgemaks.”
Toni Tuori, tootmisjuht
Piristeel · Katuse turvatooted ja vihmaveesüsteemid
Tarnekindlus jõudis sel aastal 99,2%-ni ning ajakava koostamisel säästetakse kuni neli tundi tööaega päevas.
Korduma kippuvad küsimused
Kas Acumatica API kaudu pääseb ligi tootmistellimustele?
Jah. Lepingupõhise REST API lõpp-punkt Manufacturing võimaldab ligipääsu objektidele ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine ja Tool ning töötundide ja liikumiste kannetele. Samuti saab kasutada toiminguid, näiteks FirmProductionOrder.
Kes loob Acumatica integratsiooni?
SkyPlanneri meeskond seadistab kasutuselevõtu käigus kahesuunalise integratsiooni vastavalt teie Acumatica seadistusele ning pakub tuge ka pärast töösse rakendamist. Integratsiooni võivad luua ka teie Acumatica partner või enda arendajad, kasutades SkyPlanneri dokumenteeritud REST API-t. Alustamiseks piisab API tokenist.
Kas selle integratsiooni jaoks on vaja Acumatica APS-i?
Ei. Acumatica enda tootmise planeerimine tegeliku tootmisvõimsuse piires käib vormi Rough Cut Planning kaudu. Classic APS planeerib tellimusi, mille lõpp jääb kaugemale kui 120 päeva, piiramatu tootmisvõimsusega (allikas). SkyPlanner koostab ise üksikasjaliku ajakava tegeliku tootmisvõimsuse piires, kasutades tootmistellimusi, operatsioone, töökeskusi, masinaid ja tööriistu. Seega töötab integratsioon olenemata sellest, kas APS on lubatud või mitte. Acumatica sõnul APS “is subject to licensing” (vajab litsentsi). Autopilot hoiab ajakava ajakohasena ning operaatorid registreerivad tööd funktsiooniga Mobile Confirmations.
Kuidas takistada Acumatica APS-il SkyPlanneri kuupäevi üle kirjutamast?
SkyPlanner fikseerib iga tootmistellimuse pärast selle operatsioonide kuupäevade salvestamist. Kui Acumatica koostab ajakava tegeliku tootmisvõimsuse piires, ei planeeri see fikseeritud tellimusi ümber.
Kas Acumatica saab muudatusi reaalajas edastada?
Jah. Generic Inquiry jaoks seadistatud tõuketeavitused (SM302000) saadavad muutunud read kohe URL-ile. SkyPlanneri enda veebihaagid edastavad ajakava muudatusi vastassuunas.
Millist autentimist peaks integratsioon kasutama?
Kasutage OAuth 2.0 autentimist vaates Connected Applications (SM303010) registreeritud kliendi kaudu ning eraldi integratsioonikasutajat, kelle rollidel on ainult hädavajalikud õigused. Teie keskkonna autentimisvoog kinnitatakse projekti ulatuse määramise käigus.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saab kasutada kuni 20 töökeskust ning importida andmeid Acumatica Generic Inquiry päringust Exceli või CSV kaudu. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
