@salesforce/b2c-tooling-sdk 2.4.0 → 2.5.0

package/node_modules/@salesforce/b2c-api-schemas/scapi/product/shopper-delivery-estimates/v1.json

@@ -2,7 +2,8 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Shopper Delivery Estimates",
-    "version": "1.2.0",
+    "description": "[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/shopper-delivery-estimates/shopper-delivery-estimates-oas-v1-public.yaml)\n\n# API Overview\n\nUse the Shopper Delivery Estimates API to retrieve carrier-calculated delivery date ranges for a single product at a destination postal code. The API is intended for product detail pages (PDP) where shoppers want to know when an item will arrive before adding it to a basket.\n\nFor the requested product, the platform enumerates the site's applicable shipping methods. Estimates are returned only when the `sfcc.app.shipping.estimate` hook is bound to a provider via an installed Commerce App; if no provider is bound, the platform returns no estimates.\n\nThe Shopper Delivery Estimates API is currently uncached. The URL is deterministic in `productIds`, `postalCode`, and `countryCode`, and will utilize a cache layer in the future.\n\n## Authentication & Authorization\n\nThe Shopper Delivery Estimates API requires a shopper access token.\n\nFor details on how to request an access token, see [Get a Shopper Token from SLAS](https://developer.salesforce.com/docs/commerce/commerce-api/guide/slas.html).\n\nYou must include `sfcc.shopper-delivery-estimates` and `sfcc.shopper-standard` in the client ID used to generate the token. For a full list of permissions, see the [Authorization Scopes Catalog.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/auth-z-scope-catalog.html)\n\n## Customization\n\n### Hooks\n\nFor details on working with hooks, see [Extensibility with Hooks.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/extensibility_via_hooks.html)\n\n## Response Details\n\n### Personalization\n\nResponses from this API are not personalized via the Shopper Context API.\n\n### Caching\n\nResponses from this API are not cached. The endpoint is currently uncached even though request URLs are deterministic for `productIds`, `postalCode`, and `countryCode`; a cache layer is planned for a future release. For details, see [Server-Side Web-Tier Caching.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/server-side-web-tier-caching.html)\n\n### Timeouts\n\nShopper API requests must respond within 10 seconds, including any hook execution. If a response exceeds this threshold, an HTTP 504 status code is returned. For details, see [Timeouts and Limits.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/timeouts-limits.html)\n\n### Error Handling\n\nError responses follow the [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807) problem detail format. To trace errors, include a `correlation-id` header in your request — the response returns it as `x-correlation-id`. For details, see [HTTP Status Codes and Errors.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/error-response-codes.html)\n\n## Use Cases\n\n### Show \"Arrives by\" on a Product Detail Page\n\nUse this API on the PDP after a shopper enters postal code and country. The response provides delivery windows by applicable shipping method so you can display messaging such as \"Arrives Fri, Oct 4.\"\n\n```bash\ncurl -X GET \\\n  \"https://{shortCode}.api.commercecloud.salesforce.com/product/shopper-delivery-estimates/v1/organizations/{organizationId}/delivery-estimates?siteId={siteId}&productIds={productId}&postalCode=94105&countryCode=US\" \\\n  -H \"Authorization: Bearer {shopper_access_token}\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"correlation-id: pdp-delivery-estimate-001\"\n```\n\n### Choose Which Shipping Methods to Highlight\n\nThe response includes one entry per applicable shipping method for each product. If a method is deliverable, use the `deliveryWindow`; if it is not deliverable, use `nonDeliverableReason` to suppress or de-prioritize that method in your UI.\n\n### Hide the Estimate Module When No Estimates Are Available\n\nIf `productDeliveryEstimates` is empty, no estimates are available for requested products (for example, no applicable shipping methods or no provider response). In that case, hide the delivery estimate component to avoid showing incomplete or misleading delivery messaging.\n\n## Best Practices\n\n- Keep calls scoped to PDP interactions, since the endpoint is currently uncached.\n- Respect the current one-product constraint (`productIds` currently supports one product per request) and avoid batching assumptions until multi-product support is released.\n- Gracefully handle partial availability by rendering only methods with delivery windows and clearly handling non-deliverable methods.\n- Ensure the `sfcc.app.shipping.estimate` hook is bound to a provider via an installed Commerce App — without a bound provider, no estimates are returned. Validate hook performance and timeout behavior to stay within the 10-second Shopper API limit.\n- Always include a `correlation-id` header for easier production troubleshooting.\n\n## Related APIs\n\nThis API is commonly used with SLAS token APIs for shopper authentication and Shopper Products APIs for PDP data retrieval.",
+    "version": "1.2.2",
     "x-api-type": "Shopper",
     "x-api-family": "Product"
   },
