Průvodce integrací Visma Net pro rozvrhování výroby se SkyPlanner APS

• Visma Net ERP API. Rozhraní REST se specifikací OpenAPI, která stále nese název „Visma.net ERP API v1“, obsahuje cesty v1 i v2. Základní URL je https://api.finance.visma.net. Provoz na původní doméně integration.visma.net je od 1. února 2026 omezován a doména se postupně vypíná (oznámení).
• SalesOrder service v3 na adrese https://salesorder.visma.net. Endpointy v1 a v2 pro prodejní objednávky již dosáhly konce životního cyklu.
• Webhooky přes Visma Developer Portal.
• Background API. Hlavička erp-api-background zařadí dlouho trvající volání do fronty. API vrátí stav 202 s ID úlohy a upozorní vás, až bude výsledek připraven.
• Scénáře importu a exportu ve Visma Net s datovými zdroji CSV, Excel nebo SQL slouží k jednorázovému načtení kmenových dat.

API nemá endpointy pro výrobní příkazy, technologické postupy ani pracoviště, protože Visma Net takové objekty neobsahuje. Data pro rozvrhování se získávají z položek, sad, objednávek a zásob:

• GET /v1/inventory: skladové a neskladové položky včetně příznaku sady a třídy položky
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: řádky komponent pro jednotlivé revize
• GET /v1/kitassembly: existující sestavy s možností filtrování podle typu a stavu
• SalesOrder service v3: poptávka s požadovanými termíny a řádky objednávek
• GET /v1/inventorysummary/{inventoryNumber}: fyzické a disponibilní zásoby podle skladů
• GET /v1/purchaseorder a GET /v2/PurchaseReceipt: očekávaný materiál a příjemky

Všechny endpointy pro seznamy přijímají lastModifiedDateTime s parametrem lastModifiedDateTimeCondition a také pageNumber a pageSize. Každá synchronizace tak může přenášet pouze změny.

Webhooky na Visma Developer Portal pokrývají události důležité pro rozvrhování:

• Inventory Item Created, Updated a Changed
• Purchase Order Changed a Status Changed
• Sales Order Changed a Status Changed, které přecházejí pod vydavatele SalesOrderService

Pro Kit assembly ani Kit specifications nejsou k dispozici žádné události. SkyPlanner je pravidelně načítá pomocí filtrů lastModifiedDateTime. Stavy zásob se načítají při každém spuštění rozvrhování. V opačném směru SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu.

1. Úvodní načtení kmenových dat. Načtěte skladové položky, třídy položek a nejnovější revizi Kit specification pro každou sadu. Každý řádek komponenty namapujte na materiál ve SkyPlanner. Poté vytvořte to, co Visma Net neobsahuje: pracoviště, směny, kroky postupu s časy přípravy a zpracování, matici časů přestavení a požadavky na nástroje. Importujte je ze souborů CSV nebo Excel. Jde o největší část projektu.

2. Synchronizace objednávek. Zvolte jeden model poptávky:

• Podle prodejních objednávek. Z otevřených řádků prodejních objednávek na položky sad vznikají objednávky ve SkyPlanner. Požadovaný termín se použije jako termín dokončení.
• Podle sestav. Z Kit assemblies vytvořených ve Visma Net ve stavu On hold vznikají operace ve SkyPlanner.

Otevřené nákupní objednávky se přenášejí včetně termínů. SkyPlanner považuje objednaný materiál za dostupný k datu dodání nákupní objednávky a aktualizuje zásoby, jakmile je objednávka označena stavem Delivered. Při rozvrhování tak na základě těchto dat a přehledu zásob kontroluje jak skladové zásoby, tak očekávané nákupy.

3. Zpětný zápis rozvrhu. Při řízení podle prodejních objednávek SkyPlanner vytvoří pro každou rozvrženou operaci Kit assembly typu Production. Nastaví položku sady, revizi, sklad, množství a komponenty a propojí sestavu s řádkem prodejní objednávky. Datum sestavy odpovídá plánovanému dokončení. Když Autopilot operaci přesune, volání PUT aktualizuje datum před uvolněním.

Kit assembly má jediné pole Date. Časy jednotlivých operací proto zůstávají ve SkyPlanner a do Visma Net se přenáší datum důležité pro prodej a zásoby.

4. Odvádění výroby. Obsluha zaznamenává práci pomocí Mobile Confirmations nebo Production Timer a záznamy času udržují rozvrh aktuální. Po dokončení posledního kroku SkyPlanner vyvolá akci uvolnění Kit assembly. Uvolněním se zaúčtuje vyrobené množství a spotřeba komponent a následně vznikne dávka v hlavní knize. Hodiny se souhrnně přenášejí do týdenních Employee time cards, u projektově řízené práce do projektových transakcí.

5. Pravidla vlastnictví dat a řešení konfliktů. Sepište je před spuštěním ostrého provozu:

Změnou Kit specification vzniká nová revize. Načtěte nejnovější revizi a znovu ji namapujte, protože k výrobě lze použít pouze poslední revizi. Ruční změny komponent v montážním dokladu zůstávají ve Visma Net platné, proto SkyPlanner před uvolněním doklad znovu načte.

• Technologické postupy není odkud importovat. Všechny výrobní operace i časy seřízení a výroby se zakládají ve SkyPlanner. Vyhraďte na to čas a určete odpovědnou osobu.
• Advanced logistics. Kit assembly vyžaduje skupinu Advanced logistics. Se Standard logistics zaúčtujte hotovou výrobu pomocí Inventory receipt a Inventory issue.
• Uzamčené revize. Použitou revizi Kit specification nelze upravit a vyrábět lze pouze podle nejnovější revize.
• Měrné jednotky. Kit assembly má vlastní měrnou jednotku. Při importu ji slaďte s množstvími ve SkyPlanner.
• Pravidelné dotazování bez událostí. Sady nemají webhooky. Načítejte pouze změny podle lastModifiedDateTime, nikoli všechna data znovu, abyste nepřekročili hodinový limit požadavků.
• Aktuální endpointy. Integraci stavte pouze na api.finance.visma.net a SalesOrder service v3.
• Schválení v tenantu. Ověřování pomocí client credentials nebude fungovat, dokud správce tenantu aplikaci neschválí. Domluvte tento krok včas.
• Týdenní pracovní výkazy. Pracovní výkazy vyžadují Advanced financials a vedou se po týdnech. Sčítejte hodiny obsluhy za jednotlivé týdny, nebo je zapisujte do projektových transakcí.