Ghid de integrare JobBOSS² pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare JobBOSS² le arată partenerilor și echipelor IT cum să conecteze JobBOSS² de la ECI la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu JobBOSS², folosind API-urile ECI:
- Sunt importate Orders și Order Line Items, Order Routings, Estimates, Routings și materiale, Work Centers, Employees, Company Calendar, Job Requirements și pozițiile comenzilor de achiziție.
- Datele planificate de început și de sfârșit sunt trimise înapoi la fiecare etapă Order Routing.
- Dacă alegeți această opțiune, pontajele operatorilor pot fi trimise înapoi ca Time Ticket Details.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră JobBOSS² în etapa de implementare inițială și asigură asistența după punerea în producție. Acest ghid se adresează partenerilor și dezvoltatorilor care doresc să participe sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația API). Un atelier din SUA care produce la comandă a făcut deja exact acest lucru:
Interfețele de integrare JobBOSS²
ECI își publică API-urile pentru producție, împreună cu specificațiile OpenAPI, pe site-ul de documentație pentru API-urile de producție ECI. Două dintre ele sunt relevante pentru programarea producției:
- JobBOSS² API (v1). Folosește REST și JSON și este dedicat JobBOSS². Permite citirea și scrierea comenzilor, a obiectelor Order Line Items, Order Routings, Estimates, Routings, a materialelor, a obiectelor Job Requirements, Work Centers, Company Calendar, Employees, a comenzilor de achiziție și a obiectelor Time Tickets și Time Ticket Details. ECI precizează că acesta “is currently only supported for JobBOSS² hosted (Cloud) customers.” (este în prezent disponibil doar pentru clienții JobBOSS² găzduiți în cloud).
- ECI ERP API (v2.1). Un REST API independent de produs, pentru Deacom, M1 și JobBOSS². Pentru JobBOSS², acoperă comenzile de producție, operațiile și materialele acestora, reperele și operațiile lor, centrele de lucru, pozițiile comenzilor de achiziție și înregistrările de pontaj. ECI menționează că “the actual ERP database could be a cloud hosted ERP or on premises install,” (baza de date ERP poate aparține unui ERP găzduit în cloud sau unei instalări locale), așadar aceasta este varianta pentru JobBOSS² instalat local.
Ambele API-uri folosesc aceleași convenții: expresii de filtrare precum lastModDate[gte]=, parametrul fields=, sort= și paginare cu take și skip, valoarea implicită pentru take fiind 200. “All dates submitted to the API are assumed to be in UTC.” (Toate datele trimise către API sunt considerate a fi în UTC.)
Regula ECI pentru ambele API-uri: “All APIs must be activated by ECI before use.” (Toate API-urile trebuie activate de ECI înainte de utilizare.) Contactați din timp responsabilul dumneavoastră de cont de la ECI.
Autentificare și acces
- Utilizatori API. Integrarea folosește un utilizator API creat în Integration Engine Management Console de la ECI. Utilizatorul API determină produsul, clientul și baza de date către care sunt direcționate apelurile.
- Credențiale de client OAuth 2.0. Identificatorul și secretul clientului sunt folosite pentru a obține un token de la endpointul pentru tokenuri al Authentication API. Fiecare apel trimite apoi
Authorization: Bearer [token]. - Drepturi de acces. Acordați utilizatorului API acces doar la resursele necesare conform tabelului de mapare de mai jos.
În SkyPlanner, REST API folosește un token API pentru autentificare (SkyPlanner Settings > API) și este documentat în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Evenimente și interogări periodice
Niciunul dintre cele două API-uri ECI nu documentează webhookuri. Datele din JobBOSS² sunt preluate prin interogări periodice: filtrați Order Line Items, Order Routings și pozițiile comenzilor de achiziție după lastModDate, de la ultima rulare, și paginați cu take și skip. Frecvența se stabilește pentru fiecare atelier, de la câteva minute pentru comenzile de producție până la o oră pentru stocuri.
SkyPlanner trimite webhookuri când se modifică starea sau programul de producție, astfel că transmiterea datelor înapoi este declanșată de evenimente.
Maparea datelor
| Obiect JobBOSS² (resursă JobBOSS² API) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Estimates (/estimates), materiale (/materials) | Produse, materiale, structura produsului | JobBOSS² → SkyPlanner | Încărcare inițială, apoi la modificare |
Routings (/routings): centru de lucru, timp de reglaj, timp de ciclu, mărimea echipei, utilaje pentru operație | Etape ale procesului cu durate și timpi de reglaj | JobBOSS² → SkyPlanner | Încărcare inițială, apoi la modificare |
Work Centers (/work-centers): ore pe schimb, funcționare în schimburile 1 până la 3, zile lucrătoare | Centre de lucru, grupuri de centre de lucru, eficiențe | JobBOSS² → SkyPlanner | Încărcare inițială, apoi rareori |
Company Calendar (/company-calendars), Employees (/employees) | Schimburi, zile nelucrătoare, personal | JobBOSS² → SkyPlanner | Zilnic sau cu gestionarea schimburilor în SkyPlanner |
Orders și Order Line Items (/order-line-items): numărul comenzii de producție, termen de livrare, prioritate, cantitate de fabricat | Comenzi cu termene de livrare și priorități | JobBOSS² → SkyPlanner | Interogare la câteva minute |
Order Routings (/order-routings): etapele comenzii de producție, stare, ore rămase | Operații pentru fiecare etapă a procesului | JobBOSS² → SkyPlanner | Interogare la câteva minute |
Job Requirements (/job-requirements), pozițiile comenzilor de achiziție (/purchase-order-line-items) | Necesar de materiale, comenzi de achiziție în funcție de data livrării | JobBOSS² → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Începutul și sfârșitul planificate, utilajul și operatorul pentru fiecare etapă | SkyPlanner → JobBOSS² | La modificarea programului de producție, prin webhook SkyPlanner |
| Time Ticket Details (POST): comandă de producție, etapă, centru de lucru, angajat, timp de reglaj, timp de ciclu, piese finalizate și rebutate, ora de început și de sfârșit | Pontaje și confirmări ale operatorilor | SkyPlanner → JobBOSS² | La fiecare confirmare sau pe schimb, dacă se alege această opțiune |
| Nu există în JobBOSS² | Matricea timpilor de pregătire și tranziție, scule ca resurse cu capacitate finită, utilaje și personal alternativ | Gestionate în SkyPlanner | Configurate în etapa de implementare inițială |
Pentru JobBOSS² instalat local, aceleași obiecte sunt citite prin resursele ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers și /purchase-order-lines, iar pontajele sunt trimise către /timecard-lines.
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți Estimates, Routings, materialele, Work Centers, Company Calendar și Employees. Stabiliți cu atenție maparea centrelor de lucru: un centru de lucru cu patru strunguri devine un grup de centre de lucru sau patru centre de lucru, astfel încât SkyPlanner să ordoneze operațiile pe fiecare utilaj.
2. Sincronizarea comenzilor de producție. Citiți obiectele Order Line Items deschise, împreună cu Order Routings și Job Requirements asociate, precum și pozițiile deschise ale comenzilor de achiziție. SkyPlanner consideră materialul comandat disponibil la data livrării din comanda de achiziție și actualizează stocul când aceasta este marcată Delivered. Excludeți comenzile de producție suspendate și pe cele închise.
3. Trimiterea programului de producție înapoi. Când motorul programează sau mută o etapă, un webhook SkyPlanner declanșează un PATCH către /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Acesta setează estimatedStartDate și estimatedEndDate în UTC, precum și workCenter și employeeCode când SkyPlanner a realocat etapa unui alt utilaj sau unei alte persoane. Datele sunt înscrise în etapele comenzilor de producție afișate deja în Whiteboard, Planning Board și Scheduling Advisor.
4. Confirmări din producție. Operatorii își înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer, iar pontajele mențin programul de producție actualizat. Dumneavoastră alegeți dacă timpii efectivi sunt trimiși înapoi în JobBOSS². Dacă da, fiecare confirmare devine un Time Ticket Detail cu timpul de reglaj, timpul de ciclu și numărul de piese. Dacă nu, colectarea datelor rămâne în JobBOSS², iar SkyPlanner citește progresul din Order Routings.
5. Responsabilitatea pentru date și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în producție:
| Date | Sistem responsabil |
|---|---|
| Estimates, Routings, cantități, termene de livrare, starea comenzii de producție | JobBOSS² |
| Succesiunea etapelor, orele de început și de sfârșit, utilajul și operatorul pentru fiecare etapă | SkyPlanner |
| Matricea timpilor de pregătire și tranziție, necesarul de scule și operatori, resurse alternative | SkyPlanner |
| Schimburi și zile nelucrătoare | Un singur sistem, ales la definirea domeniului |
| Fișe de pontaj, eliberări de materiale, recepții, calculul costurilor | JobBOSS², cu date introduse direct sau trimise din pontajele SkyPlanner |
Alegeți un singur sistem care să scrie datele etapelor comenzilor de producție. Pentru comenzile pe care le programează, SkyPlanner înlocuiește reprogramarea în Whiteboard: planificatorii mută operațiile în SkyPlanner, iar datele sunt transmise către JobBOSS².
Etapele obișnuite ale proiectului
Implementarea se finalizează în mod normal în câteva săptămâni de la începerea etapei inițiale. Înainte de aceasta, validați programul de producție în perioada de probă gratuită de 30 de zile, folosind Work Centers, fluxuri tehnologice și comenzi de producție deschise, exportate din JobBOSS² în format CSV sau Excel.
- Mapare. Stabiliți tabelul de mapare, regulile privind responsabilitatea pentru date, frecvențele de sincronizare și dacă fișele de pontaj vor fi trimise înapoi.
- Acces prin ECI. Solicitați ECI să activeze JobBOSS² API sau ERP API și să creeze utilizatorul API. Dacă aveți o companie de test într-un mediu sandbox, efectuați testele pe aceasta.
- Încărcarea inițială. Estimates, Routings, Work Centers, calendarul și angajații.
- Sincronizarea comenzilor de producție și a comenzilor de achiziție. Interogări periodice cu filtre
lastModDate, paginare și reîncercări. - Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire și tranziție, sculele, numărul de operatori pentru fiecare operație și utilajele sau personalul alternativ.
- Retransmiterea programului de producție. Apeluri PATCH pentru Order Routing, declanșate de webhook-urile SkyPlanner, plus Time Ticket Details dacă se optează pentru acestea.
- Testarea în paralel. Rulați SkyPlanner în paralel cu panoul de planificare actual, comparați datele calendaristice și corectați nomenclatoarele.
- Punerea în producție. Activați retransmiterea datelor către sistem după ce datele coincid.
Ce trebuie să aveți în vedere la integrarea cu JobBOSS²
- Găzduire sau instalare locală. JobBOSS² API deservește clienții care folosesc varianta găzduită. Instalările locale folosesc ERP API, care are o listă diferită de resurse. Stabiliți varianta la pasul 1.
- UTC peste tot. API-ul citește și scrie în UTC. Convertiți orele la fusul orar al fabricii; altfel, un început la 7:00 va fi înregistrat la o oră greșită.
- Centre de lucru care grupează mai multe utilaje. Un centru de lucru poate reprezenta un utilaj, un grup, o celulă sau persoane. Numărul de utilaje și mărimea echipei pentru fiecare etapă a fluxului tehnologic îi indică lui SkyPlanner de câte resurse are nevoie etapa respectivă.
- Servicii externalizate. Etapele care au un furnizor în locul unui centru de lucru reprezintă lead time, nu capacitate proprie. Modelați-le ca etape care ocupă doar timp.
- Etape suprapuse și etape fără supraveghere. Etapele fluxului tehnologic pot fi marcate pentru suprapunere sau pentru execuție fără supraveghere. Transferați ambii indicatori pentru a planifica corect lucrul fără prezența operatorilor.
- Unități de timp. Timpii de reglaj și timpii de ciclu au propriile unități, iar timpul de așteptare la coadă nu este timp de utilizare a utilajului. Convertiți unitățile la import; altfel, toate duratele vor fi greșite.
- Paginare. În mod implicit, o pagină conține 200 de înregistrări. Folosiți paginarea la fiecare citire.
Cine configurează integrarea cu JobBOSS² și asigură suportul
- Echipa SkyPlanner configurează integrarea în etapa de implementare și asigură suportul după punerea în producție, pentru resursele și regulile de interogare convenite. Fiecare fabrică folosește JobBOSS² diferit, iar aceste cunoștințe practice sunt valorificate aici.
- Partenerul dumneavoastră JobBOSS² poate participa. Acesta vă cunoaște configurația și, împreună cu echipa SkyPlanner, poate coordona cu ECI activarea API-ului și crearea utilizatorului API.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind REST API de la SkyPlanner și un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență la nevoie. Consultați documentația de integrare SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Oferta pentru integrare este stabilită de la început, în funcție de procesul și nevoile dumneavoastră, împreună cu abonamentul. Consultați prețurile, programarea cu capacitate finită pentru JobBOSS², pagina JobBOSS², funcționalitățile SkyPlanner și secțiunea de integrări ERP.
Producători care folosesc SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate centrele de lucru, durează mai puțin de 30 de minute.
Peste 1,000de comenzi de producție programate automat
„Avem un alt nivel de control asupra producției și înțelegem cu totul altfel capacitatea de producție de care dispunem.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă de înaltă tehnologie
Mii de comenzi de producție sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
98%respectarea termenelor de livrare, în creștere de la aproximativ 50%
„SkyPlanner joacă un rol decisiv în menținerea nivelului nostru de respectare a termenelor de livrare.”
Hannu Lahtinen, director general
KJH-Comp · Confecții din tablă și producție la comandă
Rata de respectare a termenelor de livrare a crescut de la aproximativ 50% până la 98%, iar programarea necesită acum un singur supervizor în loc de doi.
Întrebări frecvente
JobBOSS² are un API?
Da. ECI pune la dispoziție JobBOSS² API și ERP API, care este independent de produs, ambele de tip REST, cu specificații OpenAPI. Pentru clienții care folosesc varianta găzduită, JobBOSS² API citește și scrie comenzi, Order Routings, Estimates, Work Centers, comenzi de achiziție și Time Tickets.
Cum se autentifică integrarea în JobBOSS²?
Prin fluxul client credentials din OAuth 2.0. ECI activează API-ul, se creează un utilizator API din Integration Engine Management Console, iar fiecare apel include un token Bearer.
JobBOSS² acceptă webhook-uri?
Documentația API-urilor ECI nu menționează webhook-uri, așa că integrarea interoghează periodic JobBOSS² cu filtre lastModDate, la intervale stabilite pentru fiecare fabrică. Webhook-urile proprii SkyPlanner transmit modificările programului pe măsură ce apar.
Cum sunt înregistrate în JobBOSS² datele planificate în SkyPlanner?
Pentru fiecare etapă a operației. SkyPlanner actualizează fiecare Order Routing prin PATCH, cu estimatedStartDate și estimatedEndDate, plus workCenter și employeeCode atunci când etapa a fost mutată la alt utilaj sau operator.
Un partener JobBOSS² ar trebui să propună ECI APS sau SkyPlanner?
SkyPlanner, atunci când clientul dorește programare cu capacitate finită pentru mai multe resurse, funcțională în câteva săptămâni. ECI APS este un modul suplimentar separat, bazat pe LYNQ. SkyPlanner se conectează prin JobBOSS² API de la ECI, planifică schimbările de serie, echipele, dispozitivele de fixare și materialele, replanifică automat și pornește de la 199 € pe lună.
Putem testa SkyPlanner înainte de a dezvolta integrarea?
Da. Perioada de probă gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri CSV sau Excel din JobBOSS², fără a fi necesar un card de credit. Începeți perioada de probă sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