@@ -19,93 +20,102 @@
   "paths": {
     "/organizations/{organizationId}/delivery-estimates": {
       "get": {
+        "summary": "Returns delivery date estimates for the requested product.",
+        "description": "Returns delivery date estimates for the requested products at a destination postal code. Currently limited to one product per request. For each requested product, the platform enumerates all applicable site-level shipping methods. Estimates are returned only when the `sfcc.app.shipping.estimate` Commerce Apps hook is bound to a provider. If no provider is bound, the platform returns no estimates.\nEach entry in the response corresponds to one requested product, and contains one entry per applicable shipping method. Methods for which the provider returned an estimate carry a `deliveryWindow`. Methods for which the provider could not return an estimate include a `nonDeliverableReason`. An empty `productDeliveryEstimates` array means the platform has no estimates for any of the requested products, for example, no applicable shipping methods or the provider returned no results. In this case, clients should hide the delivery estimation block.",
         "operationId": "getDeliveryEstimates",
         "parameters": [
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "productIds",
             "in": "query",
+            "description": "The IDs of the products for which to retrieve delivery estimates. Each product must be online and site-assigned. Currently limited to one ID per request; multi-product support is reserved for a future release.",
             "required": true,
             "style": "form",
             "explode": false,
             "schema": {
               "type": "array",
+              "example": [
+                "apple-ipod-shuffle"
+              ],
               "items": {
                 "$ref": "#/components/schemas/ProductId"
               },
               "maxItems": 1,
               "minItems": 1
-            }
+            },
+            "example": "apple-ipod-shuffle"
           },
           {
             "name": "postalCode",
             "in": "query",
+            "description": "The destination postal code for which to compute delivery estimates. Format depends on the destination country (for example, a 5-digit ZIP for US, a 6-character alphanumeric code for CA).",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "type": "string",
+              "example": "10001",
               "maxLength": 20,
               "minLength": 1
-            }
+            },
+            "example": "10001"
           },
           {
             "name": "countryCode",
             "in": "query",
+            "description": "The destination country as an ISO 3166-1 alpha-2 country code (for example, `US`, `CA`, `GB`). Required for unambiguous resolution of the destination — postal codes are not globally unique.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/CountryCode"
-            }
+            },
+            "example": "US"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           },
           {
             "name": "sfdc_usid",
             "in": "header",
+            "description": "A unique shopper identifier (USID) for tracking client context.\nUsed with endpoints secured with ShopperClientContextToken.\nThis header is required for all endpoints secured with ShopperClientContextToken.",
             "required": false,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "sfdc_dw_dnt",
-            "in": "header",
-            "required": false,
-            "style": "simple",
-            "explode": false,
-            "schema": {
-              "type": "string",
-              "enum": [
-                "0",
-                "1"
-              ]
+              "format": "uuid",
+              "example": "550e8400-e29b-41d4-a716-446655440000"
             }
           },
           {
             "name": "personalized",
             "in": "query",
+            "description": "Controls whether personalization is applied to the response. When set to `none`, the server skips applying personalization to the response.",
             "required": false,
             "style": "form",
             "explode": true,
@@ -113,12 +123,14 @@
               "type": "string",
               "enum": [
                 "none"
-              ]
+              ],
+              "example": "none"
             }
           },
           {
             "name": "sfdc_shopper_context",
             "in": "header",
+            "description": "Shopper context information (for example clientIP, sourceCode, and customQualifiers)\npassed in from a trusted backend application.",
             "required": false,
             "style": "simple",
             "explode": false,
@@ -134,6 +146,17 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/DeliveryEstimatesResult"
+                },
+                "examples": {
+                  "GetDeliveryEstimatesResponseExample": {
+                    "$ref": "#/components/examples/GetDeliveryEstimatesResponseExample"
+                  },
+                  "GetDeliveryEstimatesPartialResponseExample": {
+                    "$ref": "#/components/examples/GetDeliveryEstimatesPartialResponseExample"
+                  },
+                  "GetDeliveryEstimatesEmptyResponseExample": {
+                    "$ref": "#/components/examples/GetDeliveryEstimatesEmptyResponseExample"
+                  }
                 }
               }
             }
