Backorder Issue — ACCS-216 (PDP Troubleshooting)#712
Draft
Backorder Issue — ACCS-216 (PDP Troubleshooting)#712
Conversation
bdenham
changed the title
bdenham
changed the title
keharper
reviewed
Feb 9, 2026
Contributor
keharper
left a comment
keharper
left a comment
There was a problem hiding this comment.
A lot of cosmetic stuff, but I'm not approving right now because I think sending the reader to the playground is a big error.
| import Link from '@components/Link.astro'; | ||
| import TableWrapper from '@components/TableWrapper.astro'; | ||
|
|
||
| This guide helps you troubleshoot common issues with product availability, stock status, and product data synchronization on the product details page. |
| ### Backorder status toggle switches off unexpectedly | ||
|
|
||
| <Aside type="note" title="Note about this issue"> | ||
| This troubleshooting entry is based on a customer-reported support issue. The "backorder toggle" refers to a Commerce Admin interface element used to configure product backorder settings (accessible via **Catalog** > **Products** > **\[Product\]** > **Advanced Inventory**). While the Commerce Admin interface itself is not part of the storefront codebase, the data synchronization mechanism (SaaS Data Export) that syncs inventory changes from Commerce to Catalog Service is documented and verifiable. |
Contributor
There was a problem hiding this comment.
Why does Product need to be in brackets?
| If you need the backorder toggle to change dynamically based on stock levels, you would need to implement a custom runtime action that: | ||
| - Subscribes to quantity adjustment events | ||
| - Calls Adobe Commerce APIs to update the backorder flag when quantity reaches 0 | ||
| - This custom implementation should be at the integration level (e.g., OPTP integration), not in core storefront code |
Contributor
There was a problem hiding this comment.
Not a bullet.
Remove e.g. and don't mention a specific customer.
| }); | ||
| ``` | ||
|
|
||
| **Method 2: GraphQL Playground** |
Contributor
There was a problem hiding this comment.
Again, this is not the proper destination for queries.
|
|
||
| <Steps> | ||
|
|
||
| 1. Open browser DevTools → Network tab |
Co-authored-by: Kevin Harper <keharper@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add Product Details Troubleshooting Guide
Issue
Customer-reported support issue: When ACCS is notified via API from an ERP that a product is backordered, the backorder toggle switches on (backorder flag appears on PDP), but then switches back to off after a period of time even though the ERP hasn't adjusted the quantity available. This causes customers to see products as deliverable when they're actually on backorder, leading to order fulfillment issues.
This guide helps developers troubleshoot product availability issues with actionable debugging steps.
Associated JIRA ticket
ACCS-216
Staging preview
https://commerce-docs.github.io/microsite-commerce-storefront/dropins/product-details/troubleshooting/
Affected pages
New page to be added here: