Product Details Troubleshooting

Troubleshoot backorder status issues on the product details page.

Backorder status toggle switches off unexpectedly

Symptom: The backorder toggle switches on when an ERP notifies Adobe Commerce that a product is backordered, but then switches off after a period of time, even though the ERP has not adjusted the quantity available.

Impact: Customers see products as deliverable when they’re actually on backorder, leading to order fulfillment issues.

Expected behavior:

The backorder toggle is a configuration setting that defines how products behave when stock quantity is 0 (whether to allow customers to purchase out-of-stock items). The backorder setting is a static configuration and is not intended to change automatically based on stock quantity changes.

If you need the backorder toggle to change dynamically based on stock levels, implement a custom runtime action that:

Subscribes to inventory change events.
Calls Adobe Commerce APIs to update the backorder flag when quantity reaches 0.
Operates at the integration level (for example, a custom integration), not in core storefront code.

For more information about configuring backorders, see the Commerce Admin backorder configuration documentation .

Verify the issue:

Check the browser console for product data updates.
```
1
// Listen to product data events
2
import { events } from '@dropins/tools/event-bus.js';
3

4
events.on('pdp/data', (payload) => {
5
  if (payload) {
6
    console.log('Product data:', payload);
7
    console.log('In stock:', payload.inStock);
8
    console.log('Add to cart allowed:', payload.addToCartAllowed);
9
    console.log('SKU:', payload.sku);
10
  }
11
});
```
Check the Commerce Admin backorder setting.
- Navigate to Catalog > Products and open the product in edit mode.
- Click Advanced Inventory to view the backorder settings.
- Verify the backorder toggle is set as expected.

What to check:

Expected behavior: Verify that the backorder toggle is set as a static configuration and not changing automatically based on stock quantity. The backorder setting should remain consistent regardless of stock level changes.
Custom runtime actions: Check if any custom runtime actions or integrations subscribe to inventory change events and automatically update the backorder flag. If dynamic backorder behavior is needed, implement it at the integration level (for example, a custom integration), not in core storefront code.
ERP integration: Verify that your ERP system correctly sends backorder status to Adobe Commerce via API. Check your ERP integration logs and Adobe Commerce backend logs for API call success or failure. The integration typically uses Adobe Commerce REST or GraphQL APIs, but specific implementation details vary by customer. ERP systems should not automatically toggle the backorder setting based on stock levels.
API response: Confirm the Catalog Service GraphQL API returns the correct inStock and addToCartAllowed values.
Data refresh: Check if product data is being refreshed from a different source that overwrites the backorder status.
Event handlers: Review any custom event handlers that might update product availability or backorder settings.

Workaround:

Monitor product availability in real-time and manually verify backorder status in your Commerce Admin before fulfilling orders.

Next steps:

If the issue persists, collect the following information for support:

Product SKU(s) experiencing the issue.
Timestamp when backorder status was set.
Timestamp when toggle switched back to off.
API response from Catalog Service at both timestamps.
Browser console logs showing product data updates.