@@ -144,6 +167,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "GetDeliveryEstimatesBadRequestResponseExample": {
+                    "$ref": "#/components/examples/GetDeliveryEstimatesBadRequestResponseExample"
+                  }
                 }
               }
             }
@@ -157,6 +185,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "GetDeliveryEstimatesProductNotFoundResponseExample": {
+                    "$ref": "#/components/examples/GetDeliveryEstimatesProductNotFoundResponseExample"
+                  }
                 }
               }
             }
@@ -183,27 +216,38 @@
     "schemas": {
       "OrganizationId": {
         "type": "string",
+        "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+        "example": "f_ecom_zzxy_prd",
         "pattern": "^f_ecom_[a-z]{4}_(prd|stg|dev|s[0-9]{2}|[0-9]{3})$"
       },
       "ProductId": {
         "type": "string",
+        "description": "The id (SKU) of the product.",
+        "example": "apple-ipod-classic",
         "maxLength": 100,
         "minLength": 1
       },
       "CountryCode": {
         "type": "string",
+        "description": "A two letter uppercase country code conforming to the [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 standard.",
+        "example": "US",
         "pattern": "^[A-Z][A-Z]$"
       },
       "SiteId": {
         "type": "string",
+        "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites",
+        "example": "RefArch",
         "maxLength": 32,
         "minLength": 1
       },
       "Destination": {
         "type": "object",
+        "description": "The normalized destination used for estimation. Echoes the values supplied on the request.",
         "properties": {
           "postalCode": {
             "type": "string",
+            "description": "The destination postal code.",
+            "example": "10001",
             "maxLength": 20,
             "minLength": 1
           },
@@ -212,7 +256,8 @@
               {
                 "$ref": "#/components/schemas/CountryCode"
               }
-            ]
+            ],
+            "description": "The destination country as an ISO 3166-1 alpha-2 code."
           }
         },
         "required": [
@@ -222,18 +267,25 @@
       },
       "CurrencyCode": {
         "type": "string",
+        "description": "A three letter uppercase currency code conforming to the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) standard, or the string `N/A` indicating that a currency is not applicable.",
+        "example": "USD",
         "pattern": "^([A-Z][A-Z][A-Z]|N/A)$"
       },
       "DeliveryWindow": {
         "type": "object",
+        "description": "A time window during which the delivery is expected. Both endpoints are sub-day RFC 3339 timestamps passed through unmodified from the underlying provider.",
         "properties": {
           "startAt": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "description": "The earliest expected delivery timestamp (inclusive).",
+            "example": "2026-04-30T14:00:00Z"
           },
           "endAt": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "description": "The latest expected delivery timestamp (inclusive).",
+            "example": "2026-04-30T18:00:00Z"
           }
         },
         "required": [
@@ -243,30 +295,41 @@
       },
       "ShippingOption": {
         "type": "object",
+        "description": "A delivery estimate for one applicable shipping method. When the provider answered with a delivery window, `deliveryWindow` is populated and `nonDeliverableReason` is omitted. When the provider answered \"cannot deliver via this method\", `deliveryWindow` is omitted and `nonDeliverableReason` is populated.",
         "properties": {
           "shippingMethodId": {
             "type": "string",
+            "description": "The identifier of the shipping method (matches the B2C Commerce `ShippingMethod.ID`).",
+            "example": "GroundShipping",
             "maxLength": 256,
             "minLength": 1
           },
           "name": {
             "type": "string",
+            "description": "The localized name of the shipping method.",
+            "example": "Ground",
             "maxLength": 256,
             "minLength": 1
           },
           "description": {
             "type": "string",
+            "description": "The localized description of the shipping method.",
+            "example": "Standard ground shipping",
             "maxLength": 4000,
             "minLength": 1
           },
           "carrier": {
             "type": "string",
+            "description": "The carrier the provider resolved for this shipping method (for example, `UPS`, `FedEx`, `USPS`). May be omitted when the provider cannot or does not identify a single carrier.",
+            "example": "UPS",
             "maxLength": 256,
             "minLength": 1
           },
           "price": {
             "type": "number",
             "format": "double",
+            "description": "The estimated shipping cost for this shipping method, in the currency given by `currency`. May be omitted when the provider cannot or does not return a price.",
+            "example": 5.99,
             "minimum": 0
           },
           "currency": {
@@ -274,21 +337,27 @@
               {
                 "$ref": "#/components/schemas/CurrencyCode"
               }
-            ]
+            ],
+            "description": "The ISO 4217 currency code for `price`. Defaults to the site's default currency. Omitted when `price` is omitted."
           },
           "deliveryWindow": {
             "allOf": [
               {
                 "$ref": "#/components/schemas/DeliveryWindow"
               }
-            ]
+            ],
+            "description": "The estimated delivery window for this shipping method. Omitted when `nonDeliverableReason` is set."
           },
           "orderCutoffAt": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "description": "The latest timestamp by which an order must be placed for the `deliveryWindow` to apply. Clients compare this to the current time to decide whether the estimate is still valid. Omitted when not applicable. Sub-day RFC 3339 precision.",
