Integrationer / ERP / Acumatica Cloud ERP
Guide till Acumatica-integration för produktionsplanering med SkyPlanner APS
Den här guiden visar hur partner och IT-team kopplar Acumatica Cloud ERP (Manufacturing Edition) till SkyPlanner APS. Integrationen mellan SkyPlanner och Acumatica fungerar i båda riktningarna:
- Produktionsorder med tillhörande operationer, produktionsgrupper, maskiner, verktyg, skift, lagerartiklar och inköpsorder läses in.
- Planerade start- och slutdatum skrivs till produktionsorderns operationer, och ordern fastplaneras.
- Operatörernas tidrapporter skickas tillbaka som arbetstids- och förflyttningstransaktioner.
- SkyPlanners webhooks skickar planändringar direkt när de sker.
SkyPlanner-teamet konfigurerar integrationen efter er Acumatica-miljö under införandet och ger support efter driftsättningen. Den här guiden är till för partner och utvecklare som vill delta eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens).
Acumaticas integrationsgränssnitt
Integrationen använder de gränssnitt som redan ingår i Acumatica. Inget installeras i instansen.
- Kontraktsbaserat REST API. Endpoints är versionshanterade och följer respektive release. Endpointen Manufacturing (till exempel 26.200.001 för 2026 R2) exponerar
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryochMaterialEntry. Endpointen Default omfattarStockItem,PurchaseOrderochSalesOrder. URL:er följer formatet{instance}/entity/{Endpoint}/{version}/{Entity}. - Åtgärder på samma endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryochReleaseMaterialEntrykör samma logik som knapparna i respektive vy. - OData. Alla Generic Inquiry-frågor (SM208000) kan exponeras via OData. En Generic Inquiry med öppna produktionsoperationer och datum ger snabbast masshämtning.
- Pushnotiser (SM302000). De bygger på en Generic Inquiry eller en inbyggd fråga och skickar tillagda och borttagna rader till en URL som ni konfigurerar.
- Import- och exportscenarier med dataproviders för CSV och Excel för massinläsning.
Entiteter och åtgärder listas i Web Service Endpoints (SM207000) och i Acumaticas kodarkiv för REST-klienten.
Autentisering och begränsningar
Acumatica använder OAuth 2.0 och OpenID Connect via klientapplikationer som registreras i Connected Applications (SM303010). De dokumenterade flödena är Authorization Code, Implicit, Resource Owner Password Credentials och Hybrid. För en serverintegration registrerar ni en särskild integrationsanvändare med roller som bara ger nödvändiga behörigheter. Använd Authorization Code med en refresh token eller Resource Owner Password Credentials.
Licensen sätter gränsen: License Monitoring Console (SM604000) visar tillåtet antal API-anrop per minut och API-användare.
I SkyPlanner autentiseras anrop till REST API med en API-token (SkyPlanner Settings > API). API:et är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Datamappning
| Objekt i Acumatica (endpoint / formulär) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkter och material | Acumatica → SkyPlanner | Första inläsning, därefter ändringar |
BillOfMaterial (AM208000): material, operationer | Produktstruktur, delprodukter, material per produkt | Acumatica → SkyPlanner | Första inläsning, därefter vid ändring |
| BOM-operationer: Setup, Run, Machine, Queue, Finish, Move Time | Processteg med varaktighet, ställtid och avrustningstid | Acumatica → SkyPlanner | Första inläsning, därefter vid ändring |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Produktionsgrupper, grupper av produktionsgrupper, effektivitetsgrader, alternativa produktionsgrupper | Acumatica → SkyPlanner | Första inläsning, därefter sällan |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Skift och personalkapacitet | Acumatica → SkyPlanner | Dagligen, alternativt hanteras skiften i SkyPlanner |
Tool (AM205500) | Verktyg som resurser med begränsad kapacitet | Acumatica → SkyPlanner | Första inläsning |
ProductionOrder med OrderOperationDetail (Planned, Released, In Process) | Order och jobb med färdigdatum, körprioritet och materialbehov | Acumatica → SkyPlanner | Pushnotis eller pollning med några minuters mellanrum |
Rader i PurchaseOrder (Default) | Inköpsorder med förväntat leveransdatum | Acumatica → SkyPlanner | Pollning varje timme eller vid planeringskörning |
| Artikelkvantiteter per lager | Lagersaldon | Acumatica → SkyPlanner | Pollning varje timme eller vid planeringskörning |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Planerad start, planerat slut och produktionsgrupp per operation | SkyPlanner → Acumatica | Vid ändring i planen, via en webhook från SkyPlanner |
Åtgärden FirmProductionOrder | Låser de skrivna datumen så att Acumatica APS inte ändrar dem | SkyPlanner → Acumatica | Efter varje återskrivning |
LaborEntry, MoveEntry med frisläppningsåtgärder | Tidrapporter, färdigställda kvantiteter, operatörskvitteringar | SkyPlanner → Acumatica | Per kvittering eller per skift |
| Finns inte i Acumatica | Ställtidsmatris, namngivna operatörer, jobb med flera operatörer | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsning av grunddata. Läs först in produktionsgrupper, maskiner, verktyg, skift och kalendrar. Läs sedan in lagerartiklar och stycklistor. Bestäm hur en produktionsgrupp med flera maskiner ska mappas: till en grupp där varje maskin är en egen produktionsgrupp, eller till en enda produktionsgrupp. Fältet Basis for Capacity i Acumatica visar hur fabriken räknar.
2. Ordersynkronisering. Läs in produktionsorder med operationerna från själva ordern, inte från stycklistan. Operationerna kopieras till ordern och det är där planerarna ändrar dem. Konfigurera pushnotiser för en Generic Inquiry med öppna order och operationer, eller polla frågan. Läs även in öppna inköpsorderrader. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered.
3. Återskrivning av planen. För varje operation som planeringsmotorn har placerat eller flyttat skriver SkyPlanner StartDate och EndDate till OrderOperationDetail. Även produktionsgruppen skrivs om jobbet har flyttats till ett alternativ. Därefter anropas FirmProductionOrder. Acumatica: ”When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (När ni kör finplanering av produktionsorder planerar systemet inte om de fastplanerade produktionsorderna.) (källa)
4. Återrapportering från produktionen. Operatörerna registrerar arbete med SkyPlanner Mobile Confirmations eller Production Timer. Tidrapporterna blir LaborEntry-dokument (tid och färdigställd kvantitet per operation) eller MoveEntry-dokument (enbart kvantitet), som frisläpps med motsvarande åtgärd. Om personalen i produktionen redan rapporterar i Acumatica via Labor (AM301000) eller Shop Floor Kiosk går informationen om hur arbetet fortskrider åt andra hållet. Välj en kanal, aldrig båda.
5. Dataägarskap och konfliktregler. Dokumentera dem före driftsättningen:
| Data | Ägare |
|---|---|
| Lagerartiklar, stycklistor, kvantiteter, orderstatus, kostnadskalkylering | Acumatica |
| Operationsföljd, start- och sluttider, tilldelning av produktionsgrupp | SkyPlanner |
| Ställtidsmatris, verktyg, operatörskrav, alternativ | SkyPlanner |
| Skift och frånvaro | Ett system, som väljs under kartläggningen |
| Arbetstids- och förflyttningstransaktioner | Acumatica, med bokföring från SkyPlanners tidsloggar eller registrering i produktionen |
Den främsta källan till konflikter är Acumaticas eget APS. Rough Cut Planning eller APS Maintenance Process kan räkna om datum för order som SkyPlanner har planerat. Genom att låsa varje återskriven order förhindrar ni detta. Undanta även planerade order från APS-körningar.
Vanliga projektsteg
Implementeringen är normalt klar inom några veckor efter att introduktionen har startat. Innan dess kan ni prova kostnadsfritt i 30 dagar med era egna data. Exportera produktionsgrupper och öppna tillverkningsorder med tillhörande operationer från en Generic Inquiry till Excel, importera dem och validera planen.
- Mappning. Fastställ mappningstabellen, regler för dataägarskap, synkroniseringsintervall och kanalen för bokföring av arbetstid.
- Åtkomst. Registrera den anslutna applikationen, skapa integrationsanvändaren och rollerna och bekräfta endpoint-versionen i Web Service Endpoints. Börja i en testmiljö.
- Första inläsning. Produktionsgrupper, maskiner, verktyg, skift, lagerförda artiklar och stycklistor.
- Ordersynkronisering. Tillverkningsorder, operationer och inköpsorder via pushnotiser eller pollning.
- Konfigurera begränsningar i SkyPlanner. Ställtidsmatris, namngivna operatörer, jobb med flera operatörer och alternativ.
- Återskrivning. Operationsdatum, låsning av order samt registrering av arbetstid eller förflyttningar.
- Parallellkörning. Jämför SkyPlanners datum med den nuvarande planen och korrigera grunddata.
- Driftsättning. Aktivera återskrivningen när data stämmer överens.
Att planera för vid en Acumatica-integration
- Kontrollera vilken APS-motor som är aktiv. Classic och Optimized lagrar inställningar separat, och bara en kan vara aktiverad. Kontrollera Enable/Disable Features (CS100000) före den första återskrivningen.
- Lås endpoint-versionen. Versionen ingår i URL:en. En uppgradering lägger till en ny version, så testa på nytt vid varje uppgradering.
- Uppdatering av operationer. Vissa operationsfält är skrivskyddade via REST, och orderstatusen spelar roll. Testa återskrivningssekvensen för order med status Released och In Process i en testmiljö.
- Enheter och tidsfält. Körtid anges per Run Units, maskintid per Machine Units. Kö- och förflyttningstid ”affect the calculated schedule but do not occupy work center capacity.” (påverkar den beräknade planen men tar inte produktionsgruppens kapacitet i anspråk). Var noggrann med omräkningen vid import.
- Besked om materialtillgång. Classic APS kräver att allt material finns tillgängligt i full mängd. SkyPlanner planerar utifrån lagersaldo och inkommande inköpsorder per datum. Kom överens om vilket besked planerarna ska följa.
- API-gränser. Antalet anrop per minut styrs av licensen. Läs bara in ändringar och använd pushnotiser i stället för fullständiga omladdningar.
Vem konfigurerar och ger support för Acumatica-integrationen?
- SkyPlanner-teamet konfigurerar integrationen under introduktionen och ger support efter driftsättningen. Varje fabrik använder Acumatica på sitt eget sätt, och den kunskapen kommer till nytta här.
- Er Acumatica-partner kan delta. Partnern känner till era anpassningar, Generic Inquiries och roller. SkyPlanner tillhandahåller REST API, dokumentation för Swagger/OpenAPI och webhooks.
- Era egna utvecklare kan bygga vidare mot samma REST API med en API-token. Det räcker med en API-token för att komma igång, och SkyPlanner-teamet hjälper till vid behov. Laboratory & Allied valde den här vägen för SAP Business One: företagets interna IT-team byggde till stor del integrationen på egen hand, med hjälp från SkyPlanner.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen utifrån era processer och behov, tillsammans med abonnemanget, så att ni ser hela kostnaden innan ni börjar. Se hur Acumaticas eget APS står sig i Finplanering i Acumatica, läs översikten på Acumatica-sidan och se andra system i översikten över ERP-integrationer.
Tillverkningsföretagens omdömen om SkyPlanner
2 hsparas varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-ark till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90%, och det tar under 30 minuter att ta fram en optimerad tremånadersplan för alla produktionsgrupper.
1 000-talsarbetsorder planeras automatiskt
”Vi har kontroll över produktionen på ett annat sätt, och vår förståelse för kapaciteten är på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriella blandare, pumpar och högteknologisk kontraktstillverkning
Tusentals arbetsorder planeras automatiskt, och hela organisationen får en realtidsbild av produktionen.
99,2%leveransprecision
”SkyPlanner har gjort det lättare att se flaskhalsar och gjort produktionsstyrningen tydligare.”
Toni Tuori, produktionschef
Piristeel · Taksäkerhet och takavvattningssystem
Leveransprecisionen nådde 99,2% i år, och produktionsplaneringen sparar upp till fyra timmars arbetstid per dag.
Vanliga frågor
Omfattar Acumaticas API tillverkningsorder?
Ja. Det kontraktsbaserade REST API:ets Manufacturing-endpoint ger åtkomst till ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool och registreringar av arbetstid och förflyttningar samt åtgärder som FirmProductionOrder.
Vem bygger Acumatica-integrationen?
SkyPlanner-teamet konfigurerar tvåvägsintegrationen för er Acumatica-miljö under introduktionen och ger support efter driftsättningen. Er Acumatica-partner eller era egna utvecklare kan också bygga mot SkyPlanners dokumenterade REST API. Det räcker med en API-token för att komma igång.
Behöver vi Acumatica APS för den här integrationen?
Nej. Acumaticas egen planeringskörning med hänsyn till tillgänglig kapacitet görs i formuläret Rough Cut Planning. Classic APS planerar order som slutar senare än 120 dagar framåt med obegränsad kapacitet (källa). SkyPlanner skapar själv den detaljerade planen med hänsyn till tillgänglig kapacitet utifrån tillverkningsorder, operationer, produktionsgrupper, maskiner och verktyg. Integrationen fungerar därför oavsett om APS är aktiverat eller inte. Acumatica anger att APS ”is subject to licensing” (kräver licens). Autopilot håller planen aktuell, och operatörerna registrerar arbetet med Mobile Confirmations.
Hur hindrar vi Acumatica APS från att skriva över SkyPlanners datum?
SkyPlanner låser varje tillverkningsorder efter att ha skrivit dess operationsdatum. Acumaticas finplanering planerar inte om låsta order.
Kan Acumatica skicka ändringar i realtid?
Ja. Med Push notifications (SM302000) för en Generic Inquiry skickas ändrade rader till en URL så snart ändringarna sker. SkyPlanners egna webhooks skickar planändringar åt andra hållet.
Vilken autentisering ska integrationen använda?
OAuth 2.0 via en klient registrerad i Connected Applications (SM303010), med en särskild integrationsanvändare och roller med minsta nödvändiga behörighet. Flödet för er instans bekräftas under kartläggningen.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper och importera Excel- eller CSV-filer från en Generic Inquiry i Acumatica. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.
