From time to time you may come across errors when the Toggl to QuickBooks Integration runs. In this article, we'll go through some of the more common errors that occur, and explain corrective actions you can take.

How Toggl to QuickBooks handles errors.

The integration is designed to tag entries in Toggl as soon as an error occurs. This helps you identify errors and these tags also mark the data so that the integration doesn't attempt to sync time entries again until the error has been resolved.

Error: "The Toggl project, 'X' is not associated with a client..."

The full error message looks like:

The Toggl project, 'XYZ', is not associated with a client - therefore no customer can be determined in QuickBooks. The time entry will not be processed. Toggl entry was tagged as 'QBOSyncError' to prevent it from syncing again until the error is resolved.

This error occurs when there's a Toggl time entry for a project without a client. Because no client can be determined, there is no way for the integration to match the time entry to a QuickBooks customer.

Corrective actions:

  • If you want the entry to sync to QuickBooks, add a client to the Toggl project. Then make sure that you've created a corresponding customer in QuickBooks whose name matches the Toggl client name. Finally, remove the "QBOSyncError" tag from the time entry. The integration will pick this entry up again the next time it polls, provided the time entry is inside the settings time horizon.
  • If you don't want the entry to sync. No further action is necessary.

Error: "QuickBooks customer not found for Toggl client 'X'..."

The full error message looks like: QuickBooks customer not found for Toggl client 'XYZ Company' (id: 12345678). The time entry will not be processed to QuickBooks. Toggl entry was tagged as 'QBOSyncError' to prevent it from syncing again until the error is resolved.

This error occurs when a QuickBooks customer could not be found that matches the client for the time entry in Toggl.

Corrective actions:

  • Either create customer in QuickBooks whose name matches the Toggl client name, or...
  • Find the customer in Quickbooks you think the client is supposed to match against and change either the Company Name or Display Name field to match the Toggl client name, or...
  • Change the name of the client in Toggl to match a QuickBooks customer name.

Error: "There is no valid hourly rate (0.00) for this time entry... "

The full error message looks like: There is no valid hourly rate (0.00) for this time entry. No rate is specified on the Toggl project 'XYZ Project' or client 'ABC Company', and defaults were not specified. The time entry will not be processed to QuickBooks. Toggl entry was tagged as 'QBOSyncError' to prevent it from syncing again until the error is resolved.

This error occurs when an hourly rate cannot be determined for a time entry. The integration first looks at the Toggl project, then the Toggl client to determine hourly rate information. If neither of these has been configured with hourly rate information, the integration then uses the settings as shown below:

If either the default service or the default hourly rate settings (both are optional) have not been provided, then the time entry will error out because no billable rate can be determined.

Corrective actions:

  • Define an hourly rate in Toggl for the project, or...
  • Define an hourly rate in Toggl for the client, or...
  • Add either a default service or a default hourly rate in the app settings. Note: you may need to unsubscribe and resubscribe to the integration in order to do this.

There are some entries marked as errors that I just want ignored.

Sometimes you'll have errors that cannot be resolved or that you do not want to resolve for various reasons.  If you find the "QBOSyncError" tag misleading, you can manually add a tag "IgnoreSync", and the integration will ignore this time entry. Remove "QBOSyncError" tag only after you've added the "IgnoreSync" tag. This may help you better differentiate between actual errors and entries you want ignored.