Integrationer / ERP / JobBOSS²
Guide til JobBOSS²-integration til produktionsplanlægning med SkyPlanner APS
Denne guide til JobBOSS²-integration viser partnere og IT-teams, hvordan de forbinder JobBOSS² fra ECI med SkyPlanner APS. SkyPlanner udveksler data med JobBOSS² i begge retninger via ECI’s egne API’er:
- Orders og Order Line Items, Order Routings, Estimates, Routings og materialer, Work Centers, Employees, Company Calendar, Job Requirements og indkøbsordrelinjer hentes ind.
- Planlagte start- og slutdatoer skrives tilbage til hvert trin i Order Routing.
- Operatørernes tidsregistreringer kan skrives tilbage som Time Ticket Details, hvis du ønsker det.
- SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til din JobBOSS²-opsætning under opstarten og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, der vil deltage eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference). En amerikansk underleverandør har allerede gjort netop det:
Integrationsgrænseflader i JobBOSS²
ECI offentliggør sine API’er til produktion med OpenAPI-specifikationer på siden ECI Manufacturing API Documentation. To af dem er relevante for planlægningen:
- JobBOSS² API (v1). REST og JSON, specifikt til JobBOSS². API’et læser og skriver ordrer, Order Line Items, Order Routings, Estimates, Routings, materialer, Job Requirements, Work Centers, Company Calendar, Employees, indkøbsordrer, Time Tickets og Time Ticket Details. ECI skriver, at det “is currently only supported for JobBOSS² hosted (Cloud) customers.” (understøttes i øjeblikket kun for kunder med JobBOSS² hostet i skyen).
- ECI ERP API (v2.1). Et REST API til Deacom, M1 og JobBOSS², som ikke er bundet til et bestemt produkt. For JobBOSS² dækker det opgaver, operationer, materialer til opgaver, emner, emneoperationer, arbejdscentre, indkøbsordrelinjer og tidsregistreringslinjer. ECI bemærker, at “the actual ERP database could be a cloud hosted ERP or on premises install,” (selve ERP-databasen kan være hostet i skyen eller installeret lokalt), så dette er løsningen til lokalt installeret JobBOSS².
Begge API’er bruger de samme konventioner: filterudtryk som lastModDate[gte]=, parameteren fields=, sort= og sideinddeling med take og skip, hvor standardværdien for take er 200. “All dates submitted to the API are assumed to be in UTC.” (Alle datoer, der sendes til API’et, antages at være i UTC).
ECI’s regel for begge API’er er: “All APIs must be activated by ECI before use.” (Alle API’er skal aktiveres af ECI før brug). Kontakt din kundeansvarlige hos ECI tidligt i forløbet.
Godkendelse og adgang
- API-brugere. Integrationen bruger en API-bruger, der oprettes i ECI’s Integration Engine Management Console. API-brugeren bestemmer, hvilket produkt, hvilken kunde og hvilken database kaldene får adgang til.
- OAuth 2.0 client credentials. Klient-id og klienthemmelighed bruges til at hente et token fra token-endpointet i Authentication API. Derefter sendes
Authorization: Bearer [token]med hvert kald. - Adgangsomfang. Giv API-brugeren adgang til de ressourcer, som mappingtabellen nedenfor kræver, og ikke andet.
I 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.
Hændelser og polling
Ingen af ECI’s to API’er dokumenterer webhooks. Data fra JobBOSS² hentes via polling: Filtrer Order Line Items, Order Routings og indkøbsordrelinjer på lastModDate siden sidste kørsel, og brug take og skip til sideinddeling. Intervallet fastlægges for hver virksomhed, fra med få minutters mellemrum for opgaver til hver time for lagerbeholdning.
SkyPlanner sender webhooks, når status eller planen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| JobBOSS²-objekt (ressource i JobBOSS² API) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
Estimates (/estimates), materialer (/materials) | Produkter, materialer, produktstruktur | JobBOSS² → SkyPlanner | Første indlæsning, derefter ved ændringer |
Routings (/routings): arbejdscenter, omstillingstid, cyklustid, holdstørrelse, maskiner til opgaven | Procestrin med varigheder og omstillingstider | JobBOSS² → SkyPlanner | Første indlæsning, derefter ved ændringer |
Work Centers (/work-centers): timer pr. skift, drift på skift 1 til 3, arbejdsdage | Arbejdsstationer, grupper af arbejdsstationer, effektivitetsgrader | JobBOSS² → SkyPlanner | Første indlæsning, sjældent derefter |
Company Calendar (/company-calendars), Employees (/employees) | Skift, arbejdsfri dage, personale | JobBOSS² → SkyPlanner | Dagligt, eller skiftene vedligeholdes i SkyPlanner |
Orders og Order Line Items (/order-line-items): opgavenummer, leveringsfrist, prioritet, antal til produktion | Ordrer med leveringsfrister og prioriteter | JobBOSS² → SkyPlanner | Polling med få minutters mellemrum |
Order Routings (/order-routings): opgavetrin, status, resterende timer | Opgaver pr. procestrin | JobBOSS² → SkyPlanner | Polling med få minutters mellemrum |
Job Requirements (/job-requirements), indkøbsordrelinjer (/purchase-order-line-items) | Materialebehov, indkøbsordrer efter leveringsdato | JobBOSS² → SkyPlanner | Polling hver time eller ved kørsel af planlægningen |
Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Planlagt start og slut, maskine og operatør pr. trin | SkyPlanner → JobBOSS² | Ved planændringer via en SkyPlanner-webhook |
| Time Ticket Details (POST): opgave, trin, arbejdscenter, medarbejder, omstillingstid, cyklustid, færdige og kasserede emner, start- og sluttidspunkt | Tidsregistreringer og operatørtilbagemeldinger | SkyPlanner → JobBOSS² | Pr. tilbagemelding eller pr. skift, hvis det er valgt |
| Findes ikke i JobBOSS² | Omstillingstidsmatrix, værktøjer som ressourcer med begrænset kapacitet, alternative maskiner og medarbejdere | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Ved lokalt installeret JobBOSS² læses de samme objekter via ERP API-ressourcerne /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers og /purchase-order-lines, og tidsregistreringer sendes til /timecard-lines.
Integrationsmønstre
1. Første indlæsning af stamdata. Indlæs Estimates, Routings, materialer, Work Centers, Company Calendar og Employees. Tag bevidst stilling til mappingen af arbejdscentre: Et arbejdscenter med fire drejebænke bliver til én gruppe af arbejdsstationer eller fire arbejdsstationer, så SkyPlanner planlægger rækkefølgen på hver maskine.
2. Synkronisering af opgaver. Indlæs åbne Order Line Items med tilhørende Order Routings, Job Requirements og åbne indkøbsordrelinjer. SkyPlanner betragter bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered. Spring opgaver i bero og lukkede opgaver over.
3. Tilbageskrivning af planen. Når planlægningsmotoren placerer eller flytter et trin, udløser en SkyPlanner-webhook et PATCH-kald til /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Kaldet angiver estimatedStartDate og estimatedEndDate i UTC samt workCenter og employeeCode, når SkyPlanner har flyttet trinnet til en anden maskine eller person. Datoerne skrives til de opgavetrin, som allerede vises i Whiteboard, Planning Board og Scheduling Advisor.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen ajour. Du vælger, om de faktiske tider skal skrives tilbage til JobBOSS². Hvis ja, bliver hver tilbagemelding til en Time Ticket Detail med omstillingstid, cyklustid og antal emner. Hvis nej, forbliver dataindsamlingen i JobBOSS², og SkyPlanner læser fremdriften fra Order Routings.
5. Dataejerskab og konfliktregler. Skriv dem ned inden idriftsættelsen:
| Data | Ejer |
|---|---|
| Estimates, Routings, mængder, leveringsfrister, opgavestatus | JobBOSS² |
| Trinrækkefølge, start- og sluttidspunkter, maskine og operatør pr. trin | SkyPlanner |
| Omstillingstidsmatrix, krav til værktøjer og operatører, alternative ressourcer | SkyPlanner |
| Skift og arbejdsfri dage | Ét system, valgt under afklaringen |
| Tidsregistreringer, materialeudleveringer, varemodtagelser, omkostningsberegning | JobBOSS², registreret dér eller overført fra tidsregistreringer i SkyPlanner |
Vælg ét system, der må skrive datoer på opgavetrinnene. SkyPlanner erstatter omplanlægning i Whiteboard for de opgaver, det planlægger. Planlæggerne flytter derfor arbejdet i SkyPlanner, og datoerne overføres til JobBOSS².
Typiske trin i projektet
Implementeringen afsluttes normalt i løbet af uger efter opstarten. Inden da skal du validere planen i den gratis prøveperiode på 30 dage med Work Centers, ruter og åbne opgaver eksporteret fra JobBOSS² som CSV eller Excel.
- Mapping. Fastlæg mappingtabellen, reglerne for dataejerskab, synkroniseringsintervallerne, og om tidsregistreringer skal skrives tilbage.
- Adgang via ECI. Bed ECI om at aktivere JobBOSS² API eller ERP API og oprette API-brugeren. Test mod et testregnskab, hvis I har et.
- Første indlæsning. Estimates, Routings, Work Centers, kalender og medarbejdere.
- Synkronisering af opgaver og indkøbsordrer. Polling med
lastModDate-filtre, paginering og genforsøg. - Opsætning af begrænsninger i SkyPlanner. Matrix for omstillingstider, værktøjer, antal operatører pr. opgave og alternative maskiner eller medarbejdere.
- Tilbageskrivning af planen. PATCH-kald til Order Routing fra SkyPlanner-webhooks samt Time Ticket Details, hvis det er valgt.
- Parallel test. Kør SkyPlanner sideløbende med den nuværende planlægningstavle, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når data stemmer overens.
Det skal I tage højde for i en JobBOSS²-integration
- Hostet eller lokalt installeret. JobBOSS² API er til kunder med en hostet løsning. Lokale installationer bruger ERP API, som har en anden liste over ressourcer. Afklar valget i trin 1.
- UTC overalt. API’et læser og skriver i UTC. Konvertér til fabrikkens lokale tid, ellers ender en start kl. 7:00 på det forkerte tidspunkt.
- Arbejdscentre kan dække over flere maskiner. Et arbejdscenter kan være en maskine, en gruppe, en celle eller medarbejdere. Antallet af maskiner og holdets størrelse på hvert rutetrin fortæller SkyPlanner, hvor mange ressourcer trinnet kræver.
- Eksterne ydelser. Trin med en leverandør i stedet for et arbejdscenter tæller med i gennemløbstiden, men belaster ikke jeres kapacitet. Modellér dem som trin, der kun kræver tid.
- Overlap og ubemandede trin. Rutetrin kan markeres til at overlappe eller køre ubemandet. Overfør begge markeringer, så ubemandet produktion planlægges korrekt.
- Tidsenheder. Omstillings- og cyklustider har hver deres enheder, og køtid er ventetid, ikke maskintid. Konvertér ved import, ellers bliver alle varigheder forkerte.
- Paginering. Hver side indeholder som standard 200 poster. Brug paginering ved hver læsning.
Hvem opsætter og supporterer JobBOSS²-integrationen?
- SkyPlanner-teamet opsætter integrationen under onboarding og yder support efter idriftsættelsen for de aftalte ressourcer og pollingregler. Hver produktionsvirksomhed bruger JobBOSS² på sin egen måde, og den viden indarbejdes her.
- Jeres JobBOSS²-partner kan deltage. Partneren kender jeres opsætning og kan sammen med SkyPlanner-teamet aftale API-aktivering og oprettelse af API-brugeren med ECI.
- Jeres egne udviklere kan bygge videre på integrationen via SkyPlanners REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. Dokumentationen findes i SkyPlanners integrationsdokumentation.
SkyPlanner koster fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen, tilpasset jeres processer og behov, sammen med jeres abonnement. Se priser, produktionsplanlægning med JobBOSS² under hensyn til den faktiske kapacitet, siden om JobBOSS², SkyPlanners funktioner og oversigten over ERP-integrationer.
Produktionsvirksomheder, der bruger SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-ark til optimering af produktionen i realtid.”
Kalle Kalliomäki, specialist i forsyningskæder
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når ud 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.
Flere 1.000arbejdsordrer planlægges 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 overblik over produktionen i realtid.
98%leveringssikkerhed mod tidligere omkring 50%
“SkyPlanner spiller en afgørende rolle for at fastholde vores leveringssikkerhed.”
Hannu Lahtinen, administrerende direktør
KJH-Comp · Pladebearbejdning og kontraktproduktion
Leveringssikkerheden steg fra omkring 50% til helt op til 98%, og planlægningen kræver nu én arbejdsleder i stedet for to.
Ofte stillede spørgsmål
Har JobBOSS² et API?
Ja. ECI stiller JobBOSS² API og det produktuafhængige ERP API til rådighed. Begge er REST-baserede med OpenAPI-specifikationer. JobBOSS² API læser og skriver ordrer, Order Routings, Estimates, Work Centers, indkøbsordrer og Time Tickets for kunder med en hostet løsning.
Hvordan autentificerer integrationen sig over for JobBOSS²?
Med OAuth 2.0 client credentials. ECI aktiverer API’et, der oprettes en API-bruger i Integration Engine Management Console, og hvert kald indeholder et Bearer-token.
Understøtter JobBOSS² webhooks?
Der er ingen dokumenterede webhooks i ECI’s API’er, så integrationen poller JobBOSS² med lastModDate-filtre med et interval, der fastlægges for den enkelte virksomhed. SkyPlanners egne webhooks sender ændringer i planen, så snart de sker.
Hvordan skrives planlagte datoer tilbage til JobBOSS²?
For hvert trin i opgaven. SkyPlanner opdaterer hver Order Routing via PATCH med estimatedStartDate og estimatedEndDate samt workCenter og employeeCode, når trinnet er flyttet til en anden maskine eller operatør.
Bør en JobBOSS²-partner foreslå ECI APS eller SkyPlanner?
SkyPlanner, når kunden vil have produktionsplanlægning på tværs af flere ressourcer i drift på få uger, hvor planen tager højde for den faktiske maskin- og personalekapacitet. ECI APS er et separat tilkøbsmodul baseret på LYNQ. SkyPlanner forbindes via ECI’s eget JobBOSS² API, planlægger omstillinger, hold, fiksturer og materialer og omplanlægger automatisk. Prisen starter ved 199 € pr. måned.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med CSV- eller Excel-import fra JobBOSS². Der kræves intet kreditkort. Start prøveperioden, eller tal med salg for at afklare integrationens omfang.
