Onify Blueprint: Activate and authenticate Fortnox integration

Fortnox is a Swedish ERP company that delivers a cloud-based business platform for financial management. In this Blueprint we Activate the integration between Fortnox and Onify.

Requirements

• Onify Hub
• Fortnox

Included

• 3 x Flows
• 1 x Form
• 2 x Settings

Setup

Resources

Copy .\resources\* to your Onify Hub resources

Settings

Add the following settings via /admin/settings.

Key	Name	Description	Value	Type	Tag	Role
fortnox_app_clientid	fortnox_app_clientid	Onify App Client Id	JBL1UVnvfo4y	string	fortnox,frontend	admin
fortnox_app_clientsecret	fortnox_app_clientsecret	Onify App Client Secret	*******	password	fortnox	admin

Please contact support@onify.co to get the fortnox_app_clientsecret value.

Configuration

Import configuration for forms and flows using the following command;

curl -X POST "<ONIFY-HUB-API-URL>/api/v2/setup/database/config/import" -H "accept: application/json" -H "authorization: <AUTH-TOKEN>" -H "Content-Type: application/json" -d "@./config.json" --insecure

Activate (and authenticate) integration with Fortnox

• Create activation link for Fortnox (in Onify)
  1. Go to <ONIFY-HUB-APP-URL>/form/fortnox-activate
  2. Enter Redirect URI
  3. Enter Scopes (and modify if needed)
  4. Click Generate activation URL
  5. Click on the generated action link
• Authenticate user for Onify (in Fortnox)
  1. Enter username and password for Fortnox
  2. Approve access for user and Onify
  3. Fortnox will redirect you to a website that does not exist
  4. Copy the code (eg. 035411fc-ce95-4c4a-bc15-273daf5ddd67) from the url
• Activate and authenticate Fortnox (in Onify)
  1. Go back to the activation form
  2. Paste the code in Authentication code
  3. Click Activate Onify in Fortnox

For more information about authenticating against Fortnox, please read Authorizing your integration.

Authenticate and refresh access-token

fortnox-refresh-access-token.bpmn is used for refreshing the access-token. The Access Token is valid 1 hours the Refresh Token is valid for 31 days. So make sure you refresh the Refresh Token before it expires and you have to reactivate the integration again.

Support

• Community/forum: https://support.onify.co/discuss
• Documentation: https://support.onify.co/docs
• Support and SLA: https://support.onify.co/docs/get-support

License

This project is licensed under the MIT License - see the LICENSE file for details.