Integrationer / ERP / Exact
Integrationsguide för Exact Online för produktionsplanering med SkyPlanner APS
Den här integrationsguiden för Exact Online visar Exact-partner och IT-team hur de ansluter Exact Online Manufacturing till SkyPlanner APS. Integrationen mellan SkyPlanner och Exact Online fungerar i båda riktningarna:
- Tillverkningsorder, steg i operationsföljden, materialplaner, produktionsgrupper, operationer och stycklistor läses in via Exact Online REST API.
- Artiklar, lagersaldon, inköpsorder och kundorder läses in, och ändringar meddelas via webhooks från Exact Online.
- Planerade start- och slutdatum skrivs tillbaka till varje steg i operationsföljden och till tillverkningsordern.
- Operatörernas tidrapportering bokförs som tidstransaktioner och färdiga kvantiteter som inleveranser från tillverkningsorder.
SkyPlanner-teamet anpassar integrationen till er konfiguration av Exact Online under införandet och ger support efter driftstart. 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). Sist finns ett kort avsnitt om Exact Globe+.
Exact Online REST API för tillverkning
Exact Online gör sina data tillgängliga via ett REST API, där resurserna är grupperade efter tjänst. Bassökvägen är /api/v1/{division}/<service>/<resource>, där division anger företaget i Exact Online. I referensen för REST API listas följande resurser för produktionsplanering under tillverkningstjänsten:
| Resurs | Innehåll | Metoder |
|---|---|---|
manufacturing/ShopOrders | Tillverkningsordernummer, artikel, PlannedQuantity, PlannedStartDate, PlannedDate, status, frisläppningsflagga | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Steg i operationsföljden per tillverkningsorder: operation, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Materialrader per tillverkningsorder | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Kod, typ, produktionsområde, kapacitetsvärde, kostnadssatser | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operationer med tillhörande produktionsgrupp samt ställ- och körtider | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Stycklisteversioner, komponenter och operationsföljd | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Rapporterade timmar per tillverkningsorder och steg i operationsföljden | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Färdiga kvantiteter som inlevererats från en tillverkningsorder | GET, POST |
manufacturing/MaterialIssues | Material som tagits ut till en tillverkningsorder | GET, POST |
manufacturing/ShopOrderPriorities | Prioriteringsläge per tillverkningsorder | GET, PUT |
Från övriga tjänster:
| Resurs | Innehåll |
|---|---|
logistics/Items | Artikelregister |
inventory/ItemWarehouses | Lagersaldo per artikel och lager |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Öppna inköpsorder och inleveransdatum |
salesorder/SalesOrders, SalesOrderLines | Kundbehov och leveransdatum |
Autentisering och åtkomst
Exact Online använder OAuth 2.0 med authorization code-flödet och refresh tokens. Exact skriver: ”Before you can start integration with Exact Online, you must first register your app in the App Store.” (Innan du kan börja integrera med Exact Online måste du först registrera din app i App Store.) (Hjälp för Exact Online) För att registrera appar krävs en prenumeration på Exact Online Developer (Exact App Store).
- Integrationen registreras som en app med en omdirigerings-URI.
- En Exact Online-användare med åtkomst till tillverkning, lager och inköp ger sitt samtycke en gång.
- Varje anrop skickar
Authorization: Bearer <access_token>och anger företaget i sökvägen. - Åtkomsttoken förnyas med en refresh token. Exact begränsar hur ofta en ny token får begäras, så behåll token i cachen tills den löper ut.
Exact begränsar också antalet anrop per minut och dag för varje app och företag och ber att anrop görs sekventiellt i stället för parallellt. Aktuella gränser finns i Exacts artikel om API-gränser. Integrationen är utformad efter dessa gränser: filtrerad läsning med $filter och $select samt Sync API för massändringar.
På SkyPlanner-sidan sker autentiseringen för REST API med en API-token i headern Authorization-Token (SkyPlanner Settings > API). API:et är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Webhooks och pollning
Exact Online skickar via webhooks ett POST-anrop till er callback-URL när något ändras inom ett ämne ni prenumererar på. Anropet signeras med en HMAC SHA256-hash (webhooks). Ämnena omfattar Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders och SalesOrderLines. På så sätt skickas ändringar i lager, inköp och kundbehov till SkyPlanner när de sker.
Tillverkningsorder och steg i operationsföljden läses in med schemalagda intervall. Filtrera ShopOrders och ShopOrderRoutingStepPlans på Modified och använd Sync API för massläsning (API-begränsningar).
SkyPlanner skickar egna webhooks när produktionsplanen ändras, så återskrivningen till Exact Online är händelsestyrd.
Datamappning
| Resurs i Exact Online | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
Items | Produkter och material | Exact Online → SkyPlanner | Inläsning, därefter webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Produktstruktur, delprodukter, material per produkt | Exact Online → SkyPlanner | Vid ändring |
Workcenters, OperationResources | Produktionsgrupper och grupperingar av produktionsgrupper | Exact Online → SkyPlanner | Första inläsningen |
Operations, BillOfMaterialRoutings | Processteg med ställ- och körtider | Exact Online → SkyPlanner | Vid ändring |
ShopOrders | Order med kvantitet och färdigdatum | Exact Online → SkyPlanner | Med några minuters mellanrum |
ShopOrderRoutingStepPlans | Operationer med ordningsföljd, produktionsgrupp samt ställ- och körtimmar | Exact Online → SkyPlanner | Med några minuters mellanrum |
ShopOrderMaterialPlans | Material per operation | Exact Online → SkyPlanner | Med några minuters mellanrum |
ItemWarehouses, StockPosition | Lagersaldon | Exact Online → SkyPlanner | Webbhook |
PurchaseOrderLines | Inköpsorder med förväntat leveransdatum | Exact Online → SkyPlanner | Webbhook |
SalesOrderLines | Leveransdatum till kund och prioritet | Exact Online → SkyPlanner | Webbhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Planerad start, planerat slut och produktionsgrupp per operation | SkyPlanner → Exact Online | Vid ändring, via webbhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Orderns start och slut | SkyPlanner → Exact Online | Vid ändring, via webbhook |
TimeTransactions (POST) | Tidsregistreringar och operatörskvitteringar | SkyPlanner → Exact Online | Per kvittering eller skift |
ShopOrderReceipts (POST) | Färdig kvantitet i sista operationen | SkyPlanner → Exact Online | Per kvittering |
| Lagras inte i Exact Online | Ställtidsmatris, verktyg som begränsade resurser, operatörer per operation, alternativa produktionsgrupper, skift | Underhålls i SkyPlanner | Uppstart |
Integrationsflöden
1. Första inläsningen av grunddata. Läs in Workcenters, Operations och OperationResources, därefter artiklar och BOM-versioner med tillhörande operationsföljder. En produktionsgrupp med tre maskiner blir tre produktionsgrupper eller en grupp av produktionsgrupper i SkyPlanner. Skift, frånvaro och övertid läggs upp i SkyPlanner, eftersom en produktionsgrupp i Exact har ett enda kapacitetsvärde.
2. Ordersynkronisering. Läs in öppna ShopOrders med tillhörande ShopOrderRoutingStepPlans och ShopOrderMaterialPlans, samt lagersaldon och inköpsorderrader. Planeringen kontrollerar både lagersaldon och inkommande inköp. MRP fortsätter att ge orderförslag i Exact Online, och SkyPlanner planerar de tillverkningsorder du skapar.
3. Återskrivning av planen. För varje operation som planeringsmotorn har lagt in eller flyttat skickar SkyPlanner ett PUT-anrop till ShopOrderRoutingStepPlans med PlannedStartDate, PlannedEndDate och Workcenter. Tillverkningsorderns PlannedStartDate och PlannedDate följer den första respektive sista operationen. Kvantiteter, materialplaner och kostnadskalkyler hanteras fortsatt i Exact Online.
4. Återrapportering från produktionen. Operatörerna registrerar arbetet med SkyPlanner Mobile Confirmations eller Production Timer, och tidsregistreringarna håller planen aktuell. Registrerade timmar överförs som TimeTransactions på tillverkningsordern och operationen, som ställtid eller körtid. Den sista kvitteringen skapar en ShopOrderReceipts-post för den färdiga kvantiteten. Om ni redan registrerar tid i Shop Floor Control, välj en enda kanal för tidsregistreringen.
5. Dataägarskap och konfliktregler. Dokumentera reglerna före driftstart:
| Data | Ägare |
|---|---|
| Artiklar, BOM:ar, kvantiteter på tillverkningsorder, materialplaner, kostnader | Exact Online |
| Operationsföljd, start- och sluttider, tilldelning av produktionsgrupp | SkyPlanner |
| Ställtidsmatris, verktyg, operatörer per operation, alternativa resurser, skift | SkyPlanner |
| Tidstransaktioner och inleveranser | Exact Online, med data från SkyPlanner |
Manuella datumändringar är den vanligaste orsaken till konflikter. Om planerarna fortsätter att ändra datum på tillverkningsorder i Exact Online styr två system samma datum. Låt SkyPlanner styra datumen för operationerna. Med Autopilot planerar SkyPlanner om automatiskt när produktionen förändras.
Vanliga projektsteg
Implementeringen är normalt klar inom några veckor efter att uppstarten har inletts. Validera först planen under den kostnadsfria provperioden på 30 dagar med en CSV- eller Excel-export av öppna tillverkningsorder och operationer. Därefter följer projektet dessa steg:
- Kartläggning. Bekräfta utgåva, divisioner, synkroniseringsintervall, kanal för tidsregistrering och hur inleveranser ska registreras.
- App och samtycke. Registrera appen. Därefter ger en Exact Online-användare OAuth-samtycke för varje division.
- Första inläsningen. Produktionsgrupper, operationer, artiklar, BOM-versioner och operationsföljder.
- Ordersynkronisering. Tillverkningsorder, operationsplaner och materialplaner synkroniseras enligt ett schema, medan lager och inköp synkroniseras via webbhook.
- Inställning av begränsningar i SkyPlanner. Skift, ställtidsmatris, verktyg, antal operatörer per operation samt alternativa maskiner eller personalresurser.
- Återskrivning av planen. Planerade operationsdatum förs över till Exact Online, därefter tidstransaktioner och inleveranser.
- Parallelltestning och driftstart. Jämför datumen med den nuvarande planen, rätta grunddata och aktivera sedan återskrivningen.
Att tänka på inför en integration med Exact Online
- Operationstider.
PlannedSetupHoursochPlannedRunHourshämtas från operationsföljden i BOM:en. Kontrollera först att de stämmer med de faktiska körtiderna. - Indelning av produktionsresurser. Exact har ett kapacitetsvärde per produktionsgrupp. Bestäm hur varje produktionsgrupp i Exact ska representeras i SkyPlanner: som en enda produktionsgrupp, som flera eller som en grupp av produktionsgrupper.
- Kalendrar. Skift, helgdagar och frånvaro hanteras i SkyPlanner. Lägg upp dem före den första planeringen.
- Anropsbudget. Exact begränsar antalet anrop per app och företag och förväntar sig att anropen görs sekventiellt. Använd webbhookar där det finns ämnen att prenumerera på,
$filterpåModifiedoch Sync API för massinläsning. - Flera divisioner. Varje division i Exact Online är ett företag med en egen sökväg och ett eget samtycke. Koppla varje fabrik till rätt division.
- Frisläppta tillverkningsorder. Kom överens om vilka orderstatusar som tillåter att SkyPlanner ändrar datumen: öppna och frisläppta order, eller bara öppna order.
- Ett system styr datumen. Sluta ändra datum manuellt i Exact Online när SkyPlanner styr operationsdatumen.
Exact Globe+
Exact Globe+ är Exacts ERP-system som säljs och implementeras via Exact Globe+-partner. Exact säger att det ”koppelt eenvoudig en snel met andere systemen” (enkelt och snabbt kopplas ihop med andra system) (Exact Globe+). SkyPlanner planerar tillverkningsorder från Exact Globe+ på samma sätt: tillverkningsorder, operationsföljder, resurser och lagersaldon läses in, och planerade datum och registrerade timmar skickas tillbaka. Din Exact Globe+-partner och SkyPlanner-teamet kommer överens om gränssnittet och vilka objekt som ska skrivas tillbaka under kartläggningen.
Integrationen med Exact Online: vem konfigurerar den och ger support?
- SkyPlanner-teamet konfigurerar integrationen under uppstarten och ger support efter driftstart.
- Din Exact-partner kan delta. Partnern känner till era utgåvor, divisioner och hur tillverkningen är upplagd.
- Era egna utvecklare kan bygga vidare på integrationen med SkyPlanners dokumenterade REST API. En API-token räcker för att komma igång, och SkyPlanner-teamet hjälper till vid behov.
När anslutningen är klar planerar Arcturus-motorn utifrån aktuella tillverkningsorder i Exact Online, och varje operation får planerade datum. SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Du får en offert för integrationen utifrån era processer och behov, tillsammans med abonnemanget, så att du ser hela kostnaden innan du börjar. Se priser, funktioner och hur Exact Onlines egen planering står sig i jämförelse i Finplanering i Exact Online. En översikt finns på sidan om Exact Online, och andra ERP-system finns i översikten över ERP-integrationer.
Tillverkares omdömen om SkyPlanner
Färre stopp på grund av materialbrist
”Värdet med SkyPlanner för oss är att det är ett verktyg som fungerar i vardagen, särskilt när vi ska fastställa leveransdatum.”
Tommi Männistö, produktionsplaneringschef
Eskomatic · Legobearbetning
Automatisk beläggningsplanering ger mer träffsäkra leveransdatum, och produktionsstoppen på grund av materialbrist har minskat kraftigt.
1 000-tals tillverkningsorder 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 · Industriblandare, pumpar och högteknologisk legotillverkning
Tusentals tillverkningsorder planeras automatiskt, och hela organisationen får en realtidsbild av produktionen.
Vanliga frågor
Omfattar Exact Online API tillverkningsorder och operationssteg?
Ja. Tillverkningstjänsten har resurserna ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations och BOM-resurser. Samtliga kan både läsas och skrivas. Tid rapporteras via TimeTransactions och färdiga kvantiteter via ShopOrderReceipts.
Hur skrivs planerade datum tillbaka till Exact Online?
SkyPlanner skickar en PUT-begäran till ShopOrderRoutingStepPlans med PlannedStartDate, PlannedEndDate och Workcenter för varje steg som planeras in eller flyttas. Tillverkningsorderns PlannedStartDate och PlannedDate uppdateras så att de stämmer överens med dessa.
Vem bygger integrationen med Exact Online?
SkyPlanner-teamet konfigurerar den dubbelriktade integrationen utifrån er Exact Online-miljö under införandet och ger support efter driftsättningen. Er Exact-partner kan delta. Era egna utvecklare kan också bygga med SkyPlanners dokumenterade REST API. Det räcker med en API-token för att komma igång.
Kan Exact Online skicka ändringar i realtid?
Exact Online skickar ändringar för artiklar, lagersaldon, inköpsorder och kundorder via webhooks. Tillverkningsorder och operationssteg läses med korta intervall genom filtrerade förfrågningar. I motsatt riktning skickar SkyPlanners webhooks ändringar i produktionsplanen så snart de sker.
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 era tillverkningsorder via CSV eller Excel. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.