Subscription states

Availability to the full complement of REST operations supported for a given resource depends on the state of the company’s QuickBooks subscription. The image below shows the progression of subscription states; the subscription can start either as a TRIAL or as fully SUBSCRIBED.

qbo/docs/develop/troubleshooting/QBOSubStatus4.png

The following table summarizes the possible QuickBooks subscription states, as returned in the SubscriptionStatus attribute of the CompanyInfo </app/developer/qbo/docs/api/accounting/all-entities/companyinfo> resource (with query parameter minorversion=3).

QuickBooks State Data Services
TRIAL Company is in trial; the user has not provided credit card info yet. - During this state, the subscription is set to read/write access. - If the customer does not update the payment information within 30 days, the subscription state is set to EXPIRED and data is read-only.
TRIALOPTIN Company is in trial; the user has provided credit card info. - During this state, the subscription is set to read/write access.
EXPIRED The trial period is over. - No payment received during trial period (30 days). - During this state, the trial is set to read-only access. - Operations other than read result in a Validation Fault with error code=6190. - If no action is taken after 90 days, the company data is deleted. - As a best practice before company is deleted, disconnect existing connections to the company. See more about revoking access here.
SUBSCRIBED Trial is over and the company is subscribed. - During this state, the subscription is set to read/write access.
RESTRICTED The subscription payment failed. - During this state, the subscription is set to read/write access. - If the customer does not update the payment information within 15 days (for US locale) or 7 days (for non-US locales) from the start of the RESTRICTED period the subscription state is set to SUSPENDED and data is read-only.
SUSPENDED The RESTRICTED waiting period is over for the subscription and payment information has not been received. - During this state, the subscription is set to read-only access. - Operations outside of a read operation result in a Validation Fault with error code=6190. - If no action is taken after 390 days, the company data is deleted. - As a best practice before company is deleted, disconnect existing connections to the company. See more about revoking access here.
CANCELLED The trial or subscription is cancelled by the user or support agent. - During this state, the trial or subscription is set to read-only access. - Trials remain in this state for up to 90 days. - Subscriptions remain in this state for up to 390 days. - If no action is taken during the cancelled waiting period, the company data is deleted and all operations result in a Validation Fault with error code=7001. - As a best practice before company is deleted, disconnect existing connections to the company. See more about revoking access here.
UNKNOWN Context of the company is not available.

Error codes

Error code Message Detail
6190 Invalid Company Status Error Subscription period has ended or canceled or there was a billing problem.