Integration Fortnox 3 Accounts with OpenCart Ver 3.0.3.x

About Fortnox is Sweden's leading supplier of internet-based programs for companies, associations and accounting and auditing firms. The business side is to offer a wide range of Internet-based programs that are easy to learn and use, yet powerful and feature-rich enough to meet most needs and wants. Introduction to the module Fortnox 3 is a module for integration between OpenCart and the business system Fortnox. To use this integration, it is required that you have an account with Fortnox. The data you need to activate the connection are API code (Authorization Code) and Client Secret (Client-Secret).

Functions:

1. Multistore (separate API connections and settings per store)
2. Create orders and customers
3. Create articles (if these are not already posted at Fortnox)
4. Create invoices
5. Create an invoice directly from an existing order in Fortknox
6. Generate and display a PDF invoice
7. Email/Send a PDF invoice directly to the customer
8. Cancel an order or invoice directly from OpenCart
9. Send a reminder on an invoice
10. Post an invoice
11. Feedback (register changes made directly in Fortnox)
12. Built-in event log that logs events/error messages
13. Separate work modes for orders and invoices

Included language files:

1. English language file
2. Swedish language file

How to install and activate the Fortnox 3 integration:

Here you find Fortnox 3 the integration after installation You can find Fortnox 3 under Add-ons->Modules from the menu in OpenCart admin. vqmod This module uses vqmod to create a shortcut directly to the work mode located under Sales->Fortnox 3 in the menu.

1. Upload the contents of the Upload folder to your OpenCart root (no files should be overwritten).

2. From the backend: Go to "System->Users->Usergroups". Press [Change] on Top Administrator.

3. Tick all the check boxes in both lists and then press Save.

4. Activate the module and activate the API connection From the admin menu, go to "Add-ons->Modules".

1. a. Install the Fortnox 3 module by clicking [Install]
2. b. Click [Change] to enter the settings form
3. c. Select Status: Enabled from the drop-down list (for selected store)
4. d. Enter API code and Client secret (as you received from Fortnox)
5. e. Press the [Generate Token] button
6. f. A Token will now be filled in the Token field
7. g. Press the [Apply] button to save settings.

Important: An API code can only be used once to generate a token, then it is spent. This means that if you run Multistore and need to activate one of your other hosted OpenCart stores, you must either:
a. Create a separate API connection for each of your stores in Fortnox.
b. Copy only the Token and Client Secret from your existing connection.

5. Continue to configure the module

1. a. Send prices incl. VAT: Select: No (most common)
2. b. Press the button [Get company-specific data] Now the list boxes below must be filled with list values ​​downloaded from Fortnox. It is optional to fill in these. If you choose not to enter these values, what is specified in Fortnox's settings will apply.
3. c. Now select the (General) tab
4. d. The settings you find below are optional to fill in and pretty self-explanatory. I will only explain the most important ones here.
5. e. Marginal VAT: The functions Gift cards and Discount coupons in OpenCart do not have built-in VAT management. This setting fixes this and calculates VAT backwards.
6. f. Send with VAT: The absolute most common is that you choose no here. The VAT is usually set via an accounting plan.
7. g. Sales accounts: You can enter these details if you want, usually you don't need it.
8. h. Feedback: When you change the status of an order or invoice directly in Fortnox, you can control whether you want it to take effect in OpenCart. This check is performed every time the settings form is loaded.
9. i. Filter orders by order status: Choose which orders should be visible under the (Orders) tab. By using this setting, you can e.g. control so that already sent orders disappear from the list.
10. j. Filter invoices by order status: Same as above but applies to invoices.
11. k. Cut-off date: Orders placed before the entered date will not be possible to ship.
12. l. Order status: With these settings, you can change the order status of an order when a certain event has been performed. An entry is also created in the order history about what was carried out, for maximum traceability.

[back to top]

API Settings Fortnox:

Screenshot of the API settings form this is what the settings form looks like the first time you use the module. In this mode, you must fill in the API code and Client secret to continue the configuration.

1. Navigate to Extension -> Fortnox 3.
2. Navigate to the API Tab tab.

General Tab Fortnox:

Screenshot of the settings form under the General tab Here's what it might look like after you've set up the form.

1. Navigate to Extension -> Fortnox 3.
2. Navigate to the General Tab tab.

Start working with the Fortnox 3 module

Now you have filled in all the settings and are ready to start working with the integration. Send as well as customer to Fortnox

1. Navigate to Sales->Fortnox 3 (in the menu)

2. Go to the (Orders) tab

3. Click on the [Order] button for the order you want to send.

4. The order will now be sent and supplemented with extra information such as:

1. a. Fortnox order number
2. b. Created/Changed date/time
3. c. Order status d. Status In connection with orders being created at Fortnox, customer/product(s) can also be created. This depends on how you have set up the module.

The different functions of the main buttons

1. [About] Displays a dialog box with brief information about the module and copyright-related information.

2. [Admin]A shortcut to Fortnox admin (opens in a new tab/window).

3. [Apply] Save settings, but stay in the module.

4. [Save] Save settings, and jump back to the list of modules.

5. [Undo] Return to the list of modules (exit the module).

Functions of the buttons under the Orders tab

1. [Order] Send order data and customer to Fortnox

2. [Invoice] Send invoice data and customer to Fortnox (the invoice now ends up under the invoices tab).

3. [Print] Generates a PDF document (Package Note/Order Confirmation).

4. [Email] Send PDF document (Package Note/Order Confirmation) directly to customer. NOTE: You do not need to press [Print] first to use this function.

5. [Cancel] Cancels the created order at Fortnox. Also marked as canceled in OpenCart

6. [Restore] Restores a canceled order in OpenCart so you can create a new order in Fortnox.

Functions of the buttons under the Invoices tab

1. [Print] Generates a PDF document (Invoice).

2. [Posted] Flags the invoice as posted with Fortnox.

3. [Email] Send PDF document (Invoice) directly to customer. NOTE: You do not need to press [Print] first to use this function.

4. [Cancel] Cancels the created invoice at Fortnox.

NOTE: [Save] and [ Apply] buttons are not displayed if you choose to go directly to the work mode from Sales->Fortnox 3 in the menu.