Gå til innhold

Visma.net-integrasjon

Status per 2026-06-10: Det finnes ingen aktiv Visma.net-integrasjon i ePortal. Det er ingen adapter under api/ePortal.API/ePortal.Base/Services/Integration/, ingen wv_IntegrationType-rad med TypeCode VismaNet/VismaDotNet, og ingen frontend-template i Konti Connect. URL-strenger som inneholder visma.net i kodebasen tilhører enten Visma Business NXT (business.visma.net) eller Visma Payroll (payrollapl.no.visma.net).

Denne siden beholdes som referanse for hva som vil måtte avklares hvis en Visma.net-integrasjon blir utviklet, og som svar til kunder som spør om Visma.net-støtte. Behandle innholdet som plan/aspirasjon, ikke implementasjon.

Visma.net er Visma sin SaaS-regnskapsplattform. Når en kunde sier "vi bruker Visma.net" er det ofte snakk om Visma Business NXT (skybasert ERP) — se Visma Business NXT-integrasjonen som er den faktisk støttede SaaS-Visma-integrasjonen, eller Visma Payroll for lønn.

Type (planlagt): OAuth 2.0 mot Visma.net Connect, REST-/OData-API Modul i ePortal (planlagt): Konti Connect Forskjell fra NXT: Visma Business NXT er den moderne SaaS-ERP-plattformen som ePortal har faktisk støtte for via GraphQL-API. Verifiser med kunden hva de faktisk har før du tar dette som "ja vi har integrasjon".

Hva integrasjonen er planlagt å synke (ikke implementert)

Alle tabeller og felter under er planlagte scenarier og må verifiseres mot Visma.net Connect-dokumentasjonen og en faktisk implementasjons-spike før de tas i bruk. Det finnes ingen kode i ePortal som faktisk gjør dette.

Retning Entitet Frekvens (typisk)
ePortal → Visma.net Fakturaer Hver time / umiddelbart
ePortal → Visma.net Bilag (aktivering timer) Per kjøring
Visma.net → ePortal Kunder Daglig
Visma.net → ePortal Leverandører Daglig
Visma.net → ePortal Kontoplan Ved konfigurasjons-endring
Visma.net → ePortal Bilagserier Ved oppsett
Visma.net → ePortal Bank-transaksjoner Hver time (for bankavstemming)

Tilgang

Hvem Hva trengs
Hos Visma.net Administrator-konto med tilgang til API-administrasjon
Hos Konti Administrator-tilgang til Konti Connect-modulen
Hos kunden Visma.net firmanummer (tenant) avklart

Forutsetninger

  • Visma.net-abonnement aktivt med API-tilgang aktivert
  • ePortal har Konti Connect-modulen aktivert
  • Kontoplan og avdelings-struktur i Visma.net stemmer med ePortal sin

Slik gjør du — første oppsett

1. Registrer ePortal som API-klient i Visma.net

I Visma.net-administrasjon:

  • Innstillinger → API-tilgang → Ny applikasjon
  • Velg "ePortal / Konti Connect"
  • Generer Client ID og Client Secret
  • Velg ønsket scope (kunder, leverandører, fakturaer, hovedbok)

2. Konfigurer i Konti Connect

I ePortal → Konti Connect → Ny integrasjon → Visma.net:

  • Lim inn Client ID + Client Secret
  • Angi Visma.net firmanummer
  • Autoriser tilgang via OAuth-popup

3. Velg synkroniserings-omfang

Entitet Anbefalt
Kunder Ja — kreves for faktura
Leverandører Ja — kreves for innkjøp
Kontoplan Ja — kreves for bilag
Avdelinger Ja, hvis tenant har flere avdelinger
Prosjekter Avhengig av om kunden bruker Visma sin prosjektmodul
Bank-transaksjoner Ja, hvis bankavstemming-modulen brukes

4. Konfigurer mapping

Visma.net-spesifikke felter:

ePortal-felt Visma.net-felt
Kundenummer CustomerNumber
Org.nr OrganizationNumber
Avdeling Department / R1
Prosjekt Project / R2
Konto AccountNumber

5. Sett frekvens og kjør test

  • Master-data: daglig
  • Fakturaer: per godkjenning eller hver time
  • Bank-data: hver time

Kjør test-runde manuelt og verifiser via logg.

Konfigurasjon — viktige innstillinger

Faktura-flyt

Innstilling Betydning
Bilagsserie Hvilken Visma.net-serie fakturaer føres på
Mva-håndtering Hvilke mva-koder mapper til hvilken Visma.net mva-kode
Forfallsdato Default + mulighet for kunde-spesifikk overstyring

Avdeling og prosjekt

Visma.net bruker R1-R8 (ressurser/dimensjoner) for å klassifisere bilag. Mapping fra ePortal:

  • ePortal avdeling → R1
  • ePortal prosjekt → R2
  • ePortal arbeidsordre → R3 (avhengig av oppsett)

Sikkerhet

  • OAuth-tokens roteres typisk hver 60-90 dager — Konti Connect varsler
  • Roter ved ansatt-avgang
  • Aldri del Client Secret
  • Logg innholdt kan inneholde kundedata — vær varsom ved skjermdump

Vanlige problemer

OAuth feiler med "scope mismatch"

Du har bedt om mer eller mindre tilgang enn hva Visma-applikasjonen er konfigurert for. Sjekk scope-listen og match begge sider.

Kunder synkes ikke

  • Sjekk om kunden er "Aktiv" i Visma.net
  • Sjekk filter — typisk om "Bare aktive" er valgt
  • Sjekk feilmelding i Konti Connect-logg for konkret kunde-ID

Fakturaer feiler med "Account not found"

Mapping av kontoplan er ufullstendig. Sjekk at alle ePortal-arts-koder har mapping til en Visma-konto, eller at default-konto er satt.

"Mva-kode ikke gyldig"

Visma.net-mva-kode-listen oppdateres iblant. Hvis mapping bruker en utgått kode, må den oppdateres. Sjekk Visma.net-administrasjon for gyldig kode-liste.

Bank-transaksjoner synkes ikke for bankavstemming

  • Sjekk at bank-modulen er aktivert i Visma.net
  • Sjekk at bank-kontoer er mapped riktig
  • Periodefilter må stemme

Migrasjon fra Visma Business klassisk

Hvis kunden bytter fra Visma Business klassisk til Visma.net:

  1. Sett opp Visma.net-integrasjonen parallelt
  2. Synk master-data fra Visma.net
  3. Sammenligne kontoplaner og rette eventuelle avvik
  4. Bytte faktura-flyt over til Visma.net
  5. Pause klassisk-integrasjonen

Tilbakemelding til kunder

Hvis en kunde spør om Visma.net-støtte:

  1. Avklar hvilken Visma-tjeneste de faktisk har:
  2. "Visma Business NXT" / "Visma.net ERP" → NXT-integrasjonen
  3. "Visma Lønn" / "Visma.net Payroll" → Visma Payroll-integrasjonen
  4. "Visma Business" (on-premise) → klassisk via PortalConnector
  5. "Visma.net Financials" / "Visma.net Project Management" → ikke støttet, krever ny adapter
  6. Hvis kunden eksplisitt trenger Visma.net Financials/Project Management: kontakt produkteier for prioritering.

Relaterte sider