Troubleshoot MoneyBird

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

Use the log in the MoneyBird settings to review synchronization activity, warnings, and errors.

Each log entry shows the time and a message.

If an entry contains a warning icon, you can open the full error details.

1

Open the MoneyBird settings

Go to Settings → General → Software integrations.

Open MoneyBird.

2

Review the log section

Scroll to the Log section at the bottom of the page.

Check the latest entries first.

3

Open the error details

Click an entry with a warning icon.

Use the full message to find the exact cause.

4

Refresh the log

Click Refresh to load the latest log entries.

5

Fix the source issue and retry

Correct the customer, item, setting, or connection.

Then run the sync again.

Quick checks first

Check these points before you go deeper:

• the connection to MoneyBird is still active
• the customer exists in OutSmart and in MoneyBird
• materials and hour types are set up correctly
• the default category and VAT tariff are filled in
• the export settings match your process

Common error messages

Unknown in MoneyBird administration

The customer linked to the work order does not exist in MoneyBird.

Enable contact export or create the contact in MoneyBird first.

Unknown material on order

A material used on the work order is not available as a valid item for export.

Make sure all materials used on the work order exist correctly in OutSmart before you export the invoice.

The API rate limit has been reached

MoneyBird limits the number of requests in a short period.

Wait a while.

Then start a manual sync again.

The customer on the work order is not known in OutSmart

The integration cannot create the invoice if the work order has no valid customer in OutSmart.

Open the work order and check whether a customer is linked.

Also check whether the debtor number in OutSmart matches the customer ID in MoneyBird.

The customer on the work order is not known in MoneyBird

The customer exists in OutSmart but has no matching contact in MoneyBird.

Enable relation export so OutSmart can create the contact automatically.

Or create the contact manually in MoneyBird and make sure the debtor number matches.

A relation could not be exported to MoneyBird

MoneyBird rejected the customer export.

Check whether the customer details in OutSmart are complete.

Review the name, address, and email address first.

Then open the full error message in the log.

A product or hour type could not be created in MoneyBird

MoneyBird rejected the item export.

Check whether the product code is unique.

Also check whether the default category and VAT tariff are configured.

The connection could not be established

The access token may be expired or invalid.

Reconnect the integration from the MoneyBird settings.

This starts a new authorization flow.

Frequently asked questions

Where do I find the error log?

Go to Settings → General → Software integrations.

Open MoneyBird and review the Log section.

Why does the same error keep appearing?

The sync retries the same action until the cause is fixed.

Fix the root cause first.

Then run a manual sync again.

Can I export again after I fix an error?

Yes.

After you correct the issue, start a new export attempt from the work order or sync again from the integration settings.

Related topics

• MoneyBird
• Set up MoneyBird
• Configure MoneyBird exports