Troubleshoot Yuki

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

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

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

1

Open the Yuki settings

Go to Settings → General → Software integrations.

Open Yuki.

2

Review the log panel

Check the log panel on the right side.

Look at the latest entries first.

3

Open the error details

If a log entry shows an orange error icon, open it.

Use the full message to find the exact cause.

4

Fix the source issue

Correct the settings, item data, hour type, or work order data.

5

Reset and retry

If a work order moved to Error, change the work status back to Naar Yuki.

Then run Export work orders again.

Quick checks first

Check these points before you go deeper:

• the API key is still valid
• the correct administration is selected
• the default general ledger account exists in Yuki
• the work order has materials or hours
• every material has a code
• every used hour type exists in OutSmart
• the invoice or work order has a valid customer

Common error messages

API key not valid

The saved API key is wrong or no longer active.

Enter the correct API key again.

If needed, generate a new key in Yuki.

Work order has no materials or hours to invoice

The work order does not contain invoice lines.

Add at least one material or work period.

Then export again.

Material has no code

A material on the work order is missing its product code.

Open the material in OutSmart and add the code.

Hour type not found

A work period uses an hour type that cannot be found.

Check the hour type setup in OutSmart.

Relation on invoice not found

The invoice or work order customer cannot be resolved.

Make sure a valid customer is linked.

Import the customer from Yuki first if needed.

Error invoicing work order

Yuki returned an error while creating the invoice.

Open the log entry for the full message.

Common causes are missing contact data or a wrong general ledger account.

Frequently asked questions

The log says Nothing to import. Is that an error?

No.

The sync completed successfully, but there was no new or changed data to import.

My API key changed. How do I update it?

Open the Yuki settings.

Enter the new API key on the login screen and submit it.

A work order exported, but I cannot find the invoice in Yuki.

If you selected Draft, check Yuki's send queue.

If you selected Process immediately, check the processed invoices in Yuki.

Also review the OutSmart log for the confirmation message.

How do I retry a work order that moved to Error?

Fix the cause first.

Then change the work status back to Naar Yuki and export again.

Related topics

• Yuki
• Set up Yuki
• Configure Yuki exports