Fortnox + Ongoing
Everything you need to connect Fortnox and Ongoing: how to connect, which data moves, which settings there are and what to do when something goes wrong.
- 2 data flows
1. Getting started
Prepare both systems first, then connect them in Junipeer.
Prepare Fortnox
- Create an integration user
- Add currencies and enable automatic rate updates
- Configure VAT rates
- Set up EU OSS sales accounts
- Add payment method accounts
- Add required SKUs
- Connect Fortnox in the Junipeer platform
- about 10 minutes
Prepare Ongoing
- Open the Ongoing API access setup
- Create or confirm the dedicated API user
- Copy the API username and password
- Confirm any client or goods owner identifiers
- Paste the credentials into Junipeer
Connect and test
Enter the details in Junipeer, switch on the flows you need and test with one order before you go live.
Getting started with Junipeer
2. How the data flows
What Junipeer can move between the two systems. The arrow shows which way the data goes.
Junipeer - Orders
- Products
3. Settings
The settings you see in Junipeer, in plain words. Open one to read more. The key is the technical name.
You don't need to read them all
In Junipeer every setting has a ? that opens the same explanation next to the form, right when you need it. With the Junipeer MCP your AI assistant can also propose the settings from your own data.
How the Junipeer MCP worksSettings for Fortnox (89)
| Setting | What it controls | Key |
|---|---|---|
| Account Number for shipping | Enter the account number that shipping is booked on, on orders and invoices in Fortnox. | shipping_account_nr |
| Automatically mark Invoices as Paid | How payouts work in Junipeer Please make sure to read this Payout GUIDE . | fortnox_pay_invoice |
| Account Bank Costs | The Fortnox account where the PSP's fee (excluding tax) is booked. | bank_costs_account |
| Account Number for Currency Loss | The mirror of Currency Profit — where currency-conversion losses get booked. | currency_loss_account |
| Account Number for Currency Profit | Used when a small payment difference is caused by currency conversion and results in a profit for the merchant. | currency_profit_account |
| Account Number for Incoming Tax | Used when the payout originates outside Sweden (e.g. | incoming_tax_account |
| Account Number for Penny Rounding | Small differences between the invoice amount and what actually arrived — usually cents from rounding on the PSP side. | difference_account |
| Account Number for credit vouchers (gift cards) | Enter the account number to use for credit vouchers , such as gift cards. | credit_account_nr |
Show all 89 settings
| Setting | What it controls | Key |
|---|---|---|
| Account Number for fees | Enter the account number to book fees on. | fee_account_nr |
| Activate disabled articles | An article might exist in Fortnox but be set to inactive/disabled — perhaps it was discontinued. | fortnox_activate_disabled_products |
| Add VAT on order rows | Fortnox can handle VAT in two ways: VAT is calculated automatically by Fortnox based on the article's VAT code — no explicit row needed VAT is added as an explicit line item on the order Some account… | fortnox_add_vat_on_order_rows |
| Attribute for inbound delivery date | Choose which product attribute holds the date for the manual inbound document (inleverans) Junipeer creates in Fortnox. | fortnox_in_delivery_attribute |
| Book keep converted invoices | Here is the breakdown of possible statuses in Fortnox: Order track: Order created Order updated (Warehouse Ready / Delivered) — optional status on the order Order converted → becomes an Invoice Invoi… | fortnox_book_keep_order_invoice |
| Book keep credit invoices | When a refund is sent to Fortnox, Junipeer creates a credit invoice . | fortnox_book_keep_credit_invoice |
| Book keep invoice payment | Decide whether the invoice payments Junipeer creates from payouts should be booked (bokförda) in Fortnox. | fortnox_book_keep_invoice_payment |
| Booking Accounting Settings for Settlements | Set up how payouts from each payment provider are booked in Fortnox. | fortnox_map_settlement_accounts |
| Canceled Order Status | Choose which webshop order status(es) should cancel the order in Fortnox . | fortnox_canceled_order_status |
| Cost Center Map Order Attribute | Enter the name of the order attribute whose value decides the cost center. | fortnox_cost_center_map_order_attribute |
| Cost Center Map Order Mode | Choose what on the order decides which cost center it gets in Fortnox. | fortnox_cost_center_map_order_mode |
| Cost Centers | This setting can help you connect specific locations to Projects in Fortnox or any other Cost Center entities in ERP. | fortnox_set_order_cost_center |
| Countries to Ignore | Stop orders from certain countries from being sent to Fortnox. | fortnox_ignore_order_countries |
| Create missing articles in Fortnox | When an order comes in from your webshop, each line item references an article (product/SKU). | fortnox_create_missing_products |
| Currency Code | Choose the currency the purchase price should be taken from. | fortnox_price_currency_importart |
| Default Account Number | Enter the account number to use by default on order and invoice rows in Fortnox. | default_account_nr |
| Default Action | Choose what should happen with invoices for this customer type. | default_action |
| Default Article number used for Shipping Fee | Enter the Fortnox article number used when the shipping fee is added to the order as an order row. | fortnox_default_shipment_article_no |
| Default Cost Center | Choose the cost center (kostnadsställe) that orders get in Fortnox by default. | fortnox_order_default_cost_center |
| Default Project | Choose the project that orders get in Fortnox by default. | fortnox_order_default_project |
| Default Shipping Method | Choose the Fortnox shipping method (leveranssätt) to use when no match is found for the order's shipping method. | fortnox_default_shipping_method |
| Default Terms of Payment in Fortnox | Choose the terms of payment (betalningsvillkor) that Junipeer sets on customers in Fortnox. | fortnox_default_terms_of_payment |
| Discount Article number in Fortnox | Enter the Fortnox article number used for discounts or vouchers that apply to the whole order (not to a single product). | fortnox_order_discount_article_no |
| Exclude Orders created before this date | Choose a date. Orders created before this date are not synced. | stdintegration_filter_fortnox_order_created_date |
| Fallback Payout Reference Field | A second place to look for the payout reference, in case it isn't found in the field chosen in Payout Reference Field . | fortnox_payout_transaction_invoice_identifier_fallback |
| Fixed Quantity | Use a fixed stock quantity for new articles in Fortnox, instead of the quantity coming from the webshop. | fortnox_overide_qty_importart |
| Fortnox Billing Address Fields to update | Choose which parts of the customer's billing address may be updated in Fortnox. | fortnox_update_customer_billing_fields |
| Fortnox Customer Fields to update | Choose which customer details may be updated in Fortnox. | fortnox_update_customer_fields |
| Fortnox Shipping Address Fields to update | Choose which parts of the customer's shipping (delivery) address may be updated in Fortnox. | fortnox_update_customer_shipping_fields |
| How do you want to set the Quantity | This is helpful if you want to tick the "Lagervara" check as default in Fortnox: If you want it to be turned on, configure as follows: | fortnox_mode_set_qty_importart |
| Inbound Documents date restrictions | Make sure no manual inbound document (inleverans) is created in Fortnox before the date you choose. | fortnox_in_delivery_older_than_date |
| Map Cost Centers by Country | Give orders a cost center based on the order's country . | fortnox_country_map_cost_centers |
| Map Cost Centers by Order Attribute | Give orders a cost center based on the value of an order attribute . | fortnox_attribute_map_cost_centers |
| Map Cost Centers by Order Currency | Give orders a cost center based on the order's currency . | fortnox_currency_map_cost_centers |
| Map Cost Centers by Order Location | Give orders a cost center based on the order's location (for example a market or a shop). | fortnox_location_map_cost_centers |
| Map Cost Centers by Pricelist | Give orders a cost center based on the order's pricelist . | fortnox_pricelist_map_cost_centers |
| Map Currency with Mode of Payment | Use a different Fortnox payment method for payouts in a certain currency from this payment provider. | map_currency_to_mode_of_payment |
| Map Projects by Country | Give orders a project based on the order's country . | fortnox_country_map_projects |
| Map Projects by Order Attribute | Give orders a project based on the value of an order attribute . | fortnox_attribute_map_projects |
| Map Projects by Order Currency | Give orders a project based on the order's currency . | fortnox_currency_map_projects |
| Map Projects by Order Location | Give orders a project based on the order's location (for example a market or a shop). | fortnox_location_map_projects |
| Map Projects by Pricelist | Give orders a project based on the order's pricelist . | fortnox_pricelist_map_projects |
| Map Shipping methods | Connect the shipping methods in your webshop with the shipping methods (leveranssätt) in Fortnox. | fortnox_map_shipping_methods |
| Map Terms of Payment | Give orders different terms of payment in Fortnox depending on how the customer paid. | fortnox_map_terms_of_payments |
| Map Vat rates with Account numbers | Use a different sales account for each VAT rate . | vat_map |
| Map custom attributes | Copy information from your webshop order's custom attributes to fields or labels on the order in Fortnox. | fortnox_map_order_fields |
| Map customer delivery method with (send) invoice action | Choose an action for each delivery method a customer can have in Fortnox. | method_action_map |
| Mapping Warehouse Allocation to Stock Points | When Junipeer exports the order to Fortnox, you might want the warehouse allocation forwarded on the order lines. | fortnox_map_order_item_stock_points |
| Mapping order fields to Fortnox | The available fields Fortnox invoices carry several reference fields that Junipeer can search: Shop order ID (e.g. | fortnox_add_order_nr_fields |
| Mark order as Warehouse Ready / Delivered before creating invoice | Fortnox has a warehouse/delivery status on orders — a flag that says "this order has been picked and is ready to ship / has left the warehouse." Some Fortnox setups (especially with a WMS or warehous… | fortnox_mark_order_warehouse_ready_before_invoice |
| Match shipping methods by name | Let Junipeer find the Fortnox shipping method (leveranssätt) by its name . | fortnox_match_shipping_methods_by_name |
| Order Default Terms of Payment in Fortnox | Choose the terms of payment (betalningsvillkor) to use on orders in Fortnox. | fortnox_order_default_terms_of_payment |
| Orders types to Ignore | Stop certain types of orders from being sent to Fortnox. | fortnox_ignore_order_types |
| Override customer delivery method | Decide how invoices are sent for different types of customers, instead of always using the delivery method set on the customer in Fortnox. | fortnox_rewrite_delivery_method |
| Payment method | The payment method (betalsätt) in Fortnox that this PSP maps to. | mode_of_payment |
| Payout Reference Field | The Payout Reference Field setting tells Junipeer which field on the Fortnox invoice (or order) contains the reference used to match incoming payouts back to their invoices. | fortnox_payout_transaction_invoice_identifier |
| Project Map Order Attribute | Enter the name of the order attribute whose value decides the project. | fortnox_project_map_order_attribute |
| Project Map Order Mode | Choose what on the order decides which project it gets in Fortnox. | fortnox_project_map_order_mode |
| Refund Reference Field | Choose which Fortnox field Junipeer uses to find the original invoice for a refund. | fortnox_refund_invoice_identifier |
| Search Refund Reference on Order | Choose where in Fortnox Junipeer looks for the original purchase when a refund comes in. | fortnox_refund_search_order |
| Search for the Payout Reference on the Order | Choose where in Fortnox Junipeer looks for the payout reference. | fortnox_payout_transaction_search_order |
| Select the default Stock Point (Warehouse) | Choose the Fortnox stock point (warehouse) to use by default. | fortnox_default_stock_point_code |
| Send Invoice | Decide whether the invoice should be sent to the customer when an order is turned into an invoice. | fortnox_send_order_invoice |
| Send credit invoices | When a refund is sent to Fortnox, Junipeer creates a credit invoice . | fortnox_send_credit_invoice |
| Set Delivery State when order is created | Choose which delivery state the order gets in Fortnox when Junipeer creates it. | fortnox_order_delivery_state |
| Set Project on Orders | Decide whether orders should get a project in Fortnox. | fortnox_set_order_project |
| Set purchase price | Decide whether the purchase price should be set on the article in Fortnox when Junipeer creates it. | fortnox_set_purchase_price_importart |
| Setup Sales Account mapping | Choose which booking accounts are used on orders and invoices in Fortnox, based on rules . | fortnox_map_accounting |
| Shipping fee | Decide whether the shipping fee is added to the order in Fortnox as its own order line . | fortnox_add_shipping_on_order_rows |
| Shipping fee map | Use different Fortnox articles for the shipping fee depending on the shipping method the customer chose. | fortnox_shipment_article_no |
| Specify methods | Choose which payment methods count as paid . | fortnox_map_modes_of_payment |
| Sync Webshop Articles only | Choose which Fortnox articles are sent to your webshop. | fortnox_webshop_articles_only |
| Transform Only B2B orders | Only turn business (B2B) orders into invoices. | fortnox_transform_order_to_invoice_only_b2b |
| Transform Only Paid Orders | Only turn a new order into an invoice if the order is already paid when it is sent to Fortnox. | fortnox_transform_order_to_invoice_only_if_paid |
| Transform new orders to Invoice Setting | What does the setting do This is the master switch. | fortnox_transform_order_to_invoice |
| Update Fortnox Customers | Decide whether Junipeer should update customers in Fortnox when customers are exported. | fortnox_update_customers |
| Update customer information in Fortnox | Decide whether the customer in Fortnox should be updated each time one of their orders is sent to Fortnox. | fortnox_update_customer_when_order_is_synced |
| Use Payment ID as Payout Reference | Choose which reference from the payout Junipeer uses to find the invoice or order in Fortnox. | fortnox_payout_transaction_use_payment_id |
| VAT account for provider fees | Enter the account where VAT on payment provider fees is booked. | outgoing_tax_account |
| VAT included in order rows | This setting tries to answer a question: are the prices your webshop sends to Junipeer inclusive or exclusive of VAT? | fortnox_vat_included_order_rows_price |
| Warehouse module for Stock | The Fortnox warehouse module and stock management If your business uses the Fortnox warehouse module (lagermodul) , your integration behaves differently than a standard Shopify → Fortnox setup. | fortnox_use_warehouses |
Settings for Ongoing (2)
| Setting | What it controls | Key |
|---|---|---|
| Exclude Orders created before this date | Pick a date to skip older orders. | stdintegration_filter_ongoing_order_created_date |
| Goods owner | Choose which Ongoing goods owner this integration works with. | ongoing_goods_owner_id |
4. Troubleshooting
Choose what you see. Each case shows the cause and the solution.
MediumVAT account missing
What you see
- a tax rate on an incoming order has no corresponding VAT account in Fortnox. Add the missing account in Fortnox Settings → Bookkeeping → VAT.
Cause
See symptoms and resolution for details.
Solution
a tax rate on an incoming order has no corresponding VAT account in Fortnox. Add the missing account in Fortnox Settings → Bookkeeping → VAT.
MediumCurrency mismatch
What you see
- an order uses a currency not enabled in Fortnox. Enable it in Fortnox Settings → Currencies and retry the failed task.
Cause
See symptoms and resolution for details.
Solution
an order uses a currency not enabled in Fortnox. Enable it in Fortnox Settings → Currencies and retry the failed task.
Medium"Permission denied" errors
What you see
- the connected Fortnox user is missing one or more required permissions. Go to Fortnox Settings → Manage Users and verify the permission assignments listed in Step 1.
Cause
See symptoms and resolution for details.
Solution
the connected Fortnox user is missing one or more required permissions. Go to Fortnox Settings → Manage Users and verify the permission assignments listed in Step 1.
MediumFor troubleshooting common errors, see the Error Codes page or your connector pa
Cause
For troubleshooting common errors, see the Error Codes page or your connector pair's troubleshooting section.
Solution
Refer to the platform setup guide for resolution steps.
MediumEmpty customer name
What you see
- some e-commerce platforms allow guest checkout without a full name. Configure a default customer name in Junipeer's Customer Settings to handle these orders.
Cause
See symptoms and resolution for details.
Solution
some e-commerce platforms allow guest checkout without a full name. Configure a default customer name in Junipeer's Customer Settings to handle these orders.
Show 1 more
Medium"Article not found"
What you see
- the SKU on the incoming order does not match any Fortnox article. Create the article in Fortnox or add a mapping in Junipeer's Article settings.
Cause
See symptoms and resolution for details.
Solution
the SKU on the incoming order does not match any Fortnox article. Create the article in Fortnox or add a mapping in Junipeer's Article settings.
5. More guides
Did this page help you?