Troubleshoot Billit

Review the log and fix common Billit sync and export errors.

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

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

1

Open the Billit settings

Go to Settings → General → Software integrations.

Open Billit.

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 record or field is involved.

4

Fix the cause and retry

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

Quick checks first

Check these points before you go deeper:

• the connection is still active
• the invoice customer is linked to Billit
• the delivery customer is linked to Billit
• the work order has billable material lines
• the work order has a start date and end date
• every exported material has a product code

Common error messages

Invoice customer External ID is missing

The invoice customer on the work order is not linked to a Billit customer.

Import the customer from Billit first.

Or make sure the customer was created through the Billit sync.

Delivery customer External ID is missing

The delivery customer on the work order is not linked to a Billit customer.

Import the delivery customer from Billit first.

Material order lines are invalid

The work order has no billable material lines.

Add at least one billable material before you export again.

Work order Starting date or Ending date is missing

The work order is missing a start date or end date.

Set both dates on the work order.

Material is not valid for export. Missing Code field

A material on the work order has no product code.

Open the material in OutSmart and add the code.

Material does not exist in Billit

The material code does not exist in Billit.

Turn on New materials if OutSmart should create it automatically.

Product with this reference already exists in Billit

Billit already has a product with that reference.

Usually no action is needed.

If the problem stays, check for duplicate product codes.

An error occurred while creating the invoice or quotation

Billit returned an error during export.

Open the full log message and check whether all required work order fields are filled in.

Billit customer cannot be imported due to missing fields

The customer is missing required data in Billit.

Fill in the customer number, name, street, postal code, and city.

Billit product cannot be imported due to missing fields

The product is missing a Reference or Description.

Fill in both fields in Billit.

An error occurred while retrieving products from Billit

OutSmart could not retrieve products from Billit.

Check the full log details.

Reconnect the integration if the problem keeps returning.

API token verlopen. Authenticeer de integratie opnieuw

The Billit access token has expired.

Use the power icon to disconnect the integration.

Then connect it again through the Billit login page.

Frequently asked questions

Where do I find the sync log?

Open the Billit settings.

The log is visible on the right side.

Is “Nothing to import” or “Nothing to export” an error?

No.

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

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

Check the log first.

A common cause is an expired access token.

Reconnect the integration if needed.

A work order exported successfully, but I cannot find it in Billit. What should I do?

Check the OutSmart log for the Billit order ID.

If you export as an invoice, check invoices in Billit.

If you export as a quotation, check quotations in Billit.

Related topics

• Billit
• Set up Billit
• Configure Billit exports