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
Make the React Dashboard fully translatable
Damian Legawiece68f490de4f6
diff --git a/docs/api-reference/admin.yaml b/docs/api-reference/admin.yamlindex b490d96636..0d2ed39338 100644--- a/docs/api-reference/admin.yaml+++ b/docs/api-reference/admin.yaml@@ -92,15 +92,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjAyOTJjMGE3LWM4ODctNDBhNi1hZWU5LTMzOGU4OTRiZTg2NyIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzgxNzAzNjg4fQ.0Wq9MSgFzcIq2sgIcKqtqZ4Xu_oS-KoGirUtdmnwQYY+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6ImM3Y2E2MGJkLTE0ZDItNDA2YS1hYTU5LWYwOWMwODE2ZTU2MyIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzgyMTQ3NjM3fQ.z2ER2-uMniFdfJ2Oc0vigq0NwW8dCNCHge1HiR6pY7Yuser:id: admin_UkLWZg9DAJemail: [email protected]- first_name: Conrad- last_name: Hauck- full_name: Conrad Hauck- created_at: '2026-06-17T13:36:28.388Z'- updated_at: '2026-06-17T13:36:28.388Z'+ first_name: Theola+ last_name: Streich+ full_name: Theola Streich+ selected_locale:+ created_at: '2026-06-22T16:55:37.483Z'+ updated_at: '2026-06-22T16:55:37.483Z'roles:- id: role_UkLWZg9DAJname: admin@@ -198,15 +199,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjBhZmZkZmYxLTVjZTUtNDRjNy04YjU5LTNhYzgxNjgwNTg5MCIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzgxNzAzNjg5fQ.p-ipNET4GETnwKt_V4fcOZ9y36Wd9zMSKz0b0d1OqSQ+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6Ijk4ZjNmNTE3LTU3M2UtNGJjOC04MTc4LWQ0YzYzYmRmZjk1NCIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzgyMTQ3NjM4fQ.rhzElqgBFLAJ_6LZKrpMvq6pauc1RoD2bmzgH57lh5Quser:id: admin_UkLWZg9DAJemail: [email protected]- first_name: Roma- last_name: Nicolas- full_name: Roma Nicolas- created_at: '2026-06-17T13:36:29.491Z'- updated_at: '2026-06-17T13:36:29.491Z'+ first_name: Joetta+ last_name: Fadel+ full_name: Joetta Fadel+ selected_locale:+ created_at: '2026-06-22T16:55:38.581Z'+ updated_at: '2026-06-22T16:55:38.581Z'roles:- id: role_UkLWZg9DAJname: admin@@ -303,12 +305,13 @@ paths:example:user:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Columbus- last_name: Stoltenberg- full_name: Columbus Stoltenberg- created_at: '2026-06-17T13:37:02.089Z'- updated_at: '2026-06-17T13:37:02.089Z'+ email: [email protected]+ first_name: Barbera+ last_name: McCullough+ full_name: Barbera McCullough+ selected_locale:+ created_at: '2026-06-22T16:56:09.620Z'+ updated_at: '2026-06-22T16:56:09.620Z'roles:- id: role_UkLWZg9DAJname: admin@@ -376,6 +379,132 @@ paths:message: Authentication requiredschema:"$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update the current admin profile+ tags:+ - Authentication+ security:+ - api_key: []+ bearer_auth: []+ description: Self-service update of the signed-in admin's own profile, such+ as their admin UI display language (`selected_locale`).+ 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',+ })++ // Set the signed-in admin's own UI display language.+ const me = await client.me.update({+ selected_locale: 'de',+ })+ - lang: bash+ label: Spree CLI+ source: spree api patch /me -d '{"selected_locale":"de"}'+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ description: Bearer token for admin authentication+ schema:+ type: string+ responses:+ '200':+ description: profile updated+ content:+ application/json:+ example:+ user:+ id: admin_UkLWZg9DAJ+ email: [email protected]+ first_name: Hisako+ last_name: Skiles+ full_name: Hisako Skiles+ selected_locale: de+ created_at: '2026-06-22T16:56:09.912Z'+ updated_at: '2026-06-22T16:56:09.924Z'+ roles:+ - id: role_UkLWZg9DAJ+ name: admin+ permissions:+ - allow: true+ actions:+ - manage+ subjects:+ - all+ has_conditions: false+ - allow: false+ actions:+ - cancel+ subjects:+ - Spree::Order+ has_conditions: false+ - allow: true+ actions:+ - cancel+ subjects:+ - Spree::Order+ has_conditions: true+ - allow: false+ actions:+ - destroy+ subjects:+ - Spree::Order+ has_conditions: false+ - allow: true+ actions:+ - destroy+ subjects:+ - Spree::Order+ has_conditions: true+ - allow: false+ actions:+ - edit+ - update+ subjects:+ - Spree::RefundReason+ has_conditions: true+ - allow: false+ actions:+ - edit+ - update+ subjects:+ - Spree::ReimbursementType+ has_conditions: true+ - allow: false+ actions:+ - update+ - destroy+ subjects:+ - Spree::Role+ has_conditions: true+ schema:+ "$ref": "#/components/schemas/MeResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ selected_locale:+ type: string+ example: de+ first_name:+ type: string+ example: Ada+ last_name:+ type: string+ example: Lovelace"/api/v3/admin/allowed_origins":get:summary: List allowed origins@@ -459,8 +588,8 @@ paths:data:- id: ao_UkLWZg9DAJorigin: https://shop.example.com- created_at: '2026-06-17T13:36:23.855Z'- updated_at: '2026-06-17T13:36:23.855Z'+ created_at: '2026-06-22T16:55:32.974Z'+ updated_at: '2026-06-22T16:55:32.974Z'meta:page: 1limit: 25@@ -544,8 +673,8 @@ paths:example:id: ao_gbHJdmfrXBorigin: https://admin.example.com- created_at: '2026-06-17T13:36:24.434Z'- updated_at: '2026-06-17T13:36:24.434Z'+ created_at: '2026-06-22T16:55:33.552Z'+ updated_at: '2026-06-22T16:55:33.552Z'schema:"$ref": "#/components/schemas/AllowedOrigin"'422':@@ -632,8 +761,8 @@ paths:example:id: ao_UkLWZg9DAJorigin: https://shop.example.com- created_at: '2026-06-17T13:36:24.721Z'- updated_at: '2026-06-17T13:36:24.721Z'+ created_at: '2026-06-22T16:55:33.843Z'+ updated_at: '2026-06-22T16:55:33.843Z'schema:"$ref": "#/components/schemas/AllowedOrigin"'404':@@ -694,8 +823,8 @@ paths:example:id: ao_UkLWZg9DAJorigin: https://www.example.com- created_at: '2026-06-17T13:36:25.292Z'- updated_at: '2026-06-17T13:36:25.574Z'+ created_at: '2026-06-22T16:55:34.401Z'+ updated_at: '2026-06-22T16:55:34.674Z'schema:"$ref": "#/components/schemas/AllowedOrigin"'422':@@ -815,32 +944,32 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-06-17T13:36:26.163Z'- updated_at: '2026-06-17T13:36:26.163Z'+ created_at: '2026-06-22T16:55:35.258Z'+ updated_at: '2026-06-22T16:55:35.258Z'revoked_at:last_used_at:- plaintext_token: pk_8ZT28Ukp3P1pK8s7ceH49aLZ+ plaintext_token: pk_9Qhhr8J144cNGpMS925aCMUxcreated_by_email:- id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_DHSRHRDqp+ token_prefix: sk_TcK1YKNWzscopes:- write_all- created_at: '2026-06-17T13:36:26.165Z'- updated_at: '2026-06-17T13:36:26.165Z'+ created_at: '2026-06-22T16:55:35.260Z'+ updated_at: '2026-06-22T16:55:35.260Z'revoked_at:last_used_at:plaintext_token:created_by_email:- id: key_EfhxLZ9ck8- name: neque+ name: eiuskey_type: secret- token_prefix: sk_GwCLQtS7T+ token_prefix: sk_UPaWMDDmkscopes:- write_all- created_at: '2026-06-17T13:36:26.165Z'- updated_at: '2026-06-17T13:36:26.165Z'+ created_at: '2026-06-22T16:55:35.260Z'+ updated_at: '2026-06-22T16:55:35.260Z'revoked_at:last_used_at:plaintext_token:@@ -906,15 +1035,15 @@ paths:id: key_VqXmZF31wYname: CI keykey_type: secret- token_prefix: sk_4uENDHKAe+ token_prefix: sk_SZXapquWGscopes:- read_orders- created_at: '2026-06-17T13:36:26.719Z'- updated_at: '2026-06-17T13:36:26.719Z'+ created_at: '2026-06-22T16:55:35.816Z'+ updated_at: '2026-06-22T16:55:35.816Z'revoked_at:last_used_at:- plaintext_token: sk_4uENDHKAe1d7iCtqczjBSJrd- created_by_email: [email protected]+ plaintext_token: sk_SZXapquWGcJWJZYMBXrd6hK8+ created_by_email: [email protected]'422':description: validation errorcontent:@@ -1003,11 +1132,11 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-06-17T13:36:27.005Z'- updated_at: '2026-06-17T13:36:27.005Z'+ created_at: '2026-06-22T16:55:36.099Z'+ updated_at: '2026-06-22T16:55:36.099Z'revoked_at:last_used_at:- plaintext_token: pk_J282X63g3voLpqqaWqM7J175+ plaintext_token: pk_9f3raRoa8W4JjHoKjJnnXA8ccreated_by_email:patch:summary: Update an API key@@ -1061,11 +1190,11 @@ paths:id: key_gbHJdmfrXBname: Backend integration (renamed)key_type: secret- token_prefix: sk_anBP2apR8+ token_prefix: sk_qVKLkhADbscopes:- write_all- created_at: '2026-06-17T13:36:27.283Z'- updated_at: '2026-06-17T13:36:27.563Z'+ created_at: '2026-06-22T16:55:36.378Z'+ updated_at: '2026-06-22T16:55:36.653Z'revoked_at:last_used_at:plaintext_token:@@ -1161,13 +1290,13 @@ paths:application/json:example:id: key_EfhxLZ9ck8- name: animi+ name: explicabokey_type: secret- token_prefix: sk_bkpzKACS2+ token_prefix: sk_w5NaAd2wEscopes:- write_all- created_at: '2026-06-17T13:36:27.845Z'- updated_at: '2026-06-17T13:36:27.845Z'+ created_at: '2026-06-22T16:55:36.935Z'+ updated_at: '2026-06-22T16:55:36.935Z'revoked_at:last_used_at:plaintext_token:@@ -1224,12 +1353,12 @@ paths:id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_C8QgWdstF+ token_prefix: sk_q694qPdJnscopes:- write_all- created_at: '2026-06-17T13:36:27.854Z'- updated_at: '2026-06-17T13:36:28.127Z'- revoked_at: '2026-06-17T13:36:28.127Z'+ created_at: '2026-06-22T16:55:36.945Z'+ updated_at: '2026-06-22T16:55:37.220Z'+ revoked_at: '2026-06-22T16:55:37.219Z'last_used_at:plaintext_token:created_by_email:@@ -1294,16 +1423,16 @@ paths:active: truedefault: truepreferred_order_routing_strategy:- created_at: '2026-06-17T13:36:22.603Z'- updated_at: '2026-06-17T13:36:22.603Z'+ created_at: '2026-06-22T16:55:31.707Z'+ updated_at: '2026-06-22T16:55:31.707Z'- id: ch_gbHJdmfrXBname: Wholesalecode: wholesaleactive: truedefault: falsepreferred_order_routing_strategy:- created_at: '2026-06-17T13:36:30.124Z'- updated_at: '2026-06-17T13:36:30.124Z'+ created_at: '2026-06-22T16:55:39.164Z'+ updated_at: '2026-06-22T16:55:39.164Z'meta:page: 1limit: 25@@ -1384,8 +1513,8 @@ paths:active: truedefault: falsepreferred_order_routing_strategy:- created_at: '2026-06-17T13:36:30.703Z'- updated_at: '2026-06-17T13:36:30.703Z'+ created_at: '2026-06-22T16:55:39.732Z'+ updated_at: '2026-06-22T16:55:39.732Z'requestBody:content:application/json:@@ -1457,8 +1586,8 @@ paths:active: truedefault: falsepreferred_order_routing_strategy:- created_at: '2026-06-17T13:36:30.714Z'- updated_at: '2026-06-17T13:36:30.714Z'+ created_at: '2026-06-22T16:55:39.741Z'+ updated_at: '2026-06-22T16:55:39.741Z'patch:summary: Update a channeltags:@@ -1508,8 +1637,8 @@ paths:active: truedefault: falsepreferred_order_routing_strategy:- created_at: '2026-06-17T13:36:30.997Z'- updated_at: '2026-06-17T13:36:31.278Z'+ created_at: '2026-06-22T16:55:40.024Z'+ updated_at: '2026-06-22T16:55:40.302Z'requestBody:content:application/json:@@ -1784,8 +1913,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-06-17T13:36:32.637Z'- updated_at: '2026-06-17T13:36:32.637Z'+ created_at: '2026-06-22T16:55:41.589Z'+ updated_at: '2026-06-22T16:55:41.589Z'- id: cfdef_gbHJdmfrXBnamespace: customkey: order_notes@@ -1793,8 +1922,8 @@ paths:field_type: short_textresource_type: Spree::Orderstorefront_visible: true- created_at: '2026-06-17T13:36:32.638Z'- updated_at: '2026-06-17T13:36:32.638Z'+ created_at: '2026-06-22T16:55:41.590Z'+ updated_at: '2026-06-22T16:55:41.590Z'meta:page: 1limit: 25@@ -1860,8 +1989,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-06-17T13:36:33.191Z'- updated_at: '2026-06-17T13:36:33.191Z'+ created_at: '2026-06-22T16:55:42.153Z'+ updated_at: '2026-06-22T16:55:42.153Z'requestBody:content:application/json:@@ -1958,8 +2087,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-06-17T13:36:33.203Z'- updated_at: '2026-06-17T13:36:33.203Z'+ created_at: '2026-06-22T16:55:42.160Z'+ updated_at: '2026-06-22T16:55:42.160Z'patch:summary: Update a custom field definitiontags:@@ -2016,8 +2145,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: false- created_at: '2026-06-17T13:36:33.482Z'- updated_at: '2026-06-17T13:36:33.784Z'+ created_at: '2026-06-22T16:55:42.442Z'+ updated_at: '2026-06-22T16:55:42.718Z'requestBody:content:application/json:@@ -2159,14 +2288,14 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 0- created_at: '2026-06-17T13:36:34.075Z'- updated_at: '2026-06-17T13:36:34.075Z'+ created_at: '2026-06-22T16:55:43.003Z'+ updated_at: '2026-06-22T16:55:43.003Z'- id: cg_gbHJdmfrXBname: Wholesaledescription:customers_count: 0- created_at: '2026-06-17T13:36:34.076Z'- updated_at: '2026-06-17T13:36:34.076Z'+ created_at: '2026-06-22T16:55:43.004Z'+ updated_at: '2026-06-22T16:55:43.004Z'meta:page: 1limit: 25@@ -2255,8 +2384,8 @@ paths:name: Wholesale 2description: B2B accountscustomers_count: 1- created_at: '2026-06-17T13:36:34.961Z'- updated_at: '2026-06-17T13:36:34.961Z'+ created_at: '2026-06-22T16:55:43.876Z'+ updated_at: '2026-06-22T16:55:43.876Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -2365,24 +2494,24 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 1- created_at: '2026-06-17T13:36:35.599Z'- updated_at: '2026-06-17T13:36:35.599Z'+ created_at: '2026-06-22T16:55:44.498Z'+ updated_at: '2026-06-22T16:55:44.498Z'customers:- id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Yasmin- last_name: Renner+ email: [email protected]+ first_name: Shirlene+ last_name: Boganphone:accepts_email_marketing: false- full_name: Yasmin Renner+ full_name: Shirlene Boganavailable_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-06-17T13:36:35.867Z'- updated_at: '2026-06-17T13:36:35.867Z'+ created_at: '2026-06-22T16:55:44.758Z'+ updated_at: '2026-06-22T16:55:44.758Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2463,8 +2592,8 @@ paths:name: VIP customers (Q1)description: Top spenderscustomers_count: 0- created_at: '2026-06-17T13:36:36.454Z'- updated_at: '2026-06-17T13:36:36.732Z'+ created_at: '2026-06-22T16:55:45.334Z'+ updated_at: '2026-06-22T16:55:45.609Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -2623,8 +2752,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-06-17T13:36:37.574Z'- updated_at: '2026-06-17T13:36:37.574Z'+ created_at: '2026-06-22T16:55:46.451Z'+ updated_at: '2026-06-22T16:55:46.451Z'customer_id: cus_UkLWZg9DAJmeta:page: 1@@ -2717,8 +2846,8 @@ paths:state_name: New Yorklabel: Officemetadata: {}- created_at: '2026-06-17T13:36:39.028Z'- updated_at: '2026-06-17T13:36:39.028Z'+ created_at: '2026-06-22T16:55:47.794Z'+ updated_at: '2026-06-22T16:55:47.794Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -2832,8 +2961,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-06-17T13:36:39.299Z'- updated_at: '2026-06-17T13:36:39.834Z'+ created_at: '2026-06-22T16:55:48.062Z'+ updated_at: '2026-06-22T16:55:48.611Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -2972,8 +3101,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-06-17T13:36:40.958Z'- updated_at: '2026-06-17T13:36:40.958Z'+ created_at: '2026-06-22T16:55:49.708Z'+ updated_at: '2026-06-22T16:55:49.708Z'meta:page: 1limit: 25@@ -3063,8 +3192,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-06-17T13:36:41.515Z'- updated_at: '2026-06-17T13:36:41.515Z'+ created_at: '2026-06-22T16:55:50.256Z'+ updated_at: '2026-06-22T16:55:50.256Z'delete:summary: Delete a customer credit cardtags:@@ -3189,8 +3318,8 @@ paths:currency: USDmemo:metadata: {}- created_at: '2026-06-17T13:36:42.989Z'- updated_at: '2026-06-17T13:36:42.989Z'+ created_at: '2026-06-22T16:55:51.626Z'+ updated_at: '2026-06-22T16:55:51.626Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -3269,8 +3398,8 @@ paths:currency: USDmemo: Goodwillmetadata: {}- created_at: '2026-06-17T13:36:44.090Z'- updated_at: '2026-06-17T13:36:44.090Z'+ created_at: '2026-06-22T16:55:52.756Z'+ updated_at: '2026-06-22T16:55:52.756Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_gbHJdmfrXBcategory_id: sccat_UkLWZg9DAJ@@ -3365,8 +3494,8 @@ paths:currency: USDmemo: Updatedmetadata: {}- created_at: '2026-06-17T13:36:44.650Z'- updated_at: '2026-06-17T13:36:44.959Z'+ created_at: '2026-06-22T16:55:53.294Z'+ updated_at: '2026-06-22T16:55:53.573Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -3527,8 +3656,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-06-17T13:36:46.160Z'- updated_at: '2026-06-17T13:36:46.160Z'+ created_at: '2026-06-22T16:55:54.652Z'+ updated_at: '2026-06-22T16:55:54.652Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -3615,8 +3744,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-06-17T13:36:47.204Z'- updated_at: '2026-06-17T13:36:47.204Z'+ created_at: '2026-06-22T16:55:55.475Z'+ updated_at: '2026-06-22T16:55:55.475Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -3735,8 +3864,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-06-17T13:36:47.485Z'- updated_at: '2026-06-17T13:36:47.485Z'+ created_at: '2026-06-22T16:55:55.742Z'+ updated_at: '2026-06-22T16:55:55.742Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -3813,8 +3942,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-06-17T13:36:48.191Z'- updated_at: '2026-06-17T13:36:48.518Z'+ created_at: '2026-06-22T16:55:56.287Z'+ updated_at: '2026-06-22T16:55:56.562Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -4262,11 +4391,11 @@ paths:example:data:- id: exp_UkLWZg9DAJ- number: EF056458896+ number: EF258164785type: Spree::Exports::Productsformat: csv- created_at: '2026-06-17T13:36:53.059Z'- updated_at: '2026-06-17T13:36:53.059Z'+ created_at: '2026-06-22T16:56:00.623Z'+ updated_at: '2026-06-22T16:56:00.623Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -4336,11 +4465,11 @@ paths:application/json:example:id: exp_gbHJdmfrXB- number: EF906940928+ number: EF485508971type: Spree::Exports::Productsformat: csv- created_at: '2026-06-17T13:36:53.357Z'- updated_at: '2026-06-17T13:36:53.357Z'+ created_at: '2026-06-22T16:56:00.914Z'+ updated_at: '2026-06-22T16:56:00.914Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -4430,11 +4559,11 @@ paths:application/json:example:id: exp_UkLWZg9DAJ- number: EF706283958+ number: EF506770734type: Spree::Exports::Productsformat: csv- created_at: '2026-06-17T13:36:53.632Z'- updated_at: '2026-06-17T13:36:53.632Z'+ created_at: '2026-06-22T16:56:01.187Z'+ updated_at: '2026-06-22T16:56:01.187Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -4616,7 +4745,7 @@ paths:example:data:- id: ful_UkLWZg9DAJ- number: H49222940354+ number: H56341194989tracking: U10000tracking_url:cost: '10.0'@@ -4641,8 +4770,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:04.809Z'- updated_at: '2026-06-17T13:37:04.889Z'+ created_at: '2026-06-22T16:56:12.638Z'+ updated_at: '2026-06-22T16:56:12.712Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJmeta:@@ -4728,7 +4857,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H73313996122+ number: H60126130605tracking: U10000tracking_url:cost: '10.0'@@ -4753,8 +4882,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:05.492Z'- updated_at: '2026-06-17T13:37:05.553Z'+ created_at: '2026-06-22T16:56:13.308Z'+ updated_at: '2026-06-22T16:56:13.361Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJpatch:@@ -4816,7 +4945,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H63964573474+ number: H24779581165tracking: 1Z999AA10123456784tracking_url: https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=1Z999AA10123456784cost: '10.0'@@ -4841,8 +4970,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:06.154Z'- updated_at: '2026-06-17T13:37:06.499Z'+ created_at: '2026-06-22T16:56:13.971Z'+ updated_at: '2026-06-22T16:56:14.306Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJrequestBody:@@ -4915,7 +5044,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H40931677392+ number: H29375189030tracking: U10000tracking_url:cost: '10.0'@@ -4932,7 +5061,7 @@ paths:display_tax_total: "$0.00"status: shippedfulfillment_type: shipping- fulfilled_at: '2026-06-17T13:37:07Z'+ fulfilled_at: '2026-06-22T16:56:14Z'items:- item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJ@@ -4940,8 +5069,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:06.815Z'- updated_at: '2026-06-17T13:37:07.161Z'+ created_at: '2026-06-22T16:56:14.622Z'+ updated_at: '2026-06-22T16:56:14.959Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":@@ -5003,7 +5132,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H12070437617+ number: H75664572948tracking: U10000tracking_url:cost: '10.0'@@ -5028,8 +5157,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:07.480Z'- updated_at: '2026-06-17T13:37:07.827Z'+ created_at: '2026-06-22T16:56:15.278Z'+ updated_at: '2026-06-22T16:56:15.628Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":@@ -5091,7 +5220,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H56925909547+ number: H77003135950tracking: U10000tracking_url:cost: '10.0'@@ -5116,8 +5245,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:08.160Z'- updated_at: '2026-06-17T13:37:08.505Z'+ created_at: '2026-06-22T16:56:15.953Z'+ updated_at: '2026-06-22T16:56:16.294Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":@@ -5181,7 +5310,7 @@ paths:example:data:- id: ful_gbHJdmfrXB- number: H86852767273+ number: H51733710953tracking:tracking_url:cost: '10.0'@@ -5206,8 +5335,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-06-17T13:37:09.178Z'- updated_at: '2026-06-17T13:37:09.241Z'+ created_at: '2026-06-22T16:56:16.972Z'+ updated_at: '2026-06-22T16:56:17.013Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_gbHJdmfrXBrequestBody:@@ -5306,8 +5435,8 @@ paths:codes_count: 2currency: USDprefix: WELCOME- created_at: '2026-06-17T13:36:54.240Z'- updated_at: '2026-06-17T13:36:54.240Z'+ created_at: '2026-06-22T16:56:01.786Z'+ updated_at: '2026-06-22T16:56:01.786Z'amount: '50.0'expires_at:created_by_id:@@ -5391,8 +5520,8 @@ paths:codes_count: 5currency: USDprefix: NEWCAMP- created_at: '2026-06-17T13:36:54.819Z'- updated_at: '2026-06-17T13:36:54.819Z'+ created_at: '2026-06-22T16:56:02.350Z'+ updated_at: '2026-06-22T16:56:02.350Z'amount: '25.0'expires_at: '2030-12-31'created_by_id: admin_UkLWZg9DAJ@@ -5496,8 +5625,8 @@ paths:codes_count: 2currency: USDprefix: WELCOME- created_at: '2026-06-17T13:36:55.115Z'- updated_at: '2026-06-17T13:36:55.115Z'+ created_at: '2026-06-22T16:56:02.640Z'+ updated_at: '2026-06-22T16:56:02.640Z'amount: '50.0'expires_at:created_by_id:@@ -5603,7 +5732,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: A6614CDD316725E3+ code: DF72EC0CE8A9648Estatus: activecurrency: USDamount: '50.0'@@ -5617,12 +5746,12 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-06-17T13:36:55.682Z'- updated_at: '2026-06-17T13:36:55.682Z'+ created_at: '2026-06-22T16:56:03.208Z'+ updated_at: '2026-06-22T16:56:03.208Z'customer_id:created_by_id:- id: gc_gbHJdmfrXB- code: 757D744D296D4A31+ code: 910DD40993166A47status: activecurrency: USDamount: '25.0'@@ -5636,8 +5765,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-06-17T13:36:55.683Z'- updated_at: '2026-06-17T13:36:55.683Z'+ created_at: '2026-06-22T16:56:03.209Z'+ updated_at: '2026-06-22T16:56:03.209Z'customer_id:created_by_id:meta:@@ -5725,7 +5854,7 @@ paths:application/json:example:id: gc_EfhxLZ9ck8- code: ACDEBFAD2B2FF17B+ code: 36376CEDBAD159BBstatus: activecurrency: USDamount: '25.0'@@ -5739,8 +5868,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-06-17T13:36:56.251Z'- updated_at: '2026-06-17T13:36:56.251Z'+ created_at: '2026-06-22T16:56:03.777Z'+ updated_at: '2026-06-22T16:56:03.777Z'customer_id:created_by_id: admin_UkLWZg9DAJschema:@@ -5849,7 +5978,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 5E5404111DD43D70+ code: E1AECB3CA67D3548status: activecurrency: USDamount: '50.0'@@ -5863,8 +5992,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-06-17T13:36:56.544Z'- updated_at: '2026-06-17T13:36:56.544Z'+ created_at: '2026-06-22T16:56:04.066Z'+ updated_at: '2026-06-22T16:56:04.066Z'customer_id:created_by_id:schema:@@ -5927,7 +6056,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: F5061B3D9325CCD9+ code: 41D63BDB1F92E464status: activecurrency: USDamount: '75.0'@@ -5941,8 +6070,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-06-17T13:36:57.104Z'- updated_at: '2026-06-17T13:36:57.377Z'+ created_at: '2026-06-22T16:56:04.624Z'+ updated_at: '2026-06-22T16:56:04.899Z'customer_id:created_by_id:schema:@@ -6098,8 +6227,8 @@ paths:- DEsupported_locales:- en- created_at: '2026-06-17T13:36:59.126Z'- updated_at: '2026-06-17T13:36:59.126Z'+ created_at: '2026-06-22T16:56:06.656Z'+ updated_at: '2026-06-22T16:56:06.656Z'meta:page: 1limit: 25@@ -6192,8 +6321,8 @@ paths:supported_locales:- en- fr- created_at: '2026-06-17T13:36:59.707Z'- updated_at: '2026-06-17T13:36:59.707Z'+ created_at: '2026-06-22T16:56:07.240Z'+ updated_at: '2026-06-22T16:56:07.240Z'schema:"$ref": "#/components/schemas/Market"'422':@@ -6329,8 +6458,8 @@ paths:- DEsupported_locales:- en- created_at: '2026-06-17T13:37:00.024Z'- updated_at: '2026-06-17T13:37:00.024Z'+ created_at: '2026-06-22T16:56:07.560Z'+ updated_at: '2026-06-22T16:56:07.560Z'schema:"$ref": "#/components/schemas/Market"'404':@@ -6409,8 +6538,8 @@ paths:- DEsupported_locales:- en- created_at: '2026-06-17T13:37:00.620Z'- updated_at: '2026-06-17T13:37:00.901Z'+ created_at: '2026-06-22T16:56:08.151Z'+ updated_at: '2026-06-22T16:56:08.431Z'schema:"$ref": "#/components/schemas/Market"'422':@@ -6590,8 +6719,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-06-17T13:37:02.130Z'- updated_at: '2026-06-17T13:37:02.130Z'+ created_at: '2026-06-22T16:56:09.939Z'+ updated_at: '2026-06-22T16:56:09.939Z'meta:page: 1limit: 25@@ -6685,8 +6814,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-06-17T13:37:02.704Z'- updated_at: '2026-06-17T13:37:02.704Z'+ created_at: '2026-06-22T16:56:10.522Z'+ updated_at: '2026-06-22T16:56:10.522Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -6810,8 +6939,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-06-17T13:37:03.000Z'- updated_at: '2026-06-17T13:37:03.000Z'+ created_at: '2026-06-22T16:56:10.839Z'+ updated_at: '2026-06-22T16:56:10.839Z'schema:"$ref": "#/components/schemas/OptionType"'404':@@ -6884,8 +7013,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-06-17T13:37:03.596Z'- updated_at: '2026-06-17T13:37:03.885Z'+ created_at: '2026-06-22T16:56:11.446Z'+ updated_at: '2026-06-22T16:56:11.724Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -7036,7 +7165,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: B0CBBED2D507089D+ code: 5603C9148AE80579status: activecurrency: USDamount: '10.0'@@ -7050,8 +7179,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-06-17T13:37:09.582Z'- updated_at: '2026-06-17T13:37:09.873Z'+ created_at: '2026-06-22T16:56:17.343Z'+ updated_at: '2026-06-22T16:56:17.644Z'customer_id:created_by_id:requestBody:@@ -7190,8 +7319,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 2currency: USD- name: Product 128244- slug: product-128244+ name: Product 128020+ slug: product-128020options_text: 'Size: S'price: '10.0'display_price: "$10.00"@@ -7223,12 +7352,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:10.553Z'- updated_at: '2026-06-17T13:37:10.553Z'+ created_at: '2026-06-22T16:56:18.333Z'+ updated_at: '2026-06-22T16:56:18.333Z'digital_links: []metadata: {}- created_at: '2026-06-17T13:37:10.834Z'- updated_at: '2026-06-17T13:37:10.834Z'+ created_at: '2026-06-22T16:56:18.615Z'+ updated_at: '2026-06-22T16:56:18.615Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJmeta:@@ -7298,8 +7427,8 @@ paths:variant_id: variant_VqXmZF31wYquantity: 3currency: USD- name: Product 146353- slug: product-146353+ name: Product 14512+ slug: product-14512options_text: 'Size: S'price: '19.99'display_price: "$19.99"@@ -7331,12 +7460,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:11.760Z'- updated_at: '2026-06-17T13:37:11.760Z'+ created_at: '2026-06-22T16:56:19.509Z'+ updated_at: '2026-06-22T16:56:19.509Z'digital_links: []metadata: {}- created_at: '2026-06-17T13:37:11.785Z'- updated_at: '2026-06-17T13:37:11.785Z'+ created_at: '2026-06-22T16:56:19.537Z'+ updated_at: '2026-06-22T16:56:19.537Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJrequestBody:@@ -7428,8 +7557,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 2currency: USD- name: Product 159903- slug: product-159903+ name: Product 158199+ slug: product-158199options_text: 'Size: S'price: '10.0'display_price: "$10.00"@@ -7461,12 +7590,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:11.867Z'- updated_at: '2026-06-17T13:37:11.867Z'+ created_at: '2026-06-22T16:56:19.604Z'+ updated_at: '2026-06-22T16:56:19.604Z'digital_links: []metadata: {}- created_at: '2026-06-17T13:37:12.164Z'- updated_at: '2026-06-17T13:37:12.164Z'+ created_at: '2026-06-22T16:56:19.882Z'+ updated_at: '2026-06-22T16:56:19.882Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJpatch:@@ -7531,8 +7660,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 5currency: USD- name: Product 165023- slug: product-165023+ name: Product 163371+ slug: product-163371options_text: 'Size: S'price: '19.99'display_price: "$19.99"@@ -7564,12 +7693,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:12.552Z'- updated_at: '2026-06-17T13:37:12.552Z'+ created_at: '2026-06-22T16:56:20.206Z'+ updated_at: '2026-06-22T16:56:20.206Z'digital_links: []metadata: {}- created_at: '2026-06-17T13:37:12.852Z'- updated_at: '2026-06-17T13:37:13.151Z'+ created_at: '2026-06-22T16:56:20.494Z'+ updated_at: '2026-06-22T16:56:20.790Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJrequestBody:@@ -7689,8 +7818,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R574556026- email: [email protected]+ number: R667287202+ email: [email protected]customer_note:currency: USDlocale: en@@ -7733,8 +7862,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:20.026Z'- updated_at: '2026-06-17T13:37:20.086Z'+ created_at: '2026-06-22T16:56:27.472Z'+ updated_at: '2026-06-22T16:56:27.520Z'preferred_stock_location_id:tags: []internal_note:@@ -7911,8 +8040,8 @@ paths:- id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R204604468- email: [email protected]+ number: R389518521+ email: [email protected]customer_note:currency: USDlocale: en@@ -7955,8 +8084,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:21.814Z'- updated_at: '2026-06-17T13:37:21.814Z'+ created_at: '2026-06-22T16:56:29.255Z'+ updated_at: '2026-06-22T16:56:29.255Z'preferred_stock_location_id:tags: []internal_note:@@ -8107,7 +8236,7 @@ paths:id: or_gbHJdmfrXBmarket_id:channel_id: ch_UkLWZg9DAJ- number: R080179693+ number: R909489440email: [email protected]customer_note:currency: USD@@ -8151,8 +8280,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:23.491Z'- updated_at: '2026-06-17T13:37:23.494Z'+ created_at: '2026-06-22T16:56:30.921Z'+ updated_at: '2026-06-22T16:56:30.924Z'preferred_stock_location_id: sloc_UkLWZg9DAJtags: []internal_note:@@ -8339,8 +8468,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R765234254- email: [email protected]+ number: R028809632+ email: [email protected]customer_note:currency: USDlocale: en@@ -8383,8 +8512,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:23.774Z'- updated_at: '2026-06-17T13:37:23.774Z'+ created_at: '2026-06-22T16:56:31.198Z'+ updated_at: '2026-06-22T16:56:31.198Z'preferred_stock_location_id:tags: []internal_note:@@ -8459,7 +8588,7 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R305062944+ number: R463371614email: [email protected]customer_note:currency: USD@@ -8503,8 +8632,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:24.872Z'- updated_at: '2026-06-17T13:37:25.152Z'+ created_at: '2026-06-22T16:56:32.300Z'+ updated_at: '2026-06-22T16:56:32.581Z'preferred_stock_location_id:tags: []internal_note:@@ -8691,8 +8820,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R189991286- email: [email protected]+ number: R258296734+ email: [email protected]customer_note:currency: USDlocale: en@@ -8719,7 +8848,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status: readypayment_status: paid- completed_at: '2026-06-17T13:37:26.046Z'+ completed_at: '2026-06-22T16:56:33.483Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8735,8 +8864,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:25.990Z'- updated_at: '2026-06-17T13:37:26.096Z'+ created_at: '2026-06-22T16:56:33.427Z'+ updated_at: '2026-06-22T16:56:33.506Z'preferred_stock_location_id:tags: []internal_note:@@ -8820,8 +8949,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R710028424- email: [email protected]+ number: R254080601+ email: [email protected]customer_note:currency: USDlocale: en@@ -8848,7 +8977,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: canceledpayment_status: void- completed_at: '2026-06-17T13:37:27.418Z'+ completed_at: '2026-06-22T16:56:34.730Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8862,10 +8991,10 @@ paths:payment_total: '0.0'display_payment_total: "$0.00"metadata: {}- canceled_at: '2026-06-17T13:37:27.705Z'+ canceled_at: '2026-06-22T16:56:35.033Z'approved_at:- created_at: '2026-06-17T13:37:27.363Z'- updated_at: '2026-06-17T13:37:27.746Z'+ created_at: '2026-06-22T16:56:34.679Z'+ updated_at: '2026-06-22T16:56:35.078Z'preferred_stock_location_id:tags: []internal_note:@@ -8927,8 +9056,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R042243063- email: [email protected]+ number: R497411532+ email: [email protected]customer_note:currency: USDlocale: en@@ -8955,7 +9084,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-06-17T13:37:28.107Z'+ completed_at: '2026-06-22T16:56:35.436Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -8970,9 +9099,9 @@ paths:display_payment_total: "$0.00"metadata: {}canceled_at:- approved_at: '2026-06-17T13:37:28.393Z'- created_at: '2026-06-17T13:37:28.055Z'- updated_at: '2026-06-17T13:37:28.107Z'+ approved_at: '2026-06-22T16:56:35.733Z'+ created_at: '2026-06-22T16:56:35.379Z'+ updated_at: '2026-06-22T16:56:35.436Z'preferred_stock_location_id:tags: []internal_note:@@ -9034,8 +9163,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R100206975- email: [email protected]+ number: R940120430+ email: [email protected]customer_note:currency: USDlocale: en@@ -9062,7 +9191,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: canceledpayment_status: void- completed_at: '2026-06-17T13:37:28.739Z'+ completed_at: '2026-06-22T16:56:36.067Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -9076,10 +9205,10 @@ paths:payment_total: '0.0'display_payment_total: "$0.00"metadata: {}- canceled_at: '2026-06-17T13:37:29.018Z'+ canceled_at: '2026-06-22T16:56:36.341Z'approved_at:- created_at: '2026-06-17T13:37:28.674Z'- updated_at: '2026-06-17T13:37:29.110Z'+ created_at: '2026-06-22T16:56:36.021Z'+ updated_at: '2026-06-22T16:56:36.421Z'preferred_stock_location_id:tags: []internal_note:@@ -9141,8 +9270,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R500563606- email: [email protected]+ number: R631268431+ email: [email protected]customer_note:currency: USDlocale: en@@ -9169,7 +9298,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-06-17T13:37:29.450Z'+ completed_at: '2026-06-22T16:56:36.749Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -9185,8 +9314,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-06-17T13:37:29.392Z'- updated_at: '2026-06-17T13:37:29.450Z'+ created_at: '2026-06-22T16:56:36.702Z'+ updated_at: '2026-06-22T16:56:36.749Z'preferred_stock_location_id:tags: []internal_note:@@ -9264,8 +9393,8 @@ paths:auto_capture:storefront_visible: trueposition: 1- created_at: '2026-06-17T13:37:29.753Z'- updated_at: '2026-06-17T13:37:29.754Z'+ created_at: '2026-06-22T16:56:37.048Z'+ updated_at: '2026-06-22T16:56:37.049Z'preferences: {}preference_schema: []meta:@@ -9411,8 +9540,8 @@ paths:auto_capture:storefront_visible: trueposition: 1- created_at: '2026-06-17T13:37:30.328Z'- updated_at: '2026-06-17T13:37:30.329Z'+ created_at: '2026-06-22T16:56:37.625Z'+ updated_at: '2026-06-22T16:56:37.626Z'preferences: {}preference_schema: []"/api/v3/admin/orders/{order_id}/payments":@@ -9483,8 +9612,8 @@ paths:data:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-509d110a0e0b- number: PVZOV83C+ response_code: BGS-36cb3b3a631c+ number: P3MQTUA0amount: '110.0'display_amount: "$110.00"status: completed@@ -9502,14 +9631,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-06-17T13:37:14.128Z'- updated_at: '2026-06-17T13:37:14.130Z'+ created_at: '2026-06-22T16:56:21.815Z'+ updated_at: '2026-06-22T16:56:21.819Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-06-17T13:37:14.129Z'- updated_at: '2026-06-17T13:37:14.129Z'+ created_at: '2026-06-22T16:56:21.817Z'+ updated_at: '2026-06-22T16:56:21.817Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJmeta:@@ -9579,7 +9708,7 @@ paths:id: py_gbHJdmfrXBpayment_method_id: pm_EfhxLZ9ck8response_code:- number: PLLOWZOO+ number: PJQJOEEDamount: '110.0'display_amount: "$110.00"status: checkout@@ -9590,8 +9719,8 @@ paths:avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-06-17T13:37:15.442Z'- updated_at: '2026-06-17T13:37:15.442Z'+ created_at: '2026-06-22T16:56:23.147Z'+ updated_at: '2026-06-22T16:56:23.147Z'captured_amount: '0.0'order_id: or_gbHJdmfrXBrequestBody:@@ -9684,8 +9813,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-7f8e1681c226- number: P3TZ7OC7+ response_code: BGS-d71876ffd332+ number: P4W76BHJamount: '110.0'display_amount: "$110.00"status: completed@@ -9703,14 +9832,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-06-17T13:37:15.830Z'- updated_at: '2026-06-17T13:37:15.833Z'+ created_at: '2026-06-22T16:56:23.517Z'+ updated_at: '2026-06-22T16:56:23.519Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-06-17T13:37:15.832Z'- updated_at: '2026-06-17T13:37:15.832Z'+ created_at: '2026-06-22T16:56:23.518Z'+ updated_at: '2026-06-22T16:56:23.518Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/payments/{id}/capture":@@ -9773,8 +9902,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-53c9b77de315- number: POTCCGMY+ response_code: BGS-817feeb084eb+ number: PCEMUHUKamount: '110.0'display_amount: "$110.00"status: completed@@ -9792,14 +9921,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-06-17T13:37:16.509Z'- updated_at: '2026-06-17T13:37:16.513Z'+ created_at: '2026-06-22T16:56:24.163Z'+ updated_at: '2026-06-22T16:56:24.165Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-06-17T13:37:16.511Z'- updated_at: '2026-06-17T13:37:16.848Z'+ created_at: '2026-06-22T16:56:24.164Z'+ updated_at: '2026-06-22T16:56:24.488Z'captured_amount: '110.0'order_id: or_UkLWZg9DAJ'422':@@ -9871,8 +10000,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: void-BGS-d0f387a4089a- number: PNJLW27C+ response_code: void-BGS-0815cf8df2b9+ number: PHIYPWT1amount: '110.0'display_amount: "$110.00"status: void@@ -9890,14 +10019,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-06-17T13:37:17.949Z'- updated_at: '2026-06-17T13:37:17.953Z'+ created_at: '2026-06-22T16:56:25.548Z'+ updated_at: '2026-06-22T16:56:25.550Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-06-17T13:37:17.951Z'- updated_at: '2026-06-17T13:37:18.259Z'+ created_at: '2026-06-22T16:56:25.549Z'+ updated_at: '2026-06-22T16:56:25.846Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJ"/api/v3/admin/price_lists":@@ -9985,8 +10114,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:30.609Z'- updated_at: '2026-06-17T13:37:30.609Z'+ created_at: '2026-06-22T16:56:37.907Z'+ updated_at: '2026-06-22T16:56:37.907Z'currently_active: falseproducts_count: 0prices_count: 0@@ -10000,8 +10129,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:30.610Z'- updated_at: '2026-06-17T13:37:30.610Z'+ created_at: '2026-06-22T16:56:37.908Z'+ updated_at: '2026-06-22T16:56:37.908Z'currently_active: falseproducts_count: 0prices_count: 0@@ -10115,8 +10244,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:31.595Z'- updated_at: '2026-06-17T13:37:31.597Z'+ created_at: '2026-06-22T16:56:38.875Z'+ updated_at: '2026-06-22T16:56:38.877Z'currently_active: falseproducts_count: 1prices_count: 2@@ -10279,8 +10408,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:31.891Z'- updated_at: '2026-06-17T13:37:31.891Z'+ created_at: '2026-06-22T16:56:39.170Z'+ updated_at: '2026-06-22T16:56:39.170Z'currently_active: falseproducts_count: 0prices_count: 0@@ -10355,8 +10484,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:33.776Z'- updated_at: '2026-06-17T13:37:34.072Z'+ created_at: '2026-06-22T16:56:40.717Z'+ updated_at: '2026-06-22T16:56:40.994Z'currently_active: falseproducts_count: 0prices_count: 0@@ -10544,8 +10673,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:34.393Z'- updated_at: '2026-06-17T13:37:34.695Z'+ created_at: '2026-06-22T16:56:41.287Z'+ updated_at: '2026-06-22T16:56:41.562Z'currently_active: trueproducts_count: 0prices_count: 0@@ -10608,8 +10737,8 @@ paths:starts_at:ends_at:deleted_at:- created_at: '2026-06-17T13:37:34.708Z'- updated_at: '2026-06-17T13:37:35.041Z'+ created_at: '2026-06-22T16:56:41.570Z'+ updated_at: '2026-06-22T16:56:41.849Z'currently_active: falseproducts_count: 0prices_count: 0@@ -10723,8 +10852,8 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_gbHJdmfrXB- created_at: '2026-06-17T13:37:35.214Z'- updated_at: '2026-06-17T13:37:35.214Z'+ created_at: '2026-06-22T16:56:41.908Z'+ updated_at: '2026-06-22T16:56:41.908Z'- id: price_EfhxLZ9ck8amount: '5.0'amount_in_cents: 500@@ -10735,8 +10864,8 @@ paths:display_compare_at_amount:price_list_id: pl_UkLWZg9DAJvariant_id: variant_gbHJdmfrXB- created_at: '2026-06-17T13:37:35.218Z'- updated_at: '2026-06-17T13:37:35.218Z'+ created_at: '2026-06-22T16:56:41.915Z'+ updated_at: '2026-06-22T16:56:41.915Z'meta:page: 1limit: 25@@ -10818,8 +10947,8 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_EfhxLZ9ck8- created_at: '2026-06-17T13:37:36.160Z'- updated_at: '2026-06-17T13:37:36.160Z'+ created_at: '2026-06-22T16:56:42.550Z'+ updated_at: '2026-06-22T16:56:42.550Z'schema:"$ref": "#/components/schemas/Price"requestBody:@@ -10906,8 +11035,8 @@ paths:display_compare_at_amount:price_list_id: pl_UkLWZg9DAJvariant_id: variant_gbHJdmfrXB- created_at: '2026-06-17T13:37:36.315Z'- updated_at: '2026-06-17T13:37:36.315Z'+ created_at: '2026-06-22T16:56:42.622Z'+ updated_at: '2026-06-22T16:56:42.622Z'schema:"$ref": "#/components/schemas/Price"'404':@@ -10972,8 +11101,8 @@ paths:display_compare_at_amount:price_list_id: pl_UkLWZg9DAJvariant_id: variant_gbHJdmfrXB- created_at: '2026-06-17T13:37:37.132Z'- updated_at: '2026-06-17T13:37:37.438Z'+ created_at: '2026-06-22T16:56:43.288Z'+ updated_at: '2026-06-22T16:56:43.564Z'schema:"$ref": "#/components/schemas/Price"requestBody:@@ -11285,8 +11414,8 @@ paths:field_type: short_textkey: custom.titlevalue: wool- created_at: '2026-06-17T13:37:39.058Z'- updated_at: '2026-06-17T13:37:39.058Z'+ created_at: '2026-06-22T16:56:44.971Z'+ updated_at: '2026-06-22T16:56:44.971Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJmeta:@@ -11356,8 +11485,8 @@ paths:field_type: long_textkey: custom.descriptionvalue: A longer description- created_at: '2026-06-17T13:37:39.692Z'- updated_at: '2026-06-17T13:37:39.692Z'+ created_at: '2026-06-22T16:56:45.562Z'+ updated_at: '2026-06-22T16:56:45.562Z'storefront_visible: truecustom_field_definition_id: cfdef_gbHJdmfrXB'422':@@ -11456,8 +11585,8 @@ paths:field_type: short_textkey: custom.titlevalue: wool- created_at: '2026-06-17T13:37:40.061Z'- updated_at: '2026-06-17T13:37:40.061Z'+ created_at: '2026-06-22T16:56:45.916Z'+ updated_at: '2026-06-22T16:56:45.916Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJpatch:@@ -11521,8 +11650,8 @@ paths:field_type: short_textkey: custom.titlevalue: cotton- created_at: '2026-06-17T13:37:40.389Z'- updated_at: '2026-06-17T13:37:40.671Z'+ created_at: '2026-06-22T16:56:46.225Z'+ updated_at: '2026-06-22T16:56:46.503Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJrequestBody:@@ -11678,8 +11807,8 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 574468- slug: product-574468+ name: Product 572597+ slug: product-572597meta_title:meta_description:meta_keywords:@@ -11689,22 +11818,24 @@ paths:in_stock: falsebackorderable: trueavailable: true- description: Omnis iusto quisquam repellat voluptatem rem porro- reiciendis animi. Officia iure neque consequatur dolorum. Porro- saepe perspiciatis sequi aperiam nam non deserunt libero. Maiores- harum alias nihil illo praesentium. Excepturi modi molestias ullam- similique officiis consequatur. Error minus consequatur perspiciatis- optio molestiae non ratione placeat. Velit perspiciatis hic qui- voluptatum non repudiandae unde quisquam. At vero ea sit necessitatibus- sapiente ullam nostrum. Quae facilis ipsum voluptatum temporibus- sint harum. Veniam odit nam ducimus dolores numquam. Esse aut- architecto velit vitae ratione. Qui laborum eligendi assumenda- quia quasi eum incidunt. In aspernatur nulla exercitationem veniam.- Quia inventore provident quo vel perspiciatis adipisci.+ description: Recusandae mollitia animi sed minima error aliquam+ hic commodi. Magnam cum corrupti eius numquam quibusdam rem odit.+ Alias magni et soluta assumenda. Error eos voluptate assumenda+ ut ducimus. Accusantium totam ratione expedita nihil quod voluptatum+ amet. Maxime maiores itaque iusto magnam consequatur quam odio+ deleniti. Excepturi deleniti delectus explicabo architecto. Commodi+ blanditiis nam tempore est dignissimos dolore. Deserunt praesentium+ repellat unde vero consectetur reiciendis. Iste ducimus totam+ corporis earum quas illum consectetur mollitia. Earum praesentium+ cum rem omnis alias laudantium exercitationem quisquam. Ex illum+ fugiat perspiciatis molestiae itaque dolor. Rerum unde alias fugiat+ cum maxime nostrum tempora. Aliquid nostrum aliquam id voluptas+ similique fuga corrupti porro. Cum cupiditate adipisci numquam+ nam facilis.description_html: |-- Omnis iusto quisquam repellat voluptatem rem porro reiciendis animi. Officia iure neque consequatur dolorum. Porro saepe perspiciatis sequi aperiam nam non deserunt libero. Maiores harum alias nihil illo praesentium. Excepturi modi molestias ullam similique officiis consequatur.- Error minus consequatur perspiciatis optio molestiae non ratione placeat. Velit perspiciatis hic qui voluptatum non repudiandae unde quisquam. At vero ea sit necessitatibus sapiente ullam nostrum. Quae facilis ipsum voluptatum temporibus sint harum. Veniam odit nam ducimus dolores numquam.- Esse aut architecto velit vitae ratione. Qui laborum eligendi assumenda quia quasi eum incidunt. In aspernatur nulla exercitationem veniam. Quia inventore provident quo vel perspiciatis adipisci.+ Recusandae mollitia animi sed minima error aliquam hic commodi. Magnam cum corrupti eius numquam quibusdam rem odit. Alias magni et soluta assumenda. Error eos voluptate assumenda ut ducimus. Accusantium totam ratione expedita nihil quod voluptatum amet.+ Maxime maiores itaque iusto magnam consequatur quam odio deleniti. Excepturi deleniti delectus explicabo architecto. Commodi blanditiis nam tempore est dignissimos dolore. Deserunt praesentium repellat unde vero consectetur reiciendis. Iste ducimus totam corporis earum quas illum consectetur mollitia.+ Earum praesentium cum rem omnis alias laudantium exercitationem quisquam. Ex illum fugiat perspiciatis molestiae itaque dolor. Rerum unde alias fugiat cum maxime nostrum tempora. Aliquid nostrum aliquam id voluptas similique fuga corrupti porro. Cum cupiditate adipisci numquam nam facilis.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -11719,14 +11850,14 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-06-17T13:37:41.022Z'- updated_at: '2026-06-17T13:37:41.022Z'+ created_at: '2026-06-22T16:56:46.842Z'+ updated_at: '2026-06-22T16:56:46.842Z'original_price:status: activemetadata: {}deleted_at:- created_at: '2026-06-17T13:37:41.012Z'- updated_at: '2026-06-17T13:37:41.028Z'+ created_at: '2026-06-22T16:56:46.834Z'+ updated_at: '2026-06-22T16:56:46.847Z'tax_category_id: taxcat_UkLWZg9DAJmeta:page: 1@@ -11858,8 +11989,8 @@ paths:status: draftmetadata: {}deleted_at:- created_at: '2026-06-17T13:37:41.707Z'- updated_at: '2026-06-17T13:37:41.708Z'+ created_at: '2026-06-22T16:56:47.504Z'+ updated_at: '2026-06-22T16:56:47.505Z'tax_category_id:schema:"$ref": "#/components/schemas/Product"@@ -12064,8 +12195,8 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 616894- slug: product-616894+ name: Product 618171+ slug: product-618171meta_title:meta_description:meta_keywords:@@ -12075,20 +12206,15 @@ paths:in_stock: falsebackorderable: trueavailable: true- description: Neque dicta incidunt consequuntur accusamus autem tempore- voluptatum. Ab sapiente doloribus qui expedita. Quam odit blanditiis- ullam tempora. Fugit totam ullam soluta adipisci ipsa dolores. Ipsum- omnis iusto ex facilis esse maiores. Dicta ipsam expedita ut maxime- tenetur consequatur eos incidunt. Id numquam ipsum sequi inventore.- Molestiae dolore explicabo animi numquam. Inventore quod perspiciatis- hic dolores aliquid nesciunt aliquam. Debitis quis modi iste perferendis- odio laborum quasi facere. Minima quidem dolor accusamus tenetur- dolorum vel consequuntur quia. Repellendus beatae modi cumque eligendi- architecto dicta.+ description: Alias quis reiciendis minus cum commodi laboriosam. Aliquam+ harum voluptatum voluptates doloremque. Ullam a repellat ipsam asperiores+ nulla. Culpa omnis unde quidem error dolorum suscipit vitae assumenda.+ Illum debitis et repudiandae voluptas illo amet officia placeat.+ Vero maiores assumenda autem alias voluptatibus libero. Assumenda+ ducimus expedita repellat tenetur. Facere officia quis quos recusandae.description_html: |-- Neque dicta incidunt consequuntur accusamus autem tempore voluptatum. Ab sapiente doloribus qui expedita. Quam odit blanditiis ullam tempora. Fugit totam ullam soluta adipisci ipsa dolores.- Ipsum omnis iusto ex facilis esse maiores. Dicta ipsam expedita ut maxime tenetur consequatur eos incidunt. Id numquam ipsum sequi inventore.- Molestiae dolore explicabo animi numquam. Inventore quod perspiciatis hic dolores aliquid nesciunt aliquam. Debitis quis modi iste perferendis odio laborum quasi facere. Minima quidem dolor accusamus tenetur dolorum vel consequuntur quia. Repellendus beatae modi cumque eligendi architecto dicta.+ Alias quis reiciendis minus cum commodi laboriosam. Aliquam harum voluptatum voluptates doloremque. Ullam a repellat ipsam asperiores nulla.+ Culpa omnis unde quidem error dolorum suscipit vitae assumenda. Illum debitis et repudiandae voluptas illo amet officia placeat. Vero maiores assumenda autem alias voluptatibus libero. Assumenda ducimus expedita repellat tenetur. Facere officia quis quos recusandae.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -12103,14 +12229,14 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-06-17T13:37:42.084Z'- updated_at: '2026-06-17T13:37:42.084Z'+ created_at: '2026-06-22T16:56:47.872Z'+ updated_at: '2026-06-22T16:56:47.872Z'original_price:status: activemetadata: {}deleted_at:- created_at: '2026-06-17T13:37:42.074Z'- updated_at: '2026-06-17T13:37:42.091Z'+ created_at: '2026-06-22T16:56:47.863Z'+ updated_at: '2026-06-22T16:56:47.878Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -12180,7 +12306,7 @@ paths:example:id: prod_UkLWZg9DAJname: Updated Name- slug: product-637278+ slug: product-638834meta_title:meta_description:meta_keywords:@@ -12190,16 +12316,20 @@ paths:in_stock: falsebackorderable: trueavailable: true- description: Voluptate deserunt iure ea pariatur aspernatur. Exercitationem- aspernatur quo quidem sit necessitatibus. Facere eos consectetur- neque voluptatem cupiditate explicabo. Modi optio consectetur ipsa- vero assumenda reiciendis. Itaque quae unde illum reiciendis repellendus- doloremque aperiam. Vitae laboriosam vel consequatur cumque quos- deleniti ratione. Velit dolor illum nesciunt minus. Tenetur molestias- dicta iusto eum soluta. Velit non deserunt quasi eum earum sit commodi.+ description: Modi et similique quidem eum. Assumenda quis exercitationem+ perspiciatis quia tempora et aspernatur iusto. Quisquam cupiditate+ odit quia molestiae ducimus laudantium ipsum. Ipsa distinctio est+ quibusdam repellendus perspiciatis. Animi perferendis eius cumque+ molestiae ipsam. Enim ipsa expedita consectetur dignissimos voluptatem+ nobis laboriosam. Tempore nobis aperiam fugit fuga asperiores officia+ mollitia tempora. Fugit reprehenderit corrupti culpa porro nemo+ incidunt eveniet cum. Nesciunt ipsam aliquid tempora rerum. Beatae+ et molestiae natus animi. Nesciunt corrupti pariatur dolor voluptatibus+ ut architecto. Nesciunt ipsam quas itaque molestiae ex.description_html: |-- Voluptate deserunt iure ea pariatur aspernatur. Exercitationem aspernatur quo quidem sit necessitatibus. Facere eos consectetur neque voluptatem cupiditate explicabo. Modi optio consectetur ipsa vero assumenda reiciendis.- Itaque quae unde illum reiciendis repellendus doloremque aperiam. Vitae laboriosam vel consequatur cumque quos deleniti ratione. Velit dolor illum nesciunt minus. Tenetur molestias dicta iusto eum soluta. Velit non deserunt quasi eum earum sit commodi.+ Modi et similique quidem eum. Assumenda quis exercitationem perspiciatis quia tempora et aspernatur iusto. Quisquam cupiditate odit quia molestiae ducimus laudantium ipsum. Ipsa distinctio est quibusdam repellendus perspiciatis.+ Animi perferendis eius cumque molestiae ipsam. Enim ipsa expedita consectetur dignissimos voluptatem nobis laboriosam. Tempore nobis aperiam fugit fuga asperiores officia mollitia tempora. Fugit reprehenderit corrupti culpa porro nemo incidunt eveniet cum.+ Nesciunt ipsam aliquid tempora rerum. Beatae et molestiae natus animi. Nesciunt corrupti pariatur dolor voluptatibus ut architecto. Nesciunt ipsam quas itaque molestiae ex.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -12214,14 +12344,14 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-06-17T13:37:42.729Z'- updated_at: '2026-06-17T13:37:42.729Z'+ created_at: '2026-06-22T16:56:48.502Z'+ updated_at: '2026-06-22T16:56:48.502Z'original_price:status: activemetadata: {}deleted_at:- created_at: '2026-06-17T13:37:42.719Z'- updated_at: '2026-06-17T13:37:43.018Z'+ created_at: '2026-06-22T16:56:48.494Z'+ updated_at: '2026-06-22T16:56:48.788Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -13046,15 +13176,15 @@ paths:- id: coupon_UkLWZg9DAJcode: AAA111state: unused- created_at: '2026-06-17T13:36:32.336Z'- updated_at: '2026-06-17T13:36:32.336Z'+ created_at: '2026-06-22T16:55:41.301Z'+ updated_at: '2026-06-22T16:55:41.301Z'promotion_id: promo_UkLWZg9DAJorder_id:- id: coupon_gbHJdmfrXBcode: BBB222state: unused- created_at: '2026-06-17T13:36:32.337Z'- updated_at: '2026-06-17T13:36:32.337Z'+ created_at: '2026-06-22T16:55:41.302Z'+ updated_at: '2026-06-22T16:55:41.302Z'promotion_id: promo_UkLWZg9DAJorder_id:meta:@@ -13116,8 +13246,8 @@ paths:example:data:- id: pact_UkLWZg9DAJ- created_at: '2026-06-17T13:37:47.052Z'- updated_at: '2026-06-17T13:37:47.052Z'+ created_at: '2026-06-22T16:56:52.729Z'+ updated_at: '2026-06-22T16:56:52.729Z'type: free_shippingpromotion_id: promo_UkLWZg9DAJpreferences: {}@@ -13181,8 +13311,8 @@ paths:application/json:example:id: pact_UkLWZg9DAJ- created_at: '2026-06-17T13:37:47.613Z'- updated_at: '2026-06-17T13:37:47.613Z'+ created_at: '2026-06-22T16:56:53.291Z'+ updated_at: '2026-06-22T16:56:53.291Z'type: free_shippingpromotion_id: promo_UkLWZg9DAJpreferences: {}@@ -13310,8 +13440,8 @@ paths:example:data:- id: prorule_UkLWZg9DAJ- created_at: '2026-06-17T13:37:48.195Z'- updated_at: '2026-06-17T13:37:48.195Z'+ created_at: '2026-06-22T16:56:53.874Z'+ updated_at: '2026-06-22T16:56:53.874Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -13381,8 +13511,8 @@ paths:application/json:example:id: prorule_UkLWZg9DAJ- created_at: '2026-06-17T13:37:48.759Z'- updated_at: '2026-06-17T13:37:48.759Z'+ created_at: '2026-06-22T16:56:54.433Z'+ updated_at: '2026-06-22T16:56:54.433Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -13473,8 +13603,8 @@ paths:application/json:example:id: prorule_UkLWZg9DAJ- created_at: '2026-06-17T13:37:49.065Z'- updated_at: '2026-06-17T13:37:49.342Z'+ created_at: '2026-06-22T16:56:54.740Z'+ updated_at: '2026-06-22T16:56:55.019Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -13582,7 +13712,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-06-17T13:37:49.636Z'+ starts_at: '2026-06-22T16:56:55.318Z'expires_at:usage_limit:match_policy: all@@ -13593,8 +13723,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-06-17T13:37:49.637Z'- updated_at: '2026-06-17T13:37:49.638Z'+ created_at: '2026-06-22T16:56:55.319Z'+ updated_at: '2026-06-22T16:56:55.320Z'action_ids: []rule_ids: []meta:@@ -13701,7 +13831,7 @@ paths:name: Black Fridaydescription:code: blackfriday-os- starts_at: '2026-06-17T13:37:50.547Z'+ starts_at: '2026-06-22T16:56:56.222Z'expires_at:usage_limit:match_policy: all@@ -13712,8 +13842,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-06-17T13:37:50.548Z'- updated_at: '2026-06-17T13:37:50.567Z'+ created_at: '2026-06-22T16:56:56.223Z'+ updated_at: '2026-06-22T16:56:56.241Z'action_ids:- pact_UkLWZg9DAJ- pact_gbHJdmfrXB@@ -13879,7 +14009,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-06-17T13:37:50.866Z'+ starts_at: '2026-06-22T16:56:56.541Z'expires_at:usage_limit:match_policy: all@@ -13890,8 +14020,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-06-17T13:37:50.867Z'- updated_at: '2026-06-17T13:37:50.868Z'+ created_at: '2026-06-22T16:56:56.542Z'+ updated_at: '2026-06-22T16:56:56.542Z'action_ids: []rule_ids: []patch:@@ -13988,7 +14118,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-06-17T13:37:51.757Z'+ starts_at: '2026-06-22T16:56:57.439Z'expires_at:usage_limit:match_policy: all@@ -13999,8 +14129,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-06-17T13:37:51.758Z'- updated_at: '2026-06-17T13:37:52.035Z'+ created_at: '2026-06-22T16:56:57.440Z'+ updated_at: '2026-06-22T16:56:57.722Z'action_ids: []rule_ids: []requestBody:@@ -14458,14 +14588,14 @@ paths:application/json:example:id: re_UkLWZg9DAJ- transaction_id: BGS-2e19045e798a+ transaction_id: BGS-e18e9804a95camount: '5.0'payment_id: py_UkLWZg9DAJrefund_reason_id: rr_UkLWZg9DAJreimbursement_id:metadata: {}- created_at: '2026-06-17T13:37:19.688Z'- updated_at: '2026-06-17T13:37:19.688Z'+ created_at: '2026-06-22T16:56:27.175Z'+ updated_at: '2026-06-22T16:56:27.175Z'requestBody:content:application/json:@@ -14567,8 +14697,8 @@ paths:data:- id: sccat_UkLWZg9DAJname: Goodwill- created_at: '2026-06-17T13:37:55.505Z'- updated_at: '2026-06-17T13:37:55.505Z'+ created_at: '2026-06-22T16:57:01.171Z'+ updated_at: '2026-06-22T16:57:01.171Z'non_expiring: falsemeta:page: 1@@ -14662,8 +14792,8 @@ paths:example:id: sccat_UkLWZg9DAJname: Goodwill- created_at: '2026-06-17T13:37:55.809Z'- updated_at: '2026-06-17T13:37:55.809Z'+ created_at: '2026-06-22T16:57:01.463Z'+ updated_at: '2026-06-22T16:57:01.463Z'non_expiring: falseschema:"$ref": "#/components/schemas/StoreCreditCategory"@@ -14735,8 +14865,8 @@ paths:preferred_timezone: UTCpreferred_weight_unit: lbpreferred_unit_system: imperial- created_at: '2026-06-17T13:36:22.595Z'- updated_at: '2026-06-17T13:37:56.459Z'+ created_at: '2026-06-22T16:55:31.699Z'+ updated_at: '2026-06-22T16:57:02.048Z'url: http://www.example.com:3000supported_currencies:- USD@@ -14815,8 +14945,8 @@ paths:preferred_timezone: UTCpreferred_weight_unit: lbpreferred_unit_system: imperial- created_at: '2026-06-17T13:36:22.595Z'- updated_at: '2026-06-17T13:37:57.090Z'+ created_at: '2026-06-22T16:55:31.699Z'+ updated_at: '2026-06-22T16:57:02.659Z'url: http://www.example.com:3000supported_currencies:- USD@@ -14975,12 +15105,13 @@ paths:example:data:- id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Charlyn- last_name: Bechtelar- full_name: Charlyn Bechtelar- created_at: '2026-06-17T13:36:22.912Z'- updated_at: '2026-06-17T13:36:22.912Z'+ email: [email protected]+ first_name: Filomena+ last_name: Harvey+ full_name: Filomena Harvey+ selected_locale:+ created_at: '2026-06-22T16:55:32.019Z'+ updated_at: '2026-06-22T16:55:32.019Z'roles:- id: role_UkLWZg9DAJname: admin@@ -15041,12 +15172,13 @@ paths:application/json:example:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Matilda- last_name: Bernier- full_name: Matilda Bernier- created_at: '2026-06-17T13:36:23.243Z'- updated_at: '2026-06-17T13:36:23.243Z'+ email: [email protected]+ first_name: Chantay+ last_name: Hansen+ full_name: Chantay Hansen+ selected_locale:+ created_at: '2026-06-22T16:55:32.354Z'+ updated_at: '2026-06-22T16:55:32.354Z'roles:- id: role_UkLWZg9DAJname: admin@@ -15102,12 +15234,13 @@ paths:application/json:example:id: admin_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Renamed- last_name: Fisher- full_name: Renamed Fisher- created_at: '2026-06-17T13:36:23.521Z'- updated_at: '2026-06-17T13:36:23.537Z'+ last_name: Pagac+ full_name: Renamed Pagac+ selected_locale:+ created_at: '2026-06-22T16:55:32.635Z'+ updated_at: '2026-06-22T16:55:32.651Z'roles:- id: role_UkLWZg9DAJname: admin@@ -15218,15 +15351,15 @@ paths:example:data:- id: inv_UkLWZg9DAJ- email: [email protected]+ email: [email protected]status: pending- created_at: '2026-06-17T13:36:58.221Z'- updated_at: '2026-06-17T13:36:58.221Z'- expires_at: '2026-07-01T13:36:58.218Z'+ created_at: '2026-06-22T16:56:05.746Z'+ updated_at: '2026-06-22T16:56:05.746Z'+ expires_at: '2026-07-06T16:56:05.742Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=uPYrp6FXfYEv9YqQu4Qda1SX"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=DHBJS7JNNN7idaTv6NPaw6kE"invitee_exists: falsestore:id: store_UkLWZg9DAJ@@ -15290,13 +15423,13 @@ paths:id: inv_gbHJdmfrXBemail: [email protected]status: pending- created_at: '2026-06-17T13:36:58.525Z'- updated_at: '2026-06-17T13:36:58.525Z'- expires_at: '2026-07-01T13:36:58.523Z'+ created_at: '2026-06-22T16:56:06.046Z'+ updated_at: '2026-06-22T16:56:06.046Z'+ expires_at: '2026-07-06T16:56:06.044Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=PkdFDAJnpPR85fx8YcMueeJH"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=JevkbteheJKumnMDtpmBHk46"invitee_exists: falsestore:id: store_UkLWZg9DAJ@@ -15409,15 +15542,15 @@ paths:application/json:example:id: inv_UkLWZg9DAJ- email: [email protected]+ email: [email protected]status: pending- created_at: '2026-06-17T13:36:59.077Z'- updated_at: '2026-06-17T13:36:59.077Z'- expires_at: '2026-07-01T13:36:59.075Z'+ created_at: '2026-06-22T16:56:06.600Z'+ updated_at: '2026-06-22T16:56:06.600Z'+ expires_at: '2026-07-06T16:56:06.598Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=3engiVfraa3nnyUDKSED3U6L"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=rB9DeLhDTsb2qQ8xUZmD3GPD"invitee_exists: falsestore:id: store_UkLWZg9DAJ@@ -15469,8 +15602,8 @@ paths:data:- id: role_UkLWZg9DAJname: admin- created_at: '2026-06-17T13:37:52.921Z'- updated_at: '2026-06-17T13:37:52.921Z'+ created_at: '2026-06-22T16:56:58.602Z'+ updated_at: '2026-06-22T16:56:58.602Z'meta:page: 1limit: 25@@ -15608,8 +15741,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes:pickup_instructions:- created_at: '2026-06-17T13:37:53.200Z'- updated_at: '2026-06-17T13:37:53.200Z'+ created_at: '2026-06-22T16:56:58.882Z'+ updated_at: '2026-06-22T16:56:58.882Z'meta:page: 1limit: 25@@ -15723,8 +15856,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes: 30pickup_instructions:- created_at: '2026-06-17T13:37:53.768Z'- updated_at: '2026-06-17T13:37:53.768Z'+ created_at: '2026-06-22T16:56:59.452Z'+ updated_at: '2026-06-22T16:56:59.452Z'schema:"$ref": "#/components/schemas/StockLocation"'422':@@ -15901,8 +16034,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes:pickup_instructions:- created_at: '2026-06-17T13:37:54.076Z'- updated_at: '2026-06-17T13:37:54.076Z'+ created_at: '2026-06-22T16:56:59.758Z'+ updated_at: '2026-06-22T16:56:59.758Z'schema:"$ref": "#/components/schemas/StockLocation"'404':@@ -15991,8 +16124,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes: 45pickup_instructions:- created_at: '2026-06-17T13:37:54.645Z'- updated_at: '2026-06-17T13:37:54.921Z'+ created_at: '2026-06-22T16:57:00.325Z'+ updated_at: '2026-06-22T16:57:00.601Z'schema:"$ref": "#/components/schemas/StockLocation"'422':@@ -16232,13 +16365,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-06-17T13:37:58.576Z'- updated_at: '2026-06-17T13:37:58.595Z'+ created_at: '2026-06-22T16:57:04.053Z'+ updated_at: '2026-06-22T16:57:04.067Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 79901+ product_name: Product 797829- id: variant_gbHJdmfrXBproduct_id: prod_UkLWZg9DAJsku: SKU-98@@ -16249,10 +16382,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 118.43- height: 135.93- width: 23.36- depth: 96.27+ weight: 75.3+ height: 87.8+ width: 71.0+ depth: 171.33price:id: price_gbHJdmfrXBamount: '19.99'@@ -16275,8 +16408,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:58.616Z'- updated_at: '2026-06-17T13:37:58.616Z'+ created_at: '2026-06-22T16:57:04.081Z'+ updated_at: '2026-06-22T16:57:04.081Z'metadata: {}position: 2cost_price: '17.0'@@ -16285,13 +16418,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-06-17T13:37:58.613Z'- updated_at: '2026-06-17T13:37:58.627Z'+ created_at: '2026-06-22T16:57:04.079Z'+ updated_at: '2026-06-22T16:57:04.092Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 79901+ product_name: Product 797829meta:page: 1limit: 25@@ -16403,8 +16536,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:59.375Z'- updated_at: '2026-06-17T13:37:59.375Z'+ created_at: '2026-06-22T16:57:04.716Z'+ updated_at: '2026-06-22T16:57:04.716Z'metadata: {}position: 3cost_price:@@ -16413,13 +16546,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-06-17T13:37:59.380Z'- updated_at: '2026-06-17T13:37:59.383Z'+ created_at: '2026-06-22T16:57:04.720Z'+ updated_at: '2026-06-22T16:57:04.722Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 809039+ product_name: Product 807957'422':description: validation errorcontent:@@ -16607,10 +16740,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 175.34- height: 37.43- width: 97.77- depth: 80.87+ weight: 52.58+ height: 130.57+ width: 30.29+ depth: 186.45price:id: price_gbHJdmfrXBamount: '19.99'@@ -16633,8 +16766,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:37:59.803Z'- updated_at: '2026-06-17T13:37:59.803Z'+ created_at: '2026-06-22T16:57:05.112Z'+ updated_at: '2026-06-22T16:57:05.112Z'metadata: {}position: 2cost_price: '17.0'@@ -16643,13 +16776,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-06-17T13:37:59.800Z'- updated_at: '2026-06-17T13:37:59.819Z'+ created_at: '2026-06-22T16:57:05.109Z'+ updated_at: '2026-06-22T16:57:05.122Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 821549+ product_name: Product 821534'404':description: variant not foundcontent:@@ -16731,10 +16864,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 122.92- height: 99.6- width: 185.0- depth: 9.2+ weight: 100.47+ height: 127.52+ width: 43.16+ depth: 179.89price:id: price_gbHJdmfrXBamount: '19.99'@@ -16757,8 +16890,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-06-17T13:38:00.584Z'- updated_at: '2026-06-17T13:38:00.584Z'+ created_at: '2026-06-22T16:57:05.781Z'+ updated_at: '2026-06-22T16:57:05.781Z'metadata: {}position: 2cost_price: '17.0'@@ -16767,13 +16900,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-06-17T13:38:00.578Z'- updated_at: '2026-06-17T13:38:00.888Z'+ created_at: '2026-06-22T16:57:05.779Z'+ updated_at: '2026-06-22T16:57:06.068Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 84572+ product_name: Product 846935requestBody:content:application/json:@@ -17022,9 +17155,9 @@ paths:event: order.createddata:id: 1- created_at: '2026-06-17T13:38:01.293Z'- updated_at: '2026-06-17T13:38:01.293Z'- delivered_at: '2026-06-17T13:38:01.293Z'+ created_at: '2026-06-22T16:57:06.504Z'+ updated_at: '2026-06-22T16:57:06.504Z'+ delivered_at: '2026-06-22T16:57:06.504Z'webhook_endpoint_id: whe_UkLWZg9DAJwebhook_endpoint_url: https://shop.example.com/webhooks- id: whd_UkLWZg9DAJ@@ -17040,9 +17173,9 @@ paths:event: order.createddata:id: 1- created_at: '2026-06-17T13:38:01.291Z'- updated_at: '2026-06-17T13:38:01.291Z'- delivered_at: '2026-06-17T13:38:01.291Z'+ created_at: '2026-06-22T16:57:06.503Z'+ updated_at: '2026-06-22T16:57:06.503Z'+ delivered_at: '2026-06-22T16:57:06.503Z'webhook_endpoint_id: whe_UkLWZg9DAJwebhook_endpoint_url: https://shop.example.com/webhooksmeta:@@ -17145,9 +17278,9 @@ paths:event: order.createddata:id: 1- created_at: '2026-06-17T13:38:01.931Z'- updated_at: '2026-06-17T13:38:01.931Z'- delivered_at: '2026-06-17T13:38:01.931Z'+ created_at: '2026-06-22T16:57:07.207Z'+ updated_at: '2026-06-22T16:57:07.207Z'+ delivered_at: '2026-06-22T16:57:07.207Z'webhook_endpoint_id: whe_UkLWZg9DAJwebhook_endpoint_url: https://shop.example.com/webhooks'404':@@ -17236,8 +17369,8 @@ paths:event: order.createddata:id: 1- created_at: '2026-06-17T13:38:02.788Z'- updated_at: '2026-06-17T13:38:02.788Z'+ created_at: '2026-06-22T16:57:08.191Z'+ updated_at: '2026-06-22T16:57:08.191Z'delivered_at:webhook_endpoint_id: whe_UkLWZg9DAJwebhook_endpoint_url: https://shop.example.com/webhooks@@ -17336,8 +17469,8 @@ paths:- order.completed- product.createddisabled_reason:- created_at: '2026-06-17T13:38:02.800Z'- updated_at: '2026-06-17T13:38:02.800Z'+ created_at: '2026-06-22T16:57:08.416Z'+ updated_at: '2026-06-22T16:57:08.416Z'disabled_at:secret_key:last_delivery_at:@@ -17432,10 +17565,10 @@ paths:subscriptions:- order.completeddisabled_reason:- created_at: '2026-06-17T13:38:03.392Z'- updated_at: '2026-06-17T13:38:03.392Z'+ created_at: '2026-06-22T16:57:09.506Z'+ updated_at: '2026-06-22T16:57:09.506Z'disabled_at:- secret_key: 7c054d408c1462c74e4e9d738f0f721039ebdc3045b94b41d91d24e18c25867b+ secret_key: ea95d8587de99f6ccc01914e2f3ba5b86425ee0ed4691294ad0df3211b1938e1last_delivery_at:recent_delivery_count: 0recent_failure_count: 0@@ -17558,8 +17691,8 @@ paths:- order.completed- product.createddisabled_reason:- created_at: '2026-06-17T13:38:03.690Z'- updated_at: '2026-06-17T13:38:03.690Z'+ created_at: '2026-06-22T16:57:10.033Z'+ updated_at: '2026-06-22T16:57:10.033Z'disabled_at:secret_key:last_delivery_at:@@ -17638,8 +17771,8 @@ paths:- order.completed- product.createddisabled_reason:- created_at: '2026-06-17T13:38:04.273Z'- updated_at: '2026-06-17T13:38:04.557Z'+ created_at: '2026-06-22T16:57:11.022Z'+ updated_at: '2026-06-22T16:57:11.323Z'disabled_at:secret_key:last_delivery_at:@@ -17797,15 +17930,15 @@ paths:response_body:success:payload:- id: edfe9211-1119-42ea-b6f0-67da040ef805+ id: 7707ab67-f762-4f28-99c8-80e53bc3ad82name: webhook.test- created_at: '2026-06-17T13:38:05Z'+ created_at: '2026-06-22T16:57:12Z'data:message: This is a test webhook from Spree.metadata:- spree_version: 5.5.0.rc2- created_at: '2026-06-17T13:38:05.430Z'- updated_at: '2026-06-17T13:38:05.430Z'+ spree_version: 5.5.0+ created_at: '2026-06-22T16:57:12.940Z'+ updated_at: '2026-06-22T16:57:12.940Z'delivered_at:webhook_endpoint_id: whe_UkLWZg9DAJwebhook_endpoint_url: https://shop.example.com/webhooks/orders@@ -17871,8 +18004,8 @@ paths:- order.completed- product.createddisabled_reason:- created_at: '2026-06-17T13:38:05.440Z'- updated_at: '2026-06-17T13:38:05.716Z'+ created_at: '2026-06-22T16:57:13.150Z'+ updated_at: '2026-06-22T16:57:13.446Z'disabled_at:secret_key:last_delivery_at:@@ -17949,9 +18082,9 @@ paths:- order.completed- product.createddisabled_reason: Investigating- created_at: '2026-06-17T13:38:05.730Z'- updated_at: '2026-06-17T13:38:06.005Z'- disabled_at: '2026-06-17T13:38:06.005Z'+ created_at: '2026-06-22T16:57:13.683Z'+ updated_at: '2026-06-22T16:57:13.997Z'+ disabled_at: '2026-06-22T16:57:13.997Z'secret_key:last_delivery_at:recent_delivery_count: 0@@ -18488,6 +18621,9 @@ components:full_name:type: stringnullable: true+ selected_locale:+ type: string+ nullable: truecreated_at:type: stringupdated_at:@@ -18502,6 +18638,7 @@ components:- first_name- last_name- full_name+ - selected_locale- created_at- updated_at- rolesdiff --git a/packages/admin-sdk/.changeset/admin-self-profile-update.md b/packages/admin-sdk/.changeset/admin-self-profile-update.mdnew file mode 100644index 0000000000..0c57679395--- /dev/null+++ b/packages/admin-sdk/.changeset/admin-self-profile-update.md@@ -0,0 +1,5 @@+---+"@spree/admin-sdk": minor+---++Add self-service profile updates for the authenticated admin. `client.me.update(params)` (`PATCH /me`) lets the signed-in admin change their own `selected_locale` (admin UI display language), `first_name`, and `last_name` without going through the store-scoped staff-management endpoint. The `MeResponse.user` shape now includes `selected_locale`, and a new `MeUpdateParams` type describes the writable fields.diff --git a/packages/admin-sdk/examples/me/update.ts b/packages/admin-sdk/examples/me/update.tsnew file mode 100644index 0000000000..775249f30a--- /dev/null+++ b/packages/admin-sdk/examples/me/update.ts@@ -0,0 +1,16 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+// Set the signed-in admin's own UI display language.+const me = await client.me.update({+ selected_locale: 'de',+})++// endregion:example++export { me }diff --git a/packages/admin-sdk/src/admin-client.ts b/packages/admin-sdk/src/admin-client.tsindex 2ae5a95daa..209d7b476c 100644--- a/packages/admin-sdk/src/admin-client.ts+++ b/packages/admin-sdk/src/admin-client.ts@@ -63,6 +63,7 @@ export interface MeResponse {email: stringfirst_name: string | nulllast_name: string | null+ selected_locale: string | null}permissions: PermissionRule[]}@@ -102,6 +103,7 @@ import type {MarketUpdateParams,MediaCreateParams,MediaUpdateParams,+ MeUpdateParams,OptionTypeCreateParams,OptionTypeUpdateParams,OrderApproveParams,@@ -401,6 +403,10 @@ export class AdminClient {/** Get the current admin user profile and their serialized permissions. */get: (options?: RequestOptions): Promise<MeResponse> =>this.request<MeResponse>('GET', '/me', options),++ /** Update the current admin's own profile (e.g. their UI language). */+ update: (params: MeUpdateParams, options?: RequestOptions): Promise<MeResponse> =>+ this.request<MeResponse>('PATCH', '/me', { ...options, body: params }),}// ============================================diff --git a/packages/admin-sdk/src/params.ts b/packages/admin-sdk/src/params.tsindex 1a01706801..4755dfcd0c 100644--- a/packages/admin-sdk/src/params.ts+++ b/packages/admin-sdk/src/params.ts@@ -531,6 +531,14 @@ export interface AdminUserUpdateParams {role_ids?: string[]}+/** Self-service update of the signed-in admin's own profile (PATCH /me). */+export interface MeUpdateParams {+ /** Admin UI display language code (e.g. `de`). */+ selected_locale?: string+ first_name?: string+ last_name?: string+}+export interface StockLocationCreateParams {name: stringadmin_name?: string | nulldiff --git a/packages/admin-sdk/src/types/generated/AdminUser.ts b/packages/admin-sdk/src/types/generated/AdminUser.tsindex e3fdb2984c..f58a6b5f9a 100644--- a/packages/admin-sdk/src/types/generated/AdminUser.ts+++ b/packages/admin-sdk/src/types/generated/AdminUser.ts@@ -1,4 +1,4 @@-// Typelizer digest d3883b43172cd1d461cd22716869ac2f+// Typelizer digest 1d440ad9e82f7f1a1901abeaa93f3c76//// DO NOT MODIFY: This file was automatically generated by Typelizer.@@ -8,6 +8,7 @@ interface AdminUser {first_name: string | null;last_name: string | null;full_name: string | null;+ selected_locale: string | null;created_at: string;updated_at: string;roles: Array<{ id: string; name: string }>;diff --git a/packages/cli/src/generated/admin-spec.json b/packages/cli/src/generated/admin-spec.jsonindex e1cf7d4cd9..96c9559db3 100644--- a/packages/cli/src/generated/admin-spec.json+++ b/packages/cli/src/generated/admin-spec.json@@ -1 +1 @@-{"info":{"title":"Admin API","contact":{"name":"Spree Commerce","url":"https://spreecommerce.org","email":"[email protected]"},"description":"Spree Admin API v3 - Administrative API for managing products, orders, and store settings.\n\n## Authentication\n\nThe Admin API requires a secret API key passed in the `x-spree-api-key` header.\nSecret API keys can be generated in the Spree admin dashboard.\n\n## Response Format\n\nAll responses are JSON. List endpoints return paginated responses with `data` and `meta` keys.\nSingle resource endpoints return a flat JSON object.\n\n## Resource IDs\n\nEvery resource is identified by an opaque string ID (e.g. `prod_86Rf07xd4z`,\n`variant_k5nR8xLq`, `or_UkLWZg9DAJ`). Use these IDs everywhere — URL paths,\nrequest bodies, and Ransack filters all accept them directly.\n\n## Error Handling\n\nErrors return a consistent format:\n```json\n{\n \"error\": {\n \"code\": \"validation_error\",\n \"message\": \"Validation failed\",\n \"details\": { \"name\": [\"can't be blank\"] }\n }\n}\n```\n","version":"v3"},"paths":{"/api/v3/admin/auth/login":{"post":{"summary":"Login","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Authenticates an admin user and returns a short-lived JWT access token.\nThe rotatable refresh token is set in an HttpOnly cookie — it is not\nincluded in the response body.\n\nThe `provider` field selects the authentication method. When omitted it\ndefaults to `email`, the built-in email/password login.\n\nTo authenticate against a third-party identity provider (Okta, Azure AD,\nGoogle Workspace SSO, a custom JWT issuer, SAML, etc.), send\n`{ \"provider\": \"<your_key>\", ... }` with the fields that provider\nrequires. The endpoint returns the same JWT regardless of which provider\nauthenticated the request. See\n[Custom API Authentication](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication)\nfor the list of configured providers and their required fields.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"login successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"401":{"description":"invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"title":"EmailPasswordLogin","description":"Built-in email/password authentication (default when `provider` is omitted).","type":"object","properties":{"provider":{"type":"string","enum":["email"],"default":"email"},"email":{"type":"string","format":"email"},"password":{"type":"string"}},"required":["email","password"]},{"title":"ProviderLogin","description":"Provider-dispatched login. The `provider` key selects a configured\nauthentication provider; the remaining fields are forwarded to it.\nRequired fields depend on the provider — see\n[Custom API Authentication](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication).\n","type":"object","properties":{"provider":{"type":"string","description":"Registered provider key (anything other than `email`).","not":{"enum":["email"]}}},"required":["provider"],"additionalProperties":true}]}}}}}},"/api/v3/admin/auth/refresh":{"post":{"summary":"Refresh token","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Exchanges the HttpOnly refresh-token cookie for a new access JWT and a\nrotated refresh token cookie. No request body or Authorization header\nis required — the cookie alone authenticates the call.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"refresh successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"401":{"description":"missing or invalid refresh-token cookie","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/auth/logout":{"post":{"summary":"Logout","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Revokes the refresh-token cookie, effectively logging the admin out.","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"logout successful"}}}},"/api/v3/admin/me":{"get":{"summary":"Get current admin user and permissions","tags":["Authentication"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the current admin user profile and a serialized list of permissions (CanCanCan rules). The SPA uses these to drive UI permission checks.","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"current admin user and permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/allowed_origins":{"get":{"summary":"List allowed origins","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the CORS allowlist for the current store. Each entry is a\nbare `scheme://host[:port]` permitted to call the admin API from a\nbrowser. Backs the `Rack::Cors` allowlist and the CSRF boundary of\nthe admin cookie session (see\n`docs/plans/5.5-admin-auth-cookie-refresh.md`).\n\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[origin_cont]","in":"query","required":false,"description":"Filter by origin (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"allowed origins found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AllowedOrigin"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds an origin to the admin CORS allowlist. The value must be a bare\n`scheme://host[:port]` (no path, query, or fragment) and use `http` or\n`https`.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"allowed origin created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllowedOrigin"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"}},"required":["origin"]}}}}}},"/api/v3/admin/allowed_origins/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Allowed origin ID","schema":{"type":"string"}}],"get":{"summary":"Get an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single allowed origin by prefixed ID.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"allowed origin found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllowedOrigin"}}}},"404":{"description":"allowed origin not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an existing allowed origin.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"allowed origin updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllowedOrigin"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"}}}}}}},"delete":{"summary":"Delete an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes an origin from the admin CORS allowlist. After deletion the\nadmin SPA running at that origin will no longer be able to call the\nadmin API from a browser.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"204":{"description":"allowed origin deleted"}}}},"/api/v3/admin/api_keys":{"get":{"summary":"List API keys","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns publishable and secret API keys for the current store. Secret keys are listed by `token_prefix` only — the plaintext token is delivered exactly once on create.\n\n**Required scope:** `read_api_keys` (for API-key authentication).","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":"API keys found","content":{"application/json":{}}}}},"post":{"summary":"Create an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a publishable or secret API key. The plaintext token is included in the response **once** for secret keys; publishable keys expose their token on every read since they are intended for client-side use.\n\n**Required scope:** `write_api_keys` (for API-key authentication).","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":"secret key created — plaintext token returned once","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name","key_type"],"properties":{"name":{"type":"string"},"key_type":{"type":"string","enum":["publishable","secret"]},"scopes":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/api_keys/{id}":{"get":{"summary":"Show an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"API key found","content":{"application/json":{}}}}},"patch":{"summary":"Update an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Renames a key. `key_type` and `scopes` are fixed at creation — to change a key's authority, create a new key and revoke the old one.\n\n**Required scope:** `write_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"API key renamed","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}}}}}}},"delete":{"summary":"Delete an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"API key deleted"}}}},"/api/v3/admin/api_keys/current":{"get":{"summary":"Describe the current API key","tags":["API Keys"],"security":[{"api_key":[]}],"description":"Returns the secret key that authenticated this request, including its live scopes. Useful to confirm a key's real, current authority. Only secret-key principals have a single key to describe.\n\n**Required scope:** none — any key can describe itself (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"current API key","content":{"application/json":{}}}}}},"/api/v3/admin/api_keys/{id}/revoke":{"patch":{"summary":"Revoke an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Marks the key revoked. Future requests using its token will fail; the row is preserved for audit.\n\n**Required scope:** `write_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"API key revoked","content":{"application/json":{}}}}}},"/api/v3/admin/channels":{"get":{"summary":"List channels","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the channels configured for the current store.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"channels found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new channel on the current store. `code` is normalized to a\nURL-safe slug (`Point of Sale` → `point-of-sale`); when omitted it's\nderived from `name`.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":"channel created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"code":{"type":"string","description":"Slug — auto-derived from `name` when blank."},"active":{"type":"boolean","default":true}}}}}}}},"/api/v3/admin/channels/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","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":"channel found","content":{"application/json":{}}}}},"patch":{"summary":"Update a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","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":"channel updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","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":"channel deleted"}}}},"/api/v3/admin/channels/{id}/add_products":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"Publish products on a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Publishes the listed products on this channel. Idempotent — re-publishing\nan already-published product updates its publication window. Products from\nsibling stores are silently dropped.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products published","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["product_ids"],"properties":{"product_ids":{"type":"array","items":{"type":"string"}},"published_at":{"type":"string","format":"date-time","nullable":true,"description":"When the publications go live. `null` means immediately."},"unpublished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the publications come down. `null` means never."}}}}}}}},"/api/v3/admin/channels/{id}/remove_products":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"Unpublish products from a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Unpublishes the listed products from this channel.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products unpublished","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["product_ids"],"properties":{"product_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/custom_field_definitions":{"get":{"summary":"List custom field definitions","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all defined custom fields. Filter by `?q[resource_type_eq]=Spree::Product` to narrow to one parent type.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,label,field_type). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"definitions returned","content":{"application/json":{}}}}},"post":{"summary":"Create a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","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":"definition created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["key","field_type","resource_type"],"properties":{"namespace":{"type":"string","description":"Defaults to `custom`"},"key":{"type":"string"},"label":{"type":"string","description":"Human-readable name; defaults to titleized `key`"},"field_type":{"type":"string","description":"Custom field type identifier (one of the registered field-type class names)."},"resource_type":{"type":"string","description":"Owner class, e.g. `Spree::Product`"},"storefront_visible":{"type":"boolean","description":"When false, definition is admin-only (was `display_on: back_end`)"}}}}}}}},"/api/v3/admin/custom_field_definitions/{id}":{"get":{"summary":"Show a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,label,field_type). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"definition found","content":{"application/json":{}}}}},"patch":{"summary":"Update a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"definition updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string"},"storefront_visible":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes the definition and cascades to all custom field values referencing it.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"definition deleted"}}}},"/api/v3/admin/customer_groups":{"get":{"summary":"List customer groups","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the customer groups configured for the current store. Groups\nsegment customers for targeted promotions (see the `customer_group`\npromotion rule) and reporting. The list endpoint never embeds the\nmember list — fetch a single group with `?expand=customers` if you\nneed them inline, or query `/admin/customers?customer_group_id_in=…`\nfor paginated membership.\n\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customer groups found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a customer group in the current store. `customer_ids` is\noptional; when present, customers are attached at create time.\nPass prefixed IDs (e.g. `cus_…`) — the server decodes them\nautomatically.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer group created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerGroup"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"customer_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customer_groups/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Customer group prefixed ID","schema":{"type":"string"}}],"get":{"summary":"Get a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single customer group. Pass `?expand=customers` to embed\nthe full member list inline (recommended only for single-record\nreads — embed cost scales with membership size).\n\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `customers`.","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customer group with embedded customers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerGroup"}}}},"404":{"description":"customer group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates name, description, or membership. `customer_ids` is a\nfull-set replacement — the server reconciles the membership to\nmatch the array, adding new IDs and removing ones not present.\nSend `customer_ids: []` to clear all members.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer group updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerGroup"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"customer_ids":{"type":"array","items":{"type":"string"}}}}}}}},"delete":{"summary":"Delete a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the group. Member users are not deleted; their `customer_group_users` rows are dropped.\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer group deleted"}}}},"/api/v3/admin/customers/{customer_id}/addresses":{"get":{"summary":"List customer addresses","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the customer's saved addresses.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., country, state). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., first_name,last_name,address1,city). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"addresses found","content":{"application/json":{}}}}},"post":{"summary":"Create a customer address","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new address to the customer's address book. Pass `is_default_billing: true` or `is_default_shipping: true` to set as the default — the previous default loses its flag in the same transaction.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"address created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"},"country_iso":{"type":"string","description":"ISO-2 country code (e.g. US)"},"state_abbr":{"type":"string","description":"State/province abbreviation (e.g. NY)"},"phone":{"type":"string"},"company":{"type":"string"},"label":{"type":"string"},"is_default_billing":{"type":"boolean"},"is_default_shipping":{"type":"boolean"}}}}}}}},"/api/v3/admin/customers/{customer_id}/addresses/{id}":{"patch":{"summary":"Update a customer address","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a customer address.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"address updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string"},"is_default_billing":{"type":"boolean"},"is_default_shipping":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a customer address","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes the address. If it was a default, the customer loses that default (no auto-promotion).\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"address deleted"}}}},"/api/v3/admin/customers/{customer_id}/credit_cards":{"get":{"summary":"List customer credit cards","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the customer's saved credit cards. Useful for off-session admin charges via `POST /admin/orders/:id/payments { source_id }`.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., brand,last4,month,year). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"credit cards found","content":{"application/json":{}}}}}},"/api/v3/admin/customers/{customer_id}/credit_cards/{id}":{"get":{"summary":"Show a customer credit card","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a saved credit card by ID.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., brand,last4,month,year). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"credit card found","content":{"application/json":{}}}}},"delete":{"summary":"Delete a customer credit card","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a saved credit card.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"credit card deleted"}}}},"/api/v3/admin/customers/{customer_id}/store_credits":{"get":{"summary":"List customer store credits","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns store credits issued to the customer.\n\n**Required scope:** `read_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., category, store, created_by). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,amount_used,memo,currency). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"store credits found","content":{"application/json":{}}}}},"post":{"summary":"Issue a store credit to a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"`created_by` is set automatically from the authenticated admin.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"store credit created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount","currency","category_id"],"properties":{"amount":{"type":"string"},"currency":{"type":"string"},"category_id":{"type":"string","description":"StoreCreditCategory ID"},"memo":{"type":"string"}}}}}}}},"/api/v3/admin/customers/{customer_id}/store_credits/{id}":{"patch":{"summary":"Update a store credit","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Update memo / category / amount. The amount can only be changed if `amount_used == 0`.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"store credit updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string"},"category_id":{"type":"string"},"memo":{"type":"string"}}}}}}},"delete":{"summary":"Delete a store credit","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes an unused store credit (amount_used == 0). Returns 422 otherwise.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"store credit deleted"}}}},"/api/v3/admin/customers":{"get":{"summary":"List customers","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of customers. Supports Ransack search/filters.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[search]","in":"query","required":false,"description":"Email + name full-text-ish search","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., addresses, store_credits). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., email,first_name,last_name). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customers found","content":{"application/json":{}}}}},"post":{"summary":"Create a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a customer. No welcome email is sent automatically.\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"accepts_email_marketing":{"type":"boolean"},"internal_note":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"}}}}}}}},"/api/v3/admin/customers/{id}":{"get":{"summary":"Show a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns full customer details including computed order stats (orders_count, total_spent, last_order_completed_at).\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Customer ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations: addresses, orders, store_credits, default_billing_address, default_shipping_address","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., email,first_name,last_name). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customer found","content":{"application/json":{}}}}},"patch":{"summary":"Update a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates customer attributes. `tags` replaces the full set.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"customer updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"accepts_email_marketing":{"type":"boolean"},"internal_note":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"}}}}}}},"delete":{"summary":"Delete a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a customer. Returns 422 if the customer has any orders.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"customer deleted"}}}},"/api/v3/admin/customers/bulk_add_to_groups":{"post":{"summary":"Bulk-add customers to groups","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Attaches each customer in `ids` to every group in `customer_group_ids`.\nIdempotent — customers already in a group are skipped server-side.\nGroups from sibling stores are silently ignored. Returns counts of\ncustomers and groups that were processed (post store-scoping).\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customers added to groups","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"customer_group_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","customer_group_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"customer_group_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customers/bulk_remove_from_groups":{"post":{"summary":"Bulk-remove customers from groups","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Detaches each customer in `ids` from every group in `customer_group_ids`.\nNo-op for non-members. Groups from sibling stores are silently ignored.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customers removed from groups","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"customer_group_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","customer_group_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"customer_group_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customers/bulk_add_tags":{"post":{"summary":"Bulk-add tags to customers","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds each tag name in `tags` to every customer in `ids`. Tags are\nupserted by name; re-adding an existing tag is a no-op.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"tags added","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"tag_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customers/bulk_remove_tags":{"post":{"summary":"Bulk-remove tags from customers","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes each tag name in `tags` from every customer in `ids`. No-op\nfor customers that don't carry the tag.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"tags removed","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"tag_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/exports":{"get":{"summary":"List exports","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns CSV exports queued or completed for the current store. Polled by the admin SPA to detect when an export finishes (`done: true`).\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","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":"exports found","content":{"application/json":{}}}}},"post":{"summary":"Create an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Queues a CSV export. The `type` selects the dataset; `search_params` is an\noptional Ransack query (same shape used by the `q[...]` params on list endpoints)\nthat filters which records are exported. Pass `record_selection: \"all\"` to\nclear the filter server-side and export everything in scope.\n\nGeneration is asynchronous. Poll `GET /admin/exports/{id}` until `done` is `true`,\nthen redirect the browser to `download_url` to fetch the file.\n\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","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":"export queued","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["Spree::Exports::Products","Spree::Exports::Orders","Spree::Exports::Customers","Spree::Exports::ProductTranslations","Spree::Exports::GiftCards","Spree::Exports::CouponCodes","Spree::Exports::NewsletterSubscribers"]},"record_selection":{"type":"string","enum":["filtered","all"],"description":"Set to \"all\" to ignore search_params and export everything in scope."},"search_params":{"type":"object","description":"Ransack query hash. Same predicates accepted by the list endpoint.","additionalProperties":true}}}}}}}},"/api/v3/admin/exports/{id}":{"get":{"summary":"Show an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns export status. While `done` is `false`, the SPA continues polling.\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"export found","content":{"application/json":{}}}}},"delete":{"summary":"Delete an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the export and purges its attachment.\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"export deleted"}}}},"/api/v3/admin/exports/{id}/download":{"get":{"summary":"Download an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Streams the exported CSV with `Content-Disposition: attachment`. Returns 422 with `code: export_not_ready` while `done` is still `false`. The endpoint is JWT/API-key protected, so SPA clients must fetch it (with `Authorization` header) and trigger the browser download via a Blob URL — a top-level navigation cannot carry the JWT.\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"CSV file","content":{"application/json":{},"text/csv":{"schema":{"type":"string","format":"binary"}}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments":{"get":{"summary":"List fulfillments","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all shipments for an order.\n\n**Required scope:** `read_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., inventory_units, stock_location, shipping_rates). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,status,tracking,cost). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillments found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}":{"get":{"summary":"Show a shipment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns details of a specific shipment.\n\n**Required scope:** `read_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., inventory_units, stock_location, shipping_rates). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,status,tracking,cost). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"shipment found","content":{"application/json":{}}}}},"patch":{"summary":"Update a shipment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a shipment (tracking, shipping rate).\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"shipment updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tracking":{"type":"string"},"selected_shipping_rate_id":{"type":"string"}}}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/fulfill":{"patch":{"summary":"Fulfill a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Marks a fulfillment as fulfilled.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment fulfilled","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":{"patch":{"summary":"Cancel a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Cancels a fulfillment.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment canceled","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":{"patch":{"summary":"Resume a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Resumes a canceled fulfillment.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment resumed","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":{"patch":{"summary":"Split a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Transfers items from this shipment to a new shipment at a different stock location.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment split","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["variant_id","quantity"],"properties":{"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer"},"stock_location_id":{"type":"string","description":"Target stock location ID"}}}}}}}},"/api/v3/admin/gift_card_batches":{"get":{"summary":"List gift card batches","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the gift card batches issued by the current store. Each batch\ngroups the cards generated together for a campaign or bulk-issuance\n— the cards themselves live under `/admin/gift_cards` and reference\nthe batch via `gift_card_batch_id`.\n\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Records per page","schema":{"type":"integer"}},{"name":"q[prefix_cont]","in":"query","required":false,"description":"Filter by prefix (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending.","schema":{"type":"string"}}],"responses":{"200":{"description":"gift card batches found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GiftCardBatch"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a gift card batch","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Issues a batch of gift cards in a single call. The server generates\n`codes_count` cards inline for small batches (configurable via\n`Spree.config.gift_card_batch_web_limit`, default 500) or enqueues\na background job for larger ones. Each card's code is the batch\n`prefix` followed by random hex.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card batch created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCardBatch"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["prefix","amount","codes_count"],"properties":{"prefix":{"type":"string","description":"Lowercased and prepended to every generated code."},"amount":{"type":"string","description":"Decimal amount per card, greater than zero."},"currency":{"type":"string","description":"ISO 4217 currency code. Defaults to the store currency."},"codes_count":{"type":"integer","description":"Number of cards to generate. Capped at `gift_card_batch_limit`."},"expires_at":{"type":"string","nullable":true}}}}}}}},"/api/v3/admin/gift_card_batches/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Gift card batch prefixed ID","schema":{"type":"string"}}],"get":{"summary":"Get a gift card batch","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single batch.\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","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":"gift card batch found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCardBatch"}}}},"404":{"description":"gift card batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/gift_cards":{"get":{"summary":"List gift cards","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the gift cards issued by the current store. Filter by\n`q[code_cont]` for code search, `q[user_id_eq]` for cards issued\nto a specific customer, or `q[state_eq]` for status filtering.\n\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[code_cont]","in":"query","required":false,"description":"Filter by gift card code (contains)","schema":{"type":"string"}},{"name":"q[state_eq]","in":"query","required":false,"description":"Filter by status (active, redeemed, partially_redeemed, canceled)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"gift cards found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GiftCard"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Issues a gift card scoped to the current store. The code is\nauto-generated when omitted. `currency` defaults to the store's\nconfigured currency. Pass `user_id` (prefixed ID) to attach the\ncard to a specific customer.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCard"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"string","description":"Decimal amount, greater than zero."},"currency":{"type":"string","description":"ISO 4217 currency code. Defaults to the store currency."},"code":{"type":"string","description":"Optional caller-supplied code. Auto-generated when omitted."},"expires_at":{"type":"string","description":"ISO 8601 date.","nullable":true},"user_id":{"type":"string","description":"Optional customer prefixed ID.","nullable":true}}}}}}}},"/api/v3/admin/gift_cards/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Gift card prefixed ID","schema":{"type":"string"}}],"get":{"summary":"Get a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single gift card.\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"gift card found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCard"}}}},"404":{"description":"gift card not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an active gift card's editable attributes. Redeemed or\npartially-redeemed cards cannot be edited.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCard"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string"},"expires_at":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true}}}}}}},"delete":{"summary":"Delete a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes an unused gift card. Cards that have been redeemed or\npartially redeemed cannot be deleted and return 422.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card deleted"},"422":{"description":"redeemed gift card cannot be deleted","content":{"application/json":{}}}}}},"/api/v3/admin/markets":{"get":{"summary":"List markets","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the markets configured for the current store. Markets are\nstore-scoped and ordered by `position` (an `acts_as_list` column —\nupdate the order via `PATCH /markets/{id}` with `position`).\n\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `countries`.","schema":{"type":"string"}}],"responses":{"200":{"description":"markets found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Market"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a market","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new market for the current store.\n\n- `country_isos` accepts 2-letter ISO country codes (e.g. `[\"DE\", \"FR\"]`);\n the market must contain at least one country. Unknown codes are\n silently dropped.\n- `supported_locales` accepts an array of locale codes; the\n `default_locale` is always implicitly included.\n- Setting `default: true` automatically demotes the previous default\n market in the store.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":{"schema":{"$ref":"#/components/schemas/Market"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"currency":{"type":"string","description":"ISO 4217 currency code."},"default_locale":{"type":"string","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."},"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."}},"required":["name","currency","default_locale","country_isos"]}}}}}},"/api/v3/admin/markets/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a market","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"market found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Market"}}}},"404":{"description":"market not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a market","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an existing market. Pass `country_isos` to replace the\nmarket's country list (full-set update), `supported_locales` to\nreplace the supported locales, or `position` to reorder the market\nwithin the store.\n\nSetting `default: true` automatically demotes the previous default.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":{"schema":{"$ref":"#/components/schemas/Market"}}}},"422":{"description":"validation error","content":{"application/json":{"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":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the market (sets `deleted_at`). The default market and\nthe last remaining market in a store cannot be deleted — both return\n422 with a `validation_error`.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":{}}}}}},"/api/v3/admin/option_types":{"get":{"summary":"List option types","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of option types.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,label,position). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"option types found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OptionType"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new option type. Supports nested option values.\n\nOption values can be provided inline and will be created or updated by name.\n\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"option type created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionType"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"},"filterable":{"type":"boolean"},"option_values":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"}}}}},"required":["name","label"]}}}}}},"/api/v3/admin/option_types/{id}":{"get":{"summary":"Get an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single option type by ID, including its option values.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Option type ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,label,position). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"option type found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionType"}}}},"404":{"description":"option type not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an option type. Supports updating nested option values.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Option type ID","schema":{"type":"string"}}],"responses":{"200":{"description":"option type updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionType"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"},"filterable":{"type":"boolean"},"option_values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Existing option value ID to update"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"}}}}}}}}}},"delete":{"summary":"Delete an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes an option type.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Option type ID","schema":{"type":"string"}}],"responses":{"204":{"description":"option type deleted"}}}},"/api/v3/admin/orders/{order_id}/gift_cards":{"post":{"summary":"Apply a gift card to an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Applies a gift card by code to the order. Returns the gift card.\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"gift card applied","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Gift card code"}}}}}}}},"/api/v3/admin/orders/{order_id}/gift_cards/{id}":{"delete":{"summary":"Remove a gift card from an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the gift card from the order.\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Gift card ID","schema":{"type":"string"}}],"responses":{"204":{"description":"gift card removed"}}}},"/api/v3/admin/orders/{order_id}/items":{"get":{"summary":"List order items","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all line items for an order.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variant, variant.product). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., quantity,price,total). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"items found","content":{"application/json":{}}}}},"post":{"summary":"Add an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new line item to the order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"item added","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["variant_id"],"properties":{"variant_id":{"type":"string","description":"Prefixed variant ID"},"quantity":{"type":"integer","default":1}}}}}}}},"/api/v3/admin/orders/{order_id}/items/{id}":{"get":{"summary":"Show an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns details of a specific line item.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Item ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variant, variant.product). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., quantity,price,total). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"item found","content":{"application/json":{}}}}},"patch":{"summary":"Update an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an order item quantity or metadata.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Item ID","schema":{"type":"string"}}],"responses":{"200":{"description":"item updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"quantity":{"type":"integer"}}}}}}},"delete":{"summary":"Remove an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes an item from the order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Item ID","schema":{"type":"string"}}],"responses":{"204":{"description":"line item removed"}}}},"/api/v3/admin/orders/{order_id}/store_credits":{"post":{"summary":"Apply customer's store credit to an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Applies the order customer's available store credit. When `amount` is omitted, applies up to the order outstanding balance.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"store credit applied","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string","description":"Optional explicit amount; defaults to order outstanding balance"}}}}}}},"delete":{"summary":"Remove store credit from an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes any applied store credit from the order.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"204":{"description":"store credit removed"}}}},"/api/v3/admin/orders":{"get":{"summary":"List orders","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of orders for the current store.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"sort","in":"query","required":false,"description":"Sort field (e.g., created_at, -created_at, completed_at)","schema":{"type":"string"}},{"name":"q[state_eq]","in":"query","required":false,"description":"Filter by state (cart, address, delivery, payment, confirm, complete, canceled)","schema":{"type":"string"}},{"name":"q[email_cont]","in":"query","required":false,"description":"Filter by email (contains)","schema":{"type":"string"}},{"name":"q[number_eq]","in":"query","required":false,"description":"Filter by order number","schema":{"type":"string"}},{"name":"q[completed_at_gt]","in":"query","required":false,"description":"Filter by completed after date","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., items, fulfillments, payments, customer, discounts, billing_address, shipping_address). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,total,status,completed_at). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"orders found","content":{"application/json":{}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a draft order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new draft order in one shot. Customer, items, addresses, currency,\nmarket, channel, locale, notes, metadata, and a coupon code can all be\nprovided inline.\n\nSetting `preferred_stock_location_id` pins the order's preferred fulfillment\nlocation — Order Routing's built-in `PreferredLocation` rule consumes it\nwhen picking which stock location ships each shipment.\n\nInvalid coupon codes are non-fatal — the order is created and the failure\nis reported on the service result (not in the API response body for now).\n\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"order created with preferred_stock_location_id","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"customer_id":{"type":"string","description":"Customer ID. Alias: user_id (legacy)."},"use_customer_default_address":{"type":"boolean","description":"When true with customer_id, copies the customer's saved billing/shipping addresses onto the order."},"currency":{"type":"string"},"market_id":{"type":"string","description":"Market ID"},"channel_id":{"type":"string","description":"Channel ID. Defaults to the store primary channel when omitted."},"preferred_stock_location_id":{"type":"string","description":"Stock Location ID to prefer for fulfillment. Order Routing's built-in PreferredLocation rule reads this and ranks the location first; routing falls back to the next rule when the preferred location can't cover the cart."},"locale":{"type":"string"},"customer_note":{"type":"string","description":"Public, customer-visible note"},"internal_note":{"type":"string","description":"Staff-only note"},"metadata":{"type":"object","description":"Arbitrary key/value metadata"},"shipping_address":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"shipping_address_id":{"type":"string","description":"Existing customer address ID"},"billing_address":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"billing_address_id":{"type":"string","description":"Existing customer address ID"},"items":{"type":"array","items":{"type":"object","required":["variant_id","quantity"],"properties":{"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer"},"metadata":{"type":"object"}}}},"coupon_code":{"type":"string","description":"Optional. Applied non-fatally; invalid codes do not block creation."}}}}}}}},"/api/v3/admin/orders/{id}":{"get":{"summary":"Show an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns full order details including admin-only fields.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID (e.g., or_xxx)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., items, fulfillments, payments, customer, discounts, billing_address, shipping_address). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,total,status,completed_at). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"order found","content":{"application/json":{}}},"404":{"description":"order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an order. Supports updating email, addresses, special instructions, and line items.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"special_instructions":{"type":"string"},"internal_note":{"type":"string"},"channel_id":{"type":"string","description":"Channel ID"},"preferred_stock_location_id":{"type":"string","description":"Stock Location ID to prefer for fulfillment. Re-runs Order Routing's PreferredLocation rule on subsequent shipment rebuilds."},"ship_address":{"type":"object","properties":{"firstname":{"type":"string"},"lastname":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"zipcode":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"bill_address":{"type":"object","properties":{"firstname":{"type":"string"},"lastname":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"zipcode":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"items":{"type":"array","items":{"type":"object","required":["variant_id"],"properties":{"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer"},"metadata":{"type":"object"}}}}}}}}}},"delete":{"summary":"Delete a draft order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a draft order. Completed orders cannot be deleted.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"204":{"description":"order deleted"}}}},"/api/v3/admin/orders/{id}/complete":{"patch":{"summary":"Complete an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Completes an order in the `confirm` state, marking it as placed.\n\nSet `notify_customer: true` to send the order confirmation email.\n\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order completed","content":{"application/json":{}}},"422":{"description":"order cannot be completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"notify_customer":{"type":"boolean","description":"Send the order confirmation email after completion."}}}}}}}},"/api/v3/admin/orders/{id}/cancel":{"patch":{"summary":"Cancel an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Cancels a completed order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order canceled","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{id}/approve":{"patch":{"summary":"Approve an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Approves an order (e.g., for fraud review).\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order approved","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{id}/resume":{"patch":{"summary":"Resume a canceled order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Resumes a previously canceled order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order resumed","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{id}/resend_confirmation":{"post":{"summary":"Resend confirmation email","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Publishes the order.completed event to trigger confirmation email delivery.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"confirmation resent","content":{"application/json":{}}}}}},"/api/v3/admin/payment_methods":{"get":{"summary":"List payment methods","tags":["Payment Methods"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the store's configured payment methods. Use `source_required: true` to know which methods need a saved source.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,type,active). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payment methods found","content":{"application/json":{}}}}}},"/api/v3/admin/payment_methods/types":{"get":{"summary":"List available payment provider types","tags":["Payment Methods"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the registered Spree::PaymentMethod subclasses that can be used to create new payment methods. Useful for populating a \"Provider\" dropdown in admin UIs.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"provider types found","content":{"application/json":{}}}}}},"/api/v3/admin/payment_methods/{id}":{"get":{"summary":"Show a payment method","tags":["Payment Methods"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a payment method by ID.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,type,active). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payment method found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/payments":{"get":{"summary":"List payments","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all payments for an order.\n\n**Required scope:** `read_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method, source). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,status,number,response_code). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payments found","content":{"application/json":{}}}}},"post":{"summary":"Create a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new payment for the order.\n\n**Required scope:** `write_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"payment created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["payment_method_id"],"properties":{"payment_method_id":{"type":"string","description":"Payment method ID"},"amount":{"type":"string"},"source_id":{"type":"string","description":"Payment source ID"}}}}}}}},"/api/v3/admin/orders/{order_id}/payments/{id}":{"get":{"summary":"Show a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns details of a specific payment.\n\n**Required scope:** `read_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Payment ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method, source). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,status,number,response_code). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payment found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/payments/{id}/capture":{"patch":{"summary":"Capture a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Captures a pending payment.\n\n**Required scope:** `write_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Payment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"payment captured","content":{"application/json":{}}},"422":{"description":"capture failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/orders/{order_id}/payments/{id}/void":{"patch":{"summary":"Void a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Voids a payment.\n\n**Required scope:** `write_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Payment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"payment voided","content":{"application/json":{}}}}}},"/api/v3/admin/price_lists":{"get":{"summary":"List price lists","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the price lists configured for the current store.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"schema":{"type":"string"}},{"name":"q[status_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `price_rules`.","schema":{"type":"string"}}],"responses":{"200":{"description":"price lists found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PriceList"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new draft price list.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list created (server-to-server — rules + prices, no product_ids)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true},"ends_at":{"type":"string","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"position":{"type":"integer"},"product_ids":{"type":"array","items":{"type":"string"},"description":"Prefixed product ids to seed the list with."},"rules":{"type":"array","description":"STI-typed price rules to attach on create. Existing rules on the same payload via PATCH reconcile by id.","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"prices":{"type":"array","description":"Server-to-server alternative to `product_ids`: ship the exact per-variant prices the list should contain. Each row upserts on the unique key `(variant_id, currency, price_list_id)`. Mix-and-match with `product_ids` is supported but typically unnecessary — `prices` alone tells the server which variants belong to the list and what the override amount is.","items":{"type":"object","required":["variant_id","currency"],"properties":{"variant_id":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}}}}}},"/api/v3/admin/price_lists/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"price list found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}},"404":{"description":"price list not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a price list. The optional `rules:` array reconciles nested\nSTI-typed price rules in a single round-trip — existing rules update\nby `id`, new rules build, missing rules destroy. Mirrors the\npromotion editor's \"save the whole thing on Save\" pattern.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list updated with nested rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true},"ends_at":{"type":"string","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"position":{"type":"integer"},"product_ids":{"type":"array","items":{"type":"string"},"description":"Prefixed product ids — reconciles list membership (adds + removes)."},"rules":{"type":"array","items":{"type":"object","required":["type"],"properties":{"id":{"type":"string","nullable":true},"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"prices":{"type":"array","description":"Individual price overrides (the spreadsheet payload). Each row updates by `id` if shipped, otherwise upserts on the unique key `(variant_id, currency, price_list_id)`.","items":{"type":"object","oneOf":[{"required":["id"]},{"required":["variant_id","currency"]}],"properties":{"id":{"type":"string"},"variant_id":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}}}}},"delete":{"summary":"Delete a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the price list. Associated prices are removed asynchronously.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list deleted"}}}},"/api/v3/admin/price_lists/{id}/activate":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Activate a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Transitions a draft / inactive list to `active`. If `starts_at` is\nin the future the list is marked `scheduled` instead, matching the\nlegacy admin behaviour.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list activated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}}}}},"/api/v3/admin/price_lists/{id}/deactivate":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Deactivate a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_products` (for API-key authentication).","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":"price list deactivated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}}}}},"/api/v3/admin/prices":{"get":{"summary":"List prices","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Generic prices endpoint covering both base prices and price-list\noverrides. Filter with Ransack: `q[price_list_id_eq]=…`,\n`q[currency_eq]=USD`, `q[price_list_id_null]=true` (base prices only).\n\nThe admin spreadsheet uses this with server-side pagination so it\nscales past the metadata-PATCH path on `/price_lists/:id`.\n\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[price_list_id_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"q[price_list_id_null]","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"q[currency_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"q[variant_id_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Comma-separated sort keys. Supports e.g. `variant_product_name,variant_id`.","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `variant`.","schema":{"type":"string"}}],"responses":{"200":{"description":"prices found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a single price. Omit `price_list_id` to create a base price.\nFor more than a handful of rows, prefer `POST /admin/prices/bulk_upsert`.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["variant_id","currency"],"properties":{"variant_id":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true},"price_list_id":{"type":"string","nullable":true}}}}}}}},"/api/v3/admin/prices/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_products` (for API-key authentication).","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":"price found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}},"404":{"description":"price not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_products` (for API-key authentication).","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":"price updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}},"delete":{"summary":"Delete a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the price (acts_as_paranoid).\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price deleted"}}}},"/api/v3/admin/prices/bulk_upsert":{"post":{"summary":"Bulk-upsert prices","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Upserts a batch of prices in a single SQL round trip.\n\nEach row either:\n* targets an existing price by `id`, OR\n* matches on the unique key `(variant_id, currency, price_list_id)` —\n updating the existing row if one exists, creating one otherwise.\n\nModel callbacks (e.g. PriceHistory) are bypassed; this is a\nbulk-write fast path for the admin spreadsheet. The response\ncarries `price_count` — the number of rows touched.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"prices upserted","content":{"application/json":{"schema":{"type":"object","properties":{"price_count":{"type":"integer"}}}}}},"422":{"description":"missing prices key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["prices"],"properties":{"prices":{"type":"array","items":{"type":"object","required":["variant_id","currency"],"properties":{"id":{"type":"string","nullable":true},"variant_id":{"type":"string"},"currency":{"type":"string"},"price_list_id":{"type":"string","nullable":true},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}}}}}},"/api/v3/admin/prices/bulk_destroy":{"delete":{"summary":"Bulk-delete prices","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes each price in `ids`. Returns the count actually destroyed.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"prices deleted","content":{"application/json":{"schema":{"type":"object","properties":{"price_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/{product_id}/custom_fields":{"get":{"summary":"List product custom fields","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the product's custom field values.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., custom_field_definition). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,value,namespace). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"custom fields found","content":{"application/json":{}}}}},"post":{"summary":"Create a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Sets a custom field value on the product. Requires an existing CustomFieldDefinition; pass its prefixed `cfdef_…` id.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"custom field created","content":{"application/json":{}}},"422":{"description":"duplicate definition for the same product","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["custom_field_definition_id","value"],"properties":{"custom_field_definition_id":{"type":"string","description":"Prefixed `cfdef_…` id"},"value":{"description":"Value matching the definition's `field_type`"}}}}}}}},"/api/v3/admin/products/{product_id}/custom_fields/{id}":{"get":{"summary":"Show a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., custom_field_definition). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,value,namespace). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"custom field found","content":{"application/json":{}}}}},"patch":{"summary":"Update a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates the custom field's `value`. The linked definition cannot be changed — delete and recreate to switch.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"custom field updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["value"],"properties":{"value":{"description":"New value"}}}}}}},"delete":{"summary":"Delete a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"custom field deleted"}}}},"/api/v3/admin/products":{"get":{"summary":"List products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of products for the current store.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"sort","in":"query","required":false,"description":"Sort field (e.g., name, -name, price, -price, best_selling)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variants, media, option_types, categories). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,slug,price,status). id is always included.","schema":{"type":"string"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"q[status_eq]","in":"query","required":false,"description":"Filter by status","schema":{"type":"string"}}],"responses":{"200":{"description":"products found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new product. Supports nested variants with prices and option types.\n\nOption types and values are auto-created if they don't exist.\nPrices are upserted by currency. Stock items are upserted by stock location.\n\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"product created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"tax_category_id":{"type":"string","description":"Tax category ID"},"category_ids":{"type":"array","items":{"type":"string"},"description":"Array of category IDs"},"tags":{"type":"array","items":{"type":"string"}},"prices":{"type":"array","description":"Shorthand for a simple (no-options) product: per-currency prices that forward to the product's sole variant. For products with options, set prices per variant under `variants:` instead.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"variants":{"type":"array","description":"Array of variant payloads. Variants can declare multiple option pairs via `options:` and per-currency prices via `prices:`. Stock counts go in `stock_items:` (per stock location).","items":{"type":"object","properties":{"sku":{"type":"string"},"options":{"type":"array","description":"One pair per option type the variant participates in (e.g. size + color). Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}},"required":["name"]}}}}}},"/api/v3/admin/products/{id}":{"get":{"summary":"Get a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single product by ID.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID (e.g., prod_xxx)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variants, media, option_types, categories). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,slug,price,status). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"product found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"404":{"description":"product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a product. Only provided fields are updated.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"200":{"description":"product updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"tax_category_id":{"type":"string","description":"Tax category ID"},"category_ids":{"type":"array","items":{"type":"string"},"description":"Array of category IDs"},"tags":{"type":"array","items":{"type":"string"}},"prices":{"type":"array","description":"Shorthand for a simple (no-options) product: per-currency prices that forward to the product's sole variant. For products with options, set prices per variant under `variants:` instead.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"variants":{"type":"array","description":"Array of variant payloads. Variants can declare multiple option pairs via `options:` and per-currency prices via `prices:`. Stock counts go in `stock_items:` (per stock location).","items":{"type":"object","properties":{"sku":{"type":"string"},"options":{"type":"array","description":"One pair per option type the variant participates in (e.g. size + color). Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}}}}}}},"delete":{"summary":"Delete a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes a product.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product deleted"}}}},"/api/v3/admin/products/bulk_status_update":{"post":{"summary":"Bulk-update product status","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Sets `status` on each product in `ids`. Reindexes the affected products\nfor search. Cross-store IDs are silently dropped. Returns counts.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"cross-store products silently dropped","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"status":{"type":"string"}}}}}},"422":{"description":"invalid status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","status"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["draft","active","archived"]}}}}}}}},"/api/v3/admin/products/bulk_add_to_categories":{"post":{"summary":"Bulk-add products to categories","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Attaches each product in `ids` to every category (taxon) in `category_ids`.\nCategories from sibling stores are silently ignored.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products added to categories","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"category_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","category_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_from_categories":{"post":{"summary":"Bulk-remove products from categories","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Detaches each product in `ids` from every category in `category_ids`.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products removed from categories","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","category_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_add_to_channels":{"post":{"summary":"Bulk-add products to channels","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Publishes each product in `ids` on every channel in `channel_ids`. Idempotent —\nre-publishing on an existing channel is a no-op. Channels from sibling stores\nare silently ignored.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products published on channels","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"channel_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","channel_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"channel_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_from_channels":{"post":{"summary":"Bulk-remove products from channels","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Unpublishes each product in `ids` from every channel in `channel_ids`.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products unpublished from channels","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"channel_count":{"type":"integer"},"removed":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","channel_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"channel_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_add_tags":{"post":{"summary":"Bulk-add tags to products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds each tag name in `tags` to every product in `ids`. Tags are upserted by name.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"tags added","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"tag_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_tags":{"post":{"summary":"Bulk-remove tags from products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes each tag in `tags` from every product in `ids`.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"tags removed","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_destroy":{"delete":{"summary":"Bulk-delete products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes each product in `ids`. Returns the count actually destroyed.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products deleted","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/promotions/{promotion_id}/coupon_codes":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List coupon codes for a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the auto-generated coupon codes for a multi-code promotion. Single-code promotions store the code on the promotion itself; this endpoint returns an empty list for them.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"coupon codes found","content":{"application/json":{}}}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_actions":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List actions for a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_promotions` (for API-key authentication).","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":"actions found","content":{"application/json":{}}}}},"post":{"summary":"Create an action on a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new action to a promotion. The `type` is the wire shorthand from `GET /promotion_actions/types` (e.g. `free_shipping`, `create_item_adjustments`). Fully-qualified Ruby class names are also accepted for backward compatibility.\n\n**Required scope:** `write_promotions` (for API-key authentication).","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":"action created","content":{"application/json":{}}},"422":{"description":"unknown action type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}},"required":["type"]}}}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_actions/{id}":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"delete":{"summary":"Delete an action from a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","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":"action deleted"}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_rules":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List rules for a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_promotions` (for API-key authentication).","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":"rules found","content":{"application/json":{}}}}},"post":{"summary":"Create a rule on a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new rule to a promotion. The `type` is the wire shorthand from `GET /promotion_rules/types` (e.g. `currency`, `item_total`, `product`). Fully-qualified Ruby class names are also accepted for backward compatibility.\n\n**Required scope:** `write_promotions` (for API-key authentication).","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":"rule created with preferences","content":{"application/json":{}}},"422":{"description":"unknown rule type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}},"required":["type"]}}}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_rules/{id}":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Update a rule's preferences","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","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":"rule updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"preferences":{"type":"object","additionalProperties":true}}}}}}},"delete":{"summary":"Delete a rule from a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","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":"rule deleted"}}}},"/api/v3/admin/promotions":{"get":{"summary":"List promotions","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the store's promotions, including manual coupon and automatic promotions.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"promotions found","content":{"application/json":{}}}}},"post":{"summary":"Create a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new promotion. `code` is required for single-code coupon promotions;\npass `multi_codes: true` with `number_of_codes` to auto-generate a batch.\n\nRules and actions can be created in the same request by passing arrays of\n`{ type, preferences, ... }` rows. The server reconciles to the desired set:\nnew rows are built, existing rows (by `id`) are updated, omitted rows are removed.\n\n\n**Required scope:** `write_promotions` (for API-key authentication).","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":"promotion created with rules and actions","content":{"application/json":{}}},"422":{"description":"invalid params","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"starts_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"usage_limit":{"type":"integer","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"kind":{"type":"string","enum":["coupon_code","automatic"]},"multi_codes":{"type":"boolean"},"number_of_codes":{"type":"integer","nullable":true},"code_prefix":{"type":"string","nullable":true},"promotion_category_id":{"type":"string","nullable":true},"rules":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"product_ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}},"customer_ids":{"type":"array","items":{"type":"string"}}},"required":["type"]}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"calculator":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"required":["type"]}}},"required":["name"]}}}}}},"/api/v3/admin/promotions/{id}":{"get":{"summary":"Show a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_promotions` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"promotion found","content":{"application/json":{}}}}},"patch":{"summary":"Update a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a promotion. The `rules` and `actions` arrays are treated as\na *desired set* — rows with `id` update in place, rows without `id` are\nbuilt fresh, and any existing row not present in the array is destroyed.\nPass `rules: []` or `actions: []` to clear them.\n\n\n**Required scope:** `write_promotions` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"rules and actions cleared with empty arrays","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"starts_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"usage_limit":{"type":"integer","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"kind":{"type":"string","enum":["coupon_code","automatic"]},"promotion_category_id":{"type":"string","nullable":true},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Pass to update an existing rule; omit to build a new one"},"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"product_ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}},"customer_ids":{"type":"array","items":{"type":"string"}}},"required":["type"]}},"actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","nullable":true},"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"calculator":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"required":["type"]}}}}}}}},"delete":{"summary":"Delete a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"promotion deleted"}}}},"/api/v3/admin/promotion_actions/types":{"get":{"summary":"List available promotion action types","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the registered Spree::PromotionAction subclasses with their preference schemas. Used by admin UIs to populate the \"Add action\" picker and render generic preference forms.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"action types found","content":{"application/json":{}}}}}},"/api/v3/admin/promotion_rules/types":{"get":{"summary":"List available promotion rule types","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the registered Spree::PromotionRule subclasses with their preference schemas.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"rule types found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/refunds":{"get":{"summary":"List refunds","tags":["Refunds"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all refunds for an order.\n\n**Required scope:** `read_refunds` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment, refund_reason). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,reason,transaction_id). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"refunds found","content":{"application/json":{}}}}},"post":{"summary":"Create a refund","tags":["Refunds"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a refund for a payment on the order. The refund is automatically processed via the payment gateway.\n\n**Required scope:** `write_refunds` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"refund created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["payment_id","amount"],"properties":{"payment_id":{"type":"string","description":"Payment ID"},"amount":{"type":"string"},"refund_reason_id":{"type":"string","description":"Refund reason ID"}}}}}}}},"/api/v3/admin/store_credit_categories":{"get":{"summary":"List store credit categories","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the configured store credit categories. Categories classify\nstore credits (e.g., \"Goodwill\", \"Gift Card\", \"Refund\") and surface\nin the admin UI as a dropdown when issuing or editing a store\ncredit. Category names matching `Spree::Config[:non_expiring_credit_types]`\nare flagged via `non_expiring: true`.\n\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"store credit categories found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StoreCreditCategory"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/store_credit_categories/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Store credit category ID","schema":{"type":"string"}}],"get":{"summary":"Get a store credit category","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single store credit category by prefixed ID.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"store credit category found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCreditCategory"}}}},"404":{"description":"store credit category not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/store":{"get":{"summary":"Get the current store","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the current store configuration. The store is resolved from the request context (host or admin selection); there is no `id` parameter.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"current store","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Store"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update the current store","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates the current store configuration.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"store updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Store"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"preferred_admin_locale":{"type":"string"},"preferred_timezone":{"type":"string"},"preferred_weight_unit":{"type":"string"},"preferred_unit_system":{"type":"string"}}}}}}}},"/api/v3/admin/tags":{"get":{"summary":"List tags","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns tag names for a given taggable type. Used for autocomplete in tag inputs on products, orders, and customers.","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"taggable_type","in":"query","required":true,"description":"Taggable type (`Spree::Product`, `Spree::Order`, or `Spree::User`)","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Optional case-insensitive substring filter","schema":{"type":"string"}}],"responses":{"200":{"description":"tags found","content":{"application/json":{}}},"422":{"description":"invalid taggable type","content":{"application/json":{}}}}}},"/api/v3/admin/admin_users":{"get":{"summary":"List staff","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns admin users with at least one role assignment on the current store.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"staff found","content":{"application/json":{}}}}}},"/api/v3/admin/admin_users/{id}":{"get":{"summary":"Show a staff member","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"staff member found","content":{"application/json":{}}}}},"patch":{"summary":"Update a staff member","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates name fields and reassigns roles for the current store. `role_ids` is a complete replacement — roles not in the array are removed for this store.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"staff member updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"role_ids":{"type":"array","items":{"type":"string"}}}}}}}},"delete":{"summary":"Remove a staff member from this store","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the user's role assignments on the current store. The account is preserved — the user keeps access to any other stores.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"staff removed from store"}}}},"/api/v3/admin/invitations":{"get":{"summary":"List invitations","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns invitations for the current store, including pending and accepted.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"invitations found","content":{"application/json":{}}}}},"post":{"summary":"Create an invitation","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Invites a teammate by email. The invitation is scoped to the current store and carries the chosen role; on accept, a `RoleUser` is created via the invitation's `after_accept` callback.\n\n**Required scope:** `write_settings` (for API-key authentication).","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":"invitation created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email","role_id"],"properties":{"email":{"type":"string"},"role_id":{"type":"string"}}}}}}}},"/api/v3/admin/invitations/{id}":{"delete":{"summary":"Revoke an invitation","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"invitation revoked"}}}},"/api/v3/admin/invitations/{id}/resend":{"patch":{"summary":"Resend an invitation","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Issues a fresh token and dispatches the invitation email again.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"invitation resent","content":{"application/json":{}}}}}},"/api/v3/admin/roles":{"get":{"summary":"List roles","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the roles available for staff role pickers. Roles are global, not per-store.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"roles found","content":{"application/json":{}}}}}},"/api/v3/admin/stock_locations":{"get":{"summary":"List stock locations","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the configured stock locations. Stock locations are global\n(shared across stores). Filter with Ransack predicates such as\n`q[active_eq]`, `q[kind_eq]`, `q[pickup_enabled_eq]`, or\n`q[name_cont]`.\n\nPickup-related attributes (`kind`, `pickup_enabled`,\n`pickup_stock_policy`, `pickup_ready_in_minutes`,\n`pickup_instructions`) drive merchant pickup support at checkout —\ncustomers can collect orders from any active location with\n`pickup_enabled: true`.\n\n\n**Required scope:** `read_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"q[active_eq]","in":"query","required":false,"description":"Filter by active status","schema":{"type":"boolean"}},{"name":"q[kind_eq]","in":"query","required":false,"description":"Filter by kind (built-in: 'warehouse', 'store', 'fulfillment_center')","schema":{"type":"string"}},{"name":"q[pickup_enabled_eq]","in":"query","required":false,"description":"Filter by pickup-enabled flag","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"stock locations found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StockLocation"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new stock location.\n\nSetting `default: true` automatically demotes the previous default\nlocation.\n\n\n**Required scope:** `write_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"stock location created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLocation"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"admin_name":{"type":"string","nullable":true,"description":"Internal name shown only in the admin"},"active":{"type":"boolean"},"default":{"type":"boolean","description":"Setting to true demotes the previous default."},"kind":{"type":"string","enum":["warehouse","store","fulfillment_center"],"description":"Categorizes the location."},"propagate_all_variants":{"type":"boolean"},"backorderable_default":{"type":"boolean"},"address1":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true,"description":"ISO-3166 alpha-2 country code (e.g. \"US\")."},"state_abbr":{"type":"string","nullable":true,"description":"State / province abbreviation (e.g. \"NY\"). Resolved against the selected country."},"state_name":{"type":"string","nullable":true,"description":"Free-text state for countries without a states list."},"pickup_enabled":{"type":"boolean"},"pickup_stock_policy":{"type":"string","enum":["local","any"],"description":"'local' = items at this location only; 'any' = transfer-eligible (ship-to-store)."},"pickup_ready_in_minutes":{"type":"number","nullable":true,"minimum":0},"pickup_instructions":{"type":"string","nullable":true}},"required":["name"]}}}}}},"/api/v3/admin/stock_locations/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Stock location ID","schema":{"type":"string"}}],"get":{"summary":"Get a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single stock location by prefixed ID.\n\n**Required scope:** `read_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"stock location found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLocation"}}}},"404":{"description":"stock location not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an existing stock location. Same address-field conventions as\nthe create endpoint.\n\nSetting `default: true` automatically demotes the previous default.\n\n\n**Required scope:** `write_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"stock location updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLocation"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"admin_name":{"type":"string","nullable":true},"active":{"type":"boolean"},"default":{"type":"boolean"},"kind":{"type":"string","enum":["warehouse","store","fulfillment_center"]},"propagate_all_variants":{"type":"boolean"},"backorderable_default":{"type":"boolean"},"address1":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true},"state_abbr":{"type":"string","nullable":true},"state_name":{"type":"string","nullable":true},"pickup_enabled":{"type":"boolean"},"pickup_stock_policy":{"type":"string","enum":["local","any"]},"pickup_ready_in_minutes":{"type":"number","nullable":true,"minimum":0},"pickup_instructions":{"type":"string","nullable":true}}}}}}},"delete":{"summary":"Delete a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the stock location (sets `deleted_at`). Existing\nfulfillments that referenced it keep the historical record via\n`Spree::StockLocation.with_deleted`.\n\n\n**Required scope:** `write_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"204":{"description":"stock location deleted"}}}},"/api/v3/admin/products/{product_id}/variants":{"get":{"summary":"List product variants","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of variants for a product, including the master variant.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., images, prices, stock_items, option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., sku,price,stock). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"variants found","content":{"application/json":{}}}}},"post":{"summary":"Create a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new variant for a product. Supports nested prices and stock items.\n\nOption types and values are auto-created if they don't exist.\nPrices are upserted by currency. Stock items are upserted by stock location.\n\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"201":{"description":"variant created","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"price":{"type":"string"},"compare_at_price":{"type":"string"},"cost_price":{"type":"string"},"cost_currency":{"type":"string"},"weight":{"type":"number"},"height":{"type":"number"},"width":{"type":"number"},"depth":{"type":"number"},"weight_unit":{"type":"string"},"dimensions_unit":{"type":"string"},"track_inventory":{"type":"boolean"},"tax_category_id":{"type":"string"},"options":{"type":"array","description":"One pair per option type the variant participates in (e.g. size + color). Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"position":{"type":"integer"},"barcode":{"type":"string"},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}}}}},"/api/v3/admin/products/{product_id}/variants/{id}":{"get":{"summary":"Get a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single variant by ID.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Variant ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., images, prices, stock_items, option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., sku,price,stock). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"variant found","content":{"application/json":{}}},"404":{"description":"variant not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a variant. Only provided fields are updated.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Variant ID","schema":{"type":"string"}}],"responses":{"200":{"description":"variant updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"price":{"type":"string"},"compare_at_price":{"type":"string"},"cost_price":{"type":"string"},"cost_currency":{"type":"string"},"weight":{"type":"number"},"height":{"type":"number"},"width":{"type":"number"},"depth":{"type":"number"},"weight_unit":{"type":"string"},"dimensions_unit":{"type":"string"},"track_inventory":{"type":"boolean"},"tax_category_id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"total_on_hand":{"type":"integer"},"position":{"type":"integer"},"barcode":{"type":"string"},"prices":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}},"required":["currency","amount"]}},"stock_items":{"type":"array","items":{"type":"object","properties":{"stock_location_id":{"type":"string"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}}}},"delete":{"summary":"Delete a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes a variant.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Variant ID","schema":{"type":"string"}}],"responses":{"204":{"description":"variant deleted"}}}},"/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries":{"parameters":[{"name":"webhook_endpoint_id","in":"path","required":true,"description":"Parent webhook endpoint ID","schema":{"type":"string"}}],"get":{"summary":"List webhook deliveries","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns delivery attempts for the given endpoint, most recent first.\nEach row carries the original request payload, the response code\n(when the receiver replied), the execution time, and any transport\nerror — everything needed to audit failures and decide whether to\nredeliver.\n\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[event_name_eq]","in":"query","required":false,"description":"Filter by event name (exact)","schema":{"type":"string"}},{"name":"q[success_eq]","in":"query","required":false,"description":"Filter by success flag","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-delivered_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"deliveries found","content":{"application/json":{}}},"404":{"description":"parent webhook endpoint not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}":{"parameters":[{"name":"webhook_endpoint_id","in":"path","required":true,"description":"Parent webhook endpoint ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Webhook delivery ID","schema":{"type":"string"}}],"get":{"summary":"Get a webhook delivery","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single delivery attempt with the full request payload and\nthe response body the receiver returned. Use this for ad-hoc debug\nof failed deliveries.\n\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"delivery found","content":{"application/json":{}}},"404":{"description":"delivery not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}/redeliver":{"parameters":[{"name":"webhook_endpoint_id","in":"path","required":true,"description":"Parent webhook endpoint ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Webhook delivery ID to redeliver","schema":{"type":"string"}}],"post":{"summary":"Redeliver a webhook delivery","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new delivery row with the same payload + event_name and\nqueues it. The original row is preserved for audit history.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"redelivery queued","content":{"application/json":{}}}}}},"/api/v3/admin/webhook_endpoints":{"get":{"summary":"List webhook endpoints","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns outbound webhook subscriptions for the current store. Each\nendpoint receives a signed POST when any subscribed event fires.\n`secret_key` is `null` on list reads — the plaintext is delivered\nexactly once on create.\n\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"q[url_cont]","in":"query","required":false,"description":"Filter by URL (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoints found","content":{"application/json":{}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new outbound webhook subscription. The plaintext\n`secret_key` is returned **once** in this response — persist it\nimmediately to verify incoming webhook signatures. Subsequent reads\nreturn `null` for the secret. Pass an empty `subscriptions` array or\nomit it to receive every event.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"webhook endpoint created — secret_key returned once","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"name":{"type":"string"},"url":{"type":"string"},"active":{"type":"boolean"},"subscriptions":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/webhook_endpoints/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"get":{"summary":"Get a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single webhook endpoint by prefixed ID.\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint found","content":{"application/json":{}}},"404":{"description":"webhook endpoint not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates name, URL, active flag, or the event subscription list.\nToggling `active` here is equivalent to calling `disable`/`enable`\nwithout an audit reason.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint updated","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"active":{"type":"boolean"},"subscriptions":{"type":"array","items":{"type":"string"}}}}}}}},"delete":{"summary":"Delete a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the endpoint and stops future deliveries.\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"204":{"description":"webhook endpoint deleted"}}}},"/api/v3/admin/webhook_endpoints/{id}/send_test":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"post":{"summary":"Send a test delivery","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a `webhook.test` delivery record and queues it. Use this to\nverify the endpoint is reachable and your signature verification\naccepts Spree's payloads.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"test delivery queued","content":{"application/json":{}}}}}},"/api/v3/admin/webhook_endpoints/{id}/enable":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"patch":{"summary":"Re-enable a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Re-enables an endpoint that was manually or automatically disabled.\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint enabled","content":{"application/json":{}}}}}},"/api/v3/admin/webhook_endpoints/{id}/disable":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"patch":{"summary":"Disable a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Manually pauses an endpoint. Unlike auto-disable (triggered after\nrepeated delivery failures), no notification email is sent.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint disabled","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}}}}}}}}},"components":{"schemas":{"PaginationMeta":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"count":{"type":"integer","description":"Total number of records"},"pages":{"type":"integer","description":"Total number of pages"},"from":{"type":"integer","description":"Index of first record on this page"},"to":{"type":"integer","description":"Index of last record on this page"},"in":{"type":"integer","description":"Number of records on this page"},"previous":{"type":"integer","nullable":true,"description":"Previous page number"},"next":{"type":"integer","nullable":true,"description":"Next page number"}},"required":["page","limit","count","pages","from","to","in"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","description":"Field-specific validation errors","nullable":true}},"required":["code","message"]}},"required":["error"]},"AuthResponse":{"type":"object","properties":{"token":{"type":"string","description":"JWT access token"},"user":{"$ref":"#/components/schemas/AdminUser"}},"required":["token","user"]},"PermissionRule":{"type":"object","description":"A single permission rule (CanCanCan rule). Rules are applied in order, last-matching-wins.","properties":{"allow":{"type":"boolean","description":"true for `can`, false for `cannot`"},"actions":{"type":"array","items":{"type":"string"},"description":"Action names, e.g. [\"read\", \"update\"] or [\"manage\"]"},"subjects":{"type":"array","items":{"type":"string"},"description":"Subject class names, e.g. [\"Spree::Product\"] or [\"all\"]"},"has_conditions":{"type":"boolean","description":"True if the server-side rule has per-record conditions. The SPA shows the action optimistically and handles 403 from the API."}},"required":["allow","actions","subjects","has_conditions"]},"MeResponse":{"type":"object","description":"Current admin user profile and serialized permissions","properties":{"user":{"$ref":"#/components/schemas/AdminUser"},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/PermissionRule"}}},"required":["user","permissions"]},"CheckoutRequirement":{"type":"object","properties":{"step":{"type":"string","description":"Checkout step this requirement belongs to"},"field":{"type":"string","description":"Field that needs to be satisfied"},"message":{"type":"string","description":"Human-readable requirement message"}},"required":["step","field","message"]},"CartWarning":{"type":"object","description":"A warning about a cart issue (e.g., item removed due to stock change)","properties":{"code":{"type":"string","description":"Machine-readable warning code"},"message":{"type":"string","description":"Human-readable warning message"},"line_item_id":{"type":"string","nullable":true,"description":"Prefixed line item ID (when applicable)"},"variant_id":{"type":"string","nullable":true,"description":"Prefixed variant ID (when applicable)"}},"required":["code","message"]},"FulfillmentManifestItem":{"type":"object","description":"An item within a fulfillment — which line item and how many units are in this fulfillment","properties":{"item_id":{"type":"string","description":"Line item ID"},"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer","description":"Quantity in this fulfillment"}},"required":["item_id","variant_id","quantity"]},"AdminUserRoleAssignment":{"type":"object","description":"A role assignment for the current store on a staff member","properties":{"id":{"type":"string","description":"Prefixed role ID"},"name":{"type":"string","description":"Role name"}},"required":["id","name"]},"PreferenceField":{"type":"object","description":"A single configurable preference on a payment method, promotion rule/action, or calculator. The frontend uses `type` + `default` to render a sensible input.","properties":{"key":{"type":"string"},"type":{"type":"string","description":"string | text | password | integer | decimal | boolean | array | hash"},"default":{"description":"Default value (any JSON type), null when there is no default","nullable":true}},"required":["key","type"]},"PromotionActionCalculator":{"type":"object","description":"The action's nested calculator (when the action carries one — null for actions like `free_shipping`)","properties":{"type":{"type":"string","description":"Wire shorthand for the calculator subclass"},"label":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}}},"required":["type","label","preferences","preference_schema"]},"PromotionActionLineItem":{"type":"object","description":"One row in a `create_line_items` action — the variant added to the order and how many","properties":{"variant_id":{"type":"string"},"quantity":{"type":"integer"}},"required":["variant_id","quantity"]},"Address":{"type":"object","properties":{"id":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"full_name":{"type":"string"},"address1":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"postal_code":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"country_name":{"type":"string"},"country_iso":{"type":"string"},"state_text":{"type":"string","nullable":true},"state_abbr":{"type":"string","nullable":true},"quick_checkout":{"type":"boolean"},"is_default_billing":{"type":"boolean"},"is_default_shipping":{"type":"boolean"},"state_name":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customer_id":{"type":"string","nullable":true}},"required":["id","first_name","last_name","full_name","address1","address2","postal_code","city","phone","company","country_name","country_iso","state_text","state_abbr","quick_checkout","is_default_billing","is_default_shipping","state_name","label","metadata","created_at","updated_at","customer_id"],"x-typelizer":true},"Adjustment":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"display_amount":{"type":"string"},"included":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"amount":{"type":"string"},"order_id":{"type":"string","nullable":true}},"required":["id","label","display_amount","included","created_at","updated_at","amount","order_id"],"x-typelizer":true},"AdminUser":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"full_name":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserRoleAssignment"}}},"required":["id","email","first_name","last_name","full_name","created_at","updated_at","roles"],"x-typelizer":true},"AllowedOrigin":{"type":"object","properties":{"id":{"type":"string"},"origin":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","origin","created_at","updated_at"],"x-typelizer":true},"ApiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_type":{"type":"string"},"token_prefix":{"type":"string","nullable":true},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"revoked_at":{"type":"string","nullable":true},"last_used_at":{"type":"string","nullable":true},"plaintext_token":{"type":"string","nullable":true},"created_by_email":{"type":"string","nullable":true}},"required":["id","name","key_type","token_prefix","scopes","created_at","updated_at","revoked_at","last_used_at","plaintext_token","created_by_email"],"x-typelizer":true},"Category":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"permalink":{"type":"string"},"position":{"type":"number"},"depth":{"type":"number"},"meta_title":{"type":"string","nullable":true},"meta_description":{"type":"string","nullable":true},"meta_keywords":{"type":"string","nullable":true},"children_count":{"type":"number"},"parent_id":{"type":"string","nullable":true},"description":{"type":"string"},"description_html":{"type":"string"},"image_url":{"type":"string","nullable":true},"square_image_url":{"type":"string","nullable":true},"is_root":{"type":"boolean"},"is_child":{"type":"boolean"},"is_leaf":{"type":"boolean"},"parent":{"$ref":"#/components/schemas/Category"},"children":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"ancestors":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"metadata":{"type":"object"},"pretty_name":{"type":"string"},"lft":{"type":"number"},"rgt":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","permalink","position","depth","meta_title","meta_description","meta_keywords","children_count","parent_id","description","description_html","image_url","square_image_url","is_root","is_child","is_leaf","metadata","pretty_name","lft","rgt","created_at","updated_at"],"x-typelizer":true},"Channel":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"},"default":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","code","active","default","preferred_order_routing_strategy","created_at","updated_at"],"x-typelizer":true},"Country":{"type":"object","properties":{"iso":{"type":"string"},"iso3":{"type":"string"},"name":{"type":"string"},"states_required":{"type":"boolean"},"zipcode_required":{"type":"boolean"},"states":{"type":"array","items":{"$ref":"#/components/schemas/State"}},"market":{"allOf":[{"$ref":"#/components/schemas/Market"}],"nullable":true},"created_at":{"type":"object"},"updated_at":{"type":"object"}},"required":["iso","iso3","name","states_required","zipcode_required","created_at","updated_at"],"x-typelizer":true},"CouponCode":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"state":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"promotion_id":{"type":"string"},"order_id":{"type":"string","nullable":true}},"required":["id","code","state","created_at","updated_at","promotion_id","order_id"],"x-typelizer":true},"CreditCard":{"type":"object","properties":{"id":{"type":"string"},"brand":{"type":"string"},"last4":{"type":"string"},"month":{"type":"number"},"year":{"type":"number"},"name":{"type":"string","nullable":true},"default":{"type":"boolean"},"gateway_payment_profile_id":{"type":"string","nullable":true},"customer_id":{"type":"string","nullable":true},"payment_method_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","brand","last4","month","year","name","default","gateway_payment_profile_id","customer_id","payment_method_id","metadata","created_at","updated_at"],"x-typelizer":true},"CustomFieldDefinition":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"key":{"type":"string"},"label":{"type":"string"},"field_type":{"type":"string","enum":["short_text","long_text","rich_text","number","boolean","json"]},"resource_type":{"type":"string"},"storefront_visible":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","namespace","key","label","field_type","resource_type","storefront_visible","created_at","updated_at"],"x-typelizer":true},"CustomField":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"type":{"type":"string","deprecated":true},"field_type":{"type":"string","enum":["short_text","long_text","rich_text","number","boolean","json"]},"key":{"type":"string"},"value":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"storefront_visible":{"type":"boolean"},"custom_field_definition_id":{"type":"string"}},"required":["id","label","type","field_type","key","value","created_at","updated_at","storefront_visible","custom_field_definition_id"],"x-typelizer":true},"CustomerGroup":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"customers_count":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customers":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}}},"required":["id","name","description","customers_count","created_at","updated_at"],"x-typelizer":true},"Customer":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"accepts_email_marketing":{"type":"boolean"},"full_name":{"type":"string"},"available_store_credit_total":{"type":"string"},"display_available_store_credit_total":{"type":"string"},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/Address"}},"default_billing_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"default_shipping_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"login":{"type":"string","nullable":true},"metadata":{"type":"object"},"last_sign_in_at":{"type":"string","nullable":true},"current_sign_in_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"sign_in_count":{"type":"number"},"failed_attempts":{"type":"number"},"last_sign_in_ip":{"type":"string","nullable":true},"current_sign_in_ip":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"internal_note_html":{"type":"string","nullable":true},"default_billing_address_id":{"type":"string","nullable":true},"default_shipping_address_id":{"type":"string","nullable":true},"orders_count":{"type":"number"},"total_spent":{"type":"string"},"display_total_spent":{"type":"string"},"last_order_completed_at":{"type":"string","nullable":true},"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"store_credits":{"type":"array","items":{"$ref":"#/components/schemas/StoreCredit"}},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}}},"required":["id","email","first_name","last_name","phone","accepts_email_marketing","full_name","available_store_credit_total","display_available_store_credit_total","login","metadata","last_sign_in_at","current_sign_in_at","created_at","updated_at","sign_in_count","failed_attempts","last_sign_in_ip","current_sign_in_ip","tags","internal_note_html","default_billing_address_id","default_shipping_address_id","orders_count","total_spent","display_total_spent","last_order_completed_at"],"x-typelizer":true},"DeliveryMethod":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","code","created_at","updated_at"],"x-typelizer":true},"DeliveryRate":{"type":"object","properties":{"id":{"type":"string"},"delivery_method_id":{"type":"string"},"name":{"type":"string"},"selected":{"type":"boolean"},"cost":{"type":"string"},"total":{"type":"string"},"additional_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"tax_total":{"type":"string"},"display_cost":{"type":"string"},"display_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"display_tax_total":{"type":"string"},"delivery_method":{"$ref":"#/components/schemas/DeliveryMethod"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","delivery_method_id","name","selected","cost","total","additional_tax_total","included_tax_total","tax_total","display_cost","display_total","display_additional_tax_total","display_included_tax_total","display_tax_total","created_at","updated_at"],"x-typelizer":true},"DigitalLink":{"type":"object","properties":{"id":{"type":"string"},"access_counter":{"type":"number"},"filename":{"type":"string"},"content_type":{"type":"string"},"download_url":{"type":"string"},"authorizable":{"type":"boolean"},"expired":{"type":"boolean"},"access_limit_exceeded":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","access_counter","filename","content_type","download_url","authorizable","expired","access_limit_exceeded","created_at","updated_at"],"x-typelizer":true},"Discount":{"type":"object","properties":{"id":{"type":"string"},"promotion_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"amount":{"type":"string"},"display_amount":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","promotion_id","name","description","code","amount","display_amount","created_at","updated_at"],"x-typelizer":true},"Export":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"type":{"type":"string","nullable":true},"format":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string","nullable":true},"done":{"type":"boolean"},"filename":{"type":"string","nullable":true},"byte_size":{"type":"number","nullable":true},"download_url":{"type":"string","nullable":true}},"required":["id","number","type","format","created_at","updated_at","user_id","done","filename","byte_size","download_url"],"x-typelizer":true},"Fulfillment":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"tracking":{"type":"string","nullable":true},"tracking_url":{"type":"string","nullable":true},"cost":{"type":"string"},"display_cost":{"type":"string"},"total":{"type":"string"},"display_total":{"type":"string"},"discount_total":{"type":"string"},"display_discount_total":{"type":"string"},"additional_tax_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"tax_total":{"type":"string"},"display_tax_total":{"type":"string"},"status":{"type":"string"},"fulfillment_type":{"type":"string"},"fulfilled_at":{"type":"string","nullable":true},"items":{"type":"array","items":{"$ref":"#/components/schemas/FulfillmentManifestItem"}},"delivery_method":{"$ref":"#/components/schemas/DeliveryMethod"},"stock_location":{"$ref":"#/components/schemas/StockLocation"},"delivery_rates":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryRate"}},"metadata":{"type":"object"},"adjustment_total":{"type":"string"},"pre_tax_amount":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"order_id":{"type":"string","nullable":true},"stock_location_id":{"type":"string","nullable":true},"order":{"$ref":"#/components/schemas/Order"},"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/Adjustment"}}},"required":["id","number","tracking","tracking_url","cost","display_cost","total","display_total","discount_total","display_discount_total","additional_tax_total","display_additional_tax_total","included_tax_total","display_included_tax_total","tax_total","display_tax_total","status","fulfillment_type","fulfilled_at","items","metadata","adjustment_total","pre_tax_amount","created_at","updated_at","order_id","stock_location_id"],"x-typelizer":true},"GiftCardBatch":{"type":"object","properties":{"id":{"type":"string"},"codes_count":{"type":"number"},"currency":{"type":"string","nullable":true},"prefix":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"amount":{"type":"string","nullable":true},"expires_at":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true}},"required":["id","codes_count","currency","prefix","created_at","updated_at","amount","expires_at","created_by_id"],"x-typelizer":true},"GiftCard":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"status":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string"},"amount_used":{"type":"string"},"amount_authorized":{"type":"string"},"amount_remaining":{"type":"string"},"display_amount":{"type":"string"},"display_amount_used":{"type":"string"},"display_amount_remaining":{"type":"string"},"expires_at":{"type":"string","nullable":true},"redeemed_at":{"type":"string","nullable":true},"expired":{"type":"boolean"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customer_id":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true},"customer":{"$ref":"#/components/schemas/Customer"},"created_by":{"$ref":"#/components/schemas/AdminUser"},"gift_card_batch":{"$ref":"#/components/schemas/GiftCardBatch"},"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}}},"required":["id","code","status","currency","amount","amount_used","amount_authorized","amount_remaining","display_amount","display_amount_used","display_amount_remaining","expires_at","redeemed_at","expired","active","created_at","updated_at","customer_id","created_by_id"],"x-typelizer":true},"Invitation":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"expires_at":{"type":"string"},"role_id":{"type":"string"},"role_name":{"type":"string"},"inviter_email":{"type":"string"},"acceptance_url":{"type":"string"},"invitee_exists":{"type":"boolean"},"store":{"type":"object"}},"required":["id","email","status","created_at","updated_at","expires_at","role_id","role_name","inviter_email","acceptance_url","invitee_exists","store"],"x-typelizer":true},"LineItem":{"type":"object","properties":{"id":{"type":"string"},"variant_id":{"type":"string"},"quantity":{"type":"number"},"currency":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"options_text":{"type":"string"},"price":{"type":"string"},"display_price":{"type":"string"},"total":{"type":"string"},"display_total":{"type":"string"},"adjustment_total":{"type":"string"},"display_adjustment_total":{"type":"string"},"additional_tax_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"discount_total":{"type":"string"},"display_discount_total":{"type":"string"},"pre_tax_amount":{"type":"string"},"display_pre_tax_amount":{"type":"string"},"discounted_amount":{"type":"string"},"display_discounted_amount":{"type":"string"},"display_compare_at_amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}},"digital_links":{"type":"array","items":{"$ref":"#/components/schemas/DigitalLink"}},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"cost_price":{"type":"string","nullable":true},"tax_category_id":{"type":"string","nullable":true},"variant":{"$ref":"#/components/schemas/Variant"},"tax_category":{"$ref":"#/components/schemas/TaxCategory"},"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/Adjustment"}}},"required":["id","variant_id","quantity","currency","name","slug","options_text","price","display_price","total","display_total","adjustment_total","display_adjustment_total","additional_tax_total","display_additional_tax_total","included_tax_total","display_included_tax_total","discount_total","display_discount_total","pre_tax_amount","display_pre_tax_amount","discounted_amount","display_discounted_amount","display_compare_at_amount","compare_at_amount","thumbnail_url","option_values","digital_links","metadata","created_at","updated_at","cost_price","tax_category_id"],"x-typelizer":true},"Market":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string"},"default_locale":{"type":"string"},"tax_inclusive":{"type":"boolean"},"default":{"type":"boolean"},"country_isos":{"type":"array","items":{"type":"string"}},"supported_locales":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","currency","default_locale","tax_inclusive","default","country_isos","supported_locales","created_at","updated_at"],"x-typelizer":true},"Media":{"type":"object","properties":{"id":{"type":"string"},"product_id":{"type":"string","nullable":true},"variant_ids":{"type":"array","items":{"type":"string"}},"position":{"type":"number"},"alt":{"type":"string","nullable":true},"media_type":{"type":"string"},"focal_point_x":{"type":"number","nullable":true},"focal_point_y":{"type":"number","nullable":true},"external_video_url":{"type":"string","nullable":true},"original_url":{"type":"string","nullable":true},"mini_url":{"type":"string","nullable":true},"small_url":{"type":"string","nullable":true},"medium_url":{"type":"string","nullable":true},"large_url":{"type":"string","nullable":true},"xlarge_url":{"type":"string","nullable":true},"og_image_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"viewable_id":{"type":"string"},"download_url":{"type":"string","nullable":true},"metadata":{"type":"object"},"viewable_type":{"type":"string"}},"required":["id","product_id","variant_ids","position","alt","media_type","focal_point_x","focal_point_y","external_video_url","original_url","mini_url","small_url","medium_url","large_url","xlarge_url","og_image_url","created_at","updated_at","viewable_id","download_url","metadata","viewable_type"],"x-typelizer":true},"OptionType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"number"},"kind":{"type":"string"},"metadata":{"type":"object"},"filterable":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}}},"required":["id","name","label","position","kind","metadata","filterable","created_at","updated_at"],"x-typelizer":true},"OptionValue":{"type":"object","properties":{"id":{"type":"string"},"option_type_id":{"type":"string"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"number"},"color_code":{"type":"string","nullable":true},"option_type_name":{"type":"string"},"option_type_label":{"type":"string"},"image_url":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"option_type":{"$ref":"#/components/schemas/OptionType"}},"required":["id","option_type_id","name","label","position","color_code","option_type_name","option_type_label","image_url","metadata","created_at","updated_at"],"x-typelizer":true},"Order":{"type":"object","properties":{"id":{"type":"string"},"market_id":{"type":"string","nullable":true},"channel_id":{"type":"string","nullable":true},"number":{"type":"string"},"email":{"type":"string"},"customer_note":{"type":"string","nullable":true},"currency":{"type":"string"},"locale":{"type":"string","nullable":true},"total_quantity":{"type":"number"},"item_total":{"type":"string"},"display_item_total":{"type":"string"},"adjustment_total":{"type":"string"},"display_adjustment_total":{"type":"string"},"discount_total":{"type":"string"},"display_discount_total":{"type":"string"},"tax_total":{"type":"string"},"display_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"additional_tax_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"total":{"type":"string"},"display_total":{"type":"string"},"gift_card_total":{"type":"string"},"display_gift_card_total":{"type":"string"},"amount_due":{"type":"string"},"display_amount_due":{"type":"string"},"delivery_total":{"type":"string"},"display_delivery_total":{"type":"string"},"fulfillment_status":{"type":"string","nullable":true},"payment_status":{"type":"string","nullable":true},"completed_at":{"type":"string","nullable":true},"store_credit_total":{"type":"string"},"display_store_credit_total":{"type":"string"},"covered_by_store_credit":{"type":"boolean"},"discounts":{"type":"array","items":{"$ref":"#/components/schemas/Discount"}},"items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"fulfillments":{"type":"array","items":{"$ref":"#/components/schemas/Fulfillment"}},"payments":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}},"billing_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"shipping_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"gift_card":{"allOf":[{"$ref":"#/components/schemas/GiftCard"}],"nullable":true},"market":{"allOf":[{"$ref":"#/components/schemas/Market"}],"nullable":true},"status":{"type":"string"},"last_ip_address":{"type":"string","nullable":true},"considered_risky":{"type":"boolean"},"confirmation_delivered":{"type":"boolean"},"store_owner_notification_delivered":{"type":"boolean"},"payment_total":{"type":"string"},"display_payment_total":{"type":"string"},"metadata":{"type":"object"},"canceled_at":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"preferred_stock_location_id":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"internal_note":{"type":"string","nullable":true},"approver_id":{"type":"string","nullable":true},"canceler_id":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true},"customer_id":{"type":"string","nullable":true},"channel":{"$ref":"#/components/schemas/Channel"},"preferred_stock_location":{"$ref":"#/components/schemas/StockLocation"},"payment_methods":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethod"}},"customer":{"$ref":"#/components/schemas/Customer"},"approver":{"$ref":"#/components/schemas/Customer"},"canceler":{"$ref":"#/components/schemas/Customer"},"created_by":{"$ref":"#/components/schemas/Customer"},"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/Adjustment"}},"return_authorizations":{"type":"array","items":{"$ref":"#/components/schemas/ReturnAuthorization"}},"reimbursements":{"type":"array","items":{"$ref":"#/components/schemas/Reimbursement"}}},"required":["id","market_id","channel_id","number","email","customer_note","currency","locale","total_quantity","item_total","display_item_total","adjustment_total","display_adjustment_total","discount_total","display_discount_total","tax_total","display_tax_total","included_tax_total","display_included_tax_total","additional_tax_total","display_additional_tax_total","total","display_total","gift_card_total","display_gift_card_total","amount_due","display_amount_due","delivery_total","display_delivery_total","fulfillment_status","payment_status","completed_at","store_credit_total","display_store_credit_total","covered_by_store_credit","gift_card","market","status","last_ip_address","considered_risky","confirmation_delivered","store_owner_notification_delivered","payment_total","display_payment_total","metadata","canceled_at","approved_at","created_at","updated_at","preferred_stock_location_id","tags","internal_note","approver_id","canceler_id","created_by_id","customer_id"],"x-typelizer":true},"PaymentMethod":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"type":{"type":"string"},"session_required":{"type":"boolean"},"source_required":{"type":"boolean"},"metadata":{"type":"object"},"active":{"type":"boolean"},"auto_capture":{"type":"boolean","nullable":true},"storefront_visible":{"type":"boolean"},"position":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"object"}},"required":["id","name","description","type","session_required","source_required","metadata","active","auto_capture","storefront_visible","position","created_at","updated_at","preferences","preference_schema"],"x-typelizer":true},"Payment":{"type":"object","properties":{"id":{"type":"string"},"payment_method_id":{"type":"string"},"response_code":{"type":"string","nullable":true},"number":{"type":"string"},"amount":{"type":"string"},"display_amount":{"type":"string"},"status":{"type":"string"},"source_type":{"type":"string","nullable":true,"enum":["credit_card","store_credit","payment_source"]},"source_id":{"type":"string","nullable":true},"source":{"anyOf":[{"$ref":"#/components/schemas/CreditCard"},{"$ref":"#/components/schemas/StoreCredit"},{"$ref":"#/components/schemas/PaymentSource"}],"nullable":true},"payment_method":{"$ref":"#/components/schemas/PaymentMethod"},"metadata":{"type":"object"},"avs_response":{"type":"string","nullable":true},"cvv_response_code":{"type":"string","nullable":true},"cvv_response_message":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"captured_amount":{"type":"string"},"order_id":{"type":"string","nullable":true},"order":{"$ref":"#/components/schemas/Order"},"refunds":{"type":"array","items":{"$ref":"#/components/schemas/Refund"}}},"required":["id","payment_method_id","response_code","number","amount","display_amount","status","source_type","source_id","source","metadata","avs_response","cvv_response_code","cvv_response_message","created_at","updated_at","captured_amount","order_id"],"x-typelizer":true},"PaymentSource":{"type":"object","properties":{"id":{"type":"string"},"gateway_payment_profile_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","gateway_payment_profile_id","metadata","created_at","updated_at"],"x-typelizer":true},"PriceHistory":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string"},"amount_in_cents":{"type":"number"},"currency":{"type":"string"},"display_amount":{"type":"string"},"recorded_at":{"type":"string"},"variant_id":{"type":"string"},"price_id":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true},"created_at":{"type":"string"}},"required":["id","amount","amount_in_cents","currency","display_amount","recorded_at","variant_id","price_id","compare_at_amount","created_at"],"x-typelizer":true},"PriceList":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string"},"position":{"type":"number"},"match_policy":{"type":"string"},"starts_at":{"type":"string","nullable":true},"ends_at":{"type":"string","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"currently_active":{"type":"boolean"},"products_count":{"type":"number"},"prices_count":{"type":"number"},"product_ids":{"type":"array","items":{"type":"string"}},"price_rules":{"type":"array","items":{"$ref":"#/components/schemas/PriceRule"}}},"required":["id","name","description","status","position","match_policy","starts_at","ends_at","deleted_at","created_at","updated_at","currently_active","products_count","prices_count","product_ids"],"x-typelizer":true},"PriceRule":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"price_list_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}},"label":{"type":"string"},"description":{"type":"string","nullable":true},"markets":{"type":"array","items":{"$ref":"#/components/schemas/Market"}},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"customers":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}}},"required":["id","created_at","updated_at","type","price_list_id","preferences","preference_schema","label","description"],"x-typelizer":true},"Price":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","nullable":true},"amount_in_cents":{"type":"number","nullable":true},"compare_at_amount":{"type":"string","nullable":true},"compare_at_amount_in_cents":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"display_amount":{"type":"string","nullable":true},"display_compare_at_amount":{"type":"string","nullable":true},"price_list_id":{"type":"string","nullable":true},"variant_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"variant":{"$ref":"#/components/schemas/Variant"}},"required":["id","amount","amount_in_cents","compare_at_amount","compare_at_amount_in_cents","currency","display_amount","display_compare_at_amount","price_list_id","variant_id","created_at","updated_at"],"x-typelizer":true},"ProductPublication":{"type":"object","properties":{"id":{"type":"string"},"published_at":{"type":"string","nullable":true},"unpublished_at":{"type":"string","nullable":true},"product_id":{"type":"string"},"channel_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","published_at","unpublished_at","product_id","channel_id","created_at","updated_at"],"x-typelizer":true},"Product":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"meta_title":{"type":"string","nullable":true},"meta_description":{"type":"string","nullable":true},"meta_keywords":{"type":"string","nullable":true},"variant_count":{"type":"number"},"available_on":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"in_stock":{"type":"boolean"},"backorderable":{"type":"boolean"},"available":{"type":"boolean"},"description":{"type":"string","nullable":true},"description_html":{"type":"string","nullable":true},"default_variant_id":{"type":"string"},"thumbnail_url":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"price":{"allOf":[{"$ref":"#/components/schemas/Price"}],"nullable":true},"original_price":{"allOf":[{"$ref":"#/components/schemas/Price"}],"nullable":true},"primary_media":{"$ref":"#/components/schemas/Media"},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"}},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}},"default_variant":{"$ref":"#/components/schemas/Variant"},"option_types":{"type":"array","items":{"$ref":"#/components/schemas/OptionType"}},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}},"categories":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"prior_price":{"allOf":[{"$ref":"#/components/schemas/PriceHistory"}],"nullable":true},"status":{"type":"string"},"metadata":{"type":"object"},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"tax_category_id":{"type":"string","nullable":true},"product_publications":{"type":"array","items":{"$ref":"#/components/schemas/ProductPublication"}},"channels":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}}},"required":["id","name","slug","meta_title","meta_description","meta_keywords","variant_count","available_on","purchasable","in_stock","backorderable","available","description","description_html","default_variant_id","thumbnail_url","tags","price","original_price","status","metadata","deleted_at","created_at","updated_at","tax_category_id"],"x-typelizer":true},"PromotionAction":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"promotion_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}},"label":{"type":"string"},"calculator":{"allOf":[{"$ref":"#/components/schemas/PromotionActionCalculator"}],"nullable":true},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/PromotionActionLineItem"},"nullable":true}},"required":["id","created_at","updated_at","type","promotion_id","preferences","preference_schema","label","calculator","line_items"],"x-typelizer":true},"PromotionRule":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"promotion_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}},"label":{"type":"string"},"product_ids":{"type":"array","items":{"type":"string"},"nullable":true},"category_ids":{"type":"array","items":{"type":"string"},"nullable":true},"customer_ids":{"type":"array","items":{"type":"string"},"nullable":true},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"categories":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"customers":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}},"required":["id","created_at","updated_at","type","promotion_id","preferences","preference_schema","label","product_ids","category_ids","customer_ids"],"x-typelizer":true},"Promotion":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true},"expires_at":{"type":"string","nullable":true},"usage_limit":{"type":"number","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"path":{"type":"string","nullable":true},"kind":{"type":"string","enum":["coupon_code","automatic"]},"multi_codes":{"type":"boolean"},"number_of_codes":{"type":"number","nullable":true},"code_prefix":{"type":"string","nullable":true},"promotion_category_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"action_ids":{"type":"array","items":{"type":"string"}},"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","code","starts_at","expires_at","usage_limit","match_policy","path","kind","multi_codes","number_of_codes","code_prefix","promotion_category_id","metadata","created_at","updated_at","action_ids","rule_ids"],"x-typelizer":true},"Refund":{"type":"object","properties":{"id":{"type":"string"},"transaction_id":{"type":"string","nullable":true},"amount":{"type":"string","nullable":true},"payment_id":{"type":"string","nullable":true},"refund_reason_id":{"type":"string","nullable":true},"reimbursement_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"payment":{"$ref":"#/components/schemas/Payment"},"reimbursement":{"$ref":"#/components/schemas/Reimbursement"}},"required":["id","transaction_id","amount","payment_id","refund_reason_id","reimbursement_id","metadata","created_at","updated_at"],"x-typelizer":true},"Reimbursement":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"reimbursement_status":{"type":"string","nullable":true},"total":{"type":"string","nullable":true},"order_id":{"type":"string","nullable":true},"customer_return_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"order":{"$ref":"#/components/schemas/Order"}},"required":["id","number","reimbursement_status","total","order_id","customer_return_id","created_at","updated_at"],"x-typelizer":true},"ReturnAuthorization":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"status":{"type":"string"},"order_id":{"type":"string","nullable":true},"stock_location_id":{"type":"string","nullable":true},"return_authorization_reason_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"order":{"$ref":"#/components/schemas/Order"},"stock_location":{"$ref":"#/components/schemas/StockLocation"}},"required":["id","number","status","order_id","stock_location_id","return_authorization_reason_id","created_at","updated_at"],"x-typelizer":true},"Role":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","created_at","updated_at"],"x-typelizer":true},"State":{"type":"object","properties":{"abbr":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"object"},"updated_at":{"type":"object"}},"required":["abbr","name","created_at","updated_at"],"x-typelizer":true},"StockItem":{"type":"object","properties":{"id":{"type":"string"},"count_on_hand":{"type":"number"},"backorderable":{"type":"boolean"},"stock_location_id":{"type":"string","nullable":true},"variant_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"allocated_count":{"type":"number"},"available_count":{"type":"number"},"stock_location":{"$ref":"#/components/schemas/StockLocation"},"variant":{"$ref":"#/components/schemas/Variant"}},"required":["id","count_on_hand","backorderable","stock_location_id","variant_id","metadata","created_at","updated_at","allocated_count","available_count"],"x-typelizer":true},"StockLocation":{"type":"object","properties":{"id":{"type":"string"},"state_abbr":{"type":"string","nullable":true},"name":{"type":"string"},"address1":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"zipcode":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true},"country_name":{"type":"string","nullable":true},"state_text":{"type":"string","nullable":true},"admin_name":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"state_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"active":{"type":"boolean"},"default":{"type":"boolean"},"backorderable_default":{"type":"boolean"},"propagate_all_variants":{"type":"boolean"},"kind":{"type":"string"},"pickup_enabled":{"type":"boolean"},"pickup_stock_policy":{"type":"string"},"pickup_ready_in_minutes":{"type":"number","nullable":true},"pickup_instructions":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","state_abbr","name","address1","city","zipcode","country_iso","country_name","state_text","admin_name","address2","state_name","phone","company","active","default","backorderable_default","propagate_all_variants","kind","pickup_enabled","pickup_stock_policy","pickup_ready_in_minutes","pickup_instructions","created_at","updated_at"],"x-typelizer":true},"StockReservation":{"type":"object","properties":{"id":{"type":"string"},"stock_item_id":{"type":"string"},"line_item_id":{"type":"string"},"order_id":{"type":"string"},"variant_id":{"type":"string","nullable":true},"stock_location_id":{"type":"string","nullable":true},"quantity":{"type":"number"},"expires_at":{"type":"string"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","stock_item_id","line_item_id","order_id","variant_id","stock_location_id","quantity","expires_at","active","created_at","updated_at"],"x-typelizer":true},"StockTransfer":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"reference":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"source_location_id":{"type":"string","nullable":true},"destination_location_id":{"type":"string","nullable":true},"source_location":{"$ref":"#/components/schemas/StockLocation"},"destination_location":{"$ref":"#/components/schemas/StockLocation"}},"required":["id","number","reference","metadata","created_at","updated_at","source_location_id","destination_location_id"],"x-typelizer":true},"StoreCreditCategory":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"non_expiring":{"type":"boolean"}},"required":["id","name","created_at","updated_at","non_expiring"],"x-typelizer":true},"StoreCredit":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string"},"amount_used":{"type":"string"},"amount_remaining":{"type":"string"},"display_amount":{"type":"string"},"display_amount_used":{"type":"string"},"display_amount_remaining":{"type":"string"},"currency":{"type":"string"},"memo":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customer_id":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true},"category_id":{"type":"string","nullable":true},"category_name":{"type":"string","nullable":true}},"required":["id","amount","amount_used","amount_remaining","display_amount","display_amount_used","display_amount_remaining","currency","memo","metadata","created_at","updated_at","customer_id","created_by_id","category_id","category_name"],"x-typelizer":true},"Store":{"type":"object","properties":{"id":{"type":"string"},"metadata":{"type":"object"},"name":{"type":"string"},"default_currency":{"type":"string"},"default_locale":{"type":"string"},"mail_from_address":{"type":"string","nullable":true},"customer_support_email":{"type":"string","nullable":true},"new_order_notifications_email":{"type":"string","nullable":true},"preferred_send_consumer_transactional_emails":{"type":"boolean"},"preferred_admin_locale":{"type":"string","nullable":true},"preferred_timezone":{"type":"string"},"preferred_weight_unit":{"type":"string"},"preferred_unit_system":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"url":{"type":"string"},"supported_currencies":{"type":"array","items":{"type":"string"}},"supported_locales":{"type":"array","items":{"type":"string"}},"logo_url":{"type":"string","nullable":true},"mailer_logo_url":{"type":"string","nullable":true}},"required":["id","metadata","name","default_currency","default_locale","mail_from_address","customer_support_email","new_order_notifications_email","preferred_send_consumer_transactional_emails","preferred_admin_locale","preferred_timezone","preferred_weight_unit","preferred_unit_system","created_at","updated_at","url","supported_currencies","supported_locales","logo_url","mailer_logo_url"],"x-typelizer":true},"TaxCategory":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"tax_code":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"is_default":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","tax_code","description","is_default","created_at","updated_at"],"x-typelizer":true},"Variant":{"type":"object","properties":{"id":{"type":"string"},"product_id":{"type":"string"},"sku":{"type":"string","nullable":true},"options_text":{"type":"string"},"track_inventory":{"type":"boolean"},"media_count":{"type":"number"},"thumbnail_url":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"in_stock":{"type":"boolean"},"backorderable":{"type":"boolean"},"weight":{"type":"number","nullable":true},"height":{"type":"number","nullable":true},"width":{"type":"number","nullable":true},"depth":{"type":"number","nullable":true},"price":{"$ref":"#/components/schemas/Price"},"original_price":{"allOf":[{"$ref":"#/components/schemas/Price"}],"nullable":true},"primary_media":{"$ref":"#/components/schemas/Media"},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"}},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"prior_price":{"allOf":[{"$ref":"#/components/schemas/PriceHistory"}],"nullable":true},"metadata":{"type":"object"},"position":{"type":"number"},"cost_price":{"type":"string","nullable":true},"cost_currency":{"type":"string","nullable":true},"barcode":{"type":"string","nullable":true},"weight_unit":{"type":"string","nullable":true},"dimensions_unit":{"type":"string","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"tax_category_id":{"type":"string","nullable":true},"available_stock":{"type":"number","nullable":true},"reserved_quantity":{"type":"number"},"total_on_hand":{"type":"number","nullable":true},"product_name":{"type":"string"},"prices":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"stock_items":{"type":"array","items":{"$ref":"#/components/schemas/StockItem"}}},"required":["id","product_id","sku","options_text","track_inventory","media_count","thumbnail_url","purchasable","in_stock","backorderable","weight","height","width","depth","price","original_price","option_values","metadata","position","cost_price","cost_currency","barcode","weight_unit","dimensions_unit","deleted_at","created_at","updated_at","tax_category_id","available_stock","reserved_quantity","total_on_hand","product_name"],"x-typelizer":true},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string"},"event_name":{"type":"string"},"event_id":{"type":"string","nullable":true},"response_code":{"type":"number","nullable":true},"execution_time":{"type":"number","nullable":true},"error_type":{"type":"string","nullable":true},"request_errors":{"type":"string","nullable":true},"response_body":{"type":"string","nullable":true},"success":{"type":"boolean","nullable":true},"payload":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"delivered_at":{"type":"string","nullable":true},"webhook_endpoint_id":{"type":"string"},"webhook_endpoint_url":{"type":"string"}},"required":["id","event_name","event_id","response_code","execution_time","error_type","request_errors","response_body","success","payload","created_at","updated_at","delivered_at","webhook_endpoint_id","webhook_endpoint_url"],"x-typelizer":true},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"url":{"type":"string"},"active":{"type":"boolean"},"subscriptions":{"type":"array","items":{"type":"string"}},"disabled_reason":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"disabled_at":{"type":"string","nullable":true},"secret_key":{"type":"string","nullable":true},"last_delivery_at":{"type":"string","nullable":true},"recent_delivery_count":{"type":"number"},"recent_failure_count":{"type":"number"},"total_delivery_count":{"type":"number"},"successful_delivery_count":{"type":"number"},"failed_delivery_count":{"type":"number"}},"required":["id","name","url","active","subscriptions","disabled_reason","created_at","updated_at","disabled_at","secret_key","last_delivery_at","recent_delivery_count","recent_failure_count","total_delivery_count","successful_delivery_count","failed_delivery_count"],"x-typelizer":true}}}}\ No newline at end of file+{"info":{"title":"Admin API","contact":{"name":"Spree Commerce","url":"https://spreecommerce.org","email":"[email protected]"},"description":"Spree Admin API v3 - Administrative API for managing products, orders, and store settings.\n\n## Authentication\n\nThe Admin API requires a secret API key passed in the `x-spree-api-key` header.\nSecret API keys can be generated in the Spree admin dashboard.\n\n## Response Format\n\nAll responses are JSON. List endpoints return paginated responses with `data` and `meta` keys.\nSingle resource endpoints return a flat JSON object.\n\n## Resource IDs\n\nEvery resource is identified by an opaque string ID (e.g. `prod_86Rf07xd4z`,\n`variant_k5nR8xLq`, `or_UkLWZg9DAJ`). Use these IDs everywhere — URL paths,\nrequest bodies, and Ransack filters all accept them directly.\n\n## Error Handling\n\nErrors return a consistent format:\n```json\n{\n \"error\": {\n \"code\": \"validation_error\",\n \"message\": \"Validation failed\",\n \"details\": { \"name\": [\"can't be blank\"] }\n }\n}\n```\n","version":"v3"},"paths":{"/api/v3/admin/auth/login":{"post":{"summary":"Login","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Authenticates an admin user and returns a short-lived JWT access token.\nThe rotatable refresh token is set in an HttpOnly cookie — it is not\nincluded in the response body.\n\nThe `provider` field selects the authentication method. When omitted it\ndefaults to `email`, the built-in email/password login.\n\nTo authenticate against a third-party identity provider (Okta, Azure AD,\nGoogle Workspace SSO, a custom JWT issuer, SAML, etc.), send\n`{ \"provider\": \"<your_key>\", ... }` with the fields that provider\nrequires. The endpoint returns the same JWT regardless of which provider\nauthenticated the request. See\n[Custom API Authentication](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication)\nfor the list of configured providers and their required fields.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"login successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"401":{"description":"invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"title":"EmailPasswordLogin","description":"Built-in email/password authentication (default when `provider` is omitted).","type":"object","properties":{"provider":{"type":"string","enum":["email"],"default":"email"},"email":{"type":"string","format":"email"},"password":{"type":"string"}},"required":["email","password"]},{"title":"ProviderLogin","description":"Provider-dispatched login. The `provider` key selects a configured\nauthentication provider; the remaining fields are forwarded to it.\nRequired fields depend on the provider — see\n[Custom API Authentication](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication).\n","type":"object","properties":{"provider":{"type":"string","description":"Registered provider key (anything other than `email`).","not":{"enum":["email"]}}},"required":["provider"],"additionalProperties":true}]}}}}}},"/api/v3/admin/auth/refresh":{"post":{"summary":"Refresh token","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Exchanges the HttpOnly refresh-token cookie for a new access JWT and a\nrotated refresh token cookie. No request body or Authorization header\nis required — the cookie alone authenticates the call.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"refresh successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"401":{"description":"missing or invalid refresh-token cookie","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/auth/logout":{"post":{"summary":"Logout","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Revokes the refresh-token cookie, effectively logging the admin out.","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"logout successful"}}}},"/api/v3/admin/me":{"get":{"summary":"Get current admin user and permissions","tags":["Authentication"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the current admin user profile and a serialized list of permissions (CanCanCan rules). The SPA uses these to drive UI permission checks.","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"current admin user and permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update the current admin profile","tags":["Authentication"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Self-service update of the signed-in admin's own profile, such as their admin UI display language (`selected_locale`).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"profile updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"selected_locale":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}}}}}}}},"/api/v3/admin/allowed_origins":{"get":{"summary":"List allowed origins","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the CORS allowlist for the current store. Each entry is a\nbare `scheme://host[:port]` permitted to call the admin API from a\nbrowser. Backs the `Rack::Cors` allowlist and the CSRF boundary of\nthe admin cookie session (see\n`docs/plans/5.5-admin-auth-cookie-refresh.md`).\n\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[origin_cont]","in":"query","required":false,"description":"Filter by origin (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"allowed origins found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AllowedOrigin"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds an origin to the admin CORS allowlist. The value must be a bare\n`scheme://host[:port]` (no path, query, or fragment) and use `http` or\n`https`.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"allowed origin created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllowedOrigin"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"}},"required":["origin"]}}}}}},"/api/v3/admin/allowed_origins/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Allowed origin ID","schema":{"type":"string"}}],"get":{"summary":"Get an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single allowed origin by prefixed ID.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"allowed origin found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllowedOrigin"}}}},"404":{"description":"allowed origin not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an existing allowed origin.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"allowed origin updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllowedOrigin"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"}}}}}}},"delete":{"summary":"Delete an allowed origin","tags":["Allowed Origins"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes an origin from the admin CORS allowlist. After deletion the\nadmin SPA running at that origin will no longer be able to call the\nadmin API from a browser.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"204":{"description":"allowed origin deleted"}}}},"/api/v3/admin/api_keys":{"get":{"summary":"List API keys","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns publishable and secret API keys for the current store. Secret keys are listed by `token_prefix` only — the plaintext token is delivered exactly once on create.\n\n**Required scope:** `read_api_keys` (for API-key authentication).","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":"API keys found","content":{"application/json":{}}}}},"post":{"summary":"Create an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a publishable or secret API key. The plaintext token is included in the response **once** for secret keys; publishable keys expose their token on every read since they are intended for client-side use.\n\n**Required scope:** `write_api_keys` (for API-key authentication).","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":"secret key created — plaintext token returned once","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name","key_type"],"properties":{"name":{"type":"string"},"key_type":{"type":"string","enum":["publishable","secret"]},"scopes":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/api_keys/{id}":{"get":{"summary":"Show an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"API key found","content":{"application/json":{}}}}},"patch":{"summary":"Update an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Renames a key. `key_type` and `scopes` are fixed at creation — to change a key's authority, create a new key and revoke the old one.\n\n**Required scope:** `write_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"API key renamed","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}}}}}}},"delete":{"summary":"Delete an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"API key deleted"}}}},"/api/v3/admin/api_keys/current":{"get":{"summary":"Describe the current API key","tags":["API Keys"],"security":[{"api_key":[]}],"description":"Returns the secret key that authenticated this request, including its live scopes. Useful to confirm a key's real, current authority. Only secret-key principals have a single key to describe.\n\n**Required scope:** none — any key can describe itself (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"current API key","content":{"application/json":{}}}}}},"/api/v3/admin/api_keys/{id}/revoke":{"patch":{"summary":"Revoke an API key","tags":["API Keys"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Marks the key revoked. Future requests using its token will fail; the row is preserved for audit.\n\n**Required scope:** `write_api_keys` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"API key revoked","content":{"application/json":{}}}}}},"/api/v3/admin/channels":{"get":{"summary":"List channels","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the channels configured for the current store.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"channels found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new channel on the current store. `code` is normalized to a\nURL-safe slug (`Point of Sale` → `point-of-sale`); when omitted it's\nderived from `name`.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":"channel created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"code":{"type":"string","description":"Slug — auto-derived from `name` when blank."},"active":{"type":"boolean","default":true}}}}}}}},"/api/v3/admin/channels/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","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":"channel found","content":{"application/json":{}}}}},"patch":{"summary":"Update a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","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":"channel updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","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":"channel deleted"}}}},"/api/v3/admin/channels/{id}/add_products":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"Publish products on a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Publishes the listed products on this channel. Idempotent — re-publishing\nan already-published product updates its publication window. Products from\nsibling stores are silently dropped.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products published","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["product_ids"],"properties":{"product_ids":{"type":"array","items":{"type":"string"}},"published_at":{"type":"string","format":"date-time","nullable":true,"description":"When the publications go live. `null` means immediately."},"unpublished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the publications come down. `null` means never."}}}}}}}},"/api/v3/admin/channels/{id}/remove_products":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"Unpublish products from a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Unpublishes the listed products from this channel.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products unpublished","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["product_ids"],"properties":{"product_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/custom_field_definitions":{"get":{"summary":"List custom field definitions","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all defined custom fields. Filter by `?q[resource_type_eq]=Spree::Product` to narrow to one parent type.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,label,field_type). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"definitions returned","content":{"application/json":{}}}}},"post":{"summary":"Create a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","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":"definition created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["key","field_type","resource_type"],"properties":{"namespace":{"type":"string","description":"Defaults to `custom`"},"key":{"type":"string"},"label":{"type":"string","description":"Human-readable name; defaults to titleized `key`"},"field_type":{"type":"string","description":"Custom field type identifier (one of the registered field-type class names)."},"resource_type":{"type":"string","description":"Owner class, e.g. `Spree::Product`"},"storefront_visible":{"type":"boolean","description":"When false, definition is admin-only (was `display_on: back_end`)"}}}}}}}},"/api/v3/admin/custom_field_definitions/{id}":{"get":{"summary":"Show a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,label,field_type). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"definition found","content":{"application/json":{}}}}},"patch":{"summary":"Update a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"definition updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string"},"storefront_visible":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a custom field definition","tags":["Custom Fields"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes the definition and cascades to all custom field values referencing it.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"definition deleted"}}}},"/api/v3/admin/customer_groups":{"get":{"summary":"List customer groups","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the customer groups configured for the current store. Groups\nsegment customers for targeted promotions (see the `customer_group`\npromotion rule) and reporting. The list endpoint never embeds the\nmember list — fetch a single group with `?expand=customers` if you\nneed them inline, or query `/admin/customers?customer_group_id_in=…`\nfor paginated membership.\n\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customer groups found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a customer group in the current store. `customer_ids` is\noptional; when present, customers are attached at create time.\nPass prefixed IDs (e.g. `cus_…`) — the server decodes them\nautomatically.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer group created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerGroup"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"customer_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customer_groups/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Customer group prefixed ID","schema":{"type":"string"}}],"get":{"summary":"Get a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single customer group. Pass `?expand=customers` to embed\nthe full member list inline (recommended only for single-record\nreads — embed cost scales with membership size).\n\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `customers`.","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customer group with embedded customers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerGroup"}}}},"404":{"description":"customer group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates name, description, or membership. `customer_ids` is a\nfull-set replacement — the server reconciles the membership to\nmatch the array, adding new IDs and removing ones not present.\nSend `customer_ids: []` to clear all members.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer group updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerGroup"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"customer_ids":{"type":"array","items":{"type":"string"}}}}}}}},"delete":{"summary":"Delete a customer group","tags":["Customer Groups"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the group. Member users are not deleted; their `customer_group_users` rows are dropped.\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer group deleted"}}}},"/api/v3/admin/customers/{customer_id}/addresses":{"get":{"summary":"List customer addresses","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the customer's saved addresses.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., country, state). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., first_name,last_name,address1,city). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"addresses found","content":{"application/json":{}}}}},"post":{"summary":"Create a customer address","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new address to the customer's address book. Pass `is_default_billing: true` or `is_default_shipping: true` to set as the default — the previous default loses its flag in the same transaction.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"address created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"},"country_iso":{"type":"string","description":"ISO-2 country code (e.g. US)"},"state_abbr":{"type":"string","description":"State/province abbreviation (e.g. NY)"},"phone":{"type":"string"},"company":{"type":"string"},"label":{"type":"string"},"is_default_billing":{"type":"boolean"},"is_default_shipping":{"type":"boolean"}}}}}}}},"/api/v3/admin/customers/{customer_id}/addresses/{id}":{"patch":{"summary":"Update a customer address","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a customer address.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"address updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string"},"is_default_billing":{"type":"boolean"},"is_default_shipping":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a customer address","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes the address. If it was a default, the customer loses that default (no auto-promotion).\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"address deleted"}}}},"/api/v3/admin/customers/{customer_id}/credit_cards":{"get":{"summary":"List customer credit cards","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the customer's saved credit cards. Useful for off-session admin charges via `POST /admin/orders/:id/payments { source_id }`.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., brand,last4,month,year). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"credit cards found","content":{"application/json":{}}}}}},"/api/v3/admin/customers/{customer_id}/credit_cards/{id}":{"get":{"summary":"Show a customer credit card","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a saved credit card by ID.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., brand,last4,month,year). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"credit card found","content":{"application/json":{}}}}},"delete":{"summary":"Delete a customer credit card","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a saved credit card.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"credit card deleted"}}}},"/api/v3/admin/customers/{customer_id}/store_credits":{"get":{"summary":"List customer store credits","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns store credits issued to the customer.\n\n**Required scope:** `read_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., category, store, created_by). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,amount_used,memo,currency). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"store credits found","content":{"application/json":{}}}}},"post":{"summary":"Issue a store credit to a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"`created_by` is set automatically from the authenticated admin.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"store credit created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount","currency","category_id"],"properties":{"amount":{"type":"string"},"currency":{"type":"string"},"category_id":{"type":"string","description":"StoreCreditCategory ID"},"memo":{"type":"string"}}}}}}}},"/api/v3/admin/customers/{customer_id}/store_credits/{id}":{"patch":{"summary":"Update a store credit","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Update memo / category / amount. The amount can only be changed if `amount_used == 0`.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"store credit updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string"},"category_id":{"type":"string"},"memo":{"type":"string"}}}}}}},"delete":{"summary":"Delete a store credit","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes an unused store credit (amount_used == 0). Returns 422 otherwise.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"store credit deleted"}}}},"/api/v3/admin/customers":{"get":{"summary":"List customers","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of customers. Supports Ransack search/filters.\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[search]","in":"query","required":false,"description":"Email + name full-text-ish search","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., addresses, store_credits). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., email,first_name,last_name). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customers found","content":{"application/json":{}}}}},"post":{"summary":"Create a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a customer. No welcome email is sent automatically.\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customer created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"accepts_email_marketing":{"type":"boolean"},"internal_note":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"}}}}}}}},"/api/v3/admin/customers/{id}":{"get":{"summary":"Show a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns full customer details including computed order stats (orders_count, total_spent, last_order_completed_at).\n\n**Required scope:** `read_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Customer ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations: addresses, orders, store_credits, default_billing_address, default_shipping_address","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., email,first_name,last_name). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"customer found","content":{"application/json":{}}}}},"patch":{"summary":"Update a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates customer attributes. `tags` replaces the full set.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"customer updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"accepts_email_marketing":{"type":"boolean"},"internal_note":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"}}}}}}},"delete":{"summary":"Delete a customer","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a customer. Returns 422 if the customer has any orders.\n\n**Required scope:** `write_customers` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"customer deleted"}}}},"/api/v3/admin/customers/bulk_add_to_groups":{"post":{"summary":"Bulk-add customers to groups","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Attaches each customer in `ids` to every group in `customer_group_ids`.\nIdempotent — customers already in a group are skipped server-side.\nGroups from sibling stores are silently ignored. Returns counts of\ncustomers and groups that were processed (post store-scoping).\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customers added to groups","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"customer_group_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","customer_group_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"customer_group_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customers/bulk_remove_from_groups":{"post":{"summary":"Bulk-remove customers from groups","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Detaches each customer in `ids` from every group in `customer_group_ids`.\nNo-op for non-members. Groups from sibling stores are silently ignored.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"customers removed from groups","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"customer_group_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","customer_group_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"customer_group_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customers/bulk_add_tags":{"post":{"summary":"Bulk-add tags to customers","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds each tag name in `tags` to every customer in `ids`. Tags are\nupserted by name; re-adding an existing tag is a no-op.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"tags added","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"tag_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/customers/bulk_remove_tags":{"post":{"summary":"Bulk-remove tags from customers","tags":["Customers"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes each tag name in `tags` from every customer in `ids`. No-op\nfor customers that don't carry the tag.\n\n\n**Required scope:** `write_customers` (for API-key authentication).","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":"tags removed","content":{"application/json":{"schema":{"type":"object","properties":{"customer_count":{"type":"integer"},"tag_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/exports":{"get":{"summary":"List exports","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns CSV exports queued or completed for the current store. Polled by the admin SPA to detect when an export finishes (`done: true`).\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","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":"exports found","content":{"application/json":{}}}}},"post":{"summary":"Create an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Queues a CSV export. The `type` selects the dataset; `search_params` is an\noptional Ransack query (same shape used by the `q[...]` params on list endpoints)\nthat filters which records are exported. Pass `record_selection: \"all\"` to\nclear the filter server-side and export everything in scope.\n\nGeneration is asynchronous. Poll `GET /admin/exports/{id}` until `done` is `true`,\nthen redirect the browser to `download_url` to fetch the file.\n\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","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":"export queued","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["Spree::Exports::Products","Spree::Exports::Orders","Spree::Exports::Customers","Spree::Exports::ProductTranslations","Spree::Exports::GiftCards","Spree::Exports::CouponCodes","Spree::Exports::NewsletterSubscribers"]},"record_selection":{"type":"string","enum":["filtered","all"],"description":"Set to \"all\" to ignore search_params and export everything in scope."},"search_params":{"type":"object","description":"Ransack query hash. Same predicates accepted by the list endpoint.","additionalProperties":true}}}}}}}},"/api/v3/admin/exports/{id}":{"get":{"summary":"Show an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns export status. While `done` is `false`, the SPA continues polling.\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"export found","content":{"application/json":{}}}}},"delete":{"summary":"Delete an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the export and purges its attachment.\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"export deleted"}}}},"/api/v3/admin/exports/{id}/download":{"get":{"summary":"Download an export","tags":["Exports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Streams the exported CSV with `Content-Disposition: attachment`. Returns 422 with `code: export_not_ready` while `done` is still `false`. The endpoint is JWT/API-key protected, so SPA clients must fetch it (with `Authorization` header) and trigger the browser download via a Blob URL — a top-level navigation cannot carry the JWT.\n\n**Required scope:** the read scope of the exported resource — `read_products` for product exports, `read_customers` for customer exports, etc. (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"CSV file","content":{"application/json":{},"text/csv":{"schema":{"type":"string","format":"binary"}}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments":{"get":{"summary":"List fulfillments","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all shipments for an order.\n\n**Required scope:** `read_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., inventory_units, stock_location, shipping_rates). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,status,tracking,cost). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillments found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}":{"get":{"summary":"Show a shipment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns details of a specific shipment.\n\n**Required scope:** `read_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., inventory_units, stock_location, shipping_rates). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,status,tracking,cost). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"shipment found","content":{"application/json":{}}}}},"patch":{"summary":"Update a shipment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a shipment (tracking, shipping rate).\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"shipment updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tracking":{"type":"string"},"selected_shipping_rate_id":{"type":"string"}}}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/fulfill":{"patch":{"summary":"Fulfill a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Marks a fulfillment as fulfilled.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment fulfilled","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":{"patch":{"summary":"Cancel a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Cancels a fulfillment.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment canceled","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":{"patch":{"summary":"Resume a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Resumes a canceled fulfillment.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment resumed","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":{"patch":{"summary":"Split a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Transfers items from this shipment to a new shipment at a different stock location.\n\n**Required scope:** `write_fulfillments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Fulfillment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"fulfillment split","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["variant_id","quantity"],"properties":{"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer"},"stock_location_id":{"type":"string","description":"Target stock location ID"}}}}}}}},"/api/v3/admin/gift_card_batches":{"get":{"summary":"List gift card batches","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the gift card batches issued by the current store. Each batch\ngroups the cards generated together for a campaign or bulk-issuance\n— the cards themselves live under `/admin/gift_cards` and reference\nthe batch via `gift_card_batch_id`.\n\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Records per page","schema":{"type":"integer"}},{"name":"q[prefix_cont]","in":"query","required":false,"description":"Filter by prefix (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending.","schema":{"type":"string"}}],"responses":{"200":{"description":"gift card batches found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GiftCardBatch"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a gift card batch","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Issues a batch of gift cards in a single call. The server generates\n`codes_count` cards inline for small batches (configurable via\n`Spree.config.gift_card_batch_web_limit`, default 500) or enqueues\na background job for larger ones. Each card's code is the batch\n`prefix` followed by random hex.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card batch created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCardBatch"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["prefix","amount","codes_count"],"properties":{"prefix":{"type":"string","description":"Lowercased and prepended to every generated code."},"amount":{"type":"string","description":"Decimal amount per card, greater than zero."},"currency":{"type":"string","description":"ISO 4217 currency code. Defaults to the store currency."},"codes_count":{"type":"integer","description":"Number of cards to generate. Capped at `gift_card_batch_limit`."},"expires_at":{"type":"string","nullable":true}}}}}}}},"/api/v3/admin/gift_card_batches/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Gift card batch prefixed ID","schema":{"type":"string"}}],"get":{"summary":"Get a gift card batch","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single batch.\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","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":"gift card batch found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCardBatch"}}}},"404":{"description":"gift card batch not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/gift_cards":{"get":{"summary":"List gift cards","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the gift cards issued by the current store. Filter by\n`q[code_cont]` for code search, `q[user_id_eq]` for cards issued\nto a specific customer, or `q[state_eq]` for status filtering.\n\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[code_cont]","in":"query","required":false,"description":"Filter by gift card code (contains)","schema":{"type":"string"}},{"name":"q[state_eq]","in":"query","required":false,"description":"Filter by status (active, redeemed, partially_redeemed, canceled)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"gift cards found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GiftCard"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Issues a gift card scoped to the current store. The code is\nauto-generated when omitted. `currency` defaults to the store's\nconfigured currency. Pass `user_id` (prefixed ID) to attach the\ncard to a specific customer.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCard"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"string","description":"Decimal amount, greater than zero."},"currency":{"type":"string","description":"ISO 4217 currency code. Defaults to the store currency."},"code":{"type":"string","description":"Optional caller-supplied code. Auto-generated when omitted."},"expires_at":{"type":"string","description":"ISO 8601 date.","nullable":true},"user_id":{"type":"string","description":"Optional customer prefixed ID.","nullable":true}}}}}}}},"/api/v3/admin/gift_cards/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Gift card prefixed ID","schema":{"type":"string"}}],"get":{"summary":"Get a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single gift card.\n\n**Required scope:** `read_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"gift card found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCard"}}}},"404":{"description":"gift card not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an active gift card's editable attributes. Redeemed or\npartially-redeemed cards cannot be edited.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftCard"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string"},"expires_at":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true}}}}}}},"delete":{"summary":"Delete a gift card","tags":["Gift Cards"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes an unused gift card. Cards that have been redeemed or\npartially redeemed cannot be deleted and return 422.\n\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","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":"gift card deleted"},"422":{"description":"redeemed gift card cannot be deleted","content":{"application/json":{}}}}}},"/api/v3/admin/markets":{"get":{"summary":"List markets","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the markets configured for the current store. Markets are\nstore-scoped and ordered by `position` (an `acts_as_list` column —\nupdate the order via `PATCH /markets/{id}` with `position`).\n\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `countries`.","schema":{"type":"string"}}],"responses":{"200":{"description":"markets found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Market"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a market","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new market for the current store.\n\n- `country_isos` accepts 2-letter ISO country codes (e.g. `[\"DE\", \"FR\"]`);\n the market must contain at least one country. Unknown codes are\n silently dropped.\n- `supported_locales` accepts an array of locale codes; the\n `default_locale` is always implicitly included.\n- Setting `default: true` automatically demotes the previous default\n market in the store.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":{"schema":{"$ref":"#/components/schemas/Market"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"currency":{"type":"string","description":"ISO 4217 currency code."},"default_locale":{"type":"string","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."},"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."}},"required":["name","currency","default_locale","country_isos"]}}}}}},"/api/v3/admin/markets/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a market","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"market found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Market"}}}},"404":{"description":"market not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a market","tags":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an existing market. Pass `country_isos` to replace the\nmarket's country list (full-set update), `supported_locales` to\nreplace the supported locales, or `position` to reorder the market\nwithin the store.\n\nSetting `default: true` automatically demotes the previous default.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":{"schema":{"$ref":"#/components/schemas/Market"}}}},"422":{"description":"validation error","content":{"application/json":{"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":["Markets"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the market (sets `deleted_at`). The default market and\nthe last remaining market in a store cannot be deleted — both return\n422 with a `validation_error`.\n\n\n**Required scope:** `write_settings` (for API-key authentication).","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":{}}}}}},"/api/v3/admin/option_types":{"get":{"summary":"List option types","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of option types.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,label,position). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"option types found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OptionType"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new option type. Supports nested option values.\n\nOption values can be provided inline and will be created or updated by name.\n\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"option type created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionType"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"},"filterable":{"type":"boolean"},"option_values":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"}}}}},"required":["name","label"]}}}}}},"/api/v3/admin/option_types/{id}":{"get":{"summary":"Get an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single option type by ID, including its option values.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Option type ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,label,position). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"option type found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionType"}}}},"404":{"description":"option type not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an option type. Supports updating nested option values.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Option type ID","schema":{"type":"string"}}],"responses":{"200":{"description":"option type updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionType"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"},"filterable":{"type":"boolean"},"option_values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Existing option value ID to update"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"integer"}}}}}}}}}},"delete":{"summary":"Delete an option type","tags":["Option Types"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes an option type.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Option type ID","schema":{"type":"string"}}],"responses":{"204":{"description":"option type deleted"}}}},"/api/v3/admin/orders/{order_id}/gift_cards":{"post":{"summary":"Apply a gift card to an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Applies a gift card by code to the order. Returns the gift card.\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"gift card applied","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Gift card code"}}}}}}}},"/api/v3/admin/orders/{order_id}/gift_cards/{id}":{"delete":{"summary":"Remove a gift card from an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the gift card from the order.\n\n**Required scope:** `write_gift_cards` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Gift card ID","schema":{"type":"string"}}],"responses":{"204":{"description":"gift card removed"}}}},"/api/v3/admin/orders/{order_id}/items":{"get":{"summary":"List order items","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all line items for an order.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variant, variant.product). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., quantity,price,total). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"items found","content":{"application/json":{}}}}},"post":{"summary":"Add an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new line item to the order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"item added","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["variant_id"],"properties":{"variant_id":{"type":"string","description":"Prefixed variant ID"},"quantity":{"type":"integer","default":1}}}}}}}},"/api/v3/admin/orders/{order_id}/items/{id}":{"get":{"summary":"Show an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns details of a specific line item.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Item ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variant, variant.product). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., quantity,price,total). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"item found","content":{"application/json":{}}}}},"patch":{"summary":"Update an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an order item quantity or metadata.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Item ID","schema":{"type":"string"}}],"responses":{"200":{"description":"item updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"quantity":{"type":"integer"}}}}}}},"delete":{"summary":"Remove an item","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes an item from the order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Item ID","schema":{"type":"string"}}],"responses":{"204":{"description":"line item removed"}}}},"/api/v3/admin/orders/{order_id}/store_credits":{"post":{"summary":"Apply customer's store credit to an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Applies the order customer's available store credit. When `amount` is omitted, applies up to the order outstanding balance.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"store credit applied","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string","description":"Optional explicit amount; defaults to order outstanding balance"}}}}}}},"delete":{"summary":"Remove store credit from an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes any applied store credit from the order.\n\n**Required scope:** `write_store_credits` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"204":{"description":"store credit removed"}}}},"/api/v3/admin/orders":{"get":{"summary":"List orders","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of orders for the current store.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"sort","in":"query","required":false,"description":"Sort field (e.g., created_at, -created_at, completed_at)","schema":{"type":"string"}},{"name":"q[state_eq]","in":"query","required":false,"description":"Filter by state (cart, address, delivery, payment, confirm, complete, canceled)","schema":{"type":"string"}},{"name":"q[email_cont]","in":"query","required":false,"description":"Filter by email (contains)","schema":{"type":"string"}},{"name":"q[number_eq]","in":"query","required":false,"description":"Filter by order number","schema":{"type":"string"}},{"name":"q[completed_at_gt]","in":"query","required":false,"description":"Filter by completed after date","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., items, fulfillments, payments, customer, discounts, billing_address, shipping_address). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,total,status,completed_at). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"orders found","content":{"application/json":{}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a draft order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new draft order in one shot. Customer, items, addresses, currency,\nmarket, channel, locale, notes, metadata, and a coupon code can all be\nprovided inline.\n\nSetting `preferred_stock_location_id` pins the order's preferred fulfillment\nlocation — Order Routing's built-in `PreferredLocation` rule consumes it\nwhen picking which stock location ships each shipment.\n\nInvalid coupon codes are non-fatal — the order is created and the failure\nis reported on the service result (not in the API response body for now).\n\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"order created with preferred_stock_location_id","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"customer_id":{"type":"string","description":"Customer ID. Alias: user_id (legacy)."},"use_customer_default_address":{"type":"boolean","description":"When true with customer_id, copies the customer's saved billing/shipping addresses onto the order."},"currency":{"type":"string"},"market_id":{"type":"string","description":"Market ID"},"channel_id":{"type":"string","description":"Channel ID. Defaults to the store primary channel when omitted."},"preferred_stock_location_id":{"type":"string","description":"Stock Location ID to prefer for fulfillment. Order Routing's built-in PreferredLocation rule reads this and ranks the location first; routing falls back to the next rule when the preferred location can't cover the cart."},"locale":{"type":"string"},"customer_note":{"type":"string","description":"Public, customer-visible note"},"internal_note":{"type":"string","description":"Staff-only note"},"metadata":{"type":"object","description":"Arbitrary key/value metadata"},"shipping_address":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"shipping_address_id":{"type":"string","description":"Existing customer address ID"},"billing_address":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"billing_address_id":{"type":"string","description":"Existing customer address ID"},"items":{"type":"array","items":{"type":"object","required":["variant_id","quantity"],"properties":{"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer"},"metadata":{"type":"object"}}}},"coupon_code":{"type":"string","description":"Optional. Applied non-fatally; invalid codes do not block creation."}}}}}}}},"/api/v3/admin/orders/{id}":{"get":{"summary":"Show an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns full order details including admin-only fields.\n\n**Required scope:** `read_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID (e.g., or_xxx)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., items, fulfillments, payments, customer, discounts, billing_address, shipping_address). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., number,total,status,completed_at). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"order found","content":{"application/json":{}}},"404":{"description":"order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an order. Supports updating email, addresses, special instructions, and line items.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"special_instructions":{"type":"string"},"internal_note":{"type":"string"},"channel_id":{"type":"string","description":"Channel ID"},"preferred_stock_location_id":{"type":"string","description":"Stock Location ID to prefer for fulfillment. Re-runs Order Routing's PreferredLocation rule on subsequent shipment rebuilds."},"ship_address":{"type":"object","properties":{"firstname":{"type":"string"},"lastname":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"zipcode":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"bill_address":{"type":"object","properties":{"firstname":{"type":"string"},"lastname":{"type":"string"},"address1":{"type":"string"},"city":{"type":"string"},"zipcode":{"type":"string"},"country_iso":{"type":"string"},"state_abbr":{"type":"string"},"phone":{"type":"string"}}},"items":{"type":"array","items":{"type":"object","required":["variant_id"],"properties":{"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer"},"metadata":{"type":"object"}}}}}}}}}},"delete":{"summary":"Delete a draft order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a draft order. Completed orders cannot be deleted.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"204":{"description":"order deleted"}}}},"/api/v3/admin/orders/{id}/complete":{"patch":{"summary":"Complete an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Completes an order in the `confirm` state, marking it as placed.\n\nSet `notify_customer: true` to send the order confirmation email.\n\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order completed","content":{"application/json":{}}},"422":{"description":"order cannot be completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"notify_customer":{"type":"boolean","description":"Send the order confirmation email after completion."}}}}}}}},"/api/v3/admin/orders/{id}/cancel":{"patch":{"summary":"Cancel an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Cancels a completed order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order canceled","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{id}/approve":{"patch":{"summary":"Approve an order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Approves an order (e.g., for fraud review).\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order approved","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{id}/resume":{"patch":{"summary":"Resume a canceled order","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Resumes a previously canceled order.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"order resumed","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{id}/resend_confirmation":{"post":{"summary":"Resend confirmation email","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Publishes the order.completed event to trigger confirmation email delivery.\n\n**Required scope:** `write_orders` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"200":{"description":"confirmation resent","content":{"application/json":{}}}}}},"/api/v3/admin/payment_methods":{"get":{"summary":"List payment methods","tags":["Payment Methods"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the store's configured payment methods. Use `source_required: true` to know which methods need a saved source.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,type,active). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payment methods found","content":{"application/json":{}}}}}},"/api/v3/admin/payment_methods/types":{"get":{"summary":"List available payment provider types","tags":["Payment Methods"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the registered Spree::PaymentMethod subclasses that can be used to create new payment methods. Useful for populating a \"Provider\" dropdown in admin UIs.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"provider types found","content":{"application/json":{}}}}}},"/api/v3/admin/payment_methods/{id}":{"get":{"summary":"Show a payment method","tags":["Payment Methods"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a payment method by ID.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand. Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,type,active). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payment method found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/payments":{"get":{"summary":"List payments","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all payments for an order.\n\n**Required scope:** `read_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method, source). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,status,number,response_code). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payments found","content":{"application/json":{}}}}},"post":{"summary":"Create a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new payment for the order.\n\n**Required scope:** `write_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"payment created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["payment_method_id"],"properties":{"payment_method_id":{"type":"string","description":"Payment method ID"},"amount":{"type":"string"},"source_id":{"type":"string","description":"Payment source ID"}}}}}}}},"/api/v3/admin/orders/{order_id}/payments/{id}":{"get":{"summary":"Show a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns details of a specific payment.\n\n**Required scope:** `read_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Payment ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment_method, source). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,status,number,response_code). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"payment found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/payments/{id}/capture":{"patch":{"summary":"Capture a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Captures a pending payment.\n\n**Required scope:** `write_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Payment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"payment captured","content":{"application/json":{}}},"422":{"description":"capture failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/orders/{order_id}/payments/{id}/void":{"patch":{"summary":"Void a payment","tags":["Payments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Voids a payment.\n\n**Required scope:** `write_payments` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Payment ID","schema":{"type":"string"}}],"responses":{"200":{"description":"payment voided","content":{"application/json":{}}}}}},"/api/v3/admin/price_lists":{"get":{"summary":"List price lists","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the price lists configured for the current store.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"schema":{"type":"string"}},{"name":"q[status_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `price_rules`.","schema":{"type":"string"}}],"responses":{"200":{"description":"price lists found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PriceList"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new draft price list.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list created (server-to-server — rules + prices, no product_ids)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true},"ends_at":{"type":"string","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"position":{"type":"integer"},"product_ids":{"type":"array","items":{"type":"string"},"description":"Prefixed product ids to seed the list with."},"rules":{"type":"array","description":"STI-typed price rules to attach on create. Existing rules on the same payload via PATCH reconcile by id.","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"prices":{"type":"array","description":"Server-to-server alternative to `product_ids`: ship the exact per-variant prices the list should contain. Each row upserts on the unique key `(variant_id, currency, price_list_id)`. Mix-and-match with `product_ids` is supported but typically unnecessary — `prices` alone tells the server which variants belong to the list and what the override amount is.","items":{"type":"object","required":["variant_id","currency"],"properties":{"variant_id":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}}}}}},"/api/v3/admin/price_lists/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"price list found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}},"404":{"description":"price list not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a price list. The optional `rules:` array reconciles nested\nSTI-typed price rules in a single round-trip — existing rules update\nby `id`, new rules build, missing rules destroy. Mirrors the\npromotion editor's \"save the whole thing on Save\" pattern.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list updated with nested rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true},"ends_at":{"type":"string","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"position":{"type":"integer"},"product_ids":{"type":"array","items":{"type":"string"},"description":"Prefixed product ids — reconciles list membership (adds + removes)."},"rules":{"type":"array","items":{"type":"object","required":["type"],"properties":{"id":{"type":"string","nullable":true},"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"prices":{"type":"array","description":"Individual price overrides (the spreadsheet payload). Each row updates by `id` if shipped, otherwise upserts on the unique key `(variant_id, currency, price_list_id)`.","items":{"type":"object","oneOf":[{"required":["id"]},{"required":["variant_id","currency"]}],"properties":{"id":{"type":"string"},"variant_id":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}}}}},"delete":{"summary":"Delete a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the price list. Associated prices are removed asynchronously.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list deleted"}}}},"/api/v3/admin/price_lists/{id}/activate":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Activate a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Transitions a draft / inactive list to `active`. If `starts_at` is\nin the future the list is marked `scheduled` instead, matching the\nlegacy admin behaviour.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price list activated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}}}}},"/api/v3/admin/price_lists/{id}/deactivate":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Deactivate a price list","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_products` (for API-key authentication).","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":"price list deactivated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}}}}},"/api/v3/admin/prices":{"get":{"summary":"List prices","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Generic prices endpoint covering both base prices and price-list\noverrides. Filter with Ransack: `q[price_list_id_eq]=…`,\n`q[currency_eq]=USD`, `q[price_list_id_null]=true` (base prices only).\n\nThe admin spreadsheet uses this with server-side pagination so it\nscales past the metadata-PATCH path on `/price_lists/:id`.\n\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"q[price_list_id_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"q[price_list_id_null]","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"q[currency_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"q[variant_id_eq]","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Comma-separated sort keys. Supports e.g. `variant_product_name,variant_id`.","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to embed. Supported: `variant`.","schema":{"type":"string"}}],"responses":{"200":{"description":"prices found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a single price. Omit `price_list_id` to create a base price.\nFor more than a handful of rows, prefer `POST /admin/prices/bulk_upsert`.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["variant_id","currency"],"properties":{"variant_id":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true},"price_list_id":{"type":"string","nullable":true}}}}}}}},"/api/v3/admin/prices/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_products` (for API-key authentication).","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":"price found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}},"404":{"description":"price not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_products` (for API-key authentication).","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":"price updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}},"delete":{"summary":"Delete a price","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the price (acts_as_paranoid).\n\n**Required scope:** `write_products` (for API-key authentication).","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":"price deleted"}}}},"/api/v3/admin/prices/bulk_upsert":{"post":{"summary":"Bulk-upsert prices","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Upserts a batch of prices in a single SQL round trip.\n\nEach row either:\n* targets an existing price by `id`, OR\n* matches on the unique key `(variant_id, currency, price_list_id)` —\n updating the existing row if one exists, creating one otherwise.\n\nModel callbacks (e.g. PriceHistory) are bypassed; this is a\nbulk-write fast path for the admin spreadsheet. The response\ncarries `price_count` — the number of rows touched.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"prices upserted","content":{"application/json":{"schema":{"type":"object","properties":{"price_count":{"type":"integer"}}}}}},"422":{"description":"missing prices key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["prices"],"properties":{"prices":{"type":"array","items":{"type":"object","required":["variant_id","currency"],"properties":{"id":{"type":"string","nullable":true},"variant_id":{"type":"string"},"currency":{"type":"string"},"price_list_id":{"type":"string","nullable":true},"amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true}}}}}}}}}}},"/api/v3/admin/prices/bulk_destroy":{"delete":{"summary":"Bulk-delete prices","tags":["Pricing"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes each price in `ids`. Returns the count actually destroyed.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"prices deleted","content":{"application/json":{"schema":{"type":"object","properties":{"price_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/{product_id}/custom_fields":{"get":{"summary":"List product custom fields","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the product's custom field values.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., custom_field_definition). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,value,namespace). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"custom fields found","content":{"application/json":{}}}}},"post":{"summary":"Create a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Sets a custom field value on the product. Requires an existing CustomFieldDefinition; pass its prefixed `cfdef_…` id.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"custom field created","content":{"application/json":{}}},"422":{"description":"duplicate definition for the same product","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["custom_field_definition_id","value"],"properties":{"custom_field_definition_id":{"type":"string","description":"Prefixed `cfdef_…` id"},"value":{"description":"Value matching the definition's `field_type`"}}}}}}}},"/api/v3/admin/products/{product_id}/custom_fields/{id}":{"get":{"summary":"Show a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., custom_field_definition). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., key,value,namespace). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"custom field found","content":{"application/json":{}}}}},"patch":{"summary":"Update a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates the custom field's `value`. The linked definition cannot be changed — delete and recreate to switch.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"custom field updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["value"],"properties":{"value":{"description":"New value"}}}}}}},"delete":{"summary":"Delete a product custom field","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"custom field deleted"}}}},"/api/v3/admin/products":{"get":{"summary":"List products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of products for the current store.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"sort","in":"query","required":false,"description":"Sort field (e.g., name, -name, price, -price, best_selling)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variants, media, option_types, categories). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,slug,price,status). id is always included.","schema":{"type":"string"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"q[status_eq]","in":"query","required":false,"description":"Filter by status","schema":{"type":"string"}}],"responses":{"200":{"description":"products found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new product. Supports nested variants with prices and option types.\n\nOption types and values are auto-created if they don't exist.\nPrices are upserted by currency. Stock items are upserted by stock location.\n\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"product created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"tax_category_id":{"type":"string","description":"Tax category ID"},"category_ids":{"type":"array","items":{"type":"string"},"description":"Array of category IDs"},"tags":{"type":"array","items":{"type":"string"}},"prices":{"type":"array","description":"Shorthand for a simple (no-options) product: per-currency prices that forward to the product's sole variant. For products with options, set prices per variant under `variants:` instead.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"variants":{"type":"array","description":"Array of variant payloads. Variants can declare multiple option pairs via `options:` and per-currency prices via `prices:`. Stock counts go in `stock_items:` (per stock location).","items":{"type":"object","properties":{"sku":{"type":"string"},"options":{"type":"array","description":"One pair per option type the variant participates in (e.g. size + color). Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}},"required":["name"]}}}}}},"/api/v3/admin/products/{id}":{"get":{"summary":"Get a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single product by ID.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID (e.g., prod_xxx)","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., variants, media, option_types, categories). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., name,slug,price,status). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"product found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"404":{"description":"product not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a product. Only provided fields are updated.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"200":{"description":"product updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"tax_category_id":{"type":"string","description":"Tax category ID"},"category_ids":{"type":"array","items":{"type":"string"},"description":"Array of category IDs"},"tags":{"type":"array","items":{"type":"string"}},"prices":{"type":"array","description":"Shorthand for a simple (no-options) product: per-currency prices that forward to the product's sole variant. For products with options, set prices per variant under `variants:` instead.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"variants":{"type":"array","description":"Array of variant payloads. Variants can declare multiple option pairs via `options:` and per-currency prices via `prices:`. Stock counts go in `stock_items:` (per stock location).","items":{"type":"object","properties":{"sku":{"type":"string"},"options":{"type":"array","description":"One pair per option type the variant participates in (e.g. size + color). Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}}}}}}},"delete":{"summary":"Delete a product","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes a product.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product deleted"}}}},"/api/v3/admin/products/bulk_status_update":{"post":{"summary":"Bulk-update product status","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Sets `status` on each product in `ids`. Reindexes the affected products\nfor search. Cross-store IDs are silently dropped. Returns counts.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"cross-store products silently dropped","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"status":{"type":"string"}}}}}},"422":{"description":"invalid status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","status"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["draft","active","archived"]}}}}}}}},"/api/v3/admin/products/bulk_add_to_categories":{"post":{"summary":"Bulk-add products to categories","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Attaches each product in `ids` to every category (taxon) in `category_ids`.\nCategories from sibling stores are silently ignored.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products added to categories","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"category_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","category_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_from_categories":{"post":{"summary":"Bulk-remove products from categories","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Detaches each product in `ids` from every category in `category_ids`.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products removed from categories","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","category_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_add_to_channels":{"post":{"summary":"Bulk-add products to channels","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Publishes each product in `ids` on every channel in `channel_ids`. Idempotent —\nre-publishing on an existing channel is a no-op. Channels from sibling stores\nare silently ignored.\n\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products published on channels","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"channel_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","channel_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"channel_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_from_channels":{"post":{"summary":"Bulk-remove products from channels","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Unpublishes each product in `ids` from every channel in `channel_ids`.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products unpublished from channels","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"channel_count":{"type":"integer"},"removed":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","channel_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"channel_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_add_tags":{"post":{"summary":"Bulk-add tags to products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds each tag name in `tags` to every product in `ids`. Tags are upserted by name.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"tags added","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"tag_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_tags":{"post":{"summary":"Bulk-remove tags from products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes each tag in `tags` from every product in `ids`.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"tags removed","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","tags"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_destroy":{"delete":{"summary":"Bulk-delete products","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes each product in `ids`. Returns the count actually destroyed.\n\n**Required scope:** `write_products` (for API-key authentication).","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":"products deleted","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/promotions/{promotion_id}/coupon_codes":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List coupon codes for a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the auto-generated coupon codes for a multi-code promotion. Single-code promotions store the code on the promotion itself; this endpoint returns an empty list for them.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"coupon codes found","content":{"application/json":{}}}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_actions":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List actions for a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_promotions` (for API-key authentication).","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":"actions found","content":{"application/json":{}}}}},"post":{"summary":"Create an action on a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new action to a promotion. The `type` is the wire shorthand from `GET /promotion_actions/types` (e.g. `free_shipping`, `create_item_adjustments`). Fully-qualified Ruby class names are also accepted for backward compatibility.\n\n**Required scope:** `write_promotions` (for API-key authentication).","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":"action created","content":{"application/json":{}}},"422":{"description":"unknown action type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}},"required":["type"]}}}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_actions/{id}":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"delete":{"summary":"Delete an action from a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","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":"action deleted"}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_rules":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List rules for a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_promotions` (for API-key authentication).","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":"rules found","content":{"application/json":{}}}}},"post":{"summary":"Create a rule on a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a new rule to a promotion. The `type` is the wire shorthand from `GET /promotion_rules/types` (e.g. `currency`, `item_total`, `product`). Fully-qualified Ruby class names are also accepted for backward compatibility.\n\n**Required scope:** `write_promotions` (for API-key authentication).","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":"rule created with preferences","content":{"application/json":{}}},"422":{"description":"unknown rule type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}},"required":["type"]}}}}}},"/api/v3/admin/promotions/{promotion_id}/promotion_rules/{id}":{"parameters":[{"name":"promotion_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Update a rule's preferences","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","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":"rule updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"preferences":{"type":"object","additionalProperties":true}}}}}}},"delete":{"summary":"Delete a rule from a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","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":"rule deleted"}}}},"/api/v3/admin/promotions":{"get":{"summary":"List promotions","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the store's promotions, including manual coupon and automatic promotions.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"promotions found","content":{"application/json":{}}}}},"post":{"summary":"Create a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new promotion. `code` is required for single-code coupon promotions;\npass `multi_codes: true` with `number_of_codes` to auto-generate a batch.\n\nRules and actions can be created in the same request by passing arrays of\n`{ type, preferences, ... }` rows. The server reconciles to the desired set:\nnew rows are built, existing rows (by `id`) are updated, omitted rows are removed.\n\n\n**Required scope:** `write_promotions` (for API-key authentication).","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":"promotion created with rules and actions","content":{"application/json":{}}},"422":{"description":"invalid params","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"starts_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"usage_limit":{"type":"integer","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"kind":{"type":"string","enum":["coupon_code","automatic"]},"multi_codes":{"type":"boolean"},"number_of_codes":{"type":"integer","nullable":true},"code_prefix":{"type":"string","nullable":true},"promotion_category_id":{"type":"string","nullable":true},"rules":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"product_ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}},"customer_ids":{"type":"array","items":{"type":"string"}}},"required":["type"]}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"calculator":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"required":["type"]}}},"required":["name"]}}}}}},"/api/v3/admin/promotions/{id}":{"get":{"summary":"Show a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_promotions` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"promotion found","content":{"application/json":{}}}}},"patch":{"summary":"Update a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a promotion. The `rules` and `actions` arrays are treated as\na *desired set* — rows with `id` update in place, rows without `id` are\nbuilt fresh, and any existing row not present in the array is destroyed.\nPass `rules: []` or `actions: []` to clear them.\n\n\n**Required scope:** `write_promotions` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"rules and actions cleared with empty arrays","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"starts_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"usage_limit":{"type":"integer","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"kind":{"type":"string","enum":["coupon_code","automatic"]},"promotion_category_id":{"type":"string","nullable":true},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Pass to update an existing rule; omit to build a new one"},"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"product_ids":{"type":"array","items":{"type":"string"}},"category_ids":{"type":"array","items":{"type":"string"}},"customer_ids":{"type":"array","items":{"type":"string"}}},"required":["type"]}},"actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","nullable":true},"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"calculator":{"type":"object","properties":{"type":{"type":"string"},"preferences":{"type":"object","additionalProperties":true}}}},"required":["type"]}}}}}}}},"delete":{"summary":"Delete a promotion","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_promotions` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"promotion deleted"}}}},"/api/v3/admin/promotion_actions/types":{"get":{"summary":"List available promotion action types","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the registered Spree::PromotionAction subclasses with their preference schemas. Used by admin UIs to populate the \"Add action\" picker and render generic preference forms.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"action types found","content":{"application/json":{}}}}}},"/api/v3/admin/promotion_rules/types":{"get":{"summary":"List available promotion rule types","tags":["Promotions"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the registered Spree::PromotionRule subclasses with their preference schemas.\n\n**Required scope:** `read_promotions` (for API-key authentication).","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":"rule types found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/refunds":{"get":{"summary":"List refunds","tags":["Refunds"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all refunds for an order.\n\n**Required scope:** `read_refunds` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., payment, refund_reason). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., amount,reason,transaction_id). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"refunds found","content":{"application/json":{}}}}},"post":{"summary":"Create a refund","tags":["Refunds"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a refund for a payment on the order. The refund is automatically processed via the payment gateway.\n\n**Required scope:** `write_refunds` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order ID","schema":{"type":"string"}}],"responses":{"201":{"description":"refund created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["payment_id","amount"],"properties":{"payment_id":{"type":"string","description":"Payment ID"},"amount":{"type":"string"},"refund_reason_id":{"type":"string","description":"Refund reason ID"}}}}}}}},"/api/v3/admin/store_credit_categories":{"get":{"summary":"List store credit categories","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the configured store credit categories. Categories classify\nstore credits (e.g., \"Goodwill\", \"Gift Card\", \"Refund\") and surface\nin the admin UI as a dropdown when issuing or editing a store\ncredit. Category names matching `Spree::Config[:non_expiring_credit_types]`\nare flagged via `non_expiring: true`.\n\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"store credit categories found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StoreCreditCategory"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/store_credit_categories/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Store credit category ID","schema":{"type":"string"}}],"get":{"summary":"Get a store credit category","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single store credit category by prefixed ID.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"store credit category found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCreditCategory"}}}},"404":{"description":"store credit category not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/store":{"get":{"summary":"Get the current store","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the current store configuration. The store is resolved from the request context (host or admin selection); there is no `id` parameter.\n\n**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"current store","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Store"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update the current store","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates the current store configuration.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"store updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Store"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"preferred_admin_locale":{"type":"string"},"preferred_timezone":{"type":"string"},"preferred_weight_unit":{"type":"string"},"preferred_unit_system":{"type":"string"}}}}}}}},"/api/v3/admin/tags":{"get":{"summary":"List tags","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns tag names for a given taggable type. Used for autocomplete in tag inputs on products, orders, and customers.","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"taggable_type","in":"query","required":true,"description":"Taggable type (`Spree::Product`, `Spree::Order`, or `Spree::User`)","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Optional case-insensitive substring filter","schema":{"type":"string"}}],"responses":{"200":{"description":"tags found","content":{"application/json":{}}},"422":{"description":"invalid taggable type","content":{"application/json":{}}}}}},"/api/v3/admin/admin_users":{"get":{"summary":"List staff","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns admin users with at least one role assignment on the current store.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"staff found","content":{"application/json":{}}}}}},"/api/v3/admin/admin_users/{id}":{"get":{"summary":"Show a staff member","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `read_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"staff member found","content":{"application/json":{}}}}},"patch":{"summary":"Update a staff member","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates name fields and reassigns roles for the current store. `role_ids` is a complete replacement — roles not in the array are removed for this store.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"staff member updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"role_ids":{"type":"array","items":{"type":"string"}}}}}}}},"delete":{"summary":"Remove a staff member from this store","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the user's role assignments on the current store. The account is preserved — the user keeps access to any other stores.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"staff removed from store"}}}},"/api/v3/admin/invitations":{"get":{"summary":"List invitations","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns invitations for the current store, including pending and accepted.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"invitations found","content":{"application/json":{}}}}},"post":{"summary":"Create an invitation","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Invites a teammate by email. The invitation is scoped to the current store and carries the chosen role; on accept, a `RoleUser` is created via the invitation's `after_accept` callback.\n\n**Required scope:** `write_settings` (for API-key authentication).","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":"invitation created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email","role_id"],"properties":{"email":{"type":"string"},"role_id":{"type":"string"}}}}}}}},"/api/v3/admin/invitations/{id}":{"delete":{"summary":"Revoke an invitation","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"invitation revoked"}}}},"/api/v3/admin/invitations/{id}/resend":{"patch":{"summary":"Resend an invitation","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Issues a fresh token and dispatches the invitation email again.\n\n**Required scope:** `write_settings` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"invitation resent","content":{"application/json":{}}}}}},"/api/v3/admin/roles":{"get":{"summary":"List roles","tags":["Staff"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the roles available for staff role pickers. Roles are global, not per-store.\n\n**Required scope:** `read_settings` (for API-key authentication).","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":"roles found","content":{"application/json":{}}}}}},"/api/v3/admin/stock_locations":{"get":{"summary":"List stock locations","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the configured stock locations. Stock locations are global\n(shared across stores). Filter with Ransack predicates such as\n`q[active_eq]`, `q[kind_eq]`, `q[pickup_enabled_eq]`, or\n`q[name_cont]`.\n\nPickup-related attributes (`kind`, `pickup_enabled`,\n`pickup_stock_policy`, `pickup_ready_in_minutes`,\n`pickup_instructions`) drive merchant pickup support at checkout —\ncustomers can collect orders from any active location with\n`pickup_enabled: true`.\n\n\n**Required scope:** `read_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"q[active_eq]","in":"query","required":false,"description":"Filter by active status","schema":{"type":"boolean"}},{"name":"q[kind_eq]","in":"query","required":false,"description":"Filter by kind (built-in: 'warehouse', 'store', 'fulfillment_center')","schema":{"type":"string"}},{"name":"q[pickup_enabled_eq]","in":"query","required":false,"description":"Filter by pickup-enabled flag","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"stock locations found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StockLocation"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new stock location.\n\nSetting `default: true` automatically demotes the previous default\nlocation.\n\n\n**Required scope:** `write_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"stock location created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLocation"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"admin_name":{"type":"string","nullable":true,"description":"Internal name shown only in the admin"},"active":{"type":"boolean"},"default":{"type":"boolean","description":"Setting to true demotes the previous default."},"kind":{"type":"string","enum":["warehouse","store","fulfillment_center"],"description":"Categorizes the location."},"propagate_all_variants":{"type":"boolean"},"backorderable_default":{"type":"boolean"},"address1":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true,"description":"ISO-3166 alpha-2 country code (e.g. \"US\")."},"state_abbr":{"type":"string","nullable":true,"description":"State / province abbreviation (e.g. \"NY\"). Resolved against the selected country."},"state_name":{"type":"string","nullable":true,"description":"Free-text state for countries without a states list."},"pickup_enabled":{"type":"boolean"},"pickup_stock_policy":{"type":"string","enum":["local","any"],"description":"'local' = items at this location only; 'any' = transfer-eligible (ship-to-store)."},"pickup_ready_in_minutes":{"type":"number","nullable":true,"minimum":0},"pickup_instructions":{"type":"string","nullable":true}},"required":["name"]}}}}}},"/api/v3/admin/stock_locations/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Stock location ID","schema":{"type":"string"}}],"get":{"summary":"Get a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single stock location by prefixed ID.\n\n**Required scope:** `read_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"stock location found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLocation"}}}},"404":{"description":"stock location not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates an existing stock location. Same address-field conventions as\nthe create endpoint.\n\nSetting `default: true` automatically demotes the previous default.\n\n\n**Required scope:** `write_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"stock location updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLocation"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"admin_name":{"type":"string","nullable":true},"active":{"type":"boolean"},"default":{"type":"boolean"},"kind":{"type":"string","enum":["warehouse","store","fulfillment_center"]},"propagate_all_variants":{"type":"boolean"},"backorderable_default":{"type":"boolean"},"address1":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true},"state_abbr":{"type":"string","nullable":true},"state_name":{"type":"string","nullable":true},"pickup_enabled":{"type":"boolean"},"pickup_stock_policy":{"type":"string","enum":["local","any"]},"pickup_ready_in_minutes":{"type":"number","nullable":true,"minimum":0},"pickup_instructions":{"type":"string","nullable":true}}}}}}},"delete":{"summary":"Delete a stock location","tags":["Stock Locations"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the stock location (sets `deleted_at`). Existing\nfulfillments that referenced it keep the historical record via\n`Spree::StockLocation.with_deleted`.\n\n\n**Required scope:** `write_stock` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"204":{"description":"stock location deleted"}}}},"/api/v3/admin/products/{product_id}/variants":{"get":{"summary":"List product variants","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of variants for a product, including the master variant.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., images, prices, stock_items, option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., sku,price,stock). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"variants found","content":{"application/json":{}}}}},"post":{"summary":"Create a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new variant for a product. Supports nested prices and stock items.\n\nOption types and values are auto-created if they don't exist.\nPrices are upserted by currency. Stock items are upserted by stock location.\n\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"201":{"description":"variant created","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["options"],"properties":{"sku":{"type":"string"},"cost_price":{"type":"string"},"cost_currency":{"type":"string"},"weight":{"type":"number"},"height":{"type":"number"},"width":{"type":"number"},"depth":{"type":"number"},"weight_unit":{"type":"string"},"dimensions_unit":{"type":"string"},"track_inventory":{"type":"boolean"},"tax_category_id":{"type":"string"},"options":{"type":"array","description":"Required. A variant created here is always non-master, so it must declare at least one option pair (e.g. size + color) or creation fails with 422. One pair per option type the variant participates in. Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"position":{"type":"integer"},"barcode":{"type":"string"},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}}}}},"/api/v3/admin/products/{product_id}/variants/{id}":{"get":{"summary":"Get a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single variant by ID.\n\n**Required scope:** `read_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Variant ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., images, prices, stock_items, option_values). Use dot notation for nested expand (max 4 levels).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include (e.g., sku,price,stock). id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"variant found","content":{"application/json":{}}},"404":{"description":"variant not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a variant. Only provided fields are updated.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Variant ID","schema":{"type":"string"}}],"responses":{"200":{"description":"variant updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"cost_price":{"type":"string"},"cost_currency":{"type":"string"},"weight":{"type":"number"},"height":{"type":"number"},"width":{"type":"number"},"depth":{"type":"number"},"weight_unit":{"type":"string"},"dimensions_unit":{"type":"string"},"track_inventory":{"type":"boolean"},"tax_category_id":{"type":"string"},"options":{"type":"array","description":"One pair per option type the variant participates in (e.g. size + color). Option types and values are auto-created if missing.","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"position":{"type":"integer"},"barcode":{"type":"string"},"prices":{"type":"array","description":"Per-currency prices. Upserted by currency.","items":{"type":"object","required":["currency","amount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true}}}},"stock_items":{"type":"array","description":"Per-stock-location inventory. Upserted by stock_location_id.","items":{"type":"object","required":["stock_location_id","count_on_hand"],"properties":{"stock_location_id":{"type":"string","description":"Stock location ID (e.g. sloc_xxx)"},"count_on_hand":{"type":"integer"},"backorderable":{"type":"boolean"}}}}}}}}}},"delete":{"summary":"Delete a variant","tags":["Variants"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes a variant.\n\n**Required scope:** `write_products` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Variant ID","schema":{"type":"string"}}],"responses":{"204":{"description":"variant deleted"}}}},"/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries":{"parameters":[{"name":"webhook_endpoint_id","in":"path","required":true,"description":"Parent webhook endpoint ID","schema":{"type":"string"}}],"get":{"summary":"List webhook deliveries","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns delivery attempts for the given endpoint, most recent first.\nEach row carries the original request payload, the response code\n(when the receiver replied), the execution time, and any transport\nerror — everything needed to audit failures and decide whether to\nredeliver.\n\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[event_name_eq]","in":"query","required":false,"description":"Filter by event name (exact)","schema":{"type":"string"}},{"name":"q[success_eq]","in":"query","required":false,"description":"Filter by success flag","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-delivered_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"deliveries found","content":{"application/json":{}}},"404":{"description":"parent webhook endpoint not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}":{"parameters":[{"name":"webhook_endpoint_id","in":"path","required":true,"description":"Parent webhook endpoint ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Webhook delivery ID","schema":{"type":"string"}}],"get":{"summary":"Get a webhook delivery","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single delivery attempt with the full request payload and\nthe response body the receiver returned. Use this for ad-hoc debug\nof failed deliveries.\n\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"delivery found","content":{"application/json":{}}},"404":{"description":"delivery not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}/redeliver":{"parameters":[{"name":"webhook_endpoint_id","in":"path","required":true,"description":"Parent webhook endpoint ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Webhook delivery ID to redeliver","schema":{"type":"string"}}],"post":{"summary":"Redeliver a webhook delivery","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new delivery row with the same payload + event_name and\nqueues it. The original row is preserved for audit history.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"redelivery queued","content":{"application/json":{}}}}}},"/api/v3/admin/webhook_endpoints":{"get":{"summary":"List webhook endpoints","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns outbound webhook subscriptions for the current store. Each\nendpoint receives a signed POST when any subscribed event fires.\n`secret_key` is `null` on list reads — the plaintext is delivered\nexactly once on create.\n\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of records per page","schema":{"type":"integer"}},{"name":"q[name_cont]","in":"query","required":false,"description":"Filter by name (contains)","schema":{"type":"string"}},{"name":"q[url_cont]","in":"query","required":false,"description":"Filter by URL (contains)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort by field. Prefix with `-` for descending (e.g., `-created_at`).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoints found","content":{"application/json":{}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a new outbound webhook subscription. The plaintext\n`secret_key` is returned **once** in this response — persist it\nimmediately to verify incoming webhook signatures. Subsequent reads\nreturn `null` for the secret. Pass an empty `subscriptions` array or\nomit it to receive every event.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"webhook endpoint created — secret_key returned once","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"name":{"type":"string"},"url":{"type":"string"},"active":{"type":"boolean"},"subscriptions":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/webhook_endpoints/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"get":{"summary":"Get a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single webhook endpoint by prefixed ID.\n\n**Required scope:** `read_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated list of fields to include. id is always included.","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint found","content":{"application/json":{}}},"404":{"description":"webhook endpoint not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates name, URL, active flag, or the event subscription list.\nToggling `active` here is equivalent to calling `disable`/`enable`\nwithout an audit reason.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint updated","content":{"application/json":{}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"active":{"type":"boolean"},"subscriptions":{"type":"array","items":{"type":"string"}}}}}}}},"delete":{"summary":"Delete a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Soft-deletes the endpoint and stops future deliveries.\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"204":{"description":"webhook endpoint deleted"}}}},"/api/v3/admin/webhook_endpoints/{id}/send_test":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"post":{"summary":"Send a test delivery","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a `webhook.test` delivery record and queues it. Use this to\nverify the endpoint is reachable and your signature verification\naccepts Spree's payloads.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"201":{"description":"test delivery queued","content":{"application/json":{}}}}}},"/api/v3/admin/webhook_endpoints/{id}/enable":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"patch":{"summary":"Re-enable a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Re-enables an endpoint that was manually or automatically disabled.\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint enabled","content":{"application/json":{}}}}}},"/api/v3/admin/webhook_endpoints/{id}/disable":{"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook endpoint ID","schema":{"type":"string"}}],"patch":{"summary":"Disable a webhook endpoint","tags":["Webhooks"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Manually pauses an endpoint. Unlike auto-disable (triggered after\nrepeated delivery failures), no notification email is sent.\n\n\n**Required scope:** `write_webhooks` (for API-key authentication).","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Bearer token for admin authentication","schema":{"type":"string"}}],"responses":{"200":{"description":"webhook endpoint disabled","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}}}}}}}}},"components":{"schemas":{"PaginationMeta":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"count":{"type":"integer","description":"Total number of records"},"pages":{"type":"integer","description":"Total number of pages"},"from":{"type":"integer","description":"Index of first record on this page"},"to":{"type":"integer","description":"Index of last record on this page"},"in":{"type":"integer","description":"Number of records on this page"},"previous":{"type":"integer","nullable":true,"description":"Previous page number"},"next":{"type":"integer","nullable":true,"description":"Next page number"}},"required":["page","limit","count","pages","from","to","in"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","description":"Field-specific validation errors","nullable":true}},"required":["code","message"]}},"required":["error"]},"AuthResponse":{"type":"object","properties":{"token":{"type":"string","description":"JWT access token"},"user":{"$ref":"#/components/schemas/AdminUser"}},"required":["token","user"]},"PermissionRule":{"type":"object","description":"A single permission rule (CanCanCan rule). Rules are applied in order, last-matching-wins.","properties":{"allow":{"type":"boolean","description":"true for `can`, false for `cannot`"},"actions":{"type":"array","items":{"type":"string"},"description":"Action names, e.g. [\"read\", \"update\"] or [\"manage\"]"},"subjects":{"type":"array","items":{"type":"string"},"description":"Subject class names, e.g. [\"Spree::Product\"] or [\"all\"]"},"has_conditions":{"type":"boolean","description":"True if the server-side rule has per-record conditions. The SPA shows the action optimistically and handles 403 from the API."}},"required":["allow","actions","subjects","has_conditions"]},"MeResponse":{"type":"object","description":"Current admin user profile and serialized permissions","properties":{"user":{"$ref":"#/components/schemas/AdminUser"},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/PermissionRule"}}},"required":["user","permissions"]},"CheckoutRequirement":{"type":"object","properties":{"step":{"type":"string","description":"Checkout step this requirement belongs to"},"field":{"type":"string","description":"Field that needs to be satisfied"},"message":{"type":"string","description":"Human-readable requirement message"}},"required":["step","field","message"]},"CartWarning":{"type":"object","description":"A warning about a cart issue (e.g., item removed due to stock change)","properties":{"code":{"type":"string","description":"Machine-readable warning code"},"message":{"type":"string","description":"Human-readable warning message"},"line_item_id":{"type":"string","nullable":true,"description":"Prefixed line item ID (when applicable)"},"variant_id":{"type":"string","nullable":true,"description":"Prefixed variant ID (when applicable)"}},"required":["code","message"]},"FulfillmentManifestItem":{"type":"object","description":"An item within a fulfillment — which line item and how many units are in this fulfillment","properties":{"item_id":{"type":"string","description":"Line item ID"},"variant_id":{"type":"string","description":"Variant ID"},"quantity":{"type":"integer","description":"Quantity in this fulfillment"}},"required":["item_id","variant_id","quantity"]},"AdminUserRoleAssignment":{"type":"object","description":"A role assignment for the current store on a staff member","properties":{"id":{"type":"string","description":"Prefixed role ID"},"name":{"type":"string","description":"Role name"}},"required":["id","name"]},"PreferenceField":{"type":"object","description":"A single configurable preference on a payment method, promotion rule/action, or calculator. The frontend uses `type` + `default` to render a sensible input.","properties":{"key":{"type":"string"},"type":{"type":"string","description":"string | text | password | integer | decimal | boolean | array | hash"},"default":{"description":"Default value (any JSON type), null when there is no default","nullable":true}},"required":["key","type"]},"PromotionActionCalculator":{"type":"object","description":"The action's nested calculator (when the action carries one — null for actions like `free_shipping`)","properties":{"type":{"type":"string","description":"Wire shorthand for the calculator subclass"},"label":{"type":"string"},"preferences":{"type":"object","additionalProperties":true},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}}},"required":["type","label","preferences","preference_schema"]},"PromotionActionLineItem":{"type":"object","description":"One row in a `create_line_items` action — the variant added to the order and how many","properties":{"variant_id":{"type":"string"},"quantity":{"type":"integer"}},"required":["variant_id","quantity"]},"Address":{"type":"object","properties":{"id":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"full_name":{"type":"string"},"address1":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"postal_code":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"country_name":{"type":"string"},"country_iso":{"type":"string"},"state_text":{"type":"string","nullable":true},"state_abbr":{"type":"string","nullable":true},"quick_checkout":{"type":"boolean"},"is_default_billing":{"type":"boolean"},"is_default_shipping":{"type":"boolean"},"state_name":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customer_id":{"type":"string","nullable":true}},"required":["id","first_name","last_name","full_name","address1","address2","postal_code","city","phone","company","country_name","country_iso","state_text","state_abbr","quick_checkout","is_default_billing","is_default_shipping","state_name","label","metadata","created_at","updated_at","customer_id"],"x-typelizer":true},"Adjustment":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"display_amount":{"type":"string"},"included":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"amount":{"type":"string"},"order_id":{"type":"string","nullable":true}},"required":["id","label","display_amount","included","created_at","updated_at","amount","order_id"],"x-typelizer":true},"AdminUser":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"full_name":{"type":"string","nullable":true},"selected_locale":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserRoleAssignment"}}},"required":["id","email","first_name","last_name","full_name","selected_locale","created_at","updated_at","roles"],"x-typelizer":true},"AllowedOrigin":{"type":"object","properties":{"id":{"type":"string"},"origin":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","origin","created_at","updated_at"],"x-typelizer":true},"ApiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_type":{"type":"string"},"token_prefix":{"type":"string","nullable":true},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"revoked_at":{"type":"string","nullable":true},"last_used_at":{"type":"string","nullable":true},"plaintext_token":{"type":"string","nullable":true},"created_by_email":{"type":"string","nullable":true}},"required":["id","name","key_type","token_prefix","scopes","created_at","updated_at","revoked_at","last_used_at","plaintext_token","created_by_email"],"x-typelizer":true},"Category":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"permalink":{"type":"string"},"position":{"type":"number"},"depth":{"type":"number"},"meta_title":{"type":"string","nullable":true},"meta_description":{"type":"string","nullable":true},"meta_keywords":{"type":"string","nullable":true},"children_count":{"type":"number"},"parent_id":{"type":"string","nullable":true},"description":{"type":"string"},"description_html":{"type":"string"},"image_url":{"type":"string","nullable":true},"square_image_url":{"type":"string","nullable":true},"is_root":{"type":"boolean"},"is_child":{"type":"boolean"},"is_leaf":{"type":"boolean"},"parent":{"$ref":"#/components/schemas/Category"},"children":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"ancestors":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"metadata":{"type":"object"},"pretty_name":{"type":"string"},"lft":{"type":"number"},"rgt":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","permalink","position","depth","meta_title","meta_description","meta_keywords","children_count","parent_id","description","description_html","image_url","square_image_url","is_root","is_child","is_leaf","metadata","pretty_name","lft","rgt","created_at","updated_at"],"x-typelizer":true},"Channel":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string"},"active":{"type":"boolean"},"default":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","code","active","default","preferred_order_routing_strategy","created_at","updated_at"],"x-typelizer":true},"Country":{"type":"object","properties":{"iso":{"type":"string"},"iso3":{"type":"string"},"name":{"type":"string"},"states_required":{"type":"boolean"},"zipcode_required":{"type":"boolean"},"states":{"type":"array","items":{"$ref":"#/components/schemas/State"}},"market":{"allOf":[{"$ref":"#/components/schemas/Market"}],"nullable":true},"created_at":{"type":"object"},"updated_at":{"type":"object"}},"required":["iso","iso3","name","states_required","zipcode_required","created_at","updated_at"],"x-typelizer":true},"CouponCode":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"state":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"promotion_id":{"type":"string"},"order_id":{"type":"string","nullable":true}},"required":["id","code","state","created_at","updated_at","promotion_id","order_id"],"x-typelizer":true},"CreditCard":{"type":"object","properties":{"id":{"type":"string"},"brand":{"type":"string"},"last4":{"type":"string"},"month":{"type":"number"},"year":{"type":"number"},"name":{"type":"string","nullable":true},"default":{"type":"boolean"},"gateway_payment_profile_id":{"type":"string","nullable":true},"customer_id":{"type":"string","nullable":true},"payment_method_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","brand","last4","month","year","name","default","gateway_payment_profile_id","customer_id","payment_method_id","metadata","created_at","updated_at"],"x-typelizer":true},"CustomFieldDefinition":{"type":"object","properties":{"id":{"type":"string"},"namespace":{"type":"string"},"key":{"type":"string"},"label":{"type":"string"},"field_type":{"type":"string","enum":["short_text","long_text","rich_text","number","boolean","json"]},"resource_type":{"type":"string"},"storefront_visible":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","namespace","key","label","field_type","resource_type","storefront_visible","created_at","updated_at"],"x-typelizer":true},"CustomField":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"type":{"type":"string","deprecated":true},"field_type":{"type":"string","enum":["short_text","long_text","rich_text","number","boolean","json"]},"key":{"type":"string"},"value":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"storefront_visible":{"type":"boolean"},"custom_field_definition_id":{"type":"string"}},"required":["id","label","type","field_type","key","value","created_at","updated_at","storefront_visible","custom_field_definition_id"],"x-typelizer":true},"CustomerGroup":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"customers_count":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customers":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}}},"required":["id","name","description","customers_count","created_at","updated_at"],"x-typelizer":true},"Customer":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"accepts_email_marketing":{"type":"boolean"},"full_name":{"type":"string"},"available_store_credit_total":{"type":"string"},"display_available_store_credit_total":{"type":"string"},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/Address"}},"default_billing_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"default_shipping_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"login":{"type":"string","nullable":true},"metadata":{"type":"object"},"last_sign_in_at":{"type":"string","nullable":true},"current_sign_in_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"sign_in_count":{"type":"number"},"failed_attempts":{"type":"number"},"last_sign_in_ip":{"type":"string","nullable":true},"current_sign_in_ip":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"internal_note_html":{"type":"string","nullable":true},"default_billing_address_id":{"type":"string","nullable":true},"default_shipping_address_id":{"type":"string","nullable":true},"orders_count":{"type":"number"},"total_spent":{"type":"string"},"display_total_spent":{"type":"string"},"last_order_completed_at":{"type":"string","nullable":true},"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"store_credits":{"type":"array","items":{"$ref":"#/components/schemas/StoreCredit"}},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}}},"required":["id","email","first_name","last_name","phone","accepts_email_marketing","full_name","available_store_credit_total","display_available_store_credit_total","login","metadata","last_sign_in_at","current_sign_in_at","created_at","updated_at","sign_in_count","failed_attempts","last_sign_in_ip","current_sign_in_ip","tags","internal_note_html","default_billing_address_id","default_shipping_address_id","orders_count","total_spent","display_total_spent","last_order_completed_at"],"x-typelizer":true},"DeliveryMethod":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","code","created_at","updated_at"],"x-typelizer":true},"DeliveryRate":{"type":"object","properties":{"id":{"type":"string"},"delivery_method_id":{"type":"string"},"name":{"type":"string"},"selected":{"type":"boolean"},"cost":{"type":"string"},"total":{"type":"string"},"additional_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"tax_total":{"type":"string"},"display_cost":{"type":"string"},"display_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"display_tax_total":{"type":"string"},"delivery_method":{"$ref":"#/components/schemas/DeliveryMethod"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","delivery_method_id","name","selected","cost","total","additional_tax_total","included_tax_total","tax_total","display_cost","display_total","display_additional_tax_total","display_included_tax_total","display_tax_total","created_at","updated_at"],"x-typelizer":true},"DigitalLink":{"type":"object","properties":{"id":{"type":"string"},"access_counter":{"type":"number"},"filename":{"type":"string"},"content_type":{"type":"string"},"download_url":{"type":"string"},"authorizable":{"type":"boolean"},"expired":{"type":"boolean"},"access_limit_exceeded":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","access_counter","filename","content_type","download_url","authorizable","expired","access_limit_exceeded","created_at","updated_at"],"x-typelizer":true},"Discount":{"type":"object","properties":{"id":{"type":"string"},"promotion_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"amount":{"type":"string"},"display_amount":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","promotion_id","name","description","code","amount","display_amount","created_at","updated_at"],"x-typelizer":true},"Export":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"type":{"type":"string","nullable":true},"format":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string","nullable":true},"done":{"type":"boolean"},"filename":{"type":"string","nullable":true},"byte_size":{"type":"number","nullable":true},"download_url":{"type":"string","nullable":true}},"required":["id","number","type","format","created_at","updated_at","user_id","done","filename","byte_size","download_url"],"x-typelizer":true},"Fulfillment":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"tracking":{"type":"string","nullable":true},"tracking_url":{"type":"string","nullable":true},"cost":{"type":"string"},"display_cost":{"type":"string"},"total":{"type":"string"},"display_total":{"type":"string"},"discount_total":{"type":"string"},"display_discount_total":{"type":"string"},"additional_tax_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"tax_total":{"type":"string"},"display_tax_total":{"type":"string"},"status":{"type":"string"},"fulfillment_type":{"type":"string"},"fulfilled_at":{"type":"string","nullable":true},"items":{"type":"array","items":{"$ref":"#/components/schemas/FulfillmentManifestItem"}},"delivery_method":{"$ref":"#/components/schemas/DeliveryMethod"},"stock_location":{"$ref":"#/components/schemas/StockLocation"},"delivery_rates":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryRate"}},"metadata":{"type":"object"},"adjustment_total":{"type":"string"},"pre_tax_amount":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"order_id":{"type":"string","nullable":true},"stock_location_id":{"type":"string","nullable":true},"order":{"$ref":"#/components/schemas/Order"},"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/Adjustment"}}},"required":["id","number","tracking","tracking_url","cost","display_cost","total","display_total","discount_total","display_discount_total","additional_tax_total","display_additional_tax_total","included_tax_total","display_included_tax_total","tax_total","display_tax_total","status","fulfillment_type","fulfilled_at","items","metadata","adjustment_total","pre_tax_amount","created_at","updated_at","order_id","stock_location_id"],"x-typelizer":true},"GiftCardBatch":{"type":"object","properties":{"id":{"type":"string"},"codes_count":{"type":"number"},"currency":{"type":"string","nullable":true},"prefix":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"amount":{"type":"string","nullable":true},"expires_at":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true}},"required":["id","codes_count","currency","prefix","created_at","updated_at","amount","expires_at","created_by_id"],"x-typelizer":true},"GiftCard":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"status":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string"},"amount_used":{"type":"string"},"amount_authorized":{"type":"string"},"amount_remaining":{"type":"string"},"display_amount":{"type":"string"},"display_amount_used":{"type":"string"},"display_amount_remaining":{"type":"string"},"expires_at":{"type":"string","nullable":true},"redeemed_at":{"type":"string","nullable":true},"expired":{"type":"boolean"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customer_id":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true},"customer":{"$ref":"#/components/schemas/Customer"},"created_by":{"$ref":"#/components/schemas/AdminUser"},"gift_card_batch":{"$ref":"#/components/schemas/GiftCardBatch"},"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}}},"required":["id","code","status","currency","amount","amount_used","amount_authorized","amount_remaining","display_amount","display_amount_used","display_amount_remaining","expires_at","redeemed_at","expired","active","created_at","updated_at","customer_id","created_by_id"],"x-typelizer":true},"Invitation":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"expires_at":{"type":"string"},"role_id":{"type":"string"},"role_name":{"type":"string"},"inviter_email":{"type":"string"},"acceptance_url":{"type":"string"},"invitee_exists":{"type":"boolean"},"store":{"type":"object"}},"required":["id","email","status","created_at","updated_at","expires_at","role_id","role_name","inviter_email","acceptance_url","invitee_exists","store"],"x-typelizer":true},"LineItem":{"type":"object","properties":{"id":{"type":"string"},"variant_id":{"type":"string"},"quantity":{"type":"number"},"currency":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"options_text":{"type":"string"},"price":{"type":"string"},"display_price":{"type":"string"},"total":{"type":"string"},"display_total":{"type":"string"},"adjustment_total":{"type":"string"},"display_adjustment_total":{"type":"string"},"additional_tax_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"discount_total":{"type":"string"},"display_discount_total":{"type":"string"},"pre_tax_amount":{"type":"string"},"display_pre_tax_amount":{"type":"string"},"discounted_amount":{"type":"string"},"display_discounted_amount":{"type":"string"},"display_compare_at_amount":{"type":"string","nullable":true},"compare_at_amount":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}},"digital_links":{"type":"array","items":{"$ref":"#/components/schemas/DigitalLink"}},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"cost_price":{"type":"string","nullable":true},"tax_category_id":{"type":"string","nullable":true},"variant":{"$ref":"#/components/schemas/Variant"},"tax_category":{"$ref":"#/components/schemas/TaxCategory"},"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/Adjustment"}}},"required":["id","variant_id","quantity","currency","name","slug","options_text","price","display_price","total","display_total","adjustment_total","display_adjustment_total","additional_tax_total","display_additional_tax_total","included_tax_total","display_included_tax_total","discount_total","display_discount_total","pre_tax_amount","display_pre_tax_amount","discounted_amount","display_discounted_amount","display_compare_at_amount","compare_at_amount","thumbnail_url","option_values","digital_links","metadata","created_at","updated_at","cost_price","tax_category_id"],"x-typelizer":true},"Market":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string"},"default_locale":{"type":"string"},"tax_inclusive":{"type":"boolean"},"default":{"type":"boolean"},"country_isos":{"type":"array","items":{"type":"string"}},"supported_locales":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","currency","default_locale","tax_inclusive","default","country_isos","supported_locales","created_at","updated_at"],"x-typelizer":true},"Media":{"type":"object","properties":{"id":{"type":"string"},"product_id":{"type":"string","nullable":true},"variant_ids":{"type":"array","items":{"type":"string"}},"position":{"type":"number"},"alt":{"type":"string","nullable":true},"media_type":{"type":"string"},"focal_point_x":{"type":"number","nullable":true},"focal_point_y":{"type":"number","nullable":true},"external_video_url":{"type":"string","nullable":true},"original_url":{"type":"string","nullable":true},"mini_url":{"type":"string","nullable":true},"small_url":{"type":"string","nullable":true},"medium_url":{"type":"string","nullable":true},"large_url":{"type":"string","nullable":true},"xlarge_url":{"type":"string","nullable":true},"og_image_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"viewable_id":{"type":"string"},"download_url":{"type":"string","nullable":true},"metadata":{"type":"object"},"viewable_type":{"type":"string"}},"required":["id","product_id","variant_ids","position","alt","media_type","focal_point_x","focal_point_y","external_video_url","original_url","mini_url","small_url","medium_url","large_url","xlarge_url","og_image_url","created_at","updated_at","viewable_id","download_url","metadata","viewable_type"],"x-typelizer":true},"OptionType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"number"},"kind":{"type":"string"},"metadata":{"type":"object"},"filterable":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}}},"required":["id","name","label","position","kind","metadata","filterable","created_at","updated_at"],"x-typelizer":true},"OptionValue":{"type":"object","properties":{"id":{"type":"string"},"option_type_id":{"type":"string"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"number"},"color_code":{"type":"string","nullable":true},"option_type_name":{"type":"string"},"option_type_label":{"type":"string"},"image_url":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"option_type":{"$ref":"#/components/schemas/OptionType"}},"required":["id","option_type_id","name","label","position","color_code","option_type_name","option_type_label","image_url","metadata","created_at","updated_at"],"x-typelizer":true},"Order":{"type":"object","properties":{"id":{"type":"string"},"market_id":{"type":"string","nullable":true},"channel_id":{"type":"string","nullable":true},"number":{"type":"string"},"email":{"type":"string"},"customer_note":{"type":"string","nullable":true},"currency":{"type":"string"},"locale":{"type":"string","nullable":true},"total_quantity":{"type":"number"},"item_total":{"type":"string"},"display_item_total":{"type":"string"},"adjustment_total":{"type":"string"},"display_adjustment_total":{"type":"string"},"discount_total":{"type":"string"},"display_discount_total":{"type":"string"},"tax_total":{"type":"string"},"display_tax_total":{"type":"string"},"included_tax_total":{"type":"string"},"display_included_tax_total":{"type":"string"},"additional_tax_total":{"type":"string"},"display_additional_tax_total":{"type":"string"},"total":{"type":"string"},"display_total":{"type":"string"},"gift_card_total":{"type":"string"},"display_gift_card_total":{"type":"string"},"amount_due":{"type":"string"},"display_amount_due":{"type":"string"},"delivery_total":{"type":"string"},"display_delivery_total":{"type":"string"},"fulfillment_status":{"type":"string","nullable":true},"payment_status":{"type":"string","nullable":true},"completed_at":{"type":"string","nullable":true},"store_credit_total":{"type":"string"},"display_store_credit_total":{"type":"string"},"covered_by_store_credit":{"type":"boolean"},"discounts":{"type":"array","items":{"$ref":"#/components/schemas/Discount"}},"items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"fulfillments":{"type":"array","items":{"$ref":"#/components/schemas/Fulfillment"}},"payments":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}},"billing_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"shipping_address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"gift_card":{"allOf":[{"$ref":"#/components/schemas/GiftCard"}],"nullable":true},"market":{"allOf":[{"$ref":"#/components/schemas/Market"}],"nullable":true},"status":{"type":"string"},"last_ip_address":{"type":"string","nullable":true},"considered_risky":{"type":"boolean"},"confirmation_delivered":{"type":"boolean"},"store_owner_notification_delivered":{"type":"boolean"},"payment_total":{"type":"string"},"display_payment_total":{"type":"string"},"metadata":{"type":"object"},"canceled_at":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"preferred_stock_location_id":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"internal_note":{"type":"string","nullable":true},"approver_id":{"type":"string","nullable":true},"canceler_id":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true},"customer_id":{"type":"string","nullable":true},"channel":{"$ref":"#/components/schemas/Channel"},"preferred_stock_location":{"$ref":"#/components/schemas/StockLocation"},"payment_methods":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethod"}},"customer":{"$ref":"#/components/schemas/Customer"},"approver":{"$ref":"#/components/schemas/Customer"},"canceler":{"$ref":"#/components/schemas/Customer"},"created_by":{"$ref":"#/components/schemas/Customer"},"adjustments":{"type":"array","items":{"$ref":"#/components/schemas/Adjustment"}},"return_authorizations":{"type":"array","items":{"$ref":"#/components/schemas/ReturnAuthorization"}},"reimbursements":{"type":"array","items":{"$ref":"#/components/schemas/Reimbursement"}}},"required":["id","market_id","channel_id","number","email","customer_note","currency","locale","total_quantity","item_total","display_item_total","adjustment_total","display_adjustment_total","discount_total","display_discount_total","tax_total","display_tax_total","included_tax_total","display_included_tax_total","additional_tax_total","display_additional_tax_total","total","display_total","gift_card_total","display_gift_card_total","amount_due","display_amount_due","delivery_total","display_delivery_total","fulfillment_status","payment_status","completed_at","store_credit_total","display_store_credit_total","covered_by_store_credit","gift_card","market","status","last_ip_address","considered_risky","confirmation_delivered","store_owner_notification_delivered","payment_total","display_payment_total","metadata","canceled_at","approved_at","created_at","updated_at","preferred_stock_location_id","tags","internal_note","approver_id","canceler_id","created_by_id","customer_id"],"x-typelizer":true},"PaymentMethod":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"type":{"type":"string"},"session_required":{"type":"boolean"},"source_required":{"type":"boolean"},"metadata":{"type":"object"},"active":{"type":"boolean"},"auto_capture":{"type":"boolean","nullable":true},"storefront_visible":{"type":"boolean"},"position":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"object"}},"required":["id","name","description","type","session_required","source_required","metadata","active","auto_capture","storefront_visible","position","created_at","updated_at","preferences","preference_schema"],"x-typelizer":true},"Payment":{"type":"object","properties":{"id":{"type":"string"},"payment_method_id":{"type":"string"},"response_code":{"type":"string","nullable":true},"number":{"type":"string"},"amount":{"type":"string"},"display_amount":{"type":"string"},"status":{"type":"string"},"source_type":{"type":"string","nullable":true,"enum":["credit_card","store_credit","payment_source"]},"source_id":{"type":"string","nullable":true},"source":{"anyOf":[{"$ref":"#/components/schemas/CreditCard"},{"$ref":"#/components/schemas/StoreCredit"},{"$ref":"#/components/schemas/PaymentSource"}],"nullable":true},"payment_method":{"$ref":"#/components/schemas/PaymentMethod"},"metadata":{"type":"object"},"avs_response":{"type":"string","nullable":true},"cvv_response_code":{"type":"string","nullable":true},"cvv_response_message":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"captured_amount":{"type":"string"},"order_id":{"type":"string","nullable":true},"order":{"$ref":"#/components/schemas/Order"},"refunds":{"type":"array","items":{"$ref":"#/components/schemas/Refund"}}},"required":["id","payment_method_id","response_code","number","amount","display_amount","status","source_type","source_id","source","metadata","avs_response","cvv_response_code","cvv_response_message","created_at","updated_at","captured_amount","order_id"],"x-typelizer":true},"PaymentSource":{"type":"object","properties":{"id":{"type":"string"},"gateway_payment_profile_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","gateway_payment_profile_id","metadata","created_at","updated_at"],"x-typelizer":true},"PriceHistory":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string"},"amount_in_cents":{"type":"number"},"currency":{"type":"string"},"display_amount":{"type":"string"},"recorded_at":{"type":"string"},"variant_id":{"type":"string"},"price_id":{"type":"string"},"compare_at_amount":{"type":"string","nullable":true},"created_at":{"type":"string"}},"required":["id","amount","amount_in_cents","currency","display_amount","recorded_at","variant_id","price_id","compare_at_amount","created_at"],"x-typelizer":true},"PriceList":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string"},"position":{"type":"number"},"match_policy":{"type":"string"},"starts_at":{"type":"string","nullable":true},"ends_at":{"type":"string","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"currently_active":{"type":"boolean"},"products_count":{"type":"number"},"prices_count":{"type":"number"},"product_ids":{"type":"array","items":{"type":"string"}},"price_rules":{"type":"array","items":{"$ref":"#/components/schemas/PriceRule"}}},"required":["id","name","description","status","position","match_policy","starts_at","ends_at","deleted_at","created_at","updated_at","currently_active","products_count","prices_count","product_ids"],"x-typelizer":true},"PriceRule":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"price_list_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}},"label":{"type":"string"},"description":{"type":"string","nullable":true},"markets":{"type":"array","items":{"$ref":"#/components/schemas/Market"}},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"customers":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}}},"required":["id","created_at","updated_at","type","price_list_id","preferences","preference_schema","label","description"],"x-typelizer":true},"Price":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","nullable":true},"amount_in_cents":{"type":"number","nullable":true},"compare_at_amount":{"type":"string","nullable":true},"compare_at_amount_in_cents":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"display_amount":{"type":"string","nullable":true},"display_compare_at_amount":{"type":"string","nullable":true},"price_list_id":{"type":"string","nullable":true},"variant_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"variant":{"$ref":"#/components/schemas/Variant"}},"required":["id","amount","amount_in_cents","compare_at_amount","compare_at_amount_in_cents","currency","display_amount","display_compare_at_amount","price_list_id","variant_id","created_at","updated_at"],"x-typelizer":true},"ProductPublication":{"type":"object","properties":{"id":{"type":"string"},"published_at":{"type":"string","nullable":true},"unpublished_at":{"type":"string","nullable":true},"product_id":{"type":"string"},"channel_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","published_at","unpublished_at","product_id","channel_id","created_at","updated_at"],"x-typelizer":true},"Product":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"meta_title":{"type":"string","nullable":true},"meta_description":{"type":"string","nullable":true},"meta_keywords":{"type":"string","nullable":true},"variant_count":{"type":"number"},"available_on":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"in_stock":{"type":"boolean"},"backorderable":{"type":"boolean"},"available":{"type":"boolean"},"description":{"type":"string","nullable":true},"description_html":{"type":"string","nullable":true},"default_variant_id":{"type":"string"},"thumbnail_url":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"price":{"allOf":[{"$ref":"#/components/schemas/Price"}],"nullable":true},"original_price":{"allOf":[{"$ref":"#/components/schemas/Price"}],"nullable":true},"primary_media":{"$ref":"#/components/schemas/Media"},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"}},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}},"default_variant":{"$ref":"#/components/schemas/Variant"},"option_types":{"type":"array","items":{"$ref":"#/components/schemas/OptionType"}},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}},"categories":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"prior_price":{"allOf":[{"$ref":"#/components/schemas/PriceHistory"}],"nullable":true},"status":{"type":"string"},"metadata":{"type":"object"},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"tax_category_id":{"type":"string","nullable":true},"product_publications":{"type":"array","items":{"$ref":"#/components/schemas/ProductPublication"}},"channels":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}}},"required":["id","name","slug","meta_title","meta_description","meta_keywords","variant_count","available_on","purchasable","in_stock","backorderable","available","description","description_html","default_variant_id","thumbnail_url","tags","price","original_price","status","metadata","deleted_at","created_at","updated_at","tax_category_id"],"x-typelizer":true},"PromotionAction":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"promotion_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}},"label":{"type":"string"},"calculator":{"allOf":[{"$ref":"#/components/schemas/PromotionActionCalculator"}],"nullable":true},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/PromotionActionLineItem"},"nullable":true}},"required":["id","created_at","updated_at","type","promotion_id","preferences","preference_schema","label","calculator","line_items"],"x-typelizer":true},"PromotionRule":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"promotion_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"array","items":{"$ref":"#/components/schemas/PreferenceField"}},"label":{"type":"string"},"product_ids":{"type":"array","items":{"type":"string"},"nullable":true},"category_ids":{"type":"array","items":{"type":"string"},"nullable":true},"customer_ids":{"type":"array","items":{"type":"string"},"nullable":true},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"categories":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"customers":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}},"required":["id","created_at","updated_at","type","promotion_id","preferences","preference_schema","label","product_ids","category_ids","customer_ids"],"x-typelizer":true},"Promotion":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true},"expires_at":{"type":"string","nullable":true},"usage_limit":{"type":"number","nullable":true},"match_policy":{"type":"string","enum":["all","any"]},"path":{"type":"string","nullable":true},"kind":{"type":"string","enum":["coupon_code","automatic"]},"multi_codes":{"type":"boolean"},"number_of_codes":{"type":"number","nullable":true},"code_prefix":{"type":"string","nullable":true},"promotion_category_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"action_ids":{"type":"array","items":{"type":"string"}},"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","code","starts_at","expires_at","usage_limit","match_policy","path","kind","multi_codes","number_of_codes","code_prefix","promotion_category_id","metadata","created_at","updated_at","action_ids","rule_ids"],"x-typelizer":true},"Refund":{"type":"object","properties":{"id":{"type":"string"},"transaction_id":{"type":"string","nullable":true},"amount":{"type":"string","nullable":true},"payment_id":{"type":"string","nullable":true},"refund_reason_id":{"type":"string","nullable":true},"reimbursement_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"payment":{"$ref":"#/components/schemas/Payment"},"reimbursement":{"$ref":"#/components/schemas/Reimbursement"}},"required":["id","transaction_id","amount","payment_id","refund_reason_id","reimbursement_id","metadata","created_at","updated_at"],"x-typelizer":true},"Reimbursement":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"reimbursement_status":{"type":"string","nullable":true},"total":{"type":"string","nullable":true},"order_id":{"type":"string","nullable":true},"customer_return_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"order":{"$ref":"#/components/schemas/Order"}},"required":["id","number","reimbursement_status","total","order_id","customer_return_id","created_at","updated_at"],"x-typelizer":true},"ReturnAuthorization":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"status":{"type":"string"},"order_id":{"type":"string","nullable":true},"stock_location_id":{"type":"string","nullable":true},"return_authorization_reason_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"order":{"$ref":"#/components/schemas/Order"},"stock_location":{"$ref":"#/components/schemas/StockLocation"}},"required":["id","number","status","order_id","stock_location_id","return_authorization_reason_id","created_at","updated_at"],"x-typelizer":true},"Role":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","created_at","updated_at"],"x-typelizer":true},"State":{"type":"object","properties":{"abbr":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"object"},"updated_at":{"type":"object"}},"required":["abbr","name","created_at","updated_at"],"x-typelizer":true},"StockItem":{"type":"object","properties":{"id":{"type":"string"},"count_on_hand":{"type":"number"},"backorderable":{"type":"boolean"},"stock_location_id":{"type":"string","nullable":true},"variant_id":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"allocated_count":{"type":"number"},"available_count":{"type":"number"},"stock_location":{"$ref":"#/components/schemas/StockLocation"},"variant":{"$ref":"#/components/schemas/Variant"}},"required":["id","count_on_hand","backorderable","stock_location_id","variant_id","metadata","created_at","updated_at","allocated_count","available_count"],"x-typelizer":true},"StockLocation":{"type":"object","properties":{"id":{"type":"string"},"state_abbr":{"type":"string","nullable":true},"name":{"type":"string"},"address1":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"zipcode":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true},"country_name":{"type":"string","nullable":true},"state_text":{"type":"string","nullable":true},"admin_name":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"state_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"active":{"type":"boolean"},"default":{"type":"boolean"},"backorderable_default":{"type":"boolean"},"propagate_all_variants":{"type":"boolean"},"kind":{"type":"string"},"pickup_enabled":{"type":"boolean"},"pickup_stock_policy":{"type":"string"},"pickup_ready_in_minutes":{"type":"number","nullable":true},"pickup_instructions":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","state_abbr","name","address1","city","zipcode","country_iso","country_name","state_text","admin_name","address2","state_name","phone","company","active","default","backorderable_default","propagate_all_variants","kind","pickup_enabled","pickup_stock_policy","pickup_ready_in_minutes","pickup_instructions","created_at","updated_at"],"x-typelizer":true},"StockReservation":{"type":"object","properties":{"id":{"type":"string"},"stock_item_id":{"type":"string"},"line_item_id":{"type":"string"},"order_id":{"type":"string"},"variant_id":{"type":"string","nullable":true},"stock_location_id":{"type":"string","nullable":true},"quantity":{"type":"number"},"expires_at":{"type":"string"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","stock_item_id","line_item_id","order_id","variant_id","stock_location_id","quantity","expires_at","active","created_at","updated_at"],"x-typelizer":true},"StockTransfer":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"reference":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"source_location_id":{"type":"string","nullable":true},"destination_location_id":{"type":"string","nullable":true},"source_location":{"$ref":"#/components/schemas/StockLocation"},"destination_location":{"$ref":"#/components/schemas/StockLocation"}},"required":["id","number","reference","metadata","created_at","updated_at","source_location_id","destination_location_id"],"x-typelizer":true},"StoreCreditCategory":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"non_expiring":{"type":"boolean"}},"required":["id","name","created_at","updated_at","non_expiring"],"x-typelizer":true},"StoreCredit":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string"},"amount_used":{"type":"string"},"amount_remaining":{"type":"string"},"display_amount":{"type":"string"},"display_amount_used":{"type":"string"},"display_amount_remaining":{"type":"string"},"currency":{"type":"string"},"memo":{"type":"string","nullable":true},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"customer_id":{"type":"string","nullable":true},"created_by_id":{"type":"string","nullable":true},"category_id":{"type":"string","nullable":true},"category_name":{"type":"string","nullable":true}},"required":["id","amount","amount_used","amount_remaining","display_amount","display_amount_used","display_amount_remaining","currency","memo","metadata","created_at","updated_at","customer_id","created_by_id","category_id","category_name"],"x-typelizer":true},"Store":{"type":"object","properties":{"id":{"type":"string"},"metadata":{"type":"object"},"name":{"type":"string"},"default_currency":{"type":"string"},"default_locale":{"type":"string"},"mail_from_address":{"type":"string","nullable":true},"customer_support_email":{"type":"string","nullable":true},"new_order_notifications_email":{"type":"string","nullable":true},"preferred_send_consumer_transactional_emails":{"type":"boolean"},"preferred_admin_locale":{"type":"string","nullable":true},"preferred_timezone":{"type":"string"},"preferred_weight_unit":{"type":"string"},"preferred_unit_system":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"url":{"type":"string"},"supported_currencies":{"type":"array","items":{"type":"string"}},"supported_locales":{"type":"array","items":{"type":"string"}},"logo_url":{"type":"string","nullable":true},"mailer_logo_url":{"type":"string","nullable":true}},"required":["id","metadata","name","default_currency","default_locale","mail_from_address","customer_support_email","new_order_notifications_email","preferred_send_consumer_transactional_emails","preferred_admin_locale","preferred_timezone","preferred_weight_unit","preferred_unit_system","created_at","updated_at","url","supported_currencies","supported_locales","logo_url","mailer_logo_url"],"x-typelizer":true},"TaxCategory":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"tax_code":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"is_default":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","tax_code","description","is_default","created_at","updated_at"],"x-typelizer":true},"Variant":{"type":"object","properties":{"id":{"type":"string"},"product_id":{"type":"string"},"sku":{"type":"string","nullable":true},"options_text":{"type":"string"},"track_inventory":{"type":"boolean"},"media_count":{"type":"number"},"thumbnail_url":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"in_stock":{"type":"boolean"},"backorderable":{"type":"boolean"},"weight":{"type":"number","nullable":true},"height":{"type":"number","nullable":true},"width":{"type":"number","nullable":true},"depth":{"type":"number","nullable":true},"price":{"$ref":"#/components/schemas/Price"},"original_price":{"allOf":[{"$ref":"#/components/schemas/Price"}],"nullable":true},"primary_media":{"$ref":"#/components/schemas/Media"},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"}},"option_values":{"type":"array","items":{"$ref":"#/components/schemas/OptionValue"}},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"prior_price":{"allOf":[{"$ref":"#/components/schemas/PriceHistory"}],"nullable":true},"metadata":{"type":"object"},"position":{"type":"number"},"cost_price":{"type":"string","nullable":true},"cost_currency":{"type":"string","nullable":true},"barcode":{"type":"string","nullable":true},"weight_unit":{"type":"string","nullable":true},"dimensions_unit":{"type":"string","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"tax_category_id":{"type":"string","nullable":true},"available_stock":{"type":"number","nullable":true},"reserved_quantity":{"type":"number"},"total_on_hand":{"type":"number","nullable":true},"product_name":{"type":"string"},"prices":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"stock_items":{"type":"array","items":{"$ref":"#/components/schemas/StockItem"}}},"required":["id","product_id","sku","options_text","track_inventory","media_count","thumbnail_url","purchasable","in_stock","backorderable","weight","height","width","depth","price","original_price","option_values","metadata","position","cost_price","cost_currency","barcode","weight_unit","dimensions_unit","deleted_at","created_at","updated_at","tax_category_id","available_stock","reserved_quantity","total_on_hand","product_name"],"x-typelizer":true},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string"},"event_name":{"type":"string"},"event_id":{"type":"string","nullable":true},"response_code":{"type":"number","nullable":true},"execution_time":{"type":"number","nullable":true},"error_type":{"type":"string","nullable":true},"request_errors":{"type":"string","nullable":true},"response_body":{"type":"string","nullable":true},"success":{"type":"boolean","nullable":true},"payload":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"delivered_at":{"type":"string","nullable":true},"webhook_endpoint_id":{"type":"string"},"webhook_endpoint_url":{"type":"string"}},"required":["id","event_name","event_id","response_code","execution_time","error_type","request_errors","response_body","success","payload","created_at","updated_at","delivered_at","webhook_endpoint_id","webhook_endpoint_url"],"x-typelizer":true},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"url":{"type":"string"},"active":{"type":"boolean"},"subscriptions":{"type":"array","items":{"type":"string"}},"disabled_reason":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"disabled_at":{"type":"string","nullable":true},"secret_key":{"type":"string","nullable":true},"last_delivery_at":{"type":"string","nullable":true},"recent_delivery_count":{"type":"number"},"recent_failure_count":{"type":"number"},"total_delivery_count":{"type":"number"},"successful_delivery_count":{"type":"number"},"failed_delivery_count":{"type":"number"}},"required":["id","name","url","active","subscriptions","disabled_reason","created_at","updated_at","disabled_at","secret_key","last_delivery_at","recent_delivery_count","recent_failure_count","total_delivery_count","successful_delivery_count","failed_delivery_count"],"x-typelizer":true}}}}\ No newline at end of filediff --git a/packages/dashboard-core/src/components/country-combobox.tsx b/packages/dashboard-core/src/components/country-combobox.tsxindex b39d4f62e1..535595eafe 100644--- a/packages/dashboard-core/src/components/country-combobox.tsx+++ b/packages/dashboard-core/src/components/country-combobox.tsx@@ -16,9 +16,20 @@ import {import { useMemo, useState } from 'react'import { useTranslation } from 'react-i18next'import { useCountries } from '../hooks/use-countries'+import { useDisplayName } from '../hooks/use-display-name'export type CountryOption = { iso: string; iso3: string; name: string }+/**+ * Resolves a country's display name in the admin UI language (keyed on the+ * stable ISO code), falling back to the API's backend-locale `name` when the+ * runtime lacks coverage.+ */+function useCountryDisplayName() {+ const displayName = useDisplayName('region')+ return (country: CountryOption) => displayName(country.iso) ?? country.name+}+/*** Case-insensitive substring match against name, iso, and iso3 so the user* can find a country by typing "United States", "US", or "USA". Both pickers@@ -37,15 +48,32 @@ export function countryFilter(item: CountryOption, query: string): boolean {}/**- * Shared dropdown row used by both pickers — flag + name + ISO code in a- * muted suffix. The ISO code makes ISO-based matches (typing "US"/"USA")+ * Filter that also matches the LOCALIZED country name shown to the user (not+ * just the raw backend `name` / ISO codes), so typing a translated label finds+ * its country. Memoized on the display-name resolver.+ */+function useCountryFilter() {+ const countryName = useCountryDisplayName()+ return useMemo(+ () => (item: CountryOption, query: string) => {+ const q = query.trim().toLowerCase()+ if (!q) return true+ return countryName(item).toLowerCase().includes(q) || countryFilter(item, query)+ },+ [countryName],+ )+}++/**+ * Shared dropdown row used by both pickers — flag + localized name + ISO code+ * in a muted suffix. The ISO code makes ISO-based matches (typing "US"/"USA")* comprehensible and keeps the two pickers visually consistent.*/-function CountryRow({ country }: { country: CountryOption }) {+function CountryRow({ country, label }: { country: CountryOption; label: string }) {return (<span className="flex items-center gap-3"><CountryFlag iso={country.iso} />- <span>{country.name}</span>+ <span>{label}</span>{country.iso && <span className="text-xs text-muted-foreground">({country.iso})</span>}</span>)@@ -69,6 +97,8 @@ export function CountryCombobox({}) {const { t } = useTranslation()const { countries } = useCountries()+ const countryName = useCountryDisplayName()+ const filter = useCountryFilter()const items: CountryOption[] = useMemo(() => countries.map((c) => ({ iso: c.iso, iso3: c.iso3, name: c.name })),@@ -84,12 +114,12 @@ export function CountryCombobox({items={items}value={selected}onValueChange={(c: CountryOption | null) => onValueChange(c?.iso ?? '')}- itemToStringLabel={(c: CountryOption | null) => c?.name ?? ''}+ itemToStringLabel={(c: CountryOption | null) => (c ? countryName(c) : '')}itemToStringValue={(c: CountryOption | null) => c?.iso ?? ''}disabled={disabled}- // Default filter matches name only via `itemToStringLabel`. Widen it so- // typing the ISO code ("US", "USA") also matches.- filter={countryFilter}+ // Matches the localized name, the raw name, and both ISO codes so typing+ // "Allemagne", "Germany", "DE", or "DEU" all find the country.+ filter={filter}><ComboboxInputplaceholder={placeholder ?? t('admin.components.country_combobox.search_placeholder')}@@ -110,7 +140,7 @@ export function CountryCombobox({<ComboboxList>{(country: CountryOption) => (<ComboboxItem key={country.iso} value={country}>- <CountryRow country={country} />+ <CountryRow country={country} label={countryName(country)} /></ComboboxItem>)}</ComboboxList>@@ -143,6 +173,8 @@ export function CountryMultiCombobox({}) {const { t } = useTranslation()const { countries } = useCountries()+ const countryName = useCountryDisplayName()+ const filter = useCountryFilter()const anchorRef = useComboboxAnchor()const [inputValue, setInputValue] = useState('')@@ -168,10 +200,10 @@ export function CountryMultiCombobox({onValueChange(next.map((c) => c.iso))setInputValue('')}}- itemToStringLabel={(c: CountryOption | null) => c?.name ?? ''}+ itemToStringLabel={(c: CountryOption | null) => (c ? countryName(c) : '')}itemToStringValue={(c: CountryOption | null) => c?.iso ?? ''}isItemEqualToValue={(a: CountryOption, b: CountryOption) => a.iso === b.iso}- filter={countryFilter}+ filter={filter}disabled={disabled}><ComboboxChips ref={anchorRef}>@@ -180,7 +212,7 @@ export function CountryMultiCombobox({selectedCountries.map((c) => (<ComboboxChip key={c.iso}>{c.iso && <CountryFlag iso={c.iso} className="mr-2" />}- {c.name}+ {countryName(c)}</ComboboxChip>))}@@ -196,7 +228,7 @@ export function CountryMultiCombobox({<ComboboxList>{(country: CountryOption) => (<ComboboxItem key={country.iso} value={country}>- <CountryRow country={country} />+ <CountryRow country={country} label={countryName(country)} /></ComboboxItem>)}</ComboboxList>diff --git a/packages/dashboard-core/src/components/currency-select.tsx b/packages/dashboard-core/src/components/currency-select.tsxindex df0d43377b..0c0dc5fb30 100644--- a/packages/dashboard-core/src/components/currency-select.tsx+++ b/packages/dashboard-core/src/components/currency-select.tsx@@ -1,6 +1,7 @@import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@spree/dashboard-ui'-import { useMemo, useState } from 'react'+import { useState } from 'react'import { useTranslation } from 'react-i18next'+import { useDisplayName } from '../hooks/use-display-name'import { useStore } from '../providers/store-provider'interface CurrencySelectProps {@@ -19,30 +20,12 @@ interface CurrencySelectProps {disabled?: boolean}-/**- * Resolves a currency code (`USD`) to its localized display name (`United- * States Dollar`) via the browser's built-in `Intl.DisplayNames`. Falls- * back to the code itself when the runtime lacks coverage (very old- * browsers, exotic codes) so the user always sees something.- */-function useCurrencyDisplayName(locale: string) {- return useMemo(() => {- try {- const formatter = new Intl.DisplayNames([locale, 'en'], { type: 'currency' })- return (code: string) => formatter.of(code) ?? code- } catch {- return (code: string) => code- }- }, [locale])-}-/*** Picker for one of the current store's `supported_currencies`. Defaults to* the store's `default_currency` so callers don't have to wire it up* themselves. Each option reads `CODE — Full Name` (e.g.- * `USD — United States Dollar`), localized via the browser's- * `Intl.DisplayNames` against the store's `default_locale`. Use this- * anywhere the merchant is choosing a currency for an admin-side action+ * `USD — US Dollar`), with the name localized to the admin UI language. Use+ * this anywhere the merchant is choosing a currency for an admin-side action* (issuing store credit, recording a refund, manual money entry on an* order, etc.).*/@@ -56,7 +39,7 @@ export function CurrencySelect({disabled,}: CurrencySelectProps) {const { t } = useTranslation()- const { currencies, defaultCurrency, defaultLocale } = useStore()+ const { currencies, defaultCurrency } = useStore()const [internalValue, setInternalValue] = useState(defaultValue ?? defaultCurrency)const isControlled = controlledValue !== undefined// Controlled callers that pass an empty value still see the store default@@ -64,7 +47,7 @@ export function CurrencySelect({// fallback during render dirties forms and re-triggers effects. The caller// gets the real value the first time the merchant interacts.const value = isControlled ? controlledValue || defaultCurrency : internalValue- const displayNameFor = useCurrencyDisplayName(defaultLocale)+ const displayNameFor = useDisplayName('currency')const handleChange = (next: string) => {if (!isControlled) setInternalValue(next)@@ -73,7 +56,8 @@ export function CurrencySelect({const renderOption = (code: string) => {const name = displayNameFor(code)- return name === code ? code : `${code} — ${name}`+ // Avoid `USD — USD` when the resolver falls back to the code itself.+ return name && name !== code ? `${code} — ${name}` : code}return (diff --git a/packages/dashboard-core/src/components/export-button.tsx b/packages/dashboard-core/src/components/export-button.tsxindex 01264fa470..5bca93db14 100644--- a/packages/dashboard-core/src/components/export-button.tsx+++ b/packages/dashboard-core/src/components/export-button.tsx@@ -16,8 +16,10 @@ import {RadioGroup,RadioGroupItem,} from '@spree/dashboard-ui'+import type { TFunction } from 'i18next'import { DownloadIcon, FilterIcon, GlobeIcon } from 'lucide-react'import { useState } from 'react'+import { useTranslation } from 'react-i18next'import { useExport } from '../hooks/use-export'import { filtersToRansack } from '../lib/filters-to-ransack'import type { ResourceActionsContext } from './resource-table'@@ -25,7 +27,7 @@ import type { ResourceActionsContext } from './resource-table'interface ExportButtonProps extends ResourceActionsContext {/** Which dataset to export. Server validates against `Spree::Export.available_types`. */type: ExportType- /** Label shown on the button. Defaults to "Export". */+ /** Label shown on the button. Defaults to the translated "Export" action. */label?: string}@@ -33,13 +35,14 @@ type Selection = 'filtered' | 'all'export function ExportButton({type,- label = 'Export',+ label,filters,search,searchParam,columns,totalCount,}: ExportButtonProps) {+ const { t } = useTranslation()const [open, setOpen] = useState(false)const [selection, setSelection] = useState<Selection>('filtered')const exportMutation = useExport()@@ -70,17 +73,14 @@ export function ExportButton({disabled={exportMutation.isPending}><DownloadIcon className="size-4" />- {label}+ {label ?? t('admin.actions.export')}</Button><Dialog open={open} onOpenChange={setOpen}><DialogContent><DialogHeader>- <DialogTitle>Export to CSV</DialogTitle>- <DialogDescription>- We'll prepare your CSV in the background and download it as soon as it's ready. If it- takes a while you'll get an email link too.- </DialogDescription>+ <DialogTitle>{t('admin.components.export_button.title')}</DialogTitle>+ <DialogDescription>{t('admin.components.export_button.description')}</DialogDescription></DialogHeader><DialogBody>@@ -91,24 +91,24 @@ export function ExportButton({<ChoiceCardvalue="filtered"icon={<FilterIcon className="size-4" />}- title="Current filter"- description={describeFiltered(hasActiveFilter, totalCount)}+ title={t('admin.components.export_button.filtered.title')}+ description={describeFiltered(t, hasActiveFilter, totalCount)}/><ChoiceCardvalue="all"icon={<GlobeIcon className="size-4" />}- title="All records"- description="Ignore filters and export everything in this store."+ title={t('admin.components.export_button.all.title')}+ description={t('admin.components.export_button.all.description')}/></RadioGroup></DialogBody><DialogFooter><Button variant="outline" onClick={() => setOpen(false)}>- Cancel+ {t('admin.actions.cancel')}</Button><Button onClick={handleExport} disabled={exportMutation.isPending}>- {exportMutation.isPending ? 'Exporting…' : 'Export'}+ {exportMutation.isPending ? t('admin.actions.exporting') : t('admin.actions.export')}</Button></DialogFooter></DialogContent>@@ -117,11 +117,17 @@ export function ExportButton({)}-function describeFiltered(hasActiveFilter: boolean, totalCount: number | undefined): string {- if (!hasActiveFilter) return 'No filter active — same as exporting all records.'- if (totalCount === undefined) return 'Export the records matching your current filter.'- const noun = totalCount === 1 ? 'record' : 'records'- return `Export the ${totalCount.toLocaleString()} ${noun} matching your current filter.`+function describeFiltered(+ t: TFunction,+ hasActiveFilter: boolean,+ totalCount: number | undefined,+): string {+ if (!hasActiveFilter) return t('admin.components.export_button.filtered.no_filter')+ if (totalCount === undefined) return t('admin.components.export_button.filtered.unknown_count')+ return t('admin.components.export_button.filtered.count', {+ count: totalCount,+ formattedCount: totalCount.toLocaleString(),+ })}function ChoiceCard({diff --git a/packages/dashboard-core/src/components/locale-select.tsx b/packages/dashboard-core/src/components/locale-select.tsxindex d61cebab7d..78d8d355fd 100644--- a/packages/dashboard-core/src/components/locale-select.tsx+++ b/packages/dashboard-core/src/components/locale-select.tsx@@ -17,6 +17,7 @@ import {} from '@spree/dashboard-ui'import { useMemo, useState } from 'react'import { useTranslation } from 'react-i18next'+import { useDisplayName } from '../hooks/use-display-name'import { useStore } from '../providers/store-provider'interface BaseProps {@@ -47,20 +48,13 @@ interface MultiProps extends BaseProps {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.+ * Resolves a locale code (`en`, `pt-BR`) to its display name (`English`,+ * `Portuguese (Brazil)`) in the admin UI language, falling back to the code+ * itself when the runtime lacks coverage.*/-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])+function useLocaleDisplayName() {+ const displayName = useDisplayName('language')+ return (code: string) => displayName(code) ?? code}/** Mirrors `CurrencySelect`'s row format: `CODE — Localized Name`. */@@ -76,8 +70,7 @@ function formatOption(code: string, name: string) {* has no entry.*/export function LocaleLabel({ code }: { code: string }) {- const { defaultLocale } = useStore()- const displayNameFor = useLocaleDisplayName(defaultLocale)+ const displayNameFor = useLocaleDisplayName()if (!code) return nullreturn <>{formatOption(code, displayNameFor(code))}</>}@@ -92,8 +85,8 @@ export function LocaleLabel({ code }: { code: string }) {*/export function LocaleSelect(props: LocaleSelectProps) {const { t } = useTranslation()- const { locales: storeLocales, defaultLocale } = useStore()- const displayNameFor = useLocaleDisplayName(defaultLocale)+ const { locales: storeLocales } = useStore()+ const displayNameFor = useLocaleDisplayName()// Union of `props.options` (everything the picker should show) and the// currently selected values — so editing an existing record doesn'tdiff --git a/packages/dashboard-core/src/components/page-header.tsx b/packages/dashboard-core/src/components/page-header.tsxindex a75c57831f..8145dbca1e 100644--- a/packages/dashboard-core/src/components/page-header.tsx+++ b/packages/dashboard-core/src/components/page-header.tsx@@ -218,11 +218,21 @@ function PageActionsDropdown({{onOpenJson && (<DropdownMenuItem onClick={onOpenJson}><BracesIcon className="size-4" />- View as JSON+ {t('admin.components.page_header.view_as_json')}</DropdownMenuItem>)}- {resource?.number && <CopyToClipboardItem label="Copy number" value={resource.number} />}- {resource && <CopyToClipboardItem label="Copy ID" value={resource.id} />}+ {resource?.number && (+ <CopyToClipboardItem+ label={t('admin.components.page_header.copy_number')}+ value={resource.number}+ />+ )}+ {resource && (+ <CopyToClipboardItem+ label={t('admin.components.page_header.copy_id')}+ value={resource.id}+ />+ )}{onDelete && (<>diff --git a/packages/dashboard-core/src/components/preferences-form.tsx b/packages/dashboard-core/src/components/preferences-form.tsxindex a65666e269..392867af80 100644--- a/packages/dashboard-core/src/components/preferences-form.tsx+++ b/packages/dashboard-core/src/components/preferences-form.tsx@@ -109,9 +109,14 @@ export function PreferenceField({onChange,redactPasswords,}: PreferenceFieldProps) {- const { t } = useTranslation()+ const { t, i18n } = useTranslation()const id = `preference-${field.key}`- const displayLabel = label ?? humanizeKey(field.key)+ // Localize the field label from the preference key when no explicit+ // override is given, falling back to a humanized key for custom/extension+ // preferences that ship no translation.+ const preferenceKey = `admin.preferences.${field.key}`+ const displayLabel =+ label ?? (i18n.exists(preferenceKey) ? t(preferenceKey) : humanizeKey(field.key))// Currency-typed preferences (`currency`, `default_currency`,// `display_currency`, …) get the store's CurrencySelect — samediff --git a/packages/dashboard-core/src/components/store-switcher.tsx b/packages/dashboard-core/src/components/store-switcher.tsxindex 16a730a63a..607aad65f4 100644--- a/packages/dashboard-core/src/components/store-switcher.tsx+++ b/packages/dashboard-core/src/components/store-switcher.tsx@@ -12,9 +12,11 @@ import {useSidebar,} from '@spree/dashboard-ui'import { ChevronsUpDownIcon, ExternalLinkIcon } from 'lucide-react'+import { useTranslation } from 'react-i18next'import { useStore } from '../providers/store-provider'export function StoreSwitcher() {+ const { t } = useTranslation()const { isMobile, state } = useSidebar()const isCollapsed = state === 'collapsed'@@ -58,7 +60,7 @@ export function StoreSwitcher() {><DropdownMenuItem><ExternalLinkIcon className="size-4" />- View Store+ {t('admin.account.view_store')}</DropdownMenuItem></DropdownMenuContent></DropdownMenu>diff --git a/packages/dashboard-core/src/components/table-toolbar.tsx b/packages/dashboard-core/src/components/table-toolbar.tsxindex 14c4cfab3e..549daeef23 100644--- a/packages/dashboard-core/src/components/table-toolbar.tsx+++ b/packages/dashboard-core/src/components/table-toolbar.tsx@@ -71,54 +71,56 @@ interface TableToolbarProps {// Operators// ============================================================================-const operatorsByType: Record<string, { value: string; label: string }[]> = {+// Operator labels are stored as i18n keys (`admin.components.table_toolbar.operators.*`)+// and resolved with `t()` at render time so they follow the active language.+const operatorsByType: Record<string, { value: string; labelKey: string }[]> = {string: [- { value: 'cont', label: 'contains' },- { value: 'eq', label: 'equals' },- { value: 'not_eq', label: 'does not equal' },- { value: 'start', label: 'starts with' },- { value: 'end', label: 'ends with' },- { value: 'present', label: 'is set' },- { value: 'blank', label: 'is not set' },+ { value: 'cont', labelKey: 'admin.components.table_toolbar.operators.contains' },+ { value: 'eq', labelKey: 'admin.components.table_toolbar.operators.equals' },+ { value: 'not_eq', labelKey: 'admin.components.table_toolbar.operators.does_not_equal' },+ { value: 'start', labelKey: 'admin.components.table_toolbar.operators.starts_with' },+ { value: 'end', labelKey: 'admin.components.table_toolbar.operators.ends_with' },+ { value: 'present', labelKey: 'admin.components.table_toolbar.operators.is_set' },+ { value: 'blank', labelKey: 'admin.components.table_toolbar.operators.is_not_set' },],enum: [- { value: 'eq', label: 'is' },- { value: 'not_eq', label: 'is not' },- { value: 'in', label: 'is any of' },- { value: 'not_in', label: 'is none of' },+ { value: 'eq', labelKey: 'admin.components.table_toolbar.operators.is' },+ { value: 'not_eq', labelKey: 'admin.components.table_toolbar.operators.is_not' },+ { value: 'in', labelKey: 'admin.components.table_toolbar.operators.is_any_of' },+ { value: 'not_in', labelKey: 'admin.components.table_toolbar.operators.is_none_of' },],- boolean: [{ value: 'eq', label: 'is' }],+ boolean: [{ value: 'eq', labelKey: 'admin.components.table_toolbar.operators.is' }],number: [- { value: 'eq', label: 'equals' },- { value: 'gt', label: 'greater than' },- { value: 'gteq', label: 'greater than or equal' },- { value: 'lt', label: 'less than' },- { value: 'lteq', label: 'less than or equal' },+ { value: 'eq', labelKey: 'admin.components.table_toolbar.operators.equals' },+ { value: 'gt', labelKey: 'admin.components.table_toolbar.operators.greater_than' },+ { value: 'gteq', labelKey: 'admin.components.table_toolbar.operators.greater_than_or_equal' },+ { value: 'lt', labelKey: 'admin.components.table_toolbar.operators.less_than' },+ { value: 'lteq', labelKey: 'admin.components.table_toolbar.operators.less_than_or_equal' },],date: [- { value: 'eq', label: 'is' },- { value: 'gt', label: 'after' },- { value: 'lt', label: 'before' },- { value: 'gteq', label: 'on or after' },- { value: 'lteq', label: 'on or before' },+ { value: 'eq', labelKey: 'admin.components.table_toolbar.operators.is' },+ { value: 'gt', labelKey: 'admin.components.table_toolbar.operators.after' },+ { value: 'lt', labelKey: 'admin.components.table_toolbar.operators.before' },+ { value: 'gteq', labelKey: 'admin.components.table_toolbar.operators.on_or_after' },+ { value: 'lteq', labelKey: 'admin.components.table_toolbar.operators.on_or_before' },],resource: [- { value: 'in', label: 'is any of' },- { value: 'not_in', label: 'is none of' },+ { value: 'in', labelKey: 'admin.components.table_toolbar.operators.is_any_of' },+ { value: 'not_in', labelKey: 'admin.components.table_toolbar.operators.is_none_of' },],// Tag names round-trip as CSV; `filtersToRansack` decodes to the// `tags_name_in` / `tags_name_not_in` predicate when emitting Ransack.tags: [- { value: 'in', label: 'is any of' },- { value: 'not_in', label: 'is none of' },+ { value: 'in', labelKey: 'admin.components.table_toolbar.operators.is_any_of' },+ { value: 'not_in', labelKey: 'admin.components.table_toolbar.operators.is_none_of' },],// Same shape as `enum` — the value picker just sources its option list// from the active store's `supported_currencies`.currency: [- { value: 'eq', label: 'is' },- { value: 'not_eq', label: 'is not' },- { value: 'in', label: 'is any of' },- { value: 'not_in', label: 'is none of' },+ { value: 'eq', labelKey: 'admin.components.table_toolbar.operators.is' },+ { value: 'not_eq', labelKey: 'admin.components.table_toolbar.operators.is_not' },+ { value: 'in', labelKey: 'admin.components.table_toolbar.operators.is_any_of' },+ { value: 'not_in', labelKey: 'admin.components.table_toolbar.operators.is_none_of' },],}@@ -259,7 +261,7 @@ export function TableToolbar({className="text-xs text-muted-foreground hover:text-foreground"onClick={() => onFiltersChange([])}>- Clear all+ {t('admin.components.table_toolbar.clear_all')}</button></div>)}@@ -280,8 +282,10 @@ function FilterChip({col: ColumnDef | undefinedonRemove: () => void}) {+ const { t } = useTranslation()const ops = getOperators(col?.filterType ?? 'string')- const opLabel = ops.find((o) => o.value === filter.operator)?.label ?? filter.operator+ const opLabelKey = ops.find((o) => o.value === filter.operator)?.labelKey+ const opLabel = opLabelKey ? t(opLabelKey) : filter.operatorconst showValue = !noValueOperators.includes(filter.operator)return (@@ -440,6 +444,7 @@ function SortDropdown({sort: SortOptiononSortChange: (sort: SortOption) => void}) {+ const { t } = useTranslation()const currentCol = columns.find((c) => c.key === sort.field)return (@@ -452,10 +457,12 @@ function SortDropdown({</Button></DropdownMenuTrigger></TooltipTrigger>- <TooltipContent>{currentCol?.label ?? 'Sort'}</TooltipContent>+ <TooltipContent>+ {currentCol?.label ?? t('admin.components.table_toolbar.sort_tooltip')}+ </TooltipContent></Tooltip><DropdownMenuContent align="end" className="min-w-48">- <DropdownMenuLabel>Sort by</DropdownMenuLabel>+ <DropdownMenuLabel>{t('admin.components.table_toolbar.sort_by')}</DropdownMenuLabel><DropdownMenuSeparator /><DropdownMenuRadioGroupvalue={sort.field}@@ -468,7 +475,7 @@ function SortDropdown({))}</DropdownMenuRadioGroup><DropdownMenuSeparator />- <DropdownMenuLabel>Order</DropdownMenuLabel>+ <DropdownMenuLabel>{t('admin.components.table_toolbar.order')}</DropdownMenuLabel><DropdownMenuSeparator /><DropdownMenuRadioGroupvalue={sort.direction}@@ -479,8 +486,12 @@ function SortDropdown({})}>- <DropdownMenuRadioItem value="asc">Ascending</DropdownMenuRadioItem>- <DropdownMenuRadioItem value="desc">Descending</DropdownMenuRadioItem>+ <DropdownMenuRadioItem value="asc">+ {t('admin.components.table_toolbar.ascending')}+ </DropdownMenuRadioItem>+ <DropdownMenuRadioItem value="desc">+ {t('admin.components.table_toolbar.descending')}+ </DropdownMenuRadioItem></DropdownMenuRadioGroup></DropdownMenuContent></DropdownMenu>@@ -500,6 +511,7 @@ function ColumnSelector({visibleColumns: string[]onVisibleColumnsChange: (columns: string[]) => void}) {+ const { t } = useTranslation()const defaults = columns.filter((c) => c.default).map((c) => c.key)return (@@ -512,10 +524,10 @@ function ColumnSelector({</Button></DropdownMenuTrigger></TooltipTrigger>- <TooltipContent>Columns</TooltipContent>+ <TooltipContent>{t('admin.components.table_toolbar.columns_tooltip')}</TooltipContent></Tooltip><DropdownMenuContent align="end" className="min-w-48">- <DropdownMenuLabel>Visible columns</DropdownMenuLabel>+ <DropdownMenuLabel>{t('admin.components.table_toolbar.visible_columns')}</DropdownMenuLabel><DropdownMenuSeparator />{columns.map((col) => (<DropdownMenuCheckboxItem@@ -541,7 +553,7 @@ function ColumnSelector({className="w-full justify-center"onClick={() => onVisibleColumnsChange(defaults)}>- Reset to default+ {t('admin.components.table_toolbar.reset_to_default')}</Button></div></DropdownMenuContent>@@ -627,7 +639,10 @@ function FilterPanel({{draft.map((filter) => {const col = columns.find((c) => c.key === filter.field)const type = col?.filterType ?? 'string'- const ops = getOperators(type)+ const ops = getOperators(type).map((op) => ({+ value: op.value,+ label: t(op.labelKey),+ }))return (<div key={filter.id} className="flex min-w-0 items-center gap-1.5">@@ -771,7 +786,7 @@ function FilterPanel({{draft.length === 0 && (<p className="text-xs text-muted-foreground text-center py-4">- No filters. Click below to add one.+ {t('admin.components.table_toolbar.no_filters')}</p>)}</div>@@ -779,16 +794,16 @@ function FilterPanel({<div className="flex items-center justify-between border-t px-3 py-2"><Button variant="ghost" size="sm" onClick={addFilter}><PlusIcon className="size-3.5" />- Add filter+ {t('admin.components.table_toolbar.add_filter')}</Button><div className="flex gap-1.5">{draft.length > 0 && (<Button variant="ghost" size="sm" onClick={() => setDraft([])}>- Clear+ {t('admin.actions.clear')}</Button>)}<Button size="sm" onClick={handleApply}>- Apply+ {t('admin.actions.apply')}</Button></div></div>diff --git a/packages/dashboard-core/src/components/top-bar.tsx b/packages/dashboard-core/src/components/top-bar.tsxindex 777eb386d6..0ecd13d000 100644--- a/packages/dashboard-core/src/components/top-bar.tsx+++ b/packages/dashboard-core/src/components/top-bar.tsx@@ -7,9 +7,11 @@ import {DropdownMenuItem,DropdownMenuSeparator,DropdownMenuTrigger,+ LanguageMenuItems,SidebarTrigger,ThemeMenuItems,} from '@spree/dashboard-ui'+import { Link } from '@tanstack/react-router'import {BookOpenIcon,ExternalLinkIcon,@@ -20,9 +22,12 @@ import {UserIcon,} from 'lucide-react'import { useTranslation } from 'react-i18next'+import { toast } from 'sonner'+import { adminClient } from '../client'import { useAuth } from '../hooks/use-auth'import { useCommandPalette } from '../hooks/use-command-palette'import { getInitials } from '../lib/formatters'+import { i18n, switchLocale } from '../lib/i18n'import { useStore } from '../providers/store-provider'const IS_MAC = typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(navigator.platform ?? '')@@ -35,7 +40,16 @@ const IS_MAC = typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(naviga* the layout root). The keyboard shortcut is registered in the provider, not* here, so it works regardless of focus location.*/-export function TopBar() {+/**+ * @param uiLocales Admin UI languages for the in-menu switcher. The app owns+ * which locale bundles ship (see the dashboard's `getAvailableUiLocales`) and+ * injects them here, so this core component stays free of bundle knowledge.+ */+export function TopBar({+ uiLocales = [],+}: {+ uiLocales?: ReadonlyArray<{ code: string; name: string }>+}) {return (<header className="sticky top-0 z-40 flex h-header-height shrink-0 items-center gap-3 bg-background/90 px-4 border-b border-border/50 backdrop-blur supports-[backdrop-filter]:bg-background/75"><SidebarTrigger className="-ml-1 h-8 w-8" />@@ -46,7 +60,7 @@ export function TopBar() {<div className="flex items-center gap-2"><ViewStoreLink />- <TopBarUser />+ <TopBarUser uiLocales={uiLocales} /></div></header>)@@ -80,6 +94,7 @@ function SearchTrigger() {// ---------------------------------------------------------------------------function ViewStoreLink() {+ const { t } = useTranslation()const { store } = useStore()if (!store?.url) return null@@ -90,7 +105,7 @@ function ViewStoreLink() {<Button asChild variant="ghost" size="sm"><a href={href} target="_blank" rel="noreferrer"><ExternalLinkIcon className="size-4" />- <span className="hidden sm:inline">View store</span>+ <span className="hidden sm:inline">{t('admin.account.view_store')}</span></a></Button>)@@ -100,13 +115,28 @@ function ViewStoreLink() {// User menu// ----------------------------------------------------------------------------function TopBarUser() {+function TopBarUser({ uiLocales }: { uiLocales: ReadonlyArray<{ code: string; name: string }> }) {const { t } = useTranslation()const { user, logout } = useAuth()+ const { store } = useStore()if (!user) return nullconst initials = getInitials(user.full_name, user.email)+ // Persist the chosen language to the account (PATCH /me) before reloading.+ // This must update the account — not just localStorage — otherwise the+ // auth provider, which treats the account's saved `selected_locale` as the+ // source of truth, would revert the switch on the next page load. Only+ // switch on success: reloading after a failed PATCH would desync localStorage+ // from the server and bounce the locale back on the next session bootstrap.+ const handleSelectLocale = (code: string) => {+ if (code === i18n.language) return+ void adminClient.me.update({ selected_locale: code }).then(+ () => switchLocale(code),+ () => toast.error(t('admin.account.language.update_failed')),+ )+ }+return (<DropdownMenu><DropdownMenuTrigger asChild>@@ -140,27 +170,43 @@ function TopBarUser() {</div><DropdownMenuSeparator /><ThemeMenuItems />- <DropdownMenuItem>- <UserIcon className="size-4" />- Edit Profile- </DropdownMenuItem>+ {/* Compact nested submenu; self-hides when < 2 languages are installed. */}+ <LanguageMenuItems+ label={t('admin.account.language.label')}+ locales={uiLocales}+ value={i18n.language}+ onSelect={handleSelectLocale}+ />+ {uiLocales.length >= 2 && <DropdownMenuSeparator />}+ {store && (+ <DropdownMenuItem asChild>+ <Link+ to="/$storeId/settings/profile"+ params={{ storeId: store.id }}+ className="no-underline"+ >+ <UserIcon className="size-4" />+ {t('admin.account.edit_profile')}+ </Link>+ </DropdownMenuItem>+ )}<DropdownMenuSeparator /><DropdownMenuItem><BookOpenIcon className="size-4" />- Documentation+ {t('admin.account.documentation')}</DropdownMenuItem><DropdownMenuItem><MessageCircleIcon className="size-4" />- Community+ {t('admin.account.community')}</DropdownMenuItem><DropdownMenuItem><MailIcon className="size-4" />- Contact Support+ {t('admin.account.contact_support')}</DropdownMenuItem><DropdownMenuSeparator /><DropdownMenuItem onClick={logout} className="text-destructive focus:text-destructive"><LogOutIcon className="size-4" />- Log out+ {t('admin.account.log_out')}</DropdownMenuItem></DropdownMenuContent></DropdownMenu>diff --git a/packages/dashboard-core/src/hooks/use-display-name.ts b/packages/dashboard-core/src/hooks/use-display-name.tsnew file mode 100644index 0000000000..916634187c--- /dev/null+++ b/packages/dashboard-core/src/hooks/use-display-name.ts@@ -0,0 +1,42 @@+import { useMemo } from 'react'+import { useTranslation } from 'react-i18next'++/**+ * Resolves a code to its display name via `Intl.DisplayNames`, localized to a+ * given UI language. Returns `undefined` when the runtime lacks coverage so+ * callers can apply their own fallback (the API name, the raw code, etc.).+ *+ * Standalone (non-hook) variant for module-level use outside React.+ */+export function intlDisplayName(+ type: Intl.DisplayNamesType,+ locale: string,+ code: string,+): string | undefined {+ try {+ return new Intl.DisplayNames([locale, 'en'], { type }).of(code)+ } catch {+ return undefined+ }+}++/**+ * Hook returning a memoized `code -> name` resolver for one `Intl.DisplayNames`+ * type (`currency`, `language`, `region`, …), localized to the **admin UI+ * language** (`i18n.language`) — NOT the store's content locale — so names+ * match the rest of the dashboard chrome. Returns `undefined` on a miss; the+ * caller supplies the fallback (e.g. `?? code`, `?? country.name`).+ */+export function useDisplayName(type: Intl.DisplayNamesType) {+ const { i18n: instance } = useTranslation()+ const locale = instance.language+ return useMemo(() => {+ let formatter: Intl.DisplayNames | undefined+ try {+ formatter = new Intl.DisplayNames([locale, 'en'], { type })+ } catch {+ formatter = undefined+ }+ return (code: string) => formatter?.of(code)+ }, [locale, type])+}diff --git a/packages/dashboard-core/src/index.ts b/packages/dashboard-core/src/index.tsindex f7860cf086..8f02208c45 100644--- a/packages/dashboard-core/src/index.ts+++ b/packages/dashboard-core/src/index.ts@@ -46,6 +46,7 @@ export * from './hooks/use-command-palette'export * from './hooks/use-countries'export * from './hooks/use-custom-fields'export * from './hooks/use-direct-upload'+export * from './hooks/use-display-name'export * from './hooks/use-export'export * from './hooks/use-global-search'export * from './hooks/use-resource-mutation'diff --git a/packages/dashboard-core/src/lib/i18n.ts b/packages/dashboard-core/src/lib/i18n.tsindex adab8050cd..b5de670dfb 100644--- a/packages/dashboard-core/src/lib/i18n.ts+++ b/packages/dashboard-core/src/lib/i18n.ts@@ -4,6 +4,45 @@ import { initReactI18next } from 'react-i18next'// project's `@/*` alias is theirs alone (see Phase 1's rationale).import en from '../locales/en.json'+// localStorage key for the admin's chosen UI language. Shared by the login+// screen (pre-auth), the top-bar switcher, and the profile form so a choice+// made anywhere is honored on the next paint.+export const ADMIN_LOCALE_STORAGE_KEY = 'spree-admin-locale'++function readStoredLocale(): string {+ if (typeof localStorage === 'undefined') return 'en'+ return localStorage.getItem(ADMIN_LOCALE_STORAGE_KEY) || 'en'+}++// All non-English core bundles, imported EAGERLY so the active language has its+// resources synchronously available (registered just after init() below) —+// no flash, no async race with module-load `i18n.t(...)` calls.+const coreLocales = import.meta.glob<{ default: Record<string, unknown> }>(+ ['../locales/*.json', '!../locales/en.json'],+ { eager: true },+)++// Switch the admin UI language. Persists the choice and reloads the page.+//+// A full reload is deliberate: many labels (table columns, nav, registry+// titles) are resolved with `i18n.t(...)` at module-load time and don't react+// to a live `changeLanguage`. Reloading re-runs those at boot in the new+// language (read from localStorage by `init` below), so every string switches+// — not just the components currently subscribed to i18next.+//+// The reload is deferred to the next macrotask so any pending React state flush+// (e.g. a just-saved form resetting its dirty state) completes first — otherwise+// a still-armed `beforeunload` dirty-guard would trigger the browser's+// "unsaved changes" prompt.+export function switchLocale(code: string): void {+ if (typeof localStorage !== 'undefined') {+ localStorage.setItem(ADMIN_LOCALE_STORAGE_KEY, code)+ }+ if (typeof window !== 'undefined') {+ setTimeout(() => window.location.reload(), 0)+ }+}+// Bootstrap i18next with the framework's base translation namespace. Side-effect// import — `import '@spree/dashboard-core/lib/i18n'` from the consuming app's// entry point runs this once before any component calls `useTranslation()`.@@ -13,12 +52,11 @@ import en from '../locales/en.json'// after this side-effect import has settled. The `deep` + `overwrite` flags// merge the extension into the base namespace without dropping framework keys.//-// English-only at launch. Adding another locale = add a `<code>.json` next to-// `en.json` and load it here. Lazy chunks come later if/when the locale list-// grows enough to matter.+// English ships eagerly; `lng` is read from localStorage so a previously+// chosen language is the initial language on first paint (no flash).i18n.use(initReactI18next).init({resources: { en: { translation: en } },- lng: 'en',+ lng: readStoredLocale(),fallbackLng: 'en',interpolation: { escapeValue: false },// Surface missing keys in dev so we notice gaps as we build pages; ship@@ -30,5 +68,11 @@ i18n.use(initReactI18next).init({: undefined,})+// Register the eager non-English core bundles now that i18next is initialized.+for (const [path, mod] of Object.entries(coreLocales)) {+ const code = path.replace('../locales/', '').replace('.json', '')+ i18n.addResourceBundle(code, 'translation', mod.default, true, true)+}+export { default as i18n } from 'i18next'export { Trans, useTranslation } from 'react-i18next'diff --git a/packages/dashboard-core/src/locales/de.json b/packages/dashboard-core/src/locales/de.jsonnew file mode 100644index 0000000000..89024a4cfe--- /dev/null+++ b/packages/dashboard-core/src/locales/de.json@@ -0,0 +1,504 @@+{+ "admin": {+ "actions": {+ "add": "Hinzufügen",+ "apply": "Anwenden",+ "cancel": "Abbrechen",+ "clear": "Zurücksetzen",+ "revoke": "Widerrufen",+ "close": "Schließen",+ "confirm": "Bestätigen",+ "done": "Fertig",+ "create": "Erstellen",+ "creating": "Wird erstellt…",+ "delete": "Löschen",+ "deleting": "Wird gelöscht…",+ "discard": "Verwerfen",+ "discard_changes": "Änderungen verwerfen",+ "edit": "Bearbeiten",+ "generate": "Generieren",+ "remove": "Entfernen",+ "save": "Speichern",+ "saving": "Wird gespeichert…",+ "search": "Suchen",+ "sign_in": "Anmelden",+ "signing_in": "Anmeldung läuft…",+ "view_all": "Alle anzeigen",+ "view_details": "Details anzeigen",+ "copy": "Kopieren",+ "copied": "Kopiert!",+ "export": "Exportieren",+ "exporting": "Wird exportiert…",+ "import": "Importieren",+ "invite": "Einladen",+ "send": "Senden",+ "send_invitation": "Einladung senden",+ "sending": "Wird gesendet…",+ "reset": "Zurücksetzen",+ "show": "Anzeigen",+ "hide": "Ausblenden",+ "back": "Zurück",+ "actions_menu": "Aktionen",+ "more_actions": "Weitere Aktionen"+ },+ "row_actions": {+ "menu_label": "Aktionen öffnen",+ "edit": "Bearbeiten",+ "clone": "Duplizieren",+ "delete": "Löschen"+ },+ "a11y": {+ "breadcrumb": "Breadcrumb",+ "toggle_sidebar": "Seitenleiste umschalten",+ "settings_navigation": "Einstellungsnavigation",+ "user_menu": "Benutzermenü",+ "drag_to_reorder": "Zum Neuanordnen ziehen",+ "reorder": "Neu anordnen",+ "select_all_rows": "Alle Zeilen auf dieser Seite auswählen",+ "select_row": "Zeile auswählen",+ "clear_date": "Datum löschen",+ "clear_selection": "Auswahl aufheben",+ "expand_all": "Alle erweitern",+ "collapse_all": "Alle einklappen",+ "refetch": "Erneut laden",+ "hide_value": "Wert ausblenden",+ "show_value": "Wert anzeigen",+ "pick_color": "Farbe auswählen",+ "change_color": "Farbe ändern ({{value}})",+ "stock_at_locations": "Lagerbestand an Standorten",+ "edit_media": "Medien bearbeiten",+ "delete_image": "Bild löschen",+ "remove_image": "Bild entfernen",+ "view_image": "Bild anzeigen",+ "upload_image": "Bild hochladen",+ "remove_value": "Wert entfernen"+ },+ "common": {+ "loading": "Wird geladen…",+ "searching": "Wird gesucht…",+ "no_results": "Keine Ergebnisse",+ "optional": "Optional",+ "required": "Erforderlich",+ "yes": "Ja",+ "no": "Nein",+ "or": "oder",+ "and": "und",+ "all": "Alle",+ "none": "Keine",+ "page_of": "Seite {{page}} von {{total}}",+ "prev": "Zurück",+ "next": "Weiter",+ "select_placeholder": "Auswählen…",+ "search_placeholder": "Suchen…",+ "pick_date": "Datum auswählen",+ "comma_separated_hint": "Werte durch Kommas trennen.",+ "are_you_sure": "Sind Sie sicher?",+ "remove_question": "Entfernen?",+ "deleted": "Gelöscht",+ "unsaved_changes": "Sie haben ungespeicherte Änderungen.",+ "prices": "Preise"+ },+ "color_picker": {+ "no_color": "Keine Farbe"+ },+ "messages": {+ "saved": "Gespeichert",+ "created": "Erstellt",+ "updated": "Aktualisiert",+ "removed": "Entfernt",+ "settings_updated": "Einstellungen aktualisiert",+ "store_settings_updated": "Shop-Einstellungen aktualisiert",+ "invitation_sent": "Einladung gesendet",+ "invitation_resent": "Einladung erneut gesendet",+ "invitation_accepted": "Willkommen bei Spree",+ "key_created": "Schlüssel erstellt",+ "key_updated": "Schlüssel aktualisiert",+ "key_revoked": "Schlüssel widerrufen",+ "key_deleted": "Schlüssel gelöscht",+ "product_saved": "Produkt gespeichert",+ "product_created": "Produkt erstellt",+ "product_deleted": "Produkt gelöscht",+ "order_saved": "Bestellung gespeichert",+ "customer_saved": "Kunde gespeichert",+ "customer_deleted": "Kunde gelöscht",+ "payment_method_saved": "Zahlungsmethode gespeichert",+ "tax_category_saved": "Steuerkategorie gespeichert",+ "stock_location_saved": "Lagerstandort gespeichert",+ "promotion_created": "Aktion erstellt",+ "promotion_saved": "Aktion gespeichert",+ "promotion_deleted": "Aktion gelöscht",+ "gift_card_created": "Geschenkkarte erstellt",+ "address_saved": "Adresse gespeichert",+ "address_removed": "Adresse entfernt",+ "store_credit_saved": "Guthaben gespeichert",+ "store_credit_removed": "Guthaben entfernt",+ "copied_to_clipboard": "In die Zwischenablage kopiert",+ "profile_updated": "Profil aktualisiert"+ },+ "errors": {+ "required": "Dieses Feld ist erforderlich",+ "generic": "Ein Fehler ist aufgetreten",+ "unexpected": "Ein unerwarteter Fehler ist aufgetreten",+ "failed_to_load": "Laden fehlgeschlagen",+ "failed_to_save": "Speichern fehlgeschlagen",+ "failed_to_update": "Aktualisierung fehlgeschlagen",+ "failed_to_create": "Erstellung fehlgeschlagen",+ "failed_to_delete": "Löschen fehlgeschlagen",+ "failed_to_load_customer": "Kunde konnte nicht geladen werden",+ "failed_to_load_order": "Bestellung konnte nicht geladen werden",+ "failed_to_load_product": "Produkt konnte nicht geladen werden",+ "failed_to_send_invitation": "Einladung konnte nicht gesendet werden",+ "failed_to_revoke_key": "Schlüssel konnte nicht widerrufen werden",+ "failed_to_update_store": "Store-Einstellungen konnten nicht aktualisiert werden",+ "failed_to_update_staff": "Mitarbeiter konnte nicht aktualisiert werden",+ "network": "Netzwerkfehler — bitte erneut versuchen",+ "unauthorized": "Sie haben keine Berechtigung dafür",+ "not_found": "Nicht gefunden",+ "failed_to_update_profile": "Profil konnte nicht aktualisiert werden"+ },+ "auth": {+ "login": {+ "title": "Willkommen zurück",+ "subtitle": "Melden Sie sich bei Ihrem Administratorkonto an"+ },+ "logout": "Abmelden"+ },+ "fields": {+ "name": {+ "label": "Name"+ },+ "label": {+ "label": "Bezeichnung"+ },+ "description": {+ "label": "Beschreibung"+ },+ "code": {+ "label": "Code"+ },+ "email": {+ "label": "E-Mail"+ },+ "password": {+ "label": "Passwort"+ },+ "first_name": {+ "label": "Vorname"+ },+ "last_name": {+ "label": "Nachname"+ },+ "phone": {+ "label": "Telefon"+ },+ "company": {+ "label": "Unternehmen"+ },+ "address1": {+ "label": "Adresszeile 1"+ },+ "address2": {+ "label": "Adresszeile 2"+ },+ "city": {+ "label": "Stadt"+ },+ "zipcode": {+ "label": "Postleitzahl"+ },+ "country_iso": {+ "label": "Land"+ },+ "state_abbr": {+ "label": "Bundesland / Region"+ },+ "state_name": {+ "label": "Bundesland / Region"+ },+ "starts_at": {+ "label": "Beginnt"+ },+ "ends_at": {+ "label": "Endet"+ },+ "expires_at": {+ "label": "Läuft ab"+ },+ "active": {+ "label": "Aktiv"+ },+ "kind": {+ "label": "Art"+ },+ "amount": {+ "label": "Betrag"+ },+ "currency": {+ "label": "Währung"+ },+ "quantity": {+ "label": "Menge"+ },+ "slug": {+ "label": "Slug"+ },+ "meta_title": {+ "label": "Meta-Titel"+ },+ "meta_description": {+ "label": "Meta-Beschreibung"+ },+ "status": {+ "label": "Status"+ },+ "created_at": {+ "label": "Erstellt am"+ },+ "updated_at": {+ "label": "Aktualisiert am"+ },+ "completed_at": {+ "label": "Abgeschlossen am"+ },+ "total": {+ "label": "Gesamt"+ },+ "subtotal": {+ "label": "Zwischensumme"+ },+ "tax": {+ "label": "Steuer"+ },+ "shipping": {+ "label": "Versand"+ },+ "discount": {+ "label": "Rabatt"+ },+ "login": {+ "email": {+ "placeholder": "[email protected]"+ }+ },+ "address": {+ "label": {+ "label": "Bezeichnung",+ "placeholder": "z. B. Zuhause, Büro"+ },+ "address1": {+ "label": "Adresse"+ },+ "address2": {+ "label": "Wohnung, Suite usw."+ },+ "postal_code": {+ "label": "Postleitzahl"+ },+ "is_default_billing": {+ "label": "Standard-Rechnungsadresse"+ },+ "is_default_shipping": {+ "label": "Standard-Lieferadresse"+ }+ },+ "media": {+ "alt": {+ "label": "Alternativtext",+ "placeholder": "Beschreiben Sie das Bild für Barrierefreiheit und SEO"+ }+ }+ },+ "components": {+ "currency_select": {+ "placeholder": "Währung auswählen"+ },+ "channel_select": {+ "placeholder": "Verkaufskanal auswählen"+ },+ "locale_select": {+ "placeholder": "Sprache auswählen",+ "multi_placeholder": "Sprachen hinzufügen…",+ "empty": "Keine Sprachen gefunden"+ },+ "country_combobox": {+ "search_placeholder": "Länder suchen…",+ "empty": "Keine Länder gefunden"+ },+ "state_combobox": {+ "search_placeholder": "Bundesländer suchen…",+ "empty": "Keine Bundesländer gefunden"+ },+ "command_palette": {+ "placeholder": "Produkte, Bestellungen, Kunden suchen…",+ "title": "Suche und Befehle",+ "description": "Durchsuchen Sie Produkte, Bestellungen und Kunden oder führen Sie einen Befehl aus.",+ "no_results": "Keine Ergebnisse für \"{{query}}\".",+ "empty_hint": "Zum Suchen tippen oder unten einen Befehl auswählen.",+ "goto": "Gehe zu",+ "goto_label": "Gehe zu {{label}}"+ },+ "bulk_action_bar": {+ "selected": "{{count}} ausgewählt",+ "default_success": "{n} Datensätze aktualisiert",+ "default_error": "Massenvorgang fehlgeschlagen"+ },+ "preferences_form": {+ "comma_separated_hint": "Werte durch Kommas trennen.",+ "tiers": {+ "label": "Stufen",+ "header_threshold": "Bestellsumme ≥",+ "header_value": "Rabatt",+ "empty": "Noch keine Stufen. Der Basissatz gilt, bis Sie eine Stufe hinzufügen.",+ "add_tier": "Stufe hinzufügen",+ "remove_tier": "Stufe entfernen"+ }+ },+ "confirm_dialog": {+ "title": "Sind Sie sicher?"+ },+ "table_toolbar": {+ "search_placeholder": "Suchen…",+ "filter_select_placeholder": "Auswählen…",+ "filter_date_placeholder": "Datum auswählen",+ "filter_text_placeholder": "Filtern…",+ "filters_button": "Filter",+ "sort_by": "Sortieren nach",+ "sort_tooltip": "Sortieren",+ "order": "Reihenfolge",+ "ascending": "Aufsteigend",+ "descending": "Absteigend",+ "columns_tooltip": "Spalten",+ "visible_columns": "Sichtbare Spalten",+ "reset_to_default": "Auf Standard zurücksetzen",+ "clear_all": "Alle löschen",+ "no_filters": "Keine Filter. Klicken Sie unten, um einen hinzuzufügen.",+ "add_filter": "Filter hinzufügen",+ "operators": {+ "contains": "enthält",+ "equals": "ist gleich",+ "does_not_equal": "ist ungleich",+ "starts_with": "beginnt mit",+ "ends_with": "endet mit",+ "is_set": "ist gesetzt",+ "is_not_set": "ist nicht gesetzt",+ "is": "ist",+ "is_not": "ist nicht",+ "is_any_of": "ist eines von",+ "is_none_of": "ist keines von",+ "greater_than": "größer als",+ "greater_than_or_equal": "größer oder gleich",+ "less_than": "kleiner als",+ "less_than_or_equal": "kleiner oder gleich",+ "after": "nach",+ "before": "vor",+ "on_or_after": "am oder nach",+ "on_or_before": "am oder vor"+ }+ },+ "media": {+ "remove_tooltip": "Bild entfernen"+ },+ "custom_fields": {+ "json_placeholder": "{ \"example\": \"value\" }"+ },+ "export_button": {+ "title": "Als CSV exportieren",+ "description": "Wir bereiten Ihre CSV-Datei im Hintergrund vor und laden sie herunter, sobald sie fertig ist. Falls es etwas länger dauert, erhalten Sie zusätzlich einen Link per E-Mail.",+ "filtered": {+ "title": "Aktueller Filter",+ "no_filter": "Kein Filter aktiv – entspricht dem Export aller Datensätze.",+ "unknown_count": "Exportieren Sie die Datensätze, die Ihrem aktuellen Filter entsprechen.",+ "count_one": "Exportieren Sie den {{formattedCount}} Datensatz, der Ihrem aktuellen Filter entspricht.",+ "count_other": "Exportieren Sie die {{formattedCount}} Datensätze, die Ihrem aktuellen Filter entsprechen.",+ "count_few": "Exportieren Sie die {{formattedCount}} Datensätze, die Ihrem aktuellen Filter entsprechen.",+ "count_many": "Exportieren Sie die {{formattedCount}} Datensätze, die Ihrem aktuellen Filter entsprechen."+ },+ "all": {+ "title": "Alle Datensätze",+ "description": "Filter ignorieren und alles in diesem Shop exportieren."+ }+ },+ "metadata_card": {+ "title": "Metadaten",+ "empty_title": "Keine Metadaten",+ "empty_description": "Apps und Integrationen füllen dies automatisch."+ },+ "rich_text_editor": {+ "placeholder": "Schreiben Sie etwas …",+ "link_url_prompt": "URL",+ "bold": "Fett",+ "italic": "Kursiv",+ "strikethrough": "Durchgestrichen",+ "bullet_list": "Aufzählungsliste",+ "ordered_list": "Nummerierte Liste",+ "blockquote": "Zitat",+ "link": "Link",+ "undo": "Rückgängig",+ "redo": "Wiederholen"+ },+ "date_range_picker": {+ "presets": {+ "last_7_days": "Letzte 7 Tage",+ "last_14_days": "Letzte 14 Tage",+ "last_30_days": "Letzte 30 Tage",+ "last_90_days": "Letzte 90 Tage",+ "this_month": "Dieser Monat",+ "year_to_date": "Seit Jahresbeginn"+ }+ },+ "pagination": {+ "range": "{{from}}–{{to}} von {{count}}",+ "rows_per_page": "Zeilen pro Seite",+ "first_page": "Zur ersten Seite",+ "previous_page": "Zur vorherigen Seite",+ "next_page": "Zur nächsten Seite",+ "last_page": "Zur letzten Seite"+ },+ "theme_toggle": {+ "label": "Design",+ "light": "Hell",+ "dark": "Dunkel",+ "system": "System"+ },+ "json_preview_drawer": {+ "copied": "Kopiert",+ "copy_all": "Alles kopieren",+ "open_raw": "Rohantwort öffnen",+ "raw": "Roh",+ "failed_to_load": "Laden fehlgeschlagen: {{message}}",+ "collapse_depth": "Einklapptiefe",+ "depth": "Tiefe {{level}}"+ },+ "page_header": {+ "view_as_json": "Als JSON anzeigen",+ "copy_id": "ID kopieren",+ "copy_number": "Nummer kopieren"+ }+ },+ "validation": {+ "required": "{{field}} ist erforderlich",+ "positive_number": "{{field}} muss größer als 0 sein",+ "min_length": "{{field}} muss mindestens {{count}} Zeichen lang sein",+ "passwords_dont_match": "Die Passwörter stimmen nicht überein",+ "invalid_email_or_password": "Ungültige E-Mail-Adresse oder ungültiges Passwort",+ "invalid_email": "Geben Sie eine gültige E-Mail-Adresse ein",+ "invalid_hex_color": "Ungültiger Hex-Farbwert",+ "invalid_password": "Ungültiges Passwort",+ "password_required": "Passwort ist erforderlich",+ "first_name_required": "Vorname ist erforderlich",+ "last_name_required": "Nachname ist erforderlich"+ },+ "account": {+ "edit_profile": "Profil bearbeiten",+ "language": {+ "label": "Sprache",+ "update_failed": "Spracheinstellung konnte nicht gespeichert werden. Bitte versuchen Sie es erneut."+ },+ "view_store": "Shop ansehen",+ "documentation": "Dokumentation",+ "community": "Community",+ "contact_support": "Support kontaktieren",+ "log_out": "Abmelden"+ }+ }+}diff --git a/packages/dashboard-core/src/locales/en.json b/packages/dashboard-core/src/locales/en.jsonindex d5524827fc..1589c350ac 100644--- a/packages/dashboard-core/src/locales/en.json+++ b/packages/dashboard-core/src/locales/en.json@@ -132,7 +132,8 @@"address_removed": "Address removed","store_credit_saved": "Store credit saved","store_credit_removed": "Store credit removed",- "copied_to_clipboard": "Copied to clipboard"+ "copied_to_clipboard": "Copied to clipboard",+ "profile_updated": "Profile updated"},"errors": {"required": "This field is required",@@ -152,7 +153,8 @@"failed_to_update_staff": "Failed to update staff","network": "Network error — please retry","unauthorized": "You don't have permission to do that",- "not_found": "Not found"+ "not_found": "Not found",+ "failed_to_update_profile": "Failed to update profile"},"auth": {"login": {@@ -359,13 +361,118 @@"filter_select_placeholder": "Select…","filter_date_placeholder": "Pick a date","filter_text_placeholder": "Filter…",- "filters_button": "Filters"+ "filters_button": "Filters",+ "sort_by": "Sort by",+ "sort_tooltip": "Sort",+ "order": "Order",+ "ascending": "Ascending",+ "descending": "Descending",+ "columns_tooltip": "Columns",+ "visible_columns": "Visible columns",+ "reset_to_default": "Reset to default",+ "clear_all": "Clear all",+ "no_filters": "No filters. Click below to add one.",+ "add_filter": "Add filter",+ "operators": {+ "contains": "contains",+ "equals": "equals",+ "does_not_equal": "does not equal",+ "starts_with": "starts with",+ "ends_with": "ends with",+ "is_set": "is set",+ "is_not_set": "is not set",+ "is": "is",+ "is_not": "is not",+ "is_any_of": "is any of",+ "is_none_of": "is none of",+ "greater_than": "greater than",+ "greater_than_or_equal": "greater than or equal",+ "less_than": "less than",+ "less_than_or_equal": "less than or equal",+ "after": "after",+ "before": "before",+ "on_or_after": "on or after",+ "on_or_before": "on or before"+ }},"media": {"remove_tooltip": "Remove image"},"custom_fields": {"json_placeholder": "{ \"example\": \"value\" }"+ },+ "export_button": {+ "title": "Export to CSV",+ "description": "We'll prepare your CSV in the background and download it as soon as it's ready. If it takes a while you'll get an email link too.",+ "filtered": {+ "title": "Current filter",+ "no_filter": "No filter active — same as exporting all records.",+ "unknown_count": "Export the records matching your current filter.",+ "count_one": "Export the {{formattedCount}} record matching your current filter.",+ "count_other": "Export the {{formattedCount}} records matching your current filter.",+ "count_few": "Export the {{formattedCount}} records matching your current filter.",+ "count_many": "Export the {{formattedCount}} records matching your current filter."+ },+ "all": {+ "title": "All records",+ "description": "Ignore filters and export everything in this store."+ }+ },+ "metadata_card": {+ "title": "Metadata",+ "empty_title": "No metadata",+ "empty_description": "Apps and integrations populate this automatically."+ },+ "rich_text_editor": {+ "placeholder": "Write something…",+ "link_url_prompt": "URL",+ "bold": "Bold",+ "italic": "Italic",+ "strikethrough": "Strikethrough",+ "bullet_list": "Bullet list",+ "ordered_list": "Ordered list",+ "blockquote": "Blockquote",+ "link": "Link",+ "undo": "Undo",+ "redo": "Redo"+ },+ "date_range_picker": {+ "presets": {+ "last_7_days": "Last 7 days",+ "last_14_days": "Last 14 days",+ "last_30_days": "Last 30 days",+ "last_90_days": "Last 90 days",+ "this_month": "This month",+ "year_to_date": "Year to date"+ }+ },+ "pagination": {+ "range": "{{from}}–{{to}} of {{count}}",+ "rows_per_page": "Rows per page",+ "first_page": "Go to first page",+ "previous_page": "Go to previous page",+ "next_page": "Go to next page",+ "last_page": "Go to last page"+ },+ "theme_toggle": {+ "label": "Theme",+ "light": "Light",+ "dark": "Dark",+ "system": "System"+ },+ "json_preview_drawer": {+ "copied": "Copied",+ "copy_all": "Copy all",+ "open_raw": "Open raw response",+ "raw": "Raw",+ "failed_to_load": "Failed to load: {{message}}",+ "collapse_depth": "Collapse depth",+ "depth": "Depth {{level}}"+ },+ "page_header": {+ "view_as_json": "View as JSON",+ "copy_id": "Copy ID",+ "copy_number": "Copy number"}},"validation": {@@ -380,6 +487,18 @@"password_required": "Password is required","first_name_required": "First name is required","last_name_required": "Last name is required"+ },+ "account": {+ "edit_profile": "Edit Profile",+ "language": {+ "label": "Language",+ "update_failed": "Could not save your language preference. Please try again."+ },+ "view_store": "View store",+ "documentation": "Documentation",+ "community": "Community",+ "contact_support": "Contact Support",+ "log_out": "Log out"}}}diff --git a/packages/dashboard-core/src/locales/fr.json b/packages/dashboard-core/src/locales/fr.jsonnew file mode 100644index 0000000000..6bf98255cc--- /dev/null+++ b/packages/dashboard-core/src/locales/fr.json@@ -0,0 +1,504 @@+{+ "admin": {+ "actions": {+ "add": "Ajouter",+ "apply": "Appliquer",+ "cancel": "Annuler",+ "clear": "Effacer",+ "revoke": "Révoquer",+ "close": "Fermer",+ "confirm": "Confirmer",+ "done": "Terminé",+ "create": "Créer",+ "creating": "Création…",+ "delete": "Supprimer",+ "deleting": "Suppression…",+ "discard": "Abandonner",+ "discard_changes": "Abandonner les modifications",+ "edit": "Modifier",+ "generate": "Générer",+ "remove": "Retirer",+ "save": "Enregistrer",+ "saving": "Enregistrement…",+ "search": "Rechercher",+ "sign_in": "Se connecter",+ "signing_in": "Connexion…",+ "view_all": "Tout afficher",+ "view_details": "Voir les détails",+ "copy": "Copier",+ "copied": "Copié !",+ "export": "Exporter",+ "exporting": "Exportation…",+ "import": "Importer",+ "invite": "Inviter",+ "send": "Envoyer",+ "send_invitation": "Envoyer l'invitation",+ "sending": "Envoi…",+ "reset": "Réinitialiser",+ "show": "Afficher",+ "hide": "Masquer",+ "back": "Retour",+ "actions_menu": "Actions",+ "more_actions": "Plus d'actions"+ },+ "row_actions": {+ "menu_label": "Ouvrir les actions",+ "edit": "Modifier",+ "clone": "Dupliquer",+ "delete": "Supprimer"+ },+ "a11y": {+ "breadcrumb": "Fil d'Ariane",+ "toggle_sidebar": "Afficher/masquer la barre latérale",+ "settings_navigation": "Navigation des paramètres",+ "user_menu": "Menu utilisateur",+ "drag_to_reorder": "Faire glisser pour réorganiser",+ "reorder": "Réorganiser",+ "select_all_rows": "Sélectionner toutes les lignes de cette page",+ "select_row": "Sélectionner la ligne",+ "clear_date": "Effacer la date",+ "clear_selection": "Effacer la sélection",+ "expand_all": "Tout développer",+ "collapse_all": "Tout réduire",+ "refetch": "Recharger",+ "hide_value": "Masquer la valeur",+ "show_value": "Afficher la valeur",+ "pick_color": "Choisir une couleur",+ "change_color": "Changer la couleur ({{value}})",+ "stock_at_locations": "Stock par emplacement",+ "edit_media": "Modifier le média",+ "delete_image": "Supprimer l'image",+ "remove_image": "Retirer l'image",+ "view_image": "Voir l'image",+ "upload_image": "Téléverser une image",+ "remove_value": "Retirer la valeur"+ },+ "common": {+ "loading": "Chargement…",+ "searching": "Recherche…",+ "no_results": "Aucun résultat",+ "optional": "Facultatif",+ "required": "Obligatoire",+ "yes": "Oui",+ "no": "Non",+ "or": "ou",+ "and": "et",+ "all": "Tout",+ "none": "Aucun",+ "page_of": "Page {{page}} sur {{total}}",+ "prev": "Précédent",+ "next": "Suivant",+ "select_placeholder": "Sélectionner…",+ "search_placeholder": "Rechercher…",+ "pick_date": "Choisir une date",+ "comma_separated_hint": "Séparez les valeurs par des virgules.",+ "are_you_sure": "Êtes-vous sûr ?",+ "remove_question": "Supprimer ?",+ "deleted": "Supprimé",+ "unsaved_changes": "Vous avez des modifications non enregistrées.",+ "prices": "Prix"+ },+ "color_picker": {+ "no_color": "Aucune couleur"+ },+ "messages": {+ "saved": "Enregistré",+ "created": "Créé",+ "updated": "Mis à jour",+ "removed": "Supprimé",+ "settings_updated": "Paramètres mis à jour",+ "store_settings_updated": "Paramètres de la boutique mis à jour",+ "invitation_sent": "Invitation envoyée",+ "invitation_resent": "Invitation renvoyée",+ "invitation_accepted": "Bienvenue sur Spree",+ "key_created": "Clé créée",+ "key_updated": "Clé mise à jour",+ "key_revoked": "Clé révoquée",+ "key_deleted": "Clé supprimée",+ "product_saved": "Produit enregistré",+ "product_created": "Produit créé",+ "product_deleted": "Produit supprimé",+ "order_saved": "Commande enregistrée",+ "customer_saved": "Client enregistré",+ "customer_deleted": "Client supprimé",+ "payment_method_saved": "Moyen de paiement enregistré",+ "tax_category_saved": "Catégorie de taxe enregistrée",+ "stock_location_saved": "Emplacement de stock enregistré",+ "promotion_created": "Promotion créée",+ "promotion_saved": "Promotion enregistrée",+ "promotion_deleted": "Promotion supprimée",+ "gift_card_created": "Carte cadeau créée",+ "address_saved": "Adresse enregistrée",+ "address_removed": "Adresse supprimée",+ "store_credit_saved": "Avoir enregistré",+ "store_credit_removed": "Avoir supprimé",+ "copied_to_clipboard": "Copié dans le presse-papiers",+ "profile_updated": "Profil mis à jour"+ },+ "errors": {+ "required": "Ce champ est obligatoire",+ "generic": "Une erreur s'est produite",+ "unexpected": "Une erreur inattendue s'est produite",+ "failed_to_load": "Échec du chargement",+ "failed_to_save": "Échec de l'enregistrement",+ "failed_to_update": "Échec de la mise à jour",+ "failed_to_create": "Échec de la création",+ "failed_to_delete": "Échec de la suppression",+ "failed_to_load_customer": "Échec du chargement du client",+ "failed_to_load_order": "Échec du chargement de la commande",+ "failed_to_load_product": "Échec du chargement du produit",+ "failed_to_send_invitation": "Échec de l'envoi de l'invitation",+ "failed_to_revoke_key": "Échec de la révocation de la clé",+ "failed_to_update_store": "Échec de la mise à jour des paramètres de la boutique",+ "failed_to_update_staff": "Échec de la mise à jour du personnel",+ "network": "Erreur réseau — veuillez réessayer",+ "unauthorized": "Vous n'avez pas l'autorisation d'effectuer cette action",+ "not_found": "Introuvable",+ "failed_to_update_profile": "Échec de la mise à jour du profil"+ },+ "auth": {+ "login": {+ "title": "Bon retour",+ "subtitle": "Connectez-vous à votre compte administrateur"+ },+ "logout": "Se déconnecter"+ },+ "fields": {+ "name": {+ "label": "Nom"+ },+ "label": {+ "label": "Libellé"+ },+ "description": {+ "label": "Description"+ },+ "code": {+ "label": "Code"+ },+ "email": {+ "label": "E-mail"+ },+ "password": {+ "label": "Mot de passe"+ },+ "first_name": {+ "label": "Prénom"+ },+ "last_name": {+ "label": "Nom de famille"+ },+ "phone": {+ "label": "Téléphone"+ },+ "company": {+ "label": "Société"+ },+ "address1": {+ "label": "Adresse ligne 1"+ },+ "address2": {+ "label": "Adresse ligne 2"+ },+ "city": {+ "label": "Ville"+ },+ "zipcode": {+ "label": "Code postal"+ },+ "country_iso": {+ "label": "Pays"+ },+ "state_abbr": {+ "label": "État / Province"+ },+ "state_name": {+ "label": "État / Province"+ },+ "starts_at": {+ "label": "Début"+ },+ "ends_at": {+ "label": "Fin"+ },+ "expires_at": {+ "label": "Expiration"+ },+ "active": {+ "label": "Actif"+ },+ "kind": {+ "label": "Type"+ },+ "amount": {+ "label": "Montant"+ },+ "currency": {+ "label": "Devise"+ },+ "quantity": {+ "label": "Quantité"+ },+ "slug": {+ "label": "Slug"+ },+ "meta_title": {+ "label": "Méta-titre"+ },+ "meta_description": {+ "label": "Méta-description"+ },+ "status": {+ "label": "Statut"+ },+ "created_at": {+ "label": "Créé le"+ },+ "updated_at": {+ "label": "Mis à jour le"+ },+ "completed_at": {+ "label": "Terminé le"+ },+ "total": {+ "label": "Total"+ },+ "subtotal": {+ "label": "Sous-total"+ },+ "tax": {+ "label": "Taxe"+ },+ "shipping": {+ "label": "Livraison"+ },+ "discount": {+ "label": "Remise"+ },+ "login": {+ "email": {+ "placeholder": "[email protected]"+ }+ },+ "address": {+ "label": {+ "label": "Libellé",+ "placeholder": "ex. Domicile, Bureau"+ },+ "address1": {+ "label": "Adresse"+ },+ "address2": {+ "label": "Appartement, bureau, etc."+ },+ "postal_code": {+ "label": "Code postal"+ },+ "is_default_billing": {+ "label": "Adresse de facturation par défaut"+ },+ "is_default_shipping": {+ "label": "Adresse de livraison par défaut"+ }+ },+ "media": {+ "alt": {+ "label": "Texte alternatif",+ "placeholder": "Décrivez l'image pour l'accessibilité et le SEO"+ }+ }+ },+ "components": {+ "currency_select": {+ "placeholder": "Sélectionner une devise"+ },+ "channel_select": {+ "placeholder": "Sélectionner un canal de vente"+ },+ "locale_select": {+ "placeholder": "Sélectionner une langue",+ "multi_placeholder": "Ajouter des langues…",+ "empty": "Aucune langue trouvée"+ },+ "country_combobox": {+ "search_placeholder": "Rechercher des pays…",+ "empty": "Aucun pays trouvé"+ },+ "state_combobox": {+ "search_placeholder": "Rechercher des régions…",+ "empty": "Aucune région trouvée"+ },+ "command_palette": {+ "placeholder": "Rechercher des produits, des commandes, des clients…",+ "title": "Recherche et commandes",+ "description": "Effectuez une recherche parmi les produits, les commandes et les clients, ou exécutez une commande.",+ "no_results": "Aucun résultat pour « {{query}} ».",+ "empty_hint": "Saisissez du texte pour rechercher, ou choisissez une commande ci-dessous.",+ "goto": "Aller à",+ "goto_label": "Aller à {{label}}"+ },+ "bulk_action_bar": {+ "selected": "{{count}} sélectionné(s)",+ "default_success": "{n} enregistrements mis à jour",+ "default_error": "L’opération groupée a échoué"+ },+ "preferences_form": {+ "comma_separated_hint": "Séparez les valeurs par des virgules.",+ "tiers": {+ "label": "Paliers",+ "header_threshold": "Total de la commande ≥",+ "header_value": "Remise",+ "empty": "Aucun palier pour le moment. Le taux de base s’applique jusqu’à l’ajout d’un palier.",+ "add_tier": "Ajouter un palier",+ "remove_tier": "Supprimer le palier"+ }+ },+ "confirm_dialog": {+ "title": "Êtes-vous sûr ?"+ },+ "table_toolbar": {+ "search_placeholder": "Rechercher…",+ "filter_select_placeholder": "Sélectionner…",+ "filter_date_placeholder": "Choisir une date",+ "filter_text_placeholder": "Filtrer…",+ "filters_button": "Filtres",+ "sort_by": "Trier par",+ "sort_tooltip": "Trier",+ "order": "Ordre",+ "ascending": "Croissant",+ "descending": "Décroissant",+ "columns_tooltip": "Colonnes",+ "visible_columns": "Colonnes visibles",+ "reset_to_default": "Réinitialiser",+ "clear_all": "Tout effacer",+ "no_filters": "Aucun filtre. Cliquez ci-dessous pour en ajouter un.",+ "add_filter": "Ajouter un filtre",+ "operators": {+ "contains": "contient",+ "equals": "est égal à",+ "does_not_equal": "n'est pas égal à",+ "starts_with": "commence par",+ "ends_with": "se termine par",+ "is_set": "est défini",+ "is_not_set": "n'est pas défini",+ "is": "est",+ "is_not": "n'est pas",+ "is_any_of": "est l'un de",+ "is_none_of": "n'est aucun de",+ "greater_than": "supérieur à",+ "greater_than_or_equal": "supérieur ou égal à",+ "less_than": "inférieur à",+ "less_than_or_equal": "inférieur ou égal à",+ "after": "après",+ "before": "avant",+ "on_or_after": "le ou après",+ "on_or_before": "le ou avant"+ }+ },+ "media": {+ "remove_tooltip": "Supprimer l’image"+ },+ "custom_fields": {+ "json_placeholder": "{ \"example\": \"value\" }"+ },+ "export_button": {+ "title": "Exporter au format CSV",+ "description": "Nous préparons votre fichier CSV en arrière-plan et le téléchargeons dès qu'il est prêt. Si cela prend un certain temps, vous recevrez également un lien par e-mail.",+ "filtered": {+ "title": "Filtre actuel",+ "no_filter": "Aucun filtre actif — équivaut à exporter tous les enregistrements.",+ "unknown_count": "Exportez les enregistrements correspondant à votre filtre actuel.",+ "count_one": "Exportez l'enregistrement {{formattedCount}} correspondant à votre filtre actuel.",+ "count_other": "Exportez les {{formattedCount}} enregistrements correspondant à votre filtre actuel.",+ "count_few": "Exportez les {{formattedCount}} enregistrements correspondant à votre filtre actuel.",+ "count_many": "Exportez les {{formattedCount}} enregistrements correspondant à votre filtre actuel."+ },+ "all": {+ "title": "Tous les enregistrements",+ "description": "Ignorer les filtres et tout exporter dans cette boutique."+ }+ },+ "metadata_card": {+ "title": "Métadonnées",+ "empty_title": "Aucune métadonnée",+ "empty_description": "Les applications et intégrations remplissent ceci automatiquement."+ },+ "rich_text_editor": {+ "placeholder": "Écrivez quelque chose…",+ "link_url_prompt": "URL",+ "bold": "Gras",+ "italic": "Italique",+ "strikethrough": "Barré",+ "bullet_list": "Liste à puces",+ "ordered_list": "Liste numérotée",+ "blockquote": "Citation",+ "link": "Lien",+ "undo": "Annuler",+ "redo": "Rétablir"+ },+ "date_range_picker": {+ "presets": {+ "last_7_days": "7 derniers jours",+ "last_14_days": "14 derniers jours",+ "last_30_days": "30 derniers jours",+ "last_90_days": "90 derniers jours",+ "this_month": "Ce mois-ci",+ "year_to_date": "Depuis le début de l'année"+ }+ },+ "pagination": {+ "range": "{{from}}–{{to}} sur {{count}}",+ "rows_per_page": "Lignes par page",+ "first_page": "Aller à la première page",+ "previous_page": "Aller à la page précédente",+ "next_page": "Aller à la page suivante",+ "last_page": "Aller à la dernière page"+ },+ "theme_toggle": {+ "label": "Thème",+ "light": "Clair",+ "dark": "Sombre",+ "system": "Système"+ },+ "json_preview_drawer": {+ "copied": "Copié",+ "copy_all": "Tout copier",+ "open_raw": "Ouvrir la réponse brute",+ "raw": "Brut",+ "failed_to_load": "Échec du chargement : {{message}}",+ "collapse_depth": "Profondeur de réduction",+ "depth": "Profondeur {{level}}"+ },+ "page_header": {+ "view_as_json": "Voir en JSON",+ "copy_id": "Copier l'ID",+ "copy_number": "Copier le numéro"+ }+ },+ "validation": {+ "required": "{{field}} est obligatoire",+ "positive_number": "{{field}} doit être supérieur à 0",+ "min_length": "{{field}} doit comporter au moins {{count}} caractères",+ "passwords_dont_match": "Les mots de passe ne correspondent pas",+ "invalid_email_or_password": "E-mail ou mot de passe invalide",+ "invalid_email": "Saisissez une adresse e-mail valide",+ "invalid_hex_color": "Couleur hexadécimale invalide",+ "invalid_password": "Mot de passe invalide",+ "password_required": "Le mot de passe est obligatoire",+ "first_name_required": "Le prénom est obligatoire",+ "last_name_required": "Le nom est obligatoire"+ },+ "account": {+ "edit_profile": "Modifier le profil",+ "language": {+ "label": "Langue",+ "update_failed": "Impossible d’enregistrer votre préférence de langue. Veuillez réessayer."+ },+ "view_store": "Voir la boutique",+ "documentation": "Documentation",+ "community": "Communauté",+ "contact_support": "Contacter le support",+ "log_out": "Se déconnecter"+ }+ }+}diff --git a/packages/dashboard-core/src/locales/pl.json b/packages/dashboard-core/src/locales/pl.jsonnew file mode 100644index 0000000000..9e610acd9e--- /dev/null+++ b/packages/dashboard-core/src/locales/pl.json@@ -0,0 +1,504 @@+{+ "admin": {+ "actions": {+ "add": "Dodaj",+ "apply": "Zastosuj",+ "cancel": "Anuluj",+ "clear": "Wyczyść",+ "revoke": "Cofnij",+ "close": "Zamknij",+ "confirm": "Potwierdź",+ "done": "Gotowe",+ "create": "Utwórz",+ "creating": "Tworzenie…",+ "delete": "Usuń",+ "deleting": "Usuwanie…",+ "discard": "Odrzuć",+ "discard_changes": "Odrzuć zmiany",+ "edit": "Edytuj",+ "generate": "Generuj",+ "remove": "Usuń",+ "save": "Zapisz",+ "saving": "Zapisywanie…",+ "search": "Szukaj",+ "sign_in": "Zaloguj się",+ "signing_in": "Logowanie…",+ "view_all": "Zobacz wszystko",+ "view_details": "Zobacz szczegóły",+ "copy": "Kopiuj",+ "copied": "Skopiowano!",+ "export": "Eksportuj",+ "exporting": "Eksportowanie…",+ "import": "Importuj",+ "invite": "Zaproś",+ "send": "Wyślij",+ "send_invitation": "Wyślij zaproszenie",+ "sending": "Wysyłanie…",+ "reset": "Resetuj",+ "show": "Pokaż",+ "hide": "Ukryj",+ "back": "Wstecz",+ "actions_menu": "Akcje",+ "more_actions": "Więcej akcji"+ },+ "row_actions": {+ "menu_label": "Otwórz akcje",+ "edit": "Edytuj",+ "clone": "Duplikuj",+ "delete": "Usuń"+ },+ "a11y": {+ "breadcrumb": "Ścieżka nawigacji",+ "toggle_sidebar": "Przełącz panel boczny",+ "settings_navigation": "Nawigacja ustawień",+ "user_menu": "Menu użytkownika",+ "drag_to_reorder": "Przeciągnij, aby zmienić kolejność",+ "reorder": "Zmień kolejność",+ "select_all_rows": "Zaznacz wszystkie wiersze na tej stronie",+ "select_row": "Zaznacz wiersz",+ "clear_date": "Wyczyść datę",+ "clear_selection": "Wyczyść zaznaczenie",+ "expand_all": "Rozwiń wszystko",+ "collapse_all": "Zwiń wszystko",+ "refetch": "Pobierz ponownie",+ "hide_value": "Ukryj wartość",+ "show_value": "Pokaż wartość",+ "pick_color": "Wybierz kolor",+ "change_color": "Zmień kolor ({{value}})",+ "stock_at_locations": "Stan magazynowy w lokalizacjach",+ "edit_media": "Edytuj multimedia",+ "delete_image": "Usuń obraz",+ "remove_image": "Usuń obraz",+ "view_image": "Wyświetl obraz",+ "upload_image": "Prześlij obraz",+ "remove_value": "Usuń wartość"+ },+ "common": {+ "loading": "Ładowanie…",+ "searching": "Wyszukiwanie…",+ "no_results": "Brak wyników",+ "optional": "Opcjonalne",+ "required": "Wymagane",+ "yes": "Tak",+ "no": "Nie",+ "or": "lub",+ "and": "i",+ "all": "Wszystkie",+ "none": "Brak",+ "page_of": "Strona {{page}} z {{total}}",+ "prev": "Poprzednia",+ "next": "Następna",+ "select_placeholder": "Wybierz…",+ "search_placeholder": "Szukaj…",+ "pick_date": "Wybierz datę",+ "comma_separated_hint": "Oddziel wartości przecinkami.",+ "are_you_sure": "Czy na pewno?",+ "remove_question": "Usunąć?",+ "deleted": "Usunięto",+ "unsaved_changes": "Masz niezapisane zmiany.",+ "prices": "Ceny"+ },+ "color_picker": {+ "no_color": "Brak koloru"+ },+ "messages": {+ "saved": "Zapisano",+ "created": "Utworzono",+ "updated": "Zaktualizowano",+ "removed": "Usunięto",+ "settings_updated": "Zaktualizowano ustawienia",+ "store_settings_updated": "Zaktualizowano ustawienia sklepu",+ "invitation_sent": "Wysłano zaproszenie",+ "invitation_resent": "Ponownie wysłano zaproszenie",+ "invitation_accepted": "Witamy w Spree",+ "key_created": "Utworzono klucz",+ "key_updated": "Zaktualizowano klucz",+ "key_revoked": "Unieważniono klucz",+ "key_deleted": "Usunięto klucz",+ "product_saved": "Zapisano produkt",+ "product_created": "Utworzono produkt",+ "product_deleted": "Usunięto produkt",+ "order_saved": "Zapisano zamówienie",+ "customer_saved": "Zapisano klienta",+ "customer_deleted": "Usunięto klienta",+ "payment_method_saved": "Zapisano metodę płatności",+ "tax_category_saved": "Zapisano kategorię podatkową",+ "stock_location_saved": "Zapisano lokalizację magazynu",+ "promotion_created": "Utworzono promocję",+ "promotion_saved": "Zapisano promocję",+ "promotion_deleted": "Usunięto promocję",+ "gift_card_created": "Utworzono kartę podarunkową",+ "address_saved": "Zapisano adres",+ "address_removed": "Usunięto adres",+ "store_credit_saved": "Zapisano kredyt sklepowy",+ "store_credit_removed": "Usunięto kredyt sklepowy",+ "copied_to_clipboard": "Skopiowano do schowka",+ "profile_updated": "Zaktualizowano profil"+ },+ "errors": {+ "required": "To pole jest wymagane",+ "generic": "Coś poszło nie tak",+ "unexpected": "Wystąpił nieoczekiwany błąd",+ "failed_to_load": "Nie udało się załadować",+ "failed_to_save": "Nie udało się zapisać",+ "failed_to_update": "Nie udało się zaktualizować",+ "failed_to_create": "Nie udało się utworzyć",+ "failed_to_delete": "Nie udało się usunąć",+ "failed_to_load_customer": "Nie udało się załadować klienta",+ "failed_to_load_order": "Nie udało się załadować zamówienia",+ "failed_to_load_product": "Nie udało się załadować produktu",+ "failed_to_send_invitation": "Nie udało się wysłać zaproszenia",+ "failed_to_revoke_key": "Nie udało się unieważnić klucza",+ "failed_to_update_store": "Nie udało się zaktualizować ustawień sklepu",+ "failed_to_update_staff": "Nie udało się zaktualizować personelu",+ "network": "Błąd sieci — spróbuj ponownie",+ "unauthorized": "Nie masz uprawnień, aby to zrobić",+ "not_found": "Nie znaleziono",+ "failed_to_update_profile": "Nie udało się zaktualizować profilu"+ },+ "auth": {+ "login": {+ "title": "Witaj ponownie",+ "subtitle": "Zaloguj się do swojego konta administratora"+ },+ "logout": "Wyloguj się"+ },+ "fields": {+ "name": {+ "label": "Nazwa"+ },+ "label": {+ "label": "Etykieta"+ },+ "description": {+ "label": "Opis"+ },+ "code": {+ "label": "Kod"+ },+ "email": {+ "label": "E-mail"+ },+ "password": {+ "label": "Hasło"+ },+ "first_name": {+ "label": "Imię"+ },+ "last_name": {+ "label": "Nazwisko"+ },+ "phone": {+ "label": "Telefon"+ },+ "company": {+ "label": "Firma"+ },+ "address1": {+ "label": "Adres – wiersz 1"+ },+ "address2": {+ "label": "Adres – wiersz 2"+ },+ "city": {+ "label": "Miasto"+ },+ "zipcode": {+ "label": "Kod pocztowy"+ },+ "country_iso": {+ "label": "Kraj"+ },+ "state_abbr": {+ "label": "Województwo / Region"+ },+ "state_name": {+ "label": "Województwo / Region"+ },+ "starts_at": {+ "label": "Rozpoczęcie"+ },+ "ends_at": {+ "label": "Zakończenie"+ },+ "expires_at": {+ "label": "Wygasa"+ },+ "active": {+ "label": "Aktywne"+ },+ "kind": {+ "label": "Rodzaj"+ },+ "amount": {+ "label": "Kwota"+ },+ "currency": {+ "label": "Waluta"+ },+ "quantity": {+ "label": "Ilość"+ },+ "slug": {+ "label": "Slug"+ },+ "meta_title": {+ "label": "Meta tytuł"+ },+ "meta_description": {+ "label": "Meta opis"+ },+ "status": {+ "label": "Status"+ },+ "created_at": {+ "label": "Data utworzenia"+ },+ "updated_at": {+ "label": "Data aktualizacji"+ },+ "completed_at": {+ "label": "Data ukończenia"+ },+ "total": {+ "label": "Suma"+ },+ "subtotal": {+ "label": "Suma częściowa"+ },+ "tax": {+ "label": "Podatek"+ },+ "shipping": {+ "label": "Wysyłka"+ },+ "discount": {+ "label": "Rabat"+ },+ "login": {+ "email": {+ "placeholder": "[email protected]"+ }+ },+ "address": {+ "label": {+ "label": "Etykieta",+ "placeholder": "np. Dom, Biuro"+ },+ "address1": {+ "label": "Adres"+ },+ "address2": {+ "label": "Mieszkanie, lokal itp."+ },+ "postal_code": {+ "label": "Kod pocztowy"+ },+ "is_default_billing": {+ "label": "Domyślny adres rozliczeniowy"+ },+ "is_default_shipping": {+ "label": "Domyślny adres wysyłki"+ }+ },+ "media": {+ "alt": {+ "label": "Tekst alternatywny",+ "placeholder": "Opisz obraz na potrzeby dostępności i SEO"+ }+ }+ },+ "components": {+ "currency_select": {+ "placeholder": "Wybierz walutę"+ },+ "channel_select": {+ "placeholder": "Wybierz kanał sprzedaży"+ },+ "locale_select": {+ "placeholder": "Wybierz język",+ "multi_placeholder": "Dodaj języki…",+ "empty": "Nie znaleziono języków"+ },+ "country_combobox": {+ "search_placeholder": "Szukaj krajów…",+ "empty": "Nie znaleziono krajów"+ },+ "state_combobox": {+ "search_placeholder": "Szukaj województw…",+ "empty": "Nie znaleziono województw"+ },+ "command_palette": {+ "placeholder": "Szukaj produktów, zamówień, klientów…",+ "title": "Wyszukiwanie i polecenia",+ "description": "Przeszukuj produkty, zamówienia i klientów lub uruchom polecenie.",+ "no_results": "Brak wyników dla „{{query}}”.",+ "empty_hint": "Zacznij pisać, aby wyszukać, lub wybierz polecenie poniżej.",+ "goto": "Przejdź do",+ "goto_label": "Przejdź do {{label}}"+ },+ "bulk_action_bar": {+ "selected": "Wybrano: {{count}}",+ "default_success": "Zaktualizowano {n} rekordów",+ "default_error": "Operacja zbiorcza nie powiodła się"+ },+ "preferences_form": {+ "comma_separated_hint": "Oddziel wartości przecinkami.",+ "tiers": {+ "label": "Progi",+ "header_threshold": "Wartość zamówienia ≥",+ "header_value": "Rabat",+ "empty": "Brak progów. Do momentu dodania progu obowiązuje stawka podstawowa.",+ "add_tier": "Dodaj próg",+ "remove_tier": "Usuń próg"+ }+ },+ "confirm_dialog": {+ "title": "Czy na pewno?"+ },+ "table_toolbar": {+ "search_placeholder": "Szukaj…",+ "filter_select_placeholder": "Wybierz…",+ "filter_date_placeholder": "Wybierz datę",+ "filter_text_placeholder": "Filtruj…",+ "filters_button": "Filtry",+ "sort_by": "Sortuj według",+ "sort_tooltip": "Sortuj",+ "order": "Kolejność",+ "ascending": "Rosnąco",+ "descending": "Malejąco",+ "columns_tooltip": "Kolumny",+ "visible_columns": "Widoczne kolumny",+ "reset_to_default": "Przywróć domyślne",+ "clear_all": "Wyczyść wszystko",+ "no_filters": "Brak filtrów. Kliknij poniżej, aby dodać filtr.",+ "add_filter": "Dodaj filtr",+ "operators": {+ "contains": "zawiera",+ "equals": "równa się",+ "does_not_equal": "nie równa się",+ "starts_with": "zaczyna się od",+ "ends_with": "kończy się na",+ "is_set": "jest ustawione",+ "is_not_set": "nie jest ustawione",+ "is": "jest",+ "is_not": "nie jest",+ "is_any_of": "jest jednym z",+ "is_none_of": "nie jest żadnym z",+ "greater_than": "większe niż",+ "greater_than_or_equal": "większe lub równe",+ "less_than": "mniejsze niż",+ "less_than_or_equal": "mniejsze lub równe",+ "after": "po",+ "before": "przed",+ "on_or_after": "w dniu lub po",+ "on_or_before": "w dniu lub przed"+ }+ },+ "media": {+ "remove_tooltip": "Usuń zdjęcie"+ },+ "custom_fields": {+ "json_placeholder": "{ \"example\": \"value\" }"+ },+ "export_button": {+ "title": "Eksportuj do CSV",+ "description": "Przygotujemy plik CSV w tle i pobierzemy go, gdy tylko będzie gotowy. Jeśli potrwa to dłużej, otrzymają Państwo również link e-mailem.",+ "filtered": {+ "title": "Bieżący filtr",+ "no_filter": "Brak aktywnego filtra — to samo co eksport wszystkich rekordów.",+ "unknown_count": "Wyeksportuj rekordy pasujące do bieżącego filtra.",+ "count_one": "Wyeksportuj {{formattedCount}} rekord pasujący do bieżącego filtra.",+ "count_other": "Wyeksportuj {{formattedCount}} rekordów pasujących do bieżącego filtra.",+ "count_few": "Wyeksportuj {{formattedCount}} rekordy pasujące do bieżącego filtra.",+ "count_many": "Wyeksportuj {{formattedCount}} rekordów pasujących do bieżącego filtra."+ },+ "all": {+ "title": "Wszystkie rekordy",+ "description": "Zignoruj filtry i wyeksportuj wszystko w tym sklepie."+ }+ },+ "metadata_card": {+ "title": "Metadane",+ "empty_title": "Brak metadanych",+ "empty_description": "Aplikacje i integracje wypełniają to automatycznie."+ },+ "rich_text_editor": {+ "placeholder": "Napisz coś…",+ "link_url_prompt": "Adres URL",+ "bold": "Pogrubienie",+ "italic": "Kursywa",+ "strikethrough": "Przekreślenie",+ "bullet_list": "Lista punktowana",+ "ordered_list": "Lista numerowana",+ "blockquote": "Cytat blokowy",+ "link": "Łącze",+ "undo": "Cofnij",+ "redo": "Ponów"+ },+ "date_range_picker": {+ "presets": {+ "last_7_days": "Ostatnie 7 dni",+ "last_14_days": "Ostatnie 14 dni",+ "last_30_days": "Ostatnie 30 dni",+ "last_90_days": "Ostatnie 90 dni",+ "this_month": "Bieżący miesiąc",+ "year_to_date": "Od początku roku"+ }+ },+ "pagination": {+ "range": "{{from}}–{{to}} z {{count}}",+ "rows_per_page": "Wierszy na stronę",+ "first_page": "Przejdź do pierwszej strony",+ "previous_page": "Przejdź do poprzedniej strony",+ "next_page": "Przejdź do następnej strony",+ "last_page": "Przejdź do ostatniej strony"+ },+ "theme_toggle": {+ "label": "Motyw",+ "light": "Jasny",+ "dark": "Ciemny",+ "system": "Systemowy"+ },+ "json_preview_drawer": {+ "copied": "Skopiowano",+ "copy_all": "Kopiuj wszystko",+ "open_raw": "Otwórz surową odpowiedź",+ "raw": "Surowe",+ "failed_to_load": "Nie udało się załadować: {{message}}",+ "collapse_depth": "Głębokość zwijania",+ "depth": "Głębokość {{level}}"+ },+ "page_header": {+ "view_as_json": "Pokaż jako JSON",+ "copy_id": "Kopiuj ID",+ "copy_number": "Kopiuj numer"+ }+ },+ "validation": {+ "required": "Pole {{field}} jest wymagane",+ "positive_number": "Pole {{field}} musi być większe niż 0",+ "min_length": "Pole {{field}} musi mieć co najmniej {{count}} znaków",+ "passwords_dont_match": "Hasła nie są zgodne",+ "invalid_email_or_password": "Nieprawidłowy adres e-mail lub hasło",+ "invalid_email": "Wprowadź prawidłowy adres e-mail",+ "invalid_hex_color": "Nieprawidłowy kolor szesnastkowy",+ "invalid_password": "Nieprawidłowe hasło",+ "password_required": "Hasło jest wymagane",+ "first_name_required": "Imię jest wymagane",+ "last_name_required": "Nazwisko jest wymagane"+ },+ "account": {+ "edit_profile": "Edytuj profil",+ "language": {+ "label": "Język",+ "update_failed": "Nie udało się zapisać preferencji języka. Spróbuj ponownie."+ },+ "view_store": "Zobacz sklep",+ "documentation": "Dokumentacja",+ "community": "Społeczność",+ "contact_support": "Skontaktuj się z pomocą",+ "log_out": "Wyloguj się"+ }+ }+}diff --git a/packages/dashboard-core/src/locales/zh-CN.json b/packages/dashboard-core/src/locales/zh-CN.jsonnew file mode 100644index 0000000000..15e665c544--- /dev/null+++ b/packages/dashboard-core/src/locales/zh-CN.json@@ -0,0 +1,504 @@+{+ "admin": {+ "actions": {+ "add": "添加",+ "apply": "应用",+ "cancel": "取消",+ "clear": "清除",+ "revoke": "撤销",+ "close": "关闭",+ "confirm": "确认",+ "done": "完成",+ "create": "创建",+ "creating": "创建中…",+ "delete": "删除",+ "deleting": "删除中…",+ "discard": "放弃",+ "discard_changes": "放弃更改",+ "edit": "编辑",+ "generate": "生成",+ "remove": "移除",+ "save": "保存",+ "saving": "保存中…",+ "search": "搜索",+ "sign_in": "登录",+ "signing_in": "登录中…",+ "view_all": "查看全部",+ "view_details": "查看详情",+ "copy": "复制",+ "copied": "已复制!",+ "export": "导出",+ "exporting": "导出中…",+ "import": "导入",+ "invite": "邀请",+ "send": "发送",+ "send_invitation": "发送邀请",+ "sending": "发送中…",+ "reset": "重置",+ "show": "显示",+ "hide": "隐藏",+ "back": "返回",+ "actions_menu": "操作",+ "more_actions": "更多操作"+ },+ "row_actions": {+ "menu_label": "打开操作",+ "edit": "编辑",+ "clone": "复制",+ "delete": "删除"+ },+ "a11y": {+ "breadcrumb": "面包屑导航",+ "toggle_sidebar": "切换侧边栏",+ "settings_navigation": "设置导航",+ "user_menu": "用户菜单",+ "drag_to_reorder": "拖动以重新排序",+ "reorder": "重新排序",+ "select_all_rows": "选择本页所有行",+ "select_row": "选择行",+ "clear_date": "清除日期",+ "clear_selection": "清除选择",+ "expand_all": "全部展开",+ "collapse_all": "全部折叠",+ "refetch": "重新获取",+ "hide_value": "隐藏值",+ "show_value": "显示值",+ "pick_color": "选择颜色",+ "change_color": "更改颜色({{value}})",+ "stock_at_locations": "各仓库库存",+ "edit_media": "编辑媒体",+ "delete_image": "删除图片",+ "remove_image": "移除图片",+ "view_image": "查看图片",+ "upload_image": "上传图片",+ "remove_value": "移除值"+ },+ "common": {+ "loading": "加载中…",+ "searching": "搜索中…",+ "no_results": "无结果",+ "optional": "可选",+ "required": "必填",+ "yes": "是",+ "no": "否",+ "or": "或",+ "and": "和",+ "all": "全部",+ "none": "无",+ "page_of": "第 {{page}} 页,共 {{total}} 页",+ "prev": "上一页",+ "next": "下一页",+ "select_placeholder": "请选择…",+ "search_placeholder": "搜索…",+ "pick_date": "选择日期",+ "comma_separated_hint": "用逗号分隔多个值。",+ "are_you_sure": "确定吗?",+ "remove_question": "移除?",+ "deleted": "已删除",+ "unsaved_changes": "您有未保存的更改。",+ "prices": "价格"+ },+ "color_picker": {+ "no_color": "无颜色"+ },+ "messages": {+ "saved": "已保存",+ "created": "已创建",+ "updated": "已更新",+ "removed": "已移除",+ "settings_updated": "设置已更新",+ "store_settings_updated": "店铺设置已更新",+ "invitation_sent": "邀请已发送",+ "invitation_resent": "邀请已重新发送",+ "invitation_accepted": "欢迎使用 Spree",+ "key_created": "密钥已创建",+ "key_updated": "密钥已更新",+ "key_revoked": "密钥已吊销",+ "key_deleted": "密钥已删除",+ "product_saved": "商品已保存",+ "product_created": "商品已创建",+ "product_deleted": "商品已删除",+ "order_saved": "订单已保存",+ "customer_saved": "客户已保存",+ "customer_deleted": "客户已删除",+ "payment_method_saved": "支付方式已保存",+ "tax_category_saved": "税收类别已保存",+ "stock_location_saved": "库存地点已保存",+ "promotion_created": "优惠已创建",+ "promotion_saved": "优惠已保存",+ "promotion_deleted": "优惠已删除",+ "gift_card_created": "礼品卡已创建",+ "address_saved": "地址已保存",+ "address_removed": "地址已移除",+ "store_credit_saved": "店铺积分已保存",+ "store_credit_removed": "店铺积分已移除",+ "copied_to_clipboard": "已复制到剪贴板",+ "profile_updated": "个人资料已更新"+ },+ "errors": {+ "required": "此字段为必填项",+ "generic": "出错了",+ "unexpected": "发生了意外错误",+ "failed_to_load": "加载失败",+ "failed_to_save": "保存失败",+ "failed_to_update": "更新失败",+ "failed_to_create": "创建失败",+ "failed_to_delete": "删除失败",+ "failed_to_load_customer": "加载客户失败",+ "failed_to_load_order": "加载订单失败",+ "failed_to_load_product": "加载商品失败",+ "failed_to_send_invitation": "发送邀请失败",+ "failed_to_revoke_key": "撤销密钥失败",+ "failed_to_update_store": "更新店铺设置失败",+ "failed_to_update_staff": "更新员工失败",+ "network": "网络错误 — 请重试",+ "unauthorized": "您没有执行此操作的权限",+ "not_found": "未找到",+ "failed_to_update_profile": "更新个人资料失败"+ },+ "auth": {+ "login": {+ "title": "欢迎回来",+ "subtitle": "登录您的管理员账户"+ },+ "logout": "退出登录"+ },+ "fields": {+ "name": {+ "label": "名称"+ },+ "label": {+ "label": "标签"+ },+ "description": {+ "label": "描述"+ },+ "code": {+ "label": "代码"+ },+ "email": {+ "label": "邮箱"+ },+ "password": {+ "label": "密码"+ },+ "first_name": {+ "label": "名字"+ },+ "last_name": {+ "label": "姓氏"+ },+ "phone": {+ "label": "电话"+ },+ "company": {+ "label": "公司"+ },+ "address1": {+ "label": "地址第 1 行"+ },+ "address2": {+ "label": "地址第 2 行"+ },+ "city": {+ "label": "城市"+ },+ "zipcode": {+ "label": "邮政编码"+ },+ "country_iso": {+ "label": "国家/地区"+ },+ "state_abbr": {+ "label": "州/省"+ },+ "state_name": {+ "label": "州/省"+ },+ "starts_at": {+ "label": "开始"+ },+ "ends_at": {+ "label": "结束"+ },+ "expires_at": {+ "label": "过期"+ },+ "active": {+ "label": "启用"+ },+ "kind": {+ "label": "类型"+ },+ "amount": {+ "label": "金额"+ },+ "currency": {+ "label": "币种"+ },+ "quantity": {+ "label": "数量"+ },+ "slug": {+ "label": "别名"+ },+ "meta_title": {+ "label": "Meta 标题"+ },+ "meta_description": {+ "label": "Meta 描述"+ },+ "status": {+ "label": "状态"+ },+ "created_at": {+ "label": "创建于"+ },+ "updated_at": {+ "label": "更新于"+ },+ "completed_at": {+ "label": "完成于"+ },+ "total": {+ "label": "合计"+ },+ "subtotal": {+ "label": "小计"+ },+ "tax": {+ "label": "税"+ },+ "shipping": {+ "label": "运费"+ },+ "discount": {+ "label": "优惠"+ },+ "login": {+ "email": {+ "placeholder": "[email protected]"+ }+ },+ "address": {+ "label": {+ "label": "标签",+ "placeholder": "例如:住宅、办公室"+ },+ "address1": {+ "label": "地址"+ },+ "address2": {+ "label": "公寓、套房等"+ },+ "postal_code": {+ "label": "邮政编码"+ },+ "is_default_billing": {+ "label": "默认账单地址"+ },+ "is_default_shipping": {+ "label": "默认收货地址"+ }+ },+ "media": {+ "alt": {+ "label": "替代文本",+ "placeholder": "为无障碍访问和 SEO 描述该图片"+ }+ }+ },+ "components": {+ "currency_select": {+ "placeholder": "选择货币"+ },+ "channel_select": {+ "placeholder": "选择销售渠道"+ },+ "locale_select": {+ "placeholder": "选择语言区域",+ "multi_placeholder": "添加语言区域…",+ "empty": "未找到语言区域"+ },+ "country_combobox": {+ "search_placeholder": "搜索国家/地区…",+ "empty": "未找到国家/地区"+ },+ "state_combobox": {+ "search_placeholder": "搜索州/省…",+ "empty": "未找到州/省"+ },+ "command_palette": {+ "placeholder": "搜索商品、订单、客户…",+ "title": "搜索与命令",+ "description": "搜索商品、订单和客户,或运行命令。",+ "no_results": "未找到与“{{query}}”相关的结果。",+ "empty_hint": "输入以搜索,或从下方选择命令。",+ "goto": "前往",+ "goto_label": "前往 {{label}}"+ },+ "bulk_action_bar": {+ "selected": "已选择 {{count}} 项",+ "default_success": "已更新 {n} 条记录",+ "default_error": "批量操作失败"+ },+ "preferences_form": {+ "comma_separated_hint": "使用逗号分隔多个值。",+ "tiers": {+ "label": "层级",+ "header_threshold": "订单总额 ≥",+ "header_value": "优惠",+ "empty": "暂无层级。在添加层级之前,将应用基础费率。",+ "add_tier": "添加层级",+ "remove_tier": "移除层级"+ }+ },+ "confirm_dialog": {+ "title": "确定吗?"+ },+ "table_toolbar": {+ "search_placeholder": "搜索…",+ "filter_select_placeholder": "选择…",+ "filter_date_placeholder": "选择日期",+ "filter_text_placeholder": "筛选…",+ "filters_button": "筛选",+ "sort_by": "排序方式",+ "sort_tooltip": "排序",+ "order": "顺序",+ "ascending": "升序",+ "descending": "降序",+ "columns_tooltip": "列",+ "visible_columns": "可见列",+ "reset_to_default": "重置为默认值",+ "clear_all": "全部清除",+ "no_filters": "暂无筛选条件。点击下方添加。",+ "add_filter": "添加筛选条件",+ "operators": {+ "contains": "包含",+ "equals": "等于",+ "does_not_equal": "不等于",+ "starts_with": "开头为",+ "ends_with": "结尾为",+ "is_set": "已设置",+ "is_not_set": "未设置",+ "is": "等于",+ "is_not": "不等于",+ "is_any_of": "是其中任一",+ "is_none_of": "不是其中任一",+ "greater_than": "大于",+ "greater_than_or_equal": "大于或等于",+ "less_than": "小于",+ "less_than_or_equal": "小于或等于",+ "after": "晚于",+ "before": "早于",+ "on_or_after": "在该日期或之后",+ "on_or_before": "在该日期或之前"+ }+ },+ "media": {+ "remove_tooltip": "移除图片"+ },+ "custom_fields": {+ "json_placeholder": "{ \"example\": \"value\" }"+ },+ "export_button": {+ "title": "导出为 CSV",+ "description": "我们将在后台准备您的 CSV 文件,准备就绪后立即下载。如果耗时较长,您还会收到一封包含下载链接的邮件。",+ "filtered": {+ "title": "当前筛选",+ "no_filter": "未应用筛选 — 与导出所有记录相同。",+ "unknown_count": "导出符合当前筛选条件的记录。",+ "count_one": "导出符合当前筛选条件的 {{formattedCount}} 条记录。",+ "count_other": "导出符合当前筛选条件的 {{formattedCount}} 条记录。",+ "count_few": "导出符合当前筛选条件的 {{formattedCount}} 条记录。",+ "count_many": "导出符合当前筛选条件的 {{formattedCount}} 条记录。"+ },+ "all": {+ "title": "所有记录",+ "description": "忽略筛选条件,导出此店铺中的全部内容。"+ }+ },+ "metadata_card": {+ "title": "元数据",+ "empty_title": "暂无元数据",+ "empty_description": "应用和集成会自动填充此内容。"+ },+ "rich_text_editor": {+ "placeholder": "写点什么…",+ "link_url_prompt": "URL",+ "bold": "加粗",+ "italic": "斜体",+ "strikethrough": "删除线",+ "bullet_list": "无序列表",+ "ordered_list": "有序列表",+ "blockquote": "引用",+ "link": "链接",+ "undo": "撤销",+ "redo": "重做"+ },+ "date_range_picker": {+ "presets": {+ "last_7_days": "最近 7 天",+ "last_14_days": "最近 14 天",+ "last_30_days": "最近 30 天",+ "last_90_days": "最近 90 天",+ "this_month": "本月",+ "year_to_date": "今年至今"+ }+ },+ "pagination": {+ "range": "{{from}}–{{to}},共 {{count}} 条",+ "rows_per_page": "每页行数",+ "first_page": "转到第一页",+ "previous_page": "转到上一页",+ "next_page": "转到下一页",+ "last_page": "转到最后一页"+ },+ "theme_toggle": {+ "label": "主题",+ "light": "浅色",+ "dark": "深色",+ "system": "系统"+ },+ "json_preview_drawer": {+ "copied": "已复制",+ "copy_all": "全部复制",+ "open_raw": "打开原始响应",+ "raw": "原始数据",+ "failed_to_load": "加载失败:{{message}}",+ "collapse_depth": "折叠层级",+ "depth": "层级 {{level}}"+ },+ "page_header": {+ "view_as_json": "查看为 JSON",+ "copy_id": "复制 ID",+ "copy_number": "复制编号"+ }+ },+ "validation": {+ "required": "{{field}} 为必填项",+ "positive_number": "{{field}} 必须大于 0",+ "min_length": "{{field}} 至少需要 {{count}} 个字符",+ "passwords_dont_match": "两次输入的密码不一致",+ "invalid_email_or_password": "邮箱或密码无效",+ "invalid_email": "请输入有效的邮箱地址",+ "invalid_hex_color": "无效的十六进制颜色",+ "invalid_password": "密码无效",+ "password_required": "密码为必填项",+ "first_name_required": "名字为必填项",+ "last_name_required": "姓氏为必填项"+ },+ "account": {+ "edit_profile": "编辑个人资料",+ "language": {+ "label": "语言",+ "update_failed": "无法保存您的语言偏好。请重试。"+ },+ "view_store": "查看店铺",+ "documentation": "文档",+ "community": "社区",+ "contact_support": "联系支持",+ "log_out": "退出登录"+ }+ }+}diff --git a/packages/dashboard-core/src/providers/auth-provider.tsx b/packages/dashboard-core/src/providers/auth-provider.tsxindex d937583abf..77d592bf49 100644--- a/packages/dashboard-core/src/providers/auth-provider.tsx+++ b/packages/dashboard-core/src/providers/auth-provider.tsx@@ -1,6 +1,7 @@import type { AdminUser, AuthTokens, InvitationAcceptParams } from '@spree/admin-sdk'import { createContext, type ReactNode, useCallback, useEffect, useRef, useState } from 'react'import { adminClient } from '../client'+import { ADMIN_LOCALE_STORAGE_KEY, switchLocale } from '../lib/i18n'interface AuthContextValue {user: AdminUser | null@@ -11,6 +12,12 @@ interface AuthContextValue {login: (email: string, password: string) => Promise<void>logout: () => Promise<void>acceptInvitation: (id: string, token: string, params: InvitationAcceptParams) => Promise<void>+ /**+ * Merge updated fields into the authenticated user (e.g. after a profile+ * save) so context consumers like the top-bar reflect the change immediately+ * instead of waiting for the next token refresh. No-op when signed out.+ */+ updateUser: (changes: Partial<AdminUser>) => void}export const AuthContext = createContext<AuthContextValue | null>(null)@@ -38,6 +45,20 @@ export function AuthProvider({ children }: { children: ReactNode }) {adminClient.setToken(accessToken)setToken(accessToken)setUser(authUser)+ // The account's saved admin language is the source of truth across devices.+ // Compare against the persisted choice (not the live i18n.language): if they+ // already agree, the page booted in the right language and no reload is+ // needed — this also prevents a reload loop on the periodic token refresh.+ const code = authUser.selected_locale+ const stored =+ typeof localStorage !== 'undefined'+ ? (localStorage.getItem(ADMIN_LOCALE_STORAGE_KEY) ?? 'en')+ : 'en'+ if (code && code !== stored) switchLocale(code)+ }, [])++ const updateUser = useCallback((changes: Partial<AdminUser>) => {+ setUser((current) => (current ? { ...current, ...changes } : current))}, [])const clearSession = useCallback(() => {@@ -140,6 +161,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {login,logout,acceptInvitation,+ updateUser,}}>{children}diff --git a/packages/dashboard-ui/src/index.ts b/packages/dashboard-ui/src/index.tsindex d0328d10f7..117d42a19f 100644--- a/packages/dashboard-ui/src/index.ts+++ b/packages/dashboard-ui/src/index.ts@@ -34,6 +34,7 @@ export * from './spree/country-flag'export * from './spree/data-grid'export * from './spree/drag-handle'export * from './spree/form-actions'+// JsonPreviewDrawer and JsonValueView are intentionally NOT re-exported from// this barrel: they pull in `@uiw/react-json-view` (~30KB gzip), and// code-splitting only works when consumers can deep-import via@@ -41,6 +42,7 @@ export * from './spree/form-actions'// `@spree/dashboard-ui/spree/json-value-view`. Types are available the same// way — `import { type JsonPreviewDrawerProps } from '@spree/dashboard-ui/spree/json-preview-drawer'`.+export * from './spree/language-menu-items'export * from './spree/metadata/metadata-card'export * from './spree/relative-time'export * from './spree/resource-combobox'diff --git a/packages/dashboard-ui/src/lib/date-locale.ts b/packages/dashboard-ui/src/lib/date-locale.tsnew file mode 100644index 0000000000..c626f5f21e--- /dev/null+++ b/packages/dashboard-ui/src/lib/date-locale.ts@@ -0,0 +1,19 @@+import { de, enUS, fr, pl } from 'date-fns/locale'+import i18n from 'i18next'+import type { Locale } from 'react-day-picker'++// Maps the admin UI language (i18next) to a date-fns locale so calendars and+// date formatting render month/weekday names in the chosen language. Falls+// back to English. Extend this map whenever a new UI locale bundle ships.+const DATE_LOCALES: Record<string, Locale> = {+ en: enUS,+ de,+ fr,+ pl,+}++/** date-fns locale for the active admin UI language (falls back to English). */+export function activeDateLocale(): Locale {+ const lang = i18n.language ?? 'en'+ return DATE_LOCALES[lang] ?? DATE_LOCALES[lang.split('-')[0]] ?? enUS+}diff --git a/packages/dashboard-ui/src/spree/form-actions.tsx b/packages/dashboard-ui/src/spree/form-actions.tsxindex b53f4c2745..6224510db0 100644--- a/packages/dashboard-ui/src/spree/form-actions.tsx+++ b/packages/dashboard-ui/src/spree/form-actions.tsx@@ -2,6 +2,7 @@ import { useHotkey } from '@tanstack/react-hotkeys'import { Loader2Icon } from 'lucide-react'import { useEffect } from 'react'import { type FieldValues, type UseFormReturn, useFormState } from 'react-hook-form'+import { useTranslation } from 'react-i18next'import { Button } from '../ui/button'/**@@ -19,19 +20,22 @@ import { Button } from '../ui/button'*/export function FormSaveButton<TFieldValues extends FieldValues>({form,- label = 'Save',- savingLabel = 'Saving…',+ label,+ savingLabel,}: {form: UseFormReturn<TFieldValues, any, any>label?: stringsavingLabel?: string}) {+ const { t } = useTranslation()const { isDirty, isSubmitting } = useFormState({ control: form.control })return (<Button type="submit" size="sm" disabled={!isDirty || isSubmitting}>{isSubmitting && <Loader2Icon className="animate-spin" />}- {isSubmitting ? savingLabel : label}+ {isSubmitting+ ? (savingLabel ?? t('admin.actions.saving'))+ : (label ?? t('admin.actions.save'))}</Button>)}@@ -46,13 +50,14 @@ export function FormSaveButton<TFieldValues extends FieldValues>({*/export function FormDiscardButton<TFieldValues extends FieldValues>({form,- label = 'Discard',+ label,onDiscard,}: {form: UseFormReturn<TFieldValues, any, any>label?: stringonDiscard?: () => void}) {+ const { t } = useTranslation()const { isDirty, isSubmitting } = useFormState({ control: form.control })if (!isDirty) return null@@ -65,7 +70,7 @@ export function FormDiscardButton<TFieldValues extends FieldValues>({disabled={isSubmitting}onClick={onDiscard ?? (() => form.reset())}>- {label}+ {label ?? t('admin.actions.discard')}</Button>)}diff --git a/packages/dashboard-ui/src/spree/json-preview-drawer.tsx b/packages/dashboard-ui/src/spree/json-preview-drawer.tsxindex 0b185be69d..23a69ac057 100644--- a/packages/dashboard-ui/src/spree/json-preview-drawer.tsx+++ b/packages/dashboard-ui/src/spree/json-preview-drawer.tsx@@ -160,7 +160,9 @@ export function JsonPreviewDrawer({<span className="ml-auto inline-flex items-center gap-1"><ToolbarButton size="xs" onClick={() => formatted && copy(formatted)} disabled={!data}>{copiedAll ? <CheckIcon className="size-3.5" /> : <CopyIcon className="size-3.5" />}- {copiedAll ? 'Copied' : 'Copy all'}+ {copiedAll+ ? t('admin.components.json_preview_drawer.copied')+ : t('admin.components.json_preview_drawer.copy_all')}</ToolbarButton><ToolbarButtonsize="icon-xs"@@ -181,10 +183,10 @@ export function JsonPreviewDrawer({target="_blank"rel="noreferrer noopener"className="inline-flex items-center gap-1 rounded-md px-2 py-1 text-zinc-400 hover:bg-zinc-800 hover:text-zinc-100 transition-colors"- title="Open raw response"+ title={t('admin.components.json_preview_drawer.open_raw')}><ExternalLinkIcon className="size-3.5" />- Raw+ {t('admin.components.json_preview_drawer.raw')}</a>)}</span>@@ -192,9 +194,11 @@ export function JsonPreviewDrawer({<div className="themed-scrollbar flex-1 overflow-auto p-4 font-mono text-sm">{isLoading ? (- <p className="text-zinc-500">Loading…</p>+ <p className="text-zinc-500">{t('admin.common.loading')}</p>) : error ? (- <p className="text-red-400">Failed to load: {error.message}</p>+ <p className="text-red-400">+ {t('admin.components.json_preview_drawer.failed_to_load', { message: error.message })}+ </p>) : data !== undefined ? (// The drawer paints its own dark surface around the renderer// (Sheet content + toolbar), so the view itself runs in `bare`@@ -225,6 +229,7 @@ function DepthControl({value: boolean | numberonChange: (next: boolean | number) => void}) {+ const { t } = useTranslation()const current = typeof value === 'number' ? `${value}` : value === true ? 'all' : 'open'return (<select@@ -236,13 +241,13 @@ function DepthControl({else onChange(Number(v))}}className="ml-1 bg-zinc-900 border border-zinc-700 rounded px-1.5 py-1 text-xs text-zinc-300 hover:bg-zinc-800 focus:outline-none focus:ring-1 focus:ring-zinc-600"- title="Collapse depth"+ title={t('admin.components.json_preview_drawer.collapse_depth')}>- <option value="open">Expand all</option>- <option value="1">Depth 1</option>- <option value="2">Depth 2</option>- <option value="3">Depth 3</option>- <option value="all">Collapse all</option>+ <option value="open">{t('admin.a11y.expand_all')}</option>+ <option value="1">{t('admin.components.json_preview_drawer.depth', { level: 1 })}</option>+ <option value="2">{t('admin.components.json_preview_drawer.depth', { level: 2 })}</option>+ <option value="3">{t('admin.components.json_preview_drawer.depth', { level: 3 })}</option>+ <option value="all">{t('admin.a11y.collapse_all')}</option></select>)}diff --git a/packages/dashboard-ui/src/spree/language-menu-items.tsx b/packages/dashboard-ui/src/spree/language-menu-items.tsxnew file mode 100644index 0000000000..1e33dc9f62--- /dev/null+++ b/packages/dashboard-ui/src/spree/language-menu-items.tsx@@ -0,0 +1,54 @@+import { CheckIcon, LanguagesIcon } from 'lucide-react'+import {+ DropdownMenuItem,+ DropdownMenuSub,+ DropdownMenuSubContent,+ DropdownMenuSubTrigger,+} from '../ui/dropdown-menu'++interface LanguageMenuItemsProps {+ /** Translated "Language" label for the submenu trigger (passed by the app). */+ label: string+ /** Admin UI languages available to switch to ({ code, name } pairs). */+ locales: ReadonlyArray<{ code: string; name: string }>+ /** Currently active language code. */+ value: string+ onSelect: (code: string) => void+}++/**+ * Admin UI language picker rendered inside the user dropdown menu as a nested+ * submenu (a single "Language ▸" row that expands to the list), so the menu+ * stays compact no matter how many languages are installed.+ *+ * Headless: the label, locale list, and change handler are passed in, so this+ * component imports no i18n/data runtime. Renders nothing when fewer than two+ * languages are installed: there's nothing to choose.+ */+export function LanguageMenuItems({ label, locales, value, onSelect }: LanguageMenuItemsProps) {+ if (locales.length < 2) return null++ const current = locales.find((l) => l.code === value)++ return (+ <DropdownMenuSub>+ <DropdownMenuSubTrigger>+ <LanguagesIcon className="size-4" />+ {label}+ {current && <span className="ml-auto text-xs text-muted-foreground">{current.name}</span>}+ </DropdownMenuSubTrigger>+ <DropdownMenuSubContent>+ {locales.map((locale) => (+ <DropdownMenuItem+ key={locale.code}+ closeOnClick={false}+ onClick={() => onSelect(locale.code)}+ >+ {locale.name}+ {value === locale.code && <CheckIcon className="ml-auto size-3.5" />}+ </DropdownMenuItem>+ ))}+ </DropdownMenuSubContent>+ </DropdownMenuSub>+ )+}diff --git a/packages/dashboard-ui/src/spree/metadata/metadata-card.tsx b/packages/dashboard-ui/src/spree/metadata/metadata-card.tsxindex e156e93607..2ad572b921 100644--- a/packages/dashboard-ui/src/spree/metadata/metadata-card.tsx+++ b/packages/dashboard-ui/src/spree/metadata/metadata-card.tsx@@ -10,15 +10,19 @@ interface MetadataCardProps {* empty); the API never returns `null`.*/metadata: Record<string, unknown>+ /** Translated copy (passed by the app — this component stays headless). */+ title: string+ emptyTitle: string+ emptyDescription: string}-export function MetadataCard({ metadata }: MetadataCardProps) {+export function MetadataCard({ metadata, title, emptyTitle, emptyDescription }: MetadataCardProps) {const entries = Object.entries(metadata)return (<Card><CardHeader>- <CardTitle>Metadata</CardTitle>+ <CardTitle>{title}</CardTitle></CardHeader><CardContent>{entries.length === 0 ? (@@ -27,10 +31,8 @@ export function MetadataCard({ metadata }: MetadataCardProps) {<EmptyMedia variant="icon"><BracesIcon /></EmptyMedia>- <EmptyTitle>No metadata</EmptyTitle>- <EmptyDescription>- Apps and integrations populate this automatically.- </EmptyDescription>+ <EmptyTitle>{emptyTitle}</EmptyTitle>+ <EmptyDescription>{emptyDescription}</EmptyDescription></EmptyHeader></Empty>) : (diff --git a/packages/dashboard-ui/src/spree/relative-time.tsx b/packages/dashboard-ui/src/spree/relative-time.tsxindex d71189d64f..5f38a6d90b 100644--- a/packages/dashboard-ui/src/spree/relative-time.tsx+++ b/packages/dashboard-ui/src/spree/relative-time.tsx@@ -1,5 +1,6 @@import { format, formatDistanceToNow } from 'date-fns'import type { ComponentProps, ReactNode } from 'react'+import { activeDateLocale } from '../lib/date-locale'import { cn } from '../lib/utils'import { Tooltip, TooltipContent, TooltipTrigger } from '../ui/tooltip'@@ -27,8 +28,9 @@ export function RelativeTime({const date = new Date(iso)if (Number.isNaN(date.getTime())) return <>{fallback}</>- const relative = formatDistanceToNow(date, { addSuffix: true })- const absolute = format(date, 'PPpp')+ const locale = activeDateLocale()+ const relative = formatDistanceToNow(date, { addSuffix: true, locale })+ const absolute = format(date, 'PPpp', { locale })return (<Tooltip>diff --git a/packages/dashboard-ui/src/spree/theme-toggle.tsx b/packages/dashboard-ui/src/spree/theme-toggle.tsxindex dd9929e2af..aa69b2a84c 100644--- a/packages/dashboard-ui/src/spree/theme-toggle.tsx+++ b/packages/dashboard-ui/src/spree/theme-toggle.tsx@@ -1,4 +1,5 @@import { CheckIcon, MonitorIcon, MoonIcon, SunIcon } from 'lucide-react'+import { useTranslation } from 'react-i18next'import { DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator } from '../ui/dropdown-menu'import { useTheme } from './theme-provider'@@ -8,16 +9,19 @@ import { useTheme } from './theme-provider'*/export function ThemeMenuItems() {const { mode, setMode } = useTheme()+ const { t } = useTranslation()const items = [- { value: 'light', label: 'Light', icon: SunIcon },- { value: 'dark', label: 'Dark', icon: MoonIcon },- { value: 'system', label: 'System', icon: MonitorIcon },+ { value: 'light', label: t('admin.components.theme_toggle.light'), icon: SunIcon },+ { value: 'dark', label: t('admin.components.theme_toggle.dark'), icon: MoonIcon },+ { value: 'system', label: t('admin.components.theme_toggle.system'), icon: MonitorIcon },] as constreturn (<>- <DropdownMenuLabel className="text-xs">Theme</DropdownMenuLabel>+ <DropdownMenuLabel className="text-xs">+ {t('admin.components.theme_toggle.label')}+ </DropdownMenuLabel>{items.map(({ value, label, icon: Icon }) => (<DropdownMenuItem key={value} closeOnClick={false} onClick={() => setMode(value)}><Icon className="size-4" />diff --git a/packages/dashboard-ui/src/ui/badge.tsx b/packages/dashboard-ui/src/ui/badge.tsxindex fca812ab0e..da200fbaaf 100644--- a/packages/dashboard-ui/src/ui/badge.tsx+++ b/packages/dashboard-ui/src/ui/badge.tsx@@ -84,11 +84,24 @@ const statusVariantMap: Record<string, VariantProps<typeof badgeVariants>['variarejected: 'destructive',}-function StatusBadge({ status, className }: { status: string; className?: string }) {+/**+ * Status pill whose color is derived from the raw status code. Stays headless:+ * pass a translated `label` from the app layer; without one it humanizes the+ * code itself (`balance_due` → `balance due`) as a best-effort fallback.+ */+function StatusBadge({+ status,+ label,+ className,+}: {+ status: string+ label?: string+ className?: string+}) {const variant = statusVariantMap[status] ?? 'outline'return (<Badge variant={variant} className={cn('capitalize', className)}>- {status.replace(/_/g, ' ')}+ {label ?? status.replace(/_/g, ' ')}</Badge>)}diff --git a/packages/dashboard-ui/src/ui/calendar.tsx b/packages/dashboard-ui/src/ui/calendar.tsxindex 99ba1ede13..0ae0d94873 100644--- a/packages/dashboard-ui/src/ui/calendar.tsx+++ b/packages/dashboard-ui/src/ui/calendar.tsx@@ -1,16 +1,21 @@import { ChevronLeftIcon, ChevronRightIcon } from 'lucide-react'import type * as React from 'react'import { DayPicker } from 'react-day-picker'+import { activeDateLocale } from '../lib/date-locale'import { cn } from '../lib/utils'function Calendar({className,classNames,showOutsideDays = true,+ locale,...props}: React.ComponentProps<typeof DayPicker>) {return (<DayPicker+ // Month/weekday names follow the admin UI language unless a caller+ // overrides `locale`.+ locale={locale ?? activeDateLocale()}showOutsideDays={showOutsideDays}className={cn('p-3', className)}classNames={{diff --git a/packages/dashboard-ui/src/ui/data-table.tsx b/packages/dashboard-ui/src/ui/data-table.tsxindex b1d2488113..33d67f4838 100644--- a/packages/dashboard-ui/src/ui/data-table.tsx+++ b/packages/dashboard-ui/src/ui/data-table.tsx@@ -27,7 +27,7 @@ function TableHead({ className, ...props }: React.ComponentProps<'th'>) {return (<thclassName={cn(- 'text-left text-sm font-medium text-muted-foreground bg-muted p-2 border-b border-border whitespace-nowrap first:pl-4 last:pr-4',+ 'text-left text-sm font-medium text-muted-foreground bg-muted/50 p-2 border-b border-border whitespace-nowrap first:pl-4 last:pr-4',className,)}{...props}diff --git a/packages/dashboard-ui/src/ui/date-picker.tsx b/packages/dashboard-ui/src/ui/date-picker.tsxindex e82d3a5955..b743d97727 100644--- a/packages/dashboard-ui/src/ui/date-picker.tsx+++ b/packages/dashboard-ui/src/ui/date-picker.tsx@@ -3,6 +3,7 @@ import { formatInTimeZone, fromZonedTime, toZonedTime } from 'date-fns-tz'import i18n from 'i18next'import { CalendarIcon, XIcon } from 'lucide-react'import { useEffect, useMemo, useRef, useState } from 'react'+import { activeDateLocale } from '../lib/date-locale'import { cn } from '../lib/utils'import { Button } from './button'import { Calendar } from './calendar'@@ -60,10 +61,11 @@ function formatTriggerLabel(placeholder: string,): string {if (!date || Number.isNaN(date.getTime())) return placeholder+ const locale = activeDateLocale()if (includeTime && value && !DATE_ONLY.test(value)) {- return formatInTimeZone(parseISO(value), tz, 'PPP p')+ return formatInTimeZone(parseISO(value), tz, 'PPP p', { locale })}- return format(date, includeTime ? 'PPP p' : 'PPP')+ return format(date, includeTime ? 'PPP p' : 'PPP', { locale })}function DatePicker({diff --git a/packages/dashboard-ui/src/ui/date-range-picker.tsx b/packages/dashboard-ui/src/ui/date-range-picker.tsxindex 25f1c4985c..83504499c0 100644--- a/packages/dashboard-ui/src/ui/date-range-picker.tsx+++ b/packages/dashboard-ui/src/ui/date-range-picker.tsx@@ -2,6 +2,8 @@ import { format, startOfMonth, startOfYear, subDays } from 'date-fns'import { CalendarIcon, ChevronDownIcon } from 'lucide-react'import { useState } from 'react'import type { DateRange as DayPickerDateRange } from 'react-day-picker'+import { useTranslation } from 'react-i18next'+import { activeDateLocale } from '../lib/date-locale'import { cn } from '../lib/utils'import { Button } from './button'import { Calendar } from './calendar'@@ -16,39 +18,39 @@ type PresetKey = '7d' | '14d' | '30d' | '90d' | 'this_month' | 'ytd' | 'custom'interface Preset {key: PresetKey- label: string+ labelKey: stringvalue: () => DateRange}const presets: Preset[] = [{key: '7d',- label: 'Last 7 days',+ labelKey: 'admin.components.date_range_picker.presets.last_7_days',value: () => ({ from: subDays(new Date(), 7), to: new Date() }),},{key: '14d',- label: 'Last 14 days',+ labelKey: 'admin.components.date_range_picker.presets.last_14_days',value: () => ({ from: subDays(new Date(), 14), to: new Date() }),},{key: '30d',- label: 'Last 30 days',+ labelKey: 'admin.components.date_range_picker.presets.last_30_days',value: () => ({ from: subDays(new Date(), 30), to: new Date() }),},{key: '90d',- label: 'Last 90 days',+ labelKey: 'admin.components.date_range_picker.presets.last_90_days',value: () => ({ from: subDays(new Date(), 90), to: new Date() }),},{key: 'this_month',- label: 'This month',+ labelKey: 'admin.components.date_range_picker.presets.this_month',value: () => ({ from: startOfMonth(new Date()), to: new Date() }),},{key: 'ytd',- label: 'Year to date',+ labelKey: 'admin.components.date_range_picker.presets.year_to_date',value: () => ({ from: startOfYear(new Date()), to: new Date() }),},]@@ -59,14 +61,20 @@ interface DateRangePickerProps {}export function DateRangePicker({ value, onChange }: DateRangePickerProps) {+ const { t } = useTranslation()const [open, setOpen] = useState(false)const [activePreset, setActivePreset] = useState<PresetKey>('30d')const [calendarRange, setCalendarRange] = useState<DayPickerDateRange | undefined>()+ const activePresetLabelKey =+ presets.find((p) => p.key === activePreset)?.labelKey ??+ 'admin.components.date_range_picker.presets.last_30_days'++ const dateLocale = activeDateLocale()const triggerLabel =activePreset === 'custom'- ? `${format(value.from, 'MMM d')} – ${format(value.to, 'MMM d')}`- : (presets.find((p) => p.key === activePreset)?.label ?? 'Last 30 days')+ ? `${format(value.from, 'MMM d', { locale: dateLocale })} – ${format(value.to, 'MMM d', { locale: dateLocale })}`+ : t(activePresetLabelKey)function selectPreset(preset: Preset) {const range = preset.value()@@ -117,7 +125,7 @@ export function DateRangePicker({ value, onChange }: DateRangePickerProps) {activePreset !== preset.key && 'text-muted-foreground',)}>- {preset.label}+ {t(preset.labelKey)}</button>))}</div>@@ -131,7 +139,7 @@ export function DateRangePicker({ value, onChange }: DateRangePickerProps) {/><div className="flex justify-end border-t pt-3"><Button size="sm" disabled={!canApply} onClick={applyCustomRange}>- Apply+ {t('admin.actions.apply')}</Button></div></div>diff --git a/packages/dashboard-ui/src/ui/empty.tsx b/packages/dashboard-ui/src/ui/empty.tsxindex bdb21a8ec4..f5b90d25b4 100644--- a/packages/dashboard-ui/src/ui/empty.tsx+++ b/packages/dashboard-ui/src/ui/empty.tsx@@ -31,7 +31,7 @@ const emptyMediaVariants = cva(variants: {variant: {default: 'bg-transparent',- icon: "flex size-8 shrink-0 items-center justify-center rounded-lg bg-muted text-foreground [&_svg:not([class*='size-'])]:size-4",+ icon: "flex size-8 shrink-0 items-center justify-center rounded-lg bg-muted text-foreground opacity-50 [&_svg:not([class*='size-'])]:size-4",},},defaultVariants: {diff --git a/packages/dashboard-ui/src/ui/pagination.tsx b/packages/dashboard-ui/src/ui/pagination.tsxindex a7c178ecbe..ca489e1d4b 100644--- a/packages/dashboard-ui/src/ui/pagination.tsx+++ b/packages/dashboard-ui/src/ui/pagination.tsx@@ -4,6 +4,7 @@ import {ChevronsLeftIcon,ChevronsRightIcon,} from 'lucide-react'+import { useTranslation } from 'react-i18next'import { Button } from './button'import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from './select'@@ -31,17 +32,25 @@ export function Pagination({onPageSizeChange,pageSizeOptions = [10, 20, 25, 30, 50],}: PaginationProps) {+ const { t } = useTranslation()+if (meta.pages <= 1 && !onPageSizeChange) return nullreturn (<div className="flex items-center justify-between border-t border-border px-4 py-3"><div className="text-sm text-muted-foreground">- {meta.from}–{meta.to} of {meta.count}+ {t('admin.components.pagination.range', {+ from: meta.from,+ to: meta.to,+ count: meta.count,+ })}</div><div className="flex items-center gap-6">{onPageSizeChange && (<div className="flex items-center gap-2">- <span className="text-sm text-muted-foreground">Rows per page</span>+ <span className="text-sm text-muted-foreground">+ {t('admin.components.pagination.rows_per_page')}+ </span><Selectvalue={`${meta.limit}`}onValueChange={(value) => onPageSizeChange(Number(value))}@@ -62,7 +71,7 @@ export function Pagination({{meta.pages > 1 && (<><span className="text-sm text-muted-foreground">- Page {meta.page} of {meta.pages}+ {t('admin.common.page_of', { page: meta.page, total: meta.pages })}</span><div className="flex items-center gap-1"><Button@@ -72,7 +81,7 @@ export function Pagination({disabled={!meta.previous}onClick={() => onPageChange(1)}>- <span className="sr-only">Go to first page</span>+ <span className="sr-only">{t('admin.components.pagination.first_page')}</span><ChevronsLeftIcon /></Button><Button@@ -81,7 +90,7 @@ export function Pagination({disabled={!meta.previous}onClick={() => meta.previous && onPageChange(meta.previous)}>- <span className="sr-only">Go to previous page</span>+ <span className="sr-only">{t('admin.components.pagination.previous_page')}</span><ChevronLeftIcon /></Button><Button@@ -90,7 +99,7 @@ export function Pagination({disabled={!meta.next}onClick={() => meta.next && onPageChange(meta.next)}>- <span className="sr-only">Go to next page</span>+ <span className="sr-only">{t('admin.components.pagination.next_page')}</span><ChevronRightIcon /></Button><Button@@ -100,7 +109,7 @@ export function Pagination({disabled={!meta.next}onClick={() => onPageChange(meta.pages)}>- <span className="sr-only">Go to last page</span>+ <span className="sr-only">{t('admin.components.pagination.last_page')}</span><ChevronsRightIcon /></Button></div>diff --git a/packages/dashboard-ui/src/ui/rich-text-editor.tsx b/packages/dashboard-ui/src/ui/rich-text-editor.tsxindex f26fc1567a..bee7cdae4c 100644--- a/packages/dashboard-ui/src/ui/rich-text-editor.tsx+++ b/packages/dashboard-ui/src/ui/rich-text-editor.tsx@@ -14,6 +14,7 @@ import {UndoIcon,} from 'lucide-react'import { useCallback, useEffect, useRef } from 'react'+import { useTranslation } from 'react-i18next'import { cn } from '../lib/utils'interface RichTextEditorProps {@@ -42,12 +43,14 @@ export function RichTextEditor({value = '',onChange,onBlur,- placeholder = 'Write something...',+ placeholder,className,disabled = false,ariaLabel,id,}: RichTextEditorProps) {+ const { t } = useTranslation()+ const resolvedPlaceholder = placeholder ?? t('admin.components.rich_text_editor.placeholder')const wrapperRef = useRef<HTMLDivElement | null>(null)// tiptap's `useEditor` registers `onUpdate`/`onBlur` only at create time —// later renders keep the first closure. Stash the latest callbacks in refs@@ -65,7 +68,7 @@ export function RichTextEditor({const editor = useEditor({extensions: [StarterKit.configure({ link: false }),- Placeholder.configure({ placeholder }),+ Placeholder.configure({ placeholder: resolvedPlaceholder }),Link.configure({ openOnClick: false }),],content: value,@@ -121,14 +124,14 @@ export function RichTextEditor({const setLink = useCallback(() => {if (!editor) returnconst previous = editor.getAttributes('link').href- const url = window.prompt('URL', previous)+ const url = window.prompt(t('admin.components.rich_text_editor.link_url_prompt'), previous)if (url === null) returnif (url === '') {editor.chain().focus().extendMarkRange('link').unsetLink().run()} else {editor.chain().focus().extendMarkRange('link').setLink({ href: url }).run()}- }, [editor])+ }, [editor, t])if (!editor) return null@@ -146,21 +149,21 @@ export function RichTextEditor({<ToolbarButtonactive={editor.isActive('bold')}onClick={() => editor.chain().focus().toggleBold().run()}- title="Bold"+ title={t('admin.components.rich_text_editor.bold')}><BoldIcon className="size-4" /></ToolbarButton><ToolbarButtonactive={editor.isActive('italic')}onClick={() => editor.chain().focus().toggleItalic().run()}- title="Italic"+ title={t('admin.components.rich_text_editor.italic')}><ItalicIcon className="size-4" /></ToolbarButton><ToolbarButtonactive={editor.isActive('strike')}onClick={() => editor.chain().focus().toggleStrike().run()}- title="Strikethrough"+ title={t('admin.components.rich_text_editor.strikethrough')}><StrikethroughIcon className="size-4" /></ToolbarButton>@@ -170,28 +173,32 @@ export function RichTextEditor({<ToolbarButtonactive={editor.isActive('bulletList')}onClick={() => editor.chain().focus().toggleBulletList().run()}- title="Bullet list"+ title={t('admin.components.rich_text_editor.bullet_list')}><ListIcon className="size-4" /></ToolbarButton><ToolbarButtonactive={editor.isActive('orderedList')}onClick={() => editor.chain().focus().toggleOrderedList().run()}- title="Ordered list"+ title={t('admin.components.rich_text_editor.ordered_list')}><ListOrderedIcon className="size-4" /></ToolbarButton><ToolbarButtonactive={editor.isActive('blockquote')}onClick={() => editor.chain().focus().toggleBlockquote().run()}- title="Blockquote"+ title={t('admin.components.rich_text_editor.blockquote')}><QuoteIcon className="size-4" /></ToolbarButton><ToolbarSeparator />- <ToolbarButton active={editor.isActive('link')} onClick={setLink} title="Link">+ <ToolbarButton+ active={editor.isActive('link')}+ onClick={setLink}+ title={t('admin.components.rich_text_editor.link')}+ ><LinkIcon className="size-4" /></ToolbarButton>@@ -199,14 +206,14 @@ export function RichTextEditor({<ToolbarButtononClick={() => editor.chain().focus().undo().run()}disabled={!editor.can().undo()}- title="Undo"+ title={t('admin.components.rich_text_editor.undo')}><UndoIcon className="size-4" /></ToolbarButton><ToolbarButtononClick={() => editor.chain().focus().redo().run()}disabled={!editor.can().redo()}- title="Redo"+ title={t('admin.components.rich_text_editor.redo')}><RedoIcon className="size-4" /></ToolbarButton>diff --git a/packages/dashboard/e2e/profile.spec.ts b/packages/dashboard/e2e/profile.spec.tsnew file mode 100644index 0000000000..55dcf81794--- /dev/null+++ b/packages/dashboard/e2e/profile.spec.ts@@ -0,0 +1,106 @@+import { expect, test } from '@playwright/test'+import { login } from './helpers'++const PROFILE_PATH = (storeId: string) => `/${storeId}/settings/profile`++// Serial: these tests mutate the shared admin user (name + selected_locale).+// The language test resets back to English so later tests/specs see English.+test.describe.configure({ mode: 'serial' })++test.describe('profile', () => {+ test('opens the profile page from the user menu', async ({ page }) => {+ await login(page)++ await page.getByRole('button', { name: /user menu/i }).click()+ await page.getByRole('menuitem', { name: /edit profile/i }).click()++ // The PageHeader title renders as an <h1>; the "Personal Details" CardTitle+ // is a <div>, so assert it as text rather than a heading role.+ await expect(page.getByRole('heading', { name: /^profile$/i })).toBeVisible({ timeout: 15_000 })+ await expect(page.getByText('Personal Details', { exact: true })).toBeVisible()+ // Email is identity-bound and not editable via PATCH /me.+ await expect(page.locator('#profile-email')).toBeDisabled()+ })++ test('edits personal details and persists across reload', async ({ page }) => {+ const creds = await login(page)+ await page.goto(PROFILE_PATH(creds.store_id))+ await expect(page.locator('#profile-first-name')).toBeVisible({ timeout: 15_000 })++ const firstName = `E2E${Date.now()}`++ await page.locator('#profile-first-name').fill(firstName)+ await page.locator('#profile-last-name').fill('Admin')+ await page.getByRole('button', { name: /^save$/i }).click()++ await expect(page.getByText(/profile updated/i)).toBeVisible({ timeout: 15_000 })++ await page.reload()+ await expect(page.locator('#profile-first-name')).toHaveValue(firstName, { timeout: 15_000 })+ })++ test('switching the language translates the admin UI', async ({ page }) => {+ const creds = await login(page)+ await page.goto(PROFILE_PATH(creds.store_id))+ await expect(page.locator('#profile-language')).toBeVisible({ timeout: 15_000 })++ // Select Polish (endonym shown in the picker) and save. The save triggers a+ // reload into Polish, so we assert on stable translated chrome that's always+ // present (not the dirty-only Save button).+ await page.locator('#profile-language').click()+ await page.getByRole('option', { name: /polski/i }).click()+ await page.getByRole('button', { name: /^save$/i }).click()++ // Whole UI re-renders in Polish: card title "Personal Details" → "Dane+ // osobowe", and the nav "Products" → "Produkty" (proves table/nav labels+ // resolved at boot, not just live-subscribed components).+ await expect(page.getByText('Dane osobowe', { exact: true })).toBeVisible({ timeout: 15_000 })+ await expect(page.getByRole('link', { name: /produkty/i })).toBeVisible()++ // Survives a reload (locale persisted in localStorage + bundle loaded eagerly+ // at boot).+ await page.reload()+ await expect(page.getByText('Dane osobowe', { exact: true })).toBeVisible({ timeout: 15_000 })++ // Table-driven pages also translate: the Customers list column headers are+ // resolved from `i18n.t()` at module load, so they only render in Polish if+ // the bundle is registered before the table module evaluates (the reload ++ // eager-bundle path). "Total spent" → "Łączne wydatki".+ await page.goto(`/${creds.store_id}/customers`)+ await expect(page.getByRole('columnheader', { name: /łączne wydatki/i })).toBeVisible({+ timeout: 15_000,+ })++ // Back to the profile to reset to English so later tests/specs run against+ // English chrome. The language field label is now "Język".+ await page.goto(PROFILE_PATH(creds.store_id))+ await expect(page.locator('#profile-language')).toBeVisible({ timeout: 15_000 })+ await page.getByLabel(/^język$/i).click()+ await page.getByRole('option', { name: /english/i }).click()+ await page.getByRole('button', { name: /^zapisz$/i }).click()+ await expect(page.getByText('Personal Details', { exact: true })).toBeVisible({+ timeout: 15_000,+ })+ })++ test('switches the language from the top-bar menu and persists it', async ({ page }) => {+ await login(page)++ // Switch to Polish via the top-bar user menu → Language submenu. The+ // submenu trigger's accessible name is "Language <current>", so match by+ // prefix and hover to open the nested content.+ await page.getByRole('button', { name: /user menu/i }).click()+ await page.getByRole('menuitem', { name: /^language/i }).hover()+ await page.getByRole('menuitem', { name: /polski/i }).click()++ // The switch persists to the account (PATCH /me) so it survives the reload+ // instead of being reverted by the auth provider. Nav renders in Polish.+ await expect(page.getByRole('link', { name: /produkty/i })).toBeVisible({ timeout: 15_000 })++ // Reset to English via the top-bar menu (the submenu is now "Język …").+ await page.getByRole('button', { name: /menu użytkownika/i }).click()+ await page.getByRole('menuitem', { name: /^język/i }).hover()+ await page.getByRole('menuitem', { name: /english/i }).click()+ await expect(page.getByRole('link', { name: /^products$/i })).toBeVisible({ timeout: 15_000 })+ })+})diff --git a/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx b/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsxindex d9cb65a32e..8f0dca09ae 100644--- a/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx+++ b/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx@@ -87,7 +87,7 @@ export function BulkPriceEditorDialog({count: editorState.dirtyCount,}),variant: 'destructive',- confirmLabel: t('admin.pages.products.price_lists.edit_prices.discard_confirm.confirm'),+ confirmLabel: t('admin.actions.discard_changes'),})if (!ok) returneditorState.discard()@@ -107,7 +107,7 @@ export function BulkPriceEditorDialog({'admin.pages.products.price_lists.edit_prices.discard_confirm.message_currency',),variant: 'destructive',- confirmLabel: t('admin.pages.products.price_lists.edit_prices.discard_confirm.confirm'),+ confirmLabel: t('admin.actions.discard_changes'),})if (!ok) returneditorState.discard()diff --git a/packages/dashboard/src/components/spree/custom-fields/custom-fields-card.tsx b/packages/dashboard/src/components/spree/custom-fields/custom-fields-card.tsxindex fc4d7ea564..2ccd9dfd24 100644--- a/packages/dashboard/src/components/spree/custom-fields/custom-fields-card.tsx+++ b/packages/dashboard/src/components/spree/custom-fields/custom-fields-card.tsx@@ -15,6 +15,7 @@ import {} from '@spree/dashboard-ui'import { PencilIcon, TagIcon } from 'lucide-react'import { Fragment, useState } from 'react'+import { useTranslation } from 'react-i18next'import { CustomFieldsDrawer } from './custom-fields-drawer'interface CustomFieldsCardProps {@@ -25,6 +26,7 @@ interface CustomFieldsCardProps {}export function CustomFieldsCard({ ownerType, ownerId, resourceLabel }: CustomFieldsCardProps) {+ const { t } = useTranslation()const [open, setOpen] = useState(false)const { data: definitionsResp, isLoading: defsLoading } = useCustomFieldDefinitions(ownerType)const { data: valuesResp, isLoading: valsLoading } = useCustomFields(ownerType, ownerId)@@ -43,10 +45,12 @@ export function CustomFieldsCard({ ownerType, ownerId, resourceLabel }: CustomFi<><Card><CardHeader className="flex flex-row items-center justify-between gap-2 space-y-0">- <CardTitle>Custom fields</CardTitle>+ <CardTitle>{t('admin.pages.products.section_custom_fields')}</CardTitle><Button type="button" variant="outline" size="sm" onClick={() => setOpen(true)}><PencilIcon className="size-4" />- {definitions.length === 0 ? 'Set up' : 'Edit'}+ {definitions.length === 0+ ? t('admin.components.custom_fields_card.set_up')+ : t('admin.actions.edit')}</Button></CardHeader><CardContent>@@ -61,9 +65,9 @@ export function CustomFieldsCard({ ownerType, ownerId, resourceLabel }: CustomFi<EmptyMedia variant="icon"><TagIcon /></EmptyMedia>- <EmptyTitle>No custom fields yet</EmptyTitle>+ <EmptyTitle>{t('admin.components.custom_fields_card.empty_title')}</EmptyTitle><EmptyDescription>- Track structured details like material, fit, or care instructions.+ {t('admin.components.custom_fields_card.empty_description')}</EmptyDescription></EmptyHeader></Empty>@@ -81,7 +85,7 @@ export function CustomFieldsCard({ ownerType, ownerId, resourceLabel }: CustomFi</code></dt><dd className="text-foreground/90 break-words">- {formatValue(value, def.field_type)}+ {formatValue(value, def.field_type, t)}</dd></Fragment>)@@ -89,7 +93,10 @@ export function CustomFieldsCard({ ownerType, ownerId, resourceLabel }: CustomFi</dl>{setCount < definitions.length && (<p className="text-xs text-muted-foreground border-t pt-2">- {definitions.length - setCount} of {definitions.length} not yet set+ {t('admin.components.custom_fields_card.not_yet_set', {+ count: definitions.length - setCount,+ total: definitions.length,+ })}</p>)}</div>@@ -108,9 +115,9 @@ export function CustomFieldsCard({ ownerType, ownerId, resourceLabel }: CustomFi)}-function formatValue(value: unknown, fieldType: string): string {+function formatValue(value: unknown, fieldType: string, t: (key: string) => string): string {if (value === null || value === undefined || value === '') return '—'- if (fieldType === 'boolean') return value ? 'Yes' : 'No'+ if (fieldType === 'boolean') return value ? t('admin.common.yes') : t('admin.common.no')if (fieldType === 'rich_text' && typeof value === 'string') {// Plain-text preview of HTML for the summary row. DOMParser handles// nested/malformed tags correctly — a single-pass regex strip can leakdiff --git a/packages/dashboard/src/components/spree/custom-fields/custom-fields-drawer.tsx b/packages/dashboard/src/components/spree/custom-fields/custom-fields-drawer.tsxindex f5171b860d..1b8fe44d99 100644--- a/packages/dashboard/src/components/spree/custom-fields/custom-fields-drawer.tsx+++ b/packages/dashboard/src/components/spree/custom-fields/custom-fields-drawer.tsx@@ -59,7 +59,7 @@ export function CustomFieldsDrawer({const header =view === 'values' ? (- <SheetTitle>Custom fields</SheetTitle>+ <SheetTitle>{t('admin.components.custom_fields.title')}</SheetTitle>) : (<SheetTitle className="flex gap-2 items-center"><Button@@ -71,7 +71,9 @@ export function CustomFieldsDrawer({><ArrowLeftIcon className="size-4" /></Button>- {view === 'new-definition' ? 'New custom field' : 'Definition created'}+ {view === 'new-definition'+ ? t('admin.components.custom_fields.new_definition_title')+ : t('admin.components.custom_fields.definition_created_title')}</SheetTitle>)@@ -98,7 +100,7 @@ export function CustomFieldsDrawer({onSuccess={(id) => {setLastCreatedDefinitionId(id)setView('definition-created')- toast.success('Definition created')+ toast.success(t('admin.components.custom_fields.definition_created_toast'))}}/>)}@@ -134,6 +136,7 @@ function NewDefinitionView({onCancel: () => voidonSuccess: (id: string) => void}) {+ const { t } = useTranslation()return (<DefinitionFormresourceType={resourceType}@@ -144,7 +147,7 @@ function NewDefinitionView({<div className="flex-1 overflow-y-auto p-4">{fields}</div><SheetFooter><Button type="button" variant="outline" size="sm" onClick={onCancel}>- Cancel+ {t('admin.actions.cancel')}</Button>{submitButton}</SheetFooter>@@ -179,6 +182,7 @@ function ValuesView({onClose,header,}: ValuesViewProps) {+ const { t } = useTranslation()const { data: definitionsResp, isLoading: defsLoading } = useCustomFieldDefinitions(ownerType)const { data: valuesResp, isLoading: valsLoading } = useCustomFields(ownerType, ownerId)const createValue = useCreateCustomField(ownerType, ownerId)@@ -236,15 +240,17 @@ function ValuesView({<div className="flex-1 overflow-y-auto p-4"><Empty><EmptyHeader>- <EmptyTitle>{`No custom fields defined for ${resourceLabel}`}</EmptyTitle>+ <EmptyTitle>+ {t('admin.components.custom_fields.empty_title', { resource: resourceLabel })}+ </EmptyTitle><EmptyDescription>- Define a custom field to store typed, structured information alongside your records.+ {t('admin.components.custom_fields.empty_description')}</EmptyDescription></EmptyHeader><EmptyContent><Button type="button" size="sm" onClick={onAddDefinition}><PlusIcon className="size-4" />- Create definition+ {t('admin.components.custom_fields.create_definition')}</Button></EmptyContent></Empty>@@ -283,10 +289,11 @@ function ValuesView({try {await Promise.all(tasks)- toast.success('Custom fields saved')+ toast.success(t('admin.components.custom_fields.values_saved'))onClose()} catch (err) {- const message = err instanceof Error ? err.message : 'Failed to save custom fields'+ const message =+ err instanceof Error ? err.message : t('admin.components.custom_fields.values_save_failed')toast.error(message)}})@@ -324,7 +331,9 @@ function ValuesView({</code></FieldLabel>{!def.storefront_visible && (- <span className="text-xs text-muted-foreground">Admin only</span>+ <span className="text-xs text-muted-foreground">+ {t('admin.components.custom_fields.admin_only')}+ </span>)}</div><ValueInput@@ -349,18 +358,18 @@ function ValuesView({}}><PlusIcon className="size-4" />- Add another field+ {t('admin.components.custom_fields.add_another_field')}</Button></div></div><SheetFooter><Button type="button" variant="outline" onClick={onClose}>- Cancel+ {t('admin.actions.cancel')}</Button><Button type="submit" disabled={isSaving}>{isSaving && <Loader2Icon className="size-4 animate-spin" />}- Save+ {t('admin.actions.save')}</Button></SheetFooter></form>@@ -378,22 +387,25 @@ function DefinitionCreatedView({onAddAnother: () => voidonSetValues: () => void}) {+ const { t } = useTranslation()return (<div className="flex flex-col items-center gap-4 py-8 text-center"><CheckCircle2Icon className="size-10 text-emerald-500" /><div className="flex flex-col gap-1">- <p className="text-base font-medium">Definition created</p>+ <p className="text-base font-medium">+ {t('admin.components.custom_fields.definition_created_title')}+ </p><p className="text-sm text-muted-foreground">- You can set its value now or define another field first.+ {t('admin.components.custom_fields.definition_created_hint')}</p></div><div className="mt-2 flex gap-2"><Button type="button" variant="outline" size="sm" onClick={onAddAnother}><PlusIcon className="size-4" />- Create another+ {t('admin.components.custom_fields.create_another')}</Button><Button type="button" size="sm" onClick={onSetValues}>- Set values+ {t('admin.components.custom_fields.set_values')}</Button></div></div>diff --git a/packages/dashboard/src/components/spree/payment-method-editors/payment-method-form.tsx b/packages/dashboard/src/components/spree/payment-method-editors/payment-method-form.tsxindex 5c92424d20..edb6458bbb 100644--- a/packages/dashboard/src/components/spree/payment-method-editors/payment-method-form.tsx+++ b/packages/dashboard/src/components/spree/payment-method-editors/payment-method-form.tsx@@ -140,7 +140,9 @@ export function PaymentMethodForm({{providerType && (customFormRegistered || preferenceSchema.length > 0) ? (<div className="rounded-md border bg-muted/30 p-3">- <h3 className="mb-2 text-sm font-medium">Provider configuration</h3>+ <h3 className="mb-2 text-sm font-medium">+ {t('admin.fields.payment_method.provider_configuration')}+ </h3>{customFormRegistered ? (// A plugin has taken over — render the registered editor// instead of the generic preferences form. Plugin owns itsdiff --git a/packages/dashboard/src/components/spree/products/product-form-cards.tsx b/packages/dashboard/src/components/spree/products/product-form-cards.tsxindex d395859ed1..f405caa772 100644--- a/packages/dashboard/src/components/spree/products/product-form-cards.tsx+++ b/packages/dashboard/src/components/spree/products/product-form-cards.tsx@@ -126,7 +126,7 @@ export function PricesCard({ form, productName }: FormCardProps & { productName:return (<Card><CardHeader className="flex flex-row items-center justify-between gap-3 space-y-0">- <CardTitle>{t('admin.pages.products.section_prices')}</CardTitle>+ <CardTitle>{t('admin.common.prices')}</CardTitle>{currencies.length > 1 && (<Select value={currency} onValueChange={setCurrency}><SelectTrigger size="sm" className="w-24">@@ -255,12 +255,12 @@ export function MediaCard({setPending((prev) =>prev.map((p) => (p.id === uploadId ? { ...p, progress: 'error' as const } : p)),)- const message = err instanceof Error ? err.message : 'Unknown error'- toast.error(`Failed to upload ${file.name}: ${message}`)+ const message = err instanceof Error ? err.message : t('admin.errors.unexpected')+ toast.error(t('admin.products.media.upload_failed', { name: file.name, message }))}}},- [directUpload, form],+ [directUpload, form, t],)const handleDrop = useCallback(@@ -368,7 +368,9 @@ export function MediaCard({/><div className="absolute inset-0 flex items-center justify-center">{upload.progress === 'error' ? (- <span className="text-xs text-destructive font-medium">Failed</span>+ <span className="text-xs text-destructive font-medium">+ {t('admin.products.media.upload_status_failed')}+ </span>) : (<Loader2Icon className="size-5 animate-spin text-muted-foreground" />)}@@ -597,7 +599,7 @@ export function StatusCard({ form }: FormCardProps) {return (<Card><CardHeader>- <CardTitle>{t('admin.pages.products.section_status')}</CardTitle>+ <CardTitle>{t('admin.fields.status.label')}</CardTitle></CardHeader><CardContent className="flex flex-col gap-4"><Field>@@ -616,9 +618,7 @@ export function StatusCard({ form }: FormCardProps) {<SelectItem value="draft">{t('admin.pages.products.status_options.draft')}</SelectItem>- <SelectItem value="active">- {t('admin.pages.products.status_options.active')}- </SelectItem>+ <SelectItem value="active">{t('admin.fields.active.label')}</SelectItem><SelectItem value="archived">{t('admin.pages.products.status_options.archived')}</SelectItem>diff --git a/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx b/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsxindex 8227f83ca6..59bae0c272 100644--- a/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx+++ b/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx@@ -158,7 +158,7 @@ export function VariantEditSheet({ form, variantIndex, open, onOpenChange }: Pro</Field></Section>- <Section title={t('admin.products.variants.sheet.shipping')}>+ <Section title={t('admin.fields.shipping.label')}><div className="grid grid-cols-[1fr_120px] gap-3"><Field><FieldLabel htmlFor={`variant-${variantIndex}-weight`}>@@ -267,7 +267,7 @@ export function VariantEditSheet({ form, variantIndex, open, onOpenChange }: Pro</Section>{hasTaxCategories && (- <Section title={t('admin.products.variants.sheet.tax')}>+ <Section title={t('admin.fields.tax.label')}><Field><FieldLabel htmlFor={`variant-${variantIndex}-tax-cat`}>{t('admin.fields.tax_category_id.label')}diff --git a/packages/dashboard/src/components/spree/products/variants-section.tsx b/packages/dashboard/src/components/spree/products/variants-section.tsxindex b88eea9dcb..cfac18ec7b 100644--- a/packages/dashboard/src/components/spree/products/variants-section.tsx+++ b/packages/dashboard/src/components/spree/products/variants-section.tsx@@ -274,7 +274,7 @@ export function VariantsSection({ form }: Props) {size="sm"onClick={handleConfirmDropOrphans}>- {t('admin.products.variants.remove_confirm')}+ {t('admin.actions.remove')}</Button></div></div>diff --git a/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx b/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsxindex b2257abf25..2ca478b72d 100644--- a/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx+++ b/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx@@ -12,6 +12,8 @@ import {} from '@spree/dashboard-ui'import { useQuery } from '@tanstack/react-query'import { useEffect, useMemo, useState } from 'react'+import { useTranslation } from 'react-i18next'+import { typeLabel } from '@/lib/type-labels'import { EditorShell } from './editor-shell'import type { PromotionActionEditorContext } from './types'@@ -21,6 +23,7 @@ import type { PromotionActionEditorContext } from './types'* the subclass, the form below renders that calculator's preferences.*/export function AdjustmentActionEditor({ draft, onSave, onClose }: PromotionActionEditorContext) {+ const { t } = useTranslation()const { data: calculatorsData, isLoading: calculatorsLoading } = useQuery({queryKey: ['promotion-action-calculators', draft.type],queryFn: () => adminClient.promotionActions.calculators(draft.type),@@ -68,7 +71,10 @@ export function AdjustmentActionEditor({ draft, onSave, onClose }: PromotionActipreferences,// Display-only — lets `<ActionSummary>` render the row preview// without fetching `/calculators` again. Stripped at payload time.- label: selectedCalculator?.label,+ // Localized so the row summary matches the (localized) picker.+ label: selectedCalculator+ ? typeLabel('calculators', selectedCalculator.type, selectedCalculator.label)+ : undefined,preference_schema: selectedCalculator?.preference_schema,},})@@ -84,7 +90,9 @@ export function AdjustmentActionEditor({ draft, onSave, onClose }: PromotionActi><FieldGroup><Field>- <FieldLabel htmlFor="calculator-type">Calculator</FieldLabel>+ <FieldLabel htmlFor="calculator-type">+ {t('admin.components.adjustment_action_editor.calculator_label')}+ </FieldLabel><Selectvalue={calculatorType}onValueChange={handleCalculatorChange}@@ -92,15 +100,22 @@ export function AdjustmentActionEditor({ draft, onSave, onClose }: PromotionActi><SelectTrigger id="calculator-type"><SelectValue- placeholder={calculatorsLoading ? 'Loading calculators…' : 'Select a calculator'}+ placeholder={+ calculatorsLoading+ ? t('admin.components.adjustment_action_editor.loading_calculators')+ : t('admin.components.adjustment_action_editor.select_calculator')+ }>- {(value) => calculators.find((c) => c.type === value)?.label ?? (value as string)}+ {(value) => {+ const calc = calculators.find((c) => c.type === value)+ return calc ? typeLabel('calculators', calc.type, calc.label) : (value as string)+ }}</SelectValue></SelectTrigger><SelectContent>{calculators.map((calculator) => (<SelectItem key={calculator.type} value={calculator.type}>- {calculator.label}+ {typeLabel('calculators', calculator.type, calculator.label)}</SelectItem>))}</SelectContent>@@ -128,13 +143,19 @@ function CalculatorPreferences({values: Record<string, unknown>onChange: (next: Record<string, unknown>) => void}) {+ const { t } = useTranslation()+if (!calculator.preference_schema?.length) {- return <p className="text-sm text-muted-foreground">This calculator has no extra settings.</p>+ return (+ <p className="text-sm text-muted-foreground">+ {t('admin.components.adjustment_action_editor.no_extra_settings')}+ </p>+ )}return (<FieldGroup>- <FieldLabel>Calculator settings</FieldLabel>+ <FieldLabel>{t('admin.components.adjustment_action_editor.settings_label')}</FieldLabel><PreferencesForm schema={calculator.preference_schema} values={values} onChange={onChange} /></FieldGroup>)diff --git a/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx b/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsxindex 5e008b0777..d6aec180f1 100644--- a/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx+++ b/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx@@ -10,6 +10,7 @@ import type {} from '@spree/admin-sdk'import { Can, PageHeader, PreferencesForm, StoreDatePicker } from '@spree/dashboard-core'import { formatCalculatorSummary, useConfirm } from '@spree/dashboard-ui'+import i18n from 'i18next'import { DownloadIcon, PlusIcon, SparklesIcon, TrashIcon } from 'lucide-react'import { useEffect, useState } from 'react'import { Controller, type UseFormReturn, useFieldArray, useForm } from 'react-hook-form'@@ -70,6 +71,7 @@ import {usePromotionCouponCodes,usePromotionRuleTypes,} from '@/hooks/use-promotions'+import { typeDescription, typeLabel } from '@/lib/type-labels'import {MATCH_POLICIES,type MatchPolicy,@@ -129,6 +131,16 @@ interface PromotionFormProps {deletePending?: boolean}+/**+ * Localized label for a coupon code's API `state` (`used`, `partially_used`,+ * …), falling back to the raw state for any value without a translation.+ */+function couponStateLabel(state: string | null | undefined): string {+ if (!state) return i18n.t('admin.promotions.coupon_codes.used')+ const key = `admin.promotions.coupon_codes.states.${state}`+ return i18n.exists(key) ? i18n.t(key) : state+}+// =============================================================================// Root component// =============================================================================@@ -292,7 +304,7 @@ function BasicsCard({ form }: { form: UseFormReturn<PromotionFormValues> }) {return (<Card><CardHeader>- <CardTitle>Basics</CardTitle>+ <CardTitle>{t('admin.promotions.basics_card.title')}</CardTitle></CardHeader><CardContent><FieldGroup>@@ -340,7 +352,7 @@ function TriggerCard({return (<Card><CardHeader>- <CardTitle>Trigger</CardTitle>+ <CardTitle>{t('admin.promotions.trigger_card.title')}</CardTitle></CardHeader><CardContent>{mode === 'edit' && promotion ? (@@ -476,20 +488,27 @@ function TriggerCard({}function ReadOnlyTriggerSummary({ promotion }: { promotion: Promotion }) {+ const { t } = useTranslation()const [codesOpen, setCodesOpen] = useState(false)return (<div className="space-y-2 text-sm">{promotion.kind === 'automatic' ? (- <Badge variant="outline">Automatic</Badge>+ <Badge variant="outline">{t('admin.promotions.kinds.automatic')}</Badge>) : promotion.multi_codes ? (<div className="space-y-2"><div>- Multi-code coupon ({promotion.number_of_codes ?? 0} codes- {promotion.code_prefix ? ` with prefix "${promotion.code_prefix}"` : ''})+ {promotion.code_prefix+ ? t('admin.promotions.trigger_summary.multi_code_with_prefix', {+ count: promotion.number_of_codes ?? 0,+ prefix: promotion.code_prefix,+ })+ : t('admin.promotions.trigger_summary.multi_code', {+ count: promotion.number_of_codes ?? 0,+ })}</div><Button type="button" variant="outline" size="sm" onClick={() => setCodesOpen(true)}>- Show codes+ {t('admin.promotions.trigger_summary.show_codes')}</Button>{codesOpen && (<CouponCodesSheet@@ -501,14 +520,14 @@ function ReadOnlyTriggerSummary({ promotion }: { promotion: Promotion }) {</div>) : (<div>- Single coupon code:{' '}+ {t('admin.promotions.trigger_summary.single_code')}{' '}<code className="rounded bg-muted px-1 py-0.5 text-xs">{promotion.code?.toUpperCase() || '—'}</code></div>)}<p className="text-xs text-muted-foreground">- Trigger settings can't be changed after creation. Make a new promotion to change them.+ {t('admin.promotions.trigger_summary.locked_help')}</p></div>)@@ -520,7 +539,7 @@ function ScheduleCard({ form }: { form: UseFormReturn<PromotionFormValues> }) {return (<Card><CardHeader>- <CardTitle>Schedule & limits</CardTitle>+ <CardTitle>{t('admin.promotions.schedule_card.title')}</CardTitle></CardHeader><CardContent><FieldGroup>@@ -652,8 +671,7 @@ function RulesCard({<div className="space-y-2">{rulesArray.fields.length === 0 ? (<p className="text-sm text-muted-foreground">- No rules. Without rules, the promotion always qualifies (subject to schedule and usage- limit).+ {t('admin.promotions.rules_card.empty')}</p>) : (rulesArray.fields.map((field, index) => (@@ -668,7 +686,7 @@ function RulesCard({<Can I="create" a={Subject.PromotionRule}><Button type="button" variant="outline" size="sm" onClick={() => setPickerOpen(true)}><PlusIcon className="size-4" />- Add rule+ {t('admin.promotions.rules_card.add_rule')}</Button></Can></div>@@ -714,15 +732,16 @@ function RuleRow({onEdit: () => voidonRemove: () => void}) {+ const { t } = useTranslation()const confirm = useConfirm()async function handleRemove(e: React.MouseEvent) {e.stopPropagation()const ok = await confirm({- title: 'Remove rule?',- message: 'Removed when you save the promotion.',+ title: t('admin.promotions.remove_rule_confirm.title'),+ message: t('admin.promotions.remove_rule_confirm.message'),variant: 'destructive',- confirmLabel: 'Remove',+ confirmLabel: t('admin.actions.remove'),})if (!ok) returnonRemove()@@ -738,7 +757,9 @@ function RuleRow({onClick={onEdit}className="min-w-0 flex-1 px-3 py-2 text-left focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring rounded-l-md">- <div className="text-sm font-medium">{draft.label}</div>+ <div className="text-sm font-medium">+ {typeLabel('rule_types', draft.type, draft.label)}+ </div><RuleSummary draft={draft} /></button><Can I="destroy" a={Subject.PromotionRule}>@@ -759,6 +780,7 @@ function RuleRow({}function RuleSummary({ draft }: { draft: PromotionRuleFormDraft }) {+ const { t } = useTranslation()const parts: string[] = []const products = nameList(draft.products)const categories = nameList(draft.categories)@@ -767,13 +789,22 @@ function RuleSummary({ draft }: { draft: PromotionRuleFormDraft }) {const countries = nameList(draft.countries)if (products) parts.push(products)- else if (draft.product_ids?.length) parts.push(`${draft.product_ids.length} products`)+ else if (draft.product_ids?.length)+ parts.push(+ t('admin.promotions.rule_summary.product_count', { count: draft.product_ids.length }),+ )if (categories) parts.push(categories)- else if (draft.category_ids?.length) parts.push(`${draft.category_ids.length} categories`)+ else if (draft.category_ids?.length)+ parts.push(+ t('admin.promotions.rule_summary.category_count', { count: draft.category_ids.length }),+ )if (customers) parts.push(customers)- else if (draft.customer_ids?.length) parts.push(`${draft.customer_ids.length} customers`)+ else if (draft.customer_ids?.length)+ parts.push(+ t('admin.promotions.rule_summary.customer_count', { count: draft.customer_ids.length }),+ )if (groups) parts.push(groups)if (countries) parts.push(countries)@@ -816,7 +847,8 @@ function formatPreferencesSummary(draft: PromotionRuleFormDraft): string | nullfunction formatPreferenceValue(value: unknown): string {if (Array.isArray(value)) return value.join(', ')- if (typeof value === 'boolean') return value ? 'yes' : 'no'+ if (typeof value === 'boolean')+ return value ? i18n.t('admin.common.yes') : i18n.t('admin.common.no')return String(value)}@@ -881,8 +913,8 @@ function RulePickerSheet({<Sheet open={open} onOpenChange={onOpenChange}><SheetContent><SheetHeader>- <SheetTitle>Add rule</SheetTitle>- <SheetDescription>Pick a rule type to configure.</SheetDescription>+ <SheetTitle>{t('admin.promotions.rule_picker.title')}</SheetTitle>+ <SheetDescription>{t('admin.promotions.rule_picker.description')}</SheetDescription></SheetHeader><div className="flex min-h-0 flex-1 flex-col gap-2 overflow-y-auto p-4">{types.length === 0 ? (@@ -895,9 +927,13 @@ function RulePickerSheet({onClick={() => onPicked(tt)}className="flex flex-col items-start rounded-md border p-3 text-left transition-colors hover:bg-muted/50">- <span className="text-sm font-medium">{tt.label}</span>+ <span className="text-sm font-medium">+ {typeLabel('rule_types', tt.type, tt.label)}+ </span>{tt.description && (- <span className="text-xs text-muted-foreground">{tt.description}</span>+ <span className="text-xs text-muted-foreground">+ {typeDescription('rule_types', tt.type, tt.description)}+ </span>)}</button>))@@ -905,7 +941,7 @@ function RulePickerSheet({</div><SheetFooter><Button type="button" variant="outline" size="sm" onClick={() => onOpenChange(false)}>- Cancel+ {t('admin.actions.cancel')}</Button></SheetFooter></SheetContent>@@ -924,6 +960,7 @@ function RuleEditSheet({onOpenChange: (open: boolean) => voidonSave: (next: PromotionRuleFormDraft) => void}) {+ const { t } = useTranslation()const onClose = () => onOpenChange(false)const ctx: PromotionRuleEditorContext = { draft, onSave, onClose }@@ -931,8 +968,8 @@ function RuleEditSheet({<Sheet open={open} onOpenChange={onOpenChange}><SheetContent><SheetHeader>- <SheetTitle>{draft.label}</SheetTitle>- <SheetDescription>Tune the rule's parameters.</SheetDescription>+ <SheetTitle>{typeLabel('rule_types', draft.type, draft.label)}</SheetTitle>+ <SheetDescription>{t('admin.promotions.rule_edit.description')}</SheetDescription></SheetHeader><Slotname={ruleFormSlot(draft.type)}@@ -945,6 +982,7 @@ function RuleEditSheet({}function DefaultRuleEditor({ draft, onSave, onClose }: PromotionRuleEditorContext) {+ const { t } = useTranslation()const [values, setValues] = useState<Record<string, unknown>>(draft.preferences ?? {})const hasPreferences = !!draft.preference_schema?.length@@ -964,7 +1002,7 @@ function DefaultRuleEditor({ draft, onSave, onClose }: PromotionRuleEditorContex<PreferencesForm schema={draft.preference_schema} values={values} onChange={setValues} />) : (<p className="text-sm text-muted-foreground">- This rule has no configurable options — its presence alone applies the constraint.+ {t('admin.promotions.rule_edit.no_options')}</p>)}</EditorShell>@@ -983,6 +1021,7 @@ function ActionsCard({form: anyactionsArray: ActionsArray}) {+ const { t } = useTranslation()const { data: typesData } = usePromotionActionTypes()const { defaultCurrency } = useStore()const [pickerOpen, setPickerOpen] = useState(false)@@ -997,14 +1036,16 @@ function ActionsCard({return (<Card><CardHeader>- <CardTitle>Actions</CardTitle>- <p className="text-sm text-muted-foreground">What happens when the promotion qualifies.</p>+ <CardTitle>{t('admin.actions.actions_menu')}</CardTitle>+ <p className="text-sm text-muted-foreground">+ {t('admin.promotions.actions_card.description')}+ </p></CardHeader><CardContent><div className="space-y-2">{actionsArray.fields.length === 0 ? (<p className="text-sm text-muted-foreground">- No actions yet. A promotion without actions doesn't do anything when applied.+ {t('admin.promotions.actions_card.empty')}</p>) : (actionsArray.fields.map((field, index) => (@@ -1019,7 +1060,7 @@ function ActionsCard({<Can I="create" a={Subject.PromotionAction}><Button type="button" variant="outline" size="sm" onClick={() => setPickerOpen(true)}><PlusIcon className="size-4" />- Add action+ {t('admin.promotions.actions_card.add_action')}</Button></Can></div>@@ -1063,15 +1104,16 @@ function ActionRow({onEdit: () => voidonRemove: () => void}) {+ const { t } = useTranslation()const confirm = useConfirm()async function handleRemove(e: React.MouseEvent) {e.stopPropagation()const ok = await confirm({- title: 'Remove action?',- message: 'Removed when you save the promotion.',+ title: t('admin.promotions.remove_action_confirm.title'),+ message: t('admin.promotions.remove_action_confirm.message'),variant: 'destructive',- confirmLabel: 'Remove',+ confirmLabel: t('admin.actions.remove'),})if (!ok) returnonRemove()@@ -1084,7 +1126,9 @@ function ActionRow({onClick={onEdit}className="min-w-0 flex-1 px-3 py-2 text-left focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring rounded-l-md">- <div className="text-sm font-medium">{draft.label}</div>+ <div className="text-sm font-medium">+ {typeLabel('action_types', draft.type, draft.label)}+ </div><ActionSummary draft={draft} /></button><Can I="destroy" a={Subject.PromotionAction}>@@ -1105,10 +1149,14 @@ function ActionRow({}function ActionSummary({ draft }: { draft: PromotionActionFormDraft }) {+ const { t } = useTranslation()const parts: string[] = []const calc = formatCalculatorSummary(draft.calculator)if (calc) parts.push(calc)- if (draft.line_items?.length) parts.push(`${draft.line_items.length} variants`)+ if (draft.line_items?.length)+ parts.push(+ t('admin.promotions.action_summary.variant_count', { count: draft.line_items.length }),+ )if (parts.length === 0) return nullreturn <div className="truncate text-xs text-muted-foreground">{parts.join(' · ')}</div>}@@ -1124,31 +1172,36 @@ function ActionPickerSheet({onOpenChange: (open: boolean) => voidonPicked: (type: ResourceTypeDefinition) => void}) {+ const { t } = useTranslation()return (<Sheet open={open} onOpenChange={onOpenChange}><SheetContent><SheetHeader>- <SheetTitle>Add action</SheetTitle>- <SheetDescription>Pick what should happen when the promotion qualifies.</SheetDescription>+ <SheetTitle>{t('admin.promotions.action_picker.title')}</SheetTitle>+ <SheetDescription>{t('admin.promotions.action_picker.description')}</SheetDescription></SheetHeader><div className="flex min-h-0 flex-1 flex-col gap-2 overflow-y-auto p-4">- {types.map((t) => (+ {types.map((type) => (<button- key={t.type}+ key={type.type}type="button"- onClick={() => onPicked(t)}+ onClick={() => onPicked(type)}className="flex flex-col items-start rounded-md border p-3 text-left transition-colors hover:bg-muted/50">- <span className="text-sm font-medium">{t.label}</span>- {t.description && (- <span className="text-xs text-muted-foreground">{t.description}</span>+ <span className="text-sm font-medium">+ {typeLabel('action_types', type.type, type.label)}+ </span>+ {type.description && (+ <span className="text-xs text-muted-foreground">+ {typeDescription('action_types', type.type, type.description)}+ </span>)}</button>))}</div><SheetFooter><Button type="button" variant="outline" size="sm" onClick={() => onOpenChange(false)}>- Cancel+ {t('admin.actions.cancel')}</Button></SheetFooter></SheetContent>@@ -1167,6 +1220,7 @@ function ActionEditSheet({onOpenChange: (open: boolean) => voidonSave: (next: PromotionActionFormDraft) => void}) {+ const { t } = useTranslation()const onClose = () => onOpenChange(false)const ctx: PromotionActionEditorContext = { draft, onSave, onClose }@@ -1174,8 +1228,8 @@ function ActionEditSheet({<Sheet open={open} onOpenChange={onOpenChange}><SheetContent><SheetHeader>- <SheetTitle>{draft.label}</SheetTitle>- <SheetDescription>Configure the action's parameters.</SheetDescription>+ <SheetTitle>{typeLabel('action_types', draft.type, draft.label)}</SheetTitle>+ <SheetDescription>{t('admin.promotions.action_edit.description')}</SheetDescription></SheetHeader><Slotname={actionFormSlot(draft.type)}@@ -1188,6 +1242,7 @@ function ActionEditSheet({}function DefaultActionEditor({ draft, onSave, onClose }: PromotionActionEditorContext) {+ const { t } = useTranslation()const [values, setValues] = useState<Record<string, unknown>>(draft.preferences ?? {})const hasPreferences = !!draft.preference_schema?.length@@ -1206,7 +1261,9 @@ function DefaultActionEditor({ draft, onSave, onClose }: PromotionActionEditorCo{hasPreferences ? (<PreferencesForm schema={draft.preference_schema} values={values} onChange={setValues} />) : (- <p className="text-sm text-muted-foreground">This action has no configurable options.</p>+ <p className="text-sm text-muted-foreground">+ {t('admin.promotions.action_edit.no_options')}+ </p>)}</EditorShell>)@@ -1225,6 +1282,7 @@ function CouponCodesSheet({open: booleanonOpenChange: (open: boolean) => void}) {+ const { t } = useTranslation()const [page, setPage] = useState(1)const { data: codesData, isFetching } = usePromotionCouponCodes(promotionId, {limit: 50,@@ -1247,24 +1305,26 @@ function CouponCodesSheet({<Sheet open={open} onOpenChange={onOpenChange}><SheetContent className="sm:max-w-xl"><SheetHeader>- <SheetTitle>Coupon codes</SheetTitle>+ <SheetTitle>{t('admin.promotions.coupon_codes.title')}</SheetTitle><SheetDescription>{totalCount > 0- ? `${totalCount} auto-generated codes. Read-only — regenerate by changing the promotion's number-of-codes setting.`- : "Auto-generated codes for this promotion. Read-only — regenerate by changing the promotion's number-of-codes setting."}+ ? t('admin.promotions.coupon_codes.description_with_count', { count: totalCount })+ : t('admin.promotions.coupon_codes.description')}</SheetDescription></SheetHeader><div className="flex min-h-0 flex-1 flex-col overflow-hidden">{codes.length === 0 ? (- <p className="px-4 py-6 text-sm text-muted-foreground">No codes generated yet.</p>+ <p className="px-4 py-6 text-sm text-muted-foreground">+ {t('admin.promotions.coupon_codes.empty')}+ </p>) : (<div className="flex-1 overflow-y-auto"><Table><TableHeader><TableRow>- <TableHead>Code</TableHead>- <TableHead className="w-32">Status</TableHead>+ <TableHead>{t('admin.fields.code.label')}</TableHead>+ <TableHead className="w-32">{t('admin.fields.status.label')}</TableHead></TableRow></TableHeader><TableBody>@@ -1282,8 +1342,8 @@ function CouponCodesSheet({<TableCell><ActiveBadgeactive={!used}- activeLabel="Unused"- inactiveLabel={c.state ?? 'Used'}+ activeLabel={t('admin.promotions.coupon_codes.unused')}+ inactiveLabel={couponStateLabel(c.state)}/></TableCell></TableRow>@@ -1297,7 +1357,7 @@ function CouponCodesSheet({{totalPages > 1 && (<div className="flex items-center justify-between border-t px-4 py-2"><span className="text-xs text-muted-foreground">- Page {page} of {totalPages}+ {t('admin.common.page_of', { page, total: totalPages })}</span><div className="flex gap-1"><Button@@ -1307,7 +1367,7 @@ function CouponCodesSheet({onClick={() => setPage((p) => Math.max(1, p - 1))}disabled={page === 1 || isFetching}>- Prev+ {t('admin.common.prev')}</Button><Buttontype="button"@@ -1316,7 +1376,7 @@ function CouponCodesSheet({onClick={() => setPage((p) => Math.min(totalPages, p + 1))}disabled={page === totalPages || isFetching}>- Next+ {t('admin.common.next')}</Button></div></div>@@ -1333,11 +1393,13 @@ function CouponCodesSheet({disabled={exportMutation.isPending}><DownloadIcon className="size-4" />- {exportMutation.isPending ? 'Exporting…' : 'Export CSV'}+ {exportMutation.isPending+ ? t('admin.actions.exporting')+ : t('admin.promotions.coupon_codes.export_csv')}</Button>)}<Button type="button" size="sm" variant="outline" onClick={() => onOpenChange(false)}>- Close+ {t('admin.actions.close')}</Button></SheetFooter></SheetContent>diff --git a/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx b/packages/dashboard/src/components/spree/webhook-endpoint-form.tsxindex c66305ed1f..abe33668f6 100644--- a/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx+++ b/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx@@ -186,7 +186,7 @@ function EventPicker({ value, onChange }: { value: string[]; onChange: (next: stclassName="font-mono text-xs"/><Button type="button" variant="outline" size="sm" onClick={addCustom}>- {t('admin.pages.settings.webhooks.events_add_cta')}+ {t('admin.actions.add')}</Button></div></div>diff --git a/packages/dashboard/src/hooks/use-allowed-origins.ts b/packages/dashboard/src/hooks/use-allowed-origins.tsindex 596729e1c6..9cef00978d 100644--- a/packages/dashboard/src/hooks/use-allowed-origins.ts+++ b/packages/dashboard/src/hooks/use-allowed-origins.ts@@ -10,6 +10,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'export function useAllowedOrigin(id: string | undefined) {return useQuery({@@ -23,8 +24,8 @@ export function useCreateAllowedOrigin() {return useResourceMutation<AllowedOrigin, Error, AllowedOriginCreateParams>({mutationFn: (params) => adminClient.allowedOrigins.create(params),invalidate: [['allowed-origins']],- successMessage: 'Allowed origin added',- errorMessage: 'Failed to add allowed origin',+ successMessage: i18n.t('admin.allowed_origins.messages.added'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -32,8 +33,8 @@ export function useUpdateAllowedOrigin(id: string) {return useResourceMutation<AllowedOrigin, Error, AllowedOriginUpdateParams>({mutationFn: (params) => adminClient.allowedOrigins.update(id, params),invalidate: [['allowed-origins'], ['allowed-origins', id]],- successMessage: 'Allowed origin updated',- errorMessage: 'Failed to update allowed origin',+ successMessage: i18n.t('admin.allowed_origins.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -44,8 +45,8 @@ export function useDeleteAllowedOrigin() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.allowedOrigins.delete(id),invalidate: [['allowed-origins']],- successMessage: 'Allowed origin removed',- errorMessage: 'Failed to remove allowed origin',+ successMessage: i18n.t('admin.allowed_origins.messages.removed'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('allowed-origins', id) })},diff --git a/packages/dashboard/src/hooks/use-channels.ts b/packages/dashboard/src/hooks/use-channels.tsindex e8fabfbb88..f38f29e208 100644--- a/packages/dashboard/src/hooks/use-channels.ts+++ b/packages/dashboard/src/hooks/use-channels.ts@@ -34,8 +34,8 @@ export function useCreateChannel() {return useResourceMutation<Channel, Error, ChannelCreateParams>({mutationFn: (params) => adminClient.channels.create(params),invalidate: [['channels']],- successMessage: 'Channel created',- errorMessage: 'Failed to create channel',+ successMessage: i18n.t('admin.channels.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -43,8 +43,8 @@ export function useUpdateChannel(id: string) {return useResourceMutation<Channel, Error, ChannelUpdateParams>({mutationFn: (params) => adminClient.channels.update(id, params),invalidate: [['channels'], ['channels', id]],- successMessage: 'Channel updated',- errorMessage: 'Failed to update channel',+ successMessage: i18n.t('admin.channels.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -55,8 +55,8 @@ export function useDeleteChannel() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.channels.delete(id),invalidate: [['channels']],- successMessage: 'Channel deleted',- errorMessage: 'Failed to delete channel',+ successMessage: i18n.t('admin.channels.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('channels', id) })},diff --git a/packages/dashboard/src/hooks/use-customer-groups.ts b/packages/dashboard/src/hooks/use-customer-groups.tsindex 3e17dd9217..f3575e7d3f 100644--- a/packages/dashboard/src/hooks/use-customer-groups.ts+++ b/packages/dashboard/src/hooks/use-customer-groups.ts@@ -10,6 +10,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'/*** Shared config for any `<ResourceMultiAutocomplete>` picking customer@@ -23,8 +24,8 @@ export function customerGroupAutocompleteProps(queryKey: string) {adminClient.customerGroups.list({ name_cont: q, limit: 20, sort: 'name' }),hydrate: (ids: string[]) => adminClient.customerGroups.list({ id_in: ids, limit: ids.length }),getOptionLabel: (g: CustomerGroup) => g.name ?? g.id,- placeholder: 'Search customer groups…',- emptyText: 'No customer groups match',+ placeholder: i18n.t('admin.customer_groups.autocomplete.placeholder'),+ emptyText: i18n.t('admin.customer_groups.autocomplete.empty'),}}@@ -41,8 +42,8 @@ export function useCreateCustomerGroup() {return useResourceMutation<CustomerGroup, Error, CustomerGroupCreateParams>({mutationFn: (params) => adminClient.customerGroups.create(params),invalidate: [['customer-groups']],- successMessage: 'Customer group created',- errorMessage: 'Failed to create customer group',+ successMessage: i18n.t('admin.customer_groups.messages.created'),+ errorMessage: i18n.t('admin.customer_groups.messages.create_failed'),})}@@ -50,8 +51,8 @@ export function useUpdateCustomerGroup(id: string) {return useResourceMutation<CustomerGroup, Error, CustomerGroupUpdateParams>({mutationFn: (params) => adminClient.customerGroups.update(id, params),invalidate: [['customer-groups'], ['customer-groups', id]],- successMessage: 'Customer group updated',- errorMessage: 'Failed to update customer group',+ successMessage: i18n.t('admin.customer_groups.messages.updated'),+ errorMessage: i18n.t('admin.customer_groups.messages.update_failed'),})}@@ -62,8 +63,8 @@ export function useDeleteCustomerGroup() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.customerGroups.delete(id),invalidate: [['customer-groups']],- successMessage: 'Customer group deleted',- errorMessage: 'Failed to delete customer group',+ successMessage: i18n.t('admin.customer_groups.messages.deleted'),+ errorMessage: i18n.t('admin.customer_groups.messages.delete_failed'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('customer-groups', id) })},diff --git a/packages/dashboard/src/hooks/use-customers.ts b/packages/dashboard/src/hooks/use-customers.tsindex 2eb8033d2f..91d169459d 100644--- a/packages/dashboard/src/hooks/use-customers.ts+++ b/packages/dashboard/src/hooks/use-customers.ts@@ -24,8 +24,8 @@ export function customerAutocompleteProps(queryKey: string) {search: (q: string) => adminClient.customers.list({ search: q, limit: 10 }),hydrate: (ids: string[]) => adminClient.customers.list({ id_in: ids, limit: ids.length }),getOptionLabel: (c: Customer) => c.email ?? c.id,- placeholder: 'Search customers…',- emptyText: 'No customers match',+ placeholder: i18n.t('admin.customers.autocomplete.placeholder'),+ emptyText: i18n.t('admin.customers.autocomplete.empty'),}}diff --git a/packages/dashboard/src/hooks/use-markets.ts b/packages/dashboard/src/hooks/use-markets.tsindex 4c708adca0..24df551ae8 100644--- a/packages/dashboard/src/hooks/use-markets.ts+++ b/packages/dashboard/src/hooks/use-markets.ts@@ -6,6 +6,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'interface UseMarketsParams {page?: number@@ -49,8 +50,8 @@ export function useCreateMarket() {return useResourceMutation<Market, Error, MarketCreateParams>({mutationFn: (params) => adminClient.markets.create(params),invalidate: [['markets']],- successMessage: 'Market created',- errorMessage: 'Failed to create market',+ successMessage: i18n.t('admin.markets.messages.created'),+ errorMessage: i18n.t('admin.markets.errors.failed_to_create'),})}@@ -58,8 +59,8 @@ export function useUpdateMarket(id: string) {return useResourceMutation<Market, Error, MarketUpdateParams>({mutationFn: (params) => adminClient.markets.update(id, params),invalidate: [['markets'], ['markets', id]],- successMessage: 'Market updated',- errorMessage: 'Failed to update market',+ successMessage: i18n.t('admin.markets.messages.updated'),+ errorMessage: i18n.t('admin.markets.errors.failed_to_update'),})}@@ -70,8 +71,8 @@ export function useDeleteMarket() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.markets.delete(id),invalidate: [['markets']],- successMessage: 'Market deleted',- errorMessage: 'Failed to delete market',+ successMessage: i18n.t('admin.markets.messages.deleted'),+ errorMessage: i18n.t('admin.markets.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('markets', id) })},diff --git a/packages/dashboard/src/hooks/use-option-types.ts b/packages/dashboard/src/hooks/use-option-types.tsindex 53ff4dacd1..a259f5ea61 100644--- a/packages/dashboard/src/hooks/use-option-types.ts+++ b/packages/dashboard/src/hooks/use-option-types.ts@@ -6,6 +6,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'interface UseOptionTypesParams {page?: number@@ -39,8 +40,8 @@ export function useCreateOptionType() {return useResourceMutation<OptionType, Error, OptionTypeCreateParams>({mutationFn: (params) => adminClient.optionTypes.create(params),invalidate: [['option-types']],- successMessage: 'Option type created',- errorMessage: 'Failed to create option type',+ successMessage: i18n.t('admin.option_types.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -48,8 +49,8 @@ export function useUpdateOptionType(id: string) {return useResourceMutation<OptionType, Error, OptionTypeUpdateParams>({mutationFn: (params) => adminClient.optionTypes.update(id, params),invalidate: [['option-types'], ['option-types', id]],- successMessage: 'Option type updated',- errorMessage: 'Failed to update option type',+ successMessage: i18n.t('admin.option_types.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -60,8 +61,8 @@ export function useDeleteOptionType() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.optionTypes.delete(id),invalidate: [['option-types']],- successMessage: 'Option type deleted',- errorMessage: 'Failed to delete option type',+ successMessage: i18n.t('admin.option_types.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('option-types', id) })},diff --git a/packages/dashboard/src/hooks/use-payment-methods.ts b/packages/dashboard/src/hooks/use-payment-methods.tsindex 2239c9ae38..372b0978fe 100644--- a/packages/dashboard/src/hooks/use-payment-methods.ts+++ b/packages/dashboard/src/hooks/use-payment-methods.ts@@ -10,6 +10,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'export function usePaymentMethodTypes() {// Store-scoped because the server filters out providers already installed@@ -48,8 +49,8 @@ export function useCreatePaymentMethod() {return useResourceMutation<PaymentMethod, Error, PaymentMethodCreateParams>({mutationFn: (params) => adminClient.paymentMethods.create(params),invalidate: [['payment-methods'], ['payment-methods', 'types']],- successMessage: 'Payment method created',- errorMessage: 'Failed to create payment method',+ successMessage: i18n.t('admin.payment_methods.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -57,8 +58,8 @@ export function useUpdatePaymentMethod(id: string) {return useResourceMutation<PaymentMethod, Error, PaymentMethodUpdateParams>({mutationFn: (params) => adminClient.paymentMethods.update(id, params),invalidate: [['payment-methods'], ['payment-methods', id]],- successMessage: 'Payment method updated',- errorMessage: 'Failed to update payment method',+ successMessage: i18n.t('admin.payment_methods.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -69,8 +70,8 @@ export function useDeletePaymentMethod() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.paymentMethods.delete(id),invalidate: [['payment-methods'], ['payment-methods', 'types']],- successMessage: 'Payment method deleted',- errorMessage: 'Failed to delete payment method',+ successMessage: i18n.t('admin.payment_methods.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('payment-methods', id) })},diff --git a/packages/dashboard/src/hooks/use-price-lists.ts b/packages/dashboard/src/hooks/use-price-lists.tsindex 1bb8db5c2c..dffaf8c151 100644--- a/packages/dashboard/src/hooks/use-price-lists.ts+++ b/packages/dashboard/src/hooks/use-price-lists.ts@@ -6,6 +6,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'export function usePriceList(id: string | undefined, expand?: string[]) {const base = useResourceKey('price-lists', id ?? 'noop')@@ -20,8 +21,8 @@ export function useCreatePriceList() {return useResourceMutation<PriceList, Error, PriceListCreateParams>({mutationFn: (params) => adminClient.priceLists.create(params),invalidate: [['price-lists']],- successMessage: 'Price list created',- errorMessage: 'Failed to create price list',+ successMessage: i18n.t('admin.products.price_lists.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -29,8 +30,8 @@ export function useUpdatePriceList(id: string) {return useResourceMutation<PriceList, Error, PriceListUpdateParams>({mutationFn: (params) => adminClient.priceLists.update(id, params),invalidate: [['price-lists'], ['price-lists', id]],- successMessage: 'Price list updated',- errorMessage: 'Failed to update price list',+ successMessage: i18n.t('admin.products.price_lists.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -41,8 +42,8 @@ export function useDeletePriceList() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.priceLists.delete(id),invalidate: [['price-lists']],- successMessage: 'Price list deleted',- errorMessage: 'Failed to delete price list',+ successMessage: i18n.t('admin.products.price_lists.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('price-lists', id) })},@@ -53,8 +54,8 @@ export function useActivatePriceList(id: string) {return useResourceMutation<PriceList, Error, void>({mutationFn: () => adminClient.priceLists.activate(id),invalidate: [['price-lists'], ['price-lists', id]],- successMessage: 'Price list activated',- errorMessage: 'Failed to activate price list',+ successMessage: i18n.t('admin.products.price_lists.messages.activated'),+ errorMessage: i18n.t('admin.products.price_lists.errors.failed_to_activate'),})}@@ -62,8 +63,8 @@ export function useDeactivatePriceList(id: string) {return useResourceMutation<PriceList, Error, void>({mutationFn: () => adminClient.priceLists.deactivate(id),invalidate: [['price-lists'], ['price-lists', id]],- successMessage: 'Price list deactivated',- errorMessage: 'Failed to deactivate price list',+ successMessage: i18n.t('admin.products.price_lists.messages.deactivated'),+ errorMessage: i18n.t('admin.products.price_lists.errors.failed_to_deactivate'),})}diff --git a/packages/dashboard/src/hooks/use-profile.ts b/packages/dashboard/src/hooks/use-profile.tsnew file mode 100644index 0000000000..95954007a5--- /dev/null+++ b/packages/dashboard/src/hooks/use-profile.ts@@ -0,0 +1,19 @@+import type { MeResponse, MeUpdateParams } from '@spree/admin-sdk'+import { adminClient, useResourceKey, useResourceMutation } from '@spree/dashboard-core'+import { useQuery } from '@tanstack/react-query'++export function useProfile() {+ return useQuery({+ queryKey: useResourceKey('profile'),+ queryFn: () => adminClient.me.get(),+ })+}++export function useUpdateProfile() {+ return useResourceMutation<MeResponse, Error, MeUpdateParams>({+ mutationFn: (params) => adminClient.me.update(params),+ invalidate: [['profile']],+ successMessage: false, // the page toasts success itself+ errorMessage: false, // the page maps 422s inline via mapSpreeErrorsToForm+ })+}diff --git a/packages/dashboard/src/hooks/use-promotions.ts b/packages/dashboard/src/hooks/use-promotions.tsindex 9c6b03f359..c682bb833c 100644--- a/packages/dashboard/src/hooks/use-promotions.ts+++ b/packages/dashboard/src/hooks/use-promotions.ts@@ -16,6 +16,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'interface UsePromotionsParams {page?: number@@ -34,8 +35,8 @@ export function useCreatePromotion() {return useResourceMutation<Promotion, Error, PromotionCreateParams>({mutationFn: (params) => adminClient.promotions.create(params),invalidate: [['promotions']],- successMessage: 'Promotion created',- errorMessage: 'Failed to create promotion',+ successMessage: i18n.t('admin.messages.promotion_created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -43,8 +44,8 @@ export function useUpdatePromotion(id: string) {return useResourceMutation<Promotion, Error, PromotionUpdateParams>({mutationFn: (params) => adminClient.promotions.update(id, params),invalidate: [['promotions'], ['promotions', id]],- successMessage: 'Promotion updated',- errorMessage: 'Failed to update promotion',+ successMessage: i18n.t('admin.messages.promotion_saved'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -55,8 +56,8 @@ export function useDeletePromotion() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.promotions.delete(id),invalidate: [['promotions']],- successMessage: 'Promotion deleted',- errorMessage: 'Failed to delete promotion',+ successMessage: i18n.t('admin.messages.promotion_deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('promotions', id) })},@@ -82,8 +83,8 @@ export function useCreatePromotionAction(promotionId: string) {['promotions', promotionId, 'actions'],['promotions', promotionId],],- successMessage: 'Action added',- errorMessage: 'Failed to add action',+ successMessage: i18n.t('admin.promotions.messages.action_added'),+ errorMessage: i18n.t('admin.promotions.errors.failed_to_add_action'),})}@@ -94,8 +95,8 @@ export function useUpdatePromotionAction(promotionId: string, actionId: string)['promotions', promotionId, 'actions'],['promotions', promotionId],],- successMessage: 'Action updated',- errorMessage: 'Failed to update action',+ successMessage: i18n.t('admin.promotions.messages.action_updated'),+ errorMessage: i18n.t('admin.promotions.errors.failed_to_update_action'),})}@@ -106,8 +107,8 @@ export function useDeletePromotionAction(promotionId: string) {['promotions', promotionId, 'actions'],['promotions', promotionId],],- successMessage: 'Action removed',- errorMessage: 'Failed to remove action',+ successMessage: i18n.t('admin.promotions.messages.action_removed'),+ errorMessage: i18n.t('admin.promotions.errors.failed_to_remove_action'),})}@@ -130,8 +131,8 @@ export function useCreatePromotionRule(promotionId: string) {['promotions', promotionId, 'rules'],['promotions', promotionId],],- successMessage: 'Rule added',- errorMessage: 'Failed to add rule',+ successMessage: i18n.t('admin.promotions.messages.rule_added'),+ errorMessage: i18n.t('admin.promotions.errors.failed_to_add_rule'),})}@@ -142,8 +143,8 @@ export function useUpdatePromotionRule(promotionId: string, ruleId: string) {['promotions', promotionId, 'rules'],['promotions', promotionId],],- successMessage: 'Rule updated',- errorMessage: 'Failed to update rule',+ successMessage: i18n.t('admin.promotions.messages.rule_updated'),+ errorMessage: i18n.t('admin.promotions.errors.failed_to_update_rule'),})}@@ -154,8 +155,8 @@ export function useDeletePromotionRule(promotionId: string) {['promotions', promotionId, 'rules'],['promotions', promotionId],],- successMessage: 'Rule removed',- errorMessage: 'Failed to remove rule',+ successMessage: i18n.t('admin.promotions.messages.rule_removed'),+ errorMessage: i18n.t('admin.promotions.errors.failed_to_remove_rule'),})}diff --git a/packages/dashboard/src/hooks/use-stock-items.ts b/packages/dashboard/src/hooks/use-stock-items.tsindex 83d8feba16..13e66650e6 100644--- a/packages/dashboard/src/hooks/use-stock-items.ts+++ b/packages/dashboard/src/hooks/use-stock-items.ts@@ -6,6 +6,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { type QueryKey, useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'interface UseStockItemsParams {page?: number@@ -41,8 +42,8 @@ export function useUpdateStockItem(id: string, extraInvalidate: QueryKey[] = [])return useResourceMutation<StockItem, Error, StockItemUpdateParams>({mutationFn: (params) => adminClient.stockItems.update(id, params),invalidate: [['stock-items'], ['stock-items', id], ...extraInvalidate],- successMessage: 'Stock updated',- errorMessage: 'Failed to update stock',+ successMessage: i18n.t('admin.stock_items.messages.stock_updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -53,8 +54,8 @@ export function useDeleteStockItem() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.stockItems.delete(id),invalidate: [['stock-items']],- successMessage: 'Stock item deleted',- errorMessage: 'Failed to delete stock item',+ successMessage: i18n.t('admin.stock_items.messages.stock_item_deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('stock-items', id) })},diff --git a/packages/dashboard/src/hooks/use-stock-locations.ts b/packages/dashboard/src/hooks/use-stock-locations.tsindex a971a94c65..5c77a8f428 100644--- a/packages/dashboard/src/hooks/use-stock-locations.ts+++ b/packages/dashboard/src/hooks/use-stock-locations.ts@@ -10,6 +10,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'interface UseStockLocationsParams {page?: number@@ -37,8 +38,8 @@ export function useCreateStockLocation() {return useResourceMutation<StockLocation, Error, StockLocationCreateParams>({mutationFn: (params) => adminClient.stockLocations.create(params),invalidate: [['stock-locations']],- successMessage: 'Stock location created',- errorMessage: 'Failed to create stock location',+ successMessage: i18n.t('admin.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -46,8 +47,8 @@ export function useUpdateStockLocation(id: string) {return useResourceMutation<StockLocation, Error, StockLocationUpdateParams>({mutationFn: (params) => adminClient.stockLocations.update(id, params),invalidate: [['stock-locations'], ['stock-locations', id]],- successMessage: 'Stock location updated',- errorMessage: 'Failed to update stock location',+ successMessage: i18n.t('admin.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -58,8 +59,8 @@ export function useDeleteStockLocation() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.stockLocations.delete(id),invalidate: [['stock-locations']],- successMessage: 'Stock location deleted',- errorMessage: 'Failed to delete stock location',+ successMessage: i18n.t('admin.messages.removed'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {// Drop the individual-resource cache so any open detail view stops// showing stale data after the row is gone.diff --git a/packages/dashboard/src/hooks/use-stock-transfers.ts b/packages/dashboard/src/hooks/use-stock-transfers.tsindex c514091833..765e44743f 100644--- a/packages/dashboard/src/hooks/use-stock-transfers.ts+++ b/packages/dashboard/src/hooks/use-stock-transfers.ts@@ -6,6 +6,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'export function useStockTransfer(id: string | undefined) {return useQuery({@@ -22,8 +23,8 @@ export function useCreateStockTransfer() {return useResourceMutation<StockTransfer, Error, StockTransferCreateParams>({mutationFn: (params) => adminClient.stockTransfers.create(params),invalidate: [['stock-transfers']],- successMessage: 'Stock transfer recorded',- errorMessage: 'Failed to record stock transfer',+ successMessage: i18n.t('admin.stock_transfers.messages.recorded'),+ errorMessage: i18n.t('admin.stock_transfers.errors.failed_to_record'),})}@@ -34,8 +35,8 @@ export function useDeleteStockTransfer() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.stockTransfers.delete(id),invalidate: [['stock-transfers']],- successMessage: 'Stock transfer deleted',- errorMessage: 'Failed to delete stock transfer',+ successMessage: i18n.t('admin.stock_transfers.messages.deleted'),+ errorMessage: i18n.t('admin.stock_transfers.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('stock-transfers', id) })},diff --git a/packages/dashboard/src/hooks/use-tax-categories.ts b/packages/dashboard/src/hooks/use-tax-categories.tsindex 4439cc4ebb..1ee849423e 100644--- a/packages/dashboard/src/hooks/use-tax-categories.ts+++ b/packages/dashboard/src/hooks/use-tax-categories.ts@@ -10,6 +10,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'interface UseTaxCategoriesParams {page?: number@@ -36,8 +37,8 @@ export function useCreateTaxCategory() {return useResourceMutation<TaxCategory, Error, TaxCategoryCreateParams>({mutationFn: (params) => adminClient.taxCategories.create(params),invalidate: [['tax-categories']],- successMessage: 'Tax category created',- errorMessage: 'Failed to create tax category',+ successMessage: i18n.t('admin.tax_categories.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -45,8 +46,8 @@ export function useUpdateTaxCategory(id: string) {return useResourceMutation<TaxCategory, Error, TaxCategoryUpdateParams>({mutationFn: (params) => adminClient.taxCategories.update(id, params),invalidate: [['tax-categories'], ['tax-categories', id]],- successMessage: 'Tax category updated',- errorMessage: 'Failed to update tax category',+ successMessage: i18n.t('admin.tax_categories.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -57,8 +58,8 @@ export function useDeleteTaxCategory() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.taxCategories.delete(id),invalidate: [['tax-categories']],- successMessage: 'Tax category deleted',- errorMessage: 'Failed to delete tax category',+ successMessage: i18n.t('admin.tax_categories.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('tax-categories', id) })},diff --git a/packages/dashboard/src/hooks/use-webhook-endpoints.ts b/packages/dashboard/src/hooks/use-webhook-endpoints.tsindex 9f58b90860..3dcacf6b67 100644--- a/packages/dashboard/src/hooks/use-webhook-endpoints.ts+++ b/packages/dashboard/src/hooks/use-webhook-endpoints.ts@@ -11,6 +11,7 @@ import {useResourceMutation,} from '@spree/dashboard-core'import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'export function useWebhookEndpoint(id: string | undefined) {return useQuery({@@ -27,7 +28,7 @@ export function useCreateWebhookEndpoint() {// The creator wants the dedicated "save your secret" sheet, not a toast,// because the secret_key in the response is only revealed once.successMessage: false,- errorMessage: 'Failed to create webhook endpoint',+ errorMessage: i18n.t('admin.errors.failed_to_create'),})}@@ -35,8 +36,8 @@ export function useUpdateWebhookEndpoint(id: string) {return useResourceMutation<WebhookEndpoint, Error, WebhookEndpointUpdateParams>({mutationFn: (params) => adminClient.webhookEndpoints.update(id, params),invalidate: [['webhook-endpoints'], ['webhook-endpoints', id]],- successMessage: 'Webhook endpoint updated',- errorMessage: 'Failed to update webhook endpoint',+ successMessage: i18n.t('admin.settings.webhooks.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),})}@@ -47,8 +48,8 @@ export function useDeleteWebhookEndpoint() {return useResourceMutation<void, Error, string>({mutationFn: (id) => adminClient.webhookEndpoints.delete(id),invalidate: [['webhook-endpoints']],- successMessage: 'Webhook endpoint removed',- errorMessage: 'Failed to remove webhook endpoint',+ successMessage: i18n.t('admin.settings.webhooks.messages.removed'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),onSuccess: (_data, id) => {queryClient.removeQueries({ queryKey: buildKey('webhook-endpoints', id) })},@@ -64,7 +65,7 @@ export function useToggleWebhookEndpoint() {active ? adminClient.webhookEndpoints.enable(id) : adminClient.webhookEndpoints.disable(id),invalidate: [['webhook-endpoints']],successMessage: false,- errorMessage: 'Failed to update endpoint',+ errorMessage: i18n.t('admin.errors.failed_to_update'),onSuccess: (_data, { id }) => {// Detail page reads `disabled_at` + `active` directly from the// single-endpoint cache; invalidating only the list misses it.@@ -80,7 +81,7 @@ export function useSendTestWebhook() {return useResourceMutation<WebhookDelivery, Error, string>({mutationFn: (id) => adminClient.webhookEndpoints.sendTest(id),successMessage: false,- errorMessage: 'Failed to send test webhook',+ errorMessage: i18n.t('admin.settings.webhooks.errors.send_test_failed'),onSuccess: (_data, endpointId) => {// Refetch the deliveries list embedded in the detail page (the new test// row needs to appear without a manual refresh) and the endpoint's@@ -116,6 +117,6 @@ export function useRedeliverWebhookDelivery(endpointId: string) {['webhook-endpoints', endpointId],],successMessage: false,- errorMessage: 'Failed to redeliver',+ errorMessage: i18n.t('admin.settings.webhooks.errors.redeliver_failed'),})}diff --git a/packages/dashboard/src/i18n-setup.ts b/packages/dashboard/src/i18n-setup.tsindex 4b62cb93e2..870bdd976b 100644--- a/packages/dashboard/src/i18n-setup.ts+++ b/packages/dashboard/src/i18n-setup.ts@@ -15,7 +15,49 @@//// `deep: true` + `overwrite: true` merge nested objects without dropping// keys the framework already provided; plugin keys win on collision.-import { i18n } from '@spree/dashboard-core'+import { i18n, intlDisplayName } from '@spree/dashboard-core'import en from './locales/en.json'i18n.addResourceBundle('en', 'translation', en, true, true)++// All non-English app bundles, imported EAGERLY so the active one can be+// registered synchronously at module-load — before any table/registry module+// evaluates its `i18n.t(...)` labels. (We reload the page on language change,+// so only the booted language's labels ever need to be resolved; eager keeps+// that resolution synchronous and flash-free. ~19 KB gz per locale.)+const appLocales = import.meta.glob<{ default: Record<string, unknown> }>(+ ['./locales/*.json', '!./locales/en.json'],+ { eager: true },+)++function codeFromPath(path: string): string {+ return path.replace('./locales/', '').replace('.json', '')+}++// Register every app bundle up front so a switched/booted language resolves+// synchronously. (Core bundles are registered the same way in dashboard-core.)+// `lib/i18n.ts` already set the initial `lng` from localStorage, so the booted+// language's resources are present here before any table/registry module+// evaluates its `i18n.t(...)` labels.+for (const [path, mod] of Object.entries(appLocales)) {+ i18n.addResourceBundle(codeFromPath(path), 'translation', mod.default, true, true)+}++// Each language's endonym (its own name: `Deutsch`, `日本語`). `Intl.DisplayNames`+// returns it in the language's own convention, so some are lowercase+// (`français`, `polski`); capitalize the first letter — per the language's own+// casing rules — for a uniform, title-cased list. Scripts without case+// (`日本語`) are unaffected. Falls back to the code on no coverage.+function localeName(code: string): string {+ const name = intlDisplayName('language', code, code) ?? code+ return name.charAt(0).toLocaleUpperCase(code) + name.slice(1)+}++/**+ * Admin UI languages the dashboard can display, as `{ code, name }` pairs for+ * the language picker. Derived from the shipped locale bundles, not the API.+ */+export function getAvailableUiLocales(): Array<{ code: string; name: string }> {+ const codes = ['en', ...Object.keys(appLocales).map(codeFromPath)]+ return codes.map((code) => ({ code, name: localeName(code) }))+}diff --git a/packages/dashboard/src/lib/type-labels.ts b/packages/dashboard/src/lib/type-labels.tsnew file mode 100644index 0000000000..f577e87bee--- /dev/null+++ b/packages/dashboard/src/lib/type-labels.ts@@ -0,0 +1,63 @@+import i18n from 'i18next'++/**+ * Type catalog families returned by the Admin API. Each carries a stable+ * snake_case `type` code plus an English `label`/`description`. We resolve+ * an i18n key from the code so the admin UI can localize the label, falling+ * back to the API's English string for custom/extension types that ship no+ * translation.+ */+export type TypeFamily = 'rule_types' | 'action_types' | 'calculators'++function i18nKey(family: TypeFamily, code: string, facet: 'name' | 'description'): string {+ // Calculators expose a single flat string (no separate description), so+ // their key is `admin.calculators.<code>`. Rule/action types nest+ // `name` and `description` under their code.+ if (family === 'calculators') return `admin.calculators.${code}`+ return `admin.promotions.${family}.${code}.${facet}`+}++/**+ * Localized label for an API type code, falling back to the API-provided+ * `label` when no translation key exists (custom/extension types).+ *+ * @param family which type catalog the code belongs to+ * @param code the stable snake_case type code (e.g. `country`, `flat_percent_item_total`)+ * @param fallback the API's English `label`+ * @returns the localized label, or `fallback`+ */+export function typeLabel(family: TypeFamily, code: string, fallback: string): string {+ const key = i18nKey(family, code, 'name')+ return i18n.exists(key) ? i18n.t(key) : fallback+}++/**+ * Localized description for a rule/action type code, falling back to the+ * API-provided `description`. Calculators have no description key.+ *+ * @param family which type catalog the code belongs to+ * @param code the stable snake_case type code+ * @param fallback the API's English `description`+ * @returns the localized description, or `fallback`+ */+export function typeDescription(family: TypeFamily, code: string, fallback: string): string {+ // Calculators have only a flat name key (no description), so resolving a+ // description key would wrongly return the name — always use the fallback.+ if (family === 'calculators') return fallback+ const key = i18nKey(family, code, 'description')+ return i18n.exists(key) ? i18n.t(key) : fallback+}++/**+ * Localized label for a calculator/rule/action preference field, keyed by+ * the field's `key` under `admin.preferences.<key>`. Falls back to the+ * caller's current label (typically the API label or a humanized key).+ *+ * @param key the preference field key (e.g. `amount`, `flat_percent`)+ * @param fallback the current label to use when no translation exists+ * @returns the localized label, or `fallback`+ */+export function preferenceLabel(key: string, fallback: string): string {+ const i18nKey = `admin.preferences.${key}`+ return i18n.exists(i18nKey) ? i18n.t(i18nKey) : fallback+}diff --git a/packages/dashboard/src/locales/de.json b/packages/dashboard/src/locales/de.jsonnew file mode 100644index 0000000000..a14e439336--- /dev/null+++ b/packages/dashboard/src/locales/de.json@@ -0,0 +1,2366 @@+{+ "admin": {+ "a11y": {+ "edit_media": "Bild bearbeiten",+ "delete_image": "Bild löschen"+ },+ "gift_cards": {+ "statuses": {+ "partially_redeemed": "Teilweise eingelöst",+ "redeemed": "Eingelöst",+ "canceled": "Storniert",+ "expired": "Abgelaufen"+ },+ "columns": {+ "used": "Verwendet",+ "remaining": "Verbleibend",+ "batch": "Charge",+ "customer": "Kunde",+ "issued_by": "Ausgestellt von"+ },+ "table": {+ "search_placeholder": "Nach Code suchen…",+ "empty": "Noch keine Geschenkkarten"+ },+ "messages": {+ "created": "Geschenkkarte erstellt",+ "create_failed": "Geschenkkarte konnte nicht erstellt werden",+ "updated": "Geschenkkarte aktualisiert",+ "update_failed": "Geschenkkarte konnte nicht aktualisiert werden",+ "deleted": "Geschenkkarte gelöscht",+ "delete_failed": "Geschenkkarte konnte nicht gelöscht werden",+ "batch_created": "Geschenkkarten-Charge erstellt",+ "batch_create_failed": "Geschenkkarten-Charge konnte nicht erstellt werden"+ },+ "batch_autocomplete": {+ "placeholder": "Chargen nach Präfix suchen…",+ "empty": "Keine passenden Chargen"+ }+ },+ "branding": {+ "app_name": "Spree Admin",+ "powered_by": "Bereitgestellt von Spree Commerce"+ },+ "nav": {+ "home": "Startseite",+ "account": "Konto",+ "orders": "Bestellungen",+ "draft_orders": "Bestellentwürfe",+ "products": "Produkte",+ "price_lists": "Preislisten",+ "categories": "Kategorien",+ "options": "Optionen",+ "transfers": "Umlagerungen",+ "customers": "Kunden",+ "customer_groups": "Gruppen",+ "promotions": "Aktionen",+ "gift_cards": "Geschenkkarten",+ "reports": "Berichte",+ "settings": "Einstellungen"+ },+ "settings_nav": {+ "groups": {+ "store": "Shop",+ "payments": "Zahlungen & Steuern",+ "fulfillment": "Fulfillment",+ "team": "Team & Zugriff"+ },+ "items": {+ "store": "Shop",+ "emails": "E-Mails",+ "channels": "Verkaufskanäle",+ "payment_methods": "Zahlungsmethoden",+ "tax_categories": "Steuerkategorien",+ "markets": "Märkte",+ "stock_locations": "Lagerstandorte",+ "custom_field_definitions": "Benutzerdefinierte Felder",+ "staff": "Mitarbeiter",+ "api_keys": "API-Schlüssel",+ "webhooks": "Webhooks",+ "allowed_origins": "Zugelassene Ursprünge",+ "profile": "Profil"+ }+ },+ "fields": {+ "products_count": {+ "label": "Produkte"+ },+ "prices_count": {+ "label": "Preise"+ },+ "customer_id": {+ "label": "Kunde"+ },+ "role_id": {+ "label": "Rolle"+ },+ "role_ids": {+ "label": "Rollen"+ },+ "tax_category_id": {+ "label": "Steuerkategorie"+ },+ "promotion": {+ "name": {+ "placeholder": "Sommer-Sale"+ },+ "description": {+ "placeholder": "Interne Beschreibung (optional)"+ },+ "kind": {+ "label": "Wie wird diese Aktion angewendet?"+ },+ "code": {+ "placeholder": "SOMMER2026"+ },+ "multi_codes": {+ "label": "Eine Reihe eindeutiger Codes generieren",+ "help": "Nützlich für Einmalcodes — jeder Kunde löst einen anderen Code ein."+ },+ "number_of_codes": {+ "label": "Anzahl der Codes",+ "placeholder": "100"+ },+ "code_prefix": {+ "label": "Code-Präfix (optional)",+ "placeholder": "VIP",+ "help": "Jeder generierte Code beginnt mit diesem Präfix."+ },+ "starts_at": {+ "placeholder": "Kein Startdatum"+ },+ "expires_at": {+ "placeholder": "Kein Ablauf"+ },+ "usage_limit": {+ "label": "Nutzungslimit",+ "placeholder": "Unbegrenzt"+ },+ "match_policy": {+ "label": "Übereinstimmungsregel"+ }+ },+ "custom_field_definition": {+ "label": {+ "label": "Bezeichnung",+ "placeholder": "z. B. Material"+ },+ "namespace": {+ "label": "Namensraum",+ "placeholder": "custom"+ },+ "key": {+ "label": "Schlüssel",+ "placeholder": "z. B. material",+ "invalid_format": "Nur Buchstaben, Zahlen und Unterstriche"+ },+ "field_type": {+ "label": "Typ",+ "read_only_help": "Der Typ kann nicht mehr geändert werden, sobald Werte vorhanden sind — andernfalls würden gespeicherte Werte falsch interpretiert.",+ "options": {+ "short_text": "Kurzer Text",+ "long_text": "Langer Text",+ "rich_text": "Formatierter Text",+ "number": "Zahl",+ "boolean": "Boolescher Wert",+ "json": "JSON"+ }+ },+ "resource_type": {+ "label": "Gilt für",+ "read_only_help": "Der Eigentümer kann nicht mehr geändert werden, sobald Werte für dieses Feld vorhanden sind.",+ "options": {+ "Spree::Product": "Produkte",+ "Spree::Variant": "Varianten",+ "Spree::Order": "Bestellungen",+ "Spree::User": "Kunden",+ "Spree::Category": "Kategorien",+ "Spree::OptionType": "Optionstypen"+ }+ },+ "storefront_visible": {+ "label": "Im Storefront sichtbar",+ "column_label": "Storefront"+ }+ },+ "tax_category": {+ "name": {+ "placeholder": "z. B. Ermäßigter Satz"+ },+ "tax_code": {+ "label": "Steuercode",+ "placeholder": "Code des externen Steueranbieters (Avalara usw.)"+ },+ "description": {+ "placeholder": "Optionale interne Beschreibung"+ },+ "is_default": {+ "label": "Standard",+ "help": "Wenn Sie dies festlegen, wird der bisherige Standard aufgehoben. Produkte ohne explizite Kategorie greifen auf diese zurück."+ }+ },+ "allowed_origin": {+ "origin": {+ "label": "Ursprung",+ "placeholder": "https://admin.example.com",+ "help": "Nur Schema + Host (+ optionaler Port). Kein Pfad, keine Query, kein Fragment."+ }+ },+ "channel": {+ "name": {+ "placeholder": "z. B. POS, Großhandel, Meta Shop"+ },+ "code": {+ "label": "Code",+ "placeholder": "Automatisch aus dem Namen abgeleitet",+ "help": "Stabiler Bezeichner, der von API-Clients über den X-Spree-Channel-Header und zur Bestellzuordnung verwendet wird. Leer lassen, um automatisch aus dem Namen abzuleiten. Kleinbuchstaben, Zahlen, Bindestriche, Unterstriche."+ },+ "active": {+ "label": "Aktiv",+ "help": "Inaktive Verkaufskanäle nehmen keine Bestellungen mehr an und werden vom X-Spree-Channel-Header nicht erkannt."+ },+ "default": {+ "label": "Standardkanal",+ "help": "Pro Store ist genau ein Kanal der Standard. Wird als Fallback verwendet, wenn kein Kanal ausgewählt ist, und als Auto-Veröffentlichungsziel für neue Produkte."+ },+ "order_routing_strategy": {+ "label": "Strategie für das Bestell-Routing",+ "help": "Überschreibt die Routing-Strategie auf Store-Ebene für Bestellungen, die diesem Kanal zugeordnet sind. Leer lassen, um zu erben.",+ "inherit": "Vom Store erben",+ "options": {+ "Spree::OrderRouting::Strategy::Rules": "Regeln (geordnet)",+ "Spree::OrderRouting::Strategy::Legacy": "Legacy"+ }+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "Passwort"+ },+ "password_confirmation": {+ "label": "Passwort bestätigen"+ }+ },+ "customer_group": {+ "name": {+ "placeholder": "z. B. VIP-Kunden"+ },+ "description": {+ "placeholder": "Optionale interne Beschreibung"+ }+ },+ "price_list": {+ "name": {+ "label": "Name",+ "placeholder": "z. B. EU-Großhandel",+ "help": "Interne Bezeichnung — wird Kunden nie angezeigt."+ },+ "description": {+ "label": "Beschreibung",+ "placeholder": "Optionale interne Beschreibung"+ },+ "starts_at": {+ "label": "Beginnt",+ "placeholder": "Sofort",+ "help": "Wann diese Liste aktiv wird. Leer lassen, um bei Aktivierung sofort zu starten."+ },+ "ends_at": {+ "label": "Endet",+ "placeholder": "Nie",+ "help": "Leer lassen für kein Enddatum."+ },+ "match_policy": {+ "label": "Übereinstimmungsregel",+ "all": "Alle Regeln müssen zutreffen",+ "any": "Eine beliebige Regel darf zutreffen"+ },+ "status": {+ "active": "Aktiv",+ "scheduled": "Geplant",+ "inactive": "Inaktiv",+ "draft": "Entwurf"+ }+ },+ "price_rule": {+ "customers": {+ "label": "Kunden",+ "help": "Leer lassen, um diese Regel auf jeden angemeldeten Kunden anzuwenden."+ },+ "customer_groups": {+ "label": "Kundengruppen",+ "help": "Leer lassen, um diese Regel auf jeden Kunden unabhängig von der Gruppe anzuwenden."+ },+ "markets": {+ "label": "Märkte",+ "help": "Leer lassen, um diese Regel in jedem Markt anzuwenden."+ }+ },+ "stock_location": {+ "name": {+ "placeholder": "Lager Brooklyn"+ },+ "admin_name": {+ "label": "Interner Name",+ "placeholder": "Optional — wird nur im Admin angezeigt"+ },+ "kind": {+ "label": "Art"+ },+ "active": {+ "label": "Aktiv",+ "help": "Inaktive Standorte erscheinen nicht in der Fulfillment-Auswahl."+ },+ "default": {+ "label": "Standardstandort",+ "help": "Neue Lagerbestände werden hierher übernommen. Nur ein Standort kann Standard sein."+ },+ "backorderable_default": {+ "label": "Standardmäßig nachbestellbar",+ "help": "Neue Lagerbestände erlauben standardmäßig Nachbestellungen, wenn der Bestand erschöpft ist."+ },+ "propagate_all_variants": {+ "label": "Lagerbestände für alle Varianten automatisch anlegen",+ "help": "Lagerbestände an diesem Standort für jede Produktvariante anlegen."+ },+ "pickup_enabled": {+ "label": "Abholung durch Kunden erlauben",+ "help": "Kunden können Bestellungen an diesem Standort beim Checkout abholen."+ },+ "pickup_stock_policy": {+ "label": "Bestandsrichtlinie"+ },+ "pickup_ready_in_minutes": {+ "label": "Bereit in (Minuten)",+ "placeholder": "60"+ },+ "pickup_instructions": {+ "label": "Abholhinweise",+ "placeholder": "Wohin der Kunde gehen soll, um seine Bestellung abzuholen."+ }+ },+ "payment_method": {+ "type": {+ "label": "Anbieter",+ "placeholder": "Anbieter auswählen"+ },+ "name": {+ "placeholder": "z. B. Kreditkarte (Stripe)"+ },+ "description": {+ "placeholder": "Kundenseitige Beschreibung, die beim Checkout angezeigt wird"+ },+ "storefront_visible": {+ "label": "Im Storefront sichtbar"+ },+ "active": {+ "label": "Aktiv",+ "help": "Inaktive Methoden werden beim Checkout ausgeblendet."+ },+ "auto_capture": {+ "label": "Automatischer Einzug",+ "help": "Bei Autorisierung automatisch einziehen. Wenn deaktiviert, müssen Sie manuell einziehen."+ },+ "provider_configuration": "Anbieterkonfiguration"+ },+ "market": {+ "name": {+ "placeholder": "z. B. Europa"+ },+ "currency": {+ "label": "Währung",+ "help": "ISO-4217-Währung für alle Preise in diesem Markt."+ },+ "default_locale": {+ "label": "Standardsprache",+ "help": "Storefront-Sprache für Käufer in diesem Markt."+ },+ "supported_locales": {+ "label": "Unterstützte Sprachen",+ "help": "Weitere Sprachen, zu denen Käufer wechseln können. Die Standardsprache ist immer enthalten."+ },+ "country_isos": {+ "label": "Länder",+ "help": "Wählen Sie die Länder aus, die dieser Markt abdeckt. Jedes Land kann pro Store höchstens einem Markt angehören."+ },+ "tax_inclusive": {+ "label": "Preise inklusive Steuer",+ "help": "Preise mit enthaltener Steuer anzeigen. In EU-Märkten üblich."+ },+ "default": {+ "label": "Standardmarkt",+ "help": "Käufer ohne bekanntes Land sehen diesen Markt. Pro Store kann nur einer Standard sein."+ }+ },+ "option_type": {+ "name": {+ "label": "Interner Name",+ "placeholder": "z. B. shirt-size",+ "help": "Bezeichner in Kleinbuchstaben. Muss im gesamten Store eindeutig sein."+ },+ "label": {+ "label": "Bezeichnung",+ "placeholder": "z. B. Hemdgröße",+ "help": "Wird Kunden im Storefront angezeigt."+ },+ "kind": {+ "label": "Art",+ "help": "Steuert, wie die Option im Storefront dargestellt wird. Farbmuster zeigt eine Hex-Farbe; Schaltflächen zeigen ein Vorschaubild."+ },+ "filterable": {+ "label": "Filterbar",+ "help": "Diese Option als Filter in Produktlisten des Storefronts anzeigen."+ }+ },+ "option_value": {+ "name": {+ "label": "Interner Name",+ "placeholder": "z. B. small"+ },+ "label": {+ "label": "Bezeichnung",+ "placeholder": "z. B. Klein"+ },+ "color_code": {+ "label": "Farbe"+ },+ "image": {+ "label": "Bild"+ }+ },+ "variant": {+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUCT-RED-S"+ },+ "barcode": {+ "label": "Barcode"+ },+ "weight": {+ "label": "Gewicht"+ },+ "weight_unit": {+ "label": "Einheit"+ },+ "height": {+ "label": "Höhe"+ },+ "width": {+ "label": "Breite"+ },+ "depth": {+ "label": "Tiefe"+ },+ "dimensions_unit": {+ "label": "Einheit"+ }+ },+ "api_key": {+ "name": {+ "label": "Name",+ "placeholder": "Backend-Integration, Storefront-Prod, …",+ "required": "Name ist erforderlich"+ },+ "key_type": {+ "label": "Typ"+ },+ "scopes": {+ "label": "Geltungsbereiche"+ }+ },+ "store": {+ "name": {+ "label": "Store-Name"+ },+ "preferred_admin_locale": {+ "label": "Admin-Sprache",+ "placeholder": "Standardsprache verwenden"+ },+ "preferred_timezone": {+ "label": "Zeitzone",+ "placeholder": "Zeitzone auswählen"+ },+ "preferred_unit_system": {+ "label": "Einheitensystem"+ },+ "preferred_weight_unit": {+ "label": "Gewichtseinheit"+ },+ "mail_from_address": {+ "label": "Absenderadresse",+ "placeholder": "[email protected]",+ "help": "Wird als Absenderadresse bei jeder transaktionalen E-Mail verwendet."+ },+ "customer_support_email": {+ "label": "E-Mail des Kundensupports",+ "placeholder": "[email protected]",+ "help": "Antwortadresse, die Kunden in Storefront-E-Mails angezeigt wird."+ },+ "new_order_notifications_email": {+ "label": "Benachrichtigungen über neue Bestellungen",+ "placeholder": "[email protected]",+ "help": "Empfänger von Benachrichtigungen über „neue Bestellung aufgegeben“. Leer lassen, um zu deaktivieren."+ },+ "preferred_send_consumer_transactional_emails": {+ "label": "Transaktionale E-Mails an Kunden senden",+ "help": "Wenn deaktiviert, werden keine Bestellbestätigungen, Versand- oder Erstattungs-E-Mails gesendet."+ },+ "mailer_logo": {+ "label": "E-Mail-Logo",+ "help": "PNG oder JPG mit transparentem Hintergrund. Eingebettet in die Kopfzeilen transaktionaler E-Mails."+ }+ },+ "webhook_endpoint": {+ "name": {+ "label": "Name",+ "placeholder": "z. B. Bestell-Pipeline",+ "help": "Optionale Bezeichnung, die in dieser Liste angezeigt wird."+ },+ "url": {+ "label": "Ziel-URL",+ "placeholder": "https://example.com/webhooks"+ },+ "active": {+ "label": "Aktiv",+ "help": "Inaktive Endpunkte empfangen keine Zustellungen."+ },+ "subscriptions": {+ "label": "Ereignisse",+ "help": "Wählen Sie aus, welche Ereignisse einen Webhook auslösen sollen. Wählen Sie nichts aus, um jedes Ereignis zu empfangen."+ }+ },+ "product": {+ "name": {+ "label": "Name",+ "placeholder": "Produktname"+ },+ "description": {+ "label": "Beschreibung",+ "placeholder": "Schreiben Sie eine Produktbeschreibung…"+ },+ "make_active_at": {+ "label": "Aktiv schalten am"+ },+ "available_on": {+ "label": "Verfügbar ab"+ },+ "discontinue_on": {+ "label": "Einstellen am"+ },+ "category_ids": {+ "label": "Kategorien"+ },+ "channels": {+ "label": "Verkaufskanäle"+ },+ "tags": {+ "label": "Tags"+ }+ },+ "product_publication": {+ "published_at": {+ "label": "Veröffentlichen ab",+ "placeholder": "Sofort live",+ "help": "Leer lassen, um sofort live zu gehen."+ },+ "unpublished_at": {+ "label": "Veröffentlichung beenden am",+ "placeholder": "Nie",+ "help": "Leer lassen, um unbegrenzt gelistet zu bleiben."+ }+ },+ "gift_card": {+ "code": {+ "label": "Code",+ "help": "Leer lassen für automatische Generierung. Bei Stapeln wird dies zum Präfix."+ },+ "amount": {+ "label": "Betrag"+ },+ "currency": {+ "label": "Währung"+ },+ "expires_at": {+ "label": "Läuft ab",+ "placeholder": "Kein Ablauf"+ },+ "customer_id": {+ "label": "Kunde"+ },+ "quantity": {+ "label": "Menge",+ "help": "Bei 1 wird eine einzelne Karte ausgegeben. Bei mehr als 1 wird ein Stapel mit automatisch generierten Codes ausgegeben."+ }+ },+ "customer": {+ "tags": {+ "label": "Tags"+ },+ "customer_groups": {+ "label": "Kundengruppen"+ },+ "accepts_email_marketing": {+ "label": "Für Marketing angemeldet"+ },+ "internal_note": {+ "label": "Interne Notiz",+ "placeholder": "Nur für Mitarbeiter sichtbare Hinweise zu diesem Kunden…"+ }+ },+ "store_credit": {+ "amount": {+ "label": "Betrag"+ },+ "currency": {+ "label": "Währung"+ },+ "category_id": {+ "label": "Kategorie"+ },+ "memo": {+ "label": "Notiz",+ "placeholder": "Grund für die Ausstellung dieses Guthabens"+ }+ },+ "order": {+ "email": {+ "label": "Oder eine Gast-E-Mail verwenden",+ "placeholder": "[email protected]"+ },+ "customer_note": {+ "label": "Kundennotiz (für Kunden sichtbar)"+ },+ "internal_note": {+ "label": "Interne Notiz (nur Mitarbeiter)"+ },+ "coupon_code": {+ "label": "Gutscheincode",+ "placeholder": "Optional"+ },+ "channel": {+ "label": "Verkaufskanal",+ "placeholder": "Store-Standard verwenden",+ "help": "Die Bestellung einem bestimmten Verkaufskanal zuordnen. Standardmäßig der Online-Kanal des Stores."+ }+ },+ "media": {+ "alt": {+ "label": "Alt-Text",+ "placeholder": "Beschreiben Sie das Bild für Barrierefreiheit und SEO"+ }+ },+ "profile": {+ "email": {+ "label": "E-Mail"+ },+ "first_name": {+ "label": "Vorname"+ },+ "last_name": {+ "label": "Nachname"+ },+ "selected_locale": {+ "label": "Sprache",+ "help": "Sprache, die im gesamten Admin-Dashboard verwendet wird. Betrifft nur Ihre Ansicht."+ }+ }+ },+ "promotions": {+ "rule_types_empty": "Keine Regeltypen registriert.",+ "rule_types_all_used": "Jeder verfügbare Regeltyp ist dieser Aktion bereits zugeordnet.",+ "generate_code": {+ "title": "Zufälligen Code generieren"+ },+ "kinds": {+ "coupon_code": "Gutscheincode",+ "automatic": "Automatisch (kein Code)"+ },+ "match_policies": {+ "all": "Alle Regeln müssen zutreffen",+ "any": "Mindestens eine Regel muss zutreffen",+ "all_hint": "Alle Regeln müssen zutreffen.",+ "any_hint": "Mindestens eine Regel muss zutreffen."+ },+ "rules_card": {+ "title": "Regeln",+ "description": "Bedingungen, die festlegen, ob die Aktion angewendet wird.",+ "empty": "Keine Regeln. Ohne Regeln gilt die Aktion immer (vorbehaltlich Zeitplan und Nutzungslimit).",+ "add_rule": "Regel hinzufügen"+ },+ "validation": {+ "code_required": "Code ist erforderlich (oder klicken Sie auf „Generieren“)",+ "prefix_required": "Präfix ist für Stapel mit mehreren Codes erforderlich",+ "number_of_codes_required": "Wählen Sie aus, wie viele Codes generiert werden sollen",+ "expiry_after_start": "Das Ablaufdatum muss nach dem Startdatum liegen"+ },+ "delete_confirm": {+ "title": "Aktion löschen?",+ "message": "{{name}} wird dauerhaft entfernt. Aktionen, auf die abgeschlossene Bestellungen verweisen, können nicht gelöscht werden.",+ "default_name": "Diese Aktion"+ },+ "rules": {+ "country": {+ "label": "Länder",+ "search_placeholder": "Länder suchen…",+ "empty": "Keine passenden Länder"+ },+ "product": {+ "label": "Produkte",+ "search_placeholder": "Produkte nach Namen suchen…",+ "empty": "Keine passenden Produkte",+ "match_policy": {+ "any": {+ "label": "Beliebige dieser Produkte",+ "description": "Die Bestellung muss mindestens eines enthalten."+ },+ "all": {+ "label": "Alle diese Produkte",+ "description": "Die Bestellung muss jedes Produkt enthalten."+ },+ "none": {+ "label": "Keines dieser Produkte",+ "description": "Die Bestellung darf keines davon enthalten."+ }+ }+ },+ "category": {+ "label": "Kategorien",+ "search_placeholder": "Kategorien suchen…",+ "empty": "Keine passenden Kategorien",+ "match_policy": {+ "any": {+ "label": "Beliebige dieser Kategorien",+ "description": "Die Bestellung muss ein Produkt aus mindestens einer enthalten."+ },+ "all": {+ "label": "Alle diese Kategorien",+ "description": "Die Bestellung muss ein Produkt aus jeder Kategorie enthalten."+ }+ }+ },+ "customer_group": {+ "label": "Kundengruppen",+ "search_placeholder": "Kundengruppen suchen…",+ "empty": "Keine passenden Kundengruppen"+ },+ "customer": {+ "label": "Kunden",+ "search_placeholder": "Kunden nach Namen oder E-Mail suchen…",+ "empty": "Keine passenden Kunden"+ }+ },+ "table": {+ "search_placeholder": "Nach Namen suchen…",+ "empty": "Noch keine Aktionen",+ "no_end": "Kein Enddatum"+ },+ "code": {+ "automatic": "Automatisch",+ "multi": "multi"+ },+ "basics_card": {+ "title": "Grundlagen"+ },+ "trigger_card": {+ "title": "Auslöser"+ },+ "schedule_card": {+ "title": "Zeitplan & Limits"+ },+ "trigger_summary": {+ "multi_code": "Gutschein mit mehreren Codes ({{count}} Codes)",+ "multi_code_with_prefix": "Gutschein mit mehreren Codes ({{count}} Codes mit Präfix „{{prefix}}“)",+ "show_codes": "Codes anzeigen",+ "single_code": "Einzelner Gutscheincode:",+ "locked_help": "Auslöser-Einstellungen können nach der Erstellung nicht geändert werden. Erstellen Sie eine neue Aktion, um sie zu ändern."+ },+ "remove_rule_confirm": {+ "title": "Regel entfernen?",+ "message": "Wird entfernt, sobald Sie die Aktion speichern."+ },+ "rule_summary": {+ "product_count": "{{count}} Produkte",+ "category_count": "{{count}} Kategorien",+ "customer_count": "{{count}} Kunden"+ },+ "rule_picker": {+ "title": "Regel hinzufügen",+ "description": "Wählen Sie einen Regeltyp zur Konfiguration."+ },+ "rule_edit": {+ "description": "Passen Sie die Parameter der Regel an.",+ "no_options": "Diese Regel hat keine konfigurierbaren Optionen – allein ihr Vorhandensein wendet die Einschränkung an."+ },+ "actions_card": {+ "description": "Was passiert, wenn die Aktion zutrifft.",+ "empty": "Noch keine Aktionen. Eine Aktion ohne Aktionen bewirkt nichts, wenn sie angewendet wird.",+ "add_action": "Aktion hinzufügen"+ },+ "remove_action_confirm": {+ "title": "Aktion entfernen?",+ "message": "Wird entfernt, sobald Sie die Aktion speichern."+ },+ "action_summary": {+ "variant_count": "{{count}} Varianten"+ },+ "action_picker": {+ "title": "Aktion hinzufügen",+ "description": "Wählen Sie, was passieren soll, wenn die Aktion zutrifft."+ },+ "action_edit": {+ "description": "Konfigurieren Sie die Parameter der Aktion.",+ "no_options": "Diese Aktion hat keine konfigurierbaren Optionen."+ },+ "coupon_codes": {+ "title": "Gutscheincodes",+ "description": "Automatisch generierte Codes für diese Aktion. Schreibgeschützt – neu generieren, indem Sie die Einstellung für die Anzahl der Codes ändern.",+ "description_with_count": "{{count}} automatisch generierte Codes. Schreibgeschützt – neu generieren, indem Sie die Einstellung für die Anzahl der Codes ändern.",+ "empty": "Noch keine Codes generiert.",+ "unused": "Ungenutzt",+ "used": "Genutzt",+ "export_csv": "CSV exportieren",+ "states": {+ "used": "Verwendet",+ "partially_used": "Teilweise verwendet"+ }+ },+ "rule_types": {+ "category": {+ "name": "Kategorien",+ "description": "Bestellung enthält Produkte aus den angegebenen Kategorien"+ },+ "country": {+ "name": "Land",+ "description": "Auf Bestellungen mit Lieferadresse in einem bestimmten Land beschränken"+ },+ "currency": {+ "name": "Währung",+ "description": "Auf Bestellungen in einer bestimmten Währung beschränken"+ },+ "customer": {+ "name": "Kunden",+ "description": "Nur für die angegebenen Kunden verfügbar"+ },+ "customer_group": {+ "name": "Kundengruppe(n)",+ "description": "Nur für Kunden in den angegebenen Kundengruppen verfügbar"+ },+ "customer_logged_in": {+ "name": "Nur angemeldete Kunden",+ "description": "Nur für angemeldete Kunden verfügbar"+ },+ "first_order": {+ "name": "Erste Bestellung",+ "description": "Muss die erste Bestellung des Kunden sein"+ },+ "item_total": {+ "name": "Warenwert",+ "description": "Bestellsumme erfüllt diese Kriterien"+ },+ "one_use_per_user": {+ "name": "Einmalige Nutzung pro Benutzer",+ "description": "Nur einmalige Nutzung pro Benutzer"+ },+ "option_value": {+ "name": "Optionswert(e)",+ "description": "Bestellung enthält Produkte mit übereinstimmenden Optionswerten"+ },+ "product": {+ "name": "Produkt(e)",+ "description": "Bestellung enthält die angegebenen Produkte"+ }+ },+ "action_types": {+ "create_adjustment": {+ "name": "Anpassung für gesamte Bestellung erstellen",+ "description": "Erstellt eine Aktionsgutschrift als Anpassung für die Bestellung"+ },+ "create_item_adjustments": {+ "name": "Anpassung je Bestellposition erstellen",+ "description": "Erstellt eine Aktionsgutschrift als Anpassung für eine Bestellposition"+ },+ "create_line_items": {+ "name": "Bestellpositionen erstellen",+ "description": "Fügt dem Warenkorb die angegebene Menge der Variante hinzu"+ },+ "free_shipping": {+ "name": "Kostenloser Versand",+ "description": "Macht alle Sendungen der Bestellung kostenlos"+ }+ },+ "messages": {+ "action_added": "Aktion hinzugefügt",+ "action_updated": "Aktion aktualisiert",+ "action_removed": "Aktion entfernt",+ "rule_added": "Regel hinzugefügt",+ "rule_updated": "Regel aktualisiert",+ "rule_removed": "Regel entfernt"+ },+ "errors": {+ "failed_to_add_action": "Aktion konnte nicht hinzugefügt werden",+ "failed_to_update_action": "Aktion konnte nicht aktualisiert werden",+ "failed_to_remove_action": "Aktion konnte nicht entfernt werden",+ "failed_to_add_rule": "Regel konnte nicht hinzugefügt werden",+ "failed_to_update_rule": "Regel konnte nicht aktualisiert werden",+ "failed_to_remove_rule": "Regel konnte nicht entfernt werden"+ }+ },+ "components": {+ "market_combobox": {+ "search_placeholder": "Märkte suchen…",+ "empty": "Keine passenden Märkte"+ },+ "custom_fields_card": {+ "set_up": "Einrichten",+ "empty_title": "Noch keine benutzerdefinierten Felder",+ "empty_description": "Erfassen Sie strukturierte Details wie Material, Passform oder Pflegehinweise.",+ "not_yet_set": "{{count}} von {{total}} noch nicht festgelegt"+ },+ "custom_fields": {+ "title": "Benutzerdefinierte Felder",+ "new_definition_title": "Neues benutzerdefiniertes Feld",+ "definition_created_title": "Definition erstellt",+ "definition_created_toast": "Definition erstellt",+ "definition_created_hint": "Sie können den Wert jetzt festlegen oder zunächst ein weiteres Feld definieren.",+ "empty_title": "Keine benutzerdefinierten Felder für {{resource}} definiert",+ "empty_description": "Definieren Sie ein benutzerdefiniertes Feld, um typisierte, strukturierte Informationen zusammen mit Ihren Datensätzen zu speichern.",+ "create_definition": "Definition erstellen",+ "values_saved": "Benutzerdefinierte Felder gespeichert",+ "values_save_failed": "Benutzerdefinierte Felder konnten nicht gespeichert werden",+ "admin_only": "Nur für Administratoren",+ "add_another_field": "Weiteres Feld hinzufügen",+ "create_another": "Weiteres erstellen",+ "set_values": "Werte festlegen"+ },+ "adjustment_action_editor": {+ "calculator_label": "Kalkulator",+ "loading_calculators": "Kalkulatoren werden geladen…",+ "select_calculator": "Kalkulator auswählen",+ "no_extra_settings": "Dieser Kalkulator hat keine zusätzlichen Einstellungen.",+ "settings_label": "Kalkulator-Einstellungen"+ }+ },+ "pages": {+ "home": {+ "top_products": "Top-Produkte",+ "top_products_description": "Meistverkaufte Produkte in Ihrem Shop.",+ "title": "Dashboard",+ "subtitle": "Überblick über die Leistung Ihres Shops",+ "metrics": {+ "sales": "Gesamtumsatz",+ "orders": "Bestellungen gesamt",+ "avg_order_value": "Ø Bestellwert"+ },+ "metric_short": {+ "sales": "Umsatz",+ "orders": "Bestellungen",+ "avg_order_value": "Ø-Wert"+ },+ "columns": {+ "product": "Produkt",+ "price": "Preis",+ "sold": "Verkauft"+ }+ },+ "staff": {+ "title": "Team",+ "subtitle": "Admin-Teammitglieder und Rollen verwalten",+ "invite_cta": "Teammitglied einladen",+ "members_section": "Mitglieder",+ "invitations_section": "Ausstehende Einladungen",+ "empty": "Noch keine Teammitglieder",+ "empty_description": "Laden Sie ein Teammitglied ein, um an diesem Shop mitzuarbeiten.",+ "table": {+ "member": "Mitglied",+ "roles": "Rollen",+ "role": "Rolle"+ },+ "invite_sheet": {+ "title": "Teammitglied einladen",+ "description": "Wir senden ihm einen Link per E-Mail, um sein Passwort festzulegen."+ },+ "edit_sheet": {+ "title": "Teammitglied bearbeiten"+ },+ "actions": {+ "resend": "Erneut senden",+ "remove": "Aus Team entfernen"+ },+ "messages": {+ "revoked": "Einladung widerrufen",+ "updated": "Team aktualisiert",+ "removed": "Aus Team entfernt"+ }+ },+ "channels": {+ "title": "Verkaufskanäle",+ "empty_message": "Noch keine Verkaufskanäle",+ "add_cta": "Neuer Verkaufskanal",+ "add_sheet_title": "Verkaufskanal hinzufügen",+ "edit_sheet_title": "Verkaufskanal bearbeiten",+ "create_label": "Verkaufskanal erstellen",+ "create_description": "Verkaufskanäle gruppieren Bestellungen und Produktlistings — \"online\", \"pos\", eine Marktplatz-Integration usw.",+ "edit_description": "Benennen Sie einen Verkaufskanal um oder pausieren Sie ihn. Inaktive Verkaufskanäle nehmen keine Bestellungen mehr an.",+ "delete_confirm": {+ "title": "Verkaufskanal löschen?",+ "message": "{{name}} wird entfernt. Damit verknüpfte Produkte und Bestellungen verlieren ihre Verkaufskanal-Referenz."+ },+ "search_placeholder": "Verkaufskanäle suchen…",+ "no_channels_found": "Keine Verkaufskanäle gefunden"+ },+ "customers": {+ "new_cta": "Neuer Kunde",+ "create_label": "Kunde erstellen",+ "edit_sheet_title": "Kunde bearbeiten",+ "groups_cta": "Kundengruppen",+ "groups": {+ "title": "Kundengruppen",+ "add_cta": "Kundengruppe hinzufügen",+ "edit_sheet_title": "Kundengruppe bearbeiten",+ "add_sheet_title": "Kundengruppe hinzufügen"+ },+ "detail": {+ "stat_total_spent": "Gesamtausgaben",+ "stat_orders": "Bestellungen",+ "stat_avg_order_value": "Durchschn. Bestellwert",+ "section_profile": "Profil",+ "section_addresses": "Adressen",+ "section_orders": "Bestellungen",+ "section_store_credit": "Guthaben",+ "section_internal_note": "Interne Notiz",+ "section_tags": "Tags",+ "addresses_empty": "Keine Adressen hinterlegt.",+ "orders_empty": "Noch keine Bestellungen.",+ "store_credit_empty": "Kein Guthaben ausgegeben.",+ "add_address": "Adresse hinzufügen",+ "edit_address": "Adresse bearbeiten",+ "issue_credit": "Guthaben ausstellen",+ "edit_credit": "Guthaben bearbeiten"+ }+ },+ "orders": {+ "drafts_title": "Bestellentwürfe",+ "new": {+ "title": "Neue Bestellung",+ "section_customer": "Kunde",+ "section_items": "Artikel",+ "section_billing": "Rechnung",+ "section_notes": "Notizen",+ "section_summary": "Zusammenfassung",+ "add_line_item": "Position hinzufügen",+ "select_customer": "Kunde auswählen",+ "search_variant": "Variante suchen…"+ },+ "detail": {+ "section_summary": "Zusammenfassung",+ "section_items": "Artikel",+ "section_payments": "Zahlungen",+ "section_shipments": "Sendungen",+ "section_customer": "Kunde",+ "section_shipping_address": "Lieferadresse",+ "section_billing_address": "Rechnungsadresse",+ "section_internal_note": "Interne Notiz",+ "section_customer_note": "Kundennotiz",+ "section_history": "Verlauf",+ "summary": {+ "created_by": "Erstellt von",+ "market": "Markt",+ "locale": "Sprache",+ "channel": "Verkaufskanal",+ "ip_address": "IP-Adresse"+ },+ "empty_payments": "Noch keine Zahlungen.",+ "empty_shipments": "Noch keine Sendungen.",+ "empty_history": "Noch kein Verlauf.",+ "actions": {+ "approve": "Genehmigen",+ "cancel": "Bestellung stornieren",+ "resume": "Fortsetzen",+ "refund": "Erstatten",+ "capture": "Einziehen",+ "void": "Stornieren",+ "mark_paid": "Als bezahlt markieren",+ "ship": "Als versendet markieren"+ },+ "dialogs": {+ "cancel_title": "Bestellung stornieren?",+ "approve_title": "Bestellung genehmigen?",+ "refund_title": "Zahlung erstatten?"+ }+ }+ },+ "products": {+ "add_cta": "Produkt hinzufügen",+ "new": {+ "title": "Neues Produkt",+ "description": "Richten Sie Ihr Produkt ein — fügen Sie Varianten, Preise, Bestand, Medien und benutzerdefinierte Felder hinzu und speichern Sie einmalig.",+ "save_label": "Produkt erstellen",+ "create_succeeded": "Produkt erstellt",+ "create_failed": "Produkt konnte nicht erstellt werden",+ "preview_slug_placeholder": "ihr-produkt-slug"+ },+ "edit": {+ "bulk_prices": {+ "no_variants": "Fügen Sie mindestens eine Variante hinzu, um die Preisbearbeitung zu starten."+ }+ },+ "section_basics": "Grunddaten",+ "section_media": "Medien",+ "section_pricing": "Preisgestaltung",+ "section_inventory": "Bestand",+ "section_seo": "SEO",+ "section_categorization": "Kategorisierung",+ "section_organization": "Organisation",+ "section_variants": "Varianten",+ "section_custom_fields": "Benutzerdefinierte Felder",+ "publishing": {+ "title": "Veröffentlichung",+ "manage_cta": "Verwalten",+ "manage_title": "Verkaufskanäle verwalten",+ "manage_description": "Wählen Sie aus, welche Verkaufskanäle dieses Produkt listen. Deaktivieren Sie einen Kanal, um es überall auszulisten.",+ "empty": "Noch auf keinem Verkaufskanal gelistet.",+ "no_channels": "Keine Verkaufskanäle verfügbar. Erstellen Sie einen unter Einstellungen → Verkaufskanäle.",+ "inactive_marker": "Inaktiv",+ "status_live": "Live",+ "status_scheduled": "Geplant",+ "status_hidden": "Ausgeblendet",+ "status_not_available": "Nicht verfügbar",+ "caption_live": "Jetzt für Kunden sichtbar",+ "caption_scheduled": "Geht am {{date}} live",+ "caption_hidden_after": "Wird am {{date}} ausgeblendet",+ "caption_unpublished": "Wurde am {{date}} ausgeblendet",+ "caption_window": "Live {{start}} → {{end}}",+ "caption_not_available": "Ausgeblendet — Produkt ist {{product_status}}"+ },+ "clone_succeeded": "Produkt dupliziert",+ "clone_failed": "Produkt konnte nicht dupliziert werden",+ "delete_succeeded": "Produkt gelöscht",+ "delete_failed": "Produkt konnte nicht gelöscht werden",+ "bulk": {+ "set_status_action": "Status festlegen…",+ "add_categories_action": "Zu Kategorien hinzufügen…",+ "remove_categories_action": "Aus Kategorien entfernen…",+ "add_channels_action": "Zu Verkaufskanälen hinzufügen…",+ "remove_channels_action": "Aus Verkaufskanälen entfernen…",+ "add_tags_action": "Tags hinzufügen…",+ "remove_tags_action": "Tags entfernen…",+ "status_sheet_title": "Produktstatus festlegen",+ "status_sheet_description": "Wählen Sie den Status, der auf die ausgewählten Produkte angewendet werden soll.",+ "categories_add_title": "Zu Kategorien hinzufügen",+ "categories_add_description": "Wählen Sie die Kategorien, zu denen diese Produkte hinzugefügt werden sollen.",+ "categories_remove_title": "Aus Kategorien entfernen",+ "categories_remove_description": "Wählen Sie die Kategorien, aus denen diese Produkte entfernt werden sollen.",+ "channels_add_title": "Zu Verkaufskanälen hinzufügen",+ "channels_add_description": "Wählen Sie die Verkaufskanäle, auf denen diese Produkte gelistet werden sollen.",+ "channels_remove_title": "Aus Verkaufskanälen entfernen",+ "channels_remove_description": "Wählen Sie die Verkaufskanäle, von denen diese Produkte ausgelistet werden sollen.",+ "tags_add_title": "Tags hinzufügen",+ "tags_add_description": "Wählen oder erstellen Sie Tags, die zu diesen Produkten hinzugefügt werden sollen.",+ "tags_remove_title": "Tags entfernen",+ "tags_remove_description": "Wählen Sie Tags, die von diesen Produkten entfernt werden sollen.",+ "delete_confirm": {+ "title": "{n} Produkte löschen?",+ "message": "Ausgewählte Produkte werden entfernt. Diese Aktion kann nicht rückgängig gemacht werden."+ },+ "status_updated": "Status für {n} Produkte aktualisiert",+ "status_update_failed": "Produktstatus konnte nicht aktualisiert werden",+ "categories_added": "{n} Produkte zu Kategorien hinzugefügt",+ "categories_add_failed": "Produkte konnten nicht zu Kategorien hinzugefügt werden",+ "categories_removed": "{n} Produkte aus Kategorien entfernt",+ "categories_remove_failed": "Produkte konnten nicht aus Kategorien entfernt werden",+ "channels_added": "{n} Produkte auf Verkaufskanälen gelistet",+ "channels_add_failed": "Produkte konnten nicht auf Verkaufskanälen gelistet werden",+ "channels_removed": "{n} Produkte von Verkaufskanälen ausgelistet",+ "channels_remove_failed": "Produkte konnten nicht von Verkaufskanälen ausgelistet werden",+ "tags_added": "Tags zu {n} Produkten hinzugefügt",+ "tags_add_failed": "Tags konnten nicht hinzugefügt werden",+ "tags_removed": "Tags von {n} Produkten entfernt",+ "tags_remove_failed": "Tags konnten nicht entfernt werden",+ "deleted": "{n} Produkte gelöscht",+ "delete_failed": "Produkte konnten nicht gelöscht werden"+ },+ "media_empty": "Noch keine Medien.",+ "media_upload": "Medien hochladen",+ "variants_empty": "Noch keine Varianten.",+ "status_options": {+ "draft": "Entwurf",+ "archived": "Archiviert"+ },+ "inventory": {+ "out_of_stock": "Nicht auf Lager",+ "on_backorder": "Im Rückstand",+ "in_stock": "{{count}} auf Lager"+ },+ "variants_one": "{{count}} Variante",+ "variants_other": "{{count}} Varianten",+ "transfers": {+ "sheet_title": "Neue Bestandsübertragung",+ "edit_sheet_title": "Übertragung {{number}}",+ "description_internal": "Bestand verschoben von <strong>{{source}}</strong> nach <strong>{{destination}}</strong>.",+ "description_external": "Externer Wareneingang in <strong>{{destination}}</strong>.",+ "section_from": "Von",+ "section_to": "Nach",+ "section_items": "Artikel",+ "items_empty": "Noch keine Artikel."+ },+ "options": {+ "sheet_title_create": "Optionstyp erstellen",+ "sheet_title_edit": "Optionstyp bearbeiten",+ "values_section": "Werte",+ "values_empty": "Noch keine Werte.",+ "add_value": "Optionswert hinzufügen",+ "table": {+ "values": "Werte"+ }+ },+ "price_lists": {+ "title": "Preislisten",+ "subtitle": "Gezielte Preisgestaltung für Kundengruppen, Regionen oder Mengenstaffeln.",+ "add_cta": "Neue Preisliste",+ "sheet_title_create": "Preisliste erstellen",+ "sheet_title_edit": "Preisliste bearbeiten",+ "delete_confirm": {+ "title": "Preisliste löschen?",+ "message": "Beim Entfernen von \"{{name}}\" werden ihre Preise gelöscht. Dies kann nicht rückgängig gemacht werden."+ },+ "activate": "Aktivieren",+ "deactivate": "Deaktivieren",+ "schedule": "Planen",+ "unschedule": "Planung aufheben",+ "edit_prices_cta": "Preise bearbeiten",+ "add_products_cta": "Produkte hinzufügen",+ "remove_selected": "Auswahl entfernen",+ "basics_section": "Grunddaten",+ "schedule_section": "Zeitplan",+ "products_section": "Produkte",+ "rules_section": "Regeln",+ "add_rule": "Regel hinzufügen",+ "rule_click_to_configure": "Zum Konfigurieren klicken",+ "rule_no_options": "Diese Regel hat keine konfigurierbaren Optionen — ihre bloße Existenz wendet die Einschränkung an.",+ "rule_name_overflow": "{{names}} +{{count}} weitere",+ "remove_rule_confirm": {+ "title": "Regel entfernen?",+ "message": "Die Regel wird entfernt, wenn Sie die Preisliste speichern."+ },+ "rules_help": "Bedingungen, die festlegen, wann diese Liste angewendet wird. Verwenden Sie \"alle\", um jede Regel zu erfordern, \"beliebige\", um die erste Übereinstimmung zu nehmen.",+ "rules_empty": "Keine Regeln — diese Liste gilt für jeden Käufer.",+ "add_rule_help": "Wählen Sie einen Regeltyp zum Konfigurieren.",+ "rule_types_empty": "Keine Regeltypen registriert.",+ "rule_types_all_used": "Jeder verfügbare Regeltyp befindet sich bereits auf dieser Liste.",+ "rule_default_description": "Passen Sie die Parameter der Regel an.",+ "products_help": "Wählen Sie die Produkte, für die diese Liste gilt. Platzhalterpreise werden beim Speichern erstellt — füllen Sie sie unten aus.",+ "products_search_placeholder": "Produkte nach Namen suchen…",+ "products_empty_search": "Keine passenden Produkte",+ "products_selected_one": "{{count}} Produkt ausgewählt.",+ "products_selected_other": "{{count}} Produkte ausgewählt.",+ "prices_help_one": "{{count}} Preis konfiguriert. Öffnen Sie den Mehrfacheditor, um ihn zu aktualisieren.",+ "prices_help_other": "{{count}} Preise konfiguriert. Öffnen Sie den Mehrfacheditor, um sie zu aktualisieren.",+ "prices_help_zero": "Wählen Sie oben Produkte aus, um Platzhalterpreise anzulegen, und öffnen Sie dann den Mehrfacheditor.",+ "activate_confirm": {+ "title": "Preisliste aktivieren?",+ "message": "\"{{name}}\" gilt ab sofort für berechtigte Kunden und bleibt aktiv, bis sie manuell deaktiviert wird.",+ "message_with_end": "\"{{name}}\" gilt ab sofort für berechtigte Kunden und bleibt aktiv, bis sie manuell deaktiviert wird oder ihr Enddatum ({{ends_at}}) erreicht ist."+ },+ "schedule_confirm": {+ "title": "Preisliste planen?",+ "message": "\"{{name}}\" geht am {{starts_at}} live und bleibt bis zum Enddatum aktiv."+ },+ "deactivate_confirm": {+ "title": "Preisliste deaktivieren?",+ "message": "\"{{name}}\" gilt ab sofort nicht mehr für Kunden. Bestehende Bestellungen sind nicht betroffen."+ },+ "unschedule_confirm": {+ "title": "Planung der Preisliste aufheben?",+ "message": "\"{{name}}\" wird am geplanten Datum nicht mehr aktiviert. Sie können sie später erneut planen oder manuell aktivieren."+ },+ "edit_prices": {+ "title": "Preise bearbeiten — {{name}}",+ "currency_label": "Währung",+ "empty": "Noch keine Produkte in dieser Liste.",+ "add_products_link": "Produkte hinzufügen",+ "columns": {+ "product": "Produkt",+ "variant": "Variante",+ "sku": "SKU",+ "price": "Preis",+ "compare_at_price": "Vergleichspreis"+ },+ "variant_default": "Standard",+ "grid_aria": "Variantenpreise",+ "search_placeholder": "Nach Produkt, SKU oder Option suchen…",+ "price_aria": "Preis für {{label}}",+ "compare_at_aria": "Vergleichspreis für {{label}}",+ "save_cta": "Preise speichern",+ "save_success_one": "{{count}} Preis gespeichert",+ "save_success_other": "{{count}} Preise gespeichert",+ "save_failed": "Preise konnten nicht gespeichert werden",+ "count_summary_one": "{{count}} Preis in {{currency}}",+ "count_summary_other": "{{count}} Preise in {{currency}}",+ "no_matches_for_filters": "Keine Preise entsprechen den aktuellen Filtern.",+ "no_matches_for_search": "Keine Preise entsprechen \"{{search}}\".",+ "empty_pick_products": "Wählen Sie Produkte auf der Preisliste aus, um mit der Preisfestlegung zu beginnen.",+ "empty_no_base_prices": "Noch keine Basispreise.",+ "dirty_summary_one": "{{count}} ungespeicherte Änderung",+ "dirty_summary_other": "{{count}} ungespeicherte Änderungen",+ "discard_confirm": {+ "title": "Ungespeicherte Preise verwerfen?",+ "message_close_one": "Sie haben {{count}} ungespeicherten Preis. Beim Schließen wird er verworfen.",+ "message_close_other": "Sie haben {{count}} ungespeicherte Preise. Beim Schließen werden sie verworfen.",+ "message_currency": "Beim Wechsel der Währung werden Ihre ungespeicherten Preise verworfen."+ }+ },+ "products_empty": "Noch keine Produkte — fügen Sie eins hinzu, um die Preisbearbeitung zu starten.",+ "no_changes": "Keine Änderungen zum Speichern."+ }+ },+ "settings": {+ "store": {+ "title": "Shop-Einstellungen",+ "subtitle": "Allgemeine Konfiguration und shopweite Standardwerte.",+ "tab_general": "Allgemein",+ "tab_standards": "Standards und Formate"+ },+ "emails": {+ "title": "E-Mail-Einstellungen",+ "subtitle": "Absenderadressen, Benachrichtigungen und das in Transaktions-E-Mails eingebettete Logo.",+ "section_delivery": "Zustellung",+ "section_addresses": "E-Mail-Adressen",+ "section_logo": "Logo",+ "logo_dimensions_help": "Empfohlen: 204×104 Pixel.",+ "logo_upload_cta": "Logo hochladen",+ "logo_replace_cta": "Logo ersetzen",+ "logo_remove_cta": "Logo entfernen",+ "logo_uploading": "Wird hochgeladen…",+ "logo_upload_failed": "Logo konnte nicht hochgeladen werden.",+ "load_failed_title": "E-Mail-Einstellungen konnten nicht geladen werden"+ },+ "webhooks": {+ "title": "Webhooks",+ "subtitle": "Abonnieren Sie HTTPS-Endpunkte für Ereignisse, die von Ihrem Shop ausgelöst werden.",+ "search_placeholder": "Nach URL suchen…",+ "new_cta": "Neuer Endpunkt",+ "empty_title": "Noch keine Webhook-Endpunkte",+ "empty_description": "Erstellen Sie einen Endpunkt, um bei jedem abonnierten Ereignis einen signierten POST zu erhalten.",+ "add_sheet_title": "Webhook-Endpunkt hinzufügen",+ "edit_sheet_title": "Webhook-Endpunkt bearbeiten",+ "deliveries_sheet_title": "Letzte Zustellungen",+ "delete_confirm": {+ "title": "Webhook-Endpunkt löschen?",+ "message": "{{name}} erhält ab sofort keine Zustellungen mehr. Der bisherige Zustellverlauf wird ebenfalls entfernt."+ },+ "detail": {+ "load_failed_title": "Dieser Webhook-Endpunkt konnte nicht geladen werden",+ "delete_label": "Endpunkt löschen",+ "details_title": "Details",+ "edit_title": "Endpunkt bearbeiten",+ "url": "Ziel-URL",+ "subscriptions": "Ereignisse"+ },+ "save_secret_title": "Speichern Sie Ihr Signaturgeheimnis",+ "save_secret_description": "Verifizieren Sie eingehende Webhook-Signaturen mit diesem Schlüssel. Wir zeigen ihn nicht erneut an.",+ "actions": {+ "send_test": "Test senden",+ "disable": "Deaktivieren",+ "enable": "Wieder aktivieren",+ "view_deliveries": "Zustellungen anzeigen",+ "redeliver": "Erneut zustellen"+ },+ "status": {+ "inactive": "Inaktiv",+ "disabled": "Automatisch deaktiviert",+ "disabled_reason": "Deaktiviert: {{reason}}"+ },+ "health": {+ "label": "Zustand",+ "healthy": "Gesund ({{percentage}} %)",+ "degraded": "Beeinträchtigt ({{percentage}} %)",+ "failing": "Fehlerhaft ({{percentage}} %)",+ "disabled": "Deaktiviert",+ "no_deliveries": "Noch keine Zustellungen",+ "auto_disabled_alert": "Dieser Endpunkt wurde nach wiederholten Zustellfehlern automatisch deaktiviert.",+ "re_enable_cta": "Wieder aktivieren",+ "metric_total": "Zustellungen",+ "metric_successful": "Erfolgreich",+ "metric_failed": "Fehlgeschlagen",+ "row_counters_successful_one": "{{count}} erfolgreich",+ "row_counters_successful_other": "{{count}} erfolgreich",+ "row_counters_failed_one": "{{count}} fehlgeschlagen",+ "row_counters_failed_other": "{{count}} fehlgeschlagen"+ },+ "table": {+ "url": "URL",+ "events": "Ereignisse",+ "recent_deliveries": "Letzte 7 Tage",+ "last_delivery": "Letzte Zustellung",+ "copy_url_aria": "URL kopieren"+ },+ "events_all": "Alle Ereignisse",+ "events_count_one": "{{count}} Ereignis",+ "events_count_other": "{{count}} Ereignisse",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "{{event}} entfernen",+ "event_groups": {+ "asset": "Asset",+ "custom": "Benutzerdefiniert",+ "customer": "Kunde",+ "digital": "Digital",+ "gift_card": "Geschenkkarte",+ "gift_card_batch": "Geschenkkarten-Stapel",+ "import_export": "Import / Export",+ "invitation": "Einladung",+ "line_item": "Position",+ "newsletter_subscriber": "Newsletter-Abonnent",+ "order": "Bestellung",+ "payment": "Zahlung",+ "payment_session": "Zahlungssitzung",+ "payment_setup_session": "Zahlungseinrichtungssitzung",+ "price": "Preis",+ "product": "Produkt",+ "promotion": "Aktion",+ "refund": "Erstattung",+ "report": "Bericht",+ "return": "Rücksendung",+ "shipment": "Sendung",+ "stock_item": "Bestandsartikel",+ "stock_movement": "Bestandsbewegung",+ "stock_reservation": "Bestandsreservierung",+ "stock_transfer": "Bestandsübertragung",+ "store_credit": "Guthaben",+ "variant": "Variante",+ "wishlist": "Wunschliste"+ },+ "deliveries": {+ "table": {+ "event": "Ereignis",+ "code": "Antwort",+ "execution_time": "Dauer",+ "delivered_at": "Zugestellt am"+ },+ "status": {+ "pending": "Ausstehend",+ "success": "Erfolgreich",+ "failure": "Fehlgeschlagen",+ "error": "Fehler"+ },+ "empty": "Noch keine Zustellungen — senden Sie einen Test, um Ihren Endpunkt zu verifizieren.",+ "search_placeholder": "Nach Ereignisnamen suchen…",+ "test_sent": "Test-Webhook in Warteschlange gestellt.",+ "test_failed": "Test-Webhook konnte nicht gesendet werden.",+ "redeliver_queued": "Erneute Zustellung in Warteschlange gestellt.",+ "detail_sheet_title": "Zustelldetails",+ "detail": {+ "event": "Ereignis",+ "url": "Ziel-URL",+ "delivered_at": "Zugestellt am",+ "response_code": "Antwortcode",+ "execution_time": "Ausführungszeit",+ "error_type": "Fehlertyp",+ "request_errors": "Transportfehler",+ "request_payload": "Anfrage-Payload",+ "response_body": "Antworttext",+ "response_body_truncated": "Der Antworttext wurde auf {{limit}} Zeichen gekürzt.",+ "copy_payload_aria": "Anfrage-Payload kopieren",+ "copy_response_aria": "Antworttext kopieren"+ }+ }+ },+ "api_keys": {+ "title": "API-Schlüssel",+ "subtitle": "Autorisieren Sie Integrationen und Apps für den Zugriff auf die Admin-API.",+ "publishable_section": "Veröffentlichbare Schlüssel",+ "publishable_help": "Wird von Ihrem Storefront verwendet. Kann gefahrlos im clientseitigen Code offengelegt werden.",+ "secret_section": "Geheime Schlüssel",+ "secret_help": "Nur Server-zu-Server. Beschränken Sie jeden Schlüssel auf die benötigten Operationen.",+ "new_cta": "Neuer Schlüssel",+ "empty_publishable": "Noch keine veröffentlichbaren Schlüssel.",+ "empty_secret": "Noch keine geheimen Schlüssel.",+ "table": {+ "key": "Schlüssel",+ "scopes": "Berechtigungen",+ "last_used_at": "Zuletzt verwendet"+ },+ "save_secret_title": "Speichern Sie Ihren geheimen Schlüssel",+ "save_secret_description": "Kopieren Sie diesen Wert jetzt — wir zeigen ihn nicht erneut an.",+ "scope_badge": {+ "full_access": "Vollzugriff",+ "read_all": "Alles lesen"+ }+ },+ "payment_methods": {+ "add_sheet_title": "Zahlungsmethode hinzufügen",+ "edit_sheet_title": "Zahlungsmethode bearbeiten"+ },+ "tax_categories": {+ "add_sheet_title": "Steuerkategorie hinzufügen",+ "edit_sheet_title": "Steuerkategorie bearbeiten"+ },+ "markets": {+ "add_sheet_title": "Markt hinzufügen",+ "edit_sheet_title": "Markt bearbeiten"+ },+ "custom_field_definitions": {+ "add_sheet_title": "Benutzerdefiniertes Feld hinzufügen",+ "edit_sheet_title": "Benutzerdefiniertes Feld bearbeiten"+ },+ "stock_locations": {+ "add_sheet_title": "Lagerstandort hinzufügen",+ "edit_sheet_title": "Lagerstandort bearbeiten",+ "search_placeholder": "Lagerstandorte suchen…"+ },+ "allowed_origins": {+ "add_sheet_title": "Erlaubten Ursprung hinzufügen",+ "edit_sheet_title": "Erlaubten Ursprung bearbeiten"+ }+ },+ "promotions": {+ "new_title": "Neue Aktion",+ "create_cta": "Aktion erstellen",+ "loading": "Aktion wird geladen…",+ "gift_cards": {+ "new_sheet_title": "Neue Geschenkkarte",+ "edit_sheet_title": "Geschenkkarte",+ "not_found": "Geschenkkarte nicht gefunden.",+ "new_cta": "Neue Geschenkkarte",+ "create_label": "Geschenkkarte erstellen",+ "batch_section": "Stapel",+ "create_batch_cta": "{{count}} Geschenkkarten erstellen",+ "status_options": {+ "redeemed": "Eingelöst",+ "expired": "Abgelaufen",+ "void": "Storniert"+ },+ "sheet": {+ "create_description": "Stellen Sie eine einzelne Geschenkkarte aus oder generieren Sie einen Stapel mit automatisch generierten Codes.",+ "edit_description": "Aktualisieren Sie den Kunden oder das Ablaufdatum der Geschenkkarte. Code und Betrag sind nach der Ausstellung unveränderlich."+ },+ "delete_confirm": {+ "title": "Geschenkkarte löschen?",+ "message": "Dadurch wird die Geschenkkarte storniert und kann nicht mehr eingelöst werden."+ },+ "validation": {+ "amount_positive": "Der Betrag muss größer als null sein",+ "amount_required": "Der Betrag ist erforderlich",+ "prefix_required": "Für Stapel ist ein Präfix erforderlich",+ "currency_required": "Die Währung ist erforderlich"+ },+ "prefix": {+ "label": "Präfix",+ "placeholder": "z. B. WELCOME — Codes lauten dann WELCOME-abc123",+ "auto_placeholder": "Wird automatisch generiert, wenn leer"+ },+ "no_customer": "Kein Kunde zugeordnet",+ "usage": {+ "title": "Nutzung",+ "used": "Verwendet",+ "remaining": "Verbleibend",+ "issued_by": "Ausgestellt von"+ }+ }+ },+ "profile": {+ "title": "Profil",+ "subtitle": "Verwalten Sie Ihre persönlichen Daten und Ihre Admin-Sprache.",+ "personal_details": "Persönliche Daten",+ "load_failed_title": "Ihr Profil konnte nicht geladen werden"+ }+ },+ "invitation": {+ "missing_token_title": "Einladungs-Token fehlt",+ "missing_token_message": "Dieser Link scheint unvollständig zu sein. Bitten Sie die Person, die Sie eingeladen hat, ihn erneut zu senden.",+ "loading": "Einladung wird geladen…",+ "not_found_title": "Einladung nicht gefunden",+ "not_found_message": "Diese Einladung ist abgelaufen, wurde widerrufen oder bereits angenommen. Bitten Sie die einladende Person, eine neue zu senden.",+ "generic_error_title": "Einladung konnte nicht geladen werden",+ "generic_error_message": "Etwas ist schiefgelaufen. Bitte versuchen Sie es erneut.",+ "join_store": "{{store}} beitreten",+ "invited_by": "{{email}} hat Sie eingeladen",+ "invited_generic": "Sie wurden eingeladen",+ "invited_as_role": " als {{role}}",+ "sign_in_to_accept": ". Melden Sie sich an, um anzunehmen.",+ "create_to_accept": ". Erstellen Sie Ihr Konto, um anzunehmen.",+ "could_not_accept": "Einladung konnte nicht angenommen werden",+ "accepting": "Wird angenommen…",+ "sign_in_and_accept": "Anmelden & annehmen",+ "create_and_accept": "Konto erstellen & annehmen"+ },+ "staff": {+ "actions": {+ "copy_invitation_link": "Einladungslink kopieren",+ "invitation_link_copied": "Einladungslink kopiert"+ },+ "autocomplete": {+ "placeholder": "Mitarbeiter suchen…",+ "empty": "Keine Mitarbeiter gefunden"+ },+ "confirm": {+ "remove_title": "Aus Shop entfernen?",+ "remove_message": "{{name}} verliert den Zugriff auf diesen Shop.",+ "revoke_title": "Einladung zurückziehen?",+ "revoke_message": "{{email}} kann diese Einladung nicht mehr annehmen."+ },+ "errors": {+ "failed_to_remove": "Mitarbeiter konnte nicht entfernt werden",+ "failed_to_resend": "Einladung konnte nicht erneut gesendet werden",+ "failed_to_revoke": "Einladung konnte nicht zurückgezogen werden"+ },+ "invite": {+ "email_placeholder": "[email protected]",+ "roles_loading": "Rollen werden geladen…",+ "roles_placeholder": "Rolle auswählen",+ "no_roles": "Keine Rollen verfügbar."+ },+ "edit": {+ "roles_label": "Rollen für diesen Shop"+ },+ "edit_description": "Aktualisieren Sie die Profildaten und zugewiesenen Rollen für diesen Mitarbeiter.",+ "actions_aria": "Aktionen"+ },+ "api_keys": {+ "empty_description": "Erstellen Sie einen, um zu beginnen.",+ "create_sheet_title": "API-Schlüssel erstellen",+ "create_sheet_description": "Wählen Sie einen Schlüsseltyp und anschließend die Berechtigungen aus, die er verwenden darf.",+ "edit_sheet_title": "API-Schlüssel bearbeiten",+ "edit_sheet_description": "Benennen Sie diesen Schlüssel um. Die Berechtigungen werden bei der Erstellung eines Schlüssels festgelegt und können nicht geändert werden.",+ "scopes_immutable_help": "Berechtigungen können nach der Erstellung eines Schlüssels nicht mehr geändert werden. Um sie zu ändern, erstellen Sie einen neuen Schlüssel mit den benötigten Berechtigungen und widerrufen Sie diesen.",+ "key_type": {+ "secret_title": "Geheimer Schlüssel",+ "secret_description": "Server-zu-Server. Jeder Schlüssel führt eine explizite Liste von Berechtigungen.",+ "publishable_title": "Veröffentlichbarer Schlüssel",+ "publishable_description": "Kann gefahrlos im clientseitigen Code offengelegt werden. Gewährt öffentlichen/Gast-Zugriff."+ },+ "scope_picker": {+ "resource_header": "Ressource",+ "read_header": "Lesen",+ "write_header": "Schreiben",+ "read_aria": "{{resource}} lesen",+ "write_aria": "{{resource}} schreiben",+ "full_access_label": "Vollzugriff (write_all)",+ "read_all_label": "Alles lesen (read_all)",+ "resources": {+ "orders": "Bestellungen",+ "products": "Produkte",+ "promotions": "Aktionen",+ "customers": "Kunden",+ "payments": "Zahlungen",+ "fulfillments": "Fulfillments",+ "refunds": "Rückerstattungen",+ "gift_cards": "Geschenkkarten",+ "store_credits": "Guthaben",+ "stock": "Bestand",+ "categories": "Kategorien",+ "settings": "Einstellungen",+ "webhooks": "Webhooks",+ "api_keys": "API-Schlüssel",+ "dashboard": "Dashboard"+ },+ "full_access_hint": "– Lesen + Schreiben für jede Ressource",+ "read_all_hint": "– Lesen für jede Ressource",+ "show_more_aria_one": "{{count}} weiteren Geltungsbereich anzeigen",+ "show_more_aria_other": "{{count}} weitere Geltungsbereiche anzeigen"+ },+ "warning_treat_like_password": "Behandeln Sie diesen Schlüssel wie ein Passwort. Speichern Sie ihn in Ihrem Secrets-Manager – wir können ihn nicht erneut anzeigen.",+ "revoke_confirm": {+ "title": "Schlüssel widerrufen?",+ "message": "Jede Integration, die diesen Schlüssel verwendet, funktioniert sofort nicht mehr."+ },+ "delete_confirm": {+ "title": "Schlüssel löschen?",+ "message": "Dadurch wird der Schlüssel dauerhaft entfernt. Bevorzugen Sie das Widerrufen, falls Sie den Zugriff später wiederherstellen möchten."+ },+ "dropdown": {+ "revoke": "Schlüssel widerrufen",+ "copy_token_aria": "Token kopieren"+ },+ "badge": {+ "revoked": "Widerrufen",+ "never_used": "Nie"+ },+ "errors": {+ "failed_to_delete": "Schlüssel konnte nicht gelöscht werden",+ "failed_to_update": "Schlüssel konnte nicht aktualisiert werden",+ "failed_to_create": "Schlüssel konnte nicht erstellt werden"+ },+ "by_email": "von {{email}}",+ "create_key_cta": "Schlüssel erstellen",+ "validation": {+ "scope_required": "Wählen Sie mindestens einen Geltungsbereich aus"+ }+ },+ "customers": {+ "groups": {+ "bulk_add_action": "Zu Gruppe hinzufügen…",+ "bulk_remove_action": "Aus Gruppe entfernen…",+ "bulk_added": "{{count}} Kunden zu Gruppen hinzugefügt",+ "bulk_removed": "{{count}} Kunden aus Gruppen entfernt",+ "bulk_add_failed": "Kunden konnten nicht zu Gruppen hinzugefügt werden",+ "bulk_remove_failed": "Kunden konnten nicht aus Gruppen entfernt werden",+ "picker": {+ "add_title": "Zu Gruppen hinzufügen",+ "add_description": "Wählen Sie die Gruppen aus, zu denen diese Kunden hinzugefügt werden sollen.",+ "remove_title": "Aus Gruppen entfernen",+ "remove_description": "Wählen Sie die Gruppen aus, aus denen diese Kunden entfernt werden sollen."+ },+ "view_members": "Mitglieder anzeigen",+ "count_one": "{{count}} Kunde",+ "count_other": "{{count}} Kunden",+ "create_label": "Kundengruppe erstellen",+ "create_description": "Erstellen Sie eine Kundengruppe, um Ihre Kunden für Aktionen, Analysen oder Marketing zu segmentieren.",+ "edit_description": "Aktualisieren Sie den Namen oder die Beschreibung.",+ "default_name": "Diese Gruppe",+ "delete_confirm": {+ "title": "Kundengruppe löschen?",+ "message": "{{name}} wird entfernt. Kunden in dieser Gruppe werden nicht gelöscht."+ },+ "table": {+ "title": "Kundengruppen",+ "search_placeholder": "Nach Name suchen…",+ "empty": "Noch keine Kundengruppen"+ },+ "columns": {+ "customers": "Kunden"+ }+ },+ "tags": {+ "bulk_add_action": "Tags hinzufügen…",+ "bulk_remove_action": "Tags entfernen…",+ "bulk_added": "Tags zu {n} Kunden hinzugefügt",+ "bulk_removed": "Tags von {n} Kunden entfernt",+ "bulk_add_failed": "Tags konnten nicht hinzugefügt werden",+ "bulk_remove_failed": "Tags konnten nicht entfernt werden",+ "picker": {+ "add_title": "Tags hinzufügen",+ "add_description": "Wählen oder erstellen Sie Tags, die diesen Kunden hinzugefügt werden sollen.",+ "remove_title": "Tags entfernen",+ "remove_description": "Wählen Sie Tags aus, die von diesen Kunden entfernt werden sollen."+ }+ },+ "row_actions": {+ "delete_confirm": "{{email}} löschen? Kunden mit abgeschlossenen Bestellungen können nicht entfernt werden."+ },+ "detail": {+ "delete_label": "Kunde löschen",+ "edit_profile_description": "Aktualisieren Sie die Profilinformationen des Kunden.",+ "subscribed_to_marketing": "Marketing abonniert",+ "not_subscribed_to_marketing": "Marketing nicht abonniert",+ "customer_since": "Kunde seit",+ "last_order_placed": "Letzte Bestellung aufgegeben",+ "orders_table": {+ "order": "Bestellung",+ "date": "Datum"+ },+ "no_internal_notes": "Keine internen Notizen",+ "address": {+ "default_billing": "Standard-Rechnungsadresse",+ "default_shipping": "Standard-Lieferadresse",+ "set_default_billing": "Als Standard-Rechnungsadresse festlegen",+ "set_default_shipping": "Als Standard-Lieferadresse festlegen",+ "delete_confirm_message": "Diese Adresse löschen?"+ },+ "store_credit": {+ "title": "Guthaben",+ "empty": "Kein Guthaben ausgestellt",+ "table": {+ "used": "Verwendet",+ "remaining": "Verbleibend",+ "category": "Kategorie",+ "memo": "Notiz"+ },+ "delete_confirm_message": "Dieses Guthaben löschen?",+ "edit_description": "Passen Sie den Betrag, die Kategorie oder die Notiz an. Das verwendete Guthaben kann nicht bearbeitet werden.",+ "add_description": "Stellen Sie diesem Kundenkonto Guthaben aus."+ }+ },+ "new_sheet_description": "Hier angelegte Kunden haben kein Passwort festgelegt. Sie erhalten beim ersten Anmelden einen Magic Link.",+ "table": {+ "search_placeholder": "Nach E-Mail oder Name suchen…",+ "empty": "Noch keine Kunden"+ },+ "columns": {+ "orders": "Bestellungen",+ "total_spent": "Gesamtausgaben",+ "last_order": "Letzte Bestellung",+ "groups": "Gruppen",+ "newsletter": "Newsletter"+ },+ "autocomplete": {+ "placeholder": "Kunden suchen…",+ "empty": "Keine passenden Kunden"+ }+ },+ "orders": {+ "new": {+ "use_default_addresses": "Standard-Rechnungs- und Lieferadresse des Kunden verwenden",+ "add_variant": "Variante hinzufügen",+ "items_table": {+ "variant": "Variante",+ "sku": "SKU",+ "qty": "Anz."+ },+ "creates_draft_note": "Erstellt einen Auftragsentwurf. Fügen Sie nach der Erstellung Zahlungen hinzu und schließen Sie ihn ab."+ },+ "detail": {+ "load_failed_message": "Auftrag {{orderId}} konnte nicht geladen werden.",+ "confirm": {+ "complete_message": "Diesen Auftragsentwurf jetzt abschließen?",+ "approve_message": "Diesen Auftrag genehmigen?",+ "resume_message": "Diesen stornierten Auftrag wieder aufnehmen?",+ "cancel_message": "Möchten Sie diesen Auftrag wirklich stornieren?",+ "remove_item_message": "Diesen Artikel aus dem Auftrag entfernen?",+ "ship_message": "Diese Lieferung versenden?",+ "cancel_shipment_message": "Diese Lieferung stornieren?",+ "capture_message": "Diese Zahlung einziehen?",+ "void_message": "Diese Zahlung stornieren?",+ "remove_gift_card_message": "Diese Geschenkkarte aus dem Auftrag entfernen?",+ "remove_store_credit_message": "Guthaben aus dem Auftrag entfernen?"+ },+ "dropdown": {+ "complete_order": "Auftrag abschließen",+ "preview_order": "Auftrag in der Vorschau anzeigen",+ "resend_confirmation": "Bestätigung erneut senden",+ "edit_quantity": "Menge bearbeiten",+ "cancel_shipment": "Lieferung stornieren",+ "void_payment": "Zahlung stornieren"+ },+ "messages": {+ "canceled": "Auftrag storniert",+ "completed": "Auftrag abgeschlossen",+ "approved": "Auftrag genehmigt",+ "resumed": "Auftrag wieder aufgenommen",+ "shipped": "Lieferung versendet",+ "captured": "Zahlung eingezogen",+ "voided": "Zahlung storniert",+ "confirmation_sent": "Bestätigung gesendet"+ },+ "errors": {+ "cancel_failed": "Auftrag konnte nicht storniert werden",+ "complete_failed": "Auftrag konnte nicht abgeschlossen werden",+ "approve_failed": "Auftrag konnte nicht genehmigt werden",+ "resume_failed": "Auftrag konnte nicht wieder aufgenommen werden",+ "confirmation_send_failed": "Bestätigung konnte nicht gesendet werden"+ },+ "variant_search": {+ "description": "Suchen Sie nach einer Produktvariante, die diesem Auftrag hinzugefügt werden soll.",+ "label": "Variante suchen",+ "empty": "Keine Varianten gefunden",+ "sku_prefix": "SKU",+ "placeholder": "Produktname oder SKU eingeben (min. 3 Zeichen)…"+ },+ "edit_quantity": {+ "title": "Menge bearbeiten",+ "description": "Legen Sie die Menge für diese Position fest."+ },+ "items_table": {+ "item": "Artikel",+ "price": "Preis",+ "qty": "Anz."+ },+ "tracking": {+ "label": "Sendungsnummer",+ "description": "Aktualisieren Sie die Sendungsnummer für diese Lieferung.",+ "prefix": "Tracking",+ "shipped_prefix": "Versendet",+ "edit_title": "Sendungsverfolgung bearbeiten",+ "add_title": "Sendungsverfolgung hinzufügen"+ },+ "payments_table": {+ "number": "Nummer",+ "method": "Methode",+ "state": "Status"+ },+ "payment_form": {+ "description": "Belasten Sie eine Zahlungsmethode für diesen Auftrag.",+ "method_label": "Zahlungsmethode",+ "method_placeholder": "Zahlungsmethode auswählen",+ "source_label": "Quelle",+ "amount_help": "Leer lassen, um standardmäßig den offenen Saldo zu verwenden.",+ "capture_immediately": "Sofort einziehen",+ "title": "Zahlung hinzufügen",+ "source_requires_customer": "Diese Zahlungsmethode erfordert eine gespeicherte Quelle. Weisen Sie der Bestellung zunächst einen Kunden zu.",+ "no_saved_cards": "Der Kunde hat keine gespeicherten Karten für diese Zahlungsmethode.",+ "source_placeholder": "Gespeicherte Karte auswählen…"+ },+ "summary": {+ "canceled_at": "Storniert am",+ "canceler": "Storniert von",+ "approved_by": "Genehmigt von",+ "promotions": "Aktionen",+ "adjustments": "Anpassungen",+ "tax_included": "Steuer (inklusive)",+ "tax_additional": "Steuer (zusätzlich)",+ "payment_total": "Zahlungssumme",+ "outstanding_balance": "Offener Saldo"+ },+ "gift_card_section": {+ "title": "Geschenkkarte & Guthaben",+ "gift_card_label": "Geschenkkarte",+ "store_credit_label": "Guthaben",+ "none_applied": "Keine angewendet",+ "applied_suffix": "angewendet",+ "apply_balance": "Verfügbares Guthaben des Kunden anwenden",+ "requires_customer": "Erfordert einen Kunden",+ "apply_dialog_title": "Geschenkkarte anwenden",+ "apply_dialog_description": "Geben Sie einen Geschenkkartencode ein, der auf diesen Auftrag angewendet werden soll."+ },+ "address_edit": {+ "shipping_title": "Lieferadresse bearbeiten",+ "billing_title": "Rechnungsadresse bearbeiten"+ },+ "no_customer": "Keine Kundeninformationen",+ "section_customer_note": "Besondere Anweisungen",+ "section_internal_note": "Interne Notiz",+ "completed_prefix": "Abgeschlossen",+ "add_line_item": {+ "title": "Position hinzufügen"+ },+ "no_line_items": "Keine Positionen"+ },+ "table": {+ "search_placeholder": "Bestellungen suchen…",+ "empty": "Keine Bestellungen gefunden"+ },+ "columns": {+ "number": "Nummer",+ "date": "Datum",+ "customer": "Kunde",+ "payment": "Zahlung",+ "fulfillment": "Abwicklung",+ "items": "Artikel",+ "tags": "Tags",+ "sku": "SKU"+ },+ "item_count_one": "{{count}} Artikel",+ "item_count_other": "{{count}} Artikel",+ "statuses": {+ "draft": "Entwurf",+ "placed": "Aufgegeben",+ "canceled": "Storniert"+ },+ "payment_statuses": {+ "balance_due": "Offener Betrag",+ "credit_owed": "Guthaben",+ "failed": "Fehlgeschlagen",+ "paid": "Bezahlt",+ "void": "Storniert"+ },+ "fulfillment_statuses": {+ "backorder": "Lieferrückstand",+ "canceled": "Storniert",+ "partial": "Teilweise",+ "pending": "Ausstehend",+ "ready": "Bereit",+ "fulfilled": "Abgewickelt"+ }+ },+ "products": {+ "save_label": "Produkt speichern",+ "delete_label": "Produkt löschen",+ "delete_confirm": "Möchten Sie dieses Produkt wirklich löschen?",+ "category_search_placeholder": "Kategorien suchen…",+ "no_categories_found": "Keine Kategorien gefunden",+ "media": {+ "delete_confirm": "Dieses Medium löschen? Dies kann nicht rückgängig gemacht werden.",+ "drop_hint": "Medien hierher ziehen und ablegen oder zum Durchsuchen klicken",+ "file_types_hint": "PNG, JPG, WebP bis zu 10 MB",+ "edit_title": "Medium bearbeiten",+ "assigned_variants_label": "Zugeordnete Varianten",+ "assigned_variants_help": "Wählen Sie die Varianten aus, die dieses Bild repräsentiert. Leer lassen, um es auf alle Varianten anzuwenden.",+ "upload_failed": "Hochladen von {{name}} fehlgeschlagen: {{message}}",+ "upload_status_failed": "Fehlgeschlagen"+ },+ "seo": {+ "slug_placeholder": "produkt-url-handle",+ "meta_title_placeholder": "SEO-Titel",+ "meta_description_placeholder": "SEO-Beschreibung"+ },+ "tax_category_placeholder": "Steuerkategorie auswählen",+ "transfers": {+ "new_cta": "Neuer Transfer",+ "create_description": "Bestand zwischen Standorten verschieben oder neuen Bestand von einem externen Lieferanten empfangen.",+ "external_label": "Extern (Lieferanten-Wareneingang)",+ "destination_placeholder": "Zielstandort auswählen",+ "different_locations_error": "Quelle und Ziel müssen sich unterscheiden.",+ "reference_label": "Referenz",+ "reference_placeholder": "Bestellnummer, Lieferantenrechnung, …",+ "search_items_placeholder": "Nach Name oder SKU suchen (3+ Zeichen)…",+ "items_table": {+ "variant": "Variante",+ "sku": "SKU",+ "qty": "Anz."+ },+ "delete_confirm": {+ "title": "Diesen Transfer löschen?",+ "message": "Durch diesen Transfer erstellte Bestandsbewegungen werden rückgängig gemacht."+ },+ "review_description": "Überprüfen Sie den Transfer vor dem Erstellen. Artikel können danach nicht mehr geändert werden.",+ "details_card": "Details",+ "fields": {+ "type": "Typ",+ "internal": "Intern",+ "external_receive": "Externer Wareneingang",+ "reference": "Referenz",+ "created": "Erstellt",+ "immutable_note": "Bestandstransfers sind nach dem Erstellen unveränderlich."+ }+ },+ "options": {+ "kinds": {+ "dropdown": "Dropdown",+ "color_swatch": "Farbmuster",+ "buttons": "Schaltflächen"+ },+ "add_cta": "Optionstyp hinzufügen",+ "create_label": "Optionstyp erstellen",+ "create_description": "Definieren Sie eine Option, die Varianten verwenden können (z. B. Größe, Farbe).",+ "edit_description": "Bearbeiten Sie den Optionstyp und seine Werte.",+ "delete_confirm": {+ "title": "Optionstyp löschen?",+ "message": "Dadurch werden auch alle zugehörigen Werte gelöscht. Varianten, die diese Werte verwenden, verlieren sie."+ },+ "values_help": "Werte zum Neuordnen ziehen. Der erste Wert ist der Standard für neue Varianten.",+ "count_one": "{{count}} Wert",+ "count_other": "{{count}} Werte",+ "value_name_placeholder": "z. B. small",+ "value_label_placeholder": "z. B. Small",+ "image_upload_failed": "Bild konnte nicht hochgeladen werden"+ },+ "variants": {+ "title": "Varianten",+ "default_variant": "Standardvariante",+ "variant_label": "Variante",+ "add_option": "Option hinzufügen",+ "create_option_type": "Neuen Optionstyp erstellen",+ "create_option_type_title": "Neuer Optionstyp",+ "create_value": "Neuer Wert",+ "create_value_title": "Neuer Optionswert",+ "option_type_label": "Optionstyp",+ "option_type_placeholder": "Optionstyp auswählen",+ "edit_variant": "Variante bearbeiten — {{name}}",+ "edit_row_aria": "{{name}} bearbeiten",+ "remove_row_aria": "{{name}} entfernen",+ "orphan_warning_one": "{{count}} vorhandene Variante entspricht nicht mehr den ausgewählten Optionen und wird beim Speichern entfernt:",+ "orphan_warning_other": "{{count}} vorhandene Varianten entsprechen nicht mehr den ausgewählten Optionen und werden beim Speichern entfernt:",+ "orphan_warning": "{{count}} vorhandene Variante(n) werden beim Speichern entfernt:",+ "keep": "Alle behalten",+ "sheet": {+ "identity": "Identität",+ "tax_category_placeholder": "Vom Produkt übernehmen"+ }+ },+ "inventory": {+ "columns": {+ "location": "Standort",+ "on_hand": "Verfügbar",+ "backorder": "Nachbestellung"+ },+ "on_hand_aria": "Verfügbar bei {{location}}",+ "backorder_aria": "Nachbestellung bei {{location}} zulassen",+ "empty_no_locations": "Fügen Sie in den Einstellungen einen Lagerstandort hinzu, um mit der Bestandsverfolgung zu beginnen.",+ "empty_no_variants": "Lagerbestände werden pro Lagerstandort verwaltet. Fügen Sie eine Variante hinzu, um mit der Bestandsverfolgung zu beginnen."+ },+ "custom_fields": {+ "empty_title": "Noch keine benutzerdefinierten Felder",+ "empty_description": "Definieren Sie in den Einstellungen benutzerdefinierte Felder, um strukturierte Details zu Produkten zu erfassen.",+ "empty_cta": "Benutzerdefinierte Felder einrichten"+ },+ "columns": {+ "sku": "SKU",+ "price": "Preis",+ "in_stock": "Auf Lager"+ },+ "price_lists": {+ "messages": {+ "created": "Preisliste erstellt",+ "updated": "Preisliste aktualisiert",+ "deleted": "Preisliste gelöscht",+ "activated": "Preisliste aktiviert",+ "deactivated": "Preisliste deaktiviert"+ },+ "errors": {+ "failed_to_activate": "Preisliste konnte nicht aktiviert werden",+ "failed_to_deactivate": "Preisliste konnte nicht deaktiviert werden"+ }+ }+ },+ "payment_methods": {+ "add_cta": "Zahlungsmethode hinzufügen",+ "create_description": "Wählen Sie einen Anbieter und konfigurieren Sie dessen Zugangsdaten.",+ "edit_description": "Aktualisieren Sie Name, Sichtbarkeit oder Status.",+ "create_label": "Zahlungsmethode erstellen",+ "provider_description": "Anbieter: {{provider}}",+ "delete_confirm": {+ "title": "Zahlungsmethode löschen?",+ "message": "{{name}} steht beim Checkout nicht mehr zur Verfügung."+ },+ "title": "Zahlungsarten",+ "search_placeholder": "Nach Name suchen…",+ "empty": "Keine Zahlungsarten konfiguriert",+ "columns": {+ "storefront": "Onlineshop"+ },+ "storefront": {+ "visible": "Sichtbar",+ "admin_only": "Nur Administration"+ },+ "status": {+ "disabled": "Deaktiviert"+ },+ "messages": {+ "created": "Zahlungsmethode erstellt",+ "updated": "Zahlungsmethode aktualisiert",+ "deleted": "Zahlungsmethode gelöscht"+ }+ },+ "tax_categories": {+ "add_cta": "Steuerkategorie hinzufügen",+ "create_description": "Gruppieren Sie Produkte nach steuerlicher Behandlung (Standard, ermäßigt, befreit, …).",+ "edit_description": "Aktualisieren Sie den Namen, den Code oder die Standardmarkierung.",+ "create_label": "Steuerkategorie erstellen",+ "delete_confirm": {+ "title": "Steuerkategorie löschen?",+ "message": "{{name}} wird entfernt. Produkte in dieser Kategorie greifen auf die Standardkategorie zurück."+ },+ "search_placeholder": "Nach Name suchen…",+ "empty": "Noch keine Steuerkategorien",+ "messages": {+ "created": "Steuerkategorie erstellt",+ "updated": "Steuerkategorie aktualisiert",+ "deleted": "Steuerkategorie gelöscht"+ }+ },+ "markets": {+ "add_cta": "Markt hinzufügen",+ "create_description": "Fassen Sie Länder zu einer einzigen Preisregion mit eigener Währung und eigenen Sprachen zusammen.",+ "edit_description": "Aktualisieren Sie Name, Währung, Sprachen oder die Länderabdeckung.",+ "create_label": "Markt erstellen",+ "delete_confirm": {+ "title": "Markt löschen?",+ "message": "{{name}} wird entfernt. Bestellungen, die zuvor in diesem Markt aufgegeben wurden, bleiben erhalten."+ },+ "search_placeholder": "Nach Name suchen…",+ "empty": "Noch keine Märkte",+ "tax_inclusive": "Inklusive",+ "tax_exclusive": "Exklusive",+ "columns": {+ "default": "Standard"+ },+ "messages": {+ "created": "Markt erstellt",+ "updated": "Markt aktualisiert",+ "deleted": "Markt gelöscht"+ },+ "errors": {+ "failed_to_create": "Markt konnte nicht erstellt werden",+ "failed_to_update": "Markt konnte nicht aktualisiert werden",+ "failed_to_delete": "Markt konnte nicht gelöscht werden"+ }+ },+ "custom_field_definitions": {+ "add_cta": "Benutzerdefiniertes Feld hinzufügen",+ "create_label": "Benutzerdefiniertes Feld erstellen",+ "create_description": "Definieren Sie ein typisiertes Feld, das Ihr Team in jedem passenden Datensatz ausfüllen kann.",+ "edit_description": "Aktualisieren Sie die Bezeichnung, den Schlüssel oder die Storefront-Sichtbarkeit. Der Eigentümer kann nicht mehr geändert werden, sobald Werte vorhanden sind.",+ "table_title": "Definitionen benutzerdefinierter Felder",+ "search_placeholder": "Nach Bezeichnung, Namespace oder Schlüssel suchen…",+ "empty": "Noch keine Definitionen benutzerdefinierter Felder",+ "storefront_visible": {+ "visible": "Sichtbar",+ "admin_only": "Nur Administration"+ },+ "delete_confirm": {+ "title": "Benutzerdefiniertes Feld löschen?",+ "message": "{{label}} wird zusammen mit allen dafür gespeicherten Werten entfernt."+ }+ },+ "allowed_origins": {+ "add_cta": "Erlaubten Ursprung hinzufügen",+ "create_label": "Ursprung hinzufügen",+ "create_description": "Browser, die von diesem Ursprung geladen werden, können die Admin-API aufrufen. Sowohl die CORS-Zulassungsliste als auch die Admin-Cookie-Sitzung stützen sich auf diese Liste – halten Sie sie restriktiv.",+ "edit_description": "Das Aktualisieren eines Ursprungs ändert sofort, wer die Admin-API von einem Browser aus aufrufen kann.",+ "table_title": "Erlaubte Ursprünge",+ "search_placeholder": "Nach Ursprung suchen…",+ "empty": "Noch keine erlaubten Ursprünge",+ "validation": {+ "bare_origin": "Muss ein reiner Ursprung sein (z. B. https://shop.example.com) – ohne Pfad, Query oder Fragment"+ },+ "delete_confirm": {+ "title": "Erlaubten Ursprung entfernen?",+ "message": "{{origin}} kann die Admin-API nicht mehr von einem Browser aus aufrufen. Bestehende Server-zu-Server-Anfragen sind nicht betroffen."+ },+ "messages": {+ "added": "Erlaubter Ursprung hinzugefügt",+ "updated": "Erlaubter Ursprung aktualisiert",+ "removed": "Erlaubter Ursprung entfernt"+ }+ },+ "stock_locations": {+ "add_cta": "Lagerort hinzufügen",+ "create_label": "Lagerort erstellen",+ "create_description": "Fügen Sie ein Lager, ein Geschäft oder einen Abholpunkt hinzu, von dem aus Bestellungen abgewickelt werden.",+ "edit_description": "Aktualisieren Sie Name, Adresse, Abholung oder Bestandsrichtlinien.",+ "kinds": {+ "warehouse": "Lager",+ "store": "Geschäft",+ "fulfillment_center": "Fulfillment-Center"+ },+ "pickup_stock_policies": {+ "local": "Nur Artikel an diesem Standort",+ "any": "Übertragungen von anderen Standorten zulassen"+ },+ "delete_confirm": {+ "title": "Lagerort löschen?",+ "message": "{{name}} wird entfernt. Bestandsartikel an diesem Standort werden nicht gelöscht."+ },+ "section_pickup": "Abholung",+ "stock_items": {+ "title": "Bestand an diesem Standort",+ "help": "Passen Sie die verfügbaren und nachbestellbaren Mengen pro Variante an.",+ "search_placeholder": "SKU oder Produkt suchen…",+ "table": {+ "variant": "Variante",+ "on_hand": "Verfügbar",+ "backorder": "Nachbestellung"+ },+ "empty": "An diesem Standort sind noch keine Bestandsartikel vorhanden.",+ "empty_search": "Keine Bestandsartikel entsprechen Ihrer Suche."+ },+ "search_placeholder": "Nach Name suchen…",+ "empty": "Noch keine Lagerstandorte",+ "columns": {+ "type": "Typ",+ "location": "Standort",+ "pickup": "Abholung",+ "default": "Standard"+ },+ "badges": {+ "enabled": "Aktiviert",+ "inactive": "Inaktiv",+ "default": "Standard"+ }+ },+ "store": {+ "load_failed_title": "Laden der Store-Einstellungen fehlgeschlagen",+ "unit_systems": {+ "metric": "Metrisch",+ "imperial": "Imperial"+ },+ "weight_units": {+ "kg": "Kilogramm (kg)",+ "g": "Gramm (g)",+ "lb": "Pfund (lb)",+ "oz": "Unze (oz)"+ }+ },+ "option_types": {+ "kinds": {+ "dropdown": "Dropdown",+ "color_swatch": "Farbfeld",+ "buttons": "Schaltflächen"+ },+ "columns": {+ "values": "Werte"+ },+ "value_count_one": "{{count}} Wert",+ "value_count_other": "{{count}} Werte",+ "table": {+ "search_placeholder": "Nach Name suchen…",+ "empty": "Noch keine Optionstypen"+ },+ "messages": {+ "created": "Optionstyp erstellt",+ "updated": "Optionstyp aktualisiert",+ "deleted": "Optionstyp gelöscht"+ }+ },+ "stock_transfers": {+ "title": "Lagerumbuchungen",+ "table": {+ "search_placeholder": "Nach Nummer oder Referenz suchen…",+ "empty": "Noch keine Lagerumbuchungen"+ },+ "columns": {+ "number": "Nummer",+ "direction": "Richtung",+ "reference": "Referenz"+ },+ "direction": {+ "internal": "Umbuchung zwischen Standorten",+ "external_receive": "Externer Wareneingang"+ },+ "messages": {+ "recorded": "Lagerübertrag erfasst",+ "deleted": "Lagerübertrag gelöscht"+ },+ "errors": {+ "failed_to_record": "Lagerübertrag konnte nicht erfasst werden",+ "failed_to_delete": "Lagerübertrag konnte nicht gelöscht werden"+ }+ },+ "calculators": {+ "flat_percent_item_total": "Pauschaler Prozentsatz",+ "flat_rate": "Pauschalbetrag",+ "flexi_rate": "Flexibler Tarif",+ "per_item": "Pro Artikel",+ "percent_on_line_item": "Prozentsatz pro Position",+ "price_sack": "Preisstaffel",+ "tiered_flat_rate": "Gestaffelter Pauschalbetrag",+ "tiered_percent": "Gestaffelter Prozentsatz",+ "default_tax": "Standardsteuer",+ "digital_delivery": "Digitale Lieferung",+ "default_refund_amount": "Standard-Erstattungsbetrag"+ },+ "preferences": {+ "amount": "Betrag",+ "flat_percent": "Fester Prozentsatz",+ "percent": "Prozent",+ "first_item": "Kosten für den ersten Artikel",+ "additional_item": "Kosten für jeden weiteren Artikel",+ "max_items": "Maximale Artikelanzahl",+ "minimal_amount": "Mindestbetrag",+ "normal_amount": "Normalbetrag",+ "discount_amount": "Rabattbetrag",+ "currency": "Währung",+ "base_amount": "Grundbetrag",+ "base_percent": "Grundprozentsatz",+ "preferred_amount": "Betrag",+ "preferred_percent": "Prozent"+ },+ "channels": {+ "messages": {+ "created": "Kanal erstellt",+ "updated": "Kanal aktualisiert",+ "deleted": "Kanal gelöscht"+ }+ },+ "customer_groups": {+ "messages": {+ "created": "Kundengruppe erstellt",+ "create_failed": "Kundengruppe konnte nicht erstellt werden",+ "updated": "Kundengruppe aktualisiert",+ "update_failed": "Kundengruppe konnte nicht aktualisiert werden",+ "deleted": "Kundengruppe gelöscht",+ "delete_failed": "Kundengruppe konnte nicht gelöscht werden"+ },+ "autocomplete": {+ "placeholder": "Kundengruppen suchen…",+ "empty": "Keine passenden Kundengruppen"+ }+ },+ "settings": {+ "webhooks": {+ "messages": {+ "updated": "Webhook-Endpunkt aktualisiert",+ "removed": "Webhook-Endpunkt entfernt"+ },+ "errors": {+ "send_test_failed": "Test-Webhook konnte nicht gesendet werden",+ "redeliver_failed": "Erneute Zustellung fehlgeschlagen"+ }+ }+ },+ "stock_items": {+ "messages": {+ "stock_updated": "Bestand aktualisiert",+ "stock_item_deleted": "Bestandsposition gelöscht"+ }+ }+ }+}diff --git a/packages/dashboard/src/locales/en.json b/packages/dashboard/src/locales/en.jsonindex ba6f6137e6..6844371085 100644--- a/packages/dashboard/src/locales/en.json+++ b/packages/dashboard/src/locales/en.json@@ -6,7 +6,6 @@},"gift_cards": {"statuses": {- "active": "Active","partially_redeemed": "Partially redeemed","redeemed": "Redeemed","canceled": "Canceled",@@ -17,8 +16,7 @@"remaining": "Remaining","batch": "Batch","customer": "Customer",- "issued_by": "Issued by",- "expires": "Expires"+ "issued_by": "Issued by"},"table": {"search_placeholder": "Search by code…",@@ -39,6 +37,54 @@"empty": "No batches match"}},+ "option_types": {+ "kinds": {+ "dropdown": "Dropdown",+ "color_swatch": "Color swatch",+ "buttons": "Buttons"+ },+ "columns": {+ "values": "Values"+ },+ "value_count_one": "{{count}} value",+ "value_count_other": "{{count}} values",+ "table": {+ "search_placeholder": "Search by name…",+ "empty": "No option types yet"+ },+ "messages": {+ "created": "Option type created",+ "updated": "Option type updated",+ "deleted": "Option type deleted"+ }+ },+ "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."+ },+ "search_placeholder": "Search by name…",+ "empty": "No markets yet",+ "tax_inclusive": "Inclusive",+ "tax_exclusive": "Exclusive",+ "columns": {+ "default": "Default"+ },+ "messages": {+ "created": "Market created",+ "updated": "Market updated",+ "deleted": "Market deleted"+ },+ "errors": {+ "failed_to_create": "Failed to create market",+ "failed_to_update": "Failed to update market",+ "failed_to_delete": "Failed to delete market"+ }+ },"branding": {"app_name": "Spree Admin","powered_by": "Powered by Spree Commerce"@@ -79,7 +125,8 @@"staff": "Staff","api_keys": "API keys","webhooks": "Webhooks",- "allowed_origins": "Allowed origins"+ "allowed_origins": "Allowed origins",+ "profile": "Profile"}},"fields": {@@ -208,7 +255,9 @@}},"channel": {- "name": { "placeholder": "e.g. POS, Wholesale, Meta Shop" },+ "name": {+ "placeholder": "e.g. POS, Wholesale, Meta Shop"+ },"code": {"label": "Code","placeholder": "Auto-derived from name",@@ -358,7 +407,8 @@"auto_capture": {"label": "Auto-capture","help": "Capture funds automatically on authorization. When off, you must capture manually."- }+ },+ "provider_configuration": "Provider configuration"},"market": {"name": {@@ -645,11 +695,35 @@"label": "Alt text","placeholder": "Describe the image for accessibility and SEO"}+ },+ "profile": {+ "email": {+ "label": "Email"+ },+ "first_name": {+ "label": "First name"+ },+ "last_name": {+ "label": "Last name"+ },+ "selected_locale": {+ "label": "Language",+ "help": "Language used across the admin dashboard. Only affects what you see."+ }}},"promotions": {"rule_types_empty": "No rule types registered.","rule_types_all_used": "Every available rule type is already on this promotion.",+ "table": {+ "search_placeholder": "Search by name…",+ "empty": "No promotions yet",+ "no_end": "No end"+ },+ "code": {+ "automatic": "Automatic",+ "multi": "multi"+ },"generate_code": {"title": "Generate a random code"},@@ -665,7 +739,9 @@},"rules_card": {"title": "Rules",- "description": "Conditions that decide whether the promotion applies."+ "description": "Conditions that decide whether the promotion applies.",+ "empty": "No rules. Without rules, the promotion always qualifies (subject to schedule and usage limit).",+ "add_rule": "Add rule"},"validation": {"code_required": "Code is required (or click Generate)",@@ -728,22 +804,210 @@"search_placeholder": "Search customers by name or email…","empty": "No customers match"}+ },+ "basics_card": {+ "title": "Basics"+ },+ "trigger_card": {+ "title": "Trigger"+ },+ "schedule_card": {+ "title": "Schedule & limits"+ },+ "trigger_summary": {+ "multi_code": "Multi-code coupon ({{count}} codes)",+ "multi_code_with_prefix": "Multi-code coupon ({{count}} codes with prefix \"{{prefix}}\")",+ "show_codes": "Show codes",+ "single_code": "Single coupon code:",+ "locked_help": "Trigger settings can't be changed after creation. Make a new promotion to change them."+ },+ "remove_rule_confirm": {+ "title": "Remove rule?",+ "message": "Removed when you save the promotion."+ },+ "rule_summary": {+ "product_count": "{{count}} products",+ "category_count": "{{count}} categories",+ "customer_count": "{{count}} customers"+ },+ "rule_picker": {+ "title": "Add rule",+ "description": "Pick a rule type to configure."+ },+ "rule_edit": {+ "description": "Tune the rule's parameters.",+ "no_options": "This rule has no configurable options — its presence alone applies the constraint."+ },+ "actions_card": {+ "description": "What happens when the promotion qualifies.",+ "empty": "No actions yet. A promotion without actions doesn't do anything when applied.",+ "add_action": "Add action"+ },+ "remove_action_confirm": {+ "title": "Remove action?",+ "message": "Removed when you save the promotion."+ },+ "action_summary": {+ "variant_count": "{{count}} variants"+ },+ "action_picker": {+ "title": "Add action",+ "description": "Pick what should happen when the promotion qualifies."+ },+ "action_edit": {+ "description": "Configure the action's parameters.",+ "no_options": "This action has no configurable options."+ },+ "coupon_codes": {+ "title": "Coupon codes",+ "description": "Auto-generated codes for this promotion. Read-only — regenerate by changing the promotion's number-of-codes setting.",+ "description_with_count": "{{count}} auto-generated codes. Read-only — regenerate by changing the promotion's number-of-codes setting.",+ "empty": "No codes generated yet.",+ "unused": "Unused",+ "used": "Used",+ "export_csv": "Export CSV",+ "states": {+ "used": "Used",+ "partially_used": "Partially used"+ }+ },+ "rule_types": {+ "category": {+ "name": "Categories",+ "description": "Order includes products in specified categories"+ },+ "country": {+ "name": "Country",+ "description": "Limit to orders with shipping address in a specific country"+ },+ "currency": {+ "name": "Currency",+ "description": "Limit to orders in a specific currency"+ },+ "customer": {+ "name": "Customers",+ "description": "Available only to the specified customers"+ },+ "customer_group": {+ "name": "Customer Group(s)",+ "description": "Available only to customers in specified customer group(s)"+ },+ "customer_logged_in": {+ "name": "Only logged in customers",+ "description": "Available only to logged in customers"+ },+ "first_order": {+ "name": "First order",+ "description": "Must be the customer's first order"+ },+ "item_total": {+ "name": "Item total",+ "description": "Order total meets these criteria"+ },+ "one_use_per_user": {+ "name": "One Use Per User",+ "description": "Only One Use Per User"+ },+ "option_value": {+ "name": "Option Value(s)",+ "description": "Order includes products with matching option value(s)"+ },+ "product": {+ "name": "Product(s)",+ "description": "Order includes specified product(s)"+ }+ },+ "action_types": {+ "create_adjustment": {+ "name": "Create whole-order adjustment",+ "description": "Creates a promotion credit adjustment on the order"+ },+ "create_item_adjustments": {+ "name": "Create per-line-item adjustment",+ "description": "Creates a promotion credit adjustment on a line item"+ },+ "create_line_items": {+ "name": "Create line items",+ "description": "Populates the cart with the specified quantity of variant"+ },+ "free_shipping": {+ "name": "Free shipping",+ "description": "Makes all shipments for the order free"+ }+ },+ "messages": {+ "action_added": "Action added",+ "action_updated": "Action updated",+ "action_removed": "Action removed",+ "rule_added": "Rule added",+ "rule_updated": "Rule updated",+ "rule_removed": "Rule removed"+ },+ "errors": {+ "failed_to_add_action": "Failed to add action",+ "failed_to_update_action": "Failed to update action",+ "failed_to_remove_action": "Failed to remove action",+ "failed_to_add_rule": "Failed to add rule",+ "failed_to_update_rule": "Failed to update rule",+ "failed_to_remove_rule": "Failed to remove rule"}},"components": {"market_combobox": {"search_placeholder": "Search markets…","empty": "No markets match"+ },+ "custom_fields_card": {+ "set_up": "Set up",+ "empty_title": "No custom fields yet",+ "empty_description": "Track structured details like material, fit, or care instructions.",+ "not_yet_set": "{{count}} of {{total}} not yet set"+ },+ "custom_fields": {+ "title": "Custom fields",+ "new_definition_title": "New custom field",+ "definition_created_title": "Definition created",+ "definition_created_toast": "Definition created",+ "definition_created_hint": "You can set its value now or define another field first.",+ "empty_title": "No custom fields defined for {{resource}}",+ "empty_description": "Define a custom field to store typed, structured information alongside your records.",+ "create_definition": "Create definition",+ "values_saved": "Custom fields saved",+ "values_save_failed": "Failed to save custom fields",+ "admin_only": "Admin only",+ "add_another_field": "Add another field",+ "create_another": "Create another",+ "set_values": "Set values"+ },+ "adjustment_action_editor": {+ "calculator_label": "Calculator",+ "loading_calculators": "Loading calculators…",+ "select_calculator": "Select a calculator",+ "no_extra_settings": "This calculator has no extra settings.",+ "settings_label": "Calculator settings"}},"pages": {"home": {"top_products": "Top Products",- "top_products_description": "Best-selling products in your store."- },- "login": {- "title": "Welcome back",- "subtitle": "Sign in to your admin account"+ "top_products_description": "Best-selling products in your store.",+ "title": "Dashboard",+ "subtitle": "Overview of your store performance",+ "metrics": {+ "sales": "Total Sales",+ "orders": "Total Orders",+ "avg_order_value": "Avg Order Value"+ },+ "metric_short": {+ "sales": "Sales",+ "orders": "Orders",+ "avg_order_value": "AOV"+ },+ "columns": {+ "product": "Product",+ "price": "Price",+ "sold": "Sold"+ }},"staff": {"title": "Staff",@@ -756,9 +1020,7 @@"table": {"member": "Member","roles": "Roles",- "email": "Email",- "role": "Role",- "expires": "Expires"+ "role": "Role"},"invite_sheet": {"title": "Invite teammate",@@ -769,7 +1031,6 @@},"actions": {"resend": "Resend",- "revoke": "Revoke","remove": "Remove from staff"},"messages": {@@ -850,11 +1111,8 @@"section_history": "History","summary": {"created_by": "Created by",- "created_at": "Created at",- "completed_at": "Completed at","market": "Market","locale": "Locale",- "currency": "Currency","channel": "Sales channel","ip_address": "IP address"},@@ -896,13 +1154,11 @@"section_basics": "Basics","section_media": "Media","section_pricing": "Pricing",- "section_prices": "Prices","section_inventory": "Inventory","section_seo": "SEO","section_categorization": "Categorization","section_organization": "Organization","section_variants": "Variants",- "section_status": "Status","section_custom_fields": "Custom fields","publishing": {"title": "Publishing",@@ -935,7 +1191,6 @@"remove_channels_action": "Remove from sales channels…","add_tags_action": "Add tags…","remove_tags_action": "Remove tags…",- "delete_action": "Delete","status_sheet_title": "Set product status","status_sheet_description": "Pick the status to apply to the selected products.","categories_add_title": "Add to categories",@@ -976,7 +1231,6 @@"variants_empty": "No variants yet.","status_options": {"draft": "Draft",- "active": "Active","archived": "Archived"},"inventory": {@@ -1099,8 +1353,7 @@"title": "Discard unsaved prices?","message_close_one": "You have {{count}} unsaved price. Closing will discard it.","message_close_other": "You have {{count}} unsaved prices. Closing will discard them.",- "message_currency": "Switching currency will discard your unsaved prices.",- "confirm": "Discard changes"+ "message_currency": "Switching currency will discard your unsaved prices."}},"products_empty": "No products yet — add one to start editing prices.",@@ -1148,9 +1401,7 @@"details_title": "Details","edit_title": "Edit endpoint","url": "Destination URL",- "subscriptions": "Events",- "created_at": "Created at",- "updated_at": "Updated at"+ "subscriptions": "Events"},"save_secret_title": "Save your signing secret","save_secret_description": "Verify incoming webhook signatures with this key. We won't show it again.",@@ -1162,7 +1413,6 @@"redeliver": "Redeliver"},"status": {- "active": "Active","inactive": "Inactive","disabled": "Auto-disabled","disabled_reason": "Disabled: {{reason}}"@@ -1185,10 +1435,8 @@"row_counters_failed_other": "{{count}} failed"},"table": {- "name": "Name","url": "URL","events": "Events",- "status": "Status","recent_deliveries": "Last 7 days","last_delivery": "Last delivery","copy_url_aria": "Copy URL"@@ -1197,7 +1445,6 @@"events_count_one": "{{count}} event","events_count_other": "{{count}} events","events_custom_input_placeholder": "custom.event_name",- "events_add_cta": "Add","events_remove_aria": "Remove {{event}}","event_groups": {"asset": "Asset",@@ -1232,7 +1479,6 @@"deliveries": {"table": {"event": "Event",- "status": "Status","code": "Response","execution_time": "Duration","delivered_at": "Delivered at"@@ -1251,7 +1497,6 @@"detail_sheet_title": "Delivery details","detail": {"event": "Event",- "status": "Status","url": "Destination URL","delivered_at": "Delivered at","response_code": "Response code",@@ -1277,10 +1522,8 @@"empty_publishable": "No publishable keys yet.","empty_secret": "No secret keys yet.","table": {- "name": "Name","key": "Key","scopes": "Scopes",- "created_at": "Created at","last_used_at": "Last used"},"save_secret_title": "Save your secret key",@@ -1309,7 +1552,6 @@"stock_locations": {"add_sheet_title": "Add stock location","edit_sheet_title": "Edit stock location",- "section_address": "Address","search_placeholder": "Search stock locations…"},"allowed_origins": {@@ -1356,12 +1598,17 @@"no_customer": "No customer attached","usage": {"title": "Usage",- "amount": "Amount","used": "Used","remaining": "Remaining","issued_by": "Issued by"}}+ },+ "profile": {+ "title": "Profile",+ "subtitle": "Manage your personal details and admin language.",+ "personal_details": "Personal Details",+ "load_failed_title": "Couldn't load your profile"}},"invitation": {@@ -1452,10 +1699,13 @@"webhooks": "Webhooks","api_keys": "API keys","dashboard": "Dashboard"- }+ },+ "full_access_hint": "— read + write on every resource",+ "read_all_hint": "— read on every resource",+ "show_more_aria_one": "Show {{count}} more scope",+ "show_more_aria_other": "Show {{count}} more scopes"},"warning_treat_like_password": "Treat this key like a password. Store it in your secrets manager — we can't show it again.",- "done": "Done","revoke_confirm": {"title": "Revoke key?","message": "Any integration using this key will stop working immediately."@@ -1474,12 +1724,36 @@},"errors": {"failed_to_delete": "Failed to delete key",- "failed_to_update": "Failed to update key"+ "failed_to_update": "Failed to update key",+ "failed_to_create": "Failed to create key"},- "by_email": "by {{email}}"+ "by_email": "by {{email}}",+ "create_key_cta": "Create key",+ "validation": {+ "scope_required": "Pick at least one scope"+ }},"customers": {+ "table": {+ "search_placeholder": "Search by email or name…",+ "empty": "No customers yet"+ },+ "columns": {+ "orders": "Orders",+ "total_spent": "Total spent",+ "last_order": "Last order",+ "groups": "Groups",+ "newsletter": "Newsletter"+ },"groups": {+ "table": {+ "title": "Customer Groups",+ "search_placeholder": "Search by name…",+ "empty": "No customer groups yet"+ },+ "columns": {+ "customers": "Customers"+ },"bulk_add_action": "Add to group…","bulk_remove_action": "Remove from group…","bulk_added": "Added {{count}} customers to groups",@@ -1530,9 +1804,7 @@"last_order_placed": "Last order placed","orders_table": {"order": "Order",- "date": "Date",- "status": "Status",- "total": "Total"+ "date": "Date"},"no_internal_notes": "No internal notes","address": {@@ -1546,7 +1818,6 @@"title": "Store credit","empty": "No store credits issued","table": {- "amount": "Amount","used": "Used","remaining": "Remaining","category": "Category",@@ -1557,13 +1828,52 @@"add_description": "Issue store credit to this customer's account."}},- "new_sheet_description": "Customers created here have no password set. They'll get a magic link the first time they sign in."+ "new_sheet_description": "Customers created here have no password set. They'll get a magic link the first time they sign in.",+ "autocomplete": {+ "placeholder": "Search customers…",+ "empty": "No customers match"+ }},"orders": {+ "table": {+ "search_placeholder": "Search orders…",+ "empty": "No orders found"+ },+ "columns": {+ "number": "Number",+ "date": "Date",+ "customer": "Customer",+ "payment": "Payment",+ "fulfillment": "Fulfillment",+ "items": "Items",+ "tags": "Tags",+ "sku": "SKU"+ },+ "item_count_one": "{{count}} item",+ "item_count_other": "{{count}} items",+ "statuses": {+ "draft": "Draft",+ "placed": "Placed",+ "canceled": "Canceled"+ },+ "payment_statuses": {+ "balance_due": "Balance due",+ "credit_owed": "Credit owed",+ "failed": "Failed",+ "paid": "Paid",+ "void": "Void"+ },+ "fulfillment_statuses": {+ "backorder": "Backorder",+ "canceled": "Canceled",+ "partial": "Partial",+ "pending": "Pending",+ "ready": "Ready",+ "fulfilled": "Fulfilled"+ },"new": {"use_default_addresses": "Use customer's default billing & shipping addresses","add_variant": "Add a variant",- "section_discount": "Discount","items_table": {"variant": "Variant","sku": "SKU",@@ -1615,7 +1925,8 @@"description": "Search for a product variant to add to this order.","label": "Search variant","empty": "No variants found",- "sku_prefix": "SKU"+ "sku_prefix": "SKU",+ "placeholder": "Type product name or SKU (min 3 chars)…"},"edit_quantity": {"title": "Edit Quantity",@@ -1624,22 +1935,20 @@"items_table": {"item": "Item","price": "Price",- "qty": "Qty",- "tax": "Tax",- "discount": "Discount",- "total": "Total"+ "qty": "Qty"},"tracking": {"label": "Tracking Number","description": "Update the tracking number for this shipment.","prefix": "Tracking",- "shipped_prefix": "Shipped"+ "shipped_prefix": "Shipped",+ "edit_title": "Edit Tracking",+ "add_title": "Add Tracking"},"payments_table": {"number": "Number","method": "Method",- "state": "State",- "amount": "Amount"+ "state": "State"},"payment_form": {"description": "Charge a payment method against this order.",@@ -1647,7 +1956,11 @@"method_placeholder": "Choose a payment method","source_label": "Source","amount_help": "Leave blank to default to the outstanding balance.",- "capture_immediately": "Capture immediately"+ "capture_immediately": "Capture immediately",+ "title": "Add Payment",+ "source_requires_customer": "This payment method requires a saved source. Assign a customer to the order first.",+ "no_saved_cards": "Customer has no saved cards for this payment method.",+ "source_placeholder": "Choose a saved card…"},"summary": {"canceled_at": "Canceled at",@@ -1668,7 +1981,6 @@"applied_suffix": "applied","apply_balance": "Apply customer's available balance","requires_customer": "Requires a customer",- "apply_button": "Apply","apply_dialog_title": "Apply Gift Card","apply_dialog_description": "Enter a gift card code to apply to this order."},@@ -1678,7 +1990,12 @@},"no_customer": "No customer information","section_customer_note": "Special Instructions",- "section_internal_note": "Internal Note"+ "section_internal_note": "Internal Note",+ "completed_prefix": "Completed",+ "add_line_item": {+ "title": "Add Line Item"+ },+ "no_line_items": "No line items"}},"products": {@@ -1693,7 +2010,9 @@"file_types_hint": "PNG, JPG, WebP up to 10MB","edit_title": "Edit media","assigned_variants_label": "Assigned variants",- "assigned_variants_help": "Pick the variants this image represents. Leave blank to apply to all variants."+ "assigned_variants_help": "Pick the variants this image represents. Leave blank to apply to all variants.",+ "upload_failed": "Failed to upload {{name}}: {{message}}",+ "upload_status_failed": "Failed"},"seo": {"slug_placeholder": "product-url-handle",@@ -1748,7 +2067,8 @@"count_one": "{{count}} value","count_other": "{{count}} values","value_name_placeholder": "e.g. small",- "value_label_placeholder": "e.g. Small"+ "value_label_placeholder": "e.g. Small",+ "image_upload_failed": "Failed to upload image"},"variants": {"title": "Variants",@@ -1768,11 +2088,8 @@"orphan_warning_other": "{{count}} existing variants no longer match the selected options and will be removed on save:","orphan_warning": "{{count}} existing variant(s) will be removed on save:","keep": "Keep all",- "remove_confirm": "Remove","sheet": {"identity": "Identity",- "shipping": "Shipping",- "tax": "Tax","tax_category_placeholder": "Inherit from product"}},@@ -1791,6 +2108,24 @@"empty_title": "No custom fields yet","empty_description": "Define custom fields in Settings to start tracking structured details on products.","empty_cta": "Set up custom fields"+ },+ "columns": {+ "sku": "SKU",+ "price": "Price",+ "in_stock": "In Stock"+ },+ "price_lists": {+ "messages": {+ "created": "Price list created",+ "updated": "Price list updated",+ "deleted": "Price list deleted",+ "activated": "Price list activated",+ "deactivated": "Price list deactivated"+ },+ "errors": {+ "failed_to_activate": "Failed to activate price list",+ "failed_to_deactivate": "Failed to deactivate price list"+ }}},"payment_methods": {@@ -1802,6 +2137,24 @@"delete_confirm": {"title": "Delete payment method?","message": "{{name}} will no longer be available at checkout."+ },+ "title": "Payment Methods",+ "search_placeholder": "Search by name…",+ "empty": "No payment methods configured",+ "columns": {+ "storefront": "Storefront"+ },+ "storefront": {+ "visible": "Visible",+ "admin_only": "Admin only"+ },+ "status": {+ "disabled": "Disabled"+ },+ "messages": {+ "created": "Payment method created",+ "updated": "Payment method updated",+ "deleted": "Payment method deleted"}},"tax_categories": {@@ -1809,19 +2162,16 @@"create_description": "Group products by tax treatment (standard, reduced, exempt, …).","edit_description": "Update the name, code, or default flag.","create_label": "Create tax category",+ "search_placeholder": "Search by name…",+ "empty": "No tax categories yet","delete_confirm": {"title": "Delete tax category?","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."+ },+ "messages": {+ "created": "Tax category created",+ "updated": "Tax category updated",+ "deleted": "Tax category deleted"}},"custom_field_definitions": {@@ -1855,6 +2205,35 @@"delete_confirm": {"title": "Remove allowed origin?","message": "{{origin}} will no longer be able to call the admin API from a browser. Existing server-to-server requests are not affected."+ },+ "messages": {+ "added": "Allowed origin added",+ "updated": "Allowed origin updated",+ "removed": "Allowed origin removed"+ }+ },+ "stock_transfers": {+ "title": "Stock Transfers",+ "table": {+ "search_placeholder": "Search by number or reference…",+ "empty": "No stock transfers yet"+ },+ "columns": {+ "number": "Number",+ "direction": "Direction",+ "reference": "Reference"+ },+ "direction": {+ "internal": "Transfer between locations",+ "external_receive": "External receive"+ },+ "messages": {+ "recorded": "Stock transfer recorded",+ "deleted": "Stock transfer deleted"+ },+ "errors": {+ "failed_to_record": "Failed to record stock transfer",+ "failed_to_delete": "Failed to delete stock transfer"}},"stock_locations": {@@ -1862,6 +2241,19 @@"create_label": "Create stock location","create_description": "Add a warehouse, store, or pickup point to fulfill orders from.","edit_description": "Update name, address, pickup, or stock policies.",+ "search_placeholder": "Search by name…",+ "empty": "No stock locations yet",+ "columns": {+ "type": "Type",+ "location": "Location",+ "pickup": "Pickup",+ "default": "Default"+ },+ "badges": {+ "enabled": "Enabled",+ "inactive": "Inactive",+ "default": "Default"+ },"kinds": {"warehouse": "Warehouse","store": "Store",@@ -1901,6 +2293,74 @@"lb": "Pound (lb)","oz": "Ounce (oz)"}+ },+ "calculators": {+ "flat_percent_item_total": "Flat Percent",+ "flat_rate": "Flat Rate",+ "flexi_rate": "Flexi Rate",+ "per_item": "Per Item",+ "percent_on_line_item": "Percent Per Line Item",+ "price_sack": "Price Sack",+ "tiered_flat_rate": "Tiered Flat Rate",+ "tiered_percent": "Tiered Percent",+ "default_tax": "Default Tax",+ "digital_delivery": "Digital Delivery",+ "default_refund_amount": "Default Refund Amount"+ },+ "preferences": {+ "amount": "Amount",+ "flat_percent": "Flat Percent",+ "percent": "Percent",+ "first_item": "First Item Cost",+ "additional_item": "Additional Item Cost",+ "max_items": "Max Items",+ "minimal_amount": "Minimal Amount",+ "normal_amount": "Normal Amount",+ "discount_amount": "Discount Amount",+ "currency": "Currency",+ "base_amount": "Base Amount",+ "base_percent": "Base Percent",+ "preferred_amount": "Amount",+ "preferred_percent": "Percent"+ },+ "channels": {+ "messages": {+ "created": "Channel created",+ "updated": "Channel updated",+ "deleted": "Channel deleted"+ }+ },+ "customer_groups": {+ "messages": {+ "created": "Customer group created",+ "create_failed": "Failed to create customer group",+ "updated": "Customer group updated",+ "update_failed": "Failed to update customer group",+ "deleted": "Customer group deleted",+ "delete_failed": "Failed to delete customer group"+ },+ "autocomplete": {+ "placeholder": "Search customer groups…",+ "empty": "No customer groups match"+ }+ },+ "settings": {+ "webhooks": {+ "messages": {+ "updated": "Webhook endpoint updated",+ "removed": "Webhook endpoint removed"+ },+ "errors": {+ "send_test_failed": "Failed to send test webhook",+ "redeliver_failed": "Failed to redeliver"+ }+ }+ },+ "stock_items": {+ "messages": {+ "stock_updated": "Stock updated",+ "stock_item_deleted": "Stock item deleted"+ }}}}diff --git a/packages/dashboard/src/locales/fr.json b/packages/dashboard/src/locales/fr.jsonnew file mode 100644index 0000000000..a23b03526d--- /dev/null+++ b/packages/dashboard/src/locales/fr.json@@ -0,0 +1,2366 @@+{+ "admin": {+ "a11y": {+ "edit_media": "Modifier l'image",+ "delete_image": "Supprimer l'image"+ },+ "gift_cards": {+ "statuses": {+ "partially_redeemed": "Partiellement utilisée",+ "redeemed": "Utilisée",+ "canceled": "Annulée",+ "expired": "Expirée"+ },+ "columns": {+ "used": "Utilisé",+ "remaining": "Restant",+ "batch": "Lot",+ "customer": "Client",+ "issued_by": "Émise par"+ },+ "table": {+ "search_placeholder": "Rechercher par code…",+ "empty": "Aucune carte cadeau pour le moment"+ },+ "messages": {+ "created": "Carte cadeau créée",+ "create_failed": "Échec de la création de la carte cadeau",+ "updated": "Carte cadeau mise à jour",+ "update_failed": "Échec de la mise à jour de la carte cadeau",+ "deleted": "Carte cadeau supprimée",+ "delete_failed": "Échec de la suppression de la carte cadeau",+ "batch_created": "Lot de cartes cadeaux créé",+ "batch_create_failed": "Échec de la création du lot de cartes cadeaux"+ },+ "batch_autocomplete": {+ "placeholder": "Rechercher des lots par préfixe…",+ "empty": "Aucun lot correspondant"+ }+ },+ "branding": {+ "app_name": "Administration Spree",+ "powered_by": "Propulsé par Spree Commerce"+ },+ "nav": {+ "home": "Accueil",+ "account": "Compte",+ "orders": "Commandes",+ "draft_orders": "Commandes provisoires",+ "products": "Produits",+ "price_lists": "Listes de prix",+ "categories": "Catégories",+ "options": "Options",+ "transfers": "Transferts",+ "customers": "Clients",+ "customer_groups": "Groupes",+ "promotions": "Promotions",+ "gift_cards": "Cartes cadeaux",+ "reports": "Rapports",+ "settings": "Paramètres"+ },+ "settings_nav": {+ "groups": {+ "store": "Boutique",+ "payments": "Paiements et taxes",+ "fulfillment": "Traitement des commandes",+ "team": "Équipe et accès"+ },+ "items": {+ "store": "Boutique",+ "emails": "E-mails",+ "channels": "Canaux de vente",+ "payment_methods": "Modes de paiement",+ "tax_categories": "Catégories de taxe",+ "markets": "Marchés",+ "stock_locations": "Emplacements de stock",+ "custom_field_definitions": "Champs personnalisés",+ "staff": "Personnel",+ "api_keys": "Clés API",+ "webhooks": "Webhooks",+ "allowed_origins": "Origines autorisées",+ "profile": "Profil"+ }+ },+ "fields": {+ "products_count": {+ "label": "Produits"+ },+ "prices_count": {+ "label": "Prix"+ },+ "customer_id": {+ "label": "Client"+ },+ "role_id": {+ "label": "Rôle"+ },+ "role_ids": {+ "label": "Rôles"+ },+ "tax_category_id": {+ "label": "Catégorie de taxe"+ },+ "promotion": {+ "name": {+ "placeholder": "Soldes d'été"+ },+ "description": {+ "placeholder": "Description interne (facultatif)"+ },+ "kind": {+ "label": "Comment cette promotion est-elle appliquée ?"+ },+ "code": {+ "placeholder": "ETE2026"+ },+ "multi_codes": {+ "label": "Générer un lot de codes uniques",+ "help": "Utile pour les codes à usage unique — chaque client utilise un code différent."+ },+ "number_of_codes": {+ "label": "Nombre de codes",+ "placeholder": "100"+ },+ "code_prefix": {+ "label": "Préfixe de code (facultatif)",+ "placeholder": "VIP",+ "help": "Chaque code généré commencera par ce préfixe."+ },+ "starts_at": {+ "placeholder": "Aucune date de début"+ },+ "expires_at": {+ "placeholder": "Aucune expiration"+ },+ "usage_limit": {+ "label": "Limite d'utilisation",+ "placeholder": "Illimité"+ },+ "match_policy": {+ "label": "Règle de correspondance"+ }+ },+ "custom_field_definition": {+ "label": {+ "label": "Libellé",+ "placeholder": "ex. Matière"+ },+ "namespace": {+ "label": "Espace de noms",+ "placeholder": "custom"+ },+ "key": {+ "label": "Clé",+ "placeholder": "ex. matiere",+ "invalid_format": "Lettres, chiffres et tirets bas uniquement"+ },+ "field_type": {+ "label": "Type",+ "read_only_help": "Le type ne peut pas être modifié une fois que des valeurs existent — le changer rendrait les valeurs enregistrées inexploitables.",+ "options": {+ "short_text": "Texte court",+ "long_text": "Texte long",+ "rich_text": "Texte enrichi",+ "number": "Nombre",+ "boolean": "Booléen",+ "json": "JSON"+ }+ },+ "resource_type": {+ "label": "S'applique à",+ "read_only_help": "Le propriétaire ne peut pas être modifié une fois que des valeurs existent pour ce champ.",+ "options": {+ "Spree::Product": "Produits",+ "Spree::Variant": "Variantes",+ "Spree::Order": "Commandes",+ "Spree::User": "Clients",+ "Spree::Category": "Catégories",+ "Spree::OptionType": "Types d'options"+ }+ },+ "storefront_visible": {+ "label": "Visible sur la boutique",+ "column_label": "Boutique"+ }+ },+ "tax_category": {+ "name": {+ "placeholder": "ex. Taux réduit"+ },+ "tax_code": {+ "label": "Code de taxe",+ "placeholder": "Code du fournisseur de taxe externe (Avalara, etc.)"+ },+ "description": {+ "placeholder": "Description interne facultative"+ },+ "is_default": {+ "label": "Par défaut",+ "help": "Activer cette option rétrograde la valeur par défaut précédente. Les produits sans catégorie explicite utilisent celle-ci."+ }+ },+ "allowed_origin": {+ "origin": {+ "label": "Origine",+ "placeholder": "https://admin.example.com",+ "help": "Schéma + hôte simples (+ port facultatif). Aucun chemin, requête ou fragment."+ }+ },+ "channel": {+ "name": {+ "placeholder": "ex. POS, Vente en gros, Meta Shop"+ },+ "code": {+ "label": "Code",+ "placeholder": "Dérivé automatiquement du nom",+ "help": "Identifiant stable utilisé par les clients de l'API via l'en-tête X-Spree-Channel et pour l'attribution des commandes. Laissez vide pour le dériver automatiquement du nom. Lettres minuscules, chiffres, traits d'union, tirets bas."+ },+ "active": {+ "label": "Actif",+ "help": "Les canaux de vente inactifs cessent d'accepter les commandes et ne correspondent pas à l'en-tête X-Spree-Channel."+ },+ "default": {+ "label": "Canal par défaut",+ "help": "Exactement un canal par boutique est défini par défaut. Utilisé comme solution de repli lorsqu'aucun canal n'est sélectionné et comme cible de publication automatique pour les nouveaux produits."+ },+ "order_routing_strategy": {+ "label": "Stratégie d'acheminement des commandes",+ "help": "Remplace la stratégie d'acheminement définie au niveau de la boutique pour les commandes attribuées à ce canal. Laissez vide pour hériter.",+ "inherit": "Hériter de la boutique",+ "options": {+ "Spree::OrderRouting::Strategy::Rules": "Règles (ordonnées)",+ "Spree::OrderRouting::Strategy::Legacy": "Héritée"+ }+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "Mot de passe"+ },+ "password_confirmation": {+ "label": "Confirmer le mot de passe"+ }+ },+ "customer_group": {+ "name": {+ "placeholder": "ex. Clients VIP"+ },+ "description": {+ "placeholder": "Description interne facultative"+ }+ },+ "price_list": {+ "name": {+ "label": "Nom",+ "placeholder": "ex. Vente en gros UE",+ "help": "Libellé interne — jamais affiché aux clients."+ },+ "description": {+ "label": "Description",+ "placeholder": "Description interne facultative"+ },+ "starts_at": {+ "label": "Début",+ "placeholder": "Immédiatement",+ "help": "Moment où cette liste devient active. Laissez vide pour démarrer immédiatement à l'activation."+ },+ "ends_at": {+ "label": "Fin",+ "placeholder": "Jamais",+ "help": "Laissez vide pour aucune date de fin."+ },+ "match_policy": {+ "label": "Règle de correspondance",+ "all": "Toutes les règles doivent correspondre",+ "any": "N'importe quelle règle peut correspondre"+ },+ "status": {+ "active": "Active",+ "scheduled": "Programmée",+ "inactive": "Inactive",+ "draft": "Brouillon"+ }+ },+ "price_rule": {+ "customers": {+ "label": "Clients",+ "help": "Laissez vide pour appliquer cette règle à tous les clients connectés."+ },+ "customer_groups": {+ "label": "Groupes de clients",+ "help": "Laissez vide pour appliquer cette règle à tous les clients quel que soit leur groupe."+ },+ "markets": {+ "label": "Marchés",+ "help": "Laissez vide pour appliquer cette règle sur tous les marchés."+ }+ },+ "stock_location": {+ "name": {+ "placeholder": "Entrepôt de Brooklyn"+ },+ "admin_name": {+ "label": "Nom interne",+ "placeholder": "Facultatif — affiché uniquement dans l'administration"+ },+ "kind": {+ "label": "Type"+ },+ "active": {+ "label": "Actif",+ "help": "Les emplacements inactifs n'apparaissent pas dans la sélection d'expédition."+ },+ "default": {+ "label": "Emplacement par défaut",+ "help": "Les nouveaux articles en stock sont propagés ici. Un seul emplacement peut être défini par défaut."+ },+ "backorderable_default": {+ "label": "Réapprovisionnable par défaut",+ "help": "Les nouveaux articles en stock autorisent par défaut les commandes en attente en cas de rupture de stock."+ },+ "propagate_all_variants": {+ "label": "Créer automatiquement des articles en stock pour toutes les variantes",+ "help": "Créer des articles en stock à cet emplacement pour chaque variante de produit."+ },+ "pickup_enabled": {+ "label": "Autoriser le retrait par le client",+ "help": "Les clients peuvent retirer leurs commandes à cet emplacement lors du paiement."+ },+ "pickup_stock_policy": {+ "label": "Règle de stock"+ },+ "pickup_ready_in_minutes": {+ "label": "Prêt dans (minutes)",+ "placeholder": "60"+ },+ "pickup_instructions": {+ "label": "Instructions de retrait",+ "placeholder": "Où le client doit se rendre pour récupérer sa commande."+ }+ },+ "payment_method": {+ "type": {+ "label": "Fournisseur",+ "placeholder": "Sélectionner un fournisseur"+ },+ "name": {+ "placeholder": "ex. Carte de crédit (Stripe)"+ },+ "description": {+ "placeholder": "Description visible par le client affichée lors du paiement"+ },+ "storefront_visible": {+ "label": "Visible sur la boutique"+ },+ "active": {+ "label": "Active",+ "help": "Les méthodes inactives sont masquées lors du paiement."+ },+ "auto_capture": {+ "label": "Capture automatique",+ "help": "Capturer les fonds automatiquement à l'autorisation. Si désactivé, vous devez capturer manuellement."+ },+ "provider_configuration": "Configuration du fournisseur"+ },+ "market": {+ "name": {+ "placeholder": "ex. Europe"+ },+ "currency": {+ "label": "Devise",+ "help": "Devise ISO 4217 utilisée pour tous les prix de ce marché."+ },+ "default_locale": {+ "label": "Langue par défaut",+ "help": "Langue de la boutique pour les acheteurs de ce marché."+ },+ "supported_locales": {+ "label": "Langues prises en charge",+ "help": "Langues supplémentaires vers lesquelles les acheteurs peuvent basculer. La langue par défaut est toujours incluse."+ },+ "country_isos": {+ "label": "Pays",+ "help": "Choisissez les pays couverts par ce marché. Chaque pays ne peut appartenir qu'à un seul marché par boutique."+ },+ "tax_inclusive": {+ "label": "Prix taxes comprises",+ "help": "Afficher les prix taxes comprises. Courant sur les marchés de l'UE."+ },+ "default": {+ "label": "Marché par défaut",+ "help": "Les acheteurs dont le pays est inconnu voient ce marché. Un seul peut être défini par défaut par boutique."+ }+ },+ "option_type": {+ "name": {+ "label": "Nom interne",+ "placeholder": "ex. taille-chemise",+ "help": "Identifiant en minuscules. Doit être unique dans la boutique."+ },+ "label": {+ "label": "Libellé",+ "placeholder": "ex. Taille de chemise",+ "help": "Affiché aux clients sur la boutique."+ },+ "kind": {+ "label": "Type",+ "help": "Contrôle la façon dont l'option s'affiche sur la boutique. L'échantillon de couleur affiche une couleur hexadécimale ; les boutons affichent une image miniature."+ },+ "filterable": {+ "label": "Filtrable",+ "help": "Afficher cette option comme filtre dans les listes de produits de la boutique."+ }+ },+ "option_value": {+ "name": {+ "label": "Nom interne",+ "placeholder": "ex. petit"+ },+ "label": {+ "label": "Libellé",+ "placeholder": "ex. Petit"+ },+ "color_code": {+ "label": "Couleur"+ },+ "image": {+ "label": "Image"+ }+ },+ "variant": {+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUIT-ROUGE-S"+ },+ "barcode": {+ "label": "Code-barres"+ },+ "weight": {+ "label": "Poids"+ },+ "weight_unit": {+ "label": "Unité"+ },+ "height": {+ "label": "Hauteur"+ },+ "width": {+ "label": "Largeur"+ },+ "depth": {+ "label": "Profondeur"+ },+ "dimensions_unit": {+ "label": "Unité"+ }+ },+ "api_key": {+ "name": {+ "label": "Nom",+ "placeholder": "Intégration backend, Boutique prod, …",+ "required": "Le nom est requis"+ },+ "key_type": {+ "label": "Type"+ },+ "scopes": {+ "label": "Portées"+ }+ },+ "store": {+ "name": {+ "label": "Nom de la boutique"+ },+ "preferred_admin_locale": {+ "label": "Langue de l'administration",+ "placeholder": "Utiliser la langue par défaut"+ },+ "preferred_timezone": {+ "label": "Fuseau horaire",+ "placeholder": "Sélectionner un fuseau horaire"+ },+ "preferred_unit_system": {+ "label": "Système d'unités"+ },+ "preferred_weight_unit": {+ "label": "Unité de poids"+ },+ "mail_from_address": {+ "label": "Adresse d'expéditeur",+ "placeholder": "[email protected]",+ "help": "Utilisée comme adresse d'expéditeur sur chaque e-mail transactionnel."+ },+ "customer_support_email": {+ "label": "E-mail du support client",+ "placeholder": "[email protected]",+ "help": "Adresse de réponse affichée aux clients dans les e-mails de la boutique."+ },+ "new_order_notifications_email": {+ "label": "Notifications de nouvelles commandes",+ "placeholder": "[email protected]",+ "help": "Destinataire des notifications « nouvelle commande passée ». Laissez vide pour désactiver."+ },+ "preferred_send_consumer_transactional_emails": {+ "label": "Envoyer les e-mails transactionnels aux clients",+ "help": "Si désactivé, aucun e-mail de confirmation de commande, d'expédition ou de remboursement n'est envoyé."+ },+ "mailer_logo": {+ "label": "Logo des e-mails",+ "help": "PNG ou JPG avec un fond transparent. Intégré dans les en-têtes des e-mails transactionnels."+ }+ },+ "webhook_endpoint": {+ "name": {+ "label": "Nom",+ "placeholder": "ex. Pipeline de commandes",+ "help": "Libellé facultatif affiché dans cette liste."+ },+ "url": {+ "label": "URL de destination",+ "placeholder": "https://example.com/webhooks"+ },+ "active": {+ "label": "Actif",+ "help": "Les points de terminaison inactifs ne reçoivent pas de livraisons."+ },+ "subscriptions": {+ "label": "Événements",+ "help": "Sélectionnez les événements qui doivent déclencher un webhook. Ne choisissez rien pour recevoir tous les événements."+ }+ },+ "product": {+ "name": {+ "label": "Nom",+ "placeholder": "Nom du produit"+ },+ "description": {+ "label": "Description",+ "placeholder": "Rédigez une description du produit…"+ },+ "make_active_at": {+ "label": "Activer le"+ },+ "available_on": {+ "label": "Disponible le"+ },+ "discontinue_on": {+ "label": "Arrêter le"+ },+ "category_ids": {+ "label": "Catégories"+ },+ "channels": {+ "label": "Canaux de vente"+ },+ "tags": {+ "label": "Étiquettes"+ }+ },+ "product_publication": {+ "published_at": {+ "label": "Publier à partir du",+ "placeholder": "En ligne immédiatement",+ "help": "Laissez vide pour une mise en ligne immédiate."+ },+ "unpublished_at": {+ "label": "Dépublier le",+ "placeholder": "Jamais",+ "help": "Laissez vide pour garder le produit listé indéfiniment."+ }+ },+ "gift_card": {+ "code": {+ "label": "Code",+ "help": "Laissez vide pour générer automatiquement. Pour les lots, ceci devient le préfixe."+ },+ "amount": {+ "label": "Montant"+ },+ "currency": {+ "label": "Devise"+ },+ "expires_at": {+ "label": "Expire",+ "placeholder": "Aucune expiration"+ },+ "customer_id": {+ "label": "Client"+ },+ "quantity": {+ "label": "Quantité",+ "help": "1 émet une seule carte. Plus de 1 émet un lot avec des codes générés automatiquement."+ }+ },+ "customer": {+ "tags": {+ "label": "Étiquettes"+ },+ "customer_groups": {+ "label": "Groupes de clients"+ },+ "accepts_email_marketing": {+ "label": "Abonné au marketing"+ },+ "internal_note": {+ "label": "Note interne",+ "placeholder": "Contexte réservé au personnel à propos de ce client…"+ }+ },+ "store_credit": {+ "amount": {+ "label": "Montant"+ },+ "currency": {+ "label": "Devise"+ },+ "category_id": {+ "label": "Catégorie"+ },+ "memo": {+ "label": "Note",+ "placeholder": "Raison de l'émission de cet avoir"+ }+ },+ "order": {+ "email": {+ "label": "Ou utiliser un e-mail d'invité",+ "placeholder": "[email protected]"+ },+ "customer_note": {+ "label": "Note du client (visible par le client)"+ },+ "internal_note": {+ "label": "Note interne (personnel uniquement)"+ },+ "coupon_code": {+ "label": "Code promo",+ "placeholder": "Facultatif"+ },+ "channel": {+ "label": "Canal de vente",+ "placeholder": "Utiliser la valeur par défaut de la boutique",+ "help": "Attribuer la commande à un canal de vente spécifique. Par défaut, le canal en ligne de la boutique."+ }+ },+ "media": {+ "alt": {+ "label": "Texte alternatif",+ "placeholder": "Décrivez l'image pour l'accessibilité et le référencement"+ }+ },+ "profile": {+ "email": {+ "label": "E-mail"+ },+ "first_name": {+ "label": "Prénom"+ },+ "last_name": {+ "label": "Nom"+ },+ "selected_locale": {+ "label": "Langue",+ "help": "Langue utilisée dans tout le tableau de bord d'administration. N'affecte que ce que vous voyez."+ }+ }+ },+ "promotions": {+ "rule_types_empty": "Aucun type de règle enregistré.",+ "rule_types_all_used": "Tous les types de règle disponibles sont déjà appliqués à cette promotion.",+ "generate_code": {+ "title": "Générer un code aléatoire"+ },+ "kinds": {+ "coupon_code": "Code de réduction",+ "automatic": "Automatique (sans code)"+ },+ "match_policies": {+ "all": "Toutes les règles doivent correspondre",+ "any": "Au moins une règle doit correspondre",+ "all_hint": "Toutes les règles doivent correspondre.",+ "any_hint": "Au moins une règle doit correspondre."+ },+ "rules_card": {+ "title": "Règles",+ "description": "Conditions qui déterminent si la promotion s'applique.",+ "empty": "Aucune règle. Sans règle, la promotion s'applique toujours (sous réserve de la planification et de la limite d'utilisation).",+ "add_rule": "Ajouter une règle"+ },+ "validation": {+ "code_required": "Le code est requis (ou cliquez sur Générer)",+ "prefix_required": "Le préfixe est requis pour les lots de plusieurs codes",+ "number_of_codes_required": "Choisissez le nombre de codes à générer",+ "expiry_after_start": "La date d'expiration doit être postérieure à la date de début"+ },+ "delete_confirm": {+ "title": "Supprimer la promotion ?",+ "message": "{{name}} sera supprimée définitivement. Les promotions référencées par des commandes finalisées ne peuvent pas être supprimées.",+ "default_name": "Cette promotion"+ },+ "rules": {+ "country": {+ "label": "Pays",+ "search_placeholder": "Rechercher des pays…",+ "empty": "Aucun pays ne correspond"+ },+ "product": {+ "label": "Produits",+ "search_placeholder": "Rechercher des produits par nom…",+ "empty": "Aucun produit ne correspond",+ "match_policy": {+ "any": {+ "label": "L'un de ces produits",+ "description": "La commande doit en contenir au moins un."+ },+ "all": {+ "label": "Tous ces produits",+ "description": "La commande doit contenir chaque produit."+ },+ "none": {+ "label": "Aucun de ces produits",+ "description": "La commande ne doit en contenir aucun."+ }+ }+ },+ "category": {+ "label": "Catégories",+ "search_placeholder": "Rechercher des catégories…",+ "empty": "Aucune catégorie ne correspond",+ "match_policy": {+ "any": {+ "label": "L'une de ces catégories",+ "description": "La commande doit contenir un produit appartenant à au moins une."+ },+ "all": {+ "label": "Toutes ces catégories",+ "description": "La commande doit contenir un produit dans chaque catégorie."+ }+ }+ },+ "customer_group": {+ "label": "Groupes de clients",+ "search_placeholder": "Rechercher des groupes de clients…",+ "empty": "Aucun groupe de clients ne correspond"+ },+ "customer": {+ "label": "Clients",+ "search_placeholder": "Rechercher des clients par nom ou e-mail…",+ "empty": "Aucun client ne correspond"+ }+ },+ "table": {+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucune promotion pour le moment",+ "no_end": "Sans fin"+ },+ "code": {+ "automatic": "Automatique",+ "multi": "multi"+ },+ "basics_card": {+ "title": "Informations de base"+ },+ "trigger_card": {+ "title": "Déclencheur"+ },+ "schedule_card": {+ "title": "Planification et limites"+ },+ "trigger_summary": {+ "multi_code": "Coupon multi-codes ({{count}} codes)",+ "multi_code_with_prefix": "Coupon multi-codes ({{count}} codes avec le préfixe « {{prefix}} »)",+ "show_codes": "Afficher les codes",+ "single_code": "Code de coupon unique :",+ "locked_help": "Les paramètres de déclenchement ne peuvent pas être modifiés après la création. Créez une nouvelle promotion pour les changer."+ },+ "remove_rule_confirm": {+ "title": "Supprimer la règle ?",+ "message": "Supprimée lorsque vous enregistrez la promotion."+ },+ "rule_summary": {+ "product_count": "{{count}} produits",+ "category_count": "{{count}} catégories",+ "customer_count": "{{count}} clients"+ },+ "rule_picker": {+ "title": "Ajouter une règle",+ "description": "Choisissez un type de règle à configurer."+ },+ "rule_edit": {+ "description": "Ajustez les paramètres de la règle.",+ "no_options": "Cette règle n'a aucune option configurable — sa seule présence applique la contrainte."+ },+ "actions_card": {+ "description": "Ce qui se passe lorsque la promotion s'applique.",+ "empty": "Aucune action pour l'instant. Une promotion sans actions n'a aucun effet lorsqu'elle est appliquée.",+ "add_action": "Ajouter une action"+ },+ "remove_action_confirm": {+ "title": "Supprimer l'action ?",+ "message": "Supprimée lorsque vous enregistrez la promotion."+ },+ "action_summary": {+ "variant_count": "{{count}} variantes"+ },+ "action_picker": {+ "title": "Ajouter une action",+ "description": "Choisissez ce qui doit se passer lorsque la promotion s'applique."+ },+ "action_edit": {+ "description": "Configurez les paramètres de l'action.",+ "no_options": "Cette action n'a aucune option configurable."+ },+ "coupon_codes": {+ "title": "Codes de coupon",+ "description": "Codes générés automatiquement pour cette promotion. En lecture seule — régénérez-les en modifiant le paramètre du nombre de codes de la promotion.",+ "description_with_count": "{{count}} codes générés automatiquement. En lecture seule — régénérez-les en modifiant le paramètre du nombre de codes de la promotion.",+ "empty": "Aucun code généré pour l'instant.",+ "unused": "Inutilisé",+ "used": "Utilisé",+ "export_csv": "Exporter en CSV",+ "states": {+ "used": "Utilisé",+ "partially_used": "Partiellement utilisé"+ }+ },+ "rule_types": {+ "category": {+ "name": "Catégories",+ "description": "La commande contient des produits des catégories spécifiées"+ },+ "country": {+ "name": "Pays",+ "description": "Limiter aux commandes dont l'adresse de livraison se trouve dans un pays spécifique"+ },+ "currency": {+ "name": "Devise",+ "description": "Limiter aux commandes dans une devise spécifique"+ },+ "customer": {+ "name": "Clients",+ "description": "Disponible uniquement pour les clients spécifiés"+ },+ "customer_group": {+ "name": "Groupe(s) de clients",+ "description": "Disponible uniquement pour les clients des groupes de clients spécifiés"+ },+ "customer_logged_in": {+ "name": "Uniquement les clients connectés",+ "description": "Disponible uniquement pour les clients connectés"+ },+ "first_order": {+ "name": "Première commande",+ "description": "Doit être la première commande du client"+ },+ "item_total": {+ "name": "Total des articles",+ "description": "Le total de la commande répond à ces critères"+ },+ "one_use_per_user": {+ "name": "Une utilisation par utilisateur",+ "description": "Une seule utilisation par utilisateur"+ },+ "option_value": {+ "name": "Valeur(s) d'option",+ "description": "La commande contient des produits avec des valeurs d'option correspondantes"+ },+ "product": {+ "name": "Produit(s)",+ "description": "La commande contient le(s) produit(s) spécifié(s)"+ }+ },+ "action_types": {+ "create_adjustment": {+ "name": "Créer un ajustement sur l'ensemble de la commande",+ "description": "Crée un ajustement de crédit promotionnel sur la commande"+ },+ "create_item_adjustments": {+ "name": "Créer un ajustement par ligne d'article",+ "description": "Crée un ajustement de crédit promotionnel sur une ligne d'article"+ },+ "create_line_items": {+ "name": "Créer des lignes d'article",+ "description": "Ajoute au panier la quantité spécifiée de la variante"+ },+ "free_shipping": {+ "name": "Livraison gratuite",+ "description": "Rend gratuites toutes les expéditions de la commande"+ }+ },+ "messages": {+ "action_added": "Action ajoutée",+ "action_updated": "Action mise à jour",+ "action_removed": "Action supprimée",+ "rule_added": "Règle ajoutée",+ "rule_updated": "Règle mise à jour",+ "rule_removed": "Règle supprimée"+ },+ "errors": {+ "failed_to_add_action": "Échec de l'ajout de l'action",+ "failed_to_update_action": "Échec de la mise à jour de l'action",+ "failed_to_remove_action": "Échec de la suppression de l'action",+ "failed_to_add_rule": "Échec de l'ajout de la règle",+ "failed_to_update_rule": "Échec de la mise à jour de la règle",+ "failed_to_remove_rule": "Échec de la suppression de la règle"+ }+ },+ "components": {+ "market_combobox": {+ "search_placeholder": "Rechercher des marchés…",+ "empty": "Aucun marché ne correspond"+ },+ "custom_fields_card": {+ "set_up": "Configurer",+ "empty_title": "Aucun champ personnalisé pour le moment",+ "empty_description": "Suivez des informations structurées telles que la matière, la coupe ou les instructions d'entretien.",+ "not_yet_set": "{{count}} sur {{total}} pas encore renseignés"+ },+ "custom_fields": {+ "title": "Champs personnalisés",+ "new_definition_title": "Nouveau champ personnalisé",+ "definition_created_title": "Définition créée",+ "definition_created_toast": "Définition créée",+ "definition_created_hint": "Vous pouvez définir sa valeur maintenant ou d'abord définir un autre champ.",+ "empty_title": "Aucun champ personnalisé défini pour {{resource}}",+ "empty_description": "Définissez un champ personnalisé pour stocker des informations typées et structurées avec vos enregistrements.",+ "create_definition": "Créer une définition",+ "values_saved": "Champs personnalisés enregistrés",+ "values_save_failed": "Échec de l'enregistrement des champs personnalisés",+ "admin_only": "Administrateurs uniquement",+ "add_another_field": "Ajouter un autre champ",+ "create_another": "En créer un autre",+ "set_values": "Définir les valeurs"+ },+ "adjustment_action_editor": {+ "calculator_label": "Calculateur",+ "loading_calculators": "Chargement des calculateurs…",+ "select_calculator": "Sélectionner un calculateur",+ "no_extra_settings": "Ce calculateur n'a aucun paramètre supplémentaire.",+ "settings_label": "Paramètres du calculateur"+ }+ },+ "pages": {+ "home": {+ "top_products": "Meilleurs produits",+ "top_products_description": "Produits les plus vendus de votre boutique.",+ "title": "Tableau de bord",+ "subtitle": "Aperçu des performances de votre boutique",+ "metrics": {+ "sales": "Ventes totales",+ "orders": "Commandes totales",+ "avg_order_value": "Panier moyen"+ },+ "metric_short": {+ "sales": "Ventes",+ "orders": "Commandes",+ "avg_order_value": "Panier moy."+ },+ "columns": {+ "product": "Produit",+ "price": "Prix",+ "sold": "Vendu"+ }+ },+ "staff": {+ "title": "Équipe",+ "subtitle": "Gérez les collaborateurs et les rôles d'administration",+ "invite_cta": "Inviter un collaborateur",+ "members_section": "Membres",+ "invitations_section": "Invitations en attente",+ "empty": "Aucun membre pour le moment",+ "empty_description": "Invitez un collaborateur à participer à cette boutique.",+ "table": {+ "member": "Membre",+ "roles": "Rôles",+ "role": "Rôle"+ },+ "invite_sheet": {+ "title": "Inviter un collaborateur",+ "description": "Nous lui enverrons par e-mail un lien pour définir son mot de passe."+ },+ "edit_sheet": {+ "title": "Modifier le collaborateur"+ },+ "actions": {+ "resend": "Renvoyer",+ "remove": "Retirer de l'équipe"+ },+ "messages": {+ "revoked": "Invitation révoquée",+ "updated": "Équipe mise à jour",+ "removed": "Retiré de l'équipe"+ }+ },+ "channels": {+ "title": "Canaux de vente",+ "empty_message": "Aucun canal de vente pour le moment",+ "add_cta": "Nouveau canal de vente",+ "add_sheet_title": "Ajouter un canal de vente",+ "edit_sheet_title": "Modifier le canal de vente",+ "create_label": "Créer un canal de vente",+ "create_description": "Les canaux de vente regroupent les commandes et les fiches produits — « en ligne », « point de vente », une intégration de marketplace, etc.",+ "edit_description": "Renommez un canal de vente ou mettez-le en pause. Les canaux de vente inactifs cessent d'accepter les commandes.",+ "delete_confirm": {+ "title": "Supprimer le canal de vente ?",+ "message": "{{name}} sera supprimé. Les produits et commandes qui y sont rattachés perdront leur référence de canal de vente."+ },+ "search_placeholder": "Rechercher des canaux de vente…",+ "no_channels_found": "Aucun canal de vente trouvé"+ },+ "customers": {+ "new_cta": "Nouveau client",+ "create_label": "Créer un client",+ "edit_sheet_title": "Modifier le client",+ "groups_cta": "Groupes de clients",+ "groups": {+ "title": "Groupes de clients",+ "add_cta": "Ajouter un groupe de clients",+ "edit_sheet_title": "Modifier le groupe de clients",+ "add_sheet_title": "Ajouter un groupe de clients"+ },+ "detail": {+ "stat_total_spent": "Total dépensé",+ "stat_orders": "Commandes",+ "stat_avg_order_value": "Valeur moyenne des commandes",+ "section_profile": "Profil",+ "section_addresses": "Adresses",+ "section_orders": "Commandes",+ "section_store_credit": "Avoir en boutique",+ "section_internal_note": "Note interne",+ "section_tags": "Étiquettes",+ "addresses_empty": "Aucune adresse enregistrée.",+ "orders_empty": "Aucune commande pour le moment.",+ "store_credit_empty": "Aucun avoir en boutique émis.",+ "add_address": "Ajouter une adresse",+ "edit_address": "Modifier l'adresse",+ "issue_credit": "Émettre un avoir en boutique",+ "edit_credit": "Modifier l'avoir en boutique"+ }+ },+ "orders": {+ "drafts_title": "Brouillons de commandes",+ "new": {+ "title": "Nouvelle commande",+ "section_customer": "Client",+ "section_items": "Articles",+ "section_billing": "Facturation",+ "section_notes": "Notes",+ "section_summary": "Récapitulatif",+ "add_line_item": "Ajouter une ligne d'article",+ "select_customer": "Sélectionner un client",+ "search_variant": "Rechercher une variante…"+ },+ "detail": {+ "section_summary": "Récapitulatif",+ "section_items": "Articles",+ "section_payments": "Paiements",+ "section_shipments": "Expéditions",+ "section_customer": "Client",+ "section_shipping_address": "Adresse de livraison",+ "section_billing_address": "Adresse de facturation",+ "section_internal_note": "Note interne",+ "section_customer_note": "Note du client",+ "section_history": "Historique",+ "summary": {+ "created_by": "Créée par",+ "market": "Marché",+ "locale": "Langue",+ "channel": "Canal de vente",+ "ip_address": "Adresse IP"+ },+ "empty_payments": "Aucun paiement pour le moment.",+ "empty_shipments": "Aucune expédition pour le moment.",+ "empty_history": "Aucun historique pour le moment.",+ "actions": {+ "approve": "Approuver",+ "cancel": "Annuler la commande",+ "resume": "Reprendre",+ "refund": "Rembourser",+ "capture": "Capturer",+ "void": "Annuler",+ "mark_paid": "Marquer comme payée",+ "ship": "Marquer comme expédiée"+ },+ "dialogs": {+ "cancel_title": "Annuler la commande ?",+ "approve_title": "Approuver la commande ?",+ "refund_title": "Rembourser le paiement ?"+ }+ }+ },+ "products": {+ "add_cta": "Ajouter un produit",+ "new": {+ "title": "Nouveau produit",+ "description": "Configurez votre produit — ajoutez des variantes, des prix, des stocks, des médias et des champs personnalisés, puis enregistrez en une seule fois.",+ "save_label": "Créer le produit",+ "create_succeeded": "Produit créé",+ "create_failed": "Échec de la création du produit",+ "preview_slug_placeholder": "slug-de-votre-produit"+ },+ "edit": {+ "bulk_prices": {+ "no_variants": "Ajoutez au moins une variante pour commencer à modifier les prix."+ }+ },+ "section_basics": "Informations de base",+ "section_media": "Médias",+ "section_pricing": "Tarification",+ "section_inventory": "Stock",+ "section_seo": "SEO",+ "section_categorization": "Catégorisation",+ "section_organization": "Organisation",+ "section_variants": "Variantes",+ "section_custom_fields": "Champs personnalisés",+ "publishing": {+ "title": "Publication",+ "manage_cta": "Gérer",+ "manage_title": "Gérer les canaux de vente",+ "manage_description": "Choisissez les canaux de vente sur lesquels ce produit est répertorié. Désactivez un canal pour le retirer partout.",+ "empty": "Pas encore répertorié sur un canal de vente.",+ "no_channels": "Aucun canal de vente disponible. Créez-en un dans Paramètres → Canaux de vente.",+ "inactive_marker": "Inactif",+ "status_live": "En ligne",+ "status_scheduled": "Planifié",+ "status_hidden": "Masqué",+ "status_not_available": "Indisponible",+ "caption_live": "Visible par les clients dès maintenant",+ "caption_scheduled": "Mise en ligne le {{date}}",+ "caption_hidden_after": "Retiré le {{date}}",+ "caption_unpublished": "A été masqué le {{date}}",+ "caption_window": "En ligne du {{start}} au {{end}}",+ "caption_not_available": "Masqué — le produit est {{product_status}}"+ },+ "clone_succeeded": "Produit dupliqué",+ "clone_failed": "Échec de la duplication du produit",+ "delete_succeeded": "Produit supprimé",+ "delete_failed": "Échec de la suppression du produit",+ "bulk": {+ "set_status_action": "Définir le statut…",+ "add_categories_action": "Ajouter aux catégories…",+ "remove_categories_action": "Retirer des catégories…",+ "add_channels_action": "Ajouter aux canaux de vente…",+ "remove_channels_action": "Retirer des canaux de vente…",+ "add_tags_action": "Ajouter des étiquettes…",+ "remove_tags_action": "Retirer des étiquettes…",+ "status_sheet_title": "Définir le statut du produit",+ "status_sheet_description": "Choisissez le statut à appliquer aux produits sélectionnés.",+ "categories_add_title": "Ajouter aux catégories",+ "categories_add_description": "Choisissez les catégories auxquelles ajouter ces produits.",+ "categories_remove_title": "Retirer des catégories",+ "categories_remove_description": "Choisissez les catégories desquelles retirer ces produits.",+ "channels_add_title": "Ajouter aux canaux de vente",+ "channels_add_description": "Choisissez les canaux de vente sur lesquels répertorier ces produits.",+ "channels_remove_title": "Retirer des canaux de vente",+ "channels_remove_description": "Choisissez les canaux de vente desquels retirer ces produits.",+ "tags_add_title": "Ajouter des étiquettes",+ "tags_add_description": "Choisissez ou créez des étiquettes à ajouter à ces produits.",+ "tags_remove_title": "Retirer des étiquettes",+ "tags_remove_description": "Choisissez les étiquettes à retirer de ces produits.",+ "delete_confirm": {+ "title": "Supprimer {n} produits ?",+ "message": "Les produits sélectionnés seront supprimés. Cette action est irréversible."+ },+ "status_updated": "Statut mis à jour sur {n} produits",+ "status_update_failed": "Échec de la mise à jour du statut du produit",+ "categories_added": "{n} produits ajoutés aux catégories",+ "categories_add_failed": "Échec de l'ajout des produits aux catégories",+ "categories_removed": "{n} produits retirés des catégories",+ "categories_remove_failed": "Échec du retrait des produits des catégories",+ "channels_added": "{n} produits répertoriés sur les canaux de vente",+ "channels_add_failed": "Échec du référencement des produits sur les canaux de vente",+ "channels_removed": "{n} produits retirés des canaux de vente",+ "channels_remove_failed": "Échec du retrait des produits des canaux de vente",+ "tags_added": "Étiquettes ajoutées à {n} produits",+ "tags_add_failed": "Échec de l'ajout des étiquettes",+ "tags_removed": "Étiquettes retirées de {n} produits",+ "tags_remove_failed": "Échec du retrait des étiquettes",+ "deleted": "{n} produits supprimés",+ "delete_failed": "Échec de la suppression des produits"+ },+ "media_empty": "Aucun média pour le moment.",+ "media_upload": "Téléverser un média",+ "variants_empty": "Aucune variante pour le moment.",+ "status_options": {+ "draft": "Brouillon",+ "archived": "Archivé"+ },+ "inventory": {+ "out_of_stock": "En rupture de stock",+ "on_backorder": "En réapprovisionnement",+ "in_stock": "{{count}} en stock"+ },+ "variants_one": "{{count}} variante",+ "variants_other": "{{count}} variantes",+ "transfers": {+ "sheet_title": "Nouveau transfert de stock",+ "edit_sheet_title": "Transfert {{number}}",+ "description_internal": "Stock déplacé de <strong>{{source}}</strong> vers <strong>{{destination}}</strong>.",+ "description_external": "Réception externe dans <strong>{{destination}}</strong>.",+ "section_from": "De",+ "section_to": "Vers",+ "section_items": "Articles",+ "items_empty": "Aucun article pour le moment."+ },+ "options": {+ "sheet_title_create": "Créer un type d'option",+ "sheet_title_edit": "Modifier le type d'option",+ "values_section": "Valeurs",+ "values_empty": "Aucune valeur pour le moment.",+ "add_value": "Ajouter une valeur d'option",+ "table": {+ "values": "Valeurs"+ }+ },+ "price_lists": {+ "title": "Listes de prix",+ "subtitle": "Tarification ciblée pour des groupes de clients, des régions ou des paliers de volume.",+ "add_cta": "Nouvelle liste de prix",+ "sheet_title_create": "Créer une liste de prix",+ "sheet_title_edit": "Modifier la liste de prix",+ "delete_confirm": {+ "title": "Supprimer la liste de prix ?",+ "message": "Supprimer « {{name}} » supprime ses prix. Cette action est irréversible."+ },+ "activate": "Activer",+ "deactivate": "Désactiver",+ "schedule": "Planifier",+ "unschedule": "Déplanifier",+ "edit_prices_cta": "Modifier les prix",+ "add_products_cta": "Ajouter des produits",+ "remove_selected": "Retirer la sélection",+ "basics_section": "Informations de base",+ "schedule_section": "Planification",+ "products_section": "Produits",+ "rules_section": "Règles",+ "add_rule": "Ajouter une règle",+ "rule_click_to_configure": "Cliquez pour configurer",+ "rule_no_options": "Cette règle n'a aucune option configurable — sa seule présence applique la contrainte.",+ "rule_name_overflow": "{{names}} +{{count}} de plus",+ "remove_rule_confirm": {+ "title": "Retirer la règle ?",+ "message": "La règle est supprimée lorsque vous enregistrez la liste de prix."+ },+ "rules_help": "Conditions qui déterminent quand cette liste s'applique. Utilisez « toutes » pour exiger chaque règle, « n'importe laquelle » pour prendre la première correspondance.",+ "rules_empty": "Aucune règle — cette liste s'applique à tous les acheteurs.",+ "add_rule_help": "Choisissez un type de règle à configurer.",+ "rule_types_empty": "Aucun type de règle enregistré.",+ "rule_types_all_used": "Tous les types de règles disponibles sont déjà sur cette liste.",+ "rule_default_description": "Ajustez les paramètres de la règle.",+ "products_help": "Choisissez les produits auxquels cette liste s'applique. Des prix indicatifs sont créés à l'enregistrement — renseignez-les ci-dessous.",+ "products_search_placeholder": "Rechercher des produits par nom…",+ "products_empty_search": "Aucun produit ne correspond",+ "products_selected_one": "{{count}} produit sélectionné.",+ "products_selected_other": "{{count}} produits sélectionnés.",+ "prices_help_one": "{{count}} prix configuré. Ouvrez l'éditeur groupé pour le mettre à jour.",+ "prices_help_other": "{{count}} prix configurés. Ouvrez l'éditeur groupé pour les mettre à jour.",+ "prices_help_zero": "Choisissez les produits ci-dessus pour générer des prix indicatifs, puis ouvrez l'éditeur groupé.",+ "activate_confirm": {+ "title": "Activer la liste de prix ?",+ "message": "« {{name}} » s'appliquera immédiatement aux clients éligibles et restera active jusqu'à sa désactivation manuelle.",+ "message_with_end": "« {{name}} » s'appliquera immédiatement aux clients éligibles et restera active jusqu'à sa désactivation manuelle ou sa date de fin ({{ends_at}})."+ },+ "schedule_confirm": {+ "title": "Planifier la liste de prix ?",+ "message": "« {{name}} » sera mise en ligne le {{starts_at}} et restera active jusqu'à sa date de fin."+ },+ "deactivate_confirm": {+ "title": "Désactiver la liste de prix ?",+ "message": "« {{name}} » cessera immédiatement de s'appliquer aux clients. Les commandes existantes ne sont pas affectées."+ },+ "unschedule_confirm": {+ "title": "Déplanifier la liste de prix ?",+ "message": "« {{name}} » ne s'activera plus à sa date planifiée. Vous pourrez la replanifier ou l'activer manuellement plus tard."+ },+ "edit_prices": {+ "title": "Modifier les prix — {{name}}",+ "currency_label": "Devise",+ "empty": "Aucun produit dans cette liste pour le moment.",+ "add_products_link": "Ajouter des produits",+ "columns": {+ "product": "Produit",+ "variant": "Variante",+ "sku": "SKU",+ "price": "Prix",+ "compare_at_price": "Prix de comparaison"+ },+ "variant_default": "Par défaut",+ "grid_aria": "Prix des variantes",+ "search_placeholder": "Rechercher par produit, SKU ou option…",+ "price_aria": "Prix pour {{label}}",+ "compare_at_aria": "Prix de comparaison pour {{label}}",+ "save_cta": "Enregistrer les prix",+ "save_success_one": "{{count}} prix enregistré",+ "save_success_other": "{{count}} prix enregistrés",+ "save_failed": "Échec de l'enregistrement des prix",+ "count_summary_one": "{{count}} prix en {{currency}}",+ "count_summary_other": "{{count}} prix en {{currency}}",+ "no_matches_for_filters": "Aucun prix ne correspond aux filtres actuels.",+ "no_matches_for_search": "Aucun prix ne correspond à « {{search}} ».",+ "empty_pick_products": "Choisissez des produits dans la liste de prix pour commencer à définir les prix.",+ "empty_no_base_prices": "Aucun prix de base pour le moment.",+ "dirty_summary_one": "{{count}} modification non enregistrée",+ "dirty_summary_other": "{{count}} modifications non enregistrées",+ "discard_confirm": {+ "title": "Abandonner les prix non enregistrés ?",+ "message_close_one": "Vous avez {{count}} prix non enregistré. La fermeture l'abandonnera.",+ "message_close_other": "Vous avez {{count}} prix non enregistrés. La fermeture les abandonnera.",+ "message_currency": "Changer de devise abandonnera vos prix non enregistrés."+ }+ },+ "products_empty": "Aucun produit pour le moment — ajoutez-en un pour commencer à modifier les prix.",+ "no_changes": "Aucune modification à enregistrer."+ }+ },+ "settings": {+ "store": {+ "title": "Paramètres de la boutique",+ "subtitle": "Configuration générale et valeurs par défaut à l'échelle de la boutique.",+ "tab_general": "Général",+ "tab_standards": "Normes et formats"+ },+ "emails": {+ "title": "Paramètres d'e-mail",+ "subtitle": "Adresses d'expéditeur, notifications et logo intégré aux e-mails transactionnels.",+ "section_delivery": "Distribution",+ "section_addresses": "Adresses e-mail",+ "section_logo": "Logo",+ "logo_dimensions_help": "Recommandé : 204 × 104 pixels.",+ "logo_upload_cta": "Téléverser un logo",+ "logo_replace_cta": "Remplacer le logo",+ "logo_remove_cta": "Supprimer le logo",+ "logo_uploading": "Téléversement…",+ "logo_upload_failed": "Échec du téléversement du logo.",+ "load_failed_title": "Impossible de charger les paramètres d'e-mail"+ },+ "webhooks": {+ "title": "Webhooks",+ "subtitle": "Abonnez des points de terminaison HTTPS aux événements déclenchés par votre boutique.",+ "search_placeholder": "Rechercher par URL…",+ "new_cta": "Nouveau point de terminaison",+ "empty_title": "Aucun point de terminaison de webhook pour le moment",+ "empty_description": "Créez un point de terminaison pour recevoir un POST signé à chaque déclenchement d'un événement abonné.",+ "add_sheet_title": "Ajouter un point de terminaison de webhook",+ "edit_sheet_title": "Modifier le point de terminaison de webhook",+ "deliveries_sheet_title": "Livraisons récentes",+ "delete_confirm": {+ "title": "Supprimer le point de terminaison de webhook ?",+ "message": "{{name}} cessera immédiatement de recevoir des livraisons. L'historique des livraisons passées est également supprimé."+ },+ "detail": {+ "load_failed_title": "Impossible de charger ce point de terminaison de webhook",+ "delete_label": "Supprimer le point de terminaison",+ "details_title": "Détails",+ "edit_title": "Modifier le point de terminaison",+ "url": "URL de destination",+ "subscriptions": "Événements"+ },+ "save_secret_title": "Enregistrez votre clé secrète de signature",+ "save_secret_description": "Vérifiez les signatures des webhooks entrants avec cette clé. Nous ne l'afficherons plus.",+ "actions": {+ "send_test": "Envoyer un test",+ "disable": "Désactiver",+ "enable": "Réactiver",+ "view_deliveries": "Voir les livraisons",+ "redeliver": "Relivrer"+ },+ "status": {+ "inactive": "Inactif",+ "disabled": "Désactivé automatiquement",+ "disabled_reason": "Désactivé : {{reason}}"+ },+ "health": {+ "label": "État",+ "healthy": "Sain ({{percentage}} %)",+ "degraded": "Dégradé ({{percentage}} %)",+ "failing": "En échec ({{percentage}} %)",+ "disabled": "Désactivé",+ "no_deliveries": "Aucune livraison pour le moment",+ "auto_disabled_alert": "Ce point de terminaison a été automatiquement désactivé après des échecs de livraison répétés.",+ "re_enable_cta": "Réactiver",+ "metric_total": "Livraisons",+ "metric_successful": "Réussies",+ "metric_failed": "Échouées",+ "row_counters_successful_one": "{{count}} réussie",+ "row_counters_successful_other": "{{count}} réussies",+ "row_counters_failed_one": "{{count}} échouée",+ "row_counters_failed_other": "{{count}} échouées"+ },+ "table": {+ "url": "URL",+ "events": "Événements",+ "recent_deliveries": "7 derniers jours",+ "last_delivery": "Dernière livraison",+ "copy_url_aria": "Copier l'URL"+ },+ "events_all": "Tous les événements",+ "events_count_one": "{{count}} événement",+ "events_count_other": "{{count}} événements",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "Retirer {{event}}",+ "event_groups": {+ "asset": "Ressource",+ "custom": "Personnalisé",+ "customer": "Client",+ "digital": "Numérique",+ "gift_card": "Carte cadeau",+ "gift_card_batch": "Lot de cartes cadeaux",+ "import_export": "Import / Export",+ "invitation": "Invitation",+ "line_item": "Ligne d'article",+ "newsletter_subscriber": "Abonné à la newsletter",+ "order": "Commande",+ "payment": "Paiement",+ "payment_session": "Session de paiement",+ "payment_setup_session": "Session de configuration de paiement",+ "price": "Prix",+ "product": "Produit",+ "promotion": "Promotion",+ "refund": "Remboursement",+ "report": "Rapport",+ "return": "Retour",+ "shipment": "Expédition",+ "stock_item": "Article en stock",+ "stock_movement": "Mouvement de stock",+ "stock_reservation": "Réservation de stock",+ "stock_transfer": "Transfert de stock",+ "store_credit": "Avoir en boutique",+ "variant": "Variante",+ "wishlist": "Liste de souhaits"+ },+ "deliveries": {+ "table": {+ "event": "Événement",+ "code": "Réponse",+ "execution_time": "Durée",+ "delivered_at": "Livré le"+ },+ "status": {+ "pending": "En attente",+ "success": "Réussie",+ "failure": "Échouée",+ "error": "Erreur"+ },+ "empty": "Aucune livraison pour le moment — envoyez un test pour vérifier votre point de terminaison.",+ "search_placeholder": "Rechercher par nom d'événement…",+ "test_sent": "Webhook de test mis en file d'attente.",+ "test_failed": "Échec de l'envoi du webhook de test.",+ "redeliver_queued": "Relivraison mise en file d'attente.",+ "detail_sheet_title": "Détails de la livraison",+ "detail": {+ "event": "Événement",+ "url": "URL de destination",+ "delivered_at": "Livré le",+ "response_code": "Code de réponse",+ "execution_time": "Temps d'exécution",+ "error_type": "Type d'erreur",+ "request_errors": "Erreur de transport",+ "request_payload": "Charge utile de la requête",+ "response_body": "Corps de la réponse",+ "response_body_truncated": "Le corps de la réponse a été tronqué à {{limit}} caractères.",+ "copy_payload_aria": "Copier la charge utile de la requête",+ "copy_response_aria": "Copier le corps de la réponse"+ }+ }+ },+ "api_keys": {+ "title": "Clés API",+ "subtitle": "Autorisez des intégrations et des applications à appeler l'API d'administration.",+ "publishable_section": "Clés publiables",+ "publishable_help": "Utilisées par votre vitrine. Peuvent être exposées en toute sécurité dans le code côté client.",+ "secret_section": "Clés secrètes",+ "secret_help": "Uniquement de serveur à serveur. Limitez chaque clé aux opérations dont elle a besoin.",+ "new_cta": "Nouvelle clé",+ "empty_publishable": "Aucune clé publiable pour le moment.",+ "empty_secret": "Aucune clé secrète pour le moment.",+ "table": {+ "key": "Clé",+ "scopes": "Portées",+ "last_used_at": "Dernière utilisation"+ },+ "save_secret_title": "Enregistrez votre clé secrète",+ "save_secret_description": "Copiez cette valeur maintenant — nous ne l'afficherons plus.",+ "scope_badge": {+ "full_access": "Accès complet",+ "read_all": "Lecture de tout"+ }+ },+ "payment_methods": {+ "add_sheet_title": "Ajouter un mode de paiement",+ "edit_sheet_title": "Modifier le mode de paiement"+ },+ "tax_categories": {+ "add_sheet_title": "Ajouter une catégorie de taxe",+ "edit_sheet_title": "Modifier la catégorie de taxe"+ },+ "markets": {+ "add_sheet_title": "Ajouter un marché",+ "edit_sheet_title": "Modifier le marché"+ },+ "custom_field_definitions": {+ "add_sheet_title": "Ajouter un champ personnalisé",+ "edit_sheet_title": "Modifier le champ personnalisé"+ },+ "stock_locations": {+ "add_sheet_title": "Ajouter un emplacement de stock",+ "edit_sheet_title": "Modifier l'emplacement de stock",+ "search_placeholder": "Rechercher des emplacements de stock…"+ },+ "allowed_origins": {+ "add_sheet_title": "Ajouter une origine autorisée",+ "edit_sheet_title": "Modifier l'origine autorisée"+ }+ },+ "promotions": {+ "new_title": "Nouvelle promotion",+ "create_cta": "Créer une promotion",+ "loading": "Chargement de la promotion…",+ "gift_cards": {+ "new_sheet_title": "Nouvelle carte cadeau",+ "edit_sheet_title": "Carte cadeau",+ "not_found": "Carte cadeau introuvable.",+ "new_cta": "Nouvelle carte cadeau",+ "create_label": "Créer une carte cadeau",+ "batch_section": "Lot",+ "create_batch_cta": "Créer {{count}} cartes cadeaux",+ "status_options": {+ "redeemed": "Utilisée",+ "expired": "Expirée",+ "void": "Annulée"+ },+ "sheet": {+ "create_description": "Émettez une seule carte cadeau ou générez un lot avec des codes générés automatiquement.",+ "edit_description": "Mettez à jour le client ou la date d'expiration de la carte cadeau. Le code et le montant sont immuables une fois la carte émise."+ },+ "delete_confirm": {+ "title": "Supprimer la carte cadeau ?",+ "message": "Cela annulera la carte cadeau et l'empêchera d'être utilisée."+ },+ "validation": {+ "amount_positive": "Le montant doit être supérieur à zéro",+ "amount_required": "Le montant est requis",+ "prefix_required": "Le préfixe est requis pour les lots",+ "currency_required": "La devise est requise"+ },+ "prefix": {+ "label": "Préfixe",+ "placeholder": "ex. WELCOME — les codes seront WELCOME-abc123",+ "auto_placeholder": "Généré automatiquement si laissé vide"+ },+ "no_customer": "Aucun client rattaché",+ "usage": {+ "title": "Utilisation",+ "used": "Utilisé",+ "remaining": "Restant",+ "issued_by": "Émise par"+ }+ }+ },+ "profile": {+ "title": "Profil",+ "subtitle": "Gérez vos informations personnelles et votre langue d'administration.",+ "personal_details": "Informations personnelles",+ "load_failed_title": "Impossible de charger votre profil"+ }+ },+ "invitation": {+ "missing_token_title": "Jeton d'invitation manquant",+ "missing_token_message": "Ce lien semble incomplet. Demandez à la personne qui vous a invité de vous le renvoyer.",+ "loading": "Chargement de l'invitation…",+ "not_found_title": "Invitation introuvable",+ "not_found_message": "Cette invitation a expiré, a été révoquée ou a déjà été acceptée. Demandez à la personne qui vous a invité de vous en envoyer une nouvelle.",+ "generic_error_title": "Impossible de charger l'invitation",+ "generic_error_message": "Une erreur s'est produite. Veuillez réessayer.",+ "join_store": "Rejoindre {{store}}",+ "invited_by": "{{email}} vous a invité",+ "invited_generic": "Vous avez été invité",+ "invited_as_role": " en tant que {{role}}",+ "sign_in_to_accept": ". Connectez-vous pour accepter.",+ "create_to_accept": ". Créez votre compte pour accepter.",+ "could_not_accept": "Impossible d'accepter l'invitation",+ "accepting": "Acceptation…",+ "sign_in_and_accept": "Se connecter et accepter",+ "create_and_accept": "Créer un compte et accepter"+ },+ "staff": {+ "actions": {+ "copy_invitation_link": "Copier le lien d'invitation",+ "invitation_link_copied": "Lien d'invitation copié"+ },+ "autocomplete": {+ "placeholder": "Rechercher du personnel…",+ "empty": "Aucun membre du personnel correspondant"+ },+ "confirm": {+ "remove_title": "Retirer de la boutique ?",+ "remove_message": "{{name}} perdra l'accès à cette boutique.",+ "revoke_title": "Révoquer l'invitation ?",+ "revoke_message": "{{email}} ne pourra plus accepter cette invitation."+ },+ "errors": {+ "failed_to_remove": "Échec du retrait du membre du personnel",+ "failed_to_resend": "Échec du renvoi de l'invitation",+ "failed_to_revoke": "Échec de la révocation de l'invitation"+ },+ "invite": {+ "email_placeholder": "[email protected]",+ "roles_loading": "Chargement des rôles…",+ "roles_placeholder": "Sélectionner un rôle",+ "no_roles": "Aucun rôle disponible."+ },+ "edit": {+ "roles_label": "Rôles pour cette boutique"+ },+ "edit_description": "Mettez à jour les informations du profil et les rôles attribués à ce membre du personnel.",+ "actions_aria": "Actions"+ },+ "api_keys": {+ "empty_description": "Créez-en une pour commencer.",+ "create_sheet_title": "Créer une clé API",+ "create_sheet_description": "Choisissez un type de clé, puis sélectionnez les portées qu'elle peut utiliser.",+ "edit_sheet_title": "Modifier la clé API",+ "edit_sheet_description": "Renommez cette clé. Les portées sont définies lors de la création d'une clé et ne peuvent pas être modifiées.",+ "scopes_immutable_help": "Les portées ne peuvent pas être modifiées après la création d'une clé. Pour les modifier, créez une nouvelle clé avec les portées dont vous avez besoin et révoquez celle-ci.",+ "key_type": {+ "secret_title": "Clé secrète",+ "secret_description": "Serveur à serveur. Chaque clé porte une liste explicite de portées.",+ "publishable_title": "Clé publiable",+ "publishable_description": "Peut être exposée sans risque dans le code côté client. Accorde un accès public/invité."+ },+ "scope_picker": {+ "resource_header": "Ressource",+ "read_header": "Lecture",+ "write_header": "Écriture",+ "read_aria": "Lire {{resource}}",+ "write_aria": "Écrire {{resource}}",+ "full_access_label": "Accès complet (write_all)",+ "read_all_label": "Tout lire (read_all)",+ "resources": {+ "orders": "Commandes",+ "products": "Produits",+ "promotions": "Promotions",+ "customers": "Clients",+ "payments": "Paiements",+ "fulfillments": "Exécutions des commandes",+ "refunds": "Remboursements",+ "gift_cards": "Cartes cadeaux",+ "store_credits": "Avoirs en boutique",+ "stock": "Stock",+ "categories": "Catégories",+ "settings": "Paramètres",+ "webhooks": "Webhooks",+ "api_keys": "Clés API",+ "dashboard": "Tableau de bord"+ },+ "full_access_hint": "– lecture + écriture sur chaque ressource",+ "read_all_hint": "– lecture sur chaque ressource",+ "show_more_aria_one": "Afficher {{count}} portée supplémentaire",+ "show_more_aria_other": "Afficher {{count}} portées supplémentaires"+ },+ "warning_treat_like_password": "Traitez cette clé comme un mot de passe. Conservez-la dans votre gestionnaire de secrets — nous ne pourrons pas vous la montrer à nouveau.",+ "revoke_confirm": {+ "title": "Révoquer la clé ?",+ "message": "Toute intégration utilisant cette clé cessera immédiatement de fonctionner."+ },+ "delete_confirm": {+ "title": "Supprimer la clé ?",+ "message": "Cela supprime définitivement la clé. Préférez la révocation si vous pourriez avoir besoin de rétablir l'accès ultérieurement."+ },+ "dropdown": {+ "revoke": "Révoquer la clé",+ "copy_token_aria": "Copier le jeton"+ },+ "badge": {+ "revoked": "Révoquée",+ "never_used": "Jamais"+ },+ "errors": {+ "failed_to_delete": "Échec de la suppression de la clé",+ "failed_to_update": "Échec de la mise à jour de la clé",+ "failed_to_create": "Échec de la création de la clé"+ },+ "by_email": "par {{email}}",+ "create_key_cta": "Créer la clé",+ "validation": {+ "scope_required": "Sélectionnez au moins une portée"+ }+ },+ "customers": {+ "groups": {+ "bulk_add_action": "Ajouter au groupe…",+ "bulk_remove_action": "Retirer du groupe…",+ "bulk_added": "{{count}} clients ajoutés aux groupes",+ "bulk_removed": "{{count}} clients retirés des groupes",+ "bulk_add_failed": "Échec de l'ajout des clients aux groupes",+ "bulk_remove_failed": "Échec du retrait des clients des groupes",+ "picker": {+ "add_title": "Ajouter aux groupes",+ "add_description": "Choisissez les groupes auxquels ajouter ces clients.",+ "remove_title": "Retirer des groupes",+ "remove_description": "Choisissez les groupes desquels retirer ces clients."+ },+ "view_members": "Voir les membres",+ "count_one": "{{count}} client",+ "count_other": "{{count}} clients",+ "create_label": "Créer un groupe de clients",+ "create_description": "Créez un groupe de clients pour segmenter vos clients à des fins de promotions, d'analyses ou de marketing.",+ "edit_description": "Modifiez le nom ou la description.",+ "default_name": "Ce groupe",+ "delete_confirm": {+ "title": "Supprimer le groupe de clients ?",+ "message": "{{name}} sera supprimé. Les clients de ce groupe ne sont pas supprimés."+ },+ "table": {+ "title": "Groupes de clients",+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucun groupe de clients pour le moment"+ },+ "columns": {+ "customers": "Clients"+ }+ },+ "tags": {+ "bulk_add_action": "Ajouter des étiquettes…",+ "bulk_remove_action": "Retirer des étiquettes…",+ "bulk_added": "Étiquettes ajoutées à {n} clients",+ "bulk_removed": "Étiquettes retirées de {n} clients",+ "bulk_add_failed": "Échec de l'ajout des étiquettes",+ "bulk_remove_failed": "Échec du retrait des étiquettes",+ "picker": {+ "add_title": "Ajouter des étiquettes",+ "add_description": "Choisissez ou créez des étiquettes à ajouter à ces clients.",+ "remove_title": "Retirer des étiquettes",+ "remove_description": "Choisissez les étiquettes à retirer de ces clients."+ }+ },+ "row_actions": {+ "delete_confirm": "Supprimer {{email}} ? Les clients ayant des commandes finalisées ne peuvent pas être supprimés."+ },+ "detail": {+ "delete_label": "Supprimer le client",+ "edit_profile_description": "Mettez à jour les informations du profil du client.",+ "subscribed_to_marketing": "Abonné au marketing",+ "not_subscribed_to_marketing": "Non abonné au marketing",+ "customer_since": "Client depuis",+ "last_order_placed": "Dernière commande passée",+ "orders_table": {+ "order": "Commande",+ "date": "Date"+ },+ "no_internal_notes": "Aucune note interne",+ "address": {+ "default_billing": "Facturation par défaut",+ "default_shipping": "Livraison par défaut",+ "set_default_billing": "Définir comme facturation par défaut",+ "set_default_shipping": "Définir comme livraison par défaut",+ "delete_confirm_message": "Supprimer cette adresse ?"+ },+ "store_credit": {+ "title": "Avoir en boutique",+ "empty": "Aucun avoir en boutique émis",+ "table": {+ "used": "Utilisé",+ "remaining": "Restant",+ "category": "Catégorie",+ "memo": "Note"+ },+ "delete_confirm_message": "Supprimer cet avoir en boutique ?",+ "edit_description": "Ajustez le montant, la catégorie ou la note. Le solde utilisé ne peut pas être modifié.",+ "add_description": "Émettez un avoir en boutique sur le compte de ce client."+ }+ },+ "new_sheet_description": "Les clients créés ici n'ont aucun mot de passe défini. Ils recevront un lien magique lors de leur première connexion.",+ "table": {+ "search_placeholder": "Rechercher par e-mail ou nom…",+ "empty": "Aucun client pour le moment"+ },+ "columns": {+ "orders": "Commandes",+ "total_spent": "Total dépensé",+ "last_order": "Dernière commande",+ "groups": "Groupes",+ "newsletter": "Newsletter"+ },+ "autocomplete": {+ "placeholder": "Rechercher des clients…",+ "empty": "Aucun client correspondant"+ }+ },+ "orders": {+ "new": {+ "use_default_addresses": "Utiliser les adresses de facturation et de livraison par défaut du client",+ "add_variant": "Ajouter une variante",+ "items_table": {+ "variant": "Variante",+ "sku": "SKU",+ "qty": "Qté"+ },+ "creates_draft_note": "Crée une commande brouillon. Ajoutez des paiements et finalisez-la après la création."+ },+ "detail": {+ "load_failed_message": "Impossible de charger la commande {{orderId}}.",+ "confirm": {+ "complete_message": "Finaliser cette commande brouillon maintenant ?",+ "approve_message": "Approuver cette commande ?",+ "resume_message": "Reprendre cette commande annulée ?",+ "cancel_message": "Voulez-vous vraiment annuler cette commande ?",+ "remove_item_message": "Retirer cet article de la commande ?",+ "ship_message": "Expédier cet envoi ?",+ "cancel_shipment_message": "Annuler cet envoi ?",+ "capture_message": "Capturer ce paiement ?",+ "void_message": "Annuler ce paiement ?",+ "remove_gift_card_message": "Retirer cette carte cadeau de la commande ?",+ "remove_store_credit_message": "Retirer l'avoir de la commande ?"+ },+ "dropdown": {+ "complete_order": "Finaliser la commande",+ "preview_order": "Aperçu de la commande",+ "resend_confirmation": "Renvoyer la confirmation",+ "edit_quantity": "Modifier la quantité",+ "cancel_shipment": "Annuler l'envoi",+ "void_payment": "Annuler le paiement"+ },+ "messages": {+ "canceled": "Commande annulée",+ "completed": "Commande finalisée",+ "approved": "Commande approuvée",+ "resumed": "Commande reprise",+ "shipped": "Envoi expédié",+ "captured": "Paiement capturé",+ "voided": "Paiement annulé",+ "confirmation_sent": "Confirmation envoyée"+ },+ "errors": {+ "cancel_failed": "Échec de l'annulation de la commande",+ "complete_failed": "Échec de la finalisation de la commande",+ "approve_failed": "Échec de l'approbation de la commande",+ "resume_failed": "Échec de la reprise de la commande",+ "confirmation_send_failed": "Échec de l'envoi de la confirmation"+ },+ "variant_search": {+ "description": "Recherchez une variante de produit à ajouter à cette commande.",+ "label": "Rechercher une variante",+ "empty": "Aucune variante trouvée",+ "sku_prefix": "SKU",+ "placeholder": "Saisissez le nom du produit ou le SKU (3 caractères min.)…"+ },+ "edit_quantity": {+ "title": "Modifier la quantité",+ "description": "Définissez la quantité pour cette ligne d'article."+ },+ "items_table": {+ "item": "Article",+ "price": "Prix",+ "qty": "Qté"+ },+ "tracking": {+ "label": "Numéro de suivi",+ "description": "Mettez à jour le numéro de suivi de cet envoi.",+ "prefix": "Suivi",+ "shipped_prefix": "Expédié",+ "edit_title": "Modifier le suivi",+ "add_title": "Ajouter un suivi"+ },+ "payments_table": {+ "number": "Numéro",+ "method": "Méthode",+ "state": "État"+ },+ "payment_form": {+ "description": "Prélevez un moyen de paiement sur cette commande.",+ "method_label": "Moyen de paiement",+ "method_placeholder": "Choisir un moyen de paiement",+ "source_label": "Source",+ "amount_help": "Laissez vide pour utiliser par défaut le solde restant dû.",+ "capture_immediately": "Capturer immédiatement",+ "title": "Ajouter un paiement",+ "source_requires_customer": "Ce moyen de paiement nécessite une source enregistrée. Veuillez d'abord associer un client à la commande.",+ "no_saved_cards": "Le client n'a aucune carte enregistrée pour ce moyen de paiement.",+ "source_placeholder": "Choisir une carte enregistrée…"+ },+ "summary": {+ "canceled_at": "Annulée le",+ "canceler": "Annulé par",+ "approved_by": "Approuvé par",+ "promotions": "Promotions",+ "adjustments": "Ajustements",+ "tax_included": "Taxe (incluse)",+ "tax_additional": "Taxe (supplémentaire)",+ "payment_total": "Total des paiements",+ "outstanding_balance": "Solde restant dû"+ },+ "gift_card_section": {+ "title": "Carte cadeau et avoir",+ "gift_card_label": "Carte cadeau",+ "store_credit_label": "Avoir",+ "none_applied": "Aucun appliqué",+ "applied_suffix": "appliqué",+ "apply_balance": "Appliquer le solde disponible du client",+ "requires_customer": "Nécessite un client",+ "apply_dialog_title": "Appliquer une carte cadeau",+ "apply_dialog_description": "Saisissez un code de carte cadeau à appliquer à cette commande."+ },+ "address_edit": {+ "shipping_title": "Modifier l'adresse de livraison",+ "billing_title": "Modifier l'adresse de facturation"+ },+ "no_customer": "Aucune information client",+ "section_customer_note": "Instructions spéciales",+ "section_internal_note": "Note interne",+ "completed_prefix": "Terminée",+ "add_line_item": {+ "title": "Ajouter un article"+ },+ "no_line_items": "Aucun article"+ },+ "table": {+ "search_placeholder": "Rechercher des commandes…",+ "empty": "Aucune commande trouvée"+ },+ "columns": {+ "number": "Numéro",+ "date": "Date",+ "customer": "Client",+ "payment": "Paiement",+ "fulfillment": "Traitement",+ "items": "Articles",+ "tags": "Étiquettes",+ "sku": "SKU"+ },+ "item_count_one": "{{count}} article",+ "item_count_other": "{{count}} articles",+ "statuses": {+ "draft": "Brouillon",+ "placed": "Passée",+ "canceled": "Annulée"+ },+ "payment_statuses": {+ "balance_due": "Solde dû",+ "credit_owed": "Crédit dû",+ "failed": "Échouée",+ "paid": "Payée",+ "void": "Annulée"+ },+ "fulfillment_statuses": {+ "backorder": "Commande en attente",+ "canceled": "Annulé",+ "partial": "Partiel",+ "pending": "En attente",+ "ready": "Prêt",+ "fulfilled": "Traité"+ }+ },+ "products": {+ "save_label": "Enregistrer le produit",+ "delete_label": "Supprimer le produit",+ "delete_confirm": "Voulez-vous vraiment supprimer ce produit ?",+ "category_search_placeholder": "Rechercher des catégories…",+ "no_categories_found": "Aucune catégorie trouvée",+ "media": {+ "delete_confirm": "Supprimer ce média ? Cette action est irréversible.",+ "drop_hint": "Glissez-déposez un média ici, ou cliquez pour parcourir",+ "file_types_hint": "PNG, JPG, WebP jusqu'à 10 Mo",+ "edit_title": "Modifier le média",+ "assigned_variants_label": "Variantes associées",+ "assigned_variants_help": "Sélectionnez les variantes que cette image représente. Laissez vide pour l'appliquer à toutes les variantes.",+ "upload_failed": "Échec du téléversement de {{name}} : {{message}}",+ "upload_status_failed": "Échec"+ },+ "seo": {+ "slug_placeholder": "url-du-produit",+ "meta_title_placeholder": "Titre SEO",+ "meta_description_placeholder": "Description SEO"+ },+ "tax_category_placeholder": "Sélectionner une catégorie de taxe",+ "transfers": {+ "new_cta": "Nouveau transfert",+ "create_description": "Déplacez du stock entre emplacements, ou recevez du nouveau stock d'un fournisseur externe.",+ "external_label": "Externe (réception fournisseur)",+ "destination_placeholder": "Sélectionner l'emplacement de destination",+ "different_locations_error": "La source et la destination doivent être différentes.",+ "reference_label": "Référence",+ "reference_placeholder": "Numéro de bon de commande, facture fournisseur, …",+ "search_items_placeholder": "Rechercher par nom ou SKU (3 caractères ou plus)…",+ "items_table": {+ "variant": "Variante",+ "sku": "SKU",+ "qty": "Qté"+ },+ "delete_confirm": {+ "title": "Supprimer ce transfert ?",+ "message": "Les mouvements de stock créés par ce transfert seront annulés."+ },+ "review_description": "Vérifiez le transfert avant de le créer. Les articles ne pourront plus être modifiés ensuite.",+ "details_card": "Détails",+ "fields": {+ "type": "Type",+ "internal": "Interne",+ "external_receive": "Réception externe",+ "reference": "Référence",+ "created": "Créé le",+ "immutable_note": "Les transferts de stock sont immuables une fois créés."+ }+ },+ "options": {+ "kinds": {+ "dropdown": "Liste déroulante",+ "color_swatch": "Nuancier de couleurs",+ "buttons": "Boutons"+ },+ "add_cta": "Ajouter un type d'option",+ "create_label": "Créer un type d'option",+ "create_description": "Définissez une option que les variantes peuvent utiliser (par ex. taille, couleur).",+ "edit_description": "Modifiez le type d'option et ses valeurs.",+ "delete_confirm": {+ "title": "Supprimer le type d'option ?",+ "message": "Cela supprimera également toutes ses valeurs. Les variantes utilisant ces valeurs les perdront."+ },+ "values_help": "Faites glisser les valeurs pour les réorganiser. La première valeur est celle par défaut pour les nouvelles variantes.",+ "count_one": "{{count}} valeur",+ "count_other": "{{count}} valeurs",+ "value_name_placeholder": "par ex. small",+ "value_label_placeholder": "par ex. Petit",+ "image_upload_failed": "Échec du téléversement de l'image"+ },+ "variants": {+ "title": "Variantes",+ "default_variant": "Variante par défaut",+ "variant_label": "Variante",+ "add_option": "Ajouter une option",+ "create_option_type": "Créer un nouveau type d'option",+ "create_option_type_title": "Nouveau type d'option",+ "create_value": "Nouvelle valeur",+ "create_value_title": "Nouvelle valeur d'option",+ "option_type_label": "Type d'option",+ "option_type_placeholder": "Choisissez un type d'option",+ "edit_variant": "Modifier la variante — {{name}}",+ "edit_row_aria": "Modifier {{name}}",+ "remove_row_aria": "Retirer {{name}}",+ "orphan_warning_one": "{{count}} variante existante ne correspond plus aux options sélectionnées et sera supprimée à l'enregistrement :",+ "orphan_warning_other": "{{count}} variantes existantes ne correspondent plus aux options sélectionnées et seront supprimées à l'enregistrement :",+ "orphan_warning": "{{count}} variante(s) existante(s) seront supprimées à l'enregistrement :",+ "keep": "Tout conserver",+ "sheet": {+ "identity": "Identité",+ "tax_category_placeholder": "Hériter du produit"+ }+ },+ "inventory": {+ "columns": {+ "location": "Emplacement",+ "on_hand": "En stock",+ "backorder": "Réassort"+ },+ "on_hand_aria": "En stock à {{location}}",+ "backorder_aria": "Autoriser le réassort à {{location}}",+ "empty_no_locations": "Ajoutez un emplacement de stock dans les Paramètres pour commencer à suivre l'inventaire.",+ "empty_no_variants": "Les niveaux de stock sont gérés par emplacement de stock. Ajoutez une variante pour commencer à suivre l'inventaire."+ },+ "custom_fields": {+ "empty_title": "Aucun champ personnalisé pour le moment",+ "empty_description": "Définissez des champs personnalisés dans les Paramètres pour commencer à suivre des informations structurées sur les produits.",+ "empty_cta": "Configurer les champs personnalisés"+ },+ "columns": {+ "sku": "SKU",+ "price": "Prix",+ "in_stock": "En stock"+ },+ "price_lists": {+ "messages": {+ "created": "Liste de prix créée",+ "updated": "Liste de prix mise à jour",+ "deleted": "Liste de prix supprimée",+ "activated": "Liste de prix activée",+ "deactivated": "Liste de prix désactivée"+ },+ "errors": {+ "failed_to_activate": "Échec de l'activation de la liste de prix",+ "failed_to_deactivate": "Échec de la désactivation de la liste de prix"+ }+ }+ },+ "payment_methods": {+ "add_cta": "Ajouter un moyen de paiement",+ "create_description": "Choisissez un fournisseur et configurez ses identifiants.",+ "edit_description": "Mettez à jour le nom, la visibilité ou le statut.",+ "create_label": "Créer un moyen de paiement",+ "provider_description": "Fournisseur : {{provider}}",+ "delete_confirm": {+ "title": "Supprimer le moyen de paiement ?",+ "message": "{{name}} ne sera plus disponible au paiement."+ },+ "title": "Moyens de paiement",+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucun moyen de paiement configuré",+ "columns": {+ "storefront": "Boutique"+ },+ "storefront": {+ "visible": "Visible",+ "admin_only": "Administration uniquement"+ },+ "status": {+ "disabled": "Désactivé"+ },+ "messages": {+ "created": "Moyen de paiement créé",+ "updated": "Moyen de paiement mis à jour",+ "deleted": "Moyen de paiement supprimé"+ }+ },+ "tax_categories": {+ "add_cta": "Ajouter une catégorie de taxe",+ "create_description": "Regroupez les produits par traitement fiscal (standard, réduit, exonéré, …).",+ "edit_description": "Modifiez le nom, le code ou l'indicateur par défaut.",+ "create_label": "Créer une catégorie de taxe",+ "delete_confirm": {+ "title": "Supprimer la catégorie de taxe ?",+ "message": "{{name}} sera supprimée. Les produits de cette catégorie reviendront à la catégorie par défaut."+ },+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucune catégorie de taxe pour le moment",+ "messages": {+ "created": "Catégorie de taxe créée",+ "updated": "Catégorie de taxe mise à jour",+ "deleted": "Catégorie de taxe supprimée"+ }+ },+ "markets": {+ "add_cta": "Ajouter un marché",+ "create_description": "Regroupez des pays dans une seule région tarifaire avec sa propre devise et ses propres langues.",+ "edit_description": "Mettez à jour le nom, la devise, les langues ou la couverture géographique.",+ "create_label": "Créer un marché",+ "delete_confirm": {+ "title": "Supprimer le marché ?",+ "message": "{{name}} sera supprimé. Les commandes précédemment passées sur ce marché restent intactes."+ },+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucun marché pour le moment",+ "tax_inclusive": "TTC",+ "tax_exclusive": "HT",+ "columns": {+ "default": "Par défaut"+ },+ "messages": {+ "created": "Marché créé",+ "updated": "Marché mis à jour",+ "deleted": "Marché supprimé"+ },+ "errors": {+ "failed_to_create": "Échec de la création du marché",+ "failed_to_update": "Échec de la mise à jour du marché",+ "failed_to_delete": "Échec de la suppression du marché"+ }+ },+ "custom_field_definitions": {+ "add_cta": "Ajouter un champ personnalisé",+ "create_label": "Créer un champ personnalisé",+ "create_description": "Définissez un champ typé que votre équipe peut renseigner sur tout enregistrement correspondant.",+ "edit_description": "Modifiez le libellé, la clé ou la visibilité dans la vitrine. Le propriétaire ne peut plus être modifié une fois que des valeurs existent.",+ "table_title": "Définitions de champs personnalisés",+ "search_placeholder": "Rechercher par libellé, espace de noms ou clé…",+ "empty": "Aucune définition de champ personnalisé pour le moment",+ "storefront_visible": {+ "visible": "Visible",+ "admin_only": "Admin uniquement"+ },+ "delete_confirm": {+ "title": "Supprimer le champ personnalisé ?",+ "message": "{{label}} sera supprimé, ainsi que toutes les valeurs qui y sont enregistrées."+ }+ },+ "allowed_origins": {+ "add_cta": "Ajouter une origine autorisée",+ "create_label": "Ajouter une origine",+ "create_description": "Les navigateurs chargés depuis cette origine peuvent appeler l'API admin. La liste blanche CORS et la session par cookie admin reposent toutes deux sur cette liste — restez restrictif.",+ "edit_description": "La mise à jour d'une origine modifie immédiatement qui peut appeler l'API admin depuis un navigateur.",+ "table_title": "Origines autorisées",+ "search_placeholder": "Rechercher par origine…",+ "empty": "Aucune origine autorisée pour le moment",+ "validation": {+ "bare_origin": "Doit être une origine simple (par ex. https://shop.example.com) — sans chemin, requête ni fragment"+ },+ "delete_confirm": {+ "title": "Supprimer l'origine autorisée ?",+ "message": "{{origin}} ne pourra plus appeler l'API admin depuis un navigateur. Les requêtes existantes de serveur à serveur ne sont pas affectées."+ },+ "messages": {+ "added": "Origine autorisée ajoutée",+ "updated": "Origine autorisée mise à jour",+ "removed": "Origine autorisée supprimée"+ }+ },+ "stock_locations": {+ "add_cta": "Ajouter un emplacement de stock",+ "create_label": "Créer un emplacement de stock",+ "create_description": "Ajoutez un entrepôt, un magasin ou un point de retrait pour traiter les commandes.",+ "edit_description": "Mettez à jour le nom, l'adresse, le retrait ou les politiques de stock.",+ "kinds": {+ "warehouse": "Entrepôt",+ "store": "Magasin",+ "fulfillment_center": "Centre de distribution"+ },+ "pickup_stock_policies": {+ "local": "Uniquement les articles à cet emplacement",+ "any": "Autoriser les transferts depuis d'autres emplacements"+ },+ "delete_confirm": {+ "title": "Supprimer l'emplacement de stock ?",+ "message": "{{name}} sera supprimé. Les articles en stock à cet emplacement ne sont pas supprimés."+ },+ "section_pickup": "Retrait",+ "stock_items": {+ "title": "Stock à cet emplacement",+ "help": "Ajustez les quantités disponibles et en réassort par variante.",+ "search_placeholder": "Rechercher un SKU ou un produit…",+ "table": {+ "variant": "Variante",+ "on_hand": "Disponible",+ "backorder": "Réassort"+ },+ "empty": "Aucun article en stock à cet emplacement pour le moment.",+ "empty_search": "Aucun article en stock ne correspond à votre recherche."+ },+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucun emplacement de stock pour le moment",+ "columns": {+ "type": "Type",+ "location": "Emplacement",+ "pickup": "Retrait",+ "default": "Par défaut"+ },+ "badges": {+ "enabled": "Activé",+ "inactive": "Inactif",+ "default": "Par défaut"+ }+ },+ "store": {+ "load_failed_title": "Échec du chargement des paramètres de la boutique",+ "unit_systems": {+ "metric": "Métrique",+ "imperial": "Impérial"+ },+ "weight_units": {+ "kg": "Kilogramme (kg)",+ "g": "Gramme (g)",+ "lb": "Livre (lb)",+ "oz": "Once (oz)"+ }+ },+ "option_types": {+ "kinds": {+ "dropdown": "Liste déroulante",+ "color_swatch": "Nuancier de couleur",+ "buttons": "Boutons"+ },+ "columns": {+ "values": "Valeurs"+ },+ "value_count_one": "{{count}} valeur",+ "value_count_other": "{{count}} valeurs",+ "table": {+ "search_placeholder": "Rechercher par nom…",+ "empty": "Aucun type d'option pour le moment"+ },+ "messages": {+ "created": "Type d'option créé",+ "updated": "Type d'option mis à jour",+ "deleted": "Type d'option supprimé"+ }+ },+ "stock_transfers": {+ "title": "Transferts de stock",+ "table": {+ "search_placeholder": "Rechercher par numéro ou référence…",+ "empty": "Aucun transfert de stock pour le moment"+ },+ "columns": {+ "number": "Numéro",+ "direction": "Direction",+ "reference": "Référence"+ },+ "direction": {+ "internal": "Transfert entre emplacements",+ "external_receive": "Réception externe"+ },+ "messages": {+ "recorded": "Transfert de stock enregistré",+ "deleted": "Transfert de stock supprimé"+ },+ "errors": {+ "failed_to_record": "Échec de l'enregistrement du transfert de stock",+ "failed_to_delete": "Échec de la suppression du transfert de stock"+ }+ },+ "calculators": {+ "flat_percent_item_total": "Pourcentage fixe",+ "flat_rate": "Tarif forfaitaire",+ "flexi_rate": "Tarif flexible",+ "per_item": "Par article",+ "percent_on_line_item": "Pourcentage par ligne d’article",+ "price_sack": "Palier de prix",+ "tiered_flat_rate": "Tarif forfaitaire par paliers",+ "tiered_percent": "Pourcentage par paliers",+ "default_tax": "Taxe par défaut",+ "digital_delivery": "Livraison numérique",+ "default_refund_amount": "Montant de remboursement par défaut"+ },+ "preferences": {+ "amount": "Montant",+ "flat_percent": "Pourcentage fixe",+ "percent": "Pourcentage",+ "first_item": "Coût du premier article",+ "additional_item": "Coût de chaque article supplémentaire",+ "max_items": "Nombre maximal d'articles",+ "minimal_amount": "Montant minimal",+ "normal_amount": "Montant normal",+ "discount_amount": "Montant de la remise",+ "currency": "Devise",+ "base_amount": "Montant de base",+ "base_percent": "Pourcentage de base",+ "preferred_amount": "Montant",+ "preferred_percent": "Pourcentage"+ },+ "channels": {+ "messages": {+ "created": "Canal créé",+ "updated": "Canal mis à jour",+ "deleted": "Canal supprimé"+ }+ },+ "customer_groups": {+ "messages": {+ "created": "Groupe de clients créé",+ "create_failed": "Échec de la création du groupe de clients",+ "updated": "Groupe de clients mis à jour",+ "update_failed": "Échec de la mise à jour du groupe de clients",+ "deleted": "Groupe de clients supprimé",+ "delete_failed": "Échec de la suppression du groupe de clients"+ },+ "autocomplete": {+ "placeholder": "Rechercher des groupes de clients…",+ "empty": "Aucun groupe de clients correspondant"+ }+ },+ "settings": {+ "webhooks": {+ "messages": {+ "updated": "Point de terminaison webhook mis à jour",+ "removed": "Point de terminaison webhook supprimé"+ },+ "errors": {+ "send_test_failed": "Échec de l'envoi du webhook de test",+ "redeliver_failed": "Échec de la nouvelle livraison"+ }+ }+ },+ "stock_items": {+ "messages": {+ "stock_updated": "Stock mis à jour",+ "stock_item_deleted": "Article en stock supprimé"+ }+ }+ }+}diff --git a/packages/dashboard/src/locales/pl.json b/packages/dashboard/src/locales/pl.jsonnew file mode 100644index 0000000000..c5f37263b7--- /dev/null+++ b/packages/dashboard/src/locales/pl.json@@ -0,0 +1,2398 @@+{+ "admin": {+ "a11y": {+ "edit_media": "Edytuj obraz",+ "delete_image": "Usuń obraz"+ },+ "gift_cards": {+ "statuses": {+ "partially_redeemed": "Częściowo zrealizowana",+ "redeemed": "Zrealizowana",+ "canceled": "Anulowana",+ "expired": "Wygasła"+ },+ "columns": {+ "used": "Wykorzystano",+ "remaining": "Pozostało",+ "batch": "Partia",+ "customer": "Klient",+ "issued_by": "Wystawiona przez"+ },+ "table": {+ "search_placeholder": "Szukaj według kodu…",+ "empty": "Brak kart podarunkowych"+ },+ "messages": {+ "created": "Karta podarunkowa została utworzona",+ "create_failed": "Nie udało się utworzyć karty podarunkowej",+ "updated": "Karta podarunkowa została zaktualizowana",+ "update_failed": "Nie udało się zaktualizować karty podarunkowej",+ "deleted": "Karta podarunkowa została usunięta",+ "delete_failed": "Nie udało się usunąć karty podarunkowej",+ "batch_created": "Partia kart podarunkowych została utworzona",+ "batch_create_failed": "Nie udało się utworzyć partii kart podarunkowych"+ },+ "batch_autocomplete": {+ "placeholder": "Szukaj partii według prefiksu…",+ "empty": "Brak pasujących partii"+ }+ },+ "branding": {+ "app_name": "Panel administracyjny Spree",+ "powered_by": "Obsługiwane przez Spree Commerce"+ },+ "nav": {+ "home": "Strona główna",+ "account": "Konto",+ "orders": "Zamówienia",+ "draft_orders": "Zamówienia robocze",+ "products": "Produkty",+ "price_lists": "Cenniki",+ "categories": "Kategorie",+ "options": "Opcje",+ "transfers": "Transfery",+ "customers": "Klienci",+ "customer_groups": "Grupy",+ "promotions": "Promocje",+ "gift_cards": "Karty podarunkowe",+ "reports": "Raporty",+ "settings": "Ustawienia"+ },+ "settings_nav": {+ "groups": {+ "store": "Sklep",+ "payments": "Płatności i podatki",+ "fulfillment": "Realizacja zamówień",+ "team": "Zespół i dostęp"+ },+ "items": {+ "store": "Sklep",+ "emails": "Wiadomości e-mail",+ "channels": "Kanały sprzedaży",+ "payment_methods": "Metody płatności",+ "tax_categories": "Kategorie podatkowe",+ "markets": "Rynki",+ "stock_locations": "Lokalizacje magazynowe",+ "custom_field_definitions": "Pola niestandardowe",+ "staff": "Zespół",+ "api_keys": "Klucze API",+ "webhooks": "Webhooki",+ "allowed_origins": "Dozwolone źródła",+ "profile": "Profil"+ }+ },+ "fields": {+ "products_count": {+ "label": "Produkty"+ },+ "prices_count": {+ "label": "Ceny"+ },+ "customer_id": {+ "label": "Klient"+ },+ "role_id": {+ "label": "Rola"+ },+ "role_ids": {+ "label": "Role"+ },+ "tax_category_id": {+ "label": "Kategoria podatkowa"+ },+ "promotion": {+ "name": {+ "placeholder": "Wyprzedaż letnia"+ },+ "description": {+ "placeholder": "Opis wewnętrzny (opcjonalnie)"+ },+ "kind": {+ "label": "W jaki sposób jest stosowana ta promocja?"+ },+ "code": {+ "placeholder": "LATO2026"+ },+ "multi_codes": {+ "label": "Wygeneruj partię unikalnych kodów",+ "help": "Przydatne w przypadku kodów jednorazowych — każdy klient realizuje inny kod."+ },+ "number_of_codes": {+ "label": "Liczba kodów",+ "placeholder": "100"+ },+ "code_prefix": {+ "label": "Prefiks kodu (opcjonalnie)",+ "placeholder": "VIP",+ "help": "Każdy wygenerowany kod będzie zaczynał się od tego prefiksu."+ },+ "starts_at": {+ "placeholder": "Brak daty rozpoczęcia"+ },+ "expires_at": {+ "placeholder": "Brak daty wygaśnięcia"+ },+ "usage_limit": {+ "label": "Limit użyć",+ "placeholder": "Bez ograniczeń"+ },+ "match_policy": {+ "label": "Reguła dopasowania"+ }+ },+ "custom_field_definition": {+ "label": {+ "label": "Etykieta",+ "placeholder": "np. Materiał"+ },+ "namespace": {+ "label": "Przestrzeń nazw",+ "placeholder": "custom"+ },+ "key": {+ "label": "Klucz",+ "placeholder": "np. material",+ "invalid_format": "Tylko litery, cyfry i podkreślenia"+ },+ "field_type": {+ "label": "Typ",+ "read_only_help": "Typu nie można zmienić, gdy istnieją już wartości — zmiana spowodowałaby błędną interpretację zapisanych wartości.",+ "options": {+ "short_text": "Krótki tekst",+ "long_text": "Długi tekst",+ "rich_text": "Tekst sformatowany",+ "number": "Liczba",+ "boolean": "Wartość logiczna",+ "json": "JSON"+ }+ },+ "resource_type": {+ "label": "Dotyczy",+ "read_only_help": "Właściciela nie można zmienić, gdy istnieją już wartości dla tego pola.",+ "options": {+ "Spree::Product": "Produkty",+ "Spree::Variant": "Warianty",+ "Spree::Order": "Zamówienia",+ "Spree::User": "Klienci",+ "Spree::Category": "Kategorie",+ "Spree::OptionType": "Typy opcji"+ }+ },+ "storefront_visible": {+ "label": "Widoczne w sklepie",+ "column_label": "Sklep"+ }+ },+ "tax_category": {+ "name": {+ "placeholder": "np. Stawka obniżona"+ },+ "tax_code": {+ "label": "Kod podatkowy",+ "placeholder": "Kod zewnętrznego dostawcy podatkowego (Avalara itp.)"+ },+ "description": {+ "placeholder": "Opcjonalny opis wewnętrzny"+ },+ "is_default": {+ "label": "Domyślna",+ "help": "Ustawienie tej kategorii degraduje poprzednią domyślną. Produkty bez wyraźnie przypisanej kategorii korzystają z tej kategorii."+ }+ },+ "allowed_origin": {+ "origin": {+ "label": "Źródło",+ "placeholder": "https://admin.example.com",+ "help": "Sam schemat + host (+ opcjonalnie port). Bez ścieżki, zapytania ani fragmentu."+ }+ },+ "channel": {+ "name": {+ "placeholder": "np. POS, Hurt, Sklep Meta"+ },+ "code": {+ "label": "Kod",+ "placeholder": "Wyprowadzany automatycznie z nazwy",+ "help": "Stabilny identyfikator używany przez klientów API za pośrednictwem nagłówka X-Spree-Channel oraz do przypisywania zamówień. Pozostaw puste, aby wyprowadzić automatycznie z nazwy. Małe litery, cyfry, myślniki, podkreślenia."+ },+ "active": {+ "label": "Aktywny",+ "help": "Nieaktywne kanały sprzedaży przestają przyjmować zamówienia i nie są dopasowywane przez nagłówek X-Spree-Channel."+ },+ "default": {+ "label": "Kanał domyślny",+ "help": "Dokładnie jeden kanał na sklep jest domyślny. Używany jako rozwiązanie zastępcze, gdy nie wybrano żadnego kanału, oraz jako cel automatycznej publikacji nowych produktów."+ },+ "order_routing_strategy": {+ "label": "Strategia routingu zamówień",+ "help": "Zastępuje strategię routingu na poziomie sklepu dla zamówień przypisanych do tego kanału. Pozostaw puste, aby dziedziczyć.",+ "inherit": "Dziedzicz ze sklepu",+ "options": {+ "Spree::OrderRouting::Strategy::Rules": "Reguły (uporządkowane)",+ "Spree::OrderRouting::Strategy::Legacy": "Starsza"+ }+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "Hasło"+ },+ "password_confirmation": {+ "label": "Potwierdź hasło"+ }+ },+ "customer_group": {+ "name": {+ "placeholder": "np. Klienci VIP"+ },+ "description": {+ "placeholder": "Opcjonalny opis wewnętrzny"+ }+ },+ "price_list": {+ "name": {+ "label": "Nazwa",+ "placeholder": "np. Hurt UE",+ "help": "Etykieta wewnętrzna — nigdy nie pokazywana klientom."+ },+ "description": {+ "label": "Opis",+ "placeholder": "Opcjonalny opis wewnętrzny"+ },+ "starts_at": {+ "label": "Rozpoczyna się",+ "placeholder": "Natychmiast",+ "help": "Kiedy ta lista staje się aktywna. Pozostaw puste, aby rozpocząć natychmiast po aktywacji."+ },+ "ends_at": {+ "label": "Kończy się",+ "placeholder": "Nigdy",+ "help": "Pozostaw puste, aby nie ustawiać daty zakończenia."+ },+ "match_policy": {+ "label": "Reguła dopasowania",+ "all": "Wszystkie reguły muszą być spełnione",+ "any": "Dowolna reguła może być spełniona"+ },+ "status": {+ "active": "Aktywna",+ "scheduled": "Zaplanowana",+ "inactive": "Nieaktywna",+ "draft": "Wersja robocza"+ }+ },+ "price_rule": {+ "customers": {+ "label": "Klienci",+ "help": "Pozostaw puste, aby zastosować tę regułę do każdego zalogowanego klienta."+ },+ "customer_groups": {+ "label": "Grupy klientów",+ "help": "Pozostaw puste, aby zastosować tę regułę do każdego klienta niezależnie od grupy."+ },+ "markets": {+ "label": "Rynki",+ "help": "Pozostaw puste, aby zastosować tę regułę na każdym rynku."+ }+ },+ "stock_location": {+ "name": {+ "placeholder": "Magazyn Brooklyn"+ },+ "admin_name": {+ "label": "Nazwa wewnętrzna",+ "placeholder": "Opcjonalnie — widoczne tylko w panelu administracyjnym"+ },+ "kind": {+ "label": "Rodzaj"+ },+ "active": {+ "label": "Aktywna",+ "help": "Nieaktywne lokalizacje nie pojawiają się w wyborze realizacji zamówień."+ },+ "default": {+ "label": "Lokalizacja domyślna",+ "help": "Nowe pozycje magazynowe są tu propagowane. Tylko jedna lokalizacja może być domyślna."+ },+ "backorderable_default": {+ "label": "Domyślnie dostępne na zamówienie",+ "help": "Nowe pozycje magazynowe domyślnie zezwalają na zamówienia oczekujące, gdy brakuje towaru."+ },+ "propagate_all_variants": {+ "label": "Automatycznie twórz pozycje magazynowe dla wszystkich wariantów",+ "help": "Twórz pozycje magazynowe w tej lokalizacji dla każdego wariantu produktu."+ },+ "pickup_enabled": {+ "label": "Zezwól na odbiór osobisty",+ "help": "Klienci mogą odbierać zamówienia z tej lokalizacji podczas składania zamówienia."+ },+ "pickup_stock_policy": {+ "label": "Polityka stanów magazynowych"+ },+ "pickup_ready_in_minutes": {+ "label": "Gotowe za (minuty)",+ "placeholder": "60"+ },+ "pickup_instructions": {+ "label": "Instrukcje odbioru",+ "placeholder": "Gdzie klient ma się udać, aby odebrać swoje zamówienie."+ }+ },+ "payment_method": {+ "type": {+ "label": "Dostawca",+ "placeholder": "Wybierz dostawcę"+ },+ "name": {+ "placeholder": "np. Karta kredytowa (Stripe)"+ },+ "description": {+ "placeholder": "Opis widoczny dla klienta podczas składania zamówienia"+ },+ "storefront_visible": {+ "label": "Widoczna w sklepie"+ },+ "active": {+ "label": "Aktywna",+ "help": "Nieaktywne metody są ukryte podczas składania zamówienia."+ },+ "auto_capture": {+ "label": "Automatyczne pobranie",+ "help": "Pobieraj środki automatycznie po autoryzacji. Gdy wyłączone, musisz pobrać je ręcznie."+ },+ "provider_configuration": "Konfiguracja dostawcy"+ },+ "market": {+ "name": {+ "placeholder": "np. Europa"+ },+ "currency": {+ "label": "Waluta",+ "help": "Waluta ISO 4217 używana dla wszystkich cen na tym rynku."+ },+ "default_locale": {+ "label": "Domyślne ustawienia regionalne",+ "help": "Język sklepu dla kupujących na tym rynku."+ },+ "supported_locales": {+ "label": "Obsługiwane ustawienia regionalne",+ "help": "Dodatkowe języki, na które kupujący mogą się przełączyć. Domyślne ustawienia regionalne są zawsze uwzględnione."+ },+ "country_isos": {+ "label": "Kraje",+ "help": "Wybierz kraje obejmowane przez ten rynek. Każdy kraj może należeć do co najwyżej jednego rynku w obrębie sklepu."+ },+ "tax_inclusive": {+ "label": "Ceny z podatkiem",+ "help": "Wyświetlaj ceny z uwzględnionym podatkiem. Powszechne na rynkach UE."+ },+ "default": {+ "label": "Rynek domyślny",+ "help": "Kupujący bez znanego kraju widzą ten rynek. Tylko jeden może być domyślny w obrębie sklepu."+ }+ },+ "option_type": {+ "name": {+ "label": "Nazwa wewnętrzna",+ "placeholder": "np. rozmiar-koszuli",+ "help": "Identyfikator zapisany małymi literami. Musi być unikalny w obrębie sklepu."+ },+ "label": {+ "label": "Etykieta",+ "placeholder": "np. Rozmiar koszuli",+ "help": "Pokazywana klientom w sklepie."+ },+ "kind": {+ "label": "Rodzaj",+ "help": "Określa sposób renderowania opcji w sklepie. Próbka koloru pokazuje kolor w formacie heksadecymalnym; przyciski pokazują miniaturę."+ },+ "filterable": {+ "label": "Możliwość filtrowania",+ "help": "Pokaż tę opcję jako filtr na listach produktów w sklepie."+ }+ },+ "option_value": {+ "name": {+ "label": "Nazwa wewnętrzna",+ "placeholder": "np. mały"+ },+ "label": {+ "label": "Etykieta",+ "placeholder": "np. Mały"+ },+ "color_code": {+ "label": "Kolor"+ },+ "image": {+ "label": "Obraz"+ }+ },+ "variant": {+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUKT-CZERWONY-S"+ },+ "barcode": {+ "label": "Kod kreskowy"+ },+ "weight": {+ "label": "Waga"+ },+ "weight_unit": {+ "label": "Jednostka"+ },+ "height": {+ "label": "Wysokość"+ },+ "width": {+ "label": "Szerokość"+ },+ "depth": {+ "label": "Głębokość"+ },+ "dimensions_unit": {+ "label": "Jednostka"+ }+ },+ "api_key": {+ "name": {+ "label": "Nazwa",+ "placeholder": "Integracja backendu, Sklep produkcyjny, …",+ "required": "Nazwa jest wymagana"+ },+ "key_type": {+ "label": "Typ"+ },+ "scopes": {+ "label": "Zakresy"+ }+ },+ "store": {+ "name": {+ "label": "Nazwa sklepu"+ },+ "preferred_admin_locale": {+ "label": "Język panelu administracyjnego",+ "placeholder": "Użyj języka domyślnego"+ },+ "preferred_timezone": {+ "label": "Strefa czasowa",+ "placeholder": "Wybierz strefę czasową"+ },+ "preferred_unit_system": {+ "label": "System jednostek"+ },+ "preferred_weight_unit": {+ "label": "Jednostka wagi"+ },+ "mail_from_address": {+ "label": "Adres nadawcy",+ "placeholder": "[email protected]",+ "help": "Używany jako adres nadawcy w każdej wiadomości transakcyjnej."+ },+ "customer_support_email": {+ "label": "E-mail obsługi klienta",+ "placeholder": "[email protected]",+ "help": "Adres zwrotny pokazywany klientom w wiadomościach ze sklepu."+ },+ "new_order_notifications_email": {+ "label": "Powiadomienia o nowych zamówieniach",+ "placeholder": "[email protected]",+ "help": "Odbiorca powiadomień „złożono nowe zamówienie”. Pozostaw puste, aby wyłączyć."+ },+ "preferred_send_consumer_transactional_emails": {+ "label": "Wysyłaj wiadomości transakcyjne do klientów",+ "help": "Gdy wyłączone, nie są wysyłane żadne wiadomości z potwierdzeniem zamówienia, wysyłki ani zwrotu."+ },+ "mailer_logo": {+ "label": "Logo e-mail",+ "help": "PNG lub JPG z przezroczystym tłem. Osadzane w nagłówkach wiadomości transakcyjnych."+ }+ },+ "webhook_endpoint": {+ "name": {+ "label": "Nazwa",+ "placeholder": "np. Potok zamówień",+ "help": "Opcjonalna etykieta pokazywana na tej liście."+ },+ "url": {+ "label": "Docelowy adres URL",+ "placeholder": "https://example.com/webhooks"+ },+ "active": {+ "label": "Aktywny",+ "help": "Nieaktywne punkty końcowe nie otrzymują dostarczeń."+ },+ "subscriptions": {+ "label": "Zdarzenia",+ "help": "Wybierz, które zdarzenia mają wyzwalać webhook. Nie wybieraj nic, aby otrzymywać każde zdarzenie."+ }+ },+ "product": {+ "name": {+ "label": "Nazwa",+ "placeholder": "Nazwa produktu"+ },+ "description": {+ "label": "Opis",+ "placeholder": "Napisz opis produktu…"+ },+ "make_active_at": {+ "label": "Aktywuj o"+ },+ "available_on": {+ "label": "Dostępny od"+ },+ "discontinue_on": {+ "label": "Wycofaj z dniem"+ },+ "category_ids": {+ "label": "Kategorie"+ },+ "channels": {+ "label": "Kanały sprzedaży"+ },+ "tags": {+ "label": "Tagi"+ }+ },+ "product_publication": {+ "published_at": {+ "label": "Publikuj od",+ "placeholder": "Na żywo natychmiast",+ "help": "Pozostaw puste, aby opublikować natychmiast."+ },+ "unpublished_at": {+ "label": "Cofnij publikację",+ "placeholder": "Nigdy",+ "help": "Pozostaw puste, aby utrzymać na liście bezterminowo."+ }+ },+ "gift_card": {+ "code": {+ "label": "Kod",+ "help": "Pozostaw puste, aby wygenerować automatycznie. W przypadku partii staje się to prefiksem."+ },+ "amount": {+ "label": "Kwota"+ },+ "currency": {+ "label": "Waluta"+ },+ "expires_at": {+ "label": "Wygasa",+ "placeholder": "Brak daty wygaśnięcia"+ },+ "customer_id": {+ "label": "Klient"+ },+ "quantity": {+ "label": "Ilość",+ "help": "1 wydaje pojedynczą kartę. Więcej niż 1 wydaje partię z automatycznie wygenerowanymi kodami."+ }+ },+ "customer": {+ "tags": {+ "label": "Tagi"+ },+ "customer_groups": {+ "label": "Grupy klientów"+ },+ "accepts_email_marketing": {+ "label": "Zapisany do marketingu"+ },+ "internal_note": {+ "label": "Notatka wewnętrzna",+ "placeholder": "Kontekst dotyczący tego klienta tylko dla personelu…"+ }+ },+ "store_credit": {+ "amount": {+ "label": "Kwota"+ },+ "currency": {+ "label": "Waluta"+ },+ "category_id": {+ "label": "Kategoria"+ },+ "memo": {+ "label": "Notatka",+ "placeholder": "Powód przyznania tego kredytu"+ }+ },+ "order": {+ "email": {+ "label": "Lub użyj adresu e-mail gościa",+ "placeholder": "[email protected]"+ },+ "customer_note": {+ "label": "Notatka klienta (widoczna dla klienta)"+ },+ "internal_note": {+ "label": "Notatka wewnętrzna (tylko dla personelu)"+ },+ "coupon_code": {+ "label": "Kod kuponu",+ "placeholder": "Opcjonalnie"+ },+ "channel": {+ "label": "Kanał sprzedaży",+ "placeholder": "Użyj domyślnego sklepu",+ "help": "Przypisz zamówienie do konkretnego kanału sprzedaży. Domyślnie do kanału internetowego sklepu."+ }+ },+ "media": {+ "alt": {+ "label": "Tekst alternatywny",+ "placeholder": "Opisz obraz na potrzeby dostępności i SEO"+ }+ },+ "profile": {+ "email": {+ "label": "E-mail"+ },+ "first_name": {+ "label": "Imię"+ },+ "last_name": {+ "label": "Nazwisko"+ },+ "selected_locale": {+ "label": "Język",+ "help": "Język używany w całym panelu administracyjnym. Wpływa tylko na to, co widzisz."+ }+ }+ },+ "promotions": {+ "rule_types_empty": "Brak zarejestrowanych typów reguł.",+ "rule_types_all_used": "Każdy dostępny typ reguły jest już przypisany do tej promocji.",+ "generate_code": {+ "title": "Wygeneruj losowy kod"+ },+ "kinds": {+ "coupon_code": "Kod kuponu",+ "automatic": "Automatyczna (bez kodu)"+ },+ "match_policies": {+ "all": "Wszystkie reguły muszą być spełnione",+ "any": "Dowolna reguła może być spełniona",+ "all_hint": "Wszystkie reguły muszą być spełnione.",+ "any_hint": "Dowolna reguła może być spełniona."+ },+ "rules_card": {+ "title": "Reguły",+ "description": "Warunki decydujące o tym, czy promocja zostanie zastosowana.",+ "empty": "Brak reguł. Bez reguł promocja zawsze obowiązuje (z zastrzeżeniem harmonogramu i limitu użycia).",+ "add_rule": "Dodaj regułę"+ },+ "validation": {+ "code_required": "Kod jest wymagany (lub kliknij Wygeneruj)",+ "prefix_required": "Prefiks jest wymagany dla partii wielu kodów",+ "number_of_codes_required": "Wybierz, ile kodów wygenerować",+ "expiry_after_start": "Data wygaśnięcia musi być późniejsza niż data rozpoczęcia"+ },+ "delete_confirm": {+ "title": "Usunąć promocję?",+ "message": "{{name}} zostanie trwale usunięta. Promocji powiązanych z zrealizowanymi zamówieniami nie można usunąć.",+ "default_name": "Ta promocja"+ },+ "rules": {+ "country": {+ "label": "Kraje",+ "search_placeholder": "Szukaj krajów…",+ "empty": "Brak pasujących krajów"+ },+ "product": {+ "label": "Produkty",+ "search_placeholder": "Szukaj produktów po nazwie…",+ "empty": "Brak pasujących produktów",+ "match_policy": {+ "any": {+ "label": "Dowolny z tych produktów",+ "description": "Zamówienie musi zawierać co najmniej jeden."+ },+ "all": {+ "label": "Wszystkie te produkty",+ "description": "Zamówienie musi zawierać każdy produkt."+ },+ "none": {+ "label": "Żaden z tych produktów",+ "description": "Zamówienie nie może zawierać żadnego z nich."+ }+ }+ },+ "category": {+ "label": "Kategorie",+ "search_placeholder": "Szukaj kategorii…",+ "empty": "Brak pasujących kategorii",+ "match_policy": {+ "any": {+ "label": "Dowolna z tych kategorii",+ "description": "Zamówienie musi zawierać produkt z co najmniej jednej."+ },+ "all": {+ "label": "Wszystkie te kategorie",+ "description": "Zamówienie musi zawierać produkt z każdej kategorii."+ }+ }+ },+ "customer_group": {+ "label": "Grupy klientów",+ "search_placeholder": "Szukaj grup klientów…",+ "empty": "Brak pasujących grup klientów"+ },+ "customer": {+ "label": "Klienci",+ "search_placeholder": "Szukaj klientów po nazwie lub adresie e-mail…",+ "empty": "Brak pasujących klientów"+ }+ },+ "table": {+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Brak promocji",+ "no_end": "Bez końca"+ },+ "code": {+ "automatic": "Automatyczna",+ "multi": "multi"+ },+ "basics_card": {+ "title": "Podstawowe informacje"+ },+ "trigger_card": {+ "title": "Wyzwalacz"+ },+ "schedule_card": {+ "title": "Harmonogram i limity"+ },+ "trigger_summary": {+ "multi_code": "Kupon wielokodowy ({{count}} kodów)",+ "multi_code_with_prefix": "Kupon wielokodowy ({{count}} kodów z prefiksem „{{prefix}}”)",+ "show_codes": "Pokaż kody",+ "single_code": "Pojedynczy kod kuponu:",+ "locked_help": "Ustawień wyzwalacza nie można zmienić po utworzeniu. Aby je zmienić, utwórz nową promocję."+ },+ "remove_rule_confirm": {+ "title": "Usunąć regułę?",+ "message": "Zostanie usunięta po zapisaniu promocji."+ },+ "rule_summary": {+ "product_count": "{{count}} produktów",+ "category_count": "{{count}} kategorii",+ "customer_count": "{{count}} klientów"+ },+ "rule_picker": {+ "title": "Dodaj regułę",+ "description": "Wybierz typ reguły do skonfigurowania."+ },+ "rule_edit": {+ "description": "Dostosuj parametry reguły.",+ "no_options": "Ta reguła nie ma konfigurowalnych opcji — sama jej obecność wymusza ograniczenie."+ },+ "actions_card": {+ "description": "Co się dzieje, gdy promocja zostanie spełniona.",+ "empty": "Brak akcji. Promocja bez akcji nie powoduje żadnego efektu po zastosowaniu.",+ "add_action": "Dodaj akcję"+ },+ "remove_action_confirm": {+ "title": "Usunąć akcję?",+ "message": "Zostanie usunięta po zapisaniu promocji."+ },+ "action_summary": {+ "variant_count": "{{count}} wariantów"+ },+ "action_picker": {+ "title": "Dodaj akcję",+ "description": "Wybierz, co ma się stać, gdy promocja zostanie spełniona."+ },+ "action_edit": {+ "description": "Skonfiguruj parametry akcji.",+ "no_options": "Ta akcja nie ma konfigurowalnych opcji."+ },+ "coupon_codes": {+ "title": "Kody kuponów",+ "description": "Automatycznie wygenerowane kody dla tej promocji. Tylko do odczytu — wygeneruj ponownie, zmieniając ustawienie liczby kodów promocji.",+ "description_with_count": "{{count}} automatycznie wygenerowanych kodów. Tylko do odczytu — wygeneruj ponownie, zmieniając ustawienie liczby kodów promocji.",+ "empty": "Nie wygenerowano jeszcze żadnych kodów.",+ "unused": "Nieużyty",+ "used": "Użyty",+ "export_csv": "Eksportuj CSV",+ "states": {+ "used": "Wykorzystany",+ "partially_used": "Częściowo wykorzystany"+ }+ },+ "rule_types": {+ "category": {+ "name": "Kategorie",+ "description": "Zamówienie zawiera produkty z określonych kategorii"+ },+ "country": {+ "name": "Kraj",+ "description": "Ogranicz do zamówień z adresem dostawy w określonym kraju"+ },+ "currency": {+ "name": "Waluta",+ "description": "Ogranicz do zamówień w określonej walucie"+ },+ "customer": {+ "name": "Klienci",+ "description": "Dostępne tylko dla określonych klientów"+ },+ "customer_group": {+ "name": "Grupa(-y) klientów",+ "description": "Dostępne tylko dla klientów z określonych grup klientów"+ },+ "customer_logged_in": {+ "name": "Tylko zalogowani klienci",+ "description": "Dostępne tylko dla zalogowanych klientów"+ },+ "first_order": {+ "name": "Pierwsze zamówienie",+ "description": "Musi być pierwszym zamówieniem klienta"+ },+ "item_total": {+ "name": "Wartość produktów",+ "description": "Suma zamówienia spełnia te kryteria"+ },+ "one_use_per_user": {+ "name": "Jedno użycie na użytkownika",+ "description": "Tylko jedno użycie na użytkownika"+ },+ "option_value": {+ "name": "Wartość (wartości) opcji",+ "description": "Zamówienie zawiera produkty z pasującymi wartościami opcji"+ },+ "product": {+ "name": "Produkt(y)",+ "description": "Zamówienie zawiera określone produkty"+ }+ },+ "action_types": {+ "create_adjustment": {+ "name": "Utwórz korektę dla całego zamówienia",+ "description": "Tworzy korektę kredytową promocji dla zamówienia"+ },+ "create_item_adjustments": {+ "name": "Utwórz korektę dla poszczególnych pozycji",+ "description": "Tworzy korektę kredytową promocji dla pozycji zamówienia"+ },+ "create_line_items": {+ "name": "Utwórz pozycje zamówienia",+ "description": "Dodaje do koszyka określoną ilość wariantu"+ },+ "free_shipping": {+ "name": "Darmowa wysyłka",+ "description": "Sprawia, że wszystkie przesyłki w zamówieniu są bezpłatne"+ }+ },+ "messages": {+ "action_added": "Dodano akcję",+ "action_updated": "Zaktualizowano akcję",+ "action_removed": "Usunięto akcję",+ "rule_added": "Dodano regułę",+ "rule_updated": "Zaktualizowano regułę",+ "rule_removed": "Usunięto regułę"+ },+ "errors": {+ "failed_to_add_action": "Nie udało się dodać akcji",+ "failed_to_update_action": "Nie udało się zaktualizować akcji",+ "failed_to_remove_action": "Nie udało się usunąć akcji",+ "failed_to_add_rule": "Nie udało się dodać reguły",+ "failed_to_update_rule": "Nie udało się zaktualizować reguły",+ "failed_to_remove_rule": "Nie udało się usunąć reguły"+ }+ },+ "components": {+ "market_combobox": {+ "search_placeholder": "Szukaj rynków…",+ "empty": "Brak pasujących rynków"+ },+ "custom_fields_card": {+ "set_up": "Skonfiguruj",+ "empty_title": "Brak pól niestandardowych",+ "empty_description": "Śledź uporządkowane szczegóły, takie jak materiał, krój czy instrukcje pielęgnacji.",+ "not_yet_set": "{{count}} z {{total}} jeszcze nie ustawiono"+ },+ "custom_fields": {+ "title": "Pola niestandardowe",+ "new_definition_title": "Nowe pole niestandardowe",+ "definition_created_title": "Definicja utworzona",+ "definition_created_toast": "Definicja utworzona",+ "definition_created_hint": "Możesz teraz ustawić jej wartość lub najpierw zdefiniować kolejne pole.",+ "empty_title": "Brak zdefiniowanych pól niestandardowych dla {{resource}}",+ "empty_description": "Zdefiniuj pole niestandardowe, aby przechowywać typowane, ustrukturyzowane informacje wraz z rekordami.",+ "create_definition": "Utwórz definicję",+ "values_saved": "Pola niestandardowe zapisane",+ "values_save_failed": "Nie udało się zapisać pól niestandardowych",+ "admin_only": "Tylko dla administratorów",+ "add_another_field": "Dodaj kolejne pole",+ "create_another": "Utwórz kolejne",+ "set_values": "Ustaw wartości"+ },+ "adjustment_action_editor": {+ "calculator_label": "Kalkulator",+ "loading_calculators": "Ładowanie kalkulatorów…",+ "select_calculator": "Wybierz kalkulator",+ "no_extra_settings": "Ten kalkulator nie ma dodatkowych ustawień.",+ "settings_label": "Ustawienia kalkulatora"+ }+ },+ "pages": {+ "home": {+ "top_products": "Najlepsze produkty",+ "top_products_description": "Najlepiej sprzedające się produkty w Twoim sklepie.",+ "title": "Pulpit",+ "subtitle": "Przegląd wyników Twojego sklepu",+ "metrics": {+ "sales": "Łączna sprzedaż",+ "orders": "Łączna liczba zamówień",+ "avg_order_value": "Śr. wartość zamówienia"+ },+ "metric_short": {+ "sales": "Sprzedaż",+ "orders": "Zamówienia",+ "avg_order_value": "Śr. wart."+ },+ "columns": {+ "product": "Produkt",+ "price": "Cena",+ "sold": "Sprzedano"+ }+ },+ "staff": {+ "title": "Zespół",+ "subtitle": "Zarządzaj współpracownikami i rolami administratorów",+ "invite_cta": "Zaproś współpracownika",+ "members_section": "Członkowie",+ "invitations_section": "Oczekujące zaproszenia",+ "empty": "Brak członków zespołu",+ "empty_description": "Zaproś współpracownika do współpracy nad tym sklepem.",+ "table": {+ "member": "Członek",+ "roles": "Role",+ "role": "Rola"+ },+ "invite_sheet": {+ "title": "Zaproś współpracownika",+ "description": "Wyślemy mu e-mailem link do ustawienia hasła."+ },+ "edit_sheet": {+ "title": "Edytuj współpracownika"+ },+ "actions": {+ "resend": "Wyślij ponownie",+ "remove": "Usuń z zespołu"+ },+ "messages": {+ "revoked": "Zaproszenie cofnięte",+ "updated": "Zespół zaktualizowany",+ "removed": "Usunięto z zespołu"+ }+ },+ "channels": {+ "title": "Kanały sprzedaży",+ "empty_message": "Brak kanałów sprzedaży",+ "add_cta": "Nowy kanał sprzedaży",+ "add_sheet_title": "Dodaj kanał sprzedaży",+ "edit_sheet_title": "Edytuj kanał sprzedaży",+ "create_label": "Utwórz kanał sprzedaży",+ "create_description": "Kanały sprzedaży grupują zamówienia i oferty produktów — „online”, „pos”, integracja z marketplace itp.",+ "edit_description": "Zmień nazwę kanału sprzedaży lub wstrzymaj go. Nieaktywne kanały sprzedaży przestają przyjmować zamówienia.",+ "delete_confirm": {+ "title": "Usunąć kanał sprzedaży?",+ "message": "{{name}} zostanie usunięty. Produkty i zamówienia z nim powiązane stracą odniesienie do kanału sprzedaży."+ },+ "search_placeholder": "Szukaj kanałów sprzedaży…",+ "no_channels_found": "Nie znaleziono kanałów sprzedaży"+ },+ "customers": {+ "new_cta": "Nowy klient",+ "create_label": "Utwórz klienta",+ "edit_sheet_title": "Edytuj klienta",+ "groups_cta": "Grupy klientów",+ "groups": {+ "title": "Grupy klientów",+ "add_cta": "Dodaj grupę klientów",+ "edit_sheet_title": "Edytuj grupę klientów",+ "add_sheet_title": "Dodaj grupę klientów"+ },+ "detail": {+ "stat_total_spent": "Łącznie wydano",+ "stat_orders": "Zamówienia",+ "stat_avg_order_value": "Średnia wartość zamówienia",+ "section_profile": "Profil",+ "section_addresses": "Adresy",+ "section_orders": "Zamówienia",+ "section_store_credit": "Kredyt sklepowy",+ "section_internal_note": "Notatka wewnętrzna",+ "section_tags": "Tagi",+ "addresses_empty": "Brak zapisanych adresów.",+ "orders_empty": "Brak zamówień.",+ "store_credit_empty": "Nie przyznano kredytu sklepowego.",+ "add_address": "Dodaj adres",+ "edit_address": "Edytuj adres",+ "issue_credit": "Przyznaj kredyt sklepowy",+ "edit_credit": "Edytuj kredyt sklepowy"+ }+ },+ "orders": {+ "drafts_title": "Wersje robocze zamówień",+ "new": {+ "title": "Nowe zamówienie",+ "section_customer": "Klient",+ "section_items": "Pozycje",+ "section_billing": "Rozliczenie",+ "section_notes": "Notatki",+ "section_summary": "Podsumowanie",+ "add_line_item": "Dodaj pozycję",+ "select_customer": "Wybierz klienta",+ "search_variant": "Szukaj wariantu…"+ },+ "detail": {+ "section_summary": "Podsumowanie",+ "section_items": "Pozycje",+ "section_payments": "Płatności",+ "section_shipments": "Przesyłki",+ "section_customer": "Klient",+ "section_shipping_address": "Adres dostawy",+ "section_billing_address": "Adres rozliczeniowy",+ "section_internal_note": "Notatka wewnętrzna",+ "section_customer_note": "Notatka klienta",+ "section_history": "Historia",+ "summary": {+ "created_by": "Utworzone przez",+ "market": "Rynek",+ "locale": "Język",+ "channel": "Kanał sprzedaży",+ "ip_address": "Adres IP"+ },+ "empty_payments": "Brak płatności.",+ "empty_shipments": "Brak przesyłek.",+ "empty_history": "Brak historii.",+ "actions": {+ "approve": "Zatwierdź",+ "cancel": "Anuluj zamówienie",+ "resume": "Wznów",+ "refund": "Zwrot środków",+ "capture": "Pobierz",+ "void": "Unieważnij",+ "mark_paid": "Oznacz jako opłacone",+ "ship": "Oznacz jako wysłane"+ },+ "dialogs": {+ "cancel_title": "Anulować zamówienie?",+ "approve_title": "Zatwierdzić zamówienie?",+ "refund_title": "Zwrócić płatność?"+ }+ }+ },+ "products": {+ "add_cta": "Dodaj produkt",+ "new": {+ "title": "Nowy produkt",+ "description": "Skonfiguruj swój produkt — dodaj warianty, ceny, stan magazynowy, multimedia i pola niestandardowe, a następnie zapisz wszystko za jednym razem.",+ "save_label": "Utwórz produkt",+ "create_succeeded": "Produkt utworzony",+ "create_failed": "Nie udało się utworzyć produktu",+ "preview_slug_placeholder": "twoj-slug-produktu"+ },+ "edit": {+ "bulk_prices": {+ "no_variants": "Dodaj co najmniej jeden wariant, aby rozpocząć edycję cen."+ }+ },+ "section_basics": "Podstawy",+ "section_media": "Multimedia",+ "section_pricing": "Ceny",+ "section_inventory": "Stan magazynowy",+ "section_seo": "SEO",+ "section_categorization": "Kategoryzacja",+ "section_organization": "Organizacja",+ "section_variants": "Warianty",+ "section_custom_fields": "Pola niestandardowe",+ "publishing": {+ "title": "Publikacja",+ "manage_cta": "Zarządzaj",+ "manage_title": "Zarządzaj kanałami sprzedaży",+ "manage_description": "Wybierz, na których kanałach sprzedaży ten produkt ma być wystawiony. Wyłącz kanał, aby wycofać go ze sprzedaży wszędzie.",+ "empty": "Jeszcze nie wystawiony w żadnym kanale sprzedaży.",+ "no_channels": "Brak dostępnych kanałów sprzedaży. Utwórz jeden w Ustawienia → Kanały sprzedaży.",+ "inactive_marker": "Nieaktywny",+ "status_live": "Aktywny",+ "status_scheduled": "Zaplanowany",+ "status_hidden": "Ukryty",+ "status_not_available": "Niedostępny",+ "caption_live": "Widoczny dla klientów teraz",+ "caption_scheduled": "Pojawi się {{date}}",+ "caption_hidden_after": "Zniknie {{date}}",+ "caption_unpublished": "Został ukryty {{date}}",+ "caption_window": "Aktywny {{start}} → {{end}}",+ "caption_not_available": "Ukryty — produkt ma status {{product_status}}"+ },+ "clone_succeeded": "Produkt zduplikowany",+ "clone_failed": "Nie udało się zduplikować produktu",+ "delete_succeeded": "Produkt usunięty",+ "delete_failed": "Nie udało się usunąć produktu",+ "bulk": {+ "set_status_action": "Ustaw status…",+ "add_categories_action": "Dodaj do kategorii…",+ "remove_categories_action": "Usuń z kategorii…",+ "add_channels_action": "Dodaj do kanałów sprzedaży…",+ "remove_channels_action": "Usuń z kanałów sprzedaży…",+ "add_tags_action": "Dodaj tagi…",+ "remove_tags_action": "Usuń tagi…",+ "status_sheet_title": "Ustaw status produktu",+ "status_sheet_description": "Wybierz status do zastosowania do wybranych produktów.",+ "categories_add_title": "Dodaj do kategorii",+ "categories_add_description": "Wybierz kategorie, do których chcesz dodać te produkty.",+ "categories_remove_title": "Usuń z kategorii",+ "categories_remove_description": "Wybierz kategorie, z których chcesz usunąć te produkty.",+ "channels_add_title": "Dodaj do kanałów sprzedaży",+ "channels_add_description": "Wybierz kanały sprzedaży, na których chcesz wystawić te produkty.",+ "channels_remove_title": "Usuń z kanałów sprzedaży",+ "channels_remove_description": "Wybierz kanały sprzedaży, z których chcesz wycofać te produkty.",+ "tags_add_title": "Dodaj tagi",+ "tags_add_description": "Wybierz lub utwórz tagi, które chcesz dodać do tych produktów.",+ "tags_remove_title": "Usuń tagi",+ "tags_remove_description": "Wybierz tagi, które chcesz usunąć z tych produktów.",+ "delete_confirm": {+ "title": "Usunąć {n} produktów?",+ "message": "Wybrane produkty zostaną usunięte. Tej operacji nie można cofnąć."+ },+ "status_updated": "Zaktualizowano status {n} produktów",+ "status_update_failed": "Nie udało się zaktualizować statusu produktu",+ "categories_added": "Dodano {n} produktów do kategorii",+ "categories_add_failed": "Nie udało się dodać produktów do kategorii",+ "categories_removed": "Usunięto {n} produktów z kategorii",+ "categories_remove_failed": "Nie udało się usunąć produktów z kategorii",+ "channels_added": "Wystawiono {n} produktów na kanałach sprzedaży",+ "channels_add_failed": "Nie udało się wystawić produktów na kanałach sprzedaży",+ "channels_removed": "Wycofano {n} produktów z kanałów sprzedaży",+ "channels_remove_failed": "Nie udało się wycofać produktów z kanałów sprzedaży",+ "tags_added": "Dodano tagi do {n} produktów",+ "tags_add_failed": "Nie udało się dodać tagów",+ "tags_removed": "Usunięto tagi z {n} produktów",+ "tags_remove_failed": "Nie udało się usunąć tagów",+ "deleted": "Usunięto {n} produktów",+ "delete_failed": "Nie udało się usunąć produktów"+ },+ "media_empty": "Brak multimediów.",+ "media_upload": "Prześlij multimedia",+ "variants_empty": "Brak wariantów.",+ "status_options": {+ "draft": "Wersja robocza",+ "archived": "Zarchiwizowany"+ },+ "inventory": {+ "out_of_stock": "Brak w magazynie",+ "on_backorder": "Na zamówienie",+ "in_stock": "{{count}} w magazynie"+ },+ "variants_one": "{{count}} wariant",+ "variants_other": "{{count}} wariantów",+ "transfers": {+ "sheet_title": "Nowy transfer magazynowy",+ "edit_sheet_title": "Transfer {{number}}",+ "description_internal": "Stan magazynowy przeniesiony z <strong>{{source}}</strong> do <strong>{{destination}}</strong>.",+ "description_external": "Przyjęcie zewnętrzne do <strong>{{destination}}</strong>.",+ "section_from": "Z",+ "section_to": "Do",+ "section_items": "Pozycje",+ "items_empty": "Brak pozycji."+ },+ "options": {+ "sheet_title_create": "Utwórz typ opcji",+ "sheet_title_edit": "Edytuj typ opcji",+ "values_section": "Wartości",+ "values_empty": "Brak wartości.",+ "add_value": "Dodaj wartość opcji",+ "table": {+ "values": "Wartości"+ }+ },+ "price_lists": {+ "title": "Cenniki",+ "subtitle": "Ceny ukierunkowane na grupy klientów, regiony lub progi ilościowe.",+ "add_cta": "Nowy cennik",+ "sheet_title_create": "Utwórz cennik",+ "sheet_title_edit": "Edytuj cennik",+ "delete_confirm": {+ "title": "Usunąć cennik?",+ "message": "Usunięcie „{{name}}” spowoduje usunięcie jego cen. Tej operacji nie można cofnąć."+ },+ "activate": "Aktywuj",+ "deactivate": "Dezaktywuj",+ "schedule": "Zaplanuj",+ "unschedule": "Anuluj harmonogram",+ "edit_prices_cta": "Edytuj ceny",+ "add_products_cta": "Dodaj produkty",+ "remove_selected": "Usuń zaznaczone",+ "basics_section": "Podstawy",+ "schedule_section": "Harmonogram",+ "products_section": "Produkty",+ "rules_section": "Reguły",+ "add_rule": "Dodaj regułę",+ "rule_click_to_configure": "Kliknij, aby skonfigurować",+ "rule_no_options": "Ta reguła nie ma konfigurowalnych opcji — jej obecność sama w sobie nakłada ograniczenie.",+ "rule_name_overflow": "{{names}} +{{count}} więcej",+ "remove_rule_confirm": {+ "title": "Usunąć regułę?",+ "message": "Reguła zostanie usunięta po zapisaniu cennika."+ },+ "rules_help": "Warunki decydujące o tym, kiedy ten cennik ma zastosowanie. Użyj „wszystkie”, aby wymagać każdej reguły, lub „dowolna”, aby zastosować pierwsze dopasowanie.",+ "rules_empty": "Brak reguł — ten cennik dotyczy każdego kupującego.",+ "add_rule_help": "Wybierz typ reguły do skonfigurowania.",+ "rule_types_empty": "Brak zarejestrowanych typów reguł.",+ "rule_types_all_used": "Każdy dostępny typ reguły jest już na tym cenniku.",+ "rule_default_description": "Dostosuj parametry reguły.",+ "products_help": "Wybierz produkty, których dotyczy ten cennik. Ceny zastępcze zostaną utworzone podczas zapisywania — uzupełnij je poniżej.",+ "products_search_placeholder": "Szukaj produktów po nazwie…",+ "products_empty_search": "Brak pasujących produktów",+ "products_selected_one": "Wybrano {{count}} produkt.",+ "products_selected_other": "Wybrano {{count}} produktów.",+ "prices_help_one": "Skonfigurowano {{count}} cenę. Otwórz edytor zbiorczy, aby ją zaktualizować.",+ "prices_help_other": "Skonfigurowano {{count}} cen. Otwórz edytor zbiorczy, aby je zaktualizować.",+ "prices_help_zero": "Wybierz produkty powyżej, aby utworzyć ceny zastępcze, a następnie otwórz edytor zbiorczy.",+ "activate_confirm": {+ "title": "Aktywować cennik?",+ "message": "„{{name}}” zacznie obowiązywać kwalifikujących się klientów natychmiast i pozostanie aktywny do ręcznej dezaktywacji.",+ "message_with_end": "„{{name}}” zacznie obowiązywać kwalifikujących się klientów natychmiast i pozostanie aktywny do ręcznej dezaktywacji lub do swojej daty zakończenia ({{ends_at}})."+ },+ "schedule_confirm": {+ "title": "Zaplanować cennik?",+ "message": "„{{name}}” zostanie uruchomiony {{starts_at}} i pozostanie aktywny do swojej daty zakończenia."+ },+ "deactivate_confirm": {+ "title": "Dezaktywować cennik?",+ "message": "„{{name}}” natychmiast przestanie obowiązywać klientów. Istniejące zamówienia pozostają bez zmian."+ },+ "unschedule_confirm": {+ "title": "Anulować harmonogram cennika?",+ "message": "„{{name}}” nie będzie już aktywowany w zaplanowanej dacie. Możesz go później ponownie zaplanować lub aktywować ręcznie."+ },+ "edit_prices": {+ "title": "Edytuj ceny — {{name}}",+ "currency_label": "Waluta",+ "empty": "Brak produktów na tym cenniku.",+ "add_products_link": "Dodaj produkty",+ "columns": {+ "product": "Produkt",+ "variant": "Wariant",+ "sku": "SKU",+ "price": "Cena",+ "compare_at_price": "Cena porównawcza"+ },+ "variant_default": "Domyślny",+ "grid_aria": "Ceny wariantów",+ "search_placeholder": "Szukaj po produkcie, SKU lub opcji…",+ "price_aria": "Cena dla {{label}}",+ "compare_at_aria": "Cena porównawcza dla {{label}}",+ "save_cta": "Zapisz ceny",+ "save_success_one": "Zapisano {{count}} cenę",+ "save_success_other": "Zapisano {{count}} cen",+ "save_failed": "Nie udało się zapisać cen",+ "count_summary_one": "{{count}} cena w {{currency}}",+ "count_summary_other": "{{count}} cen w {{currency}}",+ "no_matches_for_filters": "Brak cen pasujących do bieżących filtrów.",+ "no_matches_for_search": "Brak cen pasujących do „{{search}}”.",+ "empty_pick_products": "Wybierz produkty na cenniku, aby rozpocząć ustawianie cen.",+ "empty_no_base_prices": "Brak cen podstawowych.",+ "dirty_summary_one": "{{count}} niezapisana zmiana",+ "dirty_summary_other": "{{count}} niezapisanych zmian",+ "discard_confirm": {+ "title": "Odrzucić niezapisane ceny?",+ "message_close_one": "Masz {{count}} niezapisaną cenę. Zamknięcie spowoduje jej odrzucenie.",+ "message_close_other": "Masz {{count}} niezapisanych cen. Zamknięcie spowoduje ich odrzucenie.",+ "message_currency": "Zmiana waluty spowoduje odrzucenie niezapisanych cen.",+ "message_close_few": "Masz {{count}} niezapisane ceny. Zamknięcie spowoduje ich odrzucenie.",+ "message_close_many": "Masz {{count}} niezapisanych cen. Zamknięcie spowoduje ich odrzucenie."+ },+ "count_summary_few": "{{count}} ceny w {{currency}}",+ "count_summary_many": "{{count}} cen w {{currency}}",+ "dirty_summary_few": "{{count}} niezapisane zmiany",+ "dirty_summary_many": "{{count}} niezapisanych zmian",+ "save_success_few": "Zapisano {{count}} ceny",+ "save_success_many": "Zapisano {{count}} cen"+ },+ "products_empty": "Brak produktów — dodaj jeden, aby rozpocząć edycję cen.",+ "no_changes": "Brak zmian do zapisania.",+ "prices_help_few": "Skonfigurowano {{count}} ceny. Otwórz edytor zbiorczy, aby je zaktualizować.",+ "prices_help_many": "Skonfigurowano {{count}} cen. Otwórz edytor zbiorczy, aby je zaktualizować.",+ "products_selected_few": "Wybrano {{count}} produkty.",+ "products_selected_many": "Wybrano {{count}} produktów."+ },+ "variants_few": "{{count}} warianty",+ "variants_many": "{{count}} wariantów"+ },+ "settings": {+ "store": {+ "title": "Ustawienia sklepu",+ "subtitle": "Ogólna konfiguracja i domyślne ustawienia dla całego sklepu.",+ "tab_general": "Ogólne",+ "tab_standards": "Standardy i formaty"+ },+ "emails": {+ "title": "Ustawienia e-mail",+ "subtitle": "Adresy nadawców, powiadomienia i logo umieszczane w e-mailach transakcyjnych.",+ "section_delivery": "Dostarczanie",+ "section_addresses": "Adresy e-mail",+ "section_logo": "Logo",+ "logo_dimensions_help": "Zalecane: 204×104 piksele.",+ "logo_upload_cta": "Prześlij logo",+ "logo_replace_cta": "Zastąp logo",+ "logo_remove_cta": "Usuń logo",+ "logo_uploading": "Przesyłanie…",+ "logo_upload_failed": "Nie udało się przesłać logo.",+ "load_failed_title": "Nie udało się załadować ustawień e-mail"+ },+ "webhooks": {+ "title": "Webhooki",+ "subtitle": "Subskrybuj punkty końcowe HTTPS dla zdarzeń wyzwalanych przez Twój sklep.",+ "search_placeholder": "Szukaj po URL…",+ "new_cta": "Nowy punkt końcowy",+ "empty_title": "Brak punktów końcowych webhooków",+ "empty_description": "Utwórz punkt końcowy, aby otrzymywać podpisane żądanie POST za każdym razem, gdy wyzwalane jest subskrybowane zdarzenie.",+ "add_sheet_title": "Dodaj punkt końcowy webhooka",+ "edit_sheet_title": "Edytuj punkt końcowy webhooka",+ "deliveries_sheet_title": "Ostatnie dostarczenia",+ "delete_confirm": {+ "title": "Usunąć punkt końcowy webhooka?",+ "message": "{{name}} natychmiast przestanie otrzymywać dostarczenia. Dotychczasowa historia dostarczeń również zostanie usunięta."+ },+ "detail": {+ "load_failed_title": "Nie udało się załadować tego punktu końcowego webhooka",+ "delete_label": "Usuń punkt końcowy",+ "details_title": "Szczegóły",+ "edit_title": "Edytuj punkt końcowy",+ "url": "Docelowy URL",+ "subscriptions": "Zdarzenia"+ },+ "save_secret_title": "Zapisz swój sekret podpisujący",+ "save_secret_description": "Weryfikuj podpisy przychodzących webhooków za pomocą tego klucza. Nie pokażemy go ponownie.",+ "actions": {+ "send_test": "Wyślij test",+ "disable": "Wyłącz",+ "enable": "Włącz ponownie",+ "view_deliveries": "Wyświetl dostarczenia",+ "redeliver": "Dostarcz ponownie"+ },+ "status": {+ "inactive": "Nieaktywny",+ "disabled": "Automatycznie wyłączony",+ "disabled_reason": "Wyłączony: {{reason}}"+ },+ "health": {+ "label": "Kondycja",+ "healthy": "Sprawny ({{percentage}}%)",+ "degraded": "Pogorszony ({{percentage}}%)",+ "failing": "Zawodny ({{percentage}}%)",+ "disabled": "Wyłączony",+ "no_deliveries": "Brak dostarczeń",+ "auto_disabled_alert": "Ten punkt końcowy został automatycznie wyłączony po wielokrotnych niepowodzeniach dostarczenia.",+ "re_enable_cta": "Włącz ponownie",+ "metric_total": "Dostarczenia",+ "metric_successful": "Udane",+ "metric_failed": "Nieudane",+ "row_counters_successful_one": "{{count}} udane",+ "row_counters_successful_other": "{{count}} udanych",+ "row_counters_failed_one": "{{count}} nieudane",+ "row_counters_failed_other": "{{count}} nieudanych",+ "row_counters_failed_few": "{{count}} nieudane",+ "row_counters_failed_many": "{{count}} nieudanych",+ "row_counters_successful_few": "{{count}} udane",+ "row_counters_successful_many": "{{count}} udanych"+ },+ "table": {+ "url": "URL",+ "events": "Zdarzenia",+ "recent_deliveries": "Ostatnie 7 dni",+ "last_delivery": "Ostatnie dostarczenie",+ "copy_url_aria": "Kopiuj URL"+ },+ "events_all": "Wszystkie zdarzenia",+ "events_count_one": "{{count}} zdarzenie",+ "events_count_other": "{{count}} zdarzeń",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "Usuń {{event}}",+ "event_groups": {+ "asset": "Zasób",+ "custom": "Niestandardowe",+ "customer": "Klient",+ "digital": "Cyfrowy",+ "gift_card": "Karta podarunkowa",+ "gift_card_batch": "Partia kart podarunkowych",+ "import_export": "Import / Eksport",+ "invitation": "Zaproszenie",+ "line_item": "Pozycja zamówienia",+ "newsletter_subscriber": "Subskrybent newslettera",+ "order": "Zamówienie",+ "payment": "Płatność",+ "payment_session": "Sesja płatności",+ "payment_setup_session": "Sesja konfiguracji płatności",+ "price": "Cena",+ "product": "Produkt",+ "promotion": "Promocja",+ "refund": "Zwrot środków",+ "report": "Raport",+ "return": "Zwrot",+ "shipment": "Przesyłka",+ "stock_item": "Pozycja magazynowa",+ "stock_movement": "Ruch magazynowy",+ "stock_reservation": "Rezerwacja magazynowa",+ "stock_transfer": "Transfer magazynowy",+ "store_credit": "Kredyt sklepowy",+ "variant": "Wariant",+ "wishlist": "Lista życzeń"+ },+ "deliveries": {+ "table": {+ "event": "Zdarzenie",+ "code": "Odpowiedź",+ "execution_time": "Czas trwania",+ "delivered_at": "Dostarczono"+ },+ "status": {+ "pending": "Oczekujące",+ "success": "Udane",+ "failure": "Nieudane",+ "error": "Błąd"+ },+ "empty": "Brak dostarczeń — wyślij test, aby zweryfikować swój punkt końcowy.",+ "search_placeholder": "Szukaj po nazwie zdarzenia…",+ "test_sent": "Testowy webhook dodany do kolejki.",+ "test_failed": "Nie udało się wysłać testowego webhooka.",+ "redeliver_queued": "Ponowne dostarczenie dodane do kolejki.",+ "detail_sheet_title": "Szczegóły dostarczenia",+ "detail": {+ "event": "Zdarzenie",+ "url": "Docelowy URL",+ "delivered_at": "Dostarczono",+ "response_code": "Kod odpowiedzi",+ "execution_time": "Czas wykonania",+ "error_type": "Typ błędu",+ "request_errors": "Błąd transportu",+ "request_payload": "Ładunek żądania",+ "response_body": "Treść odpowiedzi",+ "response_body_truncated": "Treść odpowiedzi została skrócona do {{limit}} znaków.",+ "copy_payload_aria": "Kopiuj ładunek żądania",+ "copy_response_aria": "Kopiuj treść odpowiedzi"+ }+ },+ "events_count_few": "{{count}} zdarzenia",+ "events_count_many": "{{count}} zdarzeń"+ },+ "api_keys": {+ "title": "Klucze API",+ "subtitle": "Autoryzuj integracje i aplikacje do wywoływania Admin API.",+ "publishable_section": "Klucze publiczne",+ "publishable_help": "Używane przez Twój sklep internetowy. Bezpieczne do udostępnienia w kodzie po stronie klienta.",+ "secret_section": "Klucze tajne",+ "secret_help": "Tylko serwer-serwer. Ogranicz zakres każdego klucza do operacji, których potrzebuje.",+ "new_cta": "Nowy klucz",+ "empty_publishable": "Brak kluczy publicznych.",+ "empty_secret": "Brak kluczy tajnych.",+ "table": {+ "key": "Klucz",+ "scopes": "Zakresy",+ "last_used_at": "Ostatnio użyto"+ },+ "save_secret_title": "Zapisz swój klucz tajny",+ "save_secret_description": "Skopiuj tę wartość teraz — nie pokażemy jej ponownie.",+ "scope_badge": {+ "full_access": "Pełny dostęp",+ "read_all": "Odczyt wszystkiego"+ }+ },+ "payment_methods": {+ "add_sheet_title": "Dodaj metodę płatności",+ "edit_sheet_title": "Edytuj metodę płatności"+ },+ "tax_categories": {+ "add_sheet_title": "Dodaj kategorię podatkową",+ "edit_sheet_title": "Edytuj kategorię podatkową"+ },+ "markets": {+ "add_sheet_title": "Dodaj rynek",+ "edit_sheet_title": "Edytuj rynek"+ },+ "custom_field_definitions": {+ "add_sheet_title": "Dodaj pole niestandardowe",+ "edit_sheet_title": "Edytuj pole niestandardowe"+ },+ "stock_locations": {+ "add_sheet_title": "Dodaj lokalizację magazynową",+ "edit_sheet_title": "Edytuj lokalizację magazynową",+ "search_placeholder": "Szukaj lokalizacji magazynowych…"+ },+ "allowed_origins": {+ "add_sheet_title": "Dodaj dozwolone źródło",+ "edit_sheet_title": "Edytuj dozwolone źródło"+ }+ },+ "promotions": {+ "new_title": "Nowa promocja",+ "create_cta": "Utwórz promocję",+ "loading": "Ładowanie promocji…",+ "gift_cards": {+ "new_sheet_title": "Nowa karta podarunkowa",+ "edit_sheet_title": "Karta podarunkowa",+ "not_found": "Nie znaleziono karty podarunkowej.",+ "new_cta": "Nowa karta podarunkowa",+ "create_label": "Utwórz kartę podarunkową",+ "batch_section": "Partia",+ "create_batch_cta": "Utwórz {{count}} kart podarunkowych",+ "status_options": {+ "redeemed": "Zrealizowana",+ "expired": "Wygasła",+ "void": "Unieważniona"+ },+ "sheet": {+ "create_description": "Wydaj pojedynczą kartę podarunkową lub wygeneruj partię z automatycznie generowanymi kodami.",+ "edit_description": "Zaktualizuj klienta lub datę ważności karty podarunkowej. Kod i kwota są niezmienne po wydaniu."+ },+ "delete_confirm": {+ "title": "Usunąć kartę podarunkową?",+ "message": "Spowoduje to unieważnienie karty podarunkowej i uniemożliwi jej realizację."+ },+ "validation": {+ "amount_positive": "Kwota musi być większa od zera",+ "amount_required": "Kwota jest wymagana",+ "prefix_required": "Prefiks jest wymagany dla partii",+ "currency_required": "Waluta jest wymagana"+ },+ "prefix": {+ "label": "Prefiks",+ "placeholder": "np. WELCOME — kody będą miały postać WELCOME-abc123",+ "auto_placeholder": "Generowany automatycznie, gdy puste"+ },+ "no_customer": "Brak przypisanego klienta",+ "usage": {+ "title": "Wykorzystanie",+ "used": "Wykorzystano",+ "remaining": "Pozostało",+ "issued_by": "Wydane przez"+ }+ }+ },+ "profile": {+ "title": "Profil",+ "subtitle": "Zarządzaj swoimi danymi osobowymi i językiem administratora.",+ "personal_details": "Dane osobowe",+ "load_failed_title": "Nie udało się załadować Twojego profilu"+ }+ },+ "invitation": {+ "missing_token_title": "Brak tokenu zaproszenia",+ "missing_token_message": "Ten link wygląda na niekompletny. Poproś osobę, która Cię zaprosiła, o ponowne przesłanie go.",+ "loading": "Wczytywanie zaproszenia…",+ "not_found_title": "Nie znaleziono zaproszenia",+ "not_found_message": "To zaproszenie wygasło, zostało unieważnione lub już je zaakceptowano. Poproś osobę zapraszającą o wysłanie nowego.",+ "generic_error_title": "Nie udało się wczytać zaproszenia",+ "generic_error_message": "Coś poszło nie tak. Spróbuj ponownie.",+ "join_store": "Dołącz do {{store}}",+ "invited_by": "{{email}} zaprosił(a) Cię",+ "invited_generic": "Zostałeś(-aś) zaproszony(-a)",+ "invited_as_role": " jako {{role}}",+ "sign_in_to_accept": ". Zaloguj się, aby zaakceptować.",+ "create_to_accept": ". Utwórz konto, aby zaakceptować.",+ "could_not_accept": "Nie udało się zaakceptować zaproszenia",+ "accepting": "Akceptowanie…",+ "sign_in_and_accept": "Zaloguj się i zaakceptuj",+ "create_and_accept": "Utwórz konto i zaakceptuj"+ },+ "staff": {+ "actions": {+ "copy_invitation_link": "Kopiuj link z zaproszeniem",+ "invitation_link_copied": "Link z zaproszeniem skopiowany"+ },+ "autocomplete": {+ "placeholder": "Szukaj personelu…",+ "empty": "Brak pasującego personelu"+ },+ "confirm": {+ "remove_title": "Usunąć ze sklepu?",+ "remove_message": "{{name}} utraci dostęp do tego sklepu.",+ "revoke_title": "Cofnąć zaproszenie?",+ "revoke_message": "{{email}} nie będzie już mógł zaakceptować tego zaproszenia."+ },+ "errors": {+ "failed_to_remove": "Nie udało się usunąć personelu",+ "failed_to_resend": "Nie udało się ponownie wysłać zaproszenia",+ "failed_to_revoke": "Nie udało się cofnąć zaproszenia"+ },+ "invite": {+ "email_placeholder": "[email protected]",+ "roles_loading": "Wczytywanie ról…",+ "roles_placeholder": "Wybierz rolę",+ "no_roles": "Brak dostępnych ról."+ },+ "edit": {+ "roles_label": "Role dla tego sklepu"+ },+ "edit_description": "Zaktualizuj dane profilu i przypisane role tego członka personelu.",+ "actions_aria": "Akcje"+ },+ "api_keys": {+ "empty_description": "Utwórz klucz, aby rozpocząć.",+ "create_sheet_title": "Utwórz klucz API",+ "create_sheet_description": "Wybierz typ klucza, a następnie zakresy, których może używać.",+ "edit_sheet_title": "Edytuj klucz API",+ "edit_sheet_description": "Zmień nazwę tego klucza. Zakresy są ustalane przy tworzeniu klucza i nie można ich zmienić.",+ "scopes_immutable_help": "Zakresów nie można zmienić po utworzeniu klucza. Aby je zmienić, utwórz nowy klucz z potrzebnymi zakresami, a ten unieważnij.",+ "key_type": {+ "secret_title": "Klucz tajny",+ "secret_description": "Komunikacja serwer-serwer. Każdy klucz zawiera jawną listę zakresów.",+ "publishable_title": "Klucz publiczny",+ "publishable_description": "Bezpieczny do użycia w kodzie po stronie klienta. Zapewnia dostęp publiczny/gościa."+ },+ "scope_picker": {+ "resource_header": "Zasób",+ "read_header": "Odczyt",+ "write_header": "Zapis",+ "read_aria": "Odczyt: {{resource}}",+ "write_aria": "Zapis: {{resource}}",+ "full_access_label": "Pełny dostęp (write_all)",+ "read_all_label": "Odczyt wszystkiego (read_all)",+ "resources": {+ "orders": "Zamówienia",+ "products": "Produkty",+ "promotions": "Promocje",+ "customers": "Klienci",+ "payments": "Płatności",+ "fulfillments": "Realizacje",+ "refunds": "Zwroty pieniędzy",+ "gift_cards": "Karty podarunkowe",+ "store_credits": "Środki w sklepie",+ "stock": "Stan magazynowy",+ "categories": "Kategorie",+ "settings": "Ustawienia",+ "webhooks": "Webhooki",+ "api_keys": "Klucze API",+ "dashboard": "Panel"+ },+ "full_access_hint": "– odczyt + zapis dla każdego zasobu",+ "read_all_hint": "– odczyt dla każdego zasobu",+ "show_more_aria_one": "Pokaż {{count}} dodatkowy zakres",+ "show_more_aria_other": "Pokaż {{count}} dodatkowych zakresów",+ "show_more_aria_few": "Pokaż {{count}} dodatkowe zakresy",+ "show_more_aria_many": "Pokaż {{count}} dodatkowych zakresów"+ },+ "warning_treat_like_password": "Traktuj ten klucz jak hasło. Przechowuj go w menedżerze sekretów — nie będziemy mogli ponownie go wyświetlić.",+ "revoke_confirm": {+ "title": "Unieważnić klucz?",+ "message": "Każda integracja używająca tego klucza natychmiast przestanie działać."+ },+ "delete_confirm": {+ "title": "Usunąć klucz?",+ "message": "Spowoduje to trwałe usunięcie klucza. Jeśli możesz chcieć przywrócić dostęp później, lepiej unieważnij klucz."+ },+ "dropdown": {+ "revoke": "Unieważnij klucz",+ "copy_token_aria": "Kopiuj token"+ },+ "badge": {+ "revoked": "Unieważniony",+ "never_used": "Nigdy"+ },+ "errors": {+ "failed_to_delete": "Nie udało się usunąć klucza",+ "failed_to_update": "Nie udało się zaktualizować klucza",+ "failed_to_create": "Nie udało się utworzyć klucza"+ },+ "by_email": "przez {{email}}",+ "create_key_cta": "Utwórz klucz",+ "validation": {+ "scope_required": "Wybierz co najmniej jeden zakres"+ }+ },+ "customers": {+ "groups": {+ "bulk_add_action": "Dodaj do grupy…",+ "bulk_remove_action": "Usuń z grupy…",+ "bulk_added": "Dodano {{count}} klientów do grup",+ "bulk_removed": "Usunięto {{count}} klientów z grup",+ "bulk_add_failed": "Nie udało się dodać klientów do grup",+ "bulk_remove_failed": "Nie udało się usunąć klientów z grup",+ "picker": {+ "add_title": "Dodaj do grup",+ "add_description": "Wybierz grupy, do których chcesz dodać tych klientów.",+ "remove_title": "Usuń z grup",+ "remove_description": "Wybierz grupy, z których chcesz usunąć tych klientów."+ },+ "view_members": "Wyświetl członków",+ "count_one": "{{count}} klient",+ "count_other": "{{count}} klientów",+ "create_label": "Utwórz grupę klientów",+ "create_description": "Utwórz grupę klientów, aby segmentować klientów na potrzeby promocji, analityki lub marketingu.",+ "edit_description": "Zaktualizuj nazwę lub opis.",+ "default_name": "Ta grupa",+ "delete_confirm": {+ "title": "Usunąć grupę klientów?",+ "message": "{{name}} zostanie usunięta. Klienci z tej grupy nie zostaną usunięci."+ },+ "table": {+ "title": "Grupy klientów",+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Brak grup klientów"+ },+ "columns": {+ "customers": "Klienci"+ },+ "count_few": "{{count}} klienci",+ "count_many": "{{count}} klientów"+ },+ "tags": {+ "bulk_add_action": "Dodaj tagi…",+ "bulk_remove_action": "Usuń tagi…",+ "bulk_added": "Dodano tagi do {n} klientów",+ "bulk_removed": "Usunięto tagi z {n} klientów",+ "bulk_add_failed": "Nie udało się dodać tagów",+ "bulk_remove_failed": "Nie udało się usunąć tagów",+ "picker": {+ "add_title": "Dodaj tagi",+ "add_description": "Wybierz lub utwórz tagi, które chcesz dodać do tych klientów.",+ "remove_title": "Usuń tagi",+ "remove_description": "Wybierz tagi, które chcesz usunąć z tych klientów."+ }+ },+ "row_actions": {+ "delete_confirm": "Usunąć {{email}}? Klientów ze zrealizowanymi zamówieniami nie można usunąć."+ },+ "detail": {+ "delete_label": "Usuń klienta",+ "edit_profile_description": "Zaktualizuj dane profilu klienta.",+ "subscribed_to_marketing": "Zapisany do newslettera marketingowego",+ "not_subscribed_to_marketing": "Niezapisany do newslettera marketingowego",+ "customer_since": "Klient od",+ "last_order_placed": "Ostatnie złożone zamówienie",+ "orders_table": {+ "order": "Zamówienie",+ "date": "Data"+ },+ "no_internal_notes": "Brak notatek wewnętrznych",+ "address": {+ "default_billing": "Domyślny adres rozliczeniowy",+ "default_shipping": "Domyślny adres dostawy",+ "set_default_billing": "Ustaw jako domyślny adres rozliczeniowy",+ "set_default_shipping": "Ustaw jako domyślny adres dostawy",+ "delete_confirm_message": "Usunąć ten adres?"+ },+ "store_credit": {+ "title": "Kredyt sklepowy",+ "empty": "Nie wydano żadnych kredytów sklepowych",+ "table": {+ "used": "Wykorzystano",+ "remaining": "Pozostało",+ "category": "Kategoria",+ "memo": "Notatka"+ },+ "delete_confirm_message": "Usunąć ten kredyt sklepowy?",+ "edit_description": "Dostosuj kwotę, kategorię lub notatkę. Wykorzystanego salda nie można edytować.",+ "add_description": "Przyznaj kredyt sklepowy na konto tego klienta."+ }+ },+ "new_sheet_description": "Klienci utworzeni w tym miejscu nie mają ustawionego hasła. Przy pierwszym logowaniu otrzymają magiczny link.",+ "table": {+ "search_placeholder": "Szukaj według e-maila lub nazwy…",+ "empty": "Brak klientów"+ },+ "columns": {+ "orders": "Zamówienia",+ "total_spent": "Łączne wydatki",+ "last_order": "Ostatnie zamówienie",+ "groups": "Grupy",+ "newsletter": "Newsletter"+ },+ "autocomplete": {+ "placeholder": "Szukaj klientów…",+ "empty": "Brak pasujących klientów"+ }+ },+ "orders": {+ "new": {+ "use_default_addresses": "Użyj domyślnych adresów rozliczeniowego i wysyłki klienta",+ "add_variant": "Dodaj wariant",+ "items_table": {+ "variant": "Wariant",+ "sku": "SKU",+ "qty": "Ilość"+ },+ "creates_draft_note": "Tworzy zamówienie robocze. Dodaj płatności i sfinalizuj je po utworzeniu."+ },+ "detail": {+ "load_failed_message": "Nie udało się załadować zamówienia {{orderId}}.",+ "confirm": {+ "complete_message": "Sfinalizować teraz to zamówienie robocze?",+ "approve_message": "Zatwierdzić to zamówienie?",+ "resume_message": "Wznowić to anulowane zamówienie?",+ "cancel_message": "Czy na pewno chcesz anulować to zamówienie?",+ "remove_item_message": "Usunąć tę pozycję z zamówienia?",+ "ship_message": "Wysłać tę realizację?",+ "cancel_shipment_message": "Anulować tę realizację?",+ "capture_message": "Pobrać tę płatność?",+ "void_message": "Unieważnić tę płatność?",+ "remove_gift_card_message": "Usunąć tę kartę podarunkową z zamówienia?",+ "remove_store_credit_message": "Usunąć kredyt sklepowy z zamówienia?"+ },+ "dropdown": {+ "complete_order": "Sfinalizuj zamówienie",+ "preview_order": "Podgląd zamówienia",+ "resend_confirmation": "Wyślij ponownie potwierdzenie",+ "edit_quantity": "Edytuj ilość",+ "cancel_shipment": "Anuluj wysyłkę",+ "void_payment": "Unieważnij płatność"+ },+ "messages": {+ "canceled": "Zamówienie anulowane",+ "completed": "Zamówienie sfinalizowane",+ "approved": "Zamówienie zatwierdzone",+ "resumed": "Zamówienie wznowione",+ "shipped": "Realizacja wysłana",+ "captured": "Płatność pobrana",+ "voided": "Płatność unieważniona",+ "confirmation_sent": "Potwierdzenie wysłane"+ },+ "errors": {+ "cancel_failed": "Nie udało się anulować zamówienia",+ "complete_failed": "Nie udało się sfinalizować zamówienia",+ "approve_failed": "Nie udało się zatwierdzić zamówienia",+ "resume_failed": "Nie udało się wznowić zamówienia",+ "confirmation_send_failed": "Nie udało się wysłać potwierdzenia"+ },+ "variant_search": {+ "description": "Wyszukaj wariant produktu, aby dodać go do tego zamówienia.",+ "label": "Wyszukaj wariant",+ "empty": "Nie znaleziono wariantów",+ "sku_prefix": "SKU",+ "placeholder": "Wpisz nazwę produktu lub SKU (min. 3 znaki)…"+ },+ "edit_quantity": {+ "title": "Edytuj ilość",+ "description": "Ustaw ilość dla tej pozycji."+ },+ "items_table": {+ "item": "Pozycja",+ "price": "Cena",+ "qty": "Ilość"+ },+ "tracking": {+ "label": "Numer śledzenia",+ "description": "Zaktualizuj numer śledzenia dla tej przesyłki.",+ "prefix": "Śledzenie",+ "shipped_prefix": "Wysłano",+ "edit_title": "Edytuj śledzenie",+ "add_title": "Dodaj śledzenie"+ },+ "payments_table": {+ "number": "Numer",+ "method": "Metoda",+ "state": "Stan"+ },+ "payment_form": {+ "description": "Obciąż metodę płatności w ramach tego zamówienia.",+ "method_label": "Metoda płatności",+ "method_placeholder": "Wybierz metodę płatności",+ "source_label": "Źródło",+ "amount_help": "Pozostaw puste, aby użyć domyślnie pozostałego salda.",+ "capture_immediately": "Pobierz natychmiast",+ "title": "Dodaj płatność",+ "source_requires_customer": "Ta metoda płatności wymaga zapisanego źródła. Najpierw przypisz klienta do zamówienia.",+ "no_saved_cards": "Klient nie ma zapisanych kart dla tej metody płatności.",+ "source_placeholder": "Wybierz zapisaną kartę…"+ },+ "summary": {+ "canceled_at": "Anulowano",+ "canceler": "Anulujący",+ "approved_by": "Zatwierdzone przez",+ "promotions": "Promocje",+ "adjustments": "Korekty",+ "tax_included": "Podatek (wliczony)",+ "tax_additional": "Podatek (dodatkowy)",+ "payment_total": "Suma płatności",+ "outstanding_balance": "Pozostałe saldo"+ },+ "gift_card_section": {+ "title": "Karta podarunkowa i kredyt sklepowy",+ "gift_card_label": "Karta podarunkowa",+ "store_credit_label": "Kredyt sklepowy",+ "none_applied": "Brak zastosowanych",+ "applied_suffix": "zastosowano",+ "apply_balance": "Zastosuj dostępne saldo klienta",+ "requires_customer": "Wymaga klienta",+ "apply_dialog_title": "Zastosuj kartę podarunkową",+ "apply_dialog_description": "Wprowadź kod karty podarunkowej, aby zastosować ją do tego zamówienia."+ },+ "address_edit": {+ "shipping_title": "Edytuj adres wysyłki",+ "billing_title": "Edytuj adres rozliczeniowy"+ },+ "no_customer": "Brak informacji o kliencie",+ "section_customer_note": "Specjalne instrukcje",+ "section_internal_note": "Notatka wewnętrzna",+ "completed_prefix": "Zrealizowano",+ "add_line_item": {+ "title": "Dodaj pozycję"+ },+ "no_line_items": "Brak pozycji"+ },+ "table": {+ "search_placeholder": "Szukaj zamówień…",+ "empty": "Nie znaleziono zamówień"+ },+ "columns": {+ "number": "Numer",+ "date": "Data",+ "customer": "Klient",+ "payment": "Płatność",+ "fulfillment": "Realizacja",+ "items": "Pozycje",+ "tags": "Tagi",+ "sku": "SKU"+ },+ "item_count_one": "{{count}} pozycja",+ "item_count_other": "{{count}} pozycji",+ "statuses": {+ "draft": "Szkic",+ "placed": "Złożone",+ "canceled": "Anulowane"+ },+ "payment_statuses": {+ "balance_due": "Należność",+ "credit_owed": "Nadpłata",+ "failed": "Nieudana",+ "paid": "Opłacone",+ "void": "Unieważnione"+ },+ "fulfillment_statuses": {+ "backorder": "Zamówienie oczekujące",+ "canceled": "Anulowane",+ "partial": "Częściowa",+ "pending": "Oczekująca",+ "ready": "Gotowe",+ "fulfilled": "Zrealizowane"+ },+ "item_count_few": "{{count}} pozycje",+ "item_count_many": "{{count}} pozycji"+ },+ "products": {+ "save_label": "Zapisz produkt",+ "delete_label": "Usuń produkt",+ "delete_confirm": "Czy na pewno chcesz usunąć ten produkt?",+ "category_search_placeholder": "Szukaj kategorii…",+ "no_categories_found": "Nie znaleziono kategorii",+ "media": {+ "delete_confirm": "Usunąć ten plik multimedialny? Tej operacji nie można cofnąć.",+ "drop_hint": "Przeciągnij i upuść pliki tutaj lub kliknij, aby przeglądać",+ "file_types_hint": "PNG, JPG, WebP do 10 MB",+ "edit_title": "Edytuj plik multimedialny",+ "assigned_variants_label": "Przypisane warianty",+ "assigned_variants_help": "Wybierz warianty, które reprezentuje to zdjęcie. Pozostaw puste, aby zastosować do wszystkich wariantów.",+ "upload_failed": "Nie udało się przesłać {{name}}: {{message}}",+ "upload_status_failed": "Niepowodzenie"+ },+ "seo": {+ "slug_placeholder": "adres-url-produktu",+ "meta_title_placeholder": "Tytuł SEO",+ "meta_description_placeholder": "Opis SEO"+ },+ "tax_category_placeholder": "Wybierz kategorię podatkową",+ "transfers": {+ "new_cta": "Nowy transfer",+ "create_description": "Przenoś zapasy między lokalizacjami lub przyjmuj nowe zapasy od zewnętrznego dostawcy.",+ "external_label": "Zewnętrzny (przyjęcie od dostawcy)",+ "destination_placeholder": "Wybierz lokalizację docelową",+ "different_locations_error": "Lokalizacja źródłowa i docelowa muszą się różnić.",+ "reference_label": "Numer referencyjny",+ "reference_placeholder": "Numer zamówienia, faktura dostawcy, …",+ "search_items_placeholder": "Szukaj według nazwy lub SKU (min. 3 znaki)…",+ "items_table": {+ "variant": "Wariant",+ "sku": "SKU",+ "qty": "Ilość"+ },+ "delete_confirm": {+ "title": "Usunąć ten transfer?",+ "message": "Ruchy magazynowe utworzone przez ten transfer zostaną cofnięte."+ },+ "review_description": "Sprawdź transfer przed utworzeniem. Pozycji nie można później zmienić.",+ "details_card": "Szczegóły",+ "fields": {+ "type": "Typ",+ "internal": "Wewnętrzny",+ "external_receive": "Przyjęcie zewnętrzne",+ "reference": "Numer referencyjny",+ "created": "Utworzono",+ "immutable_note": "Transfery magazynowe są niezmienne po utworzeniu."+ }+ },+ "options": {+ "kinds": {+ "dropdown": "Lista rozwijana",+ "color_swatch": "Próbka koloru",+ "buttons": "Przyciski"+ },+ "add_cta": "Dodaj typ opcji",+ "create_label": "Utwórz typ opcji",+ "create_description": "Zdefiniuj opcję, której mogą używać warianty (np. rozmiar, kolor).",+ "edit_description": "Edytuj typ opcji i jego wartości.",+ "delete_confirm": {+ "title": "Usunąć typ opcji?",+ "message": "Spowoduje to również usunięcie wszystkich jego wartości. Warianty korzystające z tych wartości je utracą."+ },+ "values_help": "Przeciągnij wartości, aby zmienić kolejność. Pierwsza wartość jest domyślna dla nowych wariantów.",+ "count_one": "{{count}} wartość",+ "count_few": "{{count}} wartości",+ "count_many": "{{count}} wartości",+ "count_other": "{{count}} wartości",+ "value_name_placeholder": "np. small",+ "value_label_placeholder": "np. Małe",+ "image_upload_failed": "Nie udało się przesłać obrazu"+ },+ "variants": {+ "title": "Warianty",+ "default_variant": "Wariant domyślny",+ "variant_label": "Wariant",+ "add_option": "Dodaj opcję",+ "create_option_type": "Utwórz nowy typ opcji",+ "create_option_type_title": "Nowy typ opcji",+ "create_value": "Nowa wartość",+ "create_value_title": "Nowa wartość opcji",+ "option_type_label": "Typ opcji",+ "option_type_placeholder": "Wybierz typ opcji",+ "edit_variant": "Edytuj wariant — {{name}}",+ "edit_row_aria": "Edytuj {{name}}",+ "remove_row_aria": "Usuń {{name}}",+ "orphan_warning_one": "{{count}} istniejący wariant nie pasuje już do wybranych opcji i zostanie usunięty przy zapisie:",+ "orphan_warning_few": "{{count}} istniejące warianty nie pasują już do wybranych opcji i zostaną usunięte przy zapisie:",+ "orphan_warning_many": "{{count}} istniejących wariantów nie pasuje już do wybranych opcji i zostanie usuniętych przy zapisie:",+ "orphan_warning_other": "{{count}} istniejących wariantów nie pasuje już do wybranych opcji i zostanie usuniętych przy zapisie:",+ "orphan_warning": "{{count}} istniejący(ch) wariant(ów) zostanie usuniętych przy zapisie:",+ "keep": "Zachowaj wszystkie",+ "sheet": {+ "identity": "Tożsamość",+ "tax_category_placeholder": "Dziedzicz z produktu"+ }+ },+ "inventory": {+ "columns": {+ "location": "Lokalizacja",+ "on_hand": "Na stanie",+ "backorder": "Zamówienie oczekujące"+ },+ "on_hand_aria": "Na stanie w lokalizacji {{location}}",+ "backorder_aria": "Zezwól na zamówienia oczekujące w lokalizacji {{location}}",+ "empty_no_locations": "Dodaj lokalizację magazynową w Ustawieniach, aby rozpocząć śledzenie stanów magazynowych.",+ "empty_no_variants": "Stany magazynowe są zarządzane osobno dla każdej lokalizacji magazynowej. Dodaj wariant, aby rozpocząć śledzenie stanów magazynowych."+ },+ "custom_fields": {+ "empty_title": "Brak pól niestandardowych",+ "empty_description": "Zdefiniuj pola niestandardowe w Ustawieniach, aby rozpocząć śledzenie ustrukturyzowanych szczegółów produktów.",+ "empty_cta": "Skonfiguruj pola niestandardowe"+ },+ "columns": {+ "sku": "SKU",+ "price": "Cena",+ "in_stock": "Na stanie"+ },+ "price_lists": {+ "messages": {+ "created": "Utworzono cennik",+ "updated": "Zaktualizowano cennik",+ "deleted": "Usunięto cennik",+ "activated": "Aktywowano cennik",+ "deactivated": "Dezaktywowano cennik"+ },+ "errors": {+ "failed_to_activate": "Nie udało się aktywować cennika",+ "failed_to_deactivate": "Nie udało się dezaktywować cennika"+ }+ }+ },+ "payment_methods": {+ "add_cta": "Dodaj metodę płatności",+ "create_description": "Wybierz dostawcę i skonfiguruj jego dane uwierzytelniające.",+ "edit_description": "Zaktualizuj nazwę, widoczność lub status.",+ "create_label": "Utwórz metodę płatności",+ "provider_description": "Dostawca: {{provider}}",+ "delete_confirm": {+ "title": "Usunąć metodę płatności?",+ "message": "{{name}} nie będzie już dostępna przy realizacji zamówienia."+ },+ "title": "Metody płatności",+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Nie skonfigurowano metod płatności",+ "columns": {+ "storefront": "Sklep"+ },+ "storefront": {+ "visible": "Widoczna",+ "admin_only": "Tylko panel administracyjny"+ },+ "status": {+ "disabled": "Wyłączona"+ },+ "messages": {+ "created": "Utworzono metodę płatności",+ "updated": "Zaktualizowano metodę płatności",+ "deleted": "Usunięto metodę płatności"+ }+ },+ "tax_categories": {+ "add_cta": "Dodaj kategorię podatkową",+ "create_description": "Grupuj produkty według sposobu opodatkowania (standardowa, obniżona, zwolniona, …).",+ "edit_description": "Zaktualizuj nazwę, kod lub oznaczenie domyślne.",+ "create_label": "Utwórz kategorię podatkową",+ "delete_confirm": {+ "title": "Usunąć kategorię podatkową?",+ "message": "{{name}} zostanie usunięta. Produkty w tej kategorii zostaną przypisane do domyślnej."+ },+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Brak kategorii podatkowych",+ "messages": {+ "created": "Kategoria podatkowa utworzona",+ "updated": "Kategoria podatkowa zaktualizowana",+ "deleted": "Kategoria podatkowa usunięta"+ }+ },+ "markets": {+ "add_cta": "Dodaj rynek",+ "create_description": "Pogrupuj kraje w jeden region cenowy z własną walutą i ustawieniami regionalnymi.",+ "edit_description": "Zaktualizuj nazwę, walutę, ustawienia regionalne lub zasięg krajów.",+ "create_label": "Utwórz rynek",+ "delete_confirm": {+ "title": "Usunąć rynek?",+ "message": "{{name}} zostanie usunięty. Zamówienia złożone wcześniej na tym rynku pozostaną nienaruszone."+ },+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Brak rynków",+ "tax_inclusive": "Z podatkiem",+ "tax_exclusive": "Bez podatku",+ "columns": {+ "default": "Domyślny"+ },+ "messages": {+ "created": "Rynek utworzony",+ "updated": "Rynek zaktualizowany",+ "deleted": "Rynek usunięty"+ },+ "errors": {+ "failed_to_create": "Nie udało się utworzyć rynku",+ "failed_to_update": "Nie udało się zaktualizować rynku",+ "failed_to_delete": "Nie udało się usunąć rynku"+ }+ },+ "custom_field_definitions": {+ "add_cta": "Dodaj pole niestandardowe",+ "create_label": "Utwórz pole niestandardowe",+ "create_description": "Zdefiniuj typowane pole, które Twój zespół może wypełnić w dowolnym pasującym rekordzie.",+ "edit_description": "Zaktualizuj etykietę, klucz lub widoczność w sklepie. Właściciela nie można zmienić po zapisaniu wartości.",+ "table_title": "Definicje pól niestandardowych",+ "search_placeholder": "Szukaj według etykiety, przestrzeni nazw lub klucza…",+ "empty": "Brak definicji pól niestandardowych",+ "storefront_visible": {+ "visible": "Widoczne",+ "admin_only": "Tylko administrator"+ },+ "delete_confirm": {+ "title": "Usunąć pole niestandardowe?",+ "message": "{{label}} zostanie usunięte wraz z każdą zapisaną dla niego wartością."+ }+ },+ "allowed_origins": {+ "add_cta": "Dodaj dozwolone źródło",+ "create_label": "Dodaj źródło",+ "create_description": "Przeglądarki wczytane z tego źródła mogą wywoływać API administratora. Lista dozwolonych źródeł CORS oraz sesja cookie administratora opierają się na tej liście — utrzymuj ją zwięzłą.",+ "edit_description": "Aktualizacja źródła natychmiast zmienia, kto może wywoływać API administratora z przeglądarki.",+ "table_title": "Dozwolone źródła",+ "search_placeholder": "Szukaj według źródła…",+ "empty": "Brak dozwolonych źródeł",+ "validation": {+ "bare_origin": "Musi być samym źródłem (np. https://shop.example.com) — bez ścieżki, parametrów zapytania ani fragmentu"+ },+ "delete_confirm": {+ "title": "Usunąć dozwolone źródło?",+ "message": "{{origin}} nie będzie już mogło wywoływać API administratora z przeglądarki. Istniejące żądania serwer–serwer nie zostaną naruszone."+ },+ "messages": {+ "added": "Dodano dozwolone źródło",+ "updated": "Zaktualizowano dozwolone źródło",+ "removed": "Usunięto dozwolone źródło"+ }+ },+ "stock_locations": {+ "add_cta": "Dodaj lokalizację magazynową",+ "create_label": "Utwórz lokalizację magazynową",+ "create_description": "Dodaj magazyn, sklep lub punkt odbioru, z którego będą realizowane zamówienia.",+ "edit_description": "Zaktualizuj nazwę, adres, odbiór lub zasady dotyczące zapasów.",+ "kinds": {+ "warehouse": "Magazyn",+ "store": "Sklep",+ "fulfillment_center": "Centrum realizacji zamówień"+ },+ "pickup_stock_policies": {+ "local": "Tylko produkty w tej lokalizacji",+ "any": "Zezwól na transfery z innych lokalizacji"+ },+ "delete_confirm": {+ "title": "Usunąć lokalizację magazynową?",+ "message": "{{name}} zostanie usunięta. Produkty na stanie w tej lokalizacji nie zostaną usunięte."+ },+ "section_pickup": "Odbiór",+ "stock_items": {+ "title": "Zapasy w tej lokalizacji",+ "help": "Dostosuj liczbę dostępnych i możliwych do zamówienia z opóźnieniem dla każdego wariantu.",+ "search_placeholder": "Szukaj SKU lub produktu…",+ "table": {+ "variant": "Wariant",+ "on_hand": "Na stanie",+ "backorder": "Zamówienie oczekujące"+ },+ "empty": "Brak zapasów w tej lokalizacji.",+ "empty_search": "Żadne zapasy nie pasują do wyszukiwania."+ },+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Brak lokalizacji magazynowych",+ "columns": {+ "type": "Typ",+ "location": "Lokalizacja",+ "pickup": "Odbiór",+ "default": "Domyślna"+ },+ "badges": {+ "enabled": "Włączone",+ "inactive": "Nieaktywna",+ "default": "Domyślna"+ }+ },+ "store": {+ "load_failed_title": "Nie udało się załadować ustawień sklepu",+ "unit_systems": {+ "metric": "Metryczny",+ "imperial": "Imperialny"+ },+ "weight_units": {+ "kg": "Kilogram (kg)",+ "g": "Gram (g)",+ "lb": "Funt (lb)",+ "oz": "Uncja (oz)"+ }+ },+ "option_types": {+ "kinds": {+ "dropdown": "Lista rozwijana",+ "color_swatch": "Próbka koloru",+ "buttons": "Przyciski"+ },+ "columns": {+ "values": "Wartości"+ },+ "value_count_one": "{{count}} wartość",+ "value_count_other": "{{count}} wartości",+ "table": {+ "search_placeholder": "Szukaj według nazwy…",+ "empty": "Brak typów opcji"+ },+ "value_count_few": "{{count}} wartości",+ "value_count_many": "{{count}} wartości",+ "messages": {+ "created": "Typ opcji utworzony",+ "updated": "Typ opcji zaktualizowany",+ "deleted": "Typ opcji usunięty"+ }+ },+ "stock_transfers": {+ "title": "Transfery magazynowe",+ "table": {+ "search_placeholder": "Szukaj według numeru lub referencji…",+ "empty": "Brak transferów magazynowych"+ },+ "columns": {+ "number": "Numer",+ "direction": "Kierunek",+ "reference": "Referencja"+ },+ "direction": {+ "internal": "Transfer między lokalizacjami",+ "external_receive": "Przyjęcie zewnętrzne"+ },+ "messages": {+ "recorded": "Zarejestrowano przesunięcie magazynowe",+ "deleted": "Usunięto przesunięcie magazynowe"+ },+ "errors": {+ "failed_to_record": "Nie udało się zarejestrować przesunięcia magazynowego",+ "failed_to_delete": "Nie udało się usunąć przesunięcia magazynowego"+ }+ },+ "calculators": {+ "flat_percent_item_total": "Stały procent",+ "flat_rate": "Stawka ryczałtowa",+ "flexi_rate": "Stawka elastyczna",+ "per_item": "Za sztukę",+ "percent_on_line_item": "Procent za pozycję",+ "price_sack": "Próg cenowy",+ "tiered_flat_rate": "Progowa stawka ryczałtowa",+ "tiered_percent": "Procent progowy",+ "default_tax": "Domyślny podatek",+ "digital_delivery": "Dostawa cyfrowa",+ "default_refund_amount": "Domyślna kwota zwrotu"+ },+ "preferences": {+ "amount": "Kwota",+ "flat_percent": "Stały procent",+ "percent": "Procent",+ "first_item": "Koszt pierwszej pozycji",+ "additional_item": "Koszt każdej kolejnej pozycji",+ "max_items": "Maksymalna liczba pozycji",+ "minimal_amount": "Kwota minimalna",+ "normal_amount": "Kwota normalna",+ "discount_amount": "Kwota rabatu",+ "currency": "Waluta",+ "base_amount": "Kwota podstawowa",+ "base_percent": "Procent podstawowy",+ "preferred_amount": "Kwota",+ "preferred_percent": "Procent"+ },+ "channels": {+ "messages": {+ "created": "Kanał utworzony",+ "updated": "Kanał zaktualizowany",+ "deleted": "Kanał usunięty"+ }+ },+ "customer_groups": {+ "messages": {+ "created": "Utworzono grupę klientów",+ "create_failed": "Nie udało się utworzyć grupy klientów",+ "updated": "Zaktualizowano grupę klientów",+ "update_failed": "Nie udało się zaktualizować grupy klientów",+ "deleted": "Usunięto grupę klientów",+ "delete_failed": "Nie udało się usunąć grupy klientów"+ },+ "autocomplete": {+ "placeholder": "Szukaj grup klientów…",+ "empty": "Brak pasujących grup klientów"+ }+ },+ "settings": {+ "webhooks": {+ "messages": {+ "updated": "Zaktualizowano punkt końcowy webhooka",+ "removed": "Usunięto punkt końcowy webhooka"+ },+ "errors": {+ "send_test_failed": "Nie udało się wysłać testowego webhooka",+ "redeliver_failed": "Ponowne dostarczenie nie powiodło się"+ }+ }+ },+ "stock_items": {+ "messages": {+ "stock_updated": "Zaktualizowano stan magazynowy",+ "stock_item_deleted": "Usunięto pozycję magazynową"+ }+ }+ }+}diff --git a/packages/dashboard/src/locales/zh-CN.json b/packages/dashboard/src/locales/zh-CN.jsonnew file mode 100644index 0000000000..717365de44--- /dev/null+++ b/packages/dashboard/src/locales/zh-CN.json@@ -0,0 +1,2366 @@+{+ "admin": {+ "a11y": {+ "edit_media": "编辑图片",+ "delete_image": "删除图片"+ },+ "gift_cards": {+ "statuses": {+ "partially_redeemed": "部分已兑换",+ "redeemed": "已兑换",+ "canceled": "已取消",+ "expired": "已过期"+ },+ "columns": {+ "used": "已使用",+ "remaining": "剩余",+ "batch": "批次",+ "customer": "客户",+ "issued_by": "发放人"+ },+ "table": {+ "search_placeholder": "按代码搜索…",+ "empty": "暂无礼品卡"+ },+ "messages": {+ "created": "礼品卡已创建",+ "create_failed": "创建礼品卡失败",+ "updated": "礼品卡已更新",+ "update_failed": "更新礼品卡失败",+ "deleted": "礼品卡已删除",+ "delete_failed": "删除礼品卡失败",+ "batch_created": "礼品卡批次已创建",+ "batch_create_failed": "创建礼品卡批次失败"+ },+ "batch_autocomplete": {+ "placeholder": "按前缀搜索批次…",+ "empty": "无匹配的批次"+ }+ },+ "option_types": {+ "kinds": {+ "dropdown": "下拉菜单",+ "color_swatch": "颜色样本",+ "buttons": "按钮"+ },+ "columns": {+ "values": "值"+ },+ "value_count_one": "{{count}} 个值",+ "value_count_other": "{{count}} 个值",+ "table": {+ "search_placeholder": "按名称搜索…",+ "empty": "暂无选项类型"+ },+ "messages": {+ "created": "选项类型已创建",+ "updated": "选项类型已更新",+ "deleted": "选项类型已删除"+ }+ },+ "markets": {+ "add_cta": "添加市场",+ "create_description": "将多个国家/地区归入一个定价区域,使用其专属货币和区域设置。",+ "edit_description": "更新名称、货币、区域设置或国家/地区覆盖范围。",+ "create_label": "创建市场",+ "delete_confirm": {+ "title": "删除市场?",+ "message": "{{name}} 将被移除。此前在该市场中下达的订单将保持不变。"+ },+ "search_placeholder": "按名称搜索…",+ "empty": "暂无市场",+ "tax_inclusive": "含税",+ "tax_exclusive": "不含税",+ "columns": {+ "default": "默认"+ },+ "messages": {+ "created": "市场已创建",+ "updated": "市场已更新",+ "deleted": "市场已删除"+ },+ "errors": {+ "failed_to_create": "创建市场失败",+ "failed_to_update": "更新市场失败",+ "failed_to_delete": "删除市场失败"+ }+ },+ "branding": {+ "app_name": "Spree 管理后台",+ "powered_by": "由 Spree Commerce 提供支持"+ },+ "nav": {+ "home": "首页",+ "account": "账户",+ "orders": "订单",+ "draft_orders": "草稿订单",+ "products": "商品",+ "price_lists": "价格表",+ "categories": "分类",+ "options": "选项",+ "transfers": "调拨",+ "customers": "客户",+ "customer_groups": "分组",+ "promotions": "促销",+ "gift_cards": "礼品卡",+ "reports": "报表",+ "settings": "设置"+ },+ "settings_nav": {+ "groups": {+ "store": "店铺",+ "payments": "支付与税务",+ "fulfillment": "履约",+ "team": "团队与权限"+ },+ "items": {+ "store": "店铺",+ "emails": "邮件",+ "channels": "销售渠道",+ "payment_methods": "支付方式",+ "tax_categories": "税收类别",+ "markets": "市场",+ "stock_locations": "库存地点",+ "custom_field_definitions": "自定义字段",+ "staff": "员工",+ "api_keys": "API 密钥",+ "webhooks": "Webhooks",+ "allowed_origins": "允许的来源",+ "profile": "个人资料"+ }+ },+ "fields": {+ "products_count": {+ "label": "商品"+ },+ "prices_count": {+ "label": "价格"+ },+ "customer_id": {+ "label": "客户"+ },+ "role_id": {+ "label": "角色"+ },+ "role_ids": {+ "label": "角色"+ },+ "tax_category_id": {+ "label": "税务类别"+ },+ "promotion": {+ "name": {+ "placeholder": "夏季促销"+ },+ "description": {+ "placeholder": "内部说明(可选)"+ },+ "kind": {+ "label": "此优惠如何应用?"+ },+ "code": {+ "placeholder": "SUMMER2026"+ },+ "multi_codes": {+ "label": "批量生成唯一优惠码",+ "help": "适用于一次性使用的优惠码——每位客户兑换不同的优惠码。"+ },+ "number_of_codes": {+ "label": "优惠码数量",+ "placeholder": "100"+ },+ "code_prefix": {+ "label": "优惠码前缀(可选)",+ "placeholder": "VIP",+ "help": "每个生成的优惠码都将以此前缀开头。"+ },+ "starts_at": {+ "placeholder": "无开始日期"+ },+ "expires_at": {+ "placeholder": "无过期时间"+ },+ "usage_limit": {+ "label": "使用次数限制",+ "placeholder": "不限"+ },+ "match_policy": {+ "label": "匹配策略"+ }+ },+ "custom_field_definition": {+ "label": {+ "label": "标签",+ "placeholder": "例如:材质"+ },+ "namespace": {+ "label": "命名空间",+ "placeholder": "custom"+ },+ "key": {+ "label": "键名",+ "placeholder": "例如:material",+ "invalid_format": "仅限字母、数字和下划线"+ },+ "field_type": {+ "label": "类型",+ "read_only_help": "一旦存在值,类型便无法更改——更改类型会导致已存储的值被错误解析。",+ "options": {+ "short_text": "短文本",+ "long_text": "长文本",+ "rich_text": "富文本",+ "number": "数字",+ "boolean": "布尔值",+ "json": "JSON"+ }+ },+ "resource_type": {+ "label": "适用于",+ "read_only_help": "一旦此字段存在值,所属对象便无法更改。",+ "options": {+ "Spree::Product": "商品",+ "Spree::Variant": "变体",+ "Spree::Order": "订单",+ "Spree::User": "客户",+ "Spree::Category": "分类",+ "Spree::OptionType": "选项类型"+ }+ },+ "storefront_visible": {+ "label": "在网店中显示",+ "column_label": "网店"+ }+ },+ "tax_category": {+ "name": {+ "placeholder": "例如:低税率"+ },+ "tax_code": {+ "label": "税码",+ "placeholder": "外部税务服务商代码(Avalara 等)"+ },+ "description": {+ "placeholder": "可选的内部描述"+ },+ "is_default": {+ "label": "默认",+ "help": "设置后将取消之前的默认项。没有明确指定类别的商品将回退至此类别。"+ }+ },+ "allowed_origin": {+ "origin": {+ "label": "来源",+ "placeholder": "https://admin.example.com",+ "help": "仅包含协议 + 主机(+ 可选端口)。不含路径、查询参数或片段。"+ }+ },+ "channel": {+ "name": {+ "placeholder": "例如 POS、Wholesale、Meta Shop"+ },+ "code": {+ "label": "代码",+ "placeholder": "自动从名称派生",+ "help": "API 客户端通过 X-Spree-Channel header 使用的稳定标识符,也用于订单归因。留空则自动从名称派生。仅限小写字母、数字、连字符、下划线。"+ },+ "active": {+ "label": "启用",+ "help": "已停用的销售渠道将停止接受订单,且不会被 X-Spree-Channel header 匹配。"+ },+ "default": {+ "label": "默认渠道",+ "help": "每个商店有且仅有一个默认渠道。在未选择渠道时用作回退,并作为新产品的自动发布目标。"+ },+ "order_routing_strategy": {+ "label": "订单路由策略",+ "help": "为归因到此渠道的订单覆盖商店级别的路由策略。留空则继承。",+ "inherit": "从商店继承",+ "options": {+ "Spree::OrderRouting::Strategy::Rules": "规则(有序)",+ "Spree::OrderRouting::Strategy::Legacy": "旧版"+ }+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "密码"+ },+ "password_confirmation": {+ "label": "确认密码"+ }+ },+ "customer_group": {+ "name": {+ "placeholder": "例如:VIP 客户"+ },+ "description": {+ "placeholder": "可选的内部描述"+ }+ },+ "price_list": {+ "name": {+ "label": "名称",+ "placeholder": "例如:欧盟批发",+ "help": "内部标签 — 不会向客户展示。"+ },+ "description": {+ "label": "描述",+ "placeholder": "可选的内部描述"+ },+ "starts_at": {+ "label": "开始时间",+ "placeholder": "立即",+ "help": "此列表何时生效。留空则在激活时立即开始。"+ },+ "ends_at": {+ "label": "结束时间",+ "placeholder": "永不",+ "help": "留空表示无结束日期。"+ },+ "match_policy": {+ "label": "匹配策略",+ "all": "必须满足所有规则",+ "any": "满足任一规则即可"+ },+ "status": {+ "active": "生效中",+ "scheduled": "已排期",+ "inactive": "未生效",+ "draft": "草稿"+ }+ },+ "price_rule": {+ "customers": {+ "label": "客户",+ "help": "留空则此规则适用于每位已登录的客户。"+ },+ "customer_groups": {+ "label": "客户群组",+ "help": "留空则此规则适用于所有客户,不论其所属群组。"+ },+ "markets": {+ "label": "市场",+ "help": "留空则此规则适用于所有市场。"+ }+ },+ "stock_location": {+ "name": {+ "placeholder": "布鲁克林仓库"+ },+ "admin_name": {+ "label": "内部名称",+ "placeholder": "可选 — 仅在后台显示"+ },+ "kind": {+ "label": "类型"+ },+ "active": {+ "label": "启用",+ "help": "停用的库存地点不会出现在履约选择中。"+ },+ "default": {+ "label": "默认库存地点",+ "help": "新库存项会同步到此地点。只能设置一个默认地点。"+ },+ "backorderable_default": {+ "label": "默认允许缺货下单",+ "help": "新库存项在缺货时默认允许缺货下单。"+ },+ "propagate_all_variants": {+ "label": "为所有变体自动创建库存项",+ "help": "为每个商品变体在此地点创建库存项。"+ },+ "pickup_enabled": {+ "label": "允许客户自提",+ "help": "客户可在结账时选择从此地点自提订单。"+ },+ "pickup_stock_policy": {+ "label": "库存策略"+ },+ "pickup_ready_in_minutes": {+ "label": "备货时间(分钟)",+ "placeholder": "60"+ },+ "pickup_instructions": {+ "label": "自提说明",+ "placeholder": "客户应前往何处领取订单。"+ }+ },+ "payment_method": {+ "type": {+ "label": "服务商",+ "placeholder": "选择服务商"+ },+ "name": {+ "placeholder": "例如:信用卡 (Stripe)"+ },+ "description": {+ "placeholder": "结账时向客户展示的描述"+ },+ "storefront_visible": {+ "label": "在店面显示"+ },+ "active": {+ "label": "启用",+ "help": "未启用的方式将在结账时隐藏。"+ },+ "auto_capture": {+ "label": "自动收款",+ "help": "授权后自动收取款项。关闭时,需手动收款。"+ },+ "provider_configuration": "服务商配置"+ },+ "market": {+ "name": {+ "placeholder": "例如:欧洲"+ },+ "currency": {+ "label": "货币",+ "help": "用于此市场所有价格的 ISO 4217 货币。"+ },+ "default_locale": {+ "label": "默认语言区域",+ "help": "此市场中购物者的店面语言。"+ },+ "supported_locales": {+ "label": "支持的语言区域",+ "help": "购物者可切换到的其他语言。始终包含默认语言区域。"+ },+ "country_isos": {+ "label": "国家/地区",+ "help": "选择此市场涵盖的国家/地区。每个国家/地区在每个商店中最多只能属于一个市场。"+ },+ "tax_inclusive": {+ "label": "含税定价",+ "help": "显示含税价格。在欧盟市场较为常见。"+ },+ "default": {+ "label": "默认市场",+ "help": "没有已知国家/地区的购物者会看到此市场。每个商店只能有一个默认市场。"+ }+ },+ "option_type": {+ "name": {+ "label": "内部名称",+ "placeholder": "例如 shirt-size",+ "help": "小写标识符。在整个店铺中必须唯一。"+ },+ "label": {+ "label": "标签",+ "placeholder": "例如 衬衫尺码",+ "help": "在店面向客户展示。"+ },+ "kind": {+ "label": "类型",+ "help": "控制该选项在店面的呈现方式。色块显示十六进制颜色;按钮显示缩略图。"+ },+ "filterable": {+ "label": "可筛选",+ "help": "在店面商品列表中将此选项显示为筛选项。"+ }+ },+ "option_value": {+ "name": {+ "label": "内部名称",+ "placeholder": "例如 small"+ },+ "label": {+ "label": "标签",+ "placeholder": "例如 Small"+ },+ "color_code": {+ "label": "颜色"+ },+ "image": {+ "label": "图片"+ }+ },+ "variant": {+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUCT-RED-S"+ },+ "barcode": {+ "label": "条形码"+ },+ "weight": {+ "label": "重量"+ },+ "weight_unit": {+ "label": "单位"+ },+ "height": {+ "label": "高度"+ },+ "width": {+ "label": "宽度"+ },+ "depth": {+ "label": "深度"+ },+ "dimensions_unit": {+ "label": "单位"+ }+ },+ "api_key": {+ "name": {+ "label": "名称",+ "placeholder": "后端集成、店面生产环境、…",+ "required": "名称为必填项"+ },+ "key_type": {+ "label": "类型"+ },+ "scopes": {+ "label": "权限范围"+ }+ },+ "store": {+ "name": {+ "label": "店铺名称"+ },+ "preferred_admin_locale": {+ "label": "后台语言",+ "placeholder": "使用默认语言"+ },+ "preferred_timezone": {+ "label": "时区",+ "placeholder": "选择时区"+ },+ "preferred_unit_system": {+ "label": "单位制"+ },+ "preferred_weight_unit": {+ "label": "重量单位"+ },+ "mail_from_address": {+ "label": "发件人地址",+ "placeholder": "[email protected]",+ "help": "作为每封交易类邮件的发件人(From)地址。"+ },+ "customer_support_email": {+ "label": "客户支持邮箱",+ "placeholder": "[email protected]",+ "help": "在店面邮件中向客户显示的回复(Reply-to)地址。"+ },+ "new_order_notifications_email": {+ "label": "新订单通知",+ "placeholder": "[email protected]",+ "help": "“新订单已下单”通知的接收人。留空则禁用。"+ },+ "preferred_send_consumer_transactional_emails": {+ "label": "向客户发送交易类邮件",+ "help": "关闭后,将不会发送订单确认、发货或退款邮件。"+ },+ "mailer_logo": {+ "label": "邮件徽标",+ "help": "采用透明背景的 PNG 或 JPG 图片。嵌入在交易类邮件的页眉中。"+ }+ },+ "webhook_endpoint": {+ "name": {+ "label": "名称",+ "placeholder": "例如:订单流水线",+ "help": "在此列表中显示的可选标签。"+ },+ "url": {+ "label": "目标 URL",+ "placeholder": "https://example.com/webhooks"+ },+ "active": {+ "label": "启用",+ "help": "未启用的端点不会接收推送。"+ },+ "subscriptions": {+ "label": "事件",+ "help": "选择哪些事件应触发 Webhook。不选择任何事件则接收所有事件。"+ }+ },+ "product": {+ "name": {+ "label": "名称",+ "placeholder": "产品名称"+ },+ "description": {+ "label": "描述",+ "placeholder": "撰写产品描述…"+ },+ "make_active_at": {+ "label": "激活日期"+ },+ "available_on": {+ "label": "上架日期"+ },+ "discontinue_on": {+ "label": "下架日期"+ },+ "category_ids": {+ "label": "分类"+ },+ "channels": {+ "label": "销售渠道"+ },+ "tags": {+ "label": "标签"+ }+ },+ "product_publication": {+ "published_at": {+ "label": "发布开始时间",+ "placeholder": "立即上线",+ "help": "留空则立即上线。"+ },+ "unpublished_at": {+ "label": "下架时间",+ "placeholder": "永不",+ "help": "留空则一直保持上架。"+ }+ },+ "gift_card": {+ "code": {+ "label": "代码",+ "help": "留空以自动生成。批量发行时,此项将作为前缀。"+ },+ "amount": {+ "label": "金额"+ },+ "currency": {+ "label": "货币"+ },+ "expires_at": {+ "label": "过期时间",+ "placeholder": "永不过期"+ },+ "customer_id": {+ "label": "客户"+ },+ "quantity": {+ "label": "数量",+ "help": "为 1 时发行单张礼品卡。大于 1 时批量发行并自动生成代码。"+ }+ },+ "customer": {+ "tags": {+ "label": "标签"+ },+ "customer_groups": {+ "label": "客户组"+ },+ "accepts_email_marketing": {+ "label": "已订阅营销邮件"+ },+ "internal_note": {+ "label": "内部备注",+ "placeholder": "仅员工可见的客户相关备注…"+ }+ },+ "store_credit": {+ "amount": {+ "label": "金额"+ },+ "currency": {+ "label": "货币"+ },+ "category_id": {+ "label": "类别"+ },+ "memo": {+ "label": "备注",+ "placeholder": "签发此项信用额度的原因"+ }+ },+ "order": {+ "email": {+ "label": "或使用访客邮箱",+ "placeholder": "[email protected]"+ },+ "customer_note": {+ "label": "客户备注(客户可见)"+ },+ "internal_note": {+ "label": "内部备注(仅员工可见)"+ },+ "coupon_code": {+ "label": "优惠码",+ "placeholder": "可选"+ },+ "channel": {+ "label": "销售渠道",+ "placeholder": "使用店铺默认",+ "help": "将订单归属于特定销售渠道。默认为店铺的线上渠道。"+ }+ },+ "media": {+ "alt": {+ "label": "替代文本",+ "placeholder": "为无障碍访问和 SEO 描述该图片"+ }+ },+ "profile": {+ "email": {+ "label": "邮箱"+ },+ "first_name": {+ "label": "名字"+ },+ "last_name": {+ "label": "姓氏"+ },+ "selected_locale": {+ "label": "语言",+ "help": "管理后台使用的语言。仅影响您看到的界面。"+ }+ }+ },+ "promotions": {+ "rule_types_empty": "未注册任何规则类型。",+ "rule_types_all_used": "所有可用的规则类型都已添加到此优惠中。",+ "table": {+ "search_placeholder": "按名称搜索…",+ "empty": "暂无优惠活动",+ "no_end": "无结束日期"+ },+ "code": {+ "automatic": "自动",+ "multi": "multi"+ },+ "generate_code": {+ "title": "生成随机代码"+ },+ "kinds": {+ "coupon_code": "优惠码",+ "automatic": "自动(无需代码)"+ },+ "match_policies": {+ "all": "必须满足所有规则",+ "any": "满足任一规则即可",+ "all_hint": "必须满足所有规则。",+ "any_hint": "满足任一规则即可。"+ },+ "rules_card": {+ "title": "规则",+ "description": "决定优惠是否适用的条件。",+ "empty": "暂无规则。没有规则时,优惠始终满足条件(受排期和使用次数限制约束)。",+ "add_rule": "添加规则"+ },+ "validation": {+ "code_required": "代码为必填项(或点击生成)",+ "prefix_required": "多代码批次需要前缀",+ "number_of_codes_required": "请选择要生成的代码数量",+ "expiry_after_start": "到期时间必须晚于开始日期"+ },+ "delete_confirm": {+ "title": "删除优惠?",+ "message": "{{name}} 将被永久移除。被已完成订单引用的优惠无法删除。",+ "default_name": "此优惠"+ },+ "rules": {+ "country": {+ "label": "国家/地区",+ "search_placeholder": "搜索国家/地区…",+ "empty": "没有匹配的国家/地区"+ },+ "product": {+ "label": "商品",+ "search_placeholder": "按名称搜索商品…",+ "empty": "没有匹配的商品",+ "match_policy": {+ "any": {+ "label": "这些商品中的任意一个",+ "description": "订单必须至少包含其中一个。"+ },+ "all": {+ "label": "所有这些商品",+ "description": "订单必须包含每一个商品。"+ },+ "none": {+ "label": "这些商品都不包含",+ "description": "订单不得包含其中任何一个。"+ }+ }+ },+ "category": {+ "label": "分类",+ "search_placeholder": "搜索分类…",+ "empty": "没有匹配的分类",+ "match_policy": {+ "any": {+ "label": "这些分类中的任意一个",+ "description": "订单必须包含至少一个分类中的商品。"+ },+ "all": {+ "label": "所有这些分类",+ "description": "订单必须包含每个分类中的商品。"+ }+ }+ },+ "customer_group": {+ "label": "客户组",+ "search_placeholder": "搜索客户组…",+ "empty": "没有匹配的客户组"+ },+ "customer": {+ "label": "客户",+ "search_placeholder": "按姓名或邮箱搜索客户…",+ "empty": "没有匹配的客户"+ }+ },+ "basics_card": {+ "title": "基本信息"+ },+ "trigger_card": {+ "title": "触发条件"+ },+ "schedule_card": {+ "title": "排期与限制"+ },+ "trigger_summary": {+ "multi_code": "多码优惠券({{count}} 个码)",+ "multi_code_with_prefix": "多码优惠券({{count}} 个带前缀 \"{{prefix}}\" 的码)",+ "show_codes": "显示优惠码",+ "single_code": "单个优惠码:",+ "locked_help": "触发设置在创建后无法更改。如需更改,请新建一个促销活动。"+ },+ "remove_rule_confirm": {+ "title": "移除规则?",+ "message": "保存促销时移除。"+ },+ "rule_summary": {+ "product_count": "{{count}} 个商品",+ "category_count": "{{count}} 个分类",+ "customer_count": "{{count}} 位客户"+ },+ "rule_picker": {+ "title": "添加规则",+ "description": "选择要配置的规则类型。"+ },+ "rule_edit": {+ "description": "调整规则的参数。",+ "no_options": "此规则没有可配置的选项 — 仅其存在即可应用该约束。"+ },+ "actions_card": {+ "description": "促销满足条件时执行的操作。",+ "empty": "暂无操作。没有操作的促销在应用时不会产生任何效果。",+ "add_action": "添加操作"+ },+ "remove_action_confirm": {+ "title": "移除操作?",+ "message": "保存促销活动时移除。"+ },+ "action_summary": {+ "variant_count": "{{count}} 个变体"+ },+ "action_picker": {+ "title": "添加操作",+ "description": "选择当促销满足条件时应执行的操作。"+ },+ "action_edit": {+ "description": "配置该操作的参数。",+ "no_options": "此操作没有可配置的选项。"+ },+ "coupon_codes": {+ "title": "优惠券代码",+ "description": "此促销活动自动生成的代码。只读 — 通过更改促销活动的代码数量设置来重新生成。",+ "description_with_count": "{{count}} 个自动生成的代码。只读 — 通过更改促销活动的代码数量设置来重新生成。",+ "empty": "尚未生成任何代码。",+ "unused": "未使用",+ "used": "已使用",+ "export_csv": "导出 CSV",+ "states": {+ "used": "已使用",+ "partially_used": "部分使用"+ }+ },+ "rule_types": {+ "category": {+ "name": "分类",+ "description": "订单包含指定分类中的商品"+ },+ "country": {+ "name": "国家/地区",+ "description": "仅限收货地址在指定国家/地区的订单"+ },+ "currency": {+ "name": "货币",+ "description": "仅限使用指定货币的订单"+ },+ "customer": {+ "name": "客户",+ "description": "仅对指定客户可用"+ },+ "customer_group": {+ "name": "客户组",+ "description": "仅对指定客户组中的客户可用"+ },+ "customer_logged_in": {+ "name": "仅限已登录客户",+ "description": "仅对已登录客户可用"+ },+ "first_order": {+ "name": "首次订单",+ "description": "必须是客户的首次订单"+ },+ "item_total": {+ "name": "商品总额",+ "description": "订单总额满足这些条件"+ },+ "one_use_per_user": {+ "name": "每位用户限用一次",+ "description": "每位用户仅限使用一次"+ },+ "option_value": {+ "name": "选项值",+ "description": "订单包含具有匹配选项值的商品"+ },+ "product": {+ "name": "商品",+ "description": "订单包含指定商品"+ }+ },+ "action_types": {+ "create_adjustment": {+ "name": "创建整单调整",+ "description": "在订单上创建优惠抵扣调整"+ },+ "create_item_adjustments": {+ "name": "创建按行项目调整",+ "description": "在某个订单项上创建优惠抵扣调整"+ },+ "create_line_items": {+ "name": "创建订单项",+ "description": "向购物车填充指定数量的变体"+ },+ "free_shipping": {+ "name": "免运费",+ "description": "使订单的所有发货免运费"+ }+ },+ "messages": {+ "action_added": "操作已添加",+ "action_updated": "操作已更新",+ "action_removed": "操作已移除",+ "rule_added": "规则已添加",+ "rule_updated": "规则已更新",+ "rule_removed": "规则已移除"+ },+ "errors": {+ "failed_to_add_action": "添加操作失败",+ "failed_to_update_action": "更新操作失败",+ "failed_to_remove_action": "移除操作失败",+ "failed_to_add_rule": "添加规则失败",+ "failed_to_update_rule": "更新规则失败",+ "failed_to_remove_rule": "移除规则失败"+ }+ },+ "components": {+ "market_combobox": {+ "search_placeholder": "搜索市场…",+ "empty": "没有匹配的市场"+ },+ "custom_fields_card": {+ "set_up": "设置",+ "empty_title": "暂无自定义字段",+ "empty_description": "记录结构化信息,例如材质、版型或保养说明。",+ "not_yet_set": "{{total}} 项中有 {{count}} 项尚未设置"+ },+ "custom_fields": {+ "title": "自定义字段",+ "new_definition_title": "新建自定义字段",+ "definition_created_title": "定义已创建",+ "definition_created_toast": "定义已创建",+ "definition_created_hint": "您现在可以设置其值,或先定义另一个字段。",+ "empty_title": "尚未为 {{resource}} 定义自定义字段",+ "empty_description": "定义自定义字段,以便在记录中存储有类型的结构化信息。",+ "create_definition": "创建定义",+ "values_saved": "自定义字段已保存",+ "values_save_failed": "保存自定义字段失败",+ "admin_only": "仅管理员可见",+ "add_another_field": "添加另一个字段",+ "create_another": "再创建一个",+ "set_values": "设置值"+ },+ "adjustment_action_editor": {+ "calculator_label": "计算器",+ "loading_calculators": "正在加载计算器…",+ "select_calculator": "选择一个计算器",+ "no_extra_settings": "此计算器没有额外设置。",+ "settings_label": "计算器设置"+ }+ },+ "pages": {+ "home": {+ "top_products": "热销商品",+ "top_products_description": "您店铺中最畅销的商品。",+ "title": "仪表盘",+ "subtitle": "您的店铺业绩概览",+ "metrics": {+ "sales": "总销售额",+ "orders": "总订单数",+ "avg_order_value": "平均订单金额"+ },+ "metric_short": {+ "sales": "销售额",+ "orders": "订单数",+ "avg_order_value": "客单价"+ },+ "columns": {+ "product": "商品",+ "price": "价格",+ "sold": "已售"+ }+ },+ "staff": {+ "title": "员工",+ "subtitle": "管理后台团队成员和角色",+ "invite_cta": "邀请团队成员",+ "members_section": "成员",+ "invitations_section": "待处理邀请",+ "empty": "暂无员工",+ "empty_description": "邀请团队成员协作管理此店铺。",+ "table": {+ "member": "成员",+ "roles": "角色",+ "role": "角色"+ },+ "invite_sheet": {+ "title": "邀请团队成员",+ "description": "我们将通过电子邮件向其发送设置密码的链接。"+ },+ "edit_sheet": {+ "title": "编辑团队成员"+ },+ "actions": {+ "resend": "重新发送",+ "remove": "从员工中移除"+ },+ "messages": {+ "revoked": "邀请已撤销",+ "updated": "员工已更新",+ "removed": "已从员工中移除"+ }+ },+ "channels": {+ "title": "销售渠道",+ "empty_message": "暂无销售渠道",+ "add_cta": "新建销售渠道",+ "add_sheet_title": "添加销售渠道",+ "edit_sheet_title": "编辑销售渠道",+ "create_label": "创建销售渠道",+ "create_description": "销售渠道用于归集订单和商品列表 ——\"online\"、\"pos\"、市场集成等。",+ "edit_description": "重命名销售渠道或将其暂停。已停用的销售渠道将停止接收订单。",+ "delete_confirm": {+ "title": "删除销售渠道?",+ "message": "{{name}} 将被移除。关联到该渠道的商品和订单将失去其销售渠道引用。"+ },+ "search_placeholder": "搜索销售渠道…",+ "no_channels_found": "未找到销售渠道"+ },+ "customers": {+ "new_cta": "新建客户",+ "create_label": "创建客户",+ "edit_sheet_title": "编辑客户",+ "groups_cta": "客户分组",+ "groups": {+ "title": "客户分组",+ "add_cta": "添加客户分组",+ "edit_sheet_title": "编辑客户分组",+ "add_sheet_title": "添加客户分组"+ },+ "detail": {+ "stat_total_spent": "消费总额",+ "stat_orders": "订单",+ "stat_avg_order_value": "平均订单金额",+ "section_profile": "资料",+ "section_addresses": "地址",+ "section_orders": "订单",+ "section_store_credit": "商店积分",+ "section_internal_note": "内部备注",+ "section_tags": "标签",+ "addresses_empty": "暂无已保存的地址。",+ "orders_empty": "暂无订单。",+ "store_credit_empty": "尚未发放商店积分。",+ "add_address": "添加地址",+ "edit_address": "编辑地址",+ "issue_credit": "发放商店积分",+ "edit_credit": "编辑商店积分"+ }+ },+ "orders": {+ "drafts_title": "草稿订单",+ "new": {+ "title": "新建订单",+ "section_customer": "客户",+ "section_items": "商品",+ "section_billing": "账单",+ "section_notes": "备注",+ "section_summary": "概览",+ "add_line_item": "添加订单项",+ "select_customer": "选择客户",+ "search_variant": "搜索变体…"+ },+ "detail": {+ "section_summary": "概览",+ "section_items": "商品",+ "section_payments": "付款",+ "section_shipments": "发货",+ "section_customer": "客户",+ "section_shipping_address": "收货地址",+ "section_billing_address": "账单地址",+ "section_internal_note": "内部备注",+ "section_customer_note": "客户备注",+ "section_history": "历史记录",+ "summary": {+ "created_by": "创建人",+ "market": "市场",+ "locale": "语言区域",+ "channel": "销售渠道",+ "ip_address": "IP 地址"+ },+ "empty_payments": "暂无付款。",+ "empty_shipments": "暂无发货。",+ "empty_history": "暂无历史记录。",+ "actions": {+ "approve": "批准",+ "cancel": "取消订单",+ "resume": "恢复",+ "refund": "退款",+ "capture": "扣款",+ "void": "作废",+ "mark_paid": "标记为已付款",+ "ship": "标记为已发货"+ },+ "dialogs": {+ "cancel_title": "取消订单?",+ "approve_title": "批准订单?",+ "refund_title": "退款付款?"+ }+ }+ },+ "products": {+ "add_cta": "添加商品",+ "new": {+ "title": "新建商品",+ "description": "设置您的商品 — 添加变体、价格、库存、媒体和自定义字段,然后一次性保存。",+ "save_label": "创建商品",+ "create_succeeded": "商品已创建",+ "create_failed": "创建商品失败",+ "preview_slug_placeholder": "your-product-slug"+ },+ "edit": {+ "bulk_prices": {+ "no_variants": "至少添加一个变体以开始编辑价格。"+ }+ },+ "section_basics": "基本信息",+ "section_media": "媒体",+ "section_pricing": "价格",+ "section_inventory": "库存",+ "section_seo": "SEO",+ "section_categorization": "分类",+ "section_organization": "组织",+ "section_variants": "变体",+ "section_custom_fields": "自定义字段",+ "publishing": {+ "title": "发布",+ "manage_cta": "管理",+ "manage_title": "管理销售渠道",+ "manage_description": "选择哪些销售渠道展示此产品。关闭某个渠道即可在所有位置下架。",+ "empty": "尚未在任何销售渠道上展示。",+ "no_channels": "暂无可用的销售渠道。请在 设置 → 销售渠道 中创建。",+ "inactive_marker": "未启用",+ "status_live": "已上线",+ "status_scheduled": "已排期",+ "status_hidden": "已隐藏",+ "status_not_available": "不可用",+ "caption_live": "现在对客户可见",+ "caption_scheduled": "将于 {{date}} 上线",+ "caption_hidden_after": "将于 {{date}} 下架",+ "caption_unpublished": "已于 {{date}} 隐藏",+ "caption_window": "上线时间 {{start}} → {{end}}",+ "caption_not_available": "已隐藏 — 产品状态为 {{product_status}}"+ },+ "clone_succeeded": "商品已复制",+ "clone_failed": "复制商品失败",+ "delete_succeeded": "商品已删除",+ "delete_failed": "删除商品失败",+ "bulk": {+ "set_status_action": "设置状态…",+ "add_categories_action": "添加到分类…",+ "remove_categories_action": "从分类中移除…",+ "add_channels_action": "添加到销售渠道…",+ "remove_channels_action": "从销售渠道中移除…",+ "add_tags_action": "添加标签…",+ "remove_tags_action": "移除标签…",+ "status_sheet_title": "设置商品状态",+ "status_sheet_description": "选择要应用到所选商品的状态。",+ "categories_add_title": "添加到分类",+ "categories_add_description": "选择要将这些商品添加到的分类。",+ "categories_remove_title": "从分类中移除",+ "categories_remove_description": "选择要将这些商品从中移除的分类。",+ "channels_add_title": "添加到销售渠道",+ "channels_add_description": "选择要上架这些商品的销售渠道。",+ "channels_remove_title": "从销售渠道中移除",+ "channels_remove_description": "选择要将这些商品下架的销售渠道。",+ "tags_add_title": "添加标签",+ "tags_add_description": "选择或创建要添加到这些商品的标签。",+ "tags_remove_title": "移除标签",+ "tags_remove_description": "选择要从这些商品移除的标签。",+ "delete_confirm": {+ "title": "删除 {n} 个商品?",+ "message": "所选商品将被移除。此操作无法撤销。"+ },+ "status_updated": "已更新 {n} 个商品的状态",+ "status_update_failed": "更新商品状态失败",+ "categories_added": "已将 {n} 个商品添加到分类",+ "categories_add_failed": "将商品添加到分类失败",+ "categories_removed": "已将 {n} 个商品从分类中移除",+ "categories_remove_failed": "将商品从分类中移除失败",+ "channels_added": "已在销售渠道上架 {n} 个商品",+ "channels_add_failed": "在销售渠道上架商品失败",+ "channels_removed": "已将 {n} 个商品从销售渠道下架",+ "channels_remove_failed": "将商品从销售渠道下架失败",+ "tags_added": "已为 {n} 个商品添加标签",+ "tags_add_failed": "添加标签失败",+ "tags_removed": "已从 {n} 个商品移除标签",+ "tags_remove_failed": "移除标签失败",+ "deleted": "已删除 {n} 个商品",+ "delete_failed": "删除商品失败"+ },+ "media_empty": "暂无媒体。",+ "media_upload": "上传媒体",+ "variants_empty": "暂无变体。",+ "status_options": {+ "draft": "草稿",+ "archived": "已归档"+ },+ "inventory": {+ "out_of_stock": "缺货",+ "on_backorder": "可延期交货",+ "in_stock": "库存 {{count}} 件"+ },+ "variants_one": "{{count}} 个变体",+ "variants_other": "{{count}} 个变体",+ "transfers": {+ "sheet_title": "新建库存调拨",+ "edit_sheet_title": "调拨 {{number}}",+ "description_internal": "库存从 <strong>{{source}}</strong> 调拨至 <strong>{{destination}}</strong>。",+ "description_external": "外部收货至 <strong>{{destination}}</strong>。",+ "section_from": "从",+ "section_to": "至",+ "section_items": "商品",+ "items_empty": "暂无商品。"+ },+ "options": {+ "sheet_title_create": "创建选项类型",+ "sheet_title_edit": "编辑选项类型",+ "values_section": "值",+ "values_empty": "暂无值。",+ "add_value": "添加选项值",+ "table": {+ "values": "值"+ }+ },+ "price_lists": {+ "title": "价格表",+ "subtitle": "针对客户群体、地区或批量层级的定向定价。",+ "add_cta": "新建价格表",+ "sheet_title_create": "创建价格表",+ "sheet_title_edit": "编辑价格表",+ "delete_confirm": {+ "title": "删除价目表?",+ "message": "移除\"{{name}}\"将删除其价格。此操作无法撤销。"+ },+ "activate": "启用",+ "deactivate": "停用",+ "schedule": "安排",+ "unschedule": "取消安排",+ "edit_prices_cta": "编辑价格",+ "add_products_cta": "添加商品",+ "remove_selected": "移除所选",+ "basics_section": "基本信息",+ "schedule_section": "安排",+ "products_section": "商品",+ "rules_section": "规则",+ "add_rule": "添加规则",+ "rule_click_to_configure": "点击进行配置",+ "rule_no_options": "此规则没有可配置选项——只要存在即应用该约束。",+ "rule_name_overflow": "{{names}} 等 {{count}} 项",+ "remove_rule_confirm": {+ "title": "移除规则?",+ "message": "保存价格列表时将移除该规则。"+ },+ "rules_help": "决定此价格表何时生效的条件。使用“全部”要求满足每条规则,使用“任意”取第一个匹配项。",+ "rules_empty": "暂无规则——此价格表适用于所有购物者。",+ "add_rule_help": "选择要配置的规则类型。",+ "rule_types_empty": "未注册任何规则类型。",+ "rule_types_all_used": "所有可用的规则类型均已添加到此价格表。",+ "rule_default_description": "调整该规则的参数。",+ "products_help": "选择此价格表适用的商品。保存时会创建占位价格——请在下方填写。",+ "products_search_placeholder": "按名称搜索商品…",+ "products_empty_search": "没有匹配的商品",+ "products_selected_one": "已选择 {{count}} 个商品。",+ "products_selected_other": "已选择 {{count}} 个商品。",+ "prices_help_one": "已配置 {{count}} 个价格。打开批量编辑器进行更新。",+ "prices_help_other": "已配置 {{count}} 个价格。打开批量编辑器进行更新。",+ "prices_help_zero": "在上方选择商品以生成占位价格,然后打开批量编辑器。",+ "activate_confirm": {+ "title": "激活价格列表?",+ "message": "“{{name}}”将立即应用于符合条件的客户,并保持有效,直至手动停用。",+ "message_with_end": "“{{name}}”将立即应用于符合条件的客户,并保持有效,直至手动停用或到达结束日期({{ends_at}})。"+ },+ "schedule_confirm": {+ "title": "排定价目表上线时间?",+ "message": "\"{{name}}\" 将于 {{starts_at}} 上线,并持续生效至其结束日期。"+ },+ "deactivate_confirm": {+ "title": "停用价格表?",+ "message": "\"{{name}}\" 将立即对客户停止生效。已有订单不受影响。"+ },+ "unschedule_confirm": {+ "title": "取消价格表的排期?",+ "message": "\"{{name}}\" 将不再在其排定的日期激活。您可以稍后重新排期或手动激活它。"+ },+ "edit_prices": {+ "title": "编辑价格 — {{name}}",+ "currency_label": "货币",+ "empty": "此列表中暂无商品。",+ "add_products_link": "添加商品",+ "columns": {+ "product": "商品",+ "variant": "变体",+ "sku": "SKU",+ "price": "价格",+ "compare_at_price": "对比价"+ },+ "variant_default": "默认",+ "grid_aria": "变体价格",+ "search_placeholder": "按商品、SKU 或选项搜索…",+ "price_aria": "{{label}} 的价格",+ "compare_at_aria": "{{label}} 的对比价",+ "save_cta": "保存价格",+ "save_success_one": "已保存 {{count}} 个价格",+ "save_success_other": "已保存 {{count}} 个价格",+ "save_failed": "保存价格失败",+ "count_summary_one": "{{count}} 个 {{currency}} 价格",+ "count_summary_other": "{{count}} 个 {{currency}} 价格",+ "no_matches_for_filters": "没有价格符合当前筛选条件。",+ "no_matches_for_search": "没有价格匹配 \"{{search}}\"。",+ "empty_pick_products": "在价目表中选择商品以开始设置价格。",+ "empty_no_base_prices": "暂无基础价格。",+ "dirty_summary_one": "{{count}} 项未保存的更改",+ "dirty_summary_other": "{{count}} 项未保存的更改",+ "discard_confirm": {+ "title": "放弃未保存的价格?",+ "message_close_one": "您有 {{count}} 个未保存的价格。关闭将放弃它。",+ "message_close_other": "您有 {{count}} 个未保存的价格。关闭将放弃它们。",+ "message_currency": "切换货币将放弃您未保存的价格。"+ }+ },+ "products_empty": "暂无商品——添加一个以开始编辑价格。",+ "no_changes": "没有需要保存的更改。"+ }+ },+ "settings": {+ "store": {+ "title": "店铺设置",+ "subtitle": "通用配置与店铺级默认设置。",+ "tab_general": "通用",+ "tab_standards": "标准与格式"+ },+ "emails": {+ "title": "邮件设置",+ "subtitle": "发件人地址、通知,以及嵌入在交易邮件中的徽标。",+ "section_delivery": "发送",+ "section_addresses": "邮件地址",+ "section_logo": "徽标",+ "logo_dimensions_help": "推荐:204×104 像素。",+ "logo_upload_cta": "上传徽标",+ "logo_replace_cta": "替换徽标",+ "logo_remove_cta": "移除徽标",+ "logo_uploading": "上传中…",+ "logo_upload_failed": "上传徽标失败。",+ "load_failed_title": "无法加载邮件设置"+ },+ "webhooks": {+ "title": "Webhooks",+ "subtitle": "订阅 HTTPS 端点以接收店铺触发的事件。",+ "search_placeholder": "按 URL 搜索…",+ "new_cta": "新建端点",+ "empty_title": "暂无 Webhook 端点",+ "empty_description": "创建一个端点,在订阅的事件触发时接收已签名的 POST 请求。",+ "add_sheet_title": "添加 Webhook 端点",+ "edit_sheet_title": "编辑 Webhook 端点",+ "deliveries_sheet_title": "最近的投递记录",+ "delete_confirm": {+ "title": "删除 webhook 端点?",+ "message": "{{name}} 将立即停止接收投递。过往的投递历史也将被删除。"+ },+ "detail": {+ "load_failed_title": "无法加载此 Webhook 端点",+ "delete_label": "删除端点",+ "details_title": "详情",+ "edit_title": "编辑端点",+ "url": "目标 URL",+ "subscriptions": "事件"+ },+ "save_secret_title": "保存你的签名密钥",+ "save_secret_description": "使用此密钥验证传入的 Webhook 签名。我们不会再次显示它。",+ "actions": {+ "send_test": "发送测试",+ "disable": "停用",+ "enable": "重新启用",+ "view_deliveries": "查看投递记录",+ "redeliver": "重新投递"+ },+ "status": {+ "inactive": "未启用",+ "disabled": "自动禁用",+ "disabled_reason": "已禁用:{{reason}}"+ },+ "health": {+ "label": "运行状况",+ "healthy": "正常 ({{percentage}}%)",+ "degraded": "降级 ({{percentage}}%)",+ "failing": "故障中 ({{percentage}}%)",+ "disabled": "已禁用",+ "no_deliveries": "暂无投递记录",+ "auto_disabled_alert": "此端点因多次投递失败已被自动禁用。",+ "re_enable_cta": "重新启用",+ "metric_total": "投递次数",+ "metric_successful": "成功",+ "metric_failed": "失败",+ "row_counters_successful_one": "{{count}} 次成功",+ "row_counters_successful_other": "{{count}} 次成功",+ "row_counters_failed_one": "{{count}} 次失败",+ "row_counters_failed_other": "{{count}} 次失败"+ },+ "table": {+ "url": "URL",+ "events": "事件",+ "recent_deliveries": "最近 7 天",+ "last_delivery": "最近一次投递",+ "copy_url_aria": "复制 URL"+ },+ "events_all": "所有事件",+ "events_count_one": "{{count}} 个事件",+ "events_count_other": "{{count}} 个事件",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "移除 {{event}}",+ "event_groups": {+ "asset": "资源",+ "custom": "自定义",+ "customer": "客户",+ "digital": "数字内容",+ "gift_card": "礼品卡",+ "gift_card_batch": "礼品卡批次",+ "import_export": "导入 / 导出",+ "invitation": "邀请",+ "line_item": "订单项",+ "newsletter_subscriber": "邮件订阅者",+ "order": "订单",+ "payment": "支付",+ "payment_session": "支付会话",+ "payment_setup_session": "支付设置会话",+ "price": "价格",+ "product": "商品",+ "promotion": "优惠",+ "refund": "退款",+ "report": "报表",+ "return": "退货",+ "shipment": "发货",+ "stock_item": "库存项",+ "stock_movement": "库存变动",+ "stock_reservation": "库存预留",+ "stock_transfer": "库存调拨",+ "store_credit": "店铺积分",+ "variant": "变体",+ "wishlist": "心愿单"+ },+ "deliveries": {+ "table": {+ "event": "事件",+ "code": "响应",+ "execution_time": "耗时",+ "delivered_at": "投递时间"+ },+ "status": {+ "pending": "待处理",+ "success": "成功",+ "failure": "失败",+ "error": "错误"+ },+ "empty": "暂无投递记录 — 发送一次测试以验证你的端点。",+ "search_placeholder": "按事件名称搜索…",+ "test_sent": "测试 Webhook 已加入队列。",+ "test_failed": "发送测试 Webhook 失败。",+ "redeliver_queued": "重新投递已加入队列。",+ "detail_sheet_title": "投递详情",+ "detail": {+ "event": "事件",+ "url": "目标 URL",+ "delivered_at": "投递时间",+ "response_code": "响应代码",+ "execution_time": "执行耗时",+ "error_type": "错误类型",+ "request_errors": "传输错误",+ "request_payload": "请求负载",+ "response_body": "响应正文",+ "response_body_truncated": "响应正文已被截断至 {{limit}} 个字符。",+ "copy_payload_aria": "复制请求负载",+ "copy_response_aria": "复制响应正文"+ }+ }+ },+ "api_keys": {+ "title": "API 密钥",+ "subtitle": "授权集成和应用调用 Admin API。",+ "publishable_section": "可公开密钥",+ "publishable_help": "供您的店面使用。可安全地暴露在客户端代码中。",+ "secret_section": "私密密钥",+ "secret_help": "仅限服务器到服务器使用。请为每个密钥限定所需的操作范围。",+ "new_cta": "新建密钥",+ "empty_publishable": "暂无可公开密钥。",+ "empty_secret": "暂无私密密钥。",+ "table": {+ "key": "密钥",+ "scopes": "范围",+ "last_used_at": "最近使用"+ },+ "save_secret_title": "保存您的私密密钥",+ "save_secret_description": "请立即复制此值 — 我们不会再次显示它。",+ "scope_badge": {+ "full_access": "完全访问",+ "read_all": "读取全部"+ }+ },+ "payment_methods": {+ "add_sheet_title": "添加支付方式",+ "edit_sheet_title": "编辑支付方式"+ },+ "tax_categories": {+ "add_sheet_title": "添加税收类别",+ "edit_sheet_title": "编辑税收类别"+ },+ "markets": {+ "add_sheet_title": "添加市场",+ "edit_sheet_title": "编辑市场"+ },+ "custom_field_definitions": {+ "add_sheet_title": "添加自定义字段",+ "edit_sheet_title": "编辑自定义字段"+ },+ "stock_locations": {+ "add_sheet_title": "添加库存位置",+ "edit_sheet_title": "编辑库存位置",+ "search_placeholder": "搜索库存位置…"+ },+ "allowed_origins": {+ "add_sheet_title": "添加允许的来源",+ "edit_sheet_title": "编辑允许的来源"+ }+ },+ "promotions": {+ "new_title": "新建优惠活动",+ "create_cta": "创建优惠活动",+ "loading": "正在加载优惠活动…",+ "gift_cards": {+ "new_sheet_title": "新建礼品卡",+ "edit_sheet_title": "礼品卡",+ "not_found": "未找到礼品卡。",+ "new_cta": "新建礼品卡",+ "create_label": "创建礼品卡",+ "batch_section": "批次",+ "create_batch_cta": "创建 {{count}} 张礼品卡",+ "status_options": {+ "redeemed": "已兑换",+ "expired": "已过期",+ "void": "已作废"+ },+ "sheet": {+ "create_description": "签发单张礼品卡,或生成一批带自动生成代码的礼品卡。",+ "edit_description": "更新礼品卡的客户或有效期。代码和金额在签发后不可更改。"+ },+ "delete_confirm": {+ "title": "删除礼品卡?",+ "message": "此操作将作废该礼品卡并使其无法兑换。"+ },+ "validation": {+ "amount_positive": "金额必须大于零",+ "amount_required": "金额为必填项",+ "prefix_required": "批次需填写前缀",+ "currency_required": "货币为必填项"+ },+ "prefix": {+ "label": "前缀",+ "placeholder": "例如 WELCOME — 代码将为 WELCOME-abc123",+ "auto_placeholder": "留空时自动生成"+ },+ "no_customer": "未关联客户",+ "usage": {+ "title": "使用情况",+ "used": "已使用",+ "remaining": "剩余",+ "issued_by": "签发人"+ }+ }+ },+ "profile": {+ "title": "个人资料",+ "subtitle": "管理您的个人详细信息和管理后台语言。",+ "personal_details": "个人详细信息",+ "load_failed_title": "无法加载您的个人资料"+ }+ },+ "invitation": {+ "missing_token_title": "缺少邀请令牌",+ "missing_token_message": "此链接似乎不完整。请让邀请你的人重新发送一次。",+ "loading": "正在加载邀请…",+ "not_found_title": "未找到邀请",+ "not_found_message": "此邀请已过期、被撤销或已被接受。请让邀请人发送一个新的邀请。",+ "generic_error_title": "无法加载邀请",+ "generic_error_message": "出现了一些问题。请重试。",+ "join_store": "加入 {{store}}",+ "invited_by": "{{email}} 邀请了你",+ "invited_generic": "你已被邀请",+ "invited_as_role": ",担任 {{role}}",+ "sign_in_to_accept": "。登录以接受。",+ "create_to_accept": "。创建账户以接受。",+ "could_not_accept": "无法接受邀请",+ "accepting": "正在接受…",+ "sign_in_and_accept": "登录并接受",+ "create_and_accept": "创建账户并接受"+ },+ "staff": {+ "actions": {+ "copy_invitation_link": "复制邀请链接",+ "invitation_link_copied": "邀请链接已复制"+ },+ "autocomplete": {+ "placeholder": "搜索员工…",+ "empty": "无匹配的员工"+ },+ "confirm": {+ "remove_title": "从店铺中移除?",+ "remove_message": "{{name}} 将失去对此店铺的访问权限。",+ "revoke_title": "撤销邀请?",+ "revoke_message": "{{email}} 将无法再接受此邀请。"+ },+ "errors": {+ "failed_to_remove": "移除员工失败",+ "failed_to_resend": "重新发送邀请失败",+ "failed_to_revoke": "撤销邀请失败"+ },+ "invite": {+ "email_placeholder": "[email protected]",+ "roles_loading": "正在加载角色…",+ "roles_placeholder": "选择一个角色",+ "no_roles": "暂无可用角色。"+ },+ "edit": {+ "roles_label": "此店铺的角色"+ },+ "edit_description": "更新此员工的个人资料详情和分配的角色。",+ "actions_aria": "操作"+ },+ "api_keys": {+ "empty_description": "创建一个以开始使用。",+ "create_sheet_title": "创建 API key",+ "create_sheet_description": "选择密钥类型,然后选择它可以使用的权限范围。",+ "edit_sheet_title": "编辑 API key",+ "edit_sheet_description": "重命名此密钥。权限范围在创建密钥时即已固定,无法更改。",+ "scopes_immutable_help": "密钥创建后权限范围无法更改。如需更改,请使用所需的权限范围创建一个新密钥,并撤销此密钥。",+ "key_type": {+ "secret_title": "Secret key",+ "secret_description": "服务器到服务器。每个密钥都带有明确的权限范围列表。",+ "publishable_title": "Publishable key",+ "publishable_description": "可安全地暴露在客户端代码中。授予公开/访客访问权限。"+ },+ "scope_picker": {+ "resource_header": "资源",+ "read_header": "读取",+ "write_header": "写入",+ "read_aria": "读取 {{resource}}",+ "write_aria": "写入 {{resource}}",+ "full_access_label": "完全访问 (write_all)",+ "read_all_label": "全部读取 (read_all)",+ "resources": {+ "orders": "订单",+ "products": "商品",+ "promotions": "优惠",+ "customers": "客户",+ "payments": "支付",+ "fulfillments": "履约",+ "refunds": "退款",+ "gift_cards": "礼品卡",+ "store_credits": "店铺信用",+ "stock": "库存",+ "categories": "分类",+ "settings": "设置",+ "webhooks": "Webhooks",+ "api_keys": "API keys",+ "dashboard": "仪表盘"+ },+ "full_access_hint": "— 对每个资源的读取 + 写入",+ "read_all_hint": "— 对每个资源的读取",+ "show_more_aria_one": "显示另外 {{count}} 个权限范围",+ "show_more_aria_other": "显示另外 {{count}} 个权限范围"+ },+ "warning_treat_like_password": "请像对待密码一样对待此密钥。将其存储在密钥管理器中——我们无法再次显示它。",+ "revoke_confirm": {+ "title": "撤销密钥?",+ "message": "任何使用此密钥的集成都将立即停止工作。"+ },+ "delete_confirm": {+ "title": "删除密钥?",+ "message": "此操作将永久删除密钥。如果以后可能需要恢复访问权限,建议改用撤销。"+ },+ "dropdown": {+ "revoke": "撤销密钥",+ "copy_token_aria": "复制 token"+ },+ "badge": {+ "revoked": "已撤销",+ "never_used": "从未使用"+ },+ "errors": {+ "failed_to_delete": "删除密钥失败",+ "failed_to_update": "更新密钥失败",+ "failed_to_create": "创建密钥失败"+ },+ "by_email": "由 {{email}}",+ "create_key_cta": "创建密钥",+ "validation": {+ "scope_required": "请至少选择一个权限范围"+ }+ },+ "customers": {+ "table": {+ "search_placeholder": "按邮箱或姓名搜索…",+ "empty": "暂无客户"+ },+ "columns": {+ "orders": "订单",+ "total_spent": "消费总额",+ "last_order": "最近订单",+ "groups": "分组",+ "newsletter": "订阅资讯"+ },+ "groups": {+ "table": {+ "title": "客户分组",+ "search_placeholder": "按名称搜索…",+ "empty": "暂无客户分组"+ },+ "columns": {+ "customers": "客户"+ },+ "bulk_add_action": "添加到分组…",+ "bulk_remove_action": "从分组移除…",+ "bulk_added": "已将 {{count}} 位客户添加到分组",+ "bulk_removed": "已将 {{count}} 位客户从分组移除",+ "bulk_add_failed": "添加客户到分组失败",+ "bulk_remove_failed": "从分组移除客户失败",+ "picker": {+ "add_title": "添加到分组",+ "add_description": "选择要将这些客户添加到的分组。",+ "remove_title": "从分组移除",+ "remove_description": "选择要将这些客户移除的分组。"+ },+ "view_members": "查看成员",+ "count_one": "{{count}} 位客户",+ "count_other": "{{count}} 位客户",+ "create_label": "创建客户分组",+ "create_description": "创建客户分组,以便对客户进行细分,用于优惠、分析或营销。",+ "edit_description": "更新名称或描述。",+ "default_name": "此分组",+ "delete_confirm": {+ "title": "删除客户分组?",+ "message": "{{name}} 将被移除。此分组中的客户不会被删除。"+ }+ },+ "tags": {+ "bulk_add_action": "添加标签…",+ "bulk_remove_action": "移除标签…",+ "bulk_added": "已为 {n} 位客户添加标签",+ "bulk_removed": "已从 {n} 位客户移除标签",+ "bulk_add_failed": "添加标签失败",+ "bulk_remove_failed": "移除标签失败",+ "picker": {+ "add_title": "添加标签",+ "add_description": "选择或创建要添加到这些客户的标签。",+ "remove_title": "移除标签",+ "remove_description": "选择要从这些客户移除的标签。"+ }+ },+ "row_actions": {+ "delete_confirm": "删除 {{email}}?已有已完成订单的客户无法被移除。"+ },+ "detail": {+ "delete_label": "删除客户",+ "edit_profile_description": "更新客户的个人资料信息。",+ "subscribed_to_marketing": "已订阅营销资讯",+ "not_subscribed_to_marketing": "未订阅营销资讯",+ "customer_since": "注册时间",+ "last_order_placed": "最近下单时间",+ "orders_table": {+ "order": "订单",+ "date": "日期"+ },+ "no_internal_notes": "暂无内部备注",+ "address": {+ "default_billing": "默认账单地址",+ "default_shipping": "默认收货地址",+ "set_default_billing": "设为默认账单地址",+ "set_default_shipping": "设为默认收货地址",+ "delete_confirm_message": "删除此地址?"+ },+ "store_credit": {+ "title": "商店积分",+ "empty": "未发放商店积分",+ "table": {+ "used": "已使用",+ "remaining": "剩余",+ "category": "类别",+ "memo": "备注"+ },+ "delete_confirm_message": "删除此商店积分?",+ "edit_description": "调整金额、类别或备注。已使用的余额无法编辑。",+ "add_description": "向此客户账户发放商店积分。"+ }+ },+ "new_sheet_description": "在此创建的客户未设置密码。他们首次登录时将收到一个魔法链接。",+ "autocomplete": {+ "placeholder": "搜索客户…",+ "empty": "没有匹配的客户"+ }+ },+ "orders": {+ "table": {+ "search_placeholder": "搜索订单…",+ "empty": "未找到订单"+ },+ "columns": {+ "number": "编号",+ "date": "日期",+ "customer": "客户",+ "payment": "付款",+ "fulfillment": "履约",+ "items": "商品",+ "tags": "标签",+ "sku": "SKU"+ },+ "item_count_one": "{{count}} 件商品",+ "item_count_other": "{{count}} 件商品",+ "statuses": {+ "draft": "草稿",+ "placed": "已下单",+ "canceled": "已取消"+ },+ "payment_statuses": {+ "balance_due": "待付款",+ "credit_owed": "应退款",+ "failed": "失败",+ "paid": "已付款",+ "void": "已作废"+ },+ "fulfillment_statuses": {+ "backorder": "缺货补订",+ "canceled": "已取消",+ "partial": "部分完成",+ "pending": "待处理",+ "ready": "已就绪",+ "fulfilled": "已履行"+ },+ "new": {+ "use_default_addresses": "使用客户的默认账单和配送地址",+ "add_variant": "添加变体",+ "items_table": {+ "variant": "变体",+ "sku": "SKU",+ "qty": "数量"+ },+ "creates_draft_note": "创建一个草稿订单。创建后可添加付款并完成订单。"+ },+ "detail": {+ "load_failed_message": "无法加载订单 {{orderId}}。",+ "confirm": {+ "complete_message": "现在完成此草稿订单吗?",+ "approve_message": "批准此订单吗?",+ "resume_message": "恢复此已取消的订单吗?",+ "cancel_message": "确定要取消此订单吗?",+ "remove_item_message": "从订单中移除此商品吗?",+ "ship_message": "发货此履约单吗?",+ "cancel_shipment_message": "取消此履约单吗?",+ "capture_message": "捕获此付款吗?",+ "void_message": "作废此付款吗?",+ "remove_gift_card_message": "从订单中移除此礼品卡吗?",+ "remove_store_credit_message": "从订单中移除商店积分吗?"+ },+ "dropdown": {+ "complete_order": "完成订单",+ "preview_order": "预览订单",+ "resend_confirmation": "重新发送确认",+ "edit_quantity": "编辑数量",+ "cancel_shipment": "取消发货",+ "void_payment": "作废付款"+ },+ "messages": {+ "canceled": "订单已取消",+ "completed": "订单已完成",+ "approved": "订单已批准",+ "resumed": "订单已恢复",+ "shipped": "发货已发出",+ "captured": "付款已收取",+ "voided": "付款已作废",+ "confirmation_sent": "确认信息已发送"+ },+ "errors": {+ "cancel_failed": "取消订单失败",+ "complete_failed": "完成订单失败",+ "approve_failed": "批准订单失败",+ "resume_failed": "恢复订单失败",+ "confirmation_send_failed": "发送确认失败"+ },+ "variant_search": {+ "description": "搜索要添加到此订单的商品变体。",+ "label": "搜索变体",+ "empty": "未找到变体",+ "sku_prefix": "SKU",+ "placeholder": "输入商品名称或 SKU(至少 3 个字符)…"+ },+ "edit_quantity": {+ "title": "编辑数量",+ "description": "设置该订单行项目的数量。"+ },+ "items_table": {+ "item": "商品",+ "price": "价格",+ "qty": "数量"+ },+ "tracking": {+ "label": "物流单号",+ "description": "更新此发货单的物流单号。",+ "prefix": "物流",+ "shipped_prefix": "已发货",+ "edit_title": "编辑物流单号",+ "add_title": "添加物流单号"+ },+ "payments_table": {+ "number": "编号",+ "method": "方式",+ "state": "州/省"+ },+ "payment_form": {+ "description": "对此订单的某种支付方式进行收款。",+ "method_label": "支付方式",+ "method_placeholder": "选择一种支付方式",+ "source_label": "来源",+ "amount_help": "留空则默认为未结清的余额。",+ "capture_immediately": "立即扣款",+ "title": "添加付款",+ "source_requires_customer": "此支付方式需要已保存的来源。请先为订单分配一位客户。",+ "no_saved_cards": "客户没有用于此支付方式的已保存银行卡。",+ "source_placeholder": "选择一张已保存的银行卡…"+ },+ "summary": {+ "canceled_at": "取消时间",+ "canceler": "取消人",+ "approved_by": "审批人",+ "promotions": "优惠",+ "adjustments": "调整",+ "tax_included": "税(含)",+ "tax_additional": "税(额外)",+ "payment_total": "支付总额",+ "outstanding_balance": "未结余额"+ },+ "gift_card_section": {+ "title": "礼品卡和店铺积分",+ "gift_card_label": "礼品卡",+ "store_credit_label": "店铺积分",+ "none_applied": "未应用",+ "applied_suffix": "已应用",+ "apply_balance": "应用客户的可用余额",+ "requires_customer": "需要客户",+ "apply_dialog_title": "应用礼品卡",+ "apply_dialog_description": "输入要应用到此订单的礼品卡代码。"+ },+ "address_edit": {+ "shipping_title": "编辑收货地址",+ "billing_title": "编辑账单地址"+ },+ "no_customer": "无客户信息",+ "section_customer_note": "特别说明",+ "section_internal_note": "内部备注",+ "completed_prefix": "已完成",+ "add_line_item": {+ "title": "添加订单项"+ },+ "no_line_items": "无订单项"+ }+ },+ "products": {+ "save_label": "保存产品",+ "delete_label": "删除产品",+ "delete_confirm": "确定要删除此产品吗?",+ "category_search_placeholder": "搜索分类…",+ "no_categories_found": "未找到分类",+ "media": {+ "delete_confirm": "删除此媒体?此操作无法撤销。",+ "drop_hint": "将媒体拖放到此处,或点击浏览",+ "file_types_hint": "PNG、JPG、WebP,最大 10MB",+ "edit_title": "编辑媒体",+ "assigned_variants_label": "关联的变体",+ "assigned_variants_help": "选择此图片所代表的变体。留空则应用于所有变体。",+ "upload_failed": "上传 {{name}} 失败:{{message}}",+ "upload_status_failed": "失败"+ },+ "seo": {+ "slug_placeholder": "product-url-handle",+ "meta_title_placeholder": "SEO 标题",+ "meta_description_placeholder": "SEO 描述"+ },+ "tax_category_placeholder": "选择税务类别",+ "transfers": {+ "new_cta": "新建调拨",+ "create_description": "在不同地点之间调拨库存,或从外部供应商接收新库存。",+ "external_label": "外部(供应商接收)",+ "destination_placeholder": "选择目标地点",+ "different_locations_error": "来源地点和目标地点必须不同。",+ "reference_label": "参考编号",+ "reference_placeholder": "采购订单号、供应商发票…",+ "search_items_placeholder": "按名称或 SKU 搜索(3 个以上字符)…",+ "items_table": {+ "variant": "变体",+ "sku": "SKU",+ "qty": "数量"+ },+ "delete_confirm": {+ "title": "删除此调拨?",+ "message": "此调拨创建的库存变动将被撤销。"+ },+ "review_description": "创建前请检查此调拨。创建后将无法更改商品项。",+ "details_card": "详情",+ "fields": {+ "type": "类型",+ "internal": "内部",+ "external_receive": "外部接收",+ "reference": "参考编号",+ "created": "创建时间",+ "immutable_note": "库存调拨一经创建即不可更改。"+ }+ },+ "options": {+ "kinds": {+ "dropdown": "下拉菜单",+ "color_swatch": "颜色色板",+ "buttons": "按钮"+ },+ "add_cta": "添加选项类型",+ "create_label": "创建选项类型",+ "create_description": "定义变体可使用的选项(例如尺寸、颜色)。",+ "edit_description": "编辑选项类型及其值。",+ "delete_confirm": {+ "title": "删除选项类型?",+ "message": "此操作还将删除其所有值。使用这些值的变体将失去这些值。"+ },+ "values_help": "拖动值以重新排序。第一个值是新变体的默认值。",+ "count_one": "{{count}} 个值",+ "count_other": "{{count}} 个值",+ "value_name_placeholder": "例如 small",+ "value_label_placeholder": "例如 Small",+ "image_upload_failed": "图片上传失败"+ },+ "variants": {+ "title": "变体",+ "default_variant": "默认变体",+ "variant_label": "变体",+ "add_option": "添加选项",+ "create_option_type": "新建选项类型",+ "create_option_type_title": "新选项类型",+ "create_value": "新值",+ "create_value_title": "新选项值",+ "option_type_label": "选项类型",+ "option_type_placeholder": "请选择选项类型",+ "edit_variant": "编辑变体 — {{name}}",+ "edit_row_aria": "编辑 {{name}}",+ "remove_row_aria": "移除 {{name}}",+ "orphan_warning_one": "有 {{count}} 个现有变体不再与所选选项匹配,将在保存时被移除:",+ "orphan_warning_other": "有 {{count}} 个现有变体不再与所选选项匹配,将在保存时被移除:",+ "orphan_warning": "有 {{count}} 个现有变体将在保存时被移除:",+ "keep": "全部保留",+ "sheet": {+ "identity": "标识",+ "tax_category_placeholder": "继承自商品"+ }+ },+ "inventory": {+ "columns": {+ "location": "库存地点",+ "on_hand": "现有库存",+ "backorder": "延期交货"+ },+ "on_hand_aria": "{{location}} 的现有库存",+ "backorder_aria": "允许在 {{location}} 延期交货",+ "empty_no_locations": "在「设置」中添加库存地点以开始跟踪库存。",+ "empty_no_variants": "库存水平按库存地点管理。添加一个变体以开始跟踪库存。"+ },+ "custom_fields": {+ "empty_title": "暂无自定义字段",+ "empty_description": "在设置中定义自定义字段,即可开始为商品记录结构化信息。",+ "empty_cta": "配置自定义字段"+ },+ "columns": {+ "sku": "SKU",+ "price": "价格",+ "in_stock": "库存"+ },+ "price_lists": {+ "messages": {+ "created": "价目表已创建",+ "updated": "价目表已更新",+ "deleted": "价目表已删除",+ "activated": "价目表已启用",+ "deactivated": "价目表已停用"+ },+ "errors": {+ "failed_to_activate": "启用价目表失败",+ "failed_to_deactivate": "停用价目表失败"+ }+ }+ },+ "payment_methods": {+ "add_cta": "添加支付方式",+ "create_description": "选择服务商并配置其凭据。",+ "edit_description": "更新名称、可见性或状态。",+ "create_label": "创建支付方式",+ "provider_description": "服务商:{{provider}}",+ "delete_confirm": {+ "title": "删除支付方式?",+ "message": "{{name}} 将不再在结账时可用。"+ },+ "title": "支付方式",+ "search_placeholder": "按名称搜索…",+ "empty": "尚未配置支付方式",+ "columns": {+ "storefront": "店面"+ },+ "storefront": {+ "visible": "可见",+ "admin_only": "仅管理员"+ },+ "status": {+ "disabled": "已禁用"+ },+ "messages": {+ "created": "支付方式已创建",+ "updated": "支付方式已更新",+ "deleted": "支付方式已删除"+ }+ },+ "tax_categories": {+ "add_cta": "添加税务类别",+ "create_description": "按税务处理方式对商品进行分组(标准、减免、免税等)。",+ "edit_description": "更新名称、代码或默认标志。",+ "create_label": "创建税务类别",+ "search_placeholder": "按名称搜索…",+ "empty": "暂无税务类别",+ "delete_confirm": {+ "title": "删除税务类别?",+ "message": "将移除 {{name}}。此类别中的商品将回退到默认类别。"+ },+ "messages": {+ "created": "税务类别已创建",+ "updated": "税务类别已更新",+ "deleted": "税务类别已删除"+ }+ },+ "custom_field_definitions": {+ "add_cta": "添加自定义字段",+ "create_label": "创建自定义字段",+ "create_description": "定义一个有类型的字段,您的团队可以在任何匹配的记录上填写。",+ "edit_description": "更新标签、键或店面可见性。一旦存在值,所有者将无法更改。",+ "table_title": "自定义字段定义",+ "search_placeholder": "按标签、命名空间或键搜索…",+ "empty": "暂无自定义字段定义",+ "storefront_visible": {+ "visible": "可见",+ "admin_only": "仅管理员"+ },+ "delete_confirm": {+ "title": "删除自定义字段?",+ "message": "{{label}} 及为其存储的所有值都将被移除。"+ }+ },+ "allowed_origins": {+ "add_cta": "添加允许的来源",+ "create_label": "添加来源",+ "create_description": "从该来源加载的浏览器可以调用管理 API。CORS 允许列表和管理后台 Cookie 会话都依赖此列表——请保持精简。",+ "edit_description": "更新来源会立即改变哪些浏览器可以调用管理 API。",+ "table_title": "允许的来源",+ "search_placeholder": "按来源搜索…",+ "empty": "暂无允许的来源",+ "validation": {+ "bare_origin": "必须是纯来源(例如 https://shop.example.com)——不含路径、查询或片段"+ },+ "delete_confirm": {+ "title": "移除允许的来源?",+ "message": "{{origin}} 将无法再从浏览器调用管理 API。现有的服务器对服务器请求不受影响。"+ },+ "messages": {+ "added": "已添加允许的来源",+ "updated": "已更新允许的来源",+ "removed": "已移除允许的来源"+ }+ },+ "stock_transfers": {+ "title": "库存调拨",+ "table": {+ "search_placeholder": "按编号或参考信息搜索…",+ "empty": "暂无库存调拨"+ },+ "columns": {+ "number": "编号",+ "direction": "方向",+ "reference": "参考信息"+ },+ "direction": {+ "internal": "在库存地点之间调拨",+ "external_receive": "外部收货"+ },+ "messages": {+ "recorded": "库存调拨已记录",+ "deleted": "库存调拨已删除"+ },+ "errors": {+ "failed_to_record": "记录库存调拨失败",+ "failed_to_delete": "删除库存调拨失败"+ }+ },+ "stock_locations": {+ "add_cta": "添加库存地点",+ "create_label": "创建库存地点",+ "create_description": "添加仓库、门店或自提点,用于履行订单。",+ "edit_description": "更新名称、地址、自提或库存策略。",+ "search_placeholder": "按名称搜索…",+ "empty": "暂无库存地点",+ "columns": {+ "type": "类型",+ "location": "地点",+ "pickup": "自提",+ "default": "默认"+ },+ "badges": {+ "enabled": "已启用",+ "inactive": "未激活",+ "default": "默认"+ },+ "kinds": {+ "warehouse": "仓库",+ "store": "门店",+ "fulfillment_center": "履约中心"+ },+ "pickup_stock_policies": {+ "local": "仅限此地点的商品",+ "any": "允许从其他地点调拨"+ },+ "delete_confirm": {+ "title": "删除库存地点?",+ "message": "{{name}} 将被移除。此地点的库存项不会被删除。"+ },+ "section_pickup": "自提",+ "stock_items": {+ "title": "此地点的库存",+ "help": "按变体调整在库数量和可缺货预订数量。",+ "search_placeholder": "搜索 SKU 或商品…",+ "table": {+ "variant": "变体",+ "on_hand": "在库",+ "backorder": "缺货预订"+ },+ "empty": "此地点暂无库存项。",+ "empty_search": "没有与搜索匹配的库存项。"+ }+ },+ "store": {+ "load_failed_title": "加载店铺设置失败",+ "unit_systems": {+ "metric": "公制",+ "imperial": "英制"+ },+ "weight_units": {+ "kg": "千克 (kg)",+ "g": "克 (g)",+ "lb": "磅 (lb)",+ "oz": "盎司 (oz)"+ }+ },+ "calculators": {+ "flat_percent_item_total": "固定百分比",+ "flat_rate": "固定费率",+ "flexi_rate": "弹性费率",+ "per_item": "按件计费",+ "percent_on_line_item": "按订单项百分比",+ "price_sack": "价格袋",+ "tiered_flat_rate": "阶梯固定费率",+ "tiered_percent": "阶梯百分比",+ "default_tax": "默认税费",+ "digital_delivery": "数字交付",+ "default_refund_amount": "默认退款金额"+ },+ "preferences": {+ "amount": "金额",+ "flat_percent": "固定百分比",+ "percent": "百分比",+ "first_item": "首件费用",+ "additional_item": "附加件费用",+ "max_items": "最大件数",+ "minimal_amount": "最小金额",+ "normal_amount": "标准金额",+ "discount_amount": "折扣金额",+ "currency": "货币",+ "base_amount": "基础金额",+ "base_percent": "基础百分比",+ "preferred_amount": "金额",+ "preferred_percent": "百分比"+ },+ "channels": {+ "messages": {+ "created": "渠道已创建",+ "updated": "渠道已更新",+ "deleted": "渠道已删除"+ }+ },+ "customer_groups": {+ "messages": {+ "created": "客户组已创建",+ "create_failed": "创建客户组失败",+ "updated": "客户组已更新",+ "update_failed": "更新客户组失败",+ "deleted": "客户组已删除",+ "delete_failed": "删除客户组失败"+ },+ "autocomplete": {+ "placeholder": "搜索客户组…",+ "empty": "没有匹配的客户组"+ }+ },+ "settings": {+ "webhooks": {+ "messages": {+ "updated": "Webhook 端点已更新",+ "removed": "Webhook 端点已移除"+ },+ "errors": {+ "send_test_failed": "发送测试 Webhook 失败",+ "redeliver_failed": "重新投递失败"+ }+ }+ },+ "stock_items": {+ "messages": {+ "stock_updated": "库存已更新",+ "stock_item_deleted": "库存项已删除"+ }+ }+ }+}diff --git a/packages/dashboard/src/routeTree.gen.ts b/packages/dashboard/src/routeTree.gen.tsindex 46655cc80b..a8b9b242c5 100644--- a/packages/dashboard/src/routeTree.gen.ts+++ b/packages/dashboard/src/routeTree.gen.ts@@ -25,6 +25,7 @@ import { Route as AuthenticatedStoreIdSettingsTaxCategoriesRouteImport } from '.import { Route as AuthenticatedStoreIdSettingsStoreRouteImport } from './routes/_authenticated/$storeId/settings/store'import { Route as AuthenticatedStoreIdSettingsStockLocationsRouteImport } from './routes/_authenticated/$storeId/settings/stock-locations'import { Route as AuthenticatedStoreIdSettingsStaffRouteImport } from './routes/_authenticated/$storeId/settings/staff'+import { Route as AuthenticatedStoreIdSettingsProfileRouteImport } from './routes/_authenticated/$storeId/settings/profile'import { Route as AuthenticatedStoreIdSettingsPaymentMethodsRouteImport } from './routes/_authenticated/$storeId/settings/payment-methods'import { Route as AuthenticatedStoreIdSettingsMarketsRouteImport } from './routes/_authenticated/$storeId/settings/markets'import { Route as AuthenticatedStoreIdSettingsEmailsRouteImport } from './routes/_authenticated/$storeId/settings/emails'@@ -141,6 +142,12 @@ const AuthenticatedStoreIdSettingsStaffRoute =path: '/staff',getParentRoute: () => AuthenticatedStoreIdSettingsRoute,} as any)+const AuthenticatedStoreIdSettingsProfileRoute =+ AuthenticatedStoreIdSettingsProfileRouteImport.update({+ id: '/profile',+ path: '/profile',+ getParentRoute: () => AuthenticatedStoreIdSettingsRoute,+ } as any)const AuthenticatedStoreIdSettingsPaymentMethodsRoute =AuthenticatedStoreIdSettingsPaymentMethodsRouteImport.update({id: '/payment-methods',@@ -312,6 +319,7 @@ export interface FileRoutesByFullPath {'/$storeId/settings/emails': typeof AuthenticatedStoreIdSettingsEmailsRoute'/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute'/$storeId/settings/payment-methods': typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute+ '/$storeId/settings/profile': typeof AuthenticatedStoreIdSettingsProfileRoute'/$storeId/settings/staff': typeof AuthenticatedStoreIdSettingsStaffRoute'/$storeId/settings/stock-locations': typeof AuthenticatedStoreIdSettingsStockLocationsRoute'/$storeId/settings/store': typeof AuthenticatedStoreIdSettingsStoreRoute@@ -351,6 +359,7 @@ export interface FileRoutesByTo {'/$storeId/settings/emails': typeof AuthenticatedStoreIdSettingsEmailsRoute'/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute'/$storeId/settings/payment-methods': typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute+ '/$storeId/settings/profile': typeof AuthenticatedStoreIdSettingsProfileRoute'/$storeId/settings/staff': typeof AuthenticatedStoreIdSettingsStaffRoute'/$storeId/settings/stock-locations': typeof AuthenticatedStoreIdSettingsStockLocationsRoute'/$storeId/settings/store': typeof AuthenticatedStoreIdSettingsStoreRoute@@ -394,6 +403,7 @@ export interface FileRoutesById {'/_authenticated/$storeId/settings/emails': typeof AuthenticatedStoreIdSettingsEmailsRoute'/_authenticated/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute'/_authenticated/$storeId/settings/payment-methods': typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute+ '/_authenticated/$storeId/settings/profile': typeof AuthenticatedStoreIdSettingsProfileRoute'/_authenticated/$storeId/settings/staff': typeof AuthenticatedStoreIdSettingsStaffRoute'/_authenticated/$storeId/settings/stock-locations': typeof AuthenticatedStoreIdSettingsStockLocationsRoute'/_authenticated/$storeId/settings/store': typeof AuthenticatedStoreIdSettingsStoreRoute@@ -437,6 +447,7 @@ export interface FileRouteTypes {| '/$storeId/settings/emails'| '/$storeId/settings/markets'| '/$storeId/settings/payment-methods'+ | '/$storeId/settings/profile'| '/$storeId/settings/staff'| '/$storeId/settings/stock-locations'| '/$storeId/settings/store'@@ -476,6 +487,7 @@ export interface FileRouteTypes {| '/$storeId/settings/emails'| '/$storeId/settings/markets'| '/$storeId/settings/payment-methods'+ | '/$storeId/settings/profile'| '/$storeId/settings/staff'| '/$storeId/settings/stock-locations'| '/$storeId/settings/store'@@ -518,6 +530,7 @@ export interface FileRouteTypes {| '/_authenticated/$storeId/settings/emails'| '/_authenticated/$storeId/settings/markets'| '/_authenticated/$storeId/settings/payment-methods'+ | '/_authenticated/$storeId/settings/profile'| '/_authenticated/$storeId/settings/staff'| '/_authenticated/$storeId/settings/stock-locations'| '/_authenticated/$storeId/settings/store'@@ -654,6 +667,13 @@ declare module '@tanstack/react-router' {preLoaderRoute: typeof AuthenticatedStoreIdSettingsStaffRouteImportparentRoute: typeof AuthenticatedStoreIdSettingsRoute}+ '/_authenticated/$storeId/settings/profile': {+ id: '/_authenticated/$storeId/settings/profile'+ path: '/profile'+ fullPath: '/$storeId/settings/profile'+ preLoaderRoute: typeof AuthenticatedStoreIdSettingsProfileRouteImport+ parentRoute: typeof AuthenticatedStoreIdSettingsRoute+ }'/_authenticated/$storeId/settings/payment-methods': {id: '/_authenticated/$storeId/settings/payment-methods'path: '/payment-methods'@@ -833,6 +853,7 @@ interface AuthenticatedStoreIdSettingsRouteChildren {AuthenticatedStoreIdSettingsEmailsRoute: typeof AuthenticatedStoreIdSettingsEmailsRouteAuthenticatedStoreIdSettingsMarketsRoute: typeof AuthenticatedStoreIdSettingsMarketsRouteAuthenticatedStoreIdSettingsPaymentMethodsRoute: typeof AuthenticatedStoreIdSettingsPaymentMethodsRoute+ AuthenticatedStoreIdSettingsProfileRoute: typeof AuthenticatedStoreIdSettingsProfileRouteAuthenticatedStoreIdSettingsStaffRoute: typeof AuthenticatedStoreIdSettingsStaffRouteAuthenticatedStoreIdSettingsStockLocationsRoute: typeof AuthenticatedStoreIdSettingsStockLocationsRouteAuthenticatedStoreIdSettingsStoreRoute: typeof AuthenticatedStoreIdSettingsStoreRoute@@ -858,6 +879,8 @@ const AuthenticatedStoreIdSettingsRouteChildren: AuthenticatedStoreIdSettingsRouAuthenticatedStoreIdSettingsMarketsRoute,AuthenticatedStoreIdSettingsPaymentMethodsRoute:AuthenticatedStoreIdSettingsPaymentMethodsRoute,+ AuthenticatedStoreIdSettingsProfileRoute:+ AuthenticatedStoreIdSettingsProfileRoute,AuthenticatedStoreIdSettingsStaffRoute:AuthenticatedStoreIdSettingsStaffRoute,AuthenticatedStoreIdSettingsStockLocationsRoute:diff --git a/packages/dashboard/src/routes/_authenticated/$storeId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId.tsxindex 5ef51b2d84..7855c9c72e 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId.tsx@@ -10,6 +10,10 @@ import { SidebarInset, SidebarProvider } from '@spree/dashboard-ui'import { createFileRoute, Outlet, useRouterState } from '@tanstack/react-router'import { useEffect } from 'react'import { CommandPalette } from '@/components/spree/command-palette/command-palette'+import { getAvailableUiLocales } from '@/i18n-setup'++// Derived once from the shipped locale bundles — stable for the app lifetime.+const UI_LOCALES = getAvailableUiLocales()export const Route = createFileRoute('/_authenticated/$storeId')({component: StoreLayout,@@ -35,7 +39,7 @@ function StoreLayout() {<SidebarInset className="flex-row"><SettingsSidebar open={inSettings} /><div className="flex min-w-0 flex-1 flex-col">- <TopBar />+ <TopBar uiLocales={UI_LOCALES} />{inSettings ? (<Outlet />) : (diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsxindex 06736e874a..58142e328f 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx@@ -183,7 +183,12 @@ function CustomerBody({ customer }: { customer: Customer }) {ownerId={customer.id}resourceLabel="customers"/>- <MetadataCard metadata={customer.metadata} />+ <MetadataCard+ metadata={customer.metadata}+ title={t('admin.components.metadata_card.title')}+ emptyTitle={t('admin.components.metadata_card.empty_title')}+ emptyDescription={t('admin.components.metadata_card.empty_description')}+ /></>}sidebar={@@ -579,11 +584,9 @@ function OrdersCard({<th className="px-6 py-2 font-normal">{t('admin.customers.detail.orders_table.date')}</th>- <th className="px-6 py-2 font-normal">- {t('admin.customers.detail.orders_table.status')}- </th>+ <th className="px-6 py-2 font-normal">{t('admin.fields.status.label')}</th><th className="px-6 py-2 font-normal text-right">- {t('admin.customers.detail.orders_table.total')}+ {t('admin.fields.total.label')}</th></tr></thead>@@ -942,9 +945,7 @@ function StoreCreditsCard({ customer }: { customer: Customer }) {<table className="w-full text-sm"><thead><tr className="border-b text-muted-foreground text-left">- <th className="px-6 py-2 font-normal">- {t('admin.customers.detail.store_credit.table.amount')}- </th>+ <th className="px-6 py-2 font-normal">{t('admin.fields.amount.label')}</th><th className="px-6 py-2 font-normal">{t('admin.customers.detail.store_credit.table.used')}</th>diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/index.tsxindex 61318b0612..7a4b9c2d06 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/index.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/index.tsx@@ -28,25 +28,10 @@ export const Route = createFileRoute('/_authenticated/$storeId/')({type ChartMetric = 'sales' | 'orders' | 'avg_order_value'-const chartTabs: Array<{ key: ChartMetric; label: string }> = [- { key: 'sales', label: 'Total Sales' },- { key: 'orders', label: 'Total Orders' },- { key: 'avg_order_value', label: 'Avg Order Value' },-]--const chartConfigs: Record<ChartMetric, ChartConfig> = {- sales: {- sales: { label: 'Sales', color: 'var(--chart-2)' },- },- orders: {- orders: { label: 'Orders', color: 'var(--chart-2)' },- },- avg_order_value: {- avg_order_value: { label: 'AOV', color: 'var(--chart-2)' },- },-}+const CHART_METRICS: ChartMetric[] = ['sales', 'orders', 'avg_order_value']function DashboardPage() {+ const { t } = useTranslation()const [dateRange, setDateRange] = useState<DateRange>({from: subDays(new Date(), 30),to: new Date(),@@ -71,8 +56,8 @@ function DashboardPage() {<div className="flex flex-col gap-6"><div className="flex items-center justify-between"><div>- <h1 className="text-2xl font-bold">Dashboard</h1>- <p className="text-muted-foreground">Overview of your store performance</p>+ <h1 className="text-2xl font-bold">{t('admin.pages.home.title')}</h1>+ <p className="text-muted-foreground">{t('admin.pages.home.subtitle')}</p></div><DateRangePicker value={dateRange} onChange={setDateRange} /></div>@@ -83,6 +68,8 @@ function DashboardPage() {}function AnalyticsChart({ data }: { data: DashboardAnalytics }) {+ const { t, i18n } = useTranslation()+ const locale = i18n.languageconst [activeMetric, setActiveMetric] = useState<ChartMetric>('sales')const summaryValues: Record<ChartMetric, string> = {@@ -91,31 +78,37 @@ function AnalyticsChart({ data }: { data: DashboardAnalytics }) {avg_order_value: data.summary.display_avg_order_value,}+ const chartConfig: ChartConfig = {+ [activeMetric]: {+ label: t(`admin.pages.home.metric_short.${activeMetric}`),+ color: 'var(--chart-2)',+ },+ }+return (<Card><CardHeader className="flex h-auto flex-col border-b p-0 sm:flex-row gap-0">- {chartTabs.map((tab) => (+ {CHART_METRICS.map((metric) => (<button- key={tab.key}+ key={metric}type="button"- onClick={() => setActiveMetric(tab.key)}+ onClick={() => setActiveMetric(metric)}className={`relative flex flex-1 flex-col justify-center gap-1 px-6 py-4 text-left ${- activeMetric === tab.key ? 'bg-muted/50' : 'hover:bg-muted/25'+ activeMetric === metric ? 'bg-muted/50' : 'hover:bg-muted/25'} sm:border-l sm:first:border-l-0`}>- <span className="text-xs text-muted-foreground">{tab.label}</span>- <span className="text-lg font-bold leading-none">{summaryValues[tab.key]}</span>- {activeMetric === tab.key && (+ <span className="text-xs text-muted-foreground">+ {t(`admin.pages.home.metrics.${metric}`)}+ </span>+ <span className="text-lg font-bold leading-none">{summaryValues[metric]}</span>+ {activeMetric === metric && (<span className="absolute inset-x-0 bottom-0 h-0.5 bg-primary" />)}</button>))}</CardHeader><CardContent className="px-2 pt-4 sm:px-6 sm:pt-6">- <ChartContainer- config={chartConfigs[activeMetric]}- className="aspect-auto h-[250px] w-full"- >+ <ChartContainer config={chartConfig} className="aspect-auto h-[250px] w-full"><BarChart data={data.chart_data}><CartesianGrid vertical={false} /><XAxis@@ -126,7 +119,7 @@ function AnalyticsChart({ data }: { data: DashboardAnalytics }) {minTickGap={32}tickFormatter={(value: string) => {const date = new Date(value)- return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })+ return date.toLocaleDateString(locale, { month: 'short', day: 'numeric' })}}/><ChartTooltip@@ -134,7 +127,7 @@ function AnalyticsChart({ data }: { data: DashboardAnalytics }) {content={<ChartTooltipContentlabelFormatter={(value: string) => {- return new Date(value).toLocaleDateString('en-US', {+ return new Date(value).toLocaleDateString(locale, {month: 'short',day: 'numeric',year: 'numeric',@@ -173,10 +166,14 @@ function TopProducts({ products }: { products: DashboardAnalytics['top_products'<table className="w-full text-sm"><thead><tr className="border-b text-left text-muted-foreground">- <th className="px-4 py-2 font-medium">Product</th>- <th className="px-4 py-2 text-right font-medium">Price</th>- <th className="px-4 py-2 text-right font-medium">Sold</th>- <th className="px-4 py-2 text-right font-medium">Total</th>+ <th className="px-4 py-2 font-medium">{t('admin.pages.home.columns.product')}</th>+ <th className="px-4 py-2 text-right font-medium">+ {t('admin.pages.home.columns.price')}+ </th>+ <th className="px-4 py-2 text-right font-medium">+ {t('admin.pages.home.columns.sold')}+ </th>+ <th className="px-4 py-2 text-right font-medium">{t('admin.fields.total.label')}</th></tr></thead><tbody>@@ -220,11 +217,12 @@ function TopProducts({ products }: { products: DashboardAnalytics['top_products'}function DashboardSkeleton() {+ const { t } = useTranslation()return (<div className="flex flex-col gap-6"><div>- <h1 className="text-2xl font-bold">Dashboard</h1>- <p className="text-muted-foreground">Overview of your store performance</p>+ <h1 className="text-2xl font-bold">{t('admin.pages.home.title')}</h1>+ <p className="text-muted-foreground">{t('admin.pages.home.subtitle')}</p></div><Card><CardHeader className="flex h-auto flex-col border-b p-0 sm:flex-row">diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsxindex 7b9dd80514..7b3a5db377 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx@@ -61,6 +61,7 @@ import {} from '@spree/dashboard-ui'import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'import { createFileRoute } from '@tanstack/react-router'+import i18n from 'i18next'import {CheckCircleIcon,CreditCardIcon,@@ -94,7 +95,7 @@ export const Route = createFileRoute('/_authenticated/$storeId/orders/$orderId')function formatDate(iso: string | null) {if (!iso) return '—'- return new Date(iso).toLocaleDateString('en-US', {+ return new Date(iso).toLocaleDateString(i18n.language, {month: 'short',day: 'numeric',year: 'numeric',@@ -134,7 +135,12 @@ function OrderDetailPage() {<PaymentsCard order={order} /><OrderSummaryCard order={order} /><CustomFieldsCard ownerType="Spree::Order" ownerId={order.id} resourceLabel="orders" />- <MetadataCard metadata={order.metadata} />+ <MetadataCard+ metadata={order.metadata}+ title={t('admin.components.metadata_card.title')}+ emptyTitle={t('admin.components.metadata_card.empty_title')}+ emptyDescription={t('admin.components.metadata_card.empty_description')}+ /></>}sidebar={@@ -199,7 +205,7 @@ function OrderHeader({ order }: { order: Order }) {)const subtitle = order.completed_at ? (- <RelativeTime iso={order.completed_at} prefix="Completed" />+ <RelativeTime iso={order.completed_at} prefix={t('admin.orders.detail.completed_prefix')} />) : undefinedconst dropdownItems = (@@ -210,7 +216,7 @@ function OrderHeader({ order }: { order: Order }) {if (await confirm({message: t('admin.orders.detail.confirm.complete_message'),- confirmLabel: 'Complete',+ confirmLabel: t('admin.orders.detail.dropdown.complete_order'),})) {completeMutation.mutate(undefined)@@ -368,7 +374,7 @@ function AddLineItemDialog({<Sheet open={open} onOpenChange={(o) => onOpenChange(o as boolean)}><SheetContent side="right"><SheetHeader>- <SheetTitle>Add Line Item</SheetTitle>+ <SheetTitle>{t('admin.orders.detail.add_line_item.title')}</SheetTitle><SheetDescription>{t('admin.orders.detail.variant_search.description')}</SheetDescription></SheetHeader><form onSubmit={handleSubmit} className="flex flex-col flex-1 overflow-hidden">@@ -377,7 +383,7 @@ function AddLineItemDialog({<Field><FieldLabel>{t('admin.orders.detail.variant_search.label')}</FieldLabel><Input- placeholder="Type product name or SKU (min 3 chars)..."+ placeholder={t('admin.orders.detail.variant_search.placeholder')}value={search}onChange={(e) => {setSearch(e.target.value)@@ -444,7 +450,7 @@ function AddLineItemDialog({)}<Field>- <FieldLabel htmlFor="quantity">Quantity</FieldLabel>+ <FieldLabel htmlFor="quantity">{t('admin.fields.quantity.label')}</FieldLabel><Inputid="quantity"type="number"@@ -509,7 +515,7 @@ function EditQuantityDialog({<DialogBody><FieldGroup><Field>- <FieldLabel htmlFor="edit-quantity">Quantity</FieldLabel>+ <FieldLabel htmlFor="edit-quantity">{t('admin.fields.quantity.label')}</FieldLabel><Inputid="edit-quantity"name="quantity"@@ -577,15 +583,9 @@ function LineItemsCard({ order }: { order: Order }) {<th className="p-3 text-right font-normal">{t('admin.orders.detail.items_table.qty')}</th>- <th className="p-3 text-right font-normal">- {t('admin.orders.detail.items_table.tax')}- </th>- <th className="p-3 text-right font-normal">- {t('admin.orders.detail.items_table.discount')}- </th>- <th className="p-3 text-right font-normal">- {t('admin.orders.detail.items_table.total')}- </th>+ <th className="p-3 text-right font-normal">{t('admin.fields.tax.label')}</th>+ <th className="p-3 text-right font-normal">{t('admin.fields.discount.label')}</th>+ <th className="p-3 text-right font-normal">{t('admin.fields.total.label')}</th><th className="p-3 pr-5 w-10" /></tr></thead>@@ -670,7 +670,9 @@ function LineItemsCard({ order }: { order: Order }) {</div>) : (<CardContent>- <p className="text-center text-muted-foreground py-8">No line items</p>+ <p className="text-center text-muted-foreground py-8">+ {t('admin.orders.detail.no_line_items')}+ </p></CardContent>)}</Card>@@ -725,7 +727,7 @@ function EditTrackingDialog({<Dialog open={open} onOpenChange={onOpenChange}><DialogContent><DialogHeader>- <DialogTitle>Edit Tracking</DialogTitle>+ <DialogTitle>{t('admin.orders.detail.tracking.edit_title')}</DialogTitle><DialogDescription>{t('admin.orders.detail.tracking.description')}</DialogDescription></DialogHeader><form onSubmit={handleSubmit}>@@ -807,7 +809,9 @@ function ShipmentsCard({ order }: { order: Order }) {}><PencilIcon className="size-4" />- {fulfillment.tracking ? 'Edit Tracking' : 'Add Tracking'}+ {fulfillment.tracking+ ? t('admin.orders.detail.tracking.edit_title')+ : t('admin.orders.detail.tracking.add_title')}</DropdownMenuItem>{fulfillment.status === 'ready' && (<DropdownMenuItem@@ -969,9 +973,7 @@ function PaymentsCard({ order }: { order: Order }) {<th className="p-3 text-left font-normal">{t('admin.orders.detail.payments_table.state')}</th>- <th className="p-3 text-right font-normal">- {t('admin.orders.detail.payments_table.amount')}- </th>+ <th className="p-3 text-right font-normal">{t('admin.fields.amount.label')}</th><th className="p-3 pr-5 w-10" /></tr></thead>@@ -1143,7 +1145,7 @@ function AddPaymentDialog({<Dialog open={open} onOpenChange={onOpenChange}><DialogContent><DialogHeader>- <DialogTitle>Add Payment</DialogTitle>+ <DialogTitle>{t('admin.orders.detail.payment_form.title')}</DialogTitle><DialogDescription>{t('admin.orders.detail.payment_form.description')}</DialogDescription></DialogHeader><form onSubmit={handleSubmit}>@@ -1187,22 +1189,23 @@ function AddPaymentDialog({</FieldLabel>{!customerId ? (<p className="text-sm text-destructive">- This payment method requires a saved source. Assign a customer to the order- first.+ {t('admin.orders.detail.payment_form.source_requires_customer')}</p>) : savedCards.length === 0 ? (<p className="text-sm text-muted-foreground">- Customer has no saved cards for this payment method.+ {t('admin.orders.detail.payment_form.no_saved_cards')}</p>) : (<Select value={sourceId} onValueChange={setSourceId}><SelectTrigger id="pay-source">- <SelectValue placeholder="Choose a saved card…">+ <SelectValue+ placeholder={t('admin.orders.detail.payment_form.source_placeholder')}+ >{(value) => {const card = savedCards.find((c) => c.id === value)return card? `${card.brand} •••• ${card.last4} (${card.month}/${card.year})`- : 'Choose a saved card…'+ : t('admin.orders.detail.payment_form.source_placeholder')}}</SelectValue></SelectTrigger>@@ -1219,7 +1222,7 @@ function AddPaymentDialog({)}<Field>- <FieldLabel htmlFor="pay-amount">Amount</FieldLabel>+ <FieldLabel htmlFor="pay-amount">{t('admin.fields.amount.label')}</FieldLabel><Inputid="pay-amount"type="number"@@ -1306,13 +1309,13 @@ function OrderSummaryCard({ order }: { order: Order }) {/>)}<SummaryRow- label={t('admin.pages.orders.detail.summary.created_at')}+ label={t('admin.fields.created_at.label')}value={formatDate(order.created_at)}/>{order.completed_at && (<SummaryRow- label={t('admin.pages.orders.detail.summary.completed_at')}+ label={t('admin.fields.completed_at.label')}value={formatDate(order.completed_at)}/>)}@@ -1358,10 +1361,7 @@ function OrderSummaryCard({ order }: { order: Order }) {label={t('admin.pages.orders.detail.summary.locale')}value={order.locale ?? '—'}/>- <SummaryRow- label={t('admin.pages.orders.detail.summary.currency')}- value={order.currency}- />+ <SummaryRow label={t('admin.fields.currency.label')} value={order.currency} /><Separator />@@ -1491,7 +1491,7 @@ function DiscountsCard({ order }: { order: Order }) {) : (<Button size="sm" variant="outline" onClick={() => setGiftCardOpen(true)}><PlusIcon className="size-4" />- {t('admin.orders.detail.gift_card_section.apply_button')}+ {t('admin.actions.apply')}</Button>)}</div>@@ -1543,7 +1543,7 @@ function DiscountsCard({ order }: { order: Order }) {onClick={() => applyStoreCreditMutation.mutate(undefined)}><PlusIcon className="size-4" />- {t('admin.orders.detail.gift_card_section.apply_button')}+ {t('admin.actions.apply')}</Button>)}</div>@@ -1590,7 +1590,7 @@ function ApplyGiftCardDialog({<DialogBody><FieldGroup><Field>- <FieldLabel htmlFor="gift-card-code">Code</FieldLabel>+ <FieldLabel htmlFor="gift-card-code">{t('admin.fields.code.label')}</FieldLabel><Inputid="gift-card-code"name="code"diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsxindex 7d2e2d297c..02e5c12260 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx@@ -334,7 +334,7 @@ function NewOrderPage() {<Card><CardHeader>- <CardTitle>{t('admin.orders.new.section_discount')}</CardTitle>+ <CardTitle>{t('admin.fields.discount.label')}</CardTitle></CardHeader><CardContent><FieldGroup>diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsxindex e34385f4e3..831107c808 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx@@ -398,7 +398,12 @@ function ProductForm({ product }: { product: Product }) {><CustomFieldsInlineCard /></ApiBackedCustomFieldsProvider>- <MetadataCard metadata={product.metadata} />+ <MetadataCard+ metadata={product.metadata}+ title={t('admin.components.metadata_card.title')}+ emptyTitle={t('admin.components.metadata_card.empty_title')}+ emptyDescription={t('admin.components.metadata_card.empty_description')}+ /></>}sidebar={diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsxindex 79dfde28fb..efdaaf4a1c 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx@@ -211,7 +211,7 @@ function ProductsPage() {const deleteAction: BulkAction<unknown> = {key: 'delete',- label: t('admin.pages.products.bulk.delete_action'),+ label: t('admin.actions.delete'),icon: <Trash2Icon className="size-4" />,subject: Subject.Product,action: 'destroy',@@ -362,9 +362,7 @@ function StatusPickerSheet({ onSubmit, onCancel }: BulkActionFormProps<StatusFor</SelectTrigger><SelectContent><SelectItem value="draft">{t('admin.pages.products.status_options.draft')}</SelectItem>- <SelectItem value="active">- {t('admin.pages.products.status_options.active')}- </SelectItem>+ <SelectItem value="active">{t('admin.fields.active.label')}</SelectItem><SelectItem value="archived">{t('admin.pages.products.status_options.archived')}</SelectItem>diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsxindex 16bdb70cb0..427eaae7c8 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx@@ -726,7 +726,8 @@ function OptionValueImageField({})form.setValue(`option_values.${index}.image_cleared`, false, { shouldDirty: true })} catch (err) {- const message = err instanceof Error ? err.message : 'Upload failed'+ const message =+ err instanceof Error ? err.message : t('admin.products.options.image_upload_failed')toast.error(message)} finally {setUploading(false)@@ -801,7 +802,7 @@ function OptionValueImageField({<XIcon className="size-3" /></button></TooltipTrigger>- <TooltipContent>Remove image</TooltipContent>+ <TooltipContent>{t('admin.components.media.remove_tooltip')}</TooltipContent></Tooltip>)}{preview && (diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsxindex b000d0c0d9..844a99c00c 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx@@ -593,7 +593,7 @@ function GiftCardUsageSummary({ giftCard }: { giftCard: GiftCard }) {<div className="rounded-md border bg-muted/30 p-3 text-sm"><div className="mb-2 font-medium">{t('admin.pages.promotions.gift_cards.usage.title')}</div><div className="grid grid-cols-2 gap-1 text-muted-foreground">- <span>{t('admin.pages.promotions.gift_cards.usage.amount')}</span>+ <span>{t('admin.fields.amount.label')}</span><span className="text-right text-foreground tabular-nums">{giftCard.display_amount}</span><span>{t('admin.pages.promotions.gift_cards.usage.used')}</span><span className="text-right text-foreground tabular-nums">diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsxindex 5cdc052785..3e8add1c46 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx@@ -53,6 +53,7 @@ import {useCopyToClipboard,} from '@spree/dashboard-ui'import { createFileRoute } from '@tanstack/react-router'+import type { TFunction } from 'i18next'import {AlertTriangleIcon,BanIcon,@@ -228,13 +229,13 @@ function ApiKeyTable({<Table><TableHeader><TableRow>- <TableHead>{t('admin.pages.settings.api_keys.table.name')}</TableHead>+ <TableHead>{t('admin.fields.name.label')}</TableHead><TableHead>{t('admin.pages.settings.api_keys.table.key')}</TableHead>{showScopes && (<TableHead>{t('admin.pages.settings.api_keys.table.scopes')}</TableHead>)}<TableHead>{t('admin.pages.settings.api_keys.table.last_used_at')}</TableHead>- <TableHead>{t('admin.pages.settings.api_keys.table.created_at')}</TableHead>+ <TableHead>{t('admin.fields.created_at.label')}</TableHead><TableHead className="w-12" /></TableRow></TableHeader>@@ -419,7 +420,9 @@ function ScopeList({ scopes }: { scopes: string[] }) {<buttontype="button"className="cursor-pointer rounded-md focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"- aria-label={`Show ${overflow.length} more scope${overflow.length === 1 ? '' : 's'}`}+ aria-label={t('admin.api_keys.scope_picker.show_more_aria', {+ count: overflow.length,+ })}><Badge className="font-mono text-[10px] hover:bg-accent">+{overflow.length}</Badge></button>@@ -483,18 +486,19 @@ function FormErrorBanner({ message }: { message?: string }) {// Create dialog// ----------------------------------------------------------------------------const createSchema = z- .object({- name: z.string().min(1, 'Name is required'),- key_type: z.enum(['publishable', 'secret']),- scopes: z.array(z.string()),- })- .refine((v) => v.key_type !== 'secret' || v.scopes.length > 0, {- message: 'Pick at least one scope',- path: ['scopes'],- })+const buildCreateSchema = (t: TFunction) =>+ z+ .object({+ name: z.string().min(1, t('admin.fields.api_key.name.required')),+ key_type: z.enum(['publishable', 'secret']),+ scopes: z.array(z.string()),+ })+ .refine((v) => v.key_type !== 'secret' || v.scopes.length > 0, {+ message: t('admin.api_keys.validation.scope_required'),+ path: ['scopes'],+ })-type CreateFormValues = z.infer<typeof createSchema>+type CreateFormValues = z.infer<ReturnType<typeof buildCreateSchema>>// Create UX is a side Sheet (not a Dialog) because the scope grid makes the// form taller than most viewports — Sheet handles overflow with internal@@ -512,7 +516,7 @@ function CreateApiKeyDialog({const createMutation = useCreateApiKey()const form = useForm<CreateFormValues>({- resolver: zodResolver(createSchema),+ resolver: zodResolver(buildCreateSchema(t)),defaultValues: { name: '', key_type: 'secret', scopes: [] },})@@ -532,7 +536,7 @@ function CreateApiKeyDialog({} catch (err) {if (mapSpreeErrorsToForm(err, form.setError)) returnif (err instanceof SpreeError) throw err- toast.error(err instanceof Error ? err.message : 'Failed to create key')+ toast.error(err instanceof Error ? err.message : t('admin.api_keys.errors.failed_to_create'))}}@@ -606,10 +610,12 @@ function CreateApiKeyDialog({onClick={() => onOpenChange(false)}disabled={form.formState.isSubmitting}>- Cancel+ {t('admin.actions.cancel')}</Button><Button type="submit" size="sm" disabled={form.formState.isSubmitting}>- {form.formState.isSubmitting ? 'Creating…' : 'Create key'}+ {form.formState.isSubmitting+ ? t('admin.actions.creating')+ : t('admin.api_keys.create_key_cta')}</Button></SheetFooter></form>@@ -783,7 +789,9 @@ function ScopePicker({disabled={disabled}/><span className="font-medium">{t('admin.api_keys.scope_picker.full_access_label')}</span>- <span className="text-xs text-muted-foreground">— read + write on every resource</span>+ <span className="text-xs text-muted-foreground">+ {t('admin.api_keys.scope_picker.full_access_hint')}+ </span></label><label htmlFor="scope-read-all" className="flex cursor-pointer items-center gap-2 text-sm"><Checkbox@@ -793,7 +801,9 @@ function ScopePicker({disabled={disabled || hasWriteAll}/><span className="font-medium">{t('admin.api_keys.scope_picker.read_all_label')}</span>- <span className="text-xs text-muted-foreground">— read on every resource</span>+ <span className="text-xs text-muted-foreground">+ {t('admin.api_keys.scope_picker.read_all_hint')}+ </span></label></div>@@ -930,7 +940,7 @@ function TokenRevealDialog({</DialogBody><DialogFooter><Button size="sm" onClick={() => onOpenChange(false)}>- {t('admin.api_keys.done')}+ {t('admin.actions.done')}</Button></DialogFooter></DialogContent>diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsxnew file mode 100644index 0000000000..3d17b3e885--- /dev/null+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsx@@ -0,0 +1,250 @@+import { zodResolver } from '@hookform/resolvers/zod'+import { type MeResponse, SpreeError } from '@spree/admin-sdk'+import {+ i18n,+ mapSpreeErrorsToForm,+ PageHeader,+ switchLocale,+ useAuth,+} from '@spree/dashboard-core'+import {+ Card,+ CardContent,+ CardHeader,+ CardTitle,+ ErrorState,+ Field,+ FieldError,+ FieldGroup,+ FieldLabel,+ FormActions,+ Input,+ ResourceLayout,+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+ Skeleton,+ useFormSubmitShortcut,+} from '@spree/dashboard-ui'+import { createFileRoute } from '@tanstack/react-router'+import { useMemo } from 'react'+import {+ type Control,+ Controller,+ type FieldPath,+ type FieldValues,+ useForm,+} from 'react-hook-form'+import { useTranslation } from 'react-i18next'+import { toast } from 'sonner'+import { useProfile, useUpdateProfile } from '@/hooks/use-profile'+import { getAvailableUiLocales } from '@/i18n-setup'+import { type MeFormValues, meFormSchema } from '@/schemas/me'++export const Route = createFileRoute('/_authenticated/$storeId/settings/profile')({+ component: ProfilePage,+})++function meToFormValues(me: MeResponse): MeFormValues {+ return {+ first_name: me.user.first_name ?? '',+ last_name: me.user.last_name ?? '',+ selected_locale: me.user.selected_locale ?? '',+ }+}++function ProfilePage() {+ const { t } = useTranslation()+ const { data: me, isLoading, error, refetch } = useProfile()++ // Check error first: a failed fetch leaves `me` undefined, which would+ // otherwise render the skeleton forever instead of the error state.+ if (error) {+ return (+ <ErrorState+ title={t('admin.pages.profile.load_failed_title')}+ description={error instanceof Error ? error.message : undefined}+ onRetry={() => refetch()}+ />+ )+ }++ if (isLoading || !me) {+ return (+ <div className="flex flex-col gap-6">+ <Skeleton className="h-8 w-48" />+ <Skeleton className="h-64 w-full" />+ </div>+ )+ }++ // Mount the form only once `me` is loaded so `useForm` initializes with+ // concrete string defaults — keeps the inputs/Select controlled from the+ // first render.+ return <ProfileForm me={me} />+}++function ProfileForm({ me }: { me: MeResponse }) {+ const { t } = useTranslation()+ const { updateUser } = useAuth()+ const updateMutation = useUpdateProfile()++ const form = useForm<MeFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(meFormSchema) as any,+ defaultValues: meToFormValues(me),+ })++ const onSubmit = async (values: MeFormValues) => {+ try {+ const updated = await updateMutation.mutateAsync({+ first_name: values.first_name || undefined,+ last_name: values.last_name || undefined,+ selected_locale: values.selected_locale || undefined,+ })+ // Reflect the new name/locale in the auth context (top-bar, etc.)+ // immediately instead of waiting for the next token refresh.+ updateUser(updated.user)+ toast.success(t('admin.messages.profile_updated'))+ // Reset FIRST so the form is no longer dirty — otherwise the language+ // switch below reloads the page while the `beforeunload` dirty-guard is+ // still armed, triggering the browser's "unsaved changes" prompt.+ form.reset(values)+ // Apply a changed admin language by reloading in the new language.+ const code = values.selected_locale+ if (code && code !== i18n.language) switchLocale(code)+ } catch (err) {+ if (mapSpreeErrorsToForm(err, form.setError)) return+ if (err instanceof SpreeError) throw err+ toast.error(err instanceof Error ? err.message : t('admin.errors.failed_to_update_profile'))+ }+ }++ useFormSubmitShortcut(form, onSubmit)++ // Admin-UI language options come from the dashboard's own shipped locale+ // bundles (see getAvailableUiLocales) — NOT the backend. The picker is hidden+ // when fewer than two languages are installed (nothing to choose).+ const localeOptions = useMemo(+ () => getAvailableUiLocales().map((l) => ({ value: l.code, label: l.name })),+ [],+ )+ const showLanguagePicker = localeOptions.length >= 2++ const { errors } = form.formState++ return (+ <form onSubmit={form.handleSubmit(onSubmit)}>+ <ResourceLayout+ header={+ <PageHeader+ title={t('admin.pages.profile.title')}+ subtitle={t('admin.pages.profile.subtitle')}+ actions={<FormActions form={form} />}+ />+ }+ main={+ <>+ {errors.root?.message && (+ <p className="text-sm text-destructive" role="alert">+ {errors.root.message}+ </p>+ )}+ <Card>+ <CardHeader>+ <CardTitle>{t('admin.pages.profile.personal_details')}</CardTitle>+ </CardHeader>+ <CardContent>+ <FieldGroup>+ <Field>+ <FieldLabel htmlFor="profile-email">+ {t('admin.fields.profile.email.label')}+ </FieldLabel>+ {/* Email is identity-bound; PATCH /me does not accept it. */}+ <Input id="profile-email" type="email" value={me.user.email} disabled />+ </Field>+ <Field>+ <FieldLabel htmlFor="profile-first-name">+ {t('admin.fields.profile.first_name.label')}+ </FieldLabel>+ <Input+ id="profile-first-name"+ aria-invalid={!!errors.first_name || undefined}+ {...form.register('first_name')}+ />+ <FieldError errors={[errors.first_name]} />+ </Field>+ <Field>+ <FieldLabel htmlFor="profile-last-name">+ {t('admin.fields.profile.last_name.label')}+ </FieldLabel>+ <Input+ id="profile-last-name"+ aria-invalid={!!errors.last_name || undefined}+ {...form.register('last_name')}+ />+ <FieldError errors={[errors.last_name]} />+ </Field>+ {showLanguagePicker && (+ <SelectField+ id="profile-language"+ label={t('admin.fields.profile.selected_locale.label')}+ name="selected_locale"+ control={form.control}+ options={localeOptions}+ />+ )}+ </FieldGroup>+ </CardContent>+ </Card>+ </>+ }+ />+ </form>+ )+}++interface SelectFieldProps<TValues extends FieldValues> {+ id: string+ label: string+ placeholder?: string+ name: FieldPath<TValues>+ control: Control<TValues>+ options: ReadonlyArray<{ value: string; label: string }>+}++function SelectField<TValues extends FieldValues>({+ id,+ label,+ placeholder,+ name,+ control,+ options,+}: SelectFieldProps<TValues>) {+ return (+ <Controller+ name={name}+ control={control}+ render={({ field, fieldState }) => (+ <Field>+ <FieldLabel htmlFor={id}>{label}</FieldLabel>+ <Select items={options as never} value={field.value} onValueChange={field.onChange}>+ <SelectTrigger id={id} aria-invalid={!!fieldState.error || undefined}>+ <SelectValue placeholder={placeholder} />+ </SelectTrigger>+ <SelectContent>+ {options.map((o) => (+ <SelectItem key={o.value} value={o.value}>+ {o.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ <FieldError errors={[fieldState.error]} />+ </Field>+ )}+ />+ )+}diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsxindex ca0e092de0..6373118fd2 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx@@ -270,9 +270,9 @@ function PendingInvitationsCard({<Table><TableHeader><TableRow>- <TableHead>{t('admin.pages.staff.table.email')}</TableHead>+ <TableHead>{t('admin.fields.email.label')}</TableHead><TableHead>{t('admin.pages.staff.table.role')}</TableHead>- <TableHead>{t('admin.pages.staff.table.expires')}</TableHead>+ <TableHead>{t('admin.fields.expires_at.label')}</TableHead><TableHead className="w-12" /></TableRow></TableHeader>@@ -318,7 +318,7 @@ function InvitationRow({ invitation }: { invitation: Invitation }) {title: t('admin.staff.confirm.revoke_title'),message: t('admin.staff.confirm.revoke_message', { email: invitation.email }),variant: 'destructive',- confirmLabel: t('admin.pages.staff.actions.revoke'),+ confirmLabel: t('admin.actions.revoke'),})if (!ok) return@@ -373,7 +373,7 @@ function InvitationRow({ invitation }: { invitation: Invitation }) {},{key: 'revoke',- label: t('admin.pages.staff.actions.revoke'),+ label: t('admin.actions.revoke'),icon: <BanIcon className="size-4" />,destructive: true,disabled: deleteMutation.isPending,diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsxindex a1414749d5..29b8cecb86 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx@@ -663,9 +663,7 @@ function StockLocationFormFields({ form }: { form: UseFormReturn<StockLocationFo/><div className="border-t border-border pt-4">- <h3 className="mb-3 text-sm font-medium">- {t('admin.pages.settings.stock_locations.section_address')}- </h3>+ <h3 className="mb-3 text-sm font-medium">{t('admin.fields.address.address1.label')}</h3><FieldGroup><Field><FieldLabel htmlFor="address1">{t('admin.fields.address1.label')}</FieldLabel>diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsxindex 0433eec18b..4d7d6ee4bb 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx@@ -466,11 +466,11 @@ function DetailsCard({ endpoint }: { endpoint: WebhookEndpoint }) {}/><DetailRow- label={t('admin.pages.settings.webhooks.detail.created_at')}+ label={t('admin.fields.created_at.label')}value={<RelativeTime iso={endpoint.created_at} />}/><DetailRow- label={t('admin.pages.settings.webhooks.detail.updated_at')}+ label={t('admin.fields.updated_at.label')}value={<RelativeTime iso={endpoint.updated_at} />}/></CardContent>@@ -595,7 +595,7 @@ function DeliveryDetailSheet({value={<code className="font-mono text-xs">{delivery.event_name}</code>}/><DetailRow- label={t('admin.pages.settings.webhooks.deliveries.detail.status')}+ label={t('admin.fields.status.label')}value={<Badgevariant={diff --git a/packages/dashboard/src/routes/login.tsx b/packages/dashboard/src/routes/login.tsxindex 404cecb898..9e1beeb2a6 100644--- a/packages/dashboard/src/routes/login.tsx+++ b/packages/dashboard/src/routes/login.tsx@@ -71,8 +71,8 @@ function LoginFormCard({<div className={cn('flex flex-col gap-6', className)}><Card><CardHeader className="text-center">- <CardTitle className="text-xl">{t('admin.pages.login.title')}</CardTitle>- <CardDescription>{t('admin.pages.login.subtitle')}</CardDescription>+ <CardTitle className="text-xl">{t('admin.auth.login.title')}</CardTitle>+ <CardDescription>{t('admin.auth.login.subtitle')}</CardDescription></CardHeader><CardContent><form onSubmit={form.handleSubmit(onSubmit)}>diff --git a/packages/dashboard/src/schemas/me.ts b/packages/dashboard/src/schemas/me.tsnew file mode 100644index 0000000000..11048ee07f--- /dev/null+++ b/packages/dashboard/src/schemas/me.ts@@ -0,0 +1,14 @@+import { z } from 'zod/v4'++// Profile form for the signed-in admin (PATCH /me). All fields optional —+// mirrors the Rails admin profile, which doesn't require first/last name.+// The admin-UI language options are NOT listed here: they're derived at render+// time from the dashboard's shipped locale bundles (see getAvailableUiLocales),+// which is what the SPA can actually display — not a backend list.+export const meFormSchema = z.object({+ first_name: z.string().nullable().optional(),+ last_name: z.string().nullable().optional(),+ selected_locale: z.string().nullable().optional(),+})++export type MeFormValues = z.infer<typeof meFormSchema>diff --git a/packages/dashboard/src/tables/customer-groups.tsx b/packages/dashboard/src/tables/customer-groups.tsxindex 8c489925a2..2afc0041c3 100644--- a/packages/dashboard/src/tables/customer-groups.tsx+++ b/packages/dashboard/src/tables/customer-groups.tsx@@ -1,19 +1,20 @@import type { CustomerGroup } from '@spree/admin-sdk'import { defineTable } from '@spree/dashboard-core'import { ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { UsersRoundIcon } from 'lucide-react'defineTable<CustomerGroup>('customer-groups', {- title: 'Customer Groups',+ title: i18n.t('admin.customers.groups.table.title'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.customers.groups.table.search_placeholder'),defaultSort: { field: 'name', direction: 'asc' },emptyIcon: <UsersRoundIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No customer groups yet',+ emptyMessage: i18n.t('admin.customers.groups.table.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -28,7 +29,7 @@ defineTable<CustomerGroup>('customer-groups', {},{key: 'customers_count',- label: 'Customers',+ label: i18n.t('admin.customers.groups.columns.customers'),sortable: true,default: true,render: (g) => g.customers_count,diff --git a/packages/dashboard/src/tables/customers.tsx b/packages/dashboard/src/tables/customers.tsxindex 2a24ea98ad..7607a1a077 100644--- a/packages/dashboard/src/tables/customers.tsx+++ b/packages/dashboard/src/tables/customers.tsx@@ -6,16 +6,16 @@ import { UsersIcon } from 'lucide-react'import { customerGroupAutocompleteProps } from '@/hooks/use-customer-groups'defineTable('customers', {- title: 'Customers',+ title: i18n.t('admin.nav.customers'),searchParam: 'search',- searchPlaceholder: 'Search by email or name…',+ searchPlaceholder: i18n.t('admin.customers.table.search_placeholder'),defaultSort: { field: 'created_at', direction: 'desc' },emptyIcon: <UsersIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No customers yet',+ emptyMessage: i18n.t('admin.customers.table.empty'),columns: [{key: 'email',- label: 'Email',+ label: i18n.t('admin.fields.email.label'),sortable: true,filterable: true,default: true,@@ -31,7 +31,7 @@ defineTable('customers', {},{key: 'first_name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -39,7 +39,7 @@ defineTable('customers', {},{key: 'phone',- label: 'Phone',+ label: i18n.t('admin.fields.phone.label'),sortable: true,filterable: true,default: false,@@ -47,28 +47,28 @@ defineTable('customers', {},{key: 'orders_count',- label: 'Orders',+ label: i18n.t('admin.customers.columns.orders'),default: true,className: 'text-right tabular-nums',render: (c) => c.orders_count ?? 0,},{key: 'total_spent',- label: 'Total spent',+ label: i18n.t('admin.customers.columns.total_spent'),default: true,className: 'text-right tabular-nums whitespace-nowrap font-medium',render: (c) => c.display_total_spent ?? '—',},{key: 'last_order_completed_at',- label: 'Last order',+ label: i18n.t('admin.customers.columns.last_order'),default: true,className: 'text-sm text-muted-foreground whitespace-nowrap',render: (c) => <RelativeTime iso={c.last_order_completed_at} />,},{key: 'customer_groups',- label: 'Groups',+ label: i18n.t('admin.customers.columns.groups'),default: false,filterable: true,filterType: 'resource',@@ -92,7 +92,7 @@ defineTable('customers', {},{key: 'tags',- label: 'Tags',+ label: i18n.t('admin.fields.customer.tags.label'),sortable: false,filterable: true,filterType: 'tags',@@ -102,7 +102,7 @@ defineTable('customers', {},{key: 'accepts_email_marketing',- label: 'Newsletter',+ label: i18n.t('admin.customers.columns.newsletter'),sortable: true,filterable: true,default: false,diff --git a/packages/dashboard/src/tables/gift-cards.tsx b/packages/dashboard/src/tables/gift-cards.tsxindex 906effd1b9..0060245b08 100644--- a/packages/dashboard/src/tables/gift-cards.tsx+++ b/packages/dashboard/src/tables/gift-cards.tsx@@ -12,7 +12,7 @@ import { giftCardBatchAutocompleteProps } from '@/hooks/use-gift-cards'// "active" — keep this list in sync with the state machine + display_state// override in `app/models/spree/gift_card.rb`.const STATUS_OPTIONS = [- { value: 'active', label: i18n.t('admin.gift_cards.statuses.active') },+ { value: 'active', label: i18n.t('admin.fields.active.label') },{ value: 'partially_redeemed', label: i18n.t('admin.gift_cards.statuses.partially_redeemed') },{ value: 'redeemed', label: i18n.t('admin.gift_cards.statuses.redeemed') },{ value: 'canceled', label: i18n.t('admin.gift_cards.statuses.canceled') },@@ -149,7 +149,7 @@ defineTable<GiftCard>('gift-cards', {},{key: 'expires_at',- label: i18n.t('admin.gift_cards.columns.expires'),+ label: i18n.t('admin.fields.expires_at.label'),sortable: true,filterable: true,filterType: 'date',diff --git a/packages/dashboard/src/tables/markets.tsx b/packages/dashboard/src/tables/markets.tsxindex 0acd2dc87c..11188ee04e 100644--- a/packages/dashboard/src/tables/markets.tsx+++ b/packages/dashboard/src/tables/markets.tsx@@ -1,19 +1,20 @@import type { Market } from '@spree/admin-sdk'import { defineTable, LocaleLabel } from '@spree/dashboard-core'import { ActiveBadge, Badge, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { GlobeIcon } from 'lucide-react'defineTable<Market>('markets', {- title: 'Markets',+ title: i18n.t('admin.settings_nav.items.markets'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.markets.search_placeholder'),defaultSort: { field: 'position', direction: 'asc' },emptyIcon: <GlobeIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No markets yet',+ emptyMessage: i18n.t('admin.markets.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -28,36 +29,40 @@ defineTable<Market>('markets', {},{key: 'currency',- label: 'Currency',+ label: i18n.t('admin.fields.currency.label'),sortable: true,default: true,render: (market) => <Badge variant="outline">{market.currency}</Badge>,},{key: 'default_locale',- label: 'Default locale',+ label: i18n.t('admin.fields.market.default_locale.label'),sortable: true,default: true,render: (market) => <LocaleLabel code={market.default_locale} />,},{key: 'tax_inclusive',- label: 'Tax',+ label: i18n.t('admin.fields.tax.label'),default: true,render: (market) => (<ActiveBadgeactive={market.tax_inclusive}- activeLabel="Inclusive"- inactiveLabel="Exclusive"+ activeLabel={i18n.t('admin.markets.tax_inclusive')}+ inactiveLabel={i18n.t('admin.markets.tax_exclusive')}/>),},{key: 'default',- label: 'Default',+ label: i18n.t('admin.markets.columns.default'),default: true,render: (market) => (- <ActiveBadge active={market.default} activeLabel="Default" dashWhenInactive />+ <ActiveBadge+ active={market.default}+ activeLabel={i18n.t('admin.markets.columns.default')}+ dashWhenInactive+ />),},],diff --git a/packages/dashboard/src/tables/option-types.tsx b/packages/dashboard/src/tables/option-types.tsxindex 46afdf123d..869cd7bbd6 100644--- a/packages/dashboard/src/tables/option-types.tsx+++ b/packages/dashboard/src/tables/option-types.tsx@@ -1,25 +1,26 @@import type { OptionType } from '@spree/admin-sdk'import { defineTable } from '@spree/dashboard-core'import { ActiveBadge, Badge, RelativeTime, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { ListChecksIcon } from 'lucide-react'const KIND_LABELS: Record<string, string> = {- dropdown: 'Dropdown',- color_swatch: 'Color swatch',- buttons: 'Buttons',+ dropdown: i18n.t('admin.option_types.kinds.dropdown'),+ color_swatch: i18n.t('admin.option_types.kinds.color_swatch'),+ buttons: i18n.t('admin.option_types.kinds.buttons'),}defineTable<OptionType>('option-types', {- title: 'Option Types',+ title: i18n.t('admin.nav.options'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.option_types.table.search_placeholder'),defaultSort: { field: 'position', direction: 'asc' },emptyIcon: <ListChecksIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No option types yet',+ emptyMessage: i18n.t('admin.option_types.table.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -34,7 +35,7 @@ defineTable<OptionType>('option-types', {},{key: 'kind',- label: 'Kind',+ label: i18n.t('admin.fields.kind.label'),sortable: true,filterable: true,filterType: 'enum',@@ -44,26 +45,26 @@ defineTable<OptionType>('option-types', {},{key: 'option_values',- label: 'Values',+ label: i18n.t('admin.option_types.columns.values'),default: true,render: (ot) => {const count = ot.option_values?.length ?? 0return (<span className="text-sm text-muted-foreground">- {count === 1 ? '1 value' : `${count} values`}+ {i18n.t('admin.option_types.value_count', { count })}</span>)},},{key: 'filterable',- label: 'Filterable',+ label: i18n.t('admin.fields.option_type.filterable.label'),default: true,render: (ot) => <ActiveBadge active={ot.filterable ?? false} dashWhenInactive />,},{key: 'updated_at',- label: 'Updated',+ label: i18n.t('admin.fields.updated_at.label'),sortable: true,render: (ot) => <RelativeTime iso={ot.updated_at} />,},diff --git a/packages/dashboard/src/tables/orders.tsx b/packages/dashboard/src/tables/orders.tsxindex 5331b42e41..01e384d8c0 100644--- a/packages/dashboard/src/tables/orders.tsx+++ b/packages/dashboard/src/tables/orders.tsx@@ -5,17 +5,27 @@ import i18n from 'i18next'import { ShoppingCartIcon } from 'lucide-react'import { channelAutocompleteProps } from '@/hooks/use-channels'+/**+ * Localized label for an order status code, resolved from the given namespace+ * (`payment_statuses`, `fulfillment_statuses`, `statuses`) with the humanized+ * code as a fallback for any value without a translation.+ */+function statusLabel(namespace: string, status: string): string {+ const key = `admin.orders.${namespace}.${status}`+ return i18n.exists(key) ? i18n.t(key) : status.replace(/_/g, ' ')+}+defineTable('orders', {- title: 'Orders',+ title: i18n.t('admin.nav.orders'),searchParam: 'multi_search',- searchPlaceholder: 'Search orders...',+ searchPlaceholder: i18n.t('admin.orders.table.search_placeholder'),defaultSort: { field: 'completed_at', direction: 'desc' },emptyIcon: <ShoppingCartIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No orders found',+ emptyMessage: i18n.t('admin.orders.table.empty'),columns: [{key: 'number',- label: 'Number',+ label: i18n.t('admin.orders.columns.number'),sortable: true,filterable: true,default: true,@@ -31,7 +41,7 @@ defineTable('orders', {},{key: 'completed_at',- label: 'Date',+ label: i18n.t('admin.orders.columns.date'),sortable: true,default: true,filterType: 'date',@@ -40,7 +50,7 @@ defineTable('orders', {},{key: 'email',- label: 'Customer',+ label: i18n.t('admin.orders.columns.customer'),sortable: true,filterable: true,default: true,@@ -61,53 +71,67 @@ defineTable('orders', {},{key: 'payment_status',- label: 'Payment',+ label: i18n.t('admin.orders.columns.payment'),sortable: true,filterable: true,default: true,filterType: 'enum',filterOptions: [- { value: 'balance_due', label: 'Balance due' },- { value: 'credit_owed', label: 'Credit owed' },- { value: 'failed', label: 'Failed' },- { value: 'paid', label: 'Paid' },- { value: 'void', label: 'Void' },+ { value: 'balance_due', label: i18n.t('admin.orders.payment_statuses.balance_due') },+ { value: 'credit_owed', label: i18n.t('admin.orders.payment_statuses.credit_owed') },+ { value: 'failed', label: i18n.t('admin.orders.payment_statuses.failed') },+ { value: 'paid', label: i18n.t('admin.orders.payment_statuses.paid') },+ { value: 'void', label: i18n.t('admin.orders.payment_statuses.void') },],render: (order) =>- order.payment_status ? <StatusBadge status={order.payment_status} /> : '—',+ order.payment_status ? (+ <StatusBadge+ status={order.payment_status}+ label={statusLabel('payment_statuses', order.payment_status)}+ />+ ) : (+ '—'+ ),},{key: 'fulfillment_status',- label: 'Fulfillment',+ label: i18n.t('admin.orders.columns.fulfillment'),sortable: true,filterable: true,default: true,filterType: 'enum',filterOptions: [- { value: 'backorder', label: 'Backorder' },- { value: 'canceled', label: 'Canceled' },- { value: 'partial', label: 'Partial' },- { value: 'pending', label: 'Pending' },- { value: 'ready', label: 'Ready' },- { value: 'fulfilled', label: 'Fulfilled' },+ { value: 'backorder', label: i18n.t('admin.orders.fulfillment_statuses.backorder') },+ { value: 'canceled', label: i18n.t('admin.orders.fulfillment_statuses.canceled') },+ { value: 'partial', label: i18n.t('admin.orders.fulfillment_statuses.partial') },+ { value: 'pending', label: i18n.t('admin.orders.fulfillment_statuses.pending') },+ { value: 'ready', label: i18n.t('admin.orders.fulfillment_statuses.ready') },+ { value: 'fulfilled', label: i18n.t('admin.orders.fulfillment_statuses.fulfilled') },],render: (order) =>- order.fulfillment_status ? <StatusBadge status={order.fulfillment_status} /> : '—',+ order.fulfillment_status ? (+ <StatusBadge+ status={order.fulfillment_status}+ label={statusLabel('fulfillment_statuses', order.fulfillment_status)}+ />+ ) : (+ '—'+ ),},{key: 'total_quantity',- label: 'Items',+ label: i18n.t('admin.orders.columns.items'),sortable: true,default: true,className: 'text-right tabular-nums text-sm text-muted-foreground',render: (order) => {const count = order.total_quantity ?? 0- return `${count} ${count === 1 ? 'item' : 'items'}`+ return i18n.t('admin.orders.item_count', { count })},},{key: 'total',- label: 'Total',+ label: i18n.t('admin.fields.total.label'),sortable: true,filterable: true,default: true,@@ -117,7 +141,7 @@ defineTable('orders', {},{key: 'currency',- label: 'Currency',+ label: i18n.t('admin.fields.currency.label'),sortable: true,filterable: true,filterType: 'currency',@@ -126,21 +150,23 @@ defineTable('orders', {},{key: 'status',- label: 'Status',+ label: i18n.t('admin.fields.status.label'),sortable: true,filterable: true,default: false,filterType: 'enum',filterOptions: [- { value: 'draft', label: 'Draft' },- { value: 'placed', label: 'Placed' },- { value: 'canceled', label: 'Canceled' },+ { value: 'draft', label: i18n.t('admin.orders.statuses.draft') },+ { value: 'placed', label: i18n.t('admin.orders.statuses.placed') },+ { value: 'canceled', label: i18n.t('admin.orders.statuses.canceled') },],- render: (order) => <StatusBadge status={order.status} />,+ render: (order) => (+ <StatusBadge status={order.status} label={statusLabel('statuses', order.status)} />+ ),},{key: 'tags',- label: 'Tags',+ label: i18n.t('admin.orders.columns.tags'),sortable: false,filterable: true,filterType: 'tags',@@ -159,7 +185,7 @@ defineTable('orders', {},{key: 'updated_at',- label: 'Updated at',+ label: i18n.t('admin.fields.updated_at.label'),sortable: true,default: false,filterType: 'date',@@ -169,21 +195,21 @@ defineTable('orders', {// Filter-only columns{key: 'first_name',- label: 'First name',+ label: i18n.t('admin.fields.first_name.label'),filterable: true,displayable: false,ransackAttribute: 'bill_address_firstname_i',},{key: 'last_name',- label: 'Last name',+ label: i18n.t('admin.fields.last_name.label'),filterable: true,displayable: false,ransackAttribute: 'bill_address_lastname',},{key: 'sku',- label: 'SKU',+ label: i18n.t('admin.orders.columns.sku'),filterable: true,displayable: false,ransackAttribute: 'line_items_variant_sku',diff --git a/packages/dashboard/src/tables/payment-methods.tsx b/packages/dashboard/src/tables/payment-methods.tsxindex 13f52cc133..fe27d487aa 100644--- a/packages/dashboard/src/tables/payment-methods.tsx+++ b/packages/dashboard/src/tables/payment-methods.tsx@@ -1,19 +1,20 @@import type { PaymentMethod } from '@spree/admin-sdk'import { defineTable } from '@spree/dashboard-core'import { ActiveBadge, Badge, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { CreditCardIcon } from 'lucide-react'defineTable<PaymentMethod>('payment-methods', {- title: 'Payment Methods',+ title: i18n.t('admin.payment_methods.title'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.payment_methods.search_placeholder'),defaultSort: { field: 'position', direction: 'asc' },emptyIcon: <CreditCardIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No payment methods configured',+ emptyMessage: i18n.t('admin.payment_methods.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -28,7 +29,7 @@ defineTable<PaymentMethod>('payment-methods', {},{key: 'type',- label: 'Provider',+ label: i18n.t('admin.fields.payment_method.type.label'),sortable: true,filterable: true,default: true,@@ -36,26 +37,30 @@ defineTable<PaymentMethod>('payment-methods', {},{key: 'storefront_visible',- label: 'Storefront',+ label: i18n.t('admin.payment_methods.columns.storefront'),filterable: true,filterType: 'boolean',default: true,render: (pm) => (<ActiveBadgeactive={pm.storefront_visible}- activeLabel="Visible"- inactiveLabel="Admin only"+ activeLabel={i18n.t('admin.payment_methods.storefront.visible')}+ inactiveLabel={i18n.t('admin.payment_methods.storefront.admin_only')}/>),},{key: 'active',- label: 'Status',+ label: i18n.t('admin.fields.status.label'),filterable: true,default: true,filterType: 'boolean',render: (pm) => (- <ActiveBadge active={pm.active} activeLabel="Active" inactiveLabel="Disabled" />+ <ActiveBadge+ active={pm.active}+ activeLabel={i18n.t('admin.fields.active.label')}+ inactiveLabel={i18n.t('admin.payment_methods.status.disabled')}+ />),},],diff --git a/packages/dashboard/src/tables/products.tsx b/packages/dashboard/src/tables/products.tsxindex b1b87c0e4d..07a3001281 100644--- a/packages/dashboard/src/tables/products.tsx+++ b/packages/dashboard/src/tables/products.tsx@@ -53,7 +53,7 @@ defineTable('products', {filterType: 'enum',filterOptions: [{ value: 'draft', label: i18n.t('admin.pages.products.status_options.draft') },- { value: 'active', label: i18n.t('admin.pages.products.status_options.active') },+ { value: 'active', label: i18n.t('admin.fields.active.label') },{ value: 'archived', label: i18n.t('admin.pages.products.status_options.archived') },],render: (product) => <StatusBadge status={product.status} />,@@ -101,7 +101,7 @@ defineTable('products', {},{key: 'sku',- label: 'SKU',+ label: i18n.t('admin.products.columns.sku'),sortable: false,filterable: true,default: false,@@ -111,7 +111,7 @@ defineTable('products', {},{key: 'price',- label: 'Price',+ label: i18n.t('admin.products.columns.price'),sortable: true,filterable: true,default: true,@@ -152,7 +152,7 @@ defineTable('products', {},{key: 'in_stock',- label: 'In Stock',+ label: i18n.t('admin.products.columns.in_stock'),filterable: true,filterType: 'boolean',displayable: false,diff --git a/packages/dashboard/src/tables/promotions.tsx b/packages/dashboard/src/tables/promotions.tsxindex 90aa4fd694..0f65b037d9 100644--- a/packages/dashboard/src/tables/promotions.tsx+++ b/packages/dashboard/src/tables/promotions.tsx@@ -1,19 +1,20 @@import type { Promotion } from '@spree/admin-sdk'import { defineTable } from '@spree/dashboard-core'import { Badge, RelativeTime, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { TagIcon } from 'lucide-react'defineTable<Promotion>('promotions', {- title: 'Promotions',+ title: i18n.t('admin.nav.promotions'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.promotions.table.search_placeholder'),defaultSort: { field: 'created_at', direction: 'desc' },emptyIcon: <TagIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No promotions yet',+ emptyMessage: i18n.t('admin.promotions.table.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -28,19 +29,25 @@ defineTable<Promotion>('promotions', {},{key: 'code',- label: 'Code',+ label: i18n.t('admin.fields.code.label'),sortable: true,filterable: true,default: true,render: (p) => {- if (p.kind === 'automatic') return <Badge variant="outline">Automatic</Badge>- if (p.multi_codes) return <Badge variant="outline">{p.code_prefix ?? 'multi'}…</Badge>+ if (p.kind === 'automatic')+ return <Badge variant="outline">{i18n.t('admin.promotions.code.automatic')}</Badge>+ if (p.multi_codes)+ return (+ <Badge variant="outline">+ {p.code_prefix ?? i18n.t('admin.promotions.code.multi')}…+ </Badge>+ )return p.code ? <code className="text-xs">{p.code}</code> : '—'},},{key: 'starts_at',- label: 'Starts',+ label: i18n.t('admin.fields.starts_at.label'),sortable: true,filterType: 'date',default: true,@@ -49,13 +56,16 @@ defineTable<Promotion>('promotions', {},{key: 'expires_at',- label: 'Expires',+ label: i18n.t('admin.fields.expires_at.label'),sortable: true,filterType: 'date',default: true,className: 'text-sm text-muted-foreground whitespace-nowrap',render: (p) => {- if (!p.expires_at) return <span className="text-muted-foreground">No end</span>+ if (!p.expires_at)+ return (+ <span className="text-muted-foreground">{i18n.t('admin.promotions.table.no_end')}</span>+ )const expired = new Date(p.expires_at) < new Date()return (<span className={expired ? 'text-destructive' : undefined}>diff --git a/packages/dashboard/src/tables/stock-locations.tsx b/packages/dashboard/src/tables/stock-locations.tsxindex 74bd40bc3d..5936eea304 100644--- a/packages/dashboard/src/tables/stock-locations.tsx+++ b/packages/dashboard/src/tables/stock-locations.tsx@@ -1,19 +1,20 @@import type { StockLocation } from '@spree/admin-sdk'import { defineTable } from '@spree/dashboard-core'import { ActiveBadge, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { WarehouseIcon } from 'lucide-react'defineTable<StockLocation>('stock-locations', {- title: 'Stock Locations',+ title: i18n.t('admin.settings_nav.items.stock_locations'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.stock_locations.search_placeholder'),defaultSort: { field: 'name', direction: 'asc' },emptyIcon: <WarehouseIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No stock locations yet',+ emptyMessage: i18n.t('admin.stock_locations.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -28,21 +29,28 @@ defineTable<StockLocation>('stock-locations', {},{key: 'kind',- label: 'Type',+ label: i18n.t('admin.stock_locations.columns.type'),sortable: true,filterable: true,default: true,filterType: 'enum',filterOptions: [- { value: 'warehouse', label: 'Warehouse' },- { value: 'store', label: 'Store' },- { value: 'fulfillment_center', label: 'Fulfillment center' },+ { value: 'warehouse', label: i18n.t('admin.stock_locations.kinds.warehouse') },+ { value: 'store', label: i18n.t('admin.stock_locations.kinds.store') },+ {+ value: 'fulfillment_center',+ label: i18n.t('admin.stock_locations.kinds.fulfillment_center'),+ },],- render: (sl) => <span className="capitalize">{sl.kind.replace('_', ' ')}</span>,+ render: (sl) => {+ const key = `admin.stock_locations.kinds.${sl.kind}`+ const label = i18n.exists(key) ? i18n.t(key) : sl.kind.replace('_', ' ')+ return <span className="capitalize">{label}</span>+ },},{key: 'city',- label: 'Location',+ label: i18n.t('admin.stock_locations.columns.location'),default: true,render: (sl) => {const parts = [sl.city, sl.state_text || sl.state_abbr, sl.country_iso]@@ -53,33 +61,47 @@ defineTable<StockLocation>('stock-locations', {},{key: 'pickup_enabled',- label: 'Pickup',+ label: i18n.t('admin.stock_locations.columns.pickup'),sortable: true,filterable: true,default: true,filterType: 'boolean',render: (sl) => (- <ActiveBadge active={sl.pickup_enabled} activeLabel="Enabled" dashWhenInactive />+ <ActiveBadge+ active={sl.pickup_enabled}+ activeLabel={i18n.t('admin.stock_locations.badges.enabled')}+ dashWhenInactive+ />),},{key: 'active',- label: 'Active',+ label: i18n.t('admin.fields.active.label'),sortable: true,filterable: true,default: true,filterType: 'boolean',render: (sl) => (- <ActiveBadge active={sl.active} activeLabel="Active" inactiveLabel="Inactive" />+ <ActiveBadge+ active={sl.active}+ activeLabel={i18n.t('admin.fields.active.label')}+ inactiveLabel={i18n.t('admin.stock_locations.badges.inactive')}+ />),},{key: 'default',- label: 'Default',+ label: i18n.t('admin.stock_locations.columns.default'),default: true,filterable: true,filterType: 'boolean',- render: (sl) => <ActiveBadge active={sl.default} activeLabel="Default" dashWhenInactive />,+ render: (sl) => (+ <ActiveBadge+ active={sl.default}+ activeLabel={i18n.t('admin.stock_locations.badges.default')}+ dashWhenInactive+ />+ ),},],})diff --git a/packages/dashboard/src/tables/stock-transfers.tsx b/packages/dashboard/src/tables/stock-transfers.tsxindex d1db04bae9..ef0689ca13 100644--- a/packages/dashboard/src/tables/stock-transfers.tsx+++ b/packages/dashboard/src/tables/stock-transfers.tsx@@ -5,16 +5,16 @@ import i18n from 'i18next'import { ArrowLeftRightIcon } from 'lucide-react'defineTable<StockTransfer>('stock-transfers', {- title: 'Stock Transfers',+ title: i18n.t('admin.stock_transfers.title'),searchParam: 'number_cont',- searchPlaceholder: 'Search by number or reference…',+ searchPlaceholder: i18n.t('admin.stock_transfers.table.search_placeholder'),defaultSort: { field: 'created_at', direction: 'desc' },emptyIcon: <ArrowLeftRightIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No stock transfers yet',+ emptyMessage: i18n.t('admin.stock_transfers.table.empty'),columns: [{key: 'number',- label: 'Number',+ label: i18n.t('admin.stock_transfers.columns.number'),sortable: true,filterable: true,default: true,@@ -29,18 +29,20 @@ defineTable<StockTransfer>('stock-transfers', {},{key: 'source_destination',- label: 'Direction',+ label: i18n.t('admin.stock_transfers.columns.direction'),default: true,render: (st) =>st.source_location_id ? (- <span className="text-sm">Transfer between locations</span>+ <span className="text-sm">{i18n.t('admin.stock_transfers.direction.internal')}</span>) : (- <Badge variant="outline">External receive</Badge>+ <Badge variant="outline">+ {i18n.t('admin.stock_transfers.direction.external_receive')}+ </Badge>),},{key: 'reference',- label: 'Reference',+ label: i18n.t('admin.stock_transfers.columns.reference'),filterable: true,default: true,render: (st) => st.reference ?? '—',diff --git a/packages/dashboard/src/tables/tax-categories.tsx b/packages/dashboard/src/tables/tax-categories.tsxindex 6febf01010..95b48259d5 100644--- a/packages/dashboard/src/tables/tax-categories.tsx+++ b/packages/dashboard/src/tables/tax-categories.tsx@@ -1,19 +1,20 @@import type { TaxCategory } from '@spree/admin-sdk'import { defineTable } from '@spree/dashboard-core'import { ActiveBadge, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'import { PercentIcon } from 'lucide-react'defineTable<TaxCategory>('tax-categories', {- title: 'Tax Categories',+ title: i18n.t('admin.settings_nav.items.tax_categories'),searchParam: 'name_cont',- searchPlaceholder: 'Search by name…',+ searchPlaceholder: i18n.t('admin.tax_categories.search_placeholder'),defaultSort: { field: 'name', direction: 'asc' },emptyIcon: <PercentIcon className="size-8 text-muted-foreground" />,- emptyMessage: 'No tax categories yet',+ emptyMessage: i18n.t('admin.tax_categories.empty'),columns: [{key: 'name',- label: 'Name',+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -28,7 +29,7 @@ defineTable<TaxCategory>('tax-categories', {},{key: 'tax_code',- label: 'Tax code',+ label: i18n.t('admin.fields.tax_category.tax_code.label'),sortable: true,filterable: true,default: true,@@ -36,9 +37,15 @@ defineTable<TaxCategory>('tax-categories', {},{key: 'is_default',- label: 'Default',+ label: i18n.t('admin.fields.tax_category.is_default.label'),default: true,- render: (tc) => <ActiveBadge active={tc.is_default} activeLabel="Default" dashWhenInactive />,+ render: (tc) => (+ <ActiveBadge+ active={tc.is_default}+ activeLabel={i18n.t('admin.fields.tax_category.is_default.label')}+ dashWhenInactive+ />+ ),},],})diff --git a/packages/dashboard/src/tables/webhook-deliveries.tsx b/packages/dashboard/src/tables/webhook-deliveries.tsxindex 4a17f537ed..e1536d4c31 100644--- a/packages/dashboard/src/tables/webhook-deliveries.tsx+++ b/packages/dashboard/src/tables/webhook-deliveries.tsx@@ -45,7 +45,7 @@ defineTable<WebhookDelivery>('webhook-deliveries', {},{key: 'success',- label: i18n.t('admin.pages.settings.webhooks.deliveries.table.status'),+ label: i18n.t('admin.fields.status.label'),sortable: false,filterable: true,filterType: 'enum',diff --git a/packages/dashboard/src/tables/webhook-endpoints.tsx b/packages/dashboard/src/tables/webhook-endpoints.tsxindex fc485077b6..a309bc18ec 100644--- a/packages/dashboard/src/tables/webhook-endpoints.tsx+++ b/packages/dashboard/src/tables/webhook-endpoints.tsx@@ -21,7 +21,7 @@ defineTable<WebhookEndpoint>('webhook-endpoints', {columns: [{key: 'name',- label: i18n.t('admin.pages.settings.webhooks.table.name'),+ label: i18n.t('admin.fields.name.label'),sortable: true,filterable: true,default: true,@@ -73,7 +73,7 @@ defineTable<WebhookEndpoint>('webhook-endpoints', {},{key: 'status',- label: i18n.t('admin.pages.settings.webhooks.table.status'),+ label: i18n.t('admin.fields.status.label'),sortable: false,default: true,render: (endpoint) => {@@ -90,7 +90,7 @@ defineTable<WebhookEndpoint>('webhook-endpoints', {return (<ActiveBadgeactive={endpoint.active}- activeLabel={i18n.t('admin.pages.settings.webhooks.status.active')}+ activeLabel={i18n.t('admin.fields.active.label')}inactiveLabel={i18n.t('admin.pages.settings.webhooks.status.inactive')}/>)diff --git a/spree/api/app/controllers/spree/api/v3/admin/me_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/me_controller.rbindex 52fff0a3e5..d1ef6d4409 100644--- a/spree/api/app/controllers/spree/api/v3/admin/me_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/admin/me_controller.rb@@ -5,6 +5,8 @@ module Spreeclass MeController < Admin::BaseControllerskip_scope_check!+ before_action :require_current_user!+# GET /api/v3/admin/me# Returns the current admin user along with a serialized representation# of their permissions (derived from CanCanCan rules). The SPA uses@@ -21,22 +23,49 @@ module Spree# a 500 from serializing a nil user — mirroring how #current 404s for# a JWT principal that has no single key.def show- unless current_user- return render_error(- code: ERROR_CODES[:record_not_found],- message: Spree.t(:me_no_current_user),- status: :not_found- )+ render json: me_response+ end++ # PATCH /api/v3/admin/me+ # Self-service update of the signed-in admin's own profile. Currently+ # limited to `selected_locale` (the admin UI display language) — it+ # operates on `current_user` directly, so it needs no per-record+ # authorization. Distinct from PATCH /admin_users/:id, which is+ # store-scoped staff management of *other* users.+ def update+ if current_user.update(permitted_params)+ render json: me_response+ else+ render_validation_error(current_user.errors)end+ end++ private++ # A request authenticated by a secret API key has no Spree user to+ # describe/update, so it gets a 404 pointing at the key endpoint+ # rather than a 500 from a nil user — mirroring ApiKeysController#current.+ def require_current_user!+ return if current_user- render json: {+ render_error(+ code: ERROR_CODES[:record_not_found],+ message: Spree.t(:me_no_current_user),+ status: :not_found+ )+ end++ def permitted_params+ params.permit(:selected_locale, :first_name, :last_name)+ end++ def me_response+ {user: admin_user_serializer.new(current_user, params: serializer_params).to_h,permissions: serialize_permissions(current_ability)}end- private-# Serializes CanCanCan's rules into a flat, JSON-safe list of permission rules.## - Rule order is preserved so the frontend matcher can applydiff --git a/spree/api/app/serializers/spree/api/v3/admin/admin_user_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/admin_user_serializer.rbindex 2d8fabc52c..052ce26b5c 100644--- a/spree/api/app/serializers/spree/api/v3/admin/admin_user_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/admin/admin_user_serializer.rb@@ -7,9 +7,10 @@ module Spreefirst_name: [:string, nullable: true],last_name: [:string, nullable: true],full_name: [:string, nullable: true],+ selected_locale: [:string, nullable: true],roles: 'Array<{ id: string; name: string }>'- attributes :email, :first_name, :last_name, :full_name,+ attributes :email, :first_name, :last_name, :full_name, :selected_locale,created_at: :iso8601, updated_at: :iso8601# Roles assigned to this user *for the current store*. Each storediff --git a/spree/api/config/routes.rb b/spree/api/config/routes.rbindex 7708991d08..0cbf06e79e 100644--- a/spree/api/config/routes.rb+++ b/spree/api/config/routes.rb@@ -124,6 +124,8 @@ Spree::Core::Engine.add_routes do# Current admin user + permissions (for UI permission checks)get 'me', to: 'me#show'+ # Self-service profile updates (e.g. the admin's own UI language)+ patch 'me', to: 'me#update'# Store Settingsresource :store, only: [:show, :update], controller: 'store'diff --git a/spree/api/spec/controllers/spree/api/v3/admin/me_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/me_controller_spec.rbindex 5d9a4c1fc5..8337fe9e2b 100644--- a/spree/api/spec/controllers/spree/api/v3/admin/me_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/admin/me_controller_spec.rb@@ -66,6 +66,11 @@ RSpec.describe Spree::Api::V3::Admin::MeController, type: :controller doexpect(manage_all_rule).to be_presentend+ it 'exposes the user selected_locale' do+ subject+ expect(json_response['user']).to have_key('selected_locale')+ end+context 'without authentication' dolet(:headers) { {} }@@ -89,4 +94,33 @@ RSpec.describe Spree::Api::V3::Admin::MeController, type: :controller doendendend++ describe 'PATCH #update' do+ subject { patch :update, params: params, as: :json }++ # The admin-UI language is a client concern (the dashboard ships its own+ # locale bundles), so the API stores whatever code the client sends without+ # validating it against the backend's Rails/SpreeI18n locales.+ context 'with a locale code' do+ let(:params) { { selected_locale: 'pl' } }++ it 'returns ok and persists the locale, even one the backend has no translations for' do+ subject+ expect(response).to have_http_status(:ok)+ expect(json_response['user']['selected_locale']).to eq('pl')+ expect(admin_user.reload.selected_locale).to eq('pl')+ end+ end++ context 'when authenticated via a secret API key (no Spree user)' do+ let(:secret_api_key) { create(:api_key, :secret, store: store) }+ let(:headers) { { 'x-spree-api-key' => secret_api_key.plaintext_token } }+ let(:params) { { selected_locale: 'de' } }++ it 'returns not found' do+ subject+ expect(response).to have_http_status(:not_found)+ end+ end+ endenddiff --git a/spree/api/spec/integration/spree/api/v3/admin/me_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/me_spec.rbindex 36d4420f91..e25cc12938 100644--- a/spree/api/spec/integration/spree/api/v3/admin/me_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/admin/me_spec.rb@@ -43,5 +43,40 @@ RSpec.describe 'Admin Me API', type: :request, swagger_doc: 'api-reference/adminrun_test!endend++ patch 'Update the current admin profile' do+ tags 'Authentication'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description "Self-service update of the signed-in admin's own profile, such as their admin UI display language (`selected_locale`)."++ admin_sdk_example 'me/update'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true,+ description: 'Bearer token for admin authentication'+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ selected_locale: { type: :string, example: 'de' },+ first_name: { type: :string, example: 'Ada' },+ last_name: { type: :string, example: 'Lovelace' }+ }+ }++ response '200', 'profile updated' do+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }+ let(:Authorization) { "Bearer #{admin_jwt_token}" }+ let(:body) { { selected_locale: 'de' } }++ schema '$ref' => '#/components/schemas/MeResponse'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['user']['selected_locale']).to eq('de')+ end+ end+ endendenddiff --git a/spree/core/app/models/concerns/spree/admin_user_methods.rb b/spree/core/app/models/concerns/spree/admin_user_methods.rbindex 39ef211ee2..6fde5c25fd 100644--- a/spree/core/app/models/concerns/spree/admin_user_methods.rb+++ b/spree/core/app/models/concerns/spree/admin_user_methods.rb@@ -40,12 +40,6 @@ module Spreeself.whitelisted_ransackable_associations = %w[spree_roles]self.whitelisted_ransackable_attributes = %w[id email first_name last_name]-- # Validations- validates :selected_locale,- inclusion: { in: -> { Spree.available_locales.map(&:to_s) } },- allow_blank: true,- if: :will_save_change_to_selected_locale?enddef can_be_deleted?diff --git a/spree/core/spec/models/spree/concerns/admin_user_methods_spec.rb b/spree/core/spec/models/spree/concerns/admin_user_methods_spec.rbindex b257019d6c..0f6bbadc69 100644--- a/spree/core/spec/models/spree/concerns/admin_user_methods_spec.rb+++ b/spree/core/spec/models/spree/concerns/admin_user_methods_spec.rb@@ -81,32 +81,21 @@ describe Spree::AdminUserMethods doendend- describe 'validations' do- describe 'selected_locale' do- before { allow(Spree).to receive(:available_locales).and_return(%i[en de]) }-- it 'is valid when blank' do- admin_user.selected_locale = nil- expect(admin_user).to be_valid- end-- it 'is valid when an available admin locale' do- admin_user.selected_locale = 'de'- expect(admin_user).to be_valid- end-- it 'is invalid when not an available admin locale' do- admin_user.selected_locale = 'pl'- expect(admin_user).not_to be_valid- expect(admin_user.errors[:selected_locale]).to be_present- end-- it 'does not block unrelated updates when the stored locale is no longer available' do- admin_user.update_column(:selected_locale, 'pl')-- expect(admin_user.update(first_name: 'Jane')).to be(true)- expect(admin_user.reload.first_name).to eq('Jane')- end+ describe 'selected_locale' do+ # The admin-UI display language is a client concern (the React dashboard+ # ships its own locale bundles); the backend just stores the preference and+ # does NOT validate it against Spree.available_locales (Rails/SpreeI18n+ # locales), which is an unrelated list. Each consumer applies it against its+ # own supported set.+ it 'stores any locale code, including ones the Rails backend has no translations for' do+ admin_user.update(selected_locale: 'pl')+ expect(admin_user.reload.selected_locale).to eq('pl')+ end++ it 'accepts a blank value' do+ admin_user.update!(selected_locale: 'pl')+ admin_user.update!(selected_locale: nil)+ expect(admin_user.reload.selected_locale).to be_nilendend