Before you connect Fortnox to Junipeer, complete the following steps in your Fortnox account. This typically takes 20–30 minutes.
1. Create an integration user
Create a dedicated Fortnox user for the integration. Do not use a personal admin account.
The user needs the following licenses: Orders, Invoices, Accounting, Integration. Assign all required permissions.
Important: Do not modify or delete this user after setup. Changing its permissions or licenses will cause the integration to stop working.
Fortnox guide: Administrera användare →
2. Add currencies and enable automatic rate updates
Add every currency you transact in and enable automatic exchange rate updates. This ensures invoices are created with correct amounts.
If your e-commerce platform processes orders in multiple currencies, all those currencies must be enabled in Fortnox before syncing begins. If an order arrives in a currency that is not enabled, the sync will fail with a currency mismatch error.
Fortnox guide: Inställningar valuta →
3. Configure VAT rates
Set up all VAT rates for your sales markets.
Standard Swedish VAT rates (25%, 12%, 6%) are typically pre-configured in Fortnox. However, if you sell goods at non-standard rates or handle reverse charge VAT, verify those are set up as well.
Fortnox guide: Inställningar moms →
4. Set up EU OSS sales accounts
If you sell across EU markets, you need a separate sales account per country with the correct VAT mapping. Make a list of these accounts — you will need them during Junipeer configuration.
For example, sales to German consumers at 19% VAT need their own sales account, separate from sales to Dutch consumers at 21% VAT.
Pay close attention to each step in the Fortnox guide. Creating the accounting foundation (VAT rates → sales accounts → bokföringskonton) is mandatory and must be done in the correct order.
For stores selling to many EU countries, this can involve 20+ accounts. Some merchants prepare a spreadsheet first and then enter the mappings in bulk.
Fortnox guide: OSS One-Stop-Shop →
5. Add payment method accounts
Add a payment method (betalsätt) in Fortnox for each payment provider you use — e.g. Shopify Payments, Svea, Qliro, Walley, Kustom. Map each to an account number.
Payment method accounts should use a 19xx series account (interim cash equivalent), not your actual bank account. Payment provider funds are held by the provider until payout — they are not immediate bank deposits.
Fortnox guide: Betalsätt och betalningsvillkor →
6. Add required SKUs
Add the following article numbers (artikelnummer) in Fortnox. These are used for refund handling:
refund_discrepancyrefund_fee
These are needed for non-product refund rows and refund fee lines when credit notes are created.
Junipeer matches products between your e-commerce platform and Fortnox using article numbers. For the sync to work correctly:
Same SKU in both systems — if your e-commerce SKU matches the Fortnox article number exactly, no additional mapping is needed.
Different numbering — if your systems use different SKU formats, configure the mapping in Junipeer under Configure → Settings → Article.
Mismatched article numbers are one of the most common causes of sync errors.
Tips
Complete all six preparation steps before connecting to Junipeer. It is much easier to set up Fortnox correctly upfront than to fix errors after syncing has started.
If you manage multiple Fortnox companies, make sure you are logged into the correct one when authorising the OAuth connection.
Keep your payment method account numbers documented somewhere accessible — you will need them when configuring Junipeer's Payment Methods settings.
After connecting, run a test sync with a single order before enabling scheduling to verify all mappings are correct.
Once all steps above are complete, you're ready to connect Fortnox in the Junipeer app. See Fortnox — Configuration in Junipeer for the next steps.