> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/integrations/integrations/topdesk/troubleshoot-topdesk.md).

# Troubleshoot TOPdesk

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

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

{% stepper %}
{% step %}

### Open the TOPdesk settings

Go to **Settings → General → Software integrations**.

Open **TOPdesk**.
{% endstep %}

{% step %}

### Check the log panel

Use the log panel on the right side of the page.

Review the latest entries first.
{% endstep %}

{% step %}

### Open the error details

Click an entry with an orange error icon.

Use the full message to find the exact cause.
{% endstep %}

{% step %}

### Fix the cause and retry

Correct the source data or settings.

Then use **Sync** to try again.
{% endstep %}
{% endstepper %}

### Quick checks first

Check these points before you go deeper:

* the operator username, application password, and domain are correct
* the processing status and sync status are not the same
* the TOPdesk account can read processing statuses and operator groups
* the linked branch has a street, postcode, and city
* the work order still has the correct external work order number

### Common error messages

<details>

<summary>Order [number] has missing fields</summary>

The linked TOPdesk branch is missing required address information.

Complete the **street**, **postcode**, and **city** in TOPdesk.

Then run the import again.

</details>

### Related topics

* [**TopDesk**](/integrations/integrations/topdesk.md)
* [**Set up TOPdesk**](/integrations/integrations/topdesk/set-up-topdesk.md)
* [**Configure TOPdesk imports**](/integrations/integrations/topdesk/configure-topdesk-imports.md)
* [**Configure TOPdesk exports**](/integrations/integrations/topdesk/configure-topdesk-exports.md)

<details>

<summary>Incorrect credentials</summary>

The operator username, application password, or domain is wrong.

Enter the correct values again in the TOPdesk login settings.

</details>

<details>

<summary>No calls returned</summary>

No TOPdesk calls match the selected processing statuses.

Check whether you selected the correct processing statuses in the import settings.

</details>

<details>

<summary>No employees imported</summary>

No TOPdesk operators were found.

This can also happen when the selected operator groups do not contain operators.

Check the operator group filter and the TOPdesk operator data.

</details>

<details>

<summary>Sync status error</summary>

The selected sync status matches one of the processing statuses.

Choose a different sync status.

</details>

<details>

<summary>Status permission error</summary>

The TOPdesk account does not have API permission to read processing statuses.

Ask your TOPdesk administrator to grant the required permission.

</details>

<details>

<summary>Operator group permission error</summary>

The TOPdesk account does not have API permission to read operator groups.

Ask your TOPdesk administrator to grant the required permission.

</details>

<details>

<summary>Call not found in TOPdesk (404)</summary>

The call linked to the work order no longer exists in TOPdesk.

Check the external work order number.

Then confirm the call still exists in TOPdesk.

</details>

<details>

<summary>Nothing to import</summary>

This is not an error.

It means the sync ran successfully, but no new calls matched the import criteria.

</details>

### Frequently asked questions

<details>

<summary>Where do I find the sync log?</summary>

The log is on the right side of the TOPdesk settings page.

It shows the time, message, and error details for each sync.

</details>

<details>

<summary>Is “Nothing to import” an error?</summary>

No.

It only means that no new calls matched the selected import criteria at that moment.

</details>

<details>

<summary>My credentials stopped working. What should I do?</summary>

Generate a new application password in TOPdesk.

Then update the TOPdesk login settings in OutSmart.

</details>

<details>

<summary>A call imported without a customer address. What happened?</summary>

The linked branch address was incomplete when the import ran.

Update the address in TOPdesk.

Then import the call again.

</details>

<details>

<summary>A completed work order did not update TOPdesk. What should I check?</summary>

Review the log first.

Then check whether the work order still has the TOPdesk call number as its external work order number.

Without that link, OutSmart cannot find the call to update.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledge.out-smart.com/integrations/integrations/topdesk/troubleshoot-topdesk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.