Troubleshoot Teamleader

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

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

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

Warning and error entries use an orange icon.

1

Open the Teamleader settings

Go to Settings → General → Software integrations.

Open Teamleader.

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 work order, customer, or setting is involved.

4

Fix the cause and retry

After you correct the issue, run Export work orders or the relevant Sync action again.

Quick checks first

Check these points before you go deeper:

• the connection is still active
• the required invoice settings are filled in
• the customer on the work order is valid
• the work order is Complete and marked Naar Teamleader with status code 1
• the Teamleader user still has the required permissions

Common error messages

Invoice relation on work order does not come from Teamleader

The customer on the work order has no Teamleader ID.

Enable Export relations or use a customer that came from Teamleader.

Invoice relation on work order not found in OutSmart

The work order points to a customer that does not exist in OutSmart.

Assign a valid customer to the work order.

Relation not found in Teamleader

The customer exists in OutSmart, but not in Teamleader.

Import the customer again or enable Export relations.

No department selected

The export settings do not contain a department.

Select a department and save the settings.

Hour type on work order not recognised

A work period uses an hour type that OutSmart cannot resolve for export.

Check the hour types on the work order and correct the missing setup.

Error creating invoice for work order

Teamleader rejected the draft invoice.

Open the full log entry for details.

Common causes are missing fields or an invalid VAT setup.

Error retrieving token, please reset the integration

OutSmart could not refresh the Teamleader token.

Disconnect the integration and connect it again.

Error retrieving webhooks

OutSmart could not register or retrieve Teamleader webhooks.

Check the Teamleader permissions and save the settings again.

Frequently asked questions

Where do I find the sync log?

Open the Teamleader settings.

The log is visible on the right side.

Is “Nothing to import” an error?

No.

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

What should I do when the connection expired?

Use the power icon to disconnect the integration.

Then connect it again through the Teamleader login page.

How do I retry a failed export?

Fix the cause first.

Then set the work status back to Naar Teamleader and export again.

A work order exported, but I cannot find the invoice

Teamleader creates the invoice as a draft.

Check the drafts section in Teamleader.

The OutSmart log also confirms successful export.

Related topics

• Teamleader
• Set up Teamleader
• Configure Teamleader exports