Integrácie / ERP / Visma L7
Sprievodca integráciou Visma L7 s APS na rozvrhovanie výroby
Tento sprievodca integráciou Visma L7 ukazuje partnerom a IT tímom, ako prepojiť Visma L7 so SkyPlanner APS. SkyPlanner sa s Visma L7 integruje obojsmerne cez Visma L7 REST API:
- Do SkyPlanner sa načítavajú čísla výrobných zákaziek (työnumero), výrobné fázy (työnvaihe), zdroje, štruktúry výrobkov, diely, materiály, skladové zostatky a riadky predajných aj nákupných objednávok.
- Do každej pracovnej karty sa cez
PUT /manufphases/spätne zapisuje zdroj, dátum začiatku, priorita, pracovník a počet hodín na jednotlivé dni. - Kapacita v kalendári zdrojov sa synchronizuje cez
POST /resourceupdates/. - Výrobné udalosti zaznamenané v pracovných frontoch L7 sa spätne načítavajú cez
GET /manufevents/. - Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas zavádzania nakonfiguruje integráciu podľa vášho nastavenia L7 a po spustení ostrej prevádzky poskytuje podporu. Partneri a vývojári môžu vytvárať aj vlastné riešenia pomocou zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
REST API systému Visma L7
Rozhranie sa nazýva Visma L7 – REST API a je zdokumentované vo formáte OpenAPI 3.0.3 vrátane zoznamu zmien (dokumentácia). Beží na Visma LTR.
- Základná cesta je
/ltrws/REST/L7na vašom serveri LTR, či už vo vlastnej infraštruktúre, alebo v hostovanej aplikačnej službe Visma. - Licencovanie. Každý koncový bod sa licencuje samostatne. Na zápis rozvrhu cez
PUT /manufphases/potrebujete licenciu L7RMFPP a na aktualizácie kapacity licenciu L7RMCAP. Koncové body na čítanie majú vlastné licencie. - Stránkovanie. Zoznamy sa stránkujú pomocou
pageSizearecAftera filtrujú pomocouqueryKey1,queryKey2aqueryString.
Autentifikácia
S každým volaním L7 sa odosielajú dva tokeny:
- hash určuje databázu a spoločnosť.
- token identifikuje používateľa API.
Správca LTR vytvorí vo Visma LTR používateľa API, prepojí ho so spoločnosťou v L7, priradí mu profily a vytvorí používateľský token (úvodné kroky). Na integráciu používajte samostatného používateľa len s oprávneniami, ktoré integrácia potrebuje.
Na strane SkyPlanner sa na autentifikáciu v REST API používa API token odosielaný v hlavičke Authorization-Token. Vytvoríte ho v časti Settings > API. Prvými volaniami vás prevedie návod na integráciu.
Zisťovanie zmien: modifiedAfter
L7 REST API nemá webhooky. Zmeny sa načítavajú pravidelným dopytovaním:
- V správe súborov L7 (Tiedostohuolto) zapnite zaznamenávanie zmien (DBLOG) pre tabuľky, ktoré integrácia číta, napríklad pracovné karty a diely.
- Volajte koncové body na čítanie s parametrom
modifiedAfternastaveným na čas posledného spustenia. Vymazané záznamy sa vracajú s označením vymazania, takže zrušené operácie sa odstránia z rozvrhu. - Dopytovanie spúšťajte každých niekoľko minút. SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis sa riadi udalosťami.
Mapovanie dát
| Objekt Visma L7 (koncový bod) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Tuote (GET /products/) | Produkty a materiály | L7 → SkyPlanner | Úvodné načítanie, potom pri zmene |
Diely výrobnej zákazky (GET /manufcomponents/) | Podvýrobky | L7 → SkyPlanner | Pravidelné dopytovanie s modifiedAfter |
Materiálové potreby (GET /manufmaterials/) | Materiálové požiadavky na jednotlivé operácie | L7 → SkyPlanner | Pravidelné dopytovanie s modifiedAfter |
Strom zdrojov (KRYH) s počtom strojov (GET /manufresources/) | Pracoviská a skupiny pracovísk | L7 → SkyPlanner | Úvodné načítanie, potom len zriedka |
Pracovná karta (TSUUNR) pre každú fázu (GET /manufphases/) | Operácie (kroky procesu) na jednotlivých pracoviskách | L7 → SkyPlanner | Dopytovanie každých niekoľko minút |
Skladové zostatky (GET /stockbalances/) | Zásoby | L7 → SkyPlanner | Pravidelné dopytovanie |
Riadky nákupných objednávok (GET /purchaserows/) | Nákupné objednávky s termínmi dodania | L7 → SkyPlanner | Pravidelné dopytovanie |
Predajné objednávky a ich riadky (GET /salesorders/, GET /salesrows/) | Požadované termíny, priorita zákazníka | L7 → SkyPlanner | Pravidelné dopytovanie |
Výrobné udalosti (GET /manufevents/) | Priebeh jednotlivých operácií | L7 → SkyPlanner | Pravidelné dopytovanie |
Polia pracovnej karty resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Naplánované pracovisko, začiatok, poradie a hodiny na jednotlivé dni | SkyPlanner → L7 | Pri zmene rozvrhu cez webhook SkyPlanner |
Kapacita v kalendári zdrojov (POST /resourceupdates/) | Kapacita zmien | SkyPlanner → L7 | Pri úprave pracovných zmien |
| Pravidlá rozvrhovania nastavené v SkyPlanner | Povolené pracoviská, matica prípravných časov, nástroje, pracovníci | Spravované v SkyPlanner | Nastavenie počas zavádzania |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Načítajte strom zdrojov a každý stroj priraďte k samostatnému pracovisku v SkyPlanner. Ak má jeden zdroj v L7 viacero strojov, vytvorte pre každý stroj samostatné pracovisko a pre daný zdroj skupinu pracovísk. Načítajte výrobky a ich štruktúry vrátane výrobných fáz.
2. Synchronizácia výrobných zákaziek. Načítajte otvorené pracovné karty cez GET /manufphases/ a potom ich priebežne aktualizujte pomocou modifiedAfter. Pre každú výrobnú zákazku načítajte diely a materiálové potreby, ako aj skladové zostatky a riadky nákupných objednávok, aby fáza čakala na termín dodania z príslušného riadka nákupnej objednávky.
3. Spätný zápis rozvrhu. Pre každú fázu, ktorú plánovací mechanizmus zaradil alebo presunul, SkyPlanner volá PUT /manufphases/. Telo požiadavky obsahuje pre každú pracovnú kartu jednu položku workSheet s týmito údajmi:
numberoznačuje pracovnú kartu aresourcevybraný zdrojstartDateapriorityzabezpečujú, aby pracovné fronty L7 zobrazovali poradie zo SkyPlannerpersonsa uvádza, keď je naplánovaný konkrétny operátorschedulingDaysobsahuje naplánované hodiny na jednotlivé dátumy
L7 ponecháva prioritu nastavenú externým systémom bez zmeny (zdroj), takže poradie sa v pracovných frontoch zachová.
4. Synchronizácia kapacity. Keď sa v SkyPlanner zmenia pracovné zmeny, sviatky alebo nadčasy, cez POST /resourceupdates/ sa zapíše nová kapacita do kalendára zdrojov L7. Prehľady vyťaženia v L7 potom zodpovedajú plánu.
5. Priebeh výroby. Operátori naďalej zaznamenávajú údaje v pracovných frontoch L7 a vo Visma LTR a SkyPlanner načítava udalosti cez GET /manufevents/. Operátori môžu prácu potvrdzovať aj v SkyPlanner Mobile Confirmations. Autopilot preplánuje rozvrh na základe údajov z ktoréhokoľvek z týchto zdrojov a pri ďalšom spätnom zápise sa prenesú nové časy.
6. Pravidlá vlastníctva dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Vlastník |
|---|---|
| Výrobky, štruktúry, výrobné fázy, množstvá, stav výrobnej zákazky | Visma L7 |
| Poradie fáz, dátumy začiatku, hodiny na jednotlivé dni, výber zdroja | SkyPlanner |
| Povolené pracoviská, matica prípravných časov, nástroje, pracovníci | SkyPlanner |
| Pracovné zmeny a neprítomnosti | SkyPlanner, so zápisom do kalendára zdrojov L7 |
| Výrobné udalosti a skladové zápisy | Pracovné fronty Visma L7 a LTR |
Hlavným zdrojom konfliktov je vlastné plánovanie v L7. Výpočet potrieb a detailné plánovanie môžu znova zaradiť nezamknuté fázy do rozvrhu. Spúšťajte ich len pre materiál a rezervácie a nepreplánovávajte fázy, ktoré spravuje SkyPlanner.
Typický postup projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Ešte predtým môžete využiť 30-dňovú bezplatnú skúšobnú verziu s vlastnými dátami z excelového exportu výrobných zákaziek, fáz a zdrojov.
- Definovanie rozsahu. Dohodnite tabuľku mapovania, pravidlá vlastníctva dát a interval dopytovania.
- Prístup a licencie. Zabezpečte licencie pre koncové body REST zahrnuté do rozsahu integrácie. Správca LTR vytvorí používateľa API, hash a token, ideálne najprv v testovacej spoločnosti.
- Zaznamenávanie zmien. Zapnite DBLOG pre tabuľky, ktoré čítate.
- Úvodné načítanie. Zdroje, výrobky, štruktúry a výrobné fázy.
- Synchronizácia výrobných zákaziek. Pravidelné dopytovanie s modifiedAfter, spracovanie vymazaných záznamov a stránkovanie.
- Nastavenie obmedzení v SkyPlanner. Povolené pracoviská, matica prípravných časov, nástroje a pracovníci.
- Spätný zápis.
PUT /manufphases/aPOST /resourceupdates/, otestované v testovacej spoločnosti. - Súbežná prevádzka a prechod do ostrej prevádzky. Porovnajte výsledky s aktuálnym plánom, opravte kmeňové dáta a potom zapnite spätný zápis v produkčnom prostredí.
Na čo myslieť pri integrácii s Visma L7
- Licencie pre jednotlivé koncové body. Včas spíšte všetky koncové body a pred testovaním pre ne zabezpečte licencie.
- Počet strojov. Zdroj s viacerými strojmi rozdeľuje prácu v L7 (zdroj). V SkyPlanner ho rozdeľte na pracoviská a späť zapisujte zdroj, ktorý L7 očakáva.
- Hodiny na jednotlivé dni. L7 ukladá plán ako počet hodín na konkrétne dátumy. SkyPlanner odosiela
schedulingDays, ktorých súčet zodpovedá trvaniu výrobnej fázy. - Výrobný kalendár. Dbajte na to, aby bol kompletný, pretože medzery v ňom posúvajú výrobné fázy do minulosti (zdroj).
- Zákazky na sklad. Polia
mainNumber,subNumber,rowNumberanewQuantityslúžia iba na zmenu množstva v zákazke na sklad. Pri zákazkách pre zákazníkov ich vynechajte. - Prechod na ďalší ERP. Visma ukončila vývoj nových funkcií L7 a používanie produktu sa končí na konci roka 2028 (oznámenie spoločnosti Visma). Pravidlá rozvrhovania uchovávajte v SkyPlanner, nie v poliach L7, aby ste ich mohli preniesť pri zmene ERP.
Integrácia s Visma L7: kto ju nastavuje a zabezpečuje podporu
Súčasťou prác je mapovanie podľa vašich zdrojov, výrobných fáz a nastavenia L7. Patria sem aj pravidlá rozvrhovania, ktoré uchovávate v SkyPlanner: povolené pracoviská, matica prípravných časov, nástroje a pracovníci.
- Tím SkyPlanner nastaví integráciu počas zavádzania a poskytuje podporu aj po spustení ostrej prevádzky. Každý závod používa L7 inak a práve tu sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner Visma. Pozná vaše nastavenie L7 a LTR a môže zabezpečiť používateľa API, licencie aj testovaciu spoločnosť. SkyPlanner poskytuje REST API, dokumentáciu Swagger/OpenAPI a webhooky.
- Na integrácii môžu ďalej pracovať aj vaši vývojári cez rovnaké zdokumentované REST API s tokenom API. Na začiatok stačí token API a tím SkyPlanner v prípade potreby pomôže.
Keď nahradíte L7, rovnaké nastavenie SkyPlanner sa pripojí k novému ERP. Pozrite si stránky pre Business Central, Visma Net, Lemonsoft, Monitor ERP a Odoo.
Cena SkyPlanner sa začína na 199 € mesačne a zahŕňa 5 pracovísk s mesačnou fakturáciou. Cenovú ponuku na integráciu pripravíme vopred podľa vašich procesov a potrieb spolu s vybraným programom, aby ste poznali celkové náklady ešte pred začiatkom.
Pozrite si porovnanie s vlastným plánovaním L7 v článku Podporuje Visma L7 plánovanie výroby so zohľadnením skutočnej kapacity strojov a pracovníkov? Prehľad nájdete na stránke Visma L7 a ďalšie systémy v prehľade integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
1 000 a viacautomaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou úplne inak a náš prehľad o kapacitách je na celkom inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky vyspelá zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
98%spoľahlivosť dodávok, nárast z približne 50%
„SkyPlanner zohráva rozhodujúcu úlohu pri udržiavaní našej spoľahlivosti dodávok.“
Hannu Lahtinen, výkonný riaditeľ
KJH-Comp · Výroba plechových dielov a zákazková výroba
Spoľahlivosť dodávok vzrástla z približne 50% až na 98% a rozvrhovanie teraz zvládne jeden vedúci namiesto dvoch.
2 hušetrené každý týždeň
„So SkyPlanner sme pri plánovaní výroby prešli od tabuliek v Exceli k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Pri plánovaní výroby sa každý týždeň ušetria 2 hodiny pracovného času a nové poradie operácií sa dostane na linku v priebehu sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90%.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90% a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
Často kladené otázky
Má Visma L7 API pre výrobné dáta?
Áno. Visma L7 REST API na platforme Visma LTR sprístupňuje výrobné fázy, zdroje, diely, materiály, výrobné udalosti, produkty, skladové zásoby, riadky predaja a riadky nákupu. Každý koncový bod sa licencuje samostatne a správca LTR vytvára používateľa API aj tokeny.
Ako sa rozvrh zapisuje späť do Visma L7?
Pomocou požiadavky PUT /manufphases/, ktorá na každej pracovnej karte aktualizuje zdroj, dátum začiatku, prioritu, pracovníka a plánovaný počet hodín na jednotlivé dni. POST /resourceupdates/ zapisuje kapacitu do kalendára zdroja. L7 zachováva externú prioritu, takže operácie sú zoradené podľa poradia zo SkyPlanner.
Podporuje Visma L7 webhooky?
Dokumentácia neuvádza žiadne webhooky. Pre tabuľky zahrnuté do integrácie zapnite zaznamenávanie zmien a pravidelne zisťujte zmeny pomocou modifiedAfter. Vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Aký softvér na rozvrhovanie výroby sa integruje s Visma L7?
SkyPlanner APS sa obojsmerne integruje s Visma L7 cez L7 REST API a Visma uvádza Skycode so SkyPlanner na svojej stránke integrácií L7. Tím SkyPlanner nastaví integráciu počas zavádzania.
Kto vytvorí integráciu s Visma L7?
Tím SkyPlanner počas zavádzania nastaví obojsmernú integráciu podľa vašej konfigurácie L7 a poskytuje podporu aj po spustení ostrej prevádzky. Váš partner Visma alebo vaši vývojári môžu tiež vyvíjať riešenia cez zdokumentované REST API SkyPlanner. Na začiatok stačí token API.
Môžeme si SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Počas 30-dňovej bezplatnej skúšobnej verzie môžete využívať až 20 pracovísk s importom dát z L7 cez Excel alebo CSV, bez platobnej karty. Začnite skúšobnú verziu alebo kontaktujte obchodný tím a dohodnite si rozsah integrácie.
