Sprievodca integráciou Visma Net na rozvrhovanie výroby so SkyPlanner APS

• Visma Net ERP API. Rozhranie REST so špecifikáciou OpenAPI, ktorá má stále názov „Visma.net ERP API v1“, a s cestami v1 aj v2. Základná URL je https://api.finance.visma.net. Na starej doméne integration.visma.net sa od 1. februára 2026 obmedzuje priepustnosť a jej prevádzka sa ukončuje (oznámenie).
• SalesOrder service v3 na adrese https://salesorder.visma.net. Koncové body v1 a v2 pre predajné objednávky dosiahli koniec životného cyklu.
• Webhooky cez Visma Developer Portal.
• Background API. Hlavička erp-api-background zaradí dlhotrvajúce volania do frontu, vráti kód 202 s ID úlohy a upozorní vás, keď bude výsledok pripravený.
• Scenáre importu a exportu vo Visma Net so zdrojmi dát CSV, Excel alebo SQL na jednorazové načítanie kmeňových dát.

API nemá koncové body pre výrobné príkazy, technologické postupy ani pracoviská, pretože Visma Net takéto objekty neobsahuje. Dáta na rozvrhovanie pochádzajú z položiek, súprav, objednávok a zásob:

• GET /v1/inventory: skladové a neskladové položky vrátane príznaku súpravy a triedy položky
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: riadky komponentov pre jednotlivé revízie
• GET /v1/kitassembly: existujúce zostavy s možnosťou filtrovania podľa typu a stavu
• SalesOrder service v3: dopyt s požadovanými dátumami a riadkami objednávok
• GET /v1/inventorysummary/{inventoryNumber}: fyzické a disponibilné zásoby podľa skladov
• GET /v1/purchaseorder a GET /v2/PurchaseReceipt: očakávaný materiál a príjemky

Všetky koncové body na získanie zoznamov prijímajú parametre lastModifiedDateTime s lastModifiedDateTimeCondition a tiež pageNumber a pageSize, takže pri každej synchronizácii možno prenášať iba zmeny.

Webhooky vo Visma Developer Portal pokrývajú udalosti dôležité pre rozvrhovanie:

• Vytvorenie, aktualizácia a zmena skladovej položky (Inventory Item Created, Updated a Changed)
• Zmena nákupnej objednávky a jej stavu (Purchase Order Changed a Status Changed)
• Udalosti zmeny predajnej objednávky a jej stavu (Sales Order Changed a Status Changed) prechádzajú pod vydavateľa SalesOrderService.

Pre Kit assembly ani Kit specifications neexistujú udalosti. SkyPlanner ich pravidelne načítava pomocou filtrov lastModifiedDateTime. Stavy zásob sa načítavajú pri spustení rozvrhovania. V opačnom smere SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu.

1. Úvodné načítanie kmeňových dát. Načítajte skladové položky, triedy položiek a najnovšiu revíziu Kit specification každej súpravy. Každý riadok komponentu namapujte na materiál v SkyPlanner. Potom vytvorte údaje, ktoré Visma Net neobsahuje: pracoviská, zmeny, výrobné kroky s časmi prípravy a spracovania, maticu časov prestavenia a požiadavky na nástroje. Importujte ich vo formáte CSV alebo Excel. Toto je najväčšia časť projektu.

2. Synchronizácia objednávok. Vyberte si jeden model dopytu:

• Podľa predajných objednávok. Z otvorených riadkov predajných objednávok na súpravy vznikajú objednávky v SkyPlanner, pričom požadovaný dátum sa použije ako termín dodania.
• Podľa zostáv. Z Kit assemblies vytvorených vo Visma Net v stave On hold vznikajú operácie v SkyPlanner.

Otvorené nákupné objednávky sa prenášajú spolu s dátumami. SkyPlanner považuje objednaný materiál za dostupný v deň dodania nákupnej objednávky a aktualizuje zásoby, keď sa objednávka označí ako Delivered. Pri rozvrhovaní sa tak spolu s prehľadom zásob kontrolujú aktuálne zásoby aj očakávané nákupy.

3. Spätný zápis rozvrhu. Pri nastavení podľa predajných objednávok vytvorí SkyPlanner pre každú rozvrhnutú operáciu Kit assembly typu Production. Nastaví položku súpravy, revíziu, sklad, množstvo a komponenty a prepojí zostavu s riadkom predajnej objednávky. Dátum zostavy zodpovedá plánovanému dokončeniu. Keď Autopilot presunie operáciu, volanie PUT aktualizuje dátum pred uvoľnením.

Kit assembly má jedno pole Date, takže časy jednotlivých operácií zostávajú v SkyPlanner a do Visma Net sa prenáša dátum dôležitý pre predaj a zásoby.

4. Potvrdzovanie práce vo výrobe. Operátori zaznamenávajú prácu pomocou Mobile Confirmations alebo Production Timer a časové záznamy udržiavajú rozvrh aktuálny. Po dokončení posledného kroku SkyPlanner zavolá akciu uvoľnenia na Kit assembly. Uvoľnením sa zaúčtuje vyrobené množstvo a spotreba komponentov a následne vznikne dávka hlavnej knihy. Hodiny sa súhrnne prenášajú do týždenných Employee time cards alebo pri projektovej práci do projektových transakcií.

5. Pravidlá zodpovednosti za dáta a riešenia konfliktov. Spíšte ich pred spustením do ostrej prevádzky:

Zmenou Kit specification vznikne nová revízia. Znova načítajte najnovšiu revíziu a aktualizujte jej mapovanie, pretože na výrobu možno použiť iba poslednú revíziu. Ručné zmeny komponentov v doklade Kit assembly zostávajú vo Visma Net platné, preto SkyPlanner pred uvoľnením doklad znova načíta.

• Technologické postupy nie je odkiaľ importovať. Všetky výrobné kroky, prípravné a výrobné časy sa vytvárajú v systéme SkyPlanner. Naplánujte potrebnú prácu a určte, kto za ňu zodpovedá.
• Advanced logistics. Kit assembly vyžaduje skupinu Advanced logistics. Pri Standard logistics zaúčtujte vyrobené množstvo pomocou Inventory receipt a Inventory issue.
• Uzamknuté revízie. Použitú revíziu Kit specification nemožno upravovať a na výrobu možno použiť iba najnovšiu revíziu.
• Merné jednotky. Kit assembly má vlastnú mernú jednotku. Pri importe ju zosúlaďte s množstvami v systéme SkyPlanner.
• Dopytovanie bez udalostí. Súpravy nemajú webhooky. Aby ste neprekročili hodinový limit požiadaviek, načítavajte iba zmeny podľa lastModifiedDateTime, nie všetky dáta odznova.
• Aktuálne koncové body. Integráciu stavajte iba na api.finance.visma.net a SalesOrder service v3.
• Schválenie správcom tenanta. Overenie pomocou klientskych prihlasovacích údajov nebude fungovať, kým správca tenanta aplikáciu neschváli. Tento krok si dohodnite včas.
• Týždenné výkazy pracovného času. Výkazy pracovného času vyžadujú Advanced financials a vedú sa po týždňoch. Hodiny operátorov sčítavajte za každý týždeň alebo ich zapisujte do projektových transakcií.