qbXML status code 3171
ErrorThe transaction is dated on or before the company's closing date, which is password-protected.
What QuickBooks says
An attempt was made to modify a %1 with a date that is on or before the closing date of the company. If you are sure you really want to do this, please ask a user with Admin privileges to remove the password for editing transactions on or before to closing date (this setting is in the Accounting Company Preferences), then try again.
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="3171" statusSeverity="Error", with this text in statusMessage.
What to do
A QuickBooks admin has to remove the closing-date password (Accounting company preferences) before it can be changed.
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:
{
"error": {
"debug_message": null,
"error_code": 3171,
"error_type": "quickbooks_business_error",
"hresult": null,
"message": "An attempt was made to modify a %1 with a date that is on or before the closing date of the company. If you are sure you really want to do this, please ask a user with Admin privileges to remove the password for editing transactions on or before to closing date (this setting is in the Accounting Company Preferences), then try again.",
"user_message": "This transaction is dated on or before the company's closing date, so QuickBooks won't change it. A QuickBooks administrator has to remove the closing date password (in Accounting company preferences) first."
},
"state": "error"
}
Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).