Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Document the delivery vocabulary and pickup decisions

Damian Legawiec662cdd00d37e
diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yaml
index 8f82b2b599..f73bff88f8 100644
--- a/docs/api-reference/store.yaml
+++ b/docs/api-reference/store.yaml
@@ -87,16 +87,16 @@ paths:
content:
application/json:
example:
- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjcwYTg1MDZiLWRiYzctNGQ2OC04OWFhLWM4MjZlZGVlYmE3MiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1NDA3MjMwfQ.n_8sGI0eQbOzVSBJL18XoGBgv5NapILsf3TbBWT3L6w
- refresh_token: jiAaFWbv6NzsuzGuwVdpg6qV
+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImNiNmExMDhjLWU0MDgtNDYwZC1hY2Q2LWM3ZjBkMzJhYmI3YiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1Njg5NTQwfQ.Kf0_wruSOfek_CzG54sWQkMQKYydm69S_sSuqW41rKY
+ refresh_token: 7ZvuLmhuiz39K2yy6GeD95ka
user:
id: cus_UkLWZg9DAJ
- first_name: Rickie
- last_name: Dicki
+ first_name: Wilbur
+ last_name: Anderson
phone:
accepts_email_marketing: false
- full_name: Rickie Dicki
+ full_name: Wilbur Anderson
available_store_credit_total: '0'
display_available_store_credit_total: "$0.00"
addresses: []
@@ -194,16 +194,16 @@ paths:
content:
application/json:
example:
- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjNmMTE1NDQzLWUyODEtNGZmMS1iZDdiLWQzMjk1OWRiZGI1MSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1NDA3MjMxfQ.g0Mu4IYCLtnokuoPJQd-aSkMdRZp5G-raUqQqmV1lds
- refresh_token: kpBKDNbZ52Ycime6HyR3Ctzg
+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjRjMmM0ZmJjLWE0OGUtNDcyMi04NzA1LTNiZjkyYzI0ZGE5ZSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1Njg5NTQxfQ.-h7xkGieDvKHg4YEzxHOVfHFY10a0nRzheeOdPDNf78
+ refresh_token: 2zG2gncedPHeHaRu7xCWJ9x9
user:
id: cus_UkLWZg9DAJ
- first_name: Faviola
- last_name: Feil
+ first_name: Sharri
+ last_name: Bartoletti
phone:
accepts_email_marketing: false
- full_name: Faviola Feil
+ full_name: Sharri Bartoletti
available_store_credit_total: '0'
display_available_store_credit_total: "$0.00"
addresses: []
@@ -393,16 +393,16 @@ paths:
content:
application/json:
example:
- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjdjNWI0NTBhLTUxMDAtNGZlZS05OWI2LWU3YWQyZmZjMTAyZiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1NDA3MjQyfQ.Zov_hoNr0AoT-3ZOKAU6N4QoOM7X2i-56qjwFh0jypE
- refresh_token: Y2eoyio66dEsdpK4zpGXoukt
+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImU5ZGI3OTUzLWMyZjEtNGVjMC1iZjYzLWVmMzNmN2E2MWM2NyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1Njg5NTU0fQ.sIIkYyUUxv24SPNgnVGnqZ2jC0UsF4YwV1GDq9GlYRc
+ refresh_token: uSCGGTtw72n1tjoUAgqBeFp2
user:
id: cus_UkLWZg9DAJ
- first_name: Shalon
- last_name: Bins
+ first_name: Cleotilde
+ last_name: Becker
phone:
accepts_email_marketing: false
- full_name: Shalon Bins
+ full_name: Cleotilde Becker
available_store_credit_total: '0'
display_available_store_credit_total: "$0.00"
addresses: []
@@ -879,8 +879,8 @@ paths:
example:
data:
- id: prod_UkLWZg9DAJ
- name: Product 128772
- slug: product-128772
+ name: Product 1296942
+ slug: product-1296942
meta_title:
meta_description:
meta_keywords:
@@ -892,25 +892,21 @@ paths:
in_stock: false
backorderable: true
available: true
- description: Occaecati perferendis at tenetur accusamus atque nostrum
- ea. Facere nesciunt impedit atque doloremque necessitatibus. Eveniet
- distinctio dolorum officia asperiores explicabo quidem incidunt.
- Distinctio dolore laboriosam laudantium ab ipsam. Dolorem quo
- cum fuga repellat temporibus ut laudantium asperiores. Dolorem
- est eius quisquam corrupti. Itaque expedita cumque vel minima
- nostrum laboriosam numquam laborum. Eveniet expedita unde nulla
- nobis cupiditate dignissimos minus provident. Excepturi sed nostrum
- iusto recusandae corrupti. Quia labore alias laboriosam fugiat.
- Dolore qui quia quam eos autem impedit odio sint. Minima eos distinctio
- eum enim. Maxime inventore quisquam architecto quasi error. Mollitia
- vel ipsam doloremque quis animi ipsum sint aliquid. Labore veritatis
- iusto neque consectetur. Labore nam minus voluptatum nobis alias
- qui. Vitae voluptatem nesciunt ut ipsa tempora.
+ description: Blanditiis nesciunt laborum voluptatibus voluptas voluptate.
+ Debitis voluptatibus consequuntur error assumenda totam doloremque.
+ Maxime fugit tempore cupiditate ipsam earum voluptas aperiam nemo.
+ Saepe mollitia fugit iure minus neque iste quam. Error nam sequi
+ repellendus necessitatibus sit. Ipsum deleniti labore amet culpa.
+ Totam aut neque quibusdam maxime nihil magni laboriosam molestias.
+ Incidunt architecto quibusdam atque accusantium veniam perspiciatis
+ recusandae nisi. Nam temporibus in odio harum atque suscipit fugiat.
+ Placeat pariatur laboriosam voluptates fuga. Ut accusantium saepe
+ architecto aperiam. Necessitatibus nesciunt enim atque quia. Quos
+ voluptas eveniet quasi labore.
description_html: |-
- Occaecati perferendis at tenetur accusamus atque nostrum ea. Facere nesciunt impedit atque doloremque necessitatibus. Eveniet distinctio dolorum officia asperiores explicabo quidem incidunt. Distinctio dolore laboriosam laudantium ab ipsam. Dolorem quo cum fuga repellat temporibus ut laudantium asperiores.
- Dolorem est eius quisquam corrupti. Itaque expedita cumque vel minima nostrum laboriosam numquam laborum. Eveniet expedita unde nulla nobis cupiditate dignissimos minus provident. Excepturi sed nostrum iusto recusandae corrupti. Quia labore alias laboriosam fugiat.
- Dolore qui quia quam eos autem impedit odio sint. Minima eos distinctio eum enim. Maxime inventore quisquam architecto quasi error. Mollitia vel ipsam doloremque quis animi ipsum sint aliquid.
- Labore veritatis iusto neque consectetur. Labore nam minus voluptatum nobis alias qui. Vitae voluptatem nesciunt ut ipsa tempora.
+ Blanditiis nesciunt laborum voluptatibus voluptas voluptate. Debitis voluptatibus consequuntur error assumenda totam doloremque. Maxime fugit tempore cupiditate ipsam earum voluptas aperiam nemo. Saepe mollitia fugit iure minus neque iste quam. Error nam sequi repellendus necessitatibus sit.
+ Ipsum deleniti labore amet culpa. Totam aut neque quibusdam maxime nihil magni laboriosam molestias. Incidunt architecto quibusdam atque accusantium veniam perspiciatis recusandae nisi. Nam temporibus in odio harum atque suscipit fugiat. Placeat pariatur laboriosam voluptates fuga.
+ Ut accusantium saepe architecto aperiam. Necessitatibus nesciunt enim atque quia. Quos voluptas eveniet quasi labore.
default_variant_id: variant_UkLWZg9DAJ
thumbnail_url:
tags: []
@@ -1065,8 +1061,8 @@ paths:
example:
data:
- id: prod_UkLWZg9DAJ
- name: Product 170964
- slug: product-170964
+ name: Product 1718168
+ slug: product-1718168
meta_title:
meta_description:
meta_keywords:
@@ -1095,8 +1091,8 @@ paths:
price_list_id:
original_price:
- id: prod_gbHJdmfrXB
- name: Product 1715062
- slug: product-1715062
+ name: Product 1725738
+ slug: product-1725738
meta_title:
meta_description:
meta_keywords:
@@ -1108,20 +1104,24 @@ paths:
in_stock: false
backorderable: true
available: true
- description: Enim libero repellendus pariatur hic natus mollitia
- rem porro. Ullam recusandae labore vel dolore et cumque voluptatum.
- Vitae expedita dicta quia laboriosam officia tempora corrupti.
- Optio repudiandae a tenetur at molestias. Vel itaque distinctio
- similique recusandae. Fugit laudantium tempora commodi facilis.
- Deleniti optio dolorum incidunt voluptates nam dolorem. Sint molestiae
- iste commodi velit. Ut unde dolores iste deleniti. Sequi perferendis
- nostrum ut culpa ad laudantium hic. Sequi occaecati dignissimos
- et soluta eum dolore. Nulla error porro id veniam dolor laboriosam
- fugit.
+ description: Tempora esse nulla dolorum earum labore ipsa culpa.
+ Id dolorem minus assumenda ut. Ipsa iste nostrum quia veniam eveniet
+ qui expedita nobis. Velit neque fugit odio modi fuga. Illum atque
+ tenetur culpa ducimus maiores earum voluptatum odio. Cumque facilis
+ a eos quis maxime provident sunt. Nobis ratione architecto et
+ doloremque adipisci. Veritatis architecto eveniet quibusdam tenetur
+ eius aspernatur quaerat. Repellendus velit dolorem deleniti alias
+ hic pariatur illum. Veritatis impedit voluptate nulla quis saepe.
+ Itaque maxime sed pariatur mollitia impedit. Voluptate vero quidem
+ qui omnis natus. Officia quibusdam delectus nemo ipsum quo aliquid
+ voluptatum. Doloremque consequuntur ea voluptatem dignissimos.
+ Quos unde suscipit quasi quae ipsam. Iusto aperiam praesentium
+ earum deleniti est maiores. Esse qui dignissimos commodi eos.
description_html: |-
- Enim libero repellendus pariatur hic natus mollitia rem porro. Ullam recusandae labore vel dolore et cumque voluptatum. Vitae expedita dicta quia laboriosam officia tempora corrupti. Optio repudiandae a tenetur at molestias.
- Vel itaque distinctio similique recusandae. Fugit laudantium tempora commodi facilis. Deleniti optio dolorum incidunt voluptates nam dolorem. Sint molestiae iste commodi velit.
- Ut unde dolores iste deleniti. Sequi perferendis nostrum ut culpa ad laudantium hic. Sequi occaecati dignissimos et soluta eum dolore. Nulla error porro id veniam dolor laboriosam fugit.
+ Tempora esse nulla dolorum earum labore ipsa culpa. Id dolorem minus assumenda ut. Ipsa iste nostrum quia veniam eveniet qui expedita nobis. Velit neque fugit odio modi fuga. Illum atque tenetur culpa ducimus maiores earum voluptatum odio.
+ Cumque facilis a eos quis maxime provident sunt. Nobis ratione architecto et doloremque adipisci. Veritatis architecto eveniet quibusdam tenetur eius aspernatur quaerat. Repellendus velit dolorem deleniti alias hic pariatur illum. Veritatis impedit voluptate nulla quis saepe.
+ Itaque maxime sed pariatur mollitia impedit. Voluptate vero quidem qui omnis natus. Officia quibusdam delectus nemo ipsum quo aliquid voluptatum. Doloremque consequuntur ea voluptatem dignissimos.
+ Quos unde suscipit quasi quae ipsam. Iusto aperiam praesentium earum deleniti est maiores. Esse qui dignissimos commodi eos.
default_variant_id: variant_EfhxLZ9ck8
thumbnail_url:
tags: []
@@ -1223,8 +1223,8 @@ paths:
application/json:
example:
id: prod_UkLWZg9DAJ
- name: Product 1985523
- slug: product-1985523
+ name: Product 1992472
+ slug: product-1992472
meta_title:
meta_description:
meta_keywords:
@@ -1258,7 +1258,7 @@ paths:
amount_in_cents: 999
currency: USD
display_amount: "$9.99"
- recorded_at: '2026-07-15T09:27:59Z'
+ recorded_at: '2026-07-18T15:53:13Z'
schema:
"$ref": "#/components/schemas/Product"
'404':
@@ -1506,12 +1506,13 @@ paths:
- id: cart_gbHJdmfrXB
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: Ut4FpVPEsbA3RJBcXi8cgrwH
- token: Ut4FpVPEsbA3RJBcXi8cgrwH
+ preferred_stock_location_id:
+ number: cart_gbHJdmfrXB
+ token: M8ZCMLQqoQuxuwp9ejYcHwaM
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -1541,16 +1542,20 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
+ - code: ship_address_required
+ step: address
field: ship_address
message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -1562,8 +1567,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1039670
- slug: product-1039670
+ name: Product 1043676
+ slug: product-1043676
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -1606,12 +1611,13 @@ paths:
- id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: Bpkte1VqjPM9v6q3xJ621kgY
- token: Bpkte1VqjPM9v6q3xJ621kgY
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: YacMCCRLwubB7A1efKsJLQiV
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -1635,22 +1641,26 @@ paths:
display_amount_due: "$10.00"
delivery_total: '0.0'
display_delivery_total: "$0.00"
- store_credit_total: '0.0'
+ store_credit_total: '0'
display_store_credit_total: "$0.00"
covered_by_store_credit: false
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
+ - code: ship_address_required
+ step: address
field: ship_address
message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -1662,8 +1672,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1021882
- slug: product-1021882
+ name: Product 1032165
+ slug: product-1032165
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -1779,8 +1789,9 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: b87m9LpQPQJaCk3XpCWcQm4T
- token: b87m9LpQPQJaCk3XpCWcQm4T
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: jeF9EAJtimKwRY3ZNZjioqrC
email:
customer_note:
currency: USD
@@ -1814,15 +1825,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: cart
+ - code: line_items_required
+ step: cart
field: line_items
message: Add at least one item to your cart
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
shipping_eq_billing_address: true
discounts: []
items: []
@@ -1944,16 +1954,17 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: nYhFVBUvpnjkrfJjCpq1j2GM
- token: nYhFVBUvpnjkrfJjCpq1j2GM
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: xKE2yijxuYf7LKfEkUQ7QepM
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 0
warnings:
- code: line_item_removed
- message: Product 1072601 was removed because it was sold out
+ message: Product 1084189 was removed because it was sold out
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
coupon_code:
@@ -1983,15 +1994,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: cart
+ - code: line_items_required
+ step: cart
field: line_items
message: Add at least one item to your cart
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
shipping_eq_billing_address: true
discounts: []
items: []
@@ -2094,12 +2104,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: Pe115jSD8Zr6E9YX652C2wHg
- token: Pe115jSD8Zr6E9YX652C2wHg
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: Qbf1sYyBXrJASA1oX3Smizjh
email:
customer_note: Leave at door
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -2129,16 +2140,16 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -2150,8 +2161,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1082693
- slug: product-1082693
+ name: Product 1096752
+ slug: product-1096752
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -2368,12 +2379,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: pAQ5SyiHadx2XvwSGVnbG6mm
- token: pAQ5SyiHadx2XvwSGVnbG6mm
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: W69Lk7NSMgJpQDSKZtjaYGpL
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -2404,10 +2416,12 @@ paths:
completed_steps:
- address
requirements:
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: false
@@ -2419,8 +2433,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1101175
- slug: product-1101175
+ name: Product 1113151
+ slug: product-1113151
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -2450,7 +2464,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 122 Lovely Street
+ address1: 124 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -2469,7 +2483,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 121 Lovely Street
+ address1: 123 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -2574,8 +2588,8 @@ paths:
market_id: mkt_UkLWZg9DAJ
cart_id: cart_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: R950657927
+ number: R723930495
customer_note:
currency: USD
locale: en
@@ -2583,7 +2597,7 @@ paths:
coupon_code:
fulfillment_status: backorder
payment_status: paid
- completed_at: '2026-07-30T09:27:15.931Z'
+ completed_at: '2026-08-02T15:52:26.477Z'
item_total: '10.0'
display_item_total: "$10.00"
adjustment_total: '0.0'
@@ -2615,8 +2629,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1136620
- slug: product-1136620
+ name: Product 1142075
+ slug: product-1142075
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -2641,7 +2655,7 @@ paths:
digital_links: []
fulfillments:
- id: ful_gbHJdmfrXB
- number: F06002189648
+ number: F35697571850
tracking:
tracking_url:
pickup_point_data:
@@ -2675,7 +2689,7 @@ paths:
stock_location:
id: sloc_UkLWZg9DAJ
state_abbr: NY
- name: Andria Mueller
+ name: Cecilia Wolff
address1: 1600 Pennsylvania Ave NW
city: Washington
zipcode: '20500'
@@ -2707,8 +2721,8 @@ paths:
payments:
- id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: BGS-80032fa14b73
- number: P3GGMOJS
+ response_code: BGS-c05fdddc07bd
+ number: PS50A10G
amount: '20.0'
display_amount: "$20.00"
status: completed
@@ -2735,7 +2749,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 128 Lovely Street
+ address1: 130 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -2754,7 +2768,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 127 Lovely Street
+ address1: 129 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -2789,13 +2803,12 @@ paths:
example:
error:
code: cart_cannot_complete
- message: '{code: "validation_failed", errors: [{step: "address",
- field: "email", message: "Email address is required", code: "email_required"},
- {step: "address", field: "ship_address", message: "Shipping address
- is required", code: "ship_address_required"}, {step: "delivery",
- field: "shipping_method", message: "Select a shipping method for
- all shipments", code: "shipping_method_required"}, {step: "payment",
- field: "payment", message: "Add a payment method", code: "payment_required"}]}'
+ message: '{code: "validation_failed", errors: [{code: "email_required",
+ step: "address", field: "email", message: "Email address is required"},
+ {code: "delivery_method_required", step: "delivery", field: "delivery_method",
+ message: "Select a delivery method for all fulfillments"}, {code:
+ "payment_required", step: "payment", field: "payment", message:
+ "Add a payment method"}]}'
schema:
"$ref": "#/components/schemas/ErrorResponse"
"/api/v3/store/carts/{cart_id}/discount_codes":
@@ -2863,12 +2876,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: ZaRUDiZyTSsPWhtpZFyk19Ad
- token: ZaRUDiZyTSsPWhtpZFyk19Ad
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: Zdby4vYgmmgMzfoGwWFo2X5D
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code: save10
@@ -2898,15 +2912,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
shipping_eq_billing_address: true
discounts:
- id: discount_UkLWZg9DAJ
@@ -2923,8 +2936,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1396776
- slug: product-1396776
+ name: Product 140284
+ slug: product-140284
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -3051,12 +3064,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: ZrqgEJvWvKkz38gUECP5kSDS
- token: ZrqgEJvWvKkz38gUECP5kSDS
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: b895qS1guEhczxpJaPnL1gAs
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -3086,16 +3100,16 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -3107,8 +3121,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1414971
- slug: product-1414971
+ name: Product 1424036
+ slug: product-1424036
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -3224,12 +3238,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: LXmaMUaXc3DghntxU62byL4P
- token: LXmaMUaXc3DghntxU62byL4P
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: ev7uws7dAHNdVD9iCeEwC95F
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -3261,7 +3276,8 @@ paths:
- address
- delivery
requirements:
- - step: payment
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: false
@@ -3273,8 +3289,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1436032
- slug: product-1436032
+ name: Product 1443241
+ slug: product-1443241
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -3299,7 +3315,7 @@ paths:
digital_links: []
fulfillments:
- id: ful_UkLWZg9DAJ
- number: F03626998098
+ number: F96156119158
tracking:
tracking_url:
pickup_point_data:
@@ -3333,7 +3349,7 @@ paths:
stock_location:
id: sloc_UkLWZg9DAJ
state_abbr: NY
- name: Melda Jast
+ name: Shawn Deckow
address1: 1600 Pennsylvania Ave NW
city: Washington
zipcode: '20500'
@@ -3369,7 +3385,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 185 Lovely Street
+ address1: 187 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -3486,12 +3502,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: aFdjtFqsUH8dM1iwfvCkYeeD
- token: aFdjtFqsUH8dM1iwfvCkYeeD
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: pUzi2ZKFBkY6HAdFqUXudMsr
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -3521,15 +3538,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
shipping_eq_billing_address: true
discounts: []
items:
@@ -3539,8 +3555,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1456011
- slug: product-1456011
+ name: Product 1461925
+ slug: product-1461925
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -3567,8 +3583,8 @@ paths:
payments:
- id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: 1-SC-20260730092734059913
- number: PIEX367H
+ response_code: 1-SC-20260802155247025534
+ number: PKCSTMZV
amount: '10.0'
display_amount: "$10.00"
status: checkout
@@ -3722,12 +3738,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: zqaxrhRXhGD49LizWMQbUhCV
- token: zqaxrhRXhGD49LizWMQbUhCV
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: DV1AEBmKcY6EHa2SEGT96LPb
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -3757,16 +3774,16 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -3778,8 +3795,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1496441
- slug: product-1496441
+ name: Product 1503963
+ slug: product-1503963
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -3806,8 +3823,8 @@ paths:
payments:
- id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: 1-SC-20260730092736400336
- number: PA4WQKVY
+ response_code: 1-SC-20260802155249558897
+ number: PXJWX1K6
amount: '10.0'
display_amount: "$10.00"
status: invalid
@@ -3912,19 +3929,20 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: V8KuewrwWQZdHRaXVrNMJUg6
- token: V8KuewrwWQZdHRaXVrNMJUg6
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: scCHtyUPv6EbMqf8RrQzQsWL
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 2
warnings:
- code: delivery_unavailable
- message: Product 1522216 cannot be delivered to the selected address
+ message: Product 1533455 cannot be delivered to the selected address
line_item_id: li_UkLWZg9DAJ
- code: delivery_unavailable
- message: Product 1532513 cannot be delivered to the selected address
+ message: Product 1544895 cannot be delivered to the selected address
line_item_id: li_gbHJdmfrXB
coupon_code:
item_total: '29.99'
@@ -3953,16 +3971,16 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -3974,8 +3992,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1522216
- slug: product-1522216
+ name: Product 1533455
+ slug: product-1533455
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -4004,8 +4022,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1532513
- slug: product-1532513
+ name: Product 1544895
+ slug: product-1544895
options_text: ''
price: '19.99'
display_price: "$19.99"
@@ -4141,12 +4159,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: 7MGiLwH4EJZJwHomX9k4fEU8
- token: 7MGiLwH4EJZJwHomX9k4fEU8
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: BFy2af9khZmgGjmjB9Rcgyv9
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 0
warnings: []
coupon_code:
@@ -4176,15 +4195,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
shipping_eq_billing_address: true
discounts: []
items:
@@ -4194,8 +4212,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1563062
- slug: product-1563062
+ name: Product 157125
+ slug: product-157125
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -4311,12 +4329,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: AKP1NnKYUezHrgChwp8hxpMQ
- token: AKP1NnKYUezHrgChwp8hxpMQ
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: DHW9eLpepbaQP6y2G1poDLuR
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 0
warnings: []
coupon_code:
@@ -4346,15 +4365,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: cart
+ - code: line_items_required
+ step: cart
field: line_items
message: Add at least one item to your cart
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
shipping_eq_billing_address: true
discounts: []
items: []
@@ -4453,9 +4471,9 @@ paths:
id: ps_gbHJdmfrXB
status: pending
currency: USD
- external_id: bogus_31dbf05af6b91955da709a27
+ external_id: bogus_9bafc6836694b545af8631e4
external_data:
- client_secret: bogus_secret_c345aa70f7f0244a
+ client_secret: bogus_secret_4bf077ada4b9798e
customer_external_id:
expires_at:
amount: '10.0'
@@ -4554,7 +4572,7 @@ paths:
id: ps_UkLWZg9DAJ
status: pending
currency: USD
- external_id: bogus_edb0a2b2cb6227148bf7af7a
+ external_id: bogus_517198bad7366d11635637cd
external_data:
client_secret: secret_123
customer_external_id:
@@ -4617,7 +4635,7 @@ paths:
id: ps_UkLWZg9DAJ
status: pending
currency: USD
- external_id: bogus_83fa626fcc4a2b63cb6c9870
+ external_id: bogus_93fdfd4312cced1d46ecf89d
external_data:
client_secret: secret_123
customer_external_id:
@@ -4720,7 +4738,7 @@ paths:
id: ps_UkLWZg9DAJ
status: completed
currency: USD
- external_id: bogus_dbf16d0c848bb8c2d9dc2144
+ external_id: bogus_64cbc509a0d2c624c09ba075
external_data:
client_secret: secret_123
customer_external_id:
@@ -4819,7 +4837,7 @@ paths:
id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
response_code:
- number: P5E7EZW0
+ number: PRE0CVBT
amount: '10.0'
display_amount: "$10.00"
status: checkout
@@ -4926,12 +4944,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: A9Fugrxk8c8Xwo52imzW7em3
- token: A9Fugrxk8c8Xwo52imzW7em3
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: XzSDDRewu7YWcnFbxRK1gZUX
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -4961,15 +4980,14 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
shipping_eq_billing_address: true
discounts: []
items:
@@ -4979,8 +4997,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 2183838
- slug: product-2183838
+ name: Product 219654
+ slug: product-219654
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -5007,8 +5025,8 @@ paths:
payments:
- id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: 1-SC-20260730092805247846
- number: PVC553AW
+ response_code: 1-SC-20260802155318675007
+ number: PIQG4YHH
amount: '10.0'
display_amount: "$10.00"
status: checkout
@@ -5126,12 +5144,13 @@ paths:
id: cart_UkLWZg9DAJ
market_id: mkt_UkLWZg9DAJ
channel_id: ch_UkLWZg9DAJ
- number: ExfaVJfhqHsn2NX2t9YxF62D
- token: ExfaVJfhqHsn2NX2t9YxF62D
+ preferred_stock_location_id:
+ number: cart_UkLWZg9DAJ
+ token: wsQsrMWYnzGuMEw7xLbyJtjY
email:
customer_note:
currency: USD
- locale:
+ locale: en
total_quantity: 1
warnings: []
coupon_code:
@@ -5161,16 +5180,16 @@ paths:
current_step: address
completed_steps: []
requirements:
- - step: address
+ - code: email_required
+ step: address
field: email
message: Email address is required
- - step: address
- field: ship_address
- message: Shipping address is required
- - step: delivery
- field: shipping_method
- message: Select a shipping method for all shipments
- - step: payment
+ - code: delivery_method_required
+ step: delivery
+ field: delivery_method
+ message: Select a delivery method for all fulfillments
+ - code: payment_required
+ step: payment
field: payment
message: Add a payment method
shipping_eq_billing_address: true
@@ -5182,8 +5201,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 220908
- slug: product-220908
+ name: Product 2212559
+ slug: product-2212559
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -5298,7 +5317,7 @@ paths:
market_id: mkt_UkLWZg9DAJ
cart_id:
channel_id: ch_UkLWZg9DAJ
- number: R063098125
+ number: R346932621
customer_note:
currency: USD
@@ -5307,7 +5326,7 @@ paths:
coupon_code:
fulfillment_status:
payment_status:
- completed_at: '2026-07-30T09:27:48.538Z'
+ completed_at: '2026-08-02T15:53:01.938Z'
item_total: '10.0'
display_item_total: "$10.00"
adjustment_total: '0.0'
@@ -5339,8 +5358,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1603880
- slug: product-1603880
+ name: Product 1616147
+ slug: product-1616147
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -5365,7 +5384,7 @@ paths:
digital_links: []
fulfillments:
- id: ful_UkLWZg9DAJ
- number: F01766723833
+ number: F11951108951
tracking: U10000
tracking_url:
pickup_point_data:
@@ -5399,7 +5418,7 @@ paths:
stock_location:
id: sloc_UkLWZg9DAJ
state_abbr: NY
- name: Joan Schowalter
+ name: Roy Zieme
address1: 1600 Pennsylvania Ave NW
city: Washington
zipcode: '20500'
@@ -5434,7 +5453,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 237 Lovely Street
+ address1: 239 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -5453,7 +5472,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 238 Lovely Street
+ address1: 240 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -5553,7 +5572,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 88 Lovely Street
+ address1: 90 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -5571,7 +5590,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 87 Lovely Street
+ address1: 89 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -5589,7 +5608,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 86 Lovely Street
+ address1: 88 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -5838,7 +5857,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 100 Lovely Street
+ address1: 102 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -5913,7 +5932,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 106 Lovely Street
+ address1: 108 Lovely Street
address2: Northwest
postal_code: '10118'
city: Los Angeles
@@ -6351,8 +6370,8 @@ paths:
market_id: mkt_UkLWZg9DAJ
cart_id:
channel_id: ch_UkLWZg9DAJ
- number: R059426856
+ number: R420642829
customer_note:
currency: USD
locale: en
@@ -6360,7 +6379,7 @@ paths:
coupon_code:
fulfillment_status:
payment_status:
- completed_at: '2026-07-30T09:27:23.674Z'
+ completed_at: '2026-08-02T15:52:35.065Z'
item_total: '10.0'
display_item_total: "$10.00"
adjustment_total: '0.0'
@@ -6392,8 +6411,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1299675
- slug: product-1299675
+ name: Product 1303266
+ slug: product-1303266
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -6418,7 +6437,7 @@ paths:
digital_links: []
fulfillments:
- id: ful_UkLWZg9DAJ
- number: F36429200953
+ number: F03224906213
tracking: U10000
tracking_url:
pickup_point_data:
@@ -6452,7 +6471,7 @@ paths:
stock_location:
id: sloc_UkLWZg9DAJ
state_abbr: NY
- name: Zachary Harvey
+ name: Marti Schoen
address1: 1600 Pennsylvania Ave NW
city: Washington
zipcode: '20500'
@@ -6487,7 +6506,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 145 Lovely Street
+ address1: 147 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -6506,7 +6525,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 146 Lovely Street
+ address1: 148 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -6629,8 +6648,8 @@ paths:
market_id: mkt_UkLWZg9DAJ
cart_id:
channel_id: ch_UkLWZg9DAJ
- number: R051467067
+ number: R343951215
customer_note:
currency: USD
locale: en
@@ -6638,7 +6657,7 @@ paths:
coupon_code:
fulfillment_status:
payment_status:
- completed_at: '2026-07-30T09:27:24.338Z'
+ completed_at: '2026-08-02T15:52:36.278Z'
item_total: '10.0'
display_item_total: "$10.00"
adjustment_total: '0.0'
@@ -6670,8 +6689,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 1314814
- slug: product-1314814
+ name: Product 1327942
+ slug: product-1327942
options_text: ''
price: '10.0'
display_price: "$10.00"
@@ -6696,7 +6715,7 @@ paths:
digital_links: []
fulfillments:
- id: ful_UkLWZg9DAJ
- number: F90903986478
+ number: F14879759522
tracking: U10000
tracking_url:
pickup_point_data:
@@ -6730,7 +6749,7 @@ paths:
stock_location:
id: sloc_UkLWZg9DAJ
state_abbr: NY
- name: Amee Sanford
+ name: Thurman Mante
address1: 1600 Pennsylvania Ave NW
city: Washington
zipcode: '20500'
@@ -6765,7 +6784,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 151 Lovely Street
+ address1: 153 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -6784,7 +6803,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 152 Lovely Street
+ address1: 154 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -6863,8 +6882,8 @@ paths:
content:
application/json:
example:
- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjUwNjhjOGM3LThlOTUtNGRlZC04OTM1LTY2MWRmZTE0OTI2YiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1NDA3MjQ1fQ.Ejn2gkrnUNV6Hp3JmrpBS8Km1sxkiWOvFhJit3pqpVI
- refresh_token: cFrTm9BXTubEExhK3KUhW1Cr
+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6Ijc2MmMxZjE3LTlkYTUtNGI5NS05YTMzLTg2YmVhNzg0YmI3NSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1Njg5NTU4fQ.OUwdrG80xkRWcYOF29Hi7pFKNi_4P5YG-IMUTDn07j4
+ refresh_token: kcxnihfMtLi3CoWGDAyTmzPD
user:
id: cus_UkLWZg9DAJ
@@ -6881,10 +6900,10 @@ paths:
newsletter_subscriber:
id: sub_UkLWZg9DAJ
- created_at: '2026-07-30T09:27:25.517Z'
- updated_at: '2026-07-30T09:27:25.518Z'
+ created_at: '2026-08-02T15:52:37.939Z'
+ updated_at: '2026-08-02T15:52:37.940Z'
verified: true
- verified_at: '2026-07-30T09:27:25Z'
+ verified_at: '2026-08-02T15:52:37Z'
customer_id: cus_UkLWZg9DAJ
customer_groups: []
schema:
@@ -6987,12 +7006,12 @@ paths:
application/json:
example:
id: cus_UkLWZg9DAJ
- first_name: Irmgard
- last_name: Pagac
+ first_name: Suzi
+ last_name: Murray
phone: 555-555-0199
accepts_email_marketing: false
- full_name: Irmgard Pagac
+ full_name: Suzi Murray
available_store_credit_total: '0'
display_available_store_credit_total: "$0.00"
addresses:
@@ -7000,7 +7019,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 158 Lovely Street
+ address1: 160 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7018,7 +7037,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 157 Lovely Street
+ address1: 159 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7037,7 +7056,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 158 Lovely Street
+ address1: 160 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7056,7 +7075,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 157 Lovely Street
+ address1: 159 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7128,7 +7147,7 @@ paths:
application/json:
example:
id: cus_UkLWZg9DAJ
first_name: Updated
last_name: Name
phone: 555-555-0199
@@ -7141,7 +7160,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 160 Lovely Street
+ address1: 162 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7159,7 +7178,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 159 Lovely Street
+ address1: 161 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7178,7 +7197,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 160 Lovely Street
+ address1: 162 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7197,7 +7216,7 @@ paths:
first_name: John
last_name: Doe
full_name: John Doe
- address1: 159 Lovely Street
+ address1: 161 Lovely Street
address2: Northwest
postal_code: '10118'
city: New York
@@ -7319,7 +7338,7 @@ paths:
example:
data:
- id: gc_UkLWZg9DAJ
- code: 4CC206A08A965D0C
+ code: 1D8F6731E0FC883B
status: active
currency: USD
amount: '10.0'
@@ -7415,7 +7434,7 @@ paths:
application/json:
example:
id: gc_UkLWZg9DAJ
- code: BE5F9E2177DE672D
+ code: 3BBF158BE9B1C5A7
status: active
currency: USD
amount: '10.0'
@@ -7487,8 +7506,8 @@ paths:
example:
id: pss_gbHJdmfrXB
status: pending
- external_id: bogus_seti_d4f3fef1d5a431f0f6835270
- external_client_secret: bogus_seti_secret_001a6f89d9bc6018
+ external_id: bogus_seti_d9625a63ebe5532d4417b5fb
+ external_client_secret: bogus_seti_secret_e2e52280f633bc71
external_data: {}
payment_method_id: pm_UkLWZg9DAJ
payment_source_id:
@@ -7587,8 +7606,8 @@ paths:
example:
id: pss_UkLWZg9DAJ
status: pending
- external_id: seti_test_494aa02cf8d8d30a4f35d595
- external_client_secret: seti_secret_f72eb5969859f82b9f6fe9fb
+ external_id: seti_test_f5e816a9bf9173b606d77af1
+ external_client_secret: seti_secret_2324ae62ce1b4563baaab757
external_data:
client_secret: secret_123
payment_method_id: pm_UkLWZg9DAJ
@@ -7664,8 +7683,8 @@ paths:
example:
id: pss_UkLWZg9DAJ
status: completed
- external_id: seti_test_0c5ea2d94f89c38599b5c4e4
- external_client_secret: seti_secret_4a94c22af6a5544e3d8970b0
+ external_id: seti_test_f26b6475254366fa7f6cebf1
+ external_client_secret: seti_secret_1ae363c67cc007de1f518808
external_data:
client_secret: secret_123
payment_method_id: pm_UkLWZg9DAJ
@@ -8609,7 +8628,7 @@ paths:
data:
- id: wl_UkLWZg9DAJ
name: My Wishlist
- token: zPgqqcKWN3k5w1mUMwKmnVWS
+ token: Br6az3cu1vKdH5A4c3ZX5Bfk
is_default: false
is_private: true
meta:
@@ -8685,7 +8704,7 @@ paths:
example:
id: wl_gbHJdmfrXB
name: Birthday Ideas
- token: 3BmavKNXGqToHE8RRQYmTjRH
+ token: FzjUXtCBU84GauR6bAZA8qU4
is_default: false
is_private: true
schema:
@@ -8786,7 +8805,7 @@ paths:
example:
id: wl_UkLWZg9DAJ
name: My Wishlist
- token: Q2ZYCGgLAkuMzie7NSG4CqBp
+ token: UEaWB2gMn9fgmNhm2kVHxbAb
is_default: false
is_private: true
schema:
@@ -8848,7 +8867,7 @@ paths:
example:
id: wl_UkLWZg9DAJ
name: Updated Name
- token: LVjzAYCMULCfvPL3GB4vZ1F9
+ token: rjoDScyCB8Pr631VNhkxd3dK
is_default: false
is_private: true
schema:
@@ -8964,7 +8983,7 @@ paths:
variant:
id: variant_gbHJdmfrXB
product_id: prod_gbHJdmfrXB
- sku: SKU-268
+ sku: SKU-269
options_text: ''
track_inventory: true
media_count: 0
@@ -9130,11 +9149,11 @@ paths:
application/json:
example:
id: sub_UkLWZg9DAJ
- created_at: '2026-07-30T09:27:43.849Z'
- updated_at: '2026-07-30T09:27:43.850Z'
+ created_at: '2026-08-02T15:52:57.223Z'
+ updated_at: '2026-08-02T15:52:57.223Z'
verified: true
- verified_at: '2026-07-30T09:27:43Z'
+ verified_at: '2026-08-02T15:52:57Z'
customer_id: cus_UkLWZg9DAJ
schema:
"$ref": "#/components/schemas/NewsletterSubscriber"
@@ -9213,10 +9232,10 @@ paths:
example:
id: sub_UkLWZg9DAJ
- created_at: '2026-07-30T09:27:43.871Z'
- updated_at: '2026-07-30T09:27:43.876Z'
+ created_at: '2026-08-02T15:52:57.244Z'
+ updated_at: '2026-08-02T15:52:57.249Z'
verified: true
- verified_at: '2026-07-30T09:27:43Z'
+ verified_at: '2026-08-02T15:52:57Z'
customer_id:
schema:
"$ref": "#/components/schemas/NewsletterSubscriber"
@@ -9386,7 +9405,7 @@ paths:
body_html: ''
- id: pol_OIJLhNcSbf
name: Privacy Policy
- slug: privacy-policy-368ab112-1450-4e7e-a125-646d85e0f7df
+ slug: privacy-policy-d4072c17-a87b-475c-82cd-e7b9a0791da0
body: We respect your privacy.
body_html: |
<div class="trix-content">
@@ -10211,6 +10230,9 @@ components:
channel_id:
type: string
nullable: true
+ preferred_stock_location_id:
+ type: string
+ nullable: true
number:
type: string
token:
@@ -10355,6 +10377,7 @@ components:
- id
- market_id
- channel_id
+ - preferred_stock_location_id
- number
- token
- email
@@ -12318,6 +12341,17 @@ components:
- price
- original_price
x-typelizer: true
+ ProductType:
+ type: object
+ properties:
+ id:
+ type: string
+ name:
+ type: string
+ required:
+ - id
+ - name
+ x-typelizer: true
Promotion:
type: object
properties:
diff --git a/docs/developer/upgrades/5.6-to-6.0.mdx b/docs/developer/upgrades/5.6-to-6.0.mdx
index 85168f5806..914061d465 100644
--- a/docs/developer/upgrades/5.6-to-6.0.mdx
+++ b/docs/developer/upgrades/5.6-to-6.0.mdx
@@ -145,6 +145,7 @@ end
The requirement appears in the Cart API's `requirements` array (so a storefront rendering the feed generically needs zero changes) *and* blocks completion. `register_step` adds whole steps (spliced into `checkout_steps` at `before:`/`after:` anchors); built-in steps are customized through `Registry.base_steps` — an ordered `{ name => applicability }` hash you can mutate directly (`base_steps.delete('confirm')`).
- **The API `requirements` array now carries a stable `code`** on every entry (`email_required`, `out_of_stock`, `guest_checkout_not_allowed`, ...). Additive change — existing consumers keep working.
+- **The delivery requirement is keyed `delivery_method`, not `shipping_method`.** Its entry is now `{ step: 'delivery', field: 'delivery_method', code: 'delivery_method_required' }`. A storefront that renders the feed generically needs no change; one that keys off the field or code to highlight a specific input must switch both tokens. The `Spree.t('checkout_requirements.shipping_method_required')` translation key was renamed to `checkout_requirements.delivery_method_required` — override it under the new key.
- **"Logic between steps" has no backend home by design.** Side effects hang off data writes (workflow hooks such as `Carts::Complete`'s `before_finalize` and `Carts::AddItem`'s `after_item_added`) and events (`cart.updated`, `order.placed`) — not step transitions.
## Statuses: derived, then persisted
@@ -226,8 +227,11 @@ Every rename keeps the legacy name working for one release with a deprecation wa
| `use_billing` / `clone_billing_address` | `use_shipping` (shipping address is canonical) |
| `Fulfillment#ship`, `#ship!`, `#shipped?`, `#can_ship?`, `#shipping_method`, `#add_shipping_method` | `#fulfill`, `#fulfill!`, `#fulfilled?`, `#can_fulfill?`, `#delivery_method`, `#add_delivery_method` |
| `LineItem#target_shipment` | `#target_fulfillment` |
-| `create_proposed_shipments` / `create_proposed_fulfillments` | `#rebuild_fulfillments!` (both models) |
+| `Order#create_proposed_shipments` / `#create_proposed_fulfillments` | `#rebuild_fulfillments!` (Cart ships with the new name only) |
| `Order#remove_out_of_stock_items!` | cart-side only (`Spree::Carts::RemoveOutOfStockItems`) |
+| `Order#delivery_required?` | `#delivery_step_required?` — digital and pickup are deliveries too; this asks whether the customer must choose a delivery option |
+| `Order#requires_ship_address?` | `#shipping_address_required?` — decided by the selected delivery methods (`DeliveryMethod#requires_address?`); digital, pickup, and pickup-point deliveries need no customer address |
+| `requirements[].field` / `.code` `shipping_method` (Store API) | `delivery_method` / `delivery_method_required` — no bridge; clients keying off the delivery requirement must switch both tokens |
| `Cart#number` (Store API field) | `id` — carts have no order-style number; the field mirrors the prefixed ID for one release |
| `order.completed` event | `order.placed` |
| Calling cart services with `order:` kwargs | `cart:` kwargs |
@@ -237,7 +241,7 @@ Every rename keeps the legacy name working for one release with a deprecation wa
- **Don't reach for model business methods from services** — 6.0 code style writes behavior inline in service/workflow steps; models keep data, validations, predicates and persistence primitives. Extensions patching removed model methods (`finalize!` internals, updater hooks) should move to workflow hooks (`Spree.hooks.register('carts.complete.before_finalize') { |flow| ... }` — handlers receive the workflow instance) or event subscribers.
- **Store-scoped data is single-owner.** `Product`, `Promotion` and `PaymentMethod` `belongs_to :store`; the `stores: [...]` writers are gone. Multi-store sharing lives in the `spree_multi_store` extension.
-- The Store API v3 contract is stable across the split — cart endpoints keep their shapes; `requirements` gains `code`, and serializer `number` on carts is bridged as described above.
+- The Store API v3 contract is stable across the split — cart endpoints keep their shapes; `requirements` gains `code` (and renames the delivery entry's field/code to `delivery_method`, see above), and serializer `number` on carts is bridged as described above.
<Warning>
This guide tracks the 6.0 development line and will grow until release. If a behavioral change you hit isn't documented here, treat it as a documentation bug and report it.
diff --git a/docs/plans/6.0-fulfillment-and-delivery.md b/docs/plans/6.0-fulfillment-and-delivery.md
index 39808db1f8..3e776c5222 100644
--- a/docs/plans/6.0-fulfillment-and-delivery.md
+++ b/docs/plans/6.0-fulfillment-and-delivery.md
@@ -4,7 +4,7 @@
**Target:** Spree 6.0
**Depends on:** `6.0-product-types.md` (`fulfillment_types` addendum 2026-07-27 — ProductType replaces ShippingCategory; **hard blocker**, `Spree::ProductType` does not exist yet), `6.0-cart-order-split.md` (where fulfillments/rates live pre-completion), `6.0-order-routing.md` (packages come from `for_allocation`), `6.0-normalize-state-to-status.md`. Coordinates with: `6.0-delivery-rate-provider.md` (owns `store_id` on DeliveryMethod; calculators stay per decisions.md 2026-07-27), `5.5-6.0-display-on-to-boolean.md` (`storefront_visible` lands in the same migration wave), `6.0-multi-vendor-marketplace.md` (`vendor_id`, lifecycle events, `delivery_amount`). Gates: `6.0-split-adjustments.md` and `6.0-typed-stock-movements.md` are born with `fulfillment_id` — **this plan's Phase 1 must land before both**.
**Author:** Damian + Claude
-**Last updated:** 2026-07-28
+**Last updated:** 2026-08-02
## Summary
@@ -25,7 +25,7 @@ This plan is being implemented ahead of itself — the following exists today an
- **Prefix IDs claimed**: `ful_` (Shipment), `dm_` (ShippingMethod), `fi_` (InventoryUnit), `dr_` (via `Shipment#selected_delivery_rate_id`, whose YARD comment cites this plan).
- **Order aliases**: `alias_attribute :fulfillment_status, :shipment_state` and `alias_attribute :delivery_total, :shipment_total` (`order.rb:211-213`) — the Phase 1 column renames must remove these aliases in the same change.
- **`Spree::Fulfillments::Create` service** (`core/app/services/spree/fulfillments/create.rb`), registered as `Spree.fulfillment_create_service`.
-- **StockLocation pickup columns** (shipped 2026-05-08): `kind`, `pickup_enabled`, `pickup_stock_policy`, `pickup_ready_in_minutes`, `pickup_instructions` + indexes. **Do not re-add.**
+- **StockLocation pickup columns** (shipped 2026-05-08): `kind`, `pickup_enabled`, `pickup_stock_policy`, `pickup_ready_in_minutes`, `pickup_instructions` + indexes. **Do not re-add.** Reviewed 2026-08-02 — all five stay (shipped 5.x schema + admin API contract; `pickup_stock_policy` is genuinely per-location: which counters accept ship-to-store transfers varies by counter). **Rule going forward: no new per-fulfillment-type column sets on `spree_stock_locations`** — future capabilities (local-delivery radius, courier windows, …) express through the provider/method/`DeliveryMethodStockLocation` axis, not location columns. `kind` is currently unread by business logic and reserved for `6.0-inventory-operations.md` (warehouse vs store operations); do not drop or repurpose without checking that plan.
- **admin-sdk generated types are already clean** (zero `shipment` references); `packages/dashboard/src` still has 8 files on old vocabulary.
Outstanding: model/table/column renames, the eligibility rework, FulfillmentProvider, lifecycle events, and the legacy-admin/emails surfaces.
@@ -73,9 +73,11 @@ Replacement semantics:
`ShippingMethod#digital?`, `#requires_zone_check?`, and the `.digital` scope currently test `calculator.is_a?(DigitalDelivery)` (`shipping_method.rb:42, 57, 128`; memoized via `MEMOIZED_METHODS :17`), and `Product#digital?` derives through a four-hop chain (product → category → methods → calculator class). All of these move to columns: `DeliveryMethod#fulfillment_type == 'digital'` and `ProductType#digital?`. The `DigitalDelivery` calculator stays (calculators are kept) but becomes a plain zero-cost calculator — its `available?` gating is superseded by fulfillment-type eligibility. `Seeds::DigitalDelivery` updates to set `fulfillment_type: 'digital'`.
-### Fulfillment types are open strings
+### Fulfillment types are a strict registered set (revised 2026-08-02; supersedes "open strings, no inclusion validation")
-`shipping`, `pickup` (merchant location), `pickup_point` (third-party point — InPost locker, DHL ServicePoint), `digital`, `local_delivery` built in; extensible via `Spree.fulfillment_types << 'same_day_courier'`. No inclusion validation.
+`shipping`, `pickup` (merchant location), `pickup_point` (third-party point — InPost locker, DHL ServicePoint), `digital`, `local_delivery` built in; extensible via `Spree.fulfillment_types << 'same_day_courier'` in an initializer. NOT a model — a type is a behavior discriminator only meaningful to code (splitter, estimator, provider); AR-record reference data was the countries/states mistake. But not open strings either: an unregistered/typo'd type silently produces empty intersections (no error, just missing rates), so `DeliveryMethod#fulfillment_type` and each element of `ProductType#fulfillment_types` validate inclusion against the registry — **on attribute change only**, so rows carrying tokens not yet registered (e.g. freshly migrated) stay loadable and savable. The registry is exposed to admin UIs via `GET /admin/delivery_methods/fulfillment_providers` (`fulfillment_types` key) — the dashboard renders type selects/checkboxes from it, so extension-registered types appear without dashboard changes (the JS `FULFILLMENT_TYPES` const is pre-fetch fallback + labels only).
+
+**Modality vs segment.** New fulfillment types are for genuinely new delivery *modalities* (need provider code anyway — the initializer is the smallest part of the work). Product *segments* ("oversized", "fragile") should NOT become custom types: model them with `DeliveryMethodRule` (weight/item-total — merchant-manageable in the dashboard, registry `Spree.delivery_method_rules` for custom rules) plus `Product#excluded_delivery_method_ids` for one-off subtractions. The Wave 7 shipping→delivery data migration MAY mint custom tokens for 5.x shipping categories whose method bindings actually narrow (a category not served by all methods) — flattening those to `'shipping'` would silently widen eligibility — but that token-minting is a compatibility measure, not recommended modeling; the migration task must print the `Spree.fulfillment_types += [...]` initializer line for every token it mints.
### FulfillmentProvider is a strategy (not a DB model)
@@ -130,6 +132,21 @@ The rename is `shipped` → `fulfilled` (column `state` → `status` per the nor
A customer's merchant-pickup choice writes `Order#preferred_stock_location_id`, so it flows through the existing `PreferredLocation` routing rule (`6.0-order-routing.md`) instead of bypassing routing with a direct `stock_location_id` write. `Fulfillment#stock_location` always comes from the routing strategy's `for_allocation` packages — never a bare `detect`.
+### Delivery predicates — one meaning per name (settled 2026-08-02)
+
+Digital and both pickup kinds ARE deliveries — they just don't ship to a customer address. Three predicates, never interchangeable (implemented on the Purchase concerns; `Order#delivery_required?` / `#requires_ship_address?` are deprecated bridges, removed 6.1):
+
+- `digital?` / `some_digital?` — item-composition facts only, never flow gates.
+- `delivery_step_required?` — the checkout delivery step applies: the customer must choose a delivery option (shipping + pickup kinds yes; digital-only no — the provider auto-fulfills).
+- `shipping_address_required?` — checkout must collect a customer ship address. Selected delivery methods are the source of truth: `DeliveryMethod#requires_address?` delegates to the **fulfillment provider** (`FulfillmentProvider::Base#requires_address?` → true; Digital/Pickup/PickupPoint override false) — no type const, host apps extend by registering a provider. Before any selection: pickup intent (`preferred_stock_location_id`) waives it, otherwise the items' possible `fulfillment_types` are matched against the store's configured address-requiring delivery methods — deliberately no `digital?` special case anywhere. `requires_zone_check?` follows `requires_address?` (zones describe the customer destination), which also fixed pickup_point methods wrongly zone-checking against the customer address. The provider is an explicit choice, never derived from the type in the model (no naming-convention magic): `Manual` stays the column default and the **dashboard** suggests a type-specific provider when the admin picks a fulfillment type, via `GET /admin/delivery_methods/fulfillment_providers` (each provider declares `self.fulfillment_types`; empty = handles any). The field renders only when more than one registered provider matches the chosen type, so it stays hidden until a carrier integration is installed.
+
+**Resolved 2026-08-02 — pickup flow correctness (shipped together as one unit):**
+
+- **Rebuild triggers**: a destination is an address OR a pickup intent. `Carts::Update#try_advance` rebuilds proposals on `saved_change_to_preferred_stock_location_id?` (set, changed, or cleared) exactly like address/market changes; `Checkout::Advance` proposes fulfillments when `ship_address.present? || preferred_stock_location_id.present?`. A pure-pickup cart completes checkout without ever having a shipping address.
+- **Estimator location gating**: `Stock::Estimator#shipping_methods` filters on `DeliveryMethod#serves_location?(package.stock_location)`, delegated to the fulfillment provider. Base → true (shipping/digital/pickup_point are source-agnostic); `FulfillmentProvider::Pickup` → the package must be sourced from an eligible pickup location (`available_pickup_locations`: the configured `DeliveryMethodStockLocation` set, else all active pickup-enabled), **or** some eligible location must accept remote stock (`pickup_stock_policy: 'any'` — the ship-to-store case, which a strict source gate would otherwise outlaw). This makes `DeliveryMethodStockLocation` load-bearing in rating, not just in the storefront listing endpoint.
+- **Coverage checks are pickup-item-scoped**: the store `pickup_locations?cart_id=` coverage check skips line items whose product `fulfillment_types` exclude `pickup` — a tracked digital variant in a mixed cart must not disqualify a counter.
+- Cart-side sourcing still comes from the Coordinator across all stocked locations; honoring the *chosen* counter remains order-side routing (`PreferredLocation` rule) per "Pickup location selection flows through order routing" above.
+
## Design Details
### DeliveryMethod