Xledger

How to setup the integration between Xledger and BDO’s data warehouse. You only need to complete these steps once.


Step 1: Create User 

(Skip this step if you already have an integration user)

  1. A universal integration user that is not dependent on any individual must be created.
    Important: The user needs the "Administrator" role to create an API token.
     To create such a user, contact XL support or your system partner.


Step 2: Log in to Xledger
  1. Open your web browser and go to the Xledger login page. Xledger login
  2. Use the integration user created for this purpose. If a password and phone number were set during user creation, use these credentials to log in.

xl1

NB: The token must be created either at the company level or the group level (Konsern) in Xledger.

a. If BDO is the auditor for all companies within a group, the token must be created at the group entity level in Xledger.

b. If BDO is the auditor for some companies within a group—but not all—the token must be created for each individual company that BDO needs access to. This means that one token must be created for each company, and not on group (konsern) level.


Step 3: Navigate to the API Section
  1. After logging in, you will land on the main menus, go to API Token.
  2. You can access the API token either through the search menu, which you can bring up by double-tapping Shift or by clicking on Change in the user menu at the top right corner.

xl2

a) Both will result in displaying the following:

xl3


Step 4: Create a New API Token
  1. In the API Tokens menu, click on "Generate new token".

xl4

  1. Assign the following read permissions in Scope as shown in the image below.

xl5

3. Add a description in the "token description" field to reflect its purpose or endpoint for easier token management.
 

Step 5: Copy the Token
  1. Click on "Generate token" as shown in the image above.
     Copy the generated token. 
    Note: This token will not be displayed again, so it is important to save it now.

xl6


Step 6: Transfer the Token
  1. Save the copied token in a document along with the Org. number. Upload the file in the field below, fill in the email, and click "Send".