Průvodce integrací Visma L7 s APS pro plánování výroby
Tento průvodce integrací Visma L7 ukazuje partnerům a IT týmům, jak propojit Visma L7 se SkyPlanner APS. SkyPlanner si s Visma L7 vyměňuje data oběma směry prostřednictvím Visma L7 REST API:
- Do SkyPlanner se načítají čísla výrobních zakázek (työnumero), výrobní operace (työnvaihe), výrobní zdroje, struktury výrobků, díly, materiály, skladové zůstatky a řádky prodejních i nákupních objednávek.
- Do každé pracovní karty se pomocí
PUT /manufphases/zpětně zapisuje výrobní zdroj, datum zahájení, priorita, pracovník a počet hodin pro jednotlivé dny. - Kapacita v kalendáři výrobních zdrojů se synchronizuje pomocí
POST /resourceupdates/. - Výrobní události zaznamenané v pracovních frontách L7 se načítají zpět pomocí
GET /manufevents/. - Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění přizpůsobí integraci vašemu nastavení L7 a zajišťuje její podporu i po spuštění ostrého provozu. Partneři a vývojáři mohou také vytvářet vlastní řešení pomocí zdokumentovaného REST API SkyPlanner (referenční dokumentace API).
REST API Visma L7
Rozhraní se jmenuje Visma L7 – REST API a je zdokumentováno ve formátu OpenAPI 3.0.3 včetně přehledu změn (dokumentace). Běží na Visma LTR.
- Základní cesta je
/ltrws/REST/L7na vašem serveru LTR, ať už jej provozujete lokálně, nebo v rámci hostované aplikační služby Visma. - Licence. Každý endpoint se licencuje samostatně. Zápis plánu vyžaduje licenci L7RMFPP pro
PUT /manufphases/a aktualizace kapacity licenci L7RMCAP. Endpointy pro čtení mají vlastní licence. - Stránkování. Seznamy se stránkují pomocí
pageSizearecAftera filtrují pomocíqueryKey1,queryKey2aqueryString.
Ověřování
S každým voláním L7 se odesílají dva tokeny:
- hash určuje databázi a společnost.
- token identifikuje uživatele API.
Správce LTR vytvoří ve Visma LTR uživatele API, přiřadí jej ke společnosti v L7, přidělí mu profily a vytvoří uživatelský token (jak začít). Pro integraci používejte samostatný uživatelský účet pouze s oprávněními, která integrace potřebuje.
Na straně SkyPlanner se pro autentizaci v REST API používá API token odesílaný v hlavičce Authorization-Token. Vytvoříte jej v nabídce Nastavení > API. Prvními voláními vás provede návod k integraci.
Zjišťování změn: modifiedAfter
L7 REST API nepodporuje webhooky. Změny se načítají pravidelným dotazováním:
- V údržbě souborů L7 (Tiedostohuolto) zapněte protokolování změn (DBLOG) pro tabulky, ze kterých integrace čte, například pro pracovní karty a díly.
- Při volání endpointů pro čtení nastavte
modifiedAfterna čas posledního spuštění. Smazané záznamy se vracejí s označením smazání, takže se zrušené operace odstraní z plánu. - Dotazování opakujte každých několik minut. SkyPlanner při změně stavu nebo plánu odesílá webhooky, takže zpětný zápis se řídí událostmi.
Mapování dat
| Objekt Visma L7 (endpoint) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
Tuote (GET /products/) | Výrobky a materiály | L7 → SkyPlanner | Úvodní načtení, poté při změně |
Díly výrobní zakázky (GET /manufcomponents/) | Dílčí výrobky | L7 → SkyPlanner | Pravidelné dotazování s modifiedAfter |
Potřeby materiálu (GET /manufmaterials/) | Materiálové požadavky pro jednotlivé operace | L7 → SkyPlanner | Pravidelné dotazování s modifiedAfter |
Strom výrobních zdrojů (KRYH) s počtem strojů (GET /manufresources/) | Pracoviště a skupiny pracovišť | L7 → SkyPlanner | Počáteční načtení, poté jen zřídka |
Pracovní karta (TSUUNR) pro každou operaci (GET /manufphases/) | Operace (kroky postupu) na jednotlivých pracovištích | L7 → SkyPlanner | Dotazování každých několik minut |
Skladové zůstatky (GET /stockbalances/) | Zásoby | L7 → SkyPlanner | Pravidelné dotazování |
Řádky nákupních objednávek (GET /purchaserows/) | Nákupní objednávky s termíny dodání | L7 → SkyPlanner | Pravidelné dotazování |
Prodejní objednávky a jejich řádky (GET /salesorders/, GET /salesrows/) | Požadované termíny, priorita zákazníka | L7 → SkyPlanner | Pravidelné dotazování |
Výrobní události (GET /manufevents/) | Průběh jednotlivých operací | L7 → SkyPlanner | Pravidelné dotazování |
Pole pracovní karty resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Plánované pracoviště, zahájení, pořadí a hodiny pro jednotlivé dny | SkyPlanner → L7 | Při změně rozvrhu přes webhook SkyPlanner |
Kapacita v kalendáři výrobních zdrojů (POST /resourceupdates/) | Kapacita směn | SkyPlanner → L7 | Při změně směn |
| Pravidla plánování nastavená ve SkyPlanner | Povolená pracoviště, matice seřizovacích časů, nástroje, pracovníci | Spravováno ve SkyPlanner | Nastavení během zavádění |
Integrační postupy
1. Úvodní načtení kmenových dat. Načtěte strom výrobních zdrojů a každému stroji přiřaďte samostatné pracoviště ve SkyPlanner. Pokud jeden výrobní zdroj v L7 zahrnuje několik strojů, vytvořte pro každý stroj jedno pracoviště a pro celý zdroj skupinu pracovišť. Načtěte výrobky a jejich struktury včetně výrobních operací.
2. Synchronizace výrobních zakázek. Načtěte otevřené pracovní karty pomocí GET /manufphases/ a poté je průběžně aktualizujte pomocí modifiedAfter. Pro každou výrobní zakázku načtěte díly a potřeby materiálu a dále skladové zůstatky a řádky nákupních objednávek, aby operace čekala na termín dodání uvedený v příslušném řádku nákupní objednávky.
3. Zpětný zápis plánu. Pro každou operaci, kterou plánovací algoritmus zařadil nebo přesunul, volá SkyPlanner PUT /manufphases/. Tělo požadavku obsahuje pro každou pracovní kartu jednu položku workSheet s těmito údaji:
numberoznačuje pracovní kartu aresourcevybraný výrobní zdrojstartDateapriorityzajišťují, aby pracovní fronty L7 zobrazovaly pořadí ze SkyPlannerpersonse použije, pokud je naplánován konkrétní operátorschedulingDaysobsahuje plánované hodiny pro jednotlivá data
L7 ponechává prioritu nastavenou externím systémem beze změny (zdroj), takže pořadí v pracovních frontách zůstává zachováno.
4. Synchronizace kapacity. Při změně směn, dnů volna nebo přesčasů ve SkyPlanner zapíše POST /resourceupdates/ novou kapacitu do kalendáře výrobních zdrojů v L7. Přehledy vytížení v L7 pak odpovídají plánu.
5. Průběh výroby. Operátoři nadále zaznamenávají práci v pracovních frontách L7 a ve Visma LTR a SkyPlanner načítá události pomocí GET /manufevents/. Práci mohou operátoři potvrzovat také ve SkyPlanner Mobile Confirmations. Autopilot přeplánuje výrobu podle údajů z obou zdrojů a při dalším zpětném zápisu se přenesou nové časy.
6. Odpovědnost za data a pravidla řešení konfliktů. Zdokumentujte je před spuštěním ostrého provozu:
| Data | Odpovědný systém |
|---|---|
| Výrobky, struktury, výrobní operace, množství, stav výrobní zakázky | Visma L7 |
| Pořadí operací, data zahájení, hodiny pro jednotlivé dny, výběr výrobního zdroje | SkyPlanner |
| Povolená pracoviště, matice seřizovacích časů, nástroje, pracovníci | SkyPlanner |
| Směny a absence | SkyPlanner, se zápisem do kalendáře výrobních zdrojů v L7 |
| Výrobní události a skladové pohyby | Pracovní fronty Visma L7 a LTR |
Hlavním zdrojem konfliktů je vlastní plánování v L7. Výpočet potřeb a jemné plánování mohou znovu naplánovat nezamčené operace. Spouštějte je pouze pro materiál a rezervace a nepřeplánovávejte operace, za které odpovídá SkyPlanner.
Obvyklý postup projektu
Implementace je obvykle dokončena během několika týdnů od začátku zavádění. Ještě předtím probíhá 30denní bezplatné zkušební období s vašimi vlastními daty z exportu výrobních zakázek, operací a výrobních zdrojů do Excelu.
- Vymezení rozsahu. Dohodněte tabulku mapování, pravidla odpovědnosti za data a interval dotazování.
- Přístup a licence. Zajistěte licence pro REST endpointy zahrnuté do integrace. Správce LTR vytvoří uživatele API, hash a token, ideálně nejprve v testovací společnosti.
- Protokolování změn. Zapněte DBLOG pro tabulky, ze kterých čtete.
- Úvodní načtení. Výrobní zdroje, výrobky, struktury a výrobní operace.
- Synchronizace výrobních zakázek. Pravidelné dotazování s modifiedAfter, zpracování smazaných záznamů a stránkování.
- Nastavení omezení ve SkyPlanner. Povolená pracoviště, matice seřizovacích časů, nástroje a pracovníci.
- Zpětný zápis. Otestování
PUT /manufphases/aPOST /resourceupdates/v testovací společnosti. - Souběžný provoz a spuštění. Porovnejte výsledky se stávajícím plánem, opravte kmenová data a poté zapněte zpětný zápis v produkčním prostředí.
S čím počítat při integraci s Visma L7
- Licence pro jednotlivé endpointy. Včas sestavte seznam všech endpointů a před testováním pro ně zajistěte licence.
- Počet strojů. U zdroje s několika stroji L7 rozděluje práci mezi ně (zdroj). Ve SkyPlanner jej rozdělte na jednotlivá pracoviště a zpět zapisujte zdroj, který L7 očekává.
- Hodiny po dnech. L7 ukládá plán jako počet hodin pro jednotlivá data. SkyPlanner odesílá
schedulingDays, jejichž součet odpovídá délce trvání fáze. - Výrobní kalendář. Udržujte jej úplný, protože mezery posouvají fáze do minulosti (zdroj).
- Výrobní příkazy na sklad. Pole
mainNumber,subNumber,rowNumberanewQuantityslouží pouze ke změně množství u výrobního příkazu na sklad. U zákaznických zakázek je vynechte. - Přechod na jiné ERP. Visma ukončila další vývoj L7 a používání produktu končí na konci roku 2028 (oznámení společnosti Visma). Pravidla plánování uchovávejte ve SkyPlanner, nikoli v polích L7, aby zůstala zachována i při změně ERP.
Integrace s Visma L7: kdo ji nastavuje a zajišťuje podporu
Práce zahrnuje mapování podle vašich výrobních zdrojů, výrobních operací a nastavení L7. Zahrnuje také pravidla plánování, která uchováváte ve SkyPlanner: povolená pracoviště, matici seřizovacích časů, nástroje a pracovníky.
- Tým SkyPlanner integraci nastaví během zavádění a po spuštění zajišťuje její podporu. Každý závod používá L7 jinak a právě při nastavení se tyto znalosti uplatní.
- Zapojit se může i váš partner Visma. Zná vaši konfiguraci L7 a LTR a může zajistit uživatele API, licence i testovací společnost. SkyPlanner poskytuje REST API, dokumentaci Swagger/OpenAPI a webhooky.
- Na integraci mohou navázat i vaši vlastní vývojáři prostřednictvím stejného zdokumentovaného REST API s API tokenem. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže.
Až L7 nahradíte, připojíte SkyPlanner se stejným nastavením k novému ERP. Podívejte se na stránky pro Business Central, Visma Net, Lemonsoft, Monitor ERP a Odoo.
Cena SkyPlanner začíná na 199 € měsíčně za 5 pracovišť s měsíční fakturací. Cenovou nabídku integrace připravíme předem podle vašich procesů a potřeb společně s nabídkou tarifu, takže celkové náklady znáte ještě před zahájením.
Srovnání s vlastním plánováním L7 najdete v článku Nabízí Visma L7 kapacitní plánování? Přehled je na stránce Visma L7 a další systémy najdete v přehledu integrací s ERP.
Jak výrobní firmy hodnotí SkyPlanner
1 000 a víceautomaticky naplánovaných výrobních příkazů
„Výrobu máme pod kontrolou úplně jinak a náš přehled o kapacitách je na zcela jiné úrovni.“
Hannu Ryynänen, generální ředitel
Mamec · Průmyslová míchadla, čerpadla a technologicky náročná zakázková výroba
Tisíce výrobních příkazů se plánují automaticky a celá firma má přehled o výrobě v reálném čase.
98 %včasnost dodávek, nárůst z přibližně 50 %
„SkyPlanner hraje rozhodující roli v tom, že dokážeme dodávat včas.“
Hannu Lahtinen, výkonný ředitel
KJH-Comp · Výroba plechových dílů a zakázková výroba
Včasnost dodávek vzrostla z přibližně 50 % až na 98 % a plánování nyní zvládá jeden mistr místo dvou.
2 húspory každý týden
„Díky SkyPlanner jsme v plánování výroby přešli od tabulek v Excelu k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozváděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová pracovní fronta se na linku dostane během několika sekund.
+90 %efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
Časté dotazy
Má Visma L7 API pro výrobní data?
Ano. Visma L7 REST API na platformě Visma LTR zpřístupňuje pracovní fáze, výrobní zdroje, díly, materiály, výrobní události, produkty, skladové zůstatky a řádky prodejních i nákupních dokladů. Každý endpoint má samostatnou licenci a správce LTR vytváří uživatele API a tokeny.
Jak se plán zapisuje zpět do Visma L7?
Pomocí požadavku PUT /manufphases/, který u každé pracovní karty aktualizuje výrobní zdroj, datum zahájení, prioritu, pracovníka a plánované hodiny na jednotlivé dny. POST /resourceupdates/ zapisuje kapacitu do kalendáře výrobního zdroje. L7 zachovává externí prioritu, takže pracovní fronty odpovídají pořadí určenému ve SkyPlanner.
Podporuje Visma L7 webhooky?
Žádné webhooky nejsou zdokumentovány. U tabulek zahrnutých do integrace zapněte protokolování změn a pravidelně se dotazujte pomocí modifiedAfter. Vlastní webhooky SkyPlanner odesílají změny plánu ihned, jakmile nastanou.
Jaký software pro plánování výroby lze integrovat s Visma L7?
SkyPlanner APS se s Visma L7 propojuje obousměrně přes L7 REST API. Visma uvádí Skycode se SkyPlanner na své stránce integrací L7. Tým SkyPlanner integraci nastaví během zavádění.
Kdo realizuje integraci s Visma L7?
Tým SkyPlanner během zavádění nastaví obousměrnou integraci podle vaší konfigurace L7 a po spuštění zajišťuje podporu. Váš partner Visma nebo vaši vlastní vývojáři mohou také využít zdokumentované REST API SkyPlanner. Pro začátek stačí API token.
Můžeme SkyPlanner otestovat ještě před realizací integrace?
Ano. Bezplatná 30denní zkušební verze podporuje až 20 pracovišť s importem dat z L7 přes Excel nebo CSV, bez nutnosti zadávat platební kartu. Spusťte zkušební verzi nebo kontaktujte obchodní tým a vymezte rozsah integrace.
