BL Administration & Sandboxcompany Quick guide

Erik Söderlund - 21 February, 2023
If you wish to access the sandbox company in BL Administration, you first need to get a developer-license for BL Administration. To do so, you have to send a request e-mail to API@bjornlunden.se. In the request you can decide how many users the developerlicense should contain. If you need more than one sandbox company for different environments, such as PROD, STAGE, TEST etc. just let us know in the request e-mail.

Step 1 – Download BL Administration
Once you received the activation mail for your developer-license, go to https://www.bjornlunden.se/ Click on “Logga in” and “Glömt lösenord”. Fill in your customer number and click “Skicka nytt lösenord” and confirm it. You will receive a new e-mail containing the password. When signed in you can find BL Administration under “Mina program”.

Step 2 – Login and start exploring
After the installation, Start the application and choose “Lokal företagsgrupp”, use a *(asterisk) as username without a password to login.

Step 3 – Licensing BL Administration
Activate your developer-license by clicking on “Licensierat system” – “Uppdatera licens” – ”Licensuppdatering över internet”
Fill in your login details and OK.
At first login you will get a question if you want to import a local sandbox company. Choose as you please and explore our software.
This is a local database for BL Administration use only.

Step 4 – Add the Sandbox company
Now, to the point!


To add your sandbox company to the companylist, click on “ny” and fill in an ID (1-4 digits) and a company name.
Select the “Databas I molnet” and Next.



Select the alternative above and OK.


Fill in the sandbox company database information you received when you activated the API-keys. Database, username and password in that order. (Timeout can be left blank)
Congratulations!

You now have access to the sandbox company in BL Administration and can follow your data from a customer perspective.
Just click on the company in the list and let the testing begin!

Best of luck! /The Dev Team @Björn Lundén AB

API quickguide

Erik Söderlund - 19 May, 2022
First of all, we would like to thank you for your time and interest in Björn Lundén AB’s API! In this tutorial we hope to guide you through the steps needed to complete your first successful calls to them.

Step 1 – onboard your integration
Visit https://developer.bjornlunden.se/get-started/ and complete the necessary steps to acquire the API credentials. We use OAuth 2.0 Client Credentials Flow to identify your integration in our system, and GUID’s for identifying specific companies/databases. Worth noting is that once you get the credentials and complete the onboarding process through the link we send you during that process, you also will have access to a sandbox company representing your first connected customer or client. This sandbox company will be loaded with fake data for you to hit the ground running in your implementation work.

Step 2 – Get an access token
Call our identity server to get an access token. Each token is valid for 3600sec/1h and multiple tokens can be used simultaneously (but please use best practises by reusing tokens while valid, not to overburden our servers).

curl
--location --request POST '{baseUrlAuth}/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-raw'grant_type=client_credentials&scope=&client_id=&client_secret='

The above call will give you an answer like such:
Step 3 – Get list of connected companies/clients
This call will give you the list of id’s to connected companies. Once you go live with your finished integration, this list will grow as more companies connect themselves through our Marketplace, but if this is the first time you call this endpoint, the list most likely will consist of only the one Sandbox company that we created and connected to you as part of the onboarding in Step 1. These GUID’s are global and static in our systems, and potentially suitable to persist in your system as an identifier for the same company on your end as well.

alt.1
curl
--location --request GET ‘{baseUrl}/meta/allKeys’ \
--header ‘Content-Type: application/json’ \
--header ‘Authorization: Bearer
The answer will be an JSON array of GUID’s each representing a connected company that you are allowed to access through the API.

alt.2
curl
--location --request GET ‘{baseUrl}/common/client’ \
--header ‘Content-Type: application/json’ \
--header ‘Authorization: Bearer
The answer will be a JSON body containing the name, GUID(s), email address and scopes for each connected company that you are allowed to access through the API.

For the Sandbox, you will have extensive rights to enable you to develop your integration to your liking. But when you are ready to go live, we will validate and agree on which endpoints and scopes you will use in production. The ever-growing list of possible calls can be found as Swagger here https://developer.bjornlunden.se/api-documentation

Step 4 – make a call to your Sandbox company
The only additional thing needed from step 3, to make a call regarding a specific company, is the HEADER “User-Key” with the GUID value found in step 3.

curl
--location --request GET '{baseUrl}/details' \
--header 'Content-Type: application/json' \
--header 'User-Key: ' \
--header 'Authorization: Bearer '

That will give you an extensive JSON object with the details of the company identified by “User-Key”. (More information about the response for this call can be found here: https://developer.bjornlunden.se/api-documentation/ under “details” – where you also can find complete Swagger specs)

Finally
We hope you found this quick guide helpful, and that you will find our API intuitive and productive.
Also please don’t hesitate to reach out to us through Slack https://developer.bjornlunden.se/slack/ if you run into trouble or if you have suggestions or feature requests in the API! We are also available through api@bjornlunden.se if that is more convenient for you. Best of luck!

/The Dev Team @Björn Lundén AB