Resolving "Business Validation Error: A Project Cannot Contain Subcustomers"
This error is created by Quickbooks when it detects a customer hierarchy that exceeds the allowed structure. Specifically, QBO does not permit a Project to have sub-customer/Job nested beneath it. To clear the error, the hierarchy must be flattened to two levels.
1. Understanding the Allowed Customer Hierarchy
QBO enforces a maximum of two levels in the customer hierarchy:
✅ Allowed: Parent Customer → Sub-customer/Job
❌ Not allowed: Parent Customer → Sub-customer/Job → Sub-customer/Job
If a Quickbooks Project has sub-customers nested beneath it, Quickbooks will return this validation error during sync.
2. Flattening the Customer Hierarchy in QuickBooks Online
To resolve the error, reassign any sub-customers nested under a Project to a top-level customer:
Navigate to Job with the sync error.
In the Job Settings panel:
Edit the Parent Customer field and reassign it to a top-level customer (not another Sub-customer/Job).
Save the change.
Repeat on all sub-customers/Jobs until all have been moved out from under the Project, leaving a two-level hierarchy.
Important: The parent customer being referenced must be active in QBO. If the parent customer is inactive, activate it before re-triggering the sync.
3. Re-Syncing in Adaptive
Once the hierarchy has been flattened in Adaptive:
Resync the Customer/Job
Confirm the error no longer appears.
Key Requirement: All customer hierarchies in QBO must be limited to two levels (Parent Customer → Sub-customer/Job). Any structure where a Project contains sub-customers will block a successful sync until resolved.
Still Need Help?
Please reach out to our support team at [email protected] for further assistance.