# Spiris — Accounting API: connection

> Canonical URL: https://developers.apideck.com/apis/accounting/spiris/connection

# How to connect to Spiris

Connecting takes about a minute and there is nothing to copy and paste: no API key, no client id,
no company id to look up beforehand. You sign in with your normal Visma Online login, pick the
company you want to share, and approve the access being requested.

## One product, several names

You will see more than one brand during the connection, and all of them are expected:

| What you see | What it is |
|---|---|
| **Spiris** | The company behind the product, previously named Visma Spcs. |
| **Bokföring & Fakturering** | The product name in Sweden (previously Visma eEkonomi). |
| **eAccounting** | The same product, sold under this name in Norway and the Netherlands. |
| **Visma Online** | The sign-in service you authenticate with, at `identity.vismaonline.com`. |

The rename did not change anything about existing accounts, logins or subscriptions. If your
product is called Bokföring & Fakturering and the connector is called Spiris, you are in the right
place.

## Prerequisites

- An **active Bokföring & Fakturering** (Sweden) or **eAccounting** (Norway, the Netherlands)
  subscription.
- A **Visma Online** login with access to the company you want to connect.

Spiris does not document a minimum role for this authorization. In practice this step is often
completed by an accounting office on the client's behalf.

If your login opens more than one company, decide up front which one you are connecting. You pick
it during the authorization, and each company needs its own connection.

## Steps

1. Open the integration settings in the application you are connecting from and start the
   **Spiris** connection. This opens Apideck Vault.
2. Click **Authorize**. Vault sends you to the Visma Online sign-in page.
3. **Sign in** with your Visma Online email and password, and complete two-factor verification if
   your account uses it.
4. **Select the company** you want to grant access to. This is the step to slow down on. The list
   shows the companies your Visma Online login can open, and the one you pick here is the only
   company the connection will ever read or write. Pick the company that holds the data you want to
   sync, and make sure it is one with an active Bokföring & Fakturering or eAccounting
   subscription: the list is not filtered by subscription, so a company without one can appear
   here. If you are already signed in to Visma Online, this screen may be skipped and your existing
   session's company reused: see [Troubleshooting](#you-selected-the-wrong-company) if that is not
   the company you want.
5. Review the access being requested and **approve** it. Spiris asks for permission to read and
   write your sales data (invoices, customers), purchase data (supplier invoices) and accounting
   data (vouchers, accounts), and to keep the connection authorized so it does not have to ask you
   again every hour.
6. You land back in Vault and the connection shows as **Connected**. You are done.

There are no fields to fill in afterwards. Everything the connection needs, including which company
it points at, comes from the authorization you just completed.

## Notes

- **No periodic action is needed.** The access token Spiris issues is valid for 60 minutes and
  Apideck refreshes it automatically in the background.
- **One connection per company.** To sync a second company, create a second connection and select
  that company when you authorize.
- **The consent screen shows the name registered on the application's Spiris credentials**, which
  may be the name of the application you are connecting from, or "Apideck". Either is expected.
- **Changing your Visma Online password ends the connection immediately.** Spiris invalidates the
  stored authorization the moment the password changes, and gives no warning: the connection keeps
  looking healthy until the next sync fails. When you change or reset that password, open the
  connection in Vault and authorize again with the new password, selecting the same company.
- **You can revoke access from Visma Online at any time.** The connection then stops working.
  Authorize again from Vault when you want to restore it.

## Troubleshooting

### You selected the wrong company

Disconnect the connection in Vault and authorize again, then pick the correct company. If Visma
goes straight through without showing the company picker, sign out of Visma Online first (or use
the account switcher on the sign-in screen) so the picker reappears instead of reusing your
previous choice.

### The connection was working and suddenly stopped

Check whether the Visma Online password on the account that authorized the connection was changed
or reset recently. That is the most common cause. Open the connection in Vault, authorize again
with the new password, and select the same company. Nothing else needs to be reset.

### The company you need is not in the list

The picker lists the companies your Visma Online login can open, so a company you cannot open with
that login will not appear. Sign in with a login that has access to it, or ask whoever administers
your Visma Online account (or your accounting office) to give you access or to complete the
connection for you, then start the connection again.

### You connected a company without an active subscription

Because the picker is not filtered by subscription, a company with no active Bokföring &
Fakturering or eAccounting subscription can be selected: the authorization still succeeds, and the
problem only shows up afterwards when the connection cannot read or write any data. Confirm that
the company you selected has an active subscription. If it does not, disconnect the connection and
authorize again with a company that does, or get the subscription activated first.

### Sign-in fails, or the browser never returns to Apideck

If you see an error mentioning the redirect or the page stalls on the Visma screen, this is a
configuration issue on the application side rather than something you can fix from your account.
Report it to the team whose application you are connecting from.

### "Access denied" straight after approving

The approval was not completed, or the login you used cannot reach the company you selected. Try
again, click all the way through the approval screen, and make sure you are signed in with a login
that can open that company in Visma Online.

### Still stuck

For anything about your Visma Online login, your subscription or your company access, contact
Spiris support through your Bokföring & Fakturering or eAccounting account. For anything on the
Apideck side of the connection, contact
[Apideck Support](https://help.apideck.com/en/articles/7774658).

## Reference

- [Spiris/eAccounting API documentation](https://developer.vismaonline.com/docs/spiris-eaccounting-api-documentation):
  the vendor's public documentation for the API behind this connection.
- [Spiris name change announcement](https://developer.vismaonline.com/changelog/weve-changed-our-name-visma-spcs-is-now-spiris):
  the vendor's own note on Visma Spcs becoming Spiris.


[API reference](https://developers.apideck.com/apis/accounting/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/accounting/coverage)