+            "example": "2026-04-27T14:00:00Z"
           },
           "nonDeliverableReason": {
             "type": "string",
+            "description": "A SCREAMING_SNAKE_CASE code identifying why the provider could not deliver via this shipping method. This is not localized and not intended to be shown directly to shoppers. This field may be omitted when the provider cannot or does not identify a single reason. Provider implementations may emit additional codes. Omitted when `deliveryWindow` is set.",
+            "example": "INSUFFICIENT_INVENTORY",
             "maxLength": 256,
             "minLength": 1
           }
@@ -299,6 +368,7 @@
       },
       "ProductDeliveryEstimate": {
         "type": "object",
+        "description": "Delivery estimates for one product at a destination, broken down by applicable shipping method.",
         "properties": {
           "productId": {
             "$ref": "#/components/schemas/ProductId"
@@ -308,6 +378,7 @@
           },
           "shippingOptions": {
             "type": "array",
+            "description": "The array of shipping method estimates for the product at the destination. Each entry corresponds to one applicable shipping method.",
             "items": {
               "$ref": "#/components/schemas/ShippingOption"
             }
@@ -321,9 +392,11 @@
       },
       "DeliveryEstimatesResult": {
         "type": "object",
+        "description": "Result document containing per-product delivery estimates.",
         "properties": {
           "productDeliveryEstimates": {
             "type": "array",
+            "description": "The array of per-product delivery estimate entries, one per requested product that has estimates. The array is empty when the platform has no estimates for any of the requested products.",
             "items": {
               "$ref": "#/components/schemas/ProductDeliveryEstimate"
             }
@@ -339,17 +412,25 @@
         "properties": {
           "title": {
             "type": "string",
+            "description": "A short, human-readable summary of the problem\ntype.  It will not change from occurrence to occurrence of the \nproblem, except for purposes of localization\n",
+            "example": "You do not have enough credit",
             "maxLength": 256
           },
           "type": {
             "type": "string",
+            "description": "A URI reference [RFC3986] that identifies the\nproblem type.  This specification encourages that, when\ndereferenced, it provide human-readable documentation for the\nproblem type (e.g., using HTML [W3C.REC-html5-20141028]).  When\nthis member is not present, its value is assumed to be\n\"about:blank\". It accepts relative URIs; this means\nthat they must be resolved relative to the document's base URI, as\nper [RFC3986], Section 5.\n",
+            "example": "NotEnoughMoney",
             "maxLength": 2048
           },
           "detail": {
-            "type": "string"
+            "type": "string",
+            "description": "A human-readable explanation specific to this occurrence of the problem.",
+            "example": "Your current balance is 30, but that costs 50"
           },
           "instance": {
             "type": "string",
+            "description": "A URI reference that identifies the specific\noccurrence of the problem.  It may or may not yield further\ninformation if dereferenced.  It accepts relative URIs; this means\nthat they must be resolved relative to the document's base URI, as\nper [RFC3986], Section 5.\n",
+            "example": "/account/12345/msgs/abc",
             "maxLength": 2048
           }
         },
@@ -367,6 +448,11 @@
           "application/problem+json": {
             "schema": {
               "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "UnauthorizedExample": {
+                "$ref": "#/components/examples/UnauthorizedExample"
+              }
             }
           }
         }
@@ -376,88 +462,95 @@
       "organizationId": {
         "name": "organizationId",
         "in": "path",
+        "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "$ref": "#/components/schemas/OrganizationId"
-        }
+        },
+        "example": "f_ecom_zzxy_prd"
       },
       "productIds": {
         "name": "productIds",
         "in": "query",
+        "description": "The IDs of the products for which to retrieve delivery estimates. Each product must be online and site-assigned. Currently limited to one ID per request; multi-product support is reserved for a future release.",
         "required": true,
         "style": "form",
         "explode": false,
         "schema": {
           "type": "array",
+          "example": [
+            "apple-ipod-shuffle"
+          ],
           "items": {
             "$ref": "#/components/schemas/ProductId"
           },
           "maxItems": 1,
           "minItems": 1
-        }
+        },
+        "example": "apple-ipod-shuffle"
       },
       "postalCode": {
         "name": "postalCode",
         "in": "query",
+        "description": "The destination postal code for which to compute delivery estimates. Format depends on the destination country (for example, a 5-digit ZIP for US, a 6-character alphanumeric code for CA).",
         "required": true,
         "style": "form",
         "explode": true,
         "schema": {
           "type": "string",
+          "example": "10001",
           "maxLength": 20,
           "minLength": 1
-        }
+        },
+        "example": "10001"
       },
       "countryCode": {
         "name": "countryCode",
         "in": "query",
+        "description": "The destination country as an ISO 3166-1 alpha-2 country code (for example, `US`, `CA`, `GB`). Required for unambiguous resolution of the destination — postal codes are not globally unique.",
         "required": true,
         "style": "form",
         "explode": true,
         "schema": {
           "$ref": "#/components/schemas/CountryCode"
-        }
+        },
+        "example": "US"
       },
       "siteId": {
         "name": "siteId",
         "in": "query",
+        "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
         "required": true,
         "style": "form",
         "explode": true,
         "schema": {
           "$ref": "#/components/schemas/SiteId"
+        },
+        "examples": {
+          "SiteId": {
+            "value": "RefArch"
+          }
         }
       },
       "sfdcUsid": {
         "name": "sfdc_usid",
         "in": "header",
+        "description": "A unique shopper identifier (USID) for tracking client context.\nUsed with endpoints secured with ShopperClientContextToken.\nThis header is required for all endpoints secured with ShopperClientContextToken.",
         "required": false,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
-          "format": "uuid"
-        }
-      },
-      "sfdcDwDnt": {
-        "name": "sfdc_dw_dnt",
-        "in": "header",
-        "required": false,
-        "style": "simple",
-        "explode": false,
-        "schema": {
-          "type": "string",
-          "enum": [
-            "0",
-            "1"
-          ]
+          "format": "uuid",
+          "example": "550e8400-e29b-41d4-a716-446655440000"
         }
       },
       "personalized": {
         "name": "personalized",
         "in": "query",
+        "description": "Controls whether personalization is applied to the response. When set to `none`, the server skips applying personalization to the response.",
         "required": false,
         "style": "form",
         "explode": true,
@@ -465,12 +558,14 @@
           "type": "string",
           "enum": [
             "none"
-          ]
+          ],
+          "example": "none"
         }
       },
       "sfdcShopperContext": {
         "name": "sfdc_shopper_context",
         "in": "header",
+        "description": "Shopper context information (for example clientIP, sourceCode, and customQualifiers)\npassed in from a trusted backend application.",
         "required": false,
         "style": "simple",
         "explode": false,
@@ -479,9 +574,121 @@
         }
       }
     },
