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
Add full Admin Markets API/SDK/SPA (#14096)
Damian Legawiec7e622153f077
diff --git a/docs/api-reference/admin.yaml b/docs/api-reference/admin.yamlindex 29528f7996..6739a4ad6d 100644--- a/docs/api-reference/admin.yaml+++ b/docs/api-reference/admin.yaml@@ -82,12 +82,12 @@ paths:example:data:- id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Charley- last_name: Kunze- full_name: Charley Kunze- created_at: '2026-05-25T19:03:37.284Z'- updated_at: '2026-05-25T19:03:37.284Z'+ email: [email protected]+ first_name: Erwin+ last_name: Braun+ full_name: Erwin Braun+ created_at: '2026-05-26T12:42:46.794Z'+ updated_at: '2026-05-26T12:42:46.794Z'roles:- id: role_UkLWZg9DAJname: admin@@ -145,12 +145,12 @@ paths:application/json:example:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Kaitlyn- last_name: Bergstrom- full_name: Kaitlyn Bergstrom- created_at: '2026-05-25T19:03:37.662Z'- updated_at: '2026-05-25T19:03:37.662Z'+ email: [email protected]+ first_name: Lakia+ last_name: Ryan+ full_name: Lakia Ryan+ created_at: '2026-05-26T12:42:47.189Z'+ updated_at: '2026-05-26T12:42:47.189Z'roles:- id: role_UkLWZg9DAJname: admin@@ -203,12 +203,12 @@ paths:application/json:example:id: admin_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Renamed- last_name: Paucek- full_name: Renamed Paucek- created_at: '2026-05-25T19:03:37.973Z'- updated_at: '2026-05-25T19:03:37.992Z'+ last_name: O'Hara+ full_name: Renamed O'Hara+ created_at: '2026-05-26T12:42:47.469Z'+ updated_at: '2026-05-26T12:42:47.487Z'roles:- id: role_UkLWZg9DAJname: admin@@ -317,32 +317,32 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-05-25T19:03:38.293Z'- updated_at: '2026-05-25T19:03:38.293Z'+ created_at: '2026-05-26T12:42:47.777Z'+ updated_at: '2026-05-26T12:42:47.777Z'revoked_at:last_used_at:- plaintext_token: pk_NNvStJYr3CzbJP4pmogaXP7W+ plaintext_token: pk_MXpnpNbeH6Jonc9PHFAAkrRNcreated_by_email:- id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_RinHwH3Ae+ token_prefix: sk_3wzZtNJd9scopes:- write_all- created_at: '2026-05-25T19:03:38.294Z'- updated_at: '2026-05-25T19:03:38.294Z'+ created_at: '2026-05-26T12:42:47.778Z'+ updated_at: '2026-05-26T12:42:47.778Z'revoked_at:last_used_at:plaintext_token:created_by_email:- id: key_EfhxLZ9ck8- name: doloremque+ name: faciliskey_type: secret- token_prefix: sk_YHVKja5WY+ token_prefix: sk_rst3YWMdZscopes:- write_all- created_at: '2026-05-25T19:03:38.295Z'- updated_at: '2026-05-25T19:03:38.295Z'+ created_at: '2026-05-26T12:42:47.778Z'+ updated_at: '2026-05-26T12:42:47.778Z'revoked_at:last_used_at:plaintext_token:@@ -405,15 +405,15 @@ paths:id: key_VqXmZF31wYname: CI keykey_type: secret- token_prefix: sk_rmCoUu1AF+ token_prefix: sk_sySDky4Kfscopes:- read_orders- created_at: '2026-05-25T19:03:38.854Z'- updated_at: '2026-05-25T19:03:38.854Z'+ created_at: '2026-05-26T12:42:48.347Z'+ updated_at: '2026-05-26T12:42:48.347Z'revoked_at:last_used_at:- plaintext_token: sk_rmCoUu1AFif9FBbzokNsPq6s- created_by_email: [email protected]+ plaintext_token: sk_sySDky4KfskBpQC6HVsRCEsU+ created_by_email: [email protected]'422':description: validation errorcontent:@@ -499,11 +499,11 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-05-25T19:03:39.136Z'- updated_at: '2026-05-25T19:03:39.136Z'+ created_at: '2026-05-26T12:42:48.641Z'+ updated_at: '2026-05-26T12:42:48.641Z'revoked_at:last_used_at:- plaintext_token: pk_6Rr9GzApsPiynpq4GxmzkCjB+ plaintext_token: pk_Wsz6ry2mTHN8U1k4DyGQPgoEcreated_by_email:delete:summary: Delete an API key@@ -593,12 +593,12 @@ paths:id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_ZrsgB7yLr+ token_prefix: sk_HSvSsXbqAscopes:- write_all- created_at: '2026-05-25T19:03:39.699Z'- updated_at: '2026-05-25T19:03:40.000Z'- revoked_at: '2026-05-25T19:03:39.998Z'+ created_at: '2026-05-26T12:42:49.216Z'+ updated_at: '2026-05-26T12:42:49.498Z'+ revoked_at: '2026-05-26T12:42:49.497Z'last_used_at:plaintext_token:created_by_email:@@ -653,15 +653,15 @@ paths:- id: coupon_UkLWZg9DAJcode: AAA111state: unused- created_at: '2026-05-25T19:03:40.016Z'- updated_at: '2026-05-25T19:03:40.016Z'+ created_at: '2026-05-26T12:42:49.518Z'+ updated_at: '2026-05-26T12:42:49.518Z'promotion_id: promo_UkLWZg9DAJorder_id:- id: coupon_gbHJdmfrXBcode: BBB222state: unused- created_at: '2026-05-25T19:03:40.017Z'- updated_at: '2026-05-25T19:03:40.017Z'+ created_at: '2026-05-26T12:42:49.519Z'+ updated_at: '2026-05-26T12:42:49.519Z'promotion_id: promo_UkLWZg9DAJorder_id:meta:@@ -739,8 +739,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-05-25T19:03:40.309Z'- updated_at: '2026-05-25T19:03:40.309Z'+ created_at: '2026-05-26T12:42:49.819Z'+ updated_at: '2026-05-26T12:42:49.819Z'- id: cfdef_gbHJdmfrXBnamespace: customkey: order_notes@@ -748,8 +748,8 @@ paths:field_type: short_textresource_type: Spree::Orderstorefront_visible: true- created_at: '2026-05-25T19:03:40.310Z'- updated_at: '2026-05-25T19:03:40.310Z'+ created_at: '2026-05-26T12:42:49.820Z'+ updated_at: '2026-05-26T12:42:49.820Z'meta:page: 1limit: 25@@ -812,8 +812,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-05-25T19:03:40.868Z'- updated_at: '2026-05-25T19:03:40.868Z'+ created_at: '2026-05-26T12:42:50.394Z'+ updated_at: '2026-05-26T12:42:50.394Z'requestBody:content:application/json:@@ -896,8 +896,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-05-25T19:03:40.871Z'- updated_at: '2026-05-25T19:03:40.871Z'+ created_at: '2026-05-26T12:42:50.397Z'+ updated_at: '2026-05-26T12:42:50.397Z'patch:summary: Update a custom field definitiontags:@@ -936,8 +936,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: false- created_at: '2026-05-25T19:03:41.147Z'- updated_at: '2026-05-25T19:03:41.422Z'+ created_at: '2026-05-26T12:42:50.682Z'+ updated_at: '2026-05-26T12:42:50.965Z'requestBody:content:application/json:@@ -1061,14 +1061,14 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 0- created_at: '2026-05-25T19:03:41.705Z'- updated_at: '2026-05-25T19:03:41.705Z'+ created_at: '2026-05-26T12:42:51.261Z'+ updated_at: '2026-05-26T12:42:51.261Z'- id: cg_gbHJdmfrXBname: Wholesaledescription:customers_count: 0- created_at: '2026-05-25T19:03:41.706Z'- updated_at: '2026-05-25T19:03:41.706Z'+ created_at: '2026-05-26T12:42:51.262Z'+ updated_at: '2026-05-26T12:42:51.262Z'meta:page: 1limit: 25@@ -1153,8 +1153,8 @@ paths:name: Wholesale 2description: B2B accountscustomers_count: 1- created_at: '2026-05-25T19:03:42.566Z'- updated_at: '2026-05-25T19:03:42.566Z'+ created_at: '2026-05-26T12:42:52.143Z'+ updated_at: '2026-05-26T12:42:52.143Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -1260,24 +1260,24 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 1- created_at: '2026-05-25T19:03:43.157Z'- updated_at: '2026-05-25T19:03:43.157Z'+ created_at: '2026-05-26T12:42:52.761Z'+ updated_at: '2026-05-26T12:42:52.761Z'customers:- id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Cammie- last_name: Nicolas+ email: [email protected]+ first_name: Sibyl+ last_name: Rueckerphone:accepts_email_marketing: false- full_name: Cammie Nicolas+ full_name: Sibyl Rueckeravailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"- login: [email protected]+ login: [email protected]metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-25T19:03:43.418Z'- updated_at: '2026-05-25T19:03:43.418Z'+ created_at: '2026-05-26T12:42:53.023Z'+ updated_at: '2026-05-26T12:42:53.023Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -1355,8 +1355,8 @@ paths:name: VIP customers (Q1)description: Top spenderscustomers_count: 0- created_at: '2026-05-25T19:03:43.991Z'- updated_at: '2026-05-25T19:03:44.265Z'+ created_at: '2026-05-26T12:42:53.700Z'+ updated_at: '2026-05-26T12:42:53.977Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -1509,8 +1509,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-05-25T19:03:45.099Z'- updated_at: '2026-05-25T19:03:45.099Z'+ created_at: '2026-05-26T12:42:54.830Z'+ updated_at: '2026-05-26T12:42:54.830Z'customer_id: cus_UkLWZg9DAJmeta:page: 1@@ -1598,8 +1598,8 @@ paths:state_name: New Yorklabel: Officemetadata: {}- created_at: '2026-05-25T19:03:46.463Z'- updated_at: '2026-05-25T19:03:46.463Z'+ created_at: '2026-05-26T12:42:56.256Z'+ updated_at: '2026-05-26T12:42:56.256Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -1710,8 +1710,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-05-25T19:03:46.734Z'- updated_at: '2026-05-25T19:03:47.299Z'+ created_at: '2026-05-26T12:42:56.525Z'+ updated_at: '2026-05-26T12:42:57.067Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -1844,8 +1844,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-05-25T19:03:48.447Z'- updated_at: '2026-05-25T19:03:48.447Z'+ created_at: '2026-05-26T12:42:58.161Z'+ updated_at: '2026-05-26T12:42:58.161Z'meta:page: 1limit: 25@@ -1932,8 +1932,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-05-25T19:03:49.025Z'- updated_at: '2026-05-25T19:03:49.025Z'+ created_at: '2026-05-26T12:42:58.710Z'+ updated_at: '2026-05-26T12:42:58.710Z'delete:summary: Delete a customer credit cardtags:@@ -2052,8 +2052,8 @@ paths:currency: USDmemo:metadata: {}- created_at: '2026-05-25T19:03:50.414Z'- updated_at: '2026-05-25T19:03:50.414Z'+ created_at: '2026-05-26T12:43:00.094Z'+ updated_at: '2026-05-26T12:43:00.094Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -2128,8 +2128,8 @@ paths:currency: USDmemo: Goodwillmetadata: {}- created_at: '2026-05-25T19:03:51.570Z'- updated_at: '2026-05-25T19:03:51.570Z'+ created_at: '2026-05-26T12:43:01.199Z'+ updated_at: '2026-05-26T12:43:01.199Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_gbHJdmfrXBcategory_id: sccat_UkLWZg9DAJ@@ -2220,8 +2220,8 @@ paths:currency: USDmemo: Updatedmetadata: {}- created_at: '2026-05-25T19:03:52.139Z'- updated_at: '2026-05-25T19:03:52.443Z'+ created_at: '2026-05-26T12:43:01.740Z'+ updated_at: '2026-05-26T12:43:02.024Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -2375,8 +2375,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-25T19:03:53.541Z'- updated_at: '2026-05-25T19:03:53.541Z'+ created_at: '2026-05-26T12:43:03.106Z'+ updated_at: '2026-05-26T12:43:03.106Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2459,8 +2459,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-25T19:03:54.370Z'- updated_at: '2026-05-25T19:03:54.370Z'+ created_at: '2026-05-26T12:43:03.934Z'+ updated_at: '2026-05-26T12:43:03.934Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2576,8 +2576,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-25T19:03:54.641Z'- updated_at: '2026-05-25T19:03:54.641Z'+ created_at: '2026-05-26T12:43:04.206Z'+ updated_at: '2026-05-26T12:43:04.206Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2651,8 +2651,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-25T19:03:55.185Z'- updated_at: '2026-05-25T19:03:55.464Z'+ created_at: '2026-05-26T12:43:04.752Z'+ updated_at: '2026-05-26T12:43:05.035Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -3082,11 +3082,11 @@ paths:example:data:- id: exp_UkLWZg9DAJ- number: EF168281244+ number: EF532072077type: Spree::Exports::Productsformat: csv- created_at: '2026-05-25T19:03:59.549Z'- updated_at: '2026-05-25T19:03:59.549Z'+ created_at: '2026-05-26T12:43:09.204Z'+ updated_at: '2026-05-26T12:43:09.204Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -3153,11 +3153,11 @@ paths:application/json:example:id: exp_gbHJdmfrXB- number: EF913292887+ number: EF574479198type: Spree::Exports::Productsformat: csv- created_at: '2026-05-25T19:03:59.868Z'- updated_at: '2026-05-25T19:03:59.868Z'+ created_at: '2026-05-26T12:43:09.506Z'+ updated_at: '2026-05-26T12:43:09.506Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -3244,11 +3244,11 @@ paths:application/json:example:id: exp_UkLWZg9DAJ- number: EF741996303+ number: EF872001258type: Spree::Exports::Productsformat: csv- created_at: '2026-05-25T19:04:00.140Z'- updated_at: '2026-05-25T19:04:00.140Z'+ created_at: '2026-05-26T12:43:09.778Z'+ updated_at: '2026-05-26T12:43:09.778Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -3431,8 +3431,8 @@ paths:codes_count: 2currency: USDprefix: WELCOME- created_at: '2026-05-25T19:04:00.740Z'- updated_at: '2026-05-25T19:04:00.740Z'+ created_at: '2026-05-26T12:43:10.373Z'+ updated_at: '2026-05-26T12:43:10.373Z'amount: '50.0'expires_at:created_by_id:@@ -3513,8 +3513,8 @@ paths:codes_count: 5currency: USDprefix: NEWCAMP- created_at: '2026-05-25T19:04:01.301Z'- updated_at: '2026-05-25T19:04:01.301Z'+ created_at: '2026-05-26T12:43:10.938Z'+ updated_at: '2026-05-26T12:43:10.938Z'amount: '25.0'expires_at: '2030-12-31'created_by_id: admin_UkLWZg9DAJ@@ -3615,8 +3615,8 @@ paths:codes_count: 2currency: USDprefix: WELCOME- created_at: '2026-05-25T19:04:01.592Z'- updated_at: '2026-05-25T19:04:01.592Z'+ created_at: '2026-05-26T12:43:11.226Z'+ updated_at: '2026-05-26T12:43:11.226Z'amount: '50.0'expires_at:created_by_id:@@ -3719,7 +3719,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: 87D5F01BB0D0D24F+ code: 9B9ED58051A4985Astatus: activecurrency: USDamount: '50.0'@@ -3733,12 +3733,12 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-25T19:04:02.161Z'- updated_at: '2026-05-25T19:04:02.161Z'+ created_at: '2026-05-26T12:43:11.794Z'+ updated_at: '2026-05-26T12:43:11.794Z'customer_id:created_by_id:- id: gc_gbHJdmfrXB- code: 13282B2AA8873673+ code: DB1278946CB996BAstatus: activecurrency: USDamount: '25.0'@@ -3752,8 +3752,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-25T19:04:02.162Z'- updated_at: '2026-05-25T19:04:02.162Z'+ created_at: '2026-05-26T12:43:11.795Z'+ updated_at: '2026-05-26T12:43:11.795Z'customer_id:created_by_id:meta:@@ -3838,7 +3838,7 @@ paths:application/json:example:id: gc_EfhxLZ9ck8- code: 0BB8CA18901867D2+ code: AD209AAC9CF152FCstatus: activecurrency: USDamount: '25.0'@@ -3852,8 +3852,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-25T19:04:02.732Z'- updated_at: '2026-05-25T19:04:02.732Z'+ created_at: '2026-05-26T12:43:12.382Z'+ updated_at: '2026-05-26T12:43:12.382Z'customer_id:created_by_id: admin_UkLWZg9DAJschema:@@ -3959,7 +3959,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: A8D6737DEBB081A9+ code: ECF343EE602414CCstatus: activecurrency: USDamount: '50.0'@@ -3973,8 +3973,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-25T19:04:03.022Z'- updated_at: '2026-05-25T19:04:03.022Z'+ created_at: '2026-05-26T12:43:12.680Z'+ updated_at: '2026-05-26T12:43:12.680Z'customer_id:created_by_id:schema:@@ -4034,7 +4034,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 8D8176F6C0B59E6B+ code: 21BB618C1AF1DE93status: activecurrency: USDamount: '75.0'@@ -4048,8 +4048,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-25T19:04:03.609Z'- updated_at: '2026-05-25T19:04:03.886Z'+ created_at: '2026-05-26T12:43:13.248Z'+ updated_at: '2026-05-26T12:43:13.527Z'customer_id:created_by_id:schema:@@ -4161,15 +4161,15 @@ paths:example:data:- id: inv_UkLWZg9DAJ- email: [email protected]+ email: [email protected]status: pending- created_at: '2026-05-25T19:04:04.719Z'- updated_at: '2026-05-25T19:04:04.719Z'- expires_at: '2026-06-08T19:04:04.717Z'+ created_at: '2026-05-26T12:43:14.372Z'+ updated_at: '2026-05-26T12:43:14.372Z'+ expires_at: '2026-06-09T12:43:14.370Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=U3Ff8Bf2dQKhmysmeTzBhfmM"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=Cy22mSZXN67XaQANUimVWAxP"invitee_exists: falsestore:id: store_UkLWZg9DAJ@@ -4230,13 +4230,13 @@ paths:id: inv_gbHJdmfrXBemail: [email protected]status: pending- created_at: '2026-05-25T19:04:05.015Z'- updated_at: '2026-05-25T19:04:05.015Z'- expires_at: '2026-06-08T19:04:05.013Z'+ created_at: '2026-05-26T12:43:14.672Z'+ updated_at: '2026-05-26T12:43:14.672Z'+ expires_at: '2026-06-09T12:43:14.669Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=fePPvxw9ZMV6MEnBpAz94PWr"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=BSNMzr8QmbUJBWFQ9KVmhPmZ"invitee_exists: falsestore:id: store_UkLWZg9DAJ@@ -4343,15 +4343,15 @@ paths:application/json:example:id: inv_UkLWZg9DAJ- email: [email protected]+ email: [email protected]status: pending- created_at: '2026-05-25T19:04:05.564Z'- updated_at: '2026-05-25T19:04:05.564Z'- expires_at: '2026-06-08T19:04:05.563Z'+ created_at: '2026-05-26T12:43:15.228Z'+ updated_at: '2026-05-26T12:43:15.228Z'+ expires_at: '2026-06-09T12:43:15.226Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=WNrcckqxoTLbdt8b32GDSXy3"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=kD18oQX1d1ZVvQji3vskUXSH"invitee_exists: falsestore:id: store_UkLWZg9DAJ@@ -4365,9 +4365,9 @@ paths:- api_key: []bearer_auth: []description: |-- Returns the markets configured for the current store. Read-only:- write surface lives in the legacy Rails admin pending the- Channel / Catalog rework (see `docs/plans/6.0-channels-catalogs-b2b.md`).+ Returns the markets configured for the current store. Markets are+ store-scoped and ordered by `position` (an `acts_as_list` column —+ update the order via `PATCH /markets/{id}` with `position`).**Required scope:** `read_settings` (for API-key authentication).@@ -4435,8 +4435,10 @@ paths:default: falsesupported_locales:- en- created_at: '2026-05-25T19:04:05.613Z'- updated_at: '2026-05-25T19:04:05.613Z'+ country_isos:+ - DE+ created_at: '2026-05-26T12:43:15.280Z'+ updated_at: '2026-05-26T12:43:15.280Z'meta:page: 1limit: 25@@ -4459,6 +4461,148 @@ paths:required:- data- meta+ post:+ summary: Create a market+ tags:+ - Pricing+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Creates a new market for the current store.++ - `country_isos` accepts 2-letter ISO country codes (e.g. `["DE", "FR"]`);+ the market must contain at least one country. Unknown codes are+ silently dropped.+ - `supported_locales` accepts an array of locale codes; the+ `default_locale` is always implicitly included.+ - Setting `default: true` automatically demotes the previous default+ market in the store.+++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const market = await client.markets.create({+ name: 'Europe',+ currency: 'EUR',+ default_locale: 'de',+ supported_locales: ['de', 'en', 'fr'],+ tax_inclusive: true,+ country_isos: ['DE', 'FR', 'IT'],+ })+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ schema:+ type: string+ responses:+ '201':+ description: market created+ content:+ application/json:+ example:+ id: mkt_gbHJdmfrXB+ name: France only+ currency: EUR+ default_locale: fr+ tax_inclusive: true+ default: false+ supported_locales:+ - en+ - fr+ country_isos:+ - FR+ created_at: '2026-05-26T12:43:15.886Z'+ updated_at: '2026-05-26T12:43:15.886Z'+ schema:+ "$ref": "#/components/schemas/Market"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank, Currency can't be blank, Default locale+ can't be blank, and Countries can't be blank+ details:+ name:+ - can't be blank+ currency:+ - can't be blank+ default_locale:+ - can't be blank+ countries:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ name:+ type: string+ example: Europe+ currency:+ type: string+ example: EUR+ description: ISO 4217 currency code.+ default_locale:+ type: string+ example: de+ description: IETF locale tag used as the market default.+ supported_locales:+ type: array+ items:+ type: string+ description: Locale codes available in this market. The default+ is always implicitly included.+ example:+ - de+ - en+ tax_inclusive:+ type: boolean+ default: false+ description: Display prices with tax included.+ default:+ type: boolean+ default: false+ description: Setting to true demotes the previous default.+ position:+ type: integer+ description: Sort order within the store; lower = first.+ country_isos:+ type: array+ items:+ type: string+ description: 2-letter ISO country codes assigned to this market.+ At least one is required.+ example:+ - DE+ - FR+ required:+ - name+ - currency+ - default_locale+ - country_isos"/api/v3/admin/markets/{id}":parameters:- name: id@@ -4516,8 +4660,10 @@ paths:default: falsesupported_locales:- en- created_at: '2026-05-25T19:04:05.942Z'- updated_at: '2026-05-25T19:04:05.942Z'+ country_isos:+ - DE+ created_at: '2026-05-26T12:43:16.211Z'+ updated_at: '2026-05-26T12:43:16.211Z'schema:"$ref": "#/components/schemas/Market"'404':@@ -4530,6 +4676,162 @@ paths:message: Market not foundschema:"$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update a market+ tags:+ - Pricing+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Updates an existing market. Pass `country_isos` to replace the+ market's country list (full-set update), `supported_locales` to+ replace the supported locales, or `position` to reorder the market+ within the store.++ Setting `default: true` automatically demotes the previous default.+++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ // `country_isos` is a full-set update — the market is reconciled to match+ // the array (adds new countries, removes ones not present). Setting+ // `default: true` demotes the previous default market in the store.+ const market = await client.markets.update('market_UkLWZg9DAJ', {+ name: 'European Union',+ tax_inclusive: true,+ country_isos: ['DE', 'FR'],+ })+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ schema:+ type: string+ responses:+ '200':+ description: market updated+ content:+ application/json:+ example:+ id: mkt_UkLWZg9DAJ+ name: European Union+ currency: USD+ default_locale: en+ tax_inclusive: true+ default: false+ supported_locales:+ - en+ country_isos:+ - DE+ created_at: '2026-05-26T12:43:16.815Z'+ updated_at: '2026-05-26T12:43:17.100Z'+ schema:+ "$ref": "#/components/schemas/Market"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ name:+ type: string+ currency:+ type: string+ default_locale:+ type: string+ supported_locales:+ type: array+ items:+ type: string+ tax_inclusive:+ type: boolean+ default:+ type: boolean+ position:+ type: integer+ country_isos:+ type: array+ items:+ type: string+ delete:+ summary: Delete a market+ tags:+ - Pricing+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Soft-deletes the market (sets `deleted_at`). The default market and+ the last remaining market in a store cannot be deleted — both return+ 422 with a `validation_error`.+++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ // Soft-deletes the market (sets `deleted_at`). The default market and the+ // last remaining market in a store cannot be deleted — both return 422.+ await client.markets.delete('market_UkLWZg9DAJ')+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ schema:+ type: string+ responses:+ '204':+ description: market deleted+ '422':+ description: cannot delete default or last market+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Market cannot be deleted"/api/v3/admin/me":get:summary: Get current admin user and permissions@@ -4575,12 +4877,12 @@ paths:example:user:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Alix- last_name: Cormier- full_name: Alix Cormier- created_at: '2026-05-25T19:04:06.794Z'- updated_at: '2026-05-25T19:04:06.794Z'+ email: [email protected]+ first_name: Milagro+ last_name: Marks+ full_name: Milagro Marks+ created_at: '2026-05-26T12:43:18.270Z'+ updated_at: '2026-05-26T12:43:18.270Z'roles:- id: role_UkLWZg9DAJname: admin@@ -4730,8 +5032,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-25T19:04:06.835Z'- updated_at: '2026-05-25T19:04:06.835Z'+ created_at: '2026-05-26T12:43:18.311Z'+ updated_at: '2026-05-26T12:43:18.311Z'meta:page: 1limit: 25@@ -4822,8 +5124,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-25T19:04:07.413Z'- updated_at: '2026-05-25T19:04:07.413Z'+ created_at: '2026-05-26T12:43:18.885Z'+ updated_at: '2026-05-26T12:43:18.885Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -4944,8 +5246,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-25T19:04:07.702Z'- updated_at: '2026-05-25T19:04:07.702Z'+ created_at: '2026-05-26T12:43:19.174Z'+ updated_at: '2026-05-26T12:43:19.174Z'schema:"$ref": "#/components/schemas/OptionType"'404':@@ -5017,8 +5319,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-25T19:04:08.266Z'- updated_at: '2026-05-25T19:04:08.546Z'+ created_at: '2026-05-26T12:43:19.734Z'+ updated_at: '2026-05-26T12:43:20.014Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -5177,7 +5479,7 @@ paths:example:data:- id: ful_UkLWZg9DAJ- number: H83621674503+ number: H72381361328tracking: U10000tracking_url:cost: '10.0'@@ -5202,8 +5504,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:09.505Z'- updated_at: '2026-05-25T19:04:09.570Z'+ created_at: '2026-05-26T12:43:20.965Z'+ updated_at: '2026-05-26T12:43:21.034Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJmeta:@@ -5286,7 +5588,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H70407525674+ number: H55504215330tracking: U10000tracking_url:cost: '10.0'@@ -5311,8 +5613,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:10.193Z'- updated_at: '2026-05-25T19:04:10.259Z'+ created_at: '2026-05-26T12:43:21.647Z'+ updated_at: '2026-05-26T12:43:21.706Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJpatch:@@ -5371,7 +5673,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H75251004587+ number: H24051808415tracking: 1Z999AA10123456784tracking_url: https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=1Z999AA10123456784cost: '10.0'@@ -5396,8 +5698,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:10.854Z'- updated_at: '2026-05-25T19:04:11.185Z'+ created_at: '2026-05-26T12:43:22.301Z'+ updated_at: '2026-05-26T12:43:22.638Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJrequestBody:@@ -5466,7 +5768,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H47211209656+ number: H24412245737tracking: U10000tracking_url:cost: '10.0'@@ -5483,7 +5785,7 @@ paths:display_tax_total: "$0.00"status: shippedfulfillment_type: shipping- fulfilled_at: '2026-05-25T19:04:11Z'+ fulfilled_at: '2026-05-26T12:43:23Z'items:- item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJ@@ -5491,8 +5793,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:11.493Z'- updated_at: '2026-05-25T19:04:11.840Z'+ created_at: '2026-05-26T12:43:22.946Z'+ updated_at: '2026-05-26T12:43:23.313Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":@@ -5550,7 +5852,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H58682751279+ number: H57549274092tracking: U10000tracking_url:cost: '10.0'@@ -5575,8 +5877,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:12.164Z'- updated_at: '2026-05-25T19:04:12.508Z'+ created_at: '2026-05-26T12:43:23.670Z'+ updated_at: '2026-05-26T12:43:24.005Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":@@ -5634,7 +5936,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H41615282915+ number: H33252464732tracking: U10000tracking_url:cost: '10.0'@@ -5659,8 +5961,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:12.829Z'- updated_at: '2026-05-25T19:04:13.180Z'+ created_at: '2026-05-26T12:43:24.327Z'+ updated_at: '2026-05-26T12:43:24.678Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":@@ -5721,7 +6023,7 @@ paths:example:data:- id: ful_gbHJdmfrXB- number: H41242832182+ number: H76063483327tracking:tracking_url:cost: '10.0'@@ -5746,8 +6048,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-25T19:04:13.876Z'- updated_at: '2026-05-25T19:04:13.923Z'+ created_at: '2026-05-26T12:43:25.353Z'+ updated_at: '2026-05-26T12:43:25.395Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_gbHJdmfrXBrequestBody:@@ -5819,7 +6121,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 73E9905C2F1D246C+ code: 000AFB3EB6BC1603status: activecurrency: USDamount: '10.0'@@ -5833,8 +6135,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-25T19:04:14.259Z'- updated_at: '2026-05-25T19:04:14.559Z'+ created_at: '2026-05-26T12:43:25.722Z'+ updated_at: '2026-05-26T12:43:26.027Z'customer_id:created_by_id:requestBody:@@ -5967,8 +6269,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 2currency: USD- name: Product 108069- slug: product-108069+ name: Product 108818+ slug: product-108818options_text: 'Size: S'price: '10.0'display_price: "$10.00"@@ -6000,12 +6302,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:04:15.243Z'- updated_at: '2026-05-25T19:04:15.243Z'+ created_at: '2026-05-26T12:43:26.704Z'+ updated_at: '2026-05-26T12:43:26.704Z'digital_links: []metadata: {}- created_at: '2026-05-25T19:04:15.528Z'- updated_at: '2026-05-25T19:04:15.528Z'+ created_at: '2026-05-26T12:43:26.991Z'+ updated_at: '2026-05-26T12:43:26.991Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJmeta:@@ -6072,8 +6374,8 @@ paths:variant_id: variant_VqXmZF31wYquantity: 3currency: USD- name: Product 125746- slug: product-125746+ name: Product 129518+ slug: product-129518options_text: 'Size: S'price: '19.99'display_price: "$19.99"@@ -6105,12 +6407,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:04:16.437Z'- updated_at: '2026-05-25T19:04:16.437Z'+ created_at: '2026-05-26T12:43:27.918Z'+ updated_at: '2026-05-26T12:43:27.918Z'digital_links: []metadata: {}- created_at: '2026-05-25T19:04:16.478Z'- updated_at: '2026-05-25T19:04:16.478Z'+ created_at: '2026-05-26T12:43:27.951Z'+ updated_at: '2026-05-26T12:43:27.951Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJrequestBody:@@ -6199,8 +6501,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 2currency: USD- name: Product 134328- slug: product-134328+ name: Product 132864+ slug: product-132864options_text: 'Size: S'price: '10.0'display_price: "$10.00"@@ -6232,12 +6534,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:04:16.552Z'- updated_at: '2026-05-25T19:04:16.552Z'+ created_at: '2026-05-26T12:43:28.018Z'+ updated_at: '2026-05-26T12:43:28.018Z'digital_links: []metadata: {}- created_at: '2026-05-25T19:04:16.835Z'- updated_at: '2026-05-25T19:04:16.835Z'+ created_at: '2026-05-26T12:43:28.304Z'+ updated_at: '2026-05-26T12:43:28.304Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJpatch:@@ -6299,8 +6601,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 5currency: USD- name: Product 146043- slug: product-146043+ name: Product 147088+ slug: product-147088options_text: 'Size: S'price: '19.99'display_price: "$19.99"@@ -6332,12 +6634,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:04:17.158Z'- updated_at: '2026-05-25T19:04:17.158Z'+ created_at: '2026-05-26T12:43:28.621Z'+ updated_at: '2026-05-26T12:43:28.621Z'digital_links: []metadata: {}- created_at: '2026-05-25T19:04:17.446Z'- updated_at: '2026-05-25T19:04:17.742Z'+ created_at: '2026-05-26T12:43:28.907Z'+ updated_at: '2026-05-26T12:43:29.205Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJrequestBody:@@ -6463,8 +6765,8 @@ paths:data:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-3ece195ef92b- number: PLFNF8W9+ response_code: BGS-558e57f5d744+ number: PNDTT9GCamount: '110.0'display_amount: "$110.00"status: completed@@ -6482,14 +6784,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-25T19:04:18.741Z'- updated_at: '2026-05-25T19:04:18.744Z'+ created_at: '2026-05-26T12:43:30.195Z'+ updated_at: '2026-05-26T12:43:30.197Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-25T19:04:18.743Z'- updated_at: '2026-05-25T19:04:18.743Z'+ created_at: '2026-05-26T12:43:30.196Z'+ updated_at: '2026-05-26T12:43:30.196Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJmeta:@@ -6556,7 +6858,7 @@ paths:id: py_gbHJdmfrXBpayment_method_id: pm_EfhxLZ9ck8response_code:- number: PF9XNZOK+ number: PRLXLSE1amount: '110.0'display_amount: "$110.00"status: checkout@@ -6567,8 +6869,8 @@ paths:avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-25T19:04:20.060Z'- updated_at: '2026-05-25T19:04:20.060Z'+ created_at: '2026-05-26T12:43:31.503Z'+ updated_at: '2026-05-26T12:43:31.503Z'captured_amount: '0.0'order_id: or_gbHJdmfrXBrequestBody:@@ -6658,8 +6960,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-097c72fbdafa- number: PVJS99Y7+ response_code: BGS-d877df37d6f0+ number: P2VPLRI1amount: '110.0'display_amount: "$110.00"status: completed@@ -6677,14 +6979,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-25T19:04:20.423Z'- updated_at: '2026-05-25T19:04:20.426Z'+ created_at: '2026-05-26T12:43:31.879Z'+ updated_at: '2026-05-26T12:43:31.882Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-25T19:04:20.425Z'- updated_at: '2026-05-25T19:04:20.425Z'+ created_at: '2026-05-26T12:43:31.881Z'+ updated_at: '2026-05-26T12:43:31.881Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/payments/{id}/capture":@@ -6743,8 +7045,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-f1bc88b29118- number: P84XH1SZ+ response_code: BGS-854a246a7c2d+ number: PIJ45Z2Mamount: '110.0'display_amount: "$110.00"status: completed@@ -6762,14 +7064,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-25T19:04:21.070Z'- updated_at: '2026-05-25T19:04:21.072Z'+ created_at: '2026-05-26T12:43:32.537Z'+ updated_at: '2026-05-26T12:43:32.539Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-25T19:04:21.071Z'- updated_at: '2026-05-25T19:04:21.416Z'+ created_at: '2026-05-26T12:43:32.538Z'+ updated_at: '2026-05-26T12:43:32.866Z'captured_amount: '110.0'order_id: or_UkLWZg9DAJ'422':@@ -6838,8 +7140,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: void-BGS-b89f3f6ea6fb- number: PGIXCHU8+ response_code: void-BGS-2ed11968ee67+ number: PA0YA2SBamount: '110.0'display_amount: "$110.00"status: void@@ -6857,14 +7159,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-25T19:04:22.506Z'- updated_at: '2026-05-25T19:04:22.508Z'+ created_at: '2026-05-26T12:43:33.925Z'+ updated_at: '2026-05-26T12:43:33.928Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-25T19:04:22.507Z'- updated_at: '2026-05-25T19:04:22.805Z'+ created_at: '2026-05-26T12:43:33.927Z'+ updated_at: '2026-05-26T12:43:34.225Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/refunds":@@ -6992,14 +7294,14 @@ paths:application/json:example:id: re_UkLWZg9DAJ- transaction_id: BGS-20078f8c4615+ transaction_id: BGS-8f6bb1510833amount: '5.0'payment_id: py_UkLWZg9DAJrefund_reason_id: rr_UkLWZg9DAJreimbursement_id:metadata: {}- created_at: '2026-05-25T19:04:24.162Z'- updated_at: '2026-05-25T19:04:24.162Z'+ created_at: '2026-05-26T12:43:35.559Z'+ updated_at: '2026-05-26T12:43:35.559Z'requestBody:content:application/json:@@ -7071,8 +7373,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R068431070- email: [email protected]+ number: R911948765+ email: [email protected]customer_note:currency: USDlocale: en@@ -7115,8 +7417,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:24.459Z'- updated_at: '2026-05-25T19:04:24.517Z'+ created_at: '2026-05-26T12:43:35.855Z'+ updated_at: '2026-05-26T12:43:35.906Z'preferred_stock_location_id:tags: []internal_note:@@ -7287,8 +7589,8 @@ paths:- id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R735314054- email: [email protected]+ number: R530084501+ email: [email protected]customer_note:currency: USDlocale: en@@ -7331,8 +7633,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:26.257Z'- updated_at: '2026-05-25T19:04:26.257Z'+ created_at: '2026-05-26T12:43:37.653Z'+ updated_at: '2026-05-26T12:43:37.653Z'preferred_stock_location_id:tags: []internal_note:@@ -7475,7 +7777,7 @@ paths:id: or_gbHJdmfrXBmarket_id:channel_id: ch_UkLWZg9DAJ- number: R333487155+ number: R383898514email: [email protected]customer_note:currency: USD@@ -7519,8 +7821,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:27.940Z'- updated_at: '2026-05-25T19:04:27.943Z'+ created_at: '2026-05-26T12:43:39.336Z'+ updated_at: '2026-05-26T12:43:39.338Z'preferred_stock_location_id: sloc_UkLWZg9DAJtags: []internal_note:@@ -7704,8 +8006,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R936227067- email: [email protected]+ number: R366457856+ email: [email protected]customer_note:currency: USDlocale: en@@ -7748,8 +8050,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:28.215Z'- updated_at: '2026-05-25T19:04:28.215Z'+ created_at: '2026-05-26T12:43:39.618Z'+ updated_at: '2026-05-26T12:43:39.618Z'preferred_stock_location_id:tags: []internal_note:@@ -7820,7 +8122,7 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R121358504+ number: R554622571email: [email protected]customer_note:currency: USD@@ -7864,8 +8166,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:29.315Z'- updated_at: '2026-05-25T19:04:29.599Z'+ created_at: '2026-05-26T12:43:40.726Z'+ updated_at: '2026-05-26T12:43:41.017Z'preferred_stock_location_id:tags: []internal_note:@@ -8046,8 +8348,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R908661878- email: [email protected]+ number: R277721850+ email: [email protected]customer_note:currency: USDlocale: en@@ -8074,7 +8376,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status: readypayment_status: paid- completed_at: '2026-05-25T19:04:30.505Z'+ completed_at: '2026-05-26T12:43:41.913Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8090,8 +8392,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:30.459Z'- updated_at: '2026-05-25T19:04:30.527Z'+ created_at: '2026-05-26T12:43:41.861Z'+ updated_at: '2026-05-26T12:43:41.939Z'preferred_stock_location_id:tags: []internal_note:@@ -8172,8 +8474,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R902515776- email: [email protected]+ number: R820951567+ email: [email protected]customer_note:currency: USDlocale: en@@ -8200,7 +8502,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: canceledpayment_status: void- completed_at: '2026-05-25T19:04:31.771Z'+ completed_at: '2026-05-26T12:43:43.178Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8214,10 +8516,10 @@ paths:payment_total: '0.0'display_payment_total: "$0.00"metadata: {}- canceled_at: '2026-05-25T19:04:32.064Z'+ canceled_at: '2026-05-26T12:43:43.471Z'approved_at:- created_at: '2026-05-25T19:04:31.709Z'- updated_at: '2026-05-25T19:04:32.107Z'+ created_at: '2026-05-26T12:43:43.130Z'+ updated_at: '2026-05-26T12:43:43.511Z'preferred_stock_location_id:tags: []internal_note:@@ -8276,8 +8578,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R224402224- email: [email protected]+ number: R358980474+ email: [email protected]customer_note:currency: USDlocale: en@@ -8304,7 +8606,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-25T19:04:32.458Z'+ completed_at: '2026-05-26T12:43:43.853Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8319,9 +8621,9 @@ paths:display_payment_total: "$0.00"metadata: {}canceled_at:- approved_at: '2026-05-25T19:04:32.747Z'- created_at: '2026-05-25T19:04:32.407Z'- updated_at: '2026-05-25T19:04:32.458Z'+ approved_at: '2026-05-26T12:43:44.139Z'+ created_at: '2026-05-26T12:43:43.804Z'+ updated_at: '2026-05-26T12:43:43.853Z'preferred_stock_location_id:tags: []internal_note:@@ -8380,8 +8682,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R580040222- email: [email protected]+ number: R199529795+ email: [email protected]customer_note:currency: USDlocale: en@@ -8408,7 +8710,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: canceledpayment_status: void- completed_at: '2026-05-25T19:04:33.084Z'+ completed_at: '2026-05-26T12:43:44.485Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8422,10 +8724,10 @@ paths:payment_total: '0.0'display_payment_total: "$0.00"metadata: {}- canceled_at: '2026-05-25T19:04:33.362Z'+ canceled_at: '2026-05-26T12:43:44.762Z'approved_at:- created_at: '2026-05-25T19:04:33.031Z'- updated_at: '2026-05-25T19:04:33.439Z'+ created_at: '2026-05-26T12:43:44.432Z'+ updated_at: '2026-05-26T12:43:44.844Z'preferred_stock_location_id:tags: []internal_note:@@ -8484,8 +8786,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R160629193- email: [email protected]+ number: R108673461+ email: [email protected]customer_note:currency: USDlocale: en@@ -8512,7 +8814,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-25T19:04:33.776Z'+ completed_at: '2026-05-26T12:43:45.173Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8528,8 +8830,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-25T19:04:33.722Z'- updated_at: '2026-05-25T19:04:33.776Z'+ created_at: '2026-05-26T12:43:45.123Z'+ updated_at: '2026-05-26T12:43:45.173Z'preferred_stock_location_id:tags: []internal_note:@@ -8604,8 +8906,8 @@ paths:auto_capture:storefront_visible: trueposition: 1- created_at: '2026-05-25T19:04:34.075Z'- updated_at: '2026-05-25T19:04:34.076Z'+ created_at: '2026-05-26T12:43:45.478Z'+ updated_at: '2026-05-26T12:43:45.480Z'preferences: {}preference_schema: []meta:@@ -8745,8 +9047,8 @@ paths:auto_capture:storefront_visible: trueposition: 1- created_at: '2026-05-25T19:04:34.649Z'- updated_at: '2026-05-25T19:04:34.650Z'+ created_at: '2026-05-26T12:43:46.061Z'+ updated_at: '2026-05-26T12:43:46.062Z'preferences: {}preference_schema: []"/api/v3/admin/price_lists":@@ -8818,8 +9120,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:34.943Z'- updated_at: '2026-05-25T19:04:34.943Z'+ deleted_at:+ created_at: '2026-05-26T12:43:46.345Z'+ updated_at: '2026-05-26T12:43:46.345Z'currently_active: falseproducts_count: 0prices_count: 0@@ -8832,8 +9135,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:34.944Z'- updated_at: '2026-05-25T19:04:34.944Z'+ deleted_at:+ created_at: '2026-05-26T12:43:46.346Z'+ updated_at: '2026-05-26T12:43:46.346Z'currently_active: falseproducts_count: 0prices_count: 0@@ -8896,8 +9200,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:35.982Z'- updated_at: '2026-05-25T19:04:35.984Z'+ deleted_at:+ created_at: '2026-05-26T12:43:47.340Z'+ updated_at: '2026-05-26T12:43:47.342Z'currently_active: falseproducts_count: 1prices_count: 2@@ -9044,8 +9349,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:36.293Z'- updated_at: '2026-05-25T19:04:36.293Z'+ deleted_at:+ created_at: '2026-05-26T12:43:47.639Z'+ updated_at: '2026-05-26T12:43:47.639Z'currently_active: falseproducts_count: 0prices_count: 0@@ -9102,8 +9408,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:37.933Z'- updated_at: '2026-05-25T19:04:38.228Z'+ deleted_at:+ created_at: '2026-05-26T12:43:49.202Z'+ updated_at: '2026-05-26T12:43:49.480Z'currently_active: falseproducts_count: 0prices_count: 0@@ -9161,12 +9468,16 @@ paths:prices:type: arraydescription: Individual price overrides (the spreadsheet payload).- Each row updates an existing Price by `id`; unchanged rows are- no-ops server-side.+ Each row updates by `id` if shipped, otherwise upserts on the+ unique key `(variant_id, currency, price_list_id)`.items:type: object- required:- - id+ oneOf:+ - required:+ - id+ - required:+ - variant_id+ - currencyproperties:id:type: string@@ -9256,8 +9567,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:38.521Z'- updated_at: '2026-05-25T19:04:38.798Z'+ deleted_at:+ created_at: '2026-05-26T12:43:49.788Z'+ updated_at: '2026-05-26T12:43:50.099Z'currently_active: trueproducts_count: 0prices_count: 0@@ -9304,8 +9616,9 @@ paths:match_policy: allstarts_at:ends_at:- created_at: '2026-05-25T19:04:38.805Z'- updated_at: '2026-05-25T19:04:39.088Z'+ deleted_at:+ created_at: '2026-05-26T12:43:50.129Z'+ updated_at: '2026-05-26T12:43:50.432Z'currently_active: falseproducts_count: 0prices_count: 0@@ -9416,8 +9729,8 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_gbHJdmfrXB- created_at: '2026-05-25T19:04:39.143Z'- updated_at: '2026-05-25T19:04:39.143Z'+ created_at: '2026-05-26T12:43:50.504Z'+ updated_at: '2026-05-26T12:43:50.504Z'- id: price_EfhxLZ9ck8amount: '5.0'amount_in_cents: 500@@ -9428,8 +9741,8 @@ paths:display_compare_at_amount:price_list_id: pl_UkLWZg9DAJvariant_id: variant_gbHJdmfrXB- created_at: '2026-05-25T19:04:39.147Z'- updated_at: '2026-05-25T19:04:39.147Z'+ created_at: '2026-05-26T12:43:50.508Z'+ updated_at: '2026-05-26T12:43:50.508Z'meta:page: 1limit: 25@@ -9508,8 +9821,8 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_EfhxLZ9ck8- created_at: '2026-05-25T19:04:39.801Z'- updated_at: '2026-05-25T19:04:39.801Z'+ created_at: '2026-05-26T12:43:51.148Z'+ updated_at: '2026-05-26T12:43:51.148Z'schema:"$ref": "#/components/schemas/Price"requestBody:@@ -9593,8 +9906,8 @@ paths:display_compare_at_amount:price_list_id: pl_UkLWZg9DAJvariant_id: variant_gbHJdmfrXB- created_at: '2026-05-25T19:04:39.871Z'- updated_at: '2026-05-25T19:04:39.871Z'+ created_at: '2026-05-26T12:43:51.216Z'+ updated_at: '2026-05-26T12:43:51.216Z'schema:"$ref": "#/components/schemas/Price"'404':@@ -9656,8 +9969,8 @@ paths:display_compare_at_amount:price_list_id: pl_UkLWZg9DAJvariant_id: variant_gbHJdmfrXB- created_at: '2026-05-25T19:04:40.564Z'- updated_at: '2026-05-25T19:04:40.843Z'+ created_at: '2026-05-26T12:43:51.895Z'+ updated_at: '2026-05-26T12:43:52.182Z'schema:"$ref": "#/components/schemas/Price"requestBody:@@ -9803,6 +10116,9 @@ paths:type: arrayitems:type: object+ required:+ - variant_id+ - currencyproperties:id:type: string@@ -9954,8 +10270,8 @@ paths:field_type: short_textkey: custom.titlevalue: wool- created_at: '2026-05-25T19:04:42.312Z'- updated_at: '2026-05-25T19:04:42.312Z'+ created_at: '2026-05-26T12:43:53.647Z'+ updated_at: '2026-05-26T12:43:53.647Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJmeta:@@ -10022,8 +10338,8 @@ paths:field_type: long_textkey: custom.descriptionvalue: A longer description- created_at: '2026-05-25T19:04:42.930Z'- updated_at: '2026-05-25T19:04:42.930Z'+ created_at: '2026-05-26T12:43:54.246Z'+ updated_at: '2026-05-26T12:43:54.246Z'storefront_visible: truecustom_field_definition_id: cfdef_gbHJdmfrXB'422':@@ -10107,8 +10423,8 @@ paths:field_type: short_textkey: custom.titlevalue: wool- created_at: '2026-05-25T19:04:43.280Z'- updated_at: '2026-05-25T19:04:43.280Z'+ created_at: '2026-05-26T12:43:54.597Z'+ updated_at: '2026-05-26T12:43:54.597Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJpatch:@@ -10155,8 +10471,8 @@ paths:field_type: short_textkey: custom.titlevalue: cotton- created_at: '2026-05-25T19:04:43.588Z'- updated_at: '2026-05-25T19:04:43.864Z'+ created_at: '2026-05-26T12:43:54.908Z'+ updated_at: '2026-05-26T12:43:55.194Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJrequestBody:@@ -10294,34 +10610,28 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 556768- slug: product-556768+ name: Product 555940+ slug: product-555940meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-25T19:04:44.190Z'+ available_on: '2025-05-26T12:43:55.526Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Nemo voluptatem hic error nam soluta aliquam quod.- Deleniti odio enim doloremque provident voluptatum. Cupiditate- quos eum temporibus quisquam quas. Odio mollitia illo sunt adipisci- officiis quibusdam vero excepturi. Natus accusamus nostrum libero- corporis explicabo illum harum soluta. Blanditiis tempore voluptate- ipsam similique voluptates explicabo. Soluta alias adipisci eveniet- ipsam. Vel delectus asperiores enim accusamus vitae. Itaque laboriosam- repellendus ut et quidem autem. Quas hic eum fuga corrupti fugit- quo tempora. Nulla aliquam odio facere ab in reprehenderit voluptates.- Nesciunt assumenda blanditiis tempora libero. Cum doloribus ullam- illum nisi. Ratione nesciunt numquam sint eum. Dignissimos odit- velit omnis nesciunt.+ description: Sed officiis delectus neque eos tempore. Voluptatum+ tenetur reprehenderit enim cum itaque ea aut voluptatibus. Iste+ sequi explicabo rem placeat modi reprehenderit perspiciatis. Consectetur+ eveniet iure numquam vitae repellendus fuga. Illum eaque suscipit+ dolor aspernatur aperiam itaque sed. Id quia eius praesentium+ accusamus deserunt placeat. Blanditiis culpa necessitatibus eligendi+ quos explicabo temporibus iusto neque. Blanditiis ratione enim+ dignissimos laudantium fugit.description_html: |-- Nemo voluptatem hic error nam soluta aliquam quod. Deleniti odio enim doloremque provident voluptatum. Cupiditate quos eum temporibus quisquam quas. Odio mollitia illo sunt adipisci officiis quibusdam vero excepturi.- Natus accusamus nostrum libero corporis explicabo illum harum soluta. Blanditiis tempore voluptate ipsam similique voluptates explicabo. Soluta alias adipisci eveniet ipsam.- Vel delectus asperiores enim accusamus vitae. Itaque laboriosam repellendus ut et quidem autem. Quas hic eum fuga corrupti fugit quo tempora.- Nulla aliquam odio facere ab in reprehenderit voluptates. Nesciunt assumenda blanditiis tempora libero. Cum doloribus ullam illum nisi. Ratione nesciunt numquam sint eum. Dignissimos odit velit omnis nesciunt.+ Sed officiis delectus neque eos tempore. Voluptatum tenetur reprehenderit enim cum itaque ea aut voluptatibus. Iste sequi explicabo rem placeat modi reprehenderit perspiciatis. Consectetur eveniet iure numquam vitae repellendus fuga. Illum eaque suscipit dolor aspernatur aperiam itaque sed.+ Id quia eius praesentium accusamus deserunt placeat. Blanditiis culpa necessitatibus eligendi quos explicabo temporibus iusto neque. Blanditiis ratione enim dignissimos laudantium fugit.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -10336,16 +10646,16 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-05-25T19:04:44.223Z'- updated_at: '2026-05-25T19:04:44.223Z'+ created_at: '2026-05-26T12:43:55.554Z'+ updated_at: '2026-05-26T12:43:55.554Z'original_price:status: active- make_active_at: '2025-05-25T19:04:44.190Z'+ make_active_at: '2025-05-26T12:43:55.526Z'discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-25T19:04:44.206Z'- updated_at: '2026-05-25T19:04:44.224Z'+ created_at: '2026-05-26T12:43:55.540Z'+ updated_at: '2026-05-26T12:43:55.555Z'tax_category_id: taxcat_UkLWZg9DAJmeta:page: 1@@ -10479,8 +10789,8 @@ paths:discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-25T19:04:44.874Z'- updated_at: '2026-05-25T19:04:44.876Z'+ created_at: '2026-05-26T12:43:56.215Z'+ updated_at: '2026-05-26T12:43:56.218Z'tax_category_id:schema:"$ref": "#/components/schemas/Product"@@ -10660,28 +10970,28 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 593396- slug: product-593396+ name: Product 599015+ slug: product-599015meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-25T19:04:45.226Z'+ available_on: '2025-05-26T12:43:56.578Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Culpa nostrum ipsam laudantium reprehenderit dolorum.- Inventore reprehenderit nam provident quaerat fugiat deserunt veniam.- Iusto sed non possimus tempora. Quaerat ut voluptatum facilis enim- omnis ab. Earum nam architecto quo eaque. Placeat officia est laborum- vitae vero animi. Eaque harum aspernatur et maiores ipsam corporis- officia itaque. Ex eligendi ratione doloribus exercitationem suscipit- voluptate quam. Quia explicabo autem maxime officiis illo excepturi.- Quos facere iste libero assumenda.+ description: Laudantium eius ea quasi recusandae vero. Nihil officia+ culpa voluptatum iusto. Tempore delectus sint minus aliquam doloribus+ quos libero. Iusto dolorum nemo alias porro modi officia fugit rerum.+ Aut facilis debitis provident omnis rerum eligendi eum a. Quam quaerat+ maiores hic aliquid perspiciatis dolorum commodi dolor. Molestiae+ provident porro expedita cupiditate asperiores adipisci dolor. Officiis+ beatae ut accusantium laborum enim sunt ex illo. Numquam natus odio+ officiis dolore nulla.description_html: |-- Culpa nostrum ipsam laudantium reprehenderit dolorum. Inventore reprehenderit nam provident quaerat fugiat deserunt veniam. Iusto sed non possimus tempora. Quaerat ut voluptatum facilis enim omnis ab. Earum nam architecto quo eaque.- Placeat officia est laborum vitae vero animi. Eaque harum aspernatur et maiores ipsam corporis officia itaque. Ex eligendi ratione doloribus exercitationem suscipit voluptate quam. Quia explicabo autem maxime officiis illo excepturi. Quos facere iste libero assumenda.+ Laudantium eius ea quasi recusandae vero. Nihil officia culpa voluptatum iusto. Tempore delectus sint minus aliquam doloribus quos libero. Iusto dolorum nemo alias porro modi officia fugit rerum.+ Aut facilis debitis provident omnis rerum eligendi eum a. Quam quaerat maiores hic aliquid perspiciatis dolorum commodi dolor. Molestiae provident porro expedita cupiditate asperiores adipisci dolor. Officiis beatae ut accusantium laborum enim sunt ex illo. Numquam natus odio officiis dolore nulla.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -10696,16 +11006,16 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-05-25T19:04:45.258Z'- updated_at: '2026-05-25T19:04:45.258Z'+ created_at: '2026-05-26T12:43:56.602Z'+ updated_at: '2026-05-26T12:43:56.602Z'original_price:status: active- make_active_at: '2025-05-25T19:04:45.226Z'+ make_active_at: '2025-05-26T12:43:56.578Z'discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-25T19:04:45.243Z'- updated_at: '2026-05-25T19:04:45.260Z'+ created_at: '2026-05-26T12:43:56.590Z'+ updated_at: '2026-05-26T12:43:56.603Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -10772,22 +11082,28 @@ paths:example:id: prod_UkLWZg9DAJname: Updated Name- slug: product-612429+ slug: product-614078meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-25T19:04:45.871Z'+ available_on: '2025-05-26T12:43:57.210Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Quasi doloremque labore quaerat cum quos excepturi nisi.- Facere minima consectetur assumenda eum officiis perspiciatis ipsa- aperiam. Numquam nobis labore et eligendi sit debitis.- description_html: Quasi doloremque labore quaerat cum quos excepturi- nisi. Facere minima consectetur assumenda eum officiis perspiciatis- ipsa aperiam. Numquam nobis labore et eligendi sit debitis.+ description: Expedita officia vero atque saepe voluptatem. Cumque+ explicabo totam vitae similique alias. Sed dolore ipsa dolorum quae.+ Vero accusamus officia ea expedita. Quisquam modi quos rem ad. Dolorum+ qui quam animi explicabo vitae molestias. Iusto labore doloribus+ iste fugit nemo unde dignissimos. Distinctio illum ab ipsam omnis+ eaque nam. Tempore impedit nulla voluptatem autem sint aliquam.+ Voluptates eos quaerat similique quisquam facere unde culpa. Molestias+ ea ducimus sapiente architecto inventore sint officiis cumque.+ description_html: |-+ Expedita officia vero atque saepe voluptatem. Cumque explicabo totam vitae similique alias. Sed dolore ipsa dolorum quae.+ Vero accusamus officia ea expedita. Quisquam modi quos rem ad. Dolorum qui quam animi explicabo vitae molestias.+ Iusto labore doloribus iste fugit nemo unde dignissimos. Distinctio illum ab ipsam omnis eaque nam. Tempore impedit nulla voluptatem autem sint aliquam. Voluptates eos quaerat similique quisquam facere unde culpa. Molestias ea ducimus sapiente architecto inventore sint officiis cumque.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -10802,16 +11118,16 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-05-25T19:04:45.893Z'- updated_at: '2026-05-25T19:04:45.893Z'+ created_at: '2026-05-26T12:43:57.235Z'+ updated_at: '2026-05-26T12:43:57.235Z'original_price:status: active- make_active_at: '2025-05-25T19:04:45.871Z'+ make_active_at: '2025-05-26T12:43:57.210Z'discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-25T19:04:45.882Z'- updated_at: '2026-05-25T19:04:46.182Z'+ created_at: '2026-05-26T12:43:57.223Z'+ updated_at: '2026-05-26T12:43:57.528Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -11344,8 +11660,8 @@ paths:example:data:- id: pact_UkLWZg9DAJ- created_at: '2026-05-25T19:04:49.539Z'- updated_at: '2026-05-25T19:04:49.539Z'+ created_at: '2026-05-26T12:44:00.929Z'+ updated_at: '2026-05-26T12:44:00.929Z'type: free_shippingpromotion_id: promo_UkLWZg9DAJpreferences: {}@@ -11406,8 +11722,8 @@ paths:application/json:example:id: pact_UkLWZg9DAJ- created_at: '2026-05-25T19:04:50.094Z'- updated_at: '2026-05-25T19:04:50.094Z'+ created_at: '2026-05-26T12:44:01.503Z'+ updated_at: '2026-05-26T12:44:01.503Z'type: free_shippingpromotion_id: promo_UkLWZg9DAJpreferences: {}@@ -11517,8 +11833,8 @@ paths:example:data:- id: prorule_UkLWZg9DAJ- created_at: '2026-05-25T19:04:50.664Z'- updated_at: '2026-05-25T19:04:50.664Z'+ created_at: '2026-05-26T12:44:02.087Z'+ updated_at: '2026-05-26T12:44:02.087Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -11585,8 +11901,8 @@ paths:application/json:example:id: prorule_UkLWZg9DAJ- created_at: '2026-05-25T19:04:51.238Z'- updated_at: '2026-05-25T19:04:51.238Z'+ created_at: '2026-05-26T12:44:02.661Z'+ updated_at: '2026-05-26T12:44:02.661Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -11659,8 +11975,8 @@ paths:application/json:example:id: prorule_UkLWZg9DAJ- created_at: '2026-05-25T19:04:51.533Z'- updated_at: '2026-05-25T19:04:51.808Z'+ created_at: '2026-05-26T12:44:02.954Z'+ updated_at: '2026-05-26T12:44:03.236Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -11750,7 +12066,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-05-25T19:04:52.093Z'+ starts_at: '2026-05-26T12:44:03.527Z'expires_at:usage_limit:match_policy: all@@ -11761,8 +12077,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-25T19:04:52.094Z'- updated_at: '2026-05-25T19:04:52.095Z'+ created_at: '2026-05-26T12:44:03.529Z'+ updated_at: '2026-05-26T12:44:03.530Z'store_ids:- store_UkLWZg9DAJaction_ids: []@@ -11868,7 +12184,7 @@ paths:name: Black Fridaydescription:code: blackfriday-os- starts_at: '2026-05-25T19:04:53.049Z'+ starts_at: '2026-05-26T12:44:04.446Z'expires_at:usage_limit:match_policy: all@@ -11879,8 +12195,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-25T19:04:53.052Z'- updated_at: '2026-05-25T19:04:53.094Z'+ created_at: '2026-05-26T12:44:04.447Z'+ updated_at: '2026-05-26T12:44:04.468Z'store_ids:- store_UkLWZg9DAJaction_ids:@@ -12033,7 +12349,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-05-25T19:04:53.387Z'+ starts_at: '2026-05-26T12:44:04.762Z'expires_at:usage_limit:match_policy: all@@ -12044,8 +12360,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-25T19:04:53.388Z'- updated_at: '2026-05-25T19:04:53.388Z'+ created_at: '2026-05-26T12:44:04.762Z'+ updated_at: '2026-05-26T12:44:04.763Z'store_ids:- store_UkLWZg9DAJaction_ids: []@@ -12141,7 +12457,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-05-25T19:04:54.288Z'+ starts_at: '2026-05-26T12:44:05.647Z'expires_at:usage_limit:match_policy: all@@ -12152,8 +12468,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-25T19:04:54.288Z'- updated_at: '2026-05-25T19:04:54.568Z'+ created_at: '2026-05-26T12:44:05.648Z'+ updated_at: '2026-05-26T12:44:05.933Z'store_ids:- store_UkLWZg9DAJaction_ids: []@@ -12505,8 +12821,8 @@ paths:data:- id: role_UkLWZg9DAJname: admin- created_at: '2026-05-25T19:04:55.423Z'- updated_at: '2026-05-25T19:04:55.423Z'+ created_at: '2026-05-26T12:44:06.829Z'+ updated_at: '2026-05-26T12:44:06.829Z'meta:page: 1limit: 25@@ -12641,8 +12957,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes:pickup_instructions:- created_at: '2026-05-25T19:04:55.701Z'- updated_at: '2026-05-25T19:04:55.701Z'+ created_at: '2026-05-26T12:44:07.118Z'+ updated_at: '2026-05-26T12:44:07.118Z'meta:page: 1limit: 25@@ -12753,8 +13069,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes: 30pickup_instructions:- created_at: '2026-05-25T19:04:56.268Z'- updated_at: '2026-05-25T19:04:56.268Z'+ created_at: '2026-05-26T12:44:07.700Z'+ updated_at: '2026-05-26T12:44:07.700Z'schema:"$ref": "#/components/schemas/StockLocation"'422':@@ -12928,8 +13244,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes:pickup_instructions:- created_at: '2026-05-25T19:04:56.554Z'- updated_at: '2026-05-25T19:04:56.554Z'+ created_at: '2026-05-26T12:44:07.990Z'+ updated_at: '2026-05-26T12:44:07.990Z'schema:"$ref": "#/components/schemas/StockLocation"'404':@@ -13014,8 +13330,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes: 45pickup_instructions:- created_at: '2026-05-25T19:04:57.113Z'- updated_at: '2026-05-25T19:04:57.386Z'+ created_at: '2026-05-26T12:44:08.560Z'+ updated_at: '2026-05-26T12:44:08.838Z'schema:"$ref": "#/components/schemas/StockLocation"'422':@@ -13218,8 +13534,8 @@ paths:data:- id: sccat_UkLWZg9DAJname: Goodwill- created_at: '2026-05-25T19:04:57.954Z'- updated_at: '2026-05-25T19:04:57.954Z'+ created_at: '2026-05-26T12:44:09.415Z'+ updated_at: '2026-05-26T12:44:09.415Z'non_expiring: falsemeta:page: 1@@ -13310,8 +13626,8 @@ paths:example:id: sccat_UkLWZg9DAJname: Goodwill- created_at: '2026-05-25T19:04:58.261Z'- updated_at: '2026-05-25T19:04:58.261Z'+ created_at: '2026-05-26T12:44:09.714Z'+ updated_at: '2026-05-26T12:44:09.714Z'non_expiring: falseschema:"$ref": "#/components/schemas/StoreCreditCategory"@@ -13376,8 +13692,8 @@ paths:preferred_timezone: UTCpreferred_weight_unit: lbpreferred_unit_system: imperial- created_at: '2026-05-25T19:03:36.944Z'- updated_at: '2026-05-25T19:04:58.853Z'+ created_at: '2026-05-26T12:42:46.469Z'+ updated_at: '2026-05-26T12:44:10.290Z'url: http://www.example.com:3000supported_currencies:- USD@@ -13448,8 +13764,8 @@ paths:preferred_timezone: UTCpreferred_weight_unit: lbpreferred_unit_system: imperial- created_at: '2026-05-25T19:03:36.944Z'- updated_at: '2026-05-25T19:04:59.451Z'+ created_at: '2026-05-26T12:42:46.469Z'+ updated_at: '2026-05-26T12:44:10.911Z'url: http://www.example.com:3000supported_currencies:- USD@@ -13669,13 +13985,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-25T19:05:00.851Z'- updated_at: '2026-05-25T19:05:00.865Z'+ created_at: '2026-05-26T12:44:12.335Z'+ updated_at: '2026-05-26T12:44:12.347Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 757769+ product_name: Product 752256- id: variant_gbHJdmfrXBproduct_id: prod_UkLWZg9DAJsku: SKU-94@@ -13686,10 +14002,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 103.2- height: 43.85- width: 38.5- depth: 2.18+ weight: 89.39+ height: 90.94+ width: 173.91+ depth: 44.3price:id: price_gbHJdmfrXBamount: '19.99'@@ -13712,8 +14028,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:05:00.875Z'- updated_at: '2026-05-25T19:05:00.875Z'+ created_at: '2026-05-26T12:44:12.357Z'+ updated_at: '2026-05-26T12:44:12.357Z'metadata: {}position: 2cost_price: '17.0'@@ -13722,13 +14038,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-25T19:05:00.873Z'- updated_at: '2026-05-25T19:05:00.887Z'+ created_at: '2026-05-26T12:44:12.354Z'+ updated_at: '2026-05-26T12:44:12.369Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 757769+ product_name: Product 752256meta:page: 1limit: 25@@ -13839,8 +14155,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:05:01.524Z'- updated_at: '2026-05-25T19:05:01.524Z'+ created_at: '2026-05-26T12:44:13.020Z'+ updated_at: '2026-05-26T12:44:13.020Z'metadata: {}position: 3cost_price:@@ -13849,13 +14165,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-25T19:05:01.527Z'- updated_at: '2026-05-25T19:05:01.529Z'+ created_at: '2026-05-26T12:44:13.023Z'+ updated_at: '2026-05-26T12:44:13.025Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 767342+ product_name: Product 761955'422':description: validation errorcontent:@@ -14042,10 +14358,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 27.7- height: 35.3- width: 95.3- depth: 146.85+ weight: 57.3+ height: 29.54+ width: 119.92+ depth: 56.73price:id: price_gbHJdmfrXBamount: '19.99'@@ -14068,8 +14384,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:05:01.986Z'- updated_at: '2026-05-25T19:05:01.986Z'+ created_at: '2026-05-26T12:44:13.424Z'+ updated_at: '2026-05-26T12:44:13.424Z'metadata: {}position: 2cost_price: '17.0'@@ -14078,13 +14394,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-25T19:05:01.984Z'- updated_at: '2026-05-25T19:05:01.996Z'+ created_at: '2026-05-26T12:44:13.422Z'+ updated_at: '2026-05-26T12:44:13.436Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 787242+ product_name: Product 784310'404':description: variant not foundcontent:@@ -14163,10 +14479,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 53.69- height: 97.14- width: 194.61- depth: 158.53+ weight: 140.27+ height: 137.84+ width: 138.66+ depth: 182.72price:id: price_gbHJdmfrXBamount: '19.99'@@ -14189,8 +14505,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-25T19:05:02.645Z'- updated_at: '2026-05-25T19:05:02.645Z'+ created_at: '2026-05-26T12:44:14.135Z'+ updated_at: '2026-05-26T12:44:14.135Z'metadata: {}position: 2cost_price: '17.0'@@ -14199,13 +14515,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-25T19:05:02.643Z'- updated_at: '2026-05-25T19:05:02.933Z'+ created_at: '2026-05-26T12:44:14.133Z'+ updated_at: '2026-05-26T12:44:14.431Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 802402+ product_name: Product 80441requestBody:content:application/json:@@ -15935,6 +16251,10 @@ components:type: arrayitems:type: string+ country_isos:+ type: array+ items:+ type: stringcountries:type: arrayitems:@@ -15951,6 +16271,7 @@ components:- tax_inclusive- default- supported_locales+ - country_isos- created_at- updated_atx-typelizer: true@@ -16581,6 +16902,9 @@ components:ends_at:type: stringnullable: true+ deleted_at:+ type: string+ nullable: truecreated_at:type: stringupdated_at:@@ -16608,6 +16932,7 @@ components:- match_policy- starts_at- ends_at+ - deleted_at- created_at- updated_at- currently_activediff --git a/packages/admin-sdk/examples/markets/create.ts b/packages/admin-sdk/examples/markets/create.tsnew file mode 100644index 0000000000..4fe03b30a1--- /dev/null+++ b/packages/admin-sdk/examples/markets/create.ts@@ -0,0 +1,19 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const market = await client.markets.create({+ name: 'Europe',+ currency: 'EUR',+ default_locale: 'de',+ supported_locales: ['de', 'en', 'fr'],+ tax_inclusive: true,+ country_isos: ['DE', 'FR', 'IT'],+})+// endregion:example++export { market }diff --git a/packages/admin-sdk/examples/markets/delete.ts b/packages/admin-sdk/examples/markets/delete.tsnew file mode 100644index 0000000000..b2c81c2c98--- /dev/null+++ b/packages/admin-sdk/examples/markets/delete.ts@@ -0,0 +1,12 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+// Soft-deletes the market (sets `deleted_at`). The default market and the+// last remaining market in a store cannot be deleted — both return 422.+await client.markets.delete('market_UkLWZg9DAJ')+// endregion:examplediff --git a/packages/admin-sdk/examples/markets/update.ts b/packages/admin-sdk/examples/markets/update.tsnew file mode 100644index 0000000000..63e0814015--- /dev/null+++ b/packages/admin-sdk/examples/markets/update.ts@@ -0,0 +1,19 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+// `country_isos` is a full-set update — the market is reconciled to match+// the array (adds new countries, removes ones not present). Setting+// `default: true` demotes the previous default market in the store.+const market = await client.markets.update('market_UkLWZg9DAJ', {+ name: 'European Union',+ tax_inclusive: true,+ country_isos: ['DE', 'FR'],+})+// endregion:example++export { market }diff --git a/packages/admin-sdk/src/admin-client.ts b/packages/admin-sdk/src/admin-client.tsindex a0c1c145e5..392edcfc3a 100644--- a/packages/admin-sdk/src/admin-client.ts+++ b/packages/admin-sdk/src/admin-client.ts@@ -91,6 +91,8 @@ import type {InvitationCreateParams,LineItemCreateParams,LineItemUpdateParams,+ MarketCreateParams,+ MarketUpdateParams,MediaCreateParams,MediaUpdateParams,OptionTypeCreateParams,@@ -1701,9 +1703,10 @@ export class AdminClient {// ============================================/**- * Markets — read-only admin surface. Drives label resolution for- * `Spree::PriceRules::MarketRule` and similar pickers. Write surface- * lives in the legacy Rails admin pending the Channel/Catalog rework.+ * Markets — store-scoped pricing regions. Each market binds one or more+ * countries to a currency, a default locale, and a tax-display policy.+ * Drives label resolution for `Spree::PriceRules::MarketRule` and is the+ * unit that price lists target.*/readonly markets = {list: (@@ -1720,6 +1723,15 @@ export class AdminClient {...options,params: getParams(params),}),++ create: (params: MarketCreateParams, options?: RequestOptions): Promise<Market> =>+ this.request<Market>('POST', '/markets', { ...options, body: params }),++ update: (id: string, params: MarketUpdateParams, options?: RequestOptions): Promise<Market> =>+ this.request<Market>('PATCH', `/markets/${id}`, { ...options, body: params }),++ delete: (id: string, options?: RequestOptions): Promise<void> =>+ this.request<void>('DELETE', `/markets/${id}`, options),}// ============================================diff --git a/packages/admin-sdk/src/params.ts b/packages/admin-sdk/src/params.tsindex fa47a629e4..549af38a04 100644--- a/packages/admin-sdk/src/params.ts+++ b/packages/admin-sdk/src/params.ts@@ -523,6 +523,36 @@ export interface TaxCategoryUpdateParams {is_default?: boolean}+export interface MarketCreateParams {+ /** Display name (unique per store, e.g. "Europe"). */+ name: string+ /** ISO 4217 currency code (e.g. "EUR"). */+ currency: string+ /** IETF locale tag used as the market default (e.g. "de"). Always included in `supported_locales`. */+ default_locale: string+ /** Additional supported locales — the default is always implicitly present. */+ supported_locales?: string[]+ /** Display prices with tax included. */+ tax_inclusive?: boolean+ /** Setting `true` demotes the previous default in the store. */+ default?: boolean+ /** Sort order within the store; lower = first. */+ position?: number+ /** 2-letter ISO country codes assigned to this market. At least one is required. */+ country_isos: string[]+}++export interface MarketUpdateParams {+ name?: string+ currency?: string+ default_locale?: string+ supported_locales?: string[]+ tax_inclusive?: boolean+ default?: boolean+ position?: number+ country_isos?: string[]+}+export interface CustomerGroupCreateParams {name: stringdescription?: string | nulldiff --git a/packages/admin-sdk/src/types/generated/Market.ts b/packages/admin-sdk/src/types/generated/Market.tsindex b2bf6b53c1..4e2f7f1de6 100644--- a/packages/admin-sdk/src/types/generated/Market.ts+++ b/packages/admin-sdk/src/types/generated/Market.ts@@ -1,4 +1,4 @@-// Typelizer digest 6976f091f888c5e8d9b6eed7c155c439+// Typelizer digest 92b5c97c745dfd6f7f456ff4b135826a//// DO NOT MODIFY: This file was automatically generated by Typelizer.import type {Country} from '@/types'@@ -10,6 +10,7 @@ interface Market {default_locale: string;tax_inclusive: boolean;default: boolean;+ country_isos: Array<string>;supported_locales: Array<string>;countries?: Array<Country>;created_at: string;diff --git a/packages/admin/e2e/markets.spec.ts b/packages/admin/e2e/markets.spec.tsnew file mode 100644index 0000000000..62c77002c0--- /dev/null+++ b/packages/admin/e2e/markets.spec.ts@@ -0,0 +1,95 @@+import { expect, type Page, test } from '@playwright/test'+import { gotoIndex, login, openRowMenu, rowButton } from './helpers'++const MARKETS_PATH = (storeId: string) => `/${storeId}/settings/markets`+const CTA = /add market/i++/**+ * Drive the "Add market" sheet. `countries` are picked through the+ * `CountryMultiCombobox` — same pattern as `fillAddressForm` in `helpers.ts`,+ * but we expect multiple matches per typed term so we click each one in turn.+ *+ * `currency`/`default_locale` default to the store's defaults (USD / en) and+ * are usually fine left alone — only override when the test cares about the+ * specific value.+ */+async function createMarket(page: Page, attrs: { name: string; countries: string[] }) {+ await page.getByRole('button', { name: /add market/i }).click()+ await expect(page.getByRole('heading', { name: /add market/i })).toBeVisible()++ await page.locator('#market-name').fill(attrs.name)++ for (const country of attrs.countries) {+ await page.getByPlaceholder(/^search countries/i).fill(country)+ await page.getByRole('option', { name: country }).first().click()+ }++ await page.getByRole('button', { name: /create market/i }).click()+}++// The seeded default store creates a default market for `US` via+// `Store#ensure_default_market` (anchored to `default_country_iso = 'US'`),+// and `Spree::MarketCountry#country_unique_per_store` rejects re-assigning+// a country to a second market in the same store. So every test below picks+// from countries *not* already covered by the seeded US market, drawing from+// the North America + EU_VAT shipping zones seeded in `global-setup.ts`.+test.describe('markets', () => {+ test('lists markets', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, MARKETS_PATH(creds.store_id), CTA)+ })++ test('creates a new market', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, MARKETS_PATH(creds.store_id), CTA)++ const name = `E2E Market ${Date.now()}`+ await createMarket(page, { name, countries: ['Canada'] })++ await expect(rowButton(page, name)).toBeVisible({ timeout: 15_000 })+ })++ test('edits a market', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, MARKETS_PATH(creds.store_id), CTA)++ const suffix = Date.now()+ const original = `E2E Edit Market ${suffix}`+ const updated = `${original} (updated)`++ await createMarket(page, { name: original, countries: ['Germany'] })+ await expect(rowButton(page, original)).toBeVisible({ timeout: 15_000 })++ await rowButton(page, original).click()+ await expect(page.getByRole('heading', { name: original })).toBeVisible({ timeout: 15_000 })+ await expect(page.locator('#market-name')).toHaveValue(original)++ await page.locator('#market-name').fill(updated)+ await page.getByRole('button', { name: /^save$/i }).click()++ await expect(rowButton(page, updated)).toBeVisible({ timeout: 15_000 })+ })++ test('deletes a market', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, MARKETS_PATH(creds.store_id), CTA)++ const name = `E2E Delete Market ${Date.now()}`+ // The seeded default market keeps the store from going empty, so deleting+ // this fresh non-default market is allowed. `can_be_deleted?` blocks the+ // default and the last-remaining market — neither applies here.+ await createMarket(page, { name, countries: ['France'] })+ await expect(rowButton(page, name)).toBeVisible({ timeout: 15_000 })++ // Delete lives on the row-action kebab.+ await openRowMenu(page, name)+ await page.getByRole('menuitem', { name: /^delete$/i }).click()+ await expect(page.getByRole('heading', { name: /delete market\?/i })).toBeVisible()+ await page+ .getByRole('dialog')+ .getByRole('button', { name: /^delete$/i })+ .click()++ await expect(rowButton(page, name)).toHaveCount(0, { timeout: 15_000 })+ })+})diff --git a/packages/admin/src/components/spree/locale-select.tsx b/packages/admin/src/components/spree/locale-select.tsxnew file mode 100644index 0000000000..01a9343d8a--- /dev/null+++ b/packages/admin/src/components/spree/locale-select.tsx@@ -0,0 +1,209 @@+import { useMemo, useState } from 'react'+import {+ Combobox,+ ComboboxChip,+ ComboboxChips,+ ComboboxChipsInput,+ ComboboxContent,+ ComboboxEmpty,+ ComboboxItem,+ ComboboxList,+ ComboboxValue,+ useComboboxAnchor,+} from '@/components/ui/combobox'+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from '@/components/ui/select'+import { useTranslation } from '@/lib/i18n'+import { useStore } from '@/providers/store-provider'++interface BaseProps {+ /** Locale codes to pick from. Defaults to the current store's `supported_locales`. */+ options?: string[]+ /** Locale to filter out (e.g. the default locale when picking additional supported ones). */+ excludeCode?: string+ /** Marks the field required for screen readers + native form submission. */+ required?: boolean+ disabled?: boolean+ placeholder?: string+ /** ID for the trigger / chips input — paired with the parent `<FieldLabel htmlFor>`. */+ id?: string+}++interface SingleProps extends BaseProps {+ multiple?: false+ value: string | null | undefined+ onChange: (locale: string) => void+}++interface MultiProps extends BaseProps {+ multiple: true+ value: string[]+ onChange: (locales: string[]) => void+}++type LocaleSelectProps = SingleProps | MultiProps++/**+ * Resolves a locale code (`en`, `pt-BR`) to its localized display name+ * (`English`, `Portuguese (Brazil)`) via the browser's built-in+ * `Intl.DisplayNames`. Falls back to the code itself when the runtime+ * lacks coverage so the user always sees something.+ */+function useLocaleDisplayName(displayLocale: string) {+ return useMemo(() => {+ try {+ const formatter = new Intl.DisplayNames([displayLocale, 'en'], { type: 'language' })+ return (code: string) => formatter.of(code) ?? code+ } catch {+ return (code: string) => code+ }+ }, [displayLocale])+}++/** Mirrors `CurrencySelect`'s row format: `CODE — Localized Name`. */+function formatOption(code: string, name: string) {+ const upper = code.toUpperCase()+ return name === code ? upper : `${upper} — ${name}`+}++/**+ * Static text label for a locale code: `EN — English`. Use this in tables+ * and read-only contexts where the picker isn't needed but the same+ * formatting is. Falls back to the upper-cased code when `Intl.DisplayNames`+ * has no entry.+ */+export function LocaleLabel({ code }: { code: string }) {+ const { defaultLocale } = useStore()+ const displayNameFor = useLocaleDisplayName(defaultLocale)+ if (!code) return null+ return <>{formatOption(code, displayNameFor(code))}</>+}++/**+ * Picker for one of the current store's `supported_locales`. Single-select by+ * default; pass `multiple` for a chips multi-select. Each option reads+ * `CODE — Localized Name` (e.g. `EN — English`), localized via the browser's+ * `Intl.DisplayNames` against the store's `default_locale`. Use this anywhere+ * the merchant is choosing a storefront language (market default, supported+ * locales list, customer preference, etc.).+ */+export function LocaleSelect(props: LocaleSelectProps) {+ const { t } = useTranslation()+ const { locales: storeLocales, defaultLocale } = useStore()+ const displayNameFor = useLocaleDisplayName(defaultLocale)++ // Union of `props.options` (everything the picker should show) and the+ // currently selected values — so editing an existing record doesn't+ // silently drop chips when the store's locale list later narrows.+ const items = useMemo(() => {+ const base = props.options ?? storeLocales+ const selected = props.multiple ? props.value : props.value ? [props.value] : []+ const merged = Array.from(new Set([...base, ...selected]))+ return props.excludeCode ? merged.filter((l) => l !== props.excludeCode) : merged+ }, [props.options, props.excludeCode, props.multiple, props.value, storeLocales])++ if (props.multiple) {+ return (+ <MultiLocalePicker+ id={props.id}+ items={items}+ value={props.value}+ onChange={props.onChange}+ displayNameFor={displayNameFor}+ placeholder={props.placeholder ?? t('admin.components.locale_select.multi_placeholder')}+ emptyText={t('admin.components.locale_select.empty')}+ disabled={props.disabled}+ />+ )+ }++ const value = props.value ?? ''+ return (+ <Select value={value} onValueChange={props.onChange} disabled={props.disabled}>+ <SelectTrigger id={props.id} aria-required={props.required}>+ {/* Base UI's `<SelectValue>` defaults to the raw locale code. Use+ the children render-prop so the trigger shows the same+ `CODE — Name` as the items. */}+ <SelectValue+ placeholder={props.placeholder ?? t('admin.components.locale_select.placeholder')}+ >+ {(v) => (v ? formatOption(v as string, displayNameFor(v as string)) : (v as string))}+ </SelectValue>+ </SelectTrigger>+ <SelectContent>+ {items.map((locale) => (+ <SelectItem key={locale} value={locale}>+ {formatOption(locale, displayNameFor(locale))}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ )+}++function MultiLocalePicker({+ id,+ items,+ value,+ onChange,+ displayNameFor,+ placeholder,+ emptyText,+ disabled,+}: {+ id?: string+ items: string[]+ value: string[]+ onChange: (locales: string[]) => void+ displayNameFor: (code: string) => string+ placeholder: string+ emptyText: string+ disabled?: boolean+}) {+ const anchorRef = useComboboxAnchor()+ const [inputValue, setInputValue] = useState('')++ return (+ <Combobox+ multiple+ items={items}+ value={value}+ onValueChange={(next: string[]) => {+ onChange(next)+ setInputValue('')+ }}+ disabled={disabled}+ >+ <ComboboxChips ref={anchorRef}>+ <ComboboxValue>+ {(selectedLocales: string[]) =>+ selectedLocales.map((l) => (+ <ComboboxChip key={l}>{formatOption(l, displayNameFor(l))}</ComboboxChip>+ ))+ }+ </ComboboxValue>+ <ComboboxChipsInput+ id={id}+ placeholder={placeholder}+ value={inputValue}+ onChange={(e) => setInputValue((e.target as HTMLInputElement).value)}+ />+ </ComboboxChips>+ <ComboboxContent anchor={anchorRef}>+ <ComboboxEmpty>{emptyText}</ComboboxEmpty>+ <ComboboxList>+ {(locale: string) => (+ <ComboboxItem key={locale} value={locale}>+ {formatOption(locale, displayNameFor(locale))}+ </ComboboxItem>+ )}+ </ComboboxList>+ </ComboboxContent>+ </Combobox>+ )+}diff --git a/packages/admin/src/hooks/use-markets.ts b/packages/admin/src/hooks/use-markets.tsnew file mode 100644index 0000000000..0f823cbf53--- /dev/null+++ b/packages/admin/src/hooks/use-markets.ts@@ -0,0 +1,64 @@+import type { Market, MarketCreateParams, MarketUpdateParams } from '@spree/admin-sdk'+import { useQuery, useQueryClient } from '@tanstack/react-query'+import { adminClient } from '@/client'+import { useResourceMutation } from '@/hooks/use-resource-mutation'++export const marketsQueryKey = ['markets'] as const++export function marketQueryKey(id: string) {+ return ['markets', id] as const+}++interface UseMarketsParams {+ page?: number+ limit?: number+ expand?: string[]+}++export function useMarkets({ page = 1, limit = 100, expand }: UseMarketsParams = {}) {+ return useQuery({+ queryKey: [...marketsQueryKey, { page, limit, expand: expand?.join(',') ?? '' }],+ queryFn: () => adminClient.markets.list({ page, limit, ...(expand ? { expand } : {}) }),+ staleTime: 1000 * 60 * 5,+ })+}++export function useMarket(id: string | undefined) {+ return useQuery({+ queryKey: id ? marketQueryKey(id) : ['markets', 'noop'],+ queryFn: () => adminClient.markets.get(id as string),+ enabled: !!id,+ })+}++export function useCreateMarket() {+ return useResourceMutation<Market, Error, MarketCreateParams>({+ mutationFn: (params) => adminClient.markets.create(params),+ invalidate: [marketsQueryKey],+ successMessage: 'Market created',+ errorMessage: 'Failed to create market',+ })+}++export function useUpdateMarket(id: string) {+ return useResourceMutation<Market, Error, MarketUpdateParams>({+ mutationFn: (params) => adminClient.markets.update(id, params),+ invalidate: [marketsQueryKey, marketQueryKey(id)],+ successMessage: 'Market updated',+ errorMessage: 'Failed to update market',+ })+}++export function useDeleteMarket() {+ const queryClient = useQueryClient()++ return useResourceMutation<void, Error, string>({+ mutationFn: (id) => adminClient.markets.delete(id),+ invalidate: [marketsQueryKey],+ successMessage: 'Market deleted',+ errorMessage: 'Failed to delete market',+ onSuccess: (_data, id) => {+ queryClient.removeQueries({ queryKey: marketQueryKey(id) })+ },+ })+}diff --git a/packages/admin/src/locales/en.json b/packages/admin/src/locales/en.jsonindex 0bc5fe6afe..6eed4ca238 100644--- a/packages/admin/src/locales/en.json+++ b/packages/admin/src/locales/en.json@@ -418,6 +418,33 @@"help": "Capture funds automatically on authorization. When off, you must capture manually."}},+ "market": {+ "name": { "placeholder": "e.g. Europe" },+ "currency": {+ "label": "Currency",+ "help": "ISO 4217 currency used for all prices in this market."+ },+ "default_locale": {+ "label": "Default locale",+ "help": "Storefront language for shoppers in this market."+ },+ "supported_locales": {+ "label": "Supported locales",+ "help": "Additional languages shoppers can switch to. The default locale is always included."+ },+ "country_isos": {+ "label": "Countries",+ "help": "Pick the countries this market covers. Each country can belong to at most one market per store."+ },+ "tax_inclusive": {+ "label": "Tax-inclusive pricing",+ "help": "Display prices with tax included. Common in EU markets."+ },+ "default": {+ "label": "Default market",+ "help": "Shoppers without a known country see this market. Only one can be default per store."+ }+ },"login": {"email": { "placeholder": "[email protected]" }},@@ -523,6 +550,11 @@},"components": {"currency_select": { "placeholder": "Select a currency" },+ "locale_select": {+ "placeholder": "Select a locale",+ "multi_placeholder": "Add locales…",+ "empty": "No locales found"+ },"country_combobox": {"search_placeholder": "Search countries…","empty": "No countries found"@@ -983,6 +1015,10 @@"add_sheet_title": "Add tax category","edit_sheet_title": "Edit tax category"},+ "markets": {+ "add_sheet_title": "Add market",+ "edit_sheet_title": "Edit market"+ },"custom_field_definitions": {"add_sheet_title": "Add custom field","edit_sheet_title": "Edit custom field"@@ -1415,6 +1451,16 @@"message": "{{name}} will be removed. Products in this category fall back to the default."}},+ "markets": {+ "add_cta": "Add market",+ "create_description": "Group countries into a single pricing region with its own currency and locales.",+ "edit_description": "Update name, currency, locales, or country coverage.",+ "create_label": "Create market",+ "delete_confirm": {+ "title": "Delete market?",+ "message": "{{name}} will be removed. Orders previously placed in this market remain intact."+ }+ },"custom_field_definitions": {"add_cta": "Add custom field","create_label": "Create custom field",diff --git a/packages/admin/src/nav/settings.ts b/packages/admin/src/nav/settings.tsindex f0e9ba902e..fbcac62d97 100644--- a/packages/admin/src/nav/settings.ts+++ b/packages/admin/src/nav/settings.ts@@ -1,5 +1,6 @@import {CreditCardIcon,+ GlobeIcon,KeyRoundIcon,PercentIcon,StoreIcon,@@ -45,6 +46,16 @@ settingsNav.add({subject: Subject.TaxCategory,})+settingsNav.add({+ key: 'settings.markets',+ label: 'Markets',+ path: '/markets',+ icon: GlobeIcon,+ group: 'payments',+ position: 300,+ subject: Subject.Market,+})+settingsNav.add({key: 'settings.stock-locations',label: 'Stock locations',diff --git a/packages/admin/src/routeTree.gen.ts b/packages/admin/src/routeTree.gen.tsindex 52119fc081..7c164e8a6b 100644--- a/packages/admin/src/routeTree.gen.ts+++ b/packages/admin/src/routeTree.gen.ts@@ -26,6 +26,7 @@ import { Route as AuthenticatedStoreIdSettingsStoreRouteImport } from './routes/import { Route as AuthenticatedStoreIdSettingsStockLocationsRouteImport } from './routes/_authenticated/$storeId/settings/stock-locations'import { Route as AuthenticatedStoreIdSettingsStaffRouteImport } from './routes/_authenticated/$storeId/settings/staff'import { Route as AuthenticatedStoreIdSettingsPaymentMethodsRouteImport } from './routes/_authenticated/$storeId/settings/payment-methods'+import { Route as AuthenticatedStoreIdSettingsMarketsRouteImport } from './routes/_authenticated/$storeId/settings/markets'import { Route as AuthenticatedStoreIdSettingsCustomFieldDefinitionsRouteImport } from './routes/_authenticated/$storeId/settings/custom-field-definitions'import { Route as AuthenticatedStoreIdSettingsApiKeysRouteImport } from './routes/_authenticated/$storeId/settings/api-keys'import { Route as AuthenticatedStoreIdPromotionsNewRouteImport } from './routes/_authenticated/$storeId/promotions/new'@@ -140,6 +141,12 @@ const AuthenticatedStoreIdSettingsPaymentMethodsRoute =path: '/payment-methods',getParentRoute: () => AuthenticatedStoreIdSettingsRoute,} as any)+const AuthenticatedStoreIdSettingsMarketsRoute =+ AuthenticatedStoreIdSettingsMarketsRouteImport.update({+ id: '/markets',+ path: '/markets',+ getParentRoute: () => AuthenticatedStoreIdSettingsRoute,+ } as any)const AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute =AuthenticatedStoreIdSettingsCustomFieldDefinitionsRouteImport.update({id: '/custom-field-definitions',@@ -257,6 +264,7 @@ export interface FileRoutesByFullPath {'/$storeId/promotions/new': typeof AuthenticatedStoreIdPromotionsNewRoute'/$storeId/settings/api-keys': typeof AuthenticatedStoreIdSettingsApiKeysRoute'/$storeId/settings/custom-field-definitions': typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute+ '/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute'/$storeId/settings/payment-methods': typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute'/$storeId/settings/staff': typeof AuthenticatedStoreIdSettingsStaffRoute'/$storeId/settings/stock-locations': typeof AuthenticatedStoreIdSettingsStockLocationsRoute@@ -289,6 +297,7 @@ export interface FileRoutesByTo {'/$storeId/promotions/new': typeof AuthenticatedStoreIdPromotionsNewRoute'/$storeId/settings/api-keys': typeof AuthenticatedStoreIdSettingsApiKeysRoute'/$storeId/settings/custom-field-definitions': typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute+ '/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute'/$storeId/settings/payment-methods': typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute'/$storeId/settings/staff': typeof AuthenticatedStoreIdSettingsStaffRoute'/$storeId/settings/stock-locations': typeof AuthenticatedStoreIdSettingsStockLocationsRoute@@ -325,6 +334,7 @@ export interface FileRoutesById {'/_authenticated/$storeId/promotions/new': typeof AuthenticatedStoreIdPromotionsNewRoute'/_authenticated/$storeId/settings/api-keys': typeof AuthenticatedStoreIdSettingsApiKeysRoute'/_authenticated/$storeId/settings/custom-field-definitions': typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute+ '/_authenticated/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute'/_authenticated/$storeId/settings/payment-methods': typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute'/_authenticated/$storeId/settings/staff': typeof AuthenticatedStoreIdSettingsStaffRoute'/_authenticated/$storeId/settings/stock-locations': typeof AuthenticatedStoreIdSettingsStockLocationsRoute@@ -361,6 +371,7 @@ export interface FileRouteTypes {| '/$storeId/promotions/new'| '/$storeId/settings/api-keys'| '/$storeId/settings/custom-field-definitions'+ | '/$storeId/settings/markets'| '/$storeId/settings/payment-methods'| '/$storeId/settings/staff'| '/$storeId/settings/stock-locations'@@ -393,6 +404,7 @@ export interface FileRouteTypes {| '/$storeId/promotions/new'| '/$storeId/settings/api-keys'| '/$storeId/settings/custom-field-definitions'+ | '/$storeId/settings/markets'| '/$storeId/settings/payment-methods'| '/$storeId/settings/staff'| '/$storeId/settings/stock-locations'@@ -428,6 +440,7 @@ export interface FileRouteTypes {| '/_authenticated/$storeId/promotions/new'| '/_authenticated/$storeId/settings/api-keys'| '/_authenticated/$storeId/settings/custom-field-definitions'+ | '/_authenticated/$storeId/settings/markets'| '/_authenticated/$storeId/settings/payment-methods'| '/_authenticated/$storeId/settings/staff'| '/_authenticated/$storeId/settings/stock-locations'@@ -570,6 +583,13 @@ declare module '@tanstack/react-router' {preLoaderRoute: typeof AuthenticatedStoreIdSettingsPaymentMethodsRouteImportparentRoute: typeof AuthenticatedStoreIdSettingsRoute}+ '/_authenticated/$storeId/settings/markets': {+ id: '/_authenticated/$storeId/settings/markets'+ path: '/markets'+ fullPath: '/$storeId/settings/markets'+ preLoaderRoute: typeof AuthenticatedStoreIdSettingsMarketsRouteImport+ parentRoute: typeof AuthenticatedStoreIdSettingsRoute+ }'/_authenticated/$storeId/settings/custom-field-definitions': {id: '/_authenticated/$storeId/settings/custom-field-definitions'path: '/custom-field-definitions'@@ -688,6 +708,7 @@ declare module '@tanstack/react-router' {interface AuthenticatedStoreIdSettingsRouteChildren {AuthenticatedStoreIdSettingsApiKeysRoute: typeof AuthenticatedStoreIdSettingsApiKeysRouteAuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute: typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute+ AuthenticatedStoreIdSettingsMarketsRoute: typeof AuthenticatedStoreIdSettingsMarketsRouteAuthenticatedStoreIdSettingsPaymentMethodsRoute: typeof AuthenticatedStoreIdSettingsPaymentMethodsRouteAuthenticatedStoreIdSettingsStaffRoute: typeof AuthenticatedStoreIdSettingsStaffRouteAuthenticatedStoreIdSettingsStockLocationsRoute: typeof AuthenticatedStoreIdSettingsStockLocationsRoute@@ -702,6 +723,8 @@ const AuthenticatedStoreIdSettingsRouteChildren: AuthenticatedStoreIdSettingsRouAuthenticatedStoreIdSettingsApiKeysRoute,AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute:AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute,+ AuthenticatedStoreIdSettingsMarketsRoute:+ AuthenticatedStoreIdSettingsMarketsRoute,AuthenticatedStoreIdSettingsPaymentMethodsRoute:AuthenticatedStoreIdSettingsPaymentMethodsRoute,AuthenticatedStoreIdSettingsStaffRoute:diff --git a/packages/admin/src/routes/_authenticated/$storeId/settings/markets.tsx b/packages/admin/src/routes/_authenticated/$storeId/settings/markets.tsxnew file mode 100644index 0000000000..ff5efd7f56--- /dev/null+++ b/packages/admin/src/routes/_authenticated/$storeId/settings/markets.tsx@@ -0,0 +1,452 @@+import { zodResolver } from '@hookform/resolvers/zod'+import type { Market } from '@spree/admin-sdk'+import { useQueryClient } from '@tanstack/react-query'+import { createFileRoute, useNavigate } from '@tanstack/react-router'+import { PlusIcon } from 'lucide-react'+import { useEffect, useMemo } from 'react'+import { Controller, type UseFormReturn, useForm } from 'react-hook-form'+import { useTranslation } from 'react-i18next'+import { z } from 'zod/v4'+import { adminClient } from '@/client'+import { Can } from '@/components/spree/can'+import { useConfirm } from '@/components/spree/confirm-dialog'+import { CountryMultiCombobox } from '@/components/spree/country-combobox'+import { CurrencySelect } from '@/components/spree/currency-select'+import { LocaleSelect } from '@/components/spree/locale-select'+import { ResourceTable, resourceSearchSchema } from '@/components/spree/resource-table'+import { RowActions } from '@/components/spree/row-actions'+import { useRowClickBridge } from '@/components/spree/row-click-bridge'+import { Button } from '@/components/ui/button'+import { Field, FieldError, FieldGroup, FieldLabel } from '@/components/ui/field'+import { Input } from '@/components/ui/input'+import {+ Sheet,+ SheetContent,+ SheetDescription,+ SheetFooter,+ SheetHeader,+ SheetTitle,+} from '@/components/ui/sheet'+import { Switch } from '@/components/ui/switch'+import {+ marketsQueryKey,+ useCreateMarket,+ useDeleteMarket,+ useMarket,+ useUpdateMarket,+} from '@/hooks/use-markets'+import { mapSpreeErrorsToForm } from '@/lib/form-errors'+import { Subject } from '@/lib/permissions'+import { usePermissions } from '@/providers/permission-provider'+import { useStore } from '@/providers/store-provider'+import {+ MARKET_DEFAULTS,+ type MarketFormValues,+ marketFormSchema,+ marketValuesToParams,+} from '@/schemas/market'+import '@/tables/markets'++const marketsSearchSchema = resourceSearchSchema.extend({+ edit: z.string().optional(),+ new: z.coerce.boolean().optional(),+})++export const Route = createFileRoute('/_authenticated/$storeId/settings/markets')({+ validateSearch: marketsSearchSchema,+ component: MarketsPage,+})++function MarketsPage() {+ const { t } = useTranslation()+ const search = Route.useSearch() as z.infer<typeof marketsSearchSchema>+ const navigate = useNavigate()+ const queryClient = useQueryClient()+ const confirm = useConfirm()+ const deleteMutation = useDeleteMarket()+ const { permissions } = usePermissions()++ const editId = search.edit+ const isCreating = !!search.new++ const closeSheet = () =>+ navigate({+ search: (prev: Record<string, unknown>) => {+ const { edit: _e, new: _n, ...rest } = prev+ return rest as never+ },+ })++ const openCreate = () =>+ navigate({ search: (prev: Record<string, unknown>) => ({ ...prev, new: true }) as never })++ const openEdit = (id: string) =>+ navigate({ search: (prev: Record<string, unknown>) => ({ ...prev, edit: id }) as never })++ useRowClickBridge('data-market-id', openEdit)++ async function handleDelete(market: Market) {+ const ok = await confirm({+ title: t('admin.markets.delete_confirm.title'),+ message: t('admin.markets.delete_confirm.message', { name: market.name ?? '' }),+ variant: 'destructive',+ confirmLabel: t('admin.actions.delete'),+ })+ if (!ok) return+ await deleteMutation.mutateAsync(market.id).catch(() => undefined)+ }++ return (+ <>+ <ResourceTable<Market>+ tableKey="markets"+ queryKey="markets"+ queryFn={(params) => adminClient.markets.list(params)}+ searchParams={search}+ rowActions={(market) => (+ <RowActions+ actions={[+ { key: 'edit', onSelect: () => openEdit(market.id) },+ {+ key: 'delete',+ destructive: true,+ visible: permissions.can('destroy', Subject.Market),+ disabled: deleteMutation.isPending,+ onSelect: () => handleDelete(market),+ },+ ]}+ />+ )}+ actions={+ <Can I="create" a={Subject.Market}>+ <Button size="sm" className="h-[2.125rem]" onClick={openCreate}>+ <PlusIcon className="size-4" />+ {t('admin.markets.add_cta')}+ </Button>+ </Can>+ }+ reorder={{+ onReorder: async (id, position) => {+ await adminClient.markets.update(id, { position })+ queryClient.invalidateQueries({ queryKey: marketsQueryKey })+ },+ }}+ />++ {isCreating && <CreateMarketSheet open onOpenChange={(o) => !o && closeSheet()} />}+ {editId && <EditMarketSheet id={editId} open onOpenChange={(o) => !o && closeSheet()} />}+ </>+ )+}++function CreateMarketSheet({+ open,+ onOpenChange,+}: {+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const createMutation = useCreateMarket()+ const { defaultCurrency, defaultLocale } = useStore()++ // Seed the form with the store defaults so a typical "Europe" / "ROW"+ // setup is mostly pre-filled — the merchant only edits name + countries.+ const initialDefaults: MarketFormValues = useMemo(+ () => ({+ ...MARKET_DEFAULTS,+ currency: defaultCurrency,+ default_locale: defaultLocale,+ }),+ [defaultCurrency, defaultLocale],+ )++ const form = useForm<MarketFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(marketFormSchema) as any,+ defaultValues: initialDefaults,+ })++ async function onSubmit(values: MarketFormValues) {+ try {+ await createMutation.mutateAsync(marketValuesToParams(values))+ form.reset(initialDefaults)+ onOpenChange(false)+ } catch (err) {+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err+ }+ }++ return (+ <Sheet+ open={open}+ onOpenChange={(next) => {+ if (!next) form.reset(initialDefaults)+ onOpenChange(next)+ }}+ >+ <SheetContent>+ <SheetHeader>+ <SheetTitle>{t('admin.pages.settings.markets.add_sheet_title')}</SheetTitle>+ <SheetDescription>{t('admin.markets.create_description')}</SheetDescription>+ </SheetHeader>+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">+ <MarketFormFields form={form} />+ </div>+ <SheetFooter>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => onOpenChange(false)}+ disabled={form.formState.isSubmitting}+ >+ {t('admin.actions.cancel')}+ </Button>+ <Button type="submit" size="sm" disabled={form.formState.isSubmitting}>+ {form.formState.isSubmitting+ ? t('admin.actions.creating')+ : t('admin.markets.create_label')}+ </Button>+ </SheetFooter>+ </form>+ </SheetContent>+ </Sheet>+ )+}++function EditMarketSheet({+ id,+ open,+ onOpenChange,+}: {+ id: string+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const { data: market, isLoading } = useMarket(id)+ const updateMutation = useUpdateMarket(id)++ const form = useForm<MarketFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(marketFormSchema) as any,+ defaultValues: MARKET_DEFAULTS,+ })++ useEffect(() => {+ if (market) {+ form.reset({+ name: market.name,+ currency: market.currency,+ default_locale: market.default_locale,+ supported_locales: market.supported_locales.filter((l) => l !== market.default_locale),+ tax_inclusive: market.tax_inclusive,+ default: market.default,+ country_isos: market.country_isos,+ })+ }+ }, [market, form])++ async function onSubmit(values: MarketFormValues) {+ try {+ await updateMutation.mutateAsync(marketValuesToParams(values))+ form.reset(values)+ onOpenChange(false)+ } catch (err) {+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err+ }+ }++ return (+ <Sheet open={open} onOpenChange={onOpenChange}>+ <SheetContent>+ <SheetHeader>+ <SheetTitle>+ {market?.name ?? t('admin.pages.settings.markets.edit_sheet_title')}+ </SheetTitle>+ <SheetDescription>{t('admin.markets.edit_description')}</SheetDescription>+ </SheetHeader>+ {isLoading ? (+ <div className="p-4 text-sm text-muted-foreground">{t('admin.common.loading')}</div>+ ) : (+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">+ <MarketFormFields form={form} />+ </div>+ <SheetFooter>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => onOpenChange(false)}+ disabled={form.formState.isSubmitting}+ >+ {t('admin.actions.cancel')}+ </Button>+ <Button+ type="submit"+ size="sm"+ disabled={form.formState.isSubmitting || !form.formState.isDirty}+ >+ {form.formState.isSubmitting ? t('admin.actions.saving') : t('admin.actions.save')}+ </Button>+ </SheetFooter>+ </form>+ )}+ </SheetContent>+ </Sheet>+ )+}++function MarketFormFields({ form }: { form: UseFormReturn<MarketFormValues> }) {+ const { t } = useTranslation()+ const { errors } = form.formState+ const defaultLocaleField = form.watch('default_locale')++ return (+ <FieldGroup>+ {errors.root?.message && (+ <p className="text-sm text-destructive" role="alert">+ {errors.root.message}+ </p>+ )}++ <Field>+ <FieldLabel htmlFor="market-name">{t('admin.fields.name.label')}</FieldLabel>+ <Input+ id="market-name"+ autoFocus+ placeholder={t('admin.fields.market.name.placeholder')}+ aria-invalid={!!errors.name || undefined}+ {...form.register('name')}+ />+ <FieldError errors={[errors.name]} />+ </Field>++ <Field>+ <FieldLabel htmlFor="market-currency">{t('admin.fields.market.currency.label')}</FieldLabel>+ <Controller+ name="currency"+ control={form.control}+ render={({ field }) => (+ <CurrencySelect id="market-currency" value={field.value} onChange={field.onChange} />+ )}+ />+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.market.currency.help')}+ </span>+ <FieldError errors={[errors.currency]} />+ </Field>++ <Field>+ <FieldLabel htmlFor="market-default-locale">+ {t('admin.fields.market.default_locale.label')}+ </FieldLabel>+ <Controller+ name="default_locale"+ control={form.control}+ render={({ field }) => (+ <LocaleSelect+ id="market-default-locale"+ value={field.value}+ onChange={field.onChange}+ />+ )}+ />+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.market.default_locale.help')}+ </span>+ <FieldError errors={[errors.default_locale]} />+ </Field>++ <Field>+ <FieldLabel htmlFor="market-supported-locales">+ {t('admin.fields.market.supported_locales.label')}+ </FieldLabel>+ <Controller+ name="supported_locales"+ control={form.control}+ render={({ field }) => (+ <LocaleSelect+ multiple+ id="market-supported-locales"+ value={field.value}+ onChange={field.onChange}+ excludeCode={defaultLocaleField}+ />+ )}+ />+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.market.supported_locales.help')}+ </span>+ </Field>++ <Field>+ <FieldLabel htmlFor="market-countries">+ {t('admin.fields.market.country_isos.label')}+ </FieldLabel>+ <Controller+ name="country_isos"+ control={form.control}+ render={({ field }) => (+ <CountryMultiCombobox value={field.value} onValueChange={field.onChange} />+ )}+ />+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.market.country_isos.help')}+ </span>+ <FieldError errors={[errors.country_isos]} />+ </Field>++ <Field>+ <div className="flex items-start justify-between gap-4">+ <div className="flex flex-col">+ <FieldLabel htmlFor="market-tax-inclusive" className="cursor-pointer">+ {t('admin.fields.market.tax_inclusive.label')}+ </FieldLabel>+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.market.tax_inclusive.help')}+ </span>+ </div>+ <Controller+ name="tax_inclusive"+ control={form.control}+ render={({ field }) => (+ <Switch+ id="market-tax-inclusive"+ checked={!!field.value}+ onCheckedChange={field.onChange}+ />+ )}+ />+ </div>+ </Field>++ <Field>+ <div className="flex items-start justify-between gap-4">+ <div className="flex flex-col">+ <FieldLabel htmlFor="market-default" className="cursor-pointer">+ {t('admin.fields.market.default.label')}+ </FieldLabel>+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.market.default.help')}+ </span>+ </div>+ <Controller+ name="default"+ control={form.control}+ render={({ field }) => (+ <Switch+ id="market-default"+ checked={!!field.value}+ onCheckedChange={field.onChange}+ />+ )}+ />+ </div>+ </Field>+ </FieldGroup>+ )+}diff --git a/packages/admin/src/schemas/market.ts b/packages/admin/src/schemas/market.tsnew file mode 100644index 0000000000..a76e08b7e0--- /dev/null+++ b/packages/admin/src/schemas/market.ts@@ -0,0 +1,39 @@+import type { MarketCreateParams, MarketUpdateParams } from '@spree/admin-sdk'+import { z } from 'zod/v4'+import { requiredMessage } from '@/lib/validation-messages'++export const marketFormSchema = z.object({+ name: z.string().min(1, { error: requiredMessage('name') }),+ currency: z.string().min(1, { error: requiredMessage('market.currency') }),+ default_locale: z.string().min(1, { error: requiredMessage('market.default_locale') }),+ supported_locales: z.array(z.string()),+ tax_inclusive: z.boolean(),+ default: z.boolean(),+ country_isos: z.array(z.string()).min(1, { error: requiredMessage('market.country_isos') }),+})++export type MarketFormValues = z.infer<typeof marketFormSchema>++export const MARKET_DEFAULTS: MarketFormValues = {+ name: '',+ currency: '',+ default_locale: '',+ supported_locales: [],+ tax_inclusive: false,+ default: false,+ country_isos: [],+}++export function marketValuesToParams(v: MarketFormValues): MarketCreateParams & MarketUpdateParams {+ return {+ name: v.name,+ currency: v.currency,+ default_locale: v.default_locale,+ // The default locale is always implicitly included server-side; strip+ // duplicates here so the request stays compact.+ supported_locales: v.supported_locales.filter((l) => l !== v.default_locale),+ tax_inclusive: v.tax_inclusive,+ default: v.default,+ country_isos: v.country_isos,+ }+}diff --git a/packages/admin/src/tables/markets.tsx b/packages/admin/src/tables/markets.tsxnew file mode 100644index 0000000000..8e12c94425--- /dev/null+++ b/packages/admin/src/tables/markets.tsx@@ -0,0 +1,66 @@+import type { Market } from '@spree/admin-sdk'+import { GlobeIcon } from 'lucide-react'+import { LocaleLabel } from '@/components/spree/locale-select'+import { ResourceNameCell } from '@/components/spree/resource-name-cell'+import { ActiveBadge, Badge } from '@/components/ui/badge'+import { defineTable } from '@/lib/table-registry'++defineTable<Market>('markets', {+ title: 'Markets',+ searchParam: 'name_cont',+ searchPlaceholder: 'Search by name…',+ defaultSort: { field: 'position', direction: 'asc' },+ emptyIcon: <GlobeIcon className="size-8 text-muted-foreground" />,+ emptyMessage: 'No markets yet',+ columns: [+ {+ key: 'name',+ label: 'Name',+ sortable: true,+ filterable: true,+ default: true,+ render: (market) => (+ <ResourceNameCell+ id={market.id}+ dataAttr="data-market-id"+ name={market.name}+ secondary={market.country_isos.length > 0 ? market.country_isos.join(', ') : undefined}+ />+ ),+ },+ {+ key: 'currency',+ label: 'Currency',+ sortable: true,+ default: true,+ render: (market) => <Badge variant="outline">{market.currency}</Badge>,+ },+ {+ key: 'default_locale',+ label: 'Default locale',+ sortable: true,+ default: true,+ render: (market) => <LocaleLabel code={market.default_locale} />,+ },+ {+ key: 'tax_inclusive',+ label: 'Tax',+ default: true,+ render: (market) => (+ <ActiveBadge+ active={market.tax_inclusive}+ activeLabel="Inclusive"+ inactiveLabel="Exclusive"+ />+ ),+ },+ {+ key: 'default',+ label: 'Default',+ default: true,+ render: (market) => (+ <ActiveBadge active={market.default} activeLabel="Default" dashWhenInactive />+ ),+ },+ ],+})diff --git a/packages/sdk/src/types/generated/Market.ts b/packages/sdk/src/types/generated/Market.tsindex 3db04ef247..e6d24bc139 100644--- a/packages/sdk/src/types/generated/Market.ts+++ b/packages/sdk/src/types/generated/Market.ts@@ -1,4 +1,4 @@-// Typelizer digest 197d6433ecbf55fb4d24d752d9ca471f+// Typelizer digest f0c3fec6413da2882bdac9d862de6523//// DO NOT MODIFY: This file was automatically generated by Typelizer.import type {Country} from '@/types'@@ -10,6 +10,7 @@ interface Market {default_locale: string;tax_inclusive: boolean;default: boolean;+ country_isos: Array<string>;supported_locales: Array<string>;countries?: Array<Country>;}diff --git a/packages/sdk/src/zod/generated/Market.ts b/packages/sdk/src/zod/generated/Market.tsindex 0cce0b42ce..6f1354430e 100644--- a/packages/sdk/src/zod/generated/Market.ts+++ b/packages/sdk/src/zod/generated/Market.ts@@ -9,6 +9,7 @@ export const MarketSchema: z.ZodObject<any> = z.object({default_locale: z.string(),tax_inclusive: z.boolean(),default: z.boolean(),+ country_isos: z.array(z.string()),supported_locales: z.array(z.string()),countries: z.array(z.lazy(() => CountrySchema)).optional(),});diff --git a/spree/api/app/controllers/spree/api/v3/admin/markets_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/markets_controller.rbindex 76c85fd211..f981968782 100644--- a/spree/api/app/controllers/spree/api/v3/admin/markets_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/admin/markets_controller.rb@@ -2,16 +2,14 @@ module Spreemodule Apimodule V3module Admin- # Read-only Markets surface for the admin SPA. Markets are- # store-scoped (`store_id` column + `acts_as_list scope: :store_id`),- # so the base ResourceController's `scope` chain narrows- # appropriately when we restrict to `current_store.markets`.+ # Admin Markets surface. Markets are store-scoped (`store_id` column ++ # `acts_as_list scope: :store_id`), so the base ResourceController's+ # `scope` chain narrows appropriately when we restrict to+ # `current_store.markets`.#- # Why read-only: the admin SPA only needs Markets in order to- # render labels for `MarketRule` rows and resolve the picker- # dropdown. Full write surface (create/update/delete) lives in- # the legacy Rails admin pending the broader Channel/Catalog- # rework — see `docs/plans/6.0-channels-catalogs-b2b.md`.+ # `country_isos` and `supported_locales` are accepted as arrays on the+ # wire and translated by model setters (`Spree::Market#country_isos=`,+ # `#supported_locales=`).class MarketsController < ResourceControllerscoped_resource :settings@@ -25,13 +23,18 @@ module SpreeSpree.api.admin_market_serializerend- def scope- current_store.markets.accessible_by(current_ability, :show)- end-def collection_includes[:countries]end++ def permitted_params+ normalize_params(+ params.permit(+ :name, :currency, :default_locale, :tax_inclusive,+ :default, :position, supported_locales: [], country_isos: []+ )+ )+ endendendenddiff --git a/spree/api/app/serializers/spree/api/v3/market_serializer.rb b/spree/api/app/serializers/spree/api/v3/market_serializer.rbindex fe9ed0b6f0..98399d775c 100644--- a/spree/api/app/serializers/spree/api/v3/market_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/market_serializer.rb@@ -5,10 +5,11 @@ module Spreetypelize name: :string, currency: :string,default_locale: :string,supported_locales: [:string, multi: true],+ country_isos: [:string, multi: true],tax_inclusive: :boolean,default: :boolean- attributes :name, :currency, :default_locale, :tax_inclusive, :default+ attributes :name, :currency, :default_locale, :tax_inclusive, :default, :country_isosattribute :supported_locales do |market|market.supported_locales_listdiff --git a/spree/api/config/routes.rb b/spree/api/config/routes.rbindex 2cd2684232..86c4af34a5 100644--- a/spree/api/config/routes.rb+++ b/spree/api/config/routes.rb@@ -182,7 +182,7 @@ Spree::Core::Engine.add_routes doresources :tax_categories# Markets- resources :markets, only: [:index, :show]+ resources :markets# Store Credit Categories (read-only — for store credit dropdowns)resources :store_credit_categories, only: [:index, :show]diff --git a/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rbindex 8d720877e7..3c22434559 100644--- a/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rb@@ -6,7 +6,24 @@ RSpec.describe 'Admin Markets API', type: :request, swagger_doc: 'api-reference/include_context 'API v3 Admin'let(:Authorization) { "Bearer #{admin_jwt_token}" }- let!(:market) { create(:market, store: store, name: 'EU') }+ let!(:country) { create(:country, iso: 'DE', iso3: 'DEU', name: 'Germany') }+ let!(:other_country) { create(:country, iso: 'FR', iso3: 'FRA', name: 'France') }+ let!(:market) { create(:market, store: store, name: 'EU', countries: [country]) }++ # `Spree::MarketCountry` validates that the country is covered by a shipping+ # zone with an active shipping method (see `country_covered_by_shipping_zone`).+ # The market factory does this for its own countries; we mirror that for the+ # other countries this spec assigns directly through the API.+ before do+ shipping_zone = Spree::Zone.find_or_create_by!(name: 'Test Shipping Zone') { |z| z.kind = 'country' }+ [country, other_country].each do |c|+ shipping_zone.zone_members.find_or_create_by!(zoneable: c)+ end+ if shipping_zone.shipping_methods.empty?+ shipping_category = Spree::ShippingCategory.first || create(:shipping_category)+ create(:shipping_method, zones: [shipping_zone], shipping_categories: [shipping_category])+ end+ endpath '/api/v3/admin/markets' doget 'List markets' do@@ -14,9 +31,9 @@ RSpec.describe 'Admin Markets API', type: :request, swagger_doc: 'api-reference/produces 'application/json'security [api_key: [], bearer_auth: []]description <<~DESC- Returns the markets configured for the current store. Read-only:- write surface lives in the legacy Rails admin pending the- Channel / Catalog rework (see `docs/plans/6.0-channels-catalogs-b2b.md`).+ Returns the markets configured for the current store. Markets are+ store-scoped and ordered by `position` (an `acts_as_list` column —+ update the order via `PATCH /markets/{id}` with `position`).DESCadmin_scope :read, :settings@@ -42,6 +59,88 @@ RSpec.describe 'Admin Markets API', type: :request, swagger_doc: 'api-reference/endendend++ post 'Create a market' do+ tags 'Pricing'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description <<~DESC+ Creates a new market for the current store.++ - `country_isos` accepts 2-letter ISO country codes (e.g. `["DE", "FR"]`);+ the market must contain at least one country. Unknown codes are+ silently dropped.+ - `supported_locales` accepts an array of locale codes; the+ `default_locale` is always implicitly included.+ - Setting `default: true` automatically demotes the previous default+ market in the store.+ DESC+ admin_scope :write, :settings++ admin_sdk_example 'markets/create'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ name: { type: :string, example: 'Europe' },+ currency: { type: :string, example: 'EUR', description: 'ISO 4217 currency code.' },+ default_locale: { type: :string, example: 'de', description: 'IETF locale tag used as the market default.' },+ supported_locales: {+ type: :array,+ items: { type: :string },+ description: 'Locale codes available in this market. The default is always implicitly included.',+ example: %w[de en]+ },+ tax_inclusive: { type: :boolean, default: false, description: 'Display prices with tax included.' },+ default: { type: :boolean, default: false, description: 'Setting to true demotes the previous default.' },+ position: { type: :integer, description: 'Sort order within the store; lower = first.' },+ country_isos: {+ type: :array,+ items: { type: :string },+ description: '2-letter ISO country codes assigned to this market. At least one is required.',+ example: %w[DE FR]+ }+ },+ required: %w[name currency default_locale country_isos]+ }++ response '201', 'market created' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ let(:body) do+ {+ name: 'France only',+ currency: 'EUR',+ default_locale: 'fr',+ supported_locales: ['fr', 'en'],+ tax_inclusive: true,+ country_isos: [other_country.iso]+ }+ end++ schema '$ref' => '#/components/schemas/Market'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['name']).to eq('France only')+ expect(data['currency']).to eq('EUR')+ expect(data['tax_inclusive']).to be true+ expect(data['supported_locales']).to match_array(%w[en fr])+ expect(data['country_isos']).to eq(['FR'])+ end+ end++ response '422', 'validation error' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ let(:body) { { name: '' } }++ schema '$ref' => '#/components/schemas/ErrorResponse'++ run_test!+ end+ endendpath '/api/v3/admin/markets/{id}' do@@ -80,5 +179,97 @@ RSpec.describe 'Admin Markets API', type: :request, swagger_doc: 'api-reference/run_test!endend++ patch 'Update a market' do+ tags 'Pricing'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description <<~DESC+ Updates an existing market. Pass `country_isos` to replace the+ market's country list (full-set update), `supported_locales` to+ replace the supported locales, or `position` to reorder the market+ within the store.++ Setting `default: true` automatically demotes the previous default.+ DESC+ admin_scope :write, :settings++ admin_sdk_example 'markets/update'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ name: { type: :string },+ currency: { type: :string },+ default_locale: { type: :string },+ supported_locales: { type: :array, items: { type: :string } },+ tax_inclusive: { type: :boolean },+ default: { type: :boolean },+ position: { type: :integer },+ country_isos: { type: :array, items: { type: :string } }+ }+ }++ response '200', 'market updated' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ let(:id) { market.prefixed_id }+ let(:body) { { name: 'European Union', tax_inclusive: true } }++ schema '$ref' => '#/components/schemas/Market'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['name']).to eq('European Union')+ expect(data['tax_inclusive']).to be true+ end+ end++ response '422', 'validation error' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ let(:id) { market.prefixed_id }+ let(:body) { { name: '' } }++ schema '$ref' => '#/components/schemas/ErrorResponse'++ run_test!+ end+ end++ delete 'Delete a market' do+ tags 'Pricing'+ security [api_key: [], bearer_auth: []]+ description <<~DESC+ Soft-deletes the market (sets `deleted_at`). The default market and+ the last remaining market in a store cannot be deleted — both return+ 422 with a `validation_error`.+ DESC+ admin_scope :write, :settings++ admin_sdk_example 'markets/delete'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true++ response '204', 'market deleted' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ # Create a second market so the target isn't the last one in the store.+ let!(:second_market) { create(:market, store: store, name: 'ROW', countries: [other_country]) }+ let(:id) { market.prefixed_id }++ run_test!+ end++ response '422', 'cannot delete default or last market' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ let(:id) { market.prefixed_id }++ schema '$ref' => '#/components/schemas/ErrorResponse'++ run_test!+ end+ endendenddiff --git a/spree/core/app/models/spree/market.rb b/spree/core/app/models/spree/market.rbindex 24bb28e52b..f5c432c139 100644--- a/spree/core/app/models/spree/market.rb+++ b/spree/core/app/models/spree/market.rb@@ -81,6 +81,37 @@ module Spree@supported_locales_list ||= (supported_locales.to_s.split(',').map(&:strip) << default_locale).compact.uniq.sortend+ # Accepts an Array of locale codes and persists them as a comma-separated+ # string on the `supported_locales` column. Strings are still accepted+ # verbatim so legacy callers (the Rails admin form, raw seed scripts)+ # keep working.+ #+ # @param value [Array<String>, String, nil]+ def supported_locales=(value)+ @supported_locales_list = nil+ normalized = value.is_a?(Array) ? value.compact.uniq.reject(&:blank?).join(',') : value+ super(normalized)+ end++ # Read companion for `country_isos=`. Returns the sorted list of ISO codes+ # currently assigned to the market.+ #+ # @return [Array<String>]+ def country_isos+ countries.map(&:iso).compact.sort+ end++ # Accepts an Array of 2-letter ISO codes and resolves them to the matching+ # `Spree::Country` records, replacing the market's countries. Unknown codes+ # are silently dropped — the `validates :countries, presence: true` covers+ # the "every ISO was bogus" case.+ #+ # @param values [Array<String>]+ def country_isos=(values)+ isos = Array(values).compact.map { |v| v.to_s.upcase }.reject(&:blank?)+ self.countries = isos.any? ? Spree::Country.where(iso: isos) : []+ end+# Returns true when the market is safe to delete. A market cannot be deleted# if it is the default market or the only market in the store, since# Spree::Current.currency would have no fallback.diff --git a/spree/core/spec/models/spree/market_spec.rb b/spree/core/spec/models/spree/market_spec.rbindex b0b0492bf7..ecd500b8a2 100644--- a/spree/core/spec/models/spree/market_spec.rb+++ b/spree/core/spec/models/spree/market_spec.rb@@ -97,6 +97,111 @@ RSpec.describe Spree::Market, type: :model doendend+ describe '#supported_locales=' do+ let(:market) { build(:market, store: store, default_locale: 'en') }++ it 'joins an array into a comma-separated string' do+ market.supported_locales = %w[fr de]+ expect(market.read_attribute(:supported_locales)).to eq('fr,de')+ end++ it 'accepts a plain string verbatim' do+ market.supported_locales = 'fr,de'+ expect(market.read_attribute(:supported_locales)).to eq('fr,de')+ end++ it 'strips blanks and deduplicates array entries' do+ market.supported_locales = ['fr', '', 'de', 'fr', nil]+ expect(market.read_attribute(:supported_locales)).to eq('fr,de')+ end++ it 'clears the memoized supported_locales_list on assignment' do+ market.supported_locales = %w[fr]+ expect(market.supported_locales_list).to eq(%w[en fr])++ market.supported_locales = %w[de]+ expect(market.supported_locales_list).to eq(%w[de en])+ end++ it 'persists the comma-string after save' do+ market.supported_locales = %w[fr de]+ market.save!+ expect(market.reload.read_attribute(:supported_locales)).to eq('fr,de')+ end+ end++ describe '#country_isos' do+ it 'returns the sorted ISO codes for assigned countries' do+ de = create(:country, iso: 'DE', name: 'Germany')+ fr = create(:country, iso: 'FR', name: 'France')+ market = create(:market, store: store, countries: [fr, de])++ expect(market.country_isos).to eq(%w[DE FR])+ end++ it 'returns an empty array when no countries are assigned' do+ market = build(:market, store: store, countries: [])+ expect(market.country_isos).to eq([])+ end++ it 'reflects updates made via country_isos=' do+ create(:country, iso: 'DE', name: 'Germany')+ create(:country, iso: 'FR', name: 'France')+ market = build(:market, store: store, countries: [])+ market.country_isos = %w[FR DE]+ expect(market.country_isos).to eq(%w[DE FR])+ end++ it 'round-trips through save/reload' do+ de = create(:country, iso: 'DE', name: 'Germany')+ fr = create(:country, iso: 'FR', name: 'France')+ market = create(:market, store: store, countries: [de, fr])+ expect(market.reload.country_isos).to eq(%w[DE FR])+ end+ end++ describe '#country_isos=' do+ let!(:de) { create(:country, iso: 'DE', name: 'Germany') }+ let!(:fr) { create(:country, iso: 'FR', name: 'France') }+ let!(:italy) { create(:country, iso: 'IT', name: 'Italy') }++ it 'resolves ISO codes to Country records' do+ market = build(:market, store: store, countries: [])+ market.country_isos = %w[DE FR]+ expect(market.countries).to contain_exactly(de, fr)+ end++ it 'is case-insensitive' do+ market = build(:market, store: store, countries: [])+ market.country_isos = %w[de fr]+ expect(market.countries).to contain_exactly(de, fr)+ end++ it 'silently drops unknown codes' do+ market = build(:market, store: store, countries: [])+ market.country_isos = %w[DE XX FR]+ expect(market.countries).to contain_exactly(de, fr)+ end++ it 'replaces the existing country list (full-set update)' do+ market = build(:market, store: store, countries: [de, fr])+ market.country_isos = %w[IT]+ expect(market.countries).to contain_exactly(italy)+ end++ it 'clears all countries when given an empty array' do+ market = build(:market, store: store, countries: [de])+ market.country_isos = []+ expect(market.countries).to be_empty+ end++ it 'strips blanks and nils' do+ market = build(:market, store: store, countries: [])+ market.country_isos = ['DE', '', nil, 'FR']+ expect(market.countries).to contain_exactly(de, fr)+ end+ end+describe '#can_be_deleted?' doit 'returns false for the default market' docreate(:market, store: store)