For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshoot Bouwsoft

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

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

The log panel is shown on the right side of the settings page.

Open entries with an orange error icon to see the full details.

1

Open the Bouwsoft settings

Go to Settings → General → Software integrations.

Open Bouwsoft.

2

Check the log panel

Review the latest log entries on the right side of the page.

Look for warnings or errors.

3

Open the error details

Click the entry with the orange error icon.

Use the full message to find the exact cause.

4

Fix the source issue

Correct the matching setting, work order, project, material, or employee data.

5

Retry the action

Run Import or Export again after the fix.

Quick checks first

Check these points before you go deeper:

  • the connection date is still shown

  • the correct administration is selected

  • the work order has the right status for export

  • the work order has a project number for actual costs export

  • each work period has an employee

  • materials and hour types exist in Bouwsoft or can be created

Common error messages

Project not found in Bouwsoft

The project number on the work order does not match a project in Bouwsoft.

Check the project number.

Or import the project from Bouwsoft first.

Material not found in Bouwsoft

A material on the work order has no matching code in Bouwsoft.

Enable Create new materials.

Or make sure the material codes match in both systems.

Hourtype not found in Bouwsoft

An hour type on the work order does not exist in Bouwsoft.

Import hour types from Bouwsoft first.

Or make sure the codes match.

No employee found on work order

A work period has no employee assigned.

Assign an employee to every work period before export.

No materials or work periods found on work order

The work order has nothing to export.

Add at least one material or one work period.

External work order number is not an integer

The external work order number contains a non-numeric value.

Correct the value on the work order.

SalesInvoice already created

The work order was already exported as a sales invoice.

Check the existing invoice in Bouwsoft.

The same work order cannot create a new invoice again.

Workorder is being synced already

Another sync is still processing the work order.

Wait a moment.

Then try again.

Error deducting item from Bouwsoft Warehouse

Bouwsoft could not deduct the material from the selected warehouse.

Check the warehouse setting.

Also check whether the material exists in that warehouse.

WorkOrder status has to be 1

The work order is not in the required status for actual costs export.

Set the work order to status 1.

Also make sure the project number is filled in.

Frequently asked questions

Where do I find the sync log?

On the right side of the Bouwsoft settings page.

It shows the time, message, and details for sync activity.

Is "Nothing to import/export" an error?

No.

It means the sync finished successfully.

There was simply no new or changed data to process.

How do I reconnect when the connection expired?

Disconnect the integration with the power icon.

Then connect again through the Bouwsoft login page.

The integration worked before and then stopped. What should I do?

Check the log first.

A common cause is a token that could not be refreshed.

If needed, disconnect and connect again.

Last updated

Was this helpful?