> ## Documentation Index
> Fetch the complete documentation index at: https://control-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Fortnox

> Authorize Control to read accounting data from a Fortnox company.

export const ControlAppLink = ({path, breadcrumb, children}) => {
  const link = <a href={`https://app.control.dev${path}`} target="_blank" rel="noopener noreferrer" aria-label={breadcrumb ? `Open ${breadcrumb} in Control` : undefined}>
      {children}
    </a>;
  return breadcrumb ? <Tooltip tip={breadcrumb}>{link}</Tooltip> : link;
};

Fortnox connects to Control through OAuth. The person authorizing the connection must be able to select the intended
Fortnox company and approve the requested accounting permissions.

## Connect in Control

1. Open <ControlAppLink path="/entities-data-sources/overview"><strong>Entities & sources</strong></ControlAppLink>.
2. Open the intended entity, choose **Add data source**, and select **Fortnox**.
3. Give the data source a recognizable name.
4. Choose **Connect Fortnox**.
5. Sign in to Fortnox, select the intended company, and approve Control's access.
6. Return to Control and confirm that the data source shows as connected.

Access and refresh tokens are stored securely and refreshed automatically.

## Permissions requested

Control requests these Fortnox OAuth scopes because the connector reads the corresponding resources:

| Scope                | Resources read by Control               |
| -------------------- | --------------------------------------- |
| `bookkeeping`        | Accounts, financial years, and vouchers |
| `invoice`            | Sales invoices                          |
| `supplierinvoice`    | Supplier invoices                       |
| `payment`            | Customer and supplier invoice payments  |
| `costcenter`         | Cost centers                            |
| `project`            | Projects                                |
| `companyinformation` | Company information                     |
| `settings`           | Locked accounting period                |

<Warning>
  Fortnox scopes cannot be limited to read-only access: each granted scope technically permits both reading and writing.
  Control only sends read requests to these resources. Do not grant any additional scopes.
</Warning>

The Fortnox company must have the relevant product licenses. Adding scopes later requires reconnecting the data source
so Fortnox can issue a new authorization.

## Data imported

* Financial years and chart of accounts
* General-ledger vouchers
* Cost centers and projects
* Sales invoices and customer invoice payments
* Supplier invoices and supplier invoice payments

## Common problems

* **The wrong company was connected:** reconnect the data source and select the company that belongs to the Control entity.
* **Authorization is denied:** ask a Fortnox administrator to confirm that your user can approve integrations and the requested scopes.
* **The connection stopped working:** the authorization may have been revoked in Fortnox. Reconnect the data source in Control.

## Provider documentation

* [Fortnox authorization](https://www.fortnox.se/developer/authorization/get-authorization-code)
* [Fortnox scope and license reference](https://www.fortnox.se/developer/guides-and-good-to-know/scopes)
* [Fortnox API documentation](https://api.fortnox.se/apidocs)