Guide til Visma Net integration til produktionsplanlægning med SkyPlanner APS

• Visma Net ERP API. REST med en OpenAPI-specifikation, der stadig hedder “Visma.net ERP API v1”, og med v1- og v2-stier. Basis-URL’en er https://api.finance.visma.net. Det gamle domæne integration.visma.net får begrænset kaldhastigheden fra 1. februar 2026 og er ved at blive lukket ned (meddelelse).
• SalesOrder service v3 på https://salesorder.visma.net. Salgsordre-endpoints i v1 og v2 er udfaset.
• Webhooks via Visma Developer Portal.
• Background API. Med headeren erp-api-background sættes langvarige kald i kø. API’et returnerer 202 med et job-ID og giver besked, når resultatet er klar.
• Import- og eksportscenarier i Visma Net med CSV, Excel eller SQL som datakilder til engangsindlæsning af stamdata.

API’et har ingen endpoints til produktionsordrer, ruter eller arbejdscentre, fordi disse objekter ikke findes i Visma Net. Data til planlægningen hentes fra varer, kits, ordrer og lager:

• GET /v1/inventory: lagervarer og ikke-lagervarer, inklusive kit-markering og vareklasse
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: komponentlinjer pr. revision
• GET /v1/kitassembly: eksisterende montageordrer, som kan filtreres efter type og status
• SalesOrder service v3: behov med ønskede datoer og ordrelinjer
• GET /v1/inventorysummary/{inventoryNumber}: fysisk og disponibel beholdning pr. lager
• GET /v1/purchaseorder og GET /v2/PurchaseReceipt: indgående materialer og varemodtagelser

Alle liste-endpoints accepterer lastModifiedDateTime med lastModifiedDateTimeCondition samt pageNumber og pageSize, så hver synkronisering kan være inkrementel.

Webhooks i Visma Developer Portal dækker de hændelser, der er relevante for planlægningen:

• Inventory Item Created, Updated og Changed
• Purchase Order Changed og Status Changed
• Sales Order Changed og Status Changed, som flyttes til udgiveren SalesOrderService

Der findes ingen hændelser for Kit assembly eller Kit specifications. SkyPlanner henter disse via polling med lastModifiedDateTime-filtre. Lagerbeholdninger hentes via polling, når planlægningen køres. I den modsatte retning sender SkyPlanner webhooks, når status eller planen ændres.

1. Første indlæsning af stamdata. Hent lagervarer, vareklasser og den seneste revision af Kit specification for hvert kit. Knyt hver komponentlinje til et materiale i SkyPlanner. Opret derefter det, som Visma Net ikke indeholder: arbejdsstationer, skiftehold, procestrin med opstillings- og køretider, en matrix med omstillingstider og værktøjskrav. Importer dem som CSV eller Excel. Det er den største del af projektet.

2. Ordresynkronisering. Vælg én model for, hvad der udløser behovet:

• Styret af salgsordrer. Åbne salgsordrelinjer for kit-varer bliver til ordrer i SkyPlanner med den ønskede dato som leveringsfrist.
• Styret af montageordrer. Kit assemblies, der oprettes i Visma Net med status On hold, bliver til opgaver i SkyPlanner.

Åbne indkøbsordrer overføres med deres datoer. SkyPlanner regner bestilte materialer som disponible på indkøbsordrens leveringsdato og opdaterer lageret, når indkøbsordren markeres som Delivered. Med disse data og lageroversigten tager planlægningen højde for både lagerbeholdningen og indgående indkøb.

3. Tilbageskrivning af planen. I en opsætning styret af salgsordrer opretter SkyPlanner en Kit assembly af typen Production for hver planlagt opgave. SkyPlanner angiver kit-vare, revision, lager, antal og komponenter og knytter montageordren til salgsordrelinjen. Montageordrens dato er den planlagte slutdato. Når Autopilot flytter opgaven, opdateres datoen med et PUT-kald inden frigivelse.

Kit assembly har ét Date-felt, så tidspunkterne for de enkelte operationer bliver i SkyPlanner. Visma Net får den dato, der er relevant for salg og lager.

4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen opdateret. Når det sidste trin er færdigt, kalder SkyPlanner frigivelseshandlingen på Kit assembly. Frigivelsen bogfører den producerede mængde og komponentforbruget, og derefter følger finanskladden. Timerne samles i ugentlige Employee time cards eller i projekttransaktioner, når arbejdet er projektstyret.

5. Regler for dataejerskab og konflikter. Skriv dem ned før idriftsættelse:

En ændring i en Kit specification opretter en ny revision. Læs den seneste revision ind igen, og opdater mappingen, da kun den seneste revision kan bruges til produktion. Manuelle ændringer af komponenter på en Kit assembly gælder fortsat i Visma Net, så SkyPlanner læser den tilbage før frigivelse.

• Ingen ruter at importere. Alle procestrin, omstillings- og køretider oprettes i SkyPlanner. Planlæg arbejdet, og udpeg en ansvarlig.
• Advanced logistics. Kit assembly kræver gruppen Advanced logistics. Med Standard logistics bogføres produktionen via Inventory receipt og Inventory issue.
• Låste revisioner. En revision af en Kit specification kan ikke redigeres, når den er taget i brug, og kun den seneste revision kan bruges til produktion.
• Måleenheder. Kit assembly har sin egen måleenhed. Sørg ved import for, at den stemmer overens med mængderne i SkyPlanner.
• Polling uden hændelser. Kits har ingen webhooks. Hent kun ændringer ud fra lastModifiedDateTime frem for at genindlæse alle data, så I holder jer inden for den tilladte grænse for kald pr. time.
• Aktuelle endpoints. Byg kun på api.finance.visma.net og SalesOrder service v3.
• Tenantgodkendelse. Client credentials virker ikke, før tenantadministratoren har godkendt appen. Aftal det trin tidligt.
• Ugentlige timesedler. Timesedler kræver Advanced financials og dækker en uge ad gangen. Saml operatørtimerne pr. uge, eller bogfør dem som projekttransaktioner.