Visma Net-integratiegids voor productieschema’s met SkyPlanner APS

• Visma Net ERP API. REST met een OpenAPI-specificatie die nog steeds de titel “Visma.net ERP API v1” heeft, met v1- en v2-paden. De basis-URL is https://api.finance.visma.net. Vanaf 1 februari 2026 wordt de aanroepsnelheid voor het oude domein integration.visma.net beperkt en wordt het domein uitgefaseerd (aankondiging).
• SalesOrder service v3 op https://salesorder.visma.net. De v1- en v2-endpoints voor verkooporders hebben het einde van hun levensduur bereikt.
• Webhooks via de Visma Developer Portal.
• Background API. Met de header erp-api-background worden langdurige aanroepen in een wachtrij geplaatst. U ontvangt statuscode 202 met een taak-ID en krijgt een melding zodra het resultaat klaarstaat.
• Import- en exportscenario’s in Visma Net, met CSV-, Excel- of SQL-gegevensproviders, om eenmalig stamgegevens te laden.

De API heeft geen endpoints voor productieorders, bewerkingsvolgordes of werkcentra, omdat Visma Net deze objecten niet kent. De gegevens voor het productieschema komen uit artikelen, kits, orders en voorraad:

• GET /v1/inventory: voorraad- en niet-voorraadartikelen, inclusief de kitaanduiding en artikelklasse
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: componentregels per revisie
• GET /v1/kitassembly: bestaande assemblages, te filteren op type en status
• SalesOrder service v3: vraag met gewenste datums en orderregels
• GET /v1/inventorysummary/{inventoryNumber}: aanwezige en beschikbare voorraad per magazijn
• GET /v1/purchaseorder en GET /v2/PurchaseReceipt: inkomend materiaal en ontvangsten

Alle lijstendpoints accepteren lastModifiedDateTime met lastModifiedDateTimeCondition, plus pageNumber en pageSize. Daardoor kan elke synchronisatie incrementeel worden uitgevoerd.

De webhooks van de Visma Developer Portal ondersteunen de events die relevant zijn voor het productieschema:

• Inventory Item Created, Updated en Changed
• Purchase Order Changed en Status Changed
• Sales Order Changed en Status Changed, die worden overgezet naar de SalesOrderService-publisher

Er zijn geen events voor Kit assembly of Kit specifications. SkyPlanner haalt deze via polling op met lastModifiedDateTime-filters. Bij het berekenen van een productieschema worden de voorraadstanden opgehaald. In de andere richting verstuurt SkyPlanner webhooks wanneer de status of het productieschema verandert.

1. Eerste import van stamgegevens. Haal voorraadartikelen, artikelklassen en de nieuwste Kit specification-revisie van elke kit op. Koppel elke componentregel aan een materiaal in SkyPlanner. Richt vervolgens in wat Visma Net niet bevat: werkcentra, diensten, processtappen met instel- en bewerkingstijden, de omsteltijdenmatrix en gereedschapsvereisten. Importeer deze gegevens via CSV of Excel. Dit is het grootste onderdeel van het project.

2. Ordersynchronisatie. Kies één model voor de vraag:

• Op basis van verkooporders. Openstaande verkooporderregels voor kitartikelen worden orders in SkyPlanner, met de gewenste datum als leverdatum.
• Op basis van assemblageorders. Kit assemblies die in Visma Net worden aangemaakt met de status On hold, worden taken in SkyPlanner.

Openstaande inkooporders worden met hun datums ingelezen. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de order de status Delivered krijgt. Aan de hand van deze gegevens en het voorraadoverzicht houdt het productieschema rekening met zowel de voorraad als de verwachte inkopen.

3. Het productieschema terugschrijven. Bij een inrichting op basis van verkooporders maakt SkyPlanner voor elke ingeplande taak een Kit assembly van het type Production aan. SkyPlanner vult het kitartikel, de revisie, het magazijn, het aantal en de componenten in en koppelt de assemblageorder aan de verkooporderregel. De assemblagedatum is de geplande einddatum. Als Autopilot de taak verschuift, wordt de datum vóór vrijgave bijgewerkt met een PUT.

De Kit assembly heeft één Date-veld. Daarom blijven de tijden per bewerking in SkyPlanner en ontvangt Visma Net de datum die van belang is voor verkoop en voorraad.

4. Terugmeldingen van de werkvloer. Operators registreren hun werk met Mobile Confirmations of de Production Timer. Die tijdregistraties houden het productieschema actueel. Zodra de laatste stap is afgerond, roept SkyPlanner de vrijgaveactie voor de Kit assembly aan. Bij vrijgave worden de geproduceerde aantallen en het componentverbruik geboekt, waarna de grootboekbatch volgt. De uren worden per week samengevoegd in Employee time cards, of als projecttransacties verwerkt bij projectgestuurd werk.

5. Gegevenseigenaarschap en conflictregels. Leg deze vast vóór ingebruikname:

Een wijziging in een Kit specification maakt een nieuwe revisie aan. Lees de nieuwste revisie opnieuw in en werk de mapping bij: alleen de laatste revisie kan voor assemblage worden gebruikt. Handmatige componentwijzigingen in een assemblage blijven geldig in Visma Net. Daarom leest SkyPlanner de assemblage vóór vrijgave opnieuw uit.

• Geen bewerkingsvolgordes om te importeren. Alle processtappen, omstel- en bewerkingstijden worden in SkyPlanner vastgelegd. Plan het werk hiervoor in en bepaal wie verantwoordelijk is.
• Advanced logistics. Kit assembly vereist de groep Advanced logistics. Bij Standard logistics boekt u de productieopbrengst met Inventory receipt en Inventory issue.
• Vergrendelde revisies. Een gebruikte revisie van een Kit specification kan niet meer worden gewijzigd. Alleen de nieuwste revisie kan voor assemblage worden gebruikt.
• Maateenheden. De Kit assembly heeft een eigen maateenheid. Stem die bij het importeren af op de hoeveelheden in SkyPlanner.
• Polling zonder events. Kits hebben geen webhooks. Haal alleen wijzigingen op via lastModifiedDateTime, in plaats van alles opnieuw te laden. Zo blijft u binnen de limiet voor API-aanvragen per uur.
• Actuele endpoints. Gebruik voor de integratie uitsluitend api.finance.visma.net en SalesOrder service v3.
• Goedkeuring door de tenantbeheerder. Client credentials werken pas nadat de tenantbeheerder de app heeft goedgekeurd. Plan die stap tijdig in.
• Wekelijkse urenstaten. Urenstaten vereisen Advanced financials en worden per week bijgehouden. Tel de operatoruren per week op of boek ze als projecttransacties.