Integraatiot / ERP / Acumatica Cloud ERP
Acumatica-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Acumatica-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Acumatica Cloud ERP (Manufacturing Edition) yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Acumatican välinen integraatio toimii molempiin suuntiin:
- SkyPlanneriin tuodaan tuotantotilaukset työvaiheineen sekä työpisteet, koneet, työkalut, työvuorot, varastonimikkeet ja ostotilaukset.
- Suunnitellut aloitus- ja lopetuspäivämäärät kirjoitetaan tuotantotilauksen työvaiheille, ja tilaus vahvistetaan.
- Työntekijöiden aikakirjaukset palautetaan Acumaticaan työ- ja siirtokirjauksina.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation Acumatica-ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa integraation itse SkyPlannerin dokumentoidun REST API:n pohjalta (API-dokumentaatio).
Acumatican integraatiorajapinnat
Integraatio käyttää Acumatican mukana toimitettavia rajapintoja. Acumatica-instanssiin ei asenneta mitään.
- Sopimuspohjainen REST API. Rajapintapisteet on versioitu Acumatican julkaisuversioiden mukaisesti. Manufacturing-rajapintapiste (esimerkiksi 26.200.001 versiossa 2026 R2) tarjoaa objektit
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryjaMaterialEntry. Default-rajapintapiste kattaa objektitStockItem,PurchaseOrderjaSalesOrder. URL-osoitteiden muoto on{instance}/entity/{Endpoint}/{version}/{Entity}. - Saman rajapintapisteen toiminnot.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryjaReleaseMaterialEntrysuorittavat saman logiikan kuin käyttöliittymän painikkeet. - OData. Mikä tahansa Generic Inquiry (SM208000) -kysely voidaan julkaista OData-rajapinnan kautta. Nopein tapa lukea tiedot kerralla on Generic Inquiry -kysely, joka sisältää avoimet tuotannon työvaiheet päivämäärineen.
- Push-ilmoitukset (SM302000). Ne perustuvat Generic Inquiry -kyselyyn tai sisäänrakennettuun kyselyyn ja lähettävät lisätyt ja poistetut rivit määrittämääsi URL-osoitteeseen.
- Tuonti- ja vientiskenaariot CSV- ja Excel-tietolähteillä massasiirtoja varten.
Objektit ja toiminnot on lueteltu Web Service Endpoints (SM207000) -näkymässä ja Acumatican REST-asiakasohjelman koodivarastossa.
Tunnistautuminen ja rajoitukset
Acumatica käyttää OAuth 2.0- ja OpenID Connect -tunnistautumista asiakassovelluksilla, jotka rekisteröidään Connected Applications (SM303010) -näkymässä. Dokumentoidut tunnistautumismenettelyt ovat Authorization Code, Implicit, Resource Owner Password Credentials ja Hybrid. Luo palvelinintegraatiolle oma integraatiokäyttäjä ja anna sen rooleille vain välttämättömät käyttöoikeudet. Käytä joko Authorization Code -menettelyä päivitystunnisteen kanssa tai Resource Owner Password Credentials -menettelyä.
Lisenssisi määrittää ylärajat: License Monitoring Console (SM604000) näyttää sallitun API-pyyntöjen määrän minuutissa sekä API-käyttäjien määrän.
SkyPlannerin REST API käyttää tunnistautumiseen API-tunnistetta (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Integraation opastus käy läpi ensimmäiset rajapintakutsut.
Tietojen vastaavuudet
| Acumatican objekti (rajapintapiste / lomake) | SkyPlannerin objekti | Suunta | Siirtotiheys |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Tuotteet ja materiaalit | Acumatica → SkyPlanner | Alkusiirto, sen jälkeen vain muutokset |
BillOfMaterial (AM208000): materiaalit, työvaiheet | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | Acumatica → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
| BOM-työvaiheet: Setup, Run, Machine, Queue, Finish, Move Time | Työvaiheet kestoineen sekä asetus- ja purkuaikoineen | Acumatica → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Työpisteet, työpisteryhmät, tehokkuudet, vaihtoehtoiset työpisteet | Acumatica → SkyPlanner | Alkusiirto, sen jälkeen harvoin |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Työvuorot ja henkilöstökapasiteetti | Acumatica → SkyPlanner | Päivittäin, tai työvuoroja ylläpidetään SkyPlannerissa |
Tool (AM205500) | Työkalut rajallisina resursseina | Acumatica → SkyPlanner | Alkusiirto |
ProductionOrder ja sen OrderOperationDetail (Planned, Released, In Process) | Tilaukset ja työt: määräpäivät, suoritusprioriteetit ja materiaalitarpeet | Acumatica → SkyPlanner | Push-ilmoitus tai kysely muutaman minuutin välein |
PurchaseOrder-rivit (Default) | Ostotilaukset odotettuine toimituspäivineen | Acumatica → SkyPlanner | Kysely tunnin välein tai suunnitteluajon yhteydessä |
| Nimikkeiden varastokohtaiset määrät | Varastosaldot | Acumatica → SkyPlanner | Kysely tunnin välein tai suunnitteluajon yhteydessä |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Työvaiheen suunniteltu aloitus, lopetus ja työpiste | SkyPlanner → Acumatica | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
FirmProductionOrder-toiminto | Estää Acumatica APS:ää muuttamasta kirjoitettuja päivämääriä | SkyPlanner → Acumatica | Jokaisen takaisinkirjoituksen jälkeen |
LaborEntry ja MoveEntry vapautustoimintoineen | Aikakirjaukset, valmistuneet määrät, työntekijöiden kuittaukset | SkyPlanner → Acumatica | Kuittauskohtaisesti tai työvuoroittain |
| Ei Acumaticassa | Asetusaikamatriisi, nimetyt työntekijät, usean työntekijän työt | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutusmallit
1. Perustietojen alkusiirto. Lue ensin työpisteet, koneet, työkalut, työvuorot ja kalenterit. Lue sitten varastonimikkeet ja BOM-rakenteet. Päätä, miten useita koneita sisältävä työpiste mallinnetaan: yhtenä työpisteryhmänä, jonka työpisteinä ovat koneet, vai yhtenä työpisteenä. Acumatican Basis for Capacity kertoo, kumpaa mallia tehdas käyttää.
2. Tilausten synkronointi. Lue tuotantotilaukset työvaiheineen tilaukselta, älä BOM-rakenteesta. Työvaiheet kopioidaan tilaukselle, ja suunnittelijat muokkaavat niitä siellä. Määritä push-ilmoitus avoimien tilausten ja työvaiheiden Generic Inquiry -kyselylle tai lue sen tiedot säännöllisin kyselyin. Lue myös avoimet ostotilausrivit. SkyPlanner katsoo tilatun materiaalin olevan käytettävissä ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilaus merkitään Delivered-tilaan.
3. Aikataulun takaisinkirjoitus. SkyPlanner kirjoittaa StartDate- ja EndDate-arvot OrderOperationDetail-objektiin jokaiselle työvaiheelle, jonka laskentamoottori on sijoittanut tai siirtänyt aikataulussa. Myös työpiste kirjoitetaan, jos työ on siirretty vaihtoehtoiselle työpisteelle. Sen jälkeen SkyPlanner kutsuu FirmProductionOrder-toimintoa. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Kun tuotantotilauksille suoritetaan hienokuormitus, järjestelmä ei muuta vahvistettujen tuotantotilausten aikataulua.) (lähde)
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations -toiminnolla tai Production Timer -toiminnolla. Aikakirjauksista muodostetaan LaborEntry-tositteita (työvaihekohtainen aika ja valmistunut määrä) tai MoveEntry-tositteita (vain määrä), jotka vapautetaan vastaavalla toiminnolla. Jos tuotannossa raportoidaan jo Acumaticaan Labor (AM301000) -näkymän tai Shop Floor Kiosk -toiminnon kautta, etenemistiedot kulkevat toiseen suuntaan. Valitse yksi kanava, älä koskaan molempia.
5. Tietojen omistajuus ja ristiriitojen ratkaisu. Kirjaa säännöt ennen tuotantokäytön aloitusta:
| Tiedot | Omistaja |
|---|---|
| Varastonimikkeet, BOM-rakenteet, määrät, tilausten tilat, kustannuslaskenta | Acumatica |
| Työvaihejärjestys, aloitus- ja lopetusajat, työpisteiden valinta | SkyPlanner |
| Asetusaikamatriisi, työkalut, työntekijävaatimukset, vaihtoehdot | SkyPlanner |
| Työvuorot ja poissaolot | Yksi järjestelmä, joka valitaan määrittelyssä |
| Työ- ja siirtotapahtumat | Acumatica; kirjataan SkyPlannerin työaikakirjauksista tai suoraan tuotannossa |
Suurin ristiriitojen aiheuttaja on Acumatican oma APS. Rough Cut Planning tai APS Maintenance Process voi laskea päivämäärät uudelleen tilauksille, jotka SkyPlanner on jo suunnitellut. Tämä estetään vahvistamalla jokainen tilaus, jonka tiedot kirjoitetaan Acumaticaan. Jätä suunnitellut tilaukset myös APS-ajojen ulkopuolelle.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikkojen kuluessa käyttöönoton aloituksesta. Sitä ennen voit kokeilla ohjelmistoa omilla tiedoillasi 30 päivän maksuttoman kokeilun ajan. Vie työpisteet ja avoimet tuotantotilaukset työvaiheineen Generic Inquiry -kyselystä Exceliin, tuo ne SkyPlanneriin ja tarkista suunnitelma.
- Tietojen vastaavuudet. Vahvista vastaavuustaulukko, tietojen omistajuussäännöt, synkronointivälit ja työkirjausten siirtokanava.
- Käyttöoikeudet. Rekisteröi yhdistettävä sovellus, luo integraatiokäyttäjä ja roolit sekä varmista päätepisteen versio Web Service Endpoints -näkymästä. Aloita testiympäristössä.
- Alkulataus. Työpisteet, koneet, työkalut, vuorot, varastonimikkeet ja tuoterakenteet.
- Tilausten synkronointi. Tuotantotilaukset, työvaiheet ja ostotilaukset push-ilmoituksilla tai säännöllisillä kyselyillä.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, nimetyt työntekijät, usean työntekijän työt ja vaihtoehdot.
- Takaisinkirjoitus. Työvaiheiden päivämäärät, tilausten vahvistaminen sekä työ- tai siirtokirjaukset.
- Rinnakkaisajo. Vertaa SkyPlannerin päivämääriä nykyiseen suunnitelmaan ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä Acumatica-integraatiossa on otettava huomioon
- Tarkista, kumpi APS-moottori on käytössä. Classic ja Optimized tallentavat asetukset erikseen, ja vain toinen voi olla käytössä. Tarkista Enable/Disable Features (CS100000) ennen ensimmäistä takaisinkirjoitusta.
- Lukitse päätepisteen versio. Versio on osa URL-osoitetta. Ohjelmistopäivitys lisää uuden version, joten testaa toiminta uudelleen jokaisen päivityksen yhteydessä.
- Työvaiheiden päivittäminen. Osaa työvaiheiden kentistä voi REST-rajapinnan kautta vain lukea, ja myös tilauksen tila vaikuttaa päivityksiin. Testaa takaisinkirjoituksen vaiheet testiympäristössä tilauksilla, joiden tila on Released tai In Process.
- Yksiköt ja aikakentät. Run time ilmoitetaan Run Units -määrää kohti ja machine time Machine Units -määrää kohti. Jonotus- ja siirtoajat “affect the calculated schedule but do not occupy work center capacity.” (vaikuttavat laskettuun aikatauluun mutta eivät varaa työpisteen kapasiteettia). Tee muunnokset huolellisesti tietoja tuodessasi.
- Materiaalien saatavuuden tulkinta. Classic APS edellyttää, että kaikki materiaalit ovat kokonaisuudessaan saatavilla. SkyPlanner huomioi suunnittelussa varastosaldot ja saapuvat ostotilaukset päivämäärineen. Sopikaa, kumman järjestelmän tulosta suunnittelijat noudattavat.
- API-rajoitukset. Minuuttikohtainen pyyntömäärä riippuu lisenssistä. Hae vain muuttuneet tiedot ja käytä push-ilmoituksia sen sijaan, että lataisit kaikki tiedot uudelleen.
Kuka määrittää Acumatica-integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Jokainen tehdas käyttää Acumaticaa omalla tavallaan, ja tämä osaaminen hyödynnetään integraatiossa.
- Acumatica-kumppanisi voi osallistua toteutukseen. Kumppani tuntee räätälöintisi, Generic Inquiries -kyselysi ja roolisi. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Omat kehittäjäsi voivat toteuttaa integraation saman REST API -rajapinnan kautta API-tunnuksella. Aloittamiseen riittää API-tunnus, ja SkyPlanner-tiimi auttaa tarvittaessa. Laboratory & Allied valitsi tämän tavan SAP Business One -järjestelmässään: yrityksen oma IT-tiimi rakensi integraation pitkälti itse SkyPlannerin tuella.
SkyPlannerin hinta on alkaen 199 € kuukaudessa kuukausilaskutuksella, ja hintaan sisältyy 5 työpistettä. Integraatiosta annetaan etukäteen prosessisi ja tarpeidesi mukainen tarjous valitsemasi tilauksen yhteydessä, joten tiedät kokonaiskustannukset ennen aloittamista. Katso Acumatican oman APS:n vertailu sivulta Acumatican hienokuormitus, yleiskatsaus Acumatica-sivulta ja muut järjestelmät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kytkinlaitteistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa viikossa, ja uusi työjono siirtyy tuotantolinjalle sekunneissa.
+90%tuotantotehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotantotehokkuus on kasvanut 90 %, ja kaikki työpisteet kattava optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
1 000:iaautomaattisesti suunniteltuja työmääräimiä
”Tuotanto on eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on aivan eri tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhannet työmääräimet suunnitellaan automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
99,2 %toimitusvarmuus
”SkyPlanner on tehnyt pullonkaulat helpommin havaittaviksi ja selkeyttänyt tuotannonohjausta.”
Toni Tuori, tuotantopäällikkö
Piristeel · Kattoturvatuotteet ja sadevesijärjestelmät
Toimitusvarmuus nousi tänä vuonna 99,2 %:iin, ja tuotannonsuunnittelussa säästyy jopa neljä tuntia työaikaa päivässä.
Usein kysytyt kysymykset
Ovatko tuotantotilaukset saatavilla Acumatican API-rajapinnasta?
Kyllä. Sopimuspohjaisen REST API -rajapinnan Manufacturing-päätepiste tarjoaa objektit ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine ja Tool sekä työ- ja siirtokirjaukset. Lisäksi käytettävissä on toimintoja, kuten FirmProductionOrder.
Kuka toteuttaa Acumatica-integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Acumatica-ympäristöösi käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Myös Acumatica-kumppanisi tai omat kehittäjäsi voivat toteuttaa integraation SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Aloittamiseen riittää API-tunnus.
Tarvitaanko integraatioon Acumatica APS?
Ei. Acumatican oma kapasiteettirajoitteet huomioiva suunnitteluajo tehdään Rough Cut Planning -lomakkeella. Classic APS suunnittelee yli 120 päivän päähän päättyvät tilaukset rajoittamattomalla kapasiteetilla (lähde). SkyPlanner tekee itse yksityiskohtaisen, kapasiteettirajoitteet huomioivan suunnitelman tuotantotilausten, työvaiheiden, työpisteiden, koneiden ja työkalujen perusteella. Integraatio toimii siis riippumatta siitä, onko APS käytössä. Acumatican mukaan APS “is subject to licensing” (edellyttää lisenssiä). Autopilot pitää suunnitelman ajan tasalla, ja työntekijät kirjaavat työt Mobile Confirmations -toiminnolla.
Miten estämme Acumatica APS:ää korvaamasta SkyPlannerin päivämääriä?
SkyPlanner vahvistaa jokaisen tuotantotilauksen kirjoitettuaan sen työvaiheiden päivämäärät. Acumatican hienokuormitus ei suunnittele vahvistettuja tilauksia uudelleen.
Voiko Acumatica lähettää muutokset reaaliajassa?
Kyllä. Generic Inquiry -kyselyyn määritetyt push-ilmoitukset (SM302000) lähettävät muuttuneet rivit URL-osoitteeseen heti muutoksen tapahtuessa. SkyPlannerin omat webhookit välittävät suunnitelman muutokset toiseen suuntaan.
Mitä tunnistautumistapaa integraatiossa tulisi käyttää?
OAuth 2.0 -tunnistautumista Connected Applications (SM303010) -näkymässä rekisteröidyn asiakassovelluksen kautta. Käytä erillistä integraatiokäyttäjää ja rooleja, joilla on vain tarvittavat oikeudet. Ympäristöösi sopiva tunnistautumisprosessi varmistetaan määrittelyn yhteydessä.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Maksuttomassa 30 päivän kokeilussa voit käyttää enintään 20 työpistettä ja tuoda tiedot Acumatican Generic Inquiry -kyselystä Excel- tai CSV-tiedostona. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
