Ghid de integrare Lemonsoft pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Lemonsoft le arată partenerilor și echipelor IT cum să conecteze Lemonsoft ERP la SkyPlanner APS. Integrarea dintre SkyPlanner și Lemonsoft este bidirecțională și folosește REST API din Lemonsoft:
- În SkyPlanner se importă numerele comenzilor de producție (työnumero), etapele de lucru (työvaihe), utilajele, structurile de produs, materialele și schimburile planificate.
- Orele planificate de început și de sfârșit și utilajul ales sunt transmise înapoi pentru actualizarea etapelor de lucru.
- Confirmările operatorilor sunt transmise înapoi ca înregistrări de finalizare.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Kaskea Group folosește SkyPlanner cu o integrare bidirecțională cu Lemonsoft. Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Lemonsoft în etapa de inițiere și asigură asistență după punerea în funcțiune. Partenerii și dezvoltatorii pot crea la rândul lor integrări folosind REST API documentat al SkyPlanner (documentația API).
REST API din Lemonsoft
API-ul de integrare Lemonsoft este LemonRest, documentat în format Swagger 2.0, versiunea v1. Versiunea „LemonRest 2026.10 release-2026.10.2” include 422 de căi. (Swagger)
- URL-ul de bază este specific fiecărui mediu. Îl găsiți în administrarea utilizatorilor, la administrarea mediilor și adresele serviciilor, în câmpul Rest API. Pe platforma Azure a Lemonsoft, adresa de bază este
https://rest.lemon.fi. - Disponibilitate. Pentru clienții serviciului de platformă Lemonsoft (Alustapalvelu), API-urile REST sunt preinstalate și necesită doar acordarea drepturilor de utilizare. (sursă)
- Mediu de testare. Clientul final îl comandă de la Lemonsoft Service Desk.
API-ul separat Kellokortti pentru pontaj nu este necesar pentru programarea producției.
Autentificare
LemonRest folosește o sesiune:
POST /api/auth/login, cu UserName, Password, Database și ApiKey, returnează unsession_id.- Trimiteți-l în antetul
Session-Idla fiecare apel. - Reînnoiți sesiunea cu
POST /api/auth/renew. Pentru verificarea funcționării se foloseșteGET /api/auth/alive.
POST /api/auth/login/token primește un Token în locul numelui de utilizator și al parolei. Creați un utilizator dedicat integrării, cu o cheie API și doar cu drepturile necesare integrării. (sursă)
În SkyPlanner, autentificarea la REST API se face cu un token API (SkyPlanner Settings > API), iar documentația este în format Swagger/OpenAPI. Tutorialul de integrare explică pas cu pas cum să efectuați primele apeluri.
Detectarea modificărilor: interogări delta
LemonRest nu are endpointuri pentru webhookuri sau abonamente. Modificările se citesc printr-o interogare delta:
GET /api/production/main_ws/changed?updated_after=...returnează operațiile modificate de la ultima rulare.- Adăugați
optimization=true. Acest parametru a fost introdus în versiunea 2026.6.3 pentru a elimina dependența de jurnal și a accelera interogarea. (notele versiunii) GET /api/log/deletion_eventsidentifică operațiile șterse, astfel încât lucrările anulate să fie eliminate din program.
Interogați sistemul la fiecare câteva minute. SkyPlanner trimite webhookuri când se modifică starea sau programul, astfel că transmiterea datelor înapoi este declanșată de evenimente.
Maparea datelor
| Obiect Lemonsoft (endpoint) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Tuote, product_code (/api/products) | Produse și materiale | Lemonsoft → SkyPlanner | La încărcarea inițială, apoi la modificări |
Tuoterakenne cu rânduri Työvaiheet (/api/products/structure, all_levels) | Structura produsului, subproduse, etape de proces cu timpi de pregătire | Lemonsoft → SkyPlanner | La încărcarea inițială, apoi la modificări |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Centre de lucru, grupuri de centre de lucru | Lemonsoft → SkyPlanner | La încărcarea inițială, apoi rar |
Työnumero ca ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Comenzi cu termene de finalizare și prioritate | Lemonsoft → SkyPlanner | Interogări delta la fiecare câteva minute |
Työvaihe ca ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operații (etape de proces) pentru fiecare centru de lucru | Lemonsoft → SkyPlanner | Interogări delta la fiecare câteva minute |
Necesar de componente (main_ws/{worknumber}/materials) | Necesar de materiale pentru fiecare operație | Lemonsoft → SkyPlanner | Odată cu fiecare operație |
Schimburi planificate (/api/persons/plannedshifts) | Schimburi, personal | Lemonsoft → SkyPlanner | Zilnic sau cu schimburile gestionate în SkyPlanner |
Comanda de vânzare asociată unui număr de comandă de producție (/api/orders/work/{work_number}) | Informații despre client și prioritate | Lemonsoft → SkyPlanner | Odată cu fiecare operație |
Câmpurile start_time, end_time, machine_id din Työvaihe (PUT /api/production/workstage) | Începutul, sfârșitul și centrul de lucru planificate | SkyPlanner → Lemonsoft | La modificarea programului, printr-un webhook SkyPlanner |
Înregistrare de finalizare (POST main_ws/sub_ws/completion_entry) | Confirmări: cantitate realizată și rebutată, ore, persoană | SkyPlanner → Lemonsoft | La fiecare confirmare |
| Reguli de programare stabilite în SkyPlanner | Centre de lucru permise pentru fiecare operație, matricea timpilor de pregătire, scule | Gestionate în SkyPlanner | Configurate în etapa de inițiere |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți utilajele și grupurile de utilaje, structurile de produs cu etapele lor de lucru și fazele de lucru standard. Asociați fiecare utilaj efectiv cu un centru de lucru SkyPlanner. Folosiți utilajele părinte (Isäkone) doar pentru grupare, deoarece acestea însumează capacitatea utilajelor subordonate.
2. Sincronizarea comenzilor de producție. Citiți numerele comenzilor de producție deschise, împreună cu etapele lor, din /api/production/workstage sau main_ws/sub_ws, cu filtrare după stare și paginare. Apoi mențineți datele actualizate cu main_ws/changed. Mapați work_amount_left, nu work_amount, deoarece Lemonsoft programează pe baza cantității rămase. Comenzile de achiziție furnizează datele pentru programarea SkyPlanner în funcție de materiale, astfel încât o etapă așteaptă data de livrare din comanda de achiziție.
3. Transmiterea programului înapoi. Pentru fiecare etapă programată sau mutată de motor, SkyPlanner trimite PUT /api/production/workstage cu operația și elementele sale sub_workstages. Fiecare etapă include start_time, end_time și, dacă a fost mutată pe un utilaj alternativ, machine_id.
4. Confirmări din secție. Operatorii confirmă lucrările cu SkyPlanner Mobile Confirmations sau Production Timer. Fiecare confirmare este trimisă la completion_entry cu sub_workstage_id, person_number, done_amount, hours, failed_amount și job_done. Trimiteți și material_consumptions când etapa consumă materiale, iar Lemonsoft efectuează o înregistrare obișnuită de finalizare a producției (valmistuskirjaus).
5. Responsabilitatea asupra datelor și regulile pentru conflicte. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Produse, structuri, etape de lucru, cantități, starea operației | Lemonsoft |
| Succesiunea etapelor, orele de început și de sfârșit, alegerea utilajului | SkyPlanner |
| Centre de lucru permise pentru fiecare operație, matricea timpilor de pregătire, scule | SkyPlanner |
| Schimburi și absențe | Un singur sistem, ales la definirea domeniului |
| Finalizări și înregistrări de stoc | Lemonsoft, pe baza confirmărilor transmise din SkyPlanner |
Principala sursă de conflicte o reprezintă programarea automată din Lemonsoft și acțiunea de reîmprospătare: ambele reprogramează etapele neblocate. Mențineți AUTOTIMING la 0 cât timp SkyPlanner gestionează programul. Dacă îl păstrați activ, blocați programarea pentru fiecare număr de comandă de producție actualizat; blocarea fixează toate etapele acelui număr. Doar Koneiden kapasiteetin lukitus nu este suficient, deoarece programarea automată mută operațiile neblocate de pe o zi blocată. (sursă)
Etapele obișnuite ale proiectului
Implementarea se finalizează de regulă în câteva săptămâni de la începerea etapei de inițiere. Înainte de aceasta, testarea gratuită de 30 de zile se face pe datele dumneavoastră dintr-un export Excel cu numerele comenzilor de producție, etapele și utilajele.
- Definirea domeniului. Stabiliți tabelul de mapare, regulile privind responsabilitatea asupra datelor și intervalul de interogare.
- Acces. Clientul final comandă un mediu de testare de la Lemonsoft Service Desk și creează utilizatorul de integrare și cheia API.
- Încărcare inițială. Utilaje, grupuri, structuri de produs și etape de lucru.
- Sincronizarea comenzilor de producție. Interogări delta, evenimente de ștergere și reînnoirea sesiunii.
- Configurarea constrângerilor în SkyPlanner. Centrele de lucru permise pentru fiecare operație, matricea timpilor de pregătire și sculele.
- Scrierea datelor înapoi în Lemonsoft. Orele planificate ale etapelor și înregistrările de finalizare, verificate în mediul de testare.
- Rularea în paralel și trecerea în producție. Comparați cu diagrama Gantt actuală, corectați nomenclatoarele, apoi activați scrierea datelor înapoi în mediul de producție.
Ce trebuie să aveți în vedere la integrarea cu Lemonsoft
- Un utilaj pentru fiecare etapă. Fiecărei etape din Lemonsoft îi este atribuit un singur utilaj. În timpul implementării inițiale, utilajele potrivite pentru fiecare produs sunt stabilite pe baza unei liste sau a proprietăților produsului. SkyPlanner alege apoi dintre aceste alternative.
- Capacitatea zilnică. Capacitatea fixă este exprimată ca valoare zilnică, iar abaterile nu au o oră asociată. Modelați schimburile reale în SkyPlanner sau preluați schimburile planificate.
- Cantitatea rămasă. Mapați câmpul
work_amount_left. Setările STARTJOB_AUTOTIMENOW și JOBDONE_AUTOTIMENOW deplasează în timp și încărcarea calculată de Lemonsoft. - Sesiunile expiră. Reînnoiți sesiunea înaintea sincronizărilor de lungă durată și tratați situațiile în care este impusă reautentificarea.
- Reguli de confirmare. Verificați fiecare confirmare în raport cu starea etapei înainte de a o înregistra și eșalonați apelurile trimise în rafală.
- Două aplicații client. LemonOnline și versiunea Windows folosesc aceeași bază de date, astfel încât integrarea le deservește pe ambele.
- Structuri mari. Pentru importuri mari, folosiți
/api/async/product/structureîmpreună cu/api/async/status/{jobId}.
Integrarea cu Lemonsoft: cine o configurează și asigură suportul
Lucrările includ maparea datelor în funcție de utilajele, etapele de lucru și configurația dumneavoastră Lemonsoft. Sunt incluse și regulile de programare pe care le păstrați în SkyPlanner: centrele de lucru permise pentru fiecare operație, matricea timpilor de pregătire și sculele.
- Echipa SkyPlanner configurează integrarea în timpul implementării inițiale și asigură suportul după trecerea în producție. Fiecare fabrică folosește Lemonsoft diferit, iar aceste cunoștințe sunt valorificate în configurare.
- Partenerul dumneavoastră Lemonsoft poate participa. Acesta vă cunoaște configurația și se poate ocupa de utilizatorul API, drepturile de acces și mediul de testare. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhook-uri.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind același REST API documentat și un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență la nevoie.
După conectare, motorul Arcturus programează producția pe baza datelor actualizate ale comenzilor de producție din Lemonsoft, iar orele planificate sunt înscrise în etapele de lucru. SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți în avans o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu oferta pentru abonament. Astfel, cunoașteți costul total înainte de a începe.
Vedeți cum se compară planificarea proprie din Lemonsoft în articolul Programare cu capacitate finită în Lemonsoft. Găsiți prezentarea generală pe pagina Lemonsoft, iar celelalte sisteme în secțiunea de integrări ERP.
Ce spun producătorii despre SkyPlanner
Lemonsoftintegrare bidirecțională cu SkyPlanner
Kaskea Group
Producție la comandă: prelucrări CNC, structuri metalice din oțel și asamblare
Producția este planificată în SkyPlanner, cu o integrare bidirecțională cu Lemonsoft.
Mai puțineopriri cauzate de lipsa materialelor
„Valoarea pe care ne-o aduce SkyPlanner este că funcționează în activitatea de zi cu zi, mai ales la stabilirea termenelor de livrare.”
Tommi Männistö, Manager de planificare a producției
Eskomatic · Prelucrări mecanice la comandă
Programarea automată a încărcării asigură termene de livrare mai precise, iar opririle de producție cauzate de lipsa materialelor s-au redus considerabil.
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.
Întrebări frecvente
Lemonsoft are un API pentru datele de producție?
Da. LemonRest oferă acces la operațiile de producție și etapele de lucru, utilaje, structuri de produs, materiale, schimburi și înregistrarea finalizărilor. Este preinstalat pentru clienții Alustapalvelu și necesită o cheie API și drepturi de utilizator.
Lemonsoft acceptă webhook-uri?
LemonRest nu listează endpoint-uri pentru webhook-uri. Modificările sunt preluate prin interogarea incrementală main_ws/changed și prin evenimentele de ștergere, verificate la fiecare câteva minute. Webhook-urile proprii SkyPlanner transmit modificările programului de producție pe măsură ce apar.
Cum sunt transmise orele planificate înapoi în Lemonsoft?
Prin PUT /api/production/workstage, care actualizează o operație și etapele sale de lucru cu ora de început, ora de sfârșit și utilajul. Mențineți programarea automată din Lemonsoft dezactivată cât timp SkyPlanner gestionează programul de producție sau blocați programarea pentru fiecare comandă de producție actualizată. Astfel, orele rămân cele stabilite de SkyPlanner.
Confirmările operatorilor din SkyPlanner pot fi înregistrate în Lemonsoft?
Da. Fiecare confirmare este transmisă ca înregistrare de finalizare, cu cantitatea realizată și cea rebutată, orele și persoana. Această funcționalitate este folosită zilnic în proiectele clienților.
Cine realizează integrarea cu Lemonsoft?
Echipa SkyPlanner configurează integrarea bidirecțională în funcție de configurația dumneavoastră Lemonsoft în timpul implementării inițiale și asigură suportul după trecerea în producție. Partenerul dumneavoastră Lemonsoft sau propriii dezvoltatori pot, de asemenea, să dezvolte soluții folosind interfața REST API documentată a SkyPlanner. Un token API este suficient pentru a începe.
Putem testa SkyPlanner înainte de realizarea integrării?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri Excel sau CSV din Lemonsoft, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
