Guide till Visma Net integration för produktionsplanering med SkyPlanner APS

• Visma Net ERP API. REST med en OpenAPI-specifikation som fortfarande heter ”Visma.net ERP API v1”, med sökvägar för v1 och v2. Bas-URL:en är https://api.finance.visma.net. Trafiken till den gamla domänen integration.visma.net begränsas från den 1 februari 2026 och domänen håller på att stängas ned (meddelande).
• SalesOrder service v3 finns på https://salesorder.visma.net. Kundorder-endpointerna i v1 och v2 har nått slutet av sin livscykel.
• Webhooks via Visma Developer Portal.
• Background API. Med headern erp-api-background köas långvariga anrop. Svaret blir 202 med ett jobb-ID, och du får ett meddelande när resultatet är klart.
• Import- och exportscenarier i Visma Net, med dataleverantörer för CSV, Excel eller SQL, för engångsinläsning av grunddata.

API:et saknar endpoints för tillverkningsorder, operationsföljder och produktionsgrupper, eftersom dessa objekt inte finns i Visma Net. Underlaget för produktionsplaneringen hämtas från artiklar, kit, order och lager:

• GET /v1/inventory: lagerförda och ej lagerförda artiklar, inklusive kitflagga och artikelklass
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: komponentrader per revision
• GET /v1/kitassembly: befintliga monteringar, som kan filtreras efter typ och status
• SalesOrder service v3: efterfrågan med önskade datum och orderrader
• GET /v1/inventorysummary/{inventoryNumber}: lagersaldo och tillgängligt antal per lager
• GET /v1/purchaseorder och GET /v2/PurchaseReceipt: inkommande material och inleveranser

Alla listendpoints accepterar lastModifiedDateTime med lastModifiedDateTimeCondition samt pageNumber och pageSize. Varje synkronisering kan därför göras inkrementellt.

Webhooks i Visma Developer Portal täcker de händelser som är viktiga för produktionsplaneringen:

• Inventory Item Created, Updated och Changed
• Purchase Order Changed och Status Changed
• Sales Order Changed och Status Changed, som flyttas till utgivaren SalesOrderService

Det finns inga händelser för Kit assembly eller Kit specifications. SkyPlanner hämtar dem genom pollning med lastModifiedDateTime-filter. Lagersaldon hämtas vid planeringskörningar. I motsatt riktning skickar SkyPlanner webhooks när status eller produktionsplanen ändras.

1. Första inläsningen av grunddata. Läs in lagerförda artiklar, artikelklasser och den senaste revisionen av Kit specification för varje kit. Mappa varje komponentrad till ett material i SkyPlanner. Skapa sedan det som saknas i Visma Net: produktionsgrupper, skift, processteg med ställ- och körtider, ställtidsmatris och verktygskrav. Importera uppgifterna som CSV eller Excel. Det här är projektets största del.

2. Ordersynkronisering. Välj en modell för efterfrågeunderlaget:

• Kundorderstyrt. Öppna kundorderrader för kitartiklar blir order i SkyPlanner, med önskat datum som leveransdatum.
• Monteringsstyrt. Kit assemblies som skapas i Visma Net med status On hold blir operationer i SkyPlanner.

Öppna inköpsorder läses in med sina datum. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagret när ordern får status Delivered. Med hjälp av dessa uppgifter och lagersammanställningen kontrollerar planeringen både befintligt lager och inkommande inköp.

3. Återföring av produktionsplanen. I ett kundorderstyrt upplägg skapar SkyPlanner en Kit assembly av typen Production för varje planerad operation. SkyPlanner anger kitartikel, revision, lager, antal och komponenter och kopplar monteringen till kundorderraden. Monteringsdatumet är det planerade slutdatumet. När Autopilot flyttar operationen uppdateras datumet med ett PUT-anrop före frisläppning.

Kit assembly har ett enda Date-fält. Tiderna för enskilda operationer stannar därför i SkyPlanner, medan Visma Net får det datum som är relevant för försäljning och lager.

4. Återrapportering från produktionen. Operatörerna registrerar arbetet med Mobile Confirmations eller Production Timer, och tidsregistreringarna håller planen aktuell. När det sista steget är klart anropar SkyPlanner åtgärden release för Kit assembly. Release bokför producerad kvantitet och komponentförbrukning, följt av verifikationsbunten i huvudboken. Timmarna summeras till veckovisa Employee time cards, eller till projekttransaktioner vid projektstyrt arbete.

5. Regler för dataägarskap och konflikter. Dokumentera dem före driftsättning:

En ändring i en Kit specification skapar en ny revision. Läs in den senaste revisionen igen och mappa om den, eftersom bara den senaste revisionen får användas för tillverkning. Manuella komponentändringar i en montering gäller fortfarande i Visma Net. Därför hämtar SkyPlanner monteringsuppgifterna på nytt före release.

• Inga operationsföljder att importera. Alla processteg, ställtider och körtider läggs upp i SkyPlanner. Planera arbetsinsatsen och bestäm vem som ansvarar.
• Advanced logistics. Kit assembly kräver gruppen Advanced logistics. Med Standard logistics bokförs producerad kvantitet med Inventory receipt och Inventory issue.
• Låsta revisioner. En revision av Kit specification som har använts kan inte redigeras. Endast den senaste revisionen kan användas för tillverkning.
• Måttenheter. Kit assembly har en egen måttenhet. Säkerställ vid import att den stämmer med kvantiteterna i SkyPlanner.
• Pollning utan händelser. Kit har inga webhooks. Hämta ändringar med lastModifiedDateTime i stället för att läsa in allt på nytt, så att ni håller er inom gränsen för antal anrop per timme.
• Aktuella endpoints. Bygg enbart mot api.finance.visma.net och SalesOrder service v3.
• Tenantens godkännande. Client credentials fungerar inte förrän tenantadministratören har godkänt appen. Planera in det steget tidigt.
• Veckovisa tidkort. Tidkort kräver Advanced financials och gäller per vecka. Summera operatörernas timmar per vecka eller bokför dem som projekttransaktioner.