From 7cebf378ebaf191c827cefdbe3e7455ec5ed1997 Mon Sep 17 00:00:00 2001 From: Bruce Denham Date: Sat, 9 May 2026 10:26:36 -0500 Subject: [PATCH 1/2] Completed USF-3972 docs --- src/content/docs/releases/changelog.mdx | 10 ++++++++++ src/content/docs/releases/index.mdx | 3 ++- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/src/content/docs/releases/changelog.mdx b/src/content/docs/releases/changelog.mdx index 0961f0c54..1f096887f 100644 --- a/src/content/docs/releases/changelog.mdx +++ b/src/content/docs/releases/changelog.mdx @@ -674,6 +674,16 @@ import Link from '@components/Link.astro'; - **Guest order cancel with comments**: Resolved an internal server error when calling `requestGuestOrderCancel` on orders that include order comments. The error was introduced when the Order drop-in added `OrderComments` support and the new `comments` field appeared in order responses; the SCP `requestGuestOrderCancel` mutation did not handle the presence of that field, causing a 500 error on cancel requests ([#275](https://github.com/magento-commerce/storefront-compatibility/pull/275)). + + The Storefront Compatibility Package has been updated with the following changes: + + - **Guest order cancel with comments**: Resolved an internal server error when calling `requestGuestOrderCancel` on orders that include order comments. The cancellation flow was writing status history entries without an explicit UTC `created_at` timestamp; when the Order drop-in requested `comments { message timestamp }`, the null timestamp caused the GraphQL resolver to return a 500 error. This fix applies to Adobe Commerce 2.4.8 deployments ([#268](https://github.com/magento-commerce/storefront-compatibility/pull/268)). + + - **Product Recommendations v4**: The drop-in switches to the `getRecommendationsUnitsByIds` GraphQL query. If you call the legacy `getRecommendations` function directly, update your integration to use the new API before upgrading to v4. +- Order v3.3.0 adds the `comments` field to order responses. If you upgrade the Order drop-in to v3.3.0 without updating the Storefront Compatibility Package, the `requestGuestOrderCancel` mutation returns an internal server error and guest order cancellation stops working. Update the SCP to v4.7.12 (for Adobe Commerce 2.4.7) or v4.8.18 (for Adobe Commerce 2.4.8) at the same time as you upgrade the Order drop-in. ### Highlights @@ -115,7 +116,7 @@ The Drop-in SDK (`@dropins/tools`) was upgraded to 1.8.1 in this release with th ### Known issues -There are no known issues for this release suite. +- Guest order cancellation fails with an internal server error when the Order drop-in is upgraded to v3.3.0 without a matching SCP update. See the breaking changes note above for the required SCP versions. ### Component compatibility From 65d959484f990d0e4bc98e1802e4aca602b743ae Mon Sep 17 00:00:00 2001 From: Bruce Denham Date: Sat, 9 May 2026 11:08:12 -0500 Subject: [PATCH 2/2] update based on pm review skill --- src/content/docs/releases/changelog.mdx | 6 +++--- src/content/docs/releases/index.mdx | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/src/content/docs/releases/changelog.mdx b/src/content/docs/releases/changelog.mdx index 1f096887f..b052275eb 100644 --- a/src/content/docs/releases/changelog.mdx +++ b/src/content/docs/releases/changelog.mdx @@ -671,7 +671,7 @@ import Link from '@components/Link.astro'; - **Login as Customer**: Added Login as Customer feature support ([#248](https://github.com/magento-commerce/storefront-compatibility/pull/248)). **v4.7.12** - - **Guest order cancel with comments**: Resolved an internal server error when calling `requestGuestOrderCancel` on orders that include order comments. The error was introduced when the Order drop-in added `OrderComments` support and the new `comments` field appeared in order responses; the SCP `requestGuestOrderCancel` mutation did not handle the presence of that field, causing a 500 error on cancel requests ([#275](https://github.com/magento-commerce/storefront-compatibility/pull/275)). + - **Guest order cancel with comments**: Resolved an internal server error when calling `requestGuestOrderCancel` on orders that include order comments. The cancellation flow was writing status history entries without an explicit UTC `created_at` timestamp; when the Order drop-in requested `comments { message timestamp }`, the null timestamp caused the GraphQL resolver to return a 500 error. This fix is required for a safe Order drop-in v3.3.0 upgrade on Adobe Commerce 2.4.7 deployments. See the [April 2026 suite notes](/releases/) for the full context ([#275](https://github.com/magento-commerce/storefront-compatibility/pull/275)). - The Storefront Compatibility Package has been updated with the following changes: + The Storefront Compatibility Package has been updated with the following changes. This release accompanies the Order drop-in v3.3.0 release; see the [April 2026 suite notes](/releases/) for the full context. - - **Guest order cancel with comments**: Resolved an internal server error when calling `requestGuestOrderCancel` on orders that include order comments. The cancellation flow was writing status history entries without an explicit UTC `created_at` timestamp; when the Order drop-in requested `comments { message timestamp }`, the null timestamp caused the GraphQL resolver to return a 500 error. This fix applies to Adobe Commerce 2.4.8 deployments ([#268](https://github.com/magento-commerce/storefront-compatibility/pull/268)). + - **Guest order cancel with comments**: Resolved an internal server error when calling `requestGuestOrderCancel` on orders that include order comments. The cancellation flow was writing status history entries without an explicit UTC `created_at` timestamp; when the Order drop-in requested `comments { message timestamp }`, the null timestamp caused the GraphQL resolver to return a 500 error. Upgrading the Order drop-in to v3.3.0 without this SCP version causes guest cancellation to fail on Adobe Commerce 2.4.8 deployments ([#268](https://github.com/magento-commerce/storefront-compatibility/pull/268)). - **Product Recommendations v4**: The drop-in switches to the `getRecommendationsUnitsByIds` GraphQL query. If you call the legacy `getRecommendations` function directly, update your integration to use the new API before upgrading to v4. -- Order v3.3.0 adds the `comments` field to order responses. If you upgrade the Order drop-in to v3.3.0 without updating the Storefront Compatibility Package, the `requestGuestOrderCancel` mutation returns an internal server error and guest order cancellation stops working. Update the SCP to v4.7.12 (for Adobe Commerce 2.4.7) or v4.8.18 (for Adobe Commerce 2.4.8) at the same time as you upgrade the Order drop-in. +- Order v3.3.0 (Order Comments): Guest order cancellation stops working if you upgrade the [Order drop-in](/dropins/order/) to v3.3.0 without also updating the Storefront Compatibility Package (SCP). This affects Adobe Commerce on-premises and Adobe Commerce on Cloud deployments only. Order v3.3.0 adds a `comments` field to order responses; without a matching SCP update, the `requestGuestOrderCancel` mutation returns an internal server error. Update the SCP to v4.7.12 (for Adobe Commerce 2.4.7) or v4.8.18 or later (for Adobe Commerce 2.4.8; the April 2026 suite was verified with v4.8.19) at the same time as you upgrade the Order drop-in. ### Highlights @@ -87,7 +87,7 @@ The Drop-in SDK (`@dropins/tools`) was upgraded to 1.8.1 in this release with th |-----------|--------------| | [**Cart**](/dropins/cart/) v3.2.0 | No user-facing changes in this release | | [**Checkout**](/dropins/checkout/) v3.2.1 | Full `additionalData` forwarded to `setPaymentMethodOnCart`, enabling vault and other payment methods that require extra fields ([#311](https://github.com/adobe-commerce/storefront-checkout/pull/311)). | -| [**Order**](/dropins/order/) v3.3.0 | New `OrderComments` container displays order-level comments (timestamp and message) for guest and authenticated users ([#68](https://github.com/adobe-commerce/storefront-order/pull/68), [#87](https://github.com/adobe-commerce/storefront-order/pull/87)). | +| [**Order**](/dropins/order/) v3.3.0 | New `OrderComments` container displays order-level comments (timestamp and message) for guest and authenticated users ([#68](https://github.com/adobe-commerce/storefront-order/pull/68), [#87](https://github.com/adobe-commerce/storefront-order/pull/87)). Requires a matching SCP update — see breaking changes. | | [**Product Details Page**](/dropins/product-details/) v3.0.3 | New `formatValue` prop on [`ProductAttributes`](/dropins/product-details/containers/product-attributes/) for custom numeric attribute value formatting. Numeric attributes (weight, dimensions, custom fields) now render at the display precision configured in Commerce Admin instead of raw database values ([#65](https://github.com/adobe-commerce/storefront-pdp/pull/65)). | | [**User Account**](/dropins/user-account/) v3.3.0 | New `PaymentMethods` container: lists stored cards (`customerPaymentTokens` query) with brand, masked number, and expiry badge; removes a card via `deletePaymentToken` mutation with confirmation modal. New `PaymentCard` reusable component. `fieldIdPrefix` on `Addresses` now correctly propagated to form field IDs, preventing duplicate HTML IDs when shipping and billing forms render on the same page. Customer dropdown custom attributes prefill correctly from the API ([#51](https://github.com/adobe-commerce/storefront-account/pull/51), [#55](https://github.com/adobe-commerce/storefront-account/pull/55), [#56](https://github.com/adobe-commerce/storefront-account/pull/56), [#57](https://github.com/adobe-commerce/storefront-account/pull/57), [#58](https://github.com/adobe-commerce/storefront-account/pull/58)). | | [**User Auth**](/dropins/user-auth/) v3.2.0 | No user-facing changes in this release | @@ -116,7 +116,7 @@ The Drop-in SDK (`@dropins/tools`) was upgraded to 1.8.1 in this release with th ### Known issues -- Guest order cancellation fails with an internal server error when the Order drop-in is upgraded to v3.3.0 without a matching SCP update. See the breaking changes note above for the required SCP versions. +- If you already upgraded the Order drop-in to v3.3.0 without a matching SCP update, guest order cancellation returns an internal server error. See the breaking changes section above for the required SCP versions to restore guest cancellation. ### Component compatibility