Integrationer / ERP / JobBOSS²
Guide till JobBOSS² integration för produktionsplanering med SkyPlanner APS
Den här guiden visar partner och IT-team hur de ansluter ECI:s JobBOSS² till SkyPlanner APS. SkyPlanner integreras med JobBOSS² i båda riktningarna via ECI:s egna API:er:
- Orders och Order Line Items, Order Routings, Estimates, Routings och material, Work Centers, Employees, Company Calendar, Job Requirements och inköpsorderrader läses in.
- Planerade start- och slutdatum förs tillbaka till varje steg i Order Routing.
- Operatörernas tidregistreringar kan föras tillbaka som Time Ticket Details om du väljer det.
- SkyPlanners webhooks skickar planändringar direkt när de sker.
SkyPlanner-teamet konfigurerar integrationen efter din JobBOSS²-miljö under införandet och ger support efter driftsättningen. Den här guiden är för partner och utvecklare som vill delta eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens). En amerikansk legotillverkare har redan gjort just det:
Integrationsgränssnitt i JobBOSS²
ECI publicerar sina API:er för tillverkning med OpenAPI-specifikationer på webbplatsen ECI:s API-dokumentation för tillverkning. Två av dem är relevanta för produktionsplanering:
- JobBOSS² API (v1). Bygger på REST och JSON och är specifikt för JobBOSS². Det läser och skriver order, Order Line Items, Order Routings, Estimates, Routings, material, Job Requirements, Work Centers, Company Calendar, Employees, inköpsorder, Time Tickets och Time Ticket Details. ECI anger att det ”is currently only supported for JobBOSS² hosted (Cloud) customers.” (stöds för närvarande endast för kunder med molnbaserad JobBOSS²).
- ECI ERP API (v2.1). Ett produktoberoende REST API för Deacom, M1 och JobBOSS². För JobBOSS² omfattar det tillverkningsorder, orderoperationer, ordermaterial, artiklar, artikeloperationer, produktionsgrupper, inköpsorderrader och tidrapporteringsrader. ECI påpekar att ”the actual ERP database could be a cloud hosted ERP or on premises install,” (själva ERP-databasen kan finnas i molnet eller vara lokalt installerad). Därför är detta vägen för lokalt installerad JobBOSS².
Båda API:erna följer samma konventioner: filteruttryck som lastModDate[gte]=, parametern fields=, sort= och sidindelning med take och skip, där standardvärdet för take är 200. ”All dates submitted to the API are assumed to be in UTC.” (Alla datum som skickas till API:et antas vara i UTC.)
ECI:s regel gäller båda: ”All APIs must be activated by ECI before use.” (Alla API:er måste aktiveras av ECI innan de används.) Kontakta din kundansvariga på ECI i god tid.
Autentisering och åtkomst
- API-användare. Integrationen använder en API-användare som skapas i ECI:s Integration Engine Management Console. API-användaren styr vilken produkt, kund och databas anropen når.
- OAuth 2.0 client credentials. Klient-ID och klienthemlighet används för att hämta en token från Authentication API:s token-endpoint. Därefter skickas
Authorization: Bearer [token]med varje anrop. - Behörighetsomfång. Ge API-användaren åtkomst till de resurser som behövs enligt mappningstabellen nedan, och inga andra.
På SkyPlanner-sidan autentiseras REST API med en API-token (SkyPlanner Settings > API) och dokumenteras i Swagger/OpenAPI. Integrationsguiden går igenom de första anropen.
Händelser och pollning
Inget av ECI:s två API:er dokumenterar webhooks. JobBOSS²-sidan pollas: filtrera Order Line Items, Order Routings och inköpsorderrader på lastModDate sedan föregående körning och dela upp resultaten i sidor med take och skip. Intervallet ställs in för varje verkstad, från några minuters mellanrum för tillverkningsorder till en gång i timmen för lagersaldon.
SkyPlanner skickar webhooks när status eller planen ändras, så återföringen är händelsestyrd.
Datamappning
| Objekt i JobBOSS² (resurs i JobBOSS² API) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
Estimates (/estimates), material (/materials) | Produkter, material, produktstruktur | JobBOSS² → SkyPlanner | Första inläsning, därefter vid ändringar |
Routings (/routings): produktionsgrupp, ställtid, cykeltid, teamstorlek, maskiner för operationen | Processteg med tidsåtgång och ställtider | JobBOSS² → SkyPlanner | Första inläsning, därefter vid ändringar |
Work Centers (/work-centers): timmar per skift, drift på skift 1 till 3, arbetsdagar | Produktionsgrupper, grupper av produktionsgrupper, effektivitetsgrader | JobBOSS² → SkyPlanner | Första inläsning, därefter sällan |
Company Calendar (/company-calendars), Employees (/employees) | Skift, arbetsfria dagar, personal | JobBOSS² → SkyPlanner | Dagligen, eller hantera skiften i SkyPlanner |
Orders och Order Line Items (/order-line-items): tillverkningsordernummer, leveransdatum, prioritet, antal att tillverka | Order med leveransdatum och prioriteringar | JobBOSS² → SkyPlanner | Pollning med några minuters mellanrum |
Order Routings (/order-routings): ordersteg, status, återstående timmar | Operationer per processteg | JobBOSS² → SkyPlanner | Pollning med några minuters mellanrum |
Job Requirements (/job-requirements), inköpsorderrader (/purchase-order-line-items) | Materialbehov, inköpsorder efter leveransdatum | JobBOSS² → SkyPlanner | Pollning varje timme eller vid planeringskörning |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Planerad start- och sluttid, maskin och operatör per steg | SkyPlanner → JobBOSS² | Vid ändring av planen, via webhook från SkyPlanner |
| Time Ticket Details (POST): tillverkningsorder, steg, produktionsgrupp, anställd, ställtid, cykeltid, antal färdiga och kasserade enheter, start- och sluttid | Tidregistreringar och operatörsåterrapportering | SkyPlanner → JobBOSS² | Per återrapportering eller skift, om detta väljs |
| Finns inte i JobBOSS² | Ställtidsmatris, verktyg som resurser med begränsad kapacitet, alternativa maskiner och personal | Underhålls i SkyPlanner | Konfigureras under införandet |
För lokalt installerad JobBOSS² läses samma objekt via ERP API-resurserna /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers och /purchase-order-lines, och tidregistreringar skickas till /timecard-lines.
Integrationsmönster
1. Första inläsning av grunddata. Läs in Estimates, Routings, material, Work Centers, Company Calendar och Employees. Mappa produktionsgrupperna med omsorg: en produktionsgrupp med fyra svarvar blir en grupp av produktionsgrupper eller fyra produktionsgrupper, så att SkyPlanner planerar operationsordningen för varje maskin.
2. Synkronisering av tillverkningsorder. Läs in öppna Order Line Items med tillhörande Order Routings, Job Requirements och ö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. Hoppa över pausade och avslutade tillverkningsorder.
3. Återföring av planen. När planeringsmotorn lägger in eller flyttar ett steg utlöser en webhook från SkyPlanner ett PATCH-anrop till /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Anropet anger estimatedStartDate och estimatedEndDate i UTC, samt workCenter och employeeCode när SkyPlanner har flyttat steget till en annan maskin eller person. Datumen hamnar på de ordersteg som redan visas i Whiteboard, Planning Board och Scheduling Advisor.
4. Återrapportering från produktionen. Operatörerna registrerar arbetet med SkyPlanner Mobile Confirmations eller Production Timer, och tidregistreringarna håller planen aktuell. Du väljer om de faktiska tiderna ska föras tillbaka till JobBOSS². Om du väljer det blir varje återrapportering en Time Ticket Detail med ställtid, cykeltid och antal enheter. Annars ligger datainsamlingen kvar i JobBOSS² och SkyPlanner läser av hur arbetet fortskrider från Order Routings.
5. Regler för dataägarskap och konflikter. Dokumentera dem före driftsättning:
| Data | Ägare |
|---|---|
| Estimates, Routings, kvantiteter, leveransdatum, orderstatus | JobBOSS² |
| Stegens ordningsföljd, start- och sluttider, maskin och operatör per steg | SkyPlanner |
| Ställtidsmatris, krav på verktyg och operatörer, alternativa resurser | SkyPlanner |
| Skift och arbetsfria dagar | Ett system, som väljs under kartläggningen |
| Tidrapporter, materialuttag, inleveranser, kostnadsberäkning | JobBOSS², med registrering där eller överföring från SkyPlanners tidregistreringar |
Låt bara ett system skriva datum för orderstegen. SkyPlanner ersätter omplanering i Whiteboard för de tillverkningsorder som planeras där. Planerarna flyttar därför arbetet i SkyPlanner, och datumen förs över till JobBOSS².
Vanliga projektsteg
Implementeringen är normalt klar inom några veckor efter att införandet har börjat. Validera dessförinnan planen under den kostnadsfria provperioden på 30 dagar med Work Centers, operationsföljder och öppna tillverkningsorder som exporterats från JobBOSS² som CSV eller Excel.
- Mappning. Fastställ mappningstabellen, reglerna för dataägarskap, synkroniseringsintervallen och om tidrapporter ska skrivas tillbaka.
- Åtkomst via ECI. Be ECI aktivera JobBOSS² API eller ERP API och skapa API-användaren. Testa mot ett testföretag i en sandboxmiljö om ni har ett.
- Första inläsningen. Estimates, Routings, Work Centers, kalender och personal.
- Synkronisering av tillverkningsorder och inköpsorder. Pollning med
lastModDate-filter, paginering och återförsök. - Begränsningar i SkyPlanner. Konfigurera ställtidsmatris, verktyg, antal operatörer per operation och alternativa maskiner eller personal.
- Återskrivning av planen. PATCH-anrop till Order Routing via SkyPlanners webhooks, samt överföring av Time Ticket Details om ni väljer det.
- Parallella tester. Kör SkyPlanner parallellt med den nuvarande planeringstavlan, jämför datum och rätta grunddata.
- Driftsättning. Aktivera återskrivningen när uppgifterna stämmer överens.
Att ta hänsyn till vid en integration med JobBOSS²
- Hostad eller lokal drift. JobBOSS² API används för kunder med hostad drift. Lokala installationer använder ERP API, som har en annan uppsättning resurser. Bestäm vilket alternativ som gäller i steg 1.
- UTC överallt. API:et läser och skriver tider i UTC. Konvertera till fabrikens lokala tid, annars hamnar en start klockan 7:00 vid fel tidpunkt.
- Produktionsgrupper med flera underliggande resurser. En produktionsgrupp kan vara en maskin, en grupp, en cell eller personal. Antalet maskiner och bemanningen för varje steg i operationsföljden talar om för SkyPlanner hur många resurser steget behöver.
- Externa tjänster. Steg med en leverantör i stället för en produktionsgrupp bidrar till ledtiden men belastar inte er kapacitet. Modellera dem som steg som enbart tar tid.
- Överlappning och obemannade steg. Steg i operationsföljden kan markeras som överlappande eller obemannade. För över båda flaggorna så att obemannad produktion planeras korrekt.
- Tidsenheter. Ställ- och cykeltider har egna enheter, och kötid är väntetid, inte maskintid. Konvertera vid importen, annars blir alla varaktigheter fel.
- Paginering. Varje sida innehåller som standard 200 poster. Använd paginering vid varje läsning.
Vem konfigurerar och ger support för integrationen med JobBOSS²?
- SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftsättningen, för de resurser och pollningsregler ni har kommit överens om. Varje verkstad använder JobBOSS² på sitt sätt, och den kunskapen tas till vara här.
- Er JobBOSS²-partner kan delta. Partnern känner till er konfiguration och kan tillsammans med SkyPlanner-teamet ordna API-aktivering och API-användare med ECI.
- Era egna utvecklare kan bygga vidare på integrationen via SkyPlanners REST API med en API-token. En API-token räcker för att komma igång, och SkyPlanner-teamet hjälper till vid behov. Dokumentationen finns i SkyPlanners integrationsdokumentation.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen i förväg, anpassad efter era processer och behov, tillsammans med abonnemanget. Se priser, finplanering för JobBOSS², sidan om JobBOSS², SkyPlanners funktioner och översikten över ERP-integrationer.
Tillverkningsföretag som använder SkyPlanner
2 hsparade varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-kalkylblad 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 mindre än 30 minuter att skapa en optimerad plan för tre månader som omfattar 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 bild av produktionen i realtid.
98%leveransprecision, upp från cirka 50%
”SkyPlanner spelar en avgörande roll för att upprätthålla vår leveransprecision.”
Hannu Lahtinen, vd
KJH-Comp · Tunnplåtsmekanik och kontraktstillverkning
Leveransprecisionen steg från cirka 50% till hela 98%, och planeringen kräver nu en arbetsledare i stället för två.
Vanliga frågor
Har JobBOSS² ett API?
Ja. ECI tillhandahåller JobBOSS² API och det produktoberoende ERP API. Båda är REST-API:er med OpenAPI-specifikationer. JobBOSS² API läser och skriver order, Order Routings, Estimates, Work Centers, inköpsorder och Time Tickets för kunder med hostad drift.
Hur autentiserar sig integrationen mot JobBOSS²?
Med OAuth 2.0 client credentials. ECI aktiverar API:et, en API-användare skapas i Integration Engine Management Console och varje anrop innehåller en Bearer-token.
Har JobBOSS² stöd för webhooks?
Dokumentationen för ECI:s API:er beskriver inga webhooks. Därför pollar integrationen JobBOSS² med lastModDate-filter enligt ett intervall som bestäms för varje verkstad. SkyPlanners egna webhooks skickar ändringar i planen så snart de sker.
Hur skrivs planerade datum tillbaka till JobBOSS²?
För varje operationssteg. SkyPlanner uppdaterar varje Order Routing med PATCH-anrop som innehåller estimatedStartDate och estimatedEndDate, samt workCenter och employeeCode om steget har flyttats till en annan maskin eller operatör.
Bör en JobBOSS²-partner föreslå ECI APS eller SkyPlanner?
SkyPlanner, när kunden vill komma igång inom några veckor med finplanering som tar hänsyn till flera resursers kapacitet. ECI APS är ett separat tillägg som bygger på LYNQ. SkyPlanner ansluter via ECI:s eget JobBOSS² API, planerar omställningar, arbetslag, fixturer och material och planerar om automatiskt. Priset börjar på 199 € per månad.
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 CSV- eller Excel-filer från JobBOSS². Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för en kartläggning av integrationen.
