Step 1: Opsætning af servicebruger

Kunden skal først oprette en servicebruger i Business NXT med de rette tilladelser. Henvis dem til:

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

Denne servicebruger vil blive brugt til OAuth-godkendelse og API-adgang.

Brugeren skal navngives: isv_equity

Trin 2: Find Visma.net Company ID

Kunden skal oplyse sit Visma.net Company ID, som er en numerisk identifikator for virksomheden i Business NXT-systemet.

Company ID findes under General Settings → Manage Companies.
Find den virksomhed, der skal onboardes, og kopier værdien i kolonnen “Visma.net company-ID”.

Trin 3: Start onboarding-flowet

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

2. Indtast Visma.net Company ID i formularfeltet.

3. Send formularen (Submit).

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

Trin 4: Godkendelse

Efter indsendelse af company ID bliver brugeren viderestillet gennem OAuth-flowet:

1. Godkendelse via Visma Connect med OAuth 2.0.

2. Påkrævet scope: business-graphql-service-api:access-group-based

3. Ved succesfuld godkendelse åbner systemet automatisk Equity.

Fejlfinding

Typiske problemer

"No companies available"

Årsag: OAuth-legitimationsoplysningerne har ikke adgang til nogen virksomheder.

• Kontrollér, at servicebrugeren er korrekt konfigureret i Business NXT.

"Company not available"

Årsag: Det angivne Visma.net Company ID matcher ingen tilgængelige virksomheder.

• Verificér, at company ID er korrekt.

"Company organization number is required"

Årsag: Virksomheden i Business NXT har ikke noget organisationsnummer (f.eks. CVR-nummer) angivet.

• Opdater virksomhedsoplysningerne i Business NXT.

Udløb af OAuth-token

OAuth-tokens fornyes automatisk ved hjælp af refresh token.
Hvis autentificeringen fejler:

1. Kontrollér, at servicebrugeren ikke er blevet deaktiveret.

2. Verificér, at OAuth-klientens legitimationsoplysninger stadig er gyldige.

3. Kør onboarding-flowet igen om nødvendigt.