> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Fortnox

> Log in to Fortnox, and approve Consile for one company. The first activation requires a system administrator. The access is renewed continuously and can be revoked.

*[Læs siden på dansk](https://docs.consile.ai/connect/forbind-fortnox.md)*

You connect Fortnox by logging in to Fortnox and approving Consile for the company
your AI should work in. The result is an access that Consile stores encrypted per
customer. Your AI never sees the access itself, only answers to your questions. See
[Fortnox](https://docs.consile.ai/en/connectors/fortnox.md) for what the connector can do.

> [!NOTE]
>
> You need an active Fortnox subscription in the [portal](https://app.consile.ai),
> or Fortnox must be included in your plan
> ([the free edition](https://docs.consile.ai/en/portal/free-edition.md) or
> [the Consile Studio membership](https://docs.consile.ai/en/portal/membership.md)). The company needs
> Fortnox's Integration licence, and the first time, the access must be approved by
> a **system administrator** in Fortnox. Anyone on the team can connect an agreement
> that is not connected yet. Only an administrator can reconnect it or disconnect
> it. Your AI ([Claude](https://docs.consile.ai/en/connect/connect-claude.md) or
> [ChatGPT](https://docs.consile.ai/en/connect/connect-chatgpt.md)) can be added before or after.

## How to connect

**1. Open the connector in the portal**

Open the Fortnox connector in the portal. Click **Connect now** at the top of
the page, or **Connect** next to the agreement on the **Connections** card. The
portal calls each connection to the system an agreement. If you have not
accepted Consile's terms yet, you are asked to do so first.

**2. Authorise access**

The portal shows the permissions Consile asks Fortnox for (see
[What exactly am I approving?](#what-exactly-am-i-approving)). Click
**Authorise access**. You are sent to Fortnox's login.

**3. Log in and choose the company**

Log in with your Fortnox user. If you have access to several companies, for
example as an accounting firm, choose the client the agreement should apply to.
The access is bound to exactly that company.

**4. Confirm at Fortnox**

Fortnox shows what Consile is asking for access to. Confirm to continue. You
are then sent back to the portal.

> [!TIP]
>
> The portal shows that Fortnox is connected, and the agreement shows as
> **Connected**. The agreement gets the company's name and organisation number.
> If you have not already added the address
> `https://mcp.consile.ai/fortnox/mcp` in your AI, do it now.

> [!TIP]
>
> The connection is shared by the whole company, so colleagues do not have to
> connect Fortnox again. An administrator gives them access under **Team**, and each
> colleague adds the address in their own AI and logs in with their own Consile
> login. See [Team](https://docs.consile.ai/en/portal/team.md).

## What exactly am I approving?

Consile asks for exactly fifteen permissions in Fortnox: `companyinformation`,
`bookkeeping`, `customer`, `supplier`, `article`, `invoice`, `supplierinvoice`,
`project`, `costcenter`, `currency`, `offer`, `order`, `price`, `timereporting` and
`warehouse`.

> [card] Read and write, with confirmation
>
> Fortnox has no pure read permission: each permission covers both reading and
> writing. Consile only changes something when a write tool is confirmed with
> `confirm: true`, and an administrator can set users to **Read only**. See
> [Fortnox](https://docs.consile.ai/en/connectors/fortnox.md#how-the-guardrail-works).

> [card] Only the fifteen
>
> Consile does not ask for payments, settings or payroll. If the approval contains
> permissions other than the fifteen, or one is missing, the connection is
> refused.

> [card] Encrypted per customer
>
> The access is stored encrypted with a key that applies only to your account,
> and is never logged. It is renewed automatically in the background.

> [card] Your AI never sees it
>
> Your AI is never given the access itself. It only receives answers to your
> questions.

> [!NOTE]
>
> **Licences and modules.** The permissions only work for the parts of Fortnox the
> company has a licence for. Offers and orders require Offert & Order, the
> warehouse requires Lager, and time registration requires Tidredovisning. If a
> module is missing, your AI gets an explanatory message when it asks for that
> data. Reconnecting does not help. If the connection cannot be completed at all,
> write to [support@consile.dk](mailto:support@consile.dk).

## If the connection fails

If the approval does not succeed, the portal shows **Connection was not
completed** and a technical reason. The most common ones:

* `token_exchange_failed`: Fortnox did not send back a valid approval, typically
  because you cancelled at Fortnox. Try again, and approve the access.
* `unexpected_scope`: the approval did not contain exactly the fifteen permissions
  Consile asks for. Try again.
* `state_expired`, `invalid_state` or `state_unknown_or_consumed`: more than 10
  minutes passed, or the same approval was used twice (for example with the
  browser's back button). Start over in the portal.

Click **Try again** to get back to the connector's page, and start over with
**Connect now** or **Connect**. If that does not help, write to
[support@consile.dk](mailto:support@consile.dk) and include the technical reason.

## Multiple companies

One agreement covers one Fortnox company. If your AI should work in several
companies, for example an accounting firm's clients, you add one agreement per
company:

**1. Add an agreement**

Open the Fortnox connector in the portal. On the **Connections** card, an
administrator clicks **Add agreement (149.50 kr/mo.)**. The agreement is added
to the existing subscription and charged pro rata for the rest of the period.

**2. Connect the agreement**

When the new agreement is ready (typically after a few seconds), click
**Connect** next to it and complete the steps above. Choose the company the
agreement should apply to when you log in to Fortnox.

**3. Add the address in your AI**

Each agreement has its own address, for example
`https://mcp.consile.ai/fortnox-2/mcp`. Copy it from the card, and add it as an
extra connector in your AI.

Under [the Consile Studio membership](https://docs.consile.ai/en/portal/membership.md#one-more-agreement-in-a-system)
there is no button to add an agreement. Instead the card says *The membership
covers this system. One more company costs full price under the membership, and we
will set it up for you if you write to us.*

An administrator removes an agreement with the menu next to it: choose **Remove
the agreement**, and confirm with **Remove agreement**. After you have removed an
agreement, the last agreement may have got a new address (for example
`https://mcp.consile.ai/fortnox-2/mcp` instead of
`https://mcp.consile.ai/fortnox-3/mcp`). Check the addresses on the
**Connections** card, and update them in your AI. You remove the last agreement by
cancelling the subscription under **Subscription**.

## The access is renewed, but the connection can stop

Consile renews the access automatically, so you do not have to reconnect in normal
use.

> [!WARNING]
>
> If someone removes Consile under the integrations in Fortnox, or the renewal
> fails, your AI is told that the connection must be set up again from the Consile
> portal. The portal can still show **Connected**, because the stored access is
> still there.

This is how an administrator reconnects:

* If the agreement says **Access revoked**, click **Reconnect**, and follow the
  steps above.
* Otherwise: click the menu (the three dots) next to the agreement on the
  **Connections** card, choose **Disconnect**, and confirm with **Disconnect**.
  Then click **Connect**, and follow the steps above.
* You can also ask your AI for a new connection link. Ask in the connector that
  belongs to the agreement (for example `fortnox-2`), so the link connects exactly
  that agreement.

> [!NOTE]
>
> If your AI is instead told that the company lacks a licence, or that the user
> lacks a right, reconnecting does not help. Ask your Fortnox administrator to give
> access in Fortnox.

## Revoke access

You can remove the access again at any time:

* **In the portal:** an administrator clicks the menu next to the agreement on the
  **Connections** card, chooses **Disconnect** and confirms with **Disconnect**.
  The stored access is deleted at Consile right away. The subscription continues
  until an administrator cancels it under **Subscription**.
* **In Fortnox:** when you disconnect in the portal, Consile does not revoke the
  approval at Fortnox. If you also want to remove it there, an administrator does
  so under the integrations in Fortnox (Hantera integrationer). After that, the
  connector stops working in any case.
* **When the subscription ends:** if you cancel Fortnox under **Subscription**,
  Consile automatically deletes the stored access when the subscription ends.

More about data processing in [Security & data](https://docs.consile.ai/en/essentials/security-and-data.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.