Troubleshoot King

Review the log and fix common King connection, import, and export errors.

Use the log in the King settings to review imports, exports, and errors.

Each log entry shows when the sync ran and what happened.

Click a log entry with the orange error icon to open the full details.

1

Open the King settings

Go to Settings → Software integrations.

Open King.

2

Open the log

Review the log panel on the right side.

Then open the latest warning or error entry.

3

Read the full message

Use the full error details to find the exact cause.

Check which record or setting is involved.

4

Fix the cause and retry

After you correct the issue, run the relevant sync or export again.

Quick checks first

Check these points before you go deeper:

• the API token is still valid
• the selected administration is correct
• the King API is available
• materials exist in King as articles
• hour types exist in King as rates
• a default warehouse is set when you export materials
• the work order has the correct export status

Common error messages

Relations not imported due to missing fields

One or more debtors in King are missing required fields such as name or address.

Check the error details for the debtor number and complete the missing fields in King.

Materials not imported due to missing fields

One or more articles in King are missing required fields.

Check the error details for the article code and complete the missing fields in King.

Hour types not imported due to missing fields

One or more rates in King are missing required fields.

Check the error details for the rate code and complete the missing fields in King.

Missing fields on order

A King order is missing required fields and cannot be imported as a work order.

Check the error details for the order number and complete the missing fields in King.

Error importing relations, materials, hour types, or orders

A general import error occurred.

Check the error details for the King message.

If the problem keeps returning, contact support.

Unknown hour type in OutSmart

A work order contains an hour type that does not exist in OutSmart.

Import hour types from King first, or check whether the code matches.

Unknown hour type in King

A work order contains an hour type that does not exist in King.

Make sure the hour type exists in King as a rate.

Unknown material in King

A material on the work order does not exist in King.

Make sure the material exists in King as an article.

Error creating order

OutSmart could not create the order in King.

Check the error details.

Common causes are missing required fields or an invalid warehouse code.

No warehouse code

No warehouse was found for a material line.

Set a default warehouse in the export settings.

Error approving order

The order was created in King, but automatic approval failed.

Approve the order manually in King.

Order not found in King

The work order has a linked King order number, but that order no longer exists in King.

Check whether the order was deleted in King.

If needed, remove the external order number in OutSmart and export again.

Token Invalid - Unauthorized

The API token is not valid.

Request a new token from King and update it in the integration settings.

King API service unavailable

The King API is temporarily unavailable.

Wait a moment and try again.

Frequently asked questions

Where do I find the sync log?

Open the King settings.

The log is visible on the right side.

Is “Nothing to synchronise” an error?

No.

It means the sync ran successfully, but there was no new data to process.

A work order is on error status 99. What should I do?

Check the log for the exact error.

Fix the cause, then change the work order status back and export again.

An order was deleted in King, but the work order still has the King order number. What should I do?

Remove the external order number from the work order in OutSmart.

Then export the work order again if you need a new order in King.

My API token changed. How do I update it?

Open the King settings.

Use the token refresh link in General settings.

Enter the new token and save.

Related topics

• King
• Set up King
• Configure King exports