Integrasjoner / ERP / JobBOSS²
Veiledning til JobBOSS²-integrasjon for produksjonsplanlegging med SkyPlanner APS
Denne veiledningen viser partnere og IT-team hvordan de kobler JobBOSS² fra ECI til SkyPlanner APS. SkyPlanner integreres med JobBOSS² i begge retninger via ECIs egne API-er:
- Orders og Order Line Items, Order Routings, Estimates, Routings og materialer, Work Centers, Employees, Company Calendar, Job Requirements og innkjøpsordrelinjer hentes inn.
- Planlagte start- og sluttdatoer skrives tilbake til hvert trinn i Order Routing.
- Operatørenes tidsregistreringer kan skrives tilbake som Time Ticket Details, hvis dere ønsker det.
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet tilpasser integrasjonen til JobBOSS²-oppsettet deres under innføringen og gir støtte etter produksjonssetting. Denne veiledningen er for partnere og utviklere som vil delta eller selv bygge videre på det dokumenterte REST API-et til SkyPlanner (API-referanse). En amerikansk leieprodusent har allerede gjort nettopp det:
Integrasjonsgrensesnittene i JobBOSS²
ECI publiserer API-ene sine for produksjon, med OpenAPI-spesifikasjoner, på nettstedet ECIs API-dokumentasjon for produksjon. To av dem er relevante for produksjonsplanlegging:
- JobBOSS² API (v1). REST og JSON, spesifikt for JobBOSS². Det leser og skriver ordrer, Order Line Items, Order Routings, Estimates, Routings, materialer, Job Requirements, Work Centers, Company Calendar, Employees, innkjøpsordrer, Time Tickets og Time Ticket Details. ECI opplyser at det «is currently only supported for JobBOSS² hosted (Cloud) customers.» (foreløpig bare støttes for kunder med skybasert JobBOSS²).
- ECI ERP API (v2.1). Et produktuavhengig REST API for Deacom, M1 og JobBOSS². For JobBOSS² dekker det jobber, jobboperasjoner, jobbmaterialer, artikler, artikkeloperasjoner, arbeidssentre, innkjøpsordrelinjer og timeregistreringslinjer. ECI bemerker at «the actual ERP database could be a cloud hosted ERP or on premises install,» (selve ERP-databasen kan ligge i skyen eller være installert lokalt), så dette er alternativet for lokalt installert JobBOSS².
Begge API-ene følger de samme konvensjonene: filteruttrykk som lastModDate[gte]=, en fields=-parameter, sort= og sideinndeling med take og skip, der standardverdien for take er 200. «All dates submitted to the API are assumed to be in UTC.» (Alle datoer som sendes til API-et, antas å være i UTC.)
ECIs regel gjelder begge: «All APIs must be activated by ECI before use.» (Alle API-er må aktiveres av ECI før bruk.) Kontakt kundeansvarlig hos ECI tidlig.
Autentisering og tilgang
- API-brukere. Integrasjonen bruker en API-bruker som opprettes i ECIs Integration Engine Management Console. API-brukeren bestemmer hvilket produkt, hvilken kunde og hvilken database kallene går til.
- Klientlegitimasjon for OAuth 2.0. Klient-ID og klienthemmelighet brukes til å hente et token fra tokenendepunktet i Authentication API. Deretter sendes
Authorization: Bearer [token]med hvert kall. - Tilgangsomfang. Gi API-brukeren tilgang til ressursene som trengs i koblingstabellen nedenfor, og ingenting annet.
På SkyPlanner-siden bruker REST API-et et API-token til autentisering (SkyPlanner Settings > API) og er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen viser de første kallene trinn for trinn.
Hendelser og polling
Ingen av ECI-API-ene har dokumenterte webhooks. Data fra JobBOSS² hentes med polling: Filtrer Order Line Items, Order Routings og innkjøpsordrelinjer på lastModDate siden forrige kjøring, og bruk take og skip til sideinndeling. Frekvensen fastsettes for hver bedrift: Jobber hentes med noen minutters mellomrom, mens lagerbeholdning hentes hver time.
SkyPlanner sender webhooks når tilstanden eller planen endres, så tilbakeskrivingen er hendelsesstyrt.
Datakoblinger
| JobBOSS²-objekt (ressurs i JobBOSS² API) | SkyPlanner-objekt | Retning | Frekvens |
|---|---|---|---|
Estimates (/estimates), materialer (/materials) | Produkter, materialer, produktstruktur | JobBOSS² → SkyPlanner | Første innlasting, deretter ved endringer |
Routings (/routings): arbeidssenter, omstillingstid, syklustid, teamstørrelse, maskiner for jobben | Prosesstrinn med varighet og omstillingstider | JobBOSS² → SkyPlanner | Første innlasting, deretter ved endringer |
Work Centers (/work-centers): timer per skift, drift på skift 1 til 3, arbeidsdager | Arbeidsstasjoner, arbeidsstasjonsgrupper, effektivitetsfaktorer | JobBOSS² → SkyPlanner | Første innlasting, sjelden deretter |
Company Calendar (/company-calendars), Employees (/employees) | Skift, arbeidsfrie dager, personell | JobBOSS² → SkyPlanner | Daglig, eller skiftene vedlikeholdes i SkyPlanner |
Orders og Order Line Items (/order-line-items): jobbnummer, leveringsfrist, prioritet, antall som skal produseres | Ordrer med leveringsfrister og prioriteter | JobBOSS² → SkyPlanner | Polling med noen minutters mellomrom |
Order Routings (/order-routings): jobbtrinn, status, gjenstående timer | Jobber per prosesstrinn | JobBOSS² → SkyPlanner | Polling med noen minutters mellomrom |
Job Requirements (/job-requirements), innkjøpsordrelinjer (/purchase-order-line-items) | Materialbehov, innkjøpsordrer etter leveringsdato | JobBOSS² → SkyPlanner | Polling hver time eller ved plankjøring |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Planlagt start og slutt, maskin og operatør per trinn | SkyPlanner → JobBOSS² | Ved planendringer, via webhook fra SkyPlanner |
| Time Ticket Details (POST): jobb, trinn, arbeidssenter, ansatt, omstillingstid, syklustid, antall ferdige og kasserte enheter, start- og sluttid | Tidsregistreringer og operatørbekreftelser | SkyPlanner → JobBOSS² | Per bekreftelse eller per skift, hvis dette velges |
| Finnes ikke i JobBOSS² | Matrise for omstillingstider, verktøy som ressurser med begrenset kapasitet, alternative maskiner og personell | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
For lokalt installert JobBOSS² leses de samme objektene via ERP API-ressursene /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers og /purchase-order-lines, mens tidsregistreringer sendes til /timecard-lines.
Integrasjonsmønstre
1. Første innlasting av grunndata. Les inn Estimates, Routings, materialer, Work Centers, Company Calendar og Employees. Velg koblingene for arbeidssentre med omhu: Et arbeidssenter med fire dreiebenker blir én arbeidsstasjonsgruppe eller fire arbeidsstasjoner, slik at SkyPlanner planlegger rekkefølgen på hver maskin.
2. Synkronisering av jobber. Les inn åpne Order Line Items med tilhørende Order Routings, Job Requirements og åpne innkjøpsordrelinjer. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Hopp over jobber som er satt på vent eller avsluttet.
3. Tilbakeskriving av planen. Når planleggingsmotoren plasserer eller flytter et trinn, utløser en webhook fra SkyPlanner et PATCH-kall til /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Kallet angir estimatedStartDate og estimatedEndDate i UTC, og workCenter og employeeCode når SkyPlanner har flyttet trinnet til en annen maskin eller person. Datoene legges på jobbtrinnene som allerede vises i Whiteboard, Planning Board og Scheduling Advisor.
4. Bekreftelser fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Dere velger om faktiske tider skal skrives tilbake til JobBOSS². Hvis ja, blir hver bekreftelse til en Time Ticket Detail med omstillingstid, syklustid og antall enheter. Hvis nei, skjer datainnsamlingen fortsatt i JobBOSS², og SkyPlanner leser fremdriften fra Order Routings.
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Estimates, Routings, antall, leveringsfrister, jobbstatus | JobBOSS² |
| Trinnrekkefølge, start- og sluttider, maskin og operatør per trinn | SkyPlanner |
| Matrise for omstillingstider, krav til verktøy og operatører, alternative ressurser | SkyPlanner |
| Skift og arbeidsfrie dager | Ett system, valgt under avklaringen |
| Timeregistreringer, materialuttak, varemottak, kostnadsberegning | JobBOSS², registrert der eller overført fra tidsregistreringer i SkyPlanner |
Velg ett system som skriver datoene for jobbtrinnene. SkyPlanner erstatter omplanlegging i Whiteboard for jobbene det planlegger. Planleggerne flytter derfor arbeidet i SkyPlanner, og datoene overføres til JobBOSS².
Typiske prosjekttrinn
Implementeringen fullføres normalt innen noen uker etter at innføringen starter. Før det kan dere validere planen i den gratis prøveperioden på 30 dager med Work Centers, produksjonsruter og åpne jobber eksportert fra JobBOSS² som CSV eller Excel.
- Feltkobling. Fastsett koblingstabellen, reglene for dataeierskap, synkroniseringsintervallene og om timeregistreringer skal føres tilbake.
- Tilgang fra ECI. Be ECI aktivere JobBOSS² API eller ERP API og opprette API-brukeren. Test mot et testfirma hvis dere har et.
- Førstegangsimport. Estimates, Routings, Work Centers, kalender og ansatte.
- Synkronisering av jobber og innkjøpsordrer. Periodisk henting med
lastModDate-filtre, sideinndeling og nye forsøk ved feil. - Oppsett av begrensninger i SkyPlanner. Matrise for omstillingstider, verktøy, antall operatører per jobb og alternative maskiner eller medarbeidere.
- Tilbakeskriving av planen. PATCH-kall til Order Routing fra SkyPlanner-webhooks, samt Time Ticket Details hvis dette er valgt.
- Parallelltesting. Kjør SkyPlanner ved siden av dagens planleggingstavle, sammenlign datoer og korriger grunndata.
- Produksjonssetting. Aktiver tilbakeskriving når dataene stemmer overens.
Dette må du ta høyde for i en JobBOSS²-integrasjon
- Drift hos leverandøren eller lokalt. JobBOSS² API brukes av kunder med leverandørdrift. Lokale installasjoner bruker ERP API, som har en annen ressursliste. Avklar tilkoblingsmåten i trinn 1.
- UTC overalt. API-et leser og skriver UTC. Konverter til fabrikkens lokale tid, ellers havner en start kl. 7:00 på feil klokkeslett.
- Arbeidssentre med flere underliggende ressurser. Et arbeidssenter kan være en maskin, en gruppe, en celle eller personer. Antall maskiner og størrelsen på teamet i hvert trinn i produksjonsruten forteller SkyPlanner hvor mange ressurser trinnet trenger.
- Eksterne tjenester. Trinn med en leverandør i stedet for et arbeidssenter bidrar til ledetiden, men belaster ikke egen kapasitet. Modeller dem som trinn som bare tar tid.
- Overlappende og ubemannede trinn. Trinn i produksjonsruten kan merkes som overlappende eller ubemannede. Overfør begge markeringene slik at ubemannet drift blir planlagt riktig.
- Tidsenheter. Omstillings- og syklustider har egne enheter, og køtid er ventetid, ikke maskintid. Konverter ved import, ellers blir alle varigheter feil.
- Sideinndeling. Hver side inneholder som standard 200 poster. Bruk sideinndeling ved hver lesing.
Hvem setter opp og støtter JobBOSS²-integrasjonen?
- SkyPlanner-teamet setter opp integrasjonen under oppstarten og gir støtte etter produksjonssetting, med de avtalte ressursene og reglene for periodisk henting som ramme. Alle bedrifter bruker JobBOSS² på sin måte, og denne kunnskapen tas med i oppsettet.
- JobBOSS²-partneren din kan delta. Partneren kjenner oppsettet ditt og kan sammen med SkyPlanner-teamet avtale API-aktivering og opprettelse av API-brukeren med ECI.
- Egne utviklere kan bygge videre på integrasjonen via SkyPlanners REST API med et API-token. Et API-token er nok til å komme i gang, og SkyPlanner-teamet hjelper til ved behov. Du finner dokumentasjonen i SkyPlanners integrasjonsdokumentasjon.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og månedlig fakturering. Du får et pristilbud på integrasjonen på forhånd, tilpasset prosessene og behovene dine, sammen med abonnementet. Se priser, produksjonsplanlegging med JobBOSS² innenfor tilgjengelig kapasitet, JobBOSS²-siden, funksjonene i SkyPlanner og oversikten over ERP-integrasjoner.
Produksjonsbedrifter som bruker SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-ark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 arbeidstimer hver uke, og en ny jobbkø 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.
Flere 1 000arbeidsordrer 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.
98%leveringspålitelighet, opp fra omtrent 50%
«SkyPlanner spiller en avgjørende rolle i å opprettholde leveringspåliteligheten vår.»
Hannu Lahtinen, daglig leder
KJH-Comp · Tynnplatebearbeiding og kontraktsproduksjon
Leveringspåliteligheten steg fra rundt 50% til hele 98%, og produksjonsplanleggingen krever nå én arbeidsleder i stedet for to.
Ofte stilte spørsmål
Har JobBOSS² et API?
Ja. ECI publiserer JobBOSS² API og det produktuavhengige ERP API. Begge er REST-baserte og har OpenAPI-spesifikasjoner. JobBOSS² API leser og skriver ordrer, Order Routings, Estimates, Work Centers, innkjøpsordrer og Time Tickets for kunder med leverandørdrift.
Hvordan autentiserer integrasjonen seg mot JobBOSS²?
Med OAuth 2.0 client credentials. ECI aktiverer API-et, en API-bruker opprettes i Integration Engine Management Console, og hvert kall inneholder et Bearer-token.
Støtter JobBOSS² webhooks?
Det er ikke dokumentert webhooks i ECIs API-er, så integrasjonen henter data fra JobBOSS² periodisk med lastModDate-filtre. Intervallet fastsettes for hver bedrift. SkyPlanners egne webhooks sender planendringer så snart de skjer.
Hvordan skrives planlagte datoer tilbake til JobBOSS²?
For hvert jobbtrinn. SkyPlanner oppdaterer hver Order Routing med PATCH-kall som inneholder estimatedStartDate og estimatedEndDate, samt workCenter og employeeCode når trinnet er flyttet til en annen maskin eller operatør.
Bør en JobBOSS²-partner anbefale ECI APS eller SkyPlanner?
SkyPlanner, når kunden vil komme i gang i løpet av uker med produksjonsplanlegging som omfatter flere ressurser og tar hensyn til faktisk kapasitet. ECI APS er en separat tilleggsmodul basert på LYNQ. SkyPlanner kobles til via ECIs eget JobBOSS² API, planlegger omstillinger, team, fiksturer og materialer og oppdaterer planen automatisk. Prisen starter på 199 € per måned.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med import fra JobBOSS² via CSV eller Excel. Du trenger ikke kredittkort. Start prøveperioden, eller kontakt salg for å avklare omfanget av integrasjonen.
