Guide til Visma Net-integrasjon for produksjonsplanlegging med SkyPlanner APS

• Visma Net ERP API. REST med en OpenAPI-spesifikasjon som fortsatt heter «Visma.net ERP API v1», med v1- og v2-stier. Basis-URL-en er https://api.finance.visma.net. Trafikken til det gamle domenet integration.visma.net begrenses fra 1. februar 2026, og domenet er under avvikling (varsel).
• SalesOrder service v3 på https://salesorder.visma.net. v1- og v2-endepunktene for salgsordrer er utgått.
• Webhooks via Visma Developer Portal.
• Background API. Headeren erp-api-background legger langvarige kall i kø, returnerer 202 med en jobb-ID og varsler deg når resultatet er klart.
• Import- og eksportscenarioer i Visma Net, med dataleverandører for CSV, Excel eller SQL, for engangsinnlasting av grunndata.

API-et har ingen endepunkter for produksjonsordrer, produksjonsruter eller arbeidssentre, fordi Visma Net ikke har slike objekter. Dataene til produksjonsplanleggingen hentes fra varer, sett, ordrer og lager:

• GET /v1/inventory: lagervarer og ikke-lagerførte varer, inkludert settmarkering og vareklasse
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: komponentlinjer per revisjon
• GET /v1/kitassembly: eksisterende monteringer, som kan filtreres etter type og status
• SalesOrder service v3: etterspørsel med ønskede datoer og ordrelinjer
• GET /v1/inventorysummary/{inventoryNumber}: fysisk og tilgjengelig beholdning per lager
• GET /v1/purchaseorder og GET /v2/PurchaseReceipt: innkommende materialer og varemottak

Alle listeendepunkter støtter lastModifiedDateTime med lastModifiedDateTimeCondition, samt pageNumber og pageSize, slik at hver synkronisering kan være inkrementell.

Webhooks i Visma Developer Portal dekker hendelsene som er relevante for produksjonsplanleggingen:

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

Det finnes ingen hendelser for Kit assembly eller Kit specifications. SkyPlanner henter disse ved polling med lastModifiedDateTime-filtre. Lagerbeholdninger hentes når produksjonsplanleggingen kjøres. I motsatt retning sender SkyPlanner webhooks når tilstanden eller planen endres.

1. Førstegangsinnlasting av grunndata. Hent lagervarer, vareklasser og den nyeste revisjonen av Kit specification for hvert sett. Koble hver komponentlinje til et materiale i SkyPlanner. Opprett deretter det Visma Net ikke inneholder: arbeidsstasjoner, skift, prosesstrinn med omstillings- og kjøretider, omstillingstidsmatrisen og verktøykrav. Importer dem som CSV eller Excel. Dette er den største delen av prosjektet.

2. Ordresynkronisering. Velg én modell for etterspørselen:

• Styrt av salgsordrer. Åpne salgsordrelinjer for settvarer blir til ordrer i SkyPlanner, med ønsket dato som leveringsfrist.
• Styrt av monteringer. Kit assemblies som opprettes i Visma Net med status On hold, blir til jobber i SkyPlanner.

Åpne innkjøpsordrer hentes inn med datoene sine. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når ordren merkes som Delivered. Sammen med lageroversikten gjør dette at produksjonsplanleggingen kontrollerer både lagerbeholdningen og varer som er bestilt, men ennå ikke mottatt.

3. Tilbakeskriving av planen. I et oppsett styrt av salgsordrer oppretter SkyPlanner en Kit assembly av typen Production for hver planlagte jobb. SkyPlanner angir settvare, revisjon, lager, antall og komponenter, og kobler monteringen til salgsordrelinjen. Monteringsdatoen er planlagt sluttdato. Når Autopilot flytter jobben, oppdateres datoen med et PUT-kall før frigivelse.

Kit assembly har ett Date-felt. Tidspunktene for de enkelte operasjonene blir derfor værende i SkyPlanner, mens Visma Net får datoen som er relevant for salg og lager.

4. Tilbakemeldinger fra produksjonen. Operatørene registrerer arbeid med Mobile Confirmations eller Production Timer, og tidsregistreringene holder planen oppdatert. Når det siste trinnet er ferdig, kaller SkyPlanner frigivelseshandlingen på Kit assembly. Frigivelsen bokfører produsert mengde og komponentforbruk, og deretter følger hovedboksbunten. Timene summeres i ukentlige Employee time cards, eller i prosjekttransaksjoner for prosjektstyrt arbeid.

5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:

En endring i en Kit specification oppretter en ny revisjon. Les inn den nyeste revisjonen på nytt og oppdater koblingene, siden bare den siste revisjonen kan brukes til produksjon. Manuelle komponentendringer i en Kit assembly gjelder fortsatt i Visma Net, så SkyPlanner leser den tilbake før frigivelse.

• Ingen produksjonsruter å importere. Alle prosesstrinn, omstillingstider og kjøretider opprettes i SkyPlanner. Planlegg arbeidsinnsatsen og avklar hvem som har ansvaret.
• Advanced logistics. Kit assembly krever gruppen Advanced logistics. Med Standard logistics posteres produsert mengde med Inventory receipt og Inventory issue.
• Låste revisjoner. En revisjon av en Kit specification som er tatt i bruk, kan ikke redigeres. Bare den nyeste revisjonen kan brukes til produksjon.
• Måleenheter. Kit assembly har sin egen måleenhet. Sørg for at den samsvarer med mengdene i SkyPlanner ved import.
• Polling uten hendelser. Sett har ingen webhooks. Hent bare endringer med lastModifiedDateTime, ikke alle data på nytt, for å holde dere innenfor den timebaserte grensen for API-kall.
• Gjeldende endepunkter. Bygg bare på api.finance.visma.net og SalesOrder service v3.
• Godkjenning fra tenantadministratoren. Client credentials fungerer ikke før tenantadministratoren har godkjent appen. Avtal dette trinnet tidlig.
• Ukentlige timelister. Timelister krever Advanced financials og føres per uke. Summer operatørtimene per uke, eller poster dem som prosjekttransaksjoner.