https://github.com/onify/blueprint-fortnox-activate-authenticate
Onify Blueprint: Activate and authenticate Fortnox integration
https://github.com/onify/blueprint-fortnox-activate-authenticate
blueprint bpmn flow form fortnox integration onify onify-blueprint onify-blueprints rest-api
Last synced: 6 months ago
JSON representation
Onify Blueprint: Activate and authenticate Fortnox integration
- Host: GitHub
- URL: https://github.com/onify/blueprint-fortnox-activate-authenticate
- Owner: onify
- License: mit
- Created: 2022-09-20T21:00:02.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-06-15T12:49:29.000Z (about 3 years ago)
- Last Synced: 2025-02-16T17:57:04.263Z (over 1 year ago)
- Topics: blueprint, bpmn, flow, form, fortnox, integration, onify, onify-blueprint, onify-blueprints, rest-api
- Language: Pug
- Homepage: https://onify.co
- Size: 390 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.repostatus.org/#wip)
# Onify Blueprint: Activate and authenticate Fortnox integration
[Fortnox](https://fortnox.com/) 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](https://github.com/onify/install)
* [Fortnox](https://freshservice.com/)
## 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;
```bash
curl -X POST "/api/v2/setup/database/config/import" -H "accept: application/json" -H "authorization: " -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 `/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
4. Fortnox will redirect you to a website that does not exist
5. 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](https://developer.fortnox.se/general/authentication/).
### 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](LICENSE) file for details.