Trinn 1: Oppsett av servicebruker

Kunden må først opprette en servicebruker i Business NXT med riktige tilganger. Henvis dem til:

Dokumentasjon:
https://docs.vismasoftware.no/businessnxtapi/authentication/service/user_setup/

Denne servicebrukeren vil bli brukt til OAuth-autentisering og API-tilgang.

Brukeren må navngives: isv_equity

Trinn 2: Finn Visma.net Company ID

Kunden må oppgi sitt Visma.net Company ID, som er en numerisk identifikator for selskapet i Business NXT-systemet.

Company ID finnes under Generelle innstillinger → Administrer bedrifter.
Finn selskapet som skal onboardes, og kopier verdien i kolonnen “Visma.net company-ID”.

Trin 3: Start onboarding-flowet

1. Gå til:
   https://onboarding.espintegrations.com/onboard/business_nxt

2. Skriv inn Visma.net Company ID i skjemafeltet.

3. Send inn skjemaet (Submit).

(Se eventuelt også dokumentasjonen:
https://docs.vismasoftware.no/businessnxtapi/authentication/service/user_setup/)

Trinn 3: Start onboarding-flowet

Etter innsending av company ID blir brukeren sendt videre gjennom OAuth-flowet:

1. Godkjenning via Visma Connect med OAuth 2.0.

2. Påkrevd scope: business-graphql-service-api:access-group-based

3. Ved vellykket godkjenning åpnes Equity automatisk.

Feilsøking

Vanlige problemer

"No companies available"

Årsak: OAuth-legitimasjonen har ikke tilgang til noen selskaper.

• Kontroller at servicebrukeren er riktig konfigurert i Business NXT.

"Company not available"

Årsak: Det angitte Visma.net Company ID matcher ingen tilgjengelige selskaper.

• Verifiser at company ID er korrekt.

"Company organization number is required"

Årsak: Det angitte Visma.net Company ID matcher ingen tilgjengelige selskaper.

• Verifiser at company ID er korrekt.

Utløpt af OAuth-token

OAuth-tokens fornyes automatisk ved hjelp av refresh token.
Hvis autentiseringen feiler:

1. Kontroller at servicebrukeren ikke er deaktivert.

2. Verifiser at OAuth-klientens legitimasjon fortsatt er gyldig.

3. Kjør onboarding-flowet på nytt ved behov.