Visma Net Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS

• Visma Net ERP API. REST mit einer OpenAPI-Spezifikation, die weiterhin den Titel „Visma.net ERP API v1“ trägt und v1- und v2-Pfade enthält. Die Basis-URL lautet https://api.finance.visma.net. Die alte Domain integration.visma.net wird ab dem 1. Februar 2026 gedrosselt und abgeschaltet (Hinweis).
• SalesOrder service v3 unter https://salesorder.visma.net. Die v1- und v2-Endpunkte für Kundenaufträge haben ihr Supportende erreicht.
• Webhooks über das Visma Developer Portal.
• Background API. Mit dem Header erp-api-background werden lang laufende Aufrufe in eine Warteschlange gestellt. Die API gibt 202 mit einer Job-ID zurück und benachrichtigt Sie, sobald das Ergebnis vorliegt.
• Import- und Exportszenarien in Visma Net mit CSV-, Excel- oder SQL-Datenanbietern für den einmaligen Import von Stammdaten.

Die API bietet keine Endpunkte für Fertigungsaufträge, Arbeitspläne oder Arbeitsstationen, da es diese Objekte in Visma Net nicht gibt. Die Daten für die Feinplanung stammen aus Artikeln, Kits, Aufträgen und Beständen:

• GET /v1/inventory: Lager- und Nichtlagerartikel einschließlich Kit-Kennzeichen und Artikelklasse
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: Komponentenpositionen je Revision
• GET /v1/kitassembly: vorhandene Kit assemblies, nach Typ und Status filterbar
• SalesOrder service v3: Bedarfe mit Wunschterminen und Positionen
• GET /v1/inventorysummary/{inventoryNumber}: vorhandene und verfügbare Bestände je Lager
• GET /v1/purchaseorder und GET /v2/PurchaseReceipt: erwartete Materialzugänge und Wareneingänge

Alle Listenendpunkte akzeptieren lastModifiedDateTime mit lastModifiedDateTimeCondition sowie pageNumber und pageSize. So lässt sich jede Synchronisierung inkrementell ausführen.

Die Webhooks im Visma Developer Portal decken die für die Feinplanung relevanten Ereignisse ab:

• Inventory Item Created, Updated und Changed
• Purchase Order Changed und Status Changed
• Sales Order Changed und Status Changed, die zum Publisher SalesOrderService wechseln

Für Kit assembly und Kit specifications gibt es keine Ereignisse. SkyPlanner fragt diese per Polling mit lastModifiedDateTime-Filtern ab. Lagerbestände werden bei Planungsläufen abgefragt. In der Gegenrichtung sendet SkyPlanner Webhooks, wenn sich der Status oder der Zeitplan ändert.

1. Stammdaten erstmals laden. Lesen Sie Lagerartikel, Artikelklassen und für jedes Kit die neueste Revision der Kit specification ein. Ordnen Sie jede Komponentenposition einem Material in SkyPlanner zu. Legen Sie anschließend die Daten an, die Visma Net nicht vorhält: Arbeitsstationen, Schichten, Prozessschritte mit Rüst- und Bearbeitungszeiten, die Rüstzeitmatrix und Werkzeuganforderungen. Importieren Sie diese per CSV oder Excel. Das ist der größte Teil des Projekts.

2. Aufträge synchronisieren. Wählen Sie ein Modell für die Bedarfsermittlung:

• Auf Basis von Kundenaufträgen. Offene Kundenauftragspositionen für Kit-Artikel werden zu SkyPlanner-Aufträgen. Der Wunschtermin wird als Fälligkeitstermin übernommen.
• Auf Basis von Kit assemblies. Kit assemblies, die in Visma Net mit dem Status On hold angelegt wurden, werden zu Arbeitsgängen in SkyPlanner.

Offene Bestellungen werden mit ihren Terminen eingelesen. SkyPlanner betrachtet bestelltes Material ab dem Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert ist. Zusammen mit der Bestandsübersicht prüft die Planung damit sowohl vorhandene Bestände als auch erwartete Zugänge aus Bestellungen.

3. Planung zurückschreiben. Bei einer Planung auf Basis von Kundenaufträgen legt SkyPlanner für jeden eingeplanten Arbeitsgang eine Kit assembly vom Typ Production an. Dabei setzt SkyPlanner Kit-Artikel, Revision, Lager, Menge und Komponenten und verknüpft die Kit assembly mit der Kundenauftragsposition. Als Datum wird der geplante Fertigstellungstermin eingetragen. Verschiebt Autopilot den Arbeitsgang, aktualisiert ein PUT das Datum vor der Freigabe.

Die Kit assembly hat nur ein Date-Feld. Deshalb bleiben die Zeiten der einzelnen Arbeitsgänge in SkyPlanner, während Visma Net den für Vertrieb und Lager relevanten Termin erhält.

4. Rückmeldungen aus der Fertigung. Die Mitarbeiter erfassen ihre Arbeit mit Mobile Confirmations oder dem Production Timer. Die Zeitbuchungen halten den Plan aktuell. Sobald der letzte Schritt abgeschlossen ist, ruft SkyPlanner die Aktion release für die Kit assembly auf. Release bucht die gefertigte Menge und den Komponentenverbrauch; anschließend folgt der Buchungsstapel für das Hauptbuch. Die Stunden werden in wöchentlichen Employee time cards zusammengefasst oder bei projektbezogener Arbeit als Projekttransaktionen gebucht.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:

Jede Änderung an einer Kit specification erzeugt eine neue Revision. Lesen Sie die neueste Revision erneut ein und aktualisieren Sie die Zuordnung, da nur die letzte Revision für die Fertigung verwendet werden kann. Manuelle Änderungen an den Komponenten einer Kit assembly bleiben in Visma Net gültig. Deshalb liest SkyPlanner die Kit assembly vor der Freigabe erneut ein.

• Keine Arbeitspläne zum Importieren. Alle Prozessschritte sowie Rüst- und Bearbeitungszeiten werden zunächst in SkyPlanner angelegt. Planen Sie den Aufwand ein und legen Sie fest, wer dafür zuständig ist.
• Advanced logistics. Kit assembly setzt die Gruppe Advanced logistics voraus. Mit Standard logistics buchen Sie die gefertigte Menge über Inventory receipt und Inventory issue.
• Gesperrte Revisionen. Eine bereits verwendete Revision einer Kit specification lässt sich nicht mehr bearbeiten. Für die Fertigung kann nur die neueste Revision verwendet werden.
• Maßeinheiten. Die Kit assembly hat eine eigene Maßeinheit. Stimmen Sie diese beim Import mit den Mengen in SkyPlanner ab.
• Polling ohne Ereignisse. Für Kits gibt es keine Webhooks. Rufen Sie Änderungen anhand von lastModifiedDateTime ab, statt alle Daten erneut zu laden. So bleiben Sie innerhalb des stündlichen Anfragelimits.
• Aktuelle Endpunkte. Verwenden Sie ausschließlich api.finance.visma.net und SalesOrder service v3.
• Mandantenfreigabe. Die Authentifizierung mit Client-Zugangsdaten schlägt fehl, solange der Mandantenadministrator die App nicht freigegeben hat. Planen Sie diesen Schritt frühzeitig ein.
• Wöchentliche Stundennachweise. Stundennachweise setzen Advanced financials voraus und werden wochenweise geführt. Fassen Sie die Arbeitsstunden der Mitarbeiter pro Woche zusammen oder buchen Sie sie als Projekttransaktionen.