qbXML status code 3310

Error

What QuickBooks says

Failed to save the Time Tracking transaction. The employee "%1" provided in the TimeTrackingAdd request has the checkbox "Use time data to create paychecks" set to the Unknown state. Have your application ask the user whether or not to set time tracking for this employee. Then issue an EmployeeMod request to set this option to either UseTimeData or DoNotUseTimeData. If UseTimeData, activities will be transferred to paychecks.

QuickBooks fills in the marked parts when it answers: usually the value, the field, the kind of record and a longer explanation of its own.

It arrives on the response element as statusCode="3310" statusSeverity="Error", with this text in statusMessage.

We haven't seen this code from a real company file yet, so the wording above is all we can vouch for.

With QuBe Sync's API

QuBe Sync reads QuickBooks' response for you. When CustomerAdd gets this code, your webhook receives this JSON, with the marked parts filled in:

Webhook state and error
{
  "error": {
    "debug_message": null,
    "error_code": 3310,
    "error_type": "quickbooks_business_error",
    "hresult": null,
    "message": "Failed to save the Time Tracking transaction. The employee \"%1\" provided in the TimeTrackingAdd request has the checkbox \"Use time data to create paychecks\" set to the Unknown state. Have your application ask the user whether or not to set time tracking for this employee. Then issue an EmployeeMod request to set this option to either UseTimeData or DoNotUseTimeData. If UseTimeData, activities will be transferred to paychecks.",
    "user_message": "QuickBooks reported an error while processing this request: Failed to save the Time Tracking transaction. The employee \"%1\" provided in the TimeTrackingAdd request has the checkbox \"Use time data to create paychecks\" set to the Unknown state. Have your application ask the user whether or not to set time tracking for this employee. Then issue an EmployeeMod request to set this option to either UseTimeData or DoNotUseTimeData. If UseTimeData, activities will be transferred to paychecks."
  },
  "state": "error"
}

Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).