> 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/visma.net/troubleshoot-visma.net.md).

# Troubleshoot VISMA.net

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

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

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

{% stepper %}
{% step %}

### Open the VISMA.net settings

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

Open **VISMA.net**.
{% endstep %}

{% step %}

### Open the log

Review the log panel on the right side.

Then open the latest warning or error entry.
{% endstep %}

{% step %}

### Read the full message

Use the full error details to find the exact cause.

Check which record or setting is involved.
{% endstep %}

{% step %}

### Fix the cause and retry

After you correct the issue, run **Export work orders** or the relevant **Sync** action again.
{% endstep %}
{% endstepper %}

### Quick checks first

Check these points before you go deeper:

* the connection is still active
* the authentication token is still valid
* the correct import or export settings are saved
* the customer and material codes still match
* the work order is ready for export

### Common error messages

<details>

<summary>Material X on work order Y not found in VISMA.net</summary>

A material on the work order does not exist in VISMA.net.

Turn on **New material** so OutSmart creates it automatically.

Or make sure the material codes match in both systems.

</details>

<details>

<summary>Relation X on work order Y not found in VISMA.net</summary>

The customer on the work order does not exist in VISMA.net.

Turn on **New relation** so OutSmart creates it automatically.

Or import the customer from VISMA.net first.

</details>

<details>

<summary>Work order Y relation X does not exist in OutSmart</summary>

The work order does not have a valid customer in OutSmart.

Make sure the correct customer is linked to the work order.

</details>

<details>

<summary>The quantity of material X has to be greater than 0</summary>

A material line has quantity **0**.

Change the quantity to a value greater than zero before you export again.

</details>

<details>

<summary>Please specify whether to send the work order as a sales order or a sales invoice</summary>

The export format is not set.

Open the export settings, choose **Sales order** or **Sales invoice**, and save.

</details>

<details>

<summary>Error refreshing API token. Unable to access API</summary>

The access token expired and could not be refreshed.

Disconnect the integration and connect it again through the VISMA.net login page.

</details>

<details>

<summary>API token invalid. Please reauthenticate</summary>

The stored token is no longer valid.

Click **Login** on the settings page and sign in again.

</details>

<details>

<summary>Error creating customer in VISMA.net</summary>

VISMA.net could not create the customer during export.

Read the full error details.

Then make sure the customer in OutSmart has the required data, such as name and address.

</details>

### Frequently asked questions

<details>

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

Open the VISMA.net settings.

The log is visible on the right side.

</details>

<details>

<summary>Is “Niks te importeren/exporteren” an error?</summary>

No.

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

</details>

<details>

<summary>How do I reconnect when the connection expired?</summary>

Click the disconnect button in the log header.

Then sign in again through the VISMA.net login page.

</details>

<details>

<summary>A work order failed with error status. What should I do?</summary>

Reset the workstatus to the correct export status if it was set to **Error**.

Then run the export again.

</details>

<details>

<summary>A work order exported, but I cannot find it in VISMA.net. What should I do?</summary>

Check the log in OutSmart first.

If the export was successful, check the right area in VISMA.net.

For sales orders, check the sales order section.

For sales invoices, check the customer invoice section.

</details>

### Related topics

* [**VISMA.net**](/integrations/integrations/visma.net.md)
* [**Set up VISMA.net**](/integrations/integrations/visma.net/set-up-visma.net.md)
* [**Configure VISMA.net exports**](/integrations/integrations/visma.net/configure-visma.net-exports.md)


---

# 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/visma.net/troubleshoot-visma.net.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.