> ## 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.

# Fortnox

> Swedish bookkeeping, sales and supplier invoices, offers and orders, prices, time and warehouse from Fortnox, plus guardrailed creation and bookkeeping with a preview before every change, directly from your AI.

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

The Fortnox connector gives your AI access to a Swedish company's finances in
Fortnox: financial years, the chart of accounts with the year's balances, vouchers,
sales and supplier invoices, the customer, supplier and article registers, projects
and cost centres (kostnadsställen), offers and orders, price lists, exchange rates,
time registrations and the warehouse. It can also create and edit master data,
offers, orders and draft invoices, create vouchers, bookkeep invoices and register
purchase orders and goods receipts, always behind a preview that you must confirm.
You approve the access by logging in to Fortnox, and your AI never sees the access
itself.

> [!NOTE]
>
> **Read + guardrailed write.** 32 tools only read. The 28 write tools change
> nothing in Fortnox without an explicit confirmation (`confirm: true`). Without
> it, you only get a preview. Nothing is ever sent to customers or suppliers (no
> e-mail, print or payment), and suppliers' bank details cannot be changed. An
> administrator can set the individual user to **Read only**. See
> [Actions & guardrails](https://docs.consile.ai/en/essentials/actions-and-guardrails.md).

> [card] Access
>
> Read + guardrailed write. Read only can be chosen per user

> [card] Authentication
>
> Login in Fortnox (OAuth)

> [card] Hosting
>
> Hosted in the EU · Frankfurt

* **Price:** 299 DKK/month excl. VAT (€39/month if you have chosen the EU · EUR
  market in the portal). No lock-in, cancel at any time. The price covers 1 user
  and 1 Fortnox company. Each extra user and each extra company costs 149.50
  DKK/month excl. VAT. See [Pricing](https://docs.consile.ai/en/portal/pricing.md). Fortnox is also included
  in [the Consile Studio membership](https://docs.consile.ai/en/portal/membership.md) and
  [the free edition](https://docs.consile.ai/en/portal/free-edition.md).
* **One company per connection:** the access is bound to the Fortnox company you
  logged in to. An accounting firm connects one agreement per client. Each extra
  agreement gets its own address, for example
  `https://mcp.consile.ai/fortnox-2/mcp`. See
  [Multiple companies](https://docs.consile.ai/en/connect/connect-fortnox.md#multiple-companies).
* **Endpoint:** `https://mcp.consile.ai/fortnox/mcp` (your own named connector in
  your AI).

## Prerequisites

**1. Subscription**

An administrator buys the connector in the [portal](https://app.consile.ai). See
[Buy a connector](https://docs.consile.ai/en/portal/buy-a-connector.md).

**2. Your AI connected**

See [Connect Claude](https://docs.consile.ai/en/connect/connect-claude.md) or
[Connect ChatGPT](https://docs.consile.ai/en/connect/connect-chatgpt.md).

**3. Fortnox licences**

The company needs Fortnox's Integration licence and the modules the data lives
in: for example Bokföring and Fakturering, and Offert & Order, Lager or
Tidredovisning for those areas. If the company lacks a licence, your AI gets an
explanatory message when it asks for data from that area. Reconnecting does not
help; the licence must be in place in Fortnox.

**4. Fortnox connected**

The first time, the access must be approved by a system administrator in
Fortnox. See [Connect Fortnox](https://docs.consile.ai/en/connect/connect-fortnox.md).

**5. Access for each user**

Whoever buys Fortnox automatically gets the included access. If more colleagues
need Fortnox in their AI, an administrator gives them access on the person's
page under **Team** and chooses their access level at the same time (see
[Access level per user](#access-level-per-user)). Each extra user costs 149.50
DKK/month excl. VAT. If you have
[the Consile Studio membership](https://docs.consile.ai/en/portal/membership.md), an administrator
instead gives one membership licence per person, and it also covers Fortnox. See
[Team](https://docs.consile.ai/en/portal/team.md).

> [!NOTE]
>
> **Were you a customer before 2026-11-08?** If your organization has a membership
> or a free edition from before Fortnox became public, Fortnox's tools are switched
> off until an administrator switches them on under [Tools](https://docs.consile.ai/en/portal/tools.md). New
> customers get both the read and the write tools switched on from the start.

## What can it do? (tools)

You do not need to know the tool names. You ask in natural language, and your AI
picks and calls the right tool itself. Each tool is called `fortnox__<tool>` (for
example `fortnox__list_invoices`); in the tables below the names are shown without
the prefix.

The connector provides 60 tools in total: 32 read-only and 28 guardrailed write
tools. A user on **Read only** only gets the 32.

### Reading (32 read-only)

**Company & bookkeeping**

| Tool | What it does |
| - | - |
| `get_company` | The connected company: name, organisation number, address and Fortnox database number |
| `list_financial_years` | Financial years (räkenskapsår) with id, period and accounting method |
| `list_accounts` | Chart of accounts (BAS) for a financial year with opening and closing balance per account |
| `get_account` | One account with VAT code, SRU code, dimension rules and the year's balances |
| `list_voucher_series` | Voucher series with description and next number |
| `list_vouchers` | Vouchers in a financial year or period, and what created them |
| `get_voucher` | One voucher with its rows: account, debit, credit, cost centre and project |

**Registers**

| Tool | What it does |
| - | - |
| `list_customers` | Customer register with customer number, name, organisation number and city |
| `get_customer` | One customer's master data: addresses, contact, payment terms and default accounts |
| `list_suppliers` | Supplier register with supplier number, name and organisation number |
| `get_supplier` | One supplier's master data and payment details (IBAN and account number masked) |
| `list_articles` | Articles with sales and purchase price, stock quantity and unit |
| `list_projects` | Projects with status, dates and project leader |
| `list_cost_centers` | Cost centres (kostnadsställen) with code and description |

**Invoices**

| Tool | What it does |
| - | - |
| `list_invoices` | Sales invoices with total, unpaid balance, due date and status |
| `get_invoice` | One sales invoice with rows, VAT, OCR reference and the voucher it was booked on |
| `list_supplier_invoices` | Supplier invoices with unpaid balance, including those awaiting approval or payment |
| `get_supplier_invoice` | One supplier invoice with booking rows, vouchers and comments |

**Offers, orders & prices**

| Tool | What it does |
| - | - |
| `list_offers` | Offers (offerter) with customer, offer date, total and status, such as whether an order was created |
| `get_offer` | One offer with rows, VAT, expiry date and the order or invoice created from it |
| `list_orders` | Sales orders (ordrar) with customer, order and delivery date, total and whether an invoice was created |
| `get_order` | One sales order with rows, ordered, delivered and reserved quantities, delivery state and invoice reference |
| `list_price_lists` | Price lists with code, description and which list is pre-selected |
| `list_article_prices` | One article's prices in one price list, with quantity breaks and last change |
| `list_currencies` | Currencies with buy and sell rate, rate unit, rate date and automatic updates |

**Time & warehouse**

| Tool | What it does |
| - | - |
| `list_time_registrations` | Work time per employee, customer and project with hours to invoice (absence never shown) |
| `list_stock_balance` | Stock per article and stock point: in stock, available and reserved |
| `list_stock_points` | Stock points (lagerställen) with code, name and active status |
| `list_purchase_orders` | Purchase orders with supplier, delivery date, status, supplier response and order value |
| `get_purchase_order` | One purchase order with rows: ordered, received and remaining quantity per article |
| `list_incoming_goods` | Goods receipts (inleveranser) with supplier, delivery note and status |
| `get_incoming_goods` | One goods receipt with rows: received, back-ordered and invoiced quantity and the purchase order |

### Writing (28 guardrailed tools)

These 28 tools are the only ones that change anything in Fortnox. A call without
`confirm: true` never changes anything, but shows exactly which change would be
sent. Normally your AI shows you the preview and only calls again with
`confirm: true` once you have said yes. The **Extra lock** column shows the tools
where the confirmation must also match the preview (see
[How the guardrail works](#how-the-guardrail-works)).

**Master data**

| Tool | What it does | Extra lock |
| - | - | - |
| `create_customer` | Creates one customer with type, organisation and VAT number, contact details, address and payment terms | |
| `update_customer` | Changes selected fields of one customer and leaves the rest as is; the preview shows the current values | |
| `create_supplier` | Creates one supplier with master data, never payment details such as bankgiro or IBAN | |
| `update_supplier` | Changes one supplier's master data; payment details cannot be changed here because of the fraud risk | |
| `create_article` | Creates one article with unit, type, VAT, accounts and purchase price; the sales price is set per price list | |
| `update_article` | Changes fields of one article, never its sales price or stock quantity | |
| `set_article_price` | Sets one article's price in one price list from a given quantity; the row is created or updated | |
| `create_project` | Creates one project with status, start and end date and project leader | |
| `update_project` | Changes the description, status, dates or project leader of one project | |
| `create_cost_center` | Creates one cost centre (kostnadsställe) with code and description | |
| `update_cost_center` | Changes the description, active status or note of one cost centre | |

**Sales**

| Tool | What it does | Extra lock |
| - | - | - |
| `create_offer` | Creates an offer for a customer with up to 100 rows; nothing is sent to the customer and nothing is booked | |
| `update_offer` | Changes fields or replaces the rows of an open offer; cancelled and already converted offers are refused | When the rows are replaced |
| `create_order_from_offer` | Turns an open offer into a sales order | Yes |
| `create_order` | Creates a sales order for a customer with up to 100 rows; nothing is sent to the customer and nothing is booked | |
| `update_order` | Changes fields or replaces the rows of an open order; cancelled and invoiced orders are refused | When the rows are replaced |
| `create_invoice_from_order` | Turns an open order into a draft invoice that is neither booked nor sent | Yes |
| `create_invoice` | Creates a sales invoice as a draft that is neither booked nor sent | |
| `update_invoice` | Changes fields or replaces the rows of a draft invoice; booked and cancelled invoices and credit notes are refused | When the rows are replaced |

**Bookkeeping**

| Tool | What it does | Extra lock |
| - | - | - |
| `bookkeep_invoice` | Bookkeeps one draft invoice; afterwards it can only be credited in Fortnox | Yes, cannot be undone |
| `create_supplier_invoice` | Registers a supplier invoice that is not bookkept on creation; no payments or bank details | |
| `update_supplier_invoice` | Changes fields or replaces the booking rows of a supplier invoice that is not bookkept | When the rows are replaced |
| `bookkeep_supplier_invoice` | Bookkeeps one supplier invoice with balancing booking rows; it is not approved or paid | Yes, cannot be undone |
| `create_voucher` | Creates one voucher with debit and credit rows that must balance; it cannot be deleted in Fortnox, only reversed | Yes, cannot be undone |

**Warehouse**

| Tool | What it does | Extra lock |
| - | - | - |
| `create_purchase_order` | Creates a purchase order to one supplier in Fortnox Lager; the order is never sent to the supplier | |
| `update_purchase_order` | Changes dates, references, the delivery address and rows on an open purchase order | Yes |
| `create_incoming_goods` | Registers a goods receipt as a draft, with or without a purchase order; stock changes only when it is released | |
| `release_incoming_goods` | Releases a draft so Fortnox locks and bookkeeps it, and the goods count in the stock balance | Yes, cannot be undone |

> [card] [Building on top of it yourself? See the API reference](https://docs.consile.ai/developers/tools/fortnox.md)
>
> Full reference with all 60 tools, arguments, pagination, guardrail fields and
> errors.

## How the guardrail works

1. **All 28 write tools are dry-run by default.** A call without `confirm: true`
   never changes anything in Fortnox. You get a preview of exactly the change that
   would be sent. For updates, it also shows the current values.
2. **The change is only made with `confirm: true`.** There are no exceptions.
3. **Permanent changes must match the preview.** Vouchers, bookkeeping of sales
   and supplier invoices, release of goods receipts, conversions (offer to order,
   order to invoice) and full replacements of rows also require a check value from
   the preview. If the record has changed in Fortnox between the preview and the
   confirmation, the call is refused, and nothing is changed. It always takes two
   calls.
4. **Nothing is sent or paid.** The connector cannot send, print or e-mail
   invoices, offers or orders, and it cannot pay, approve, cancel, credit or delete
   anything. You do that yourself in Fortnox.
5. **Suppliers' bank details are locked.** Bankgiro, plusgiro, IBAN and account
   number can neither be created nor changed via the connector, because changed
   payment details are a known fraud method.
6. **An unknown outcome is stated plainly.** If a write gets no answer from
   Fortnox, the error tells your AI that the outcome is unknown and asks it to
   check in Fortnox before trying again.

> [!TIP]
>
> Read the full confirmation model, which applies across all write connectors,
> under [Actions & guardrails](https://docs.consile.ai/en/essentials/actions-and-guardrails.md). If you want
> an administrator's yes before specific writes, use
> [Approvals](https://docs.consile.ai/en/portal/approvals.md). A rule on a write tool applies to both the
> preview and the confirmation.

## Access level per user

An administrator chooses the access level for each user in the portal under
[Team](https://docs.consile.ai/en/portal/team.md): click the user's name, and for Fortnox choose between
**None**, **Read only (32)**, **Full access (60)** and **Custom**, where you choose
exactly the tools the user gets (see
[Custom access](https://docs.consile.ai/en/portal/team.md#custom-access)). The numbers count the tools the
organization has switched on.

| Level | Tools | What your AI can do |
| - | - | - |
| **Read only** | 32 | Read bookkeeping, invoices, registers, offers, orders, time and warehouse. No write tools. |
| **Full access** (default) | 60 | Everything above plus the 28 guardrailed write tools. |

* Both levels cost the same.
* If a user is on **Read only**, Consile blocks all write operations on the server
  for that user: the write tools do not show in the user's AI, and a call to them
  is refused without anything being changed.
* The connection to Fortnox belongs to the company, so colleagues with **Full
  access** can still write.

## Try asking

> [accordion] Liquidity
>
> > *"Which sales invoices are overdue right now, and how much do they add up to?"*
>
> > *"Show the supplier invoices awaiting approval or payment, sorted by due date."*

> [accordion] Bookkeeping
>
> > *"What is on voucher A 214 in the current financial year, and which accounts does it touch?"*
>
> > *"Show the closing balance on account 1930 for last financial year."*

> [accordion] Sales & warehouse
>
> > *"Which offers from last month have not become an order yet?"*
>
> > *"Which articles have fewer than 10 pieces available in stock?"*

> [accordion] Create & bookkeep (guardrailed)
>
> > *"Make a draft invoice for customer 1005 with two rows. Show it to me first."*
>
> > *"Create a voucher that moves 5,000 SEK from account 6110 to 6250."* (you get a preview and must confirm)

> [!TIP]
>
> Accounts, balances and vouchers exist per financial year in Fortnox. Feel free to
> mention the year in the question. Your AI looks up the year's id itself with
> `list_financial_years`.

## Limitations

* **Writing is guardrailed, not unrestricted.** The 28 write tools only work behind
  the confirmation lock above. The guardrail consists of safe defaults in the
  connector and is not an absolute guarantee.
* **Booked is booked.** Vouchers, bookkept invoices and released goods receipts
  cannot be undone in Fortnox. An error is corrected with a reversing voucher or a
  credit note, which you make in Fortnox.
* **Amounts and currency.** The bookkeeping is in the company's accounting currency
  (SEK). Invoices are shown in their own currency.
* **No period balances.** Fortnox gives the year's opening and closing balance per
  account. Your AI calculates figures for a single month from the voucher rows.
* **Time registration is work time only.** Absence such as vacation and sick leave
  is never shown, and time registrations cannot be created via the connector.
* **Personal data is minimised.** If a customer is a private person or a sole
  trader (enskild firma), the organisation and VAT number are not shown, because it
  is a personal identity number (personnummer). A supplier's IBAN and account
  number are only shown with the last four characters.
* **Fortnox's call limit.** Fortnox allows a limited number of calls per few
  seconds per company, and the limit is shared by all users of the same company. If your AI
  hits it, it is told to wait a little.
* **No stored data.** Everything is fetched and written live when you ask. Consile
  stores no accounting data.

Is something not working as expected? See [Troubleshooting](https://docs.consile.ai/en/troubleshooting.md).


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