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.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Document the delivery vocabulary and pickup decisions
Damian Legawiec662cdd00d37e
diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yamlindex 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: 7ZvuLmhuiz39K2yy6GeD95kauser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Rickie- last_name: Dicki+ first_name: Wilbur+ last_name: Andersonphone:accepts_email_marketing: false- full_name: Rickie Dicki+ full_name: Wilbur Andersonavailable_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: 2zG2gncedPHeHaRu7xCWJ9x9user:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Faviola- last_name: Feil+ first_name: Sharri+ last_name: Bartolettiphone:accepts_email_marketing: false- full_name: Faviola Feil+ full_name: Sharri Bartolettiavailable_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: uSCGGTtw72n1tjoUAgqBeFp2user:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Shalon- last_name: Bins+ first_name: Cleotilde+ last_name: Beckerphone:accepts_email_marketing: false- full_name: Shalon Bins+ full_name: Cleotilde Beckeravailable_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-1296942meta_title:meta_description:meta_keywords:@@ -892,25 +892,21 @@ paths:in_stock: falsebackorderable: trueavailable: 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_UkLWZg9DAJthumbnail_url:tags: []@@ -1065,8 +1061,8 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 170964- slug: product-170964+ name: Product 1718168+ slug: product-1718168meta_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-1725738meta_title:meta_description:meta_keywords:@@ -1108,20 +1104,24 @@ paths:in_stock: falsebackorderable: trueavailable: 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_EfhxLZ9ck8thumbnail_url:tags: []@@ -1223,8 +1223,8 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 1985523- slug: product-1985523+ name: Product 1992472+ slug: product-1992472meta_title:meta_description:meta_keywords:@@ -1258,7 +1258,7 @@ paths:amount_in_cents: 999currency: USDdisplay_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_gbHJdmfrXBmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: Ut4FpVPEsbA3RJBcXi8cgrwH- token: Ut4FpVPEsbA3RJBcXi8cgrwH+ preferred_stock_location_id:+ number: cart_gbHJdmfrXB+ token: M8ZCMLQqoQuxuwp9ejYcHwaMemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -1541,16 +1542,20 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: Email address is required- - step: address+ - code: ship_address_required+ step: addressfield: ship_addressmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -1562,8 +1567,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1039670- slug: product-1039670+ name: Product 1043676+ slug: product-1043676options_text: ''price: '10.0'display_price: "$10.00"@@ -1606,12 +1611,13 @@ paths:- id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: Bpkte1VqjPM9v6q3xJ621kgY- token: Bpkte1VqjPM9v6q3xJ621kgY+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: YacMCCRLwubB7A1efKsJLQiVemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []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: falsecurrent_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: Email address is required- - step: address+ - code: ship_address_required+ step: addressfield: ship_addressmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -1662,8 +1672,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1021882- slug: product-1021882+ name: Product 1032165+ slug: product-1032165options_text: ''price: '10.0'display_price: "$10.00"@@ -1779,8 +1789,9 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: b87m9LpQPQJaCk3XpCWcQm4T- token: b87m9LpQPQJaCk3XpCWcQm4T+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: jeF9EAJtimKwRY3ZNZjioqrCemail:customer_note:currency: USD@@ -1814,15 +1825,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: cart+ - code: line_items_required+ step: cartfield: line_itemsmessage: Add at least one item to your cart- - step: address+ - code: email_required+ step: addressfield: emailmessage: Email address is required- - step: address- field: ship_address- message: Shipping address is requiredshipping_eq_billing_address: truediscounts: []items: []@@ -1944,16 +1954,17 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: nYhFVBUvpnjkrfJjCpq1j2GM- token: nYhFVBUvpnjkrfJjCpq1j2GM+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: xKE2yijxuYf7LKfEkUQ7QepMemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 0warnings:- code: line_item_removed- message: Product 1072601 was removed because it was sold out+ message: Product 1084189 was removed because it was sold outline_item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJcoupon_code:@@ -1983,15 +1994,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: cart+ - code: line_items_required+ step: cartfield: line_itemsmessage: Add at least one item to your cart- - step: address+ - code: email_required+ step: addressfield: emailmessage: Email address is required- - step: address- field: ship_address- message: Shipping address is requiredshipping_eq_billing_address: truediscounts: []items: []@@ -2094,12 +2104,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: Pe115jSD8Zr6E9YX652C2wHg- token: Pe115jSD8Zr6E9YX652C2wHg+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: Qbf1sYyBXrJASA1oX3Smizjhemail:customer_note: Leave at doorcurrency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -2129,16 +2140,16 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -2150,8 +2161,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1082693- slug: product-1082693+ name: Product 1096752+ slug: product-1096752options_text: ''price: '10.0'display_price: "$10.00"@@ -2368,12 +2379,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: pAQ5SyiHadx2XvwSGVnbG6mm- token: pAQ5SyiHadx2XvwSGVnbG6mm- email: [email protected]+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: W69Lk7NSMgJpQDSKZtjaYGpL+ email: [email protected]customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -2404,10 +2416,12 @@ paths:completed_steps:- addressrequirements:- - 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: false@@ -2419,8 +2433,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1101175- slug: product-1101175+ name: Product 1113151+ slug: product-1113151options_text: ''price: '10.0'display_price: "$10.00"@@ -2450,7 +2464,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 122 Lovely Street+ address1: 124 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -2469,7 +2483,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 121 Lovely Street+ address1: 123 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -2574,8 +2588,8 @@ paths:market_id: mkt_UkLWZg9DAJcart_id: cart_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R950657927- email: [email protected]+ number: R723930495+ email: [email protected]customer_note:currency: USDlocale: en@@ -2583,7 +2597,7 @@ paths:coupon_code:fulfillment_status: backorderpayment_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: 1currency: USD- name: Product 1136620- slug: product-1136620+ name: Product 1142075+ slug: product-1142075options_text: ''price: '10.0'display_price: "$10.00"@@ -2641,7 +2655,7 @@ paths:digital_links: []fulfillments:- id: ful_gbHJdmfrXB- number: F06002189648+ number: F35697571850tracking:tracking_url:pickup_point_data:@@ -2675,7 +2689,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Andria Mueller+ name: Cecilia Wolffaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2707,8 +2721,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-80032fa14b73- number: P3GGMOJS+ response_code: BGS-c05fdddc07bd+ number: PS50A10Gamount: '20.0'display_amount: "$20.00"status: completed@@ -2735,7 +2749,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 128 Lovely Street+ address1: 130 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -2754,7 +2768,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 127 Lovely Street+ address1: 129 Lovely Streetaddress2: Northwestpostal_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_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: ZaRUDiZyTSsPWhtpZFyk19Ad- token: ZaRUDiZyTSsPWhtpZFyk19Ad+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: Zdby4vYgmmgMzfoGwWFo2X5Demail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code: save10@@ -2898,15 +2912,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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 fulfillmentsshipping_eq_billing_address: truediscounts:- id: discount_UkLWZg9DAJ@@ -2923,8 +2936,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1396776- slug: product-1396776+ name: Product 140284+ slug: product-140284options_text: ''price: '10.0'display_price: "$10.00"@@ -3051,12 +3064,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: ZrqgEJvWvKkz38gUECP5kSDS- token: ZrqgEJvWvKkz38gUECP5kSDS+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: b895qS1guEhczxpJaPnL1gAsemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -3086,16 +3100,16 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -3107,8 +3121,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1414971- slug: product-1414971+ name: Product 1424036+ slug: product-1424036options_text: ''price: '10.0'display_price: "$10.00"@@ -3224,12 +3238,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: LXmaMUaXc3DghntxU62byL4P- token: LXmaMUaXc3DghntxU62byL4P- email: [email protected]+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: ev7uws7dAHNdVD9iCeEwC95F+ email: [email protected]customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -3261,7 +3276,8 @@ paths:- address- deliveryrequirements:- - step: payment+ - code: payment_required+ step: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: false@@ -3273,8 +3289,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1436032- slug: product-1436032+ name: Product 1443241+ slug: product-1443241options_text: ''price: '10.0'display_price: "$10.00"@@ -3299,7 +3315,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: F03626998098+ number: F96156119158tracking:tracking_url:pickup_point_data:@@ -3333,7 +3349,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Melda Jast+ name: Shawn Deckowaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -3369,7 +3385,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 185 Lovely Street+ address1: 187 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -3486,12 +3502,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: aFdjtFqsUH8dM1iwfvCkYeeD- token: aFdjtFqsUH8dM1iwfvCkYeeD+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: pUzi2ZKFBkY6HAdFqUXudMsremail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -3521,15 +3538,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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 fulfillmentsshipping_eq_billing_address: truediscounts: []items:@@ -3539,8 +3555,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1456011- slug: product-1456011+ name: Product 1461925+ slug: product-1461925options_text: ''price: '10.0'display_price: "$10.00"@@ -3567,8 +3583,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260730092734059913- number: PIEX367H+ response_code: 1-SC-20260802155247025534+ number: PKCSTMZVamount: '10.0'display_amount: "$10.00"status: checkout@@ -3722,12 +3738,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: zqaxrhRXhGD49LizWMQbUhCV- token: zqaxrhRXhGD49LizWMQbUhCV+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: DV1AEBmKcY6EHa2SEGT96LPbemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -3757,16 +3774,16 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -3778,8 +3795,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1496441- slug: product-1496441+ name: Product 1503963+ slug: product-1503963options_text: ''price: '10.0'display_price: "$10.00"@@ -3806,8 +3823,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260730092736400336- number: PA4WQKVY+ response_code: 1-SC-20260802155249558897+ number: PXJWX1K6amount: '10.0'display_amount: "$10.00"status: invalid@@ -3912,19 +3929,20 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: V8KuewrwWQZdHRaXVrNMJUg6- token: V8KuewrwWQZdHRaXVrNMJUg6+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: scCHtyUPv6EbMqf8RrQzQsWLemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 2warnings:- code: delivery_unavailable- message: Product 1522216 cannot be delivered to the selected address+ message: Product 1533455 cannot be delivered to the selected addressline_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 addressline_item_id: li_gbHJdmfrXBcoupon_code:item_total: '29.99'@@ -3953,16 +3971,16 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -3974,8 +3992,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1522216- slug: product-1522216+ name: Product 1533455+ slug: product-1533455options_text: ''price: '10.0'display_price: "$10.00"@@ -4004,8 +4022,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1532513- slug: product-1532513+ name: Product 1544895+ slug: product-1544895options_text: ''price: '19.99'display_price: "$19.99"@@ -4141,12 +4159,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: 7MGiLwH4EJZJwHomX9k4fEU8- token: 7MGiLwH4EJZJwHomX9k4fEU8+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: BFy2af9khZmgGjmjB9Rcgyv9email:customer_note:currency: USD- locale:+ locale: entotal_quantity: 0warnings: []coupon_code:@@ -4176,15 +4195,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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 fulfillmentsshipping_eq_billing_address: truediscounts: []items:@@ -4194,8 +4212,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1563062- slug: product-1563062+ name: Product 157125+ slug: product-157125options_text: ''price: '10.0'display_price: "$10.00"@@ -4311,12 +4329,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: AKP1NnKYUezHrgChwp8hxpMQ- token: AKP1NnKYUezHrgChwp8hxpMQ+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: DHW9eLpepbaQP6y2G1poDLuRemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 0warnings: []coupon_code:@@ -4346,15 +4365,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: cart+ - code: line_items_required+ step: cartfield: line_itemsmessage: Add at least one item to your cart- - step: address+ - code: email_required+ step: addressfield: emailmessage: Email address is required- - step: address- field: ship_address- message: Shipping address is requiredshipping_eq_billing_address: truediscounts: []items: []@@ -4453,9 +4471,9 @@ paths:id: ps_gbHJdmfrXBstatus: pendingcurrency: USD- external_id: bogus_31dbf05af6b91955da709a27+ external_id: bogus_9bafc6836694b545af8631e4external_data:- client_secret: bogus_secret_c345aa70f7f0244a+ client_secret: bogus_secret_4bf077ada4b9798ecustomer_external_id:expires_at:amount: '10.0'@@ -4554,7 +4572,7 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_edb0a2b2cb6227148bf7af7a+ external_id: bogus_517198bad7366d11635637cdexternal_data:client_secret: secret_123customer_external_id:@@ -4617,7 +4635,7 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_83fa626fcc4a2b63cb6c9870+ external_id: bogus_93fdfd4312cced1d46ecf89dexternal_data:client_secret: secret_123customer_external_id:@@ -4720,7 +4738,7 @@ paths:id: ps_UkLWZg9DAJstatus: completedcurrency: USD- external_id: bogus_dbf16d0c848bb8c2d9dc2144+ external_id: bogus_64cbc509a0d2c624c09ba075external_data:client_secret: secret_123customer_external_id:@@ -4819,7 +4837,7 @@ paths:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJresponse_code:- number: P5E7EZW0+ number: PRE0CVBTamount: '10.0'display_amount: "$10.00"status: checkout@@ -4926,12 +4944,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: A9Fugrxk8c8Xwo52imzW7em3- token: A9Fugrxk8c8Xwo52imzW7em3+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: XzSDDRewu7YWcnFbxRK1gZUXemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -4961,15 +4980,14 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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 fulfillmentsshipping_eq_billing_address: truediscounts: []items:@@ -4979,8 +4997,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 2183838- slug: product-2183838+ name: Product 219654+ slug: product-219654options_text: ''price: '10.0'display_price: "$10.00"@@ -5007,8 +5025,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260730092805247846- number: PVC553AW+ response_code: 1-SC-20260802155318675007+ number: PIQG4YHHamount: '10.0'display_amount: "$10.00"status: checkout@@ -5126,12 +5144,13 @@ paths:id: cart_UkLWZg9DAJmarket_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: ExfaVJfhqHsn2NX2t9YxF62D- token: ExfaVJfhqHsn2NX2t9YxF62D+ preferred_stock_location_id:+ number: cart_UkLWZg9DAJ+ token: wsQsrMWYnzGuMEw7xLbyJtjYemail:customer_note:currency: USD- locale:+ locale: entotal_quantity: 1warnings: []coupon_code:@@ -5161,16 +5180,16 @@ paths:current_step: addresscompleted_steps: []requirements:- - step: address+ - code: email_required+ step: addressfield: emailmessage: 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: paymentfield: paymentmessage: Add a payment methodshipping_eq_billing_address: true@@ -5182,8 +5201,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 220908- slug: product-220908+ name: Product 2212559+ slug: product-2212559options_text: ''price: '10.0'display_price: "$10.00"@@ -5298,7 +5317,7 @@ paths:market_id: mkt_UkLWZg9DAJcart_id:channel_id: ch_UkLWZg9DAJ- number: R063098125+ number: R346932621email: [email protected]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: 1currency: USD- name: Product 1603880- slug: product-1603880+ name: Product 1616147+ slug: product-1616147options_text: ''price: '10.0'display_price: "$10.00"@@ -5365,7 +5384,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: F01766723833+ number: F11951108951tracking: U10000tracking_url:pickup_point_data:@@ -5399,7 +5418,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Joan Schowalter+ name: Roy Ziemeaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -5434,7 +5453,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 237 Lovely Street+ address1: 239 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -5453,7 +5472,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 238 Lovely Street+ address1: 240 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -5553,7 +5572,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 88 Lovely Street+ address1: 90 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -5571,7 +5590,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 87 Lovely Street+ address1: 89 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -5589,7 +5608,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 86 Lovely Street+ address1: 88 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -5838,7 +5857,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 100 Lovely Street+ address1: 102 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -5913,7 +5932,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 106 Lovely Street+ address1: 108 Lovely Streetaddress2: Northwestpostal_code: '10118'city: Los Angeles@@ -6351,8 +6370,8 @@ paths:market_id: mkt_UkLWZg9DAJcart_id:channel_id: ch_UkLWZg9DAJ- number: R059426856- email: [email protected]+ number: R420642829+ email: [email protected]customer_note:currency: USDlocale: 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: 1currency: USD- name: Product 1299675- slug: product-1299675+ name: Product 1303266+ slug: product-1303266options_text: ''price: '10.0'display_price: "$10.00"@@ -6418,7 +6437,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: F36429200953+ number: F03224906213tracking: U10000tracking_url:pickup_point_data:@@ -6452,7 +6471,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Zachary Harvey+ name: Marti Schoenaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6487,7 +6506,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 145 Lovely Street+ address1: 147 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6506,7 +6525,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 146 Lovely Street+ address1: 148 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6629,8 +6648,8 @@ paths:market_id: mkt_UkLWZg9DAJcart_id:channel_id: ch_UkLWZg9DAJ- number: R051467067- email: [email protected]+ number: R343951215+ email: [email protected]customer_note:currency: USDlocale: 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: 1currency: USD- name: Product 1314814- slug: product-1314814+ name: Product 1327942+ slug: product-1327942options_text: ''price: '10.0'display_price: "$10.00"@@ -6696,7 +6715,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: F90903986478+ number: F14879759522tracking: U10000tracking_url:pickup_point_data:@@ -6730,7 +6749,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Amee Sanford+ name: Thurman Manteaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6765,7 +6784,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 151 Lovely Street+ address1: 153 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6784,7 +6803,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 152 Lovely Street+ address1: 154 Lovely Streetaddress2: Northwestpostal_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: kcxnihfMtLi3CoWGDAyTmzPDuser:id: cus_UkLWZg9DAJemail: [email protected]@@ -6881,10 +6900,10 @@ paths:newsletter_subscriber:id: sub_UkLWZg9DAJemail: [email protected]- 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_UkLWZg9DAJcustomer_groups: []schema:@@ -6987,12 +7006,12 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Irmgard- last_name: Pagac+ email: [email protected]+ first_name: Suzi+ last_name: Murrayphone: 555-555-0199accepts_email_marketing: false- full_name: Irmgard Pagac+ full_name: Suzi Murrayavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses:@@ -7000,7 +7019,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 158 Lovely Street+ address1: 160 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7018,7 +7037,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 157 Lovely Street+ address1: 159 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7037,7 +7056,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 158 Lovely Street+ address1: 160 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7056,7 +7075,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 157 Lovely Street+ address1: 159 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7128,7 +7147,7 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Updatedlast_name: Namephone: 555-555-0199@@ -7141,7 +7160,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 160 Lovely Street+ address1: 162 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7159,7 +7178,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 159 Lovely Street+ address1: 161 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7178,7 +7197,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 160 Lovely Street+ address1: 162 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7197,7 +7216,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 159 Lovely Street+ address1: 161 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7319,7 +7338,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: 4CC206A08A965D0C+ code: 1D8F6731E0FC883Bstatus: activecurrency: USDamount: '10.0'@@ -7415,7 +7434,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: BE5F9E2177DE672D+ code: 3BBF158BE9B1C5A7status: activecurrency: USDamount: '10.0'@@ -7487,8 +7506,8 @@ paths:example:id: pss_gbHJdmfrXBstatus: pending- external_id: bogus_seti_d4f3fef1d5a431f0f6835270- external_client_secret: bogus_seti_secret_001a6f89d9bc6018+ external_id: bogus_seti_d9625a63ebe5532d4417b5fb+ external_client_secret: bogus_seti_secret_e2e52280f633bc71external_data: {}payment_method_id: pm_UkLWZg9DAJpayment_source_id:@@ -7587,8 +7606,8 @@ paths:example:id: pss_UkLWZg9DAJstatus: pending- external_id: seti_test_494aa02cf8d8d30a4f35d595- external_client_secret: seti_secret_f72eb5969859f82b9f6fe9fb+ external_id: seti_test_f5e816a9bf9173b606d77af1+ external_client_secret: seti_secret_2324ae62ce1b4563baaab757external_data:client_secret: secret_123payment_method_id: pm_UkLWZg9DAJ@@ -7664,8 +7683,8 @@ paths:example:id: pss_UkLWZg9DAJstatus: completed- external_id: seti_test_0c5ea2d94f89c38599b5c4e4- external_client_secret: seti_secret_4a94c22af6a5544e3d8970b0+ external_id: seti_test_f26b6475254366fa7f6cebf1+ external_client_secret: seti_secret_1ae363c67cc007de1f518808external_data:client_secret: secret_123payment_method_id: pm_UkLWZg9DAJ@@ -8609,7 +8628,7 @@ paths:data:- id: wl_UkLWZg9DAJname: My Wishlist- token: zPgqqcKWN3k5w1mUMwKmnVWS+ token: Br6az3cu1vKdH5A4c3ZX5Bfkis_default: falseis_private: truemeta:@@ -8685,7 +8704,7 @@ paths:example:id: wl_gbHJdmfrXBname: Birthday Ideas- token: 3BmavKNXGqToHE8RRQYmTjRH+ token: FzjUXtCBU84GauR6bAZA8qU4is_default: falseis_private: trueschema:@@ -8786,7 +8805,7 @@ paths:example:id: wl_UkLWZg9DAJname: My Wishlist- token: Q2ZYCGgLAkuMzie7NSG4CqBp+ token: UEaWB2gMn9fgmNhm2kVHxbAbis_default: falseis_private: trueschema:@@ -8848,7 +8867,7 @@ paths:example:id: wl_UkLWZg9DAJname: Updated Name- token: LVjzAYCMULCfvPL3GB4vZ1F9+ token: rjoDScyCB8Pr631VNhkxd3dKis_default: falseis_private: trueschema:@@ -8964,7 +8983,7 @@ paths:variant:id: variant_gbHJdmfrXBproduct_id: prod_gbHJdmfrXB- sku: SKU-268+ sku: SKU-269options_text: ''track_inventory: truemedia_count: 0@@ -9130,11 +9149,11 @@ paths:application/json:example:id: sub_UkLWZg9DAJ- email: [email protected]- created_at: '2026-07-30T09:27:43.849Z'- updated_at: '2026-07-30T09:27:43.850Z'+ email: [email protected]+ 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_UkLWZg9DAJschema:"$ref": "#/components/schemas/NewsletterSubscriber"@@ -9213,10 +9232,10 @@ paths:example:id: sub_UkLWZg9DAJemail: [email protected]- 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_OIJLhNcSbfname: Privacy Policy- slug: privacy-policy-368ab112-1450-4e7e-a125-646d85e0f7df+ slug: privacy-policy-d4072c17-a87b-475c-82cd-e7b9a0791da0body: We respect your privacy.body_html: |<div class="trix-content">@@ -10211,6 +10230,9 @@ components:channel_id:type: stringnullable: true+ preferred_stock_location_id:+ type: string+ nullable: truenumber:type: stringtoken:@@ -10355,6 +10377,7 @@ components:- id- market_id- channel_id+ - preferred_stock_location_id- number- token@@ -12318,6 +12341,17 @@ components:- price- original_pricex-typelizer: true+ ProductType:+ type: object+ properties:+ id:+ type: string+ name:+ type: string+ required:+ - id+ - name+ x-typelizer: truePromotion:type: objectproperties:diff --git a/docs/developer/upgrades/5.6-to-6.0.mdx b/docs/developer/upgrades/5.6-to-6.0.mdxindex 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 @@ endThe 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.mdindex 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 norA 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