Ghid de integrare APS cu Visma L7 pentru programarea producției
Acest ghid de integrare cu Visma L7 arată partenerilor și echipelor IT cum să conecteze Visma L7 la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu Visma L7 prin Visma L7 REST API:
- Sunt preluate numerele lucrărilor (työnumero), etapele de lucru (työnvaihe), resursele, structurile de produs, piesele, materialele, stocurile, liniile comenzilor de vânzare și cele ale comenzilor de achiziție.
- Pentru fiecare fișă de lucru, resursa, data de început, prioritatea, persoana și orele defalcate pe zile sunt trimise înapoi prin
PUT /manufphases/. - Capacitatea din calendarul resurselor este menținută sincronizată prin
POST /resourceupdates/. - Evenimentele de producție înregistrate în cozile de lucru L7 sunt preluate prin
GET /manufevents/. - Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră L7 în etapa de implementare inițială și asigură suport după punerea în funcțiune. Partenerii și dezvoltatorii pot crea, de asemenea, integrări folosind REST API-ul documentat al SkyPlanner (documentația API).
REST API-ul Visma L7
API-ul se numește Visma L7 – REST API și este documentat în format OpenAPI 3.0.3, cu un istoric al modificărilor (documentație). Acesta rulează pe Visma LTR.
- Calea de bază este
/ltrws/REST/L7pe serverul dumneavoastră LTR, instalat local sau în serviciul de găzduire a aplicațiilor oferit de Visma. - Licențiere. Fiecare endpoint se licențiază separat. Scrierea programului necesită licența L7RMFPP pentru
PUT /manufphases/, iar actualizările de capacitate necesită L7RMCAP. Endpointurile de citire au propriile licențe. - Paginare. Listele sunt paginate cu
pageSizeșirecAfterși filtrate cuqueryKey1,queryKey2șiqueryString.
Autentificare
Fiecare apel L7 include două tokenuri:
- hash selectează baza de date și compania.
- token identifică utilizatorul API.
Administratorul LTR creează utilizatorul API în Visma LTR, îl asociază companiei L7, îi atribuie profiluri și creează tokenul de utilizator (primii pași). Folosiți un utilizator dedicat integrării, cu strict drepturile de care aceasta are nevoie.
În SkyPlanner, autentificarea la REST API se face cu un token API trimis în antetul Authorization-Token. Îl creați din Settings > API. Tutorialul de integrare vă ghidează prin primele apeluri.
Detectarea modificărilor: modifiedAfter
L7 REST API nu oferă webhookuri. Modificările sunt preluate prin interogări periodice:
- Activați jurnalizarea modificărilor (DBLOG) în secțiunea de întreținere a fișierelor L7 (Tiedostohuolto) pentru tabelele citite de integrare, precum cele cu fișe de lucru și piese.
- Apelați endpointurile de citire cu
modifiedAftersetat la momentul ultimei rulări. Înregistrările șterse sunt returnate cu marcajul de ștergere, astfel încât lucrările anulate să fie eliminate din program. - Efectuați interogări la câteva minute. SkyPlanner trimite webhookuri când se schimbă starea sau programul, astfel încât scrierea datelor înapoi în L7 este declanșată de evenimente.
Maparea datelor
| Obiect Visma L7 (endpoint) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Tuote (GET /products/) | Produse și materiale | L7 → SkyPlanner | Încărcare inițială, apoi la modificări |
Piese aferente unui număr de lucrare (GET /manufcomponents/) | Subproduse | L7 → SkyPlanner | Interogare periodică cu modifiedAfter |
Necesar de materiale (GET /manufmaterials/) | Necesar de materiale pentru fiecare operație | L7 → SkyPlanner | Interogare periodică cu modifiedAfter |
Arbore de resurse (KRYH) cu numărul de utilaje (GET /manufresources/) | Centre de lucru și grupuri de centre de lucru | L7 → SkyPlanner | Încărcare inițială, apoi rar |
Fișă de lucru (TSUUNR) pentru fiecare etapă (GET /manufphases/) | Operații (etape de proces) pentru fiecare centru de lucru | L7 → SkyPlanner | Interogare la câteva minute |
Stocuri (GET /stockbalances/) | Stoc | L7 → SkyPlanner | Interogare periodică |
Linii ale comenzilor de achiziție (GET /purchaserows/) | Comenzi de achiziție cu date de livrare | L7 → SkyPlanner | Interogare periodică |
Comenzi de vânzare și liniile acestora (GET /salesorders/, GET /salesrows/) | Termene de livrare, prioritatea clientului | L7 → SkyPlanner | Interogare periodică |
Evenimente de producție (GET /manufevents/) | Progresul fiecărei operații | L7 → SkyPlanner | Interogare periodică |
Câmpurile resource, startDate, priority, person, schedulingDays ale fișei de lucru (PUT /manufphases/) | Centrul de lucru, începutul, ordinea și orele zilnice programate | SkyPlanner → L7 | La modificarea programului de producție, prin webhook SkyPlanner |
Capacitatea din calendarul resurselor (POST /resourceupdates/) | Capacitatea pe schimburi | SkyPlanner → L7 | La modificarea schimburilor |
| Reguli de programare stabilite în SkyPlanner | Centre de lucru permise, matricea timpilor de pregătire, scule, personal | Gestionate în SkyPlanner | Configurare în etapa de implementare inițială |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți arborele de resurse și asociați fiecare utilaj cu un centru de lucru propriu în SkyPlanner. Dacă o resursă L7 include mai multe utilaje, creați câte un centru de lucru pentru fiecare utilaj și un grup de centre de lucru pentru resursa respectivă. Citiți produsele și structurile de produs, împreună cu etapele lor de lucru.
2. Sincronizarea numerelor de lucrare. Citiți fișele de lucru deschise cu GET /manufphases/, apoi mențineți-le actualizate cu modifiedAfter. Citiți piesele și necesarul de materiale pentru fiecare număr de lucrare, precum și stocurile și liniile comenzilor de achiziție, astfel încât o etapă să aștepte data de livrare a liniei de achiziție aferente.
3. Scrierea programului înapoi în L7. Pentru fiecare etapă pe care motorul a programat-o sau a mutat-o, SkyPlanner apelează PUT /manufphases/. Corpul cererii conține câte o intrare workSheet pentru fiecare fișă de lucru, cu:
number, fișa de lucru, șiresource, resursa aleasăstartDateșipriority, astfel încât cozile de lucru L7 să afișeze ordinea stabilită de SkyPlannerperson, când este programat un operator nominalizatschedulingDays, orele programate pentru fiecare dată
L7 păstrează neschimbată prioritatea stabilită de un sistem extern (sursă), astfel încât ordinea se menține în cozile de lucru.
4. Sincronizarea capacității. Când se modifică schimburile, zilele libere sau orele suplimentare în SkyPlanner, POST /resourceupdates/ scrie noua capacitate în calendarul resurselor L7. Vizualizările de încărcare din L7 reflectă apoi planul.
5. Progresul din producție. Operatorii continuă să înregistreze activitatea în cozile de lucru L7 și în Visma LTR, iar SkyPlanner citește evenimentele cu GET /manufevents/. Operatorii pot confirma lucrările și în SkyPlanner Mobile Confirmations. Autopilot reprogramează pe baza datelor din oricare dintre cele două surse, iar următoarea scriere înapoi în L7 transmite noii timpi.
6. Responsabilitatea pentru date și regulile de rezolvare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Produse, structuri, etape de lucru, cantități, starea lucrării | Visma L7 |
| Ordinea etapelor, datele de început, orele zilnice, alegerea resursei | SkyPlanner |
| Centre de lucru permise, matricea timpilor de pregătire, scule, personal | SkyPlanner |
| Schimburi și absențe | SkyPlanner, cu scriere în calendarul resurselor L7 |
| Evenimente de producție și înregistrări ale mișcărilor de stoc | Cozile de lucru Visma L7 și LTR |
Principala sursă de conflicte este planificarea proprie din L7. Calculul necesarului și planificarea detaliată pot programa din nou etapele neblocate. Rulați-le doar pentru materiale și rezervări și nu reprogramați etapele gestionate de SkyPlanner.
Etapele obișnuite ale proiectului
Implementarea se încheie de obicei în câteva săptămâni de la începerea configurării inițiale. Înainte de aceasta, perioada de testare gratuită de 30 de zile se desfășoară cu datele dumneavoastră, exportate în Excel: numere de lucrare, etape și resurse.
- Definirea domeniului. Stabiliți tabelul de mapare, responsabilitatea pentru date și intervalul de interogare.
- Acces și licențe. Obțineți licențele pentru endpointurile REST incluse în proiect. Administratorul LTR creează utilizatorul API, hash și token, de preferat mai întâi într-o companie de test.
- Jurnalizarea modificărilor. Activați DBLOG pentru tabelele pe care le citiți.
- Încărcarea inițială. Resurse, produse, structuri și etape de lucru.
- Sincronizarea numerelor de lucrare. Interogare periodică cu modifiedAfter, ștergeri și paginare.
- Configurarea restricțiilor în SkyPlanner. Centre de lucru permise, matricea timpilor de pregătire, scule și personal.
- Scrierea înapoi în L7.
PUT /manufphases/șiPOST /resourceupdates/, testate în compania de test. - Rulare în paralel și punere în funcțiune. Comparați cu planul actual, corectați nomenclatoarele, apoi activați scrierea înapoi în L7 în mediul de producție.
Ce trebuie să aveți în vedere la integrarea cu Visma L7
- Licențe pentru fiecare endpoint. Inventariați din timp toate endpointurile și obțineți licențele înainte de testare.
- Numărul de utilaje. În L7, lucrul este repartizat între utilajele aceleiași resurse (sursa). Împărțiți resursa în centre de lucru în SkyPlanner, iar la scrierea înapoi transmiteți resursa pe care o așteaptă L7.
- Ore pe zi. L7 stochează programul ca număr de ore pentru fiecare dată. SkyPlanner trimite
schedulingDays, cu un total de ore egal cu durata etapei. - Calendarul fabricii. Păstrați-l complet, deoarece lipsurile duc la programarea etapelor în trecut (sursa).
- Comenzi pentru stoc.
mainNumber,subNumber,rowNumberșinewQuantityse folosesc doar pentru a modifica cantitatea unei comenzi pentru stoc. Omiteți-le pentru lucrările destinate clienților. - Următorul ERP. Visma a oprit dezvoltarea de funcționalități noi pentru L7, iar utilizarea produsului încetează la sfârșitul anului 2028 (anunțul Visma). Păstrați regulile de programare în SkyPlanner, nu în câmpurile L7, ca să le puteți folosi în continuare când schimbați sistemul ERP.
Integrarea cu Visma L7: cine o configurează și oferă asistență
Lucrările includ maparea în funcție de resursele, etapele de lucru și configurația L7 pe care le utilizați. Sunt incluse și regulile de programare păstrate în SkyPlanner: centrele de lucru permise, matricea timpilor de pregătire, sculele și personalul.
- Echipa SkyPlanner configurează integrarea în etapa de implementare și oferă asistență după intrarea în producție. Fiecare fabrică folosește L7 în mod diferit, iar aici sunt puse în practică aceste cunoștințe.
- Partenerul dumneavoastră Visma poate participa. Acesta cunoaște configurația L7 și LTR pe care o utilizați și se poate ocupa de utilizatorul API, licențe și compania de test. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhookuri.
- Propriii dumneavoastră dezvoltatori pot extinde integrarea folosind același REST API documentat și un token API. Pentru a începe este suficient un token API, iar echipa SkyPlanner vă ajută la nevoie.
Când înlocuiți L7, aceeași configurație SkyPlanner se conectează la noul ERP. Consultați paginile pentru Business Central, Visma Net, Lemonsoft, Monitor ERP și Odoo.
Prețul 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 procesele și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe.
Vedeți cum se compară funcțiile de planificare din L7 în articolul Visma L7 oferă programare cu capacitate finită? Prezentarea generală se află pe pagina Visma L7, iar celelalte sisteme sunt prezentate în secțiunea de integrări ERP.
Ce spun producătorii despre SkyPlanner
1.000+de comenzi de producție programate automat
„Avem un alt nivel de control asupra producției, iar înțelegerea capacității noastre este la un nivel complet diferit.”
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 a producției.
98%respectarea termenelor de livrare, în creștere de la aproximativ 50%
„SkyPlanner joacă un rol decisiv în menținerea nivelului de respectare a termenelor noastre de livrare.”
Hannu Lahtinen, director general
KJH-Comp · Prelucrarea tablei ș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 coordonator în loc de doi.
2 heconomisite în fiecare săptămână
„Cu SkyPlanner am trecut de la planificarea producției în foi 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 lucrări ajunge pe linia de producție în câteva secunde.
+90%eficiența producției
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența producției a crescut cu 90%, iar realizarea unui program optimizat pe trei luni, pentru toate centrele de lucru, durează mai puțin de 30 de minute.
Întrebări frecvente
Visma L7 are un API pentru datele de producție?
Da. REST API al Visma L7, disponibil prin Visma LTR, oferă acces la etapele de lucru, resurse, piese, materiale, evenimente de producție, produse, stocuri, linii de vânzare și linii de achiziție. Fiecare endpoint necesită o licență separată, iar administratorul LTR creează utilizatorul API și tokenurile.
Cum este transmis programul înapoi în Visma L7?
Prin PUT /manufphases/, care actualizează, pentru fiecare fișă de lucru, resursa, data de început, prioritatea, persoana și orele planificate pe date calendaristice. POST /resourceupdates/ înregistrează capacitatea în calendarul resursei. L7 păstrează prioritatea externă, astfel încât listele de lucrări respectă ordinea din SkyPlanner.
Visma L7 acceptă webhookuri?
Nu există webhookuri documentate. Activați jurnalizarea modificărilor pentru tabelele incluse în integrare și interogați-le periodic cu modifiedAfter. Webhookurile proprii SkyPlanner transmit modificările programului pe măsură ce apar.
Ce software de programare a producției se integrează cu Visma L7?
SkyPlanner APS se integrează bidirecțional cu Visma L7 prin REST API al L7, iar Visma listează Skycode cu SkyPlanner pe pagina sa de integrări L7. Echipa SkyPlanner configurează integrarea în etapa de implementare.
Cine realizează integrarea cu Visma L7?
Echipa SkyPlanner configurează integrarea bidirecțională în funcție de configurația dumneavoastră L7 în etapa de implementare și oferă asistență după intrarea în producție. Partenerul dumneavoastră Visma sau propriii dezvoltatori pot, de asemenea, extinde integrarea folosind REST API documentat al SkyPlanner, iar pentru a începe este suficient un token API.
Putem testa SkyPlanner înainte de a realiza integrarea?
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 L7, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
