BusinessPlus Connect (Developer)
Product Detail API & Commerce Modes
Retrieve complete product specifications, technical details, multi-image galleries, video URLs, and authoritative commerce modes for product pages.
Endpoint & Lookup Parameters
Fetch full item details using the public GET endpoint. The endpoint requires both your site_id UUID and the item identifier (slug or UUID):
Root Fields Reference & Naming
Take note of exact property names in the root object:
Commerce Modes (commerce.mode)
The commerce.mode property defines how the custom storefront must present the purchase action to the shopper:
Commerce Mode Inheritance Behavior
BusinessPlus resolves effective commerce mode through strict hierarchical inheritance:
- 1. Explicit Product Override: If the merchant explicitly configured purchase_mode on the product record as "purchase", "quote", or "purchase_and_quote", that setting overrides everything.
- 2. Site Setting Fallback (Inherit): If the product setting is "inherit" (or unspecified), the product inherits from Site Settings -> primary_cta. If primary_cta is set to "quote" or "request_quote", the product resolves to commerce.mode = "quote". Otherwise, it defaults to "purchase".
NOTE: The server-side order database transaction enforces the exact same inheritance rule. If a client attempts to submit a direct order for an item whose effective mode is "quote", the transaction rejects the order with machine-readable error code ITEM_REQUIRES_QUOTE.
Normalized details Object vs Deprecated expansion_details
All new headless integrations must consume the clean, normalized details object.
TypeScript / JavaScript Fetch Example
Fetch and strongly type full product details with this copyable implementation: