Integrationer / ERP / Acumatica Cloud ERP
Guide til Acumatica-integration til produktionsplanlægning med SkyPlanner APS
Denne guide til Acumatica-integration viser partnere og IT-teams, hvordan de forbinder Acumatica Cloud ERP (Manufacturing Edition) med SkyPlanner APS. Integrationen mellem SkyPlanner og Acumatica fungerer i begge retninger:
- Produktionsordrer med tilhørende operationer samt arbejdscentre, maskiner, værktøjer, skift, lagervarer og indkøbsordrer overføres til SkyPlanner.
- Planlagte start- og slutdatoer skrives til produktionsordrens operationer, og ordren fastlåses.
- Operatørernes tidsregistreringer sendes tilbage som arbejds- og flytteposteringer.
- SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres Acumatica-opsætning under opstarten og yder support, når den er sat i drift. Denne guide er til partnere og udviklere, der vil deltage eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Acumaticas integrationsgrænseflader
Integrationen bruger de grænseflader, der allerede følger med Acumatica. Der installeres ikke noget i instansen.
- Kontraktbaseret REST API. Endpoints er versionsstyrede og følger udgivelsen. Endpointet Manufacturing (for eksempel 26.200.001 til 2026 R2) giver adgang til
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryogMaterialEntry. Endpointet Default dækkerStockItem,PurchaseOrderogSalesOrder. URL’er følger formatet{instance}/entity/{Endpoint}/{version}/{Entity}. - Handlinger på samme endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryogReleaseMaterialEntryudfører samme logik som knapperne i skærmbillederne. - OData. Enhver Generic Inquiry (SM208000) kan gøres tilgængelig via OData. En Generic Inquiry med åbne produktionsoperationer og deres datoer er den hurtigste måde at læse store datamængder på.
- Pushbeskeder (SM302000). De bygger på en Generic Inquiry eller en indbygget forespørgsel og sender indsatte og slettede rækker til en URL, som I angiver.
- Import- og eksportscenarier med CSV- og Excel-providere til indlæsning af store datamængder.
Entiteter og handlinger er angivet i Web Service Endpoints (SM207000) og i Acumaticas kodelager til REST-klienten.
Godkendelse og grænser
Acumatica bruger OAuth 2.0 og OpenID Connect via klientapplikationer, der registreres i Connected Applications (SM303010). De dokumenterede flows er Authorization Code, Implicit, Resource Owner Password Credentials og Hybrid. Til en serverintegration skal I oprette en særskilt integrationsbruger med roller, der kun giver de nødvendige rettigheder, og bruge Authorization Code med et refresh-token eller Resource Owner Password Credentials.
Jeres licens sætter grænsen: License Monitoring Console (SM604000) viser det tilladte antal API-kald pr. minut og API-brugere.
Hos SkyPlanner sker godkendelsen til REST API med et API-token (SkyPlanner Settings > API), og API’et er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Datamapping
| Acumatica-objekt (endpoint / skærmbillede) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkter og materialer | Acumatica → SkyPlanner | Først en fuld indlæsning, derefter kun ændringer |
BillOfMaterial (AM208000): materialer, operationer | Produktstruktur, delprodukter, materialer pr. produkt | Acumatica → SkyPlanner | Ved første indlæsning, derefter ved ændringer |
| BOM-operationer: Setup, Run, Machine, Queue, Finish, Move Time | Procestrin med varighed, opstillings- og nedtagningstider | Acumatica → SkyPlanner | Ved første indlæsning, derefter ved ændringer |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Arbejdsstationer, grupper af arbejdsstationer, effektivitetsgrader, alternative arbejdsstationer | Acumatica → SkyPlanner | Ved første indlæsning, sjældent derefter |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Skift og personalekapacitet | Acumatica → SkyPlanner | Dagligt, eller skift vedligeholdes i SkyPlanner |
Tool (AM205500) | Værktøjer som ressourcer med begrænset kapacitet | Acumatica → SkyPlanner | Ved første indlæsning |
ProductionOrder med OrderOperationDetail (Planned, Released, In Process) | Ordrer og job med leveringsfrister, prioritet i produktionen og materialebehov | Acumatica → SkyPlanner | Pushbesked eller polling med få minutters mellemrum |
PurchaseOrder-linjer (Default) | Indkøbsordrer med forventet leveringsdato | Acumatica → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| Varebeholdninger pr. lager | Lagerbeholdninger | Acumatica → SkyPlanner | Polling hver time eller ved planlægningskørsel |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Planlagt start, slut og arbejdsstation pr. operation | SkyPlanner → Acumatica | Ved ændringer i planen via en SkyPlanner-webhook |
Handlingen FirmProductionOrder | Låser de overførte datoer, så Acumatica APS ikke ændrer dem | SkyPlanner → Acumatica | Efter hver tilbageskrivning |
LaborEntry, MoveEntry med frigivelseshandlinger | Tidsregistreringer, færdigmeldte mængder, operatørtilbagemeldinger | SkyPlanner → Acumatica | Pr. tilbagemelding eller pr. skift |
| Findes ikke i Acumatica | Matrix for omstillingstider, navngivne operatører, job med flere operatører | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Læs først arbejdscentre, maskiner, værktøjer, skift og kalendere. Læs derefter lagervarer og styklister. Beslut, hvordan et arbejdscenter med flere maskiner skal afbildes: som én gruppe af arbejdsstationer med hver maskine som en arbejdsstation eller som én arbejdsstation. Feltet Basis for Capacity i Acumatica viser, hvilken tilgang fabrikken bruger.
2. Synkronisering af ordrer. Læs produktionsordrer og deres operationer fra ordren, ikke fra styklistegrundlaget (BOM). Operationerne kopieres til ordren, og det er her, planlæggerne ændrer dem. Opsæt pushbeskeder fra en Generic Inquiry med åbne ordrer og operationer, eller brug polling. Læs også åbne indkøbsordrelinjer. SkyPlanner regner bestilt materiale som tilgængeligt på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered.
3. Tilbageskrivning af planen. For hver operation, som planlægningsmotoren har placeret eller flyttet, skriver SkyPlanner StartDate og EndDate til OrderOperationDetail. Arbejdscentret skrives også, hvis arbejdet er flyttet til et alternativt arbejdscenter. Derefter kaldes FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Når I kører produktionsplanlægning, der tager højde for den faktiske maskin- og personalekapacitet, omplanlægger systemet ikke de fastlåste produktionsordrer.) (kilde)
4. Tilbagemeldinger fra produktionsgulvet. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer. Tidsregistreringerne bliver til LaborEntry-dokumenter (tid og færdigmeldt mængde pr. operation) eller MoveEntry-dokumenter (kun mængde), som frigives med den tilhørende handling. Hvis I allerede registrerer fremdrift i Acumatica via Labor (AM301000) eller Shop Floor Kiosk, sendes fremdriften den anden vej. Vælg én kanal, aldrig begge.
5. Regler for dataejerskab og konflikter. Skriv dem ned, inden integrationen sættes i drift:
| Data | Ejer |
|---|---|
| Lagervarer, styklister, mængder, ordrestatus, omkostningsberegning | Acumatica |
| Operationsrækkefølge, start- og sluttidspunkter, tildeling af arbejdsstationer | SkyPlanner |
| Matrix for omstillingstider, værktøjer, operatørkrav, alternativer | SkyPlanner |
| Skift og fravær | Ét system, som vælges under afklaringen |
| Arbejds- og flytteposteringer | Acumatica, bogført fra SkyPlanners tidsregistreringer eller registreret på produktionsgulvet |
Den primære kilde til konflikter er Acumaticas eget APS. Rough Cut Planning eller APS Maintenance Process kan genberegne datoer på ordrer, som SkyPlanner har planlagt. Det forhindres ved at fastlåse hver ordre efter tilbageskrivning. Udeluk også de planlagte ordrer fra APS-kørsler.
Typiske trin i projektet
Implementeringen afsluttes normalt i ugerne efter starten på onboarding. Inden da kan I bruge jeres egne data i den gratis prøveperiode på 30 dage. Eksportér arbejdscentre og åbne produktionsordrer med tilhørende operationer fra en Generic Inquiry til Excel, importér dem, og kontrollér planen.
- Datamapping. Fastlæg mappingtabellen, reglerne for dataejerskab, synkroniseringshyppigheden og kanalen til bogføring af arbejdstid.
- Adgang. Registrér den tilsluttede applikation, opret integrationsbrugeren og rollerne, og bekræft endpointversionen i Web Service Endpoints. Start i en sandbox.
- Første indlæsning. Arbejdscentre, maskiner, værktøjer, skift, lagervarer og styklister.
- Ordresynkronisering. Produktionsordrer, operationer og indkøbsordrer via pushnotifikationer eller polling.
- Opsætning af begrænsninger i SkyPlanner. Matrix for omstillingstider, navngivne operatører, job med flere operatører og alternativer.
- Tilbageskrivning. Operationsdatoer, fastlåsning af ordrer samt arbejds- eller flytteposteringer.
- Paralleldrift. Sammenlign SkyPlanners datoer med den nuværende plan, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når data stemmer overens.
Det skal I tage højde for i en Acumatica-integration
- Kontrollér, hvilken APS-motor der er aktiv. Classic og Optimized gemmer indstillinger hver for sig, og kun den ene kan være aktiveret. Kontrollér Enable/Disable Features (CS100000) før den første tilbageskrivning.
- Lås endpointversionen. Versionen er en del af URL’en. En opgradering tilføjer en ny version, så test igen ved hver opgradering.
- Opdatering af operationer. Nogle operationsfelter kan kun læses via REST, og ordrens status har betydning. Test rækkefølgen for tilbageskrivning på ordrer med status Released og In Process i en sandbox.
- Enheder og tidsfelter. Kørselstid angives pr. Run Units og maskintid pr. Machine Units. Kø- og flyttetid “affect the calculated schedule but do not occupy work center capacity.” (påvirker den beregnede plan, men optager ikke kapacitet i arbejdscentret). Vær omhyggelig med omregningen ved import.
- Vurdering af materialetilgængelighed. Classic APS kræver, at alle materialer er tilgængelige i fuldt omfang. SkyPlanner planlægger ud fra lagerbeholdningen og indgående indkøbsordrer med deres datoer. Aftal, hvilken vurdering planlæggerne skal følge.
- API-grænser. Licensen bestemmer antallet af forespørgsler pr. minut. Brug indlæsning af ændringer og pushnotifikationer frem for at genindlæse alle data.
Hvem opsætter og supporterer Acumatica-integrationen?
- SkyPlanner-teamet opsætter integrationen under onboarding og yder support efter idriftsættelsen. Hver fabrik bruger Acumatica på sin egen måde, og den viden bliver bragt i spil her.
- Jeres Acumatica-partner kan deltage. Partneren kender jeres tilpasninger, Generic Inquiries og roller. SkyPlanner stiller REST API, Swagger/OpenAPI-dokumentation og webhooks til rådighed.
- Jeres egne udviklere kan bygge videre på integrationen via det samme REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. Laboratory & Allied valgte denne vej med SAP Business One: Virksomhedens interne IT-team byggede i vid udstrækning selv integrationen med hjælp fra SkyPlanner.
SkyPlanner koster fra 199 € om måneden med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen, tilpasset jeres proces og behov, sammen med prisen på abonnementet. Dermed kender I den samlede pris, før I går i gang. Se, hvordan Acumaticas eget APS klarer sig i sammenligningen på siden om produktionsplanlægning med begrænset kapacitet i Acumatica, få overblikket på Acumatica-siden, og se andre systemer i oversigten over ERP-integrationer.
Produktionsvirksomheders erfaringer med SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-ark til optimering af produktionen i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny jobkø når frem til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
1.000-vis afarbejdsordrer planlagt automatisk
“Vi har styr på produktionen på en helt anden måde, og vores forståelse af kapaciteten er på et helt andet niveau.”
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle blandere, pumper og højteknologisk kontraktproduktion
Tusindvis af arbejdsordrer planlægges automatisk, og hele organisationen har et overblik over produktionen i realtid.
99,2%leveringssikkerhed
“SkyPlanner har gjort det lettere at få øje på flaskehalse og gjort produktionsstyringen mere overskuelig.”
Toni Tuori, produktionschef
Piristeel · Tagsikkerhedsudstyr og regnvandssystemer
Leveringssikkerheden nåede op på 99,2% i år, og detailplanlægningen sparer op til fire timers arbejdstid om dagen.
Ofte stillede spørgsmål
Omfatter Acumaticas API produktionsordrer?
Ja. Manufacturing-endpointet i det kontraktbaserede REST API giver adgang til ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool samt arbejds- og flytteposteringer og handlinger som FirmProductionOrder.
Hvem bygger Acumatica-integrationen?
SkyPlanner-teamet tilpasser tovejsintegrationen til jeres Acumatica-opsætning under onboarding og yder support efter idriftsættelsen. Jeres Acumatica-partner eller egne udviklere kan også bygge videre på SkyPlanners dokumenterede REST API, og et API-token er nok til at komme i gang.
Har vi brug for Acumatica APS til denne integration?
Nej. Acumaticas egen planlægning med begrænset kapacitet køres via formularen Rough Cut Planning, og Classic APS planlægger ordrer med slutdato mere end 120 dage frem med ubegrænset kapacitet (kilde). SkyPlanner laver selv den detaljerede produktionsplan ud fra produktionsordrer, operationer, arbejdscentre, maskiner og værktøjer med respekt for den faktiske kapacitet. Integrationen virker derfor, uanset om APS er aktiveret eller ej. Acumatica oplyser, at APS “is subject to licensing” (kræver licens). Autopilot holder planen opdateret, og operatørerne registrerer arbejdet med Mobile Confirmations.
Hvordan forhindrer vi Acumatica APS i at overskrive SkyPlanners datoer?
SkyPlanner fastlåser hver produktionsordre efter at have skrevet operationsdatoerne. Acumaticas produktionsplanlægning med begrænset kapacitet omplanlægger ikke fastlåste ordrer.
Kan Acumatica sende ændringer i realtid?
Ja. Pushnotifikationer (SM302000) på en Generic Inquiry sender ændrede rækker til en URL, så snart ændringerne sker. SkyPlanners egne webhooks sender planændringer den modsatte vej.
Hvilken godkendelsesmetode skal integrationen bruge?
OAuth 2.0 via en klient registreret i Connected Applications (SM303010), med en dedikeret integrationsbruger og roller med færrest mulige rettigheder. Godkendelsesforløbet for jeres instans bekræftes under afklaringen.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med import af Excel- eller CSV-filer fra en Acumatica Generic Inquiry. Der kræves ikke kreditkort. Start prøveperioden, eller tal med salg for at afklare integrationens omfang.