+    "examples": {
+      "GetDeliveryEstimatesResponseExample": {
+        "summary": "Happy path — one product with two shipping options, both deliverable.",
+        "value": {
+          "productDeliveryEstimates": [
+            {
+              "productId": "apple-ipod-shuffle",
+              "destination": {
+                "postalCode": "10001",
+                "countryCode": "US"
+              },
+              "shippingOptions": [
+                {
+                  "shippingMethodId": "GroundShipping",
+                  "name": "Ground",
+                  "description": "Standard ground shipping",
+                  "carrier": "UPS",
+                  "price": 5.99,
+                  "currency": "USD",
+                  "deliveryWindow": {
+                    "startAt": "2026-04-30T14:00:00Z",
+                    "endAt": "2026-04-30T18:00:00Z"
+                  },
+                  "orderCutoffAt": "2026-04-27T14:00:00Z"
+                },
+                {
+                  "shippingMethodId": "TwoDayShipping",
+                  "name": "Two-Day",
+                  "description": "Expedited air shipping",
+                  "carrier": "UPS",
+                  "price": 12.99,
+                  "currency": "USD",
+                  "deliveryWindow": {
+                    "startAt": "2026-04-28T09:00:00Z",
+                    "endAt": "2026-04-28T17:00:00Z"
+                  },
+                  "orderCutoffAt": "2026-04-26T18:00:00Z"
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "GetDeliveryEstimatesPartialResponseExample": {
+        "summary": "One shipping option is deliverable, another is not. Methods that cannot deliver for a particular reason are kept in the response with `nonDeliverableReason` populated.",
+        "value": {
+          "productDeliveryEstimates": [
+            {
+              "productId": "apple-ipod-shuffle",
+              "destination": {
+                "postalCode": "10001",
+                "countryCode": "US"
+              },
+              "shippingOptions": [
+                {
+                  "shippingMethodId": "GroundShipping",
+                  "name": "Ground",
+                  "description": "Standard ground shipping",
+                  "carrier": "UPS",
+                  "price": 5.99,
+                  "currency": "USD",
+                  "deliveryWindow": {
+                    "startAt": "2026-04-30T14:00:00Z",
+                    "endAt": "2026-04-30T18:00:00Z"
+                  },
+                  "orderCutoffAt": "2026-04-27T14:00:00Z"
+                },
+                {
+                  "shippingMethodId": "OvernightShipping",
+                  "name": "Overnight",
+                  "description": "Priority overnight shipping",
+                  "carrier": "UPS",
+                  "nonDeliverableReason": "INSUFFICIENT_INVENTORY"
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "GetDeliveryEstimatesEmptyResponseExample": {
+        "summary": "No estimates available — for example, when the provider returned an empty result.",
+        "value": {
+          "productDeliveryEstimates": []
+        }
+      },
+      "GetDeliveryEstimatesBadRequestResponseExample": {
+        "summary": "A required parameter is missing or has an invalid value.",
+        "value": {
+          "title": "Bad Request",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/validation",
+          "detail": "The 'postalCode' parameter is required."
+        }
+      },
+      "UnauthorizedExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/unauthorized",
+          "title": "Unauthorized",
+          "detail": "Unauthorized request"
+        }
+      },
+      "GetDeliveryEstimatesProductNotFoundResponseExample": {
+        "summary": "The supplied `productId` does not resolve to an online, site-assigned product.",
+        "value": {
+          "title": "Product Not Found",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/product-not-found",
+          "detail": "No product with ID 'apple-ipod-shuffle' for site 'SiteGenesis' could be found.",
+          "productId": "apple-ipod-shuffle",
+          "siteId": "SiteGenesis"
+        }
+      }
+    },
     "securitySchemes": {
       "ShopperToken": {
         "type": "oauth2",
+        "description": "ShopperToken authentication follows the authorization code grant flow, as defined by the OAuth 2.1 standard. Depending on the type of OAuth client (public or private), this authorization flow has further requirements.\nFor a detailed description of the authorization flow, see the [SLAS overview](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-login:Summary).\nA shopper token allows you to access the Shopper API endpoints of both OCAPI and the B2C Commerce API. These endpoints can be used to build headless storefronts and other applications.\nThe `ShopperToken` security scheme is a parent of other security schemes, such as `ShopperTokenTsob`. A Shopper API endpoint can require a specific child scheme (`ShopperTokenTsob`, for example) that cannot be accessed with a regular shopper token.\n",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://{shortCode}.api.commercecloud.salesforce.com/shopper/auth/v1/organizations/{organizationId}/oauth2/token",
@@ -502,6 +709,7 @@
       },
       "ShopperClientContextToken": {
         "type": "oauth2",
+        "description": "ShopperClientContextToken is a separate security scheme used to track and validate client context information.\nIt is valid for Guest shoppers flows only using SLAS private clients. For registered shoppers, use existing ShopperToken flows.\nFor authentication details, see the [SLAS overview](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-login:Summary).\nThis token allows access to Shopper API endpoints for guest shoppers only.\n",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://{shortCode}.api.commercecloud.salesforce.com/shopper/auth/v1/organizations/{organizationId}/oauth2/token?hint=client_context",