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

Open the integration settings in the application you are connecting from and start the Spiris connection. This opens Apideck Vault.
Click Authorize. Vault sends you to the Visma Online sign-in page.
Sign in with your Visma Online email and password, and complete two-factor verification if your account uses it.
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 if that is not the company you want.
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.
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.

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.

Reference

Spiris/eAccounting API documentation: the vendor's public documentation for the API behind this connection.
Spiris name change announcement: the vendor's own note on Visma Spcs becoming Spiris.