Ghid de integrare MRPeasy pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare MRPeasy le arată consultanților și echipelor IT cum să conecteze MRPeasy la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu MRPeasy prin interfața REST API a MRPeasy:
- Sunt importate comenzile de producție, fluxurile tehnologice, listele de materiale (BOM), grupurile de centre de lucru, centrele de lucru, articolele, stocurile și comenzile de achiziție.
- Datele calendaristice planificate și progresul sunt transmise înapoi către fiecare Manufacturing Order.
- Webhook-urile SkyPlanner transmit modificările programului de producție pe măsură ce apar.
SkyPlanner a fost integrat cu MRPeasy în proiecte pentru clienți. În etapa de implementare, echipa SkyPlanner adaptează integrarea la configurația dumneavoastră MRPeasy și asigură suport după punerea în funcțiune. Acest ghid se adresează consultanților și dezvoltatorilor care doresc să participe sau să dezvolte singuri soluții folosind interfața REST API documentată a SkyPlanner (documentația de referință API).
Interfața REST API a MRPeasy: v1 și v2
MRPeasy este un produs unic în cloud, fără versiuni instalate local, astfel că toți clienții folosesc același API. Există două versiuni:
- REST API v1 (OpenAPI 1.0, server
https://api.mrpeasy.com/rest/v1) este API-ul folosit în producție. Acesta include/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsși rapoarte de producție precum/report/production/operations. - REST API v2 (OpenAPI 2.0.0, server
https://api.mrpeasy.com/rest/v2) se află într-un stadiu incipient de dezvoltare. Adaugă/workstation-groupscuwork_hoursșiholidays,/workstationscuproductivityșiidle,/inventory,/stock-movementși PATCH. Comenzile de producție rămân pe v1.
Atenție la denumiri. Un Workstation group din interfața MRPeasy corespunde în v1 cu work-center-types (type_id). Un Workstation corespunde cu work-centers (center_id). Operațiile din fluxul tehnologic fac referire la un grup prin type_id, nu la un utilaj.
API-ul este inclus în planul Unlimited al MRPeasy, pentru conturile cu plată. MRPeasy precizează și că “Our Support Department cannot help you using the API.” (Departamentul nostru de asistență nu vă poate ajuta să utilizați API-ul.) Prin urmare, cineva trebuie să răspundă de integrare: SkyPlanner, consultantul dumneavoastră MRPeasy sau dezvoltatorul dumneavoastră. Echipa SkyPlanner preia exact această responsabilitate în etapa de implementare.
Autentificare și limite
MRPeasy folosește autentificarea HTTP Basic: Authorization: Basic base64(api-key:api-secret). Cheia și secretul se creează în Settings → Integration → API access. Ștergerea cheii dezactivează API-ul.
Aceste limite determină modul de proiectare a sincronizării:
- Pentru fiecare client se procesează câte o singură cerere odată: cererile sunt procesate secvențial.
- Cel mult 100 de cereri în 10 secunde. La depășirea acestei limite, API-ul returnează codul 429.
- Listele returnează implicit 100 de înregistrări și până la 1.000 cu antetul
Range. AntetulContent-Rangedin răspuns indică totalul.
În SkyPlanner, interfața 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 interogare periodică
Pagina de prețuri MRPeasy menționează “API, webhooks (for paid accounts)” (API, webhook-uri pentru conturile cu plată), însă specificațiile v1 și v2 nu documentează evenimente webhook pentru comenzile de producție. De aceea, integrarea interoghează MRPeasy incremental:
- Comenzile de producție sunt filtrate după stările Not scheduled (15), Scheduled (20), In progress (30) și Paused (35).
- Comenzile de achiziție și stocurile sunt preluate la intervale stabilite sau înainte de fiecare rulare a programării.
- Nomenclatoarele sunt preluate la modificare sau în fiecare noapte.
Interogările secvențiale, cu filtre, rămân mult sub limita de 100 de cereri în 10 secunde. În sens invers, webhook-urile proprii SkyPlanner transmit modificările programului de producție pe măsură ce apar, astfel că scrierea înapoi este declanșată de evenimente.
Maparea datelor
| Obiect MRPeasy (endpoint) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Produse și materiale | MRPeasy → SkyPlanner | Încărcare inițială, apoi în fiecare noapte |
BOM cu componente (/boms) | Structura produsului, subproduse, materiale pentru fiecare produs | MRPeasy → SkyPlanner | Încărcare inițială, apoi la modificare |
Operații din fluxul tehnologic (/routings): type_id, fixed_time, variable_time, variable_quantity | Etape de proces cu durate, timpi de reglaj și mărimea lotului | MRPeasy → SkyPlanner | Încărcare inițială, apoi la modificare |
Workstation group (/work-center-types; v2 /workstation-groups) | Grupuri de centre de lucru, schimburi | MRPeasy → SkyPlanner | Încărcare inițială, apoi rar |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Centre de lucru, randamente, absențe | MRPeasy → SkyPlanner | Încărcare inițială, zilnic pentru perioadele de inactivitate |
Manufacturing Order cu operații, due_date (/manufacturing-orders) | Comenzi și operații | MRPeasy → SkyPlanner | Interogare la fiecare câteva minute |
Inventory, Stock lots (/stock/inventory, /lots) | Solduri de stoc | MRPeasy → SkyPlanner | O dată pe oră sau la fiecare rulare a programării |
Purchase Order (/purchase-orders) | Materiale în curs de aprovizionare, cu data estimată a livrării | MRPeasy → SkyPlanner | O dată pe oră sau la fiecare rulare a programării |
Câmpurile due_date și custom_<id> din Manufacturing Order (PUT /manufacturing-orders/{id}) | Început planificat, finalizare planificată, progres | SkyPlanner → MRPeasy | La modificarea programului de producție, prin webhook SkyPlanner |
| Nu există în MRPeasy | Matricea timpilor de pregătire, scule ca resurse limitate, numărul de operatori, centre de lucru alternative | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Preluați articolele, unitățile de măsură, listele BOM și fluxurile tehnologice din v1, iar grupurile de centre de lucru și centrele de lucru din v1 sau v2. Preluați calendarele din v2 /workstation-groups (work_hours, holidays) sau configurați schimburile direct în SkyPlanner. Asociați fiecare grup Active processing cu un grup de centre de lucru din SkyPlanner, incluzând centrele sale de lucru ca membri.
2. Sincronizarea comenzilor. Citiți comenzile de producție deschise împreună cu operațiile lor, precum și comenzile de achiziție deschise și stocurile. SkyPlanner consideră materialele comandate disponibile la data livrării din comanda de achiziție și actualizează stocul când aceasta este marcată cu starea Delivered. La fiecare reprogramare sunt verificate atât stocurile, cât și achizițiile în curs de livrare.
3. Scrierea programului de producție înapoi în MRPeasy. PUT /manufacturing-orders/{id} acceptă code, quantity, due_date și assigned_id, precum și câmpuri personalizate în forma custom_<id>. SkyPlanner scrie finalizarea planificată în due_date dacă s-a convenit astfel. Începutul planificat, finalizarea planificată și progresul sunt scrise în câmpurile personalizate MRPeasy. Echipele de vânzări și achiziții văd apoi programul real în MRPeasy. Succesiunea detaliată a operațiilor și centrul de lucru alocat fiecărei operații sunt păstrate în SkyPlanner, care oferă secției de producție vizualizarea lucrărilor de executat.
4. Comenzi create în afara MRPeasy. Dacă se creează comenzi prin API, POST /manufacturing-orders acceptă no_scheduling și no_bookings. Folosiți-le pentru ca MRPeasy să nu rezerve centrele de lucru pe care SkyPlanner le programează deja.
5. Confirmări din secția de producție. Operatorii înregistrează lucrul efectuat prin SkyPlanner Mobile Confirmations, Production Timer sau Quick Log Mode, iar înregistrările de timp mențin programul de producție la zi. Alegeți un singur canal de raportare. Folosirea în paralel a Internet-kiosk din MRPeasy și a SkyPlanner pentru aceleași operații creează două versiuni ale realității.
6. Responsabilități și reguli pentru conflicte. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Articole, liste BOM, fluxuri tehnologice, cantități, stocuri, aprovizionare | MRPeasy |
| Succesiunea operațiilor, orele de început și de sfârșit, alocarea centrelor de lucru | SkyPlanner |
| Matricea timpilor de pregătire, scule, numărul de operatori, resurse alternative | SkyPlanner |
| Schimburi și absențe | Un singur sistem, ales la definirea domeniului |
| Progresul comenzilor și lucrul înregistrat | SkyPlanner, cu un rezumat în Manufacturing Order |
Flux pentru proiectare la comandă. Într-un proiect MRPeasy implementat, fiecare proiect al clientului devine un produs principal și între unul și trei semifabricate. Fiecare are propria listă de materiale (BOM) și propriul flux tehnologic în MRPeasy, iar comanda de fabricație există în ambele sisteme. Păstrați un identificator comun stabil pentru fiecare comandă, astfel încât actualizările să nu creeze niciodată duplicate.
Etapele obișnuite ale proiectului
Implementarea se finalizează de obicei în câteva săptămâni de la începerea procesului de punere în funcțiune. Înainte de această etapă, puteți folosi perioada de probă gratuită de 30 de zile cu propriile date, indiferent de abonamentul MRPeasy. Exportați articolele, listele de materiale (BOM), fluxurile tehnologice, centrele de lucru și comenzile de fabricație deschise din listele MRPeasy în format CSV, importați-le și validați programul de producție.
Proiectul propriu-zis cuprinde:
- Verificarea abonamentului. Confirmați că abonamentul MRPeasy include acces la API și creați cheia API și secretul.
- Maparea. Stabiliți tabelul de corespondență, regulile privind sistemul responsabil pentru fiecare set de date, câmpurile personalizate pentru scrierea datelor înapoi și canalul de raportare.
- Încărcarea inițială. Articole, unități de măsură, liste de materiale (BOM), fluxuri tehnologice, grupuri de centre de lucru, centre de lucru și calendare.
- Sincronizarea comenzilor și a comenzilor de achiziție. Interogare periodică incrementală în funcție de stare, cu tratarea răspunsurilor 429.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire între operații, scule, numărul de operatori și centre de lucru alternative.
- Scrierea datelor înapoi. Termene de finalizare și câmpuri personalizate pentru fiecare Manufacturing Order.
- Testarea în paralel. Rulați SkyPlanner în paralel cu programul de producție actual, comparați datele calendaristice și corectați nomenclatoarele.
- Punerea în producție. Activați scrierea datelor înapoi după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu MRPeasy
- Câmpurile de timp diferă în funcție de interfață. Câmpurile Setup time, Cycle time și Capacity din interfața de utilizare corespund câmpurilor
fixed_time,variable_timeșivariable_quantitydin API. O valoare Capacity mai mare de 1 înseamnă procesare în lot, ca în cazul unui cuptor. Mapați-o ca operație pe lot, nu ca ciclu mai lung. - Grupuri de procesare pasivă. Grupurile de uscare și răcire funcționează 24/7, fără limite de capacitate. Mapați-le ca timpi de așteptare, nu ca centre de lucru cu capacitate finită.
- Calendarele lipsesc din v1.
work-centersreturnează doarcenter_id,type_id,codeșititle. Folosiți v2 sau gestionați schimburile în SkyPlanner. - Timpi de inactivitate. Timpii de inactivitate ai centrelor de lucru includ mentenanța și opririle. Sincronizați-i; altfel, SkyPlanner va programa operații pe un utilaj oprit.
- Fluxurile tehnologice fac trimitere la grupuri. MRPeasy alege utilajul cu cea mai bună disponibilitate. În SkyPlanner, centrele de lucru din grup devin alternative reale între care motorul de programare poate alege.
Integrarea cu MRPeasy: cine o configurează și cine oferă asistență
Lucrările includ maparea fluxurilor tehnologice, a grupurilor de centre de lucru și a fluxului comenzilor, precum și configurarea constrângerilor care nu sunt stocate în MRPeasy: matricea timpilor de pregătire între operații, sculele, numărul de operatori și resursele alternative.
- Echipa SkyPlanner configurează integrarea în etapa de punere în funcțiune și oferă asistență după lansarea în producție. Fiecare fabrică folosește MRPeasy în mod diferit, iar configurarea valorifică tocmai aceste cunoștințe. Asistența MRPeasy nu acoperă lucrările legate de API, de aceea este important ca o singură echipă să răspundă de integrare.
- Consultantul dumneavoastră MRPeasy sau partenerul de integrare o poate realiza. Într-un proiect MRPeasy implementat, un partener de integrare a conectat cele două sisteme prin API-urile REST ale acestora. SkyPlanner pune la dispoziție REST API, documentație Swagger/OpenAPI și webhook-uri.
- Propriii dezvoltatori pot realiza integrarea folosind un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă ajutor atunci când este nevoie. Documentația produsului, inclusiv informațiile despre comenzile de achiziție și API-ul pentru produse și materiale, este disponibilă în documentația SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți de la început o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu oferta pentru abonament, astfel încât să cunoașteți costul total înainte de a începe. Consultați prețurile, funcționalitățile și comparația cu instrumentul de programare propriu MRPeasy în pagina Programare cu capacitate finită în MRPeasy. Prezentarea generală se află pe pagina MRPeasy, iar celelalte sisteme ERP sunt prezentate în secțiunea de integrări ERP.
Ce spun producătorii despre 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.
6 luniîn avans: echipa de vânzări vede capacitatea disponibilă
„SkyPlanner oferă o bază solidă și siguranță pentru întreaga planificare a producției.”
Anu Järvinen, manager de producție
Fredman Operations · Hârtie pentru ambalaje destinată contactului cu alimentele
Echipa de vânzări vede capacitatea disponibilă cu șase luni în avans, iar solicitările de modificare a programului, care necesitau o oră sau mai mult, primesc acum răspuns în câteva secunde.
Întrebări frecvente
MRPeasy are un API și de ce abonament am nevoie?
Da. MRPeasy oferă un REST API, cu v1 în producție și v2 în dezvoltare, disponibil în abonamentul Unlimited pentru conturile plătitoare. Autentificarea folosește HTTP Basic, cu o cheie API și un secret din Settings → Integration → API access.
Poate SkyPlanner să trimită programul de producție înapoi în MRPeasy?
Da. SkyPlanner actualizează fiecare Manufacturing Order prin PUT /manufacturing-orders/{id}, scriind termenul de finalizare și câmpurile personalizate pentru începutul planificat, sfârșitul planificat și progres. Succesiunea detaliată a operațiilor este păstrată în SkyPlanner, unde operatorii lucrează pe baza propriei liste de operații.
MRPeasy transmite automat modificările în timp real?
Specificațiile API nu documentează evenimente webhook pentru comenzile de fabricație, așa că SkyPlanner interoghează comenzile deschise în funcție de stare, la fiecare câteva minute. Webhook-urile proprii SkyPlanner transmit modificările programului pe măsură ce acestea au loc.
Cine realizează integrarea cu MRPeasy?
Echipa SkyPlanner configurează integrarea bidirecțională în etapa de punere în funcțiune și oferă asistență după lansarea în producție. Consultantul dumneavoastră MRPeasy, un partener de integrare sau propriii dezvoltatori pot, de asemenea, să realizeze integrarea folosind REST API și documentația SkyPlanner.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de probă gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri CSV din MRPeasy, indiferent de abonamentul MRPeasy și fără a fi necesar un card bancar. Începeți proba gratuită sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
