Følgende steg må utføres for å sette opp integrasjonen mellom Account Control og Visma Business NXT.
Som start på prosessen vil dere få en klient-ID knyttet til en appregistrering utført av oss i Account Control tilsendt. Denne legges inn som en bruker i Visma Business NXT og brukes til å knytte rettigheter opp mot selskapene dere ønsker å hente inn i Account Control.
Dere kan hoppe over steget under (registrering av ny applikasjon), da dette i utgangspunktet ikke skal gjøres av dere. Om dere er kjent med Visma Developer Portal fra før (og har registrert selskapet deres der fra før, uavhengig av oppsett mot Account Control), kan dere utføre dette steget selv om dere ønsker. Om dette er tilfellet, kan klikke på raden under for å vise fremgangsmåten for registrering av ny applikasjon i Visma Developer Portal.
Registrering av ny applikasjon (Gjøres av support per i dag)
Registrering av ny applikasjon
- Logg på Visma Developer Portal (https://oauth.developers.visma.com/service-registry/home)
- Gå til My applications i toppmenyen
- Klikk på knappen Add application på høyre side
Klikk på bildene for å forstørre de og ESC for å lukke bildevisning - Under Select Application Type, velg Service og klikk på Next
- Gi et navn til applikasjonen din (f.eks. AccountControlSvc) og gi den en unik ClientID (feks isv_acsvc)
- Skriv inn en beskrivelse
- Noter ned ClientId for denne vil du trenge senere
- La resten av feltene stå som de er, men huk av på Client Credentials. Access Token Lifetime kan stå til 60 minutter
- Klikk på “Save as draft” og videre på “Create“
Credentials - Oppretting av nøkler
Neste trinn er å opprette en client secret.
- Klikk på Credentials i venstre menyen
- Klikk på Generate secret
- Fyll ut beskrivelse om du vil
- La expiration stå til “No expiration”
- Klikk på “Generate secret”
-
- Kopier den genererte nøkkelen (du trenger denne når du setter opp klienten i Account Control)
- Det er en god ide å lagre nøkkelen i en passordhåndterer (f.eks. LastPass, Keeper, 1Password etc.)
- Det er en god ide å lagre nøkkelen i en passordhåndterer (f.eks. LastPass, Keeper, 1Password etc.)
- Kopier den genererte nøkkelen (du trenger denne når du setter opp klienten i Account Control)
- Det neste trinnet er å spesifisere hvilken integrasjon som skal være tilgjengelig for denne applikasjonen
- Klikk på “Integrations” i menyen til venstre
- Klikk på “New Integration” på den venstre siden
- I Select API nedtrekkslisten så velger du Business NXT GraphQL Service API
- Klikk Continue
- I scopes så velger du den som er tilgjengelig der (business-graphql-service-api:access-group-based)
- Klikk på Continue
- Klikk på Confirm Integration
Supert! Du har nå en klient og en secret. Neste skritt er å knytte den sammen med tilgang til Visma NXT
Knytt sammen app og Visma-bruker
- Logg inn på Business NXT (https://business.visma.net/)
- Klikk på → Meny → Opprett nytt oppsett (i bunnen)
- Klikk på Nytt element → Tabell
- Søk etter Bruker og velg den
- Sørg for at Connect Applikasjon-kolonnen fra denne tabellen er markert og klikk OK
- Klikk på knappen Lagre som ny
- Gi oppsettet et navn (f.eks. Save Setup)
- Trykk på Lagre oppsett
- Legg til en ny rad/bruker med samme navn som klienten som dere fikk tilsendt (f.eks.. isv_acservice) ved å klikke på Ny i bunnen av brukerlisten, eller ved å dobbeltklikke på den tomme raden i bunnen
- Marker Connect applikasjon-feltet i kolonne helt til høyre og deretter på den blå Lagre-knappen i toppen
- Aktiver Design-modus i øvre høyre hjørne
- Klikk på Nytt element og Tabell
- Legg til tabellen Connect applikasjonsadgang og klikk på Ok
- Forslag: dra den nye tabellen ut til siden så den ikke er på toppen av “User” tabellen (bruk markøren i det øverste venstre hjørnet av tabellen for å gjøre dette)
- Forslag: dra den nye tabellen ut til siden så den ikke er på toppen av “User” tabellen (bruk markøren i det øverste venstre hjørnet av tabellen for å gjøre dette)
- Klikk på Lagre endringer og gå ut av Design-modus (Viktig!)
-
Legg til den nylig opprettede brukeren til Connect applikasjonsadgang-tabellen.
- Dette kan gjøres ved å dobbeltklikke på en ny rad, og så finner du din nye bruker i søkeboksen som dukker opp, og så trykker du Ok.
- Velg selskapet du vil gi servicen din tilgang til ved å skrive inn nummeret i Column no. feltet (eller dobbeltklikk og velg det fra nedtrekkslisten)
- Velg bedriftssgruppe (bruk Standard) for den nye brukeren
- Velg den ønskede brukergruppen som definerer tilganger til dette selskapet
- Av sikkerhetsårsaker så er det anbefalt å opprette en egen tilgangsgruppe for din integrasjon. Dette kan du gjøre i tilgangsinnstillinger (access management settings). For Save Solutions har en tilgangsgruppe blitt opprettet som heter “Integration” og den har id 3)
- Du må gjenta de siste to trinnene for hvert selskap du ønsker å gi tilgang til
- Trykk på den blå Lagre-knappen. Dine endringer er nå lagret.
Knytte Visma Business NXT til Account Control
NB! Dette steget håndteres foreløpig av vårt supportteam. Gi oss beskjed så snart brukeren er knyttet i Visma NXT, så setter vi i gang med å verifisere dataene.
Du er nå klar for å knytte Visma Business Next til Account Control!
Dette gjøres under integrasjonsinnstillingene for Visma Business NXT.
Logg først på Account Control og følg stegene under:
- Åpne Administrator
- Klikk på API-nøkler
- Velg Visma Business NXT
- Fyll inn Klient-ID i eget felt (ikke bruk den i eksempelet under, bruk den du har blitt tildelt av oss)
- Fyll inn Klientnøkkel i eget felt (ikke bruk den i eksempelet under, bruk den du har blitt tildelt av oss)
- Klikk på Ferdig
Kjør en selskapsimport
- Naviger til Balancer-siden ved å klikke på knappen med en vektskål som anvist i bildet, eller klikk HER for å navigere direkte dit.
- Klikk Importer selskaper.
Selskapene skal nå dukke opp i listen og være klare til å settes opp. Rapportoversikten på høyre side er markert i rødt for selskap som ikke er satt opp. - Klikk på selskapsnavnet for å starte oppsettsveiviseren.
Se denne artikkelen for dokumentasjon på hvordan kommer i gang med balanseavstemming på et nytt selskap: Balanseavstemming - Opplæringsvideoer
Problemer med selskapsimport og oppdatering fra Visma Business NXT
Grunnet manglende validering av avgiftskoder på kontoplanen i Business NXT, kan det oppstå tilfeller hvor en avgiftskode som er definert på en konto slettes, og at den blir værende igjen som definert avgiftskode på kontoplanen. Da får vi en feilmelding ved oppsett av selskapet (om det er første gang det kjøres en import på det gitte selskapet), eller ved en senere oppdatering av regnskapsdata i Account Control.