Join us at Fortnox App Market today!

Developer Portal

Developers Integration Dictionary

During the process of creating your integration you will bump into these words and functions.

Developer Portal

In the developer portal, you have the possibility to create your own apps that customers can add to their companies in Fortnox. This requires you to have a developer license in Fortnox and to have a user set up with the correct permissions.

The developer license is added to your account by Fortnox.

If you are already registered as a developer you must be migrated to the new system towards a live company in Fortnox. If you do not have a live company in Fortnox before, this happens automatically when we create a company for you.

All new registrations get this feature.

To reach the portal, please select Menu – Developer Portal.

 

My Apps

An App is an integration that customers can use to connect your system to Fortnox.

The App has a Client-Id and a Client-Secret that is used in the connection process.

To create an app, click on “Create new app”.

 

Create app

When you create your App, you must enter a name and select the scopes that the app should have access to.

Once the app is created, you can set information such as contact, routes, price for your connection and link customers to your own website.

 

Image management

You can add a logo, app icon, cover images and information about your App so that customers can easily get an idea of what the App offers.

You add an image by clicking on the field or dragging the image there.

Then place the selection as desired and press Ok.

To delete an uploaded image, there is a cross in the image field when you hold the mouse over it.

 

Buy via Fortnox / Buy via Website

If you choose Buy via Website, we will send the customer to your website from Fortnox’s marketplace.
If you want Fortnox to handle invoicing of the app, you can choose the option Buy via Fortnox. The customer can then buy the app directly in the Fortnox marketplace and Fortnox handles the invoicing. Information about sales and sales data can be found under the Sales tab in the developer portal.

 

Price / Price per month

If you choose Buy via Fortnox, the price is automatically set for monthly payment per user.
With the option Buy via Website, you can specify price as free text.
Example: “SEK 100 / month and SEK 50 per new user.”

 

Only one license / One license per user

If your system supports more than one user, you can select this option. The customer can then buy your app several times and in this way connect this to more users in Fortnox.

 

Link to user agreement

Here you link the user agreement that the customer must approve if they buy your app.

 

Link to Read more

Here you link to your website where you describe more about the connection between your system and Fortnox.

 

Redirect URI

This is the link to the landing page to get your App connected to the customer’s Fortnox account. This is where the customer can buy or activate your system and get more information about your connection. The redirect URI is also used as the callback URI during the authorization code flow.

 

Start page

When customers activate your App, they come here. Here you can guide customers on to, for example, registration or login.

 

Link to launch the app in Fortnox

The link is used to launch an app on the My Apps page in Fortnox. The page shows the user’s activated apps, here you click on “Go to the app” to launch the app.

 

Select scopes

Scope is a mechanism to limit an App’s access to a customer’s Fortnox account. An App can request one or more scopes, and the access token issued to the application will be limited to those scopes.

You can change scopes on an active connection but this does not affect already activated customers.

The connection to the customer retains the scopes your App had when the customer activated it.

To gain access to the new scopes, the customer needs to reactivate your App.

 

Category

Here you choose under which category you want your App to be seen in the App Market. Only one choice can be made but you can change this in the future.

 

Publish app

Here you can decide if you want to publish your App so that it becomes available on App Market.

When the App is created but still hidden, customers can use your Client ID to find the App in Fortnox. This is preferable for private integrations that are not published in the App Market.

When you want to publish your App, select “Requesting publication:” with your choice and press Save. You must approve the Fortnox app partner agreement to have your app published. Fortnox will contact you and guide you through the review process required to become an app partner to Fortnox.

 

My sandboxes

We provide test environments (sandboxes) to test your code in a secure environment before connecting with your live customers.

You can create up to 30 test environments simultaneously for testing and demo purposes.

You can create and remove test environments in the developer portal.

The user in the test database is created with the same email address as the user who creates the sandbox in the developer portal.

You administer the test environments just like a regular company in Fortnox.

 

Statistics

On the statistics page, you see the number of activations an app has within different time intervals. You can also switch between all apps in this view.

 

Sale

The sales page shows information about the apps that are invoiced by Fortnox. Here you will also find information about sales data.