Integrācijas / ERP / Acumatica Cloud ERP
Acumatica integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS
Šajā Acumatica integrācijas ceļvedī partneriem un IT komandām skaidrots, kā savienot Acumatica Cloud ERP (Manufacturing Edition) ar SkyPlanner APS. SkyPlanner un Acumatica apmainās ar datiem abos virzienos:
- SkyPlanner saņem ražošanas pasūtījumus ar to operācijām, darba centrus, iekārtas, instrumentus, maiņas, krājumu artikulus un iepirkuma pasūtījumus.
- Plānotos sākuma un beigu datumus ieraksta ražošanas pasūtījuma operācijās, un pasūtījuma grafiku fiksē.
- Operatoru darba laika uzskaites ierakstus nosūta atpakaļ kā darba un pārvietošanas ierakstus.
- SkyPlanner nosūta grafika izmaiņas ar webhook palīdzību, tiklīdz tās notiek.
Ieviešanas laikā SkyPlanner komanda pielāgo integrāciju jūsu Acumatica konfigurācijai un nodrošina tās atbalstu arī pēc palaišanas ekspluatācijā. Šis ceļvedis paredzēts partneriem un izstrādātājiem, kuri vēlas iesaistīties vai paši veidot risinājumus, izmantojot dokumentēto SkyPlanner REST API (API uzziņa).
Acumatica integrācijas saskarnes
Integrācija izmanto Acumatica jau iekļautās saskarnes. Acumatica instancē nekas nav jāinstalē.
- Uz līgumiem balstīts REST API. Galapunktiem ir versijas, kas atbilst produkta laidieniem. Manufacturing galapunkts (piemēram, 26.200.001 laidienam 2026 R2) nodrošina piekļuvi
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryunMaterialEntry. Default galapunkts nodrošina piekļuviStockItem,PurchaseOrderunSalesOrder. URL struktūra ir{instance}/entity/{Endpoint}/{version}/{Entity}. - Darbības tajā pašā galapunktā.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryunReleaseMaterialEntryizpilda to pašu loģiku, ko attiecīgās pogas sistēmas ekrānos. - OData. Jebkuru Generic Inquiry (SM208000) vaicājumu var padarīt pieejamu ar OData. Visātrāk lielu datu apjomu var nolasīt ar Generic Inquiry vaicājumu, kas atlasa nepabeigtās ražošanas operācijas un to datumus.
- Pašpiegādes paziņojumi (SM302000). To pamatā ir Generic Inquiry vai iebūvēts vaicājums. Paziņojumi nosūta pievienotās un dzēstās rindas uz jūsu konfigurētu URL.
- Importa un eksporta scenāriji ar CSV un Excel datu nodrošinātājiem lielapjoma datu ielādei.
Entītijas un darbības ir norādītas ekrānā Web Service Endpoints (SM207000) un Acumatica REST klienta repozitorijā.
Autentifikācija un ierobežojumi
Acumatica izmanto OAuth 2.0 un OpenID Connect ar klienta lietotnēm, kas reģistrētas ekrānā Connected Applications (SM303010). Dokumentācijā aprakstītas plūsmas Authorization Code, Implicit, Resource Owner Password Credentials un Hybrid. Servera integrācijai reģistrējiet atsevišķu integrācijas lietotāju ar lomām, kas piešķir tikai nepieciešamās tiesības, un izmantojiet Authorization Code ar atsvaidzināšanas marķieri vai Resource Owner Password Credentials.
Ierobežojumus nosaka jūsu licence: ekrānā License Monitoring Console (SM604000) ir redzams atļautais API pieprasījumu skaits minūtē un API lietotāju skaits.
SkyPlanner pusē REST API autentifikācijai izmanto API marķieri (SkyPlanner Settings > API), un API ir dokumentēts Swagger/OpenAPI formātā. Integrācijas pamācībā soli pa solim izskaidroti pirmie izsaukumi.
Datu kartēšana
| Acumatica objekts (galapunkts / forma) | SkyPlanner objekts | Virziens | Biežums |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkti un materiāli | Acumatica → SkyPlanner | Sākotnējā ielāde, pēc tam tikai izmaiņas |
BillOfMaterial (AM208000): materiāli, operācijas | Produkta struktūra, apakšprodukti, katram produktam nepieciešamie materiāli | Acumatica → SkyPlanner | Sākotnējā ielāde, pēc tam izmaiņu gadījumā |
| BOM operācijas: Setup, Run, Machine, Queue, Finish, Move Time | Procesa soļi ar ilgumu, sagatavošanas un noslēguma laiku | Acumatica → SkyPlanner | Sākotnējā ielāde, pēc tam izmaiņu gadījumā |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Darba centri, darba centru grupas, efektivitātes rādītāji, alternatīvie darba centri | Acumatica → SkyPlanner | Sākotnējā ielāde, pēc tam reti |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Maiņas un personāla kapacitāte | Acumatica → SkyPlanner | Katru dienu, vai arī maiņas uztur SkyPlanner |
Tool (AM205500) | Instrumenti kā resursi ar ierobežotu pieejamību | Acumatica → SkyPlanner | Sākotnējā ielāde |
ProductionOrder ar OrderOperationDetail (Planned, Released, In Process) | Pasūtījumi un darbi ar izpildes termiņiem, izpildes prioritāti un materiālu vajadzībām | Acumatica → SkyPlanner | Pašpiegādes paziņojums vai periodiska pieprasīšana ik pēc dažām minūtēm |
PurchaseOrder rindas (Default) | Iepirkuma pasūtījumi ar paredzamo piegādes datumu | Acumatica → SkyPlanner | Datu pieprasīšana reizi stundā vai grafika aprēķina laikā |
| Artikulu daudzumi noliktavās | Krājumu atlikumi | Acumatica → SkyPlanner | Datu pieprasīšana reizi stundā vai grafika aprēķina laikā |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Katras operācijas plānotais sākums, beigas un darba centrs | SkyPlanner → Acumatica | Mainoties grafikam, ar SkyPlanner webhook palīdzību |
Darbība FirmProductionOrder | Neļauj Acumatica APS mainīt ierakstītos datumus | SkyPlanner → Acumatica | Pēc katras atpakaļierakstes |
LaborEntry, MoveEntry ar iegrāmatošanas darbībām | Darba laika uzskaites ieraksti, pabeigtie daudzumi, operatoru apstiprinājumi | SkyPlanner → Acumatica | Pēc katra apstiprinājuma vai katras maiņas |
| Nav Acumatica | Sagatavošanas laiku matrica, konkrēti operatori, darbi ar vairākiem operatoriem | Uztur SkyPlanner | Konfigurē ieviešanas laikā |
Integrācijas shēmas
1. Sākotnējā pamatdatu ielāde. Vispirms nolasiet darba centrus, iekārtas, instrumentus, maiņas un kalendārus. Pēc tam nolasiet krājumu artikulus un materiālu specifikācijas. Izlemiet, kā attēlot darba centru ar vairākām iekārtām: kā vienu darba centru grupu, kurā katra iekārta ir atsevišķs darba centrs, vai kā vienu darba centru. Acumatica lauks Basis for Capacity parāda, kuru pieeju izmanto ražotne.
2. Pasūtījumu sinhronizācija. Ražošanas pasūtījumus un to operācijas nolasiet no pasūtījuma, nevis no BOM. Operācijas tiek kopētas pasūtījumā, un plānotāji tās maina tieši tur. Konfigurējiet pašpiegādes paziņojumus Generic Inquiry vaicājumam par nepabeigtajiem pasūtījumiem un operācijām vai periodiski pieprasiet tā datus. Nolasiet arī atvērto iepirkuma pasūtījumu rindas. SkyPlanner uzskata pasūtīto materiālu par pieejamu iepirkuma pasūtījuma piegādes datumā un atjaunina krājumu atlikumus, kad iepirkuma pasūtījumam piešķir statusu Delivered.
3. Grafika atpakaļierakste. Katrai operācijai, ko plānošanas dzinis ieplānojis vai pārcēlis, SkyPlanner ieraksta StartDate un EndDate objektā OrderOperationDetail, kā arī darba centru, ja darbs pārcelts uz alternatīvu centru. Pēc tam tiek izsaukta darbība FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Veicot ražošanas pasūtījumu plānošanu atbilstoši reālajai iekārtu un personāla kapacitātei, sistēma nepārplāno pasūtījumus ar fiksētu grafiku.) (avots)
4. Apstiprinājumi no ražošanas ceha. Operatori reģistrē darbu ar SkyPlanner Mobile Confirmations vai Production Timer. No darba laika uzskaites ierakstiem veido LaborEntry dokumentus (laiks un pabeigtais daudzums katrai operācijai) vai MoveEntry dokumentus (tikai daudzums), kurus iegrāmato ar attiecīgo darbību. Ja ražošanas cehā darbu jau uzskaita Acumatica, izmantojot Labor (AM301000) vai Shop Floor Kiosk, izpildes dati plūst pretējā virzienā. Izvēlieties vienu kanālu, nekad neizmantojiet abus.
5. Atbildība par datiem un konfliktu risināšanas noteikumi. Dokumentējiet tos pirms palaišanas ekspluatācijā:
| Dati | Atbildīgā sistēma |
|---|---|
| Krājumu artikuli, BOM, daudzumi, pasūtījumu statusi, pašizmaksas aprēķins | Acumatica |
| Operāciju secība, sākuma un beigu laiks, darba centru piešķiršana | SkyPlanner |
| Sagatavošanas laiku matrica, instrumenti, prasības operatoriem, alternatīvas | SkyPlanner |
| Maiņas un prombūtnes | Viena sistēma, ko izvēlas tvēruma noteikšanas laikā |
| Darba un pārvietošanas transakcijas | Acumatica; ierakstus iegrāmato no SkyPlanner darba laika uzskaites vai ievada ražošanas cehā |
Galvenais konfliktu avots ir pašas Acumatica APS. Rough Cut Planning vai APS Maintenance Process var pārrēķināt datumus pasūtījumiem, kuriem SkyPlanner jau ir sastādījis grafiku. To novērš, fiksējot katru pasūtījumu, kuram grafika dati ierakstīti atpakaļ Acumatica. Izslēdziet no APS aprēķiniem arī pasūtījumus, kuriem grafiks jau sastādīts.
Tipiskie projekta posmi
Ieviešanu parasti pabeidz dažu nedēļu laikā pēc ieviešanas procesa sākuma. Pirms tam 30 dienu bezmaksas izmēģinājumā varat izmantot savus datus. Eksportējiet no Generic Inquiry uz Excel darba centrus un atvērtos ražošanas pasūtījumus ar to operācijām, importējiet šos datus un pārbaudiet grafiku.
- Datu kartēšana. Nosakiet datu kartēšanas tabulu, noteikumus par to, kura sistēma pārvalda datus, sinhronizācijas biežumu un darba laika ierakstu iegrāmatošanas kanālu.
- Piekļuve. Reģistrējiet pievienoto lietotni, izveidojiet integrācijas lietotāju un lomas un pārbaudiet galapunkta versiju sadaļā Web Service Endpoints. Vispirms dariet to testa vidē.
- Sākotnējā ielāde. Darba centri, iekārtas, instrumenti, maiņas, krājumu preces un BOM.
- Pasūtījumu sinhronizācija. Ražošanas pasūtījumi, operācijas un iepirkuma pasūtījumi, izmantojot pašpiegādes paziņojumus vai periodisku datu pieprasīšanu.
- Ierobežojumu iestatīšana SkyPlanner. Sagatavošanas laiku matrica, konkrēti operatori, darbi ar vairākiem operatoriem un alternatīvas.
- Ierakstīšana atpakaļ. Operāciju datumi, pasūtījumu fiksēšana un darba laika vai pārvietošanas ieraksti.
- Paralēlā darbība. Salīdziniet SkyPlanner datumus ar pašreizējo plānu un izlabojiet pamatdatus.
- Ekspluatācijas sākšana. Ieslēdziet ierakstīšanu atpakaļ, kad dati sakrīt.
Kas jāņem vērā, integrējot Acumatica
- Noskaidrojiet, kurš APS dzinis ir ieslēgts. Classic un Optimized glabā iestatījumus atsevišķi, un ieslēgts var būt tikai viens no tiem. Pirms pirmās ierakstīšanas atpakaļ pārbaudiet Enable/Disable Features (CS100000).
- Fiksējiet galapunkta versiju. Versija ir daļa no URL. Sistēmas atjauninājums pievieno jaunu versiju, tāpēc pēc katra atjauninājuma testējiet atkārtoti.
- Operāciju atjaunināšana. Daži operāciju lauki, piekļūstot tiem ar REST, ir tikai lasāmi, un nozīme ir arī pasūtījuma statusam. Testa vidē pārbaudiet ierakstīšanas secību pasūtījumiem ar statusu Released un In Process.
- Mērvienības un laika lauki. Izpildes laiks attiecas uz Run Units norādīto daudzumu, bet iekārtas laiks — uz Machine Units norādīto daudzumu. Par gaidīšanas un pārvietošanas laiku norādīts: “affect the calculated schedule but do not occupy work center capacity.” (ietekmē aprēķināto grafiku, bet nenoslogo darba centra jaudu). Importējot rūpīgi pārrēķiniet vērtības.
- Materiālu pieejamības novērtējums. Classic APS prasa, lai visi materiāli būtu pieejami pilnā apjomā. SkyPlanner plāno, ņemot vērā krājumus un gaidāmos iepirkuma pasūtījumus pēc datuma. Vienojieties, kuras sistēmas novērtējumam plānotāji sekos.
- API ierobežojumi. Pieprasījumu skaitu minūtē nosaka licence. Izmantojiet tikai izmaiņu nolasīšanu un pašpiegādes paziņojumus, nevis pilnu datu atkārtotu ielādi.
Kas konfigurē Acumatica integrāciju un nodrošina tās atbalstu
- SkyPlanner komanda konfigurē integrāciju ieviešanas laikā un nodrošina atbalstu pēc darba sākšanas produkcijas vidē. Katrā rūpnīcā Acumatica izmanto citādi, un konfigurācijā tiek ņemtas vērā šīs īpatnības.
- Var iesaistīties arī jūsu Acumatica partneris. Partneris pārzina jūsu pielāgojumus, Generic Inquiries un lomas. SkyPlanner nodrošina REST API, Swagger/OpenAPI dokumentāciju un tīmekļa aizķeres.
- Integrāciju var izstrādāt arī jūsu izstrādātāji, izmantojot to pašu REST API un API marķieri. Lai sāktu, pietiek ar API marķieri, un SkyPlanner komanda vajadzības gadījumā palīdz. Laboratory & Allied izvēlējās šo pieeju ar SAP Business One: uzņēmuma IT komanda integrāciju lielākoties izstrādāja pati, saņemot SkyPlanner palīdzību.
SkyPlanner cena sākas no 199 € mēnesī ar ikmēneša norēķiniem, un tajā iekļauti 5 darba centri. Integrācijas cenu atbilstoši jūsu procesam un vajadzībām piedāvājam iepriekš kopā ar abonēšanas plānu, lai visas izmaksas būtu zināmas pirms darba sākšanas. Salīdzinājumu ar pašas Acumatica APS skatiet sadaļā Acumatica ražošanas plānošana, ievērojot reālo iekārtu un darbinieku jaudu, pārskatu — Acumatica lapā, bet citas sistēmas — ERP integrāciju sadaļā.
Ražotāju atsauksmes par SkyPlanner
2 hietaupītas katru nedēļu
“Ar SkyPlanner mūsu ražošanas plānošana ir pārgājusi no Excel tabulām uz ražošanas optimizāciju reāllaikā.”
Kalle Kalliomäki, piegādes ķēdes speciālists
UTU · Elektrosadales skapji un sadalietaises
Ražošanas plānošana ietaupa 2 darba stundas katru nedēļu, un jaunā darbu rinda nonāk ražošanas līnijā dažu sekunžu laikā.
+90%ražošanas efektivitāte
“Ražošanas efektivitāte ir pieaugusi par 90%.”
Abdul Rucyinga, IT vadītājs
Laboratory & Allied · Farmaceitiskā ražošana
Ražošanas efektivitāte ir pieaugusi par 90%, un optimizēta plāna sastādīšana trim mēnešiem visiem darba centriem aizņem mazāk nekā 30 minūtes.
1 000-iemdarba pasūtījumu automātiski iekļauti grafikā
“Tagad ražošanu pārvaldām citādi, un mūsu izpratne par jaudu ir pavisam citā līmenī.”
Hannu Ryynänen, izpilddirektors
Mamec · Rūpnieciskie maisītāji, sūkņi un augsto tehnoloģiju līgumražošana
Tūkstošiem darba pasūtījumu tiek automātiski iekļauti grafikā, un visam uzņēmumam ir pieejams reāllaika pārskats par ražošanu.
99,2%piegāžu savlaicīgums
“SkyPlanner ir palīdzējis saskatīt ražošanas šaurās vietas un padarījis ražošanas vadību pārskatāmāku.”
Toni Tuori, ražošanas vadītājs
Piristeel · Jumta drošības aprīkojums un lietusūdens novadīšanas sistēmas
Šogad piegāžu savlaicīgums sasniedza 99,2%, un grafiku sastādīšana ietaupa līdz četrām darba stundām dienā.
Biežāk uzdotie jautājumi
Vai Acumatica API ir pieejami ražošanas pasūtījumi?
Jā. Uz datu līgumiem balstītās REST API galapunktā Manufacturing ir pieejami ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool, kā arī darba laika un pārvietošanas ieraksti un tādas darbības kā FirmProductionOrder.
Kas izstrādā Acumatica integrāciju?
SkyPlanner komanda ieviešanas laikā konfigurē divvirzienu integrāciju atbilstoši jūsu Acumatica konfigurācijai un nodrošina atbalstu pēc darba sākšanas produkcijas vidē. Arī jūsu Acumatica partneris vai jūsu izstrādātāji var veidot integrāciju, izmantojot SkyPlanner dokumentēto REST API; lai sāktu, pietiek ar API marķieri.
Vai šai integrācijai ir nepieciešama Acumatica APS?
Nē. Pašas Acumatica ražošanas plānošana, kas ņem vērā reālo iekārtu un darbinieku jaudu, tiek veikta formā Rough Cut Planning. Savukārt Classic APS pasūtījumus, kuru beigu datums ir vēlāk nekā pēc 120 dienām, plāno, pieņemot neierobežotu jaudu (avots). SkyPlanner pats sastāda detalizētu grafiku atbilstoši pieejamajai jaudai, izmantojot ražošanas pasūtījumus, operācijas, darba centrus, iekārtas un instrumentus. Tāpēc integrācija darbojas neatkarīgi no tā, vai ir ieslēgta APS, par kuru Acumatica norāda: “is subject to licensing” (ir nepieciešama licence). Autopilot uztur grafiku aktuālu, bet operatori reģistrē darbu ar Mobile Confirmations.
Kā neļaut Acumatica APS pārrakstīt SkyPlanner datumus?
SkyPlanner fiksē katru ražošanas pasūtījumu pēc tā operāciju datumu ierakstīšanas. Acumatica ražošanas plānošana, kas ņem vērā pieejamo jaudu, nemaina fiksētu pasūtījumu grafikus.
Vai Acumatica var nosūtīt izmaiņas reāllaikā?
Jā. Generic Inquiry konfigurētie Push notifications (SM302000) nosūta mainītās rindas uz URL uzreiz pēc izmaiņām. SkyPlanner tīmekļa aizķeres savukārt nosūta grafika izmaiņas pretējā virzienā.
Kāda autentifikācija jāizmanto integrācijai?
OAuth 2.0 ar klientu, kas reģistrēts sadaļā Connected Applications (SM303010), īpaši integrācijai izveidotu lietotāju un lomām ar minimāli nepieciešamajām tiesībām. Jūsu instancei piemēroto autentifikācijas plūsmu apstiprina tvēruma noteikšanas laikā.
Vai varam izmēģināt SkyPlanner pirms integrācijas izstrādes?
Jā. 30 dienu bezmaksas izmēģinājumā var izmantot līdz 20 darba centriem, importējot Excel vai CSV datus no Acumatica Generic Inquiry. Kredītkarte nav nepieciešama. Sāciet izmēģinājumu vai sazinieties ar pārdošanas komandu, lai noteiktu integrācijas tvērumu.
