Integrasjoner / ERP / Acumatica Cloud ERP
Veiledning for Acumatica-integrasjon: produksjonsplanlegging med SkyPlanner APS
Denne veiledningen viser partnere og IT-team hvordan de kobler Acumatica Cloud ERP (Manufacturing Edition) til SkyPlanner APS. Integrasjonen mellom SkyPlanner og Acumatica går begge veier:
- Produksjonsordrer med tilhørende operasjoner, arbeidssentre, maskiner, verktøy, skift, lagervarer og innkjøpsordrer overføres til SkyPlanner.
- Planlagte start- og sluttdatoer skrives til operasjonene på produksjonsordren, og ordren fastlåses.
- Operatørenes tidsregistreringer sendes tilbake som arbeids- og flytteposteringer.
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet tilpasser integrasjonen til Acumatica-oppsettet ditt under innføringen og følger den opp etter produksjonssetting. Denne veiledningen er for partnere og utviklere som vil delta i arbeidet eller selv bygge videre på det dokumenterte REST API-et til SkyPlanner (API-referanse).
Integrasjonsgrensesnitt i Acumatica
Integrasjonen bruker grensesnitt som allerede følger med Acumatica. Ingenting installeres i instansen.
- Kontraktbasert REST API. Endepunktene er versjonerte og følger programvareversjonen. Endepunktet Manufacturing (for eksempel 26.200.001 for 2026 R2) gir tilgang til
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryogMaterialEntry. Endepunktet Default dekkerStockItem,PurchaseOrderogSalesOrder. URL-ene følger mønsteret{instance}/entity/{Endpoint}/{version}/{Entity}. - Handlinger på samme endepunkt.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryogReleaseMaterialEntrykjører samme logikk som knappene i skjermbildene. - OData. Alle Generic Inquiry-spørringer (SM208000) kan gjøres tilgjengelige via OData. En Generic Inquiry-spørring med åpne produksjonsoperasjoner og datoer er den raskeste måten å hente disse dataene samlet på.
- Pushvarsler (SM302000). Disse bygger på en Generic Inquiry-spørring eller en innebygd spørring og sender innsatte og slettede rader til en URL du angir.
- Import- og eksportscenarioer med dataleverandører for CSV og Excel til masseinnlasting.
Entiteter og handlinger er oppført i Web Service Endpoints (SM207000) og i Acumaticas kodelager for REST-klienten.
Autentisering og begrensninger
Acumatica bruker OAuth 2.0 og OpenID Connect via klientapplikasjoner som registreres i Connected Applications (SM303010). De dokumenterte autentiseringsflytene er Authorization Code, Implicit, Resource Owner Password Credentials og Hybrid. For en serverintegrasjon registrerer du en egen integrasjonsbruker med roller som bare gir nødvendige rettigheter. Bruk Authorization Code med et oppdateringstoken eller Resource Owner Password Credentials.
Lisensen din setter grensene: License Monitoring Console (SM604000) viser tillatt antall API-kall per minutt og API-brukere.
Hos SkyPlanner bruker REST API-et et API-token til autentisering (SkyPlanner Settings > API) og er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen tar deg gjennom de første kallene.
Datakobling
| Acumatica-objekt (endepunkt / skjermbilde) | SkyPlanner-objekt | Retning | Frekvens |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkter og materialer | Acumatica → SkyPlanner | Først full innlasting, deretter bare endringer |
BillOfMaterial (AM208000): materialer, operasjoner | Produktstruktur, delprodukter, materialer per produkt | Acumatica → SkyPlanner | Første innlasting, deretter ved endringer |
| BOM-operasjoner: Setup, Run, Machine, Queue, Finish, Move Time | Prosesstrinn med varighet, omstillingstid og nedriggingstid | Acumatica → SkyPlanner | Første innlasting, deretter ved endringer |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Arbeidsstasjoner, grupper av arbeidsstasjoner, effektivitetsgrader, alternative arbeidsstasjoner | Acumatica → SkyPlanner | Første innlasting, sjelden etterpå |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Skift og bemanningskapasitet | Acumatica → SkyPlanner | Daglig, eller skiftene vedlikeholdes i SkyPlanner |
Tool (AM205500) | Verktøy som ressurser med begrenset kapasitet | Acumatica → SkyPlanner | Første innlasting |
ProductionOrder med OrderOperationDetail (Planned, Released, In Process) | Ordrer og jobber med leveringsfrister, kjøreprioritet og materialbehov | Acumatica → SkyPlanner | Pushvarsel eller polling med noen minutters mellomrom |
PurchaseOrder-linjer (Default) | Innkjøpsordrer med forventet leveringsdato | Acumatica → SkyPlanner | Polling hver time eller når planen beregnes |
| Varebeholdning per lager | Lagerbeholdning | Acumatica → SkyPlanner | Polling hver time eller når planen beregnes |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Planlagt start, slutt og arbeidsstasjon per operasjon | SkyPlanner → Acumatica | Ved planendringer, via en webhook fra SkyPlanner |
Handlingen FirmProductionOrder | Låser de tilbakeskrevne datoene slik at Acumatica APS ikke endrer dem | SkyPlanner → Acumatica | Etter hver tilbakeskriving |
LaborEntry, MoveEntry med tilhørende frigivelseshandlinger | Tidsregistreringer, ferdigmeldte mengder, operatørbekreftelser | SkyPlanner → Acumatica | Per bekreftelse eller per skift |
| Finnes ikke i Acumatica | Matrise for omstillingstider, navngitte operatører, jobber med flere operatører | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
Integrasjonsmønstre
1. Første innlasting av grunndata. Les først inn arbeidssentre, maskiner, verktøy, skift og kalendere. Les deretter inn lagervarer og stykklister. Avgjør hvordan et arbeidssenter med flere maskiner skal modelleres: som én gruppe med maskinene som arbeidsstasjoner, eller som én arbeidsstasjon. Feltet Basis for Capacity i Acumatica viser hvilken modell fabrikken bruker.
2. Ordresynkronisering. Les produksjonsordrer med operasjoner fra selve ordren, ikke fra BOM. Operasjonene kopieres til ordren, og planleggerne endrer dem der. Sett opp pushvarsler fra en Generic Inquiry-spørring med åpne ordrer og operasjoner, eller bruk polling mot spørringen. Les også åpne innkjøpsordrelinjer. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered.
3. Tilbakeskriving av planen. For hver operasjon som planleggingsmotoren har plassert eller flyttet, skriver SkyPlanner StartDate og EndDate til OrderOperationDetail. Arbeidssenteret skrives også tilbake hvis arbeidet er flyttet til et alternativt arbeidssenter. Deretter kalles FirmProductionOrder. Acumatica: «When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.» (Når du kjører produksjonsplanlegging som tar hensyn til tilgjengelig kapasitet, planlegger ikke systemet fastlåste produksjonsordrer på nytt.) (kilde)
4. Bekreftelser fra produksjonsgulvet. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer. Tidsregistreringene blir til LaborEntry-dokumenter (tid og ferdigmeldt mengde per operasjon) eller MoveEntry-dokumenter (bare mengde), som frigis med den tilhørende handlingen. Hvis produksjonen allerede rapporterer i Acumatica via Labor (AM301000) eller Shop Floor Kiosk, går fremdriftsdataene motsatt vei. Velg én kanal, aldri begge.
5. Dataeierskap og konfliktregler. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Lagervarer, stykklister, mengder, ordrestatus, kostnadsberegning | Acumatica |
| Operasjonsrekkefølge, start- og sluttider, tildeling av arbeidsstasjon | SkyPlanner |
| Matrise for omstillingstider, verktøy, operatørkrav, alternativer | SkyPlanner |
| Skift og fravær | Ett system, valgt under avklaringen |
| Arbeids- og flyttetransaksjoner | Acumatica, bokført fra tidsregistreringer i SkyPlanner eller registrert på produksjonsgulvet |
Acumaticas eget APS er den viktigste kilden til konflikter. Rough Cut Planning eller APS Maintenance Process kan beregne datoene på nytt for ordrer som SkyPlanner har planlagt. Ved å låse hver ordre etter tilbakeskriving hindrer dere dette. Utelat også planlagte ordrer fra APS-kjøringer.
Typiske prosjekttrinn
Implementeringen er normalt ferdig i løpet av noen uker etter at innføringen starter. Før det kan dere bruke egne data i den gratis prøveperioden på 30 dager. Eksporter arbeidssentre og åpne produksjonsordrer med tilhørende operasjoner fra en Generic Inquiry til Excel. Importer dem, og kontroller produksjonsplanen.
- Feltkoblinger. Fastsett koblingstabellen, reglene for dataeierskap, synkroniseringsfrekvensene og kanalen for bokføring av arbeidstid.
- Tilgang. Registrer den tilkoblede applikasjonen, opprett integrasjonsbrukeren og rollene, og bekreft endepunktversjonen i Web Service Endpoints. Start i et testmiljø.
- Første innlasting. Arbeidssentre, maskiner, verktøy, skift, lagervarer og stykklister.
- Ordresynkronisering. Produksjonsordrer, operasjoner og innkjøpsordrer via pushvarsler eller periodisk avspørring.
- Oppsett av begrensninger i SkyPlanner. Matrise for omstillingstider, navngitte operatører, jobber med flere operatører og alternativer.
- Tilbakeskriving. Operasjonsdatoer, låsing av ordrer og registreringer av arbeidstid eller flytting.
- Parallellkjøring. Sammenlign datoene fra SkyPlanner med gjeldende plan, og rett opp grunndataene.
- Produksjonssetting. Slå på tilbakeskriving når dataene stemmer overens.
Dette bør dere ta høyde for i en Acumatica-integrasjon
- Sjekk hvilken APS-motor som er aktiv. Classic og Optimized lagrer innstillingene hver for seg, og bare én kan være aktivert. Sjekk Enable/Disable Features (CS100000) før første tilbakeskriving.
- Lås endepunktversjonen. Versjonen er en del av URL-en. En programvareoppgradering legger til en ny versjon, så test på nytt ved hver oppgradering.
- Oppdatering av operasjoner. Enkelte operasjonsfelt er skrivebeskyttet via REST, og ordrestatusen har betydning. Test rekkefølgen for tilbakeskriving på ordrer med status Released og In Process i et testmiljø.
- Enheter og tidsfelt. Kjøretid angis per Run Units, maskintid per Machine Units. Køtid og flyttetid «affect the calculated schedule but do not occupy work center capacity.» (påvirker den beregnede planen, men beslaglegger ikke kapasitet i arbeidssenteret). Vær nøye med konverteringen ved import.
- Materialtilgjengelighet. Classic APS krever at alt materiale er tilgjengelig i sin helhet. SkyPlanner planlegger ut fra lagerbeholdning og innkommende innkjøpsordrer med tilhørende datoer. Avtal hvilket resultat planleggerne skal forholde seg til.
- API-grenser. Lisensen bestemmer antall forespørsler per minutt. Bruk endringsbaserte uthentinger og pushvarsler, ikke fullstendige innlastinger.
Hvem setter opp og støtter Acumatica-integrasjonen?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter produksjonssetting. Hver fabrikk bruker Acumatica på sin måte, og denne kunnskapen tas med i oppsettet.
- Acumatica-partneren deres kan delta. Partneren kjenner tilpasningene, Generic Inquiries og rollene deres. SkyPlanner stiller med REST API, Swagger/OpenAPI-dokumentasjon og webhooks.
- Egne utviklere kan bygge videre på integrasjonen via samme REST API med et API-token. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov. Laboratory & Allied valgte denne løsningen for SAP Business One: Den interne IT-avdelingen bygget i stor grad integrasjonen selv, med hjelp fra SkyPlanner.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og månedlig fakturering. Dere får et pristilbud på integrasjonen sammen med abonnementet, tilpasset prosessene og behovene deres. Dermed ser dere totalkostnaden før dere starter. Se hvordan Acumaticas eget APS kommer ut i sammenligningen i produksjonsplanlegging med Acumatica innenfor reell kapasitet, få oversikt på Acumatica-siden, og finn andre systemer i oversikten over ERP-integrasjoner.
Produsenters erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til optimalisering av produksjonen i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 arbeidstimer hver uke, og en ny arbeidskø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder på tvers av alle arbeidsstasjoner.
1 000-tallsarbeidsordrer planlagt automatisk
«Vi har kontroll på produksjonen på en helt annen måte, og forståelsen vår av kapasiteten er på et helt annet nivå.»
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle miksere, pumper og høyteknologisk kontraktsproduksjon
Tusenvis av arbeidsordrer planlegges automatisk, og hele organisasjonen har oversikt over produksjonen i sanntid.
99,2%leveringspålitelighet
«SkyPlanner har gjort det lettere å se flaskehalser og gitt oss bedre oversikt over produksjonsstyringen.»
Toni Tuori, produksjonssjef
Piristeel · Taksikring og regnvannssystemer
Leveringspåliteligheten nådde 99,2% i år, og produksjonsplanleggingen sparer opptil fire arbeidstimer per dag.
Ofte stilte spørsmål
Omfatter Acumaticas API produksjonsordrer?
Ja. Manufacturing-endepunktet i det kontraktsbaserte REST API-et gir tilgang til ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool og registreringer av arbeidstid og flytting, samt handlinger som FirmProductionOrder.
Hvem bygger Acumatica-integrasjonen?
SkyPlanner-teamet setter opp toveisintegrasjonen for deres Acumatica-oppsett under innføringen og gir støtte etter produksjonssetting. Acumatica-partneren eller egne utviklere kan også bygge videre på SkyPlanners dokumenterte REST API. Et API-token er nok for å komme i gang.
Trenger vi Acumatica APS for denne integrasjonen?
Nei. Acumaticas egen planleggingskjøring med begrenset kapasitet gjøres i skjermbildet Rough Cut Planning. Classic APS planlegger ordrer som avsluttes etter mer enn 120 dager, med ubegrenset kapasitet (kilde). SkyPlanner lager selv en detaljert produksjonsplan innenfor reell kapasitet ut fra produksjonsordrer, operasjoner, arbeidssentre, maskiner og verktøy. Integrasjonen fungerer derfor uansett om APS er aktivert eller ikke. Acumatica opplyser at APS «is subject to licensing» (krever lisens). Autopilot holder planen oppdatert, og operatørene registrerer arbeid med Mobile Confirmations.
Hvordan hindrer vi at Acumatica APS overskriver datoene fra SkyPlanner?
SkyPlanner låser hver produksjonsordre etter å ha skrevet operasjonsdatoene. Acumaticas produksjonsplanlegging med begrenset kapasitet planlegger ikke låste ordrer på nytt.
Kan Acumatica sende endringer i sanntid?
Ja. Push notifications (SM302000) på en Generic Inquiry sender endrede rader til en URL fortløpende. SkyPlanners egne webhooks sender planendringer i motsatt retning.
Hvilken autentisering bør integrasjonen bruke?
OAuth 2.0 via en klient registrert i Connected Applications (SM303010), med en egen integrasjonsbruker og roller som bare gir nødvendige rettigheter. Autentiseringsflyten for deres instans bekreftes under avklaringen.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med Excel- eller CSV-import fra en Generic Inquiry i Acumatica. Kredittkort er ikke nødvendig. Start prøveperioden, eller snakk med salg for å avklare omfanget av integrasjonen.
