1. Getting started

Integrating with DataLøn is done through our RESTful API based on JWT  authentication.

Become integration partner

1. Contact Søren to sign up as integration partner
2. You will receive a subscription-key and a demo account. Follow the link in the received email and create a password
3. Integrate with our PreProduction environment before integrating with the Production environment

Activating integration and collect the refreshToken

---

1. Log into DataLøn and select the "Opsætning -> Integration til andre systemer"-button in the top menu.
2. Find your companies integration tile in the list and click the "Tilmeld"-knap.
3. Copy the refreshToken.

Environment URLs

---

PreProduction (Test)

Bluegarden SSO: https://preprod-logon.bluegarden.dk/api/LoginRefreshToken

DataLøn API: https://preprod-dataloen-api.bluegarden.dk/api/input/salary

DataLøn: https://preprod-dataloen.bluegarden.dk

 

Production

Bluegarden SSO: https://logon.bluegarden.dk/api/LoginRefreshToken

DataLøn API: https://dataloen-api.bluegarden.dk/api/input/salary

DataLøn: https://dataloen.bluegarden.dk

Authentication

---

Collect an accessToken using the refreshToken via the Single Single On (SSO) service

• POST https://BluegardenSsoUrl/api/LoginRefreshToken
• Request headers
  
  

  Key	Value	Description
  Ocp-apim-subscription-key	subscription-key
  Content-Type	application/json

• Request body

  { "refreshToken" : refreshToken }

• Response body 200

  { "accessToken" : accessToken }

• Note: The accessToken expires after one hour

Glossary

---

Subscription-Key

UUID string
A unique key granted to the integration partner (you). Varies for each environment (PreProduction, Production). 

RefreshToken

64 character string
Unique key representing the connection between a DataLøn Employer and an integration partner.

AccessToken

A Json Web Token, JWT issued by Bluegardens SSO. Expires after one hour. Used in all API requests.