Integracije / ERP / Visma L7
Visma L7: vodič za integracijo APS za terminiranje proizvodnje
Ta vodič za integracijo Visma L7 partnerjem in ekipam IT pokaže, kako povezati Visma L7 s SkyPlanner APS. SkyPlanner se z Visma L7 povezuje dvosmerno prek Visma L7 REST API:
- V SkyPlanner se prenašajo številke nalogov (työnumero), delovne faze (työnvaihe), viri, strukture izdelkov, sestavni deli, materiali, stanja zalog ter postavke prodajnih in nabavnih naročil.
- Za vsako delovno kartico se s klicem
PUT /manufphases/nazaj zapišejo vir, datum začetka, prioriteta, oseba in ure po posameznih dnevih. - Zmogljivosti v koledarju virov se usklajujejo s klicem
POST /resourceupdates/. - SkyPlanner s klicem
GET /manufevents/prebere proizvodne dogodke, zabeležene v delovnih vrstah L7. - SkyPlanner prek obvestil webhook pošilja spremembe terminskega plana takoj, ko nastanejo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši konfiguraciji L7 in zanjo zagotavlja podporo tudi po prehodu v produkcijo. Partnerji in razvijalci lahko rešitve gradijo tudi na dokumentiranem REST API sistema SkyPlanner (referenčna dokumentacija API).
REST API sistema Visma L7
Vmesnik se imenuje Visma L7 – REST API in je dokumentiran v obliki OpenAPI 3.0.3 z dnevnikom sprememb (dokumentacija). Deluje na Visma LTR.
- Osnovna pot je
/ltrws/REST/L7na vašem gostitelju LTR, bodisi v lokalnem okolju bodisi v Vismovi storitvi gostovanja aplikacij. - Licenciranje. Vsaka končna točka se licencira ločeno. Za zapis terminskega plana prek
PUT /manufphases/potrebujete licenco L7RMFPP, za posodobitve zmogljivosti pa L7RMCAP. Tudi končne točke za branje imajo svoje licence. - Ostranjevanje. Sezname ostranjujete s parametroma
pageSizeinrecAfter, filtrirate pa s parametriqueryKey1,queryKey2inqueryString.
Preverjanje pristnosti
Vsakemu klicu L7 sta priložena dva žetona:
- hash določa podatkovno zbirko in podjetje.
- token identificira uporabnika API.
Vaš skrbnik LTR v Visma LTR ustvari uporabnika API, ga poveže s podjetjem L7, mu dodeli profile in ustvari uporabniški žeton (prvi koraki). Za integracijo uporabite namenskega uporabnika, ki ima samo pravice, potrebne za integracijo.
Na strani sistema SkyPlanner avtentikacija REST API poteka z žetonom API, poslanim v glavi Authorization-Token. Ustvarite ga v meniju Settings > API. Navodila za integracijo vas vodijo skozi prve klice.
Zaznavanje sprememb: modifiedAfter
L7 REST API ne podpira obvestil webhook. Spremembe se berejo s periodičnim poizvedovanjem:
- V vzdrževanju datotek L7 (Tiedostohuolto) vklopite beleženje sprememb (DBLOG) za tabele, ki jih integracija bere, na primer delovne kartice in sestavne dele.
- Končne točke za branje kličite s parametrom
modifiedAfter, nastavljenim na čas zadnjega izvajanja. Izbrisani zapisi se vrnejo z oznako izbrisa, zato se preklicano delo odstrani iz terminskega plana. - Poizvedujte vsakih nekaj minut. SkyPlanner ob spremembi stanja ali terminskega plana pošlje obvestila webhook, zato povratni zapis temelji na dogodkih.
Preslikava podatkov
| Objekt Visma L7 (končna točka) | Objekt v SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Tuote (GET /products/) | Izdelki in materiali | L7 → SkyPlanner | Začetni prenos, nato ob spremembah |
Sestavni deli naloga (GET /manufcomponents/) | Podizdelki | L7 → SkyPlanner | Periodično poizvedovanje z modifiedAfter |
Potrebe po materialu (GET /manufmaterials/) | Potrebe po materialu za vsako operacijo | L7 → SkyPlanner | Periodično poizvedovanje z modifiedAfter |
Drevo virov (KRYH) s številom strojev (GET /manufresources/) | Delovni centri in skupine delovnih centrov | L7 → SkyPlanner | Začetni prenos, nato le redko |
Delovna kartica (TSUUNR) za vsako fazo (GET /manufphases/) | Operacije (koraki procesa) za vsak delovni center | L7 → SkyPlanner | Poizvedovanje vsakih nekaj minut |
Stanja zalog (GET /stockbalances/) | Zaloga | L7 → SkyPlanner | Periodično poizvedovanje |
Postavke nabavnih naročil (GET /purchaserows/) | Nabavna naročila z datumi dobave | L7 → SkyPlanner | Periodično poizvedovanje |
Prodajna naročila in postavke (GET /salesorders/, GET /salesrows/) | Roki dobave, prioriteta stranke | L7 → SkyPlanner | Periodično poizvedovanje |
Proizvodni dogodki (GET /manufevents/) | Napredek posamezne operacije | L7 → SkyPlanner | Periodično poizvedovanje |
Polja delovne kartice resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Načrtovani delovni center, začetek, vrstni red in ure po dnevih | SkyPlanner → L7 | Ob spremembi terminskega plana prek obvestila webhook sistema SkyPlanner |
Zmogljivosti v koledarju virov (POST /resourceupdates/) | Zmogljivosti izmen | SkyPlanner → L7 | Ob spremembah izmen |
| Pravila terminiranja, nastavljena v sistemu SkyPlanner | Dovoljeni delovni centri, matrika pripravljalnih časov, orodja, osebje | Vzdrževanje v sistemu SkyPlanner | Nastavitev med uvajanjem |
Pristopi k integraciji
1. Začetni prenos matičnih podatkov. Preberite drevo virov in vsak stroj preslikajte v lasten delovni center v sistemu SkyPlanner. Če ima en vir L7 več strojev, za vsak stroj ustvarite en delovni center, za vir pa skupino delovnih centrov. Preberite izdelke in njihove strukture z delovnimi fazami.
2. Sinhronizacija nalogov. Odprte delovne kartice preberite s klicem GET /manufphases/, nato jih sproti posodabljajte s parametrom modifiedAfter. Za vsak nalog preberite sestavne dele in potrebe po materialu ter stanja zalog in postavke nabavnih naročil, da faza počaka do datuma dobave ustrezne nabavne postavke.
3. Povratni zapis terminskega plana. Za vsako fazo, ki jo je mehanizem razporedil ali premaknil, SkyPlanner pokliče PUT /manufphases/. Telo zahteve vsebuje en vnos workSheet za vsako delovno kartico z naslednjimi podatki:
numberza delovno kartico inresourceza izbrani virstartDateinpriority, da delovne vrste L7 prikazujejo vrstni red iz sistema SkyPlannerperson, kadar je načrtovan določen operaterschedulingDaysza načrtovane ure po datumih
L7 ohrani prioriteto, ki jo nastavi zunanji sistem, nespremenjeno (vir), zato se vrstni red v delovnih vrstah ohrani.
4. Sinhronizacija zmogljivosti. Ko se v sistemu SkyPlanner spremenijo izmene, prazniki ali nadure, klic POST /resourceupdates/ zapiše nove zmogljivosti v koledar virov L7. Prikazi obremenitev v L7 se tako ujemajo s planom.
5. Napredek v proizvodnji. Operaterji še naprej beležijo delo v delovnih vrstah L7 in Visma LTR, SkyPlanner pa dogodke bere s klicem GET /manufevents/. Operaterji lahko delo potrjujejo tudi v SkyPlanner Mobile Confirmations. Autopilot na podlagi podatkov iz enega ali drugega vira na novo izdela terminski plan, naslednji povratni zapis pa prenese nove čase.
6. Pravila lastništva podatkov in reševanja navzkrižij. Zapišite jih pred prehodom v produkcijo:
| Podatki | Lastnik |
|---|---|
| Izdelki, strukture, delovne faze, količine, stanje naloga | Visma L7 |
| Vrstni red faz, datumi začetka, ure po dnevih, izbira virov | SkyPlanner |
| Dovoljeni delovni centri, matrika pripravljalnih časov, orodja, osebje | SkyPlanner |
| Izmene in odsotnosti | SkyPlanner, z zapisom v koledar virov L7 |
| Proizvodni dogodki in knjižbe zalog | Delovne vrste Visma L7 in LTR |
Glavni vir navzkrižij je lastno planiranje v L7. Izračun potreb in podrobno planiranje lahko odklenjene faze ponovno razporedita. Uporabljajte ju samo za material in rezervacije ter ne terminirajte znova faz, za katere je odgovoren SkyPlanner.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko v 30-dnevnem brezplačnem preizkusu uporabljate lastne podatke o številkah nalogov, fazah in virih, izvožene v Excel.
- Opredelitev obsega. Določite tabelo preslikav, pravila lastništva podatkov in interval poizvedovanja.
- Dostop in licence. Pridobite licence za končne točke REST, vključene v obseg projekta. Skrbnik LTR ustvari uporabnika API ter hash in token, po možnosti najprej v testnem podjetju.
- Beleženje sprememb. Za tabele, ki jih berete, vklopite DBLOG.
- Začetni prenos. Viri, izdelki, strukture in delovne faze.
- Sinhronizacija nalogov. Periodično poizvedovanje z modifiedAfter, brisanje in ostranjevanje.
- Nastavitev omejitev v sistemu SkyPlanner. Dovoljeni delovni centri, matrika pripravljalnih časov, orodja in osebje.
- Povratni zapis.
PUT /manufphases/inPOST /resourceupdates/, preizkušena v testnem podjetju. - Vzporedno delovanje in prehod v produkcijo. Primerjajte rezultate s trenutnim planom, popravite matične podatke in nato v produkcijskem okolju vklopite povratni zapis.
Kaj upoštevati pri integraciji s sistemom Visma L7
- Licence za posamezne končne točke. Že na začetku pripravite seznam vseh končnih točk in pred preizkušanjem pridobite licence zanje.
- Število strojev. Pri viru z več stroji L7 delo razdeli mednje (vir). V sistemu SkyPlanner ga razdelite na delovne centre, nazaj v L7 pa zapišite vir, ki ga L7 pričakuje.
- Ure po dnevih. L7 hrani plan kot število ur za posamezen datum. SkyPlanner pošlje podatke
schedulingDays, pri katerih je vsota ur enaka trajanju faze. - Tovarniški koledar. Poskrbite, da bo v celoti izpolnjen, saj se zaradi vrzeli faze pomaknejo v preteklost (vir).
- Nalogi za zalogo. Polja
mainNumber,subNumber,rowNumberinnewQuantityse uporabljajo samo za spreminjanje količine pri nalogu za zalogo. Pri delu za naročnika jih izpustite. - Naslednji sistem ERP. Visma je končala razvoj novih funkcij za L7, uporaba izdelka pa se konča ob koncu leta 2028 (obvestilo družbe Visma). Pravila terminiranja hranite v sistemu SkyPlanner, ne v poljih sistema L7, da jih ohranite ob zamenjavi sistema ERP.
Integracija s sistemom Visma L7: kdo jo nastavi in zagotavlja podporo
Delo zajema preslikavo na vaše vire, delovne faze in nastavitve sistema L7. Vključuje tudi pravila terminiranja, ki jih hranite v sistemu SkyPlanner: dovoljene delovne centre, matriko pripravljalnih časov, orodja in osebje.
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in zagotavlja podporo po zagonu v produkciji. Vsak obrat uporablja L7 po svoje, pri nastavitvi integracije pa se to poznavanje sistema uporabi v praksi.
- Sodeluje lahko tudi vaš partner za Visma. Partner pozna vaše nastavitve sistemov L7 in LTR ter lahko poskrbi za uporabnika API, licence in testno podjetje. SkyPlanner zagotovi REST API, dokumentacijo Swagger/OpenAPI in spletne povratne klice.
- Rešitev lahko nadgrajujejo tudi vaši razvijalci prek istega dokumentiranega REST API z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga.
Ko zamenjate L7, lahko SkyPlanner z obstoječimi nastavitvami povežete z novim sistemom ERP. Oglejte si strani za Business Central, Visma Net, Lemonsoft, Monitor ERP in Odoo.
Cena za SkyPlanner se začne pri 199 € na mesec in vključuje 5 delovnih centrov, obračun pa je mesečen. Ponudbo za integracijo pripravimo vnaprej glede na vaše procese in potrebe ter jo predložimo skupaj s ponudbo za naročniški paket, da že pred začetkom poznate celoten strošek.
Kako se obnese planiranje v samem sistemu L7, preberite v članku Ali Visma L7 omogoča terminiranje proizvodnje ob upoštevanju dejanskih zmogljivosti? Pregled najdete na strani o sistemu Visma L7, druge sisteme pa na pregledni strani integracij s sistemi ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
1.000+samodejno terminiranih delovnih nalogov
»Proizvodnjo imamo pod nadzorom na povsem drugačen način, naše razumevanje zmogljivosti pa je na povsem drugi ravni.«
Hannu Ryynänen, direktor
Mamec · Industrijski mešalniki, črpalke in visokotehnološka pogodbena proizvodnja
Na tisoče delovnih nalogov se terminira samodejno, celotna organizacija pa ima sproten vpogled v proizvodnjo.
98%zanesljivost dobav, prej približno 50%
»SkyPlanner ima odločilno vlogo pri ohranjanju naše zanesljivosti dobav.«
Hannu Lahtinen, direktor
KJH-Comp · Izdelava pločevinastih delov in pogodbena proizvodnja
Zanesljivost dobav se je povečala s približno 50% na kar 98%, za terminiranje pa zdaj namesto dveh vodij zadostuje eden.
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na sprotno optimizacijo proizvodnje.«
Kalle Kalliomäki, strokovnjak za dobavno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri delovnega časa, nov vrstni red dela pa do proizvodne linije prispe v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost proizvodnje se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
Pogosta vprašanja
Ali ima Visma L7 API za proizvodne podatke?
Da. Visma L7 REST API v sistemu Visma LTR omogoča dostop do delovnih faz, virov, sestavnih delov, materialov, proizvodnih dogodkov, izdelkov, stanja zalog ter prodajnih in nabavnih postavk. Za vsako končno točko je potrebna ločena licenca, skrbnik LTR pa ustvari uporabnika API in žetone.
Kako se terminski plan zapiše nazaj v Visma L7?
S klicem PUT /manufphases/, ki za vsak delovni karton posodobi vir, začetni datum, prioriteto, osebo in planirane ure po datumih. S klicem POST /resourceupdates/ se zapišejo zmogljivosti v koledarju virov. L7 ohrani zunanjo prioriteto, zato čakalne vrste nalogov sledijo vrstnemu redu iz sistema SkyPlanner.
Ali Visma L7 podpira spletne povratne klice?
Spletni povratni klici niso dokumentirani. Za tabele, vključene v integracijo, vklopite beleženje sprememb in jih redno preverjajte s parametrom modifiedAfter. Lastni spletni povratni klici sistema SkyPlanner pošljejo spremembe terminskega plana takoj, ko nastanejo.
Katera programska oprema za terminiranje se povezuje s sistemom Visma L7?
SkyPlanner APS se s sistemom Visma L7 povezuje dvosmerno prek L7 REST API. Visma na svoji strani integracij za L7 navaja Skycode z izdelkom SkyPlanner. Ekipa SkyPlanner integracijo nastavi med uvajanjem.
Kdo izvede integracijo s sistemom Visma L7?
Ekipa SkyPlanner med uvajanjem nastavi dvosmerno integracijo glede na vaše nastavitve sistema L7 in zagotavlja podporo po zagonu v produkciji. Vaš partner za Visma ali vaši razvijalci lahko rešitev nadgrajujejo tudi prek dokumentiranega REST API sistema SkyPlanner. Za začetek zadostuje žeton API.
Ali lahko SkyPlanner preizkusimo pred izvedbo integracije?
Da. V 30-dnevnem brezplačnem preizkusu lahko uporabljate do 20 delovnih centrov in podatke iz sistema L7 uvozite v obliki Excel ali CSV. Kreditna kartica ni potrebna. Začnite preizkus ali se pogovorite s prodajno ekipo, da opredelite obseg integracije.
