VBS integration setup towards Visma Business in BxAdmin
To set up a VBS integration towards Visma Business, you need to have a valid VBS license for Visma Business. The VBS integration also requires a VBS user. There are two different ways to set up a VBS user: Context username and Host integration. Which of these two types of user you can create depends on what sort of VBS license you have.
To learn more about how to create a VBS user, click here.
With the Context username you only need one user in the setup and this will be used as vbs and contect within our setup parametres. With the Host integration we need a vbs username and a context user. This is often just the system user, or a different equivalent user. There is no need for a password for the context user.
BxAdmin
During new installations of BxEngine and first time sign-ins to BxAdmin you will see the setup wizard. Here you pick the VismaBusinessServices to upload the standard settings for VBS. During the next steps you enter the database connection for the Visma Business database with the bxengine sql user that was created during the installation of BxEngine.
When the setup wizard is complete you can move on to Configuration -> Company Profiles, search for vb to see all the relevant fields that has to be filled out.
Here you fill out:
- The installation path to Visma Business. Change it to the correct path. If Visma Business is on a different server than BxEngine, you must enter the UNC path to the VB server, i.ex \Vismaserver\Business (it is important that it is the Business catalogue). In these cases you must also add a service user with access to the installation catalogue on our BxEngine Service so that the service will get the access to this catalogue.
- The company number in Visma, if i.ex "302" you must enter 0302 (the number of 0 in the database name), or in our case; 9999
- Context user. In this case we use a host integration user in the vbsusername field, and it should be filled out with what counts as context user in their system. System is often enough, or the user you specifically created for our integration. In our case this is our "BxContextUser" user. If the VBS user is a context username, the context username field must be the VBS username.
- VBS Culture ID - you can leave this as standard "Norwegian_Bokmaal__Norway"
- VBS Endpoint address - The address to the VBS endpoint, localhost is often enough if BxEngine and Visma Business has been installed on the same server, or potentially just switch out the localhost with the server name if Visma Business has been installed on a different server from BxEngine.
- VBS password - The password for the VBS user itself (user with context username, or in this case the host integration option)
- VBS Site ID - Standard is often enough, if it differs from this you must enter the correct ID.
- VBS username - Here you enter the VBS user (user with context username, or in this case the host integration option)
- Example of a username setup
