Fortnox

Fortnox connects OCP to customer, item and order data in Fortnox. After connecting an administration with OAuth, you can use Fortnox as a source for item and customer synchronization and for retrieving orders, or as a destination for order export.

Data	Supported capabilities
Items	Synchronize articles, stock and associated files
Customers	Synchronize customers and their contact and address details
Orders	Export new orders and retrieve existing orders with their lines

Retrieving orders

Select Fortnox as the connector source in a retrieve orders flow. Order lists and individual order details are read on demand from Fortnox. Results include Fortnox document numbers, customer numbers, order dates, amounts, order lines, addresses and available contact information. List requests can be narrowed by a modification date.

Fortnox lists orders in pages of at most 500 records. OCP retrieves each listed order's details separately to include its lines; this may take longer for large pages. The requested modification date is sent to Fortnox using its minute-precision lastmodified filter.

Order import job

The Fortnox order import job can be scheduled or started manually from jobs. Its first run reads every order. Later runs fetch orders modified since the last successful run, overlapping the preceding minute so boundary updates are not missed. Imported orders are updated by document number; changes to a record do not create duplicates. Partial results never delete previously imported orders.

If an order list or detail cannot be retrieved, the entire run fails: neither the order cache nor the last successful import time is updated. The next run retries the same range. A repeatedly failing order can therefore hold up later imports; check the job failure and its logs for the document number or list offset, resolve the cause, then rerun the job.

The import job maintains a connector-owned order cache. The retrieve orders flow reads Fortnox directly and does not require the import job to have completed.