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
Ship the 6.0 API/SDK/dashboard surface for typed adjustments and delivery (Wave 6)
Damian Legawiecf6c9b5cda313
diff --git a/CLAUDE.md b/CLAUDE.mdindex ca7babf8f5..b3efe15e1f 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -13,15 +13,15 @@ Use `/project:create-plan` and `/project:update-plan` for plan management.Active plans (6.0 target, work pending):- `6.0-multi-vendor-marketplace.md` — Open-source the marketplace core (Vendor, OrderGroup-based order splitting, commission engine with EU commission taxation, `VendorTransfer`/`VendorPayout` ledger + pluggable `PayoutProvider`) per spree/spree#13323. 6.0 headline feature; rebuilds the legacy Enterprise multi-vendor module as native models on the Cart/Order split. Basic Stripe Connect payouts (Express onboarding + on-fulfillment transfers) ship OSS in the monorepo, alongside the Stripe core gateway pulled in from the standalone `spree_stripe` repo (payment-sessions classes only, likely `spree/core` — decisions.md 2026-07-15); Enterprise keeps refund clawbacks/netting, reconciliation, KYC ops, DAC7 payout reports, facilitator taxes + Shopify/WooCommerce vendor apps.-- `6.0-cart-order-split.md` — Cart/Order model separation, dual-FK owner everywhere (`cart_id`/`order_id` exactly-one, `#owner` as method — NOT polymorphic), idempotent copy-on-completion (`Order#cart_id` unique, order-before-payment), Order state machine removed (Checkout::Requirements for steps; payment/fulfillment statuses derived-then-persisted via one recompute service). Expanded 2026-07-27; gates split-adjustments, fulfillment, multi-vendor+- `6.0-cart-order-split.md` — Cart/Order model separation, dual-FK owner everywhere (`cart_id`/`order_id` exactly-one, `#owner` as method — NOT polymorphic), idempotent copy-on-completion (`Order#cart_id` unique, order-before-payment), Order state machine removed (Checkout::Requirements for steps; payment/fulfillment statuses derived-then-persisted via one recompute service). **Shipped to 6-0-dev (feature/6-0-core-rewrite Waves 1+5):** Cart owns checkout end to end, machine + `spree_orders.state` gone, `Carts::Complete` three-phase pipeline live, `Orders::RecomputeStatuses` sole status writer; only Wave 7 data migration (incomplete orders → carts) remains- `6.0-admin-api.md` — Admin REST API conventions, auth, endpoint list (~300 endpoints)- `6.0-admin-spa.md` — React admin architecture, extension points, table registry, i18n + server-error mapping- `6.0-product-types.md` — Prototype → ProductType rename, MetafieldDefinition schema enforcement- `6.0-remove-master-variant.md` — Eliminate is_master, add default_variant_id FK on Product. **Shipped to 6-0-dev (PR #14265):** is_master removed from all models, default_variant_id + `spree:remove_master_variant` data-migration rake landed; only the physical is_master column drop remains (6.1 cleanup).-- `6.0-split-adjustments.md` — Replace polymorphic Adjustment with TaxLine, Discount, Fee+- `6.0-split-adjustments.md` — Replace polymorphic Adjustment with TaxLine, Discount, Fee. **Shipped to 6-0-dev (Waves 3+6):** typed rows + winner-only promotion adjuster + `Spree.tax_provider` live; admin `/orders/:id/{tax_lines,discounts,fees}` API + dashboard panels + `OrderUpdater#resum_typed_totals!` post-placement edit path; Wave 7 adjustments→typed data migration remains- `6.0-typed-stock-movements.md` — Replace generic StockMovement with typed kinds + concrete FKs- `6.0-normalize-state-to-status.md` — Rename state → status on Payment, Shipment, InventoryUnit, ReturnAuthorization, GiftCard-- `6.0-fulfillment-and-delivery.md` — Shipment→Fulfillment, ShippingMethod→DeliveryMethod, drop ShippingCategory, FulfillmentProvider strategy, pickup (merchant StockLocation) + pickup_point (third-party PickupPointProvider)+- `6.0-fulfillment-and-delivery.md` — Shipment→Fulfillment, ShippingMethod→DeliveryMethod, drop ShippingCategory, FulfillmentProvider strategy, pickup (merchant StockLocation) + pickup_point (third-party PickupPointProvider). **Shipped to 6-0-dev (Waves 2+4+6):** renames + deprecated twins, providers (Manual/Digital/Pickup/PickupPoint), dual-emit events, store pickup discovery endpoints, admin delivery_methods/delivery_zones CRUD + dashboard settings pages, FulfillmentMailer; Wave 7 shipping→delivery data migration remains- `6.0-returns-exchanges-claims.md` — First-class Return, Exchange, Claim models replacing ReturnAuthorization/Reimbursement chain- `6.0-platform-auth.md` — Drop Devise, own auth stack, User→Customer/Staff rename (RefreshToken shipped in 5.4)- `6.0-tax-provider.md` — Per-Market TaxProvider, replaces TaxRate.adjust + Calculator; TaxRate gets direct country/state FKs (tax decoupled from Zone; Zone model dropped in 6.0 via `6.0-delivery-zones.md`)diff --git a/docs/api-reference/admin.yaml b/docs/api-reference/admin.yamlindex cd9de42d15..c8e090c6d2 100644--- a/docs/api-reference/admin.yaml+++ b/docs/api-reference/admin.yaml@@ -92,16 +92,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6ImU3YjgzNTVhLTExYWUtNGNmYy1iNzYyLTM4NGQ5OGY1ZGQwZCIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzg1MTgyNzA1fQ.i0SlPXHKVN5YG7XjmSIknXGFOaKgeBwHiNkyQzHEqzw+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjU2ODJlNjQyLTdlMzEtNGFiMS05NTAzLTE4NzE0MzEyM2JjOSIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzg1MzE0NTE5fQ.DhyikCxMqccHOde1_E-4Q_fkfuMQ9T7pue_HCYHQIjMuser:id: admin_UkLWZg9DAJemail: [email protected]- first_name: Tien- last_name: Medhurst- full_name: Tien Medhurst+ first_name: Agustin+ last_name: Buckridge+ full_name: Agustin Buckridgeselected_locale:- created_at: '2026-07-27T20:00:04.732Z'- updated_at: '2026-07-27T20:00:04.732Z'+ created_at: '2026-07-29T08:36:59.663Z'+ updated_at: '2026-07-29T08:36:59.663Z'avatar_url:roles:- id: role_UkLWZg9DAJ@@ -204,16 +204,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjIwMzFkOWE3LTljMGMtNGNkZi05ZWU2LTE0MDI0MjIwZGFlYSIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzg1MTgyNzA1fQ.qe0T7bUxlw38ohjW5xR0Xv2qflnGYPBNrib-RaTblI8+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6ImM3MjFiNWM1LWRlMzItNGY5Ny04OTQ3LWM4NGYwYjEwYmUwYyIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzg1MzE0NTIwfQ.xXfHwRZoFDSK2OEqZiS4z77bGow4rcozEuID71Q6NZsuser:id: admin_UkLWZg9DAJemail: [email protected]- first_name: Santo- last_name: Pagac- full_name: Santo Pagac+ first_name: Whitney+ last_name: Schiller+ full_name: Whitney Schillerselected_locale:- created_at: '2026-07-27T20:00:05.821Z'- updated_at: '2026-07-27T20:00:05.821Z'+ created_at: '2026-07-29T08:37:00.756Z'+ updated_at: '2026-07-29T08:37:00.756Z'avatar_url:roles:- id: role_UkLWZg9DAJ@@ -315,13 +315,13 @@ paths:example:user:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Charleen- last_name: Kihn- full_name: Charleen Kihn+ email: [email protected]+ first_name: Edra+ last_name: Thompson+ full_name: Edra Thompsonselected_locale:- created_at: '2026-07-27T20:00:44.530Z'- updated_at: '2026-07-27T20:00:44.530Z'+ created_at: '2026-07-29T08:37:45.003Z'+ updated_at: '2026-07-29T08:37:45.003Z'avatar_url:roles:- id: role_UkLWZg9DAJ@@ -441,13 +441,13 @@ paths:example:user:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Beulah- last_name: Schimmel- full_name: Beulah Schimmel+ email: [email protected]+ first_name: Milda+ last_name: Prohaska+ full_name: Milda Prohaskaselected_locale: de- created_at: '2026-07-27T20:00:44.839Z'- updated_at: '2026-07-27T20:00:44.854Z'+ created_at: '2026-07-29T08:37:45.297Z'+ updated_at: '2026-07-29T08:37:45.309Z'avatar_url:roles:- id: role_UkLWZg9DAJ@@ -644,16 +644,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6ImI5ZTA5YzBhLTYxMzctNGQ4YS1iM2RjLTFkMDUwZmNmOTM5YiIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzg1MTg2MDc2fQ.U397bHv2j422wBayJZbq3D2Cj2_wmZ7t73zs9k7FXwE+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6Ijg1ZjRhMjE1LTFmNzYtNGFlOS04NWVmLWYzNTliNjk5MjM3NSIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzg1MzE3ODk5fQ.dOJa2zbAKWkOGWvH5aUynjC917keSAL13ToHN7314Mcuser:id: admin_UkLWZg9DAJemail: [email protected]- first_name: Sana- last_name: Marvin- full_name: Sana Marvin+ first_name: Carlota+ last_name: Gusikowski+ full_name: Carlota Gusikowskiselected_locale:- created_at: '2026-07-27T20:01:16.038Z'- updated_at: '2026-07-27T20:01:16.312Z'+ created_at: '2026-07-29T08:38:19.448Z'+ updated_at: '2026-07-29T08:38:19.720Z'avatar_url:roles:- id: role_UkLWZg9DAJ@@ -772,8 +772,8 @@ paths:data:- id: ao_UkLWZg9DAJorigin: https://shop.example.com- created_at: '2026-07-27T20:00:00.158Z'- updated_at: '2026-07-27T20:00:00.158Z'+ created_at: '2026-07-29T08:36:54.987Z'+ updated_at: '2026-07-29T08:36:54.987Z'meta:page: 1limit: 25@@ -857,8 +857,8 @@ paths:example:id: ao_gbHJdmfrXBorigin: https://admin.example.com- created_at: '2026-07-27T20:00:00.744Z'- updated_at: '2026-07-27T20:00:00.744Z'+ created_at: '2026-07-29T08:36:55.572Z'+ updated_at: '2026-07-29T08:36:55.572Z'schema:"$ref": "#/components/schemas/AllowedOrigin"'422':@@ -945,8 +945,8 @@ paths:example:id: ao_UkLWZg9DAJorigin: https://shop.example.com- created_at: '2026-07-27T20:00:01.037Z'- updated_at: '2026-07-27T20:00:01.037Z'+ created_at: '2026-07-29T08:36:55.863Z'+ updated_at: '2026-07-29T08:36:55.863Z'schema:"$ref": "#/components/schemas/AllowedOrigin"'404':@@ -1007,8 +1007,8 @@ paths:example:id: ao_UkLWZg9DAJorigin: https://www.example.com- created_at: '2026-07-27T20:00:01.603Z'- updated_at: '2026-07-27T20:00:01.879Z'+ created_at: '2026-07-29T08:36:56.430Z'+ updated_at: '2026-07-29T08:36:56.708Z'schema:"$ref": "#/components/schemas/AllowedOrigin"'422':@@ -1128,34 +1128,34 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-07-27T20:00:02.459Z'- updated_at: '2026-07-27T20:00:02.459Z'+ created_at: '2026-07-29T08:36:57.308Z'+ updated_at: '2026-07-29T08:36:57.308Z'revoked_at:last_used_at:channel_id:- plaintext_token: pk_BUr9aRDjsVXrXqA54fhUUKJr+ plaintext_token: pk_9i1SFs5WGSYbujrHFiGtYF2rcreated_by_email:- id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_X1KbsdrkJ+ token_prefix: sk_iwrzcB6nVscopes:- write_all- created_at: '2026-07-27T20:00:02.460Z'- updated_at: '2026-07-27T20:00:02.460Z'+ created_at: '2026-07-29T08:36:57.309Z'+ updated_at: '2026-07-29T08:36:57.309Z'revoked_at:last_used_at:channel_id:plaintext_token:created_by_email:- id: key_EfhxLZ9ck8- name: perspiciatis+ name: nemokey_type: secret- token_prefix: sk_KwNinNmrS+ token_prefix: sk_gmsxn5pRkscopes:- write_all- created_at: '2026-07-27T20:00:02.461Z'- updated_at: '2026-07-27T20:00:02.461Z'+ created_at: '2026-07-29T08:36:57.310Z'+ updated_at: '2026-07-29T08:36:57.310Z'revoked_at:last_used_at:channel_id:@@ -1222,16 +1222,16 @@ paths:id: key_VqXmZF31wYname: CI keykey_type: secret- token_prefix: sk_RTADPjJfn+ token_prefix: sk_h6RcqCQYCscopes:- read_orders- created_at: '2026-07-27T20:00:03.022Z'- updated_at: '2026-07-27T20:00:03.022Z'+ created_at: '2026-07-29T08:36:57.906Z'+ updated_at: '2026-07-29T08:36:57.906Z'revoked_at:last_used_at:channel_id:- plaintext_token: sk_RTADPjJfnvUVe2ckb1F9Kmkr- created_by_email: [email protected]+ plaintext_token: sk_h6RcqCQYC1gnd5wyYwYrvUwy+ created_by_email: [email protected]'422':description: validation errorcontent:@@ -1320,12 +1320,12 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-07-27T20:00:03.310Z'- updated_at: '2026-07-27T20:00:03.310Z'+ created_at: '2026-07-29T08:36:58.225Z'+ updated_at: '2026-07-29T08:36:58.225Z'revoked_at:last_used_at:channel_id:- plaintext_token: pk_eTVTrmwQTUc16hVEk4nqknYg+ plaintext_token: pk_vk1WNQR7KLENALm6Hyodbgsscreated_by_email:patch:summary: Update an API key@@ -1379,11 +1379,11 @@ paths:id: key_gbHJdmfrXBname: Backend integration (renamed)key_type: secret- token_prefix: sk_mW4Ca8p5F+ token_prefix: sk_XQ1QQePdUscopes:- write_all- created_at: '2026-07-27T20:00:03.592Z'- updated_at: '2026-07-27T20:00:03.885Z'+ created_at: '2026-07-29T08:36:58.509Z'+ updated_at: '2026-07-29T08:36:58.814Z'revoked_at:last_used_at:channel_id:@@ -1480,13 +1480,13 @@ paths:application/json:example:id: key_EfhxLZ9ck8- name: ipsam+ name: laborumkey_type: secret- token_prefix: sk_ekeeHsr4J+ token_prefix: sk_7cUurVP65scopes:- write_all- created_at: '2026-07-27T20:00:04.179Z'- updated_at: '2026-07-27T20:00:04.179Z'+ created_at: '2026-07-29T08:36:59.107Z'+ updated_at: '2026-07-29T08:36:59.107Z'revoked_at:last_used_at:channel_id:@@ -1544,12 +1544,12 @@ paths:id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_TiYvmwsZg+ token_prefix: sk_LmZTjWbDiscopes:- write_all- created_at: '2026-07-27T20:00:04.193Z'- updated_at: '2026-07-27T20:00:04.470Z'- revoked_at: '2026-07-27T20:00:04.470Z'+ created_at: '2026-07-29T08:36:59.119Z'+ updated_at: '2026-07-29T08:36:59.396Z'+ revoked_at: '2026-07-29T08:36:59.396Z'last_used_at:channel_id:plaintext_token:@@ -1626,8 +1626,8 @@ paths:lft: 1rgt: 2products_count: 0- created_at: '2026-07-27T20:00:06.415Z'- updated_at: '2026-07-27T20:00:06.415Z'+ created_at: '2026-07-29T08:37:01.350Z'+ updated_at: '2026-07-29T08:37:01.350Z'meta:page: 1limit: 25@@ -1701,8 +1701,8 @@ paths:lft: 2rgt: 3products_count: 0- created_at: '2026-07-27T20:00:06.985Z'- updated_at: '2026-07-27T20:00:06.991Z'+ created_at: '2026-07-29T08:37:01.926Z'+ updated_at: '2026-07-29T08:37:01.933Z'schema:"$ref": "#/components/schemas/Category"'422':@@ -1811,8 +1811,8 @@ paths:lft: 1rgt: 2products_count: 0- created_at: '2026-07-27T20:00:07.305Z'- updated_at: '2026-07-27T20:00:07.305Z'+ created_at: '2026-07-29T08:37:02.234Z'+ updated_at: '2026-07-29T08:37:02.234Z'schema:"$ref": "#/components/schemas/Category"'404':@@ -1882,8 +1882,8 @@ paths:lft: 1rgt: 2products_count: 0- created_at: '2026-07-27T20:00:07.899Z'- updated_at: '2026-07-27T20:00:08.186Z'+ created_at: '2026-07-29T08:37:02.807Z'+ updated_at: '2026-07-29T08:37:03.116Z'schema:"$ref": "#/components/schemas/Category"requestBody:@@ -2000,8 +2000,8 @@ paths:lft: 2rgt: 3products_count: 0- created_at: '2026-07-27T20:00:08.500Z'- updated_at: '2026-07-27T20:00:08.791Z'+ created_at: '2026-07-29T08:37:03.436Z'+ updated_at: '2026-07-29T08:37:03.727Z'schema:"$ref": "#/components/schemas/Category"requestBody:@@ -2113,12 +2113,12 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 19585- slug: product-19585+ name: Product 19005+ slug: product-19005meta_title:meta_description:meta_keywords:- variant_count: 0+ variant_count: 1available_on:preorder_ships_at:purchasable: true@@ -2126,30 +2126,12 @@ paths:in_stock: falsebackorderable: trueavailable: true- description: Inventore dicta voluptates rem amet ipsa. Dolores inventore- dicta commodi sequi non aliquam officia. Saepe maiores itaque in- earum repudiandae magnam fugit commodi. Reiciendis dolorem distinctio- earum a. Soluta ipsa eum sit suscipit eaque autem voluptate. Fugiat- asperiores non adipisci dicta consequuntur excepturi quia velit.- Quidem quas optio vitae voluptates nihil iste eaque. Laboriosam- vel quibusdam doloremque unde quis. Tempore sit eaque dolor possimus- pariatur molestiae perspiciatis. Impedit repudiandae perspiciatis- unde id accusantium nisi eos placeat. Nostrum voluptatibus assumenda- voluptas nesciunt molestias voluptates dicta quasi. Aliquam vitae- velit adipisci soluta sunt doloremque asperiores. Modi architecto- nisi asperiores reiciendis aspernatur voluptatum odit. Asperiores- facilis omnis quas officiis iusto ex sapiente. Quae sed architecto- fugit dolores. Non officia omnis asperiores tempore nemo hic deleniti- beatae. Ullam minima excepturi aspernatur qui voluptas sequi corrupti.- Quo aliquam excepturi laborum ullam ipsa recusandae. Aspernatur- vitae pariatur distinctio dolorum veritatis aliquam repellat. Corrupti- quo molestiae dicta assumenda quidem vitae temporibus.- description_html: |-- Inventore dicta voluptates rem amet ipsa. Dolores inventore dicta commodi sequi non aliquam officia. Saepe maiores itaque in earum repudiandae magnam fugit commodi.- Reiciendis dolorem distinctio earum a. Soluta ipsa eum sit suscipit eaque autem voluptate. Fugiat asperiores non adipisci dicta consequuntur excepturi quia velit. Quidem quas optio vitae voluptates nihil iste eaque.- Laboriosam vel quibusdam doloremque unde quis. Tempore sit eaque dolor possimus pariatur molestiae perspiciatis. Impedit repudiandae perspiciatis unde id accusantium nisi eos placeat. Nostrum voluptatibus assumenda voluptas nesciunt molestias voluptates dicta quasi.- Aliquam vitae velit adipisci soluta sunt doloremque asperiores. Modi architecto nisi asperiores reiciendis aspernatur voluptatum odit. Asperiores facilis omnis quas officiis iusto ex sapiente. Quae sed architecto fugit dolores. Non officia omnis asperiores tempore nemo hic deleniti beatae.- Ullam minima excepturi aspernatur qui voluptas sequi corrupti. Quo aliquam excepturi laborum ullam ipsa recusandae. Aspernatur vitae pariatur distinctio dolorum veritatis aliquam repellat. Corrupti quo molestiae dicta assumenda quidem vitae temporibus.+ description: Nesciunt porro tempora non ducimus hic error exercitationem.+ Soluta unde ab facere consectetur laudantium veritatis. Sit ipsa+ optio dignissimos dicta tempore.+ description_html: Nesciunt porro tempora non ducimus hic error exercitationem.+ Soluta unde ab facere consectetur laudantium veritatis. Sit ipsa+ optio dignissimos dicta tempore.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -2164,14 +2146,14 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-07-27T20:00:09.164Z'- updated_at: '2026-07-27T20:00:09.164Z'+ created_at: '2026-07-29T08:37:04.097Z'+ updated_at: '2026-07-29T08:37:04.097Z'original_price:status: activemetadata: {}deleted_at:- created_at: '2026-07-27T20:00:09.145Z'- updated_at: '2026-07-27T20:00:09.175Z'+ created_at: '2026-07-29T08:37:04.073Z'+ updated_at: '2026-07-29T08:37:04.109Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -2186,6 +2168,45 @@ paths:example: prod_abc123required:- product_id+ "/api/v3/admin/categories/{category_id}/products/{id}":+ delete:+ summary: Remove a product from a category+ tags:+ - Categories+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Removes a product from the category's manual classification.++ **Required scope:** `write_categories` (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: category_id+ in: path+ required: true+ description: Category ID+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Product ID+ schema:+ type: string+ responses:+ '204':+ description: product removed"/api/v3/admin/categories/{category_id}/products/{id}/reposition":patch:summary: Reposition a category product@@ -2301,8 +2322,8 @@ paths:preferred_order_routing_strategy:preferred_storefront_access:preferred_guest_checkout:- created_at: '2026-07-27T19:59:58.883Z'- updated_at: '2026-07-27T19:59:58.883Z'+ created_at: '2026-07-29T08:36:53.679Z'+ updated_at: '2026-07-29T08:36:53.679Z'- id: ch_gbHJdmfrXBname: Wholesalecode: wholesale@@ -2313,8 +2334,8 @@ paths:preferred_order_routing_strategy:preferred_storefront_access:preferred_guest_checkout:- created_at: '2026-07-27T20:00:09.837Z'- updated_at: '2026-07-27T20:00:09.837Z'+ created_at: '2026-07-29T08:37:05.105Z'+ updated_at: '2026-07-29T08:37:05.105Z'meta:page: 1limit: 25@@ -2399,8 +2420,8 @@ paths:preferred_order_routing_strategy:preferred_storefront_access:preferred_guest_checkout:- created_at: '2026-07-27T20:00:10.427Z'- updated_at: '2026-07-27T20:00:10.427Z'+ created_at: '2026-07-29T08:37:05.681Z'+ updated_at: '2026-07-29T08:37:05.681Z'requestBody:content:application/json:@@ -2498,8 +2519,8 @@ paths:preferred_order_routing_strategy:preferred_storefront_access:preferred_guest_checkout:- created_at: '2026-07-27T20:00:10.439Z'- updated_at: '2026-07-27T20:00:10.439Z'+ created_at: '2026-07-29T08:37:05.692Z'+ updated_at: '2026-07-29T08:37:05.692Z'patch:summary: Update a channeltags:@@ -2553,8 +2574,8 @@ paths:preferred_order_routing_strategy:preferred_storefront_access: login_requiredpreferred_guest_checkout: false- created_at: '2026-07-27T20:00:10.727Z'- updated_at: '2026-07-27T20:00:11.011Z'+ created_at: '2026-07-29T08:37:05.982Z'+ updated_at: '2026-07-29T08:37:06.265Z'requestBody:content:application/json:@@ -2836,8 +2857,8 @@ paths:- id: orule_UkLWZg9DAJposition: 1active: true- created_at: '2026-07-27T19:59:58.888Z'- updated_at: '2026-07-27T19:59:58.888Z'+ created_at: '2026-07-29T08:36:53.683Z'+ updated_at: '2026-07-29T08:36:53.683Z'type: preferred_locationchannel_id: ch_UkLWZg9DAJpreferences: {}@@ -2848,8 +2869,8 @@ paths:- id: orule_gbHJdmfrXBposition: 2active: true- created_at: '2026-07-27T19:59:58.891Z'- updated_at: '2026-07-27T19:59:58.891Z'+ created_at: '2026-07-29T08:36:53.688Z'+ updated_at: '2026-07-29T08:36:53.688Z'type: minimize_splitschannel_id: ch_UkLWZg9DAJpreferences: {}@@ -2860,8 +2881,8 @@ paths:- id: orule_EfhxLZ9ck8position: 3active: true- created_at: '2026-07-27T19:59:58.895Z'- updated_at: '2026-07-27T19:59:58.895Z'+ created_at: '2026-07-29T08:36:53.691Z'+ updated_at: '2026-07-29T08:36:53.691Z'type: default_locationchannel_id: ch_UkLWZg9DAJpreferences: {}@@ -2926,8 +2947,8 @@ paths:id: orule_VqXmZF31wYposition: 3active: true- created_at: '2026-07-27T20:00:47.726Z'- updated_at: '2026-07-27T20:00:47.726Z'+ created_at: '2026-07-29T08:37:51.476Z'+ updated_at: '2026-07-29T08:37:51.476Z'type: default_locationchannel_id: ch_UkLWZg9DAJpreferences: {}@@ -3022,8 +3043,8 @@ paths:id: orule_UkLWZg9DAJposition: 2active: false- created_at: '2026-07-27T19:59:58.888Z'- updated_at: '2026-07-27T20:00:48.291Z'+ created_at: '2026-07-29T08:36:53.683Z'+ updated_at: '2026-07-29T08:37:52.034Z'type: preferred_locationchannel_id: ch_UkLWZg9DAJpreferences: {}@@ -3211,8 +3232,8 @@ paths:searchable: falsesortable: falsefilter_key: cf_specs_fabric- created_at: '2026-07-27T20:00:12.346Z'- updated_at: '2026-07-27T20:00:12.346Z'+ created_at: '2026-07-29T08:37:11.196Z'+ updated_at: '2026-07-29T08:37:11.196Z'- id: cfdef_gbHJdmfrXBnamespace: customkey: order_notes@@ -3223,8 +3244,8 @@ paths:searchable: falsesortable: falsefilter_key: cf_custom_order_notes- created_at: '2026-07-27T20:00:12.347Z'- updated_at: '2026-07-27T20:00:12.347Z'+ created_at: '2026-07-29T08:37:11.197Z'+ updated_at: '2026-07-29T08:37:11.197Z'meta:page: 1limit: 25@@ -3293,8 +3314,8 @@ paths:searchable: falsesortable: falsefilter_key: cf_specs_origin- created_at: '2026-07-27T20:00:12.904Z'- updated_at: '2026-07-27T20:00:12.904Z'+ created_at: '2026-07-29T08:37:11.759Z'+ updated_at: '2026-07-29T08:37:11.759Z'requestBody:content:application/json:@@ -3402,8 +3423,8 @@ paths:searchable: falsesortable: falsefilter_key: cf_specs_fabric- created_at: '2026-07-27T20:00:12.908Z'- updated_at: '2026-07-27T20:00:12.908Z'+ created_at: '2026-07-29T08:37:11.763Z'+ updated_at: '2026-07-29T08:37:11.763Z'patch:summary: Update a custom field definitiontags:@@ -3463,8 +3484,8 @@ paths:searchable: falsesortable: falsefilter_key: cf_specs_fabric- created_at: '2026-07-27T20:00:13.189Z'- updated_at: '2026-07-27T20:00:13.470Z'+ created_at: '2026-07-29T08:37:12.043Z'+ updated_at: '2026-07-29T08:37:12.315Z'requestBody:content:application/json:@@ -3610,14 +3631,14 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 0- created_at: '2026-07-27T20:00:13.762Z'- updated_at: '2026-07-27T20:00:13.762Z'+ created_at: '2026-07-29T08:37:12.609Z'+ updated_at: '2026-07-29T08:37:12.609Z'- id: cg_gbHJdmfrXBname: Wholesaledescription:customers_count: 0- created_at: '2026-07-27T20:00:13.763Z'- updated_at: '2026-07-27T20:00:13.763Z'+ created_at: '2026-07-29T08:37:12.610Z'+ updated_at: '2026-07-29T08:37:12.610Z'meta:page: 1limit: 25@@ -3706,8 +3727,8 @@ paths:name: Wholesale 2description: B2B accountscustomers_count: 1- created_at: '2026-07-27T20:00:14.614Z'- updated_at: '2026-07-27T20:00:14.614Z'+ created_at: '2026-07-29T08:37:13.482Z'+ updated_at: '2026-07-29T08:37:13.482Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -3816,24 +3837,24 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 1- created_at: '2026-07-27T20:00:15.210Z'- updated_at: '2026-07-27T20:00:15.210Z'+ created_at: '2026-07-29T08:37:14.063Z'+ updated_at: '2026-07-29T08:37:14.063Z'customers:- id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Weston- last_name: Halvorson+ email: [email protected]+ first_name: Shu+ last_name: Ankundingphone:accepts_email_marketing: false- full_name: Weston Halvorson+ full_name: Shu Ankundingavailable_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-07-27T20:00:15.472Z'- updated_at: '2026-07-27T20:00:15.472Z'+ created_at: '2026-07-29T08:37:14.326Z'+ updated_at: '2026-07-29T08:37:14.326Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -3916,8 +3937,8 @@ paths:name: VIP customers (Q1)description: Top spenderscustomers_count: 0- created_at: '2026-07-27T20:00:16.053Z'- updated_at: '2026-07-27T20:00:16.329Z'+ created_at: '2026-07-29T08:37:14.909Z'+ updated_at: '2026-07-29T08:37:15.187Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -4076,8 +4097,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-07-27T20:00:17.181Z'- updated_at: '2026-07-27T20:00:17.181Z'+ created_at: '2026-07-29T08:37:16.022Z'+ updated_at: '2026-07-29T08:37:16.022Z'customer_id: cus_UkLWZg9DAJmeta:page: 1@@ -4170,8 +4191,8 @@ paths:state_name: New Yorklabel: Officemetadata: {}- created_at: '2026-07-27T20:00:18.540Z'- updated_at: '2026-07-27T20:00:18.540Z'+ created_at: '2026-07-29T08:37:17.382Z'+ updated_at: '2026-07-29T08:37:17.382Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -4285,8 +4306,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-07-27T20:00:18.809Z'- updated_at: '2026-07-27T20:00:19.351Z'+ created_at: '2026-07-29T08:37:17.654Z'+ updated_at: '2026-07-29T08:37:18.230Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -4425,8 +4446,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-07-27T20:00:20.435Z'- updated_at: '2026-07-27T20:00:20.435Z'+ created_at: '2026-07-29T08:37:19.338Z'+ updated_at: '2026-07-29T08:37:19.338Z'meta:page: 1limit: 25@@ -4516,8 +4537,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-07-27T20:00:20.997Z'- updated_at: '2026-07-27T20:00:20.997Z'+ created_at: '2026-07-29T08:37:19.945Z'+ updated_at: '2026-07-29T08:37:19.945Z'delete:summary: Delete a customer credit cardtags:@@ -4642,8 +4663,8 @@ paths:currency: USDmemo:metadata: {}- created_at: '2026-07-27T20:00:22.373Z'- updated_at: '2026-07-27T20:00:22.373Z'+ created_at: '2026-07-29T08:37:21.304Z'+ updated_at: '2026-07-29T08:37:21.304Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -4722,8 +4743,8 @@ paths:currency: USDmemo: Goodwillmetadata: {}- created_at: '2026-07-27T20:00:23.466Z'- updated_at: '2026-07-27T20:00:23.466Z'+ created_at: '2026-07-29T08:37:22.427Z'+ updated_at: '2026-07-29T08:37:22.427Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_gbHJdmfrXBcategory_id: sccat_UkLWZg9DAJ@@ -4818,8 +4839,8 @@ paths:currency: USDmemo: Updatedmetadata: {}- created_at: '2026-07-27T20:00:24.001Z'- updated_at: '2026-07-27T20:00:24.282Z'+ created_at: '2026-07-29T08:37:23.024Z'+ updated_at: '2026-07-29T08:37:23.328Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -4980,8 +5001,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-07-27T20:00:25.364Z'- updated_at: '2026-07-27T20:00:25.364Z'+ created_at: '2026-07-29T08:37:24.608Z'+ updated_at: '2026-07-29T08:37:24.608Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -5069,8 +5090,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-07-27T20:00:26.198Z'- updated_at: '2026-07-27T20:00:26.198Z'+ created_at: '2026-07-29T08:37:25.465Z'+ updated_at: '2026-07-29T08:37:25.465Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -5190,8 +5211,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-07-27T20:00:26.467Z'- updated_at: '2026-07-27T20:00:26.467Z'+ created_at: '2026-07-29T08:37:25.736Z'+ updated_at: '2026-07-29T08:37:25.736Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -5269,8 +5290,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-07-27T20:00:27.014Z'- updated_at: '2026-07-27T20:00:27.307Z'+ created_at: '2026-07-29T08:37:26.282Z'+ updated_at: '2026-07-29T08:37:26.559Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -5719,10 +5740,10 @@ paths:example:data:- id: exp_UkLWZg9DAJ- number: EF092919737+ number: EF825112788format: csv- created_at: '2026-07-27T20:00:31.464Z'- updated_at: '2026-07-27T20:00:31.464Z'+ created_at: '2026-07-29T08:37:31.845Z'+ updated_at: '2026-07-29T08:37:31.845Z'type: productsuser_id: admin_UkLWZg9DAJdone: false@@ -5793,10 +5814,10 @@ paths:application/json:example:id: exp_gbHJdmfrXB- number: EF926124188+ number: EF405144259format: csv- created_at: '2026-07-27T20:00:31.764Z'- updated_at: '2026-07-27T20:00:31.764Z'+ created_at: '2026-07-29T08:37:32.138Z'+ updated_at: '2026-07-29T08:37:32.138Z'type: productsuser_id: admin_UkLWZg9DAJdone: false@@ -5893,10 +5914,10 @@ paths:application/json:example:id: exp_UkLWZg9DAJ- number: EF786153581+ number: EF226804590format: csv- created_at: '2026-07-27T20:00:32.034Z'- updated_at: '2026-07-27T20:00:32.034Z'+ created_at: '2026-07-29T08:37:32.409Z'+ updated_at: '2026-07-29T08:37:32.409Z'type: productsuser_id: admin_UkLWZg9DAJdone: false@@ -6079,9 +6100,11 @@ paths:example:data:- id: ful_UkLWZg9DAJ- number: H22848285025+ number: F10210831453tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_EfhxLZ9ck8cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6103,9 +6126,9 @@ paths:quantity: 1metadata: {}adjustment_total: '0.0'- pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:49.207Z'- updated_at: '2026-07-27T20:00:49.274Z'+ pre_tax_amount: '100.0'+ created_at: '2026-07-29T08:37:52.929Z'+ updated_at: '2026-07-29T08:37:52.986Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJmeta:@@ -6175,9 +6198,11 @@ paths:application/json:example:id: ful_gbHJdmfrXB- number: H57282126368+ number: F37324713730tracking: INPOST-12345tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_VqXmZF31wYcost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6190,9 +6215,9 @@ paths:display_included_tax_total: "$0.00"tax_total: '0.0'display_tax_total: "$0.00"- status: shipped+ status: fulfilledfulfillment_type: shipping- fulfilled_at: '2026-07-27T20:00:50Z'+ fulfilled_at: '2026-07-29T08:37:54Z'items:- item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJ@@ -6200,8 +6225,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:50.223Z'- updated_at: '2026-07-27T20:00:50.241Z'+ created_at: '2026-07-29T08:37:54.034Z'+ updated_at: '2026-07-29T08:37:54.059Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ'422':@@ -6341,9 +6366,11 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H39128930875+ number: F81074402860tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_EfhxLZ9ck8cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6365,9 +6392,9 @@ paths:quantity: 1metadata: {}adjustment_total: '0.0'- pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:51.524Z'- updated_at: '2026-07-27T20:00:51.575Z'+ pre_tax_amount: '100.0'+ created_at: '2026-07-29T08:37:55.400Z'+ updated_at: '2026-07-29T08:37:55.440Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJpatch:@@ -6429,9 +6456,11 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H98676755303+ number: F46781562312tracking: 1Z999AA10123456784tracking_url: https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=1Z999AA10123456784+ pickup_point_data:+ selected_delivery_rate_id: dr_EfhxLZ9ck8cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6453,9 +6482,9 @@ paths:quantity: 1metadata: {}adjustment_total: '0.0'- pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:52.169Z'- updated_at: '2026-07-27T20:00:52.496Z'+ pre_tax_amount: '100.0'+ created_at: '2026-07-29T08:37:56.031Z'+ updated_at: '2026-07-29T08:37:56.364Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJrequestBody:@@ -6531,9 +6560,11 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H43758153206+ number: F40205948652tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_EfhxLZ9ck8cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6546,18 +6577,18 @@ paths:display_included_tax_total: "$0.00"tax_total: '0.0'display_tax_total: "$0.00"- status: shipped+ status: fulfilledfulfillment_type: shipping- fulfilled_at: '2026-07-27T20:00:53Z'+ fulfilled_at: '2026-07-29T08:37:56Z'items:- item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1metadata: {}adjustment_total: '0.0'- pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:52.824Z'- updated_at: '2026-07-27T20:00:53.162Z'+ pre_tax_amount: '100.0'+ created_at: '2026-07-29T08:37:56.671Z'+ updated_at: '2026-07-29T08:37:56.997Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":@@ -6619,9 +6650,11 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H28848383571+ number: F88082709992tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_EfhxLZ9ck8cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6643,9 +6676,9 @@ paths:quantity: 1metadata: {}adjustment_total: '0.0'- pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:53.493Z'- updated_at: '2026-07-27T20:00:53.825Z'+ pre_tax_amount: '100.0'+ created_at: '2026-07-29T08:37:57.315Z'+ updated_at: '2026-07-29T08:37:57.646Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":@@ -6707,9 +6740,11 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H41517579550+ number: F27787193963tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_EfhxLZ9ck8cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6731,9 +6766,9 @@ paths:quantity: 1metadata: {}adjustment_total: '0.0'- pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:54.169Z'- updated_at: '2026-07-27T20:00:54.511Z'+ pre_tax_amount: '100.0'+ created_at: '2026-07-29T08:37:57.966Z'+ updated_at: '2026-07-29T08:37:58.296Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":@@ -6797,9 +6832,11 @@ paths:example:data:- id: ful_gbHJdmfrXB- number: H90746305483+ number: F74012925926tracking:tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_uw2YK1rnl0cost: '10.0'display_cost: "$10.00"total: '10.0'@@ -6822,8 +6859,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-07-27T20:00:55.293Z'- updated_at: '2026-07-27T20:00:55.340Z'+ created_at: '2026-07-29T08:37:58.947Z'+ updated_at: '2026-07-29T08:37:58.978Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_gbHJdmfrXBrequestBody:@@ -6922,8 +6959,8 @@ paths:codes_count: 2currency: USDprefix: WELCOME- created_at: '2026-07-27T20:00:32.682Z'- updated_at: '2026-07-27T20:00:32.682Z'+ created_at: '2026-07-29T08:37:32.996Z'+ updated_at: '2026-07-29T08:37:32.996Z'amount: '50.0'expires_at:created_by_id:@@ -7007,8 +7044,8 @@ paths:codes_count: 5currency: USDprefix: NEWCAMP- created_at: '2026-07-27T20:00:33.266Z'- updated_at: '2026-07-27T20:00:33.266Z'+ created_at: '2026-07-29T08:37:33.678Z'+ updated_at: '2026-07-29T08:37:33.678Z'amount: '25.0'expires_at: '2030-12-31'created_by_id: admin_UkLWZg9DAJ@@ -7112,8 +7149,8 @@ paths:codes_count: 2currency: USDprefix: WELCOME- created_at: '2026-07-27T20:00:33.564Z'- updated_at: '2026-07-27T20:00:33.564Z'+ created_at: '2026-07-29T08:37:34.071Z'+ updated_at: '2026-07-29T08:37:34.071Z'amount: '50.0'expires_at:created_by_id:@@ -7219,7 +7256,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: C249A72EFCB55D1F+ code: FD05314751E0A06Astatus: activecurrency: USDamount: '50.0'@@ -7233,12 +7270,12 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-07-27T20:00:34.147Z'- updated_at: '2026-07-27T20:00:34.147Z'+ created_at: '2026-07-29T08:37:34.751Z'+ updated_at: '2026-07-29T08:37:34.751Z'customer_id:created_by_id:- id: gc_gbHJdmfrXB- code: 88EC46FC5AFBB800+ code: F4D00786A114D454status: activecurrency: USDamount: '25.0'@@ -7252,8 +7289,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-07-27T20:00:34.148Z'- updated_at: '2026-07-27T20:00:34.148Z'+ created_at: '2026-07-29T08:37:34.752Z'+ updated_at: '2026-07-29T08:37:34.752Z'customer_id:created_by_id:meta:@@ -7341,7 +7378,7 @@ paths:application/json:example:id: gc_EfhxLZ9ck8- code: FF819AE2DC53F483+ code: A62A8458BD3119D7status: activecurrency: USDamount: '25.0'@@ -7355,8 +7392,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-07-27T20:00:34.738Z'- updated_at: '2026-07-27T20:00:34.738Z'+ created_at: '2026-07-29T08:37:35.339Z'+ updated_at: '2026-07-29T08:37:35.339Z'customer_id:created_by_id: admin_UkLWZg9DAJschema:@@ -7465,7 +7502,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 92B7BC62609DC882+ code: 9DC41B9D49DC1BEBstatus: activecurrency: USDamount: '50.0'@@ -7479,8 +7516,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-07-27T20:00:35.062Z'- updated_at: '2026-07-27T20:00:35.062Z'+ created_at: '2026-07-29T08:37:35.652Z'+ updated_at: '2026-07-29T08:37:35.652Z'customer_id:created_by_id:schema:@@ -7543,7 +7580,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: FD0325D1399A9589+ code: 1BD677E826FE2CC8status: activecurrency: USDamount: '75.0'@@ -7557,8 +7594,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-07-27T20:00:35.647Z'- updated_at: '2026-07-27T20:00:35.931Z'+ created_at: '2026-07-29T08:37:36.293Z'+ updated_at: '2026-07-29T08:37:36.572Z'customer_id:created_by_id:schema:@@ -7661,10 +7698,10 @@ paths:example:data:- id: imp_UkLWZg9DAJ- number: IM204548010+ number: IM797794902rows_count: 0- created_at: '2026-07-27T20:00:36.798Z'- updated_at: '2026-07-27T20:00:36.806Z'+ created_at: '2026-07-29T08:37:37.455Z'+ updated_at: '2026-07-29T08:37:37.462Z'type: productsstatus: pendingowner_type: store@@ -7840,10 +7877,10 @@ paths:application/json:example:id: imp_gbHJdmfrXB- number: IM356592378+ number: IM473572849rows_count: 0- created_at: '2026-07-27T20:00:37.122Z'- updated_at: '2026-07-27T20:00:37.171Z'+ created_at: '2026-07-29T08:37:37.780Z'+ updated_at: '2026-07-29T08:37:37.826Z'type: productsstatus: mappingowner_type: store@@ -8278,10 +8315,10 @@ paths:application/json:example:id: imp_UkLWZg9DAJ- number: IM602867622+ number: IM285428266rows_count: 0- created_at: '2026-07-27T20:00:38.335Z'- updated_at: '2026-07-27T20:00:38.344Z'+ created_at: '2026-07-29T08:37:38.985Z'+ updated_at: '2026-07-29T08:37:38.991Z'type: productsstatus: pendingowner_type: store@@ -8515,10 +8552,10 @@ paths:application/json:example:id: imp_gbHJdmfrXB- number: IM228704951+ number: IM489787332rows_count: 0- created_at: '2026-07-27T20:00:39.264Z'- updated_at: '2026-07-27T20:00:39.330Z'+ created_at: '2026-07-29T08:37:39.886Z'+ updated_at: '2026-07-29T08:37:39.945Z'type: productsstatus: completed_mappingowner_type: store@@ -8851,10 +8888,10 @@ paths:application/json:example:id: imp_gbHJdmfrXB- number: IM634836351+ number: IM462772260rows_count: 1- created_at: '2026-07-27T20:00:39.621Z'- updated_at: '2026-07-27T20:00:39.647Z'+ created_at: '2026-07-29T08:37:40.232Z'+ updated_at: '2026-07-29T08:37:40.251Z'type: productsstatus: processingowner_type: store@@ -9027,8 +9064,8 @@ paths:row_number: 2status: failedvalidation_errors: boom- created_at: '2026-07-27T20:00:39.936Z'- updated_at: '2026-07-27T20:00:39.936Z'+ created_at: '2026-07-29T08:37:40.533Z'+ updated_at: '2026-07-29T08:37:40.533Z'import_id: imp_UkLWZg9DAJitem_type:item_id:@@ -9121,6 +9158,18 @@ paths:example:data:- id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ - id: mkt_gbHJdmfrXBname: EUcurrency: USDdefault_locale: en@@ -9130,16 +9179,16 @@ paths:- DEsupported_locales:- en- created_at: '2026-07-27T20:00:41.516Z'- updated_at: '2026-07-27T20:00:41.516Z'+ created_at: '2026-07-29T08:37:42.074Z'+ updated_at: '2026-07-29T08:37:42.074Z'meta:page: 1limit: 25- count: 1+ count: 2pages: 1from: 1- to: 1- in: 1+ to: 2+ in: 2previous:next:schema:@@ -9213,7 +9262,7 @@ paths:content:application/json:example:- id: mkt_gbHJdmfrXB+ id: mkt_EfhxLZ9ck8name: France onlycurrency: EURdefault_locale: fr@@ -9224,8 +9273,8 @@ paths:supported_locales:- en- fr- created_at: '2026-07-27T20:00:42.106Z'- updated_at: '2026-07-27T20:00:42.106Z'+ created_at: '2026-07-29T08:37:42.647Z'+ updated_at: '2026-07-29T08:37:42.647Z'schema:"$ref": "#/components/schemas/Market"'422':@@ -9351,7 +9400,7 @@ paths:content:application/json:example:- id: mkt_UkLWZg9DAJ+ id: mkt_gbHJdmfrXBname: EUcurrency: USDdefault_locale: en@@ -9361,8 +9410,8 @@ paths:- DEsupported_locales:- en- created_at: '2026-07-27T20:00:42.429Z'- updated_at: '2026-07-27T20:00:42.429Z'+ created_at: '2026-07-29T08:37:42.962Z'+ updated_at: '2026-07-29T08:37:42.962Z'schema:"$ref": "#/components/schemas/Market"'404':@@ -9431,7 +9480,7 @@ paths:content:application/json:example:- id: mkt_UkLWZg9DAJ+ id: mkt_gbHJdmfrXBname: European Unioncurrency: USDdefault_locale: en@@ -9441,8 +9490,8 @@ paths:- DEsupported_locales:- en- created_at: '2026-07-27T20:00:43.047Z'- updated_at: '2026-07-27T20:00:43.328Z'+ created_at: '2026-07-29T08:37:43.548Z'+ updated_at: '2026-07-29T08:37:43.831Z'schema:"$ref": "#/components/schemas/Market"'422':@@ -9622,8 +9671,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-07-27T20:00:44.872Z'- updated_at: '2026-07-27T20:00:44.872Z'+ created_at: '2026-07-29T08:37:45.334Z'+ updated_at: '2026-07-29T08:37:45.334Z'meta:page: 1limit: 25@@ -9717,8 +9766,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-07-27T20:00:45.447Z'- updated_at: '2026-07-27T20:00:45.447Z'+ created_at: '2026-07-29T08:37:45.967Z'+ updated_at: '2026-07-29T08:37:45.967Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -9842,8 +9891,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-07-27T20:00:45.733Z'- updated_at: '2026-07-27T20:00:45.733Z'+ created_at: '2026-07-29T08:37:46.261Z'+ updated_at: '2026-07-29T08:37:46.261Z'schema:"$ref": "#/components/schemas/OptionType"'404':@@ -9916,8 +9965,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-07-27T20:00:46.312Z'- updated_at: '2026-07-27T20:00:46.589Z'+ created_at: '2026-07-29T08:37:46.843Z'+ updated_at: '2026-07-29T08:37:47.124Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -10014,18 +10063,18 @@ paths:responses:'204':description: option type deleted- "/api/v3/admin/orders/{order_id}/gift_cards":- post:- summary: Apply a gift card to an order+ "/api/v3/admin/orders/{order_id}/tax_lines":+ get:+ summary: List tax linestags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Applies a gift card by code to the order. Returns the gift card.+ Typed tax rows on the order. Read-only — written exclusively by the tax provider.- **Required scope:** `write_gift_cards` (for API-key authentication).+ **Required scope:** `read_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -10037,12 +10086,10 @@ paths:secretKey: 'sk_xxx',})- await client.orders.giftCards.apply('or_UkLWZg9DAJ', {- code: 'GIFT-XXXX-YYYY',- })+ const { data: taxLines } = await client.orders.taxLines.list('or_abc123')- lang: bashlabel: Spree CLI- source: spree api post /orders/{order_id}/gift_cards -d '{"code":"GIFT-XXXX-YYYY"}'+ source: spree api get /orders/{order_id}/tax_linesparameters:- name: x-spree-api-keyin: header@@ -10052,116 +10099,55 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- name: order_idin: pathrequired: true- description: Order ID+ description: Order prefixed IDschema:type: stringresponses:- '201':- description: gift card applied+ '200':+ description: tax lines foundcontent:application/json:example:- id: gc_UkLWZg9DAJ- code: C228B4B05F860A11- status: active- currency: USD- amount: '10.0'- amount_used: '10.0'- amount_authorized: '0.0'- amount_remaining: '0.0'- display_amount: "$10.00"- display_amount_used: "$10.00"- display_amount_remaining: "$0.00"- expires_at:- redeemed_at:- expired: false- active: true- created_at: '2026-07-27T20:00:55.684Z'- updated_at: '2026-07-27T20:00:55.973Z'- customer_id:- created_by_id:- requestBody:- content:- application/json:- schema:- type: object- required:- - code- properties:- code:- type: string- description: Gift card code- example: GIFT-XXXX-YYYY- "/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.-- **Required scope:** `write_gift_cards` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- await client.orders.giftCards.remove('or_UkLWZg9DAJ', 'gc_UkLWZg9DAJ')- - lang: bash- label: Spree CLI- source: spree api delete /orders/{order_id}/gift_cards/{id}- 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":+ data:+ - id: tl_UkLWZg9DAJ+ label: VAT 15%+ included: false+ rate: '0.15'+ tax_rate_id:+ line_item_id: li_UkLWZg9DAJ+ fulfillment_id:+ fee_id:+ amount: '1.5'+ display_amount: "$1.50"+ provider_id: internal+ metadata: {}+ created_at: '2026-07-29T08:37:48.144Z'+ updated_at: '2026-07-29T08:37:48.144Z'+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ "/api/v3/admin/orders/{order_id}/discounts":get:- summary: List order items+ summary: List discountstags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns all line items for an order.+ Typed discount rows (promotion-sourced and manual) on the order.**Required scope:** `read_orders` (for API-key authentication).x-codeSamples:@@ -10175,10 +10161,10 @@ paths:secretKey: 'sk_xxx',})- const { data: items } = await client.orders.items.list('or_UkLWZg9DAJ')+ const { data: discounts } = await client.orders.discounts.list('or_abc123')- lang: bashlabel: Spree CLI- source: spree api get /orders/{order_id}/items+ source: spree api get /orders/{order_id}/discountsparameters:- name: x-spree-api-keyin: header@@ -10188,83 +10174,35 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- name: order_idin: pathrequired: 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.+ description: Order prefixed IDschema:type: stringresponses:'200':- description: items found+ description: discounts foundcontent:application/json:example:data:- - id: li_UkLWZg9DAJ- variant_id: variant_gbHJdmfrXB- preorder: false- preorder_ships_at:- quantity: 2- currency: USD- name: Product 17510- slug: product-17510- options_text: 'Size: S'- price: '10.0'- display_price: "$10.00"- total: '20.0'- display_total: "$20.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- pre_tax_amount: '20.0'- display_pre_tax_amount: "$20.00"- discounted_amount: '20.0'- display_discounted_amount: "$20.00"- display_compare_at_amount: "$0.00"- compare_at_amount:- thumbnail_url:- option_values:- - id: optval_UkLWZg9DAJ- option_type_id: opt_UkLWZg9DAJ- name: size-1- label: S- position: 1- color_code:- option_type_name: foo-size-10- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:00:56.643Z'- updated_at: '2026-07-27T20:00:56.643Z'- digital_links: []+ - id: disc_UkLWZg9DAJ+ label: Loyalty+ kind: manual+ code:+ value_type:+ value:+ promotion_id:+ line_item_id: li_UkLWZg9DAJ+ fulfillment_id:+ amount: "-2.0"+ display_amount: "-$2.00"metadata: {}- created_at: '2026-07-27T20:00:56.921Z'- updated_at: '2026-07-27T20:00:56.921Z'- cost_price: '17.0'- tax_category_id: taxcat_UkLWZg9DAJ+ created_at: '2026-07-29T08:37:48.766Z'+ updated_at: '2026-07-29T08:37:48.766Z'meta:page: 1limit: 25@@ -10276,14 +10214,14 @@ paths:previous:next:post:- summary: Add an item+ summary: Create manual discounttags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Adds a new line item to the order.+ Creates a manual discount. With line_item_id a single row is created; without it the amount is distributed across line items (largest remainder). This is the sanctioned post-placement discount path and works on completed orders.**Required scope:** `write_orders` (for API-key authentication).x-codeSamples:@@ -10297,13 +10235,17 @@ paths:secretKey: 'sk_xxx',})- const item = await client.orders.items.create('or_UkLWZg9DAJ', {- variant_id: 'variant_k5nR8xLq',- quantity: 2,+ // Line-item discount; omit line_item_id to distribute across the order.+ const { data: discounts } = await client.orders.discounts.create('or_abc123', {+ label: 'Customer appeasement',+ value: 10,+ value_type: 'flat',+ line_item_id: 'item_abc123',})- lang: bashlabel: Spree CLI- source: spree api post /orders/{order_id}/items -d '{"variant_id":"variant_k5nR8xLq","quantity":2}'+ source: spree api post /orders/{order_id}/discounts -d '{"label":"Customer+ appeasement","value":10,"value_type":"flat","line_item_id":"item_abc123"}'parameters:- name: x-spree-api-keyin: header@@ -10313,94 +10255,81 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- name: order_idin: pathrequired: true- description: Order ID+ description: Order prefixed IDschema:type: stringresponses:'201':- description: item added+ description: discount createdcontent:application/json:example:- id: li_gbHJdmfrXB- variant_id: variant_VqXmZF31wY- preorder: false- preorder_ships_at:- quantity: 3- currency: USD- name: Product 19115- slug: product-19115- options_text: 'Size: S'- price: '19.99'- display_price: "$19.99"- total: '59.97'- display_total: "$59.97"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- pre_tax_amount: '59.97'- display_pre_tax_amount: "$59.97"- discounted_amount: '59.97'- display_discounted_amount: "$59.97"- display_compare_at_amount: "$0.00"- compare_at_amount:- thumbnail_url:- option_values:- - id: optval_gbHJdmfrXB- option_type_id: opt_gbHJdmfrXB- name: size-3- label: S- position: 1- color_code:- option_type_name: foo-size-12- option_type_label: Size- image_url:+ data:+ - id: disc_UkLWZg9DAJ+ label: Appeasement+ kind: manual+ code:+ value_type: flat+ value: '3.0'+ promotion_id:+ line_item_id: li_UkLWZg9DAJ+ fulfillment_id:+ amount: "-3.0"+ display_amount: "-$3.00"metadata: {}- created_at: '2026-07-27T20:00:57.836Z'- updated_at: '2026-07-27T20:00:57.836Z'- digital_links: []- metadata: {}- created_at: '2026-07-27T20:00:57.865Z'- updated_at: '2026-07-27T20:00:57.865Z'- cost_price: '17.0'- tax_category_id: taxcat_UkLWZg9DAJ+ created_at: '2026-07-29T08:37:49.661Z'+ updated_at: '2026-07-29T08:37:49.661Z'+ '422':+ description: invalid discount+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: discount value must be a positive numberrequestBody:content:application/json:schema:type: object- required:- - variant_idproperties:- variant_id:+ label:type: string- description: Prefixed variant ID- quantity:- type: integer- default: 1- "/api/v3/admin/orders/{order_id}/items/{id}":- get:- summary: Show an item+ example: Customer appeasement+ value:+ type: number+ example: 10+ value_type:+ type: string+ enum:+ - flat+ - percent+ example: flat+ line_item_id:+ type: string+ nullable: true+ example: item_abc123+ description: Target line item; omit to distribute order-level+ required:+ - label+ - value+ "/api/v3/admin/orders/{order_id}/fees":+ post:+ summary: Create feetags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns details of a specific line item.+ Creates a fee (surcharge, handling, gift wrap, COD). Order-level when no target is given. Works on completed orders.- **Required scope:** `read_orders` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -10412,10 +10341,14 @@ paths:secretKey: 'sk_xxx',})- const item = await client.orders.items.get('or_UkLWZg9DAJ', 'li_UkLWZg9DAJ')+ const fee = await client.orders.fees.create('or_abc123', {+ label: 'Gift wrap',+ amount: 4,+ kind: 'gift_wrap',+ })- lang: bashlabel: Spree CLI- source: spree api get /orders/{order_id}/items/{id}+ source: spree api post /orders/{order_id}/fees -d '{"label":"Gift wrap","amount":4,"kind":"gift_wrap"}'parameters:- name: x-spree-api-keyin: header@@ -10425,99 +10358,67 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- name: order_idin: pathrequired: 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.+ description: Order prefixed IDschema:type: stringresponses:- '200':- description: item found+ '201':+ description: fee createdcontent:application/json:example:- id: li_UkLWZg9DAJ- variant_id: variant_gbHJdmfrXB- preorder: false- preorder_ships_at:- quantity: 2- currency: USD- name: Product 203163- slug: product-203163- options_text: 'Size: S'- price: '10.0'- display_price: "$10.00"- total: '20.0'- display_total: "$20.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- pre_tax_amount: '20.0'- display_pre_tax_amount: "$20.00"- discounted_amount: '20.0'- display_discounted_amount: "$20.00"- display_compare_at_amount: "$0.00"- compare_at_amount:- thumbnail_url:- option_values:- - id: optval_UkLWZg9DAJ- option_type_id: opt_UkLWZg9DAJ- name: size-4- label: S- position: 1- color_code:- option_type_name: foo-size-13- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:00:57.948Z'- updated_at: '2026-07-27T20:00:57.948Z'- digital_links: []+ id: fee_UkLWZg9DAJ+ label: Gift wrap+ kind: gift_wrap+ line_item_id:+ fulfillment_id:+ amount: '4.0'+ display_amount: "$4.00"metadata: {}- created_at: '2026-07-27T20:00:58.238Z'- updated_at: '2026-07-27T20:00:58.238Z'- cost_price: '17.0'- tax_category_id: taxcat_UkLWZg9DAJ- patch:- summary: Update an item+ created_at: '2026-07-29T08:37:50.903Z'+ updated_at: '2026-07-29T08:37:50.903Z'+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ label:+ type: string+ example: Gift wrap+ amount:+ type: number+ example: 4+ kind:+ type: string+ example: gift_wrap+ description: Defaults to 'surcharge'+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:+ type: string+ nullable: true+ required:+ - label+ - amount+ "/api/v3/admin/orders/{order_id}/gift_cards":+ post:+ summary: Apply a gift card to an ordertags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Updates an order item quantity or metadata.+ Applies a gift card by code to the order. Returns the gift card.- **Required scope:** `write_orders` (for API-key authentication).+ **Required scope:** `write_gift_cards` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -10529,12 +10430,12 @@ paths:secretKey: 'sk_xxx',})- const item = await client.orders.items.update('or_UkLWZg9DAJ', 'li_UkLWZg9DAJ', {- quantity: 5,+ await client.orders.giftCards.apply('or_UkLWZg9DAJ', {+ code: 'GIFT-XXXX-YYYY',})- lang: bashlabel: Spree CLI- source: spree api patch /orders/{order_id}/items/{id} -d '{"quantity":5}'+ source: spree api post /orders/{order_id}/gift_cards -d '{"code":"GIFT-XXXX-YYYY"}'parameters:- name: x-spree-api-keyin: header@@ -10553,84 +10454,55 @@ paths:description: Order IDschema:type: string- - name: id- in: path- required: true- description: Item ID- schema:- type: stringresponses:- '200':- description: item updated+ '201':+ description: gift card appliedcontent:application/json:example:- id: li_UkLWZg9DAJ- variant_id: variant_gbHJdmfrXB- preorder: false- preorder_ships_at:- quantity: 5+ id: gc_UkLWZg9DAJ+ code: 622E9D2E113FAC43+ status: activecurrency: USD- name: Product 214628- slug: product-214628- options_text: 'Size: S'- price: '19.99'- display_price: "$19.99"- total: '99.95'- display_total: "$99.95"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- pre_tax_amount: '99.95'- display_pre_tax_amount: "$99.95"- discounted_amount: '99.95'- display_discounted_amount: "$99.95"- display_compare_at_amount: "$0.00"- compare_at_amount:- thumbnail_url:- option_values:- - id: optval_UkLWZg9DAJ- option_type_id: opt_UkLWZg9DAJ- name: size-5- label: S- position: 1- color_code:- option_type_name: foo-size-14- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:00:58.587Z'- updated_at: '2026-07-27T20:00:58.587Z'- digital_links: []- metadata: {}- created_at: '2026-07-27T20:00:58.875Z'- updated_at: '2026-07-27T20:00:59.177Z'- cost_price: '17.0'- tax_category_id: taxcat_UkLWZg9DAJ+ amount: '10.0'+ amount_used: '10.0'+ amount_authorized: '0.0'+ amount_remaining: '0.0'+ display_amount: "$10.00"+ display_amount_used: "$10.00"+ display_amount_remaining: "$0.00"+ expires_at:+ redeemed_at:+ expired: false+ active: true+ created_at: '2026-07-29T08:37:59.313Z'+ updated_at: '2026-07-29T08:37:59.612Z'+ customer_id:+ created_by_id:requestBody:content:application/json:schema:type: object+ required:+ - codeproperties:- quantity:- type: integer+ code:+ type: string+ description: Gift card code+ example: GIFT-XXXX-YYYY+ "/api/v3/admin/orders/{order_id}/gift_cards/{id}":delete:- summary: Remove an item+ summary: Remove a gift card from an ordertags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Removes an item from the order.+ Removes the gift card from the order.- **Required scope:** `write_orders` (for API-key authentication).+ **Required scope:** `write_gift_cards` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -10642,10 +10514,10 @@ paths:secretKey: 'sk_xxx',})- await client.orders.items.delete('or_UkLWZg9DAJ', 'li_UkLWZg9DAJ')+ await client.orders.giftCards.remove('or_UkLWZg9DAJ', 'gc_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api delete /orders/{order_id}/items/{id}+ source: spree api delete /orders/{order_id}/gift_cards/{id}parameters:- name: x-spree-api-keyin: header@@ -10667,24 +10539,24 @@ paths:- name: idin: pathrequired: true- description: Item ID+ description: Gift card IDschema:type: stringresponses:'204':- description: line item removed- "/api/v3/admin/orders/{order_id}/store_credits":- post:- summary: Apply customer's store credit to an order+ description: gift card removed+ "/api/v3/admin/orders/{order_id}/items":+ get:+ summary: List order itemstags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Applies the order customer's available store credit. When `amount` is omitted, applies up to the order outstanding balance.+ Returns all line items for an order.- **Required scope:** `write_store_credits` (for API-key authentication).+ **Required scope:** `read_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -10696,12 +10568,10 @@ paths:secretKey: 'sk_xxx',})- const order = await client.orders.storeCredits.apply('or_UkLWZg9DAJ', {- amount: '25.00',- })+ const { data: items } = await client.orders.items.list('or_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api post /orders/{order_id}/store_credits -d '{"amount":"25.00"}'+ source: spree api get /orders/{order_id}/itemsparameters:- name: x-spree-api-keyin: header@@ -10720,89 +10590,95 @@ paths:description: Order IDschema: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: stringresponses:- '201':- description: store credit applied+ '200':+ description: items foundcontent:application/json:example:- id: or_UkLWZg9DAJ- market_id:- channel_id: ch_UkLWZg9DAJ- number: R375407510- email: [email protected]- customer_note:- currency: USD- locale: en- total_quantity: 1- fulfillment_status:- payment_status:- completed_at:- item_total: '10.0'- display_item_total: "$10.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: '60.0'- display_amount_due: "$60.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"- store_credit_total: '50.0'- display_store_credit_total: "-$50.00"- covered_by_store_credit: false- gift_card:- market:- status: draft- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '0.0'- display_payment_total: "$0.00"- metadata: {}- canceled_at:- approved_at:- created_at: '2026-07-27T20:01:05.830Z'- updated_at: '2026-07-27T20:01:05.883Z'- preferred_stock_location_id:- tags: []- internal_note:- approver_id:- canceler_id:- created_by_id:- customer_id: cus_UkLWZg9DAJ- 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+ data:+ - id: li_UkLWZg9DAJ+ variant_id: variant_gbHJdmfrXB+ preorder: false+ preorder_ships_at:+ quantity: 2+ currency: USD+ name: Product 261623+ slug: product-261623+ options_text: 'Size: S'+ price: '10.0'+ display_price: "$10.00"+ total: '20.0'+ display_total: "$20.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ pre_tax_amount: '20.0'+ display_pre_tax_amount: "$20.00"+ discounted_amount: '20.0'+ display_discounted_amount: "$20.00"+ display_compare_at_amount: "$0.00"+ compare_at_amount:+ thumbnail_url:+ option_values:+ - id: optval_UkLWZg9DAJ+ option_type_id: opt_UkLWZg9DAJ+ name: size-1+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-10+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:00.320Z'+ updated_at: '2026-07-29T08:38:00.320Z'+ digital_links: []+ metadata: {}+ created_at: '2026-07-29T08:38:00.608Z'+ updated_at: '2026-07-29T08:38:00.608Z'+ cost_price: '17.0'+ tax_category_id: taxcat_UkLWZg9DAJ+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ post:+ summary: Add an itemtags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Removes any applied store credit from the order.+ Adds a new line item to the order.- **Required scope:** `write_store_credits` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -10814,10 +10690,13 @@ paths:secretKey: 'sk_xxx',})- await client.orders.storeCredits.remove('or_UkLWZg9DAJ')+ const item = await client.orders.items.create('or_UkLWZg9DAJ', {+ variant_id: 'variant_k5nR8xLq',+ quantity: 2,+ })- lang: bashlabel: Spree CLI- source: spree api delete /orders/{order_id}/store_credits+ source: spree api post /orders/{order_id}/items -d '{"variant_id":"variant_k5nR8xLq","quantity":2}'parameters:- name: x-spree-api-keyin: header@@ -10837,18 +10716,82 @@ paths:schema:type: stringresponses:- '204':- description: store credit removed- "/api/v3/admin/orders":+ '201':+ description: item added+ content:+ application/json:+ example:+ id: li_gbHJdmfrXB+ variant_id: variant_VqXmZF31wY+ preorder: false+ preorder_ships_at:+ quantity: 3+ currency: USD+ name: Product 288930+ slug: product-288930+ options_text: 'Size: S'+ price: '19.99'+ display_price: "$19.99"+ total: '59.97'+ display_total: "$59.97"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ pre_tax_amount: '59.97'+ display_pre_tax_amount: "$59.97"+ discounted_amount: '59.97'+ display_discounted_amount: "$59.97"+ display_compare_at_amount: "$0.00"+ compare_at_amount:+ thumbnail_url:+ option_values:+ - id: optval_gbHJdmfrXB+ option_type_id: opt_gbHJdmfrXB+ name: size-3+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-12+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:01.516Z'+ updated_at: '2026-07-29T08:38:01.516Z'+ digital_links: []+ metadata: {}+ created_at: '2026-07-29T08:38:01.537Z'+ updated_at: '2026-07-29T08:38:01.537Z'+ cost_price: '17.0'+ tax_category_id: taxcat_UkLWZg9DAJ+ 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: List orders+ summary: Show an itemtags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns a paginated list of orders for the current store.+ Returns details of a specific line item.**Required scope:** `read_orders` (for API-key authentication).x-codeSamples:@@ -10862,15 +10805,10 @@ paths:secretKey: 'sk_xxx',})- const { data: orders, meta } = await client.orders.list({- status_eq: 'complete',- completed_at_gt: '2026-01-01',- sort: '-completed_at',- limit: 25,- })+ const item = await client.orders.items.get('or_UkLWZg9DAJ', 'li_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /orders -d '{"status_eq":"complete","completed_at_gt":"2026-01-01","sort":"-completed_at","limit":25}'+ source: spree api get /orders/{order_id}/items/{id}parameters:- name: x-spree-api-keyin: header@@ -10883,154 +10821,96 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: page- in: query- required: false- description: Page number+ - name: order_id+ in: path+ required: true+ description: Order IDschema:- type: integer- - name: limit- in: query- required: false- description: Number of records per page+ type: string+ - name: id+ in: path+ required: true+ description: Item IDschema:- type: integer- - name: sort+ type: string+ - name: expandin: queryrequired: false- description: Sort field (e.g., created_at, -created_at, completed_at)+ description: Comma-separated associations to expand (e.g., variant, variant.product).+ Use dot notation for nested expand (max 4 levels).schema:type: string- - name: q[state_eq]+ - name: fieldsin: queryrequired: 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).+ description: Comma-separated list of fields to include (e.g., quantity,price,total).id is always included.schema:type: stringresponses:'200':- description: orders found+ description: item foundcontent:application/json:example:- data:- - id: or_UkLWZg9DAJ- market_id:- channel_id: ch_UkLWZg9DAJ- number: R138037474- email: [email protected]- customer_note:- currency: USD- locale: en- total_quantity: 0- fulfillment_status:- payment_status:- completed_at:- item_total: '0.0'- display_item_total: "$0.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- total: '0.0'- display_total: "$0.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: '0.0'- display_amount_due: "$0.00"- delivery_total: '0.0'- display_delivery_total: "$0.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"- covered_by_store_credit: false- gift_card:- market:- status: draft- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '0.0'- display_payment_total: "$0.00"+ id: li_UkLWZg9DAJ+ variant_id: variant_gbHJdmfrXB+ preorder: false+ preorder_ships_at:+ quantity: 2+ currency: USD+ name: Product 298227+ slug: product-298227+ options_text: 'Size: S'+ price: '10.0'+ display_price: "$10.00"+ total: '20.0'+ display_total: "$20.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ pre_tax_amount: '20.0'+ display_pre_tax_amount: "$20.00"+ discounted_amount: '20.0'+ display_discounted_amount: "$20.00"+ display_compare_at_amount: "$0.00"+ compare_at_amount:+ thumbnail_url:+ option_values:+ - id: optval_UkLWZg9DAJ+ option_type_id: opt_UkLWZg9DAJ+ name: size-4+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-13+ option_type_label: Size+ image_url:metadata: {}- canceled_at:- approved_at:- created_at: '2026-07-27T20:01:07.609Z'- updated_at: '2026-07-27T20:01:07.609Z'- preferred_stock_location_id:- tags: []- internal_note:- approver_id:- canceler_id:- created_by_id:- customer_id: cus_UkLWZg9DAJ- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- '401':- description: unauthorized- content:- application/json:- example:- error:- code: authentication_required- message: Authentication required- schema:- "$ref": "#/components/schemas/ErrorResponse"- post:- summary: Create a draft order+ created_at: '2026-07-29T08:38:01.602Z'+ updated_at: '2026-07-29T08:38:01.602Z'+ digital_links: []+ metadata: {}+ created_at: '2026-07-29T08:38:01.960Z'+ updated_at: '2026-07-29T08:38:01.960Z'+ cost_price: '17.0'+ tax_category_id: taxcat_UkLWZg9DAJ+ patch:+ summary: Update an itemtags:- Orderssecurity:- api_key: []bearer_auth: []+ description: |-+ Updates an order item quantity or metadata.++ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -11042,90 +10922,12 @@ paths:secretKey: 'sk_xxx',})- // One-shot order create: customer, items, addresses, market, channel,- // notes, metadata, and a coupon code in a single call. Everything- // except `email` is optional.- const order = await client.orders.create({- email: '[email protected]',- customer_id: 'cus_UkLWZg9DAJ', // Existing customer; omit for guest orders- use_customer_default_address: false, // true to copy the customer's saved addresses-- currency: 'USD',- market_id: 'mkt_UkLWZg9DAJ',- channel_id: 'ch_UkLWZg9DAJ', // Optional — defaults to the store's primary channel- locale: 'en-US',-- // Pin the order's preferred fulfillment location. Order Routing's- // built-in PreferredLocation rule ranks this location first when- // it stocks the cart's items; if it doesn't, routing falls back- // to the next rule (Minimize Splits → Default Location).- preferred_stock_location_id: 'sloc_UkLWZg9DAJ',-- customer_note: 'Please leave at the front desk.',- internal_note: 'VIP customer — handle with care.',- metadata: {- external_reference: 'subscription_invoice_2026_04',- source: 'recurring-engine',- },-- // Items: each variant_id + quantity. Optional metadata per line.- items: [- { variant_id: 'variant_k5nR8xLq', quantity: 2 },- { variant_id: 'variant_QXyZ12abCD', quantity: 1, metadata: { gift: true } },- ],-- // Provide addresses inline OR by ID (existing customer addresses).- shipping_address: {- first_name: 'Jane',- last_name: 'Doe',- address1: '350 Fifth Avenue',- address2: 'Floor 42',- city: 'New York',- postal_code: '10118',- country_iso: 'US',- state_abbr: 'NY',- phone: '+1 212 555 1234',- company: 'Acme Inc.',- },- // shipping_address_id: 'addr_UkLWZg9DAJ', // alternative to inline-- billing_address: {- first_name: 'Jane',- last_name: 'Doe',- address1: '350 Fifth Avenue',- city: 'New York',- postal_code: '10118',- country_iso: 'US',- state_abbr: 'NY',- phone: '+1 212 555 1234',- },- // billing_address_id: 'addr_UkLWZg9DAJ',-- // Optional. Invalid codes are non-fatal — the order is created either way.- coupon_code: 'WELCOME10',+ const item = await client.orders.items.update('or_UkLWZg9DAJ', 'li_UkLWZg9DAJ', {+ quantity: 5,})- lang: bashlabel: Spree CLI- source: spree api post /orders -d '{"email":"[email protected]","customer_id":"cus_UkLWZg9DAJ","use_customer_default_address":false,"currency":"USD","market_id":"mkt_UkLWZg9DAJ","channel_id":"ch_UkLWZg9DAJ","locale":"en-US","preferred_stock_location_id":"sloc_UkLWZg9DAJ","customer_note":"Please- leave at the front desk.","internal_note":"VIP customer — handle with care.","metadata":{"external_reference":"subscription_invoice_2026_04","source":"recurring-engine"},"items":[{"variant_id":"variant_k5nR8xLq","quantity":2},{"variant_id":"variant_QXyZ12abCD","quantity":1,"metadata":{"gift":true}}],"shipping_address":{"first_name":"Jane","last_name":"Doe","address1":"350- Fifth Avenue","address2":"Floor 42","city":"New York","postal_code":"10118","country_iso":"US","state_abbr":"NY","phone":"+1- 212 555 1234","company":"Acme Inc."},"billing_address":{"first_name":"Jane","last_name":"Doe","address1":"350- Fifth Avenue","city":"New York","postal_code":"10118","country_iso":"US","state_abbr":"NY","phone":"+1- 212 555 1234"},"coupon_code":"WELCOME10"}'- description: |-- Creates a new draft order in one shot. Customer, items, addresses, currency,- market, channel, locale, notes, metadata, and a coupon code can all be- provided inline.-- Setting `preferred_stock_location_id` pins the order's preferred fulfillment- location — Order Routing's built-in `PreferredLocation` rule consumes it- when picking which stock location ships each shipment.-- Invalid coupon codes are non-fatal — the order is created and the failure- is reported on the service result (not in the API response body for now).--- **Required scope:** `write_orders` (for API-key authentication).+ source: spree api patch /orders/{order_id}/items/{id} -d '{"quantity":5}'parameters:- name: x-spree-api-keyin: header@@ -11138,188 +10940,90 @@ paths:description: Bearer token for admin authenticationschema: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: stringresponses:- '201':- description: order created with preferred_stock_location_id+ '200':+ description: item updatedcontent:application/json:example:- id: or_gbHJdmfrXB- market_id:- channel_id: ch_UkLWZg9DAJ- number: R933904120- email: [email protected]- customer_note:+ id: li_UkLWZg9DAJ+ variant_id: variant_gbHJdmfrXB+ preorder: false+ preorder_ships_at:+ quantity: 5currency: USD- locale: en- total_quantity: 0- fulfillment_status:- payment_status:- completed_at:- item_total: '0.0'- display_item_total: "$0.00"+ name: Product 307268+ slug: product-307268+ options_text: 'Size: S'+ price: '19.99'+ display_price: "$19.99"+ total: '99.95'+ display_total: "$99.95"adjustment_total: '0.0'display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '0.0'- display_total: "$0.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: '0.0'- display_amount_due: "$0.00"- delivery_total: '0.0'- display_delivery_total: "$0.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"- covered_by_store_credit: false- gift_card:- market:- status: draft- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '0.0'- display_payment_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ pre_tax_amount: '99.95'+ display_pre_tax_amount: "$99.95"+ discounted_amount: '99.95'+ display_discounted_amount: "$99.95"+ display_compare_at_amount: "$0.00"+ compare_at_amount:+ thumbnail_url:+ option_values:+ - id: optval_UkLWZg9DAJ+ option_type_id: opt_UkLWZg9DAJ+ name: size-5+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-14+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:02.277Z'+ updated_at: '2026-07-29T08:38:02.277Z'+ digital_links: []metadata: {}- canceled_at:- approved_at:- created_at: '2026-07-27T20:01:09.346Z'- updated_at: '2026-07-27T20:01:09.349Z'- preferred_stock_location_id: sloc_UkLWZg9DAJ- tags: []- internal_note:- approver_id:- canceler_id:- created_by_id:- customer_id:+ created_at: '2026-07-29T08:38:02.553Z'+ updated_at: '2026-07-29T08:38:02.845Z'+ cost_price: '17.0'+ tax_category_id: taxcat_UkLWZg9DAJrequestBody:content:application/json:schema:type: objectproperties:- email:- type: string- example: [email protected]- 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- example: USD- 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- example: en-US- 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- example: 1- 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+ quantity:+ type: integer+ delete:+ summary: Remove an itemtags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns full order details including admin-only fields.+ Removes an item from the order.- **Required scope:** `read_orders` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -11331,12 +11035,10 @@ paths:secretKey: 'sk_xxx',})- const order = await client.orders.get('or_UkLWZg9DAJ', {- expand: ['items', 'fulfillments', 'payments', 'customer'],- })+ await client.orders.items.delete('or_UkLWZg9DAJ', 'li_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /orders/{id} -d '{"expand":["items","fulfillments","payments","customer"]}'+ source: spree api delete /orders/{order_id}/items/{id}parameters:- name: x-spree-api-keyin: header@@ -11349,133 +11051,54 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: id+ - name: order_idin: pathrequired: true- description: Order ID (e.g., or_xxx)+ description: Order IDschema: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).+ - name: id+ in: path+ required: true+ description: Item IDschema: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:- example:- id: or_UkLWZg9DAJ- market_id:- channel_id: ch_UkLWZg9DAJ- number: R801110570- email: [email protected]- customer_note:- currency: USD- locale: en- total_quantity: 0- fulfillment_status:- payment_status:- completed_at:- item_total: '0.0'- display_item_total: "$0.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- total: '0.0'- display_total: "$0.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: '0.0'- display_amount_due: "$0.00"- delivery_total: '0.0'- display_delivery_total: "$0.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"- covered_by_store_credit: false- gift_card:- market:- status: draft- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '0.0'- display_payment_total: "$0.00"- metadata: {}- canceled_at:- approved_at:- created_at: '2026-07-27T20:01:09.626Z'- updated_at: '2026-07-27T20:01:09.626Z'- preferred_stock_location_id:- tags: []- internal_note:- approver_id:- canceler_id:- created_by_id:- customer_id: cus_UkLWZg9DAJ- '404':- description: order not found- content:- application/json:- example:- error:- code: order_not_found- message: Order not found- 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.-- **Required scope:** `write_orders` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const order = await client.orders.update('or_UkLWZg9DAJ', {- email: '[email protected]',- internal_note: 'VIP — gift wrap on next order',- })- - lang: bash- label: Spree CLI- source: spree api patch /orders/{id} -d '{"email":"[email protected]","internal_note":"VIP- — gift wrap on next order"}'- parameters:- - name: x-spree-api-key- in: header- required: true+ 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.++ **Required scope:** `write_store_credits` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const order = await client.orders.storeCredits.apply('or_UkLWZg9DAJ', {+ amount: '25.00',+ })+ - lang: bash+ label: Spree CLI+ source: spree api post /orders/{order_id}/store_credits -d '{"amount":"25.00"}'+ parameters:+ - name: x-spree-api-key+ in: header+ required: trueschema:type: string- name: Authorization@@ -11484,32 +11107,32 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: id+ - name: order_idin: pathrequired: truedescription: Order IDschema:type: stringresponses:- '200':- description: order updated+ '201':+ description: store credit appliedcontent:application/json:example:id: or_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R731181056- email: [email protected]+ number: R654930418+ email: [email protected]customer_note:currency: USDlocale: en- total_quantity: 0+ total_quantity: 1fulfillment_status:payment_status:completed_at:- item_total: '0.0'- display_item_total: "$0.00"+ item_total: '10.0'+ display_item_total: "$10.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"discount_total: '0.0'@@ -11520,19 +11143,31 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '0.0'- display_total: "$0.00"+ total: '110.0'+ display_total: "$110.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '0.0'- display_amount_due: "$0.00"- delivery_total: '0.0'- display_delivery_total: "$0.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"+ amount_due: '60.0'+ display_amount_due: "$60.00"+ delivery_total: '100.0'+ display_delivery_total: "$100.00"+ store_credit_total: '50.0'+ display_store_credit_total: "-$50.00"covered_by_store_credit: falsegift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'status: draftlast_ip_address:considered_risky: false@@ -11543,8 +11178,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-07-27T20:01:10.730Z'- updated_at: '2026-07-27T20:01:11.015Z'+ created_at: '2026-07-29T08:38:09.311Z'+ updated_at: '2026-07-29T08:38:09.356Z'preferred_stock_location_id:tags: []internal_note:@@ -11558,84 +11193,21 @@ paths:schema:type: objectproperties:- email:- type: string- special_instructions:- type: string- internal_note:- type: string- channel_id:- type: string- description: Channel ID- preferred_stock_location_id:+ amount: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- example: 1- metadata:- type: object+ description: Optional explicit amount; defaults to order outstanding+ balancedelete:- summary: Delete a draft order+ summary: Remove store credit from an ordertags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Deletes a draft order. Completed orders cannot be deleted.+ Removes any applied store credit from the order.- **Required scope:** `write_orders` (for API-key authentication).+ **Required scope:** `write_store_credits` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -11647,10 +11219,10 @@ paths:secretKey: 'sk_xxx',})- await client.orders.delete('or_UkLWZg9DAJ')+ await client.orders.storeCredits.remove('or_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api delete /orders/{id}+ source: spree api delete /orders/{order_id}/store_creditsparameters:- name: x-spree-api-keyin: header@@ -11663,7 +11235,7 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: id+ - name: order_idin: pathrequired: truedescription: Order ID@@ -11671,22 +11243,19 @@ paths:type: stringresponses:'204':- description: order deleted- "/api/v3/admin/orders/{id}/complete":- patch:- summary: Complete an order+ description: store credit removed+ "/api/v3/admin/orders":+ get:+ summary: List orderstags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Completes an order in the `confirm` state, marking it as placed.-- Set `notify_customer: true` to send the order confirmation email.-+ Returns a paginated list of orders for the current store.- **Required scope:** `write_orders` (for API-key authentication).+ **Required scope:** `read_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -11698,12 +11267,15 @@ paths:secretKey: 'sk_xxx',})- const order = await client.orders.complete('or_UkLWZg9DAJ', {- notify_customer: true,+ const { data: orders, meta } = await client.orders.list({+ status_eq: 'complete',+ completed_at_gt: '2026-01-01',+ sort: '-completed_at',+ limit: 25,})- lang: bashlabel: Spree CLI- source: spree api patch /orders/{id}/complete -d '{"notify_customer":true}'+ source: spree api get /orders -d '{"status_eq":"complete","completed_at_gt":"2026-01-01","sort":"-completed_at","limit":25}'parameters:- name: x-spree-api-keyin: header@@ -11716,108 +11288,166 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: id- in: path- required: true- description: Order ID+ - name: page+ in: query+ required: false+ description: Page numberschema:- type: string- responses:+ 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: order completed+ description: orders foundcontent:application/json:example:- id: or_UkLWZg9DAJ- market_id:- channel_id: ch_UkLWZg9DAJ- number: R339300602- email: [email protected]- customer_note:- currency: USD- locale: en- total_quantity: 1- fulfillment_status: ready- payment_status: paid- completed_at: '2026-07-27T20:01:11.923Z'- item_total: '10.0'- display_item_total: "$10.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: '0.0'- display_amount_due: "$0.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"- covered_by_store_credit: false- gift_card:- market:- status: draft- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '110.0'- display_payment_total: "$110.00"- metadata: {}- canceled_at:- approved_at:- created_at: '2026-07-27T20:01:11.864Z'- updated_at: '2026-07-27T20:01:11.943Z'- preferred_stock_location_id:- tags: []- internal_note:- approver_id:- canceler_id:- created_by_id:- customer_id: cus_UkLWZg9DAJ- '422':- description: order cannot be completed+ data:+ - id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R203088763+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 0+ fulfillment_status:+ payment_status:+ completed_at:+ item_total: '0.0'+ display_item_total: "$0.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '0.0'+ display_total: "$0.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: draft+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '0.0'+ display_payment_total: "$0.00"+ metadata: {}+ canceled_at:+ approved_at:+ created_at: '2026-07-29T08:38:11.118Z'+ updated_at: '2026-07-29T08:38:11.118Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id:+ canceler_id:+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ '401':+ description: unauthorizedcontent:application/json:example:error:- code: order_cannot_complete- message: No payment found- details:- base:- - No payment found+ code: authentication_required+ message: Authentication requiredschema:"$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+ post:+ summary: Create a draft ordertags:- Orderssecurity:- api_key: []bearer_auth: []- description: |-- Cancels a completed order.-- **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -11829,117 +11459,90 @@ paths:secretKey: 'sk_xxx',})- const order = await client.orders.cancel('or_UkLWZg9DAJ')- - lang: bash- label: Spree CLI- source: spree api patch /orders/{id}/cancel -d '{ ... }'- 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:- example:- id: or_UkLWZg9DAJ- market_id:- channel_id: ch_UkLWZg9DAJ- number: R431148308- email: [email protected]- customer_note:- currency: USD- locale: en- total_quantity: 1- fulfillment_status: canceled- payment_status: void- completed_at: '2026-07-27T20:01:13.171Z'- item_total: '10.0'- display_item_total: "$10.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- total: '20.0'- display_total: "$20.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: "-0.0"- display_amount_due: "$0.00"- delivery_total: '10.0'- display_delivery_total: "$10.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"- covered_by_store_credit: false- gift_card:- market:- status: canceled- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '0.0'- display_payment_total: "$0.00"- metadata: {}- canceled_at: '2026-07-27T20:01:13.457Z'- approved_at:- created_at: '2026-07-27T20:01:13.126Z'- updated_at: '2026-07-27T20:01:13.511Z'- preferred_stock_location_id:- tags: []- internal_note:- approver_id:- canceler_id: admin_UkLWZg9DAJ- created_by_id:- customer_id: cus_UkLWZg9DAJ- "/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).+ // One-shot order create: customer, items, addresses, market, channel,+ // notes, metadata, and a coupon code in a single call. Everything+ // except `email` is optional.+ const order = await client.orders.create({+ email: '[email protected]',+ customer_id: 'cus_UkLWZg9DAJ', // Existing customer; omit for guest orders+ use_customer_default_address: false, // true to copy the customer's saved addresses- **Required scope:** `write_orders` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'+ currency: 'USD',+ market_id: 'mkt_UkLWZg9DAJ',+ channel_id: 'ch_UkLWZg9DAJ', // Optional — defaults to the store's primary channel+ locale: 'en-US',- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })+ // Pin the order's preferred fulfillment location. Order Routing's+ // built-in PreferredLocation rule ranks this location first when+ // it stocks the cart's items; if it doesn't, routing falls back+ // to the next rule (Minimize Splits → Default Location).+ preferred_stock_location_id: 'sloc_UkLWZg9DAJ',- const order = await client.orders.approve('or_UkLWZg9DAJ')+ customer_note: 'Please leave at the front desk.',+ internal_note: 'VIP customer — handle with care.',+ metadata: {+ external_reference: 'subscription_invoice_2026_04',+ source: 'recurring-engine',+ },++ // Items: each variant_id + quantity. Optional metadata per line.+ items: [+ { variant_id: 'variant_k5nR8xLq', quantity: 2 },+ { variant_id: 'variant_QXyZ12abCD', quantity: 1, metadata: { gift: true } },+ ],++ // Provide addresses inline OR by ID (existing customer addresses).+ shipping_address: {+ first_name: 'Jane',+ last_name: 'Doe',+ address1: '350 Fifth Avenue',+ address2: 'Floor 42',+ city: 'New York',+ postal_code: '10118',+ country_iso: 'US',+ state_abbr: 'NY',+ phone: '+1 212 555 1234',+ company: 'Acme Inc.',+ },+ // shipping_address_id: 'addr_UkLWZg9DAJ', // alternative to inline++ billing_address: {+ first_name: 'Jane',+ last_name: 'Doe',+ address1: '350 Fifth Avenue',+ city: 'New York',+ postal_code: '10118',+ country_iso: 'US',+ state_abbr: 'NY',+ phone: '+1 212 555 1234',+ },+ // billing_address_id: 'addr_UkLWZg9DAJ',++ // Optional. Invalid codes are non-fatal — the order is created either way.+ coupon_code: 'WELCOME10',+ })- lang: bashlabel: Spree CLI- source: spree api patch /orders/{id}/approve -d '{ ... }'+ source: spree api post /orders -d '{"email":"[email protected]","customer_id":"cus_UkLWZg9DAJ","use_customer_default_address":false,"currency":"USD","market_id":"mkt_UkLWZg9DAJ","channel_id":"ch_UkLWZg9DAJ","locale":"en-US","preferred_stock_location_id":"sloc_UkLWZg9DAJ","customer_note":"Please+ leave at the front desk.","internal_note":"VIP customer — handle with care.","metadata":{"external_reference":"subscription_invoice_2026_04","source":"recurring-engine"},"items":[{"variant_id":"variant_k5nR8xLq","quantity":2},{"variant_id":"variant_QXyZ12abCD","quantity":1,"metadata":{"gift":true}}],"shipping_address":{"first_name":"Jane","last_name":"Doe","address1":"350+ Fifth Avenue","address2":"Floor 42","city":"New York","postal_code":"10118","country_iso":"US","state_abbr":"NY","phone":"+1+ 212 555 1234","company":"Acme Inc."},"billing_address":{"first_name":"Jane","last_name":"Doe","address1":"350+ Fifth Avenue","city":"New York","postal_code":"10118","country_iso":"US","state_abbr":"NY","phone":"+1+ 212 555 1234"},"coupon_code":"WELCOME10"}'+ description: |-+ Creates a new draft order in one shot. Customer, items, addresses, currency,+ market, channel, locale, notes, metadata, and a coupon code can all be+ provided inline.++ Setting `preferred_stock_location_id` pins the order's preferred fulfillment+ location — Order Routing's built-in `PreferredLocation` rule consumes it+ when picking which stock location ships each shipment.++ Invalid coupon codes are non-fatal — the order is created and the failure+ is reported on the service result (not in the API response body for now).+++ **Required scope:** `write_orders` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -11952,32 +11555,26 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: id- in: path- required: true- description: Order ID- schema:- type: stringresponses:- '200':- description: order approved+ '201':+ description: order created with preferred_stock_location_idcontent:application/json:example:- id: or_UkLWZg9DAJ- market_id:+ id: or_gbHJdmfrXB+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R046415341- email: [email protected]+ number: R256445661+ email: [email protected]customer_note:currency: USDlocale: en- total_quantity: 1+ total_quantity: 0fulfillment_status:payment_status:- completed_at: '2026-07-27T20:01:13.864Z'- item_total: '10.0'- display_item_total: "$10.00"+ completed_at:+ item_total: '0.0'+ display_item_total: "$0.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"discount_total: '0.0'@@ -11988,19 +11585,31 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '0.0'+ display_total: "$0.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsegift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'status: draftlast_ip_address:considered_risky: false@@ -12010,135 +11619,136 @@ paths:display_payment_total: "$0.00"metadata: {}canceled_at:- approved_at: '2026-07-27T20:01:14.155Z'- created_at: '2026-07-27T20:01:13.815Z'- updated_at: '2026-07-27T20:01:13.864Z'- preferred_stock_location_id:+ approved_at:+ created_at: '2026-07-29T08:38:12.820Z'+ updated_at: '2026-07-29T08:38:12.825Z'+ preferred_stock_location_id: sloc_UkLWZg9DAJtags: []internal_note:- approver_id: admin_UkLWZg9DAJ+ approver_id:canceler_id:created_by_id:- customer_id: cus_UkLWZg9DAJ- "/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.-- **Required scope:** `write_orders` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const order = await client.orders.resume('or_UkLWZg9DAJ')- - lang: bash- label: Spree CLI- source: spree api patch /orders/{id}/resume -d '{ ... }'- 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:- example:- id: or_UkLWZg9DAJ+ customer_id:+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ email:+ type: string+ example: [email protected]+ 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+ example: USDmarket_id:- channel_id: ch_UkLWZg9DAJ- number: R010191644- email: [email protected]+ 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+ example: en-UScustomer_note:- currency: USD- locale: en- total_quantity: 1- fulfillment_status: canceled- payment_status: void- completed_at: '2026-07-27T20:01:14.486Z'- item_total: '10.0'- display_item_total: "$10.00"- adjustment_total: '0.0'- display_adjustment_total: "$0.00"- discount_total: '0.0'- display_discount_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- total: '20.0'- display_total: "$20.00"- gift_card_total: '0.0'- display_gift_card_total: "$0.00"- amount_due: '20.0'- display_amount_due: "$20.00"- delivery_total: '10.0'- display_delivery_total: "$10.00"- store_credit_total: '0.0'- display_store_credit_total: "$0.00"- covered_by_store_credit: false- gift_card:- market:- status: placed- last_ip_address:- considered_risky: false- confirmation_delivered: false- store_owner_notification_delivered:- payment_total: '0.0'- display_payment_total: "$0.00"- metadata: {}- canceled_at: '2026-07-27T20:01:14.763Z'- approved_at:- created_at: '2026-07-27T20:01:14.434Z'- updated_at: '2026-07-27T20:01:14.868Z'- preferred_stock_location_id:- tags: []+ type: string+ description: Public, customer-visible noteinternal_note:- approver_id:- canceler_id: admin_UkLWZg9DAJ- created_by_id:- customer_id: cus_UkLWZg9DAJ- "/api/v3/admin/orders/{id}/resend_confirmation":- post:- summary: Resend confirmation email+ 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+ example: 1+ 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 ordertags:- Orderssecurity:- api_key: []bearer_auth: []description: |-- Publishes the order.completed event to trigger confirmation email delivery.+ Returns full order details including admin-only fields.- **Required scope:** `write_orders` (for API-key authentication).+ **Required scope:** `read_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12150,10 +11760,12 @@ paths:secretKey: 'sk_xxx',})- await client.orders.resendConfirmation('or_UkLWZg9DAJ')+ const order = await client.orders.get('or_UkLWZg9DAJ', {+ expand: ['items', 'fulfillments', 'payments', 'customer'],+ })- lang: bashlabel: Spree CLI- source: spree api post /orders/{id}/resend_confirmation -d '{ ... }'+ source: spree api get /orders/{id} -d '{"expand":["items","fulfillments","payments","customer"]}'parameters:- name: x-spree-api-keyin: header@@ -12169,29 +11781,44 @@ paths:- name: idin: pathrequired: true- description: Order ID+ 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: stringresponses:'200':- description: confirmation resent+ description: order foundcontent:application/json:example:id: or_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R876299554- email: [email protected]+ number: R365885489+ email: [email protected]customer_note:currency: USDlocale: en- total_quantity: 1+ total_quantity: 0fulfillment_status:payment_status:- completed_at: '2026-07-27T20:01:15.201Z'- item_total: '10.0'- display_item_total: "$10.00"+ completed_at:+ item_total: '0.0'+ display_item_total: "$0.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"discount_total: '0.0'@@ -12202,19 +11829,31 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '0.0'+ display_total: "$0.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsegift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'status: draftlast_ip_address:considered_risky: false@@ -12225,8 +11864,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-07-27T20:01:15.155Z'- updated_at: '2026-07-27T20:01:15.201Z'+ created_at: '2026-07-29T08:38:13.107Z'+ updated_at: '2026-07-29T08:38:13.107Z'preferred_stock_location_id:tags: []internal_note:@@ -12234,18 +11873,27 @@ paths:canceler_id:created_by_id:customer_id: cus_UkLWZg9DAJ- "/api/v3/admin/payment_methods":- get:- summary: List payment methods+ '404':+ description: order not found+ content:+ application/json:+ example:+ error:+ code: order_not_found+ message: Order not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update an ordertags:- - Payment Methods+ - Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns the store's configured payment methods. Use `source_required: true` to know which methods need a saved source.+ Updates an order. Supports updating email, addresses, special instructions, and line items.- **Required scope:** `read_settings` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12257,10 +11905,14 @@ paths:secretKey: 'sk_xxx',})- const { data: paymentMethods } = await client.paymentMethods.list()+ const order = await client.orders.update('or_UkLWZg9DAJ', {+ email: '[email protected]',+ internal_note: 'VIP — gift wrap on next order',+ })- lang: bashlabel: Spree CLI- source: spree api get /payment_methods+ source: spree api patch /orders/{id} -d '{"email":"[email protected]","internal_note":"VIP+ — gift wrap on next order"}'parameters:- name: x-spree-api-keyin: header@@ -12270,66 +11922,173 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema: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.+ - name: id+ in: path+ required: true+ description: Order IDschema:type: stringresponses:'200':- description: payment methods found+ description: order updatedcontent:application/json:example:- data:- - id: pm_UkLWZg9DAJ- name: Check- description:- type: check- session_required: false- source_required: false- metadata: {}- active: true- auto_capture:- storefront_visible: true- position: 1- created_at: '2026-07-27T20:01:16.605Z'- updated_at: '2026-07-27T20:01:16.605Z'- preferences: {}- preference_schema: []- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- "/api/v3/admin/payment_methods/types":- get:- summary: List available payment provider types- tags:- - Payment Methods- security:+ id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R082983639+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 0+ fulfillment_status:+ payment_status:+ completed_at:+ item_total: '0.0'+ display_item_total: "$0.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '0.0'+ display_total: "$0.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: draft+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '0.0'+ display_payment_total: "$0.00"+ metadata: {}+ canceled_at:+ approved_at:+ created_at: '2026-07-29T08:38:14.210Z'+ updated_at: '2026-07-29T08:38:14.492Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id:+ canceler_id:+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ 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+ example: 1+ metadata:+ type: object+ delete:+ summary: Delete a draft order+ tags:+ - Orders+ 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.+ Deletes a draft order. Completed orders cannot be deleted.- **Required scope:** `read_settings` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12341,10 +12100,10 @@ paths:secretKey: 'sk_xxx',})- const { data: types } = await client.paymentMethods.types()+ await client.orders.delete('or_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /payment_methods/types+ source: spree api delete /orders/{id}parameters:- name: x-spree-api-keyin: header@@ -12354,41 +12113,33 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authentication+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Order IDschema:type: stringresponses:- '200':- description: provider types found- content:- application/json:- example:- data:- - type: bogus- label: Bogus- description:- preference_schema:- - key: dummy_key- type: string- default: PUBLICKEY123- - key: dummy_secret_key- type: password- default:- - type: custom_payment_source_method- label: Custom Payment Source Method- description:- preference_schema: []- "/api/v3/admin/payment_methods/{id}":- get:- summary: Show a payment method+ '204':+ description: order deleted+ "/api/v3/admin/orders/{id}/complete":+ patch:+ summary: Complete an ordertags:- - Payment Methods+ - Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns a payment method by ID.+ Completes an order in the `confirm` state, marking it as placed.- **Required scope:** `read_settings` (for API-key authentication).+ Set `notify_customer: true` to send the order confirmation email.+++ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12400,10 +12151,12 @@ paths:secretKey: 'sk_xxx',})- const paymentMethod = await client.paymentMethods.get('pm_UkLWZg9DAJ')+ const order = await client.orders.complete('or_UkLWZg9DAJ', {+ notify_customer: true,+ })- lang: bashlabel: Spree CLI- source: spree api get /payment_methods/{id}+ source: spree api patch /orders/{id}/complete -d '{"notify_customer":true}'parameters:- name: x-spree-api-keyin: header@@ -12413,78 +12166,141 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: string- name: idin: pathrequired: 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.+ description: Order IDschema:type: stringresponses:'200':- description: payment method found+ description: order completedcontent:application/json:example:- id: pm_UkLWZg9DAJ- name: Check- description:- type: check- session_required: false- source_required: false- metadata: {}- active: true- auto_capture:- storefront_visible: true- position: 1- created_at: '2026-07-27T20:01:17.183Z'- updated_at: '2026-07-27T20:01:17.183Z'- preferences: {}- preference_schema: []- "/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.-- **Required scope:** `read_payments` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const { data: payments } = await client.orders.payments.list('or_UkLWZg9DAJ')- - lang: bash- label: Spree CLI- source: spree api get /orders/{order_id}/payments- parameters:- - name: x-spree-api-key- in: header+ id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R583220136+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 1+ fulfillment_status: ready+ payment_status: paid+ completed_at: '2026-07-29T08:38:15.388Z'+ item_total: '10.0'+ display_item_total: "$10.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '110.0'+ display_total: "$110.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '100.0'+ display_delivery_total: "$100.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: placed+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '110.0'+ display_payment_total: "$110.00"+ metadata: {}+ canceled_at:+ approved_at:+ created_at: '2026-07-29T08:38:15.346Z'+ updated_at: '2026-07-29T08:38:15.403Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id:+ canceler_id:+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ '422':+ description: order cannot be completed+ content:+ application/json:+ example:+ error:+ code: order_cannot_complete+ message: No payment found+ details:+ base:+ - No payment found+ 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.++ **Required scope:** `write_orders` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const order = await client.orders.cancel('or_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api patch /orders/{id}/cancel -d '{ ... }'+ parameters:+ - name: x-spree-api-key+ in: headerrequired: trueschema:type: string@@ -12494,85 +12310,98 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: order_id+ - name: idin: pathrequired: truedescription: Order IDschema: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: stringresponses:'200':- description: payments found+ description: order canceledcontent:application/json:example:- data:- - id: py_UkLWZg9DAJ- payment_method_id: pm_UkLWZg9DAJ- response_code: BGS-f9deefbc6187- number: PS6MV2Q2- amount: '110.0'- display_amount: "$110.00"- status: completed- source_type: credit_card- source_id: card_UkLWZg9DAJ- source:- id: card_UkLWZg9DAJ- brand: visa- last4: '1111'- month: 12- year: 2027- name: Spree Commerce- default: false- gateway_payment_profile_id:- customer_id:- payment_method_id: pm_gbHJdmfrXB- metadata: {}- created_at: '2026-07-27T20:01:00.159Z'- updated_at: '2026-07-27T20:01:00.162Z'- metadata: {}- avs_response:- cvv_response_code:- cvv_response_message:- created_at: '2026-07-27T20:01:00.161Z'- updated_at: '2026-07-27T20:01:00.161Z'- captured_amount: '0.0'- order_id: or_UkLWZg9DAJ- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- post:- summary: Create a payment+ id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R120599329+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 1+ fulfillment_status: canceled+ payment_status: void+ completed_at: '2026-07-29T08:38:16.598Z'+ item_total: '10.0'+ display_item_total: "$10.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '20.0'+ display_total: "$20.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: "-0.0"+ display_amount_due: "$0.00"+ delivery_total: '10.0'+ display_delivery_total: "$10.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: canceled+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '0.0'+ display_payment_total: "$0.00"+ metadata: {}+ canceled_at: '2026-07-29T08:38:16.889Z'+ approved_at:+ created_at: '2026-07-29T08:38:16.558Z'+ updated_at: '2026-07-29T08:38:16.919Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id:+ canceler_id: admin_UkLWZg9DAJ+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ "/api/v3/admin/orders/{id}/approve":+ patch:+ summary: Approve an ordertags:- - Payments+ - Orderssecurity:- api_key: []bearer_auth: []description: |-- Creates a new payment for the order.+ Approves an order (e.g., for fraud review).- **Required scope:** `write_payments` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12584,14 +12413,10 @@ paths:secretKey: 'sk_xxx',})- const payment = await client.orders.payments.create('or_UkLWZg9DAJ', {- payment_method_id: 'pm_UkLWZg9DAJ',- amount: '99.99',- source_id: 'cc_UkLWZg9DAJ',- })+ const order = await client.orders.approve('or_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api post /orders/{order_id}/payments -d '{"payment_method_id":"pm_UkLWZg9DAJ","amount":"99.99","source_id":"cc_UkLWZg9DAJ"}'+ source: spree api patch /orders/{id}/approve -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -12604,65 +12429,98 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: order_id+ - name: idin: pathrequired: truedescription: Order IDschema:type: stringresponses:- '201':- description: payment created+ '200':+ description: order approvedcontent:application/json:example:- id: py_gbHJdmfrXB- payment_method_id: pm_EfhxLZ9ck8- response_code:- number: P6E9CP8T- amount: '110.0'- display_amount: "$110.00"- status: checkout- source_type:- source_id:- source:- metadata: {}- avs_response:- cvv_response_code:- cvv_response_message:- created_at: '2026-07-27T20:01:01.461Z'- updated_at: '2026-07-27T20:01:01.461Z'- captured_amount: '0.0'- order_id: or_gbHJdmfrXB- requestBody:- content:- application/json:- schema:- type: object- required:- - payment_method_id- properties:- payment_method_id:- type: string- description: Payment method ID- amount:- type: string- example: '99.99'- source_id:- type: string- description: Payment source ID- "/api/v3/admin/orders/{order_id}/payments/{id}":- get:- summary: Show a payment+ id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R451326031+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 1+ fulfillment_status:+ payment_status:+ completed_at: '2026-07-29T08:38:17.263Z'+ item_total: '10.0'+ display_item_total: "$10.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '110.0'+ display_total: "$110.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: '110.0'+ display_amount_due: "$110.00"+ delivery_total: '100.0'+ display_delivery_total: "$100.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: placed+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '0.0'+ display_payment_total: "$0.00"+ metadata: {}+ canceled_at:+ approved_at: '2026-07-29T08:38:17.545Z'+ created_at: '2026-07-29T08:38:17.220Z'+ updated_at: '2026-07-29T08:38:17.262Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id: admin_UkLWZg9DAJ+ canceler_id:+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ "/api/v3/admin/orders/{id}/resume":+ patch:+ summary: Resume a canceled ordertags:- - Payments+ - Orderssecurity:- api_key: []bearer_auth: []description: |-- Returns details of a specific payment.+ Resumes a previously canceled order.- **Required scope:** `read_payments` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12674,10 +12532,10 @@ paths:secretKey: 'sk_xxx',})- const payment = await client.orders.payments.get('or_UkLWZg9DAJ', 'pay_UkLWZg9DAJ')+ const order = await client.orders.resume('or_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /orders/{order_id}/payments/{id}+ source: spree api patch /orders/{id}/resume -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -12690,81 +12548,98 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: order_id- in: path- required: true- description: Order ID- schema:- type: string- name: idin: pathrequired: 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.+ description: Order IDschema:type: stringresponses:'200':- description: payment found+ description: order resumedcontent:application/json:example:- id: py_UkLWZg9DAJ- payment_method_id: pm_UkLWZg9DAJ- response_code: BGS-85157feeb11f- number: PC6I3WMW- amount: '110.0'- display_amount: "$110.00"- status: completed- source_type: credit_card- source_id: card_UkLWZg9DAJ- source:- id: card_UkLWZg9DAJ- brand: visa- last4: '1111'- month: 12- year: 2027- name: Spree Commerce- default: false- gateway_payment_profile_id:- customer_id:- payment_method_id: pm_gbHJdmfrXB- metadata: {}- created_at: '2026-07-27T20:01:01.859Z'- updated_at: '2026-07-27T20:01:01.861Z'+ id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R826951393+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 1+ fulfillment_status: canceled+ payment_status: void+ completed_at: '2026-07-29T08:38:17.867Z'+ item_total: '10.0'+ display_item_total: "$10.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '20.0'+ display_total: "$20.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: '20.0'+ display_amount_due: "$20.00"+ delivery_total: '10.0'+ display_delivery_total: "$10.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: placed+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '0.0'+ display_payment_total: "$0.00"metadata: {}- avs_response:- cvv_response_code:- cvv_response_message:- created_at: '2026-07-27T20:01:01.860Z'- updated_at: '2026-07-27T20:01:01.860Z'- captured_amount: '0.0'- order_id: or_UkLWZg9DAJ- "/api/v3/admin/orders/{order_id}/payments/{id}/capture":- patch:- summary: Capture a payment+ canceled_at: '2026-07-29T08:38:18.142Z'+ approved_at:+ created_at: '2026-07-29T08:38:17.825Z'+ updated_at: '2026-07-29T08:38:18.144Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id:+ canceler_id: admin_UkLWZg9DAJ+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ "/api/v3/admin/orders/{id}/resend_confirmation":+ post:+ summary: Resend confirmation emailtags:- - Payments+ - Orderssecurity:- api_key: []bearer_auth: []description: |-- Captures a pending payment.+ Publishes the order.completed event to trigger confirmation email delivery.- **Required scope:** `write_payments` (for API-key authentication).+ **Required scope:** `write_orders` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12776,11 +12651,10 @@ paths:secretKey: 'sk_xxx',})- const payment = await client.orders.payments.capture('or_UkLWZg9DAJ', 'pay_UkLWZg9DAJ')+ await client.orders.resendConfirmation('or_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api patch /orders/{order_id}/payments/{id}/capture -d '{ ...- }'+ source: spree api post /orders/{id}/resend_confirmation -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -12793,77 +12667,98 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: order_id- in: path- required: true- description: Order ID- schema:- type: string- name: idin: pathrequired: true- description: Payment ID+ description: Order IDschema:type: stringresponses:'200':- description: payment captured- content:- application/json:- example:- id: py_UkLWZg9DAJ- payment_method_id: pm_UkLWZg9DAJ- response_code: BGS-10226f85112e- number: P7TD8HCH- amount: '110.0'- display_amount: "$110.00"- status: completed- source_type: credit_card- source_id: card_UkLWZg9DAJ- source:- id: card_UkLWZg9DAJ- brand: visa- last4: '1111'- month: 12- year: 2027- name: Spree Commerce- default: false- gateway_payment_profile_id:- customer_id:- payment_method_id: pm_gbHJdmfrXB- metadata: {}- created_at: '2026-07-27T20:01:02.504Z'- updated_at: '2026-07-27T20:01:02.506Z'- metadata: {}- avs_response:- cvv_response_code:- cvv_response_message:- created_at: '2026-07-27T20:01:02.505Z'- updated_at: '2026-07-27T20:01:02.848Z'- captured_amount: '110.0'- order_id: or_UkLWZg9DAJ- '422':- description: capture failed+ description: confirmation resentcontent:application/json:example:- error:- code: processing_error- message: 'Bogus Gateway: Forced failure'- schema:- "$ref": "#/components/schemas/ErrorResponse"- "/api/v3/admin/orders/{order_id}/payments/{id}/void":- patch:- summary: Void a payment+ id: or_UkLWZg9DAJ+ market_id: mkt_UkLWZg9DAJ+ channel_id: ch_UkLWZg9DAJ+ number: R910390804+ email: [email protected]+ customer_note:+ currency: USD+ locale: en+ total_quantity: 1+ fulfillment_status:+ payment_status:+ completed_at: '2026-07-29T08:38:18.524Z'+ item_total: '10.0'+ display_item_total: "$10.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ discount_total: '0.0'+ display_discount_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '110.0'+ display_total: "$110.00"+ gift_card_total: '0.0'+ display_gift_card_total: "$0.00"+ amount_due: '110.0'+ display_amount_due: "$110.00"+ delivery_total: '100.0'+ display_delivery_total: "$100.00"+ store_credit_total: '0.0'+ display_store_credit_total: "$0.00"+ covered_by_store_credit: false+ gift_card:+ market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en+ created_at: '2026-07-29T08:36:53.674Z'+ updated_at: '2026-07-29T08:36:53.674Z'+ status: placed+ last_ip_address:+ considered_risky: false+ confirmation_delivered: false+ store_owner_notification_delivered:+ payment_total: '0.0'+ display_payment_total: "$0.00"+ metadata: {}+ canceled_at:+ approved_at:+ created_at: '2026-07-29T08:38:18.474Z'+ updated_at: '2026-07-29T08:38:18.524Z'+ preferred_stock_location_id:+ tags: []+ internal_note:+ approver_id:+ canceler_id:+ created_by_id:+ customer_id: cus_UkLWZg9DAJ+ "/api/v3/admin/payment_methods":+ get:+ summary: List payment methodstags:- - Payments+ - Payment Methodssecurity:- api_key: []bearer_auth: []description: |-- Voids a payment.+ Returns the store's configured payment methods. Use `source_required: true` to know which methods need a saved source.- **Required scope:** `write_payments` (for API-key authentication).+ **Required scope:** `read_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12875,10 +12770,10 @@ paths:secretKey: 'sk_xxx',})- const payment = await client.orders.payments.void('or_UkLWZg9DAJ', 'pay_UkLWZg9DAJ')+ const { data: paymentMethods } = await client.paymentMethods.list()- lang: bashlabel: Spree CLI- source: spree api patch /orders/{order_id}/payments/{id}/void -d '{ ... }'+ source: spree api get /payment_methodsparameters:- name: x-spree-api-keyin: header@@ -12888,70 +12783,66 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- - name: order_id- in: path- required: true- description: Order ID+ - 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: id- in: path- required: true- description: Payment ID+ - 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: stringresponses:'200':- description: payment voided+ description: payment methods foundcontent:application/json:example:- id: py_UkLWZg9DAJ- payment_method_id: pm_UkLWZg9DAJ- response_code: void-BGS-409f55320e90- number: P5MSP7K5- amount: '110.0'- display_amount: "$110.00"- status: void- source_type: credit_card- source_id: card_UkLWZg9DAJ- source:- id: card_UkLWZg9DAJ- brand: visa- last4: '1111'- month: 12- year: 2027- name: Spree Commerce- default: false- gateway_payment_profile_id:- customer_id:- payment_method_id: pm_gbHJdmfrXB+ data:+ - id: pm_UkLWZg9DAJ+ name: Check+ description:+ type: check+ session_required: false+ source_required: falsemetadata: {}- created_at: '2026-07-27T20:01:03.896Z'- updated_at: '2026-07-27T20:01:03.898Z'- metadata: {}- avs_response:- cvv_response_code:- cvv_response_message:- created_at: '2026-07-27T20:01:03.897Z'- updated_at: '2026-07-27T20:01:04.207Z'- captured_amount: '0.0'- order_id: or_UkLWZg9DAJ- "/api/v3/admin/price_lists":+ active: true+ auto_capture:+ storefront_visible: true+ position: 1+ created_at: '2026-07-29T08:38:20.008Z'+ updated_at: '2026-07-29T08:38:20.008Z'+ preferences: {}+ preference_schema: []+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ "/api/v3/admin/payment_methods/types":get:- summary: List price lists+ summary: List available payment provider typestags:- - Pricing+ - Payment Methodssecurity:- api_key: []bearer_auth: []description: |-- Returns the price lists configured for the current store.+ Returns the registered Spree::PaymentMethod subclasses that can be used to create new payment methods. Useful for populating a "Provider" dropdown in admin UIs.- **Required scope:** `read_products` (for API-key authentication).+ **Required scope:** `read_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -12963,10 +12854,10 @@ paths:secretKey: 'sk_xxx',})- const { data: priceLists } = await client.priceLists.list()+ const { data: types } = await client.paymentMethods.types()- lang: bashlabel: Spree CLI- source: spree api get /price_lists+ source: spree api get /payment_methods/typesparameters:- name: x-spree-api-keyin: header@@ -12978,107 +12869,223 @@ paths:required: trueschema:type: string- - name: page- in: query- required: false- schema:- type: integer- - name: limit- in: query- required: false+ responses:+ '200':+ description: provider types found+ content:+ application/json:+ example:+ data:+ - type: bogus+ label: Bogus+ description:+ preference_schema:+ - key: dummy_key+ type: string+ default: PUBLICKEY123+ - key: dummy_secret_key+ type: password+ default:+ - type: custom_payment_source_method+ label: Custom Payment Source Method+ description:+ preference_schema: []+ "/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.++ **Required scope:** `read_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const paymentMethod = await client.paymentMethods.get('pm_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api get /payment_methods/{id}+ parameters:+ - name: x-spree-api-key+ in: header+ required: trueschema:- type: integer- - name: q[name_cont]- in: query- required: false+ type: string+ - name: Authorization+ in: header+ required: trueschema:type: string- - name: q[status_eq]- in: query- required: false+ - name: id+ in: path+ required: trueschema:type: string- - name: sort+ - name: expandin: queryrequired: false+ description: Comma-separated associations to expand. Use dot notation for+ nested expand (max 4 levels).schema:type: string- - name: expand+ - name: fieldsin: queryrequired: false- description: 'Comma-separated associations to embed. Supported: `price_rules`.'+ description: Comma-separated list of fields to include (e.g., name,type,active).+ id is always included.schema:type: stringresponses:'200':- description: price lists found+ description: payment method foundcontent:application/json:example:- data:- - id: pl_UkLWZg9DAJ- name: Wholesale- description:- status: draft- position: 1- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:17.472Z'- updated_at: '2026-07-27T20:01:17.472Z'- currently_active: false- products_count: 0- prices_count: 0- product_ids: []- - id: pl_gbHJdmfrXB- name: Holiday- description:- status: draft- position: 2- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:17.473Z'- updated_at: '2026-07-27T20:01:17.473Z'- currently_active: false- products_count: 0- prices_count: 0- product_ids: []+ id: pm_UkLWZg9DAJ+ name: Check+ description:+ type: check+ session_required: false+ source_required: false+ metadata: {}+ active: true+ auto_capture:+ storefront_visible: true+ position: 1+ created_at: '2026-07-29T08:38:20.572Z'+ updated_at: '2026-07-29T08:38:20.572Z'+ preferences: {}+ preference_schema: []+ "/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.++ **Required scope:** `read_payments` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: payments } = await client.orders.payments.list('or_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api get /orders/{order_id}/payments+ 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:+ example:+ data:+ - id: py_UkLWZg9DAJ+ payment_method_id: pm_UkLWZg9DAJ+ response_code: BGS-08a8cc0d3568+ number: P2J2YVLH+ amount: '110.0'+ display_amount: "$110.00"+ status: completed+ source_type: credit_card+ source_id: card_UkLWZg9DAJ+ source:+ id: card_UkLWZg9DAJ+ brand: visa+ last4: '1111'+ month: 12+ year: 2027+ name: Spree Commerce+ default: false+ gateway_payment_profile_id:+ customer_id:+ payment_method_id: pm_gbHJdmfrXB+ metadata: {}+ created_at: '2026-07-29T08:38:03.780Z'+ updated_at: '2026-07-29T08:38:03.782Z'+ metadata: {}+ avs_response:+ cvv_response_code:+ cvv_response_message:+ created_at: '2026-07-29T08:38:03.781Z'+ updated_at: '2026-07-29T08:38:03.781Z'+ captured_amount: '0.0'+ order_id: or_UkLWZg9DAJmeta:page: 1limit: 25- count: 2+ count: 1pages: 1from: 1- to: 2- in: 2+ to: 1+ in: 1previous:next:- schema:- type: object- properties:- data:- type: array- items:- "$ref": "#/components/schemas/PriceList"- meta:- "$ref": "#/components/schemas/PaginationMeta"- required:- - data- - metapost:- summary: Create a price list+ summary: Create a paymenttags:- - Pricing+ - Paymentssecurity:- api_key: []bearer_auth: []description: |-- Creates a new draft price list.+ Creates a new payment for the order.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `write_payments` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -13090,45 +13097,14 @@ paths:secretKey: 'sk_xxx',})- // Server-to-server one-shot create. Ship the rules that gate the list- // and the exact per-variant prices in a single request — variants in- // `prices` implicitly become part of the list (upserted on the unique- // key `(variant_id, currency, price_list_id)`), so there's no need to- // pre-declare `product_ids` separately.- const priceList = await client.priceLists.create({- name: 'EU wholesale',- description: 'Tiered pricing for verified B2B customers',- match_policy: 'all',- starts_at: '2026-06-01T00:00:00Z',- ends_at: '2026-09-01T00:00:00Z',- rules: [- {- type: 'customer_group_rule',- preferences: { customer_group_ids: ['cg_aBc123'] },- },- {- type: 'volume_rule',- preferences: { min_quantity: 10 },- },- ],- prices: [- {- variant_id: 'variant_xY9',- currency: 'USD',- amount: '19.99',- compare_at_amount: '24.99',- },- {- variant_id: 'variant_aB7',- currency: 'USD',- amount: '21.99',- },- ],+ const payment = await client.orders.payments.create('or_UkLWZg9DAJ', {+ payment_method_id: 'pm_UkLWZg9DAJ',+ amount: '99.99',+ source_id: 'cc_UkLWZg9DAJ',})- lang: bashlabel: Spree CLI- source: spree api post /price_lists -d '{"name":"EU wholesale","description":"Tiered- pricing for verified B2B customers","match_policy":"all","starts_at":"2026-06-01T00:00:00Z","ends_at":"2026-09-01T00:00:00Z","rules":[{"type":"customer_group_rule","preferences":{"customer_group_ids":["cg_aBc123"]}},{"type":"volume_rule","preferences":{"min_quantity":10}}],"prices":[{"variant_id":"variant_xY9","currency":"USD","amount":"19.99","compare_at_amount":"24.99"},{"variant_id":"variant_aB7","currency":"USD","amount":"21.99"}]}'+ source: spree api post /orders/{order_id}/payments -d '{"payment_method_id":"pm_UkLWZg9DAJ","amount":"99.99","source_id":"cc_UkLWZg9DAJ"}'parameters:- name: x-spree-api-keyin: header@@ -13138,141 +13114,68 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authentication+ schema:+ type: string+ - name: order_id+ in: path+ required: true+ description: Order IDschema:type: stringresponses:'201':- description: price list created (server-to-server — rules + prices, no product_ids)- content:- application/json:- example:- id: pl_EfhxLZ9ck8- name: EU wholesale- description:- status: draft- position: 3- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:18.433Z'- updated_at: '2026-07-27T20:01:18.435Z'- currently_active: false- products_count: 1- prices_count: 2- product_ids:- - prod_UkLWZg9DAJ- schema:- "$ref": "#/components/schemas/PriceList"- '422':- description: validation error+ description: payment createdcontent:application/json:example:- error:- code: validation_error- message: Name can't be blank- details:- name:- - can't be blank- schema:- "$ref": "#/components/schemas/ErrorResponse"+ id: py_gbHJdmfrXB+ payment_method_id: pm_EfhxLZ9ck8+ response_code:+ number: P4CZSVJT+ amount: '110.0'+ display_amount: "$110.00"+ status: checkout+ source_type:+ source_id:+ source:+ metadata: {}+ avs_response:+ cvv_response_code:+ cvv_response_message:+ created_at: '2026-07-29T08:38:05.082Z'+ updated_at: '2026-07-29T08:38:05.082Z'+ captured_amount: '0.0'+ order_id: or_gbHJdmfrXBrequestBody:content:application/json:schema:type: objectrequired:- - name+ - payment_method_idproperties:- name:- type: string- example: EU wholesale- description:- type: string- nullable: true- starts_at:+ payment_method_id:type: string- nullable: true- example: '2026-06-01T00:00:00Z'- ends_at:+ description: Payment method ID+ amount:type: string- nullable: true- example: '2026-09-01T00:00:00Z'- match_policy:+ example: '99.99'+ source_id:type: string- enum:- - all- - any- example: all- position:- type: integer- example: 1- product_ids:- type: array- items:- type: string- description: Prefixed product ids to seed the list with.- example:- - prod_aBc123- 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- example: volume_rule- 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- example: variant_xY9- currency:- type: string- example: USD- amount:- type: string- nullable: true- example: '19.99'- compare_at_amount:- type: string- nullable: true- example: '24.99'- "/api/v3/admin/price_lists/{id}":- parameters:- - name: id- in: path- required: true- schema:- type: string+ description: Payment source ID+ "/api/v3/admin/orders/{order_id}/payments/{id}":get:- summary: Get a price list+ summary: Show a paymenttags:- - Pricing+ - Paymentssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `read_products` (for API-key authentication)."+ description: |-+ Returns details of a specific payment.++ **Required scope:** `read_payments` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -13284,10 +13187,10 @@ paths:secretKey: 'sk_xxx',})- const priceList = await client.priceLists.get('pl_xxx')+ const payment = await client.orders.payments.get('or_UkLWZg9DAJ', 'pay_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /price_lists/{id}+ source: spree api get /orders/{order_id}/payments/{id}parameters:- name: x-spree-api-keyin: header@@ -13297,61 +13200,84 @@ paths:- name: Authorizationin: headerrequired: 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 IDschema:type: string- name: expandin: queryrequired: 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: stringresponses:'200':- description: price list found- content:- application/json:- example:- id: pl_UkLWZg9DAJ- name: Wholesale- description:- status: draft- position: 1- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:18.735Z'- updated_at: '2026-07-27T20:01:18.735Z'- currently_active: false- products_count: 0- prices_count: 0- product_ids: []- schema:- "$ref": "#/components/schemas/PriceList"- '404':- description: price list not found+ description: payment foundcontent:application/json:example:- error:- code: record_not_found- message: Price list not found- schema:- "$ref": "#/components/schemas/ErrorResponse"+ id: py_UkLWZg9DAJ+ payment_method_id: pm_UkLWZg9DAJ+ response_code: BGS-cbc2e5545b26+ number: PMZTR0EB+ amount: '110.0'+ display_amount: "$110.00"+ status: completed+ source_type: credit_card+ source_id: card_UkLWZg9DAJ+ source:+ id: card_UkLWZg9DAJ+ brand: visa+ last4: '1111'+ month: 12+ year: 2027+ name: Spree Commerce+ default: false+ gateway_payment_profile_id:+ customer_id:+ payment_method_id: pm_gbHJdmfrXB+ metadata: {}+ created_at: '2026-07-29T08:38:05.429Z'+ updated_at: '2026-07-29T08:38:05.431Z'+ metadata: {}+ avs_response:+ cvv_response_code:+ cvv_response_message:+ created_at: '2026-07-29T08:38:05.430Z'+ updated_at: '2026-07-29T08:38:05.430Z'+ captured_amount: '0.0'+ order_id: or_UkLWZg9DAJ+ "/api/v3/admin/orders/{order_id}/payments/{id}/capture":patch:- summary: Update a price list+ summary: Capture a paymenttags:- - Pricing+ - Paymentssecurity:- api_key: []bearer_auth: []description: |-- Updates a price list. The optional `rules:` array reconciles nested- STI-typed price rules in a single round-trip — existing rules update- by `id`, new rules build, missing rules destroy. Mirrors the- promotion editor's "save the whole thing on Save" pattern.-+ Captures a pending payment.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `write_payments` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -13363,12 +13289,11 @@ paths:secretKey: 'sk_xxx',})- const priceList = await client.priceLists.update('pl_xxx', {- name: 'Wholesale (Q3)',- })+ const payment = await client.orders.payments.capture('or_UkLWZg9DAJ', 'pay_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api patch /price_lists/{id} -d '{"name":"Wholesale (Q3)"}'+ source: spree api patch /orders/{order_id}/payments/{id}/capture -d '{ ...+ }'parameters:- name: x-spree-api-keyin: header@@ -13378,171 +13303,80 @@ paths:- name: Authorizationin: headerrequired: 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 IDschema:type: stringresponses:'200':- description: price list updated with nested rules+ description: payment capturedcontent:application/json:example:- id: pl_UkLWZg9DAJ- name: Wholesale (Q3)- description:- status: draft- position: 1- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:20.309Z'- updated_at: '2026-07-27T20:01:20.586Z'- currently_active: false- products_count: 0- prices_count: 0- product_ids: []+ id: py_UkLWZg9DAJ+ payment_method_id: pm_UkLWZg9DAJ+ response_code: BGS-4bf168a10987+ number: PFEW18X4+ amount: '110.0'+ display_amount: "$110.00"+ status: completed+ source_type: credit_card+ source_id: card_UkLWZg9DAJ+ source:+ id: card_UkLWZg9DAJ+ brand: visa+ last4: '1111'+ month: 12+ year: 2027+ name: Spree Commerce+ default: false+ gateway_payment_profile_id:+ customer_id:+ payment_method_id: pm_gbHJdmfrXB+ metadata: {}+ created_at: '2026-07-29T08:38:06.062Z'+ updated_at: '2026-07-29T08:38:06.065Z'+ metadata: {}+ avs_response:+ cvv_response_code:+ cvv_response_message:+ created_at: '2026-07-29T08:38:06.064Z'+ updated_at: '2026-07-29T08:38:06.384Z'+ captured_amount: '110.0'+ order_id: or_UkLWZg9DAJ+ '422':+ description: capture failed+ content:+ application/json:+ example:+ error:+ code: processing_error+ message: 'Bogus Gateway: Forced failure'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).- example:- - prod_aBc123- rules:- type: array- items:- type: object- required:- - type- properties:- id:- type: string- nullable: true- type:- type: string- example: volume_rule- 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- example: price_aBc123- variant_id:- type: string- example: variant_xY9- currency:- type: string- example: USD- amount:- type: string- nullable: true- example: '12.50'- compare_at_amount:- type: string- nullable: true- example: '15.00'- delete:- summary: Delete a price list- tags:- - Pricing- security:- - api_key: []- bearer_auth: []- description: |-- Soft-deletes the price list. Associated prices are removed asynchronously.-- **Required scope:** `write_products` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- await client.priceLists.delete('pl_xxx')- - lang: bash- label: Spree CLI- source: spree api delete /price_lists/{id}- 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+ "$ref": "#/components/schemas/ErrorResponse"+ "/api/v3/admin/orders/{order_id}/payments/{id}/void":patch:- summary: Activate a price list+ summary: Void a paymenttags:- - Pricing+ - Paymentssecurity:- api_key: []bearer_auth: []description: |-- Transitions a draft / inactive list to `active`. If `starts_at` is- in the future the list is marked `scheduled` instead, matching the- legacy admin behaviour.-+ Voids a payment.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `write_payments` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -13554,10 +13388,10 @@ paths:secretKey: 'sk_xxx',})- const priceList = await client.priceLists.activate('pl_xxx')+ const payment = await client.orders.payments.void('or_UkLWZg9DAJ', 'pay_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api patch /price_lists/{id}/activate -d '{ ... }'+ source: spree api patch /orders/{order_id}/payments/{id}/void -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -13567,111 +13401,68 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: string- responses:- '200':- description: price list activated- content:- application/json:- example:- id: pl_UkLWZg9DAJ- name: Wholesale- description:- status: active- position: 1- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:20.896Z'- updated_at: '2026-07-27T20:01:21.182Z'- currently_active: true- products_count: 0- prices_count: 0- product_ids: []- 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)."- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const priceList = await client.priceLists.deactivate('pl_xxx')- - lang: bash- label: Spree CLI- source: spree api patch /price_lists/{id}/deactivate -d '{ ... }'- parameters:- - name: x-spree-api-key- in: header+ - name: order_id+ in: pathrequired: true+ description: Order IDschema:type: string- - name: Authorization- in: header+ - name: id+ in: pathrequired: true+ description: Payment IDschema:type: stringresponses:'200':- description: price list deactivated+ description: payment voidedcontent:application/json:example:- id: pl_UkLWZg9DAJ- name: Price List 1- description:- status: inactive- position: 1- match_policy: all- starts_at:- ends_at:- deleted_at:- created_at: '2026-07-27T20:01:21.193Z'- updated_at: '2026-07-27T20:01:21.480Z'- currently_active: false- products_count: 0- prices_count: 0- product_ids: []- schema:- "$ref": "#/components/schemas/PriceList"- "/api/v3/admin/prices":+ id: py_UkLWZg9DAJ+ payment_method_id: pm_UkLWZg9DAJ+ response_code: void-BGS-efa7b18b44a8+ number: PW06KO91+ amount: '110.0'+ display_amount: "$110.00"+ status: void+ source_type: credit_card+ source_id: card_UkLWZg9DAJ+ source:+ id: card_UkLWZg9DAJ+ brand: visa+ last4: '1111'+ month: 12+ year: 2027+ name: Spree Commerce+ default: false+ gateway_payment_profile_id:+ customer_id:+ payment_method_id: pm_gbHJdmfrXB+ metadata: {}+ created_at: '2026-07-29T08:38:07.431Z'+ updated_at: '2026-07-29T08:38:07.434Z'+ metadata: {}+ avs_response:+ cvv_response_code:+ cvv_response_message:+ created_at: '2026-07-29T08:38:07.433Z'+ updated_at: '2026-07-29T08:38:07.728Z'+ captured_amount: '0.0'+ order_id: or_UkLWZg9DAJ+ "/api/v3/admin/price_lists":get:- summary: List prices+ summary: List price liststags:- Pricingsecurity:- api_key: []bearer_auth: []description: |-- Generic prices endpoint covering both base prices and price-list- overrides. Filter with Ransack: `q[price_list_id_eq]=…`,- `q[currency_eq]=USD`, `q[price_list_id_null]=true` (base prices only).-- The admin spreadsheet uses this with server-side pagination so it- scales past the metadata-PATCH path on `/price_lists/:id`.-+ Returns the price lists configured for the current store.**Required scope:** `read_products` (for API-key authentication).x-codeSamples:@@ -13685,14 +13476,10 @@ paths:secretKey: 'sk_xxx',})- const { data: prices } = await client.prices.list({- price_list_id_eq: 'pl_xxx',- currency_eq: 'USD',- expand: ['variant'],- })+ const { data: priceLists } = await client.priceLists.list()- lang: bashlabel: Spree CLI- source: spree api get /prices -d '{"price_list_id_eq":"pl_xxx","currency_eq":"USD","expand":["variant"]}'+ source: spree api get /price_listsparameters:- name: x-spree-api-keyin: header@@ -13714,69 +13501,64 @@ paths:required: falseschema:type: integer- - name: q[price_list_id_eq]+ - name: q[name_cont]in: queryrequired: falseschema:type: string- - name: q[price_list_id_null]+ - name: q[status_eq]in: queryrequired: falseschema:- type: boolean- - name: q[currency_eq]+ type: string+ - name: sortin: queryrequired: falseschema: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: expandin: queryrequired: false- description: 'Comma-separated associations to embed. Supported: `variant`.'+ description: 'Comma-separated associations to embed. Supported: `price_rules`.'schema:type: stringresponses:'200':- description: prices found+ description: price lists foundcontent:application/json:example:data:- - id: price_gbHJdmfrXB- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- variant_id: variant_gbHJdmfrXB- created_at: '2026-07-27T20:01:21.537Z'- updated_at: '2026-07-27T20:01:21.537Z'- - id: price_EfhxLZ9ck8- amount: '5.0'- amount_in_cents: 500- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$5.00"- display_compare_at_amount:- price_list_id: pl_UkLWZg9DAJ- variant_id: variant_gbHJdmfrXB- created_at: '2026-07-27T20:01:21.541Z'- updated_at: '2026-07-27T20:01:21.541Z'+ - id: pl_UkLWZg9DAJ+ name: Wholesale+ description:+ status: draft+ position: 1+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:20.853Z'+ updated_at: '2026-07-29T08:38:20.853Z'+ currently_active: false+ products_count: 0+ prices_count: 0+ product_ids: []+ - id: pl_gbHJdmfrXB+ name: Holiday+ description:+ status: draft+ position: 2+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:20.854Z'+ updated_at: '2026-07-29T08:38:20.854Z'+ currently_active: false+ products_count: 0+ prices_count: 0+ product_ids: []meta:page: 1limit: 25@@ -13793,23 +13575,21 @@ paths:data:type: arrayitems:- "$ref": "#/components/schemas/Price"+ "$ref": "#/components/schemas/PriceList"meta:"$ref": "#/components/schemas/PaginationMeta"required:- data- metapost:- summary: Create a price+ summary: Create a price listtags:- Pricingsecurity:- api_key: []bearer_auth: []description: |-- Creates a single price. Omit `price_list_id` to create a base price.- For more than a handful of rows, prefer `POST /admin/prices/bulk_upsert`.-+ Creates a new draft price list.**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -13823,14 +13603,45 @@ paths:secretKey: 'sk_xxx',})- const price = await client.prices.create({- variant_id: 'variant_xxx',- currency: 'USD',- amount: '19.99',+ // Server-to-server one-shot create. Ship the rules that gate the list+ // and the exact per-variant prices in a single request — variants in+ // `prices` implicitly become part of the list (upserted on the unique+ // key `(variant_id, currency, price_list_id)`), so there's no need to+ // pre-declare `product_ids` separately.+ const priceList = await client.priceLists.create({+ name: 'EU wholesale',+ description: 'Tiered pricing for verified B2B customers',+ match_policy: 'all',+ starts_at: '2026-06-01T00:00:00Z',+ ends_at: '2026-09-01T00:00:00Z',+ rules: [+ {+ type: 'customer_group_rule',+ preferences: { customer_group_ids: ['cg_aBc123'] },+ },+ {+ type: 'volume_rule',+ preferences: { min_quantity: 10 },+ },+ ],+ prices: [+ {+ variant_id: 'variant_xY9',+ currency: 'USD',+ amount: '19.99',+ compare_at_amount: '24.99',+ },+ {+ variant_id: 'variant_aB7',+ currency: 'USD',+ amount: '21.99',+ },+ ],})- lang: bashlabel: Spree CLI- source: spree api post /prices -d '{"variant_id":"variant_xxx","currency":"USD","amount":"19.99"}'+ source: spree api post /price_lists -d '{"name":"EU wholesale","description":"Tiered+ pricing for verified B2B customers","match_policy":"all","starts_at":"2026-06-01T00:00:00Z","ends_at":"2026-09-01T00:00:00Z","rules":[{"type":"customer_group_rule","preferences":{"customer_group_ids":["cg_aBc123"]}},{"type":"volume_rule","preferences":{"min_quantity":10}}],"prices":[{"variant_id":"variant_xY9","currency":"USD","amount":"19.99","compare_at_amount":"24.99"},{"variant_id":"variant_aB7","currency":"USD","amount":"21.99"}]}'parameters:- name: x-spree-api-keyin: header@@ -13844,52 +13655,123 @@ paths:type: stringresponses:'201':- description: price created+ description: price list created (server-to-server — rules + prices, no product_ids)content:application/json:example:- id: price_uw2YK1rnl0- amount: '9.99'- amount_in_cents: 999- compare_at_amount:- compare_at_amount_in_cents:- currency: EUR- display_amount: "€9.99"- display_compare_at_amount:- price_list_id:- variant_id: variant_EfhxLZ9ck8- created_at: '2026-07-27T20:01:22.180Z'- updated_at: '2026-07-27T20:01:22.180Z'+ id: pl_EfhxLZ9ck8+ name: EU wholesale+ description:+ status: draft+ position: 3+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:21.838Z'+ updated_at: '2026-07-29T08:38:21.840Z'+ currently_active: false+ products_count: 1+ prices_count: 2+ product_ids:+ - prod_UkLWZg9DAJschema:- "$ref": "#/components/schemas/Price"+ "$ref": "#/components/schemas/PriceList"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:schema:type: objectrequired:- - variant_id- - currency+ - nameproperties:- variant_id:- type: string- example: variant_xY9- currency:+ name:type: string- example: USD- amount:+ example: EU wholesale+ description:type: stringnullable: true- example: '19.99'- compare_at_amount:+ starts_at:type: stringnullable: true- example: '24.99'- price_list_id:+ example: '2026-06-01T00:00:00Z'+ ends_at:type: stringnullable: true- example: pl_aBc123- "/api/v3/admin/prices/{id}":+ example: '2026-09-01T00:00:00Z'+ match_policy:+ type: string+ enum:+ - all+ - any+ example: all+ position:+ type: integer+ example: 1+ product_ids:+ type: array+ items:+ type: string+ description: Prefixed product ids to seed the list with.+ example:+ - prod_aBc123+ 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+ example: volume_rule+ 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+ example: variant_xY9+ currency:+ type: string+ example: USD+ amount:+ type: string+ nullable: true+ example: '19.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '24.99'+ "/api/v3/admin/price_lists/{id}":parameters:- name: idin: path@@ -13897,7 +13779,7 @@ paths:schema:type: stringget:- summary: Get a price+ summary: Get a price listtags:- Pricingsecurity:@@ -13915,10 +13797,10 @@ paths:secretKey: 'sk_xxx',})- const price = await client.prices.get('price_xxx')+ const priceList = await client.priceLists.get('pl_xxx')- lang: bashlabel: Spree CLI- source: spree api get /prices/{id}+ source: spree api get /price_lists/{id}parameters:- name: x-spree-api-keyin: header@@ -13930,44 +13812,59 @@ paths:required: trueschema:type: string+ - name: expand+ in: query+ required: false+ schema:+ type: stringresponses:'200':- description: price found+ description: price list foundcontent:application/json:example:- id: price_EfhxLZ9ck8- amount: '5.0'- amount_in_cents: 500- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$5.00"- display_compare_at_amount:- price_list_id: pl_UkLWZg9DAJ- variant_id: variant_gbHJdmfrXB- created_at: '2026-07-27T20:01:22.236Z'- updated_at: '2026-07-27T20:01:22.236Z'- schema:- "$ref": "#/components/schemas/Price"+ id: pl_UkLWZg9DAJ+ name: Wholesale+ description:+ status: draft+ position: 1+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:22.140Z'+ updated_at: '2026-07-29T08:38:22.140Z'+ currently_active: false+ products_count: 0+ prices_count: 0+ product_ids: []+ schema:+ "$ref": "#/components/schemas/PriceList"'404':- description: price not found+ description: price list not foundcontent:application/json:example:error:code: record_not_found- message: Price not found+ message: Price list not foundschema:"$ref": "#/components/schemas/ErrorResponse"patch:- summary: Update a price+ summary: Update a price listtags:- Pricingsecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_products` (for API-key authentication)."+ description: |-+ Updates a price list. The optional `rules:` array reconciles nested+ STI-typed price rules in a single round-trip — existing rules update+ by `id`, new rules build, missing rules destroy. Mirrors the+ promotion editor's "save the whole thing on Save" pattern.+++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -13979,12 +13876,12 @@ paths:secretKey: 'sk_xxx',})- const price = await client.prices.update('price_xxx', {- amount: '12.34',+ const priceList = await client.priceLists.update('pl_xxx', {+ name: 'Wholesale (Q3)',})- lang: bashlabel: Spree CLI- source: spree api patch /prices/{id} -d '{"amount":"12.34"}'+ source: spree api patch /price_lists/{id} -d '{"name":"Wholesale (Q3)"}'parameters:- name: x-spree-api-keyin: header@@ -13998,45 +13895,115 @@ paths:type: stringresponses:'200':- description: price updated+ description: price list updated with nested rulescontent:application/json:example:- id: price_EfhxLZ9ck8- amount: '12.34'- amount_in_cents: 1234- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$12.34"- display_compare_at_amount:- price_list_id: pl_UkLWZg9DAJ- variant_id: variant_gbHJdmfrXB- created_at: '2026-07-27T20:01:22.922Z'- updated_at: '2026-07-27T20:01:23.200Z'+ id: pl_UkLWZg9DAJ+ name: Wholesale (Q3)+ description:+ status: draft+ position: 1+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:23.672Z'+ updated_at: '2026-07-29T08:38:23.948Z'+ currently_active: false+ products_count: 0+ prices_count: 0+ product_ids: []schema:- "$ref": "#/components/schemas/Price"+ "$ref": "#/components/schemas/PriceList"requestBody:content:application/json:schema:type: objectproperties:- amount:+ name:+ type: string+ description:type: stringnullable: true- compare_at_amount:+ starts_at:+ type: string+ nullable: true+ ends_at:type: stringnullable: 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).+ example:+ - prod_aBc123+ rules:+ type: array+ items:+ type: object+ required:+ - type+ properties:+ id:+ type: string+ nullable: true+ type:+ type: string+ example: volume_rule+ 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+ example: price_aBc123+ variant_id:+ type: string+ example: variant_xY9+ currency:+ type: string+ example: USD+ amount:+ type: string+ nullable: true+ example: '12.50'+ compare_at_amount:+ type: string+ nullable: true+ example: '15.00'delete:- summary: Delete a price+ summary: Delete a price listtags:- Pricingsecurity:- api_key: []bearer_auth: []description: |-- Soft-deletes the price (acts_as_paranoid).+ Soft-deletes the price list. Associated prices are removed asynchronously.**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -14050,10 +14017,10 @@ paths:secretKey: 'sk_xxx',})- await client.prices.delete('price_xxx')+ await client.priceLists.delete('pl_xxx')- lang: bashlabel: Spree CLI- source: spree api delete /prices/{id}+ source: spree api delete /price_lists/{id}parameters:- name: x-spree-api-keyin: header@@ -14067,26 +14034,25 @@ paths:type: stringresponses:'204':- description: price deleted- "/api/v3/admin/prices/bulk_upsert":- post:- summary: Bulk-upsert prices+ 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 listtags:- Pricingsecurity:- api_key: []bearer_auth: []description: |-- Upserts a batch of prices in a single SQL round trip.-- Each row either:- * targets an existing price by `id`, OR- * matches on the unique key `(variant_id, currency, price_list_id)` —- updating the existing row if one exists, creating one otherwise.-- Model callbacks (e.g. PriceHistory) are bypassed; this is a- bulk-write fast path for the admin spreadsheet. The response- carries `price_count` — the number of rows touched.+ Transitions a draft / inactive list to `active`. If `starts_at` is+ in the future the list is marked `scheduled` instead, matching the+ legacy admin behaviour.**Required scope:** `write_products` (for API-key authentication).@@ -14101,25 +14067,10 @@ paths:secretKey: 'sk_xxx',})- const { price_count } = await client.prices.bulkUpsert({- prices: [- {- variant_id: 'variant_xxx',- currency: 'USD',- price_list_id: 'pl_xxx',- amount: '11.11',- },- {- variant_id: 'variant_yyy',- currency: 'USD',- price_list_id: 'pl_xxx',- amount: '22.22',- },- ],- })+ const priceList = await client.priceLists.activate('pl_xxx')- lang: bashlabel: Spree CLI- source: spree api post /prices/bulk_upsert -d '{"prices":[{"variant_id":"variant_xxx","currency":"USD","price_list_id":"pl_xxx","amount":"11.11"},{"variant_id":"variant_yyy","currency":"USD","price_list_id":"pl_xxx","amount":"22.22"}]}'+ source: spree api patch /price_lists/{id}/activate -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -14133,76 +14084,109 @@ paths:type: stringresponses:'200':- description: prices upserted+ description: price list activatedcontent:application/json:example:- price_count: 2+ id: pl_UkLWZg9DAJ+ name: Wholesale+ description:+ status: active+ position: 1+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:24.247Z'+ updated_at: '2026-07-29T08:38:24.524Z'+ currently_active: true+ products_count: 0+ prices_count: 0+ product_ids: []schema:- type: object- properties:- price_count:- type: integer- '422':- description: missing prices key+ "$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)."+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const priceList = await client.priceLists.deactivate('pl_xxx')+ - lang: bash+ label: Spree CLI+ source: spree api patch /price_lists/{id}/deactivate -d '{ ... }'+ 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 deactivatedcontent:application/json:example:- error:- code: missing_prices- message: prices is required (send an empty array to no-op).+ id: pl_UkLWZg9DAJ+ name: Price List 1+ description:+ status: inactive+ position: 1+ match_policy: all+ starts_at:+ ends_at:+ deleted_at:+ created_at: '2026-07-29T08:38:24.533Z'+ updated_at: '2026-07-29T08:38:24.812Z'+ currently_active: false+ products_count: 0+ prices_count: 0+ product_ids: []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- example: price_aBc123- variant_id:- type: string- example: variant_xY9- currency:- type: string- example: USD- price_list_id:- type: string- nullable: true- example: pl_aBc123- amount:- type: string- nullable: true- example: '19.99'- compare_at_amount:- type: string- nullable: true- example: '24.99'- "/api/v3/admin/prices/bulk_destroy":- delete:- summary: Bulk-delete prices+ "$ref": "#/components/schemas/PriceList"+ "/api/v3/admin/prices":+ get:+ summary: List pricestags:- Pricingsecurity:- api_key: []bearer_auth: []description: |-- Soft-deletes each price in `ids`. Returns the count actually destroyed.+ Generic prices endpoint covering both base prices and price-list+ overrides. Filter with Ransack: `q[price_list_id_eq]=…`,+ `q[currency_eq]=USD`, `q[price_list_id_null]=true` (base prices only).- **Required scope:** `write_products` (for API-key authentication).+ The admin spreadsheet uses this with server-side pagination so it+ scales past the metadata-PATCH path on `/price_lists/:id`.+++ **Required scope:** `read_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -14214,12 +14198,14 @@ paths:secretKey: 'sk_xxx',})- const { price_count } = await client.prices.bulkDestroy({- ids: ['price_xxx', 'price_yyy'],+ const { data: prices } = await client.prices.list({+ price_list_id_eq: 'pl_xxx',+ currency_eq: 'USD',+ expand: ['variant'],})- lang: bashlabel: Spree CLI- source: spree api delete /prices/bulk_destroy -d '{"ids":["price_xxx","price_yyy"]}'+ source: spree api get /prices -d '{"price_list_id_eq":"pl_xxx","currency_eq":"USD","expand":["variant"]}'parameters:- name: x-spree-api-keyin: header@@ -14231,123 +14217,124 @@ paths:required: trueschema:type: string- responses:- '200':- description: prices deleted- content:- application/json:- example:- price_count: 1- 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.-- **Required scope:** `read_products` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const { data: customFields } = await client.products.customFields.list('prod_UkLWZg9DAJ')- - lang: bash- label: Spree CLI- source: spree api get /products/{product_id}/custom_fields- parameters:- - name: x-spree-api-key- in: header- required: true+ - 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: falseschema:type: string- - name: Authorization- in: header- required: true+ - name: q[price_list_id_null]+ in: query+ required: false+ schema:+ type: boolean+ - name: q[currency_eq]+ in: query+ required: falseschema:type: string- - name: product_id- in: path- required: true+ - name: q[variant_id_eq]+ in: query+ required: falseschema:type: string- - name: expand+ - name: sortin: queryrequired: false- description: Comma-separated associations to expand (e.g., custom_field_definition).- Use dot notation for nested expand (max 4 levels).+ description: Comma-separated sort keys. Supports e.g. `variant_product_name,variant_id`.schema:type: string- - name: fields+ - name: expandin: queryrequired: false- description: Comma-separated list of fields to include (e.g., key,value,namespace).- id is always included.+ description: 'Comma-separated associations to embed. Supported: `variant`.'schema:type: stringresponses:'200':- description: custom fields found+ description: prices foundcontent:application/json:example:data:- - id: cf_UkLWZg9DAJ- label: Title- type: Spree::Metafields::ShortText- field_type: short_text- key: custom.title- value: wool- created_at: '2026-07-27T20:01:24.600Z'- updated_at: '2026-07-27T20:01:24.600Z'- storefront_visible: true- custom_field_definition_id: cfdef_UkLWZg9DAJ+ - id: price_UkLWZg9DAJ+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:24.841Z'+ updated_at: '2026-07-29T08:38:24.841Z'+ - id: price_gbHJdmfrXB+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_gbHJdmfrXB+ created_at: '2026-07-29T08:38:24.859Z'+ updated_at: '2026-07-29T08:38:24.859Z'+ - id: price_EfhxLZ9ck8+ amount: '5.0'+ amount_in_cents: 500+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$5.00"+ display_compare_at_amount:+ price_list_id: pl_UkLWZg9DAJ+ variant_id: variant_gbHJdmfrXB+ created_at: '2026-07-29T08:38:24.862Z'+ updated_at: '2026-07-29T08:38:24.862Z'meta:page: 1limit: 25- count: 1+ count: 3pages: 1from: 1- to: 1- in: 1+ to: 3+ in: 3previous:next:+ schema:+ type: object+ properties:+ data:+ type: array+ items:+ "$ref": "#/components/schemas/Price"+ meta:+ "$ref": "#/components/schemas/PaginationMeta"+ required:+ - data+ - metapost:- summary: Create a product custom field+ summary: Create a pricetags:- - Products+ - Pricingsecurity:- api_key: []bearer_auth: []description: |-- Sets a custom field value on the product. Requires an existing CustomFieldDefinition; pass its prefixed `cfdef_…` id.+ Creates a single price. Omit `price_list_id` to create a base price.+ For more than a handful of rows, prefer `POST /admin/prices/bulk_upsert`.+**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -14361,13 +14348,14 @@ paths:secretKey: 'sk_xxx',})- const customField = await client.products.customFields.create('prod_UkLWZg9DAJ', {- custom_field_definition_id: 'cfdef_AbC123XyZ',- value: 'wool',+ const price = await client.prices.create({+ variant_id: 'variant_xxx',+ currency: 'USD',+ amount: '19.99',})- lang: bashlabel: Spree CLI- source: spree api post /products/{product_id}/custom_fields -d '{"custom_field_definition_id":"cfdef_AbC123XyZ","value":"wool"}'+ source: spree api post /prices -d '{"variant_id":"variant_xxx","currency":"USD","amount":"19.99"}'parameters:- name: x-spree-api-keyin: header@@ -14379,57 +14367,64 @@ paths:required: trueschema:type: string- - name: product_id- in: path- required: true- schema:- type: stringresponses:'201':- description: custom field created+ description: price createdcontent:application/json:example:- id: cf_gbHJdmfrXB- label: Description- type: Spree::Metafields::LongText- field_type: long_text- key: custom.description- value: A longer description- created_at: '2026-07-27T20:01:25.214Z'- updated_at: '2026-07-27T20:01:25.214Z'- storefront_visible: true- custom_field_definition_id: cfdef_gbHJdmfrXB- '422':- description: duplicate definition for the same product- content:- application/json:- example:- error:- code: validation_error- message: Metafield definition has already been taken- details:- metafield_definition_id:- - has already been taken+ id: price_uw2YK1rnl0+ amount: '9.99'+ amount_in_cents: 999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: EUR+ display_amount: "€9.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_EfhxLZ9ck8+ created_at: '2026-07-29T08:38:25.496Z'+ updated_at: '2026-07-29T08:38:25.496Z'+ schema:+ "$ref": "#/components/schemas/Price"requestBody:content:application/json:schema:type: objectrequired:- - custom_field_definition_id- - value+ - variant_id+ - currencyproperties:- custom_field_definition_id:+ variant_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}":+ example: variant_xY9+ currency:+ type: string+ example: USD+ amount:+ type: string+ nullable: true+ example: '19.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '24.99'+ price_list_id:+ type: string+ nullable: true+ example: pl_aBc123+ "/api/v3/admin/prices/{id}":+ parameters:+ - name: id+ in: path+ required: true+ schema:+ type: stringget:- summary: Show a product custom field+ summary: Get a pricetags:- - Products+ - Pricingsecurity:- api_key: []bearer_auth: []@@ -14445,10 +14440,10 @@ paths:secretKey: 'sk_xxx',})- const customField = await client.products.customFields.get('prod_UkLWZg9DAJ', 'cf_AbC123XyZ')+ const price = await client.prices.get('price_xxx')- lang: bashlabel: Spree CLI- source: spree api get /products/{product_id}/custom_fields/{id}+ source: spree api get /prices/{id}parameters:- name: x-spree-api-keyin: header@@ -14460,57 +14455,44 @@ paths:required: trueschema: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: stringresponses:'200':- description: custom field found+ description: price foundcontent:application/json:example:- id: cf_UkLWZg9DAJ- label: Title- type: Spree::Metafields::ShortText- field_type: short_text- key: custom.title- value: wool- created_at: '2026-07-27T20:01:25.564Z'- updated_at: '2026-07-27T20:01:25.564Z'- storefront_visible: true- custom_field_definition_id: cfdef_UkLWZg9DAJ+ id: price_EfhxLZ9ck8+ amount: '5.0'+ amount_in_cents: 500+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$5.00"+ display_compare_at_amount:+ price_list_id: pl_UkLWZg9DAJ+ variant_id: variant_gbHJdmfrXB+ created_at: '2026-07-29T08:38:25.546Z'+ updated_at: '2026-07-29T08:38:25.546Z'+ schema:+ "$ref": "#/components/schemas/Price"+ '404':+ description: price not found+ content:+ application/json:+ example:+ error:+ code: record_not_found+ message: Price not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse"patch:- summary: Update a product custom field+ summary: Update a pricetags:- - Products+ - Pricingsecurity:- api_key: []bearer_auth: []- description: |-- Updates the custom field's `value`. The linked definition cannot be changed — delete and recreate to switch.-- **Required scope:** `write_products` (for API-key authentication).+ description: "**Required scope:** `write_products` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -14522,12 +14504,12 @@ paths:secretKey: 'sk_xxx',})- const customField = await client.products.customFields.update('prod_UkLWZg9DAJ', 'cf_AbC123XyZ', {- value: 'cotton',+ const price = await client.prices.update('price_xxx', {+ amount: '12.34',})- lang: bashlabel: Spree CLI- source: spree api patch /products/{product_id}/custom_fields/{id} -d '{"value":"cotton"}'+ source: spree api patch /prices/{id} -d '{"amount":"12.34"}'parameters:- name: x-spree-api-keyin: header@@ -14539,50 +14521,49 @@ paths:required: trueschema:type: string- - name: product_id- in: path- required: true- schema:- type: string- - name: id- in: path- required: true- schema:- type: stringresponses:'200':- description: custom field updated+ description: price updatedcontent:application/json:example:- id: cf_UkLWZg9DAJ- label: Title- type: Spree::Metafields::ShortText- field_type: short_text- key: custom.title- value: cotton- created_at: '2026-07-27T20:01:25.883Z'- updated_at: '2026-07-27T20:01:26.160Z'- storefront_visible: true- custom_field_definition_id: cfdef_UkLWZg9DAJ+ id: price_EfhxLZ9ck8+ amount: '12.34'+ amount_in_cents: 1234+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$12.34"+ display_compare_at_amount:+ price_list_id: pl_UkLWZg9DAJ+ variant_id: variant_gbHJdmfrXB+ created_at: '2026-07-29T08:38:26.202Z'+ updated_at: '2026-07-29T08:38:26.479Z'+ schema:+ "$ref": "#/components/schemas/Price"requestBody:content:application/json:schema:type: object- required:- - valueproperties:- value:- description: New value+ amount:+ type: string+ nullable: true+ compare_at_amount:+ type: string+ nullable: truedelete:- summary: Delete a product custom field+ summary: Delete a pricetags:- - Products+ - Pricingsecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_products` (for API-key authentication)."+ description: |-+ Soft-deletes the price (acts_as_paranoid).++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -14594,10 +14575,10 @@ paths:secretKey: 'sk_xxx',})- await client.products.customFields.delete('prod_UkLWZg9DAJ', 'cf_AbC123XyZ')+ await client.prices.delete('price_xxx')- lang: bashlabel: Spree CLI- source: spree api delete /products/{product_id}/custom_fields/{id}+ source: spree api delete /prices/{id}parameters:- name: x-spree-api-keyin: header@@ -14609,109 +14590,31 @@ paths:required: trueschema:type: string- - name: product_id- in: path- required: true- schema:- type: string- - name: id- in: path- required: true- schema:- type: stringresponses:'204':- description: custom field deleted- "/api/v3/admin/products/{product_id}/translations":- get:- summary: List product translations+ description: price deleted+ "/api/v3/admin/prices/bulk_upsert":+ post:+ summary: Bulk-upsert pricestags:- - Products+ - Pricingsecurity:- api_key: []bearer_auth: []description: |-- Returns the full translation matrix for the product: the source value and content type per translatable field, plus the translated value for every supported locale.+ Upserts a batch of prices in a single SQL round trip.- **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- responses:- '200':- description: translations found- content:- application/json:- example:- data:- resource_id: prod_UkLWZg9DAJ- resource_type: product- translations:- de:- name: Espressomaschine- description:- slug: espressomaschine- meta_description:- meta_title:- translated_field_count: 2- fr:- name:- description:- slug:- meta_description:- meta_title:- translated_field_count: 0- fields:- - key: name- type: string- source: Espresso Machine- - key: description- type: html- source: |-- Similique laudantium vel neque cumque ipsam molestias harum. Veniam distinctio ducimus possimus minus ad aperiam fuga. Vero reiciendis quaerat nemo aliquam iure minus. Reprehenderit facere esse sit odio.- Sunt consequatur soluta exercitationem fugit. Nihil dolorem nesciunt itaque nemo harum doloribus aperiam. Similique officiis vero nobis porro deserunt accusantium perferendis. Aliquam asperiores labore ad ipsam. Rerum officia neque nisi accusantium.- Asperiores iusto facere atque quos occaecati. Sapiente placeat non illo perspiciatis similique cum ad quas. Impedit soluta quas quasi harum quam commodi at. Dicta provident illo numquam minus. Eos temporibus vitae omnis tempore voluptatem autem quam dolores.- Ducimus cum distinctio error dolorum voluptate. Iste blanditiis possimus modi impedit ducimus tempore beatae. Mollitia velit voluptas voluptates temporibus est error corrupti alias.- Deserunt maiores nostrum accusamus velit. Eum mollitia repellat tenetur nihil iusto possimus nobis reprehenderit. Reprehenderit maiores totam dolorem deserunt pariatur repellat.- - key: slug- type: string- source: espresso-machine- - key: meta_description- type: string- source:- - key: meta_title- type: string- source:- default_locale: en- supported_locales:- - de- - en- - fr- "/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.+ Each row either:+ * targets an existing price by `id`, OR+ * matches on the unique key `(variant_id, currency, price_list_id)` —+ updating the existing row if one exists, creating one otherwise.- **Required scope:** `read_products` (for API-key authentication).+ Model callbacks (e.g. PriceHistory) are bypassed; this is a+ bulk-write fast path for the admin spreadsheet. The response+ carries `price_count` — the number of rows touched.+++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -14723,15 +14626,25 @@ paths:secretKey: 'sk_xxx',})- const { data: products } = await client.products.list({- name_cont: 'shirt',- status_eq: 'active',- sort: '-created_at',- limit: 25,+ const { price_count } = await client.prices.bulkUpsert({+ prices: [+ {+ variant_id: 'variant_xxx',+ currency: 'USD',+ price_list_id: 'pl_xxx',+ amount: '11.11',+ },+ {+ variant_id: 'variant_yyy',+ currency: 'USD',+ price_list_id: 'pl_xxx',+ amount: '22.22',+ },+ ],})- lang: bashlabel: Spree CLI- source: spree api get /products -d '{"name_cont":"shirt","status_eq":"active","sort":"-created_at","limit":25}'+ source: spree api post /prices/bulk_upsert -d '{"prices":[{"variant_id":"variant_xxx","currency":"USD","price_list_id":"pl_xxx","amount":"11.11"},{"variant_id":"variant_yyy","currency":"USD","price_list_id":"pl_xxx","amount":"22.22"}]}'parameters:- name: x-spree-api-keyin: header@@ -14741,163 +14654,78 @@ paths:- name: Authorizationin: headerrequired: 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 statusschema:type: stringresponses:'200':- description: products found+ description: prices upsertedcontent:application/json:example:- data:- - id: prod_UkLWZg9DAJ- name: Product 629418- slug: product-629418- meta_title:- meta_description:- meta_keywords:- variant_count: 0- available_on:- preorder_ships_at:- purchasable: true- preorder: false- in_stock: false- backorderable: true- available: true- description: Possimus consequuntur molestiae mollitia hic esse culpa- soluta. Non fugit vel labore in id at natus. Dolore voluptatem- pariatur cumque dolorem tempora. Beatae explicabo architecto optio- quam. Sit dolore cumque adipisci doloremque ex quisquam ea. Eum- beatae laboriosam magni at sit ex. Maxime esse dicta natus corporis- exercitationem. Libero repudiandae nesciunt officia placeat. Nihil- voluptatibus dolor consequuntur deleniti perferendis. Magni vero- provident natus blanditiis placeat. Aliquam molestiae cum ullam- deserunt consectetur debitis. Blanditiis consequuntur minima beatae- perferendis. Tenetur magni deserunt odit sequi expedita in quis- quos. Eligendi iusto repellendus quae ratione iure. Magni fugit- dolor quae tempora praesentium. Quia ex facere enim ipsum facilis- hic. Eos facilis sapiente consequatur veritatis pariatur ad officiis.- Odio consequuntur rerum aspernatur maxime. Quis consequatur totam- eveniet quidem officiis.- description_html: |-- Possimus consequuntur molestiae mollitia hic esse culpa soluta. Non fugit vel labore in id at natus. Dolore voluptatem pariatur cumque dolorem tempora. Beatae explicabo architecto optio quam. Sit dolore cumque adipisci doloremque ex quisquam ea.- Eum beatae laboriosam magni at sit ex. Maxime esse dicta natus corporis exercitationem. Libero repudiandae nesciunt officia placeat. Nihil voluptatibus dolor consequuntur deleniti perferendis.- Magni vero provident natus blanditiis placeat. Aliquam molestiae cum ullam deserunt consectetur debitis. Blanditiis consequuntur minima beatae perferendis.- Tenetur magni deserunt odit sequi expedita in quis quos. Eligendi iusto repellendus quae ratione iure. Magni fugit dolor quae tempora praesentium.- Quia ex facere enim ipsum facilis hic. Eos facilis sapiente consequatur veritatis pariatur ad officiis. Odio consequuntur rerum aspernatur maxime. Quis consequatur totam eveniet quidem officiis.- default_variant_id: variant_UkLWZg9DAJ- thumbnail_url:- tags: []- price:- id: price_UkLWZg9DAJ- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- variant_id: variant_UkLWZg9DAJ- created_at: '2026-07-27T20:01:26.819Z'- updated_at: '2026-07-27T20:01:26.819Z'- original_price:- status: active- metadata: {}- deleted_at:- created_at: '2026-07-27T20:01:26.811Z'- updated_at: '2026-07-27T20:01:26.825Z'- tax_category_id: taxcat_UkLWZg9DAJ- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:+ price_count: 2schema:type: objectproperties:- data:- type: array- items:- "$ref": "#/components/schemas/Product"- meta:- "$ref": "#/components/schemas/PaginationMeta"- required:- - data- - meta- '401':- description: unauthorized+ price_count:+ type: integer+ '422':+ description: missing prices keycontent:application/json:example:error:- code: authentication_required- message: Authentication required+ code: missing_prices+ message: prices is required (send an empty array to no-op).schema:"$ref": "#/components/schemas/ErrorResponse"- post:- summary: Create a product+ 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+ example: price_aBc123+ variant_id:+ type: string+ example: variant_xY9+ currency:+ type: string+ example: USD+ price_list_id:+ type: string+ nullable: true+ example: pl_aBc123+ amount:+ type: string+ nullable: true+ example: '19.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '24.99'+ "/api/v3/admin/prices/bulk_destroy":+ delete:+ summary: Bulk-delete pricestags:- - Products+ - Pricingsecurity:- api_key: []bearer_auth: []description: |-- Creates a new product. Supports nested variants with prices and option types.-- Option types and values are auto-created if they don't exist.- Prices are upserted by currency. Stock items are upserted by stock location.-+ Soft-deletes each price in `ids`. Returns the count actually destroyed.**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -14911,38 +14739,12 @@ paths:secretKey: 'sk_xxx',})- const product = await client.products.create({- name: 'Premium T-Shirt',- description: 'Soft, organic cotton.',- status: 'active',- variants: [- {- sku: 'TSHIRT-S-NAVY',- options: [- { name: 'size', value: 'Small' },- { name: 'color', value: 'navy' },- ],- prices: [- { currency: 'USD', amount: '29.99' },- { currency: 'EUR', amount: '27.99' },- ],- stock_items: [{ stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 50 }],- },- {- sku: 'TSHIRT-M-NAVY',- options: [- { name: 'size', value: 'Medium' },- { name: 'color', value: 'navy' },- ],- prices: [{ currency: 'USD', amount: '29.99' }],- stock_items: [{ stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 30 }],- },- ],- })+ const { price_count } = await client.prices.bulkDestroy({+ ids: ['price_xxx', 'price_yyy'],+ })- lang: bashlabel: Spree CLI- source: spree api post /products -d '{"name":"Premium T-Shirt","description":"Soft,- organic cotton.","status":"active","variants":[{"sku":"TSHIRT-S-NAVY","options":[{"name":"size","value":"Small"},{"name":"color","value":"navy"}],"prices":[{"currency":"USD","amount":"29.99"},{"currency":"EUR","amount":"27.99"}],"stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":50}]},{"sku":"TSHIRT-M-NAVY","options":[{"name":"size","value":"Medium"},{"name":"color","value":"navy"}],"prices":[{"currency":"USD","amount":"29.99"}],"stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":30}]}]}'+ source: spree api delete /prices/bulk_destroy -d '{"ids":["price_xxx","price_yyy"]}'parameters:- name: x-spree-api-keyin: header@@ -14952,187 +14754,42 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: stringresponses:- '201':- description: product created- content:- application/json:- example:- id: prod_gbHJdmfrXB- name: New Product- slug: new-product- meta_title:- meta_description:- meta_keywords:- variant_count: 0- available_on:- preorder_ships_at:- purchasable: false- preorder: false- in_stock: false- backorderable: false- available: false- description:- description_html:- default_variant_id: variant_gbHJdmfrXB- thumbnail_url:- tags: []- price:- original_price:- status: draft- metadata: {}- deleted_at:- created_at: '2026-07-27T20:01:27.491Z'- updated_at: '2026-07-27T20:01:27.492Z'- tax_category_id:- schema:- "$ref": "#/components/schemas/Product"- '422':- description: validation error+ '200':+ description: prices deletedcontent:application/json:example:- error:- code: validation_error- message: Name can't be blank- details:- name:- - can't be blank+ price_count: 1schema:- "$ref": "#/components/schemas/ErrorResponse"+ type: object+ properties:+ price_count:+ type: integerrequestBody:content:application/json:schema:type: object+ required:+ - idsproperties:- name:- type: string- example: Premium T-Shirt- 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:+ ids:type: arrayitems:type: string- example:- - eco- - sale- 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- example: USD- amount:- type: string- example: '29.99'- compare_at_amount:- type: string- nullable: true- example: '39.99'- 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- example: size- value:- type: string- example: Small- prices:- type: array- description: Per-currency prices. Upserted by currency.- items:- type: object- required:- - currency- - amount- properties:- currency:- type: string- example: USD- amount:- type: string- example: '29.99'- compare_at_amount:- type: string- nullable: true- example: '39.99'- 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- example: 50- backorderable:- type: boolean- required:- - name- "/api/v3/admin/products/{id}":+ "/api/v3/admin/products/{product_id}/custom_fields":get:- summary: Get a product+ summary: List product custom fieldstags:- Productssecurity:- api_key: []bearer_auth: []description: |-- Returns a single product by ID.+ Returns the product's custom field values.**Required scope:** `read_products` (for API-key authentication).x-codeSamples:@@ -15146,12 +14803,10 @@ paths:secretKey: 'sk_xxx',})- const product = await client.products.get('prod_86Rf07xd4z', {- expand: ['variants', 'option_types'],- })+ const { data: customFields } = await client.products.customFields.list('prod_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /products/{id} -d '{"expand":["variants","option_types"]}'+ source: spree api get /products/{product_id}/custom_fieldsparameters:- name: x-spree-api-keyin: header@@ -15161,124 +14816,83 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- - name: id+ - name: product_idin: pathrequired: true- description: Product ID (e.g., prod_xxx)schema:type: string- name: expandin: queryrequired: false- description: Comma-separated associations to expand (e.g., variants, media,- option_types, categories). Use dot notation for nested expand (max 4 levels).+ description: Comma-separated associations to expand (e.g., custom_field_definition).+ Use dot notation for nested expand (max 4 levels).schema:type: string- name: fieldsin: queryrequired: false- description: Comma-separated list of fields to include (e.g., name,slug,price,status).+ description: Comma-separated list of fields to include (e.g., key,value,namespace).id is always included.schema:type: stringresponses:'200':- description: product found- content:- application/json:- example:- id: prod_UkLWZg9DAJ- name: Product 663452- slug: product-663452- meta_title:- meta_description:- meta_keywords:- variant_count: 0- available_on:- preorder_ships_at:- purchasable: true- preorder: false- in_stock: false- backorderable: true- available: true- description: Atque ipsa modi velit similique est cum nostrum. Fugit- expedita in laboriosam nemo id quasi itaque cupiditate. A reiciendis- impedit unde quisquam omnis explicabo exercitationem modi. Adipisci- atque consequatur quas quae eaque. Est et cupiditate nihil dolor- alias porro aut. Blanditiis nulla minima saepe iste. Ad natus neque- eligendi itaque quae. Iure dignissimos perspiciatis voluptatem incidunt- neque.- description_html: |-- Atque ipsa modi velit similique est cum nostrum. Fugit expedita in laboriosam nemo id quasi itaque cupiditate. A reiciendis impedit unde quisquam omnis explicabo exercitationem modi. Adipisci atque consequatur quas quae eaque. Est et cupiditate nihil dolor alias porro aut.- Blanditiis nulla minima saepe iste. Ad natus neque eligendi itaque quae. Iure dignissimos perspiciatis voluptatem incidunt neque.- default_variant_id: variant_UkLWZg9DAJ- thumbnail_url:- tags: []- price:- id: price_UkLWZg9DAJ- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- variant_id: variant_UkLWZg9DAJ- created_at: '2026-07-27T20:01:27.863Z'- updated_at: '2026-07-27T20:01:27.863Z'- original_price:- status: active- metadata: {}- deleted_at:- created_at: '2026-07-27T20:01:27.855Z'- updated_at: '2026-07-27T20:01:27.869Z'- tax_category_id: taxcat_UkLWZg9DAJ- schema:- "$ref": "#/components/schemas/Product"- '404':- description: product not found+ description: custom fields foundcontent:application/json:example:- error:- code: record_not_found- message: Product not found- 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.-- **Required scope:** `write_products` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',+ data:+ - id: cf_UkLWZg9DAJ+ label: Title+ type: Spree::Metafields::ShortText+ field_type: short_text+ key: custom.title+ value: wool+ created_at: '2026-07-29T08:38:27.864Z'+ updated_at: '2026-07-29T08:38:27.864Z'+ storefront_visible: true+ custom_field_definition_id: cfdef_UkLWZg9DAJ+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ 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.++ **Required scope:** `write_products` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',secretKey: 'sk_xxx',})- const product = await client.products.update('prod_86Rf07xd4z', {- name: 'Updated Name',- status: 'active',- tags: ['eco', 'sale'],+ const customField = await client.products.customFields.create('prod_UkLWZg9DAJ', {+ custom_field_definition_id: 'cfdef_AbC123XyZ',+ value: 'wool',})- lang: bashlabel: Spree CLI- source: spree api patch /products/{id} -d '{"name":"Updated Name","status":"active","tags":["eco","sale"]}'+ source: spree api post /products/{product_id}/custom_fields -d '{"custom_field_definition_id":"cfdef_AbC123XyZ","value":"wool"}'parameters:- name: x-spree-api-keyin: header@@ -15288,216 +14902,63 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- - name: id+ - name: product_idin: pathrequired: true- description: Product IDschema:type: stringresponses:- '200':- description: product updated+ '201':+ description: custom field createdcontent:application/json:example:- id: prod_UkLWZg9DAJ- name: Updated Name- slug: product-683541- meta_title:- meta_description:- meta_keywords:- variant_count: 0- available_on:- preorder_ships_at:- purchasable: true- preorder: false- in_stock: false- backorderable: true- available: true- description: Adipisci ratione accusamus vitae consequatur sint accusantium- quod at. Enim cumque earum quibusdam saepe itaque. Natus similique- illo numquam maxime mollitia magnam dolor dolorem. Illum minus adipisci- facere magni minima. Debitis sint quaerat reprehenderit fugiat perspiciatis- magni. Officia nisi sint magni cumque quam illum. Consectetur velit- recusandae pariatur consequatur officiis neque. Similique cumque- non officiis maiores. Illum minus molestias alias nemo ad sapiente- neque. At pariatur assumenda nihil voluptates saepe accusantium- dolorum. Dignissimos officiis iste inventore a repellendus accusamus.- Dolor itaque et nesciunt optio tenetur laborum.- description_html: |-- Adipisci ratione accusamus vitae consequatur sint accusantium quod at. Enim cumque earum quibusdam saepe itaque. Natus similique illo numquam maxime mollitia magnam dolor dolorem. Illum minus adipisci facere magni minima. Debitis sint quaerat reprehenderit fugiat perspiciatis magni.- Officia nisi sint magni cumque quam illum. Consectetur velit recusandae pariatur consequatur officiis neque. Similique cumque non officiis maiores.- Illum minus molestias alias nemo ad sapiente neque. At pariatur assumenda nihil voluptates saepe accusantium dolorum. Dignissimos officiis iste inventore a repellendus accusamus. Dolor itaque et nesciunt optio tenetur laborum.- default_variant_id: variant_UkLWZg9DAJ- thumbnail_url:- tags: []- price:- id: price_UkLWZg9DAJ- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- variant_id: variant_UkLWZg9DAJ- created_at: '2026-07-27T20:01:28.495Z'- updated_at: '2026-07-27T20:01:28.495Z'- original_price:- status: active- metadata: {}- deleted_at:- created_at: '2026-07-27T20:01:28.485Z'- updated_at: '2026-07-27T20:01:28.786Z'- tax_category_id: taxcat_UkLWZg9DAJ- schema:- "$ref": "#/components/schemas/Product"+ id: cf_gbHJdmfrXB+ label: Description+ type: Spree::Metafields::LongText+ field_type: long_text+ key: custom.description+ value: A longer description+ created_at: '2026-07-29T08:38:28.459Z'+ updated_at: '2026-07-29T08:38:28.459Z'+ storefront_visible: true+ custom_field_definition_id: cfdef_gbHJdmfrXB'422':- description: validation error+ description: duplicate definition for the same productcontent:application/json:example:error:code: validation_error- message: Name can't be blank+ message: Metafield definition has already been takendetails:- name:- - can't be blank- schema:- "$ref": "#/components/schemas/ErrorResponse"+ metafield_definition_id:+ - has already been takenrequestBody:content:application/json:schema:type: object+ required:+ - custom_field_definition_id+ - valueproperties:- name:- type: string- example: Premium T-Shirt- description:- type: string- slug:- type: string- status:- type: string- enum:- - draft- - active- - archived- tax_category_id:+ custom_field_definition_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- example:- - eco- - sale- 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- example: USD- amount:- type: string- example: '29.99'- compare_at_amount:- type: string- nullable: true- example: '39.99'- 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- example: size- value:- type: string- example: Small- prices:- type: array- description: Per-currency prices. Upserted by currency.- items:- type: object- required:- - currency- - amount- properties:- currency:- type: string- example: USD- amount:- type: string- example: '29.99'- compare_at_amount:- type: string- nullable: true- example: '39.99'- 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- example: 50- backorderable:- type: boolean- delete:- summary: Delete a product+ 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 fieldtags:- Productssecurity:- api_key: []bearer_auth: []- description: |-- Soft-deletes a product.-- **Required scope:** `write_products` (for API-key authentication).+ description: "**Required scope:** `read_products` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -15509,10 +14970,10 @@ paths:secretKey: 'sk_xxx',})- await client.products.delete('prod_86Rf07xd4z')+ const customField = await client.products.customFields.get('prod_UkLWZg9DAJ', 'cf_AbC123XyZ')- lang: bashlabel: Spree CLI- source: spree api delete /products/{id}+ source: spree api get /products/{product_id}/custom_fields/{id}parameters:- name: x-spree-api-keyin: header@@ -15522,30 +14983,57 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authentication+ schema:+ type: string+ - name: product_id+ in: path+ required: trueschema:type: string- name: idin: pathrequired: true- description: Product IDschema:type: string- responses:- '204':- description: product deleted- "/api/v3/admin/products/bulk_status_update":- post:- summary: Bulk-update product status- tags:- - Products- security:+ - 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:+ example:+ id: cf_UkLWZg9DAJ+ label: Title+ type: Spree::Metafields::ShortText+ field_type: short_text+ key: custom.title+ value: wool+ created_at: '2026-07-29T08:38:28.812Z'+ updated_at: '2026-07-29T08:38:28.812Z'+ storefront_visible: true+ custom_field_definition_id: cfdef_UkLWZg9DAJ+ patch:+ summary: Update a product custom field+ tags:+ - Products+ security:- api_key: []bearer_auth: []description: |-- Sets `status` on each product in `ids`. Reindexes the affected products- for search. Cross-store IDs are silently dropped. Returns counts.-+ Updates the custom field's `value`. The linked definition cannot be changed — delete and recreate to switch.**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -15559,13 +15047,12 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkStatusUpdate({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- status: 'archived',+ const customField = await client.products.customFields.update('prod_UkLWZg9DAJ', 'cf_AbC123XyZ', {+ value: 'cotton',})- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_status_update -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"status":"archived"}'+ source: spree api patch /products/{product_id}/custom_fields/{id} -d '{"value":"cotton"}'parameters:- name: x-spree-api-keyin: header@@ -15577,67 +15064,50 @@ paths:required: trueschema:type: string+ - name: product_id+ in: path+ required: true+ schema:+ type: string+ - name: id+ in: path+ required: true+ schema:+ type: stringresponses:'200':- description: cross-store products silently dropped- content:- application/json:- example:- product_count: 0- status: archived- schema:- type: object- properties:- product_count:- type: integer- status:- type: string- '422':- description: invalid status+ description: custom field updatedcontent:application/json:example:- error:- code: invalid_status- message: Invalid status- schema:- "$ref": "#/components/schemas/ErrorResponse"+ id: cf_UkLWZg9DAJ+ label: Title+ type: Spree::Metafields::ShortText+ field_type: short_text+ key: custom.title+ value: cotton+ created_at: '2026-07-29T08:38:29.135Z'+ updated_at: '2026-07-29T08:38:29.413Z'+ storefront_visible: true+ custom_field_definition_id: cfdef_UkLWZg9DAJrequestBody:content:application/json:schema:type: objectrequired:- - ids- - status+ - valueproperties:- ids:- type: array- items:- type: string- example:- - prod_UkLWZg9DAJ- status:- type: string- enum:- - draft- - active- - archived- example: archived- "/api/v3/admin/products/bulk_add_to_categories":- post:- summary: Bulk-add products to categories+ value:+ description: New value+ delete:+ summary: Delete a product custom fieldtags:- Productssecurity:- api_key: []bearer_auth: []- description: |-- Attaches each product in `ids` to every category (taxon) in `category_ids`.- Categories from sibling stores are silently ignored.--- **Required scope:** `write_products` (for API-key authentication).+ description: "**Required scope:** `write_products` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -15649,13 +15119,46 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkAddToCategories({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- category_ids: ['cat_AbC123XyZ'],- })+ await client.products.customFields.delete('prod_UkLWZg9DAJ', 'cf_AbC123XyZ')- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_add_to_categories -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"category_ids":["cat_AbC123XyZ"]}'+ source: spree api delete /products/{product_id}/custom_fields/{id}+ 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/{product_id}/translations":+ get:+ summary: List product translations+ tags:+ - Products+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Returns the full translation matrix for the product: the source value and content type per translatable field, plus the translated value for every supported locale.++ **Required scope:** `read_products` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -15667,50 +15170,71 @@ paths:required: trueschema:type: string+ - name: product_id+ in: path+ required: true+ schema:+ type: stringresponses:'200':- description: products added to categories+ description: translations foundcontent:application/json:example:- product_count: 1- category_count: 1- 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:+ data:+ resource_id: prod_UkLWZg9DAJ+ resource_type: product+ translations:+ de:+ name: Espressomaschine+ description:+ slug: espressomaschine+ meta_description:+ meta_title:+ translated_field_count: 2+ fr:+ name:+ description:+ slug:+ meta_description:+ meta_title:+ translated_field_count: 0+ fields:+ - key: nametype: string- category_ids:- type: array- items:+ source: Espresso Machine+ - key: description+ type: html+ source: |-+ Rerum sunt occaecati ipsum praesentium temporibus consequuntur quaerat nulla. Quaerat repudiandae tempora assumenda explicabo asperiores modi dolores itaque. Fuga cupiditate optio quo expedita nesciunt. Rem quos aliquid ducimus in doloremque. Voluptates corrupti itaque expedita adipisci.+ Atque quasi explicabo molestiae veritatis dolorum. Eaque neque temporibus iure non. Modi non architecto recusandae eum sapiente. Nesciunt neque repellat non officia a.+ Laborum dolore odio iusto illum deleniti. Provident possimus neque quae at dolores tenetur. Porro laborum quos labore sapiente ullam iusto.+ - key: slugtype: string- "/api/v3/admin/products/bulk_remove_from_categories":- post:- summary: Bulk-remove products from categories+ source: espresso-machine+ - key: meta_description+ type: string+ source:+ - key: meta_title+ type: string+ source:+ default_locale: en+ supported_locales:+ - de+ - en+ - fr+ "/api/v3/admin/products":+ get:+ summary: List productstags:- Productssecurity:- api_key: []bearer_auth: []description: |-- Detaches each product in `ids` from every category in `category_ids`.+ Returns a paginated list of products for the current store.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `read_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -15722,13 +15246,15 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkRemoveFromCategories({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- category_ids: ['cat_AbC123XyZ'],+ const { data: products } = await client.products.list({+ name_cont: 'shirt',+ status_eq: 'active',+ sort: '-created_at',+ limit: 25,})- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_remove_from_categories -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"category_ids":["cat_AbC123XyZ"]}'+ source: spree api get /products -d '{"name_cont":"shirt","status_eq":"active","sort":"-created_at","limit":25}'parameters:- name: x-spree-api-keyin: header@@ -15738,45 +15264,146 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: string- responses:- '200':- description: products removed from categories- content:- application/json:- example:- product_count: 1- category_count: 1- 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":+ - 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:+ example:+ data:+ - id: prod_UkLWZg9DAJ+ name: Product 713809+ slug: product-713809+ meta_title:+ meta_description:+ meta_keywords:+ variant_count: 1+ available_on:+ preorder_ships_at:+ purchasable: true+ preorder: false+ in_stock: false+ backorderable: true+ available: true+ description: Quasi explicabo delectus exercitationem vel et. In+ illo soluta nemo accusantium quia. Unde sapiente esse id est sit.+ description_html: Quasi explicabo delectus exercitationem vel et.+ In illo soluta nemo accusantium quia. Unde sapiente esse id est+ sit.+ default_variant_id: variant_UkLWZg9DAJ+ thumbnail_url:+ tags: []+ price:+ id: price_UkLWZg9DAJ+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:30.078Z'+ updated_at: '2026-07-29T08:38:30.078Z'+ original_price:+ status: active+ metadata: {}+ deleted_at:+ created_at: '2026-07-29T08:38:30.069Z'+ updated_at: '2026-07-29T08:38:30.083Z'+ tax_category_id: taxcat_UkLWZg9DAJ+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ 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:+ example:+ error:+ code: authentication_required+ message: Authentication required+ schema:+ "$ref": "#/components/schemas/ErrorResponse"post:- summary: Bulk-add products to channels+ summary: Create a producttags:- Productssecurity:- api_key: []bearer_auth: []description: |-- Publishes each product in `ids` on every channel in `channel_ids`. Idempotent —- re-publishing on an existing channel is a no-op. Channels from sibling stores- are silently ignored.+ Creates a new product. Supports nested variants with prices and option types.++ Option types and values are auto-created if they don't exist.+ Prices are upserted by currency. Stock items are upserted by stock location.**Required scope:** `write_products` (for API-key authentication).@@ -15791,13 +15418,38 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkAddToChannels({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- channel_ids: ['channel_AbC123XyZ'],+ const product = await client.products.create({+ name: 'Premium T-Shirt',+ description: 'Soft, organic cotton.',+ status: 'active',+ variants: [+ {+ sku: 'TSHIRT-S-NAVY',+ options: [+ { name: 'size', value: 'Small' },+ { name: 'color', value: 'navy' },+ ],+ prices: [+ { currency: 'USD', amount: '29.99' },+ { currency: 'EUR', amount: '27.99' },+ ],+ stock_items: [{ stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 50 }],+ },+ {+ sku: 'TSHIRT-M-NAVY',+ options: [+ { name: 'size', value: 'Medium' },+ { name: 'color', value: 'navy' },+ ],+ prices: [{ currency: 'USD', amount: '29.99' }],+ stock_items: [{ stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 30 }],+ },+ ],})- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_add_to_channels -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"channel_ids":["channel_AbC123XyZ"]}'+ source: spree api post /products -d '{"name":"Premium T-Shirt","description":"Soft,+ organic cotton.","status":"active","variants":[{"sku":"TSHIRT-S-NAVY","options":[{"name":"size","value":"Small"},{"name":"color","value":"navy"}],"prices":[{"currency":"USD","amount":"29.99"},{"currency":"EUR","amount":"27.99"}],"stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":50}]},{"sku":"TSHIRT-M-NAVY","options":[{"name":"size","value":"Medium"},{"name":"color","value":"navy"}],"prices":[{"currency":"USD","amount":"29.99"}],"stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":30}]}]}'parameters:- name: x-spree-api-keyin: header@@ -15807,52 +15459,189 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: stringresponses:- '200':- description: products published on channels+ '201':+ description: product createdcontent:application/json:example:- product_count: 1- channel_count: 1+ id: prod_gbHJdmfrXB+ name: New Product+ slug: new-product+ meta_title:+ meta_description:+ meta_keywords:+ variant_count: 0+ available_on:+ preorder_ships_at:+ purchasable: false+ preorder: false+ in_stock: false+ backorderable: false+ available: false+ description:+ description_html:+ default_variant_id: variant_gbHJdmfrXB+ thumbnail_url:+ tags: []+ price:+ original_price:+ status: draft+ metadata: {}+ deleted_at:+ created_at: '2026-07-29T08:38:30.740Z'+ updated_at: '2026-07-29T08:38:30.744Z'+ tax_category_id:schema:- type: object- properties:- product_count:- type: integer- channel_count:- type: integer+ "$ref": "#/components/schemas/Product"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:schema:type: object- required:- - ids- - channel_idsproperties:- ids:+ name:+ type: string+ example: Premium T-Shirt+ 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: arrayitems:type: string- channel_ids:+ description: Array of category IDs+ tags:type: arrayitems: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`.+ example:+ - eco+ - sale+ 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+ example: USD+ amount:+ type: string+ example: '29.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '39.99'+ 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+ example: size+ value:+ type: string+ example: Small+ prices:+ type: array+ description: Per-currency prices. Upserted by currency.+ items:+ type: object+ required:+ - currency+ - amount+ properties:+ currency:+ type: string+ example: USD+ amount:+ type: string+ example: '29.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '39.99'+ 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+ example: 50+ 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.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `read_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -15864,13 +15653,12 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkRemoveFromChannels({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- channel_ids: ['channel_AbC123XyZ'],+ const product = await client.products.get('prod_86Rf07xd4z', {+ expand: ['variants', 'option_types'],})- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_remove_from_channels -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"channel_ids":["channel_AbC123XyZ"]}'+ source: spree api get /products/{id} -d '{"expand":["variants","option_types"]}'parameters:- name: x-spree-api-keyin: header@@ -15880,53 +15668,102 @@ paths:- name: Authorizationin: headerrequired: 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: stringresponses:'200':- description: products unpublished from channels+ description: product foundcontent:application/json:example:- product_count: 1- channel_count: 1- removed: 1+ id: prod_UkLWZg9DAJ+ name: Product 757547+ slug: product-757547+ meta_title:+ meta_description:+ meta_keywords:+ variant_count: 1+ available_on:+ preorder_ships_at:+ purchasable: true+ preorder: false+ in_stock: false+ backorderable: true+ available: true+ description: Suscipit iste saepe magnam nobis. Magnam id quis corporis+ consectetur eaque. Corrupti vel distinctio dolore commodi nulla+ explicabo ullam. Officia possimus tempore ea eveniet unde. Quod+ quas perspiciatis sint facere. Officia rerum exercitationem laudantium+ asperiores totam unde quod quam. Et molestias harum doloribus eligendi+ dolorem.+ description_html: |-+ Suscipit iste saepe magnam nobis. Magnam id quis corporis consectetur eaque. Corrupti vel distinctio dolore commodi nulla explicabo ullam. Officia possimus tempore ea eveniet unde.+ Quod quas perspiciatis sint facere. Officia rerum exercitationem laudantium asperiores totam unde quod quam. Et molestias harum doloribus eligendi dolorem.+ default_variant_id: variant_UkLWZg9DAJ+ thumbnail_url:+ tags: []+ price:+ id: price_UkLWZg9DAJ+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:31.103Z'+ updated_at: '2026-07-29T08:38:31.103Z'+ original_price:+ status: active+ metadata: {}+ deleted_at:+ created_at: '2026-07-29T08:38:31.091Z'+ updated_at: '2026-07-29T08:38:31.109Z'+ tax_category_id: taxcat_UkLWZg9DAJschema:- 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+ "$ref": "#/components/schemas/Product"+ '404':+ description: product not found+ content:+ application/json:+ example:+ error:+ code: record_not_found+ message: Product not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update a producttags:- Productssecurity:- api_key: []bearer_auth: []description: |-- Adds each tag name in `tags` to every product in `ids`. Tags are upserted by name.+ Updates a product. Only provided fields are updated.**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -15940,13 +15777,14 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkAddTags({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- tags: ['summer', 'sale'],+ const product = await client.products.update('prod_86Rf07xd4z', {+ name: 'Updated Name',+ status: 'active',+ tags: ['eco', 'sale'],})- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_add_tags -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"tags":["summer","sale"]}'+ source: spree api patch /products/{id} -d '{"name":"Updated Name","status":"active","tags":["eco","sale"]}'parameters:- name: x-spree-api-keyin: header@@ -15956,53 +15794,223 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authentication+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Product IDschema:type: stringresponses:'200':- description: tags added+ description: product updatedcontent:application/json:example:- product_count: 1- tag_count: 2- 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- example:- - summer- - sale- "/api/v3/admin/products/bulk_remove_tags":- post:- summary: Bulk-remove tags from products+ id: prod_UkLWZg9DAJ+ name: Updated Name+ slug: product-777123+ meta_title:+ meta_description:+ meta_keywords:+ variant_count: 1+ available_on:+ preorder_ships_at:+ purchasable: true+ preorder: false+ in_stock: false+ backorderable: true+ available: true+ description: Officia illo deserunt non exercitationem dolores eius+ eos. Ea perspiciatis ipsum numquam similique. Non deserunt minus+ ipsum possimus iusto veritatis dolor. Hic voluptates quidem molestias+ fugiat. A illo explicabo molestias velit ducimus itaque blanditiis.+ Eos ab id inventore consectetur rem quod cupiditate placeat. Saepe+ commodi explicabo ut dolore aperiam tempora optio itaque. Ad iste+ asperiores culpa officia excepturi molestiae. Accusamus culpa beatae+ architecto quos sunt voluptatum minus similique. Ducimus doloremque+ saepe optio deleniti. Quaerat consequuntur itaque fugit blanditiis+ sint placeat. Quos dicta omnis officiis architecto vitae sunt illum+ fuga. Fugit vero facere eos error. Rerum consectetur fugiat possimus+ consequuntur eaque sint ratione. Quam vel eos ipsam nulla repudiandae+ enim. Hic delectus doloremque nostrum incidunt voluptatem possimus.+ Nemo officiis beatae quo ea ullam architecto aliquam quam. Nisi+ veritatis quam fugiat adipisci. Inventore similique eius maiores+ ad nulla sint id perferendis. Laborum ut quidem id blanditiis vel+ ea suscipit ducimus. Autem magnam illo quia nisi fuga aspernatur.+ description_html: |-+ Officia illo deserunt non exercitationem dolores eius eos. Ea perspiciatis ipsum numquam similique. Non deserunt minus ipsum possimus iusto veritatis dolor.+ Hic voluptates quidem molestias fugiat. A illo explicabo molestias velit ducimus itaque blanditiis. Eos ab id inventore consectetur rem quod cupiditate placeat. Saepe commodi explicabo ut dolore aperiam tempora optio itaque. Ad iste asperiores culpa officia excepturi molestiae.+ Accusamus culpa beatae architecto quos sunt voluptatum minus similique. Ducimus doloremque saepe optio deleniti. Quaerat consequuntur itaque fugit blanditiis sint placeat. Quos dicta omnis officiis architecto vitae sunt illum fuga. Fugit vero facere eos error.+ Rerum consectetur fugiat possimus consequuntur eaque sint ratione. Quam vel eos ipsam nulla repudiandae enim. Hic delectus doloremque nostrum incidunt voluptatem possimus.+ Nemo officiis beatae quo ea ullam architecto aliquam quam. Nisi veritatis quam fugiat adipisci. Inventore similique eius maiores ad nulla sint id perferendis. Laborum ut quidem id blanditiis vel ea suscipit ducimus. Autem magnam illo quia nisi fuga aspernatur.+ default_variant_id: variant_UkLWZg9DAJ+ thumbnail_url:+ tags: []+ price:+ id: price_UkLWZg9DAJ+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:31.738Z'+ updated_at: '2026-07-29T08:38:31.738Z'+ original_price:+ status: active+ metadata: {}+ deleted_at:+ created_at: '2026-07-29T08:38:31.729Z'+ updated_at: '2026-07-29T08:38:32.020Z'+ tax_category_id: taxcat_UkLWZg9DAJ+ schema:+ "$ref": "#/components/schemas/Product"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ name:+ type: string+ example: Premium T-Shirt+ 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+ example:+ - eco+ - sale+ 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+ example: USD+ amount:+ type: string+ example: '29.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '39.99'+ 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+ example: size+ value:+ type: string+ example: Small+ prices:+ type: array+ description: Per-currency prices. Upserted by currency.+ items:+ type: object+ required:+ - currency+ - amount+ properties:+ currency:+ type: string+ example: USD+ amount:+ type: string+ example: '29.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '39.99'+ 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+ example: 50+ backorderable:+ type: boolean+ delete:+ summary: Delete a producttags:- Productssecurity:- api_key: []bearer_auth: []description: |-- Removes each tag in `tags` from every product in `ids`.+ Soft-deletes a product.**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -16016,13 +16024,10 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkRemoveTags({- ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],- tags: ['summer'],- })+ await client.products.delete('prod_86Rf07xd4z')- lang: bashlabel: Spree CLI- source: spree api post /products/bulk_remove_tags -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"tags":["summer"]}'+ source: spree api delete /products/{id}parameters:- name: x-spree-api-keyin: header@@ -16032,43 +16037,30 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authentication+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Product IDschema:type: stringresponses:- '200':- description: tags removed- content:- application/json:- example:- product_count: 1- tag_count: 1- 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+ '204':+ description: product deleted+ "/api/v3/admin/products/bulk_status_update":+ post:+ summary: Bulk-update product statustags:- Productssecurity:- api_key: []bearer_auth: []description: |-- Soft-deletes each product in `ids`. Returns the count actually destroyed.+ Sets `status` on each product in `ids`. Reindexes the affected products+ for search. Cross-store IDs are silently dropped. Returns counts.+**Required scope:** `write_products` (for API-key authentication).x-codeSamples:@@ -16082,12 +16074,13 @@ paths:secretKey: 'sk_xxx',})- const result = await client.products.bulkDestroy({+ const result = await client.products.bulkStatusUpdate({ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ status: 'archived',})- lang: bashlabel: Spree CLI- source: spree api delete /products/bulk_destroy -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"]}'+ source: spree api post /products/bulk_status_update -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"status":"archived"}'parameters:- name: x-spree-api-keyin: header@@ -16101,16 +16094,29 @@ paths:type: stringresponses:'200':- description: products deleted+ description: cross-store products silently droppedcontent:application/json:example:- product_count: 1+ product_count: 0+ status: archivedschema:type: objectproperties:product_count:type: integer+ status:+ type: string+ '422':+ description: invalid status+ content:+ application/json:+ example:+ error:+ code: invalid_status+ message: Invalid status+ schema:+ "$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:@@ -16118,29 +16124,35 @@ paths:type: objectrequired:- ids+ - statusproperties:ids:type: arrayitems: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:+ example:+ - prod_UkLWZg9DAJ+ status:+ type: string+ enum:+ - draft+ - active+ - archived+ example: archived+ "/api/v3/admin/products/bulk_add_to_categories":+ post:+ summary: Bulk-add products to categories+ tags:+ - Products+ 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.+ Attaches each product in `ids` to every category (taxon) in `category_ids`.+ Categories from sibling stores are silently ignored.- **Required scope:** `read_promotions` (for API-key authentication).++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16152,10 +16164,13 @@ paths:secretKey: 'sk_xxx',})- const { data: coupons } = await client.promotions.couponCodes.list('promo_UkLWZg9DAJ')+ const result = await client.products.bulkAddToCategories({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ category_ids: ['cat_AbC123XyZ'],+ })- lang: bashlabel: Spree CLI- source: spree api get /promotions/{promotion_id}/coupon_codes+ source: spree api post /products/bulk_add_to_categories -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"category_ids":["cat_AbC123XyZ"]}'parameters:- name: x-spree-api-keyin: header@@ -16169,50 +16184,48 @@ paths:type: stringresponses:'200':- description: coupon codes found+ description: products added to categoriescontent:application/json:example:- data:- - id: coupon_UkLWZg9DAJ- code: AAA111- state: unused- created_at: '2026-07-27T20:00:12.052Z'- updated_at: '2026-07-27T20:00:12.052Z'- promotion_id: promo_UkLWZg9DAJ- order_id:- - id: coupon_gbHJdmfrXB- code: BBB222- state: unused- created_at: '2026-07-27T20:00:12.053Z'- updated_at: '2026-07-27T20:00:12.053Z'- promotion_id: promo_UkLWZg9DAJ- order_id:- meta:- page: 1- limit: 25- count: 2- pages: 1- from: 1- to: 2- in: 2- previous:- next:- "/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+ product_count: 1+ category_count: 1+ 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 categoriestags:- - Promotions+ - Productssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `read_promotions` (for API-key authentication)."+ description: |-+ Detaches each product in `ids` from every category in `category_ids`.++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16224,10 +16237,13 @@ paths:secretKey: 'sk_xxx',})- const { data: actions } = await client.promotions.actions.list('promo_UkLWZg9DAJ')+ const result = await client.products.bulkRemoveFromCategories({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ category_ids: ['cat_AbC123XyZ'],+ })- lang: bashlabel: Spree CLI- source: spree api get /promotions/{promotion_id}/promotion_actions+ source: spree api post /products/bulk_remove_from_categories -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"category_ids":["cat_AbC123XyZ"]}'parameters:- name: x-spree-api-keyin: header@@ -16241,59 +16257,43 @@ paths:type: stringresponses:'200':- description: actions found+ description: products removed from categoriescontent:application/json:example:- data:- - id: pact_UkLWZg9DAJ- created_at: '2026-07-27T20:01:32.814Z'- updated_at: '2026-07-27T20:01:32.814Z'- type: free_shipping- promotion_id: promo_UkLWZg9DAJ- preferences: {}- preference_schema: []- label: Free shipping- calculator:- line_items:- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:+ product_count: 1+ category_count: 1+ 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_collections":post:- summary: Create an action on a promotion+ summary: Bulk-add products to collectionstags:- - Promotions+ - Productssecurity:- 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.-- **Required scope:** `write_promotions` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'+ Attaches each product in `ids` to every manual collection in `collection_ids`.+ Automatic (rule-based) and sibling-store collections are silently ignored.- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })- const action = await client.promotions.actions.create('promo_UkLWZg9DAJ', {- type: 'free_shipping',- })- - lang: bash- label: Spree CLI- source: spree api post /promotions/{promotion_id}/promotion_actions -d '{"type":"free_shipping"}'+ **Required scope:** `write_products` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -16306,78 +16306,49 @@ paths:schema:type: stringresponses:- '201':- description: action created- content:- application/json:- example:- id: pact_UkLWZg9DAJ- created_at: '2026-07-27T20:01:33.424Z'- updated_at: '2026-07-27T20:01:33.424Z'- type: free_shipping- promotion_id: promo_UkLWZg9DAJ- preferences: {}- preference_schema: []- label: Free shipping- calculator:- line_items:- '422':- description: unknown action type+ '200':+ description: products added to collectionscontent:application/json:example:- error:- code: unknown_promotion_action_type- message: Unknown type+ product_count: 1+ collection_count: 1+ schema:+ type: object+ properties:+ product_count:+ type: integer+ collection_count:+ type: integerrequestBody:content:application/json:schema:type: object- properties:- type:- type: string- example: free_shipping- preferences:- type: object- additionalProperties: truerequired:- - 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+ - ids+ - collection_ids+ properties:+ ids:+ type: array+ items:+ type: string+ collection_ids:+ type: array+ items:+ type: string+ "/api/v3/admin/products/bulk_remove_from_collections":+ post:+ summary: Bulk-remove products from collectionstags:- - Promotions+ - Productssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_promotions` (for API-key authentication)."- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })+ description: |-+ Detaches each product in `ids` from every collection in `collection_ids`.- await client.promotions.actions.delete('promo_UkLWZg9DAJ', 'promoact_k5nR8xLq')- - lang: bash- label: Spree CLI- source: spree api delete /promotions/{promotion_id}/promotion_actions/{id}+ **Required scope:** `write_products` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -16390,23 +16361,45 @@ paths:schema:type: stringresponses:- '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:+ '200':+ description: products removed from collections+ content:+ application/json:+ example:+ product_count: 1+ collection_count: 1+ requestBody:+ content:+ application/json:+ schema:+ type: object+ required:+ - ids+ - collection_ids+ properties:+ ids:+ type: array+ items:+ type: string+ collection_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: "**Required scope:** `read_promotions` (for API-key authentication)."+ description: |-+ Publishes each product in `ids` on every channel in `channel_ids`. Idempotent —+ re-publishing on an existing channel is a no-op. Channels from sibling stores+ are silently ignored.+++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16418,10 +16411,13 @@ paths:secretKey: 'sk_xxx',})- const { data: rules } = await client.promotions.rules.list('promo_UkLWZg9DAJ')+ const result = await client.products.bulkAddToChannels({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ channel_ids: ['channel_AbC123XyZ'],+ })- lang: bashlabel: Spree CLI- source: spree api get /promotions/{promotion_id}/promotion_rules+ source: spree api post /products/bulk_add_to_channels -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"channel_ids":["channel_AbC123XyZ"]}'parameters:- name: x-spree-api-keyin: header@@ -16435,47 +16431,48 @@ paths:type: stringresponses:'200':- description: rules found+ description: products published on channelscontent:application/json:example:- data:- - id: prorule_UkLWZg9DAJ- created_at: '2026-07-27T20:01:34.013Z'- updated_at: '2026-07-27T20:01:34.013Z'- type: currency- promotion_id: promo_UkLWZg9DAJ- preferences:- currency: USD- preference_schema:- - key: currency+ product_count: 1+ channel_count: 1+ 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- default:- label: Currency- product_ids:- category_ids:- customer_ids:- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:+ channel_ids:+ type: array+ items:+ type: string+ "/api/v3/admin/products/bulk_remove_from_channels":post:- summary: Create a rule on a promotion+ summary: Bulk-remove products from channelstags:- - Promotions+ - Productssecurity:- 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.+ Unpublishes each product in `ids` from every channel in `channel_ids`.- **Required scope:** `write_promotions` (for API-key authentication).+ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16487,13 +16484,13 @@ paths:secretKey: 'sk_xxx',})- const rule = await client.promotions.rules.create('promo_UkLWZg9DAJ', {- type: 'currency',- preferences: { currency: 'EUR' },+ const result = await client.products.bulkRemoveFromChannels({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ channel_ids: ['channel_AbC123XyZ'],})- lang: bashlabel: Spree CLI- source: spree api post /promotions/{promotion_id}/promotion_rules -d '{"type":"currency","preferences":{"currency":"EUR"}}'+ source: spree api post /products/bulk_remove_from_channels -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"channel_ids":["channel_AbC123XyZ"]}'parameters:- name: x-spree-api-keyin: header@@ -16506,68 +16503,52 @@ paths:schema:type: stringresponses:- '201':- description: rule created with preferences- content:- application/json:- example:- id: prorule_UkLWZg9DAJ- created_at: '2026-07-27T20:01:34.570Z'- updated_at: '2026-07-27T20:01:34.570Z'- type: currency- promotion_id: promo_UkLWZg9DAJ- preferences:- currency: EUR- preference_schema:- - key: currency- type: string- default:- label: Currency- product_ids:- category_ids:- customer_ids:- '422':- description: unknown rule type+ '200':+ description: products unpublished from channelscontent:application/json:example:- error:- code: unknown_promotion_rule_type- message: Unknown type+ product_count: 1+ channel_count: 1+ removed: 1+ schema:+ type: object+ properties:+ product_count:+ type: integer+ channel_count:+ type: integer+ removed:+ type: integerrequestBody:content:application/json:schema:type: object- properties:- type:- type: string- example: currency- preferences:- type: object- additionalProperties: truerequired:- - 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+ - 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 productstags:- - Promotions+ - Productssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_promotions` (for API-key authentication)."+ description: |-+ Adds each tag name in `tags` to every product in `ids`. Tags are upserted by name.++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16579,13 +16560,13 @@ paths:secretKey: 'sk_xxx',})- const rule = await client.promotions.rules.update('promo_UkLWZg9DAJ', 'promorule_k5nR8xLq', {- preferences: { currency: 'USD' },+ const result = await client.products.bulkAddTags({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ tags: ['summer', 'sale'],})- lang: bashlabel: Spree CLI- source: spree api patch /promotions/{promotion_id}/promotion_rules/{id} -d- '{"preferences":{"currency":"USD"}}'+ source: spree api post /products/bulk_add_tags -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"tags":["summer","sale"]}'parameters:- name: x-spree-api-keyin: header@@ -16599,42 +16580,51 @@ paths:type: stringresponses:'200':- description: rule updated+ description: tags addedcontent:application/json:example:- id: prorule_UkLWZg9DAJ- created_at: '2026-07-27T20:01:34.856Z'- updated_at: '2026-07-27T20:01:35.136Z'- type: currency- promotion_id: promo_UkLWZg9DAJ- preferences:- currency: GBP- preference_schema:- - key: currency- type: string- default:- label: Currency- product_ids:- category_ids:- customer_ids:+ product_count: 1+ tag_count: 2+ schema:+ type: object+ properties:+ product_count:+ type: integer+ tag_count:+ type: integerrequestBody:content:application/json:schema:type: object+ required:+ - ids+ - tagsproperties:- preferences:- type: object- additionalProperties: true- delete:- summary: Delete a rule from a promotion+ ids:+ type: array+ items:+ type: string+ tags:+ type: array+ items:+ type: string+ example:+ - summer+ - sale+ "/api/v3/admin/products/bulk_remove_tags":+ post:+ summary: Bulk-remove tags from productstags:- - Promotions+ - Productssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_promotions` (for API-key authentication)."+ description: |-+ Removes each tag in `tags` from every product in `ids`.++ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16646,10 +16636,13 @@ paths:secretKey: 'sk_xxx',})- await client.promotions.rules.delete('promo_UkLWZg9DAJ', 'promorule_k5nR8xLq')+ const result = await client.products.bulkRemoveTags({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ tags: ['summer'],+ })- lang: bashlabel: Spree CLI- source: spree api delete /promotions/{promotion_id}/promotion_rules/{id}+ source: spree api post /products/bulk_remove_tags -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"],"tags":["summer"]}'parameters:- name: x-spree-api-keyin: header@@ -16662,18 +16655,110 @@ paths:schema:type: stringresponses:- '204':- description: rule deleted- "/api/v3/admin/promotions":+ '200':+ description: tags removed+ content:+ application/json:+ example:+ product_count: 1+ tag_count: 1+ 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.++ **Required scope:** `write_products` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const result = await client.products.bulkDestroy({+ ids: ['prod_UkLWZg9DAJ', 'prod_9XbR2kQwLm'],+ })+ - lang: bash+ label: Spree CLI+ source: spree api delete /products/bulk_destroy -d '{"ids":["prod_UkLWZg9DAJ","prod_9XbR2kQwLm"]}'+ 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:+ example:+ product_count: 1+ 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: stringget:- summary: List promotions+ summary: List coupon codes for a promotiontags:- Promotionssecurity:- api_key: []bearer_auth: []description: |-- Returns the store's promotions, including manual coupon and automatic promotions.+ 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.**Required scope:** `read_promotions` (for API-key authentication).x-codeSamples:@@ -16687,10 +16772,10 @@ paths:secretKey: 'sk_xxx',})- const { data: promotions } = await client.promotions.list()+ const { data: coupons } = await client.promotions.couponCodes.list('promo_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /promotions+ source: spree api get /promotions/{promotion_id}/coupon_codesparameters:- name: x-spree-api-keyin: header@@ -16704,30 +16789,93 @@ paths:type: stringresponses:'200':- description: promotions found+ description: coupon codes foundcontent:application/json:example:data:- - id: promo_UkLWZg9DAJ- name: Summer Sale- description:- code: summer- starts_at: '2026-07-27T20:01:35.424Z'- expires_at:- usage_limit:- match_policy: all- path:- kind: coupon_code- multi_codes: false- number_of_codes:- code_prefix:- promotion_category_id:- metadata: {}- created_at: '2026-07-27T20:01:35.424Z'- updated_at: '2026-07-27T20:01:35.424Z'- action_ids: []- rule_ids: []+ - id: coupon_UkLWZg9DAJ+ code: AAA111+ state: unused+ created_at: '2026-07-29T08:37:10.906Z'+ updated_at: '2026-07-29T08:37:10.906Z'+ promotion_id: promo_UkLWZg9DAJ+ order_id:+ - id: coupon_gbHJdmfrXB+ code: BBB222+ state: unused+ created_at: '2026-07-29T08:37:10.907Z'+ updated_at: '2026-07-29T08:37:10.907Z'+ promotion_id: promo_UkLWZg9DAJ+ order_id:+ meta:+ page: 1+ limit: 25+ count: 2+ pages: 1+ from: 1+ to: 2+ in: 2+ previous:+ next:+ "/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)."+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: actions } = await client.promotions.actions.list('promo_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api get /promotions/{promotion_id}/promotion_actions+ 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:+ example:+ data:+ - id: pact_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:36.667Z'+ updated_at: '2026-07-29T08:38:36.667Z'+ type: free_shipping+ promotion_id: promo_UkLWZg9DAJ+ preferences: {}+ preference_schema: []+ label: Free shipping+ calculator:+ line_items:meta:page: 1limit: 25@@ -16739,20 +16887,14 @@ paths:previous:next:post:- summary: Create a promotion+ summary: Create an action on a promotiontags:- Promotionssecurity:- api_key: []bearer_auth: []description: |-- Creates a new promotion. `code` is required for single-code coupon promotions;- pass `multi_codes: true` with `number_of_codes` to auto-generate a batch.-- Rules and actions can be created in the same request by passing arrays of- `{ type, preferences, ... }` rows. The server reconciles to the desired set:- new rows are built, existing rows (by `id`) are updated, omitted rows are removed.-+ 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.**Required scope:** `write_promotions` (for API-key authentication).x-codeSamples:@@ -16766,51 +16908,12 @@ paths:secretKey: 'sk_xxx',})- // Single coupon code, no rules/actions- const promotion = await client.promotions.create({- name: 'Black Friday',- code: 'BLACKFRIDAY',- starts_at: '2026-11-29T00:00:00Z',- expires_at: '2026-12-01T00:00:00Z',- })-- // One-shot: promotion + rules + actions in a single request- const blackFriday = await client.promotions.create({- name: 'Black Friday',- code: 'BLACKFRIDAY',- kind: 'coupon_code',- starts_at: '2026-11-29T00:00:00Z',- expires_at: '2026-12-01T00:00:00Z',- match_policy: 'all',- rules: [- {- type: 'currency',- preferences: { currency: 'USD' },- },- {- type: 'item_total',- preferences: { amount_min: 100, operator_min: 'gte' },- },- {- type: 'product',- preferences: { match_policy: 'any' },- product_ids: ['prod_abc123', 'prod_def456'],- },- ],- actions: [- {- type: 'create_item_adjustments',- calculator: {- type: 'percent_on_line_item',- preferences: { percent: 25 },- },- },- { type: 'free_shipping' },- ],+ const action = await client.promotions.actions.create('promo_UkLWZg9DAJ', {+ type: 'free_shipping',})- lang: bashlabel: Spree CLI- source: spree api post /promotions -d '{"name":"Black Friday","code":"BLACKFRIDAY","starts_at":"2026-11-29T00:00:00Z","expires_at":"2026-12-01T00:00:00Z"}'+ source: spree api post /promotions/{promotion_id}/promotion_actions -d '{"type":"free_shipping"}'parameters:- name: x-spree-api-keyin: header@@ -16824,151 +16927,62 @@ paths:type: stringresponses:'201':- description: promotion created with rules and actions+ description: action createdcontent:application/json:example:- id: promo_gbHJdmfrXB- name: Black Friday- description:- code: blackfriday-os- starts_at: '2026-07-27T20:01:36.335Z'- expires_at:- usage_limit:- match_policy: all- path:- kind: coupon_code- multi_codes: false- number_of_codes:- code_prefix:- promotion_category_id:- metadata: {}- created_at: '2026-07-27T20:01:36.335Z'- updated_at: '2026-07-27T20:01:36.353Z'- action_ids:- - pact_UkLWZg9DAJ- - pact_gbHJdmfrXB- rule_ids:- - prorule_UkLWZg9DAJ- - prorule_gbHJdmfrXB- - prorule_EfhxLZ9ck8+ id: pact_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:37.228Z'+ updated_at: '2026-07-29T08:38:37.228Z'+ type: free_shipping+ promotion_id: promo_UkLWZg9DAJ+ preferences: {}+ preference_schema: []+ label: Free shipping+ calculator:+ line_items:'422':- description: invalid params+ description: unknown action typecontent:application/json:example:error:- code: validation_error- message: Name can't be blank and Code can't be blank- details:- name:- - can't be blank- code:- - can't be blank+ code: unknown_promotion_action_type+ message: Unknown typerequestBody:content:application/json:schema:type: objectproperties:- 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:type: string- nullable: true- rules:- type: array- items:- type: object- properties:- type:- type: string- example: currency- 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- example: free_shipping- preferences:- type: object- additionalProperties: true- calculator:- type: object- properties:- type:- type: string- example: flat_percent_item_total- preferences:- type: object- additionalProperties: true- required:- - type+ example: free_shipping+ preferences:+ type: object+ additionalProperties: truerequired:- - name- "/api/v3/admin/promotions/{id}":- get:- summary: Show a promotion+ - 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 promotiontags:- Promotionssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `read_promotions` (for API-key authentication)."+ description: "**Required scope:** `write_promotions` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -16980,10 +16994,10 @@ paths:secretKey: 'sk_xxx',})- const promotion = await client.promotions.get('promo_UkLWZg9DAJ')+ await client.promotions.actions.delete('promo_UkLWZg9DAJ', 'promoact_k5nR8xLq')- lang: bashlabel: Spree CLI- source: spree api get /promotions/{id}+ source: spree api delete /promotions/{promotion_id}/promotion_actions/{id}parameters:- name: x-spree-api-keyin: header@@ -16995,51 +17009,24 @@ paths:required: trueschema:type: string- - name: id- in: path- required: true- schema:- type: stringresponses:- '200':- description: promotion found- content:- application/json:- example:- id: promo_UkLWZg9DAJ- name: Summer Sale- description:- code: summer- starts_at: '2026-07-27T20:01:36.644Z'- expires_at:- usage_limit:- match_policy: all- path:- kind: coupon_code- multi_codes: false- number_of_codes:- code_prefix:- promotion_category_id:- metadata: {}- created_at: '2026-07-27T20:01:36.644Z'- updated_at: '2026-07-27T20:01:36.644Z'- action_ids: []- rule_ids: []- patch:- summary: Update a promotion+ '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 promotiontags:- Promotionssecurity:- api_key: []bearer_auth: []- description: |-- Updates a promotion. The `rules` and `actions` arrays are treated as- a *desired set* — rows with `id` update in place, rows without `id` are- built fresh, and any existing row not present in the array is destroyed.- Pass `rules: []` or `actions: []` to clear them.--- **Required scope:** `write_promotions` (for API-key authentication).+ description: "**Required scope:** `read_promotions` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17051,48 +17038,10 @@ paths:secretKey: 'sk_xxx',})- // Basic field update- await client.promotions.update(promotionId, {- description: 'Updated description',- })-- // One-shot: rewrite rules + actions in a single request- await client.promotions.update(promotionId, {- name: 'Holiday Sale',- rules: [- // Update an existing rule by id — `preferences` overwrite the prior set- {- id: 'prorule_existing',- type: 'currency',- preferences: { currency: 'EUR' },- },- // Add a new rule- {- type: 'item_total',- preferences: { amount_min: 50, operator_min: 'gte' },- },- ],- actions: [- // Swap calculator type on an existing action- {- id: 'proaction_existing',- type: 'create_item_adjustments',- calculator: {- type: 'percent_on_line_item',- preferences: { percent: 15 },- },- },- ],- })-- // Remove all rules/actions- await client.promotions.update(promotionId, {- rules: [],- actions: [],- })+ const { data: rules } = await client.promotions.rules.list('promo_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api patch /promotions/{id} -d '{"description":"Updated description"}'+ source: spree api get /promotions/{promotion_id}/promotion_rulesparameters:- name: x-spree-api-keyin: header@@ -17104,137 +17053,49 @@ paths:required: trueschema:type: string- - name: id- in: path- required: true- schema:- type: stringresponses:'200':- description: rules and actions cleared with empty arrays+ description: rules foundcontent:application/json:example:- id: promo_UkLWZg9DAJ- name: Summer Sale- description:- code: summer- starts_at: '2026-07-27T20:01:37.511Z'- expires_at:- usage_limit:- match_policy: all- path:- kind: coupon_code- multi_codes: false- number_of_codes:- code_prefix:- promotion_category_id:- metadata: {}- created_at: '2026-07-27T20:01:37.511Z'- updated_at: '2026-07-27T20:01:37.790Z'- action_ids: []- rule_ids: []- 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- example: currency- 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- example: free_shipping- preferences:- type: object- additionalProperties: true- calculator:- type: object- properties:- type:- type: string- example: flat_percent_item_total- preferences:- type: object- additionalProperties: true- required:- - type- delete:- summary: Delete a promotion+ data:+ - id: prorule_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:37.800Z'+ updated_at: '2026-07-29T08:38:37.800Z'+ type: currency+ promotion_id: promo_UkLWZg9DAJ+ preferences:+ currency: USD+ preference_schema:+ - key: currency+ type: string+ default:+ label: Currency+ product_ids:+ category_ids:+ customer_ids:+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ post:+ summary: Create a rule on a promotiontags:- Promotionssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_promotions` (for API-key authentication)."+ 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.++ **Required scope:** `write_promotions` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17246,10 +17107,13 @@ paths:secretKey: 'sk_xxx',})- await client.promotions.delete('promo_UkLWZg9DAJ')+ const rule = await client.promotions.rules.create('promo_UkLWZg9DAJ', {+ type: 'currency',+ preferences: { currency: 'EUR' },+ })- lang: bashlabel: Spree CLI- source: spree api delete /promotions/{id}+ source: spree api post /promotions/{promotion_id}/promotion_rules -d '{"type":"currency","preferences":{"currency":"EUR"}}'parameters:- name: x-spree-api-keyin: header@@ -17261,26 +17125,69 @@ paths:required: trueschema:type: string- - name: id- in: path- required: true- schema:- type: stringresponses:- '204':- description: promotion deleted- "/api/v3/admin/promotion_actions/types":- get:- summary: List available promotion action types+ '201':+ description: rule created with preferences+ content:+ application/json:+ example:+ id: prorule_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:38.355Z'+ updated_at: '2026-07-29T08:38:38.355Z'+ type: currency+ promotion_id: promo_UkLWZg9DAJ+ preferences:+ currency: EUR+ preference_schema:+ - key: currency+ type: string+ default:+ label: Currency+ product_ids:+ category_ids:+ customer_ids:+ '422':+ description: unknown rule type+ content:+ application/json:+ example:+ error:+ code: unknown_promotion_rule_type+ message: Unknown type+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ type:+ type: string+ example: currency+ 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 preferencestags:- Promotionssecurity:- 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.-- **Required scope:** `read_promotions` (for API-key authentication).+ description: "**Required scope:** `write_promotions` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17292,10 +17199,13 @@ paths:secretKey: 'sk_xxx',})- const { data: actionTypes } = await client.promotionActions.types()+ const rule = await client.promotions.rules.update('promo_UkLWZg9DAJ', 'promorule_k5nR8xLq', {+ preferences: { currency: 'USD' },+ })- lang: bashlabel: Spree CLI- source: spree api get /promotion_actions/types+ source: spree api patch /promotions/{promotion_id}/promotion_rules/{id} -d+ '{"preferences":{"currency":"USD"}}'parameters:- name: x-spree-api-keyin: header@@ -17309,41 +17219,44 @@ paths:type: stringresponses:'200':- description: action types found+ description: rule updatedcontent:application/json:example:- data:- - type: create_line_items- label: Create line items- description:- preference_schema: []- - type: create_item_adjustments- label: Create per-line-item adjustment- description:- preference_schema: []- - type: create_adjustment- label: Create whole-order adjustment- description:- preference_schema: []- - type: free_shipping- label: Free shipping- description:- preference_schema: []- "/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.-- **Required scope:** `read_promotions` (for API-key authentication).- x-codeSamples:- - lang: javascript+ id: prorule_UkLWZg9DAJ+ created_at: '2026-07-29T08:38:38.645Z'+ updated_at: '2026-07-29T08:38:38.933Z'+ type: currency+ promotion_id: promo_UkLWZg9DAJ+ preferences:+ currency: GBP+ preference_schema:+ - key: currency+ type: string+ default:+ label: Currency+ product_ids:+ category_ids:+ customer_ids:+ 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)."+ x-codeSamples:+ - lang: javascriptlabel: Spree Admin SDKsource: |-import { createAdminClient } from '@spree/admin-sdk'@@ -17353,10 +17266,10 @@ paths:secretKey: 'sk_xxx',})- const { data: ruleTypes } = await client.promotionRules.types()+ await client.promotions.rules.delete('promo_UkLWZg9DAJ', 'promorule_k5nR8xLq')- lang: bashlabel: Spree CLI- source: spree api get /promotion_rules/types+ source: spree api delete /promotions/{promotion_id}/promotion_rules/{id}parameters:- name: x-spree-api-keyin: header@@ -17369,121 +17282,20 @@ paths:schema:type: stringresponses:- '200':- description: rule types found- content:- application/json:- example:- data:- - type: category- label: Categories- description:- preference_schema:- - key: match_policy- type: string- default: any- - type: channel- label: Channel(s)- description:- preference_schema:- - key: channel_ids- type: array- default: []- - type: country- label: Country- description:- preference_schema:- - key: country_isos- type: array- default: []- - key: country_id- type: integer- default:- - key: country_iso- type: string- default:- - type: currency- label: Currency- description:- preference_schema:- - key: currency- type: string- default:- - type: customer_group- label: Customer Group(s)- description:- preference_schema:- - key: customer_group_ids- type: array- default: []- - type: customer- label: Customers- description:- preference_schema: []- - type: first_order- label: First order- description:- preference_schema: []- - type: item_total- label: Item total- description:- preference_schema:- - key: amount_min- type: decimal- default: 100.0- - key: operator_min- type: string- default: ">"- - key: amount_max- type: decimal- default:- - key: operator_max- type: string- default: "<"- - type: market- label: Market(s)- description:- preference_schema:- - key: market_ids- type: array- default: []- - type: one_use_per_user- label: One Use Per User- description:- preference_schema: []- - type: customer_logged_in- label: Only logged in customers- description:- preference_schema: []- - type: option_value- label: Option Value(s)- description:- preference_schema:- - key: match_policy- type: string- default: any- - key: eligible_values- type: array- default: []- - type: product- label: Product(s)- description:- preference_schema:- - key: match_policy- type: string- default: any- "/api/v3/admin/orders/{order_id}/refunds":+ '204':+ description: rule deleted+ "/api/v3/admin/promotions":get:- summary: List refunds+ summary: List promotionstags:- - Refunds+ - Promotionssecurity:- api_key: []bearer_auth: []description: |-- Returns all refunds for an order.+ Returns the store's promotions, including manual coupon and automatic promotions.- **Required scope:** `read_refunds` (for API-key authentication).+ **Required scope:** `read_promotions` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17495,10 +17307,10 @@ paths:secretKey: 'sk_xxx',})- const { data: refunds } = await client.orders.refunds.list('or_UkLWZg9DAJ')+ const { data: promotions } = await client.promotions.list()- lang: bashlabel: Spree CLI- source: spree api get /orders/{order_id}/refunds+ source: spree api get /promotionsparameters:- name: x-spree-api-keyin: header@@ -17508,57 +17320,61 @@ paths:- name: Authorizationin: headerrequired: 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: stringresponses:'200':- description: refunds found+ description: promotions foundcontent:application/json:example:- data: []+ data:+ - id: promo_UkLWZg9DAJ+ name: Summer Sale+ description:+ code: summer+ starts_at: '2026-07-29T08:38:39.256Z'+ expires_at:+ usage_limit:+ match_policy: all+ path:+ kind: coupon_code+ multi_codes: false+ number_of_codes:+ code_prefix:+ promotion_category_id:+ metadata: {}+ created_at: '2026-07-29T08:38:39.256Z'+ updated_at: '2026-07-29T08:38:39.256Z'+ action_ids: []+ rule_ids: []meta:page: 1limit: 25- count: 0+ count: 1pages: 1- from: 0- to: 0- in: 0+ from: 1+ to: 1+ in: 1previous:next:post:- summary: Create a refund+ summary: Create a promotiontags:- - Refunds+ - Promotionssecurity:- api_key: []bearer_auth: []description: |-- Creates a refund for a payment on the order. The refund is automatically processed via the payment gateway.+ Creates a new promotion. `code` is required for single-code coupon promotions;+ pass `multi_codes: true` with `number_of_codes` to auto-generate a batch.- **Required scope:** `write_refunds` (for API-key authentication).+ Rules and actions can be created in the same request by passing arrays of+ `{ type, preferences, ... }` rows. The server reconciles to the desired set:+ new rows are built, existing rows (by `id`) are updated, omitted rows are removed.+++ **Required scope:** `write_promotions` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17570,77 +17386,51 @@ paths:secretKey: 'sk_xxx',})- const refund = await client.orders.refunds.create('or_UkLWZg9DAJ', {- payment_id: 'pay_UkLWZg9DAJ',- amount: '5.00',- refund_reason_id: 'refrsn_UkLWZg9DAJ',+ // Single coupon code, no rules/actions+ const promotion = await client.promotions.create({+ name: 'Black Friday',+ code: 'BLACKFRIDAY',+ starts_at: '2026-11-29T00:00:00Z',+ expires_at: '2026-12-01T00:00:00Z',})- - lang: bash- label: Spree CLI- source: spree api post /orders/{order_id}/refunds -d '{"payment_id":"pay_UkLWZg9DAJ","amount":"5.00","refund_reason_id":"refrsn_UkLWZg9DAJ"}'- 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:- example:- id: re_UkLWZg9DAJ- transaction_id: BGS-2cd1ddfbf9fc- amount: '5.0'- payment_id: py_UkLWZg9DAJ- refund_reason_id: rr_UkLWZg9DAJ- reimbursement_id:- metadata: {}- created_at: '2026-07-27T20:01:05.524Z'- updated_at: '2026-07-27T20:01:05.524Z'- requestBody:- content:- application/json:- schema:- type: object- required:- - payment_id- - amount- properties:- payment_id:- type: string- description: Payment ID- amount:- type: string- example: '10.00'- refund_reason_id:- type: string- description: Refund reason ID- "/api/v3/admin/locales":- get:- summary: List supported locales- tags:- - Settings- security:- - api_key: []- bearer_auth: []- description: |-- Returns the locales a merchant can translate content into for the current store, with the default and right-to-left flags.- **Required scope:** `read_settings` (for API-key authentication).+ // One-shot: promotion + rules + actions in a single request+ const blackFriday = await client.promotions.create({+ name: 'Black Friday',+ code: 'BLACKFRIDAY',+ kind: 'coupon_code',+ starts_at: '2026-11-29T00:00:00Z',+ expires_at: '2026-12-01T00:00:00Z',+ match_policy: 'all',+ rules: [+ {+ type: 'currency',+ preferences: { currency: 'USD' },+ },+ {+ type: 'item_total',+ preferences: { amount_min: 100, operator_min: 'gte' },+ },+ {+ type: 'product',+ preferences: { match_policy: 'any' },+ product_ids: ['prod_abc123', 'prod_def456'],+ },+ ],+ actions: [+ {+ type: 'create_item_adjustments',+ calculator: {+ type: 'percent_on_line_item',+ preferences: { percent: 25 },+ },+ },+ { type: 'free_shipping' },+ ],+ })+ - lang: bash+ label: Spree CLI+ source: spree api post /promotions -d '{"name":"Black Friday","code":"BLACKFRIDAY","starts_at":"2026-11-29T00:00:00Z","expires_at":"2026-12-01T00:00:00Z"}'parameters:- name: x-spree-api-keyin: header@@ -17653,41 +17443,152 @@ paths:schema:type: stringresponses:- '200':- description: locales found+ '201':+ description: promotion created with rules and actionscontent:application/json:example:- data:- - code: de- name: de- default: false- rtl: false- - code: en- name: English- default: true- rtl: false- - code: fr- name: fr- default: false- rtl: false- "/api/v3/admin/store_credit_categories":+ id: promo_gbHJdmfrXB+ name: Black Friday+ description:+ code: blackfriday-os+ starts_at: '2026-07-29T08:38:40.224Z'+ expires_at:+ usage_limit:+ match_policy: all+ path:+ kind: coupon_code+ multi_codes: false+ number_of_codes:+ code_prefix:+ promotion_category_id:+ metadata: {}+ created_at: '2026-07-29T08:38:40.224Z'+ updated_at: '2026-07-29T08:38:40.248Z'+ action_ids:+ - pact_UkLWZg9DAJ+ - pact_gbHJdmfrXB+ rule_ids:+ - prorule_UkLWZg9DAJ+ - prorule_gbHJdmfrXB+ - prorule_EfhxLZ9ck8+ '422':+ description: invalid params+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank and Code can't be blank+ details:+ name:+ - can't be blank+ code:+ - can't be blank+ 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+ example: currency+ 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+ example: free_shipping+ preferences:+ type: object+ additionalProperties: true+ calculator:+ type: object+ properties:+ type:+ type: string+ example: flat_percent_item_total+ preferences:+ type: object+ additionalProperties: true+ required:+ - type+ required:+ - name+ "/api/v3/admin/promotions/{id}":get:- summary: List store credit categories+ summary: Show a promotiontags:- - Settings+ - Promotionssecurity:- api_key: []bearer_auth: []- description: |-- Returns the configured store credit categories. Categories classify- store credits (e.g., "Goodwill", "Gift Card", "Refund") and surface- in the admin UI as a dropdown when issuing or editing a store- credit. Category names matching `Spree::Config[:non_expiring_credit_types]`- are flagged via `non_expiring: true`.--- **Required scope:** `read_settings` (for API-key authentication).+ description: "**Required scope:** `read_promotions` (for API-key authentication)."x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17699,10 +17600,10 @@ paths:secretKey: 'sk_xxx',})- const { data: categories } = await client.storeCreditCategories.list()+ const promotion = await client.promotions.get('promo_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api get /store_credit_categories+ source: spree api get /promotions/{id}parameters:- name: x-spree-api-keyin: header@@ -17712,102 +17613,53 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema: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.+ - name: id+ in: path+ required: trueschema:type: stringresponses:'200':- description: store credit categories found- content:- application/json:- example:- data:- - id: sccat_UkLWZg9DAJ- name: Goodwill- created_at: '2026-07-27T20:01:41.294Z'- updated_at: '2026-07-27T20:01:41.294Z'- non_expiring: false- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- schema:- type: object- properties:- data:- type: array- items:- "$ref": "#/components/schemas/StoreCreditCategory"- meta:- "$ref": "#/components/schemas/PaginationMeta"- required:- - data- - meta- '401':- description: unauthorized+ description: promotion foundcontent:application/json:example:- error:- code: authentication_required- message: Authentication required- 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+ id: promo_UkLWZg9DAJ+ name: Summer Sale+ description:+ code: summer+ starts_at: '2026-07-29T08:38:40.542Z'+ expires_at:+ usage_limit:+ match_policy: all+ path:+ kind: coupon_code+ multi_codes: false+ number_of_codes:+ code_prefix:+ promotion_category_id:+ metadata: {}+ created_at: '2026-07-29T08:38:40.542Z'+ updated_at: '2026-07-29T08:38:40.542Z'+ action_ids: []+ rule_ids: []+ patch:+ summary: Update a promotiontags:- - Settings+ - Promotionssecurity:- api_key: []bearer_auth: []description: |-- Returns a single store credit category by prefixed ID.+ Updates a promotion. The `rules` and `actions` arrays are treated as+ a *desired set* — rows with `id` update in place, rows without `id` are+ built fresh, and any existing row not present in the array is destroyed.+ Pass `rules: []` or `actions: []` to clear them.- **Required scope:** `read_settings` (for API-key authentication).++ **Required scope:** `write_promotions` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -17819,78 +17671,48 @@ paths:secretKey: 'sk_xxx',})- const category = await client.storeCreditCategories.get('sccat_UkLWZg9DAJ')- - lang: bash- label: Spree CLI- source: spree api get /store_credit_categories/{id}- 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:- example:- id: sccat_UkLWZg9DAJ- name: Goodwill- created_at: '2026-07-27T20:01:41.591Z'- updated_at: '2026-07-27T20:01:41.591Z'- non_expiring: false- schema:- "$ref": "#/components/schemas/StoreCreditCategory"- '404':- description: store credit category not found- content:- application/json:- example:- error:- code: record_not_found- message: Store credit category not found- 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.-- **Required scope:** `read_settings` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'+ // Basic field update+ await client.promotions.update(promotionId, {+ description: 'Updated description',+ })- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',+ // One-shot: rewrite rules + actions in a single request+ await client.promotions.update(promotionId, {+ name: 'Holiday Sale',+ rules: [+ // Update an existing rule by id — `preferences` overwrite the prior set+ {+ id: 'prorule_existing',+ type: 'currency',+ preferences: { currency: 'EUR' },+ },+ // Add a new rule+ {+ type: 'item_total',+ preferences: { amount_min: 50, operator_min: 'gte' },+ },+ ],+ actions: [+ // Swap calculator type on an existing action+ {+ id: 'proaction_existing',+ type: 'create_item_adjustments',+ calculator: {+ type: 'percent_on_line_item',+ preferences: { percent: 15 },+ },+ },+ ],})- const store = await client.store.get()+ // Remove all rules/actions+ await client.promotions.update(promotionId, {+ rules: [],+ actions: [],+ })- lang: bashlabel: Spree CLI- source: spree api get /store+ source: spree api patch /promotions/{id} -d '{"description":"Updated description"}'parameters:- name: x-spree-api-keyin: header@@ -17900,62 +17722,1160 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authentication+ schema:+ type: string+ - name: id+ in: path+ required: trueschema:type: stringresponses:'200':- description: current store+ description: rules and actions cleared with empty arrayscontent:application/json:example:- id: store_UkLWZg9DAJ+ id: promo_UkLWZg9DAJ+ name: Summer Sale+ description:+ code: summer+ starts_at: '2026-07-29T08:38:41.409Z'+ expires_at:+ usage_limit:+ match_policy: all+ path:+ kind: coupon_code+ multi_codes: false+ number_of_codes:+ code_prefix:+ promotion_category_id:metadata: {}- name: Spree Test Store- code: spree_1- preferred_storefront_url:- default_currency: USD- default_locale: en- mail_from_address: [email protected]- customer_support_email: [email protected]- new_order_notifications_email: [email protected]- preferred_send_consumer_transactional_emails: true- preferred_admin_locale:- preferred_timezone: UTC- preferred_weight_unit: lb- preferred_unit_system: imperial- preferred_storefront_access: public- preferred_guest_checkout: true- preferred_order_routing_strategy: Spree::OrderRouting::Strategy::Rules- created_at: '2026-07-27T19:59:58.874Z'- updated_at: '2026-07-27T20:01:42.184Z'- url: http://www.example.com:3000- api_url: http://www.example.com:3000- setup_tasks:- - name: setup_payment_method- done: false- - name: add_products- done: false- - name: set_customer_support_email- done: true- - name: setup_taxes_collection- done: false- - name: setup_storefront- done: false- supported_currencies:- - USD- supported_locales:- - en- available_locales:- - aa- - ab- - ae- - af- - ak- - am- - an- - ar- - as+ created_at: '2026-07-29T08:38:41.409Z'+ updated_at: '2026-07-29T08:38:41.692Z'+ action_ids: []+ rule_ids: []+ 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+ example: currency+ 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+ example: free_shipping+ preferences:+ type: object+ additionalProperties: true+ calculator:+ type: object+ properties:+ type:+ type: string+ example: flat_percent_item_total+ 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)."+ 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',+ })++ await client.promotions.delete('promo_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api delete /promotions/{id}+ 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.++ **Required scope:** `read_promotions` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: actionTypes } = await client.promotionActions.types()+ - lang: bash+ label: Spree CLI+ source: spree api get /promotion_actions/types+ 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:+ example:+ data:+ - type: create_line_items+ label: Create line items+ description:+ preference_schema: []+ - type: create_item_adjustments+ label: Create per-line-item adjustment+ description:+ preference_schema: []+ - type: create_adjustment+ label: Create whole-order adjustment+ description:+ preference_schema: []+ - type: free_shipping+ label: Free shipping+ description:+ preference_schema: []+ "/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.++ **Required scope:** `read_promotions` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: ruleTypes } = await client.promotionRules.types()+ - lang: bash+ label: Spree CLI+ source: spree api get /promotion_rules/types+ 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:+ example:+ data:+ - type: category+ label: Categories+ description:+ preference_schema:+ - key: match_policy+ type: string+ default: any+ - type: channel+ label: Channel(s)+ description:+ preference_schema:+ - key: channel_ids+ type: array+ default: []+ - type: country+ label: Country+ description:+ preference_schema:+ - key: country_isos+ type: array+ default: []+ - key: country_id+ type: integer+ default:+ - key: country_iso+ type: string+ default:+ - type: currency+ label: Currency+ description:+ preference_schema:+ - key: currency+ type: string+ default:+ - type: customer_group+ label: Customer Group(s)+ description:+ preference_schema:+ - key: customer_group_ids+ type: array+ default: []+ - type: customer+ label: Customers+ description:+ preference_schema: []+ - type: first_order+ label: First order+ description:+ preference_schema: []+ - type: item_total+ label: Item total+ description:+ preference_schema:+ - key: amount_min+ type: decimal+ default: 100.0+ - key: operator_min+ type: string+ default: ">"+ - key: amount_max+ type: decimal+ default:+ - key: operator_max+ type: string+ default: "<"+ - type: market+ label: Market(s)+ description:+ preference_schema:+ - key: market_ids+ type: array+ default: []+ - type: one_use_per_user+ label: One Use Per User+ description:+ preference_schema: []+ - type: customer_logged_in+ label: Only logged in customers+ description:+ preference_schema: []+ - type: option_value+ label: Option Value(s)+ description:+ preference_schema:+ - key: match_policy+ type: string+ default: any+ - key: eligible_values+ type: array+ default: []+ - type: product+ label: Product(s)+ description:+ preference_schema:+ - key: match_policy+ type: string+ default: any+ "/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.++ **Required scope:** `read_refunds` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: refunds } = await client.orders.refunds.list('or_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api get /orders/{order_id}/refunds+ 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:+ example:+ data: []+ meta:+ page: 1+ limit: 25+ count: 0+ pages: 1+ from: 0+ to: 0+ in: 0+ previous:+ next:+ 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.++ **Required scope:** `write_refunds` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const refund = await client.orders.refunds.create('or_UkLWZg9DAJ', {+ payment_id: 'pay_UkLWZg9DAJ',+ amount: '5.00',+ refund_reason_id: 'refrsn_UkLWZg9DAJ',+ })+ - lang: bash+ label: Spree CLI+ source: spree api post /orders/{order_id}/refunds -d '{"payment_id":"pay_UkLWZg9DAJ","amount":"5.00","refund_reason_id":"refrsn_UkLWZg9DAJ"}'+ 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:+ example:+ id: re_UkLWZg9DAJ+ transaction_id: BGS-5916f4d11210+ amount: '5.0'+ payment_id: py_UkLWZg9DAJ+ refund_reason_id: rr_UkLWZg9DAJ+ reimbursement_id:+ metadata: {}+ created_at: '2026-07-29T08:38:09.014Z'+ updated_at: '2026-07-29T08:38:09.014Z'+ requestBody:+ content:+ application/json:+ schema:+ type: object+ required:+ - payment_id+ - amount+ properties:+ payment_id:+ type: string+ description: Payment ID+ amount:+ type: string+ example: '10.00'+ refund_reason_id:+ type: string+ description: Refund reason ID+ "/api/v3/admin/locales":+ get:+ summary: List supported locales+ tags:+ - Settings+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Returns the locales a merchant can translate content into for the current store, with the default and right-to-left flags.++ **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: locales found+ content:+ application/json:+ example:+ data:+ - code: de+ name: de+ default: false+ rtl: false+ - code: en+ name: English+ default: true+ rtl: false+ - code: fr+ name: fr+ default: false+ rtl: false+ "/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+ store credits (e.g., "Goodwill", "Gift Card", "Refund") and surface+ in the admin UI as a dropdown when issuing or editing a store+ credit. Category names matching `Spree::Config[:non_expiring_credit_types]`+ are flagged via `non_expiring: true`.+++ **Required scope:** `read_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: categories } = await client.storeCreditCategories.list()+ - lang: bash+ label: Spree CLI+ source: spree api get /store_credit_categories+ 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:+ example:+ data:+ - id: sccat_UkLWZg9DAJ+ name: Goodwill+ created_at: '2026-07-29T08:38:45.144Z'+ updated_at: '2026-07-29T08:38:45.144Z'+ non_expiring: false+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ 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:+ example:+ error:+ code: authentication_required+ message: Authentication required+ 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.++ **Required scope:** `read_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const category = await client.storeCreditCategories.get('sccat_UkLWZg9DAJ')+ - lang: bash+ label: Spree CLI+ source: spree api get /store_credit_categories/{id}+ 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:+ example:+ id: sccat_UkLWZg9DAJ+ name: Goodwill+ created_at: '2026-07-29T08:38:45.441Z'+ updated_at: '2026-07-29T08:38:45.441Z'+ non_expiring: false+ schema:+ "$ref": "#/components/schemas/StoreCreditCategory"+ '404':+ description: store credit category not found+ content:+ application/json:+ example:+ error:+ code: record_not_found+ message: Store credit category not found+ 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.++ **Required scope:** `read_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const store = await client.store.get()+ - lang: bash+ label: Spree CLI+ source: spree api get /store+ 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:+ example:+ id: store_UkLWZg9DAJ+ metadata: {}+ name: Spree Test Store+ code: spree_1+ preferred_storefront_url:+ default_currency: USD+ default_locale: en+ mail_from_address: [email protected]+ customer_support_email: [email protected]+ new_order_notifications_email: [email protected]+ preferred_send_consumer_transactional_emails: true+ preferred_admin_locale:+ preferred_timezone: UTC+ preferred_weight_unit: lb+ preferred_unit_system: imperial+ preferred_storefront_access: public+ preferred_guest_checkout: true+ preferred_order_routing_strategy: Spree::OrderRouting::Strategy::Rules+ created_at: '2026-07-29T08:36:53.649Z'+ updated_at: '2026-07-29T08:38:46.019Z'+ url: http://www.example.com:3000+ api_url: http://www.example.com:3000+ setup_tasks:+ - name: setup_payment_method+ done: false+ - name: add_products+ done: false+ - name: set_customer_support_email+ done: true+ - name: setup_taxes_collection+ done: false+ - name: setup_storefront+ done: false+ supported_currencies:+ - USD+ - EUR+ - GBP+ supported_locales:+ - en+ available_locales:+ - aa+ - ab+ - ae+ - af+ - ak+ - am+ - an+ - ar+ - as+ - av+ - ay+ - az+ - ba+ - be+ - bg+ - bh+ - bi+ - bm+ - bn+ - bo+ - br+ - bs+ - ca+ - ce+ - ch+ - co+ - cr+ - cs+ - cu+ - cv+ - cy+ - da+ - de+ - de-AT+ - de-CH+ - dv+ - dz+ - ee+ - el+ - en+ - en-AU+ - en-CA+ - en-GB+ - en-IN+ - en-NZ+ - eo+ - es+ - es-419+ - es-MX+ - et+ - eu+ - fa+ - ff+ - fi+ - fj+ - fo+ - fr+ - fr-CA+ - fy+ - ga+ - gd+ - gl+ - gn+ - gu+ - gv+ - ha+ - he+ - hi+ - ho+ - hr+ - ht+ - hu+ - hy+ - hz+ - ia+ - id+ - ie+ - ig+ - ii+ - ik+ - io+ - is+ - it+ - iu+ - ja+ - jv+ - ka+ - kg+ - ki+ - kj+ - kk+ - kl+ - km+ - kn+ - ko+ - kr+ - ks+ - ku+ - kv+ - kw+ - ky+ - la+ - lb+ - lg+ - li+ - ln+ - lo+ - lt+ - lu+ - lv+ - mg+ - mh+ - mi+ - mk+ - ml+ - mn+ - mr+ - ms+ - mt+ - my+ - na+ - nb+ - nd+ - ne+ - ng+ - nl+ - nn+ - 'no'+ - nr+ - nv+ - ny+ - oc+ - oj+ - om+ - or+ - os+ - pa+ - pi+ - pl+ - ps+ - pt+ - pt-BR+ - pt-PT+ - qu+ - rm+ - rn+ - ro+ - ru+ - rw+ - sa+ - sc+ - sd+ - se+ - sg+ - si+ - sk+ - sl+ - sm+ - sn+ - so+ - sq+ - sr+ - ss+ - st+ - su+ - sv+ - sw+ - ta+ - te+ - tg+ - th+ - ti+ - tk+ - tl+ - tn+ - to+ - tr+ - ts+ - tt+ - tw+ - ty+ - ug+ - uk+ - ur+ - uz+ - ve+ - vi+ - vo+ - wa+ - wo+ - xh+ - yi+ - yo+ - za+ - zh-CN+ - zh-HK+ - zh-TW+ - zu+ logo_url:+ mailer_logo_url:+ schema:+ "$ref": "#/components/schemas/Store"+ '401':+ description: unauthorized+ content:+ application/json:+ example:+ error:+ code: authentication_required+ message: Authentication required+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update the current store+ tags:+ - Settings+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Updates the current store configuration.++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const store = await client.store.update({+ name: 'My Store'+ })+ - lang: bash+ label: Spree CLI+ source: spree api patch /store -d '{"name":"My Store"}'+ 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:+ example:+ id: store_UkLWZg9DAJ+ metadata: {}+ name: Renamed Store+ code: spree_1+ preferred_storefront_url:+ default_currency: USD+ default_locale: en+ mail_from_address: [email protected]+ customer_support_email: [email protected]+ new_order_notifications_email: [email protected]+ preferred_send_consumer_transactional_emails: true+ preferred_admin_locale:+ preferred_timezone: UTC+ preferred_weight_unit: lb+ preferred_unit_system: imperial+ preferred_storefront_access: public+ preferred_guest_checkout: true+ preferred_order_routing_strategy: Spree::OrderRouting::Strategy::Rules+ created_at: '2026-07-29T08:36:53.649Z'+ updated_at: '2026-07-29T08:38:46.711Z'+ url: http://www.example.com:3000+ api_url: http://www.example.com:3000+ setup_tasks:+ - name: setup_payment_method+ done: false+ - name: add_products+ done: false+ - name: set_customer_support_email+ done: true+ - name: setup_taxes_collection+ done: false+ - name: setup_storefront+ done: false+ supported_currencies:+ - USD+ - EUR+ - GBP+ supported_locales:+ - en+ available_locales:+ - aa+ - ab+ - ae+ - af+ - ak+ - am+ - an+ - ar+ - as- av- ay- az@@ -18149,27 +19069,327 @@ paths:mailer_logo_url:schema:"$ref": "#/components/schemas/Store"- '401':- description: unauthorized+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Site Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ name:+ type: string+ example: My Store+ preferred_admin_locale:+ type: string+ example: en+ preferred_timezone:+ type: string+ example: UTC+ preferred_weight_unit:+ type: string+ example: kg+ preferred_unit_system:+ type: string+ example: metric+ "/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.+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: tags } = await client.tags.list({+ taggable_type: 'Spree::User',+ q: 'vip',+ })+ - lang: bash+ label: Spree CLI+ source: spree api get /tags -d '{"taggable_type":"Spree::User","q":"vip"}'+ 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:+ example:+ data:+ - name: vip+ - name: wholesale+ '422':+ description: invalid taggable type+ content:+ application/json:+ example:+ error:+ code: invalid_taggable_type+ message: taggable_type must be one of Spree::Product, Spree::Order,+ Spree::LegacyUser+ "/api/v3/admin/translatable_resources":+ get:+ summary: List translatable resources+ tags:+ - Settings+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Returns every translatable resource type and its translatable fields (key + content type), so clients can render translation editors generically.++ **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: translatable resources foundcontent:application/json:example:- error:- code: authentication_required- message: Authentication required- schema:- "$ref": "#/components/schemas/ErrorResponse"- patch:- summary: Update the current store+ data:+ - resource_type: option_type+ fields:+ - key: label+ type: string+ readable: true+ - resource_type: option_value+ fields:+ - key: label+ type: string+ readable: false+ - resource_type: product+ fields:+ - key: name+ type: string+ - key: description+ type: html+ - key: slug+ type: string+ - key: meta_description+ type: string+ - key: meta_title+ type: string+ readable: true+ - resource_type: product_type+ fields:+ - key: name+ type: string+ readable: false+ - resource_type: collection+ fields:+ - key: name+ type: string+ - key: description+ type: string+ - key: permalink+ type: string+ readable: false+ - resource_type: category+ fields:+ - key: name+ type: string+ - key: pretty_name+ type: string+ - key: description+ type: html+ - key: permalink+ type: string+ readable: true+ - resource_type: taxonomy+ fields:+ - key: name+ type: string+ readable: false+ - resource_type: store+ fields:+ - key: name+ type: string+ - key: meta_description+ type: string+ - key: meta_keywords+ type: string+ - key: seo_title+ type: string+ - key: customer_support_email+ type: string+ - key: address+ type: string+ - key: contact_phone+ type: string+ readable: false+ - resource_type: policy+ fields:+ - key: name+ type: string+ - key: body+ type: html+ readable: false+ "/api/v3/admin/translations/batch":+ post:+ summary: Batch upsert translationstags:- Settingssecurity:- api_key: []bearer_auth: []description: |-- Updates the current store configuration.+ Atomically upserts translations across many records of (possibly) different translatable resource types in one request — e.g. an option type and all its option values in one save. A flat list of independent registry writes; all entries succeed or none do.- **Required scope:** `write_settings` (for API-key authentication).+ **Required scope:** `write_<resource>` for every resource type in the batch (for API-key authentication) (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: translations upserted+ content:+ application/json:+ example:+ data:+ - resource_id: opt_UkLWZg9DAJ+ resource_type: option_type+ translations:+ de:+ label: Größe+ translated_field_count: 1+ fr:+ label:+ translated_field_count: 0+ default_locale: en+ supported_locales:+ - de+ - en+ - fr+ - resource_id: optval_UkLWZg9DAJ+ resource_type: option_value+ translations:+ de:+ label: Klein+ translated_field_count: 1+ fr:+ label:+ translated_field_count: 0+ default_locale: en+ supported_locales:+ - de+ - en+ - fr+ '422':+ description: unsupported locale rolls back the whole batch+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: 'Unsupported locale(s): es'+ details:+ translations:+ '0':+ - 'Unsupported locale(s): es'+ requestBody:+ content:+ application/json:+ schema:+ type: object+ required:+ - translations+ properties:+ translations:+ type: array+ items:+ type: object+ required:+ - resource_type+ - resource_id+ - values+ properties:+ resource_type:+ type: string+ description: Translatable resource type token, e.g. `option_type`+ resource_id:+ type: string+ description: Prefixed id of the record+ values:+ type: object+ description: 'Map of locale code to { field: value }'+ additionalProperties:+ type: object+ additionalProperties: true+ "/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.++ **Required scope:** `read_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -18181,12 +19401,78 @@ paths:secretKey: 'sk_xxx',})- const store = await client.store.update({- name: 'My Store'+ const { data: staff } = await client.adminUsers.list()+ - lang: bash+ label: Spree CLI+ source: spree api get /admin_users+ 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:+ example:+ data:+ - id: admin_UkLWZg9DAJ+ email: [email protected]+ first_name: Sherman+ last_name: Streich+ full_name: Sherman Streich+ selected_locale:+ created_at: '2026-07-29T08:36:54.002Z'+ updated_at: '2026-07-29T08:36:54.002Z'+ avatar_url:+ roles:+ - id: role_UkLWZg9DAJ+ name: admin+ stores:+ - id: store_UkLWZg9DAJ+ name: Spree Test Store+ code: spree_1+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ "/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)."+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',})++ const staff = await client.adminUsers.get('admin_xxx')- lang: bashlabel: Spree CLI- source: spree api patch /store -d '{"name":"My Store"}'+ source: spree api get /admin_users/{id}parameters:- name: x-spree-api-keyin: header@@ -18196,299 +19482,129 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: string- responses:- '200':- description: store updated- content:- application/json:- example:- id: store_UkLWZg9DAJ- metadata: {}- name: Renamed Store- code: spree_1- preferred_storefront_url:- default_currency: USD- default_locale: en- mail_from_address: [email protected]- customer_support_email: [email protected]- new_order_notifications_email: [email protected]- preferred_send_consumer_transactional_emails: true- preferred_admin_locale:- preferred_timezone: UTC- preferred_weight_unit: lb- preferred_unit_system: imperial- preferred_storefront_access: public- preferred_guest_checkout: true- preferred_order_routing_strategy: Spree::OrderRouting::Strategy::Rules- created_at: '2026-07-27T19:59:58.874Z'- updated_at: '2026-07-27T20:01:42.800Z'- url: http://www.example.com:3000- api_url: http://www.example.com:3000- setup_tasks:- - name: setup_payment_method- done: false- - name: add_products- done: false- - name: set_customer_support_email- done: true- - name: setup_taxes_collection- done: false- - name: setup_storefront- done: false- supported_currencies:- - USD- supported_locales:- - en- available_locales:- - aa- - ab- - ae- - af- - ak- - am- - an- - ar- - as- - av- - ay- - az- - ba- - be- - bg- - bh- - bi- - bm- - bn- - bo- - br- - bs- - ca- - ce- - ch- - co- - cr- - cs- - cu- - cv- - cy- - da- - de- - de-AT- - de-CH- - dv- - dz- - ee- - el- - en- - en-AU- - en-CA- - en-GB- - en-IN- - en-NZ- - eo- - es- - es-419- - es-MX- - et- - eu- - fa- - ff- - fi- - fj- - fo- - fr- - fr-CA- - fy- - ga- - gd- - gl- - gn- - gu- - gv- - ha- - he- - hi- - ho- - hr- - ht- - hu- - hy- - hz- - ia- - id- - ie- - ig- - ii- - ik- - io- - is- - it- - iu- - ja- - jv- - ka- - kg- - ki- - kj- - kk- - kl- - km- - kn- - ko- - kr- - ks- - ku- - kv- - kw- - ky- - la- - lb- - lg- - li- - ln- - lo- - lt- - lu- - lv- - mg- - mh- - mi- - mk- - ml- - mn- - mr- - ms- - mt- - my- - na- - nb- - nd- - ne- - ng- - nl- - nn- - 'no'- - nr- - nv- - ny- - oc- - oj- - om- - or- - os- - pa- - pi- - pl- - ps- - pt- - pt-BR- - pt-PT- - qu- - rm- - rn- - ro- - ru- - rw- - sa- - sc- - sd- - se- - sg- - si- - sk- - sl- - sm- - sn- - so- - sq- - sr- - ss- - st- - su- - sv- - sw- - ta- - te- - tg- - th- - ti- - tk- - tl- - tn- - to- - tr- - ts- - tt- - tw- - ty- - ug- - uk- - ur- - uz- - ve- - vi- - vo- - wa- - wo- - xh- - yi- - yo- - za- - zh-CN- - zh-HK- - zh-TW- - zu- logo_url:- mailer_logo_url:- schema:- "$ref": "#/components/schemas/Store"- '422':- description: validation error+ - name: id+ in: path+ required: true+ schema:+ type: string+ responses:+ '200':+ description: staff member foundcontent:application/json:example:- error:- code: validation_error- message: Site Name can't be blank- details:- name:- - can't be blank- schema:- "$ref": "#/components/schemas/ErrorResponse"+ id: admin_UkLWZg9DAJ+ email: [email protected]+ first_name: Buena+ last_name: Sauer+ full_name: Buena Sauer+ selected_locale:+ created_at: '2026-07-29T08:36:54.379Z'+ updated_at: '2026-07-29T08:36:54.379Z'+ avatar_url:+ roles:+ - id: role_UkLWZg9DAJ+ name: admin+ stores:+ - id: store_UkLWZg9DAJ+ name: Spree Test Store+ code: spree_1+ 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.++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const staff = await client.adminUsers.update('admin_xxx', {+ first_name: 'Ada',+ role_ids: ['role_xxx']+ })+ - lang: bash+ label: Spree CLI+ source: spree api patch /admin_users/{id} -d '{"first_name":"Ada","role_ids":["role_xxx"]}'+ 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:+ example:+ id: admin_UkLWZg9DAJ+ email: [email protected]+ first_name: Renamed+ last_name: Zboncak+ full_name: Renamed Zboncak+ selected_locale:+ created_at: '2026-07-29T08:36:54.670Z'+ updated_at: '2026-07-29T08:36:54.688Z'+ avatar_url:+ roles:+ - id: role_UkLWZg9DAJ+ name: admin+ stores:+ - id: store_UkLWZg9DAJ+ name: Spree Test Store+ code: spree_1requestBody:content:application/json:schema:type: objectproperties:- name:- type: string- example: My Store- preferred_admin_locale:- type: string- example: en- preferred_timezone:- type: string- example: UTC- preferred_weight_unit:+ first_name:type: string- example: kg- preferred_unit_system:+ example: Ada+ last_name:type: string- example: metric- "/api/v3/admin/tags":- get:- summary: List tags+ example: Lovelace+ role_ids:+ type: array+ items:+ type: string+ delete:+ summary: Remove a staff member from this storetags:- - Settings+ - Staffsecurity:- api_key: []bearer_auth: []- description: Returns tag names for a given taggable type. Used for autocomplete- in tag inputs on products, orders, and customers.+ description: |-+ Removes the user's role assignments on the current store. The account is preserved — the user keeps access to any other stores.++ **Required scope:** `write_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -18500,13 +19616,10 @@ paths:secretKey: 'sk_xxx',})- const { data: tags } = await client.tags.list({- taggable_type: 'Spree::User',- q: 'vip',- })+ await client.adminUsers.delete('admin_xxx')- lang: bashlabel: Spree CLI- source: spree api get /tags -d '{"taggable_type":"Spree::User","q":"vip"}'+ source: spree api delete /admin_users/{id}parameters:- name: x-spree-api-keyin: header@@ -18518,48 +19631,182 @@ paths:required: trueschema:type: string- - name: taggable_type- in: query+ - name: id+ in: pathrequired: 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+ 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.++ **Required scope:** `read_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: invitations } = await client.invitations.list()+ - lang: bash+ label: Spree CLI+ source: spree api get /invitations+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: trueschema:type: stringresponses:'200':- description: tags found+ description: invitations foundcontent:application/json:example:data:- - name: vip- - name: wholesale- '422':- description: invalid taggable type+ - id: inv_UkLWZg9DAJ+ email: [email protected]+ status: pending+ created_at: '2026-07-29T08:37:40.834Z'+ updated_at: '2026-07-29T08:37:40.834Z'+ expires_at: '2026-08-12T08:37:40.828Z'+ role_id: role_UkLWZg9DAJ+ role_name: admin+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=tSsnoHEue1Y5xPAnnDAq1fHU"+ invitee_exists: false+ store:+ id: store_UkLWZg9DAJ+ name: Spree Test Store+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ 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.++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const invitation = await client.invitations.create({+ email: '[email protected]',+ role_id: 'role_xxx'+ })+ - lang: bash+ label: Spree CLI+ source: spree api post /invitations -d '{"email":"[email protected]","role_id":"role_xxx"}'+ 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 createdcontent:application/json:example:- error:- code: invalid_taggable_type- message: taggable_type must be one of Spree::Product, Spree::Order,- Spree::LegacyUser- "/api/v3/admin/translatable_resources":- get:- summary: List translatable resources+ id: inv_gbHJdmfrXB+ email: [email protected]+ status: pending+ created_at: '2026-07-29T08:37:41.171Z'+ updated_at: '2026-07-29T08:37:41.171Z'+ expires_at: '2026-08-12T08:37:41.166Z'+ role_id: role_UkLWZg9DAJ+ role_name: admin+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=Kubw9tCz1KTRjKA3i2YGajA3"+ invitee_exists: false+ store:+ id: store_UkLWZg9DAJ+ name: Spree Test Store+ requestBody:+ content:+ application/json:+ schema:+ type: object+ required:+ - role_id+ properties:+ email:+ type: string+ example: [email protected]+ role_id:+ type: string+ example: role_xxx+ "/api/v3/admin/invitations/{id}":+ delete:+ summary: Revoke an invitationtags:- - Settings+ - Staffsecurity:- api_key: []bearer_auth: []- description: |-- Returns every translatable resource type and its translatable fields (key + content type), so clients can render translation editors generically.+ description: "**Required scope:** `write_settings` (for API-key authentication)."+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'- **Required scope:** `read_settings` (for API-key authentication).+ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ await client.invitations.delete('inv_xxx')+ - lang: bash+ label: Spree CLI+ source: spree api delete /invitations/{id}parameters:- name: x-spree-api-keyin: header@@ -18571,88 +19818,41 @@ paths:required: trueschema:type: string+ - name: id+ in: path+ required: true+ schema:+ type: stringresponses:- '200':- description: translatable resources found- content:- application/json:- example:- data:- - resource_type: option_type- fields:- - key: label- type: string- readable: true- - resource_type: option_value- fields:- - key: label- type: string- readable: false- - resource_type: product- fields:- - key: name- type: string- - key: description- type: html- - key: slug- type: string- - key: meta_description- type: string- - key: meta_title- type: string- readable: true- - resource_type: category- fields:- - key: name- type: string- - key: pretty_name- type: string- - key: description- type: html- - key: permalink- type: string- readable: true- - resource_type: taxonomy- fields:- - key: name- type: string- readable: false- - resource_type: store- fields:- - key: name- type: string- - key: meta_description- type: string- - key: meta_keywords- type: string- - key: seo_title- type: string- - key: customer_support_email- type: string- - key: address- type: string- - key: contact_phone- type: string- readable: false- - resource_type: policy- fields:- - key: name- type: string- - key: body- type: html- readable: false- "/api/v3/admin/translations/batch":- post:- summary: Batch upsert translations+ '204':+ description: invitation revoked+ "/api/v3/admin/invitations/{id}/resend":+ patch:+ summary: Resend an invitationtags:- - Settings+ - Staffsecurity:- api_key: []bearer_auth: []description: |-- Atomically upserts translations across many records of (possibly) different translatable resource types in one request — e.g. an option type and all its option values in one save. A flat list of independent registry writes; all entries succeed or none do.+ Issues a fresh token and dispatches the invitation email again.- **Required scope:** `write_<resource>` for every resource type in the batch (for API-key authentication) (for API-key authentication).+ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const invitation = await client.invitations.resend('inv_xxx')+ - lang: bash+ label: Spree CLI+ source: spree api patch /invitations/{id}/resend -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -18664,92 +19864,41 @@ paths:required: trueschema:type: string+ - name: id+ in: path+ required: true+ schema:+ type: stringresponses:'200':- description: translations upserted- content:- application/json:- example:- data:- - resource_id: opt_UkLWZg9DAJ- resource_type: option_type- translations:- de:- label: Größe- translated_field_count: 1- fr:- label:- translated_field_count: 0- default_locale: en- supported_locales:- - de- - en- - fr- - resource_id: optval_UkLWZg9DAJ- resource_type: option_value- translations:- de:- label: Klein- translated_field_count: 1- fr:- label:- translated_field_count: 0- default_locale: en- supported_locales:- - de- - en- - fr- '422':- description: unsupported locale rolls back the whole batch+ description: invitation resentcontent:application/json:example:- error:- code: validation_error- message: 'Unsupported locale(s): es'- details:- translations:- '0':- - 'Unsupported locale(s): es'- requestBody:- content:- application/json:- schema:- type: object- required:- - translations- properties:- translations:- type: array- items:- type: object- required:- - resource_type- - resource_id- - values- properties:- resource_type:- type: string- description: Translatable resource type token, e.g. `option_type`- resource_id:- type: string- description: Prefixed id of the record- values:- type: object- description: 'Map of locale code to { field: value }'- additionalProperties:- type: object- additionalProperties: true- "/api/v3/admin/admin_users":+ id: inv_UkLWZg9DAJ+ email: [email protected]+ status: pending+ created_at: '2026-07-29T08:37:41.763Z'+ updated_at: '2026-07-29T08:37:41.763Z'+ expires_at: '2026-08-12T08:37:41.760Z'+ role_id: role_UkLWZg9DAJ+ role_name: admin+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=2sRHoNoCpZTDhDrxi6uiyKyM"+ invitee_exists: false+ store:+ id: store_UkLWZg9DAJ+ name: Spree Test Store+ "/api/v3/admin/roles":get:- summary: List staff+ summary: List rolestags:- Staffsecurity:- api_key: []bearer_auth: []description: |-- Returns admin users with at least one role assignment on the current store.+ Returns the roles available for staff role pickers. Roles are global, not per-store.**Required scope:** `read_settings` (for API-key authentication).x-codeSamples:@@ -18763,10 +19912,10 @@ paths:secretKey: 'sk_xxx',})- const { data: staff } = await client.adminUsers.list()+ const { data: roles } = await client.roles.list()- lang: bashlabel: Spree CLI- source: spree api get /admin_users+ source: spree api get /rolesparameters:- name: x-spree-api-keyin: header@@ -18780,27 +19929,15 @@ paths:type: stringresponses:'200':- description: staff found+ description: roles foundcontent:application/json:example:data:- - id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Dean- last_name: King- full_name: Dean King- selected_locale:- created_at: '2026-07-27T19:59:59.194Z'- updated_at: '2026-07-27T19:59:59.194Z'- avatar_url:- roles:- - id: role_UkLWZg9DAJ- name: admin- stores:- - id: store_UkLWZg9DAJ- name: Spree Test Store- code: spree_1+ - id: role_UkLWZg9DAJ+ name: admin+ created_at: '2026-07-29T08:38:42.570Z'+ updated_at: '2026-07-29T08:38:42.570Z'meta:page: 1limit: 25@@ -18811,15 +19948,28 @@ paths:in: 1previous:next:- "/api/v3/admin/admin_users/{id}":+ "/api/v3/admin/stock_locations":get:- summary: Show a staff member+ summary: List stock locationstags:- - Staff+ - Stock Locationssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `read_settings` (for API-key authentication)."+ description: |-+ Returns the configured stock locations. Stock locations are global+ (shared across stores). Filter with Ransack predicates such as+ `q[active_eq]`, `q[kind_eq]`, `q[pickup_enabled_eq]`, or+ `q[name_cont]`.++ Pickup-related attributes (`kind`, `pickup_enabled`,+ `pickup_stock_policy`, `pickup_ready_in_minutes`,+ `pickup_instructions`) drive merchant pickup support at checkout —+ customers can collect orders from any active location with+ `pickup_enabled: true`.+++ **Required scope:** `read_stock` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -18831,10 +19981,10 @@ paths:secretKey: 'sk_xxx',})- const staff = await client.adminUsers.get('admin_xxx')+ const { data: stockLocations } = await client.stockLocations.list()- lang: bashlabel: Spree CLI- source: spree api get /admin_users/{id}+ source: spree api get /stock_locationsparameters:- name: x-spree-api-keyin: header@@ -18844,46 +19994,136 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: string- - name: id- in: path- required: true+ - 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: stringresponses:'200':- description: staff member found+ description: stock locations foundcontent:application/json:example:- id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Pauline- last_name: Bergnaum- full_name: Pauline Bergnaum- selected_locale:- created_at: '2026-07-27T19:59:59.533Z'- updated_at: '2026-07-27T19:59:59.533Z'- avatar_url:- roles:- - id: role_UkLWZg9DAJ- name: admin- stores:- - id: store_UkLWZg9DAJ- name: Spree Test Store- code: spree_1- patch:- summary: Update a staff member+ data:+ - id: sloc_UkLWZg9DAJ+ state_abbr: STATE_ABBR_56+ name: Brooklyn warehouse+ address1: 1600 Pennsylvania Ave NW+ city: Washington+ zipcode: '20500'+ country_iso: US+ country_name: United States of America+ state_text: STATE_ABBR_56+ admin_name:+ address2:+ state_name:+ phone: "(202) 456-1111"+ company:+ active: true+ default: false+ backorderable_default: true+ propagate_all_variants: false+ kind: warehouse+ pickup_enabled: false+ pickup_stock_policy: local+ pickup_ready_in_minutes:+ pickup_instructions:+ created_at: '2026-07-29T08:38:42.855Z'+ updated_at: '2026-07-29T08:38:42.855Z'+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ 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:+ example:+ error:+ code: authentication_required+ message: Authentication required+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ post:+ summary: Create a stock locationtags:- - Staff+ - Stock Locationssecurity:- 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.+ Creates a new stock location.- **Required scope:** `write_settings` (for API-key authentication).+ Setting `default: true` automatically demotes the previous default+ location.+++ **Required scope:** `write_stock` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -18895,13 +20135,20 @@ paths:secretKey: 'sk_xxx',})- const staff = await client.adminUsers.update('admin_xxx', {- first_name: 'Ada',- role_ids: ['role_xxx']+ const stockLocation = await client.stockLocations.create({+ name: 'Brooklyn warehouse',+ kind: 'warehouse',+ country_iso: 'US',+ state_abbr: 'NY',+ city: 'Brooklyn',+ zipcode: '11201',+ pickup_enabled: true,+ pickup_stock_policy: 'local',+ pickup_ready_in_minutes: 60,})- lang: bashlabel: Spree CLI- source: spree api patch /admin_users/{id} -d '{"first_name":"Ada","role_ids":["role_xxx"]}'+ source: spree api post /stock_locations -d '{"name":"Brooklyn warehouse","kind":"warehouse","country_iso":"US","state_abbr":"NY","city":"Brooklyn","zipcode":"11201","pickup_enabled":true,"pickup_stock_policy":"local","pickup_ready_in_minutes":60}'parameters:- name: x-spree-api-keyin: header@@ -18911,62 +20158,154 @@ paths:- name: Authorizationin: headerrequired: true- schema:- type: string- - name: id- in: path- required: true+ description: Bearer token for admin authenticationschema:type: stringresponses:- '200':- description: staff member updated+ '201':+ description: stock location createdcontent:application/json:example:- id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Renamed- last_name: Dibbert- full_name: Renamed Dibbert- selected_locale:- created_at: '2026-07-27T19:59:59.836Z'- updated_at: '2026-07-27T19:59:59.858Z'- avatar_url:- roles:- - id: role_UkLWZg9DAJ- name: admin- stores:- - id: store_UkLWZg9DAJ- name: Spree Test Store- code: spree_1+ id: sloc_gbHJdmfrXB+ state_abbr:+ name: Manhattan store+ address1:+ city:+ zipcode:+ country_iso:+ country_name:+ state_text:+ admin_name:+ address2:+ state_name:+ phone:+ company:+ active: true+ default: false+ backorderable_default: false+ propagate_all_variants: false+ kind: store+ pickup_enabled: true+ pickup_stock_policy: local+ pickup_ready_in_minutes: 30+ pickup_instructions:+ created_at: '2026-07-29T08:38:43.421Z'+ updated_at: '2026-07-29T08:38:43.421Z'+ schema:+ "$ref": "#/components/schemas/StockLocation"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:schema:type: objectproperties:- first_name:+ name:+ type: string+ example: Brooklyn warehouse+ admin_name:+ type: string+ nullable: true+ description: Internal name shown only in the admin+ active:+ type: boolean+ example: true+ default:+ type: boolean+ description: Setting to true demotes the previous default.+ kind:+ type: string+ enum:+ - warehouse+ - store+ - fulfillment_center+ description: Categorizes the location.+ example: warehouse+ propagate_all_variants:+ type: boolean+ backorderable_default:+ type: boolean+ address1:+ type: string+ nullable: true+ address2:+ type: string+ nullable: true+ city:type: string- example: Ada- last_name:+ nullable: true+ zipcode:type: string- example: Lovelace- role_ids:- type: array- items:- type: string- delete:- summary: Remove a staff member from this store+ 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 locationtags:- - Staff+ - Stock Locationssecurity:- 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.+ Returns a single stock location by prefixed ID.- **Required scope:** `write_settings` (for API-key authentication).+ **Required scope:** `read_stock` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -18978,10 +20317,10 @@ paths:secretKey: 'sk_xxx',})- await client.adminUsers.delete('admin_xxx')+ const stockLocation = await client.stockLocations.get('sloc_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api delete /admin_users/{id}+ source: spree api get /stock_locations/{id}parameters:- name: x-spree-api-keyin: header@@ -18991,96 +20330,73 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema: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.-- **Required scope:** `read_settings` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const { data: invitations } = await client.invitations.list()- - lang: bash- label: Spree CLI- source: spree api get /invitations- parameters:- - name: x-spree-api-key- in: header- required: true- schema:- type: string- - name: Authorization- in: header- required: true+ - name: fields+ in: query+ required: false+ description: Comma-separated list of fields to include. id is always included.schema:type: stringresponses:'200':- description: invitations found+ description: stock location foundcontent:application/json:example:- data:- - id: inv_UkLWZg9DAJ- email: [email protected]- status: pending- created_at: '2026-07-27T20:00:40.233Z'- updated_at: '2026-07-27T20:00:40.233Z'- expires_at: '2026-08-10T20:00:40.227Z'- role_id: role_UkLWZg9DAJ- role_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=v8dYAmdtYLK9oGXRkXhxjpN8"- invitee_exists: false- store:- id: store_UkLWZg9DAJ- name: Spree Test Store- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- post:- summary: Create an invitation+ id: sloc_UkLWZg9DAJ+ state_abbr: STATE_ABBR_60+ name: Brooklyn warehouse+ address1: 1600 Pennsylvania Ave NW+ city: Washington+ zipcode: '20500'+ country_iso: US+ country_name: United States of America+ state_text: STATE_ABBR_60+ admin_name:+ address2:+ state_name:+ phone: "(202) 456-1111"+ company:+ active: true+ default: false+ backorderable_default: true+ propagate_all_variants: false+ kind: warehouse+ pickup_enabled: false+ pickup_stock_policy: local+ pickup_ready_in_minutes:+ pickup_instructions:+ created_at: '2026-07-29T08:38:43.710Z'+ updated_at: '2026-07-29T08:38:43.710Z'+ schema:+ "$ref": "#/components/schemas/StockLocation"+ '404':+ description: stock location not found+ content:+ application/json:+ example:+ error:+ code: record_not_found+ message: Stock location not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update a stock locationtags:- - Staff+ - Stock Locationssecurity:- 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.+ Updates an existing stock location. Same address-field conventions as+ the create endpoint.- **Required scope:** `write_settings` (for API-key authentication).+ Setting `default: true` automatically demotes the previous default.+++ **Required scope:** `write_stock` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19092,13 +20408,15 @@ paths:secretKey: 'sk_xxx',})- const invitation = await client.invitations.create({- email: '[email protected]',- role_id: 'role_xxx'+ const stockLocation = await client.stockLocations.update('sloc_UkLWZg9DAJ', {+ pickup_enabled: true,+ pickup_ready_in_minutes: 45,+ pickup_instructions: 'Enter through the back door, ring the bell.',})- lang: bashlabel: Spree CLI- source: spree api post /invitations -d '{"email":"[email protected]","role_id":"role_xxx"}'+ source: spree api patch /stock_locations/{id} -d '{"pickup_enabled":true,"pickup_ready_in_minutes":45,"pickup_instructions":"Enter+ through the back door, ring the bell."}'parameters:- name: x-spree-api-keyin: header@@ -19108,52 +20426,135 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: stringresponses:- '201':- description: invitation created+ '200':+ description: stock location updatedcontent:application/json:example:- id: inv_gbHJdmfrXB- email: [email protected]- status: pending- created_at: '2026-07-27T20:00:40.581Z'- updated_at: '2026-07-27T20:00:40.581Z'- expires_at: '2026-08-10T20:00:40.577Z'- role_id: role_UkLWZg9DAJ- role_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=imsi6bATMRCejdokMfCiwnLd"- invitee_exists: false- store:- id: store_UkLWZg9DAJ- name: Spree Test Store+ id: sloc_UkLWZg9DAJ+ state_abbr: STATE_ABBR_62+ name: Renamed warehouse+ address1: 1600 Pennsylvania Ave NW+ city: Washington+ zipcode: '20500'+ country_iso: US+ country_name: United States of America+ state_text: STATE_ABBR_62+ admin_name:+ address2:+ state_name:+ phone: "(202) 456-1111"+ company:+ active: true+ default: false+ backorderable_default: true+ propagate_all_variants: false+ kind: warehouse+ pickup_enabled: true+ pickup_stock_policy: local+ pickup_ready_in_minutes: 45+ pickup_instructions:+ created_at: '2026-07-29T08:38:44.278Z'+ updated_at: '2026-07-29T08:38:44.558Z'+ schema:+ "$ref": "#/components/schemas/StockLocation"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Pickup stock policy is not included in the list+ details:+ pickup_stock_policy:+ - is not included in the list+ schema:+ "$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:schema:type: object- required:- - role_idproperties:- email:+ name:+ type: string+ admin_name:+ type: string+ nullable: true+ active:+ type: boolean+ default:+ type: boolean+ kind:type: string- example: [email protected]- role_id:+ enum:+ - warehouse+ - store+ - fulfillment_center+ propagate_all_variants:+ type: boolean+ backorderable_default:+ type: boolean+ address1:type: string- example: role_xxx- "/api/v3/admin/invitations/{id}":+ 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: truedelete:- summary: Revoke an invitation+ summary: Delete a stock locationtags:- - Staff+ - Stock Locationssecurity:- api_key: []bearer_auth: []- description: "**Required scope:** `write_settings` (for API-key authentication)."+ description: |-+ Soft-deletes the stock location (sets `deleted_at`). Existing+ fulfillments that referenced it keep the historical record via+ `Spree::StockLocation.with_deleted`.+++ **Required scope:** `write_stock` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19165,10 +20566,10 @@ paths:secretKey: 'sk_xxx',})- await client.invitations.delete('inv_xxx')+ await client.stockLocations.delete('sloc_UkLWZg9DAJ')- lang: bashlabel: Spree CLI- source: spree api delete /invitations/{id}+ source: spree api delete /stock_locations/{id}parameters:- name: x-spree-api-keyin: header@@ -19178,28 +20579,24 @@ paths:- name: Authorizationin: headerrequired: true- schema:- type: string- - name: id- in: path- required: true+ description: Bearer token for admin authenticationschema:type: stringresponses:'204':- description: invitation revoked- "/api/v3/admin/invitations/{id}/resend":- patch:- summary: Resend an invitation+ description: stock location deleted+ "/api/v3/admin/products/{product_id}/variants":+ get:+ summary: List product variantstags:- - Staff+ - Variantssecurity:- api_key: []bearer_auth: []description: |-- Issues a fresh token and dispatches the invitation email again.+ Returns a paginated list of variants for a product, including the default variant.- **Required scope:** `write_settings` (for API-key authentication).+ **Required scope:** `read_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19211,10 +20608,12 @@ paths:secretKey: 'sk_xxx',})- const invitation = await client.invitations.resend('inv_xxx')+ const { data: variants } = await client.products.variants.list('prod_86Rf07xd4z', {+ expand: ['prices', 'stock_items'],+ })- lang: bashlabel: Spree CLI- source: spree api patch /invitations/{id}/resend -d '{ ... }'+ source: spree api get /products/{product_id}/variants -d '{"expand":["prices","stock_items"]}'parameters:- name: x-spree-api-keyin: header@@ -19224,114 +20623,175 @@ paths:- name: Authorizationin: headerrequired: true+ description: Bearer token for admin authenticationschema:type: string- - name: id+ - name: product_idin: pathrequired: true+ description: Product IDschema:type: string- responses:- '200':- description: invitation resent- content:- application/json:- example:- id: inv_UkLWZg9DAJ- email: [email protected]- status: pending- created_at: '2026-07-27T20:00:41.168Z'- updated_at: '2026-07-27T20:00:41.168Z'- expires_at: '2026-08-10T20:00:41.166Z'- role_id: role_UkLWZg9DAJ- role_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=1gxEHnAgHyTVekF6SdcT9ji3"- invitee_exists: false- store:- id: store_UkLWZg9DAJ- name: Spree Test Store- "/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.-- **Required scope:** `read_settings` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const { data: roles } = await client.roles.list()- - lang: bash- label: Spree CLI- source: spree api get /roles- parameters:- - name: x-spree-api-key- in: header- required: true+ - 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: Authorization- in: header- required: true+ - 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: stringresponses:'200':- description: roles found+ description: variants foundcontent:application/json:example:data:- - id: role_UkLWZg9DAJ- name: admin- created_at: '2026-07-27T20:01:38.681Z'- updated_at: '2026-07-27T20:01:38.681Z'+ - id: variant_UkLWZg9DAJ+ product_id: prod_UkLWZg9DAJ+ sku: SKU-114+ options_text: ''+ track_inventory: true+ media_count: 0+ preorder_ships_at:+ thumbnail_url:+ purchasable: true+ in_stock: false+ backorderable: true+ preorder: false+ weight: 0.0+ height:+ width:+ depth:+ price:+ id: price_UkLWZg9DAJ+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ original_price:+ option_values: []+ metadata: {}+ position: 1+ cost_price: '17.0'+ cost_currency: USD+ barcode:+ weight_unit: lb+ dimensions_unit:+ backorder_limit:+ deleted_at:+ created_at: '2026-07-29T08:38:49.018Z'+ updated_at: '2026-07-29T08:38:49.028Z'+ preorderable: false+ tax_category_id: taxcat_UkLWZg9DAJ+ available_stock: 0+ reserved_quantity: 0+ total_on_hand: 0+ product_name: Product 959049+ - id: variant_gbHJdmfrXB+ product_id: prod_UkLWZg9DAJ+ sku: SKU-115+ options_text: 'Size: S'+ track_inventory: true+ media_count: 0+ preorder_ships_at:+ thumbnail_url:+ purchasable: true+ in_stock: false+ backorderable: true+ preorder: false+ weight: 52.81+ height: 126.92+ width: 19.4+ depth: 171.61+ price:+ id: price_gbHJdmfrXB+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ original_price:+ option_values:+ - id: optval_UkLWZg9DAJ+ option_type_id: opt_UkLWZg9DAJ+ name: size-19+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-28+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:49.043Z'+ updated_at: '2026-07-29T08:38:49.043Z'+ metadata: {}+ position: 2+ cost_price: '17.0'+ cost_currency: USD+ barcode:+ weight_unit: lb+ dimensions_unit:+ backorder_limit:+ deleted_at:+ created_at: '2026-07-29T08:38:49.041Z'+ updated_at: '2026-07-29T08:38:49.051Z'+ preorderable: false+ tax_category_id: taxcat_UkLWZg9DAJ+ available_stock: 0+ reserved_quantity: 0+ total_on_hand: 0+ product_name: Product 959049meta:page: 1limit: 25- count: 1+ count: 2pages: 1from: 1- to: 1- in: 1+ to: 2+ in: 2previous:next:- "/api/v3/admin/stock_locations":- get:- summary: List stock locations+ post:+ summary: Create a varianttags:- - Stock Locations+ - Variantssecurity:- api_key: []bearer_auth: []description: |-- Returns the configured stock locations. Stock locations are global- (shared across stores). Filter with Ransack predicates such as- `q[active_eq]`, `q[kind_eq]`, `q[pickup_enabled_eq]`, or- `q[name_cont]`.+ Creates a new variant for a product. Supports nested prices and stock items.- Pickup-related attributes (`kind`, `pickup_enabled`,- `pickup_stock_policy`, `pickup_ready_in_minutes`,- `pickup_instructions`) drive merchant pickup support at checkout —- customers can collect orders from any active location with- `pickup_enabled: true`.+ Option types and values are auto-created if they don't exist.+ Prices are upserted by currency. Stock items are upserted by stock location.- **Required scope:** `read_stock` (for API-key authentication).+ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19343,10 +20803,21 @@ paths:secretKey: 'sk_xxx',})- const { data: stockLocations } = await client.stockLocations.list()+ const variant = await client.products.variants.create('prod_86Rf07xd4z', {+ sku: 'TSHIRT-L-NAVY',+ options: [+ { name: 'size', value: 'Large' },+ { name: 'color', value: 'navy' },+ ],+ prices: [+ { currency: 'USD', amount: '29.99', compare_at_amount: '34.99' },+ { currency: 'EUR', amount: '27.99' },+ ],+ stock_items: [{ stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 25 }],+ })- lang: bashlabel: Spree CLI- source: spree api get /stock_locations+ source: spree api post /products/{product_id}/variants -d '{"sku":"TSHIRT-L-NAVY","options":[{"name":"size","value":"Large"},{"name":"color","value":"navy"}],"prices":[{"currency":"USD","amount":"29.99","compare_at_amount":"34.99"},{"currency":"EUR","amount":"27.99"}],"stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":25}]}'parameters:- name: x-spree-api-keyin: header@@ -19359,133 +20830,188 @@ paths:description: Bearer token for admin authenticationschema: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.+ - name: product_id+ in: path+ required: true+ description: Product IDschema:type: stringresponses:- '200':- description: stock locations found+ '201':+ description: variant createdcontent:application/json:example:- data:- - id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_50- name: Brooklyn warehouse- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: STATE_ABBR_50- admin_name:- address2:- state_name:- phone: "(202) 456-1111"- company:- active: true- default: false- backorderable_default: true- propagate_all_variants: false- kind: warehouse- pickup_enabled: false- pickup_stock_policy: local- pickup_ready_in_minutes:- pickup_instructions:- created_at: '2026-07-27T20:01:38.982Z'- updated_at: '2026-07-27T20:01:38.982Z'- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- schema:- type: object- properties:- data:- type: array- items:- "$ref": "#/components/schemas/StockLocation"- meta:- "$ref": "#/components/schemas/PaginationMeta"- required:- - data- - meta- '401':- description: unauthorized+ id: variant_EfhxLZ9ck8+ product_id: prod_UkLWZg9DAJ+ sku: NEW-SKU-001+ options_text: 'Size: XL'+ track_inventory: true+ media_count: 0+ preorder_ships_at:+ thumbnail_url:+ purchasable: false+ in_stock: false+ backorderable: false+ preorder: false+ weight: 0.0+ height:+ width:+ depth:+ price:+ id: price_EfhxLZ9ck8+ amount: '24.99'+ amount_in_cents: 2499+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$24.99"+ display_compare_at_amount:+ price_list_id:+ original_price:+ option_values:+ - id: optval_gbHJdmfrXB+ option_type_id: opt_gbHJdmfrXB+ name: xl+ label: XL+ position: 1+ color_code:+ option_type_name: size+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:49.691Z'+ updated_at: '2026-07-29T08:38:49.691Z'+ metadata: {}+ position: 3+ cost_price:+ cost_currency: USD+ barcode:+ weight_unit: lb+ dimensions_unit:+ backorder_limit:+ deleted_at:+ created_at: '2026-07-29T08:38:49.696Z'+ updated_at: '2026-07-29T08:38:49.698Z'+ preorderable: false+ tax_category_id: taxcat_UkLWZg9DAJ+ available_stock: 0+ reserved_quantity: 0+ total_on_hand: 0+ product_name: Product 968182+ '422':+ description: validation errorcontent:application/json:example:error:- code: authentication_required- message: Authentication required+ code: validation_error+ message: SKU has already been taken+ details:+ sku:+ - has already been takenschema:"$ref": "#/components/schemas/ErrorResponse"- post:- summary: Create a stock location+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ sku:+ type: string+ example: SKU-001+ cost_price:+ type: string+ example: '10.00'+ cost_currency:+ type: string+ example: USD+ 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: A variant on a product with option types should declare+ its option pairs (e.g. size + color) — one per option type it+ participates in. Option types and values are auto-created if missing.+ items:+ type: object+ required:+ - name+ - value+ properties:+ name:+ type: string+ example: size+ value:+ type: string+ example: Small+ 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+ example: USD+ amount:+ type: string+ example: '29.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '39.99'+ 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+ example: 50+ backorderable:+ type: boolean+ "/api/v3/admin/products/{product_id}/variants/{id}":+ get:+ summary: Get a varianttags:- - Stock Locations+ - Variantssecurity:- api_key: []bearer_auth: []description: |-- Creates a new stock location.-- Setting `default: true` automatically demotes the previous default- location.-+ Returns a single variant by ID.- **Required scope:** `write_stock` (for API-key authentication).+ **Required scope:** `read_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19497,20 +21023,12 @@ paths:secretKey: 'sk_xxx',})- const stockLocation = await client.stockLocations.create({- name: 'Brooklyn warehouse',- kind: 'warehouse',- country_iso: 'US',- state_abbr: 'NY',- city: 'Brooklyn',- zipcode: '11201',- pickup_enabled: true,- pickup_stock_policy: 'local',- pickup_ready_in_minutes: 60,+ const variant = await client.products.variants.get('prod_86Rf07xd4z', 'variant_k5nR8xLq', {+ expand: ['prices', 'stock_items'],})- lang: bashlabel: Spree CLI- source: spree api post /stock_locations -d '{"name":"Brooklyn warehouse","kind":"warehouse","country_iso":"US","state_abbr":"NY","city":"Brooklyn","zipcode":"11201","pickup_enabled":true,"pickup_stock_policy":"local","pickup_ready_in_minutes":60}'+ source: spree api get /products/{product_id}/variants/{id} -d '{"expand":["prices","stock_items"]}'parameters:- name: x-spree-api-keyin: header@@ -19523,151 +21041,116 @@ paths:description: Bearer token for admin authenticationschema: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: stringresponses:- '201':- description: stock location created- content:- application/json:- example:- id: sloc_gbHJdmfrXB- state_abbr:- name: Manhattan store- address1:- city:- zipcode:- country_iso:- country_name:- state_text:- admin_name:- address2:- state_name:- phone:- company:- active: true- default: false- backorderable_default: false- propagate_all_variants: false- kind: store- pickup_enabled: true- pickup_stock_policy: local- pickup_ready_in_minutes: 30- pickup_instructions:- created_at: '2026-07-27T20:01:39.576Z'- updated_at: '2026-07-27T20:01:39.576Z'- schema:- "$ref": "#/components/schemas/StockLocation"- '422':- description: validation error+ '200':+ description: variant foundcontent:application/json:example:- error:- code: validation_error- message: Name can't be blank- details:- name:- - can't be blank- schema:- "$ref": "#/components/schemas/ErrorResponse"- requestBody:- content:- application/json:- schema:- type: object- properties:- name:- type: string- example: Brooklyn warehouse- admin_name:- type: string- nullable: true- description: Internal name shown only in the admin- active:- type: boolean- example: true- default:- type: boolean- description: Setting to true demotes the previous default.- kind:- type: string- enum:- - warehouse- - store- - fulfillment_center- description: Categorizes the location.- example: warehouse- 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+ id: variant_gbHJdmfrXB+ product_id: prod_UkLWZg9DAJ+ sku: SKU-121+ options_text: 'Size: S'+ track_inventory: true+ media_count: 0+ preorder_ships_at:+ thumbnail_url:+ purchasable: true+ in_stock: false+ backorderable: true+ preorder: false+ weight: 143.82+ height: 162.47+ width: 138.57+ depth: 125.77+ price:+ id: price_gbHJdmfrXB+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ original_price:+ option_values:+ - id: optval_UkLWZg9DAJ+ option_type_id: opt_UkLWZg9DAJ+ name: size-22+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-31+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:50.093Z'+ updated_at: '2026-07-29T08:38:50.093Z'+ metadata: {}+ position: 2+ cost_price: '17.0'+ cost_currency: USD+ barcode:+ weight_unit: lb+ dimensions_unit:+ backorder_limit:+ deleted_at:+ created_at: '2026-07-29T08:38:50.091Z'+ updated_at: '2026-07-29T08:38:50.099Z'+ preorderable: false+ tax_category_id: taxcat_UkLWZg9DAJ+ available_stock: 0+ reserved_quantity: 0+ total_on_hand: 0+ product_name: Product 987470+ '404':+ description: variant not found+ content:+ application/json:+ example:+ error:+ code: variant_not_found+ message: Variant not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ patch:+ summary: Update a varianttags:- - Stock Locations+ - Variantssecurity:- api_key: []bearer_auth: []description: |-- Returns a single stock location by prefixed ID.+ Updates a variant. Only provided fields are updated.- **Required scope:** `read_stock` (for API-key authentication).+ **Required scope:** `write_products` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19679,10 +21162,15 @@ paths:secretKey: 'sk_xxx',})- const stockLocation = await client.stockLocations.get('sloc_UkLWZg9DAJ')+ const variant = await client.products.variants.update('prod_86Rf07xd4z', 'variant_k5nR8xLq', {+ sku: 'UPDATED-SKU',+ stock_items: [+ { stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 75 },+ ],+ })- lang: bashlabel: Spree CLI- source: spree api get /stock_locations/{id}+ source: spree api patch /products/{product_id}/variants/{id} -d '{"sku":"UPDATED-SKU","stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":75}]}'parameters:- name: x-spree-api-keyin: header@@ -19695,70 +21183,246 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: fields- in: query- required: false- description: Comma-separated list of fields to include. id is always included.+ - name: product_id+ in: path+ required: true+ description: Product ID+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Variant IDschema:type: stringresponses:'200':- description: stock location found- content:- application/json:- example:- id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_54- name: Brooklyn warehouse- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: STATE_ABBR_54- admin_name:- address2:- state_name:- phone: "(202) 456-1111"- company:- active: true- default: false- backorderable_default: true- propagate_all_variants: false- kind: warehouse- pickup_enabled: false- pickup_stock_policy: local- pickup_ready_in_minutes:- pickup_instructions:- created_at: '2026-07-27T20:01:39.872Z'- updated_at: '2026-07-27T20:01:39.872Z'- schema:- "$ref": "#/components/schemas/StockLocation"- '404':- description: stock location not found+ description: variant updatedcontent:application/json:example:- error:- code: record_not_found- message: Stock location not found- schema:- "$ref": "#/components/schemas/ErrorResponse"- patch:- summary: Update a stock location+ id: variant_gbHJdmfrXB+ product_id: prod_UkLWZg9DAJ+ sku: UPDATED-SKU+ options_text: 'Size: S'+ track_inventory: true+ media_count: 0+ preorder_ships_at:+ thumbnail_url:+ purchasable: true+ in_stock: false+ backorderable: true+ preorder: false+ weight: 195.66+ height: 41.75+ width: 163.44+ depth: 152.75+ price:+ id: price_gbHJdmfrXB+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ original_price:+ option_values:+ - id: optval_UkLWZg9DAJ+ option_type_id: opt_UkLWZg9DAJ+ name: size-24+ label: S+ position: 1+ color_code:+ option_type_name: foo-size-33+ option_type_label: Size+ image_url:+ metadata: {}+ created_at: '2026-07-29T08:38:50.791Z'+ updated_at: '2026-07-29T08:38:50.791Z'+ metadata: {}+ position: 2+ cost_price: '17.0'+ cost_currency: USD+ barcode:+ weight_unit: lb+ dimensions_unit:+ backorder_limit:+ deleted_at:+ created_at: '2026-07-29T08:38:50.788Z'+ updated_at: '2026-07-29T08:38:51.087Z'+ preorderable: false+ tax_category_id: taxcat_UkLWZg9DAJ+ available_stock: 0+ reserved_quantity: 0+ total_on_hand: 0+ product_name: Product 1009647+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ sku:+ type: string+ example: SKU-001+ cost_price:+ type: string+ example: '10.00'+ cost_currency:+ type: string+ example: USD+ 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+ example: size+ value:+ type: string+ example: Small+ 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+ example: USD+ amount:+ type: string+ example: '29.99'+ compare_at_amount:+ type: string+ nullable: true+ example: '39.99'+ 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+ example: 50+ backorderable:+ type: boolean+ delete:+ summary: Delete a variant+ tags:+ - Variants+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Soft-deletes a variant.++ **Required scope:** `write_products` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ await client.products.variants.delete('prod_86Rf07xd4z', 'variant_k5nR8xLq')+ - lang: bash+ label: Spree CLI+ source: spree api delete /products/{product_id}/variants/{id}+ 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 deliveriestags:- - Stock Locations+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Updates an existing stock location. Same address-field conventions as- the create endpoint.-- Setting `default: true` automatically demotes the previous default.+ Returns delivery attempts for the given endpoint, most recent first.+ Each row carries the original request payload, the response code+ (when the receiver replied), the execution time, and any transport+ error — everything needed to audit failures and decide whether to+ redeliver.- **Required scope:** `write_stock` (for API-key authentication).+ **Required scope:** `read_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19770,15 +21434,10 @@ paths:secretKey: 'sk_xxx',})- const stockLocation = await client.stockLocations.update('sloc_UkLWZg9DAJ', {- pickup_enabled: true,- pickup_ready_in_minutes: 45,- pickup_instructions: 'Enter through the back door, ring the bell.',- })+ const deliveries = await client.webhookEndpoints.deliveries.list('whe_xxx')- lang: bashlabel: Spree CLI- source: spree api patch /stock_locations/{id} -d '{"pickup_enabled":true,"pickup_ready_in_minutes":45,"pickup_instructions":"Enter- through the back door, ring the bell."}'+ source: spree api get /webhook_endpoints/{webhook_endpoint_id}/deliveriesparameters:- name: x-spree-api-keyin: header@@ -19791,132 +21450,133 @@ paths:description: Bearer token for admin authenticationschema: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: stringresponses:'200':- description: stock location updated+ description: deliveries foundcontent:application/json:example:- id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_56- name: Renamed warehouse- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: STATE_ABBR_56- admin_name:- address2:- state_name:- phone: "(202) 456-1111"- company:- active: true- default: false- backorderable_default: true- propagate_all_variants: false- kind: warehouse- pickup_enabled: true- pickup_stock_policy: local- pickup_ready_in_minutes: 45- pickup_instructions:- created_at: '2026-07-27T20:01:40.444Z'- updated_at: '2026-07-27T20:01:40.721Z'- schema:- "$ref": "#/components/schemas/StockLocation"- '422':- description: validation error+ data:+ - id: whd_gbHJdmfrXB+ event_name: order.created+ event_id:+ response_code: 500+ execution_time: 200+ error_type:+ request_errors:+ response_body:+ success: false+ created_at: '2026-07-29T08:38:51.539Z'+ updated_at: '2026-07-29T08:38:51.539Z'+ delivered_at: '2026-07-29T08:38:51.539Z'+ payload:+ event: order.created+ data:+ id: 1+ webhook_endpoint_id: whe_UkLWZg9DAJ+ webhook_endpoint_url: https://shop.example.com/webhooks+ - id: whd_UkLWZg9DAJ+ event_name: order.created+ event_id:+ response_code: 200+ execution_time: 150+ error_type:+ request_errors:+ response_body:+ success: true+ created_at: '2026-07-29T08:38:51.538Z'+ updated_at: '2026-07-29T08:38:51.538Z'+ delivered_at: '2026-07-29T08:38:51.538Z'+ payload:+ event: order.created+ data:+ id: 1+ webhook_endpoint_id: whe_UkLWZg9DAJ+ webhook_endpoint_url: https://shop.example.com/webhooks+ meta:+ page: 1+ limit: 25+ count: 2+ pages: 1+ from: 1+ to: 2+ in: 2+ previous:+ next:+ '404':+ description: parent webhook endpoint not foundcontent:application/json:example:error:- code: validation_error- message: Pickup stock policy is not included in the list- details:- pickup_stock_policy:- - is not included in the list+ code: record_not_found+ message: Webhook endpoint not foundschema:"$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+ "/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 deliverytags:- - Stock Locations+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Soft-deletes the stock location (sets `deleted_at`). Existing- fulfillments that referenced it keep the historical record via- `Spree::StockLocation.with_deleted`.+ Returns a single delivery attempt with the full request payload and+ the response body the receiver returned. Use this for ad-hoc debug+ of failed deliveries.- **Required scope:** `write_stock` (for API-key authentication).+ **Required scope:** `read_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19928,10 +21588,10 @@ paths:secretKey: 'sk_xxx',})- await client.stockLocations.delete('sloc_UkLWZg9DAJ')+ const delivery = await client.webhookEndpoints.deliveries.get('whe_xxx', 'whd_xxx')- lang: bashlabel: Spree CLI- source: spree api delete /stock_locations/{id}+ source: spree api get /webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}parameters:- name: x-spree-api-keyin: header@@ -19944,21 +21604,73 @@ paths:description: Bearer token for admin authenticationschema:type: string+ - name: fields+ in: query+ required: false+ description: Comma-separated list of fields to include. id is always included.+ schema:+ type: stringresponses:- '204':- description: stock location deleted- "/api/v3/admin/products/{product_id}/variants":- get:- summary: List product variants+ '200':+ description: delivery found+ content:+ application/json:+ example:+ id: whd_gbHJdmfrXB+ event_name: order.created+ event_id:+ response_code: 500+ execution_time: 200+ error_type:+ request_errors:+ response_body:+ success: false+ created_at: '2026-07-29T08:38:52.194Z'+ updated_at: '2026-07-29T08:38:52.194Z'+ delivered_at: '2026-07-29T08:38:52.194Z'+ payload:+ event: order.created+ data:+ id: 1+ webhook_endpoint_id: whe_UkLWZg9DAJ+ webhook_endpoint_url: https://shop.example.com/webhooks+ '404':+ description: delivery not found+ content:+ application/json:+ example:+ error:+ code: record_not_found+ message: Webhook delivery not found+ 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 deliverytags:- - Variants+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Returns a paginated list of variants for a product, including the master variant.+ Creates a new delivery row with the same payload + event_name and+ queues it. The original row is preserved for audit history.- **Required scope:** `read_products` (for API-key authentication).++ **Required scope:** `write_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -19970,12 +21682,13 @@ paths:secretKey: 'sk_xxx',})- const { data: variants } = await client.products.variants.list('prod_86Rf07xd4z', {- expand: ['prices', 'stock_items'],- })+ // Creates a new delivery row with the same payload + event_name and queues+ // it. The original row is preserved for audit history.+ const delivery = await client.webhookEndpoints.deliveries.redeliver('whe_xxx', 'whd_xxx')- lang: bashlabel: Spree CLI- source: spree api get /products/{product_id}/variants -d '{"expand":["prices","stock_items"]}'+ source: spree api post /webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}/redeliver+ -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -19988,10 +21701,71 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: product_id- in: path+ responses:+ '201':+ description: redelivery queued+ content:+ application/json:+ example:+ id: whd_EfhxLZ9ck8+ event_name: order.created+ event_id:+ response_code:+ execution_time:+ error_type:+ request_errors:+ response_body:+ success:+ created_at: '2026-07-29T08:38:53.180Z'+ updated_at: '2026-07-29T08:38:53.180Z'+ delivered_at:+ payload:+ event: order.created+ data:+ id: 1+ webhook_endpoint_id: whe_UkLWZg9DAJ+ webhook_endpoint_url: https://shop.example.com/webhooks+ "/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+ endpoint receives a signed POST when any subscribed event fires.+ `secret_key` is `null` on list reads — the plaintext is delivered+ exactly once on create.+++ **Required scope:** `read_webhooks` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const endpoints = await client.webhookEndpoints.list()+ - lang: bash+ label: Spree CLI+ source: spree api get /webhook_endpoints+ parameters:+ - name: x-spree-api-key+ in: headerrequired: true- description: Product ID+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ description: Bearer token for admin authenticationschema:type: string- name: page@@ -20006,154 +21780,92 @@ paths:description: Number of records per pageschema: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+ - name: q[name_cont]in: queryrequired: 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:- example:- data:- - id: variant_UkLWZg9DAJ- product_id: prod_UkLWZg9DAJ- sku: SKU-103- options_text: ''- track_inventory: true- media_count: 0- preorder_ships_at:- thumbnail_url:- purchasable: false- in_stock: false- backorderable: false- preorder: false- weight: 0.0- height:- width:- depth:- price:- id:- amount:- amount_in_cents: 0- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$0.00"- display_compare_at_amount:- price_list_id:- original_price:- option_values: []- metadata: {}- position: 1- cost_price: '17.0'- cost_currency: USD- barcode:- weight_unit: lb- dimensions_unit:- backorder_limit:- deleted_at:- created_at: '2026-07-27T20:01:45.101Z'- updated_at: '2026-07-27T20:01:45.109Z'- preorderable: false- tax_category_id: taxcat_UkLWZg9DAJ- available_stock: 0- reserved_quantity: 0- total_on_hand: 0- product_name: Product 8414- - id: variant_gbHJdmfrXB- product_id: prod_UkLWZg9DAJ- sku: SKU-104- options_text: 'Size: S'- track_inventory: true- media_count: 0- preorder_ships_at:- thumbnail_url:- purchasable: true- in_stock: false- backorderable: true- preorder: false- weight: 179.91- height: 136.1- width: 137.55- depth: 198.67- price:- id: price_gbHJdmfrXB- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- original_price:- option_values:- - id: optval_UkLWZg9DAJ- option_type_id: opt_UkLWZg9DAJ- name: size-19- label: S- position: 1- color_code:- option_type_name: foo-size-28- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:01:45.123Z'- updated_at: '2026-07-27T20:01:45.123Z'- metadata: {}- position: 2- cost_price: '17.0'- cost_currency: USD- barcode:- weight_unit: lb- dimensions_unit:- backorder_limit:- deleted_at:- created_at: '2026-07-27T20:01:45.121Z'- updated_at: '2026-07-27T20:01:45.131Z'- preorderable: false- tax_category_id: taxcat_UkLWZg9DAJ- available_stock: 0- reserved_quantity: 0- total_on_hand: 0- product_name: Product 8414+ 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:+ example:+ data:+ - id: whe_UkLWZg9DAJ+ name: Order pipeline+ url: https://shop.example.com/webhooks/orders+ active: true+ subscriptions:+ - order.created+ - order.completed+ - product.created+ disabled_reason:+ created_at: '2026-07-29T08:38:53.213Z'+ updated_at: '2026-07-29T08:38:53.213Z'+ disabled_at:+ secret_key:+ last_delivery_at:+ recent_delivery_count: 0+ recent_failure_count: 0+ total_delivery_count: 0+ successful_delivery_count: 0+ failed_delivery_count: 0meta:page: 1limit: 25- count: 2+ count: 1pages: 1from: 1- to: 2- in: 2+ to: 1+ in: 1previous:next:+ '401':+ description: unauthorized+ content:+ application/json:+ example:+ error:+ code: authentication_required+ message: Authentication required+ schema:+ "$ref": "#/components/schemas/ErrorResponse"post:- summary: Create a variant+ summary: Create a webhook endpointtags:- - Variants+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Creates a new variant for a product. Supports nested prices and stock items.-- Option types and values are auto-created if they don't exist.- Prices are upserted by currency. Stock items are upserted by stock location.+ Creates a new outbound webhook subscription. The plaintext+ `secret_key` is returned **once** in this response — persist it+ immediately to verify incoming webhook signatures. Subsequent reads+ return `null` for the secret. Pass an empty `subscriptions` array or+ omit it to receive every event.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `write_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -20165,21 +21877,20 @@ paths:secretKey: 'sk_xxx',})- const variant = await client.products.variants.create('prod_86Rf07xd4z', {- sku: 'TSHIRT-L-NAVY',- options: [- { name: 'size', value: 'Large' },- { name: 'color', value: 'navy' },- ],- prices: [- { currency: 'USD', amount: '29.99', compare_at_amount: '34.99' },- { currency: 'EUR', amount: '27.99' },- ],- stock_items: [{ stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 25 }],+ const endpoint = await client.webhookEndpoints.create({+ name: 'Order pipeline',+ url: 'https://example.com/webhooks/orders',+ active: true,+ subscriptions: ['order.completed', 'order.canceled'],})++ // The plaintext `secret_key` is returned exactly once on create — persist it+ // immediately so you can verify incoming webhook signatures. Subsequent reads+ // will return `null`.+ const signingSecret = endpoint.secret_key- lang: bashlabel: Spree CLI- source: spree api post /products/{product_id}/variants -d '{"sku":"TSHIRT-L-NAVY","options":[{"name":"size","value":"Large"},{"name":"color","value":"navy"}],"prices":[{"currency":"USD","amount":"29.99","compare_at_amount":"34.99"},{"currency":"EUR","amount":"27.99"}],"stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":25}]}'+ source: spree api post /webhook_endpoints -d '{"name":"Order pipeline","url":"https://example.com/webhooks/orders","active":true,"subscriptions":["order.completed","order.canceled"]}'parameters:- name: x-spree-api-keyin: header@@ -20192,75 +21903,29 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: product_id- in: path- required: true- description: Product ID- schema:- type: stringresponses:'201':- description: variant created+ description: webhook endpoint created — secret_key returned oncecontent:application/json:example:- id: variant_EfhxLZ9ck8- product_id: prod_UkLWZg9DAJ- sku: NEW-SKU-001- options_text: 'Size: XL'- track_inventory: true- media_count: 0- preorder_ships_at:- thumbnail_url:- purchasable: false- in_stock: false- backorderable: false- preorder: false- weight: 0.0- height:- width:- depth:- price:- id: price_EfhxLZ9ck8- amount: '24.99'- amount_in_cents: 2499- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$24.99"- display_compare_at_amount:- price_list_id:- original_price:- option_values:- - id: optval_gbHJdmfrXB- option_type_id: opt_gbHJdmfrXB- name: xl- label: XL- position: 1- color_code:- option_type_name: size- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:01:45.783Z'- updated_at: '2026-07-27T20:01:45.783Z'- metadata: {}- position: 3- cost_price:- cost_currency: USD- barcode:- weight_unit: lb- dimensions_unit:- backorder_limit:- deleted_at:- created_at: '2026-07-27T20:01:45.786Z'- updated_at: '2026-07-27T20:01:45.788Z'- preorderable: false- tax_category_id: taxcat_UkLWZg9DAJ- available_stock: 0- reserved_quantity: 0- total_on_hand: 0- product_name: Product 852654+ id: whe_gbHJdmfrXB+ name: CI integration+ url: https://ci.example.com/webhooks+ active: true+ subscriptions:+ - order.completed+ disabled_reason:+ created_at: '2026-07-29T08:38:53.975Z'+ updated_at: '2026-07-29T08:38:53.975Z'+ disabled_at:+ secret_key: b593e6e809044796fa4eed5f5557bcdfe1ab113262c9b2450884dacea427e2a5+ last_delivery_at:+ recent_delivery_count: 0+ recent_failure_count: 0+ total_delivery_count: 0+ successful_delivery_count: 0+ failed_delivery_count: 0'422':description: validation errorcontent:@@ -20268,115 +21933,67 @@ paths:example:error:code: validation_error- message: Option value variants can't be blank+ message: |-+ Url Translation missing. Options considered were:+ - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url+ - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url+ - en.activerecord.errors.messages.invalid_url+ - en.errors.attributes.url.invalid_url+ - en.errors.messages.invalid_urldetails:- option_value_variants:- - can't be blank+ url:+ - |-+ Translation missing. Options considered were:+ - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url+ - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url+ - en.activerecord.errors.messages.invalid_url+ - en.errors.attributes.url.invalid_url+ - en.errors.messages.invalid_urlschema:"$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:- schema:- type: object- required:- - options- properties:- sku:- type: string- example: SKU-001- cost_price:- type: string- example: '10.00'- cost_currency:- type: string- example: USD- 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- example: size- value:- type: string- example: Small- 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- example: USD- amount:- type: string- example: '29.99'- compare_at_amount:- type: string- nullable: true- example: '39.99'- stock_items:+ schema:+ type: object+ required:+ - url+ properties:+ name:+ type: string+ example: Order pipeline+ url:+ type: string+ example: https://example.com/webhooks/orders+ active:+ type: boolean+ example: true+ subscriptions: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- example: 50- backorderable:- type: boolean- "/api/v3/admin/products/{product_id}/variants/{id}":+ type: string+ example:+ - order.completed+ - order.canceled+ "/api/v3/admin/webhook_endpoints/{id}":+ parameters:+ - name: id+ in: path+ required: true+ description: Webhook endpoint ID+ schema:+ type: stringget:- summary: Get a variant+ summary: Get a webhook endpointtags:- - Variants+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Returns a single variant by ID.+ Returns a single webhook endpoint by prefixed ID.- **Required scope:** `read_products` (for API-key authentication).+ **Required scope:** `read_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -20388,12 +22005,10 @@ paths:secretKey: 'sk_xxx',})- const variant = await client.products.variants.get('prod_86Rf07xd4z', 'variant_k5nR8xLq', {- expand: ['prices', 'stock_items'],- })+ const endpoint = await client.webhookEndpoints.get('whe_xxx')- lang: bashlabel: Spree CLI- source: spree api get /products/{product_id}/variants/{id} -d '{"expand":["prices","stock_items"]}'+ source: spree api get /webhook_endpoints/{id}parameters:- name: x-spree-api-keyin: header@@ -20406,116 +22021,61 @@ paths:description: Bearer token for admin authenticationschema: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: fieldsin: queryrequired: false- description: Comma-separated list of fields to include (e.g., sku,price,stock).- id is always included.+ description: Comma-separated list of fields to include. id is always included.schema:type: stringresponses:'200':- description: variant found+ description: webhook endpoint foundcontent:application/json:example:- id: variant_gbHJdmfrXB- product_id: prod_UkLWZg9DAJ- sku: SKU-110- options_text: 'Size: S'- track_inventory: true- media_count: 0- preorder_ships_at:- thumbnail_url:- purchasable: true- in_stock: false- backorderable: true- preorder: false- weight: 117.12- height: 75.32- width: 133.58- depth: 44.31- price:- id: price_gbHJdmfrXB- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- original_price:- option_values:- - id: optval_UkLWZg9DAJ- option_type_id: opt_UkLWZg9DAJ- name: size-22- label: S- position: 1- color_code:- option_type_name: foo-size-31- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:01:46.177Z'- updated_at: '2026-07-27T20:01:46.177Z'- metadata: {}- position: 2- cost_price: '17.0'- cost_currency: USD- barcode:- weight_unit: lb- dimensions_unit:- backorder_limit:- deleted_at:- created_at: '2026-07-27T20:01:46.175Z'- updated_at: '2026-07-27T20:01:46.186Z'- preorderable: false- tax_category_id: taxcat_UkLWZg9DAJ- available_stock: 0- reserved_quantity: 0- total_on_hand: 0- product_name: Product 871094+ id: whe_UkLWZg9DAJ+ name: Order pipeline+ url: https://shop.example.com/webhooks/orders+ active: true+ subscriptions:+ - order.created+ - order.completed+ - product.created+ disabled_reason:+ created_at: '2026-07-29T08:38:54.325Z'+ updated_at: '2026-07-29T08:38:54.325Z'+ disabled_at:+ secret_key:+ last_delivery_at:+ recent_delivery_count: 0+ recent_failure_count: 0+ total_delivery_count: 0+ successful_delivery_count: 0+ failed_delivery_count: 0'404':- description: variant not found+ description: webhook endpoint not foundcontent:application/json:example:error:- code: variant_not_found- message: Variant not found+ code: record_not_found+ message: Webhook endpoint not foundschema:"$ref": "#/components/schemas/ErrorResponse"patch:- summary: Update a variant+ summary: Update a webhook endpointtags:- - Variants+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Updates a variant. Only provided fields are updated.+ Updates name, URL, active flag, or the event subscription list.+ Toggling `active` here is equivalent to calling `disable`/`enable`+ without an audit reason.- **Required scope:** `write_products` (for API-key authentication).++ **Required scope:** `write_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -20527,15 +22087,14 @@ paths:secretKey: 'sk_xxx',})- const variant = await client.products.variants.update('prod_86Rf07xd4z', 'variant_k5nR8xLq', {- sku: 'UPDATED-SKU',- stock_items: [- { stock_location_id: 'sloc_UkLWZg9DAJ', count_on_hand: 75 },- ],+ const endpoint = await client.webhookEndpoints.update('whe_xxx', {+ name: 'Order pipeline (v2)',+ subscriptions: ['order.completed', 'order.canceled', 'order.paid'],})- lang: bashlabel: Spree CLI- source: spree api patch /products/{product_id}/variants/{id} -d '{"sku":"UPDATED-SKU","stock_items":[{"stock_location_id":"sloc_UkLWZg9DAJ","count_on_hand":75}]}'+ source: spree api patch /webhook_endpoints/{id} -d '{"name":"Order pipeline+ (v2)","subscriptions":["order.completed","order.canceled","order.paid"]}'parameters:- name: x-spree-api-keyin: header@@ -20548,180 +22107,83 @@ paths:description: Bearer token for admin authenticationschema: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: stringresponses:'200':- description: variant updated+ description: webhook endpoint updatedcontent:application/json:example:- id: variant_gbHJdmfrXB- product_id: prod_UkLWZg9DAJ- sku: UPDATED-SKU- options_text: 'Size: S'- track_inventory: true- media_count: 0- preorder_ships_at:- thumbnail_url:- purchasable: true- in_stock: false- backorderable: true- preorder: false- weight: 107.24- height: 81.79- width: 3.9- depth: 36.62- price:- id: price_gbHJdmfrXB- amount: '19.99'- amount_in_cents: 1999- compare_at_amount:- compare_at_amount_in_cents:- currency: USD- display_amount: "$19.99"- display_compare_at_amount:- price_list_id:- original_price:- option_values:- - id: optval_UkLWZg9DAJ- option_type_id: opt_UkLWZg9DAJ- name: size-24- label: S- position: 1- color_code:- option_type_name: foo-size-33- option_type_label: Size- image_url:- metadata: {}- created_at: '2026-07-27T20:01:46.848Z'- updated_at: '2026-07-27T20:01:46.848Z'- metadata: {}- position: 2- cost_price: '17.0'- cost_currency: USD- barcode:- weight_unit: lb- dimensions_unit:- backorder_limit:- deleted_at:- created_at: '2026-07-27T20:01:46.845Z'- updated_at: '2026-07-27T20:01:47.142Z'- preorderable: false- tax_category_id: taxcat_UkLWZg9DAJ- available_stock: 0- reserved_quantity: 0- total_on_hand: 0- product_name: Product 896054+ id: whe_UkLWZg9DAJ+ name: Order pipeline (renamed)+ url: https://shop.example.com/webhooks/orders+ active: true+ subscriptions:+ - order.created+ - order.completed+ - product.created+ disabled_reason:+ created_at: '2026-07-29T08:38:55.017Z'+ updated_at: '2026-07-29T08:38:55.296Z'+ disabled_at:+ secret_key:+ last_delivery_at:+ recent_delivery_count: 0+ recent_failure_count: 0+ total_delivery_count: 0+ successful_delivery_count: 0+ failed_delivery_count: 0+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: |-+ Url Translation missing. Options considered were:+ - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url+ - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url+ - en.activerecord.errors.messages.invalid_url+ - en.errors.attributes.url.invalid_url+ - en.errors.messages.invalid_url+ details:+ url:+ - |-+ Translation missing. Options considered were:+ - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url+ - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url+ - en.activerecord.errors.messages.invalid_url+ - en.errors.attributes.url.invalid_url+ - en.errors.messages.invalid_url+ schema:+ "$ref": "#/components/schemas/ErrorResponse"requestBody:content:application/json:schema:type: objectproperties:- sku:- type: string- example: SKU-001- cost_price:- type: string- example: '10.00'- cost_currency:- type: string- example: USD- weight:- type: number- height:- type: number- width:- type: number- depth:- type: number- weight_unit:+ name:type: string- dimensions_unit:+ url:type: string- track_inventory:+ active: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- example: size- value:- type: string- example: Small- 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- example: USD- amount:- type: string- example: '29.99'- compare_at_amount:- type: string- nullable: true- example: '39.99'- stock_items:+ subscriptions: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- example: 50- backorderable:- type: boolean+ type: stringdelete:- summary: Delete a variant+ summary: Delete a webhook endpointtags:- - Variants+ - Webhookssecurity:- api_key: []bearer_auth: []description: |-- Soft-deletes a variant.+ Soft-deletes the endpoint and stops future deliveries.- **Required scope:** `write_products` (for API-key authentication).+ **Required scope:** `write_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -20733,10 +22195,10 @@ paths:secretKey: 'sk_xxx',})- await client.products.variants.delete('prod_86Rf07xd4z', 'variant_k5nR8xLq')+ await client.webhookEndpoints.delete('whe_xxx')- lang: bashlabel: Spree CLI- source: spree api delete /products/{product_id}/variants/{id}+ source: spree api delete /webhook_endpoints/{id}parameters:- name: x-spree-api-keyin: header@@ -20749,45 +22211,31 @@ paths:description: Bearer token for admin authenticationschema: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: stringresponses:'204':- description: variant deleted- "/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries":+ description: webhook endpoint deleted+ "/api/v3/admin/webhook_endpoints/{id}/send_test":parameters:- - name: webhook_endpoint_id+ - name: idin: pathrequired: true- description: Parent webhook endpoint ID+ description: Webhook endpoint IDschema:type: string- get:- summary: List webhook deliveries+ post:+ summary: Send a test deliverytags:- Webhookssecurity:- api_key: []bearer_auth: []description: |-- Returns delivery attempts for the given endpoint, most recent first.- Each row carries the original request payload, the response code- (when the receiver replied), the execution time, and any transport- error — everything needed to audit failures and decide whether to- redeliver.+ Creates a `webhook.test` delivery record and queues it. Use this to+ verify the endpoint is reachable and your signature verification+ accepts Spree's payloads.- **Required scope:** `read_webhooks` (for API-key authentication).+ **Required scope:** `write_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -20799,10 +22247,12 @@ paths:secretKey: 'sk_xxx',})- const deliveries = await client.webhookEndpoints.deliveries.list('whe_xxx')+ // Fires a synthetic `webhook.test` delivery so you can verify the endpoint is+ // reachable and your signature-verification code accepts Spree's payloads.+ const delivery = await client.webhookEndpoints.sendTest('whe_xxx')- lang: bashlabel: Spree CLI- source: spree api get /webhook_endpoints/{webhook_endpoint_id}/deliveries+ source: spree api post /webhook_endpoints/{id}/send_test -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -20815,133 +22265,53 @@ paths:description: Bearer token for admin authenticationschema: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: stringresponses:- '200':- description: deliveries found- content:- application/json:- example:- data:- - id: whd_gbHJdmfrXB- event_name: order.created- event_id:- response_code: 500- execution_time: 200- error_type:- request_errors:- response_body:- success: false- created_at: '2026-07-27T20:01:47.791Z'- updated_at: '2026-07-27T20:01:47.791Z'- delivered_at: '2026-07-27T20:01:47.791Z'- payload:- event: order.created- data:- id: 1- webhook_endpoint_id: whe_UkLWZg9DAJ- webhook_endpoint_url: https://shop.example.com/webhooks- - id: whd_UkLWZg9DAJ- event_name: order.created- event_id:- response_code: 200- execution_time: 150- error_type:- request_errors:- response_body:- success: true- created_at: '2026-07-27T20:01:47.790Z'- updated_at: '2026-07-27T20:01:47.790Z'- delivered_at: '2026-07-27T20:01:47.789Z'- payload:- event: order.created- data:- id: 1- webhook_endpoint_id: whe_UkLWZg9DAJ- webhook_endpoint_url: https://shop.example.com/webhooks- meta:- page: 1- limit: 25- count: 2- pages: 1- from: 1- to: 2- in: 2- previous:- next:- '404':- description: parent webhook endpoint not found+ '201':+ description: test delivery queuedcontent:application/json:example:- error:- code: record_not_found- message: Webhook endpoint not found- schema:- "$ref": "#/components/schemas/ErrorResponse"- "/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}":+ id: whd_UkLWZg9DAJ+ event_name: webhook.test+ event_id:+ response_code:+ execution_time:+ error_type:+ request_errors:+ response_body:+ success:+ created_at: '2026-07-29T08:38:56.343Z'+ updated_at: '2026-07-29T08:38:56.343Z'+ delivered_at:+ payload:+ id: 5f977258-b7bd-414a-8a94-eb170b8b7e7c+ name: webhook.test+ created_at: '2026-07-29T08:38:56Z'+ data:+ message: This is a test webhook from Spree.+ metadata:+ spree_version: 5.6.1+ webhook_endpoint_id: whe_UkLWZg9DAJ+ webhook_endpoint_url: https://shop.example.com/webhooks/orders+ "/api/v3/admin/webhook_endpoints/{id}/enable":parameters:- - name: webhook_endpoint_id- in: path- required: true- description: Parent webhook endpoint ID- schema:- type: string- name: idin: pathrequired: true- description: Webhook delivery ID+ description: Webhook endpoint IDschema:type: string- get:- summary: Get a webhook delivery+ patch:+ summary: Re-enable a webhook endpointtags:- Webhookssecurity:- api_key: []bearer_auth: []description: |-- Returns a single delivery attempt with the full request payload and- the response body the receiver returned. Use this for ad-hoc debug- of failed deliveries.-+ Re-enables an endpoint that was manually or automatically disabled.- **Required scope:** `read_webhooks` (for API-key authentication).+ **Required scope:** `write_webhooks` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -20953,10 +22323,11 @@ paths:secretKey: 'sk_xxx',})- const delivery = await client.webhookEndpoints.deliveries.get('whe_xxx', 'whd_xxx')+ // Re-enable an endpoint that was auto-disabled after repeated delivery failures.+ const endpoint = await client.webhookEndpoints.enable('whe_xxx')- lang: bashlabel: Spree CLI- source: spree api get /webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}+ source: spree api patch /webhook_endpoints/{id}/enable -d '{ ... }'parameters:- name: x-spree-api-keyin: header@@ -20969,70 +22340,49 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: fields- in: query- required: false- description: Comma-separated list of fields to include. id is always included.- schema:- type: stringresponses:'200':- description: delivery found- content:- application/json:- example:- id: whd_gbHJdmfrXB- event_name: order.created- event_id:- response_code: 500- execution_time: 200- error_type:- request_errors:- response_body:- success: false- created_at: '2026-07-27T20:01:48.872Z'- updated_at: '2026-07-27T20:01:48.872Z'- delivered_at: '2026-07-27T20:01:48.872Z'- payload:- event: order.created- data:- id: 1- webhook_endpoint_id: whe_UkLWZg9DAJ- webhook_endpoint_url: https://shop.example.com/webhooks- '404':- description: delivery not found+ description: webhook endpoint enabledcontent:application/json:example:- error:- code: record_not_found- message: Webhook delivery not found- schema:- "$ref": "#/components/schemas/ErrorResponse"- "/api/v3/admin/webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}/redeliver":+ id: whe_UkLWZg9DAJ+ name: Order pipeline+ url: https://shop.example.com/webhooks/orders+ active: true+ subscriptions:+ - order.created+ - order.completed+ - product.created+ disabled_reason:+ created_at: '2026-07-29T08:38:56.392Z'+ updated_at: '2026-07-29T08:38:56.675Z'+ disabled_at:+ secret_key:+ last_delivery_at:+ recent_delivery_count: 0+ recent_failure_count: 0+ total_delivery_count: 0+ successful_delivery_count: 0+ failed_delivery_count: 0+ "/api/v3/admin/webhook_endpoints/{id}/disable":parameters:- - name: webhook_endpoint_id- in: path- required: true- description: Parent webhook endpoint ID- schema:- type: string- name: idin: pathrequired: true- description: Webhook delivery ID to redeliver+ description: Webhook endpoint IDschema:type: string- post:- summary: Redeliver a webhook delivery+ patch:+ summary: Disable a webhook endpointtags:- Webhookssecurity:- api_key: []bearer_auth: []description: |-- Creates a new delivery row with the same payload + event_name and- queues it. The original row is preserved for audit history.+ Manually pauses an endpoint. Unlike auto-disable (triggered after+ repeated delivery failures), no notification email is sent.**Required scope:** `write_webhooks` (for API-key authentication).@@ -21047,13 +22397,15 @@ paths:secretKey: 'sk_xxx',})- // Creates a new delivery row with the same payload + event_name and queues- // it. The original row is preserved for audit history.- const delivery = await client.webhookEndpoints.deliveries.redeliver('whe_xxx', 'whd_xxx')+ // Pause an endpoint without deleting it. The optional `reason` is shown next+ // to the disabled indicator in the admin.+ const endpoint = await client.webhookEndpoints.disable('whe_xxx', {+ reason: 'Investigating elevated 5xx rate',+ })- lang: bashlabel: Spree CLI- source: spree api post /webhook_endpoints/{webhook_endpoint_id}/deliveries/{id}/redeliver- -d '{ ... }'+ source: spree api patch /webhook_endpoints/{id}/disable -d '{"reason":"Investigating+ elevated 5xx rate"}'parameters:- name: x-spree-api-keyin: header@@ -21067,60 +22419,261 @@ paths:schema:type: stringresponses:- '201':- description: redelivery queued+ '200':+ description: webhook endpoint disabledcontent:application/json:example:- id: whd_EfhxLZ9ck8- event_name: order.created- event_id:- response_code:- execution_time:- error_type:- request_errors:- response_body:- success:- created_at: '2026-07-27T20:01:49.983Z'- updated_at: '2026-07-27T20:01:49.983Z'- delivered_at:- payload:- event: order.created+ id: whe_UkLWZg9DAJ+ name: Order pipeline+ url: https://shop.example.com/webhooks/orders+ active: false+ subscriptions:+ - order.created+ - order.completed+ - product.created+ disabled_reason: Investigating+ created_at: '2026-07-29T08:38:56.778Z'+ updated_at: '2026-07-29T08:38:57.064Z'+ disabled_at: '2026-07-29T08:38:57.063Z'+ secret_key:+ last_delivery_at:+ recent_delivery_count: 0+ recent_failure_count: 0+ total_delivery_count: 0+ successful_delivery_count: 0+ failed_delivery_count: 0+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ reason:+ type: string+ example: Investigating elevated 5xx rate+ "/api/v3/admin/collections":+ get:+ summary: List collections+ tags:+ - Collections+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Returns a paginated list of the store's collections.++ **Required scope:** `read_collections` (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: expand+ in: query+ required: false+ description: Comma-separated associations to expand (e.g., custom_fields,+ translations).+ schema:+ type: string+ responses:+ '200':+ description: collections found+ content:+ application/json:+ example:+ data:+ - id: coll_UkLWZg9DAJ+ name: Summer Sale+ permalink: summer-sale+ position: 1+ sort_order: manual+ meta_title:+ meta_description:+ meta_keywords:+ products_count: 0+ description: ''+ description_html: ''+ image_url:+ square_image_url:+ automatic: false+ rules_match_policy: all+ metadata: {}+ created_at: '2026-07-29T08:37:07.296Z'+ updated_at: '2026-07-29T08:37:07.296Z'+ rules: []+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ schema:+ type: object+ properties:data:- id: 1- webhook_endpoint_id: whe_UkLWZg9DAJ- webhook_endpoint_url: https://shop.example.com/webhooks- "/api/v3/admin/webhook_endpoints":+ type: array+ items:+ "$ref": "#/components/schemas/Collection"+ meta:+ "$ref": "#/components/schemas/PaginationMeta"+ required:+ - data+ - meta+ post:+ summary: Create a collection+ tags:+ - Collections+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Creates a manual or automatic (rule-based) collection. For automatic collections, send the full desired rule set under `rules`.++ **Required scope:** `write_collections` (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: collection created+ content:+ application/json:+ example:+ id: coll_gbHJdmfrXB+ name: On Sale+ permalink: on-sale+ position: 2+ sort_order: manual+ meta_title:+ meta_description:+ meta_keywords:+ products_count: 0+ description: ''+ description_html: ''+ image_url:+ square_image_url:+ automatic: true+ rules_match_policy: any+ metadata: {}+ created_at: '2026-07-29T08:37:07.892Z'+ updated_at: '2026-07-29T08:37:07.894Z'+ rules:+ - id: crule_UkLWZg9DAJ+ type: Spree::CollectionRules::Tag+ value: summer+ match_policy: contains+ schema:+ "$ref": "#/components/schemas/Collection"+ '422':+ description: validation error+ content:+ application/json:+ example:+ error:+ code: validation_error+ message: Name can't be blank+ details:+ name:+ - can't be blank+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ name:+ type: string+ example: On Sale+ automatic:+ type: boolean+ example: true+ rules_match_policy:+ type: string+ enum:+ - all+ - any+ example: all+ sort_order:+ type: string+ example: manual+ permalink:+ type: string+ description:+ type: string+ meta_title:+ type: string+ meta_description:+ type: string+ meta_keywords:+ type: string+ rules:+ type: array+ description: Full desired rule set. Entries with an id update, id-less+ entries create, omitted rules are removed.+ items:+ type: object+ properties:+ id:+ type: string+ example: crule_abc123+ type:+ type: string+ example: Spree::CollectionRules::Tag+ value:+ type: string+ example: summer+ match_policy:+ type: string+ example: contains+ required:+ - name+ "/api/v3/admin/collections/{id}":get:- summary: List webhook endpoints+ summary: Get a collectiontags:- - Webhooks+ - Collectionssecurity:- api_key: []bearer_auth: []description: |-- Returns outbound webhook subscriptions for the current store. Each- endpoint receives a signed POST when any subscribed event fires.- `secret_key` is `null` on list reads — the plaintext is delivered- exactly once on create.--- **Required scope:** `read_webhooks` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })+ Returns a single collection by ID, including its rules.- const endpoints = await client.webhookEndpoints.list()- - lang: bash- label: Spree CLI- source: spree api get /webhook_endpoints+ **Required scope:** `read_collections` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -21133,129 +22686,67 @@ paths:description: Bearer token for admin authenticationschema: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`).+ - name: id+ in: path+ required: true+ description: Collection IDschema:type: string- - name: fields+ - name: expandin: queryrequired: false- description: Comma-separated list of fields to include. id is always included.+ description: Comma-separated associations to expand (e.g., custom_fields,+ translations).schema:type: stringresponses:'200':- description: webhook endpoints found+ description: collection foundcontent:application/json:example:- data:- - id: whe_UkLWZg9DAJ- name: Order pipeline- url: https://shop.example.com/webhooks/orders- active: true- subscriptions:- - order.created- - order.completed- - product.created- disabled_reason:- created_at: '2026-07-27T20:01:50.024Z'- updated_at: '2026-07-27T20:01:50.024Z'- disabled_at:- secret_key:- last_delivery_at:- recent_delivery_count: 0- recent_failure_count: 0- total_delivery_count: 0- successful_delivery_count: 0- failed_delivery_count: 0- meta:- page: 1- limit: 25- count: 1- pages: 1- from: 1- to: 1- in: 1- previous:- next:- '401':- description: unauthorized+ id: coll_UkLWZg9DAJ+ name: Summer Sale+ permalink: summer-sale+ position: 1+ sort_order: manual+ meta_title:+ meta_description:+ meta_keywords:+ products_count: 0+ description: ''+ description_html: ''+ image_url:+ square_image_url:+ automatic: false+ rules_match_policy: all+ metadata: {}+ created_at: '2026-07-29T08:37:08.200Z'+ updated_at: '2026-07-29T08:37:08.200Z'+ rules: []+ schema:+ "$ref": "#/components/schemas/Collection"+ '404':+ description: collection not foundcontent:application/json:example:error:- code: authentication_required- message: Authentication required+ code: record_not_found+ message: Collection not foundschema:"$ref": "#/components/schemas/ErrorResponse"- post:- summary: Create a webhook endpoint+ patch:+ summary: Update a collectiontags:- - Webhooks+ - Collectionssecurity:- api_key: []bearer_auth: []description: |-- Creates a new outbound webhook subscription. The plaintext- `secret_key` is returned **once** in this response — persist it- immediately to verify incoming webhook signatures. Subsequent reads- return `null` for the secret. Pass an empty `subscriptions` array or- omit it to receive every event.--- **Required scope:** `write_webhooks` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })-- const endpoint = await client.webhookEndpoints.create({- name: 'Order pipeline',- url: 'https://example.com/webhooks/orders',- active: true,- subscriptions: ['order.completed', 'order.canceled'],- })+ Updates a collection. Send `position` to reorder it within the flat list; send the full `rules` set to sync automatic rules.- // The plaintext `secret_key` is returned exactly once on create — persist it- // immediately so you can verify incoming webhook signatures. Subsequent reads- // will return `null`.- const signingSecret = endpoint.secret_key- - lang: bash- label: Spree CLI- source: spree api post /webhook_endpoints -d '{"name":"Order pipeline","url":"https://example.com/webhooks/orders","active":true,"subscriptions":["order.completed","order.canceled"]}'+ **Required scope:** `write_collections` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -21268,112 +22759,128 @@ paths:description: Bearer token for admin authenticationschema:type: string+ - name: id+ in: path+ required: true+ description: Collection ID+ schema:+ type: stringresponses:- '201':- description: webhook endpoint created — secret_key returned once- content:- application/json:- example:- id: whe_gbHJdmfrXB- name: CI integration- url: https://ci.example.com/webhooks- active: true- subscriptions:- - order.completed- disabled_reason:- created_at: '2026-07-27T20:01:50.936Z'- updated_at: '2026-07-27T20:01:50.936Z'- disabled_at:- secret_key: 90ad965cc1c4d99ff9b7d7cf3b8f926a4658097c48c0271d492a5b059fd1620b- last_delivery_at:- recent_delivery_count: 0- recent_failure_count: 0- total_delivery_count: 0- successful_delivery_count: 0- failed_delivery_count: 0- '422':- description: validation error+ '200':+ description: collection updatedcontent:application/json:example:- error:- code: validation_error- message: |-- Url Translation missing. Options considered were:- - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url- - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url- - en.activerecord.errors.messages.invalid_url- - en.errors.attributes.url.invalid_url- - en.errors.messages.invalid_url- details:- url:- - |-- Translation missing. Options considered were:- - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url- - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url- - en.activerecord.errors.messages.invalid_url- - en.errors.attributes.url.invalid_url- - en.errors.messages.invalid_url+ id: coll_UkLWZg9DAJ+ name: Winter Sale+ permalink: summer-sale+ position: 1+ sort_order: manual+ meta_title:+ meta_description:+ meta_keywords:+ products_count: 0+ description: ''+ description_html: ''+ image_url:+ square_image_url:+ automatic: false+ rules_match_policy: all+ metadata: {}+ created_at: '2026-07-29T08:37:08.845Z'+ updated_at: '2026-07-29T08:37:09.154Z'+ rules: []schema:- "$ref": "#/components/schemas/ErrorResponse"+ "$ref": "#/components/schemas/Collection"requestBody:content:application/json:schema:type: object- required:- - urlproperties:name:type: string- example: Order pipeline- url:+ example: Winter Sale+ permalink:type: string- example: https://example.com/webhooks/orders- active:+ description:+ type: string+ meta_title:+ type: string+ meta_description:+ type: string+ meta_keywords:+ type: string+ sort_order:+ type: string+ automatic:type: boolean- example: true- subscriptions:+ rules_match_policy:+ type: string+ enum:+ - all+ - any+ position:+ type: integer+ description: Reorders the collection within the flat list (acts_as_list)+ rules:type: array+ description: Full desired rule set (see create).items:- type: string- example:- - order.completed- - order.canceled- "/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+ type: object+ properties:+ id:+ type: string+ type:+ type: string+ value:+ type: string+ match_policy:+ type: string+ delete:+ summary: Delete a collectiontags:- - Webhooks+ - Collectionssecurity:- api_key: []bearer_auth: []description: |-- Returns a single webhook endpoint by prefixed ID.-- **Required scope:** `read_webhooks` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'+ Deletes a collection.- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })+ **Required scope:** `write_collections` (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: Collection ID+ schema:+ type: string+ responses:+ '204':+ description: collection deleted+ "/api/v3/admin/collections/{collection_id}/products":+ get:+ summary: List collection products+ tags:+ - Collections+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Products curated in the collection, ordered by their membership position.- const endpoint = await client.webhookEndpoints.get('whe_xxx')- - lang: bash- label: Spree CLI- source: spree api get /webhook_endpoints/{id}+ **Required scope:** `read_collections` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -21386,80 +22893,52 @@ paths:description: Bearer token for admin authenticationschema:type: string- - name: fields- in: query- required: false- description: Comma-separated list of fields to include. id is always included.+ - name: collection_id+ in: path+ required: true+ description: Collection IDschema:type: stringresponses:'200':- description: webhook endpoint found- content:- application/json:- example:- id: whe_UkLWZg9DAJ- name: Order pipeline- url: https://shop.example.com/webhooks/orders- active: true- subscriptions:- - order.created- - order.completed- - product.created- disabled_reason:- created_at: '2026-07-27T20:01:51.455Z'- updated_at: '2026-07-27T20:01:51.455Z'- disabled_at:- secret_key:- last_delivery_at:- recent_delivery_count: 0- recent_failure_count: 0- total_delivery_count: 0- successful_delivery_count: 0- failed_delivery_count: 0- '404':- description: webhook endpoint not found+ description: products foundcontent:application/json:example:- error:- code: record_not_found- message: Webhook endpoint not found+ data: []+ meta:+ page: 1+ limit: 25+ count: 0+ pages: 1+ from: 0+ to: 0+ in: 0+ previous:+ next:schema:- "$ref": "#/components/schemas/ErrorResponse"- patch:- summary: Update a webhook endpoint+ type: object+ properties:+ data:+ type: array+ items:+ "$ref": "#/components/schemas/Product"+ meta:+ "$ref": "#/components/schemas/PaginationMeta"+ required:+ - data+ - meta+ post:+ summary: Add a product to a collectiontags:- - Webhooks+ - Collectionssecurity:- api_key: []bearer_auth: []description: |-- Updates name, URL, active flag, or the event subscription list.- Toggling `active` here is equivalent to calling `disable`/`enable`- without an audit reason.--- **Required scope:** `write_webhooks` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })+ Curates a product into the collection (appended to the end).- const endpoint = await client.webhookEndpoints.update('whe_xxx', {- name: 'Order pipeline (v2)',- subscriptions: ['order.completed', 'order.canceled', 'order.paid'],- })- - lang: bash- label: Spree CLI- source: spree api patch /webhook_endpoints/{id} -d '{"name":"Order pipeline- (v2)","subscriptions":["order.completed","order.canceled","order.paid"]}'+ **Required scope:** `write_collections` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -21472,98 +22951,103 @@ paths:description: Bearer token for admin authenticationschema:type: string+ - name: collection_id+ in: path+ required: true+ description: Collection ID+ schema:+ type: stringresponses:- '200':- description: webhook endpoint updated- content:- application/json:- example:- id: whe_UkLWZg9DAJ- name: Order pipeline (renamed)- url: https://shop.example.com/webhooks/orders- active: true- subscriptions:- - order.created- - order.completed- - product.created- disabled_reason:- created_at: '2026-07-27T20:01:52.504Z'- updated_at: '2026-07-27T20:01:52.803Z'- disabled_at:- secret_key:- last_delivery_at:- recent_delivery_count: 0- recent_failure_count: 0- total_delivery_count: 0- successful_delivery_count: 0- failed_delivery_count: 0- '422':- description: validation error+ '201':+ description: product addedcontent:application/json:example:- error:- code: validation_error- message: |-- Url Translation missing. Options considered were:- - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url- - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url- - en.activerecord.errors.messages.invalid_url- - en.errors.attributes.url.invalid_url- - en.errors.messages.invalid_url- details:- url:- - |-- Translation missing. Options considered were:- - en.activerecord.errors.models.spree/webhook_endpoint.attributes.url.invalid_url- - en.activerecord.errors.models.spree/webhook_endpoint.invalid_url- - en.activerecord.errors.messages.invalid_url- - en.errors.attributes.url.invalid_url- - en.errors.messages.invalid_url+ id: prod_UkLWZg9DAJ+ name: Product 64440+ slug: product-64440+ meta_title:+ meta_description:+ meta_keywords:+ variant_count: 1+ available_on:+ preorder_ships_at:+ purchasable: true+ preorder: false+ in_stock: false+ backorderable: true+ available: true+ description: Non esse quidem assumenda sapiente architecto nostrum+ at. Veritatis fugit pariatur rerum necessitatibus ex maiores ipsa+ sed. Incidunt labore consequuntur placeat quibusdam fugit. Porro+ ad rem veniam deserunt ab id natus quos. Tempore iste sapiente iusto+ iure sint ipsam. Voluptatum accusantium ex architecto et. Consequuntur+ ipsa excepturi commodi ad. Libero expedita nulla accusantium aperiam+ harum impedit quas. Accusamus iure debitis animi dolorem incidunt.+ Cumque dignissimos provident ullam doloremque a quis illo harum.+ Dolore animi corporis possimus nemo corrupti illum labore hic. Numquam+ deleniti deserunt id commodi quo rem. Possimus vel ipsum cum voluptatum+ odit. Expedita perspiciatis occaecati natus neque quo doloremque+ impedit quidem. Eum et amet sed unde laborum beatae placeat optio.+ Nam molestiae ratione quam eos debitis ad accusantium modi. Voluptatum+ quas quasi ipsa officia adipisci libero odio eius. Quibusdam harum+ nam earum atque voluptatem similique. Quaerat perspiciatis quia+ dolorum quam illum corrupti laborum. Excepturi molestias ea dicta+ aspernatur ex.+ description_html: |-+ Non esse quidem assumenda sapiente architecto nostrum at. Veritatis fugit pariatur rerum necessitatibus ex maiores ipsa sed. Incidunt labore consequuntur placeat quibusdam fugit. Porro ad rem veniam deserunt ab id natus quos.+ Tempore iste sapiente iusto iure sint ipsam. Voluptatum accusantium ex architecto et. Consequuntur ipsa excepturi commodi ad. Libero expedita nulla accusantium aperiam harum impedit quas. Accusamus iure debitis animi dolorem incidunt.+ Cumque dignissimos provident ullam doloremque a quis illo harum. Dolore animi corporis possimus nemo corrupti illum labore hic. Numquam deleniti deserunt id commodi quo rem.+ Possimus vel ipsum cum voluptatum odit. Expedita perspiciatis occaecati natus neque quo doloremque impedit quidem. Eum et amet sed unde laborum beatae placeat optio. Nam molestiae ratione quam eos debitis ad accusantium modi. Voluptatum quas quasi ipsa officia adipisci libero odio eius.+ Quibusdam harum nam earum atque voluptatem similique. Quaerat perspiciatis quia dolorum quam illum corrupti laborum. Excepturi molestias ea dicta aspernatur ex.+ default_variant_id: variant_UkLWZg9DAJ+ thumbnail_url:+ tags: []+ price:+ id: price_UkLWZg9DAJ+ amount: '19.99'+ amount_in_cents: 1999+ compare_at_amount:+ compare_at_amount_in_cents:+ currency: USD+ display_amount: "$19.99"+ display_compare_at_amount:+ price_list_id:+ variant_id: variant_UkLWZg9DAJ+ created_at: '2026-07-29T08:37:09.879Z'+ updated_at: '2026-07-29T08:37:09.879Z'+ original_price:+ status: active+ metadata: {}+ deleted_at:+ created_at: '2026-07-29T08:37:09.869Z'+ updated_at: '2026-07-29T08:37:09.885Z'+ tax_category_id: taxcat_UkLWZg9DAJschema:- "$ref": "#/components/schemas/ErrorResponse"+ "$ref": "#/components/schemas/Product"requestBody:content:application/json:schema:type: objectproperties:- name:- type: string- url:+ product_id:type: string- active:- type: boolean- subscriptions:- type: array- items:- type: string+ example: prod_abc123+ required:+ - product_id+ "/api/v3/admin/collections/{collection_id}/products/{id}":delete:- summary: Delete a webhook endpoint+ summary: Remove a product from a collectiontags:- - Webhooks+ - Collectionssecurity:- api_key: []bearer_auth: []description: |-- Soft-deletes the endpoint and stops future deliveries.-- **Required scope:** `write_webhooks` (for API-key authentication).- x-codeSamples:- - lang: javascript- label: Spree Admin SDK- source: |-- import { createAdminClient } from '@spree/admin-sdk'-- const client = createAdminClient({- baseUrl: 'https://your-store.com',- secretKey: 'sk_xxx',- })+ Removes a product from the collection's manual curation.- await client.webhookEndpoints.delete('whe_xxx')- - lang: bash- label: Spree CLI- source: spree api delete /webhook_endpoints/{id}+ **Required scope:** `write_collections` (for API-key authentication).parameters:- name: x-spree-api-keyin: header@@ -21576,31 +23060,83 @@ paths:description: Bearer token for admin authenticationschema:type: string+ - name: collection_id+ in: path+ required: true+ description: Collection ID+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Product ID+ schema:+ type: stringresponses:'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+ description: product removed+ "/api/v3/admin/collections/{collection_id}/products/{id}/reposition":+ patch:+ summary: Reposition a collection producttags:- - Webhooks+ - Collectionssecurity:- api_key: []bearer_auth: []description: |-- Creates a `webhook.test` delivery record and queues it. Use this to- verify the endpoint is reachable and your signature verification- accepts Spree's payloads.+ Moves a product to a new index among the collection's products.+ **Required scope:** `write_collections` (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: collection_id+ in: path+ required: true+ description: Collection ID+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Product ID+ schema:+ type: string+ responses:+ '204':+ description: product repositioned+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ new_position:+ type: integer+ description: 0-based index among the collection's products+ required:+ - new_position+ "/api/v3/admin/delivery_methods":+ get:+ summary: List delivery methods+ tags:+ - Delivery+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Returns all delivery methods with calculator and zone configuration.- **Required scope:** `write_webhooks` (for API-key authentication).+ **Required scope:** `read_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -21612,12 +23148,10 @@ paths:secretKey: 'sk_xxx',})- // Fires a synthetic `webhook.test` delivery so you can verify the endpoint is- // reachable and your signature-verification code accepts Spree's payloads.- const delivery = await client.webhookEndpoints.sendTest('whe_xxx')+ const { data: deliveryMethods } = await client.deliveryMethods.list()- lang: bashlabel: Spree CLI- source: spree api post /webhook_endpoints/{id}/send_test -d '{ ... }'+ source: spree api get /delivery_methodsparameters:- name: x-spree-api-keyin: header@@ -21627,56 +23161,60 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: stringresponses:- '201':- description: test delivery queued+ '200':+ description: delivery methods foundcontent:application/json:example:- id: whd_UkLWZg9DAJ- event_name: webhook.test- event_id:- response_code:- execution_time:- error_type:- request_errors:- response_body:- success:- created_at: '2026-07-27T20:01:54.161Z'- updated_at: '2026-07-27T20:01:54.161Z'- delivered_at:- payload:- id: e8144392-1d31-4f81-9f14-2dda90cc63f9- name: webhook.test- created_at: '2026-07-27T20:01:54Z'- data:- message: This is a test webhook from Spree.- metadata:- spree_version: 5.6.0- webhook_endpoint_id: whe_UkLWZg9DAJ- webhook_endpoint_url: https://shop.example.com/webhooks/orders- "/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+ data:+ - id: dm_UkLWZg9DAJ+ name: UPS Ground+ code: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:+ admin_name:+ fulfillment_provider: Spree::FulfillmentProvider::Manual+ pickup_point_provider:+ storefront_visible: true+ tracking_url:+ created_at: '2026-07-29T08:37:30.386Z'+ updated_at: '2026-07-29T08:37:30.387Z'+ deleted_at:+ tax_category_id:+ delivery_zone_ids: []+ calculator_type: Spree::Calculator::Shipping::FlatRate+ calculator_preferences:+ amount: '10.0'+ currency: USD+ minimum_item_total:+ maximum_item_total:+ minimum_weight:+ maximum_weight:+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ post:+ summary: Create delivery methodtags:- - Webhooks+ - Deliverysecurity:- api_key: []bearer_auth: []description: |-- Re-enables an endpoint that was manually or automatically disabled.+ Creates a delivery method. fulfillment_type is one of shipping, digital, pickup, pickup_point.- **Required scope:** `write_webhooks` (for API-key authentication).+ **Required scope:** `write_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -21688,11 +23226,16 @@ paths:secretKey: 'sk_xxx',})- // Re-enable an endpoint that was auto-disabled after repeated delivery failures.- const endpoint = await client.webhookEndpoints.enable('whe_xxx')+ const deliveryMethod = await client.deliveryMethods.create({+ name: 'Express',+ fulfillment_type: 'shipping',+ storefront_visible: true,+ calculator_type: 'Spree::Calculator::Shipping::FlatRate',+ calculator_preferences: { amount: 12.5 },+ })- lang: bashlabel: Spree CLI- source: spree api patch /webhook_endpoints/{id}/enable -d '{ ... }'+ source: spree api post /delivery_methods -d '{"name":"Express","fulfillment_type":"shipping","storefront_visible":true,"calculator_type":"Spree::Calculator::Shipping::FlatRate","calculator_preferences":{"amount":12.5}}'parameters:- name: x-spree-api-keyin: header@@ -21702,55 +23245,221 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: stringresponses:- '200':- description: webhook endpoint enabled+ '201':+ description: delivery method createdcontent:application/json:example:- id: whe_UkLWZg9DAJ- name: Order pipeline- url: https://shop.example.com/webhooks/orders- active: true- subscriptions:- - order.created- - order.completed- - product.created- disabled_reason:- created_at: '2026-07-27T20:01:54.198Z'- updated_at: '2026-07-27T20:01:54.477Z'- disabled_at:- secret_key:- last_delivery_at:- recent_delivery_count: 0- recent_failure_count: 0- total_delivery_count: 0- successful_delivery_count: 0- failed_delivery_count: 0- "/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+ id: dm_UkLWZg9DAJ+ name: Express+ code:+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:+ admin_name:+ fulfillment_provider: Spree::FulfillmentProvider::Manual+ pickup_point_provider:+ storefront_visible: true+ tracking_url:+ created_at: '2026-07-29T08:37:30.981Z'+ updated_at: '2026-07-29T08:37:30.982Z'+ deleted_at:+ tax_category_id:+ delivery_zone_ids: []+ calculator_type: Spree::Calculator::Shipping::FlatRate+ calculator_preferences:+ amount: '12.5'+ currency: USD+ minimum_item_total:+ maximum_item_total:+ minimum_weight:+ maximum_weight:+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ name:+ type: string+ example: Express+ admin_name:+ type: string+ nullable: true+ code:+ type: string+ nullable: true+ fulfillment_type:+ type: string+ enum:+ - shipping+ - digital+ - pickup+ - pickup_point+ example: shipping+ storefront_visible:+ type: boolean+ example: true+ tracking_url:+ type: string+ nullable: true+ estimated_transit_business_days_min:+ type: integer+ nullable: true+ estimated_transit_business_days_max:+ type: integer+ nullable: true+ tax_category_id:+ type: string+ nullable: true+ calculator_type:+ type: string+ example: Spree::Calculator::Shipping::FlatRate+ calculator_preferences:+ type: object+ example:+ amount: 12.5+ delivery_zone_ids:+ type: array+ items:+ type: string+ required:+ - name+ "/api/v3/admin/delivery_methods/calculators":+ get:+ summary: List delivery calculators+ tags:+ - Delivery+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Registered delivery calculator classes with preference schemas for building configuration forms.++ **Required scope:** `write_settings` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const { data: calculators } = await client.deliveryMethods.calculators()+ - lang: bash+ label: Spree CLI+ source: spree api get /delivery_methods/calculators+ 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: calculators found+ content:+ application/json:+ example:+ data:+ - type: Spree::Calculator::Shipping::FlatPercentItemTotal+ name: Flat Percent+ preference_schema:+ - key: flat_percent+ type: decimal+ default: 0+ - type: Spree::Calculator::Shipping::FlatRate+ name: Flat rate+ preference_schema:+ - key: amount+ type: decimal+ default: 0+ - key: currency+ type: string+ default: USD+ - key: minimum_item_total+ type: decimal+ default:+ - key: maximum_item_total+ type: decimal+ default:+ - key: minimum_weight+ type: decimal+ default:+ - key: maximum_weight+ type: decimal+ default:+ - type: Spree::Calculator::Shipping::FlexiRate+ name: Flexible Rate per package item+ preference_schema:+ - key: additional_item+ type: decimal+ default: 0.0+ - key: max_items+ type: integer+ default: 0+ - key: currency+ type: string+ default: USD+ - key: first_item+ type: decimal+ default: 0.0+ - type: Spree::Calculator::Shipping::PerItem+ name: Flat rate per package item+ preference_schema:+ - key: amount+ type: decimal+ default: 0+ - key: currency+ type: string+ default: USD+ - type: Spree::Calculator::Shipping::PriceSack+ name: Price sack+ preference_schema:+ - key: minimal_amount+ type: decimal+ default: 0+ - key: normal_amount+ type: decimal+ default: 0+ - key: currency+ type: string+ default: USD+ - key: discount_amount+ type: decimal+ default: 0+ - type: Spree::Calculator::Shipping::DigitalDelivery+ name: Digital Delivery+ preference_schema:+ - key: amount+ type: decimal+ default: 0+ - key: currency+ type: string+ default: USD+ "/api/v3/admin/delivery_zones":+ post:+ summary: Create delivery zonetags:- - Webhooks+ - Deliverysecurity:- api_key: []bearer_auth: []description: |-- Manually pauses an endpoint. Unlike auto-disable (triggered after- repeated delivery failures), no notification email is sent.+ Creates a delivery zone with typed members: country, state, or postal_code (prefix or from/to range).-- **Required scope:** `write_webhooks` (for API-key authentication).+ **Required scope:** `write_settings` (for API-key authentication).x-codeSamples:- lang: javascriptlabel: Spree Admin SDK@@ -21762,15 +23471,16 @@ paths:secretKey: 'sk_xxx',})- // Pause an endpoint without deleting it. The optional `reason` is shown next- // to the disabled indicator in the admin.- const endpoint = await client.webhookEndpoints.disable('whe_xxx', {- reason: 'Investigating elevated 5xx rate',+ const deliveryZone = await client.deliveryZones.create({+ name: 'US North-East',+ members: [+ { member_type: 'country', country_iso: 'US' },+ { member_type: 'postal_code', country_iso: 'US', postal_code_prefix: '10' },+ ],})- lang: bashlabel: Spree CLI- source: spree api patch /webhook_endpoints/{id}/disable -d '{"reason":"Investigating- elevated 5xx rate"}'+ source: spree api post /delivery_zones -d '{"name":"US North-East","members":[{"member_type":"country","country_iso":"US"},{"member_type":"postal_code","country_iso":"US","postal_code_prefix":"10"}]}'parameters:- name: x-spree-api-keyin: header@@ -21780,43 +23490,84 @@ paths:- name: Authorizationin: headerrequired: true- description: Bearer token for admin authenticationschema:type: stringresponses:- '200':- description: webhook endpoint disabled+ '201':+ description: delivery zone createdcontent:application/json:example:- id: whe_UkLWZg9DAJ- name: Order pipeline- url: https://shop.example.com/webhooks/orders- active: false- subscriptions:- - order.created- - order.completed- - product.created- disabled_reason: Investigating- created_at: '2026-07-27T20:01:54.602Z'- updated_at: '2026-07-27T20:01:54.891Z'- disabled_at: '2026-07-27T20:01:54.891Z'- secret_key:- last_delivery_at:- recent_delivery_count: 0- recent_failure_count: 0- total_delivery_count: 0- successful_delivery_count: 0- failed_delivery_count: 0+ id: dz_UkLWZg9DAJ+ name: US North-East+ description:+ members:+ - id: dzm_UkLWZg9DAJ+ member_type: country+ postal_code_prefix:+ postal_code_from:+ postal_code_to:+ country_iso: US+ state_abbr:+ state_name:+ created_at: '2026-07-29T08:37:31.569Z'+ updated_at: '2026-07-29T08:37:31.569Z'+ - id: dzm_gbHJdmfrXB+ member_type: postal_code+ postal_code_prefix: '10'+ postal_code_from:+ postal_code_to:+ country_iso: US+ state_abbr:+ state_name:+ created_at: '2026-07-29T08:37:31.569Z'+ updated_at: '2026-07-29T08:37:31.569Z'+ created_at: '2026-07-29T08:37:31.568Z'+ updated_at: '2026-07-29T08:37:31.568Z'+ delivery_method_ids: []requestBody:content:application/json:schema:type: objectproperties:- reason:+ name:type: string- example: Investigating elevated 5xx rate+ example: US North-East+ description:+ type: string+ nullable: true+ members:+ type: array+ items:+ type: object+ properties:+ member_type:+ type: string+ enum:+ - country+ - state+ - postal_code+ country_iso:+ type: string+ nullable: true+ example: US+ state_abbr:+ type: string+ nullable: true+ postal_code_prefix:+ type: string+ nullable: true+ postal_code_from:+ type: string+ nullable: true+ postal_code_to:+ type: string+ nullable: true+ required:+ - member_type+ required:+ - nameservers:- url: http://{defaultHost}variables:@@ -22297,36 +24048,6 @@ components:- updated_at- customer_idx-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: trueAdminUser:type: objectproperties:@@ -22440,6 +24161,40 @@ components:- plaintext_token- created_by_emailx-typelizer: true+ AppliedPromotion:+ 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: trueCategory:type: objectproperties:@@ -22548,40 +24303,133 @@ components:type: stringcode:type: string- active:- type: boolean- default:- type: boolean- storefront_access:+ active:+ type: boolean+ default:+ type: boolean+ storefront_access:+ type: string+ guest_checkout:+ type: boolean+ preferred_order_routing_strategy:+ type: string+ nullable: true+ preferred_storefront_access:+ type: string+ nullable: true+ preferred_guest_checkout:+ type: boolean+ nullable: true+ created_at:+ type: string+ updated_at:+ type: string+ required:+ - id+ - name+ - code+ - active+ - default+ - storefront_access+ - guest_checkout+ - preferred_order_routing_strategy+ - preferred_storefront_access+ - preferred_guest_checkout+ - created_at+ - updated_at+ x-typelizer: true+ CollectionRule:+ type: object+ properties:+ id:+ type: string+ type:+ type: string+ value:+ type: string+ nullable: true+ match_policy:+ type: string+ required:+ - id+ - type+ - value+ - match_policy+ x-typelizer: true+ Collection:+ type: object+ properties:+ id:+ type: string+ name:+ type: string+ permalink:+ type: string+ position:+ type: number+ sort_order:+ type: string+ meta_title:+ type: string+ nullable: true+ meta_description:+ type: string+ nullable: true+ meta_keywords:+ type: string+ nullable: true+ products_count:+ type: number+ description:+ type: string+ description_html:type: string- guest_checkout:- type: boolean- preferred_order_routing_strategy:+ image_url:type: stringnullable: true- preferred_storefront_access:+ square_image_url:type: stringnullable: true- preferred_guest_checkout:+ custom_fields:+ type: array+ items:+ "$ref": "#/components/schemas/CustomField"+ translations:+ type: object+ automatic:type: boolean- nullable: true+ rules_match_policy:+ type: string+ metadata:+ type: objectcreated_at:type: stringupdated_at:type: string+ rules:+ type: array+ items:+ "$ref": "#/components/schemas/CollectionRule"required:- id- name- - code- - active- - default- - storefront_access- - guest_checkout- - preferred_order_routing_strategy- - preferred_storefront_access- - preferred_guest_checkout+ - permalink+ - position+ - sort_order+ - meta_title+ - meta_description+ - meta_keywords+ - products_count+ - description+ - description_html+ - image_url+ - square_image_url+ - automatic+ - rules_match_policy+ - metadata- created_at- updated_at+ - rulesx-typelizer: trueCountry:type: object@@ -22955,16 +24803,65 @@ components:code:type: stringnullable: true+ fulfillment_type:+ type: string+ estimated_transit_business_days_min:+ type: number+ nullable: true+ estimated_transit_business_days_max:+ type: number+ nullable: true+ admin_name:+ type: string+ nullable: true+ fulfillment_provider:+ type: string+ pickup_point_provider:+ type: string+ nullable: true+ storefront_visible:+ type: boolean+ tracking_url:+ type: string+ nullable: truecreated_at:type: stringupdated_at:type: string+ deleted_at:+ type: string+ tax_category_id:+ type: string+ nullable: true+ delivery_zone_ids:+ type: array+ items:+ type: string+ calculator_type:+ type: string+ nullable: true+ calculator_preferences:+ type: object+ nullable: truerequired:- id- name- code+ - fulfillment_type+ - estimated_transit_business_days_min+ - estimated_transit_business_days_max+ - admin_name+ - fulfillment_provider+ - pickup_point_provider+ - storefront_visible+ - tracking_url- created_at- updated_at+ - deleted_at+ - tax_category_id+ - delivery_zone_ids+ - calculator_type+ - calculator_preferencesx-typelizer: trueDeliveryRate:type: object@@ -23021,6 +24918,78 @@ components:- created_at- updated_atx-typelizer: true+ DeliveryZoneMember:+ type: object+ properties:+ id:+ type: string+ member_type:+ type: string+ postal_code_prefix:+ type: string+ nullable: true+ postal_code_from:+ type: string+ nullable: true+ postal_code_to:+ type: string+ nullable: true+ country_iso:+ type: string+ nullable: true+ state_abbr:+ type: string+ nullable: true+ state_name:+ type: string+ nullable: true+ created_at:+ type: string+ updated_at:+ type: string+ required:+ - id+ - member_type+ - postal_code_prefix+ - postal_code_from+ - postal_code_to+ - country_iso+ - state_abbr+ - state_name+ - created_at+ - updated_at+ x-typelizer: true+ DeliveryZone:+ type: object+ properties:+ id:+ type: string+ name:+ type: string+ description:+ type: string+ nullable: true+ members:+ type: array+ items:+ "$ref": "#/components/schemas/DeliveryZoneMember"+ created_at:+ type: string+ updated_at:+ type: string+ delivery_method_ids:+ type: array+ items:+ type: string+ required:+ - id+ - name+ - description+ - members+ - created_at+ - updated_at+ - delivery_method_ids+ x-typelizer: trueDigitalLink:type: objectproperties:@@ -23061,32 +25030,52 @@ components:properties:id:type: string- promotion_id:+ label:type: string- name:+ kind:type: string- description:+ code:type: stringnullable: true- code:+ value_type:+ type: string+ nullable: true+ value:+ type: string+ nullable: true+ promotion_id:+ type: string+ nullable: true+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:type: stringnullable: trueamount:type: stringdisplay_amount:type: string+ metadata:+ type: object+ nullable: truecreated_at:type: stringupdated_at:type: stringrequired:- id- - promotion_id- - name- - description+ - label+ - kind- code+ - value_type+ - value+ - promotion_id+ - line_item_id+ - fulfillment_id- amount- display_amount+ - metadata- created_at- updated_atx-typelizer: true@@ -23134,6 +25123,44 @@ components:- byte_size- download_urlx-typelizer: true+ Fee:+ type: object+ properties:+ id:+ type: string+ label:+ type: string+ kind:+ type: string+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:+ type: string+ nullable: true+ amount:+ type: string+ display_amount:+ type: string+ metadata:+ type: object+ nullable: true+ created_at:+ type: string+ updated_at:+ type: string+ required:+ - id+ - label+ - kind+ - line_item_id+ - fulfillment_id+ - amount+ - display_amount+ - metadata+ - created_at+ - updated_at+ x-typelizer: trueFulfillment:type: objectproperties:@@ -23147,6 +25174,12 @@ components:tracking_url:type: stringnullable: true+ pickup_point_data:+ type: object+ nullable: true+ selected_delivery_rate_id:+ type: string+ nullable: truecost:type: stringdisplay_cost:@@ -23208,15 +25241,13 @@ components:nullable: trueorder:"$ref": "#/components/schemas/Order"- adjustments:- type: array- items:- "$ref": "#/components/schemas/Adjustment"required:- id- number- tracking- tracking_url+ - pickup_point_data+ - selected_delivery_rate_id- cost- display_cost- total@@ -23621,10 +25652,6 @@ components:"$ref": "#/components/schemas/Variant"tax_category:"$ref": "#/components/schemas/TaxCategory"- adjustments:- type: array- items:- "$ref": "#/components/schemas/Adjustment"required:- id- variant_id@@ -24023,7 +26050,7 @@ components:discounts:type: arrayitems:- "$ref": "#/components/schemas/Discount"+ "$ref": "#/components/schemas/AppliedPromotion"items:type: arrayitems:@@ -24117,10 +26144,6 @@ components:"$ref": "#/components/schemas/Customer"created_by:"$ref": "#/components/schemas/Customer"- adjustments:- type: array- items:- "$ref": "#/components/schemas/Adjustment"return_authorizations:type: arrayitems:@@ -25491,6 +27514,59 @@ components:- created_at- updated_atx-typelizer: true+ TaxLine:+ type: object+ properties:+ id:+ type: string+ label:+ type: string+ included:+ type: boolean+ rate:+ type: string+ tax_rate_id:+ type: string+ nullable: true+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:+ type: string+ nullable: true+ fee_id:+ type: string+ nullable: true+ amount:+ type: string+ display_amount:+ type: string+ provider_id:+ type: string+ nullable: true+ metadata:+ type: object+ nullable: true+ created_at:+ type: string+ updated_at:+ type: string+ required:+ - id+ - label+ - included+ - rate+ - tax_rate_id+ - line_item_id+ - fulfillment_id+ - fee_id+ - amount+ - display_amount+ - provider_id+ - metadata+ - created_at+ - updated_at+ x-typelizer: trueVariant:type: objectproperties:diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yamlindex 7137b989c8..c9ffeb6859 100644--- a/docs/api-reference/store.yaml+++ b/docs/api-reference/store.yaml@@ -87,16 +87,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjI4ZTVkYTQyLThjZWEtNDIwNS1iYmQ0LWMzNTc0ZTRkMjczZCIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MTQ0ODc3fQ.-PUIDdgrQyum0e3zH6EIQARlL99DsucPmfayRDJD-ws- refresh_token: 2shuEh7LQ1ERU6h2ktqfsPJE+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6Ijg3ZmQ0ZGQ0LTVlMTMtNGQxMS1iZDZmLTJhYWY4OTVjODJmNiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MzE3OTQyfQ.MlaQ5cdUfaXq8bPSTOYmw-QXwEYV5gdla5kP5OUL6e8+ refresh_token: KBcBMjzd81z8Hq2fqus8Mgcvuser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Malka- last_name: Lubowitz+ first_name: Ingeborg+ last_name: Johnsphone:accepts_email_marketing: false- full_name: Malka Lubowitz+ full_name: Ingeborg Johnsavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses: []@@ -194,16 +194,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjgwZWUzMTc5LWFlZDktNGNjYy05MmFlLTYxNWViZmNhNGE2MyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MTQ0ODc4fQ.NbKXf5rwJfIMAQy5by2TBOEm2p3mRsMvgVvtzTPn6ao- refresh_token: kd8NnnTmm4ueAVYCWRhaZSSf+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjAwZGMzYjY0LTk1OTgtNGM4Yy04OWE0LWZmMTEwNmQwZmJkMyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MzE3OTQzfQ.dOyiA8fFVdvcqefLGpnSvHKPJ2z-O5vsGHxhN21EVzc+ refresh_token: PVQe1GaHuyw5mMoUg142jfXquser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Keira- last_name: Fay+ first_name: Deanna+ last_name: Champlinphone:accepts_email_marketing: false- full_name: Keira Fay+ full_name: Deanna Champlinavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses: []@@ -393,16 +393,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjgyOTFiMWI4LTQ2MzUtNGFmMy1iYzk0LTY4NGYzYWE3Y2Q5YyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MTQ0ODkwfQ.wh9fRHbT0WGKae7FV0p37gJRLorCt0uFPWBCTuWF0iY- refresh_token: DjwQbieiBWawP3ycCGrzv6xD+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjZjMDAzOWFkLTUwZjYtNDA4Yy05OTJlLTQ1M2YyYTA2MDIzNyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MzE3OTU1fQ.yFQB95mJztuA_QOkaMzAtMC-_Bf7MTHhZSy3qEZbPkQ+ refresh_token: eRi5ibnnooVqvCCg9zaeKDcduser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Lavone- last_name: Schulist+ first_name: Beula+ last_name: Bartonphone:accepts_email_marketing: false- full_name: Lavone Schulist+ full_name: Beula Bartonavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses: []@@ -879,8 +879,8 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 1238166- slug: product-1238166+ name: Product 1288469+ slug: product-1288469meta_title:meta_description:meta_keywords:@@ -892,23 +892,18 @@ paths:in_stock: falsebackorderable: trueavailable: true- description: Similique in sapiente consequatur nesciunt. Occaecati- aliquid quo quasi eaque dolorem beatae. Rerum qui rem laboriosam- suscipit. Odit debitis at excepturi ab inventore. Ipsam aspernatur- dolores provident maiores sed fuga deleniti ut. Saepe animi iure- quas vel ullam veritatis ipsa. Est sed ab officia fugit similique- odio ipsum quo. Id amet autem occaecati laboriosam incidunt ex- sint. Molestias architecto fuga sequi ut assumenda. Maxime distinctio- libero porro iure. Deleniti laborum quidem asperiores praesentium.- Beatae eligendi recusandae voluptatum dolorum placeat corrupti.- Dolorem voluptates quaerat incidunt repudiandae corporis rem ipsum.- Maxime occaecati vitae porro enim. Harum recusandae sequi id ratione.- Nam quia inventore nisi officiis minima.+ description: Nesciunt ipsum molestiae accusamus facere possimus+ libero nulla consequatur. In labore neque explicabo dignissimos+ possimus. Similique incidunt ducimus odio libero doloribus. Inventore+ odit sint reiciendis nostrum soluta officia quam. Magni laudantium+ assumenda fugit omnis. Commodi rerum blanditiis a doloribus labore+ soluta. Dolores voluptas sunt porro perspiciatis laudantium sequi.+ Quas sequi sit id illo fugit. Minima explicabo officia blanditiis+ perspiciatis distinctio consequatur. Eveniet facilis ipsum amet+ quia hic.description_html: |-- Similique in sapiente consequatur nesciunt. Occaecati aliquid quo quasi eaque dolorem beatae. Rerum qui rem laboriosam suscipit. Odit debitis at excepturi ab inventore. Ipsam aspernatur dolores provident maiores sed fuga deleniti ut.- Saepe animi iure quas vel ullam veritatis ipsa. Est sed ab officia fugit similique odio ipsum quo. Id amet autem occaecati laboriosam incidunt ex sint. Molestias architecto fuga sequi ut assumenda. Maxime distinctio libero porro iure.- Deleniti laborum quidem asperiores praesentium. Beatae eligendi recusandae voluptatum dolorum placeat corrupti. Dolorem voluptates quaerat incidunt repudiandae corporis rem ipsum.- Maxime occaecati vitae porro enim. Harum recusandae sequi id ratione. Nam quia inventore nisi officiis minima.+ Nesciunt ipsum molestiae accusamus facere possimus libero nulla consequatur. In labore neque explicabo dignissimos possimus. Similique incidunt ducimus odio libero doloribus. Inventore odit sint reiciendis nostrum soluta officia quam. Magni laudantium assumenda fugit omnis.+ Commodi rerum blanditiis a doloribus labore soluta. Dolores voluptas sunt porro perspiciatis laudantium sequi. Quas sequi sit id illo fugit. Minima explicabo officia blanditiis perspiciatis distinctio consequatur. Eveniet facilis ipsum amet quia hic.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -1063,8 +1058,8 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 1654288- slug: product-1654288+ name: Product 170241+ slug: product-170241meta_title:meta_description:meta_keywords:@@ -1093,8 +1088,8 @@ paths:price_list_id:original_price:- id: prod_gbHJdmfrXB- name: Product 1666705- slug: product-1666705+ name: Product 1715839+ slug: product-1715839meta_title:meta_description:meta_keywords:@@ -1106,19 +1101,20 @@ paths:in_stock: falsebackorderable: trueavailable: true- description: Veritatis porro rerum enim recusandae quam pariatur- voluptatibus suscipit. Enim ea dolorum quidem id esse. Aliquam- ad aperiam tempora inventore laborum maiores consequatur. Ducimus- soluta veritatis tempora dolores. Saepe iure beatae incidunt similique- doloremque. Eos voluptates ex quaerat nesciunt nihil modi dolor- culpa. Mollitia quidem suscipit in dolore libero voluptatem ratione.- Dolorem vel voluptatibus perferendis quia animi. Libero officia- commodi voluptas asperiores. Doloribus consequuntur dolorum quisquam- animi occaecati tempore dolor.+ description: Quas nobis explicabo magnam fugiat. Non fugiat cumque+ incidunt nam dolorum id in ad. Nemo laboriosam ipsum harum voluptas+ unde delectus animi. Autem quisquam odio consectetur natus sunt+ laborum qui. Velit sint pariatur ex quia. Facilis dolorem ex repudiandae+ mollitia tenetur. Nulla nisi excepturi voluptatum dolore blanditiis+ sapiente. Labore enim perferendis et reiciendis facilis nobis+ doloribus voluptatem. Minus repellendus repudiandae quas atque+ possimus totam. Error facilis aliquam doloribus sunt ratione.+ Quos dolore aut perspiciatis quod temporibus adipisci. Nihil occaecati+ dicta iste in explicabo laborum.description_html: |-- Veritatis porro rerum enim recusandae quam pariatur voluptatibus suscipit. Enim ea dolorum quidem id esse. Aliquam ad aperiam tempora inventore laborum maiores consequatur.- Ducimus soluta veritatis tempora dolores. Saepe iure beatae incidunt similique doloremque. Eos voluptates ex quaerat nesciunt nihil modi dolor culpa.- Mollitia quidem suscipit in dolore libero voluptatem ratione. Dolorem vel voluptatibus perferendis quia animi. Libero officia commodi voluptas asperiores. Doloribus consequuntur dolorum quisquam animi occaecati tempore dolor.+ Quas nobis explicabo magnam fugiat. Non fugiat cumque incidunt nam dolorum id in ad. Nemo laboriosam ipsum harum voluptas unde delectus animi. Autem quisquam odio consectetur natus sunt laborum qui.+ Velit sint pariatur ex quia. Facilis dolorem ex repudiandae mollitia tenetur. Nulla nisi excepturi voluptatum dolore blanditiis sapiente. Labore enim perferendis et reiciendis facilis nobis doloribus voluptatem. Minus repellendus repudiandae quas atque possimus totam.+ Error facilis aliquam doloribus sunt ratione. Quos dolore aut perspiciatis quod temporibus adipisci. Nihil occaecati dicta iste in explicabo laborum.default_variant_id: variant_EfhxLZ9ck8thumbnail_url:tags: []@@ -1220,8 +1216,8 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 1935443- slug: product-1935443+ name: Product 1989733+ slug: product-1989733meta_title:meta_description:meta_keywords:@@ -1255,7 +1251,7 @@ paths:amount_in_cents: 999currency: USDdisplay_amount: "$9.99"- recorded_at: '2026-07-12T08:35:26Z'+ recorded_at: '2026-07-14T08:39:52Z'schema:"$ref": "#/components/schemas/Product"'404':@@ -1358,13 +1354,21 @@ paths:count: 2sort_options:- id: manual+ label:- id: best_selling+ label:- id: price+ label:- id: "-price"+ label:- id: "-available_on"+ label:- id: available_on+ label:- id: name+ label:- id: "-name"+ label:schema:type: objectproperties:@@ -1493,14 +1497,14 @@ paths:example:data:- id: cart_gbHJdmfrXB- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R231436232- token: DF7cm2sHnWkhyiymT9M3e39eAoPM9djNiST- email: [email protected]+ number: JvMyQCGSVuYqfhEmhkfY669g+ token: JvMyQCGSVuYqfhEmhkfY669g+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -1515,24 +1519,33 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsecurrent_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_gbHJdmfrXB@@ -1541,8 +1554,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 983745- slug: product-983745+ name: Product 1032396+ slug: product-1032396options_text: ''price: '10.0'display_price: "$10.00"@@ -1565,114 +1578,32 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_gbHJdmfrXB- number: H25672180110- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_gbHJdmfrXB- variant_id: variant_gbHJdmfrXB- quantity: 1- delivery_method:- id: dm_gbHJdmfrXB- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Carson Purdy- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_gbHJdmfrXB- delivery_method_id: dm_gbHJdmfrXB- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_gbHJdmfrXB- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_uw2YK1rnl0- first_name: John- last_name: Doe- full_name: John Doe- address1: 107 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_OIJLhNcSbf- first_name: John- last_name: Doe- full_name: John Doe- address1: 108 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - en- id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R994045635- token: wwLfWkfohRi83QSuqVzfWH6hX4Fz1t4QveL- email: [email protected]+ number: LY8aLXHn487AtSm7SobkPDeQ+ token: LY8aLXHn487AtSm7SobkPDeQ+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -1687,24 +1618,33 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"- store_credit_total: '0'+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"+ store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsecurrent_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -1713,8 +1653,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 976073- slug: product-976073+ name: Product 1028357+ slug: product-1028357options_text: ''price: '10.0'display_price: "$10.00"@@ -1737,105 +1677,23 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H26659659316- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Carson Purdy- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 105 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 106 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enmeta:page: 1limit: 25@@ -1910,10 +1768,10 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R877344132- token: Jhd42A6dm2KmyAcZU8R7yq1MBM1RsJGEW27+ number: fmMt7J3xf67W1cwzc9SkCFDm+ token: fmMt7J3xf67W1cwzc9SkCFDmemail:customer_note:currency: USD@@ -1955,9 +1813,6 @@ paths:- step: addressfield: ship_addressmessage: Shipping address is required- - step: delivery- field: shipping_method- message: Select a shipping method for all shipmentsshipping_eq_billing_address: truediscounts: []items: []@@ -1968,6 +1823,16 @@ paths:payment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"requestBody:@@ -2067,18 +1932,18 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R784760157- token: Dh8LoLodddbtxHCheoYw3up6SjZ6C9RJJKj- email: [email protected]+ number: 3ge37zQRsbXCfZCFdLoCZRmP+ token: 3ge37zQRsbXCfZCFdLoCZRmP+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 0warnings:- code: line_item_removed- message: Product 1029179 was removed because it was sold out+ message: Product 107874 was removed because it was sold outline_item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJitem_total: '0.0'@@ -2110,55 +1975,32 @@ paths:- step: cartfield: line_itemsmessage: Add at least one item to your cart- - step: delivery- field: shipping_method- message: Select a shipping method for all shipments- shipping_eq_billing_address: false+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ shipping_eq_billing_address: truediscounts: []items: []fulfillments: []payments: []billing_address:- id: addr_UkLWZg9DAJ- first_name: John- last_name: Doe- full_name: John Doe- address1: 115 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_gbHJdmfrXB- first_name: John- last_name: Doe- full_name: John Doe- address1: 116 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'404':@@ -2167,7 +2009,7 @@ paths:application/json:example:error:- code: cart_not_found+ code: record_not_foundmessage: Cart not foundschema:"$ref": "#/components/schemas/ErrorResponse"@@ -2239,18 +2081,18 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R051796841- token: eqpqJqhKCCAKT9FJDRe3dLmobUqb4747xBZ- email: [email protected]+ number: Y2SEhiSZazrREtd7pYztmR3n+ token: Y2SEhiSZazrREtd7pYztmR3n+ email:customer_note: Leave at doorcurrency: USD- locale: en+ locale:total_quantity: 1warnings: []- item_total: '19.99'- display_item_total: "$19.99"+ item_total: '10.0'+ display_item_total: "$10.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"discount_total: '0.0'@@ -2261,26 +2103,33 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '29.99'- display_total: "$29.99"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '29.99'- display_amount_due: "$29.99"- delivery_total: '10.0'- display_delivery_total: "$10.00"+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false- current_step: payment- completed_steps:- - address- - delivery+ current_step: address+ completed_steps: []requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -2289,13 +2138,13 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1032314- slug: product-1032314+ name: Product 1084456+ slug: product-1084456options_text: ''- price: '19.99'- display_price: "$19.99"- total: '19.99'- display_total: "$19.99"+ price: '10.0'+ display_price: "$10.00"+ total: '10.0'+ display_total: "$10.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"additional_tax_total: '0.0'@@ -2304,114 +2153,32 @@ paths:display_included_tax_total: "$0.00"discount_total: '0.0'display_discount_total: "$0.00"- pre_tax_amount: '19.99'- display_pre_tax_amount: "$19.99"- discounted_amount: '19.99'- display_discounted_amount: "$19.99"+ pre_tax_amount: '10.0'+ display_pre_tax_amount: "$10.00"+ discounted_amount: '10.0'+ display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"compare_at_amount:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_gbHJdmfrXB- number: H71464598794- tracking:- tracking_url:- cost: '10.0'- display_cost: "$10.00"- total: '10.0'- display_total: "$10.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Wally Buckridge- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_gbHJdmfrXB- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '10.0'- total: '10.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$10.00"- display_total: "$10.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 119 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 120 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"requestBody:@@ -2587,14 +2354,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R661948308- token: zf38VkPJGWyPNvu4ao9UM8XynyYY3qpAzij- email: [email protected]+ number: 5B2GmvYpUpru4sR9QaudJtaS+ token: 5B2GmvYpUpru4sR9QaudJtaS+ email: [email protected]customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -2609,20 +2376,24 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false- current_step: address- completed_steps: []+ current_step: delivery+ completed_steps:+ - addressrequirements:+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method@@ -2635,8 +2406,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1056579- slug: product-1056579+ name: Product 1108129+ slug: product-1108129options_text: ''price: '10.0'display_price: "$10.00"@@ -2659,70 +2430,14 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H44008576003- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Joanie Sipes- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_UkLWZg9DAJ+ id: addr_gbHJdmfrXBfirst_name: Johnlast_name: Doefull_name: John Doe- address1: 125 Lovely Street+ address1: 122 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -2733,15 +2448,15 @@ paths:state_text: NYstate_abbr: NYquick_checkout: false- is_default_billing: false+ is_default_billing: trueis_default_shipping: falsestate_name: New Yorkshipping_address:- id: addr_gbHJdmfrXB+ id: addr_UkLWZg9DAJfirst_name: Johnlast_name: Doefull_name: John Doe- address1: 126 Lovely Street+ address1: 121 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -2753,11 +2468,21 @@ paths:state_abbr: NYquick_checkout: falseis_default_billing: false- is_default_shipping: false+ is_default_shipping: truestate_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'401':@@ -2833,19 +2558,19 @@ paths:application/json:example:id: or_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R827602836- email: [email protected]+ number: R453150540+ email: [email protected]customer_note:currency: USDlocale: entotal_quantity: 1fulfillment_status: backorderpayment_status: paid- completed_at: '2026-07-27T08:34:43.656Z'- item_total: '19.99'- display_item_total: "$19.99"+ completed_at: '2026-07-29T08:39:08.229Z'+ item_total: '10.0'+ display_item_total: "$10.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"discount_total: '0.0'@@ -2856,8 +2581,8 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '29.99'- display_total: "$29.99"+ total: '20.0'+ display_total: "$20.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"amount_due: '0.0'@@ -2869,19 +2594,19 @@ paths:covered_by_store_credit: falsediscounts: []items:- - id: li_UkLWZg9DAJ+ - id: li_gbHJdmfrXBvariant_id: variant_UkLWZg9DAJpreorder: falsepreorder_ships_at:quantity: 1currency: USD- name: Product 1086219- slug: product-1086219+ name: Product 11327+ slug: product-11327options_text: ''- price: '19.99'- display_price: "$19.99"- total: '19.99'- display_total: "$19.99"+ price: '10.0'+ display_price: "$10.00"+ total: '10.0'+ display_total: "$10.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"additional_tax_total: '0.0'@@ -2890,10 +2615,10 @@ paths:display_included_tax_total: "$0.00"discount_total: '0.0'display_discount_total: "$0.00"- pre_tax_amount: '19.99'- display_pre_tax_amount: "$19.99"- discounted_amount: '19.99'- display_discounted_amount: "$19.99"+ pre_tax_amount: '10.0'+ display_pre_tax_amount: "$10.00"+ discounted_amount: '10.0'+ display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"compare_at_amount:thumbnail_url:@@ -2901,9 +2626,11 @@ paths:digital_links: []fulfillments:- id: ful_gbHJdmfrXB- number: H93494385977+ number: F91603145627tracking:tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_gbHJdmfrXBcost: '10.0'display_cost: "$10.00"total: '10.0'@@ -2920,17 +2647,20 @@ paths:fulfillment_type: shippingfulfilled_at:items:- - item_id: li_UkLWZg9DAJ+ - item_id: li_gbHJdmfrXBvariant_id: variant_UkLWZg9DAJquantity: 1delivery_method:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Lili D'Amore+ name: Becki Rogahnaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2956,13 +2686,16 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-aee8a8926d3b- number: PMJDJ6NQ- amount: '29.99'- display_amount: "$29.99"+ response_code: BGS-4d6f43b92d81+ number: PFPFXGPZ+ amount: '20.0'+ display_amount: "$20.00"status: completedsource_type: credit_cardsource_id: card_UkLWZg9DAJ@@ -2983,11 +2716,11 @@ paths:session_required: falsesource_required: falsebilling_address:- id: addr_EfhxLZ9ck8+ id: addr_uw2YK1rnl0first_name: Johnlast_name: Doefull_name: John Doe- address1: 137 Lovely Street+ address1: 128 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -3002,11 +2735,11 @@ paths:is_default_shipping: falsestate_name: New Yorkshipping_address:- id: addr_VqXmZF31wY+ id: addr_OIJLhNcSbffirst_name: Johnlast_name: Doefull_name: John Doe- address1: 138 Lovely Street+ address1: 127 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -3022,6 +2755,16 @@ paths:state_name: New Yorkgift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Order"'422':@@ -3031,7 +2774,13 @@ paths:example:error:code: cart_cannot_complete- message: No payment found+ message: '{code: "validation_failed", errors: [{step: "address",+ field: "email", message: "Email address is required", code: "email_required"},+ {step: "address", field: "ship_address", message: "Shipping address+ is required", code: "ship_address_required"}, {step: "delivery",+ field: "shipping_method", message: "Select a shipping method for+ all shipments", code: "shipping_method_required"}, {step: "payment",+ field: "payment", message: "Add a payment method", code: "payment_required"}]}'schema:"$ref": "#/components/schemas/ErrorResponse""/api/v3/store/carts/{cart_id}/discount_codes":@@ -3097,14 +2846,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R420325156- token: zckVBSeBjbC7kypMZUsDk7PQPngrkQbWTAh- email: [email protected]+ number: AY3mRD9b1PpQ8s1sU8N9PTty+ token: AY3mRD9b1PpQ8s1sU8N9PTty+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -3119,24 +2868,30 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '100.0'- display_total: "$100.00"+ total: '0.0'+ display_total: "$0.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '100.0'- display_amount_due: "$100.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsecurrent_step: addresscompleted_steps: []requirements:- - step: payment- field: payment- message: Add a payment method- shipping_eq_billing_address: false+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments+ shipping_eq_billing_address: truediscounts:- id: discount_UkLWZg9DAJpromotion_id: promo_UkLWZg9DAJ@@ -3152,8 +2907,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1344050- slug: product-1344050+ name: Product 1392450+ slug: product-1392450options_text: ''price: '10.0'display_price: "$10.00"@@ -3167,8 +2922,8 @@ paths:display_included_tax_total: "$0.00"discount_total: "-10.0"display_discount_total: "-$10.00"- pre_tax_amount: '10.0'- display_pre_tax_amount: "$10.00"+ pre_tax_amount: '0.0'+ display_pre_tax_amount: "$0.00"discounted_amount: '0.0'display_discounted_amount: "$0.00"display_compare_at_amount: "$0.00"@@ -3176,105 +2931,23 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H00167913199- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Epifania Sanford- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 189 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 190 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'422':@@ -3360,14 +3033,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R517958825- token: 7PYcZnY85Y7zGEEvE5VLMwwecgGqbyTMGDj- email: [email protected]+ number: eYu5CkE6QtcaDdf2hW51Gb7B+ token: eYu5CkE6QtcaDdf2hW51Gb7B+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -3382,24 +3055,33 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsecurrent_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -3408,8 +3090,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 136888- slug: product-136888+ name: Product 141181+ slug: product-141181options_text: ''price: '10.0'display_price: "$10.00"@@ -3432,105 +3114,23 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H61181630054- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Verona Brakus- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 197 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 198 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'422':@@ -3605,14 +3205,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R280861113- token: bTUumNDZBWg5mVdrPwi7kyHVTaHBwriPC6E- email: [email protected]+ number: sXcs9P79ixxxaTjum4dyxqVr+ token: sXcs9P79ixxxaTjum4dyxqVr+ email: [email protected]customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -3627,14 +3227,14 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '20.0'+ display_total: "$20.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '20.0'+ display_amount_due: "$20.00"+ delivery_total: '10.0'+ display_delivery_total: "$10.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -3655,8 +3255,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1382983- slug: product-1382983+ name: Product 1431317+ slug: product-1431317options_text: ''price: '10.0'display_price: "$10.00"@@ -3681,13 +3281,15 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H76466218675- tracking: U10000+ number: F98440208788+ tracking:tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"+ pickup_point_data:+ selected_delivery_rate_id: dr_gbHJdmfrXB+ cost: '10.0'+ display_cost: "$10.00"+ total: '10.0'+ display_total: "$10.00"discount_total: '0.0'display_discount_total: "$0.00"additional_tax_total: '0.0'@@ -3707,10 +3309,13 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Vilma Gottlieb+ name: Rupert Coleaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -3718,17 +3323,17 @@ paths:country_name: United States of Americastate_text: NYdelivery_rates:- - id: dr_UkLWZg9DAJ+ - id: dr_gbHJdmfrXBdelivery_method_id: dm_UkLWZg9DAJname: UPS Groundselected: true- cost: '100.0'- total: '100.0'+ cost: '10.0'+ total: '10.0'additional_tax_total: '0.0'included_tax_total: '0.0'tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"+ display_cost: "$10.00"+ display_total: "$10.00"display_additional_tax_total: "$0.00"display_included_tax_total: "$0.00"display_tax_total: "$0.00"@@ -3736,32 +3341,17 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 205 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY+ id: addr_EfhxLZ9ck8first_name: Johnlast_name: Doefull_name: John Doe- address1: 206 Lovely Street+ address1: 185 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -3778,6 +3368,16 @@ paths:payment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'404':@@ -3787,7 +3387,7 @@ paths:example:error:code: record_not_found- message: Shipping rate not found+ message: Delivery rate not foundschema:"$ref": "#/components/schemas/ErrorResponse"requestBody:@@ -3866,14 +3466,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R821609071- token: QUU7N1xvSqjW1RHBGvceFD7paviVEgrLsJK- email: [email protected]+ number: rSQTRbemMU7aHq2DNBRTFJTu+ token: rSQTRbemMU7aHq2DNBRTFJTu+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -3888,21 +3488,30 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"- gift_card_total: '50.0'- display_gift_card_total: "$50.00"- amount_due: '60.0'- display_amount_due: "$60.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"- store_credit_total: '50.0'- display_store_credit_total: "-$50.00"- covered_by_store_credit: false+ total: '10.0'+ display_total: "$10.00"+ gift_card_total: '10.0'+ display_gift_card_total: "$10.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"+ store_credit_total: '10.0'+ display_store_credit_total: "-$10.00"+ covered_by_store_credit: truecurrent_step: addresscompleted_steps: []- requirements: []- shipping_eq_billing_address: false+ requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -3911,8 +3520,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1401630- slug: product-1401630+ name: Product 145214+ slug: product-145214options_text: ''price: '10.0'display_price: "$10.00"@@ -3935,127 +3544,35 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H88419915435- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Shaneka Crist- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260727083500970293- number: PCH0X6LY- amount: '50.0'- display_amount: "$50.00"+ response_code: 1-SC-20260729083926479739+ number: PCHT6D62+ amount: '10.0'+ display_amount: "$10.00"status: checkoutsource_type: store_creditsource_id: credit_UkLWZg9DAJsource:id: credit_UkLWZg9DAJ- amount: '50.0'+ amount: '10.0'amount_used: '0.0'- amount_remaining: '50.0'- display_amount: "$50.00"+ amount_remaining: '10.0'+ display_amount: "$10.00"display_amount_used: "$0.00"- display_amount_remaining: "$50.00"+ display_amount_remaining: "$10.00"currency: USD- payment_method:- id: pm_UkLWZg9DAJ- name: Store Credit- description:- type: store_credit- session_required: false- source_required: true- billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 213 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New York- shipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 214 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New York+ payment_method:+ id: pm_UkLWZg9DAJ+ name: Store Credit+ description:+ type: store_credit+ session_required: false+ source_required: true+ billing_address:+ shipping_address:payment_methods:- id: pm_UkLWZg9DAJname: Store Credit@@ -4069,17 +3586,27 @@ paths:status: activecurrency: USDamount: '50.0'- amount_used: '50.0'+ amount_used: '10.0'amount_authorized: '0.0'- amount_remaining: '0.0'+ amount_remaining: '40.0'display_amount: "$50.00"- display_amount_used: "$50.00"- display_amount_remaining: "$0.00"+ display_amount_used: "$10.00"+ display_amount_remaining: "$40.00"expires_at:redeemed_at:expired: falseactive: truemarket:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'404':@@ -4174,14 +3701,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R512800902- token: Jas8U9F4DWNKXFvTZBv6XZ5CL8jJnxq6QSi- email: [email protected]+ number: 53b7GnqS2Zfqb8rmBwt6cgv1+ token: 53b7GnqS2Zfqb8rmBwt6cgv1+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -4196,24 +3723,33 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsecurrent_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -4222,8 +3758,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1446305- slug: product-1446305+ name: Product 1491701+ slug: product-1491701options_text: ''price: '10.0'display_price: "$10.00"@@ -4246,81 +3782,25 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H72048537191- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Fletcher Spencer- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260727083503225026- number: P66ENJQB- amount: '50.0'- display_amount: "$50.00"+ response_code: 1-SC-20260729083928863243+ number: PMZH6L09+ amount: '10.0'+ display_amount: "$10.00"status: invalidsource_type: store_creditsource_id: credit_UkLWZg9DAJsource:id: credit_UkLWZg9DAJ- amount: '50.0'+ amount: '10.0'amount_used: '0.0'- amount_remaining: '50.0'- display_amount: "$50.00"+ amount_remaining: '10.0'+ display_amount: "$10.00"display_amount_used: "$0.00"- display_amount_remaining: "$50.00"+ display_amount_remaining: "$10.00"currency: USDpayment_method:id: pm_UkLWZg9DAJ@@ -4330,46 +3810,20 @@ paths:session_required: falsesource_required: truebilling_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 229 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 230 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart""/api/v3/store/carts/{cart_id}/items":@@ -4436,16 +3890,22 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R636007622- token: 69r23XQLhv8dwdqEbFooYLp2mhUkcZEGwVm- email: [email protected]+ number: iRVwYBBXyNgMgNBxPAfsUYWb+ token: iRVwYBBXyNgMgNBxPAfsUYWb+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 2- warnings: []+ warnings:+ - code: delivery_unavailable+ message: Product 152952 cannot be delivered to the selected address+ line_item_id: li_UkLWZg9DAJ+ - code: delivery_unavailable+ message: Product 1535555 cannot be delivered to the selected address+ line_item_id: li_gbHJdmfrXBitem_total: '29.99'display_item_total: "$29.99"adjustment_total: '0.0'@@ -4472,6 +3932,9 @@ paths:current_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required- step: addressfield: ship_addressmessage: Shipping address is required@@ -4481,7 +3944,7 @@ paths:- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -4490,8 +3953,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 147367- slug: product-147367+ name: Product 152952+ slug: product-152952options_text: ''price: '10.0'display_price: "$10.00"@@ -4520,8 +3983,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1482463- slug: product-1482463+ name: Product 1535555+ slug: product-1535555options_text: ''price: '19.99'display_price: "$19.99"@@ -4547,28 +4010,20 @@ paths:fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 244 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:payment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'404':@@ -4663,14 +4118,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R561740090- token: Lmzy7wcr3o44HY92D8N3taaWiRxEo3HDK7r- email: [email protected]+ number: t4qEMHA1Aexr7vmUJqzCMyD2+ token: t4qEMHA1Aexr7vmUJqzCMyD2+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 0warnings: []item_total: '0.0'@@ -4699,13 +4154,16 @@ paths:current_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required- step: addressfield: ship_addressmessage: Shipping address is required- step: deliveryfield: shipping_methodmessage: Select a shipping method for all shipments- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -4714,8 +4172,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 151753- slug: product-151753+ name: Product 1565550+ slug: product-1565550options_text: ''price: '10.0'display_price: "$10.00"@@ -4741,28 +4199,20 @@ paths:fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 253 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:payment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"requestBody:@@ -4837,14 +4287,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R961009318- token: G17eGUKntkx1qWU3JrZk61nNbnrH3QfhY2G- email: [email protected]+ number: wXtyH9iL1ReukEkwvNvpKPy6+ token: wXtyH9iL1ReukEkwvNvpKPy6+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 0warnings: []item_total: '0.0'@@ -4876,40 +4326,32 @@ paths:- step: cartfield: line_itemsmessage: Add at least one item to your cart+ - step: address+ field: email+ message: Email address is required- step: addressfield: ship_addressmessage: Shipping address is required- - step: delivery- field: shipping_method- message: Select a shipping method for all shipments- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items: []fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 256 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:payment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'404':@@ -4988,14 +4430,15 @@ paths:id: ps_gbHJdmfrXBstatus: pendingcurrency: USD- external_id: bogus_fbe71829f130b6ec14b94363+ external_id: bogus_b392fb78becfe3fa40ea34b7external_data:- client_secret: bogus_secret_7ee6170795ddbb44+ client_secret: bogus_secret_eaffce2131eb7802customer_external_id:expires_at:- amount: '110.0'+ amount: '10.0'payment_method_id: pm_UkLWZg9DAJ- order_id: or_UkLWZg9DAJ+ order_id: cart_UkLWZg9DAJ+ cart_id: cart_UkLWZg9DAJpayment_method:id: pm_UkLWZg9DAJname: Credit Card@@ -5088,14 +4531,15 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_4c9addcdd772c08374677937+ external_id: bogus_cfd176fddeac34093200cf6fexternal_data:client_secret: secret_123customer_external_id:expires_at:- amount: '110.0'+ amount: '10.0'payment_method_id: pm_UkLWZg9DAJ- order_id: or_UkLWZg9DAJ+ order_id: cart_UkLWZg9DAJ+ cart_id: cart_UkLWZg9DAJpayment_method:id: pm_UkLWZg9DAJname: Credit Card@@ -5150,14 +4594,15 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_9aecb1293929838db6f4f4c9+ external_id: bogus_655b9bfbd6544aa6b17b47f4external_data:client_secret: secret_123customer_external_id:expires_at:amount: '50.0'payment_method_id: pm_UkLWZg9DAJ- order_id: or_UkLWZg9DAJ+ order_id: cart_UkLWZg9DAJ+ cart_id: cart_UkLWZg9DAJpayment_method:id: pm_UkLWZg9DAJname: Credit Card@@ -5252,14 +4697,15 @@ paths:id: ps_UkLWZg9DAJstatus: completedcurrency: USD- external_id: bogus_053f4de83186ebb2769d5034+ external_id: bogus_a83fd72b70384797452063b6external_data:client_secret: secret_123customer_external_id:expires_at:- amount: '110.0'+ amount: '10.0'payment_method_id: pm_UkLWZg9DAJ- order_id: or_UkLWZg9DAJ+ order_id: cart_UkLWZg9DAJ+ cart_id: cart_UkLWZg9DAJpayment_method:id: pm_UkLWZg9DAJname: Credit Card@@ -5350,9 +4796,9 @@ paths:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJresponse_code:- number: PUL84XQ7- amount: '110.0'- display_amount: "$110.00"+ number: PYJVVHYA+ amount: '10.0'+ display_amount: "$10.00"status: checkoutsource_type:source_id:@@ -5455,14 +4901,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R315269833- token: e5T7Z9DMH6wfJSF5pg26HsB88bsdkHaDx8g- email: [email protected]+ number: rQkoYNxP6NAiv2bRoq8jhB67+ token: rQkoYNxP6NAiv2bRoq8jhB67+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -5477,21 +4923,30 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '100.0'- display_amount_due: "$100.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '0.0'+ display_amount_due: "$0.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '10.0'display_store_credit_total: "-$10.00"- covered_by_store_credit: false+ covered_by_store_credit: truecurrent_step: addresscompleted_steps: []- requirements: []- shipping_eq_billing_address: false+ requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -5500,8 +4955,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 213132- slug: product-213132+ name: Product 2184666+ slug: product-2184666options_text: ''price: '10.0'display_price: "$10.00"@@ -5524,68 +4979,12 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H04067904266- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Michal Langosh- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260727083531209896- number: PEDVV3AW+ response_code: 1-SC-20260729083957978743+ number: PVR6ORCWamount: '10.0'display_amount: "$10.00"status: checkout@@ -5608,43 +5007,7 @@ paths:session_required: falsesource_required: truebilling_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 340 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 341 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods:- id: pm_UkLWZg9DAJname: Store Credit@@ -5654,6 +5017,16 @@ paths:source_required: truegift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart"'422':@@ -5727,14 +5100,14 @@ paths:application/json:example:id: cart_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R461755970- token: WEmeTia2c1nKvHcc8Nd5DS7g44ngEFL5T2t- email: [email protected]+ number: Jp9gUDKENDePJqXVJ96MR4LH+ token: Jp9gUDKENDePJqXVJ96MR4LH+ email:customer_note:currency: USD- locale: en+ locale:total_quantity: 1warnings: []item_total: '10.0'@@ -5749,24 +5122,33 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '110.0'- display_total: "$110.00"+ total: '10.0'+ display_total: "$10.00"gift_card_total: '0.0'display_gift_card_total: "$0.00"- amount_due: '110.0'- display_amount_due: "$110.00"- delivery_total: '100.0'- display_delivery_total: "$100.00"+ amount_due: '10.0'+ display_amount_due: "$10.00"+ delivery_total: '0.0'+ display_delivery_total: "$0.00"store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: falsecurrent_step: addresscompleted_steps: []requirements:+ - step: address+ field: email+ message: Email address is required+ - step: address+ field: ship_address+ message: Shipping address is required+ - step: delivery+ field: shipping_method+ message: Select a shipping method for all shipments- step: paymentfield: paymentmessage: Add a payment method- shipping_eq_billing_address: false+ shipping_eq_billing_address: truediscounts: []items:- id: li_UkLWZg9DAJ@@ -5775,8 +5157,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 2154909- slug: product-2154909+ name: Product 2201123+ slug: product-2201123options_text: ''price: '10.0'display_price: "$10.00"@@ -5799,105 +5181,23 @@ paths:thumbnail_url:option_values: []digital_links: []- fulfillments:- - id: ful_UkLWZg9DAJ- number: H71308374993- tracking: U10000- tracking_url:- cost: '100.0'- display_cost: "$100.00"- total: '100.0'- display_total: "$100.00"- discount_total: '0.0'- display_discount_total: "$0.00"- additional_tax_total: '0.0'- display_additional_tax_total: "$0.00"- included_tax_total: '0.0'- display_included_tax_total: "$0.00"- tax_total: '0.0'- display_tax_total: "$0.00"- status: pending- fulfillment_type: shipping- fulfilled_at:- items:- - item_id: li_UkLWZg9DAJ- variant_id: variant_UkLWZg9DAJ- quantity: 1- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND- stock_location:- id: sloc_UkLWZg9DAJ- state_abbr: NY- name: Verline Kunde- address1: 1600 Pennsylvania Ave NW- city: Washington- zipcode: '20500'- country_iso: US- country_name: United States of America- state_text: NY- delivery_rates:- - id: dr_UkLWZg9DAJ- delivery_method_id: dm_UkLWZg9DAJ- name: UPS Ground- selected: true- cost: '100.0'- total: '100.0'- additional_tax_total: '0.0'- included_tax_total: '0.0'- tax_total: '0.0'- display_cost: "$100.00"- display_total: "$100.00"- display_additional_tax_total: "$0.00"- display_included_tax_total: "$0.00"- display_tax_total: "$0.00"- delivery_method:- id: dm_UkLWZg9DAJ- name: UPS Ground- code: UPS_GROUND+ fulfillments: []payments: []billing_address:- id: addr_EfhxLZ9ck8- first_name: John- last_name: Doe- full_name: John Doe- address1: 348 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkshipping_address:- id: addr_VqXmZF31wY- first_name: John- last_name: Doe- full_name: John Doe- address1: 349 Lovely Street- address2: Northwest- postal_code: '10118'- city: New York- phone: 555-555-0199- company: Company- country_name: United States of America- country_iso: US- state_text: NY- state_abbr: NY- quick_checkout: false- is_default_billing: false- is_default_shipping: false- state_name: New Yorkpayment_methods: []gift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Cart""/api/v3/store/orders/{id}":@@ -5970,9 +5270,9 @@ paths:application/json:example:id: or_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R294005223+ number: R911428384email: [email protected]customer_note:currency: USD@@ -5980,7 +5280,7 @@ paths:total_quantity: 1fulfillment_status:payment_status:- completed_at: '2026-07-27T08:35:14.500Z'+ completed_at: '2026-07-29T08:39:41.240Z'item_total: '10.0'display_item_total: "$10.00"adjustment_total: '0.0'@@ -6012,8 +5312,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1551533- slug: product-1551533+ name: Product 160863+ slug: product-160863options_text: ''price: '10.0'display_price: "$10.00"@@ -6038,9 +5338,11 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H26998320722+ number: F17081498428tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_gbHJdmfrXBcost: '100.0'display_cost: "$100.00"total: '100.0'@@ -6064,10 +5366,13 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Richard Berge+ name: Carolann McLaughlinaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6093,13 +5398,16 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:payments: []billing_address:id: addr_UkLWZg9DAJfirst_name: Johnlast_name: Doefull_name: John Doe- address1: 276 Lovely Street+ address1: 237 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6118,7 +5426,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 277 Lovely Street+ address1: 238 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6134,6 +5442,16 @@ paths:state_name: New Yorkgift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Order"'404':@@ -6208,7 +5526,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 78 Lovely Street+ address1: 88 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6226,7 +5544,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 77 Lovely Street+ address1: 87 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6244,7 +5562,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 76 Lovely Street+ address1: 86 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6493,7 +5811,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 90 Lovely Street+ address1: 100 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -6568,7 +5886,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 96 Lovely Street+ address1: 106 Lovely Streetaddress2: Northwestpostal_code: '10118'city: Los Angeles@@ -7003,17 +6321,17 @@ paths:example:data:- id: or_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R127800916- email: [email protected]+ number: R155250385+ email: [email protected]customer_note:currency: USDlocale: entotal_quantity: 1fulfillment_status:payment_status:- completed_at: '2026-07-27T08:34:51.087Z'+ completed_at: '2026-07-29T08:39:16.158Z'item_total: '10.0'display_item_total: "$10.00"adjustment_total: '0.0'@@ -7045,8 +6363,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1242905- slug: product-1242905+ name: Product 1297075+ slug: product-1297075options_text: ''price: '10.0'display_price: "$10.00"@@ -7071,9 +6389,11 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H44389704925+ number: F98098601128tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_gbHJdmfrXBcost: '100.0'display_cost: "$100.00"total: '100.0'@@ -7097,10 +6417,13 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Chastity Herzog+ name: Frederica Schowalteraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -7126,13 +6449,16 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:payments: []billing_address:id: addr_EfhxLZ9ck8first_name: Johnlast_name: Doefull_name: John Doe- address1: 157 Lovely Street+ address1: 145 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7151,7 +6477,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 158 Lovely Street+ address1: 146 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7167,6 +6493,16 @@ paths:state_name: New Yorkgift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enmeta:page: 1limit: 25@@ -7261,17 +6597,17 @@ paths:application/json:example:id: or_UkLWZg9DAJ- market_id:+ market_id: mkt_UkLWZg9DAJchannel_id: ch_UkLWZg9DAJ- number: R296955256- email: [email protected]+ number: R384682296+ email: [email protected]customer_note:currency: USDlocale: entotal_quantity: 1fulfillment_status:payment_status:- completed_at: '2026-07-27T08:34:51.718Z'+ completed_at: '2026-07-29T08:39:16.833Z'item_total: '10.0'display_item_total: "$10.00"adjustment_total: '0.0'@@ -7303,8 +6639,8 @@ paths:preorder_ships_at:quantity: 1currency: USD- name: Product 1264837- slug: product-1264837+ name: Product 1316030+ slug: product-1316030options_text: ''price: '10.0'display_price: "$10.00"@@ -7329,9 +6665,11 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H13887733205+ number: F82864692318tracking: U10000tracking_url:+ pickup_point_data:+ selected_delivery_rate_id: dr_gbHJdmfrXBcost: '100.0'display_cost: "$100.00"total: '100.0'@@ -7355,10 +6693,13 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Tera Berge+ name: Dian Runteaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -7384,13 +6725,16 @@ paths:id: dm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUND+ fulfillment_type: shipping+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:payments: []billing_address:id: addr_EfhxLZ9ck8first_name: Johnlast_name: Doefull_name: John Doe- address1: 163 Lovely Street+ address1: 151 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7409,7 +6753,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 164 Lovely Street+ address1: 152 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7425,6 +6769,16 @@ paths:state_name: New Yorkgift_card:market:+ id: mkt_UkLWZg9DAJ+ name: United States of America+ currency: USD+ default_locale: en+ tax_inclusive: false+ default: true+ country_isos:+ - US+ supported_locales:+ - enschema:"$ref": "#/components/schemas/Order"'404':@@ -7478,8 +6832,8 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjkxZTBmNzRkLTk0ZmQtNGFjMi04OTM3LTE1NjIxZTZkNmI5YiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MTQ0ODkzfQ.kAs6yYsxnV2J6redLrYHXYiIF0iUVXaq-JxsjOHVKQc- refresh_token: K6EXLYTz9XTZkttL1XYHysy7+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjE5ODM3YzgyLThkMGEtNDM1Yy04ZGRmLTRkNmJmZjVlNzc1OCIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg1MzE3OTU4fQ.QeoNJcoHRYznILHI652Gj2U_lERe1hbsmMzXvblMVxM+ refresh_token: Pfv5xCjvd1yoNfqEPfkPjAuduser:id: cus_UkLWZg9DAJemail: [email protected]@@ -7496,10 +6850,10 @@ paths:newsletter_subscriber:id: sub_UkLWZg9DAJemail: [email protected]- created_at: '2026-07-27T08:34:52.831Z'- updated_at: '2026-07-27T08:34:52.833Z'+ created_at: '2026-07-29T08:39:18.020Z'+ updated_at: '2026-07-29T08:39:18.021Z'verified: true- verified_at: '2026-07-27T08:34:52Z'+ verified_at: '2026-07-29T08:39:18Z'customer_id: cus_UkLWZg9DAJcustomer_groups: []schema:@@ -7602,12 +6956,12 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Herlinda- last_name: Haley+ email: [email protected]+ first_name: Wilma+ last_name: Breitenbergphone: 555-555-0199accepts_email_marketing: false- full_name: Herlinda Haley+ full_name: Wilma Breitenbergavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses:@@ -7615,7 +6969,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 170 Lovely Street+ address1: 158 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7633,7 +6987,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 169 Lovely Street+ address1: 157 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7652,7 +7006,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 170 Lovely Street+ address1: 158 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7671,7 +7025,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 169 Lovely Street+ address1: 157 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7743,7 +7097,7 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Updatedlast_name: Namephone: 555-555-0199@@ -7756,7 +7110,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 172 Lovely Street+ address1: 160 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7774,7 +7128,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 171 Lovely Street+ address1: 159 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7793,7 +7147,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 172 Lovely Street+ address1: 160 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7812,7 +7166,7 @@ paths:first_name: Johnlast_name: Doefull_name: John Doe- address1: 171 Lovely Street+ address1: 159 Lovely Streetaddress2: Northwestpostal_code: '10118'city: New York@@ -7934,7 +7288,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: 1BCAE9D2B0C1E652+ code: 1C43C8FDED0E917Cstatus: activecurrency: USDamount: '10.0'@@ -8030,7 +7384,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 5CC1D35D0BD33170+ code: A04D1606D8E69C2Fstatus: activecurrency: USDamount: '10.0'@@ -8102,8 +7456,8 @@ paths:example:id: pss_gbHJdmfrXBstatus: pending- external_id: bogus_seti_8f638585dffbd1739de14692- external_client_secret: bogus_seti_secret_775960a21436fea2+ external_id: bogus_seti_76f68ae73974121185b8b8dc+ external_client_secret: bogus_seti_secret_de3dc77d431a936bexternal_data: {}payment_method_id: pm_UkLWZg9DAJpayment_source_id:@@ -8202,8 +7556,8 @@ paths:example:id: pss_UkLWZg9DAJstatus: pending- external_id: seti_test_34d9f6d1dc28619a63889b60- external_client_secret: seti_secret_24d0f00a0f16441a19e2426b+ external_id: seti_test_36da84aba9ec7d0d376224c0+ external_client_secret: seti_secret_e1d367db1355a80bf5d9398bexternal_data:client_secret: secret_123payment_method_id: pm_UkLWZg9DAJ@@ -8279,8 +7633,8 @@ paths:example:id: pss_UkLWZg9DAJstatus: completed- external_id: seti_test_44dba00a8f369c80ec2bb1c4- external_client_secret: seti_secret_33daa67e62e12390f203e123+ external_id: seti_test_cf7a700626bf02039af42646+ external_client_secret: seti_secret_a965c4a904fd18248fff8d80external_data:client_secret: secret_123payment_method_id: pm_UkLWZg9DAJ@@ -8524,7 +7878,7 @@ paths:example:data:- iso: DE- iso3: IS42+ iso3: IS5name: Germanystates_required: falsezipcode_required: true@@ -8678,6 +8032,9 @@ paths:- iso_code: EURname: Eurosymbol: "€"+ - iso_code: GBP+ name: British Pound+ symbol: "£"schema:type: objectproperties:@@ -8837,12 +8194,12 @@ paths:- frcountries:- iso: DE- iso3: IS69+ iso3: IS15name: Germanystates_required: falsezipcode_required: true- iso: FR- iso3: IS70+ iso3: IS16name: Francestates_required: falsezipcode_required: true@@ -8924,12 +8281,12 @@ paths:- frcountries:- iso: DE- iso3: IS73+ iso3: IS19name: Germanystates_required: falsezipcode_required: true- iso: FR- iso3: IS74+ iso3: IS20name: Francestates_required: falsezipcode_required: true@@ -9007,12 +8364,12 @@ paths:- frcountries:- iso: DE- iso3: IS77+ iso3: IS23name: Germanystates_required: falsezipcode_required: true- iso: FR- iso3: IS78+ iso3: IS24name: Francestates_required: falsezipcode_required: true@@ -9076,12 +8433,12 @@ paths:example:data:- iso: FR- iso3: IS82+ iso3: IS28name: Francestates_required: falsezipcode_required: true- iso: DE- iso3: IS81+ iso3: IS27name: Germanystates_required: falsezipcode_required: true@@ -9221,7 +8578,7 @@ paths:data:- id: wl_UkLWZg9DAJname: My Wishlist- token: Jz7UrRcMxJa6wuwNWYtS4pfV+ token: XJsv41dUz4Yttd4JKgncTAqris_default: falseis_private: truemeta:@@ -9297,7 +8654,7 @@ paths:example:id: wl_gbHJdmfrXBname: Birthday Ideas- token: L1b4riEV9f6iE5QQf4wbGW4t+ token: uiWFi27Yi3eEkA3Z6UcZRc2Kis_default: falseis_private: trueschema:@@ -9398,7 +8755,7 @@ paths:example:id: wl_UkLWZg9DAJname: My Wishlist- token: cc2jr6tPbgBnWkM2Sb1U9FS3+ token: UaAqQBNAQJYeHV4XhLQCj2UVis_default: falseis_private: trueschema:@@ -9460,7 +8817,7 @@ paths:example:id: wl_UkLWZg9DAJname: Updated Name- token: CTVWekAzfaQzN1sjmqdVvCb9+ token: C6quXMSP6jcJK6ctGECfPAaZis_default: falseis_private: trueschema:@@ -9576,7 +8933,7 @@ paths:variant:id: variant_gbHJdmfrXBproduct_id: prod_gbHJdmfrXB- sku: SKU-263+ sku: SKU-268options_text: ''track_inventory: truemedia_count: 0@@ -9742,11 +9099,11 @@ paths:application/json:example:id: sub_UkLWZg9DAJ- email: [email protected]- created_at: '2026-07-27T08:35:10.174Z'- updated_at: '2026-07-27T08:35:10.175Z'+ email: [email protected]+ created_at: '2026-07-29T08:39:36.454Z'+ updated_at: '2026-07-29T08:39:36.455Z'verified: true- verified_at: '2026-07-27T08:35:10Z'+ verified_at: '2026-07-29T08:39:36Z'customer_id: cus_UkLWZg9DAJschema:"$ref": "#/components/schemas/NewsletterSubscriber"@@ -9825,10 +9182,10 @@ paths:example:id: sub_UkLWZg9DAJemail: [email protected]- created_at: '2026-07-27T08:35:10.196Z'- updated_at: '2026-07-27T08:35:10.200Z'+ created_at: '2026-07-29T08:39:36.473Z'+ updated_at: '2026-07-29T08:39:36.476Z'verified: true- verified_at: '2026-07-27T08:35:10Z'+ verified_at: '2026-07-29T08:39:36Z'customer_id:schema:"$ref": "#/components/schemas/NewsletterSubscriber"@@ -9998,7 +9355,7 @@ paths:body_html: ''- id: pol_OIJLhNcSbfname: Privacy Policy- slug: privacy-policy-dee83a06-d73e-4b72-865e-4c440f69be1e+ slug: privacy-policy-afe33a07-e789-445a-8f78-90a6dc08a432body: We respect your privacy.body_html: |<div class="trix-content">@@ -10233,6 +9590,122 @@ paths:message: Valid API key requiredschema:"$ref": "#/components/schemas/ErrorResponse"+ "/api/v3/store/delivery_methods":+ get:+ summary: List delivery methods+ tags:+ - Delivery+ security:+ - api_key: []+ description: Storefront-visible delivery methods. Filter by fulfillment_type+ to discover pickup options.+ x-codeSamples:+ - lang: javascript+ label: Spree SDK+ source: |-+ import { createClient } from '@spree/sdk'++ const client = createClient({+ baseUrl: 'https://your-store.com',+ publishableKey: '<api-key>',+ })++ const { data: pickupMethods } = await client.deliveryMethods.list({+ fulfillment_type: 'pickup',+ })+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: fulfillment_type+ in: query+ required: false+ description: 'Filter: shipping, digital, pickup, pickup_point'+ schema:+ type: string+ responses:+ '200':+ description: delivery methods found+ content:+ application/json:+ example:+ data:+ - id: dm_gbHJdmfrXB+ name: Store pickup+ code: UPS_GROUND+ fulfillment_type: pickup+ estimated_transit_business_days_min:+ estimated_transit_business_days_max:+ meta:+ page: 1+ limit: 25+ count: 1+ pages: 1+ from: 1+ to: 1+ in: 1+ previous:+ next:+ "/api/v3/store/delivery_methods/{id}/pickup_locations":+ get:+ summary: List pickup locations+ tags:+ - Delivery+ security:+ - api_key: []+ description: Pickup-enabled stock locations for a pickup delivery method. Pass+ cart_id to keep only locations that can fulfill the whole cart from local+ stock.+ x-codeSamples:+ - lang: javascript+ label: Spree SDK+ source: |-+ import { createClient } from '@spree/sdk'++ const client = createClient({+ baseUrl: 'https://your-store.com',+ publishableKey: '<api-key>',+ })++ const { data: pickupLocations } = await client.deliveryMethods.pickupLocations('dm_abc123', {+ cart_id: 'cart_abc123',+ })+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Delivery method prefixed ID+ schema:+ type: string+ - name: cart_id+ in: query+ required: false+ description: Cart prefixed ID for availability filtering+ schema:+ type: string+ responses:+ '200':+ description: pickup locations found+ content:+ application/json:+ example:+ data:+ - id: sloc_UkLWZg9DAJ+ state_abbr: STATE_ABBR_91+ name: Downtown+ address1: 1600 Pennsylvania Ave NW+ city: Washington+ zipcode: '20500'+ country_iso: US+ country_name: United States of America+ state_text: STATE_ABBR_91servers:- url: http://{defaultHost}variables:@@ -10658,6 +10131,36 @@ components:- is_default_shipping- state_namex-typelizer: true+ AppliedPromotion:+ 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+ nullable: true+ display_amount:+ type: string+ nullable: true+ required:+ - id+ - promotion_id+ - name+ - description+ - code+ - amount+ - display_amount+ x-typelizer: trueBase:type: objectproperties:@@ -10781,7 +10284,7 @@ components:discounts:type: arrayitems:- "$ref": "#/components/schemas/Discount"+ "$ref": "#/components/schemas/AppliedPromotion"items:type: arrayitems:@@ -11203,10 +10706,21 @@ components:code:type: stringnullable: true+ fulfillment_type:+ type: string+ estimated_transit_business_days_min:+ type: number+ nullable: true+ estimated_transit_business_days_max:+ type: number+ nullable: truerequired:- id- name- code+ - fulfillment_type+ - estimated_transit_business_days_min+ - estimated_transit_business_days_maxx-typelizer: trueDeliveryRate:type: object@@ -11258,6 +10772,61 @@ components:- display_tax_total- delivery_methodx-typelizer: true+ DeliveryZoneMember:+ type: object+ properties:+ id:+ type: string+ member_type:+ type: string+ postal_code_prefix:+ type: string+ nullable: true+ postal_code_from:+ type: string+ nullable: true+ postal_code_to:+ type: string+ nullable: true+ country_iso:+ type: string+ nullable: true+ state_abbr:+ type: string+ nullable: true+ state_name:+ type: string+ nullable: true+ required:+ - id+ - member_type+ - postal_code_prefix+ - postal_code_from+ - postal_code_to+ - country_iso+ - state_abbr+ - state_name+ x-typelizer: true+ DeliveryZone:+ type: object+ properties:+ id:+ type: string+ name:+ type: string+ description:+ type: string+ nullable: true+ members:+ type: array+ items:+ "$ref": "#/components/schemas/DeliveryZoneMember"+ required:+ - id+ - name+ - description+ - members+ x-typelizer: trueDigitalLink:type: objectproperties:@@ -11310,14 +10879,26 @@ components:properties:id:type: string- promotion_id:+ label:type: string- name:+ kind:type: string- description:+ code:type: stringnullable: true- code:+ value_type:+ type: string+ nullable: true+ value:+ type: string+ nullable: true+ promotion_id:+ type: string+ nullable: true+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:type: stringnullable: trueamount:@@ -11328,10 +10909,44 @@ components:nullable: truerequired:- id- - promotion_id- - name- - description+ - label+ - kind- code+ - value_type+ - value+ - promotion_id+ - line_item_id+ - fulfillment_id+ - amount+ - display_amount+ x-typelizer: true+ Fee:+ type: object+ properties:+ id:+ type: string+ label:+ type: string+ kind:+ type: string+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:+ type: string+ nullable: true+ amount:+ type: string+ nullable: true+ display_amount:+ type: string+ nullable: true+ required:+ - id+ - label+ - kind+ - line_item_id+ - fulfillment_id- amount- display_amountx-typelizer: true@@ -11348,6 +10963,12 @@ components:tracking_url:type: stringnullable: true+ pickup_point_data:+ type: object+ nullable: true+ selected_delivery_rate_id:+ type: string+ nullable: truecost:type: stringnullable: true@@ -11408,6 +11029,8 @@ components:- number- tracking- tracking_url+ - pickup_point_data+ - selected_delivery_rate_id- cost- display_cost- total@@ -12007,7 +11630,7 @@ components:discounts:type: arrayitems:- "$ref": "#/components/schemas/Discount"+ "$ref": "#/components/schemas/AppliedPromotion"items:type: arrayitems:@@ -12181,6 +11804,10 @@ components:type: stringorder_id:type: string+ nullable: true+ cart_id:+ type: string+ nullable: truepayment_method:"$ref": "#/components/schemas/PaymentMethod"payment:@@ -12196,6 +11823,7 @@ components:- amount- payment_method_id- order_id+ - cart_id- payment_methodx-typelizer: truePaymentSetupSession:@@ -12485,8 +12113,12 @@ components:properties:id:type: string+ label:+ type: string+ nullable: truerequired:- id+ - labelx-typelizer: trueProductFilters:type: object@@ -12858,6 +12490,47 @@ components:- display_amount_remaining- currencyx-typelizer: true+ TaxLine:+ type: object+ properties:+ id:+ type: string+ label:+ type: string+ included:+ type: boolean+ rate:+ type: string+ tax_rate_id:+ type: string+ nullable: true+ line_item_id:+ type: string+ nullable: true+ fulfillment_id:+ type: string+ nullable: true+ fee_id:+ type: string+ nullable: true+ amount:+ type: string+ nullable: true+ display_amount:+ type: string+ nullable: true+ required:+ - id+ - label+ - included+ - rate+ - tax_rate_id+ - line_item_id+ - fulfillment_id+ - fee_id+ - amount+ - display_amount+ x-typelizer: trueVariant:type: objectproperties:diff --git a/docs/plans/6.0-core-rewrite-tasks.md b/docs/plans/6.0-core-rewrite-tasks.mdindex 03448eb429..bac8ca1f91 100644--- a/docs/plans/6.0-core-rewrite-tasks.md+++ b/docs/plans/6.0-core-rewrite-tasks.md@@ -158,7 +158,7 @@ Runs after Wave 2 (tables born with `fulfillment_id`). Can proceed in parallel w- [x] FreeShipping → fulfillment-attached `Discount`, persisted **even at zero**; `Order#has_free_shipping?` tests row existence.- [x] Order-level discount distribution: largest-remainder, prorated over each line's *remaining discounted* base, weights frozen at placement.- [x] Manual paths: `Discount(kind: 'manual')` (line-targeted or order-distributed) and `Fee` (order-level or attached); ad-hoc credits are manual Discounts, never negative Fees.-- [x] Promotion STI namespace rename rides here: `Spree::Promotion::Rules::*`→`Spree::PromotionRules::*`, `Actions::*`→`PromotionActions::*`, `CreateItemAdjustments`→`CreateItemDiscounts` (one-release aliases; `type`-column data task in Wave 7).+- [x] ~~Promotion STI namespace rename~~ **REVERTED in Wave 6 (2026-07-29, Damian):** promotion rule/action class names stay `Spree::Promotion::Rules::*` / `Spree::Promotion::Actions::*` (incl. `CreateItemAdjustments`) — the rename wasn't required by the split; typed-Discount behavior kept under the legacy names. No STI type-column data task needed.### T3.4 Minimal TaxProvider (the sanctioned TaxLine writer)- [x] `Spree::TaxProvider::Base` (estimate required; commit/void/refund no-op stubs; `exempt?` default) + `Spree::TaxProvider::Internal` computing directly from TaxRate data (rate × discounted base; VAT included-in-price math) — **no `Calculator::DefaultTax` indirection**; zone matching stays as today (`TaxRate.match` over `Spree::Zone`) until the tax plan decouples it.@@ -255,28 +255,42 @@ The point of no return; biggest single wave. Everything before it exists so this## Wave 6 — API / SDK / Dashboard / emails / docs+### Wave 6 outcome notes (2026-07-29 — COMPLETE)++**Backend (T6.1/T6.2).** Admin nested `/orders/:id/{tax_lines,discounts,fees}` (tax read-only; discounts manual-CRUD with `422 discount_not_editable` on promotion rows; fees full CRUD, `kind` defaults `surcharge`) — all mutations run `OrderUpdater#resum_typed_totals!`, the sanctioned post-placement edit path (re-sums rows into totals WITHOUT re-running promotion competition/tax estimation; works on completed orders). `Spree::Orders::AddManualDiscount` (DI `order_add_manual_discount_service`) computes flat/percent line-item rows or distributes order-level via the extracted `Spree::Adjusters::LargestRemainder`. Net-new admin `delivery_methods` CRUD (+`/calculators` discovery with preference schemas; flat `calculator_type`/`calculator_preferences` params; prefixed `tax_category_id`/`delivery_zone_ids`) + `delivery_zones` CRUD (typed members by `country_iso`/`state_abbr`/postal prefix-or-range; `members` replaces the set atomically). Store `delivery_methods` discovery (`storefront_visible` scope, `fulfillment_type` filter) + `/:id/pickup_locations` (pickup-enabled stock locations, `cart_id` narrows to full-cart local coverage) + `/:id/pickup_points?latitude&longitude` via `DeliveryMethod#pickup_point_provider_instance`. Cart pickup selection: `preferred_stock_location_id` — **a preference (`preference :stock_location_id`), not a column (Damian 2026-07-29)** — prefixed-ID writer validating pickup_enabled, copied to the order column at completion; `pickup_point_external_id` on cart fulfillment update validated via provider and frozen into `pickup_point_data`. FulfillmentSerializer: `status` column-backed, `fulfillment_type` column-with-fallback, `pickup_point_data` + `selected_delivery_rate_id` exposed, real-name associations. Admin orders scope excludes transient completion drafts (`draft` + `cart_id` set). `AppliedPromotionSerializer` rename frees `DiscountSerializer` (+`TaxLine`/`Fee`/`DeliveryZone`/`DeliveryZoneMember` serializers, registry keys, payment-session serializer gets `cart_id` + owner-bridged `order_id`). `ConfigurationManagement` grants DeliveryMethod/DeliveryZone/Member.++**Directives landed mid-wave (Damian):** (1) `market` + `channel` **required** on Cart AND Order (`belongs_to` without optional). Supporting invariant: **every store owns a bootstrap default market** — `Stores::Markets#ensure_default_market` is unconditional (country fallback: creation param → legacy default_country column → US, created if the countries table is empty), inherits the store's column configuration (currency/locale/supported_locales), and is flagged `bootstrap_default` so the MarketCountry shipping-coverage validation skips it (plus a `DeliveryMethod.none?` bootstrap exemption). Store column edits to default_locale/default_currency **sync onto the default market** (diff-based, not dirty-tracking); `supported_currencies_list`/`supported_locales_list` are now the **union of markets + legacy columns**; `Market#ensure_single_default` resets the owning store's association caches; markets cascade-delete with their store via `destroyed_by_association`; `Current.market` always resolves. `defined_preferences` no longer picks up `preferred_*` association writers (Order#preferred_stock_location= phantom), preference readers/writers tolerate NULL preferences columns. (2) **Promotion STI namespace rename REVERTED** — classes stay `Spree::Promotion::Rules::*`/`Spree::Promotion::Actions::*` incl. `CreateItemAdjustments` (typed-Discount behavior under legacy names; wire type back to `create_item_adjustments`; single calculator registry key; T7.5 type-column task dropped; decisions.md 2026-03-16 marked reversed). (3) Cart totals columns get **DB-level defaults** (0/0.0) in migration 100001; dummy apps rebuilt. (4) `preferred_stock_location_id` on Cart is a **preference** (`preference :stock_location_id`), not a column — migration dropped. (5) `docs/developer` updates skipped (full Spree 6 docs rewrite comes separately).++**Final gates after directives:** core 7438/0, api 2525/0, emails 103/0 (all parallel where applicable), dashboard tsc+vitest+e2e green, both SDK suites green.++**Emails (T6.4).** `FulfillmentMailer#fulfilled_email` + views; `ShipmentMailer#shipped_email` deprecated delegate; `FulfillmentEmailSubscriber` on `fulfillment.fulfilled` (replaces the shipment subscriber — dual-emit means one subscription only); `FulfillmentHelper` + deprecated ShipmentHelper; FulfillmentPreview; partials on real names; payment-link email → storefront `/checkout/:token/payment` URL; `fulfillment_mailer.*` locale keys (legacy keys kept one release).++**SDK + Dashboard (T6.3).** admin-sdk: `orders.{taxLines,discounts,fees}` replace `orders.adjustments` (removed clean), `deliveryMethods` (+`calculators()`), `deliveryZones`, `DeliveryMethodParams`/`DeliveryZoneParams`; sdk: `deliveryMethods.{list,get,pickupLocations,pickupPoints}`; typelizer + Zod + OpenAPI (store+admin) regenerated; both SDK test suites green. Dashboard: order-detail `AdjustmentLinesCard` (tax grouped by label, discounts with promo lock, fees; Add discount flat/percent + order/line target; Add fee) on store-scoped query keys; settings pages Delivery Methods (fulfillment_type-aware form, calculator discovery-driven preference fields, zone checkboxes, transit days, storefront_visible) + Delivery Zones (typed member editor incl. postal prefix/range) with tables/hooks/schemas/nav (`Subject.DeliveryMethod`/`DeliveryZone`); webhook event groups shipment→fulfillment; `section_fulfillments` label; i18n in all 6 locales (en/de/fr/zh-CN/ar/pl); e2e `delivery-settings.spec.ts` 4/4 (real API create paths; surfaced + fixed the missing-calculator 422 via model-level FlatRate(0) default).++**Docs (T6.5).** SKIPPED per Damian (2026-07-29): `docs/developer` gets a full Spree 6 rewrite separately — no incremental doc edits now. Only CLAUDE.md plan statuses + `docs/plans/*` updated; `docs/api-reference/*.yaml` regenerated (build artifact of the rswag pipeline, not docs work).+### T6.1 Store API v3-- [ ] `carts/fulfillments_controller` requirements-driven (drop the `cart.next` loop); completion endpoint returns the Wave-5 contract.-- [ ] Pickup flows: `GET /store/delivery_methods?fulfillment_type=pickup`, `…/:id/pickup_locations` (pickup-enabled StockLocations, **package-scoped** stock), `…/:id/pickup_points?latitude&longitude`; selection writes `Order#preferred_stock_location_id` (routing rule) / validated `pickup_point_external_id` frozen into `pickup_point_data`.-- [ ] `FulfillmentSerializer#fulfillment_type` computed → column-backed; `storefront_visible` exposure; `ready_for_pickup` returned as its own status (Decision 7).+- [x] `carts/fulfillments_controller` requirements-driven (drop the `cart.next` loop); completion endpoint returns the Wave-5 contract.+- [x] Pickup flows: `GET /store/delivery_methods?fulfillment_type=pickup`, `…/:id/pickup_locations` (pickup-enabled StockLocations, **package-scoped** stock), `…/:id/pickup_points?latitude&longitude`; selection writes `Order#preferred_stock_location_id` (routing rule) / validated `pickup_point_external_id` frozen into `pickup_point_data`.+- [x] `FulfillmentSerializer#fulfillment_type` computed → column-backed; `storefront_visible` exposure; `ready_for_pickup` returned as its own status (Decision 7).### T6.2 Admin API v3-- [ ] `/admin/orders/:id/{tax_lines,discounts,fees}` replace `/admin/orders/:id/adjustments`: tax_lines read-only; discounts/fees full CRUD for manual rows (promotion-sourced rows 422 on edit); mutations run recalculation on the changed base — this **is** the sanctioned post-placement edit path and works on completed orders.-- [ ] Net-new `delivery_methods` CRUD controller (none exists today) + nested `delivery_method_stock_locations`; `delivery_zones` CRUD with typed members.-- [ ] Fulfillments admin surface completed (create via `Fulfillments::Create`, ready/fulfill/cancel/track through providers); admin Drafts list scoped `cart_id: nil`; status filters (`status`/`payment_status`/`fulfillment_status`).-- [ ] Scopes (`read_orders`/`write_orders`, delivery settings scopes) + CanCanCan abilities on the typed models.+- [x] `/admin/orders/:id/{tax_lines,discounts,fees}` replace `/admin/orders/:id/adjustments`: tax_lines read-only; discounts/fees full CRUD for manual rows (promotion-sourced rows 422 on edit); mutations run recalculation on the changed base — this **is** the sanctioned post-placement edit path and works on completed orders.+- [x] Net-new `delivery_methods` CRUD controller (none exists today) + nested `delivery_method_stock_locations`; `delivery_zones` CRUD with typed members.+- [x] Fulfillments admin surface completed (create via `Fulfillments::Create`, ready/fulfill/cancel/track through providers); admin Drafts list scoped `cart_id: nil`; status filters (`status`/`payment_status`/`fulfillment_status`).+- [x] Scopes (`read_orders`/`write_orders`, delivery settings scopes) + CanCanCan abilities on the typed models.### T6.3 SDK + Dashboard-- [ ] admin-sdk: `orders.{taxLines,discounts,fees}` replacing `orders.adjustments` (unreleased — break cleanly); `deliveryMethods`, `deliveryZones`; fulfillments updates. Full type pipeline: typelizer → Zod → integration specs → `rswag:specs:swaggerize` → SDK tests.-- [ ] Dashboard order detail: typed panels (tax grouped by rate/label, discounts, fees) + "Add fee"/"Add discount" (amount-or-percent via `value`/`value_type`, target picker order/line), `<Can>`-gated, RHF + Zod + `mapSpreeErrorsToForm`; fulfillment vocabulary + status/actions sweep (remaining `shipment` refs: `orders/$orderId.tsx`, `schemas/webhook-endpoint.ts` event list — dual-emit names).-- [ ] Dashboard settings: Delivery Methods page (fulfillment_type, provider selects, pickup locations, `storefront_visible`, zone picker) and Delivery Zones page (typed member editor incl. postal ranges/prefixes).-- [ ] i18n keys in **all** locale files (en/de/fr/zh-CN/ar/pl, dashboard + dashboard-core); e2e specs for the new pages.+- [x] admin-sdk: `orders.{taxLines,discounts,fees}` replacing `orders.adjustments` (unreleased — break cleanly); `deliveryMethods`, `deliveryZones`; fulfillments updates. Full type pipeline: typelizer → Zod → integration specs → `rswag:specs:swaggerize` → SDK tests.+- [x] Dashboard order detail: typed panels (tax grouped by rate/label, discounts, fees) + "Add fee"/"Add discount" (amount-or-percent via `value`/`value_type`, target picker order/line), `<Can>`-gated, RHF + Zod + `mapSpreeErrorsToForm`; fulfillment vocabulary + status/actions sweep (remaining `shipment` refs: `orders/$orderId.tsx`, `schemas/webhook-endpoint.ts` event list — dual-emit names).+- [x] Dashboard settings: Delivery Methods page (fulfillment_type, provider selects, pickup locations, `storefront_visible`, zone picker) and Delivery Zones page (typed member editor incl. postal ranges/prefixes).+- [x] i18n keys in **all** locale files (en/de/fr/zh-CN/ar/pl, dashboard + dashboard-core); e2e specs for the new pages.### T6.4 Emails-- [ ] Fulfillment vocabulary sweep (~20 files: `shipment_mailer` → fulfillment, subscriber, templates); `_purchased_items_table` partials iterate typed associations (no `.eligible`/`source_type`); payment-link email `checkout_state_url(token, :payment)` → cart checkout URL.+- [x] Fulfillment vocabulary sweep (~20 files: `shipment_mailer` → fulfillment, subscriber, templates); `_purchased_items_table` partials iterate typed associations (no `.eligible`/`source_type`); payment-link email `checkout_state_url(token, :payment)` → cart checkout URL.### T6.5 Docs + guides-- [ ] `adjustments.mdx` rewritten for typed models; `custom-promotion.mdx` (adjusters write Discount/Fee); checkout/requirements docs; **extension migration guide** (`checkout_flow` → `Checkout::Registry`; `ShipmentHandler` → FulfillmentProvider; `shipment.*` → `fulfillment.*` webhooks); CSV import/export `shipping_category` mapping + deprecation window; CLAUDE.md plan-status updates.+- [x] ~~developer docs updates~~ dropped — full Spree 6 docs rewrite happens separately (Damian 2026-07-29); CLAUDE.md plan-status updates done.---@@ -288,7 +302,7 @@ All batched, idempotent, resumable. They read legacy structures that stay in pla- [ ] **T7.2 `spree:migrate_zones_to_delivery_zones`**: shipping-referenced Zones → DeliveryZones (name/description + country/state members); tax-only zones left for the tax plan; unreferenced zones logged + skipped.- [ ] **T7.3 Adjustments → typed rows**: mapping table per plan (TaxRate→TaxLine w/ rate copy + `provider_id: 'internal'`; eligible PromotionAction→Discount w/ snapshots; ineligible skipped; nil-source by sign → manual Discount / order-level Fee `'surcharge'`; ReturnAuthorization skipped + order marked recalculation-frozen; unknown sources → Fee with class in metadata); order-level rows distributed largest-remainder; **order totals byte-for-byte untouched**; per-order reconciliation asserts typed sums match legacy totals (non-reconciling orders logged + frozen, never force-balanced); line-level shift logging.- [ ] **T7.4 Incomplete orders → Carts**: one Cart per incomplete order (token/binding/addresses); line items re-owned (`cart_id` set, `order_id` nulled); hollow order rows deleted; mid-payment orders converted **last** with payment sessions re-linked; completed orders untouched (`cart_id: nil`).-- [ ] **T7.5 Small companions**: promotion rules/actions STI `type`-column task (`Spree::Promotion::Rules::*` → `Spree::PromotionRules::*` etc.); product-types backfill (store_id → `Store.default`, orphaned join rows deleted, `reset_counters`).+- [ ] **T7.5 Small companions**: product-types backfill (store_id → `Store.default`, orphaned join rows deleted, `reset_counters`). (Promotion STI type-column task dropped — the namespace rename was reverted in Wave 6.)- [ ] **T7.6 Upgrade manifest**: documented 5.6→6.0 order (migrate, then tasks in the sequence above), rollback notes (`spree_adjustments` intact and re-derivable through 6.0; `spree_carts` conversion reversible until the old rows age out), operator checklist.---diff --git a/docs/plans/6.0-split-adjustments.md b/docs/plans/6.0-split-adjustments.mdindex f33f49bc9a..a285c9f7b7 100644--- a/docs/plans/6.0-split-adjustments.md+++ b/docs/plans/6.0-split-adjustments.md@@ -265,7 +265,7 @@ class Spree::Adjusters::Promotion < Spree::Adjusters::Baseend```-Promotion action classes move to `Spree::PromotionActions::*` per decisions.md 2026-03-16; `CreateItemAdjustments` → `CreateItemDiscounts` as part of that rename wave.+Promotion rule/action class names stay `Spree::Promotion::Rules::*` / `Spree::Promotion::Actions::*` (incl. `CreateItemAdjustments`) — the planned namespace rename was dropped during implementation (2026-07-29): not required by the split, and it saves an STI type-column data migration.### Extensibilitydiff --git a/docs/plans/decisions.md b/docs/plans/decisions.mdindex ee6083187b..214aa631db 100644--- a/docs/plans/decisions.md+++ b/docs/plans/decisions.md@@ -243,6 +243,17 @@ Note this is a behavior change for multi-store installs (globally-visiblemethods become single-store), not a mechanical migration.## 2026-03-16: Fix promotion rule/action STI namespacing+**REVERSED 2026-07-29 (Damian, during Wave 6 of the core rewrite):** the rename+shipped briefly on `feature/6-0-core-rewrite` and was rolled back — class-name+churn wasn't required by any 6.0 feature, and it forced an STI `type`-column+data migration plus extension breakage for a purely cosmetic consistency win.+Promotion rules/actions stay `Spree::Promotion::Rules::*` /+`Spree::Promotion::Actions::*` (incl. `CreateItemAdjustments`, which now writes+typed `Spree::Discount` rows under its legacy name). The STI-namespace+convention below still applies to NEW hierarchies; existing promotion classes+are grandfathered.++Original decision:Rename `Spree::Promotion::Rules::*` → `Spree::PromotionRules::*` and`Spree::Promotion::Actions::*` → `Spree::PromotionActions::*`.diff --git a/packages/admin-sdk/examples/delivery-methods/calculators.ts b/packages/admin-sdk/examples/delivery-methods/calculators.tsnew file mode 100644index 0000000000..31539a3ea1--- /dev/null+++ b/packages/admin-sdk/examples/delivery-methods/calculators.ts@@ -0,0 +1,13 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const { data: calculators } = await client.deliveryMethods.calculators()++// endregion:example++export { calculators }diff --git a/packages/admin-sdk/examples/delivery-methods/create.ts b/packages/admin-sdk/examples/delivery-methods/create.tsnew file mode 100644index 0000000000..49e0a8aee0--- /dev/null+++ b/packages/admin-sdk/examples/delivery-methods/create.ts@@ -0,0 +1,19 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const deliveryMethod = await client.deliveryMethods.create({+ name: 'Express',+ fulfillment_type: 'shipping',+ storefront_visible: true,+ calculator_type: 'Spree::Calculator::Shipping::FlatRate',+ calculator_preferences: { amount: 12.5 },+})++// endregion:example++export { deliveryMethod }diff --git a/packages/admin-sdk/examples/delivery-methods/list.ts b/packages/admin-sdk/examples/delivery-methods/list.tsnew file mode 100644index 0000000000..b50d31bb58--- /dev/null+++ b/packages/admin-sdk/examples/delivery-methods/list.ts@@ -0,0 +1,13 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const { data: deliveryMethods } = await client.deliveryMethods.list()++// endregion:example++export { deliveryMethods }diff --git a/packages/admin-sdk/examples/delivery-zones/create.ts b/packages/admin-sdk/examples/delivery-zones/create.tsnew file mode 100644index 0000000000..ac5933a16d--- /dev/null+++ b/packages/admin-sdk/examples/delivery-zones/create.ts@@ -0,0 +1,19 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const deliveryZone = await client.deliveryZones.create({+ name: 'US North-East',+ members: [+ { member_type: 'country', country_iso: 'US' },+ { member_type: 'postal_code', country_iso: 'US', postal_code_prefix: '10' },+ ],+})++// endregion:example++export { deliveryZone }diff --git a/packages/admin-sdk/examples/orders/discounts-create.ts b/packages/admin-sdk/examples/orders/discounts-create.tsnew file mode 100644index 0000000000..a5517763f0--- /dev/null+++ b/packages/admin-sdk/examples/orders/discounts-create.ts@@ -0,0 +1,19 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+// Line-item discount; omit line_item_id to distribute across the order.+const { data: discounts } = await client.orders.discounts.create('or_abc123', {+ label: 'Customer appeasement',+ value: 10,+ value_type: 'flat',+ line_item_id: 'item_abc123',+})++// endregion:example++export { discounts }diff --git a/packages/admin-sdk/examples/orders/discounts-list.ts b/packages/admin-sdk/examples/orders/discounts-list.tsnew file mode 100644index 0000000000..9ad011e101--- /dev/null+++ b/packages/admin-sdk/examples/orders/discounts-list.ts@@ -0,0 +1,13 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const { data: discounts } = await client.orders.discounts.list('or_abc123')++// endregion:example++export { discounts }diff --git a/packages/admin-sdk/examples/orders/fees-create.ts b/packages/admin-sdk/examples/orders/fees-create.tsnew file mode 100644index 0000000000..6ac170c818--- /dev/null+++ b/packages/admin-sdk/examples/orders/fees-create.ts@@ -0,0 +1,17 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const fee = await client.orders.fees.create('or_abc123', {+ label: 'Gift wrap',+ amount: 4,+ kind: 'gift_wrap',+})++// endregion:example++export { fee }diff --git a/packages/admin-sdk/examples/orders/tax-lines-list.ts b/packages/admin-sdk/examples/orders/tax-lines-list.tsnew file mode 100644index 0000000000..c55e864bc4--- /dev/null+++ b/packages/admin-sdk/examples/orders/tax-lines-list.ts@@ -0,0 +1,13 @@+import { createAdminClient } from '@spree/admin-sdk'++const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+})++// region:example+const { data: taxLines } = await client.orders.taxLines.list('or_abc123')++// endregion:example++export { taxLines }diff --git a/packages/admin-sdk/src/admin-client.ts b/packages/admin-sdk/src/admin-client.tsindex 1965a2dc12..89edc56c53 100644--- a/packages/admin-sdk/src/admin-client.ts+++ b/packages/admin-sdk/src/admin-client.ts@@ -93,6 +93,8 @@ import type {CustomFieldDefinitionUpdateParams,CustomFieldOwnerType,CustomFieldUpdateParams,+ DeliveryMethodParams,+ DeliveryZoneParams,DirectUploadCreateParams,ExportCreateParams,FulfillmentCreateParams,@@ -158,7 +160,6 @@ import type {} from './params'import type {Address,- Adjustment,AdminUser,AllowedOrigin,ApiKey,@@ -171,7 +172,11 @@ import type {CustomerGroup,CustomField,CustomFieldDefinition,+ DeliveryMethod,+ DeliveryZone,+ Discount,Export,+ Fee,Fulfillment,GiftCard,GiftCardBatch,@@ -204,6 +209,7 @@ import type {StoreCredit,StoreCreditCategory,TaxCategory,+ TaxLine,TranslatableResource,TranslationBatchEntry,Variant,@@ -1038,19 +1044,109 @@ export class AdminClient {this.request<Refund>('POST', `/orders/${orderId}/refunds`, { ...options, body: params }),},- adjustments: {+ taxLines: {list: (orderId: string,params?: ListParams & Record<string, unknown>,options?: RequestOptions,- ): Promise<PaginatedResponse<Adjustment>> =>- this.request<PaginatedResponse<Adjustment>>('GET', `/orders/${orderId}/adjustments`, {+ ): Promise<PaginatedResponse<TaxLine>> =>+ this.request<PaginatedResponse<TaxLine>>('GET', `/orders/${orderId}/tax_lines`, {...options,params: params ? transformListParams(params) : undefined,}),- get: (orderId: string, id: string, options?: RequestOptions): Promise<Adjustment> =>- this.request<Adjustment>('GET', `/orders/${orderId}/adjustments/${id}`, options),+ get: (orderId: string, id: string, options?: RequestOptions): Promise<TaxLine> =>+ this.request<TaxLine>('GET', `/orders/${orderId}/tax_lines/${id}`, options),+ },++ discounts: {+ list: (+ orderId: string,+ params?: ListParams & Record<string, unknown>,+ options?: RequestOptions,+ ): Promise<PaginatedResponse<Discount>> =>+ this.request<PaginatedResponse<Discount>>('GET', `/orders/${orderId}/discounts`, {+ ...options,+ params: params ? transformListParams(params) : undefined,+ }),++ get: (orderId: string, id: string, options?: RequestOptions): Promise<Discount> =>+ this.request<Discount>('GET', `/orders/${orderId}/discounts/${id}`, options),++ /**+ * Creates a manual discount. With `line_item_id` a single row is+ * created; without it the value is distributed across line items+ * (largest remainder). Works on completed orders.+ */+ create: (+ orderId: string,+ params: {+ label: string+ value: string | number+ value_type?: 'flat' | 'percent'+ line_item_id?: string+ },+ options?: RequestOptions,+ ): Promise<{ data: Discount[] }> =>+ this.request<{ data: Discount[] }>('POST', `/orders/${orderId}/discounts`, {+ ...options,+ body: params,+ }),++ /** Manual rows only — promotion-sourced rows respond 422 (`discount_not_editable`). */+ update: (+ orderId: string,+ id: string,+ params: { label?: string; amount?: string | number },+ options?: RequestOptions,+ ): Promise<Discount> =>+ this.request<Discount>('PATCH', `/orders/${orderId}/discounts/${id}`, {+ ...options,+ body: params,+ }),++ /** Manual rows only — promotion-sourced rows respond 422 (`discount_not_editable`). */+ delete: (orderId: string, id: string, options?: RequestOptions): Promise<void> =>+ this.request<void>('DELETE', `/orders/${orderId}/discounts/${id}`, options),+ },++ fees: {+ list: (+ orderId: string,+ params?: ListParams & Record<string, unknown>,+ options?: RequestOptions,+ ): Promise<PaginatedResponse<Fee>> =>+ this.request<PaginatedResponse<Fee>>('GET', `/orders/${orderId}/fees`, {+ ...options,+ params: params ? transformListParams(params) : undefined,+ }),++ get: (orderId: string, id: string, options?: RequestOptions): Promise<Fee> =>+ this.request<Fee>('GET', `/orders/${orderId}/fees/${id}`, options),++ create: (+ orderId: string,+ params: {+ label: string+ amount: string | number+ kind?: string+ line_item_id?: string+ fulfillment_id?: string+ },+ options?: RequestOptions,+ ): Promise<Fee> =>+ this.request<Fee>('POST', `/orders/${orderId}/fees`, { ...options, body: params }),++ update: (+ orderId: string,+ id: string,+ params: { label?: string; amount?: string | number; kind?: string },+ options?: RequestOptions,+ ): Promise<Fee> =>+ this.request<Fee>('PATCH', `/orders/${orderId}/fees/${id}`, { ...options, body: params }),++ delete: (orderId: string, id: string, options?: RequestOptions): Promise<void> =>+ this.request<void>('DELETE', `/orders/${orderId}/fees/${id}`, options),},customFields: this.parentScopedCustomFields(CUSTOM_FIELD_OWNER_PATHS['Spree::Order']),@@ -1102,6 +1198,74 @@ export class AdminClient {// Payment Methods// ============================================+ readonly deliveryMethods = {+ list: (+ params?: ListParams & Record<string, unknown>,+ options?: RequestOptions,+ ): Promise<PaginatedResponse<DeliveryMethod>> =>+ this.request<PaginatedResponse<DeliveryMethod>>('GET', '/delivery_methods', {+ ...options,+ params: params ? transformListParams(params) : undefined,+ }),++ get: (id: string, options?: RequestOptions): Promise<DeliveryMethod> =>+ this.request<DeliveryMethod>('GET', `/delivery_methods/${id}`, options),++ create: (params: DeliveryMethodParams, options?: RequestOptions): Promise<DeliveryMethod> =>+ this.request<DeliveryMethod>('POST', '/delivery_methods', { ...options, body: params }),++ update: (+ id: string,+ params: DeliveryMethodParams,+ options?: RequestOptions,+ ): Promise<DeliveryMethod> =>+ this.request<DeliveryMethod>('PATCH', `/delivery_methods/${id}`, {+ ...options,+ body: params,+ }),++ delete: (id: string, options?: RequestOptions): Promise<void> =>+ this.request<void>('DELETE', `/delivery_methods/${id}`, options),++ /** Registered delivery calculator classes with preference schemas. */+ calculators: (+ options?: RequestOptions,+ ): Promise<{ data: Array<{ type: string; name: string; preference_schema: unknown[] }> }> =>+ this.request<{ data: Array<{ type: string; name: string; preference_schema: unknown[] }> }>(+ 'GET',+ '/delivery_methods/calculators',+ options,+ ),+ }++ readonly deliveryZones = {+ list: (+ params?: ListParams & Record<string, unknown>,+ options?: RequestOptions,+ ): Promise<PaginatedResponse<DeliveryZone>> =>+ this.request<PaginatedResponse<DeliveryZone>>('GET', '/delivery_zones', {+ ...options,+ params: params ? transformListParams(params) : undefined,+ }),++ get: (id: string, options?: RequestOptions): Promise<DeliveryZone> =>+ this.request<DeliveryZone>('GET', `/delivery_zones/${id}`, options),++ create: (params: DeliveryZoneParams, options?: RequestOptions): Promise<DeliveryZone> =>+ this.request<DeliveryZone>('POST', '/delivery_zones', { ...options, body: params }),++ /** `members` replaces the zone's full member set atomically. */+ update: (+ id: string,+ params: DeliveryZoneParams,+ options?: RequestOptions,+ ): Promise<DeliveryZone> =>+ this.request<DeliveryZone>('PATCH', `/delivery_zones/${id}`, { ...options, body: params }),++ delete: (id: string, options?: RequestOptions): Promise<void> =>+ this.request<void>('DELETE', `/delivery_zones/${id}`, options),+ }+readonly paymentMethods = {list: (params?: ListParams & Record<string, unknown>,diff --git a/packages/admin-sdk/src/params.ts b/packages/admin-sdk/src/params.tsindex 44c9cce5c2..fef24af76e 100644--- a/packages/admin-sdk/src/params.ts+++ b/packages/admin-sdk/src/params.ts@@ -1369,3 +1369,40 @@ export interface PromotionRuleUpdateParams {category_ids?: string[]customer_ids?: string[]}++export interface DeliveryMethodParams {+ name?: string+ admin_name?: string | null+ code?: string | null+ /** One of `shipping`, `digital`, `pickup`, `pickup_point`. */+ fulfillment_type?: string+ fulfillment_provider?: string+ pickup_point_provider?: string | null+ storefront_visible?: boolean+ tracking_url?: string | null+ estimated_transit_business_days_min?: number | null+ estimated_transit_business_days_max?: number | null+ /** Prefixed tax category ID (`taxcat_...`), or null to clear. */+ tax_category_id?: string | null+ /** Delivery calculator class name (see `deliveryMethods.calculators()`). */+ calculator_type?: string+ calculator_preferences?: Record<string, unknown>+ /** Prefixed delivery zone IDs (`dz_...`); replaces the full set. */+ delivery_zone_ids?: string[]+}++export interface DeliveryZoneMemberParams {+ member_type: 'country' | 'state' | 'postal_code'+ country_iso?: string+ state_abbr?: string+ postal_code_prefix?: string+ postal_code_from?: string+ postal_code_to?: string+}++export interface DeliveryZoneParams {+ name?: string+ description?: string | null+ /** Replaces the zone's full member set atomically. */+ members?: DeliveryZoneMemberParams[]+}diff --git a/packages/admin-sdk/src/types/generated/AppliedPromotion.ts b/packages/admin-sdk/src/types/generated/AppliedPromotion.tsnew file mode 100644index 0000000000..26ad886961--- /dev/null+++ b/packages/admin-sdk/src/types/generated/AppliedPromotion.ts@@ -0,0 +1,17 @@+// Typelizer digest b4aca10598728561b598347552d68c6c+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface AppliedPromotion {+ id: string;+ promotion_id: string;+ name: string;+ description: string | null;+ code: string | null;+ amount: string;+ display_amount: string;+ created_at: string;+ updated_at: string;+}++export default AppliedPromotion;diff --git a/packages/admin-sdk/src/types/generated/DeliveryMethod.ts b/packages/admin-sdk/src/types/generated/DeliveryMethod.tsindex 78880ec586..3f03266e23 100644--- a/packages/admin-sdk/src/types/generated/DeliveryMethod.ts+++ b/packages/admin-sdk/src/types/generated/DeliveryMethod.ts@@ -1,4 +1,4 @@-// Typelizer digest 1cfcde8cdcef95e311198ef79824c581+// Typelizer digest fe953fd920a31b03b36a4f4e19cced51//// DO NOT MODIFY: This file was automatically generated by Typelizer.@@ -6,8 +6,21 @@ interface DeliveryMethod {id: string;name: string;code: string | null;+ fulfillment_type: string;+ estimated_transit_business_days_min: number | null;+ estimated_transit_business_days_max: number | null;+ admin_name: string | null;+ fulfillment_provider: string;+ pickup_point_provider: string | null;+ storefront_visible: boolean;+ tracking_url: string | null;created_at: string;updated_at: string;+ deleted_at: string;+ tax_category_id: string | null;+ delivery_zone_ids: Array<string>;+ calculator_type: string | null;+ calculator_preferences: Record<string, unknown> | null;}export default DeliveryMethod;diff --git a/packages/admin-sdk/src/types/generated/DeliveryZone.ts b/packages/admin-sdk/src/types/generated/DeliveryZone.tsnew file mode 100644index 0000000000..fa2d9b29bf--- /dev/null+++ b/packages/admin-sdk/src/types/generated/DeliveryZone.ts@@ -0,0 +1,16 @@+// Typelizer digest 01553d9d35fe933ca026c7732d95a536+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.+import type {DeliveryZoneMember} from '@/types'++interface DeliveryZone {+ id: string;+ name: string;+ description: string | null;+ members: Array<DeliveryZoneMember>;+ created_at: string;+ updated_at: string;+ delivery_method_ids: Array<string>;+}++export default DeliveryZone;diff --git a/packages/admin-sdk/src/types/generated/DeliveryZoneMember.ts b/packages/admin-sdk/src/types/generated/DeliveryZoneMember.tsnew file mode 100644index 0000000000..a7f6084505--- /dev/null+++ b/packages/admin-sdk/src/types/generated/DeliveryZoneMember.ts@@ -0,0 +1,18 @@+// Typelizer digest 8357d6c4cee5abf78c125edd4e951d48+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface DeliveryZoneMember {+ id: string;+ member_type: string;+ postal_code_prefix: string | null;+ postal_code_from: string | null;+ postal_code_to: string | null;+ country_iso: string | null;+ state_abbr: string | null;+ state_name: string | null;+ created_at: string;+ updated_at: string;+}++export default DeliveryZoneMember;diff --git a/packages/admin-sdk/src/types/generated/Discount.ts b/packages/admin-sdk/src/types/generated/Discount.tsindex 7ccb268c78..2fad110659 100644--- a/packages/admin-sdk/src/types/generated/Discount.ts+++ b/packages/admin-sdk/src/types/generated/Discount.ts@@ -1,15 +1,20 @@-// Typelizer digest a2f18de2c82d51339476e96c2780cd84+// Typelizer digest f87c1c7115952fc7099d79710ef335a7//// DO NOT MODIFY: This file was automatically generated by Typelizer.interface Discount {id: string;- promotion_id: string;- name: string;- description: string | null;+ label: string;+ kind: string;code: string | null;+ value_type: string | null;+ value: string | null;+ promotion_id: string | null;+ line_item_id: string | null;+ fulfillment_id: string | null;amount: string;display_amount: string;+ metadata: Record<string, unknown> | null;created_at: string;updated_at: string;}diff --git a/packages/admin-sdk/src/types/generated/Fee.ts b/packages/admin-sdk/src/types/generated/Fee.tsnew file mode 100644index 0000000000..621c2bc5eb--- /dev/null+++ b/packages/admin-sdk/src/types/generated/Fee.ts@@ -0,0 +1,18 @@+// Typelizer digest 8ecec6dbff6c3c936dbed5c9973dd9c1+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface Fee {+ id: string;+ label: string;+ kind: string;+ line_item_id: string | null;+ fulfillment_id: string | null;+ amount: string;+ display_amount: string;+ metadata: Record<string, unknown> | null;+ created_at: string;+ updated_at: string;+}++export default Fee;diff --git a/packages/admin-sdk/src/types/generated/Fulfillment.ts b/packages/admin-sdk/src/types/generated/Fulfillment.tsindex ff6f5e7ae1..1c26410087 100644--- a/packages/admin-sdk/src/types/generated/Fulfillment.ts+++ b/packages/admin-sdk/src/types/generated/Fulfillment.ts@@ -1,4 +1,4 @@-// Typelizer digest bbed88b8ea7ca52131296db84b48aa3b+// Typelizer digest 86e7aceb1c85322cab69fd50d1495105//// DO NOT MODIFY: This file was automatically generated by Typelizer.import type {DeliveryMethod, StockLocation, DeliveryRate, Order} from '@/types'@@ -8,6 +8,8 @@ interface Fulfillment {number: string;tracking: string | null;tracking_url: string | null;+ pickup_point_data: Record<string, unknown> | null;+ selected_delivery_rate_id: string | null;cost: string;display_cost: string;total: string;diff --git a/packages/admin-sdk/src/types/generated/Order.ts b/packages/admin-sdk/src/types/generated/Order.tsindex 36b089353a..0484de6eeb 100644--- a/packages/admin-sdk/src/types/generated/Order.ts+++ b/packages/admin-sdk/src/types/generated/Order.ts@@ -1,7 +1,7 @@-// Typelizer digest 045dabbbb4a625d1281160da95051bb0+// Typelizer digest 1366ec45238e85d679d9ea819923b916//// DO NOT MODIFY: This file was automatically generated by Typelizer.-import type {Discount, LineItem, Fulfillment, Payment, Address, GiftCard, Market, Channel, StockLocation, PaymentMethod, Customer, ReturnAuthorization, Reimbursement} from '@/types'+import type {AppliedPromotion, LineItem, Fulfillment, Payment, Address, GiftCard, Market, Channel, StockLocation, PaymentMethod, Customer, ReturnAuthorization, Reimbursement} from '@/types'interface Order {id: string;@@ -39,7 +39,7 @@ interface Order {store_credit_total: string;display_store_credit_total: string;covered_by_store_credit: boolean;- discounts?: Array<Discount>;+ discounts?: Array<AppliedPromotion>;items?: Array<LineItem>;fulfillments?: Array<Fulfillment>;payments?: Array<Payment>;diff --git a/packages/admin-sdk/src/types/generated/TaxLine.ts b/packages/admin-sdk/src/types/generated/TaxLine.tsnew file mode 100644index 0000000000..1f2e87a07d--- /dev/null+++ b/packages/admin-sdk/src/types/generated/TaxLine.ts@@ -0,0 +1,22 @@+// Typelizer digest c92826f6c8a65b31bc558b76f9e11c78+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface TaxLine {+ id: string;+ label: string;+ included: boolean;+ rate: string;+ tax_rate_id: string | null;+ line_item_id: string | null;+ fulfillment_id: string | null;+ fee_id: string | null;+ amount: string;+ display_amount: string;+ provider_id: string | null;+ metadata: Record<string, unknown> | null;+ created_at: string;+ updated_at: string;+}++export default TaxLine;diff --git a/packages/admin-sdk/src/types/generated/index.ts b/packages/admin-sdk/src/types/generated/index.tsindex 5062a1679c..8b50d74113 100644--- a/packages/admin-sdk/src/types/generated/index.ts+++ b/packages/admin-sdk/src/types/generated/index.ts@@ -1,10 +1,11 @@-// Typelizer digest f13784d3e9c6c459e63893766a3e59ee+// Typelizer digest 8271ff0a7517e31f05096608ee018af3//// DO NOT MODIFY: This file was automatically generated by Typelizer.export type { default as Address } from './Address'export type { default as AdminUser } from './AdminUser'export type { default as AllowedOrigin } from './AllowedOrigin'export type { default as ApiKey } from './ApiKey'+export type { default as AppliedPromotion } from './AppliedPromotion'export type { default as Category } from './Category'export type { default as Channel } from './Channel'export type { default as CollectionRule } from './CollectionRule'@@ -18,9 +19,12 @@ export type { default as CustomerGroup } from './CustomerGroup'export type { default as Customer } from './Customer'export type { default as DeliveryMethod } from './DeliveryMethod'export type { default as DeliveryRate } from './DeliveryRate'+export type { default as DeliveryZoneMember } from './DeliveryZoneMember'+export type { default as DeliveryZone } from './DeliveryZone'export type { default as DigitalLink } from './DigitalLink'export type { default as Discount } from './Discount'export type { default as Export } from './Export'+export type { default as Fee } from './Fee'export type { default as Fulfillment } from './Fulfillment'export type { default as GiftCardBatch } from './GiftCardBatch'export type { default as GiftCard } from './GiftCard'@@ -62,6 +66,7 @@ export type { default as StoreCreditCategory } from './StoreCreditCategory'export type { default as StoreCredit } from './StoreCredit'export type { default as Store } from './Store'export type { default as TaxCategory } from './TaxCategory'+export type { default as TaxLine } from './TaxLine'export type { default as Variant } from './Variant'export type { default as WebhookDelivery } from './WebhookDelivery'export type { default as WebhookEndpoint } from './WebhookEndpoint'diff --git a/packages/admin-sdk/src/types/index.ts b/packages/admin-sdk/src/types/index.tsindex a9a2dba94d..f3cefe6c13 100644--- a/packages/admin-sdk/src/types/index.ts+++ b/packages/admin-sdk/src/types/index.ts@@ -10,10 +10,10 @@ export type {// Admin-specific generated typesexport type { default as Address } from './generated/Address'-export type { default as Adjustment } from './generated/Adjustment'export type { default as AdminUser } from './generated/AdminUser'export type { default as AllowedOrigin } from './generated/AllowedOrigin'export type { default as ApiKey } from './generated/ApiKey'+export type { default as AppliedPromotion } from './generated/AppliedPromotion'export type { default as Category } from './generated/Category'export type { default as Channel } from './generated/Channel'export type { default as Country } from './generated/Country'@@ -25,9 +25,12 @@ export type { default as CustomField } from './generated/CustomField'export type { default as CustomFieldDefinition } from './generated/CustomFieldDefinition'export type { default as DeliveryMethod } from './generated/DeliveryMethod'export type { default as DeliveryRate } from './generated/DeliveryRate'+export type { default as DeliveryZone } from './generated/DeliveryZone'+export type { default as DeliveryZoneMember } from './generated/DeliveryZoneMember'export type { default as DigitalLink } from './generated/DigitalLink'export type { default as Discount } from './generated/Discount'export type { default as Export } from './generated/Export'+export type { default as Fee } from './generated/Fee'export type { default as Fulfillment } from './generated/Fulfillment'export type { default as GiftCard } from './generated/GiftCard'export type { default as GiftCardBatch } from './generated/GiftCardBatch'@@ -68,6 +71,7 @@ export type { default as Store } from './generated/Store'export type { default as StoreCredit } from './generated/StoreCredit'export type { default as StoreCreditCategory } from './generated/StoreCreditCategory'export type { default as TaxCategory } from './generated/TaxCategory'+export type { default as TaxLine } from './generated/TaxLine'export type { default as Variant } from './generated/Variant'export type { default as WebhookDelivery } from './generated/WebhookDelivery'export type { default as WebhookEndpoint } from './generated/WebhookEndpoint'diff --git a/packages/cli/src/generated/admin-spec.json b/packages/cli/src/generated/admin-spec.jsonindex b95f86204b..a135ca1384 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"}}}}}},"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/auth/password_resets":{"post":{"summary":"Request password reset","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Requests a password reset email for an admin user. Always returns `202`\nwhether or not the email matches an account, to prevent enumeration.\n\n`redirect_url` is where the emailed link should point (the reset token\nis appended as a `token` query param). It must match one of the store's\nallowed origins — otherwise it is silently ignored and the server-side\ndefault is used. The email is delivered by Spree itself via the\n`admin_user.password_reset_requested` event; this event is never\nforwarded to webhook endpoints.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"reset requested","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"redirect_url":{"type":"string","description":"Must match an allowed origin of the store; ignored otherwise."}},"required":["email"]}}}}}},"/api/v3/admin/auth/password_resets/{id}":{"patch":{"summary":"Reset password","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Consumes a password reset token (the `token` query param from the\nemailed link), sets the new password, and signs the admin in: the\nresponse carries a JWT access token and the rotatable refresh token is\nset in an HttpOnly cookie. The token is single-use — it invalidates as\nsoon as the password changes.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"The reset token from the emailed link","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"password reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"422":{"description":"invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"password":{"type":"string"},"password_confirmation":{"type":"string"}},"required":["password","password_confirmation"]}}}}}},"/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/categories":{"get":{"summary":"List categories","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of the store's categories (manual hierarchical taxons; rule-based collections are excluded).\n\n**Required scope:** `read_categories` (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":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., children, parent, ancestors).","schema":{"type":"string"}}],"responses":{"200":{"description":"categories found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a category. Nests under the parent when parent_id is given, otherwise creates a top-level category.\n\n**Required scope:** `write_categories` (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":"category created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"parent_id":{"type":"string","description":"Prefixed ID of the parent category"},"description":{"type":"string"},"permalink":{"type":"string"},"meta_title":{"type":"string"},"meta_description":{"type":"string"},"meta_keywords":{"type":"string"},"hide_from_nav":{"type":"boolean"}},"required":["name"]}}}}}},"/api/v3/admin/categories/{id}":{"get":{"summary":"Get a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single category by ID.\n\n**Required scope:** `read_categories` (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":"Category ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., children, parent, ancestors).","schema":{"type":"string"}}],"responses":{"200":{"description":"category found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"404":{"description":"category not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a category.\n\n**Required scope:** `write_categories` (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":"Category ID","schema":{"type":"string"}}],"responses":{"200":{"description":"category updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"parent_id":{"type":"string","description":"Prefixed ID of the parent category"},"description":{"type":"string"},"permalink":{"type":"string"},"meta_title":{"type":"string"},"meta_description":{"type":"string"},"meta_keywords":{"type":"string"},"hide_from_nav":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a category and its descendants.\n\n**Required scope:** `write_categories` (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":"Category ID","schema":{"type":"string"}}],"responses":{"204":{"description":"category deleted"}}}},"/api/v3/admin/categories/{id}/reposition":{"patch":{"summary":"Reposition a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Moves a category to a new parent and/or index within the tree.\n\n**Required scope:** `write_categories` (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":"Category ID","schema":{"type":"string"}}],"responses":{"200":{"description":"category repositioned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"new_parent_id":{"type":"string","description":"Prefixed ID of the new parent (omit for top level)"},"new_position":{"type":"integer","description":"0-based index among the new parent's children"}},"required":["new_position"]}}}}}},"/api/v3/admin/categories/{category_id}/products":{"get":{"summary":"List category products","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Products classified under the category, ordered by their classification position.\n\n**Required scope:** `read_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","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"]}}}}}},"post":{"summary":"Add a product to a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Classifies a product under the category (appended to the end).\n\n**Required scope:** `write_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","schema":{"type":"string"}}],"responses":{"201":{"description":"product added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]}}}}}},"/api/v3/admin/categories/{category_id}/products/{id}/reposition":{"patch":{"summary":"Reposition a category product","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Moves a product to a new index among the category's products.\n\n**Required scope:** `write_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product repositioned"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"new_position":{"type":"integer","description":"0-based index among the category's products"}},"required":["new_position"]}}}}}},"/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},"default":{"type":"boolean","default":false},"preferred_order_routing_strategy":{"type":"string","nullable":true,"description":"Routing strategy class name. `null` inherits the store setting."},"preferred_storefront_access":{"type":"string","nullable":true,"enum":["public","prices_hidden","login_required"],"description":"Anonymous-visitor access posture. `null` inherits the store setting."},"preferred_guest_checkout":{"type":"boolean","nullable":true,"description":"Whether guests can check out without an account. `null` inherits the store setting."}}}}}}}},"/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"},"default":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string","nullable":true,"description":"Routing strategy class name. `null` inherits the store setting."},"preferred_storefront_access":{"type":"string","nullable":true,"enum":["public","prices_hidden","login_required"],"description":"Anonymous-visitor access posture. `null` inherits the store setting."},"preferred_guest_checkout":{"type":"boolean","nullable":true,"description":"Whether guests can check out without an account. `null` inherits the store setting."}}}}}}},"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/channels/{channel_id}/order_routing_rules":{"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List order routing rules for a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the channel's routing rules in priority order. The rules engine walks them top-down; see the Order Routing guide.\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":"rules found","content":{"application/json":{}}}}},"post":{"summary":"Create an order routing rule on a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a rule to the channel's routing list. The `type` is the wire shorthand from `GET /order_routing_rules/types` (e.g. `preferred_location`). Omitting `position` appends the rule at the end of the list. Each rule kind can appear at most once per channel — a duplicate `type` is rejected with a validation error.\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":"rule created","content":{"application/json":{}}},"422":{"description":"unknown rule type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"active":{"type":"boolean"},"position":{"type":"integer"},"preferences":{"type":"object","additionalProperties":true}},"required":["type"]}}}}}},"/api/v3/admin/channels/{channel_id}/order_routing_rules/{id}":{"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Update an order routing rule","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a rule's `active` flag, `position` (the list reorders around it), or `preferences`. The rule kind cannot be changed — delete and re-create instead.\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":"rule updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"position":{"type":"integer"},"preferences":{"type":"object","additionalProperties":true}}}}}}},"delete":{"summary":"Delete an order routing rule","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":"rule deleted"}}}},"/api/v3/admin/order_routing_rules/types":{"get":{"summary":"List available order routing rule types","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Enumerates the registered rule kinds with their labels, descriptions and preference schemas — drives the \"Add rule\" picker in the admin dashboard. Plugins extend the list by registering `Spree::OrderRoutingRule` subclasses via `Spree.order_routing.rules`.\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":"types found","content":{"application/json":{}}}}}},"/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`)"},"searchable":{"type":"boolean","description":"When true, values are included in storefront product text search"},"sortable":{"type":"boolean","description":"When true, storefront product listings can sort by this field"}}}}}}}},"/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"},"searchable":{"type":"boolean"},"sortable":{"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":["products","orders","customers","product_translations","gift_cards","coupon_codes","newsletter_subscribers"]},"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},"results_url":{"type":"string","description":"Absolute URL of your admin exports view; the export-done email uses it as the download button target. Only honored when it matches one of the store's configured allowed origins."}}}}}}}},"/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":{}}}}},"post":{"summary":"Create a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Manually creates a fulfillment on a completed order, bypassing order routing — for example to mirror a shipment handled by an external carrier or 3PL. Moves the requested line item quantities out of their current fulfillments; when `items` is omitted, every not-yet-shipped unit is moved. Pass `status: 'shipped'` to register an already-shipped fulfillment (fires shipped webhooks and freezes cost/carrier). When `delivery_method_id` is omitted, the fulfillment inherits the delivery method and cost of the source fulfillment(s) it fully drains — keeping the order total unchanged; partially drained splits get no carrier when shipped, and pending fulfillments are otherwise (re)priced by the standard rate engine, which selects the lowest-cost available rate. Pass `cost` to set an explicit shipping cost instead (e.g. the 3PL price) — note this changes the order total and payment state, and is guaranteed to persist only with `status: 'shipped'` (pending fulfillments are re-priced by the rate engine).\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"}}],"responses":{"201":{"description":"fulfillment created","content":{"application/json":{}}},"422":{"description":"order not completed","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["stock_location_id"],"properties":{"stock_location_id":{"type":"string","description":"Stock location the fulfillment ships from"},"tracking":{"type":"string","description":"Carrier tracking number, or a full https:// tracking link — a full URL is served back as tracking_url unchanged instead of being templated into the delivery method tracking URL"},"delivery_method_id":{"type":"string","description":"Delivery method (carrier) to attach as the selected rate. Defaults to the delivery method of the fully drained source fulfillment(s)"},"cost":{"type":"string","description":"Explicit shipping cost. Defaults to the summed cost of the fully drained source fulfillment(s), which keeps the order total unchanged; an explicit cost changes the order total and payment state. Guaranteed to persist only with status: 'shipped' — pending fulfillments are re-priced by the rate engine"},"status":{"type":"string","enum":["shipped"],"description":"Pass 'shipped' to register the fulfillment as already shipped"},"items":{"type":"array","description":"Line item quantities to fulfill. Omit to fulfill every not-yet-shipped unit.","items":{"type":"object","required":["item_id","quantity"],"properties":{"item_id":{"type":"string","description":"Line item ID"},"quantity":{"type":"integer"}}}},"metadata":{"type":"object","additionalProperties":true}}}}}}}},"/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 fulfillment (tracking, delivery 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","description":"Carrier tracking number, or a full https:// tracking link served back as tracking_url unchanged"},"selected_delivery_rate_id":{"type":"string","description":"Delivery rate ID (dr_...) to select"}}}}}}}},"/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/imports":{"get":{"summary":"List imports","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns CSV imports queued or completed for the current store.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"imports found","content":{"application/json":{}}}}},"post":{"summary":"Create an import","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Queues a CSV import. Upload the file first via `POST /api/v3/admin/direct_uploads`\nand pass the returned `signed_id` as `attachment`. On success the import is in the\n`mapping` state and the response carries the mapping payload: `schema_fields`\n(the canonical columns for the type), `csv_headers`, a `sample_row`, and the\nauto-assigned `mappings`.\n\nAdjust mappings if needed, then call `PATCH /admin/imports/{id}/complete_mapping`\nto start processing. Poll `GET /admin/imports/{id}` while `status` is\n`completed_mapping`/`processing`; terminal statuses are `completed` and `failed`.\n\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import created in mapping state","content":{"application/json":{}}},"422":{"description":"unknown import type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type","attachment"],"properties":{"type":{"type":"string","enum":["products","customers","product_translations"]},"attachment":{"type":"string","description":"ActiveStorage signed blob id from POST /api/v3/admin/direct_uploads."},"preferred_delimiter":{"type":"string","enum":[",",";","|","\t"],"description":"CSV column separator. Defaults to a comma."},"results_url":{"type":"string","description":"Absolute URL of your admin imports view; the import-done email links back to it with `?import=<id>` appended. Only honored when it matches one of the store's configured allowed origins."}}}}}}}},"/api/v3/admin/imports/template":{"get":{"summary":"Download an import template","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a CSV header row for the given import type, including the custom field columns available for the model.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"type","in":"query","required":true,"description":"Registered import type, e.g. products.","schema":{"type":"string"}}],"responses":{"200":{"description":"CSV template","content":{"application/json":{},"text/csv":{"schema":{"type":"string","format":"binary"}}}}}}},"/api/v3/admin/imports/example":{"get":{"summary":"Download an example import file","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Redirects to a populated example CSV for the given import type — the same sample data `rake spree:load_sample_data` uses, pinned to the installed Spree version. Returns 404 for a type that ships no example file.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"type","in":"query","required":true,"description":"Registered import type, e.g. products.","schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect to the example CSV"}}}},"/api/v3/admin/imports/{id}":{"get":{"summary":"Show an import","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns import status and row counters. The admin dashboard polls this endpoint while `status` is `completed_mapping` or `processing`; `rows_count`, `completed_rows_count` and `failed_rows_count` drive the progress bar. The mapping payload (`csv_headers`, `sample_row`) is only present while `status` is `mapping`.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import found","content":{"application/json":{}}}}},"delete":{"summary":"Delete an import","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the import, its rows and the uploaded file. Returns 422 while the import is being processed.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import deleted"}}}},"/api/v3/admin/imports/{id}/download":{"get":{"summary":"Download the originally uploaded file","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Streams the CSV exactly as it was uploaded — the audit trail for what was imported. JWT/API-key protected; SPA clients fetch it with the Authorization header and trigger the browser download via a Blob URL.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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/imports/{id}/complete_mapping":{"patch":{"summary":"Complete mapping and start processing","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Applies the submitted column mappings, then starts row processing. Omit `mappings`\nto accept the auto-assigned ones from the create response. Returns 422 when a\nrequired schema field is left unmapped (`details.missing_required_fields`) or a\nfile column is assigned twice.\n\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"mapping completed, processing queued","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mappings":{"type":"array","description":"Column assignments to apply before starting. `file_column: null` unmaps a field.","items":{"type":"object","required":["schema_field"],"properties":{"schema_field":{"type":"string"},"file_column":{"type":"string","nullable":true}}}}}}}}}}},"/api/v3/admin/imports/{id}/retry_failed_rows":{"patch":{"summary":"Retry failed rows","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Re-processes the rows that failed. The import re-enters `processing`; poll `GET /admin/imports/{id}` until it completes again. Returns 422 when the import is not `completed` or has no failed rows.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"retry queued","content":{"application/json":{}}}}}},"/api/v3/admin/imports/{import_id}/rows":{"get":{"summary":"List import rows","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Paginated rows of an import — the failure report. Filter with `q[status_eq]=failed` to list only rows that could not be imported; each row carries the raw CSV `data` and its `validation_errors`.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"q[status_eq]","in":"query","required":false,"description":"Filter rows by status: pending, processing, completed, failed.","schema":{"type":"string"}}],"responses":{"200":{"description":"rows found","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/{product_id}/translations":{"get":{"summary":"List product translations","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the full translation matrix for the product: the source value and content type per translatable field, plus the translated value for every supported locale.\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"}}],"responses":{"200":{"description":"translations found","content":{"application/json":{}}}}}},"/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/locales":{"get":{"summary":"List supported locales","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the locales a merchant can translate content into for the current store, with the default and right-to-left flags.\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":"locales found","content":{"application/json":{}}}}}},"/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/translatable_resources":{"get":{"summary":"List translatable resources","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns every translatable resource type and its translatable fields (key + content type), so clients can render translation editors generically.\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":"translatable resources found","content":{"application/json":{}}}}}},"/api/v3/admin/translations/batch":{"post":{"summary":"Batch upsert translations","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Atomically upserts translations across many records of (possibly) different translatable resource types in one request — e.g. an option type and all its option values in one save. A flat list of independent registry writes; all entries succeed or none do.\n\n**Required scope:** `write_<resource>` for every resource type in the batch (for API-key authentication) (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":"translations upserted","content":{"application/json":{}}},"422":{"description":"unsupported locale rolls back the whole batch","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["translations"],"properties":{"translations":{"type":"array","items":{"type":"object","required":["resource_type","resource_id","values"],"properties":{"resource_type":{"type":"string","description":"Translatable resource type token, e.g. `option_type`"},"resource_id":{"type":"string","description":"Prefixed id of the record"},"values":{"type":"object","description":"Map of locale code to { field: value }","additionalProperties":{"type":"object","additionalProperties":true}}}}}}}}}}}},"/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"]},"ImportSchemaField":{"type":"object","description":"A canonical column of an import type, including per-store custom field columns","properties":{"name":{"type":"string","description":"Canonical field name used in mappings"},"label":{"type":"string","description":"Human-readable label"},"required":{"type":"boolean","description":"Whether the field must be mapped before processing"}},"required":["name","label","required"]},"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"]},"AdminUserStore":{"type":"object","description":"A store the staff member can access through a role assignment","properties":{"id":{"type":"string","description":"Prefixed store ID"},"name":{"type":"string","description":"Store name"},"code":{"type":"string","description":"Store code"}},"required":["id","name","code"]},"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"},"avatar_url":{"type":"string","nullable":true},"roles":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserRoleAssignment"}},"stores":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserStore"}}},"required":["id","email","first_name","last_name","full_name","selected_locale","created_at","updated_at","avatar_url","roles","stores"],"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},"channel_id":{"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","channel_id","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"}},"translations":{"type":"object"},"metadata":{"type":"object"},"pretty_name":{"type":"string"},"lft":{"type":"number"},"rgt":{"type":"number"},"products_count":{"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","products_count","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"},"storefront_access":{"type":"string"},"guest_checkout":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string","nullable":true},"preferred_storefront_access":{"type":"string","nullable":true},"preferred_guest_checkout":{"type":"boolean","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","code","active","default","storefront_access","guest_checkout","preferred_order_routing_strategy","preferred_storefront_access","preferred_guest_checkout","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":"string"},"updated_at":{"type":"string"}},"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"},"searchable":{"type":"boolean"},"sortable":{"type":"boolean"},"filter_key":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","namespace","key","label","field_type","resource_type","storefront_visible","searchable","sortable","filter_key","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},"newsletter_subscriber":{"allOf":[{"$ref":"#/components/schemas/NewsletterSubscriber"}],"nullable":true},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"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_group_ids":{"type":"array","items":{"type":"string"}}},"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","customer_group_ids"],"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"},"format":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string","nullable":true},"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","format","created_at","updated_at","type","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},"ImportMapping":{"type":"object","properties":{"id":{"type":"string"},"schema_field":{"type":"string"},"file_column":{"type":"string","nullable":true},"required":{"type":"boolean"}},"required":["id","schema_field","file_column","required"],"x-typelizer":true},"ImportRow":{"type":"object","properties":{"id":{"type":"string"},"row_number":{"type":"number"},"status":{"type":"string"},"validation_errors":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"import_id":{"type":"string","nullable":true},"item_type":{"type":"string","nullable":true},"item_id":{"type":"string","nullable":true},"data":{"type":"object"}},"required":["id","row_number","status","validation_errors","created_at","updated_at","import_id","item_type","item_id","data"],"x-typelizer":true},"Import":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"rows_count":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string","nullable":true},"status":{"type":"string"},"owner_type":{"type":"string","nullable":true},"owner_id":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true},"processing_errors":{"type":"string","nullable":true},"preferred_delimiter":{"type":"string"},"original_filename":{"type":"string","nullable":true},"original_byte_size":{"type":"number","nullable":true},"original_file_url":{"type":"string","nullable":true},"completed_rows_count":{"type":"number"},"failed_rows_count":{"type":"number"},"schema_fields":{"type":"array","items":{"$ref":"#/components/schemas/ImportSchemaField"}},"csv_headers":{"type":"array","items":{"type":"string"}},"sample_row":{"type":"object"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/ImportMapping"}}},"required":["id","number","rows_count","created_at","updated_at","type","status","owner_type","owner_id","user_id","processing_errors","preferred_delimiter","original_filename","original_byte_size","original_file_url","completed_rows_count","failed_rows_count","schema_fields","csv_headers","sample_row","mappings"],"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"},"preorder":{"type":"boolean"},"preorder_ships_at":{"type":"string","nullable":true},"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","preorder","preorder_ships_at","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},"NewsletterSubscriber":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"verified":{"type":"boolean"},"verified_at":{"type":"string","nullable":true},"customer_id":{"type":"string","nullable":true}},"required":["id","email","created_at","updated_at","verified","verified_at","customer_id"],"x-typelizer":true},"OptionType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"number"},"kind":{"type":"string"},"translations":{"type":"object"},"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},"OrderRoutingRule":{"type":"object","properties":{"id":{"type":"string"},"position":{"type":"number"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"channel_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"object"},"label":{"type":"string"},"description":{"type":"string"}},"required":["id","position","active","created_at","updated_at","type","channel_id","preferences","preference_schema","label","description"],"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"},"fulfillment_status":{"type":"string","nullable":true},"payment_status":{"type":"string","nullable":true},"completed_at":{"type":"string","nullable":true},"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"},"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","fulfillment_status","payment_status","completed_at","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","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"}},"channels":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}},"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},"preorder_ships_at":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"preorder":{"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},"translations":{"type":"object"},"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","preorder_ships_at","purchasable","preorder","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"}},"channels":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}},"markets":{"type":"array","items":{"$ref":"#/components/schemas/Market"}}},"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},"SetupTask":{"type":"object","properties":{"name":{"type":"string"},"done":{"type":"boolean"}},"required":["name","done"],"x-typelizer":true},"State":{"type":"object","properties":{"abbr":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"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"},"code":{"type":"string"},"preferred_storefront_url":{"type":"string","nullable":true},"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"},"preferred_storefront_access":{"type":"string"},"preferred_guest_checkout":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"url":{"type":"string"},"api_url":{"type":"string"},"setup_tasks":{"type":"array","items":{"$ref":"#/components/schemas/SetupTask"}},"supported_currencies":{"type":"array","items":{"type":"string"}},"supported_locales":{"type":"array","items":{"type":"string"}},"available_locales":{"type":"array","items":{"type":"string"}},"logo_url":{"type":"string","nullable":true},"mailer_logo_url":{"type":"string","nullable":true}},"required":["id","metadata","name","code","preferred_storefront_url","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","preferred_storefront_access","preferred_guest_checkout","preferred_order_routing_strategy","created_at","updated_at","url","api_url","setup_tasks","supported_currencies","supported_locales","available_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"},"preorder_ships_at":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"in_stock":{"type":"boolean"},"backorderable":{"type":"boolean"},"preorder":{"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},"backorder_limit":{"type":"number","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"preorderable":{"type":"boolean"},"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","preorder_ships_at","thumbnail_url","purchasable","in_stock","backorderable","preorder","weight","height","width","depth","price","original_price","option_values","metadata","position","cost_price","cost_currency","barcode","weight_unit","dimensions_unit","backorder_limit","deleted_at","created_at","updated_at","preorderable","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},"created_at":{"type":"string"},"updated_at":{"type":"string"},"delivered_at":{"type":"string","nullable":true},"payload":{"type":"object"},"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","created_at","updated_at","delivered_at","payload","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/auth/password_resets":{"post":{"summary":"Request password reset","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Requests a password reset email for an admin user. Always returns `202`\nwhether or not the email matches an account, to prevent enumeration.\n\n`redirect_url` is where the emailed link should point (the reset token\nis appended as a `token` query param). It must match one of the store's\nallowed origins — otherwise it is silently ignored and the server-side\ndefault is used. The email is delivered by Spree itself via the\n`admin_user.password_reset_requested` event; this event is never\nforwarded to webhook endpoints.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"reset requested","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"redirect_url":{"type":"string","description":"Must match an allowed origin of the store; ignored otherwise."}},"required":["email"]}}}}}},"/api/v3/admin/auth/password_resets/{id}":{"patch":{"summary":"Reset password","tags":["Authentication"],"security":[{"api_key":[]}],"description":"Consumes a password reset token (the `token` query param from the\nemailed link), sets the new password, and signs the admin in: the\nresponse carries a JWT access token and the rotatable refresh token is\nset in an HttpOnly cookie. The token is single-use — it invalidates as\nsoon as the password changes.\n","parameters":[{"name":"x-spree-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"The reset token from the emailed link","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"password reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"422":{"description":"invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"password":{"type":"string"},"password_confirmation":{"type":"string"}},"required":["password","password_confirmation"]}}}}}},"/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/categories":{"get":{"summary":"List categories","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of the store's categories (manual hierarchical taxons; rule-based collections are excluded).\n\n**Required scope:** `read_categories` (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":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., children, parent, ancestors).","schema":{"type":"string"}}],"responses":{"200":{"description":"categories found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a category. Nests under the parent when parent_id is given, otherwise creates a top-level category.\n\n**Required scope:** `write_categories` (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":"category created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"parent_id":{"type":"string","description":"Prefixed ID of the parent category"},"description":{"type":"string"},"permalink":{"type":"string"},"meta_title":{"type":"string"},"meta_description":{"type":"string"},"meta_keywords":{"type":"string"},"hide_from_nav":{"type":"boolean"}},"required":["name"]}}}}}},"/api/v3/admin/categories/{id}":{"get":{"summary":"Get a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single category by ID.\n\n**Required scope:** `read_categories` (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":"Category ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., children, parent, ancestors).","schema":{"type":"string"}}],"responses":{"200":{"description":"category found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"404":{"description":"category not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a category.\n\n**Required scope:** `write_categories` (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":"Category ID","schema":{"type":"string"}}],"responses":{"200":{"description":"category updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"parent_id":{"type":"string","description":"Prefixed ID of the parent category"},"description":{"type":"string"},"permalink":{"type":"string"},"meta_title":{"type":"string"},"meta_description":{"type":"string"},"meta_keywords":{"type":"string"},"hide_from_nav":{"type":"boolean"}}}}}}},"delete":{"summary":"Delete a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a category and its descendants.\n\n**Required scope:** `write_categories` (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":"Category ID","schema":{"type":"string"}}],"responses":{"204":{"description":"category deleted"}}}},"/api/v3/admin/categories/{id}/reposition":{"patch":{"summary":"Reposition a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Moves a category to a new parent and/or index within the tree.\n\n**Required scope:** `write_categories` (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":"Category ID","schema":{"type":"string"}}],"responses":{"200":{"description":"category repositioned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"new_parent_id":{"type":"string","description":"Prefixed ID of the new parent (omit for top level)"},"new_position":{"type":"integer","description":"0-based index among the new parent's children"}},"required":["new_position"]}}}}}},"/api/v3/admin/categories/{category_id}/products":{"get":{"summary":"List category products","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Products classified under the category, ordered by their classification position.\n\n**Required scope:** `read_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","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"]}}}}}},"post":{"summary":"Add a product to a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Classifies a product under the category (appended to the end).\n\n**Required scope:** `write_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","schema":{"type":"string"}}],"responses":{"201":{"description":"product added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]}}}}}},"/api/v3/admin/categories/{category_id}/products/{id}":{"delete":{"summary":"Remove a product from a category","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes a product from the category's manual classification.\n\n**Required scope:** `write_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product removed"}}}},"/api/v3/admin/categories/{category_id}/products/{id}/reposition":{"patch":{"summary":"Reposition a category product","tags":["Categories"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Moves a product to a new index among the category's products.\n\n**Required scope:** `write_categories` (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":"category_id","in":"path","required":true,"description":"Category ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product repositioned"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"new_position":{"type":"integer","description":"0-based index among the category's products"}},"required":["new_position"]}}}}}},"/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},"default":{"type":"boolean","default":false},"preferred_order_routing_strategy":{"type":"string","nullable":true,"description":"Routing strategy class name. `null` inherits the store setting."},"preferred_storefront_access":{"type":"string","nullable":true,"enum":["public","prices_hidden","login_required"],"description":"Anonymous-visitor access posture. `null` inherits the store setting."},"preferred_guest_checkout":{"type":"boolean","nullable":true,"description":"Whether guests can check out without an account. `null` inherits the store setting."}}}}}}}},"/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"},"default":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string","nullable":true,"description":"Routing strategy class name. `null` inherits the store setting."},"preferred_storefront_access":{"type":"string","nullable":true,"enum":["public","prices_hidden","login_required"],"description":"Anonymous-visitor access posture. `null` inherits the store setting."},"preferred_guest_checkout":{"type":"boolean","nullable":true,"description":"Whether guests can check out without an account. `null` inherits the store setting."}}}}}}},"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/channels/{channel_id}/order_routing_rules":{"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"List order routing rules for a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the channel's routing rules in priority order. The rules engine walks them top-down; see the Order Routing guide.\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":"rules found","content":{"application/json":{}}}}},"post":{"summary":"Create an order routing rule on a channel","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Adds a rule to the channel's routing list. The `type` is the wire shorthand from `GET /order_routing_rules/types` (e.g. `preferred_location`). Omitting `position` appends the rule at the end of the list. Each rule kind can appear at most once per channel — a duplicate `type` is rejected with a validation error.\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":"rule created","content":{"application/json":{}}},"422":{"description":"unknown rule type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"active":{"type":"boolean"},"position":{"type":"integer"},"preferences":{"type":"object","additionalProperties":true}},"required":["type"]}}}}}},"/api/v3/admin/channels/{channel_id}/order_routing_rules/{id}":{"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"summary":"Update an order routing rule","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a rule's `active` flag, `position` (the list reorders around it), or `preferences`. The rule kind cannot be changed — delete and re-create instead.\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":"rule updated","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"position":{"type":"integer"},"preferences":{"type":"object","additionalProperties":true}}}}}}},"delete":{"summary":"Delete an order routing rule","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":"rule deleted"}}}},"/api/v3/admin/order_routing_rules/types":{"get":{"summary":"List available order routing rule types","tags":["Channels"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Enumerates the registered rule kinds with their labels, descriptions and preference schemas — drives the \"Add rule\" picker in the admin dashboard. Plugins extend the list by registering `Spree::OrderRoutingRule` subclasses via `Spree.order_routing.rules`.\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":"types found","content":{"application/json":{}}}}}},"/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`)"},"searchable":{"type":"boolean","description":"When true, values are included in storefront product text search"},"sortable":{"type":"boolean","description":"When true, storefront product listings can sort by this field"}}}}}}}},"/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"},"searchable":{"type":"boolean"},"sortable":{"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":["products","orders","customers","product_translations","gift_cards","coupon_codes","newsletter_subscribers"]},"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},"results_url":{"type":"string","description":"Absolute URL of your admin exports view; the export-done email uses it as the download button target. Only honored when it matches one of the store's configured allowed origins."}}}}}}}},"/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":{}}}}},"post":{"summary":"Create a fulfillment","tags":["Fulfillments"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Manually creates a fulfillment on a completed order, bypassing order routing — for example to mirror a shipment handled by an external carrier or 3PL. Moves the requested line item quantities out of their current fulfillments; when `items` is omitted, every not-yet-shipped unit is moved. Pass `status: 'shipped'` to register an already-shipped fulfillment (fires shipped webhooks and freezes cost/carrier). When `delivery_method_id` is omitted, the fulfillment inherits the delivery method and cost of the source fulfillment(s) it fully drains — keeping the order total unchanged; partially drained splits get no carrier when shipped, and pending fulfillments are otherwise (re)priced by the standard rate engine, which selects the lowest-cost available rate. Pass `cost` to set an explicit shipping cost instead (e.g. the 3PL price) — note this changes the order total and payment state, and is guaranteed to persist only with `status: 'shipped'` (pending fulfillments are re-priced by the rate engine).\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"}}],"responses":{"201":{"description":"fulfillment created","content":{"application/json":{}}},"422":{"description":"order not completed","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["stock_location_id"],"properties":{"stock_location_id":{"type":"string","description":"Stock location the fulfillment ships from"},"tracking":{"type":"string","description":"Carrier tracking number, or a full https:// tracking link — a full URL is served back as tracking_url unchanged instead of being templated into the delivery method tracking URL"},"delivery_method_id":{"type":"string","description":"Delivery method (carrier) to attach as the selected rate. Defaults to the delivery method of the fully drained source fulfillment(s)"},"cost":{"type":"string","description":"Explicit shipping cost. Defaults to the summed cost of the fully drained source fulfillment(s), which keeps the order total unchanged; an explicit cost changes the order total and payment state. Guaranteed to persist only with status: 'shipped' — pending fulfillments are re-priced by the rate engine"},"status":{"type":"string","enum":["shipped"],"description":"Pass 'shipped' to register the fulfillment as already shipped"},"items":{"type":"array","description":"Line item quantities to fulfill. Omit to fulfill every not-yet-shipped unit.","items":{"type":"object","required":["item_id","quantity"],"properties":{"item_id":{"type":"string","description":"Line item ID"},"quantity":{"type":"integer"}}}},"metadata":{"type":"object","additionalProperties":true}}}}}}}},"/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 fulfillment (tracking, delivery 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","description":"Carrier tracking number, or a full https:// tracking link served back as tracking_url unchanged"},"selected_delivery_rate_id":{"type":"string","description":"Delivery rate ID (dr_...) to select"}}}}}}}},"/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/imports":{"get":{"summary":"List imports","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns CSV imports queued or completed for the current store.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"imports found","content":{"application/json":{}}}}},"post":{"summary":"Create an import","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Queues a CSV import. Upload the file first via `POST /api/v3/admin/direct_uploads`\nand pass the returned `signed_id` as `attachment`. On success the import is in the\n`mapping` state and the response carries the mapping payload: `schema_fields`\n(the canonical columns for the type), `csv_headers`, a `sample_row`, and the\nauto-assigned `mappings`.\n\nAdjust mappings if needed, then call `PATCH /admin/imports/{id}/complete_mapping`\nto start processing. Poll `GET /admin/imports/{id}` while `status` is\n`completed_mapping`/`processing`; terminal statuses are `completed` and `failed`.\n\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import created in mapping state","content":{"application/json":{}}},"422":{"description":"unknown import type","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type","attachment"],"properties":{"type":{"type":"string","enum":["products","customers","product_translations"]},"attachment":{"type":"string","description":"ActiveStorage signed blob id from POST /api/v3/admin/direct_uploads."},"preferred_delimiter":{"type":"string","enum":[",",";","|","\t"],"description":"CSV column separator. Defaults to a comma."},"results_url":{"type":"string","description":"Absolute URL of your admin imports view; the import-done email links back to it with `?import=<id>` appended. Only honored when it matches one of the store's configured allowed origins."}}}}}}}},"/api/v3/admin/imports/template":{"get":{"summary":"Download an import template","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a CSV header row for the given import type, including the custom field columns available for the model.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"type","in":"query","required":true,"description":"Registered import type, e.g. products.","schema":{"type":"string"}}],"responses":{"200":{"description":"CSV template","content":{"application/json":{},"text/csv":{"schema":{"type":"string","format":"binary"}}}}}}},"/api/v3/admin/imports/example":{"get":{"summary":"Download an example import file","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Redirects to a populated example CSV for the given import type — the same sample data `rake spree:load_sample_data` uses, pinned to the installed Spree version. Returns 404 for a type that ships no example file.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"type","in":"query","required":true,"description":"Registered import type, e.g. products.","schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect to the example CSV"}}}},"/api/v3/admin/imports/{id}":{"get":{"summary":"Show an import","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns import status and row counters. The admin dashboard polls this endpoint while `status` is `completed_mapping` or `processing`; `rows_count`, `completed_rows_count` and `failed_rows_count` drive the progress bar. The mapping payload (`csv_headers`, `sample_row`) is only present while `status` is `mapping`.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import found","content":{"application/json":{}}}}},"delete":{"summary":"Delete an import","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes the import, its rows and the uploaded file. Returns 422 while the import is being processed.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import deleted"}}}},"/api/v3/admin/imports/{id}/download":{"get":{"summary":"Download the originally uploaded file","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Streams the CSV exactly as it was uploaded — the audit trail for what was imported. JWT/API-key protected; SPA clients fetch it with the Authorization header and trigger the browser download via a Blob URL.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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/imports/{id}/complete_mapping":{"patch":{"summary":"Complete mapping and start processing","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Applies the submitted column mappings, then starts row processing. Omit `mappings`\nto accept the auto-assigned ones from the create response. Returns 422 when a\nrequired schema field is left unmapped (`details.missing_required_fields`) or a\nfile column is assigned twice.\n\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"mapping completed, processing queued","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mappings":{"type":"array","description":"Column assignments to apply before starting. `file_column: null` unmaps a field.","items":{"type":"object","required":["schema_field"],"properties":{"schema_field":{"type":"string"},"file_column":{"type":"string","nullable":true}}}}}}}}}}},"/api/v3/admin/imports/{id}/retry_failed_rows":{"patch":{"summary":"Retry failed rows","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Re-processes the rows that failed. The import re-enters `processing`; poll `GET /admin/imports/{id}` until it completes again. Returns 422 when the import is not `completed` or has no failed rows.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"retry queued","content":{"application/json":{}}}}}},"/api/v3/admin/imports/{import_id}/rows":{"get":{"summary":"List import rows","tags":["Imports"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Paginated rows of an import — the failure report. Filter with `q[status_eq]=failed` to list only rows that could not be imported; each row carries the raw CSV `data` and its `validation_errors`.\n\n**Required scope:** the write scope of the imported resource — `write_products` for product imports, `write_customers` for customer imports, 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":"import_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"q[status_eq]","in":"query","required":false,"description":"Filter rows by status: pending, processing, completed, failed.","schema":{"type":"string"}}],"responses":{"200":{"description":"rows found","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}/tax_lines":{"get":{"summary":"List tax lines","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Typed tax rows on the order. Read-only — written exclusively by the tax provider.\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,"schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order prefixed ID","schema":{"type":"string"}}],"responses":{"200":{"description":"tax lines found","content":{"application/json":{}}}}}},"/api/v3/admin/orders/{order_id}/discounts":{"get":{"summary":"List discounts","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Typed discount rows (promotion-sourced and manual) on the 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,"schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order prefixed ID","schema":{"type":"string"}}],"responses":{"200":{"description":"discounts found","content":{"application/json":{}}}}},"post":{"summary":"Create manual discount","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a manual discount. With line_item_id a single row is created; without it the amount is distributed across line items (largest remainder). This is the sanctioned post-placement discount path and works on completed orders.\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,"schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order prefixed ID","schema":{"type":"string"}}],"responses":{"201":{"description":"discount created","content":{"application/json":{}}},"422":{"description":"invalid discount","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"number"},"value_type":{"type":"string","enum":["flat","percent"]},"line_item_id":{"type":"string","nullable":true,"description":"Target line item; omit to distribute order-level"}},"required":["label","value"]}}}}}},"/api/v3/admin/orders/{order_id}/fees":{"post":{"summary":"Create fee","tags":["Orders"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a fee (surcharge, handling, gift wrap, COD). Order-level when no target is given. Works on completed orders.\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,"schema":{"type":"string"}},{"name":"order_id","in":"path","required":true,"description":"Order prefixed ID","schema":{"type":"string"}}],"responses":{"201":{"description":"fee created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string"},"amount":{"type":"number"},"kind":{"type":"string","description":"Defaults to 'surcharge'"},"line_item_id":{"type":"string","nullable":true},"fulfillment_id":{"type":"string","nullable":true}},"required":["label","amount"]}}}}}},"/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/{product_id}/translations":{"get":{"summary":"List product translations","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the full translation matrix for the product: the source value and content type per translatable field, plus the translated value for every supported locale.\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"}}],"responses":{"200":{"description":"translations found","content":{"application/json":{}}}}}},"/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_collections":{"post":{"summary":"Bulk-add products to collections","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Attaches each product in `ids` to every manual collection in `collection_ids`.\nAutomatic (rule-based) and sibling-store collections 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 collections","content":{"application/json":{"schema":{"type":"object","properties":{"product_count":{"type":"integer"},"collection_count":{"type":"integer"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","collection_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"collection_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v3/admin/products/bulk_remove_from_collections":{"post":{"summary":"Bulk-remove products from collections","tags":["Products"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Detaches each product in `ids` from every collection in `collection_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 collections","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["ids","collection_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"}},"collection_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/locales":{"get":{"summary":"List supported locales","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns the locales a merchant can translate content into for the current store, with the default and right-to-left flags.\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":"locales found","content":{"application/json":{}}}}}},"/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/translatable_resources":{"get":{"summary":"List translatable resources","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns every translatable resource type and its translatable fields (key + content type), so clients can render translation editors generically.\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":"translatable resources found","content":{"application/json":{}}}}}},"/api/v3/admin/translations/batch":{"post":{"summary":"Batch upsert translations","tags":["Settings"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Atomically upserts translations across many records of (possibly) different translatable resource types in one request — e.g. an option type and all its option values in one save. A flat list of independent registry writes; all entries succeed or none do.\n\n**Required scope:** `write_<resource>` for every resource type in the batch (for API-key authentication) (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":"translations upserted","content":{"application/json":{}}},"422":{"description":"unsupported locale rolls back the whole batch","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["translations"],"properties":{"translations":{"type":"array","items":{"type":"object","required":["resource_type","resource_id","values"],"properties":{"resource_type":{"type":"string","description":"Translatable resource type token, e.g. `option_type`"},"resource_id":{"type":"string","description":"Prefixed id of the record"},"values":{"type":"object","description":"Map of locale code to { field: value }","additionalProperties":{"type":"object","additionalProperties":true}}}}}}}}}}}},"/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 default 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"},"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":"A variant on a product with option types should declare its option pairs (e.g. size + color) — one per option type it 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"}}}}}}}},"/api/v3/admin/collections":{"get":{"summary":"List collections","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a paginated list of the store's collections.\n\n**Required scope:** `read_collections` (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":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., custom_fields, translations).","schema":{"type":"string"}}],"responses":{"200":{"description":"collections found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Collection"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"]}}}}}},"post":{"summary":"Create a collection","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a manual or automatic (rule-based) collection. For automatic collections, send the full desired rule set under `rules`.\n\n**Required scope:** `write_collections` (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":"collection created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}},"422":{"description":"validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"automatic":{"type":"boolean"},"rules_match_policy":{"type":"string","enum":["all","any"]},"sort_order":{"type":"string"},"permalink":{"type":"string"},"description":{"type":"string"},"meta_title":{"type":"string"},"meta_description":{"type":"string"},"meta_keywords":{"type":"string"},"rules":{"type":"array","description":"Full desired rule set. Entries with an id update, id-less entries create, omitted rules are removed.","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"value":{"type":"string"},"match_policy":{"type":"string"}}}}},"required":["name"]}}}}}},"/api/v3/admin/collections/{id}":{"get":{"summary":"Get a collection","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns a single collection by ID, including its rules.\n\n**Required scope:** `read_collections` (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":"Collection ID","schema":{"type":"string"}},{"name":"expand","in":"query","required":false,"description":"Comma-separated associations to expand (e.g., custom_fields, translations).","schema":{"type":"string"}}],"responses":{"200":{"description":"collection found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}},"404":{"description":"collection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"summary":"Update a collection","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Updates a collection. Send `position` to reorder it within the flat list; send the full `rules` set to sync automatic rules.\n\n**Required scope:** `write_collections` (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":"Collection ID","schema":{"type":"string"}}],"responses":{"200":{"description":"collection updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"permalink":{"type":"string"},"description":{"type":"string"},"meta_title":{"type":"string"},"meta_description":{"type":"string"},"meta_keywords":{"type":"string"},"sort_order":{"type":"string"},"automatic":{"type":"boolean"},"rules_match_policy":{"type":"string","enum":["all","any"]},"position":{"type":"integer","description":"Reorders the collection within the flat list (acts_as_list)"},"rules":{"type":"array","description":"Full desired rule set (see create).","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"value":{"type":"string"},"match_policy":{"type":"string"}}}}}}}}}},"delete":{"summary":"Delete a collection","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Deletes a collection.\n\n**Required scope:** `write_collections` (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":"Collection ID","schema":{"type":"string"}}],"responses":{"204":{"description":"collection deleted"}}}},"/api/v3/admin/collections/{collection_id}/products":{"get":{"summary":"List collection products","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Products curated in the collection, ordered by their membership position.\n\n**Required scope:** `read_collections` (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":"collection_id","in":"path","required":true,"description":"Collection ID","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"]}}}}}},"post":{"summary":"Add a product to a collection","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Curates a product into the collection (appended to the end).\n\n**Required scope:** `write_collections` (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":"collection_id","in":"path","required":true,"description":"Collection ID","schema":{"type":"string"}}],"responses":{"201":{"description":"product added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]}}}}}},"/api/v3/admin/collections/{collection_id}/products/{id}":{"delete":{"summary":"Remove a product from a collection","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Removes a product from the collection's manual curation.\n\n**Required scope:** `write_collections` (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":"collection_id","in":"path","required":true,"description":"Collection ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product removed"}}}},"/api/v3/admin/collections/{collection_id}/products/{id}/reposition":{"patch":{"summary":"Reposition a collection product","tags":["Collections"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Moves a product to a new index among the collection's products.\n\n**Required scope:** `write_collections` (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":"collection_id","in":"path","required":true,"description":"Collection ID","schema":{"type":"string"}},{"name":"id","in":"path","required":true,"description":"Product ID","schema":{"type":"string"}}],"responses":{"204":{"description":"product repositioned"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"new_position":{"type":"integer","description":"0-based index among the collection's products"}},"required":["new_position"]}}}}}},"/api/v3/admin/delivery_methods":{"get":{"summary":"List delivery methods","tags":["Delivery"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Returns all delivery methods with calculator and zone configuration.\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":"delivery methods found","content":{"application/json":{}}}}},"post":{"summary":"Create delivery method","tags":["Delivery"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a delivery method. fulfillment_type is one of shipping, digital, pickup, pickup_point.\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":"delivery method created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"admin_name":{"type":"string","nullable":true},"code":{"type":"string","nullable":true},"fulfillment_type":{"type":"string","enum":["shipping","digital","pickup","pickup_point"]},"storefront_visible":{"type":"boolean"},"tracking_url":{"type":"string","nullable":true},"estimated_transit_business_days_min":{"type":"integer","nullable":true},"estimated_transit_business_days_max":{"type":"integer","nullable":true},"tax_category_id":{"type":"string","nullable":true},"calculator_type":{"type":"string"},"calculator_preferences":{"type":"object"},"delivery_zone_ids":{"type":"array","items":{"type":"string"}}},"required":["name"]}}}}}},"/api/v3/admin/delivery_methods/calculators":{"get":{"summary":"List delivery calculators","tags":["Delivery"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Registered delivery calculator classes with preference schemas for building configuration forms.\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":"calculators found","content":{"application/json":{}}}}}},"/api/v3/admin/delivery_zones":{"post":{"summary":"Create delivery zone","tags":["Delivery"],"security":[{"api_key":[],"bearer_auth":[]}],"description":"Creates a delivery zone with typed members: country, state, or postal_code (prefix or from/to range).\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":"delivery zone created","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"members":{"type":"array","items":{"type":"object","properties":{"member_type":{"type":"string","enum":["country","state","postal_code"]},"country_iso":{"type":"string","nullable":true},"state_abbr":{"type":"string","nullable":true},"postal_code_prefix":{"type":"string","nullable":true},"postal_code_from":{"type":"string","nullable":true},"postal_code_to":{"type":"string","nullable":true}},"required":["member_type"]}}},"required":["name"]}}}}}}},"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"]},"ImportSchemaField":{"type":"object","description":"A canonical column of an import type, including per-store custom field columns","properties":{"name":{"type":"string","description":"Canonical field name used in mappings"},"label":{"type":"string","description":"Human-readable label"},"required":{"type":"boolean","description":"Whether the field must be mapped before processing"}},"required":["name","label","required"]},"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"]},"AdminUserStore":{"type":"object","description":"A store the staff member can access through a role assignment","properties":{"id":{"type":"string","description":"Prefixed store ID"},"name":{"type":"string","description":"Store name"},"code":{"type":"string","description":"Store code"}},"required":["id","name","code"]},"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},"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"},"avatar_url":{"type":"string","nullable":true},"roles":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserRoleAssignment"}},"stores":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserStore"}}},"required":["id","email","first_name","last_name","full_name","selected_locale","created_at","updated_at","avatar_url","roles","stores"],"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},"channel_id":{"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","channel_id","plaintext_token","created_by_email"],"x-typelizer":true},"AppliedPromotion":{"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},"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"}},"translations":{"type":"object"},"metadata":{"type":"object"},"pretty_name":{"type":"string"},"lft":{"type":"number"},"rgt":{"type":"number"},"products_count":{"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","products_count","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"},"storefront_access":{"type":"string"},"guest_checkout":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string","nullable":true},"preferred_storefront_access":{"type":"string","nullable":true},"preferred_guest_checkout":{"type":"boolean","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","code","active","default","storefront_access","guest_checkout","preferred_order_routing_strategy","preferred_storefront_access","preferred_guest_checkout","created_at","updated_at"],"x-typelizer":true},"CollectionRule":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"value":{"type":"string","nullable":true},"match_policy":{"type":"string"}},"required":["id","type","value","match_policy"],"x-typelizer":true},"Collection":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"permalink":{"type":"string"},"position":{"type":"number"},"sort_order":{"type":"string"},"meta_title":{"type":"string","nullable":true},"meta_description":{"type":"string","nullable":true},"meta_keywords":{"type":"string","nullable":true},"products_count":{"type":"number"},"description":{"type":"string"},"description_html":{"type":"string"},"image_url":{"type":"string","nullable":true},"square_image_url":{"type":"string","nullable":true},"custom_fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"translations":{"type":"object"},"automatic":{"type":"boolean"},"rules_match_policy":{"type":"string"},"metadata":{"type":"object"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/CollectionRule"}}},"required":["id","name","permalink","position","sort_order","meta_title","meta_description","meta_keywords","products_count","description","description_html","image_url","square_image_url","automatic","rules_match_policy","metadata","created_at","updated_at","rules"],"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":"string"},"updated_at":{"type":"string"}},"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"},"searchable":{"type":"boolean"},"sortable":{"type":"boolean"},"filter_key":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","namespace","key","label","field_type","resource_type","storefront_visible","searchable","sortable","filter_key","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},"newsletter_subscriber":{"allOf":[{"$ref":"#/components/schemas/NewsletterSubscriber"}],"nullable":true},"customer_groups":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroup"}},"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_group_ids":{"type":"array","items":{"type":"string"}}},"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","customer_group_ids"],"x-typelizer":true},"DeliveryMethod":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string","nullable":true},"fulfillment_type":{"type":"string"},"estimated_transit_business_days_min":{"type":"number","nullable":true},"estimated_transit_business_days_max":{"type":"number","nullable":true},"admin_name":{"type":"string","nullable":true},"fulfillment_provider":{"type":"string"},"pickup_point_provider":{"type":"string","nullable":true},"storefront_visible":{"type":"boolean"},"tracking_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"deleted_at":{"type":"string"},"tax_category_id":{"type":"string","nullable":true},"delivery_zone_ids":{"type":"array","items":{"type":"string"}},"calculator_type":{"type":"string","nullable":true},"calculator_preferences":{"type":"object","nullable":true}},"required":["id","name","code","fulfillment_type","estimated_transit_business_days_min","estimated_transit_business_days_max","admin_name","fulfillment_provider","pickup_point_provider","storefront_visible","tracking_url","created_at","updated_at","deleted_at","tax_category_id","delivery_zone_ids","calculator_type","calculator_preferences"],"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},"DeliveryZoneMember":{"type":"object","properties":{"id":{"type":"string"},"member_type":{"type":"string"},"postal_code_prefix":{"type":"string","nullable":true},"postal_code_from":{"type":"string","nullable":true},"postal_code_to":{"type":"string","nullable":true},"country_iso":{"type":"string","nullable":true},"state_abbr":{"type":"string","nullable":true},"state_name":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","member_type","postal_code_prefix","postal_code_from","postal_code_to","country_iso","state_abbr","state_name","created_at","updated_at"],"x-typelizer":true},"DeliveryZone":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"members":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryZoneMember"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"delivery_method_ids":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","members","created_at","updated_at","delivery_method_ids"],"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"},"label":{"type":"string"},"kind":{"type":"string"},"code":{"type":"string","nullable":true},"value_type":{"type":"string","nullable":true},"value":{"type":"string","nullable":true},"promotion_id":{"type":"string","nullable":true},"line_item_id":{"type":"string","nullable":true},"fulfillment_id":{"type":"string","nullable":true},"amount":{"type":"string"},"display_amount":{"type":"string"},"metadata":{"type":"object","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","label","kind","code","value_type","value","promotion_id","line_item_id","fulfillment_id","amount","display_amount","metadata","created_at","updated_at"],"x-typelizer":true},"Export":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"format":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string","nullable":true},"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","format","created_at","updated_at","type","user_id","done","filename","byte_size","download_url"],"x-typelizer":true},"Fee":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"},"line_item_id":{"type":"string","nullable":true},"fulfillment_id":{"type":"string","nullable":true},"amount":{"type":"string"},"display_amount":{"type":"string"},"metadata":{"type":"object","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","label","kind","line_item_id","fulfillment_id","amount","display_amount","metadata","created_at","updated_at"],"x-typelizer":true},"Fulfillment":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"tracking":{"type":"string","nullable":true},"tracking_url":{"type":"string","nullable":true},"pickup_point_data":{"type":"object","nullable":true},"selected_delivery_rate_id":{"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"}},"required":["id","number","tracking","tracking_url","pickup_point_data","selected_delivery_rate_id","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},"ImportMapping":{"type":"object","properties":{"id":{"type":"string"},"schema_field":{"type":"string"},"file_column":{"type":"string","nullable":true},"required":{"type":"boolean"}},"required":["id","schema_field","file_column","required"],"x-typelizer":true},"ImportRow":{"type":"object","properties":{"id":{"type":"string"},"row_number":{"type":"number"},"status":{"type":"string"},"validation_errors":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"import_id":{"type":"string","nullable":true},"item_type":{"type":"string","nullable":true},"item_id":{"type":"string","nullable":true},"data":{"type":"object"}},"required":["id","row_number","status","validation_errors","created_at","updated_at","import_id","item_type","item_id","data"],"x-typelizer":true},"Import":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"rows_count":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string","nullable":true},"status":{"type":"string"},"owner_type":{"type":"string","nullable":true},"owner_id":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true},"processing_errors":{"type":"string","nullable":true},"preferred_delimiter":{"type":"string"},"original_filename":{"type":"string","nullable":true},"original_byte_size":{"type":"number","nullable":true},"original_file_url":{"type":"string","nullable":true},"completed_rows_count":{"type":"number"},"failed_rows_count":{"type":"number"},"schema_fields":{"type":"array","items":{"$ref":"#/components/schemas/ImportSchemaField"}},"csv_headers":{"type":"array","items":{"type":"string"}},"sample_row":{"type":"object"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/ImportMapping"}}},"required":["id","number","rows_count","created_at","updated_at","type","status","owner_type","owner_id","user_id","processing_errors","preferred_delimiter","original_filename","original_byte_size","original_file_url","completed_rows_count","failed_rows_count","schema_fields","csv_headers","sample_row","mappings"],"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"},"preorder":{"type":"boolean"},"preorder_ships_at":{"type":"string","nullable":true},"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"}},"required":["id","variant_id","preorder","preorder_ships_at","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},"NewsletterSubscriber":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"verified":{"type":"boolean"},"verified_at":{"type":"string","nullable":true},"customer_id":{"type":"string","nullable":true}},"required":["id","email","created_at","updated_at","verified","verified_at","customer_id"],"x-typelizer":true},"OptionType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"label":{"type":"string"},"position":{"type":"number"},"kind":{"type":"string"},"translations":{"type":"object"},"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},"OrderRoutingRule":{"type":"object","properties":{"id":{"type":"string"},"position":{"type":"number"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"type":{"type":"string"},"channel_id":{"type":"string"},"preferences":{"type":"object"},"preference_schema":{"type":"object"},"label":{"type":"string"},"description":{"type":"string"}},"required":["id","position","active","created_at","updated_at","type","channel_id","preferences","preference_schema","label","description"],"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"},"fulfillment_status":{"type":"string","nullable":true},"payment_status":{"type":"string","nullable":true},"completed_at":{"type":"string","nullable":true},"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"},"store_credit_total":{"type":"string"},"display_store_credit_total":{"type":"string"},"covered_by_store_credit":{"type":"boolean"},"discounts":{"type":"array","items":{"$ref":"#/components/schemas/AppliedPromotion"}},"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"},"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","fulfillment_status","payment_status","completed_at","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","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"}},"channels":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}},"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},"preorder_ships_at":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"preorder":{"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},"translations":{"type":"object"},"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","preorder_ships_at","purchasable","preorder","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"}},"channels":{"type":"array","items":{"$ref":"#/components/schemas/Channel"}},"markets":{"type":"array","items":{"$ref":"#/components/schemas/Market"}}},"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},"SetupTask":{"type":"object","properties":{"name":{"type":"string"},"done":{"type":"boolean"}},"required":["name","done"],"x-typelizer":true},"State":{"type":"object","properties":{"abbr":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"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"},"code":{"type":"string"},"preferred_storefront_url":{"type":"string","nullable":true},"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"},"preferred_storefront_access":{"type":"string"},"preferred_guest_checkout":{"type":"boolean"},"preferred_order_routing_strategy":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"url":{"type":"string"},"api_url":{"type":"string"},"setup_tasks":{"type":"array","items":{"$ref":"#/components/schemas/SetupTask"}},"supported_currencies":{"type":"array","items":{"type":"string"}},"supported_locales":{"type":"array","items":{"type":"string"}},"available_locales":{"type":"array","items":{"type":"string"}},"logo_url":{"type":"string","nullable":true},"mailer_logo_url":{"type":"string","nullable":true}},"required":["id","metadata","name","code","preferred_storefront_url","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","preferred_storefront_access","preferred_guest_checkout","preferred_order_routing_strategy","created_at","updated_at","url","api_url","setup_tasks","supported_currencies","supported_locales","available_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},"TaxLine":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"included":{"type":"boolean"},"rate":{"type":"string"},"tax_rate_id":{"type":"string","nullable":true},"line_item_id":{"type":"string","nullable":true},"fulfillment_id":{"type":"string","nullable":true},"fee_id":{"type":"string","nullable":true},"amount":{"type":"string"},"display_amount":{"type":"string"},"provider_id":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","label","included","rate","tax_rate_id","line_item_id","fulfillment_id","fee_id","amount","display_amount","provider_id","metadata","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"},"preorder_ships_at":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"purchasable":{"type":"boolean"},"in_stock":{"type":"boolean"},"backorderable":{"type":"boolean"},"preorder":{"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},"backorder_limit":{"type":"number","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"preorderable":{"type":"boolean"},"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","preorder_ships_at","thumbnail_url","purchasable","in_stock","backorderable","preorder","weight","height","width","depth","price","original_price","option_values","metadata","position","cost_price","cost_currency","barcode","weight_unit","dimensions_unit","backorder_limit","deleted_at","created_at","updated_at","preorderable","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},"created_at":{"type":"string"},"updated_at":{"type":"string"},"delivered_at":{"type":"string","nullable":true},"payload":{"type":"object"},"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","created_at","updated_at","delivered_at","payload","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/cli/src/generated/resource-paths.json b/packages/cli/src/generated/resource-paths.jsonindex cc1a6f4439..cc0a2b4232 100644--- a/packages/cli/src/generated/resource-paths.json+++ b/packages/cli/src/generated/resource-paths.json@@ -1 +1 @@-["/admin_users","/allowed_origins","/api_keys","/auth","/categories","/channels","/collections","/custom_field_definitions","/customer_groups","/customers","/exports","/gift_card_batches","/gift_cards","/imports","/invitations","/locales","/markets","/me","/option_types","/order_routing_rules","/orders","/payment_methods","/price_lists","/prices","/products","/promotion_actions","/promotion_rules","/promotions","/roles","/stock_locations","/store","/store_credit_categories","/tags","/translatable_resources","/translations","/webhook_endpoints"]\ No newline at end of file+["/admin_users","/allowed_origins","/api_keys","/auth","/categories","/channels","/collections","/custom_field_definitions","/customer_groups","/customers","/delivery_methods","/delivery_zones","/exports","/gift_card_batches","/gift_cards","/imports","/invitations","/locales","/markets","/me","/option_types","/order_routing_rules","/orders","/payment_methods","/price_lists","/prices","/products","/promotion_actions","/promotion_rules","/promotions","/roles","/stock_locations","/store","/store_credit_categories","/tags","/translatable_resources","/translations","/webhook_endpoints"]\ No newline at end of filediff --git a/packages/dashboard-core/src/lib/permissions.ts b/packages/dashboard-core/src/lib/permissions.tsindex 28e08f75e7..c689bb06ed 100644--- a/packages/dashboard-core/src/lib/permissions.ts+++ b/packages/dashboard-core/src/lib/permissions.ts@@ -26,6 +26,9 @@ export const Subject = {TaxCategory: 'Spree::TaxCategory',CustomFieldDefinition: 'Spree::MetafieldDefinition',PaymentMethod: 'Spree::PaymentMethod',+ DeliveryMethod: 'Spree::DeliveryMethod',+ DeliveryZone: 'Spree::DeliveryZone',+ /** @deprecated Use Subject.DeliveryMethod — removed in Spree 6.1. */ShippingMethod: 'Spree::ShippingMethod',StockLocation: 'Spree::StockLocation',StockItem: 'Spree::StockItem',diff --git a/packages/dashboard/e2e/delivery-settings.spec.ts b/packages/dashboard/e2e/delivery-settings.spec.tsnew file mode 100644index 0000000000..b64ab8eac6--- /dev/null+++ b/packages/dashboard/e2e/delivery-settings.spec.ts@@ -0,0 +1,60 @@+import { expect, test } from '@playwright/test'+import { gotoIndex, login } from './helpers'++const ZONES_PATH = (storeId: string) => `/${storeId}/settings/delivery-zones`+const METHODS_PATH = (storeId: string) => `/${storeId}/settings/delivery-methods`+const ZONES_CTA = /add delivery zone/i+const METHODS_CTA = /add delivery method/i++test.describe('delivery zones', () => {+ test('lists delivery zones', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, ZONES_PATH(creds.store_id), ZONES_CTA)+ })++ test('creates a delivery zone with a country member', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, ZONES_PATH(creds.store_id), ZONES_CTA)++ const name = `E2E Zone ${Date.now()}`++ await page.getByRole('button', { name: ZONES_CTA }).click()+ await expect(page.getByRole('heading', { name: /new delivery zone/i })).toBeVisible()++ await page.locator('#name').fill(name)+ await page.getByRole('button', { name: /add member/i }).click()+ // Second combobox in the member row is the country picker.+ await page.getByRole('combobox').nth(1).click()+ await page.getByRole('option', { name: /united states/i }).click()++ await page.getByRole('button', { name: /create delivery zone/i }).click()++ await expect(page.getByText(name)).toBeVisible({ timeout: 15_000 })+ })+})++test.describe('delivery methods', () => {+ test('lists delivery methods', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, METHODS_PATH(creds.store_id), METHODS_CTA)+ })++ test('creates a pickup delivery method', async ({ page }) => {+ const creds = await login(page)+ await gotoIndex(page, METHODS_PATH(creds.store_id), METHODS_CTA)++ const name = `E2E Pickup ${Date.now()}`++ await page.getByRole('button', { name: METHODS_CTA }).click()+ await expect(page.getByRole('heading', { name: /new delivery method/i })).toBeVisible()++ await page.locator('#name').fill(name)+ // Fulfillment type select — first combobox in the sheet form.+ await page.getByRole('combobox').first().click()+ await page.getByRole('option', { name: /^pickup$/i }).click()++ await page.getByRole('button', { name: /create delivery method/i }).click()++ await expect(page.getByText(name)).toBeVisible({ timeout: 15_000 })+ })+})diff --git a/packages/dashboard/src/hooks/use-delivery-methods.ts b/packages/dashboard/src/hooks/use-delivery-methods.tsnew file mode 100644index 0000000000..8de6d81e40--- /dev/null+++ b/packages/dashboard/src/hooks/use-delivery-methods.ts@@ -0,0 +1,58 @@+import type { DeliveryMethod, DeliveryMethodParams } from '@spree/admin-sdk'+import {+ adminClient,+ useResourceKey,+ useResourceKeyBuilder,+ useResourceMutation,+} from '@spree/dashboard-core'+import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'++export function useDeliveryMethod(id: string | undefined) {+ return useQuery({+ queryKey: useResourceKey('delivery-methods', id ?? 'noop'),+ queryFn: () => adminClient.deliveryMethods.get(id as string),+ enabled: !!id,+ })+}++export function useDeliveryCalculators() {+ return useQuery({+ queryKey: useResourceKey('delivery-methods', 'calculators'),+ queryFn: () => adminClient.deliveryMethods.calculators(),+ staleTime: 1000 * 60 * 30,+ })+}++export function useCreateDeliveryMethod() {+ return useResourceMutation<DeliveryMethod, Error, DeliveryMethodParams>({+ mutationFn: (params) => adminClient.deliveryMethods.create(params),+ invalidate: [['delivery-methods']],+ successMessage: i18n.t('admin.delivery_methods.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),+ })+}++export function useUpdateDeliveryMethod(id: string) {+ return useResourceMutation<DeliveryMethod, Error, DeliveryMethodParams>({+ mutationFn: (params) => adminClient.deliveryMethods.update(id, params),+ invalidate: [['delivery-methods'], ['delivery-methods', id]],+ successMessage: i18n.t('admin.delivery_methods.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),+ })+}++export function useDeleteDeliveryMethod() {+ const queryClient = useQueryClient()+ const buildKey = useResourceKeyBuilder()++ return useResourceMutation<void, Error, string>({+ mutationFn: (id) => adminClient.deliveryMethods.delete(id),+ invalidate: [['delivery-methods']],+ successMessage: i18n.t('admin.delivery_methods.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),+ onSuccess: (_data, id) => {+ queryClient.removeQueries({ queryKey: buildKey('delivery-methods', id) })+ },+ })+}diff --git a/packages/dashboard/src/hooks/use-delivery-zones.ts b/packages/dashboard/src/hooks/use-delivery-zones.tsnew file mode 100644index 0000000000..2b865692d9--- /dev/null+++ b/packages/dashboard/src/hooks/use-delivery-zones.ts@@ -0,0 +1,64 @@+import type { DeliveryZone, DeliveryZoneParams } from '@spree/admin-sdk'+import {+ adminClient,+ useResourceKey,+ useResourceKeyBuilder,+ useResourceMutation,+} from '@spree/dashboard-core'+import { useQuery, useQueryClient } from '@tanstack/react-query'+import i18n from 'i18next'++export function useDeliveryZones({+ page = 1,+ limit = 100,+}: {+ page?: number+ limit?: number+} = {}) {+ return useQuery({+ queryKey: useResourceKey('delivery-zones', { page, limit }),+ queryFn: () => adminClient.deliveryZones.list({ page, limit }),+ staleTime: 1000 * 60 * 5,+ })+}++export function useDeliveryZone(id: string | undefined) {+ return useQuery({+ queryKey: useResourceKey('delivery-zones', id ?? 'noop'),+ queryFn: () => adminClient.deliveryZones.get(id as string),+ enabled: !!id,+ })+}++export function useCreateDeliveryZone() {+ return useResourceMutation<DeliveryZone, Error, DeliveryZoneParams>({+ mutationFn: (params) => adminClient.deliveryZones.create(params),+ invalidate: [['delivery-zones']],+ successMessage: i18n.t('admin.delivery_zones.messages.created'),+ errorMessage: i18n.t('admin.errors.failed_to_create'),+ })+}++export function useUpdateDeliveryZone(id: string) {+ return useResourceMutation<DeliveryZone, Error, DeliveryZoneParams>({+ mutationFn: (params) => adminClient.deliveryZones.update(id, params),+ invalidate: [['delivery-zones'], ['delivery-zones', id]],+ successMessage: i18n.t('admin.delivery_zones.messages.updated'),+ errorMessage: i18n.t('admin.errors.failed_to_update'),+ })+}++export function useDeleteDeliveryZone() {+ const queryClient = useQueryClient()+ const buildKey = useResourceKeyBuilder()++ return useResourceMutation<void, Error, string>({+ mutationFn: (id) => adminClient.deliveryZones.delete(id),+ invalidate: [['delivery-zones']],+ successMessage: i18n.t('admin.delivery_zones.messages.deleted'),+ errorMessage: i18n.t('admin.errors.failed_to_delete'),+ onSuccess: (_data, id) => {+ queryClient.removeQueries({ queryKey: buildKey('delivery-zones', id) })+ },+ })+}diff --git a/packages/dashboard/src/hooks/use-order.ts b/packages/dashboard/src/hooks/use-order.tsindex 66ae4ad5e0..83fe03b095 100644--- a/packages/dashboard/src/hooks/use-order.ts+++ b/packages/dashboard/src/hooks/use-order.ts@@ -51,3 +51,44 @@ export function useOrderMutation<TParams>(export function orderQueryKey(orderId: string): QueryKey {return ['orders', orderId]}++export function useOrderTaxLines(orderId: string) {+ return useQuery({+ queryKey: useResourceKey('orders', orderId, 'tax_lines'),+ queryFn: () => adminClient.orders.taxLines.list(orderId),+ enabled: !!orderId,+ })+}++export function useOrderDiscounts(orderId: string) {+ return useQuery({+ queryKey: useResourceKey('orders', orderId, 'discounts'),+ queryFn: () => adminClient.orders.discounts.list(orderId),+ enabled: !!orderId,+ })+}++export function useOrderFees(orderId: string) {+ return useQuery({+ queryKey: useResourceKey('orders', orderId, 'fees'),+ queryFn: () => adminClient.orders.fees.list(orderId),+ enabled: !!orderId,+ })+}++/**+ * Mutation for typed adjustment rows: invalidates the order detail AND the+ * nested tax_lines/discounts/fees lists (totals change server-side on every+ * row mutation).+ */+export function useOrderAdjustmentLinesMutation<TParams>(+ orderId: string,+ mutationFn: (params: TParams) => Promise<unknown>,+) {+ const queryClient = useQueryClient()+ const buildKey = useResourceKeyBuilder()+ return useMutation({+ mutationFn,+ onSuccess: () => queryClient.invalidateQueries({ queryKey: buildKey('orders', orderId) }),+ })+}diff --git a/packages/dashboard/src/locales/ar.json b/packages/dashboard/src/locales/ar.jsonindex d28bb4c96c..aa49041073 100644--- a/packages/dashboard/src/locales/ar.json+++ b/packages/dashboard/src/locales/ar.json@@ -1,317 +1,628 @@{"admin": {"a11y": {- "edit_media": "تعديل الصورة",- "delete_image": "حذف الصورة"+ "delete_image": "حذف الصورة",+ "edit_media": "تعديل الصورة"},- "gift_cards": {- "statuses": {- "partially_redeemed": "مُستَخدمة جزئيًا",- "redeemed": "مُستَخدمة",- "canceled": "ملغاة",- "expired": "منتهية الصلاحية"- },- "columns": {- "used": "مُستخدم",- "remaining": "المتبقي",- "batch": "دفعة",- "customer": "العميل",- "issued_by": "صادرة من"- },- "table": {- "search_placeholder": "البحث بالرمز…",- "empty": "لا توجد بطاقات هدايا بعد"+ "allowed_origins": {+ "add_cta": "أضف الأصل المسموح به",+ "create_description": "يمكن للمتصفحات المحملة من هذا الأصل الاتصال بالمسؤول API. تعتمد كل من القائمة المسموح بها CORS وجلسة ملفات تعريف الارتباط للمشرف على هذه القائمة - أبقِها ضيقة.",+ "create_label": "أضف الأصل",+ "delete_confirm": {+ "message": "لن يكون {{origin}} قادرًا على الاتصال بالمسؤول API من المتصفح. ولا تتأثر طلبات خادم إلى خادم الموجودة.",+ "title": "هل تريد إزالة الأصل المسموح به؟"},+ "edit_description": "يؤدي تحديث الأصل على الفور إلى تغيير من يمكنه الاتصال بالمسؤول API من المتصفح.",+ "empty": "لا توجد أصول مسموح بها حتى الآن","messages": {- "created": "تم إنشاء بطاقة الهدايا",- "create_failed": "فشل إنشاء بطاقة الهدايا",- "updated": "تم تحديث بطاقة الهدايا",- "update_failed": "فشل تحديث بطاقة الهدايا",- "deleted": "تم حذف بطاقة الهدايا",- "delete_failed": "فشل حذف بطاقة الهدايا",- "batch_created": "تم إنشاء دفعة بطاقات الهدايا",- "batch_create_failed": "فشل إنشاء دفعة بطاقات الهدايا"+ "added": "تمت إضافة الأصل المسموح به",+ "removed": "تمت إزالة الأصل المسموح به",+ "updated": "تم تحديث الأصل المسموح به"},- "batch_autocomplete": {- "placeholder": "البحث في الدفعات بالبادئة…",- "empty": "لا توجد دفعات مطابقة"+ "search_placeholder": "البحث حسب الأصل…",+ "table_title": "الأصول المسموح بها",+ "validation": {+ "bare_origin": "يجب أن يكون أصلًا مجردًا (على سبيل المثال https://shop.example.com) — بدون مسار أو استعلام أو جزء"}},- "option_types": {- "kinds": {- "dropdown": "Dropdown",- "color_swatch": "Color swatch",- "buttons": "Buttons"+ "api_keys": {+ "badge": {+ "never_used": "Never",+ "revoked": "تم إبطاله"},- "columns": {- "values": "القيم"+ "by_email": "بواسطة {{email}}",+ "create_key_cta": "إنشاء مفتاح",+ "create_sheet_description": "اختر نوع المفتاح، ثم اختر النطاقات التي يمكنه استخدامها.",+ "create_sheet_title": "قم بإنشاء مفتاح API",+ "delete_confirm": {+ "message": "يؤدي هذا إلى إزالة المفتاح بشكل دائم. تفضل الإلغاء إذا كان بإمكانك استعادة الوصول لاحقًا.",+ "title": "هل تريد حذف المفتاح؟"},- "value_count_one": "{{count}} قيمة",- "value_count_other": "{{count}} قيم",- "table": {- "search_placeholder": "البحث بالاسم…",- "empty": "لا توجد أنواع خيارات بعد"+ "dropdown": {+ "copy_token_aria": "نسخ الرمز المميز",+ "revoke": "إبطال المفتاح"},- "messages": {- "created": "تم إنشاء نوع الخيار",- "updated": "تم تحديث نوع الخيار",- "deleted": "تم حذف نوع الخيار"- }- },- "markets": {- "add_cta": "إضافة سوق",- "create_description": "اجمع الدول في منطقة تسعير واحدة بعملتها ولغاتها الخاصة.",- "edit_description": "حدّث الاسم أو العملة أو اللغات أو تغطية الدول.",- "create_label": "إنشاء سوق",- "delete_confirm": {- "title": "حذف السوق؟",- "message": "سيتم إزالة {{name}}. الطلبات السابقة في هذا السوق تبقى كما هي."+ "edit_sheet_description": "إعادة تسمية هذا المفتاح. يتم إصلاح Scopes عند إنشاء مفتاح ولا يمكن تغييره.",+ "edit_sheet_title": "تحرير مفتاح API",+ "empty_description": "قم بإنشاء واحدة للبدء.",+ "errors": {+ "failed_to_create": "فشل في إنشاء المفتاح",+ "failed_to_delete": "فشل في حذف المفتاح",+ "failed_to_update": "فشل في تحديث المفتاح"},- "search_placeholder": "البحث بالاسم…",- "empty": "لا توجد أسواق بعد",- "tax_inclusive": "شامل",- "tax_exclusive": "غير شامل",+ "key_type": {+ "publishable_description": "آمن للكشف في التعليمات البرمجية من جانب العميل. يمنح وصول الجمهور/الضيف.",+ "publishable_title": "مفتاح قابل للنشر",+ "secret_description": "خادم إلى خادم. يحمل كل مفتاح قائمة واضحة من النطاقات.",+ "secret_title": "المفتاح السري"+ },+ "revoke_confirm": {+ "message": "أي تكامل يستخدم هذا المفتاح سوف يتوقف عن العمل على الفور.",+ "title": "إبطال المفتاح؟"+ },+ "scope_picker": {+ "full_access_hint": "- قراءة + الكتابة على كل الموارد",+ "full_access_label": "Full access (write_all)",+ "read_all_hint": "- اقرأ على كل مورد",+ "read_all_label": "Read all (read_all)",+ "read_aria": "إقرأ {{resource}}",+ "read_header": "يقرأ",+ "resource_header": "الموارد",+ "resources": {+ "api_keys": "API مفاتيح",+ "categories": "فئات",+ "customers": "العملاء",+ "dashboard": "Dashboard",+ "fulfillments": "Fulfillments",+ "gift_cards": "بطاقات الهدايا",+ "orders": "طلبات",+ "payments": "المدفوعات",+ "products": "منتجات",+ "promotions": "الترقيات",+ "refunds": "المبالغ المستردة",+ "settings": "إعدادات",+ "stock": "مخزون",+ "store_credits": "Store credits",+ "webhooks": "Webhooks"+ },+ "show_more_aria_one": "أظهر {{count}} نطاقًا أكبر",+ "show_more_aria_other": "عرض {{count}} المزيد من النطاقات",+ "write_aria": "اكتب {{resource}}",+ "write_header": "يكتب"+ },+ "scopes_immutable_help": "Scopes لا يمكن تغييره بعد إنشاء المفتاح. لتغييرها، قم بإنشاء مفتاح جديد بالنطاقات التي تحتاجها وقم بإبطال هذا المفتاح.",+ "validation": {+ "scope_required": "اختر نطاقًا واحدًا على الأقل"+ },+ "warning_treat_like_password": "تعامل مع هذا المفتاح ككلمة مرور. قم بتخزينه في مدير الأسرار لديك — لا يمكننا إظهاره مرة أخرى."+ },+ "calculators": {+ "default_refund_amount": "Default Refund Amount",+ "default_tax": "Default Tax",+ "digital_delivery": "Digital Delivery",+ "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"+ },+ "categories": {+ "add_cta": "فئة جديدة",+ "collapse": "طي","columns": {- "default": "افتراضي"+ "name": "الاسم",+ "products": "المنتجات"+ },+ "delete_confirm": "حذف الفئة \"{{name}}\" وجميع فئاتها الفرعية؟",+ "delete_label": "حذف الفئة",+ "empty": "لا توجد فئات بعد.",+ "expand": "توسيع",+ "fields": {+ "parent": {+ "label": "الفئة الأصل",+ "placeholder": "المستوى الأعلى"+ }+ },+ "images": {+ "help": "تُستخدم في لافتات الفئات. يُوصى بـ 1920×1080.",+ "label": "صورة",+ "square_help": "تُستخدم في التنقل المُدمج. يُوصى بـ 400×400.",+ "square_label": "صورة مربعة",+ "title": "الصور"},+ "load_failed": "فشل تحميل الفئات. يرجى المحاولة مرة أخرى.","messages": {- "created": "تم إنشاء السوق",- "updated": "تم تحديث السوق",- "deleted": "تم حذف السوق"+ "created": "تم إنشاء الفئة",+ "deleted": "تم حذف الفئة",+ "move_failed": "تعذّر نقل الفئة",+ "updated": "تم تحديث الفئة"},- "errors": {- "failed_to_create": "فشل إنشاء السوق",- "failed_to_update": "فشل تحديث السوق",- "failed_to_delete": "فشل حذف السوق"- }- },- "errors": {- "not_found_title": "الصفحة غير موجودة",- "not_found_description": "الصفحة التي تبحث عنها غير موجودة.",- "forbidden_title": "غير مصرح",- "forbidden_description": "ليس لديك إذن لعرض هذه الصفحة.",- "plugin_route_title": "تعذّر عرض هذه الصفحة"+ "navigation": {+ "title": "التنقل"+ },+ "new_title": "فئة جديدة",+ "no_results": "لا توجد فئات مطابقة.",+ "products": {+ "add_cta": "إضافة منتجات",+ "column_product": "المنتج",+ "empty": "لا توجد منتجات في هذه الفئة بعد.",+ "filter_placeholder": "تصفية المنتجات…",+ "no_matches": "لا توجد منتجات تطابق عامل التصفية.",+ "picker_description": "ابحث وحدد المنتجات لإضافتها إلى هذه الفئة.",+ "picker_title": "إضافة منتجات إلى الفئة",+ "remove": "إزالة من الفئة",+ "remove_selected": "إزالة",+ "search_placeholder": "البحث عن المنتجات…",+ "select_all": "تحديد الكل",+ "select_row": "تحديد المنتج",+ "selected_count_one": "تم تحديد {{count}}",+ "selected_count_other": "تم تحديد {{count}}",+ "title": "المنتجات"+ },+ "products_count_one": "منتج واحد",+ "products_count_other": "{{count}} منتجات",+ "search_placeholder": "البحث عن الفئات…",+ "seo": {+ "preview_slug_placeholder": "category-slug",+ "title": "تحسين محركات البحث"+ },+ "title": "الفئات"},- "nav": {- "home": "الرئيسية",- "account": "الحساب",- "orders": "الطلبات",- "draft_orders": "مسودات الطلبات",- "products": "المنتجات",- "price_lists": "قوائم الأسعار",- "categories": "الفئات",- "options": "الخيارات",- "transfers": "التحويلات",- "customers": "العملاء",- "customer_groups": "المجموعات",- "promotions": "العروض الترويجية",- "gift_cards": "بطاقات الهدايا",- "reports": "التقارير",- "settings": "الإعدادات",- "getting_started": "البدء"+ "channels": {+ "messages": {+ "created": "تم إنشاء القناة",+ "deleted": "تم حذف القناة",+ "updated": "تم تحديث القناة"+ }},- "settings_nav": {- "groups": {- "store": "المتجر",- "payments": "المدفوعات والضرائب",- "fulfillment": "التنفيذ",- "team": "الفريق والوصول",- "audit": "التدقيق"+ "components": {+ "adjustment_action_editor": {+ "calculator_label": "آلة حاسبة",+ "loading_calculators": "جارٍ تحميل الآلات الحاسبة…",+ "no_extra_settings": "هذه الآلة الحاسبة لا تحتوي على إعدادات إضافية.",+ "select_calculator": "اختر آلة حاسبة",+ "settings_label": "إعدادات الآلة الحاسبة"},- "items": {- "store": "المتجر",- "emails": "البريد الإلكتروني",- "channels": "قنوات البيع",- "payment_methods": "طرق الدفع",- "tax_categories": "فئات الضريبة",- "markets": "الأسواق",- "stock_locations": "مواقع المخزون",- "custom_field_definitions": "الحقول المخصصة",- "staff": "الموظفون",- "api_keys": "مفاتيح API",- "webhooks": "Webhooks",- "allowed_origins": "المصادر المسموح بها",- "profile": "الملف الشخصي",- "imports": "عمليات الاستيراد"+ "custom_fields": {+ "default_resource": "السجلات",+ "empty_description": "تتبّع تفاصيل منظمة مثل الخامة أو المقاس أو تعليمات العناية.",+ "empty_title": "لا توجد حقول مخصصة بعد",+ "errors": {+ "failed_to_save": "فشل حفظ الحقل المخصص"+ },+ "manage_in_settings": "الإدارة في الإعدادات",+ "new_definition_description": "حدّد حقلاً مخصصاً لتخزين معلومات مكتوبة ومنظمة في {{resource}} الخاصة بك.",+ "new_definition_title": "حقل مخصص جديد",+ "section_title": "الحقول المخصصة",+ "set_up": "إعداد الحقول المخصصة",+ "values_save_partial_failed": "تعذّر حفظ بعض الحقول المخصصة: {{fields}}",+ "values_saved": "تم حفظ الحقول المخصصة"+ },+ "market_combobox": {+ "empty": "لا توجد أسواق تتطابق",+ "search_placeholder": "بحث في الأسواق…"}},- "fields": {- "products_count": {- "label": "المنتجات"+ "custom_field_definitions": {+ "add_cta": "أضف الحقل custom",+ "create_description": "حدد حقلاً مكتوبًا يمكن لفريقك تعبئته في أي سجل مطابق.",+ "create_label": "قم بإنشاء حقل custom",+ "delete_confirm": {+ "message": "ستتم إزالة {{label}} مع كل قيمة مخزنة له.",+ "title": "هل تريد حذف الحقل custom؟"},- "prices_count": {- "label": "الأسعار"+ "edit_description": "قم بتحديث الملصق أو المفتاح أو رؤية واجهة المتجر. لا يمكن للمالك أن يتغير بمجرد وجود القيم.",+ "empty": "لا توجد تعريفات للمجال custom حتى الآن",+ "errors": {+ "failed_to_create": "فشل إنشاء تعريف الحقل المخصص",+ "failed_to_delete": "فشل حذف تعريف الحقل المخصص",+ "failed_to_update": "فشل تحديث تعريف الحقل المخصص"},- "customer_id": {- "label": "العميل"+ "messages": {+ "created": "تم إنشاء تعريف الحقل المخصص",+ "deleted": "تم حذف تعريف الحقل المخصص",+ "updated": "تم تحديث تعريف الحقل المخصص"},- "role_id": {- "label": "الدور"+ "search_placeholder": "البحث حسب التسمية أو مساحة الاسم أو المفتاح…",+ "storefront_visible": {+ "admin_only": "Admin only",+ "visible": "مرئي"},- "role_ids": {- "label": "الأدوار"+ "table_title": "Custom تعريفات المجال"+ },+ "customer_groups": {+ "autocomplete": {+ "empty": "لا توجد مجموعات العميل متطابقة",+ "placeholder": "ابحث عن مجموعات العميل…"},- "tax_category_id": {- "label": "فئة الضريبة"+ "messages": {+ "create_failed": "فشل إنشاء مجموعة العميل",+ "created": "تم إنشاء مجموعة العميل",+ "delete_failed": "فشل حذف مجموعة العميل",+ "deleted": "تم حذف مجموعة العميل",+ "update_failed": "فشل تحديث مجموعة العميل",+ "updated": "تم تحديث مجموعة العميل"+ }+ },+ "customers": {+ "autocomplete": {+ "empty": "لا يوجد عملاء مطابقون",+ "placeholder": "البحث عن العملاء…"},- "promotion": {- "name": {- "placeholder": "Summer Sale"+ "columns": {+ "groups": "المجموعات",+ "last_order": "الطلب الأخير",+ "newsletter": "النشرة الإخبارية",+ "orders": "طلبات",+ "total_spent": "إجمالي ما تم إنفاقه"+ },+ "detail": {+ "address": {+ "default_billing": "الفواتير الافتراضية",+ "default_shipping": "الشحن الافتراضي",+ "delete_confirm_message": "هل تريد حذف هذا العنوان؟",+ "set_default_billing": "تعيين كفواتير افتراضية",+ "set_default_shipping": "تعيين كشحن افتراضي"},- "description": {- "placeholder": "وصف داخلي (اختياري)"+ "customer_since": "العميل منذ ذلك الحين",+ "delete_label": "حذف العميل",+ "edit_profile_description": "قم بتحديث معلومات الملف الشخصي لـ العميل.",+ "groups": {+ "edit_description": "أضف أو أزل المجموعات التي ينتمي إليها هذا العميل.",+ "edit_title": "تعديل مجموعات العملاء",+ "empty": "ليس في أي مجموعة",+ "save_failed": "فشل تحديث مجموعات العملاء",+ "title": "مجموعات العملاء"},- "kind": {- "label": "كيف يُطبَّق هذا العرض؟"+ "last_order_placed": "آخر طلب تم تقديمه",+ "no_internal_notes": "لا توجد ملاحظات داخلية",+ "not_subscribed_to_marketing": "غير مشترك في التسويق",+ "orders_table": {+ "date": "تاريخ",+ "order": "طلب"},- "code": {- "placeholder": "SUMMER2026"+ "store_credit": {+ "add_description": "قم بإصدار رصيد المتجر إلى حساب العميل هذا.",+ "delete_confirm_message": "هل تريد حذف رصيد المتجر هذا؟",+ "edit_description": "اضبط المبلغ أو الفئة أو المذكرة. لا يمكن تعديل الرصيد المستخدم.",+ "empty": "لم يتم إصدار اعتمادات المتجر",+ "table": {+ "category": "فئة",+ "memo": "Memo",+ "remaining": "متبقي",+ "used": "مستخدم"+ },+ "title": "Store credit"},- "multi_codes": {- "label": "إنشاء دفعة من رموز فريدة",- "help": "مفيد لرموز الاستخدام الواحد — كل عميل يسترد رمزًا مختلفًا."+ "subscribed_to_marketing": "اشتركت في التسويق"+ },+ "groups": {+ "bulk_add_action": "إضافة إلى المجموعة…",+ "bulk_add_failed": "فشلت إضافة العملاء إلى المجموعات",+ "bulk_added": "تمت إضافة {{count}} العملاء إلى المجموعات",+ "bulk_remove_action": "إزالة من المجموعة…",+ "bulk_remove_failed": "فشلت إزالة العملاء من المجموعات",+ "bulk_removed": "تمت إزالة {{count}} العملاء من المجموعات",+ "columns": {+ "customers": "العملاء"},- "number_of_codes": {- "label": "عدد الرموز",- "placeholder": "100"+ "count_one": "{{count}} العميل",+ "count_other": "{{count}} العملاء",+ "create_description": "قم بإنشاء مجموعة العميل لتقسيم العملاء إلى عروض ترويجية أو تحليلات أو تسويق.",+ "create_label": "قم بإنشاء مجموعة العميل",+ "default_name": "هذه المجموعة",+ "delete_confirm": {+ "message": "ستتم إزالة {{name}}. Custom لا يتم حذف الأعضاء في هذه المجموعة.",+ "title": "هل تريد حذف مجموعة العميل؟"},- "code_prefix": {- "label": "بادئة الرمز (اختياري)",- "placeholder": "VIP",- "help": "كل رمز مُنشأ سيبدأ بهذه البادئة."+ "edit_description": "قم بتحديث الاسم أو الوصف.",+ "picker": {+ "add_description": "اختر المجموعات التي تريد إضافة هؤلاء العملاء إليها.",+ "add_title": "أضف إلى المجموعات",+ "remove_description": "اختر المجموعات المراد إزالة العملاء منها.",+ "remove_title": "إزالة من المجموعات"},- "starts_at": {- "placeholder": "بدون تاريخ بدء"+ "table": {+ "empty": "لا توجد مجموعات عملاء بعد",+ "search_placeholder": "البحث بالاسم…",+ "title": "مجموعات العملاء"},- "expires_at": {- "placeholder": "بدون انتهاء"+ "view_members": "مشاهدة الأعضاء"+ },+ "new_sheet_description": "العملاء الذين تم إنشاؤهم هنا لم يتم تعيين كلمة مرور لهم. سيحصلون على رابط سحري عند تسجيل الدخول لأول مرة.",+ "row_actions": {+ "delete_confirm": "حذف {{email}}؟ العملاء الذين لديهم طلبات مكتملة لا يمكن إزالتهم."+ },+ "table": {+ "empty": "لا يوجد عملاء بعد",+ "search_placeholder": "البحث عن طريق البريد الإلكتروني أو الاسم…"+ },+ "tags": {+ "bulk_add_action": "إضافة علامات…",+ "bulk_add_failed": "فشلت إضافة العلامات",+ "bulk_added": "تمت إضافة العلامات إلى {n} العملاء",+ "bulk_remove_action": "إزالة العلامات…",+ "bulk_remove_failed": "فشلت إزالة العلامات",+ "bulk_removed": "تمت إزالة العلامات من {n} العملاء",+ "picker": {+ "add_description": "اختر أو أنشئ علامات لإضافتها إلى هؤلاء العملاء.",+ "add_title": "إضافة العلامات",+ "remove_description": "اختر العلامات لإزالتها من هؤلاء العملاء.",+ "remove_title": "إزالة العلامات"+ }+ }+ },+ "delivery_methods": {+ "add_cta": "إضافة طريقة توصيل",+ "add_sheet_title": "طريقة توصيل جديدة",+ "create_description": "حدّد كيفية وصول الطلبات إلى العملاء: شحن أو تسليم رقمي أو استلام.",+ "create_label": "إنشاء طريقة التوصيل",+ "delete_confirm": {+ "message": "حذف \"{{name}}\"؟ ستتوقف الواجهات فورًا عن عرضها.",+ "title": "حذف طريقة التوصيل"+ },+ "edit_description": "تحديث إعدادات طريقة التوصيل هذه.",+ "edit_sheet_title": "تعديل طريقة التوصيل",+ "empty": "لا توجد طرق توصيل بعد.",+ "fulfillment_types": {+ "digital": "رقمي",+ "pickup": "استلام",+ "pickup_point": "نقطة استلام",+ "shipping": "شحن"+ },+ "messages": {+ "created": "تم إنشاء طريقة التوصيل",+ "deleted": "تم حذف طريقة التوصيل",+ "updated": "تم تحديث طريقة التوصيل"+ },+ "no_zones_hint": "لا توجد مناطق توصيل بعد — تنطبق الطريقة في كل مكان.",+ "search_placeholder": "البحث في طرق التوصيل…"+ },+ "delivery_zones": {+ "add_cta": "إضافة منطقة توصيل",+ "add_member": "إضافة عضو",+ "add_sheet_title": "منطقة توصيل جديدة",+ "create_description": "اجمع الدول أو الولايات أو الرموز البريدية في منطقة تخدمها طرق التوصيل.",+ "create_label": "إنشاء منطقة التوصيل",+ "delete_confirm": {+ "message": "حذف \"{{name}}\"؟ لن تطابق طرق التوصيل المستخدمة لها هذه المناطق بعد الآن.",+ "title": "حذف منطقة التوصيل"+ },+ "edit_description": "الأعضاء أدناه يستبدلون قائمة أعضاء المنطقة كاملة عند الحفظ.",+ "edit_sheet_title": "تعديل منطقة التوصيل",+ "empty": "لا توجد مناطق توصيل بعد.",+ "from_placeholder": "من",+ "member_types": {+ "country": "دولة",+ "postal_code": "رمز بريدي",+ "state": "ولاية"+ },+ "members_column": "الأعضاء",+ "members_count": "{{count}} أعضاء",+ "messages": {+ "created": "تم إنشاء منطقة التوصيل",+ "deleted": "تم حذف منطقة التوصيل",+ "updated": "تم تحديث منطقة التوصيل"+ },+ "no_members_hint": "لا يوجد أعضاء بعد — أضف دولًا أو ولايات أو قواعد رموز بريدية.",+ "prefix_placeholder": "بادئة",+ "search_placeholder": "البحث في مناطق التوصيل…",+ "select_country": "اختر الدولة",+ "state_placeholder": "رمز الولاية أو اسمها",+ "to_placeholder": "إلى"+ },+ "errors": {+ "forbidden_description": "ليس لديك إذن لعرض هذه الصفحة.",+ "forbidden_title": "غير مصرح",+ "not_found_description": "الصفحة التي تبحث عنها غير موجودة.",+ "not_found_title": "الصفحة غير موجودة",+ "plugin_route_title": "تعذّر عرض هذه الصفحة"+ },+ "fields": {+ "allowed_origin": {+ "origin": {+ "help": "المخطط + المضيف فقط (+ منفذ اختياري). بدون مسار أو استعلام أو جزء.",+ "label": "Origin",+ "placeholder": "https://admin.example.com"+ }+ },+ "api_key": {+ "channel": {+ "all_channels": "All channels",+ "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",+ "label": "Channel"},- "usage_limit": {- "label": "حد الاستخدام",- "placeholder": "غير محدود"+ "key_type": {+ "label": "النوع"},- "match_policy": {- "label": "سياسة المطابقة"+ "name": {+ "label": "الاسم",+ "placeholder": "Backend integration, Storefront prod, …",+ "required": "الاسم مطلوب"+ },+ "scopes": {+ "label": "Scopes"}},- "custom_field_definition": {- "label": {- "label": "التسمية",- "placeholder": "مثلًا Material"+ "channel": {+ "active": {+ "help": "قنوات البيع غير النشطة تتوقف عن قبول الطلبات ولا تُطابق ترويسة X-Spree-Channel.",+ "label": "نشط"},- "namespace": {- "label": "Namespace",- "placeholder": "custom"+ "code": {+ "help": "معرّف ثابت يستخدمه عملاء API عبر ترويسة X-Spree-Channel ولإسناد الطلبات. اتركه فارغًا للاشتقاق التلقائي من الاسم. حروف صغيرة وأرقام وشرطات وشرطات سفلية.",+ "label": "Code",+ "placeholder": "يُشتق تلقائيًا من الاسم"},- "key": {- "label": "Key",- "placeholder": "مثلًا material",- "invalid_format": "حروف وأرقام وشرطة سفلية فقط"+ "default": {+ "help": "قناة واحدة فقط لكل متجر هي الافتراضية. تُستخدم كبديل عند عدم اختيار قناة وكهدف نشر تلقائي للمنتجات الجديدة.",+ "label": "القناة الافتراضية"+ },+ "guest_checkout": {+ "help": "ما إذا كان بإمكان المتسوّقين إتمام الشراء دون حساب في هذه القناة. اتركه فارغًا للاستناد إلى إعداد المتجر.",+ "inherit": "التوريث من المتجر",+ "label": "الدفع كضيف",+ "options": {+ "false": "غير مسموح",+ "true": "مسموح"+ }},+ "name": {+ "placeholder": "مثلًا POS، Wholesale، Meta Shop"+ },+ "order_routing_strategy": {+ "help": "تتجاوز استراتيجية التوجيه على مستوى المتجر للطلبات المنسوبة لهذه القناة. اتركه فارغًا للوراثة.",+ "inherit": "الوراثة من المتجر",+ "label": "استراتيجية توجيه الطلبات",+ "options": {+ "Spree::OrderRouting::Strategy::Legacy": "Legacy",+ "Spree::OrderRouting::Strategy::Rules": "Rules (ordered)"+ }+ },+ "storefront_access": {+ "help": "يتحكم في ما يراه الزوار غير المسجّلين في هذه القناة. اتركه فارغًا للاستناد إلى إعداد المتجر. عند إخفاء الأسعار، يجب على الضيوف تسجيل الدخول لإتمام الشراء.",+ "inherit": "التوريث من المتجر",+ "label": "الوصول إلى المتجر",+ "options": {+ "login_required": "تسجيل الدخول مطلوب — يجب على الزوار تسجيل الدخول للتصفّح",+ "prices_hidden": "الأسعار مخفية — يجب على الزوار تسجيل الدخول لرؤية الأسعار",+ "public": "عام — يمكن للجميع التصفّح ورؤية الأسعار"+ }+ }+ },+ "custom_field_definition": {"field_type": {"label": "النوع",- "read_only_help": "لا يمكن تغيير النوع بعد وجود قيم — تغييره سيجعل القيم المخزنة تُفسَّر بشكل خاطئ.","options": {- "short_text": "نص قصير",+ "boolean": "Boolean",+ "json": "JSON","long_text": "نص طويل",- "rich_text": "نص غني","number": "رقم",- "boolean": "Boolean",- "json": "JSON"- }+ "rich_text": "نص غني",+ "short_text": "نص قصير"+ },+ "read_only_help": "لا يمكن تغيير النوع بعد وجود قيم — تغييره سيجعل القيم المخزنة تُفسَّر بشكل خاطئ."+ },+ "key": {+ "invalid_format": "حروف وأرقام وشرطة سفلية فقط",+ "label": "Key",+ "placeholder": "مثلًا material"+ },+ "label": {+ "label": "التسمية",+ "placeholder": "مثلًا Material"+ },+ "namespace": {+ "label": "Namespace",+ "placeholder": "custom"},"resource_type": {"label": "ينطبق على",- "read_only_help": "لا يمكن تغيير المالك بعد وجود قيم لهذا الحقل.","options": {- "Spree::Product": "المنتجات",- "Spree::Variant": "المتغيرات",+ "Spree::OptionType": "أنواع الخيارات","Spree::Order": "الطلبات",- "Spree::User": "العملاء",+ "Spree::Product": "المنتجات","Spree::Taxon": "الفئات",- "Spree::OptionType": "أنواع الخيارات"- }- },- "storefront_visible": {- "label": "مرئي في المتجر",- "column_label": "المتجر"+ "Spree::User": "العملاء",+ "Spree::Variant": "المتغيرات"+ },+ "read_only_help": "لا يمكن تغيير المالك بعد وجود قيم لهذا الحقل."},"searchable": {- "label": "قابل للبحث",- "help": "تضمين القيم في بحث منتجات الواجهة (نص قصير ونص طويل ورقم فقط). بعد التفعيل مع Meilisearch، نفّذ rake spree:search:reindex لتحديث المنتجات الحالية."+ "help": "تضمين القيم في بحث منتجات الواجهة (نص قصير ونص طويل ورقم فقط). بعد التفعيل مع Meilisearch، نفّذ rake spree:search:reindex لتحديث المنتجات الحالية.",+ "label": "قابل للبحث"},"sortable": {- "label": "قابل للفرز",- "help": "السماح بفرز قوائم منتجات الواجهة حسب هذا الحقل (نص قصير ورقم فقط). بعد التفعيل مع Meilisearch، نفّذ rake spree:search:reindex لتحديث المنتجات الحالية."+ "help": "السماح بفرز قوائم منتجات الواجهة حسب هذا الحقل (نص قصير ورقم فقط). بعد التفعيل مع Meilisearch، نفّذ rake spree:search:reindex لتحديث المنتجات الحالية.",+ "label": "قابل للفرز"+ },+ "storefront_visible": {+ "column_label": "المتجر",+ "label": "مرئي في المتجر"}},- "tax_category": {- "name": {- "placeholder": "مثلًا Reduced rate"+ "customer": {+ "accepts_email_marketing": {+ "label": "مشترك في التسويق"},- "tax_code": {- "label": "رمز الضريبة",- "placeholder": "رمز مزود الضريبة الخارجي (Avalara، إلخ.)"+ "customer_groups": {+ "label": "مجموعات العملاء"+ },+ "internal_note": {+ "label": "ملاحظة داخلية",+ "placeholder": "سياق داخلي للموظفين عن هذا العميل…"},+ "tags": {+ "label": "Tags"+ }+ },+ "customer_group": {"description": {"placeholder": "وصف داخلي اختياري"},- "is_default": {- "label": "افتراضي",- "help": "تعيين هذا يلغي الافتراضي السابق. المنتجات بدون فئة صريحة ترجع إلى هذه."+ "name": {+ "placeholder": "مثلًا VIP customers"}},- "allowed_origin": {- "origin": {- "label": "Origin",- "placeholder": "https://admin.example.com",- "help": "المخطط + المضيف فقط (+ منفذ اختياري). بدون مسار أو استعلام أو جزء."- }+ "customer_id": {+ "label": "العميل"},- "channel": {- "name": {- "placeholder": "مثلًا POS، Wholesale، Meta Shop"+ "delivery_method": {+ "admin_name": {+ "label": "الاسم الداخلي"+ },+ "calculator": {+ "label": "حاسبة الأسعار"},"code": {- "label": "Code",- "placeholder": "يُشتق تلقائيًا من الاسم",- "help": "معرّف ثابت يستخدمه عملاء API عبر ترويسة X-Spree-Channel ولإسناد الطلبات. اتركه فارغًا للاشتقاق التلقائي من الاسم. حروف صغيرة وأرقام وشرطات وشرطات سفلية."+ "label": "الرمز"},- "active": {- "label": "نشط",- "help": "قنوات البيع غير النشطة تتوقف عن قبول الطلبات ولا تُطابق ترويسة X-Spree-Channel."+ "delivery_zones": {+ "label": "مناطق التوصيل"},- "default": {- "label": "القناة الافتراضية",- "help": "قناة واحدة فقط لكل متجر هي الافتراضية. تُستخدم كبديل عند عدم اختيار قناة وكهدف نشر تلقائي للمنتجات الجديدة."+ "fulfillment_type": {+ "label": "نوع التنفيذ"},- "order_routing_strategy": {- "label": "استراتيجية توجيه الطلبات",- "help": "تتجاوز استراتيجية التوجيه على مستوى المتجر للطلبات المنسوبة لهذه القناة. اتركه فارغًا للوراثة.",- "inherit": "الوراثة من المتجر",- "options": {- "Spree::OrderRouting::Strategy::Rules": "Rules (ordered)",- "Spree::OrderRouting::Strategy::Legacy": "Legacy"- }+ "storefront_visible": {+ "help": "يمكن للعملاء اختيار هذه الطريقة عند الدفع."},- "storefront_access": {- "label": "الوصول إلى المتجر",- "help": "يتحكم في ما يراه الزوار غير المسجّلين في هذه القناة. اتركه فارغًا للاستناد إلى إعداد المتجر. عند إخفاء الأسعار، يجب على الضيوف تسجيل الدخول لإتمام الشراء.",- "inherit": "التوريث من المتجر",- "options": {- "public": "عام — يمكن للجميع التصفّح ورؤية الأسعار",- "prices_hidden": "الأسعار مخفية — يجب على الزوار تسجيل الدخول لرؤية الأسعار",- "login_required": "تسجيل الدخول مطلوب — يجب على الزوار تسجيل الدخول للتصفّح"- }+ "tax_category": {+ "label": "فئة الضريبة"},- "guest_checkout": {- "label": "الدفع كضيف",- "help": "ما إذا كان بإمكان المتسوّقين إتمام الشراء دون حساب في هذه القناة. اتركه فارغًا للاستناد إلى إعداد المتجر.",- "inherit": "التوريث من المتجر",- "options": {- "true": "مسموح",- "false": "غير مسموح"- }+ "tracking_url": {+ "label": "قالب رابط التتبع"+ },+ "transit_days_max": {+ "label": "أيام النقل (الأقصى)"+ },+ "transit_days_min": {+ "label": "أيام النقل (الأدنى)"+ }+ },+ "gift_card": {+ "amount": {+ "label": "المبلغ"+ },+ "code": {+ "help": "اتركه فارغًا للإنشاء التلقائي. للدفعات، يصبح هذا البادئة.",+ "label": "Code"+ },+ "currency": {+ "label": "Currency"+ },+ "customer_id": {+ "label": "العميل"+ },+ "expires_at": {+ "label": "ينتهي",+ "placeholder": "بدون انتهاء"+ },+ "quantity": {+ "help": "1 تصدر بطاقة واحدة. أكثر من 1 تصدر دفعة برموز مُنشأة تلقائيًا.",+ "label": "الكمية"}},"invitation_acceptance": {@@ -322,269 +633,370 @@"label": "تأكيد كلمة المرور"}},- "customer_group": {+ "market": {+ "country_isos": {+ "help": "اختر الدول التي يغطيها هذا السوق. كل دولة يمكن أن تنتمي إلى سوق واحد فقط لكل متجر.",+ "label": "الدول"+ },+ "currency": {+ "help": "عملة ISO 4217 المستخدمة لجميع الأسعار في هذا السوق.",+ "label": "Currency"+ },+ "default": {+ "help": "المتسوقون بدون دولة معروفة يرون هذا السوق. واحد فقط يمكن أن يكون افتراضيًا لكل متجر.",+ "label": "السوق الافتراضي"+ },+ "default_locale": {+ "help": "لغة المتجر للمتسوقين في هذا السوق.",+ "label": "اللغة الافتراضية"+ },"name": {- "placeholder": "مثلًا VIP customers"+ "placeholder": "مثلًا Europe"},- "description": {- "placeholder": "وصف داخلي اختياري"+ "supported_locales": {+ "help": "لغات إضافية يمكن للمتسوقين التبديل إليها. اللغة الافتراضية مُضمَّنة دائمًا.",+ "label": "اللغات المدعومة"+ },+ "tax_inclusive": {+ "help": "عرض الأسعار مع الضريبة. شائع في أسواق الاتحاد الأوروبي.",+ "label": "تسعير شامل الضريبة"}},- "price_list": {+ "match_policy": {+ "label": "سياسة المطابقة"+ },+ "media": {+ "alt": {+ "label": "Alt text",+ "placeholder": "صف الصورة لإمكانية الوصول وSEO"+ }+ },+ "option_type": {+ "filterable": {+ "help": "عرض هذا الخيار كمرشّح في قوائم المنتجات.",+ "label": "قابل للتصفية"+ },+ "kind": {+ "help": "يتحكم في كيفية عرض الخيار في المتجر. Color swatch يعرض لون hex؛ buttons تعرض صورة مصغرة.",+ "label": "النوع"+ },+ "label": {+ "help": "يُعرض للعملاء في المتجر.",+ "label": "التسمية",+ "placeholder": "مثلًا Shirt size"+ },"name": {- "label": "الاسم",- "placeholder": "مثلًا EU wholesale",- "help": "تسمية داخلية — لا تُعرض للعملاء أبدًا."+ "help": "معرّف بأحرف صغيرة. يجب أن يكون فريدًا في المتجر.",+ "label": "الاسم الداخلي",+ "placeholder": "مثلًا shirt-size"+ }+ },+ "option_value": {+ "color_code": {+ "label": "اللون"+ },+ "image": {+ "label": "الصورة"+ },+ "label": {+ "label": "التسمية",+ "placeholder": "مثلًا Small"+ },+ "name": {+ "label": "الاسم الداخلي",+ "placeholder": "مثلًا small"+ }+ },+ "order": {+ "channel": {+ "help": "إسناد الطلب إلى قناة بيع محددة. الافتراضي هو القناة الإلكترونية للمتجر.",+ "label": "قناة البيع",+ "placeholder": "استخدام افتراضي المتجر"+ },+ "coupon_code": {+ "label": "رمز القسيمة",+ "placeholder": "اختياري"+ },+ "customer_note": {+ "label": "ملاحظة العميل (مرئية للعميل)"+ },+ "email": {+ "label": "أو استخدم بريد ضيف",+ "placeholder": "[email protected]"+ },+ "internal_note": {+ "label": "ملاحظة داخلية (للموظفين فقط)"+ }+ },+ "payment_method": {+ "active": {+ "help": "الطرق غير النشطة مخفية عند الدفع.",+ "label": "نشط"+ },+ "auto_capture": {+ "help": "Capture الأموال تلقائيًا عند التفويض. عند الإيقاف، يجب Capture يدويًا.",+ "label": "Auto-capture"+ },+ "description": {+ "placeholder": "وصف يظهر للعميل عند الدفع"+ },+ "name": {+ "placeholder": "مثلًا Credit card (Stripe)"},+ "provider_configuration": "إعدادات المزود",+ "storefront_visible": {+ "label": "مرئي في المتجر"+ },+ "type": {+ "label": "Provider",+ "placeholder": "اختر مزودًا"+ }+ },+ "price_list": {"description": {"label": "الوصف","placeholder": "وصف داخلي اختياري"},- "starts_at": {- "label": "يبدأ",- "placeholder": "فورًا",- "help": "متى تصبح هذه القائمة نشطة. اتركه فارغًا للبدء فور التفعيل."- },"ends_at": {+ "help": "اتركه فارغًا لعدم تحديد تاريخ انتهاء.","label": "ينتهي",- "placeholder": "أبدًا",- "help": "اتركه فارغًا لعدم تحديد تاريخ انتهاء."+ "placeholder": "أبدًا"},"match_policy": {- "label": "سياسة المطابقة","all": "يجب أن تطابق جميع القواعد",- "any": "قد تطابق أي قاعدة"+ "any": "قد تطابق أي قاعدة",+ "label": "سياسة المطابقة"+ },+ "name": {+ "help": "تسمية داخلية — لا تُعرض للعملاء أبدًا.",+ "label": "الاسم",+ "placeholder": "مثلًا EU wholesale"+ },+ "starts_at": {+ "help": "متى تصبح هذه القائمة نشطة. اتركه فارغًا للبدء فور التفعيل.",+ "label": "يبدأ",+ "placeholder": "فورًا"},"status": {"active": "نشط",- "scheduled": "مجدول",+ "draft": "مسودة","inactive": "غير نشط",- "draft": "مسودة"+ "scheduled": "مجدول"}},"price_rule": {- "customers": {- "label": "العملاء",- "help": "اتركه فارغًا لتطبيق هذه القاعدة على كل عميل مسجّل الدخول."+ "channels": {+ "help": "اتركه فارغًا لتطبيق هذه القاعدة على كل قناة بيع.",+ "label": "قنوات البيع"},"customer_groups": {- "label": "مجموعات العملاء",- "help": "اتركه فارغًا لتطبيق هذه القاعدة على كل عميل بغض النظر عن المجموعة."+ "help": "اتركه فارغًا لتطبيق هذه القاعدة على كل عميل بغض النظر عن المجموعة.",+ "label": "مجموعات العملاء"+ },+ "customers": {+ "help": "اتركه فارغًا لتطبيق هذه القاعدة على كل عميل مسجّل الدخول.",+ "label": "العملاء"},"markets": {- "label": "الأسواق",- "help": "اتركه فارغًا لتطبيق هذه القاعدة في كل سوق."+ "help": "اتركه فارغًا لتطبيق هذه القاعدة في كل سوق.",+ "label": "الأسواق"},- "channels": {- "label": "قنوات البيع",- "help": "اتركه فارغًا لتطبيق هذه القاعدة على كل قناة بيع."+ "max_quantity": {+ "help": "اتركه فارغًا لعدم وجود حد أقصى."},"min_quantity": {"help": "يُطبَّق هذا السعر فقط عندما يطلب العميل هذا العدد على الأقل من صنف واحد."- },- "max_quantity": {- "help": "اتركه فارغًا لعدم وجود حد أقصى."}},- "stock_location": {- "name": {- "placeholder": "Brooklyn warehouse"+ "prices_count": {+ "label": "الأسعار"+ },+ "product": {+ "available_on": {+ "label": "متاح في"},- "admin_name": {- "label": "الاسم الداخلي",- "placeholder": "اختياري — يُعرض في لوحة الإدارة فقط"+ "category_ids": {+ "label": "الفئات"},- "kind": {- "label": "النوع"+ "channels": {+ "label": "قنوات البيع"},- "active": {- "label": "نشط",- "help": "المواقع غير النشطة لا تظهر في اختيار التنفيذ."+ "description": {+ "label": "الوصف",+ "placeholder": "اكتب وصف المنتج…"},- "default": {- "label": "الموقع الافتراضي",- "help": "عناصر المخزون الجديدة تُنشأ هنا. موقع واحد فقط يمكن أن يكون افتراضيًا."+ "discontinue_on": {+ "label": "إيقاف في"},- "backorderable_default": {- "label": "قابل للطلب المسبق افتراضيًا",- "help": "عناصر المخزون الجديدة تسمح بالطلب المسبق عند نفاد المخزون."+ "make_active_at": {+ "label": "تفعيل في"},- "propagate_all_variants": {- "label": "إنشاء عناصر مخزون تلقائيًا لجميع المتغيرات",- "help": "إنشاء عناصر مخزون في هذا الموقع لكل متغير منتج."+ "name": {+ "label": "الاسم",+ "placeholder": "اسم المنتج"},- "pickup_enabled": {- "label": "السماح بالاستلام من العميل",- "help": "يمكن للعملاء استلام الطلبات من هذا الموقع عند الدفع."+ "tags": {+ "label": "Tags"+ }+ },+ "product_publication": {+ "published_at": {+ "help": "اتركه فارغًا للنشر فورًا.",+ "label": "النشر من",+ "placeholder": "مباشرة"},- "pickup_stock_policy": {- "label": "سياسة المخزون"+ "unpublished_at": {+ "help": "اتركه فارغًا للإبقاء في القائمة بلا نهاية.",+ "label": "إلغاء النشر في",+ "placeholder": "أبدًا"+ }+ },+ "products_count": {+ "label": "المنتجات"+ },+ "profile": {+ "avatar": {+ "help": "تظهر بجوار اسمك في جميع أنحاء لوحة الإدارة. الصور المربعة تبدو أفضل.",+ "label": "الصورة"},- "pickup_ready_in_minutes": {- "label": "جاهز خلال (دقائق)",- "placeholder": "60"+ "email": {+ "label": "البريد الإلكتروني"},- "pickup_instructions": {- "label": "تعليمات الاستلام",- "placeholder": "أين يذهب العميل لاستلام طلبه."+ "first_name": {+ "label": "الاسم الأول"+ },+ "last_name": {+ "label": "اسم العائلة"+ },+ "selected_locale": {+ "help": "اللغة المستخدمة في لوحة الإدارة. تؤثر فقط على ما تراه.",+ "label": "اللغة"}},- "payment_method": {- "type": {- "label": "Provider",- "placeholder": "اختر مزودًا"+ "promotion": {+ "code": {+ "placeholder": "SUMMER2026"},- "name": {- "placeholder": "مثلًا Credit card (Stripe)"+ "code_prefix": {+ "help": "كل رمز مُنشأ سيبدأ بهذه البادئة.",+ "label": "بادئة الرمز (اختياري)",+ "placeholder": "VIP"},"description": {- "placeholder": "وصف يظهر للعميل عند الدفع"+ "placeholder": "وصف داخلي (اختياري)"},- "storefront_visible": {- "label": "مرئي في المتجر"+ "expires_at": {+ "placeholder": "بدون انتهاء"},- "active": {- "label": "نشط",- "help": "الطرق غير النشطة مخفية عند الدفع."+ "kind": {+ "label": "كيف يُطبَّق هذا العرض؟"},- "auto_capture": {- "label": "Auto-capture",- "help": "Capture الأموال تلقائيًا عند التفويض. عند الإيقاف، يجب Capture يدويًا."+ "match_policy": {+ "label": "سياسة المطابقة"+ },+ "multi_codes": {+ "help": "مفيد لرموز الاستخدام الواحد — كل عميل يسترد رمزًا مختلفًا.",+ "label": "إنشاء دفعة من رموز فريدة"},- "provider_configuration": "إعدادات المزود"- },- "market": {"name": {- "placeholder": "مثلًا Europe"+ "placeholder": "Summer Sale"},- "currency": {- "label": "Currency",- "help": "عملة ISO 4217 المستخدمة لجميع الأسعار في هذا السوق."+ "number_of_codes": {+ "label": "عدد الرموز",+ "placeholder": "100"},- "default_locale": {- "label": "اللغة الافتراضية",- "help": "لغة المتجر للمتسوقين في هذا السوق."+ "starts_at": {+ "placeholder": "بدون تاريخ بدء"},- "supported_locales": {- "label": "اللغات المدعومة",- "help": "لغات إضافية يمكن للمتسوقين التبديل إليها. اللغة الافتراضية مُضمَّنة دائمًا."- },- "country_isos": {- "label": "الدول",- "help": "اختر الدول التي يغطيها هذا السوق. كل دولة يمكن أن تنتمي إلى سوق واحد فقط لكل متجر."- },- "tax_inclusive": {- "label": "تسعير شامل الضريبة",- "help": "عرض الأسعار مع الضريبة. شائع في أسواق الاتحاد الأوروبي."- },- "default": {- "label": "السوق الافتراضي",- "help": "المتسوقون بدون دولة معروفة يرون هذا السوق. واحد فقط يمكن أن يكون افتراضيًا لكل متجر."+ "usage_limit": {+ "label": "حد الاستخدام",+ "placeholder": "غير محدود"}},- "option_type": {- "name": {- "label": "الاسم الداخلي",- "placeholder": "مثلًا shirt-size",- "help": "معرّف بأحرف صغيرة. يجب أن يكون فريدًا في المتجر."- },- "label": {- "label": "التسمية",- "placeholder": "مثلًا Shirt size",- "help": "يُعرض للعملاء في المتجر."- },- "kind": {- "label": "النوع",- "help": "يتحكم في كيفية عرض الخيار في المتجر. Color swatch يعرض لون hex؛ buttons تعرض صورة مصغرة."- },- "filterable": {- "label": "قابل للتصفية",- "help": "عرض هذا الخيار كمرشّح في قوائم المنتجات."- }+ "role_id": {+ "label": "الدور"},- "option_value": {- "name": {- "label": "الاسم الداخلي",- "placeholder": "مثلًا small"- },- "label": {- "label": "التسمية",- "placeholder": "مثلًا Small"- },- "color_code": {- "label": "اللون"- },- "image": {- "label": "الصورة"- }+ "role_ids": {+ "label": "الأدوار"},- "variant": {- "sku": {- "label": "SKU",- "placeholder": "PRODUCT-RED-S"+ "stock_location": {+ "active": {+ "help": "المواقع غير النشطة لا تظهر في اختيار التنفيذ.",+ "label": "نشط"},- "barcode": {- "label": "Barcode"+ "admin_name": {+ "label": "الاسم الداخلي",+ "placeholder": "اختياري — يُعرض في لوحة الإدارة فقط"},- "weight": {- "label": "الوزن"+ "backorderable_default": {+ "help": "عناصر المخزون الجديدة تسمح بالطلب المسبق عند نفاد المخزون.",+ "label": "قابل للطلب المسبق افتراضيًا"},- "weight_unit": {- "label": "الوحدة"+ "default": {+ "help": "عناصر المخزون الجديدة تُنشأ هنا. موقع واحد فقط يمكن أن يكون افتراضيًا.",+ "label": "الموقع الافتراضي"},- "height": {- "label": "الارتفاع"+ "kind": {+ "label": "النوع"},- "width": {- "label": "العرض"+ "name": {+ "placeholder": "Brooklyn warehouse"},- "depth": {- "label": "العمق"+ "pickup_enabled": {+ "help": "يمكن للعملاء استلام الطلبات من هذا الموقع عند الدفع.",+ "label": "السماح بالاستلام من العميل"},- "dimensions_unit": {- "label": "الوحدة"+ "pickup_instructions": {+ "label": "تعليمات الاستلام",+ "placeholder": "أين يذهب العميل لاستلام طلبه."},- "preorderable": {- "label": "متاح للطلب المسبق",- "help": "بِع هذا الخيار قبل توفره في المخزون. حدِّد العدد عبر حد الطلبات المتأخرة، أو أدخل المخزون الوارد ككمية، أو اتركه فارغًا لعدد غير محدود."+ "pickup_ready_in_minutes": {+ "label": "جاهز خلال (دقائق)",+ "placeholder": "60"},- "preorder_ships_at": {- "label": "الشحن بحلول",- "placeholder": "اختر تاريخًا",- "help": "موعد شحنك المتوقع للطلبات المسبقة. يظهر للعملاء كوعد بالتسليم؛ وينتهي الطلب المسبق بمجرد مرور هذا التاريخ."+ "pickup_stock_policy": {+ "label": "سياسة المخزون"},- "backorder_limit": {- "label": "حد الطلبات المتأخرة",- "placeholder": "غير محدود",- "help": "الحد الأقصى لعدد الوحدات المباعة بما يتجاوز المخزون المتاح — يحدّ الطلبات المتأخرة والطلبات المسبقة. اتركه فارغًا لعدد غير محدود."+ "propagate_all_variants": {+ "help": "إنشاء عناصر مخزون في هذا الموقع لكل متغير منتج.",+ "label": "إنشاء عناصر مخزون تلقائيًا لجميع المتغيرات"}},- "api_key": {- "name": {- "label": "الاسم",- "placeholder": "Backend integration, Storefront prod, …",- "required": "الاسم مطلوب"+ "store": {+ "customer_support_email": {+ "help": "عنوان الرد الظاهر للعملاء في رسائل المتجر.",+ "label": "بريد دعم العملاء",+ "placeholder": "[email protected]"},- "key_type": {- "label": "النوع"+ "guest_checkout": {+ "help": "الإعداد الافتراضي على مستوى المتجر لما إذا كان بإمكان المتسوّقين إتمام الشراء دون حساب. يمكن للقنوات تجاوزه.",+ "label": "الدفع كضيف"},- "scopes": {- "label": "Scopes"+ "mail_from_address": {+ "help": "يُستخدم كعنوان From في كل رسالة معاملات.",+ "label": "عنوان المرسل",+ "placeholder": "[email protected]"+ },+ "mailer_logo": {+ "help": "PNG أو JPG بخلفية شفافة. يُضمَّن في ترويسات رسائل المعاملات.",+ "label": "شعار البريد"},- "channel": {- "label": "Channel",- "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",- "all_channels": "All channels"- }- },- "store": {"name": {"label": "اسم المتجر"},+ "new_order_notifications_email": {+ "help": "مستلم إشعارات «تم تقديم طلب جديد». اتركه فارغًا للتعطيل.",+ "label": "إشعارات الطلبات الجديدة",+ "placeholder": "[email protected]"+ },"preferred_admin_locale": {"label": "لغة لوحة الإدارة","placeholder": "استخدام اللغة الافتراضية"},+ "preferred_send_consumer_transactional_emails": {+ "help": "عند الإيقاف، لا تُرسل رسائل تأكيد الطلب أو الشحن أو الاسترداد.",+ "label": "إرسال رسائل المعاملات للعملاء"+ },"preferred_timezone": {"label": "Timezone","placeholder": "اختر منطقة زمنية"@@ -596,955 +1008,1115 @@"label": "وحدة الوزن"},"storefront_access": {- "label": "الوصول إلى المتجر","help": "الإعداد الافتراضي على مستوى المتجر لما يراه الزوار غير المسجّلين. يمكن للقنوات تجاوزه. عند إخفاء الأسعار، يجب على الضيوف تسجيل الدخول لإتمام الشراء.",+ "label": "الوصول إلى المتجر","options": {- "public": "عام — يمكن للجميع التصفّح ورؤية الأسعار",+ "login_required": "تسجيل الدخول مطلوب — يجب على الزوار تسجيل الدخول للتصفّح","prices_hidden": "الأسعار مخفية — يجب على الزوار تسجيل الدخول لرؤية الأسعار",- "login_required": "تسجيل الدخول مطلوب — يجب على الزوار تسجيل الدخول للتصفّح"+ "public": "عام — يمكن للجميع التصفّح ورؤية الأسعار"}- },- "guest_checkout": {- "label": "الدفع كضيف",- "help": "الإعداد الافتراضي على مستوى المتجر لما إذا كان بإمكان المتسوّقين إتمام الشراء دون حساب. يمكن للقنوات تجاوزه."- },- "mail_from_address": {- "label": "عنوان المرسل",- "placeholder": "[email protected]",- "help": "يُستخدم كعنوان From في كل رسالة معاملات."- },- "customer_support_email": {- "label": "بريد دعم العملاء",- "placeholder": "[email protected]",- "help": "عنوان الرد الظاهر للعملاء في رسائل المتجر."- },- "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": "مثلًا Order pipeline",- "help": "تسمية اختيارية تظهر في هذه القائمة."+ "store_credit": {+ "amount": {+ "label": "المبلغ"},- "url": {- "label": "Destination URL",- "placeholder": "https://example.com/webhooks"+ "category_id": {+ "label": "الفئة"},- "active": {- "label": "نشط",- "help": "النقاط غير النشطة لا تستقبل التسليمات."+ "currency": {+ "label": "Currency"},- "subscriptions": {- "label": "Events",- "help": "اختر الأحداث التي تُطلق Webhook. لا تختر شيئًا لاستقبال كل حدث."+ "memo": {+ "label": "Memo",+ "placeholder": "سبب إصدار هذا الرصيد"}},- "product": {- "name": {- "label": "الاسم",- "placeholder": "اسم المنتج"- },+ "storefront_visible": {+ "label": "ظاهر في المتجر"+ },+ "tax_category": {"description": {- "label": "الوصف",- "placeholder": "اكتب وصف المنتج…"- },- "make_active_at": {- "label": "تفعيل في"- },- "available_on": {- "label": "متاح في"- },- "discontinue_on": {- "label": "إيقاف في"+ "placeholder": "وصف داخلي اختياري"},- "category_ids": {- "label": "الفئات"+ "is_default": {+ "help": "تعيين هذا يلغي الافتراضي السابق. المنتجات بدون فئة صريحة ترجع إلى هذه.",+ "label": "افتراضي"},- "channels": {- "label": "قنوات البيع"+ "name": {+ "placeholder": "مثلًا Reduced rate"},- "tags": {- "label": "Tags"+ "tax_code": {+ "label": "رمز الضريبة",+ "placeholder": "رمز مزود الضريبة الخارجي (Avalara، إلخ.)"}},- "product_publication": {- "published_at": {- "label": "النشر من",- "placeholder": "مباشرة",- "help": "اتركه فارغًا للنشر فورًا."- },- "unpublished_at": {- "label": "إلغاء النشر في",- "placeholder": "أبدًا",- "help": "اتركه فارغًا للإبقاء في القائمة بلا نهاية."- }+ "tax_category_id": {+ "label": "فئة الضريبة"},- "gift_card": {- "code": {- "label": "Code",- "help": "اتركه فارغًا للإنشاء التلقائي. للدفعات، يصبح هذا البادئة."- },- "amount": {- "label": "المبلغ"+ "variant": {+ "backorder_limit": {+ "help": "الحد الأقصى لعدد الوحدات المباعة بما يتجاوز المخزون المتاح — يحدّ الطلبات المتأخرة والطلبات المسبقة. اتركه فارغًا لعدد غير محدود.",+ "label": "حد الطلبات المتأخرة",+ "placeholder": "غير محدود"},- "currency": {- "label": "Currency"+ "barcode": {+ "label": "Barcode"},- "expires_at": {- "label": "ينتهي",- "placeholder": "بدون انتهاء"+ "depth": {+ "label": "العمق"},- "customer_id": {- "label": "العميل"+ "dimensions_unit": {+ "label": "الوحدة"},- "quantity": {- "label": "الكمية",- "help": "1 تصدر بطاقة واحدة. أكثر من 1 تصدر دفعة برموز مُنشأة تلقائيًا."- }- },- "customer": {- "tags": {- "label": "Tags"+ "height": {+ "label": "الارتفاع"},- "customer_groups": {- "label": "مجموعات العملاء"+ "preorder_ships_at": {+ "help": "موعد شحنك المتوقع للطلبات المسبقة. يظهر للعملاء كوعد بالتسليم؛ وينتهي الطلب المسبق بمجرد مرور هذا التاريخ.",+ "label": "الشحن بحلول",+ "placeholder": "اختر تاريخًا"},- "accepts_email_marketing": {- "label": "مشترك في التسويق"+ "preorderable": {+ "help": "بِع هذا الخيار قبل توفره في المخزون. حدِّد العدد عبر حد الطلبات المتأخرة، أو أدخل المخزون الوارد ككمية، أو اتركه فارغًا لعدد غير محدود.",+ "label": "متاح للطلب المسبق"},- "internal_note": {- "label": "ملاحظة داخلية",- "placeholder": "سياق داخلي للموظفين عن هذا العميل…"- }- },- "store_credit": {- "amount": {- "label": "المبلغ"+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUCT-RED-S"},- "currency": {- "label": "Currency"+ "weight": {+ "label": "الوزن"},- "category_id": {- "label": "الفئة"+ "weight_unit": {+ "label": "الوحدة"},- "memo": {- "label": "Memo",- "placeholder": "سبب إصدار هذا الرصيد"+ "width": {+ "label": "العرض"}},- "order": {- "email": {- "label": "أو استخدم بريد ضيف",- "placeholder": "[email protected]"+ "webhook_endpoint": {+ "active": {+ "help": "النقاط غير النشطة لا تستقبل التسليمات.",+ "label": "نشط"},- "customer_note": {- "label": "ملاحظة العميل (مرئية للعميل)"- },- "internal_note": {- "label": "ملاحظة داخلية (للموظفين فقط)"- },- "coupon_code": {- "label": "رمز القسيمة",- "placeholder": "اختياري"- },- "channel": {- "label": "قناة البيع",- "placeholder": "استخدام افتراضي المتجر",- "help": "إسناد الطلب إلى قناة بيع محددة. الافتراضي هو القناة الإلكترونية للمتجر."- }- },- "media": {- "alt": {- "label": "Alt text",- "placeholder": "صف الصورة لإمكانية الوصول وSEO"- }- },- "profile": {- "email": {- "label": "البريد الإلكتروني"- },- "first_name": {- "label": "الاسم الأول"- },- "last_name": {- "label": "اسم العائلة"+ "name": {+ "help": "تسمية اختيارية تظهر في هذه القائمة.",+ "label": "الاسم",+ "placeholder": "مثلًا Order pipeline"},- "avatar": {- "label": "الصورة",- "help": "تظهر بجوار اسمك في جميع أنحاء لوحة الإدارة. الصور المربعة تبدو أفضل."+ "subscriptions": {+ "help": "اختر الأحداث التي تُطلق Webhook. لا تختر شيئًا لاستقبال كل حدث.",+ "label": "Events"},- "selected_locale": {- "label": "اللغة",- "help": "اللغة المستخدمة في لوحة الإدارة. تؤثر فقط على ما تراه."+ "url": {+ "label": "Destination URL",+ "placeholder": "https://example.com/webhooks"}- },- "match_policy": {- "label": "سياسة المطابقة"}},- "promotions": {- "rule_types_empty": "لم يتم تسجيل أي أنواع قواعد.",- "rule_types_all_used": "كل نوع قاعدة متاح موجود بالفعل في هذا العرض الترويجي.",- "table": {- "search_placeholder": "البحث بالاسم…",- "empty": "لا يوجد ترقيات حتى الآن",- "no_end": "لا نهاية"- },- "code": {- "automatic": "تلقائي",- "multi": "multi"+ "gift_cards": {+ "batch_autocomplete": {+ "empty": "لا توجد دفعات مطابقة",+ "placeholder": "البحث في الدفعات بالبادئة…"},- "generate_code": {- "title": "إنشاء رمز عشوائي"+ "columns": {+ "batch": "دفعة",+ "customer": "العميل",+ "issued_by": "صادرة من",+ "remaining": "المتبقي",+ "used": "مُستخدم"},- "kinds": {- "coupon_code": "رمز القسيمة",- "automatic": "تلقائي (بدون رمز)"+ "messages": {+ "batch_create_failed": "فشل إنشاء دفعة بطاقات الهدايا",+ "batch_created": "تم إنشاء دفعة بطاقات الهدايا",+ "create_failed": "فشل إنشاء بطاقة الهدايا",+ "created": "تم إنشاء بطاقة الهدايا",+ "delete_failed": "فشل حذف بطاقة الهدايا",+ "deleted": "تم حذف بطاقة الهدايا",+ "update_failed": "فشل تحديث بطاقة الهدايا",+ "updated": "تم تحديث بطاقة الهدايا"},- "match_policies": {- "all": "يجب أن تتطابق جميع القواعد",- "any": "قد تتطابق أي قاعدة",- "all_hint": "يجب أن تتطابق جميع القواعد.",- "any_hint": "قد تتطابق أي قاعدة."+ "statuses": {+ "canceled": "ملغاة",+ "expired": "منتهية الصلاحية",+ "partially_redeemed": "مُستَخدمة جزئيًا",+ "redeemed": "مُستَخدمة"},- "rules_card": {- "title": "قواعد",- "description": "الشروط التي تحدد ما إذا كان سيتم تطبيق العرض الترويجي أم لا.",- "empty": "لا توجد قواعد. بدون قواعد، يكون العرض الترويجي مؤهلًا دائمًا (يخضع للجدول الزمني وحد الاستخدام).",- "add_rule": "أضف القاعدة"+ "table": {+ "empty": "لا توجد بطاقات هدايا بعد",+ "search_placeholder": "البحث بالرمز…"+ }+ },+ "imports": {+ "download_original": "تنزيل الملف الأصلي",+ "failed": {+ "description": "تعذّرت معالجة الملف.",+ "title": "فشل الاستيراد"},- "validation": {- "code_required": "الرمز مطلوب (أو انقر «إنشاء»)",- "prefix_required": "البادئة مطلوبة لدفعات الرموز المتعددة",- "number_of_codes_required": "اختر عدد الرموز المراد إنشاؤها",- "expiry_after_start": "يجب أن يكون انتهاء الصلاحية بعد تاريخ البدء"+ "failed_rows": {+ "error": "الخطأ",+ "hide_data": "إخفاء بيانات الصف",+ "next_page": "الصفحة التالية",+ "prev_page": "الصفحة السابقة",+ "row_number": "الصف",+ "title": "الصفوف الفاشلة",+ "view_data": "عرض بيانات الصف"},- "delete_confirm": {- "title": "هل تريد حذف العرض الترويجي؟",- "message": "ستتم إزالة {{name}} نهائيًا. لا يمكن حذف العروض الترويجية المشار إليها بواسطة الطلبات المكتملة.",- "default_name": "هذا الترويج"+ "load_failed": "تعذّر تحميل الاستيراد.",+ "mapping": {+ "description": "طابق أعمدة ملفك مع حقول {{type}}.",+ "field": "الحقل",+ "file_column": "عمود الملف",+ "missing_required": "طابق الحقول المطلوبة للمتابعة: {{fields}}",+ "not_mapped": "غير مطابق",+ "required": "مطلوب",+ "sample": "مثال",+ "start": "بدء الاستيراد",+ "starting": "جارٍ البدء…",+ "title": "مطابقة الأعمدة"},- "rules": {- "country": {- "label": "بلدان",- "search_placeholder": "بحث عن الدول…",- "empty": "لا توجد بلدان متطابقة"- },- "channel": {- "label": "القنوات"- },- "market": {- "label": "الأسواق"- },- "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": "لا يوجد عملاء مطابقون"- }+ "processing": {+ "failed_count": "{{failed}} فشلت",+ "note": "يمكنك مغادرة هذه الصفحة — سيستمر الاستيراد في الخلفية.",+ "preparing": "جارٍ تجهيز الصفوف…",+ "progress": "تمت معالجة {{processed}} من {{total}} صفًا",+ "retrying": "إعادة محاولة الصفوف الفاشلة · {{remaining}} متبقية",+ "title": "جارٍ معالجة الصفوف"},- "basics_card": {- "title": "الأساسيات"+ "results": {+ "completed_title": "اكتمل الاستيراد",+ "retry_failed": "إعادة محاولة الصفوف الفاشلة ({{failed}})",+ "retrying": "جارٍ إعادة المحاولة…",+ "summary": "تم استيراد {{completed}} صفًا · {{failed}} فشلت",+ "view_records": "عرض {{type}}"},- "trigger_card": {- "title": "مشغل"+ "status": {+ "completed": "مكتمل",+ "completed_mapping": "في قائمة الانتظار",+ "failed": "فشل",+ "mapping": "المطابقة",+ "pending": "قيد الانتظار",+ "processing": "قيد المعالجة"},- "schedule_card": {- "title": "الجدول الزمني والحدود"+ "steps": {+ "complete": "اكتمل",+ "map_fields": "مطابقة الحقول",+ "process_rows": "معالجة الصفوف"},- "trigger_summary": {- "multi_code": "قسيمة متعددة الرموز (أكواد {{count}})",- "multi_code_with_prefix": "قسيمة متعددة الرموز (أكواد {{count}} مع البادئة \"{{prefix}}\")",- "show_codes": "إظهار الرموز",- "single_code": "رمز قسيمة واحد:",- "locked_help": "لا يمكن تغيير إعدادات المشغل بعد الإنشاء. قم بإجراء ترقية جديدة لتغييرها."+ "try_again": "حاول مرة أخرى",+ "types": {+ "customers": "العملاء",+ "product_translations": "ترجمات المنتجات",+ "products": "المنتجات"},- "remove_rule_confirm": {- "title": "هل تريد إزالة القاعدة؟",- "message": "تمت إزالته عند حفظ العرض الترويجي."+ "wizard_title": "الاستيراد"+ },+ "invitation": {+ "accepting": "قبول…",+ "could_not_accept": "لا يمكن قبول الدعوة",+ "create_and_accept": "Create account & accept",+ "create_to_accept": ". أنشئ حسابك للقبول.",+ "generic_error_message": "حدث خطأ ما. يرجى المحاولة مرة أخرى.",+ "generic_error_title": "تعذر تحميل الدعوة",+ "invited_as_role": "مثل {{role}}",+ "invited_by": "{{email}} دعوتك",+ "invited_generic": "لقد تمت دعوتك",+ "join_store": "انضم إلى {{store}}",+ "loading": "جارٍ تحميل الدعوة…",+ "missing_token_message": "هذا الرابط يبدو غير مكتمل. اطلب من الشخص الذي دعاك أن يرسلها مرة أخرى.",+ "missing_token_title": "رمز الدعوة مفقود",+ "not_found_message": "انتهت صلاحية هذه الدعوة، أو تم إلغاؤها، أو تم قبولها بالفعل. اطلب من الداعي إرسال واحدة جديدة.",+ "not_found_title": "لم يتم العثور على الدعوة",+ "sign_in_and_accept": "Sign in & accept",+ "sign_in_to_accept": ". قم بتسجيل الدخول للقبول."+ },+ "markets": {+ "add_cta": "إضافة سوق",+ "columns": {+ "default": "افتراضي"},- "rule_summary": {- "product_count": "{{count}} منتجات",- "category_count": "{{count}} فئات",- "customer_count": "{{count}} عملاء"+ "create_description": "اجمع الدول في منطقة تسعير واحدة بعملتها ولغاتها الخاصة.",+ "create_label": "إنشاء سوق",+ "delete_confirm": {+ "message": "سيتم إزالة {{name}}. الطلبات السابقة في هذا السوق تبقى كما هي.",+ "title": "حذف السوق؟"},- "rule_picker": {- "title": "أضف القاعدة",- "description": "اختر نوع القاعدة لتكوينه."+ "edit_description": "حدّث الاسم أو العملة أو اللغات أو تغطية الدول.",+ "empty": "لا توجد أسواق بعد",+ "errors": {+ "failed_to_create": "فشل إنشاء السوق",+ "failed_to_delete": "فشل حذف السوق",+ "failed_to_update": "فشل تحديث السوق"},- "rule_edit": {- "description": "ضبط معلمات القاعدة.",- "no_options": "لا تحتوي هذه القاعدة على خيارات قابلة للتكوين، فوجودها وحده يطبق القيد."+ "messages": {+ "created": "تم إنشاء السوق",+ "deleted": "تم حذف السوق",+ "updated": "تم تحديث السوق"},- "actions_card": {- "description": "ماذا يحدث عندما يصبح العرض الترويجي مؤهلاً؟",- "empty": "لا توجد إجراءات حتى الآن. الترويج بدون إجراءات لا يفعل أي شيء عند تطبيقه.",- "add_action": "أضف الإجراء"+ "search_placeholder": "البحث بالاسم…",+ "tax_exclusive": "غير شامل",+ "tax_inclusive": "شامل"+ },+ "nav": {+ "account": "الحساب",+ "categories": "الفئات",+ "customer_groups": "المجموعات",+ "customers": "العملاء",+ "draft_orders": "مسودات الطلبات",+ "getting_started": "البدء",+ "gift_cards": "بطاقات الهدايا",+ "home": "الرئيسية",+ "options": "الخيارات",+ "orders": "الطلبات",+ "price_lists": "قوائم الأسعار",+ "products": "المنتجات",+ "promotions": "العروض الترويجية",+ "reports": "التقارير",+ "settings": "الإعدادات",+ "transfers": "التحويلات"+ },+ "option_types": {+ "columns": {+ "values": "القيم"},- "remove_action_confirm": {- "title": "هل تريد إزالة الإجراء؟",- "message": "تمت إزالته عند حفظ العرض الترويجي."+ "kinds": {+ "buttons": "Buttons",+ "color_swatch": "Color swatch",+ "dropdown": "Dropdown"},- "action_summary": {- "variant_count": "{{count}} متغيرات"+ "messages": {+ "created": "تم إنشاء نوع الخيار",+ "deleted": "تم حذف نوع الخيار",+ "updated": "تم تحديث نوع الخيار"},- "action_picker": {- "title": "أضف الإجراء",- "description": "اختر ما يجب أن يحدث عندما يصبح العرض الترويجي مؤهلاً."+ "table": {+ "empty": "لا توجد أنواع خيارات بعد",+ "search_placeholder": "البحث بالاسم…"},- "action_edit": {- "description": "قم بتكوين معلمات الإجراء.",- "no_options": "لا يحتوي هذا الإجراء على خيارات قابلة للتكوين."+ "value_count_one": "{{count}} قيمة",+ "value_count_other": "{{count}} قيم"+ },+ "order_routing_rules": {+ "messages": {+ "created": "تمت إضافة قاعدة التوجيه",+ "deleted": "تمت إزالة قاعدة التوجيه"},- "coupon_codes": {- "title": "رموز القسيمة",- "description": "الرموز التي تم إنشاؤها تلقائيًا لهذا العرض الترويجي. للقراءة فقط — قم بالتجديد عن طريق تغيير إعداد عدد الرموز الخاصة بالحملة الترويجية.",- "description_with_count": "{{count}} رمزًا مُنشأًا تلقائيًا. للقراءة فقط — أعد الإنشاء بتغيير إعداد عدد الرموز في العرض.",- "empty": "لم يتم إنشاء رموز حتى الآن.",- "unused": "غير مستخدمة",- "used": "مستخدم",- "export_csv": "تصدير CSV",- "states": {- "used": "مستخدم",- "partially_used": "تستخدم جزئيا"+ "types": {+ "default_location": {+ "description": "يفضّل موقع المخزون المحدد كافتراضي",+ "name": "الموقع الافتراضي"+ },+ "minimize_splits": {+ "description": "يفضّل الموقع القادر على تلبية أكبر عدد من العناصر بمفرده لتجنّب تقسيم الشحنات",+ "name": "تقليل تقسيم الشحنات"+ },+ "preferred_location": {+ "description": "الشحن من الموقع المثبّت على الطلب إن وُجد",+ "name": "الموقع المفضل"}+ }+ },+ "orders": {+ "columns": {+ "customer": "العميل",+ "date": "تاريخ",+ "fulfillment": "Fulfillment",+ "items": "أغراض",+ "number": "رقم",+ "payment": "قسط",+ "sku": "SKU",+ "tags": "Tags"},- "rule_types": {- "category": {- "name": "فئات",- "description": "يتضمن الطلب منتجات في فئات محددة"+ "detail": {+ "add_line_item": {+ "title": "Add Line Item"},- "country": {- "name": "دولة",- "description": "يقتصر على الطلبات التي لها عنوان شحن في بلد معين"+ "address_edit": {+ "billing_title": "تحرير عنوان الفواتير",+ "shipping_title": "تحرير عنوان الشحن"+ },+ "adjustment_lines": {+ "add_discount": "إضافة خصم",+ "add_discount_description": "ينشئ خصمًا يدويًا. بدون تحديد عنصر مستهدف يوزَّع المبلغ على جميع العناصر.",+ "add_fee": "إضافة رسوم",+ "add_fee_description": "ينشئ رسومًا مثل رسوم إضافية أو مناولة أو تغليف هدايا.",+ "amount_field": "المبلغ",+ "delete_discount_message": "إزالة الخصم \"{{label}}\" من هذا الطلب؟ سيُعاد حساب الإجماليات.",+ "delete_discount_title": "حذف الخصم",+ "delete_fee_message": "إزالة الرسوم \"{{label}}\" من هذا الطلب؟ سيُعاد حساب الإجماليات.",+ "delete_fee_title": "حذف الرسوم",+ "discounts": "الخصومات",+ "empty": "لا توجد ضرائب أو خصومات أو رسوم على هذا الطلب بعد.",+ "fees": "الرسوم",+ "kind_field": "الفئة",+ "kind_promotion": "عرض ترويجي",+ "label_field": "التسمية",+ "target_field": "ينطبق على",+ "target_order": "الطلب بأكمله",+ "taxes": "الضرائب",+ "title": "الضرائب والخصومات والرسوم",+ "value_field": "القيمة",+ "value_type_field": "النوع",+ "value_type_flat": "مبلغ",+ "value_type_percent": "نسبة مئوية"},- "currency": {- "name": "Currency",- "description": "الحد من الطلبات بعملة معينة"+ "completed_prefix": "مكتمل",+ "confirm": {+ "approve_message": "هل توافق على هذا الطلب؟",+ "cancel_message": "هل أنت متأكد أنك تريد إلغاء هذا الطلب؟",+ "cancel_shipment_message": "إلغاء هذا الوفاء؟",+ "capture_message": "القبض على هذه الدفعة؟",+ "complete_message": "هل تريد إكمال مسودة الطلب هذه الآن؟",+ "remove_gift_card_message": "هل تريد إزالة بطاقة الهدايا هذه من الطلب؟",+ "remove_item_message": "هل تريد إزالة هذا العنصر من الطلب؟",+ "remove_store_credit_message": "هل تريد إزالة رصيد المتجر من الطلب؟",+ "resume_message": "هل تريد استئناف هذا الطلب الملغى؟",+ "ship_message": "شحن هذا الوفاء؟",+ "void_message": "Void هذه الدفعة؟"},- "customer": {- "name": "العملاء",- "description": "متاح فقط للعملاء المحددين"+ "dropdown": {+ "cancel_shipment": "Cancel Shipment",+ "complete_order": "Complete Order",+ "edit_quantity": "Edit Quantity",+ "preview_order": "Preview Order",+ "resend_confirmation": "Resend Confirmation",+ "void_payment": "Void Payment"},- "customer_group": {- "name": "العميل Group(s)",- "description": "متاح فقط للعملاء في مجموعة (مجموعات) العملاء المحددة"+ "edit_quantity": {+ "description": "قم بتعيين الكمية لهذا البند.",+ "title": "Edit Quantity"},- "customer_logged_in": {- "name": "الأشخاص الذين قاموا بتسجيل الدخول فقط custom",- "description": "متاح فقط للأشخاص الذين قاموا بتسجيل الدخول custom"+ "errors": {+ "approve_failed": "فشلت الموافقة على الطلب",+ "cancel_failed": "فشل في إلغاء الطلب",+ "complete_failed": "فشل في إكمال الطلب",+ "confirmation_send_failed": "فشل في إرسال التأكيد",+ "resume_failed": "فشل في استئناف الطلب"},- "first_order": {- "name": "الطلب الأول",- "description": "يجب أن يكون الطلب الأول للعميل"+ "gift_card_section": {+ "applied_suffix": "مُطبَّق",+ "apply_balance": "قم بتطبيق الرصيد المتاح لـ العميل",+ "apply_dialog_description": "أدخل رمز بطاقة الهدايا لتطبيقه على هذا الطلب.",+ "apply_dialog_title": "Apply Gift Card",+ "code_placeholder": "GIFT-XXXX-YYYY",+ "gift_card_label": "بطاقة هدية",+ "none_applied": "لم يتم تطبيق أي شيء",+ "requires_customer": "يتطلب العميل",+ "store_credit_label": "Store credit",+ "title": "Gift Card & Store Credit"},- "item_total": {- "name": "إجمالي السلعة",- "description": "إجمالي الطلب يلبي هذه المعايير"+ "items_table": {+ "item": "غرض",+ "price": "سعر",+ "qty": "الكمية"},- "one_use_per_user": {- "name": "One Use Per User",- "description": "Only One Use Per User"+ "load_failed_message": "لم نتمكن من تحميل الطلب {{orderId}}.",+ "messages": {+ "approved": "تمت الموافقة على الطلب",+ "canceled": "تم إلغاء الطلب",+ "captured": "القبض على الدفع",+ "completed": "اكتمل الطلب",+ "confirmation_sent": "تم إرسال التأكيد",+ "resumed": "تم استئناف الطلب",+ "shipped": "Fulfillment تم الشحن",+ "voided": "تم إلغاء الدفع"},- "option_value": {- "name": "Option Value(s)",- "description": "يتضمن الطلب منتجات ذات قيمة (قيم) خيار متطابقة"+ "no_customer": "لا توجد معلومات العميل",+ "no_line_items": "لا توجد عناصر",+ "payment_form": {+ "amount_help": "اتركه فارغًا لتقصير الرصيد المستحق.",+ "capture_immediately": "التقط على الفور",+ "description": "تحصيل رسوم من طريقة الدفع مقابل هذا الطلب.",+ "method_label": "طريقة الدفع",+ "method_placeholder": "اختر طريقة الدفع",+ "no_saved_cards": "العميل ليس لديه بطاقات محفوظة لطريقة الدفع هذه.",+ "source_label": "مصدر",+ "source_placeholder": "اختر بطاقة محفوظة…",+ "source_requires_customer": "تتطلب طريقة الدفع هذه مصدرًا محفوظًا. قم بتعيين العميل للطلب أولاً.",+ "title": "Add Payment"},- "product": {- "name": "Product(s)",- "description": "يتضمن الطلب منتجًا (منتجات) محددة"- }- },- "action_types": {- "create_adjustment": {- "name": "إنشاء تعديل الطلب بالكامل",- "description": "يقوم بإنشاء تعديل ائتمان ترويجي على الأمر"+ "payments_table": {+ "method": "طريقة",+ "number": "رقم",+ "state": "ولاية"},- "create_item_adjustments": {- "name": "إنشاء تعديل لكل بند",- "description": "إنشاء تسوية رصيد ترويجي على أحد البنود"+ "section_customer_note": "Special Instructions",+ "section_internal_note": "Internal Note",+ "summary": {+ "adjustments": "التعديلات",+ "approved_by": "تمت الموافقة عليه من قبل",+ "canceled_at": "تم الإلغاء عند",+ "canceler": "إلغاء",+ "outstanding_balance": "رصيد متميز",+ "payment_total": "إجمالي الدفع",+ "promotions": "الترقيات",+ "tax_additional": "الضريبة (الإضافية)",+ "tax_included": "الضريبة (متضمنة)"},- "create_line_items": {- "name": "إنشاء عناصر سطرية",- "description": "تعبئة سلة التسوق بالكمية المحددة من المتغير"+ "tracking": {+ "add_title": "Add Tracking",+ "description": "قم بتحديث رقم التتبع لهذه الشحنة.",+ "edit_title": "Edit Tracking",+ "label": "Tracking الرقم",+ "prefix": "Tracking",+ "shipped_prefix": "تم الشحن"},- "free_shipping": {- "name": "ًالشحن مجانا",- "description": "يجعل جميع الشحنات للطلب مجانية"+ "variant_search": {+ "description": "ابحث عن متغير منتج لإضافته إلى هذا الطلب.",+ "empty": "لم يتم العثور على متغيرات",+ "label": "متغير البحث",+ "placeholder": "اكتب اسم المنتج أو SKU (3 أحرف على الأقل)…",+ "sku_prefix": "SKU"}},- "messages": {- "action_added": "تمت إضافة الإجراء",- "action_updated": "تم تحديث الإجراء",- "action_removed": "تمت إزالة الإجراء",- "rule_added": "تمت إضافة القاعدة",- "rule_updated": "تم تحديث القاعدة",- "rule_removed": "تمت إزالة القاعدة"+ "fulfillment_statuses": {+ "backorder": "طلب متأخر",+ "canceled": "تم الإلغاء",+ "fulfilled": "تم الوفاء به",+ "partial": "جزئي",+ "pending": "قيد الانتظار",+ "ready": "مستعد"},- "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": "لا توجد أسواق تتطابق"+ "item_count_one": "{{count}} البند",+ "item_count_other": "{{count}} العناصر",+ "new": {+ "add_variant": "إضافة البديل",+ "creates_draft_note": "إنشاء مسودة أمر. إضافة المدفوعات وإكمالها بعد الإنشاء.",+ "items_table": {+ "qty": "الكمية",+ "sku": "SKU",+ "variant": "البديل"+ },+ "use_default_addresses": "استخدم عناوين الفواتير والشحن الافتراضية لـ العميل"},- "custom_fields": {- "section_title": "الحقول المخصصة",- "set_up": "إعداد الحقول المخصصة",- "manage_in_settings": "الإدارة في الإعدادات",- "empty_title": "لا توجد حقول مخصصة بعد",- "empty_description": "تتبّع تفاصيل منظمة مثل الخامة أو المقاس أو تعليمات العناية.",- "values_saved": "تم حفظ الحقول المخصصة",- "values_save_partial_failed": "تعذّر حفظ بعض الحقول المخصصة: {{fields}}",- "new_definition_title": "حقل مخصص جديد",- "new_definition_description": "حدّد حقلاً مخصصاً لتخزين معلومات مكتوبة ومنظمة في {{resource}} الخاصة بك.",- "default_resource": "السجلات",- "errors": {- "failed_to_save": "فشل حفظ الحقل المخصص"- }+ "payment_statuses": {+ "balance_due": "الرصيد المستحق",+ "credit_owed": "الائتمان المستحق",+ "failed": "فشل",+ "paid": "مدفوع",+ "void": "Void"},- "adjustment_action_editor": {- "calculator_label": "آلة حاسبة",- "loading_calculators": "جارٍ تحميل الآلات الحاسبة…",- "select_calculator": "اختر آلة حاسبة",- "no_extra_settings": "هذه الآلة الحاسبة لا تحتوي على إعدادات إضافية.",- "settings_label": "إعدادات الآلة الحاسبة"+ "statuses": {+ "canceled": "تم الإلغاء",+ "draft": "مسودة",+ "placed": "وضعت"+ },+ "table": {+ "empty": "لم يتم العثور على أي أوامر",+ "search_placeholder": "أوامر البحث…"}},"pages": {- "home": {- "top_products": "Top Products",- "top_products_description": "المنتجات الأكثر مبيعا في متجرك.",- "title": "Dashboard",- "subtitle": "نظرة عامة على أداء متجرك",- "metrics": {- "sales": "إجمالي المبيعات",- "orders": "إجمالي الطلبات",- "avg_order_value": "متوسط قيمة الطلب"- },- "metric_short": {- "sales": "مبيعات",- "orders": "طلبات",- "avg_order_value": "AOV"- },- "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": "طلبات مجموعة قنوات المبيعات وقوائم المنتجات - \"عبر الإنترنت\"، و\"نقاط البيع\"، وتكامل السوق، وما إلى ذلك.",- "edit_description": "إعادة تسمية قناة المبيعات أو إيقافها مؤقتًا. تتوقف قنوات البيع غير النشطة عن قبول الطلبات.",+ "create_label": "إنشاء قناة مبيعات","delete_confirm": {- "title": "هل تريد حذف قناة المبيعات؟",- "message": "ستتم إزالة {{name}}. ستفقد المنتجات والأوامر المرتبطة بها مرجع قناة المبيعات الخاصة بها."+ "message": "ستتم إزالة {{name}}. ستفقد المنتجات والأوامر المرتبطة بها مرجع قناة المبيعات الخاصة بها.",+ "title": "هل تريد حذف قناة المبيعات؟"},+ "edit_description": "إعادة تسمية قناة المبيعات أو إيقافها مؤقتًا. تتوقف قنوات البيع غير النشطة عن قبول الطلبات.",+ "edit_sheet_title": "تحرير قناة المبيعات",+ "empty_message": "لا توجد قنوات مبيعات حتى الآن",+ "no_channels_found": "لم يتم العثور على قنوات البيع","order_routing_rules": {- "title": "قواعد توجيه الطلبات",- "help": "عند استخدام استراتيجية التوجيه «قواعد (مرتبة)»، تُقيَّم القواعد من الأعلى إلى الأسفل — تفوز أول قاعدة تحدد موقع مخزون واحدًا، وعند التعادل تُحسم بالقاعدة التالية.",- "empty": "لا توجد قواعد توجيه — تُوجَّه الطلبات إلى موقع المخزون الافتراضي.",- "add_cta": "إضافة قاعدة",- "picker_title": "إضافة قاعدة توجيه",- "edit_preferences": "تعديل إعدادات القاعدة","active_toggle": "القاعدة مفعّلة",+ "add_cta": "إضافة قاعدة","delete_confirm": {- "title": "حذف قاعدة التوجيه؟",- "message": "ستتم إزالة {{name}} من ترتيب التوجيه لهذه القناة."- }+ "message": "ستتم إزالة {{name}} من ترتيب التوجيه لهذه القناة.",+ "title": "حذف قاعدة التوجيه؟"+ },+ "edit_preferences": "تعديل إعدادات القاعدة",+ "empty": "لا توجد قواعد توجيه — تُوجَّه الطلبات إلى موقع المخزون الافتراضي.",+ "help": "عند استخدام استراتيجية التوجيه «قواعد (مرتبة)»، تُقيَّم القواعد من الأعلى إلى الأسفل — تفوز أول قاعدة تحدد موقع مخزون واحدًا، وعند التعادل تُحسم بالقاعدة التالية.",+ "picker_title": "إضافة قاعدة توجيه",+ "title": "قواعد توجيه الطلبات"},"search_placeholder": "البحث في قنوات البيع…",- "no_channels_found": "لم يتم العثور على قنوات البيع",+ "title": "قنوات البيع","validation": {"code_format": "أحرف صغيرة وأرقام وشرطات وشرطات سفلية فقط"}},"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": "حساب تعريفي",+ "add_address": "أضف عنوانًا",+ "addresses_empty": "لا توجد عناوين في الملف.",+ "edit_address": "تحرير العنوان",+ "edit_credit": "تحرير رصيد المتجر",+ "issue_credit": "إصدار رصيد المتجر",+ "orders_empty": "لا توجد أوامر حتى الآن.","section_addresses": "العناوين",+ "section_internal_note": "ملاحظة داخلية","section_orders": "طلبات",+ "section_profile": "حساب تعريفي","section_store_credit": "Store credit",- "section_internal_note": "ملاحظة داخلية","section_tags": "Tags",- "addresses_empty": "لا توجد عناوين في الملف.",- "orders_empty": "لا توجد أوامر حتى الآن.",- "store_credit_empty": "لم يتم إصدار أي رصيد مخزن.",- "add_address": "أضف عنوانًا",- "edit_address": "تحرير العنوان",- "issue_credit": "إصدار رصيد المتجر",- "edit_credit": "تحرير رصيد المتجر"- }+ "stat_avg_order_value": "متوسط قيمة الطلب",+ "stat_orders": "طلبات",+ "stat_total_spent": "إجمالي ما تم إنفاقه",+ "store_credit_empty": "لم يتم إصدار أي رصيد مخزن."+ },+ "edit_sheet_title": "تعديل العميل",+ "groups": {+ "add_cta": "إضافة مجموعة عملاء",+ "add_sheet_title": "إضافة مجموعة عملاء",+ "edit_sheet_title": "تعديل مجموعة العملاء",+ "title": "مجموعات العملاء"+ },+ "groups_cta": "مجموعات العملاء",+ "new_cta": "عميل جديد"},- "orders": {- "drafts_title": "Draft Orders",- "new": {- "title": "طلب جديد",- "section_customer": "العميل",- "section_items": "أغراض",- "section_billing": "الفواتير",- "section_notes": "ملحوظات",- "section_summary": "ملخص",- "add_line_item": "إضافة بند",- "select_customer": "اختر عميلًا",- "search_variant": "متغير البحث…"+ "getting_started": {+ "description": "أكمل هذه الخطوات لإطلاق متجرك.",+ "progress": "اكتمل {{done}} من {{total}}",+ "storefront_sheet": {+ "api_url_label": "عنوان URL لـ Store API",+ "deploy_button": "النشر على Vercel",+ "deploy_copy": "يستنسخ النشر المتجر مفتوح المصدر إلى حساب Git الخاص بك ويبنيه على Vercel مع تعبئة بيانات الاعتماد مسبقًا. بعد الانتهاء، انسخ عنوان URL الخاص به في الحقل أدناه.",+ "deploy_title": "موصى به: انشر متجر Next.js الرسمي",+ "description": "استخدم بيانات الاعتماد هذه في أي عميل يتواصل مع Store API — متجر ويب أو تطبيق جوال أو أي شيء آخر.",+ "env_description": "عنوان URL لـ Spree Store API ومفتاحك القابل للنشر. كلاهما معبأ مسبقًا من متجرك — عدّلهما قبل النشر إذا لزم الأمر.",+ "invalid_url": "لا يبدو هذا عنوان URL صالحًا للمتجر.",+ "key_error": "تعذر تحميل مفتاح API القابل للنشر.",+ "local_installation_instructions": "تعليمات التثبيت المحلي",+ "publishable_key_label": "مفتاح API القابل للنشر",+ "save": "احفظ وأكمل الإعداد",+ "saved": "تم حفظ عنوان URL للمتجر: {{url}}",+ "see_online_demo": "شاهد العرض التوضيحي عبر الإنترنت",+ "storefront_url_help": "عنوان URL الذي يستخدمه العملاء للوصول إلى متجرك. يصبح الأساس للروابط في رسائل البريد الإلكتروني للعملاء ويُضاف تلقائيًا كأصل مسموح به حتى تتمكن المتاجر المستندة إلى المتصفح من استدعاء Store API.",+ "storefront_url_label": "عنوان URL للمتجر",+ "storefront_url_placeholder": "https://myshop.com",+ "title": "اربط متجرك"},- "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"+ "tasks": {+ "add_products": {+ "cta": "إضافة المنتجات",+ "description": "أضف منتجات إلى متجرك — منتجاتك الخاصة أو ادعُ بائعين خارجيين للبيع معًا.",+ "import_cta": "استيراد المنتجات من CSV",+ "title": "إضافة المنتجات"},- "empty_payments": "لا توجد مدفوعات حتى الآن.",- "empty_shipments": "لا توجد شحنات حتى الآن.",- "no_delivery_method": "لم يتم اختيار طريقة توصيل.",- "empty_history": "لا يوجد تاريخ بعد.",+ "set_customer_support_email": {+ "cta": "إعدادات البريد الإلكتروني",+ "description": "يظهر في متجرك كنقطة اتصال لأسئلة العملاء والدعم.",+ "title": "تعيين البريد الإلكتروني لدعم العملاء"+ },+ "setup_payment_method": {+ "cta": "إعداد المدفوعات",+ "description": "لاستلام المدفوعات، قم بإعداد مزود دفع إلكتروني واحد على الأقل.",+ "title": "إعداد طرق الدفع"+ },+ "setup_storefront": {+ "cta": "ربط المتجر",+ "description": "اربط متجرك الإلكتروني أو تطبيقك للجوال باستخدام بيانات اعتماد Store API واحفظ عنوان URL لمتجرك.",+ "title": "إعداد المتجر"+ },+ "setup_taxes_collection": {+ "cta": "إعدادات الضرائب",+ "description": "لتحصيل الضرائب، قم بإعداد معدلات الضرائب.",+ "title": "إعداد تحصيل الضرائب"+ }+ },+ "title": "البدء"+ },+ "home": {+ "columns": {+ "price": "سعر",+ "product": "منتج",+ "sold": "مُباع"+ },+ "metric_short": {+ "avg_order_value": "AOV",+ "orders": "طلبات",+ "sales": "مبيعات"+ },+ "metrics": {+ "avg_order_value": "متوسط قيمة الطلب",+ "orders": "إجمالي الطلبات",+ "sales": "إجمالي المبيعات"+ },+ "subtitle": "نظرة عامة على أداء متجرك",+ "title": "Dashboard",+ "top_products": "Top Products",+ "top_products_description": "المنتجات الأكثر مبيعا في متجرك."+ },+ "orders": {+ "detail": {"actions": {"approve": "يعتمد","cancel": "إلغاء الطلب",- "resume": "سيرة ذاتية",- "refund": "استرداد","capture": "يأسر",- "void": "Void","mark_paid": "وضع علامة على أنه مدفوع",- "ship": "وضع علامة على أنه تم الشحن"+ "refund": "استرداد",+ "resume": "سيرة ذاتية",+ "ship": "وضع علامة على أنه تم الشحن",+ "void": "Void"},"dialogs": {- "cancel_title": "هل تريد إلغاء الطلب؟","approve_title": "الموافقة على الطلب؟",+ "cancel_title": "هل تريد إلغاء الطلب؟","refund_title": "استرداد المبلغ؟"+ },+ "empty_history": "لا يوجد تاريخ بعد.",+ "empty_payments": "لا توجد مدفوعات حتى الآن.",+ "empty_shipments": "لا توجد شحنات حتى الآن.",+ "no_delivery_method": "لم يتم اختيار طريقة توصيل.",+ "section_billing_address": "عنوان إرسال الفواتير",+ "section_customer": "العميل",+ "section_customer_note": "ملاحظة العميل",+ "section_fulfillments": "عمليات التنفيذ",+ "section_history": "تاريخ",+ "section_internal_note": "ملاحظة داخلية",+ "section_items": "أغراض",+ "section_payments": "المدفوعات",+ "section_shipping_address": "عنوان الشحن",+ "section_summary": "ملخص",+ "summary": {+ "channel": "قناة المبيعات",+ "created_by": "تم إنشاؤها بواسطة",+ "ip_address": "عنوان IP",+ "locale": "لغة",+ "market": "سوق"}+ },+ "drafts_title": "Draft Orders",+ "new": {+ "add_line_item": "إضافة بند",+ "search_variant": "متغير البحث…",+ "section_billing": "الفواتير",+ "section_customer": "العميل",+ "section_items": "أغراض",+ "section_notes": "ملحوظات",+ "section_summary": "ملخص",+ "select_customer": "اختر عميلًا",+ "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": "المتغيرات",- "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_add_failed": "فشلت إضافة المنتجات إلى الفئات",+ "categories_add_title": "أضف إلى الفئات",+ "categories_added": "تمت إضافة منتجات {n} إلى الفئات","categories_remove_description": "اختر الفئات المراد إزالة هذه المنتجات منها.",- "channels_add_title": "أضف إلى قنوات البيع",+ "categories_remove_failed": "فشلت إزالة المنتجات من الفئات",+ "categories_remove_title": "إزالة من الفئات",+ "categories_removed": "تمت إزالة منتجات {n} من الفئات","channels_add_description": "اختر قنوات البيع لإدراج هذه المنتجات عليها.",- "channels_remove_title": "إزالة من قنوات البيع",+ "channels_add_failed": "فشل في إدراج المنتجات على قنوات البيع",+ "channels_add_title": "أضف إلى قنوات البيع",+ "channels_added": "إدراج منتجات {n} على قنوات البيع","channels_remove_description": "اختر قنوات المبيعات لإلغاء إدراج هذه المنتجات منها.",- "tags_add_title": "إضافة العلامات",- "tags_add_description": "اختر أو أنشئ علامات لإضافتها إلى هذه المنتجات.",- "tags_remove_title": "إزالة العلامات",- "tags_remove_description": "اختر العلامات لإزالتها من هذه المنتجات.",+ "channels_remove_failed": "فشل في إلغاء إدراج المنتجات من قنوات البيع",+ "channels_remove_title": "إزالة من قنوات البيع",+ "channels_removed": "منتجات {n} غير مدرجة من قنوات البيع","delete_confirm": {- "title": "هل تريد حذف منتجات {n}؟",- "message": "ستتم إزالة المنتجات المحددة. لا يمكن التراجع عن هذا الإجراء."+ "message": "ستتم إزالة المنتجات المحددة. لا يمكن التراجع عن هذا الإجراء.",+ "title": "هل تريد حذف منتجات {n}؟"},- "status_updated": "تحديث الحالة على منتجات {n}",+ "delete_failed": "فشل في حذف المنتجات",+ "deleted": "منتجات {n} المحذوفة",+ "remove_categories_action": "إزالة من الفئات…",+ "remove_channels_action": "إزالة من قنوات البيع…",+ "remove_tags_action": "إزالة العلامات…",+ "set_status_action": "تعيين الحالة…",+ "status_sheet_description": "اختر الحالة المراد تطبيقها على المنتجات المحددة.",+ "status_sheet_title": "ضبط حالة المنتج","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}",+ "status_updated": "تحديث الحالة على منتجات {n}",+ "tags_add_description": "اختر أو أنشئ علامات لإضافتها إلى هذه المنتجات.","tags_add_failed": "فشلت إضافة العلامات",- "tags_removed": "تمت إزالة العلامات من منتجات {n}",+ "tags_add_title": "إضافة العلامات",+ "tags_added": "تمت إضافة العلامات إلى منتجات {n}",+ "tags_remove_description": "اختر العلامات لإزالتها من هذه المنتجات.","tags_remove_failed": "فشلت إزالة العلامات",- "deleted": "منتجات {n} المحذوفة",- "delete_failed": "فشل في حذف المنتجات"+ "tags_remove_title": "إزالة العلامات",+ "tags_removed": "تمت إزالة العلامات من منتجات {n}"},- "media_empty": "لا توجد وسائل الإعلام بعد.",- "media_upload": "تحميل الوسائط",- "variants_empty": "لا توجد متغيرات حتى الآن.",- "status_options": {- "draft": "مسودة",- "active": "نشط",- "archived": "مؤرشف"+ "clone_failed": "فشل في تكرار المنتج",+ "clone_succeeded": "المنتج مكرر",+ "delete_failed": "فشل في حذف المنتج",+ "delete_succeeded": "تم حذف المنتج",+ "edit": {+ "bulk_prices": {+ "no_variants": "أضف متغيرًا واحدًا على الأقل لبدء تعديل الأسعار."+ }},"inventory": {- "out_of_stock": "إنتهى من المخزن",+ "in_stock": "{{count}} في المخزون","on_backorder": "على المؤجل",- "in_stock": "{{count}} في المخزون"+ "out_of_stock": "إنتهى من المخزن"},- "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": "لا توجد عناصر بعد."+ "media_empty": "لا توجد وسائل الإعلام بعد.",+ "media_upload": "تحميل الوسائط",+ "new": {+ "create_failed": "فشل في إنشاء المنتج",+ "create_succeeded": "تم إنشاء المنتج",+ "description": "قم بإعداد منتجك — أضف المتغيرات والأسعار والمخزون والوسائط والحقول المخصصة",+ "preview_slug_placeholder": "your-product-slug",+ "save_label": "إنشاء المنتج",+ "title": "منتج جديد"},"options": {+ "add_value": "إضافة قيمة الخيار","sheet_title_create": "إنشاء نوع الخيار","sheet_title_edit": "تحرير نوع الخيار",- "values_section": "قيم",- "values_empty": "لا توجد قيم بعد.",- "add_value": "إضافة قيمة الخيار","table": {"values": "قيم"- }+ },+ "values_empty": "لا توجد قيم بعد.",+ "values_section": "قيم"},"price_lists": {- "title": "Price Lists",- "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}}\" على المؤهلين custom على الفور وسيظل نشطًا حتى يتم إلغاء التنشيط يدويًا.",- "message_with_end": "سيتم تطبيق \"{{name}}\" على المؤهلين custom على الفور وسيظل نشطًا حتى يتم إلغاء التنشيط يدويًا أو تاريخ انتهائه ({{ends_at}})."- },- "schedule_confirm": {- "title": "جدولة قائمة الأسعار؟",- "message": "سيتم بث \"{{name}}\" على {{starts_at}} وسيظل نشطًا حتى تاريخ انتهائه."+ "message_with_end": "سيتم تطبيق \"{{name}}\" على المؤهلين custom على الفور وسيظل نشطًا حتى يتم إلغاء التنشيط يدويًا أو تاريخ انتهائه ({{ends_at}}).",+ "title": "تفعيل قائمة الأسعار؟"},+ "add_cta": "قائمة الأسعار الجديدة",+ "add_products_cta": "أضف المنتجات",+ "add_rule": "أضف القاعدة",+ "add_rule_help": "اختر نوع القاعدة لتكوينه.",+ "basics_section": "الأساسيات",+ "deactivate": "إلغاء التنشيط","deactivate_confirm": {- "title": "هل تريد إلغاء تفعيل قائمة الأسعار؟",- "message": "سيتوقف تطبيق \"{{name}}\" على custom على الفور. الطلبات الحالية لن تتأثر."+ "message": "سيتوقف تطبيق \"{{name}}\" على custom على الفور. الطلبات الحالية لن تتأثر.",+ "title": "هل تريد إلغاء تفعيل قائمة الأسعار؟"},- "unschedule_confirm": {- "title": "قائمة الأسعار غير المجدولة؟",- "message": "لن يتم تفعيل \"{{name}}\" في الموعد المحدد له بعد الآن. ويمكنك إعادة جدولته أو تفعيله يدويًا لاحقًا."+ "delete_confirm": {+ "message": "تؤدي إزالة \"{{name}}\" إلى حذف أسعارها. لا يمكن التراجع عن هذا.",+ "title": "هل تريد حذف قائمة الأسعار؟"},"edit_prices": {- "title": "تعديل الأسعار — {{name}}",- "currency_label": "Currency",- "empty": "لا توجد منتجات في هذه القائمة حتى الآن.","add_products_link": "أضف المنتجات","columns": {+ "compare_at_price": "Compare-at price",+ "price": "سعر","product": "منتج",- "variant": "البديل","sku": "SKU",- "price": "سعر",- "compare_at_price": "Compare-at price"+ "variant": "البديل"},- "variant_default": "تقصير",- "grid_aria": "أسعار متغيرة",- "search_placeholder": "البحث حسب المنتج، SKU، أو الخيار…",- "price_aria": "سعر {{label}}","compare_at_aria": "Compare-at price لـ {{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": "لا توجد أسعار أساسية بعد.",+ "currency_label": "Currency","dirty_summary_one": "{{count}} تغيير غير محفوظ","dirty_summary_other": "{{count}} التغييرات غير المحفوظة","discard_confirm": {- "title": "هل تريد تجاهل الأسعار غير المحفوظة؟","message_close_one": "لديك {{count}} سعر غير محفوظ. إغلاق سوف تجاهل ذلك.","message_close_other": "لديك {{count}} أسعار غير محفوظة. سيؤدي الإغلاق إلى تجاهلهم.",- "message_currency": "سيؤدي تبديل العملة إلى تجاهل الأسعار غير المحفوظة."- }+ "message_currency": "سيؤدي تبديل العملة إلى تجاهل الأسعار غير المحفوظة.",+ "title": "هل تريد تجاهل الأسعار غير المحفوظة؟"+ },+ "empty": "لا توجد منتجات في هذه القائمة حتى الآن.",+ "empty_no_base_prices": "لا توجد أسعار أساسية بعد.",+ "empty_pick_products": "اختر المنتجات من قائمة الأسعار للبدء في تحديد الأسعار.",+ "grid_aria": "أسعار متغيرة",+ "no_matches_for_filters": "لا توجد أسعار تتطابق مع الفلاتر الحالية.",+ "no_matches_for_search": "لا توجد أسعار تطابق \"{{search}}\".",+ "price_aria": "سعر {{label}}",+ "save_cta": "حفظ الأسعار",+ "save_failed": "فشل في حفظ الأسعار",+ "save_success_one": "تم الحفظ {{count}} السعر",+ "save_success_other": "تم الحفظ {{count}} الأسعار",+ "search_placeholder": "البحث حسب المنتج، SKU، أو الخيار…",+ "title": "تعديل الأسعار — {{name}}",+ "variant_default": "تقصير"},+ "edit_prices_cta": "تحرير الأسعار",+ "no_changes": "لا توجد تغييرات للحفظ.",+ "prices_help_one": "{{count}} تم تكوين السعر. افتح المحرر المجمع لتحديثه.",+ "prices_help_other": "{{count}} الأسعار مضبوطة. افتح المحرر المجمع لتحديثها.",+ "prices_help_zero": "اختر المنتجات أعلاه لتحديد أسعار العناصر النائبة، ثم افتح المحرر المجمع.","products_empty": "لا توجد منتجات حتى الآن — أضف منتجًا لبدء تعديل الأسعار.",- "no_changes": "لا توجد تغييرات للحفظ."- }+ "products_empty_search": "لا توجد منتجات متطابقة",+ "products_help": "اختر المنتجات التي تنطبق عليها هذه القائمة. يتم إنشاء أسعار العناصر النائبة عند الحفظ - املأها أدناه.",+ "products_search_placeholder": "البحث عن المنتجات بالاسم…",+ "products_section": "منتجات",+ "products_selected_one": "{{count}} المنتج المحدد.",+ "products_selected_other": "{{count}} منتجات المختارة.",+ "remove_rule_confirm": {+ "message": "تتم إزالة القاعدة عند حفظ قائمة الأسعار.",+ "title": "هل تريد إزالة القاعدة؟"+ },+ "remove_selected": "إزالة المحدد",+ "rule_click_to_configure": "انقر للتكوين",+ "rule_default_description": "ضبط معلمات القاعدة.",+ "rule_name_overflow": "{{names}} +{{count}} المزيد",+ "rule_no_options": "لا تحتوي هذه القاعدة على خيارات قابلة للتكوين، فوجودها وحده يطبق القيد.",+ "rule_types_all_used": "كل نوع قاعدة متاح موجود بالفعل في هذه القائمة.",+ "rule_types_empty": "لم يتم تسجيل أي أنواع قواعد.",+ "rules_empty": "لا توجد قواعد - تنطبق هذه القائمة على كل متسوق.",+ "rules_help": "الشروط التي تقرر متى تنطبق هذه القائمة. استخدم \"الكل\" للمطالبة بكل قاعدة، و\"أي\" لأخذ المباراة الأولى.",+ "rules_section": "قواعد",+ "schedule": "جدول",+ "schedule_confirm": {+ "message": "سيتم بث \"{{name}}\" على {{starts_at}} وسيظل نشطًا حتى تاريخ انتهائه.",+ "title": "جدولة قائمة الأسعار؟"+ },+ "schedule_section": "جدول",+ "sheet_title_create": "إنشاء قائمة الأسعار",+ "sheet_title_edit": "تعديل قائمة الأسعار",+ "subtitle": "تسعير مستهدف لمجموعات العملاء أو المناطق أو شرائح الحجم.",+ "title": "Price Lists",+ "unschedule": "إلغاء الجدول الزمني",+ "unschedule_confirm": {+ "message": "لن يتم تفعيل \"{{name}}\" في الموعد المحدد له بعد الآن. ويمكنك إعادة جدولته أو تفعيله يدويًا لاحقًا.",+ "title": "قائمة الأسعار غير المجدولة؟"+ }+ },+ "publishing": {+ "caption_hidden_after": "ينزل {{date}}",+ "caption_live": "مرئي للعملاء الآن",+ "caption_not_available": "مخفي — المنتج {{product_status}}",+ "caption_scheduled": "يبدأ البث المباشر {{date}}",+ "caption_unpublished": "كانت مخفية على {{date}}",+ "caption_window": "مباشر {{start}} → {{end}}",+ "empty": "لم يتم إدراجه في أي قناة مبيعات حتى الآن.",+ "inactive_marker": "غير نشط",+ "manage_cta": "يدير",+ "manage_description": "اختر قنوات المبيعات التي تدرج هذا المنتج. قم بإيقاف تشغيل القناة لإلغاء إدراجها في كل مكان.",+ "manage_title": "إدارة قنوات البيع",+ "no_channels": "لا توجد قنوات مبيعات متاحة. قم بإنشاء واحدة في الإعدادات → قنوات المبيعات.",+ "status_hidden": "مختفي",+ "status_live": "يعيش",+ "status_not_available": "غير متوفر",+ "status_scheduled": "المقرر",+ "title": "نشر"+ },+ "section_basics": "الأساسيات",+ "section_categorization": "التصنيف",+ "section_inventory": "جرد",+ "section_media": "وسائط",+ "section_organization": "منظمة",+ "section_pricing": "التسعير",+ "section_seo": "SEO",+ "section_variants": "المتغيرات",+ "status_options": {+ "active": "نشط",+ "archived": "مؤرشف",+ "draft": "مسودة"+ },+ "transfers": {+ "description_external": "الاستلام الخارجي إلى <strong>{{destination}}</strong>.",+ "description_internal": "تم نقل المخزون من <strong>{{source}}</strong> إلى <strong>{{destination}}</strong>.",+ "edit_sheet_title": "نقل {{number}}",+ "items_empty": "لا توجد عناصر بعد.",+ "section_from": "من",+ "section_items": "أغراض",+ "section_to": "ل",+ "sheet_title": "نقل المخزون الجديد"+ },+ "variants_empty": "لا توجد متغيرات حتى الآن.",+ "variants_one": "{{count}} البديل",+ "variants_other": "{{count}} متغيرات"+ },+ "profile": {+ "load_failed_title": "تعذر تحميل ملفك الشخصي",+ "personal_details": "البيانات الشخصية",+ "subtitle": "إدارة بياناتك الشخصية ولغة الإدارة.",+ "title": "الملف الشخصي"+ },+ "promotions": {+ "create_cta": "إنشاء الترويج",+ "gift_cards": {+ "batch_section": "حزمة",+ "create_batch_cta": "قم بإنشاء بطاقات هدايا {{count}}",+ "create_label": "إنشاء بطاقة هدية",+ "delete_confirm": {+ "message": "سيؤدي هذا إلى إبطال بطاقة الهدايا ومنع استردادها.",+ "title": "هل تريد حذف بطاقة الهدايا؟"+ },+ "edit_sheet_title": "بطاقة هدية",+ "new_cta": "بطاقة هدية جديدة",+ "new_sheet_title": "بطاقة هدية جديدة",+ "no_customer": "لا يوجد عميل مرتبط",+ "not_found": "لم يتم العثور على بطاقة الهدايا.",+ "prefix": {+ "auto_placeholder": "Auto-generated when blank",+ "label": "بادئة",+ "placeholder": "e.g. WELCOME — codes will be WELCOME-abc123"+ },+ "sheet": {+ "create_description": "قم بإصدار بطاقة هدايا واحدة أو إنشاء دفعة باستخدام الرموز التي يتم إنشاؤها تلقائيًا.",+ "edit_description": "حدّث عميل بطاقة الهدايا أو تاريخ انتهائها. الرمز والمبلغ غير قابلين للتغيير بعد الإصدار."+ },+ "status_options": {+ "expired": "منتهي الصلاحية",+ "redeemed": "مستردة",+ "void": "Void"+ },+ "usage": {+ "issued_by": "صادرة عن",+ "remaining": "متبقي",+ "title": "الاستخدام",+ "used": "مستخدم"+ },+ "validation": {+ "amount_positive": "يجب أن يكون المبلغ أكبر من الصفر",+ "amount_required": "المبلغ مطلوب",+ "currency_required": "Currency مطلوب",+ "prefix_required": "البادئة مطلوبة للدفعات"+ }+ },+ "loading": "جارٍ تحميل العرض الترويجي…",+ "new_title": "ترقية جديدة"},"settings": {- "store": {- "title": "إعدادات المتجر",- "subtitle": "التكوين العام والإعدادات الافتراضية على مستوى المتجر.",- "tab_general": "عام",- "tab_standards": "المعايير والأشكال",- "tab_storefront_access": "الوصول إلى المتجر"+ "allowed_origins": {+ "add_sheet_title": "أضف الأصل المسموح به",+ "edit_sheet_title": "تحرير الأصل المسموح به"+ },+ "api_keys": {+ "empty_publishable": "لا توجد مفاتيح قابلة للنشر حتى الآن.",+ "empty_secret": "لا توجد مفاتيح سرية حتى الآن.",+ "new_cta": "مفتاح جديد",+ "publishable_help": "المستخدمة من قبل واجهة المتجر الخاص بك. آمن للكشف في التعليمات البرمجية من جانب العميل.",+ "publishable_section": "مفاتيح قابلة للنشر",+ "save_secret_description": "انسخ هذه القيمة الآن، ولن نعرضها مرة أخرى.",+ "save_secret_title": "احفظ مفتاحك السري",+ "scope_badge": {+ "full_access": "الوصول الكامل",+ "read_all": "اقرأ الكل"+ },+ "secret_help": "خادم إلى خادم فقط. نطاق كل مفتاح للعمليات التي يحتاجها.",+ "secret_section": "مفاتيح سرية",+ "subtitle": "قم بتفويض عمليات التكامل والتطبيقات للاتصال بالمسؤول API.",+ "table": {+ "all_channels": "All channels",+ "channel": "Channel",+ "key": "Key",+ "last_used_at": "آخر استخدام",+ "scopes": "Scopes"+ },+ "title": "API مفاتيح"+ },+ "custom_field_definitions": {+ "add_sheet_title": "أضف الحقل custom",+ "edit_sheet_title": "قم بتحرير الحقل custom"},"emails": {- "title": "إعدادات Email",- "subtitle": "عناوين المرسل والإشعارات والشعار المضمن في رسائل البريد الإلكتروني الخاصة بالمعاملات.",- "section_delivery": "توصيل",+ "load_failed_title": "تعذر تحميل إعدادات البريد الإلكتروني",+ "logo_dimensions_help": "الموصى بها: 204 × 104 بكسل.","section_addresses": "عناوين Email",+ "section_delivery": "توصيل","section_logo": "الشعار",- "logo_dimensions_help": "الموصى بها: 204 × 104 بكسل.",- "load_failed_title": "تعذر تحميل إعدادات البريد الإلكتروني"+ "subtitle": "عناوين المرسل والإشعارات والشعار المضمن في رسائل البريد الإلكتروني الخاصة بالمعاملات.",+ "title": "إعدادات Email"},- "webhooks": {- "title": "Webhooks",- "subtitle": "اشترك في نقاط النهاية HTTPS للأحداث التي يطلقها متجرك.",- "search_placeholder": "البحث عن طريق URL…",- "new_cta": "نقطة نهاية جديدة",- "empty_title": "لا توجد نقاط نهاية لخطاف الويب حتى الآن",- "empty_description": "قم بإنشاء نقطة نهاية لتلقي POST موقعة في كل مرة يتم فيها تشغيل حدث مشترك.",- "add_sheet_title": "أضف نقطة نهاية خطاف الويب",- "edit_sheet_title": "تحرير نقطة نهاية خطاف الويب",- "deliveries_sheet_title": "التسليمات الأخيرة",+ "imports": {"delete_confirm": {- "title": "هل تريد حذف نقطة نهاية الرد التلقائي على الويب؟",- "message": "{{name}} سيتوقف عن تلقي التسليمات على الفور. تتم أيضًا إزالة سجل التسليم السابق."- },- "detail": {- "load_failed_title": "تعذر تحميل نقطة نهاية الرد التلقائي على الويب هذه",- "delete_label": "حذف نقطة النهاية",- "details_title": "تفاصيل",- "edit_title": "تحرير نقطة النهاية",- "url": "Destination URL",- "subscriptions": "Events"+ "message": "سيؤدي هذا إلى إزالة {{number}} وصفوفه والملف المرفوع.",+ "title": "حذف الاستيراد؟"},- "save_secret_title": "احفظ سر التوقيع الخاص بك",- "save_secret_description": "تحقق من توقيعات Webhook الواردة باستخدام هذا المفتاح. لن نعرضه مرة أخرى.",- "actions": {- "send_test": "إرسال الاختبار",+ "empty_title": "لا توجد عمليات استيراد بعد",+ "search_placeholder": "البحث بالرقم…",+ "table": {+ "failed_count": "{{failed}} فشلت",+ "number": "الرقم",+ "rows": "الصفوف",+ "status": "الحالة",+ "type": "النوع"+ },+ "title": "عمليات الاستيراد"+ },+ "markets": {+ "add_sheet_title": "أضف السوق",+ "edit_sheet_title": "تحرير السوق"+ },+ "payment_methods": {+ "add_sheet_title": "أضف طريقة الدفع",+ "edit_sheet_title": "تعديل طريقة الدفع"+ },+ "stock_locations": {+ "add_sheet_title": "إضافة موقع المخزون",+ "edit_sheet_title": "تحرير موقع المخزون",+ "search_placeholder": "البحث عن مواقع المخزون…"+ },+ "store": {+ "subtitle": "التكوين العام والإعدادات الافتراضية على مستوى المتجر.",+ "tab_general": "عام",+ "tab_standards": "المعايير والأشكال",+ "tab_storefront_access": "الوصول إلى المتجر",+ "title": "إعدادات المتجر"+ },+ "tax_categories": {+ "add_sheet_title": "إضافة فئة الضريبة",+ "edit_sheet_title": "تحرير فئة الضريبة"+ },+ "webhooks": {+ "actions": {"disable": "إبطال","enable": "إعادة التمكين",- "view_deliveries": "عرض عمليات التسليم",- "redeliver": "إعادة التسليم"+ "redeliver": "إعادة التسليم",+ "send_test": "إرسال الاختبار",+ "view_deliveries": "عرض عمليات التسليم"},- "status": {- "inactive": "غير نشط",- "disabled": "تعطيل تلقائي",- "disabled_reason": "معطل: {{reason}}"+ "add_sheet_title": "أضف نقطة نهاية خطاف الويب",+ "delete_confirm": {+ "message": "{{name}} سيتوقف عن تلقي التسليمات على الفور. تتم أيضًا إزالة سجل التسليم السابق.",+ "title": "هل تريد حذف نقطة نهاية الرد التلقائي على الويب؟"},- "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}} فشل"+ "deliveries": {+ "detail": {+ "copy_payload_aria": "نسخ حمولة الطلب",+ "copy_response_aria": "نسخ نص الاستجابة",+ "delivered_at": "تم التسليم في",+ "error_type": "نوع الخطأ",+ "event": "حدث",+ "execution_time": "وقت التنفيذ",+ "request_errors": "خطأ في النقل",+ "request_payload": "طلب الحمولة",+ "response_body": "هيئة الاستجابة",+ "response_body_truncated": "تم اقتطاع نص الاستجابة إلى أحرف {{limit}}.",+ "response_code": "رمز الاستجابة",+ "url": "Destination URL"+ },+ "detail_sheet_title": "تفاصيل التسليم",+ "empty": "لم يتم تسليم أي شحنات حتى الآن — أرسل اختبارًا للتحقق من نقطة النهاية الخاصة بك.",+ "redeliver_queued": "إعادة التسليم في قائمة الانتظار.",+ "search_placeholder": "البحث حسب اسم الحدث…",+ "status": {+ "error": "خطأ",+ "failure": "فشل",+ "pending": "قيد الانتظار",+ "success": "نجحت"+ },+ "table": {+ "code": "إجابة",+ "delivered_at": "تم التسليم في",+ "event": "حدث",+ "execution_time": "مدة"+ },+ "test_failed": "فشل إرسال الرد التلقائي على الويب للاختبار.",+ "test_sent": "اختبار الرد التلقائي على الويب في قائمة الانتظار."},- "table": {- "url": "URL",- "events": "Events",- "recent_deliveries": "آخر 7 أيام",- "last_delivery": "التسليم الأخير",- "copy_url_aria": "نسخ URL"+ "deliveries_sheet_title": "التسليمات الأخيرة",+ "detail": {+ "delete_label": "حذف نقطة النهاية",+ "details_title": "تفاصيل",+ "edit_title": "تحرير نقطة النهاية",+ "load_failed_title": "تعذر تحميل نقطة نهاية الرد التلقائي على الويب هذه",+ "subscriptions": "Events",+ "url": "Destination URL"},- "events_all": "جميع الأحداث",- "events_count_one": "حدث {{count}}",- "events_count_other": "{{count}} الأحداث",- "events_custom_input_placeholder": "custom.event_name",- "events_remove_aria": "إزالة {{event}}",+ "edit_sheet_title": "تحرير نقطة نهاية خطاف الويب",+ "empty_description": "قم بإنشاء نقطة نهاية لتلقي POST موقعة في كل مرة يتم فيها تشغيل حدث مشترك.",+ "empty_title": "لا توجد نقاط نهاية لخطاف الويب حتى الآن","event_groups": {"asset": "Asset","custom": "Custom","customer": "العميل","digital": "Digital",+ "fulfillment": "التنفيذ","gift_card": "بطاقة هدية","gift_card_batch": "Gift card batch","import_export": "Import / Export",@@ -1561,7 +2133,6 @@"refund": "استرداد","report": "تقرير","return": "يعود",- "shipment": "شحنة","stock_item": "عنصر المخزون","stock_movement": "حركة الأسهم","stock_reservation": "Stock reservation",@@ -1570,1166 +2141,716 @@"variant": "البديل","wishlist": "قائمة الرغبات"},- "deliveries": {- "table": {- "event": "حدث",- "code": "إجابة",- "execution_time": "مدة",- "delivered_at": "تم التسليم في"- },- "status": {- "pending": "قيد الانتظار",- "success": "نجحت",- "failure": "فشل",- "error": "خطأ"- },- "empty": "لم يتم تسليم أي شحنات حتى الآن — أرسل اختبارًا للتحقق من نقطة النهاية الخاصة بك.",- "search_placeholder": "البحث حسب اسم الحدث…",- "test_sent": "اختبار الرد التلقائي على الويب في قائمة الانتظار.",- "test_failed": "فشل إرسال الرد التلقائي على الويب للاختبار.",- "redeliver_queued": "إعادة التسليم في قائمة الانتظار.",- "detail_sheet_title": "تفاصيل التسليم",- "detail": {- "event": "حدث",- "url": "Destination 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": "قم بتفويض عمليات التكامل والتطبيقات للاتصال بالمسؤول API.",- "publishable_section": "مفاتيح قابلة للنشر",- "publishable_help": "المستخدمة من قبل واجهة المتجر الخاص بك. آمن للكشف في التعليمات البرمجية من جانب العميل.",- "secret_section": "مفاتيح سرية",- "secret_help": "خادم إلى خادم فقط. نطاق كل مفتاح للعمليات التي يحتاجها.",- "new_cta": "مفتاح جديد",- "empty_publishable": "لا توجد مفاتيح قابلة للنشر حتى الآن.",- "empty_secret": "لا توجد مفاتيح سرية حتى الآن.",+ "events_all": "جميع الأحداث",+ "events_count_one": "حدث {{count}}",+ "events_count_other": "{{count}} الأحداث",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "إزالة {{event}}",+ "health": {+ "auto_disabled_alert": "تم تعطيل نقطة النهاية هذه تلقائيًا بعد فشل التسليم المتكرر.",+ "degraded": "متدهورة ({{percentage}}%)",+ "disabled": "عاجز",+ "failing": "الفشل ({{percentage}}%)",+ "healthy": "صحي ({{percentage}}%)",+ "label": "صحة",+ "metric_failed": "فشل",+ "metric_successful": "ناجح",+ "metric_total": "التسليم",+ "no_deliveries": "لا يوجد تسليمات حتى الآن",+ "re_enable_cta": "إعادة التمكين",+ "row_counters_failed_one": "{{count}} فشل",+ "row_counters_failed_other": "{{count}} فشل",+ "row_counters_successful_one": "{{count}} ناجح",+ "row_counters_successful_other": "{{count}} ناجح"+ },+ "new_cta": "نقطة نهاية جديدة",+ "save_secret_description": "تحقق من توقيعات Webhook الواردة باستخدام هذا المفتاح. لن نعرضه مرة أخرى.",+ "save_secret_title": "احفظ سر التوقيع الخاص بك",+ "search_placeholder": "البحث عن طريق URL…",+ "status": {+ "disabled": "تعطيل تلقائي",+ "disabled_reason": "معطل: {{reason}}",+ "inactive": "غير نشط"+ },+ "subtitle": "اشترك في نقاط النهاية HTTPS للأحداث التي يطلقها متجرك.","table": {- "key": "Key",- "scopes": "Scopes",- "last_used_at": "آخر استخدام",- "channel": "Channel",- "all_channels": "All channels"+ "copy_url_aria": "نسخ URL",+ "events": "Events",+ "last_delivery": "التسليم الأخير",+ "recent_deliveries": "آخر 7 أيام",+ "url": "URL"},- "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": "تحرير فئة الضريبة"+ "title": "Webhooks"+ }+ },+ "staff": {+ "actions": {+ "remove": "إزالة من الموظفين",+ "resend": "إعادة الإرسال"},- "markets": {- "add_sheet_title": "أضف السوق",- "edit_sheet_title": "تحرير السوق"+ "edit_sheet": {+ "title": "تحرير زميله"},- "custom_field_definitions": {- "add_sheet_title": "أضف الحقل custom",- "edit_sheet_title": "قم بتحرير الحقل custom"+ "empty": "لا يوجد موظفين بعد",+ "empty_description": "قم بدعوة زميل في الفريق للتعاون في هذا المتجر.",+ "invitations_section": "الدعوات المعلقة",+ "invite_cta": "دعوة زميله",+ "invite_sheet": {+ "description": "سنرسل إليهم رابطًا عبر البريد الإلكتروني لتعيين كلمة المرور الخاصة بهم.",+ "title": "دعوة زميله"},- "stock_locations": {- "add_sheet_title": "إضافة موقع المخزون",- "edit_sheet_title": "تحرير موقع المخزون",- "search_placeholder": "البحث عن مواقع المخزون…"+ "members_section": "أعضاء",+ "messages": {+ "removed": "تمت إزالته من الموظفين",+ "revoked": "تم إلغاء الدعوة",+ "updated": "تم تحديث الموظفين"},- "allowed_origins": {- "add_sheet_title": "أضف الأصل المسموح به",- "edit_sheet_title": "تحرير الأصل المسموح به"+ "subtitle": "إدارة زملاء الفريق الإداري والأدوار",+ "table": {+ "member": "عضو",+ "role": "دور",+ "roles": "الأدوار"},- "imports": {- "title": "عمليات الاستيراد",- "search_placeholder": "البحث بالرقم…",- "empty_title": "لا توجد عمليات استيراد بعد",- "table": {- "number": "الرقم",- "type": "النوع",- "status": "الحالة",- "rows": "الصفوف",- "failed_count": "{{failed}} فشلت"- },- "delete_confirm": {- "title": "حذف الاستيراد؟",- "message": "سيؤدي هذا إلى إزالة {{number}} وصفوفه والملف المرفوع."- }- }- },- "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": "Void"- },- "sheet": {- "create_description": "قم بإصدار بطاقة هدايا واحدة أو إنشاء دفعة باستخدام الرموز التي يتم إنشاؤها تلقائيًا.",- "edit_description": "حدّث عميل بطاقة الهدايا أو تاريخ انتهائها. الرمز والمبلغ غير قابلين للتغيير بعد الإصدار."- },- "delete_confirm": {- "title": "هل تريد حذف بطاقة الهدايا؟",- "message": "سيؤدي هذا إلى إبطال بطاقة الهدايا ومنع استردادها."- },- "validation": {- "amount_positive": "يجب أن يكون المبلغ أكبر من الصفر",- "amount_required": "المبلغ مطلوب",- "prefix_required": "البادئة مطلوبة للدفعات",- "currency_required": "Currency مطلوب"- },- "prefix": {- "label": "بادئة",- "placeholder": "e.g. WELCOME — codes will be WELCOME-abc123",- "auto_placeholder": "Auto-generated when blank"- },- "no_customer": "لا يوجد عميل مرتبط",- "usage": {- "title": "الاستخدام",- "used": "مستخدم",- "remaining": "متبقي",- "issued_by": "صادرة عن"- }- }- },- "profile": {- "title": "الملف الشخصي",- "subtitle": "إدارة بياناتك الشخصية ولغة الإدارة.",- "personal_details": "البيانات الشخصية",- "load_failed_title": "تعذر تحميل ملفك الشخصي"- },- "getting_started": {- "title": "البدء",- "description": "أكمل هذه الخطوات لإطلاق متجرك.",- "progress": "اكتمل {{done}} من {{total}}",- "tasks": {- "setup_payment_method": {- "title": "إعداد طرق الدفع",- "description": "لاستلام المدفوعات، قم بإعداد مزود دفع إلكتروني واحد على الأقل.",- "cta": "إعداد المدفوعات"- },- "add_products": {- "title": "إضافة المنتجات",- "description": "أضف منتجات إلى متجرك — منتجاتك الخاصة أو ادعُ بائعين خارجيين للبيع معًا.",- "cta": "إضافة المنتجات",- "import_cta": "استيراد المنتجات من CSV"- },- "set_customer_support_email": {- "title": "تعيين البريد الإلكتروني لدعم العملاء",- "description": "يظهر في متجرك كنقطة اتصال لأسئلة العملاء والدعم.",- "cta": "إعدادات البريد الإلكتروني"- },- "setup_taxes_collection": {- "title": "إعداد تحصيل الضرائب",- "description": "لتحصيل الضرائب، قم بإعداد معدلات الضرائب.",- "cta": "إعدادات الضرائب"- },- "setup_storefront": {- "title": "إعداد المتجر",- "description": "اربط متجرك الإلكتروني أو تطبيقك للجوال باستخدام بيانات اعتماد Store API واحفظ عنوان URL لمتجرك.",- "cta": "ربط المتجر"- }- },- "storefront_sheet": {- "title": "اربط متجرك",- "description": "استخدم بيانات الاعتماد هذه في أي عميل يتواصل مع Store API — متجر ويب أو تطبيق جوال أو أي شيء آخر.",- "api_url_label": "عنوان URL لـ Store API",- "publishable_key_label": "مفتاح API القابل للنشر",- "deploy_title": "موصى به: انشر متجر Next.js الرسمي",- "deploy_copy": "يستنسخ النشر المتجر مفتوح المصدر إلى حساب Git الخاص بك ويبنيه على Vercel مع تعبئة بيانات الاعتماد مسبقًا. بعد الانتهاء، انسخ عنوان URL الخاص به في الحقل أدناه.",- "deploy_button": "النشر على Vercel",- "env_description": "عنوان URL لـ Spree Store API ومفتاحك القابل للنشر. كلاهما معبأ مسبقًا من متجرك — عدّلهما قبل النشر إذا لزم الأمر.",- "storefront_url_label": "عنوان URL للمتجر",- "storefront_url_help": "عنوان URL الذي يستخدمه العملاء للوصول إلى متجرك. يصبح الأساس للروابط في رسائل البريد الإلكتروني للعملاء ويُضاف تلقائيًا كأصل مسموح به حتى تتمكن المتاجر المستندة إلى المتصفح من استدعاء Store API.",- "save": "احفظ وأكمل الإعداد",- "saved": "تم حفظ عنوان URL للمتجر: {{url}}",- "invalid_url": "لا يبدو هذا عنوان URL صالحًا للمتجر.",- "see_online_demo": "شاهد العرض التوضيحي عبر الإنترنت",- "local_installation_instructions": "تعليمات التثبيت المحلي",- "key_error": "تعذر تحميل مفتاح API القابل للنشر.",- "storefront_url_placeholder": "https://myshop.com"- }- }- },- "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": "Sign in & accept",- "create_and_accept": "Create account & 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": "الإجراءات",- "validation": {- "role_required": "اختر دورًا",- "roles_required": "اختر دورًا واحدًا على الأقل"- }- },- "api_keys": {- "empty_description": "قم بإنشاء واحدة للبدء.",- "create_sheet_title": "قم بإنشاء مفتاح API",- "create_sheet_description": "اختر نوع المفتاح، ثم اختر النطاقات التي يمكنه استخدامها.",- "edit_sheet_title": "تحرير مفتاح API",- "edit_sheet_description": "إعادة تسمية هذا المفتاح. يتم إصلاح Scopes عند إنشاء مفتاح ولا يمكن تغييره.",- "scopes_immutable_help": "Scopes لا يمكن تغييره بعد إنشاء المفتاح. لتغييرها، قم بإنشاء مفتاح جديد بالنطاقات التي تحتاجها وقم بإبطال هذا المفتاح.",- "key_type": {- "secret_title": "المفتاح السري",- "secret_description": "خادم إلى خادم. يحمل كل مفتاح قائمة واضحة من النطاقات.",- "publishable_title": "مفتاح قابل للنشر",- "publishable_description": "آمن للكشف في التعليمات البرمجية من جانب العميل. يمنح وصول الجمهور/الضيف."- },- "scope_picker": {- "resource_header": "الموارد",- "read_header": "يقرأ",- "write_header": "يكتب",- "read_aria": "إقرأ {{resource}}",- "write_aria": "اكتب {{resource}}",- "full_access_label": "Full access (write_all)",- "read_all_label": "Read all (read_all)",- "resources": {- "orders": "طلبات",- "products": "منتجات",- "promotions": "الترقيات",- "customers": "العملاء",- "payments": "المدفوعات",- "fulfillments": "Fulfillments",- "refunds": "المبالغ المستردة",- "gift_cards": "بطاقات الهدايا",- "store_credits": "Store credits",- "stock": "مخزون",- "categories": "فئات",- "settings": "إعدادات",- "webhooks": "Webhooks",- "api_keys": "API مفاتيح",- "dashboard": "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": "أي تكامل يستخدم هذا المفتاح سوف يتوقف عن العمل على الفور."+ "title": "طاقم عمل"+ }+ },+ "payment_methods": {+ "add_cta": "أضف طريقة الدفع",+ "columns": {+ "storefront": "Storefront"},+ "create_description": "اختر موفرًا وقم بتكوين بيانات الاعتماد الخاصة به.",+ "create_label": "إنشاء طريقة الدفع","delete_confirm": {- "title": "هل تريد حذف المفتاح؟",- "message": "يؤدي هذا إلى إزالة المفتاح بشكل دائم. تفضل الإلغاء إذا كان بإمكانك استعادة الوصول لاحقًا."+ "message": "{{name}} لن يكون متاحًا عند الخروج.",+ "title": "هل تريد حذف طريقة الدفع؟"},- "dropdown": {- "revoke": "إبطال المفتاح",- "copy_token_aria": "نسخ الرمز المميز"+ "edit_description": "تحديث الاسم أو الرؤية أو الحالة.",+ "empty": "لم يتم تكوين طرق الدفع",+ "messages": {+ "created": "تم إنشاء طريقة الدفع",+ "deleted": "تم حذف طريقة الدفع",+ "updated": "تم تحديث طريقة الدفع"},- "badge": {- "revoked": "تم إبطاله",- "never_used": "Never"+ "provider_description": "Provider: {{provider}}",+ "search_placeholder": "البحث بالاسم…",+ "status": {+ "disabled": "عاجز"},- "errors": {- "failed_to_delete": "فشل في حذف المفتاح",- "failed_to_update": "فشل في تحديث المفتاح",- "failed_to_create": "فشل في إنشاء المفتاح"+ "storefront": {+ "admin_only": "Admin only",+ "visible": "مرئي"},- "by_email": "بواسطة {{email}}",- "create_key_cta": "إنشاء مفتاح",- "validation": {- "scope_required": "اختر نطاقًا واحدًا على الأقل"- }+ "title": "Payment Methods"},- "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}}. Custom لا يتم حذف الأعضاء في هذه المجموعة."- }- },- "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": "Store credit",- "empty": "لم يتم إصدار اعتمادات المتجر",- "table": {- "used": "مستخدم",- "remaining": "متبقي",- "category": "فئة",- "memo": "Memo"- },- "delete_confirm_message": "هل تريد حذف رصيد المتجر هذا؟",- "edit_description": "اضبط المبلغ أو الفئة أو المذكرة. لا يمكن تعديل الرصيد المستخدم.",- "add_description": "قم بإصدار رصيد المتجر إلى حساب العميل هذا."- },- "groups": {- "title": "مجموعات العملاء",- "empty": "ليس في أي مجموعة",- "edit_title": "تعديل مجموعات العملاء",- "edit_description": "أضف أو أزل المجموعات التي ينتمي إليها هذا العميل.",- "save_failed": "فشل تحديث مجموعات العملاء"- }- },- "new_sheet_description": "العملاء الذين تم إنشاؤهم هنا لم يتم تعيين كلمة مرور لهم. سيحصلون على رابط سحري عند تسجيل الدخول لأول مرة.",- "autocomplete": {- "placeholder": "البحث عن العملاء…",- "empty": "لا يوجد عملاء مطابقون"- }+ "preferences": {+ "additional_item": "Additional Item Cost",+ "amount": "كمية",+ "base_amount": "Base Amount",+ "base_percent": "Base Percent",+ "currency": "Currency",+ "discount_amount": "Discount Amount",+ "first_item": "First Item Cost",+ "flat_percent": "Flat Percent",+ "max_items": "Max Items",+ "max_quantity": "الحد الأقصى للكمية",+ "min_quantity": "الحد الأدنى للكمية",+ "minimal_amount": "Minimal Amount",+ "normal_amount": "Normal Amount",+ "percent": "نسبة مئوية",+ "preferred_amount": "كمية",+ "preferred_percent": "نسبة مئوية"},- "orders": {- "table": {- "search_placeholder": "أوامر البحث…",- "empty": "لم يتم العثور على أي أوامر"- },+ "products": {+ "category_search_placeholder": "فئات البحث…","columns": {- "number": "رقم",- "date": "تاريخ",- "customer": "العميل",- "payment": "قسط",- "fulfillment": "Fulfillment",- "items": "أغراض",- "tags": "Tags",+ "in_stock": "In Stock",+ "price": "سعر","sku": "SKU"},- "item_count_one": "{{count}} البند",- "item_count_other": "{{count}} العناصر",- "statuses": {- "draft": "مسودة",- "placed": "وضعت",- "canceled": "تم الإلغاء"- },- "payment_statuses": {- "balance_due": "الرصيد المستحق",- "credit_owed": "الائتمان المستحق",- "failed": "فشل",- "paid": "مدفوع",- "void": "Void"+ "delete_confirm": "هل أنت متأكد أنك تريد حذف هذا المنتج؟",+ "delete_label": "حذف المنتج",+ "inventory": {+ "backorder_aria": "السماح بالطلب المؤجل عند {{location}}",+ "columns": {+ "backorder": "طلب متأخر",+ "location": "موقع",+ "on_hand": "في متناول اليد"+ },+ "empty_no_locations": "أضف موقع المخزون في الإعدادات لبدء تتبع المخزون.",+ "empty_no_variants": "تتم إدارة مستويات المخزون لكل موقع المخزون. أضف متغيرًا لبدء تتبع المخزون.",+ "on_hand_aria": "في متناول اليد في {{location}}",+ "unknown_location": "موقع غير معروف"},- "fulfillment_statuses": {- "backorder": "طلب متأخر",- "canceled": "تم الإلغاء",- "partial": "جزئي",- "pending": "قيد الانتظار",- "ready": "مستعد",- "fulfilled": "تم الوفاء به"+ "media": {+ "assigned_variants_help": "اختر المتغيرات التي تمثلها هذه الصورة. اتركه فارغًا ليتم تطبيقه على كافة المتغيرات.",+ "assigned_variants_label": "المتغيرات المخصصة",+ "delete_confirm": "هل تريد حذف هذه الوسائط؟ لا يمكن التراجع عن هذا.",+ "drop_hint": "قم بسحب وإفلات الوسائط هنا، أو انقر للتصفح",+ "edit_title": "تحرير الوسائط",+ "file_types_hint": "PNG، JPG، WebP حتى 10 ميغابايت",+ "upload_failed": "فشل تحميل {{name}}: {{message}}",+ "upload_status_failed": "فشل"},- "new": {- "use_default_addresses": "استخدم عناوين الفواتير والشحن الافتراضية لـ العميل",- "add_variant": "إضافة البديل",- "items_table": {- "variant": "البديل",- "sku": "SKU",- "qty": "الكمية"+ "no_categories_found": "لم يتم العثور على فئات",+ "options": {+ "add_cta": "إضافة نوع الخيار",+ "count_one": "قيمة {{count}}",+ "count_other": "{{count}} القيم",+ "create_description": "حدد خيارًا يمكن للمتغيرات استخدامه (مثل الحجم واللون).",+ "create_label": "إنشاء نوع الخيار",+ "delete_confirm": {+ "message": "سيؤدي هذا أيضًا إلى حذف جميع قيمه. ستفقدها المتغيرات التي تستخدم هذه القيم.",+ "title": "هل تريد حذف نوع الخيار؟"},- "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": "Void هذه الدفعة؟",- "remove_gift_card_message": "هل تريد إزالة بطاقة الهدايا هذه من الطلب؟",- "remove_store_credit_message": "هل تريد إزالة رصيد المتجر من الطلب؟"+ "edit_description": "تحرير نوع الخيار وقيمه.",+ "image_upload_failed": "فشل تحميل الصورة",+ "kinds": {+ "buttons": "Buttons",+ "color_swatch": "Color swatch",+ "dropdown": "Dropdown"},- "dropdown": {- "complete_order": "Complete Order",- "preview_order": "Preview Order",- "resend_confirmation": "Resend Confirmation",- "edit_quantity": "Edit Quantity",- "cancel_shipment": "Cancel Shipment",- "void_payment": "Void Payment"+ "value_label_placeholder": "e.g. Small",+ "value_name_placeholder": "e.g. small",+ "values_help": "اسحب القيم لإعادة ترتيبها. القيمة الأولى هي القيمة الافتراضية للمتغيرات الجديدة."+ },+ "price_lists": {+ "errors": {+ "failed_to_activate": "فشل تفعيل قائمة الأسعار",+ "failed_to_deactivate": "فشل في إلغاء تنشيط قائمة الأسعار"},"messages": {- "canceled": "تم إلغاء الطلب",- "completed": "اكتمل الطلب",- "approved": "تمت الموافقة على الطلب",- "resumed": "تم استئناف الطلب",- "shipped": "Fulfillment تم الشحن",- "captured": "القبض على الدفع",- "voided": "تم إلغاء الدفع",- "confirmation_sent": "تم إرسال التأكيد"- },- "errors": {- "cancel_failed": "فشل في إلغاء الطلب",- "complete_failed": "فشل في إكمال الطلب",- "approve_failed": "فشلت الموافقة على الطلب",- "resume_failed": "فشل في استئناف الطلب",- "confirmation_send_failed": "فشل في إرسال التأكيد"+ "activated": "تم تفعيل قائمة الأسعار",+ "created": "تم إنشاء قائمة الأسعار",+ "deactivated": "تم إلغاء تفعيل قائمة الأسعار",+ "deleted": "تم حذف قائمة الأسعار",+ "updated": "تم تحديث قائمة الأسعار"},- "variant_search": {- "description": "ابحث عن متغير منتج لإضافته إلى هذا الطلب.",- "label": "متغير البحث",- "empty": "لم يتم العثور على متغيرات",- "sku_prefix": "SKU",- "placeholder": "اكتب اسم المنتج أو SKU (3 أحرف على الأقل)…"+ "validation": {+ "ends_after_starts": "يجب أن يكون بعد تاريخ البدء."+ }+ },+ "save_label": "حفظ المنتج",+ "seo": {+ "meta_description_placeholder": "SEO description",+ "meta_title_placeholder": "SEO title",+ "slug_placeholder": "product-url-handle"+ },+ "tax_category_placeholder": "Select tax category",+ "transfers": {+ "create_description": "انقل المخزون بين المواقع، أو احصل على مخزون جديد من بائع خارجي.",+ "delete_confirm": {+ "message": "سيتم عكس حركات المخزون الناتجة عن هذا النقل.",+ "title": "هل تريد حذف هذا النقل؟"},- "edit_quantity": {- "title": "Edit Quantity",- "description": "قم بتعيين الكمية لهذا البند."+ "destination_placeholder": "حدد موقع الوجهة",+ "details_card": "تفاصيل",+ "different_locations_error": "يجب أن يختلف المصدر والوجهة.",+ "external_label": "خارجي (استلام البائع)",+ "fields": {+ "created": "مخلوق",+ "external_receive": "استلام خارجي",+ "immutable_note": "عمليات نقل المخزون غير قابلة للتغيير بمجرد إنشائها.",+ "internal": "داخلي",+ "reference": "مرجع",+ "type": "يكتب"},"items_table": {- "item": "غرض",- "price": "سعر",- "qty": "الكمية"- },- "tracking": {- "label": "Tracking الرقم",- "description": "قم بتحديث رقم التتبع لهذه الشحنة.",- "prefix": "Tracking",- "shipped_prefix": "تم الشحن",- "edit_title": "Edit Tracking",- "add_title": "Add Tracking"+ "qty": "الكمية",+ "sku": "SKU",+ "variant": "البديل"},- "payments_table": {- "number": "رقم",- "method": "طريقة",- "state": "ولاية"+ "new_cta": "نقل جديد",+ "reference_label": "مرجع",+ "reference_placeholder": "رقم أمر الشراء، فاتورة البائع،…",+ "review_description": "قم بمراجعة النقل قبل الإنشاء. لا يمكن تغيير العناصر بعد ذلك.",+ "search_items_placeholder": "البحث بالاسم أو SKU (3+ أحرف) …"+ },+ "variant_media_picker": {+ "add_count_one": "إضافة {{count}}",+ "add_count_other": "إضافة {{count}}",+ "empty_all_linked": "جميع وسائط المنتج مرتبطة بالفعل بهذا المتغير.",+ "empty_no_media": "لا توجد وسائط للمنتج بعد — ارفع الصور على المنتج أولاً.",+ "title": "اختر من معرض المنتج",+ "trigger": "اختر من معرض المنتج"+ },+ "variants": {+ "add_option": "إضافة خيار",+ "create_option_type": "إنشاء نوع خيار جديد",+ "create_option_type_title": "نوع خيار جديد",+ "create_value": "قيمة جديدة",+ "create_value_title": "قيمة الخيار الجديدة",+ "default_variant": "البديل الافتراضي",+ "edit_row_aria": "تحرير {{name}}",+ "edit_variant": "تعديل المتغير — {{name}}",+ "errors": {+ "failed_to_create_option_type": "فشل إنشاء نوع الخيار",+ "failed_to_create_value": "فشل إنشاء القيمة"},- "payment_form": {- "description": "تحصيل رسوم من طريقة الدفع مقابل هذا الطلب.",- "method_label": "طريقة الدفع",- "method_placeholder": "اختر طريقة الدفع",- "source_label": "مصدر",- "amount_help": "اتركه فارغًا لتقصير الرصيد المستحق.",- "capture_immediately": "التقط على الفور",- "title": "Add Payment",- "source_requires_customer": "تتطلب طريقة الدفع هذه مصدرًا محفوظًا. قم بتعيين العميل للطلب أولاً.",- "no_saved_cards": "العميل ليس لديه بطاقات محفوظة لطريقة الدفع هذه.",- "source_placeholder": "اختر بطاقة محفوظة…"+ "keep": "احتفظ بالكل",+ "option_type_label": "نوع الخيار",+ "option_type_placeholder": "اختر نوع الخيار",+ "orphan_warning": "{{count}} ستتم إزالة المتغيرات الموجودة عند الحفظ:",+ "orphan_warning_one": "{{count}} المتغير الحالي لم يعد يطابق الخيارات المحددة وستتم إزالته عند الحفظ:",+ "orphan_warning_other": "{{count}} متغيرات الحالية لم تعد تتطابق مع الخيارات المحددة وستتم إزالتها عند الحفظ:",+ "remove_row_aria": "إزالة {{name}}",+ "sheet": {+ "availability": "التوفر",+ "identity": "هوية",+ "tax_category_placeholder": "ترث من المنتج"},- "summary": {- "canceled_at": "تم الإلغاء عند",- "canceler": "إلغاء",- "approved_by": "تمت الموافقة عليه من قبل",- "promotions": "الترقيات",- "adjustments": "التعديلات",- "tax_included": "الضريبة (متضمنة)",- "tax_additional": "الضريبة (الإضافية)",- "payment_total": "إجمالي الدفع",- "outstanding_balance": "رصيد متميز"+ "title": "المتغيرات",+ "variant_label": "البديل"+ }+ },+ "promotions": {+ "action_edit": {+ "description": "قم بتكوين معلمات الإجراء.",+ "no_options": "لا يحتوي هذا الإجراء على خيارات قابلة للتكوين."+ },+ "action_picker": {+ "description": "اختر ما يجب أن يحدث عندما يصبح العرض الترويجي مؤهلاً.",+ "title": "أضف الإجراء"+ },+ "action_summary": {+ "variant_count": "{{count}} متغيرات"+ },+ "action_types": {+ "create_adjustment": {+ "description": "يقوم بإنشاء تعديل ائتمان ترويجي على الأمر",+ "name": "إنشاء تعديل الطلب بالكامل"},- "gift_card_section": {- "title": "Gift Card & Store Credit",- "gift_card_label": "بطاقة هدية",- "store_credit_label": "Store credit",- "none_applied": "لم يتم تطبيق أي شيء",- "applied_suffix": "مُطبَّق",- "apply_balance": "قم بتطبيق الرصيد المتاح لـ العميل",- "requires_customer": "يتطلب العميل",- "apply_dialog_title": "Apply Gift Card",- "apply_dialog_description": "أدخل رمز بطاقة الهدايا لتطبيقه على هذا الطلب.",- "code_placeholder": "GIFT-XXXX-YYYY"+ "create_item_adjustments": {+ "description": "إنشاء تسوية رصيد ترويجي على أحد البنود",+ "name": "إنشاء تعديل لكل بند"},- "address_edit": {- "shipping_title": "تحرير عنوان الشحن",- "billing_title": "تحرير عنوان الفواتير"+ "create_line_items": {+ "description": "تعبئة سلة التسوق بالكمية المحددة من المتغير",+ "name": "إنشاء عناصر سطرية"},- "no_customer": "لا توجد معلومات العميل",- "section_customer_note": "Special Instructions",- "section_internal_note": "Internal Note",- "completed_prefix": "مكتمل",- "add_line_item": {- "title": "Add Line Item"+ "free_shipping": {+ "description": "يجعل جميع الشحنات للطلب مجانية",+ "name": "ًالشحن مجانا"+ }+ },+ "actions_card": {+ "add_action": "أضف الإجراء",+ "description": "ماذا يحدث عندما يصبح العرض الترويجي مؤهلاً؟",+ "empty": "لا توجد إجراءات حتى الآن. الترويج بدون إجراءات لا يفعل أي شيء عند تطبيقه."+ },+ "basics_card": {+ "title": "الأساسيات"+ },+ "code": {+ "automatic": "تلقائي",+ "multi": "multi"+ },+ "coupon_codes": {+ "description": "الرموز التي تم إنشاؤها تلقائيًا لهذا العرض الترويجي. للقراءة فقط — قم بالتجديد عن طريق تغيير إعداد عدد الرموز الخاصة بالحملة الترويجية.",+ "description_with_count": "{{count}} رمزًا مُنشأًا تلقائيًا. للقراءة فقط — أعد الإنشاء بتغيير إعداد عدد الرموز في العرض.",+ "empty": "لم يتم إنشاء رموز حتى الآن.",+ "export_csv": "تصدير CSV",+ "states": {+ "partially_used": "تستخدم جزئيا",+ "used": "مستخدم"},- "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 حتى 10 ميغابايت",- "edit_title": "تحرير الوسائط",- "assigned_variants_label": "المتغيرات المخصصة",- "assigned_variants_help": "اختر المتغيرات التي تمثلها هذه الصورة. اتركه فارغًا ليتم تطبيقه على كافة المتغيرات.",- "upload_failed": "فشل تحميل {{name}}: {{message}}",- "upload_status_failed": "فشل"+ "title": "رموز القسيمة",+ "unused": "غير مستخدمة",+ "used": "مستخدم"+ },+ "delete_confirm": {+ "default_name": "هذا الترويج",+ "message": "ستتم إزالة {{name}} نهائيًا. لا يمكن حذف العروض الترويجية المشار إليها بواسطة الطلبات المكتملة.",+ "title": "هل تريد حذف العرض الترويجي؟"+ },+ "errors": {+ "failed_to_add_action": "فشلت إضافة الإجراء",+ "failed_to_add_rule": "فشلت إضافة القاعدة",+ "failed_to_remove_action": "فشل في إزالة الإجراء",+ "failed_to_remove_rule": "فشلت إزالة القاعدة",+ "failed_to_update_action": "فشل تحديث الإجراء",+ "failed_to_update_rule": "فشل تحديث القاعدة"+ },+ "generate_code": {+ "title": "إنشاء رمز عشوائي"+ },+ "kinds": {+ "automatic": "تلقائي (بدون رمز)",+ "coupon_code": "رمز القسيمة"+ },+ "match_policies": {+ "all": "يجب أن تتطابق جميع القواعد",+ "all_hint": "يجب أن تتطابق جميع القواعد.",+ "any": "قد تتطابق أي قاعدة",+ "any_hint": "قد تتطابق أي قاعدة."+ },+ "messages": {+ "action_added": "تمت إضافة الإجراء",+ "action_removed": "تمت إزالة الإجراء",+ "action_updated": "تم تحديث الإجراء",+ "rule_added": "تمت إضافة القاعدة",+ "rule_removed": "تمت إزالة القاعدة",+ "rule_updated": "تم تحديث القاعدة"+ },+ "remove_action_confirm": {+ "message": "تمت إزالته عند حفظ العرض الترويجي.",+ "title": "هل تريد إزالة الإجراء؟"+ },+ "remove_rule_confirm": {+ "message": "تمت إزالته عند حفظ العرض الترويجي.",+ "title": "هل تريد إزالة القاعدة؟"+ },+ "rule_edit": {+ "description": "ضبط معلمات القاعدة.",+ "no_options": "لا تحتوي هذه القاعدة على خيارات قابلة للتكوين، فوجودها وحده يطبق القيد."},- "seo": {- "slug_placeholder": "product-url-handle",- "meta_title_placeholder": "SEO title",- "meta_description_placeholder": "SEO description"+ "rule_picker": {+ "description": "اختر نوع القاعدة لتكوينه.",+ "title": "أضف القاعدة"},- "tax_category_placeholder": "Select tax category",- "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": "الكمية"+ "rule_summary": {+ "category_count": "{{count}} فئات",+ "customer_count": "{{count}} عملاء",+ "product_count": "{{count}} منتجات"+ },+ "rule_types": {+ "category": {+ "description": "يتضمن الطلب منتجات في فئات محددة",+ "name": "فئات"},- "delete_confirm": {- "title": "هل تريد حذف هذا النقل؟",- "message": "سيتم عكس حركات المخزون الناتجة عن هذا النقل."+ "country": {+ "description": "يقتصر على الطلبات التي لها عنوان شحن في بلد معين",+ "name": "دولة"},- "review_description": "قم بمراجعة النقل قبل الإنشاء. لا يمكن تغيير العناصر بعد ذلك.",- "details_card": "تفاصيل",- "fields": {- "type": "يكتب",- "internal": "داخلي",- "external_receive": "استلام خارجي",- "reference": "مرجع",- "created": "مخلوق",- "immutable_note": "عمليات نقل المخزون غير قابلة للتغيير بمجرد إنشائها."- }- },- "options": {- "kinds": {- "dropdown": "Dropdown",- "color_swatch": "Color swatch",- "buttons": "Buttons"+ "currency": {+ "description": "الحد من الطلبات بعملة معينة",+ "name": "Currency"},- "add_cta": "إضافة نوع الخيار",- "create_label": "إنشاء نوع الخيار",- "create_description": "حدد خيارًا يمكن للمتغيرات استخدامه (مثل الحجم واللون).",- "edit_description": "تحرير نوع الخيار وقيمه.",- "delete_confirm": {- "title": "هل تريد حذف نوع الخيار؟",- "message": "سيؤدي هذا أيضًا إلى حذف جميع قيمه. ستفقدها المتغيرات التي تستخدم هذه القيم."+ "customer": {+ "description": "متاح فقط للعملاء المحددين",+ "name": "العملاء"},- "values_help": "اسحب القيم لإعادة ترتيبها. القيمة الأولى هي القيمة الافتراضية للمتغيرات الجديدة.",- "count_one": "قيمة {{count}}",- "count_other": "{{count}} القيم",- "value_name_placeholder": "e.g. small",- "value_label_placeholder": "e.g. 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": "هوية",- "availability": "التوفر",- "tax_category_placeholder": "ترث من المنتج"+ "customer_group": {+ "description": "متاح فقط للعملاء في مجموعة (مجموعات) العملاء المحددة",+ "name": "العميل Group(s)"},- "errors": {- "failed_to_create_value": "فشل إنشاء القيمة",- "failed_to_create_option_type": "فشل إنشاء نوع الخيار"+ "customer_logged_in": {+ "description": "متاح فقط للأشخاص الذين قاموا بتسجيل الدخول custom",+ "name": "الأشخاص الذين قاموا بتسجيل الدخول فقط custom"+ },+ "first_order": {+ "description": "يجب أن يكون الطلب الأول للعميل",+ "name": "الطلب الأول"+ },+ "item_total": {+ "description": "إجمالي الطلب يلبي هذه المعايير",+ "name": "إجمالي السلعة"+ },+ "one_use_per_user": {+ "description": "Only One Use Per User",+ "name": "One Use Per User"+ },+ "option_value": {+ "description": "يتضمن الطلب منتجات ذات قيمة (قيم) خيار متطابقة",+ "name": "Option Value(s)"+ },+ "product": {+ "description": "يتضمن الطلب منتجًا (منتجات) محددة",+ "name": "Product(s)"}},- "inventory": {- "columns": {- "location": "موقع",- "on_hand": "في متناول اليد",- "backorder": "طلب متأخر"+ "rule_types_all_used": "كل نوع قاعدة متاح موجود بالفعل في هذا العرض الترويجي.",+ "rule_types_empty": "لم يتم تسجيل أي أنواع قواعد.",+ "rules": {+ "category": {+ "empty": "لا توجد فئات متطابقة",+ "label": "فئات",+ "match_policy": {+ "all": {+ "description": "يجب أن يحتوي الطلب على منتج في كل فئة.",+ "label": "كل هذه الفئات"+ },+ "any": {+ "description": "يجب أن يحتوي الطلب على منتج واحد على الأقل.",+ "label": "أي من هذه الفئات"+ }+ },+ "search_placeholder": "فئات البحث…"},- "on_hand_aria": "في متناول اليد في {{location}}",- "backorder_aria": "السماح بالطلب المؤجل عند {{location}}",- "empty_no_locations": "أضف موقع المخزون في الإعدادات لبدء تتبع المخزون.",- "empty_no_variants": "تتم إدارة مستويات المخزون لكل موقع المخزون. أضف متغيرًا لبدء تتبع المخزون.",- "unknown_location": "موقع غير معروف"- },- "columns": {- "sku": "SKU",- "price": "سعر",- "in_stock": "In Stock"- },- "price_lists": {- "messages": {- "created": "تم إنشاء قائمة الأسعار",- "updated": "تم تحديث قائمة الأسعار",- "deleted": "تم حذف قائمة الأسعار",- "activated": "تم تفعيل قائمة الأسعار",- "deactivated": "تم إلغاء تفعيل قائمة الأسعار"+ "channel": {+ "label": "القنوات"},- "errors": {- "failed_to_activate": "فشل تفعيل قائمة الأسعار",- "failed_to_deactivate": "فشل في إلغاء تنشيط قائمة الأسعار"+ "country": {+ "empty": "لا توجد بلدان متطابقة",+ "label": "بلدان",+ "search_placeholder": "بحث عن الدول…"},- "validation": {- "ends_after_starts": "يجب أن يكون بعد تاريخ البدء."+ "customer": {+ "empty": "لا يوجد عملاء مطابقون",+ "label": "العملاء",+ "search_placeholder": "البحث عن العملاء بالاسم أو البريد…"+ },+ "customer_group": {+ "empty": "لا توجد مجموعات عملاء مطابقة",+ "label": "مجموعات العملاء",+ "search_placeholder": "البحث في مجموعات العملاء…"+ },+ "market": {+ "label": "الأسواق"+ },+ "product": {+ "empty": "لا توجد منتجات متطابقة",+ "label": "منتجات",+ "match_policy": {+ "all": {+ "description": "يجب أن يحتوي الطلب على كل منتج.",+ "label": "كل هذه المنتجات"+ },+ "any": {+ "description": "يجب أن يحتوي الطلب على واحد على الأقل.",+ "label": "أي من هذه المنتجات"+ },+ "none": {+ "description": "يجب ألا يحتوي الطلب على أي منها.",+ "label": "لا شيء من هذه المنتجات"+ }+ },+ "search_placeholder": "البحث عن المنتجات بالاسم…"}},- "variant_media_picker": {- "trigger": "اختر من معرض المنتج",- "title": "اختر من معرض المنتج",- "empty_no_media": "لا توجد وسائط للمنتج بعد — ارفع الصور على المنتج أولاً.",- "empty_all_linked": "جميع وسائط المنتج مرتبطة بالفعل بهذا المتغير.",- "add_count_one": "إضافة {{count}}",- "add_count_other": "إضافة {{count}}"- }- },- "payment_methods": {- "add_cta": "أضف طريقة الدفع",- "create_description": "اختر موفرًا وقم بتكوين بيانات الاعتماد الخاصة به.",- "edit_description": "تحديث الاسم أو الرؤية أو الحالة.",- "create_label": "إنشاء طريقة الدفع",- "provider_description": "Provider: {{provider}}",- "delete_confirm": {- "title": "هل تريد حذف طريقة الدفع؟",- "message": "{{name}} لن يكون متاحًا عند الخروج."+ "rules_card": {+ "add_rule": "أضف القاعدة",+ "description": "الشروط التي تحدد ما إذا كان سيتم تطبيق العرض الترويجي أم لا.",+ "empty": "لا توجد قواعد. بدون قواعد، يكون العرض الترويجي مؤهلًا دائمًا (يخضع للجدول الزمني وحد الاستخدام).",+ "title": "قواعد"},- "title": "Payment Methods",- "search_placeholder": "البحث بالاسم…",- "empty": "لم يتم تكوين طرق الدفع",- "columns": {- "storefront": "Storefront"+ "schedule_card": {+ "title": "الجدول الزمني والحدود"},- "storefront": {- "visible": "مرئي",- "admin_only": "Admin only"+ "table": {+ "empty": "لا يوجد ترقيات حتى الآن",+ "no_end": "لا نهاية",+ "search_placeholder": "البحث بالاسم…"},- "status": {- "disabled": "عاجز"+ "trigger_card": {+ "title": "مشغل"},- "messages": {- "created": "تم إنشاء طريقة الدفع",- "updated": "تم تحديث طريقة الدفع",- "deleted": "تم حذف طريقة الدفع"+ "trigger_summary": {+ "locked_help": "لا يمكن تغيير إعدادات المشغل بعد الإنشاء. قم بإجراء ترقية جديدة لتغييرها.",+ "multi_code": "قسيمة متعددة الرموز (أكواد {{count}})",+ "multi_code_with_prefix": "قسيمة متعددة الرموز (أكواد {{count}} مع البادئة \"{{prefix}}\")",+ "show_codes": "إظهار الرموز",+ "single_code": "رمز قسيمة واحد:"+ },+ "validation": {+ "code_required": "الرمز مطلوب (أو انقر «إنشاء»)",+ "expiry_after_start": "يجب أن يكون انتهاء الصلاحية بعد تاريخ البدء",+ "number_of_codes_required": "اختر عدد الرموز المراد إنشاؤها",+ "prefix_required": "البادئة مطلوبة لدفعات الرموز المتعددة"}},- "tax_categories": {- "add_cta": "إضافة فئة الضريبة",- "create_description": "تجميع المنتجات حسب المعاملة الضريبية (قياسية، مخفضة، معفاة،…).",- "edit_description": "قم بتحديث الاسم أو الرمز أو العلامة الافتراضية.",- "create_label": "إنشاء فئة ضريبية",- "search_placeholder": "البحث بالاسم…",- "empty": "لا توجد فئات ضريبية حتى الآن",- "delete_confirm": {- "title": "هل تريد حذف فئة الضريبة؟",- "message": "ستتم إزالة {{name}}. المنتجات في هذه الفئة تعود إلى الوضع الافتراضي."+ "settings": {+ "webhooks": {+ "errors": {+ "redeliver_failed": "تعذّرت إعادة التسليم",+ "send_test_failed": "فشل إرسال الرد التلقائي على الويب للاختبار"+ },+ "messages": {+ "removed": "تمت إزالة نقطة نهاية Webhook",+ "updated": "تم تحديث نقطة نهاية Webhook"+ }+ }+ },+ "settings_nav": {+ "groups": {+ "audit": "التدقيق",+ "fulfillment": "التنفيذ",+ "payments": "المدفوعات والضرائب",+ "store": "المتجر",+ "team": "الفريق والوصول"},- "messages": {- "created": "تم إنشاء فئة الضريبة",- "updated": "تم تحديث فئة الضريبة",- "deleted": "تم حذف فئة الضريبة"+ "items": {+ "allowed_origins": "المصادر المسموح بها",+ "api_keys": "مفاتيح API",+ "channels": "قنوات البيع",+ "custom_field_definitions": "الحقول المخصصة",+ "delivery_methods": "طرق التوصيل",+ "delivery_zones": "مناطق التوصيل",+ "emails": "البريد الإلكتروني",+ "imports": "عمليات الاستيراد",+ "markets": "الأسواق",+ "payment_methods": "طرق الدفع",+ "profile": "الملف الشخصي",+ "staff": "الموظفون",+ "stock_locations": "مواقع المخزون",+ "store": "المتجر",+ "tax_categories": "فئات الضريبة",+ "webhooks": "Webhooks"}},- "custom_field_definitions": {- "add_cta": "أضف الحقل custom",- "create_label": "قم بإنشاء حقل custom",- "create_description": "حدد حقلاً مكتوبًا يمكن لفريقك تعبئته في أي سجل مطابق.",- "edit_description": "قم بتحديث الملصق أو المفتاح أو رؤية واجهة المتجر. لا يمكن للمالك أن يتغير بمجرد وجود القيم.",- "table_title": "Custom تعريفات المجال",- "search_placeholder": "البحث حسب التسمية أو مساحة الاسم أو المفتاح…",- "empty": "لا توجد تعريفات للمجال custom حتى الآن",- "storefront_visible": {- "visible": "مرئي",- "admin_only": "Admin only"+ "staff": {+ "actions": {+ "copy_invitation_link": "انسخ رابط الدعوة",+ "invitation_link_copied": "تم نسخ رابط الدعوة"},- "delete_confirm": {- "title": "هل تريد حذف الحقل custom؟",- "message": "ستتم إزالة {{label}} مع كل قيمة مخزنة له."+ "actions_aria": "الإجراءات",+ "autocomplete": {+ "empty": "لا يوجد تطابق بين الموظفين",+ "placeholder": "البحث عن الموظفين…"},- "messages": {- "created": "تم إنشاء تعريف الحقل المخصص",- "updated": "تم تحديث تعريف الحقل المخصص",- "deleted": "تم حذف تعريف الحقل المخصص"+ "confirm": {+ "remove_message": "سيفقد {{name}} إمكانية الوصول إلى هذا المتجر.",+ "remove_title": "هل تريد الإزالة من المتجر؟",+ "revoke_message": "لن يتمكن {{email}} من قبول هذه الدعوة بعد الآن.",+ "revoke_title": "هل تريد إلغاء الدعوة؟"},- "errors": {- "failed_to_create": "فشل إنشاء تعريف الحقل المخصص",- "failed_to_update": "فشل تحديث تعريف الحقل المخصص",- "failed_to_delete": "فشل حذف تعريف الحقل المخصص"- }- },- "allowed_origins": {- "add_cta": "أضف الأصل المسموح به",- "create_label": "أضف الأصل",- "create_description": "يمكن للمتصفحات المحملة من هذا الأصل الاتصال بالمسؤول API. تعتمد كل من القائمة المسموح بها CORS وجلسة ملفات تعريف الارتباط للمشرف على هذه القائمة - أبقِها ضيقة.",- "edit_description": "يؤدي تحديث الأصل على الفور إلى تغيير من يمكنه الاتصال بالمسؤول API من المتصفح.",- "table_title": "الأصول المسموح بها",- "search_placeholder": "البحث حسب الأصل…",- "empty": "لا توجد أصول مسموح بها حتى الآن",- "validation": {- "bare_origin": "يجب أن يكون أصلًا مجردًا (على سبيل المثال https://shop.example.com) — بدون مسار أو استعلام أو جزء"+ "edit": {+ "roles_label": "أدوار لهذا المتجر"+ },+ "edit_description": "قم بتحديث تفاصيل الملف الشخصي والأدوار المعينة لهذا الموظف.",+ "errors": {+ "failed_to_remove": "فشل في إزالة الموظفين",+ "failed_to_resend": "فشلت إعادة إرسال الدعوة",+ "failed_to_revoke": "فشل في إلغاء الدعوة"},- "delete_confirm": {- "title": "هل تريد إزالة الأصل المسموح به؟",- "message": "لن يكون {{origin}} قادرًا على الاتصال بالمسؤول API من المتصفح. ولا تتأثر طلبات خادم إلى خادم الموجودة."+ "invite": {+ "email_placeholder": "[email protected]",+ "no_roles": "لا توجد أدوار متاحة.",+ "roles_loading": "جارٍ تحميل الأدوار…",+ "roles_placeholder": "حدد دورًا"},- "messages": {- "added": "تمت إضافة الأصل المسموح به",- "updated": "تم تحديث الأصل المسموح به",- "removed": "تمت إزالة الأصل المسموح به"+ "validation": {+ "role_required": "اختر دورًا",+ "roles_required": "اختر دورًا واحدًا على الأقل"}},- "stock_transfers": {- "title": "Stock Transfers",- "table": {- "search_placeholder": "البحث بالرقم أو المرجع…",- "empty": "لا يوجد تحويلات الأسهم حتى الآن"- },- "columns": {- "number": "رقم",- "direction": "اتجاه",- "reference": "مرجع"- },- "direction": {- "internal": "نقل بين المواقع",- "external_receive": "استلام خارجي"- },+ "stock_items": {"messages": {- "recorded": "تم تسجيل نقل المخزون",- "deleted": "تم حذف نقل المخزون"- },- "errors": {- "failed_to_record": "فشل في تسجيل نقل المخزون",- "failed_to_delete": "فشل في حذف نقل المخزون"+ "stock_item_deleted": "تم حذف عنصر المخزون",+ "stock_updated": "تم تحديث المخزون"}},"stock_locations": {"add_cta": "إضافة موقع المخزون",- "create_label": "إنشاء موقع المخزون",- "create_description": "أضف مستودعًا أو متجرًا أو نقطة استلام لتلبية الطلبات منها.",- "edit_description": "تحديث الاسم أو العنوان أو الالتقاط أو سياسات المخزون.",- "search_placeholder": "البحث بالاسم…",- "empty": "لا توجد مواقع المخزون حتى الآن",+ "badges": {+ "default": "تقصير",+ "enabled": "ممكّن",+ "inactive": "غير نشط"+ },"columns": {- "type": "يكتب",+ "default": "تقصير","location": "موقع","pickup": "يلتقط",- "default": "تقصير"+ "type": "يكتب"},- "badges": {- "enabled": "ممكّن",- "inactive": "غير نشط",- "default": "تقصير"+ "create_description": "أضف مستودعًا أو متجرًا أو نقطة استلام لتلبية الطلبات منها.",+ "create_label": "إنشاء موقع المخزون",+ "delete_confirm": {+ "message": "ستتم إزالة {{name}}. لا يتم حذف عناصر المخزون في هذا الموقع.",+ "title": "هل تريد حذف موقع المخزون؟"},+ "edit_description": "تحديث الاسم أو العنوان أو الالتقاط أو سياسات المخزون.",+ "empty": "لا توجد مواقع المخزون حتى الآن","kinds": {- "warehouse": "مستودع",+ "fulfillment_center": "Fulfillment center","store": "محل",- "fulfillment_center": "Fulfillment center"+ "warehouse": "مستودع"},"pickup_stock_policies": {- "local": "العناصر فقط في هذا الموقع",- "any": "السماح بالتحويلات من مواقع أخرى"- },- "delete_confirm": {- "title": "هل تريد حذف موقع المخزون؟",- "message": "ستتم إزالة {{name}}. لا يتم حذف عناصر المخزون في هذا الموقع."+ "any": "السماح بالتحويلات من مواقع أخرى",+ "local": "العناصر فقط في هذا الموقع"},+ "search_placeholder": "البحث بالاسم…","section_pickup": "يلتقط","stock_items": {- "title": "المخزون في هذا الموقع",+ "empty": "لا توجد عناصر المخزون في هذا الموقع حتى الآن.",+ "empty_search": "لا توجد عناصر مخزون تطابق بحثك.","help": "اضبط الأعداد المتاحة والقابلة للطلب الخلفي لكل متغير.",+ "low_stock_marker": "مخزون منخفض","search_placeholder": "ابحث عن SKU أو المنتج…","table": {- "variant": "البديل",+ "backorder": "طلب متأخر","on_hand": "في متناول اليد",- "backorder": "طلب متأخر"+ "variant": "البديل"},- "empty": "لا توجد عناصر المخزون في هذا الموقع حتى الآن.",- "empty_search": "لا توجد عناصر مخزون تطابق بحثك.",+ "title": "المخزون في هذا الموقع","unknown_product": "منتج غير معروف","variant_count_one": "{{count}} متغير",- "variant_count_other": "{{count}} متغيرات",- "low_stock_marker": "مخزون منخفض"+ "variant_count_other": "{{count}} متغيرات"}},+ "stock_transfers": {+ "columns": {+ "direction": "اتجاه",+ "number": "رقم",+ "reference": "مرجع"+ },+ "direction": {+ "external_receive": "استلام خارجي",+ "internal": "نقل بين المواقع"+ },+ "errors": {+ "failed_to_delete": "فشل في حذف نقل المخزون",+ "failed_to_record": "فشل في تسجيل نقل المخزون"+ },+ "messages": {+ "deleted": "تم حذف نقل المخزون",+ "recorded": "تم تسجيل نقل المخزون"+ },+ "table": {+ "empty": "لا يوجد تحويلات الأسهم حتى الآن",+ "search_placeholder": "البحث بالرقم أو المرجع…"+ },+ "title": "Stock Transfers"+ },"store": {"load_failed_title": "فشل تحميل إعدادات المتجر","unit_systems": {- "metric": "متري",- "imperial": "إمبراطوري"+ "imperial": "إمبراطوري",+ "metric": "متري"},"weight_units": {- "kg": "كيلوغرام (كجم)","g": "جرام (جم)",+ "kg": "كيلوغرام (كجم)","lb": "جنيه (رطل)","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": "كمية",- "flat_percent": "Flat 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": "كمية",- "preferred_percent": "نسبة مئوية",- "min_quantity": "الحد الأدنى للكمية",- "max_quantity": "الحد الأقصى للكمية"- },- "channels": {- "messages": {- "created": "تم إنشاء القناة",- "updated": "تم تحديث القناة",- "deleted": "تم حذف القناة"- }- },- "order_routing_rules": {- "messages": {- "created": "تمت إضافة قاعدة التوجيه",- "deleted": "تمت إزالة قاعدة التوجيه"+ "tax_categories": {+ "add_cta": "إضافة فئة الضريبة",+ "create_description": "تجميع المنتجات حسب المعاملة الضريبية (قياسية، مخفضة، معفاة،…).",+ "create_label": "إنشاء فئة ضريبية",+ "delete_confirm": {+ "message": "ستتم إزالة {{name}}. المنتجات في هذه الفئة تعود إلى الوضع الافتراضي.",+ "title": "هل تريد حذف فئة الضريبة؟"},- "types": {- "preferred_location": {- "name": "الموقع المفضل",- "description": "الشحن من الموقع المثبّت على الطلب إن وُجد"- },- "minimize_splits": {- "name": "تقليل تقسيم الشحنات",- "description": "يفضّل الموقع القادر على تلبية أكبر عدد من العناصر بمفرده لتجنّب تقسيم الشحنات"- },- "default_location": {- "name": "الموقع الافتراضي",- "description": "يفضّل موقع المخزون المحدد كافتراضي"- }- }- },- "customer_groups": {+ "edit_description": "قم بتحديث الاسم أو الرمز أو العلامة الافتراضية.",+ "empty": "لا توجد فئات ضريبية حتى الآن","messages": {- "created": "تم إنشاء مجموعة العميل",- "create_failed": "فشل إنشاء مجموعة العميل",- "updated": "تم تحديث مجموعة العميل",- "update_failed": "فشل تحديث مجموعة العميل",- "deleted": "تم حذف مجموعة العميل",- "delete_failed": "فشل حذف مجموعة العميل"+ "created": "تم إنشاء فئة الضريبة",+ "deleted": "تم حذف فئة الضريبة",+ "updated": "تم تحديث فئة الضريبة"},- "autocomplete": {- "placeholder": "ابحث عن مجموعات العميل…",- "empty": "لا توجد مجموعات العميل متطابقة"- }- },- "settings": {- "webhooks": {- "messages": {- "updated": "تم تحديث نقطة نهاية Webhook",- "removed": "تمت إزالة نقطة نهاية Webhook"- },- "errors": {- "send_test_failed": "فشل إرسال الرد التلقائي على الويب للاختبار",- "redeliver_failed": "تعذّرت إعادة التسليم"- }- }- },- "stock_items": {- "messages": {- "stock_updated": "تم تحديث المخزون",- "stock_item_deleted": "تم حذف عنصر المخزون"- }+ "search_placeholder": "البحث بالاسم…"},"translations": {- "title": "الترجمات",- "locale": "اللغة",- "source": "المصدر",- "save": "حفظ الترجمات",- "saved": "تم حفظ الترجمات",- "save_error": "تعذر حفظ الترجمات",- "no_locales": "أضف المزيد من اللغات إلى متجرك لترجمة هذا المنتج.",- "manage": "إدارة الترجمات",- "field": "الحقل","coverage_summary": "تمت ترجمة {{translated}} من {{total}} لغة","dirty_summary": "{{count}} تغيير(ات) غير محفوظة","discard_confirm": {- "title": "تجاهل التغييرات؟",- "message": "لديك {{count}} تغيير(ات) ترجمة غير محفوظة. هل تريد تجاهلها؟"+ "message": "لديك {{count}} تغيير(ات) ترجمة غير محفوظة. هل تريد تجاهلها؟",+ "title": "تجاهل التغييرات؟"},+ "field": "الحقل",+ "load_error": "تعذر تحميل الترجمات",+ "locale": "اللغة",+ "manage": "إدارة الترجمات",+ "no_locales": "أضف المزيد من اللغات إلى متجرك لترجمة هذا المنتج.","original": "الأصل",- "load_error": "تعذر تحميل الترجمات"- },- "categories": {- "title": "الفئات",- "add_cta": "فئة جديدة",- "empty": "لا توجد فئات بعد.",- "expand": "توسيع",- "collapse": "طي",- "delete_confirm": "حذف الفئة \"{{name}}\" وجميع فئاتها الفرعية؟",- "columns": {- "name": "الاسم",- "products": "المنتجات"- },- "fields": {- "parent": {- "label": "الفئة الأصل",- "placeholder": "المستوى الأعلى"- }- },- "messages": {- "created": "تم إنشاء الفئة",- "updated": "تم تحديث الفئة",- "deleted": "تم حذف الفئة",- "move_failed": "تعذّر نقل الفئة"- },- "seo": {- "title": "تحسين محركات البحث",- "preview_slug_placeholder": "category-slug"- },- "products_count_one": "منتج واحد",- "products_count_other": "{{count}} منتجات",- "search_placeholder": "البحث عن الفئات…",- "no_results": "لا توجد فئات مطابقة.",- "new_title": "فئة جديدة",- "delete_label": "حذف الفئة",- "images": {- "title": "الصور",- "label": "صورة",- "square_label": "صورة مربعة",- "help": "تُستخدم في لافتات الفئات. يُوصى بـ 1920×1080.",- "square_help": "تُستخدم في التنقل المُدمج. يُوصى بـ 400×400."- },- "navigation": {- "title": "التنقل"- },- "products": {- "title": "المنتجات",- "search_placeholder": "البحث عن المنتجات…",- "empty": "لا توجد منتجات في هذه الفئة بعد.",- "remove": "إزالة من الفئة",- "add_cta": "إضافة منتجات",- "picker_title": "إضافة منتجات إلى الفئة",- "picker_description": "ابحث وحدد المنتجات لإضافتها إلى هذه الفئة.",- "select_all": "تحديد الكل",- "select_row": "تحديد المنتج",- "remove_selected": "إزالة",- "selected_count_one": "تم تحديد {{count}}",- "selected_count_other": "تم تحديد {{count}}",- "column_product": "المنتج",- "filter_placeholder": "تصفية المنتجات…",- "no_matches": "لا توجد منتجات تطابق عامل التصفية."- },- "load_failed": "فشل تحميل الفئات. يرجى المحاولة مرة أخرى."- },- "imports": {- "download_original": "تنزيل الملف الأصلي",- "load_failed": "تعذّر تحميل الاستيراد.",- "try_again": "حاول مرة أخرى",- "wizard_title": "الاستيراد",- "steps": {- "map_fields": "مطابقة الحقول",- "process_rows": "معالجة الصفوف",- "complete": "اكتمل"- },- "status": {- "pending": "قيد الانتظار",- "mapping": "المطابقة",- "completed_mapping": "في قائمة الانتظار",- "processing": "قيد المعالجة",- "completed": "مكتمل",- "failed": "فشل"- },- "types": {- "products": "المنتجات",- "customers": "العملاء",- "product_translations": "ترجمات المنتجات"- },- "mapping": {- "title": "مطابقة الأعمدة",- "description": "طابق أعمدة ملفك مع حقول {{type}}.",- "field": "الحقل",- "file_column": "عمود الملف",- "sample": "مثال",- "not_mapped": "غير مطابق",- "required": "مطلوب",- "missing_required": "طابق الحقول المطلوبة للمتابعة: {{fields}}",- "start": "بدء الاستيراد",- "starting": "جارٍ البدء…"- },- "processing": {- "title": "جارٍ معالجة الصفوف",- "preparing": "جارٍ تجهيز الصفوف…",- "progress": "تمت معالجة {{processed}} من {{total}} صفًا",- "failed_count": "{{failed}} فشلت",- "retrying": "إعادة محاولة الصفوف الفاشلة · {{remaining}} متبقية",- "note": "يمكنك مغادرة هذه الصفحة — سيستمر الاستيراد في الخلفية."- },- "results": {- "completed_title": "اكتمل الاستيراد",- "summary": "تم استيراد {{completed}} صفًا · {{failed}} فشلت",- "retry_failed": "إعادة محاولة الصفوف الفاشلة ({{failed}})",- "retrying": "جارٍ إعادة المحاولة…",- "view_records": "عرض {{type}}"- },- "failed": {- "title": "فشل الاستيراد",- "description": "تعذّرت معالجة الملف."- },- "failed_rows": {- "next_page": "الصفحة التالية",- "prev_page": "الصفحة السابقة",- "title": "الصفوف الفاشلة",- "row_number": "الصف",- "error": "الخطأ",- "view_data": "عرض بيانات الصف",- "hide_data": "إخفاء بيانات الصف"- }+ "save": "حفظ الترجمات",+ "save_error": "تعذر حفظ الترجمات",+ "saved": "تم حفظ الترجمات",+ "source": "المصدر",+ "title": "الترجمات"}}}diff --git a/packages/dashboard/src/locales/de.json b/packages/dashboard/src/locales/de.jsonindex ba4547b6b4..70586f414a 100644--- a/packages/dashboard/src/locales/de.json+++ b/packages/dashboard/src/locales/de.json@@ -1,631 +1,839 @@{"admin": {"a11y": {- "edit_media": "Bild bearbeiten",- "delete_image": "Bild löschen"+ "delete_image": "Bild löschen",+ "edit_media": "Bild bearbeiten"},- "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"+ "allowed_origins": {+ "add_cta": "Erlaubten 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.",+ "create_label": "Ursprung hinzufügen",+ "delete_confirm": {+ "message": "{{origin}} kann die Admin-API nicht mehr von einem Browser aus aufrufen. Bestehende Server-zu-Server-Anfragen sind nicht betroffen.",+ "title": "Erlaubten Ursprung entfernen?"},+ "edit_description": "Das Aktualisieren eines Ursprungs ändert sofort, wer die Admin-API von einem Browser aus aufrufen kann.",+ "empty": "Noch keine erlaubten Ursprünge","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"- }- },- "errors": {- "not_found_title": "Seite nicht gefunden",- "not_found_description": "Die gesuchte Seite existiert nicht.",- "forbidden_title": "Nicht berechtigt",- "forbidden_description": "Sie haben keine Berechtigung, diese Seite anzuzeigen.",- "plugin_route_title": "Diese Seite konnte nicht dargestellt werden"- },- "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",- "getting_started": "Erste Schritte"- },- "settings_nav": {- "groups": {- "store": "Shop",- "payments": "Zahlungen & Steuern",- "fulfillment": "Fulfillment",- "team": "Team & Zugriff",- "audit": "Audit"+ "added": "Erlaubter Ursprung hinzugefügt",+ "removed": "Erlaubter Ursprung entfernt",+ "updated": "Erlaubter Ursprung aktualisiert"},- "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",- "imports": "Importe"+ "search_placeholder": "Nach Ursprung suchen…",+ "table_title": "Erlaubte Ursprünge",+ "validation": {+ "bare_origin": "Muss ein reiner Ursprung sein (z. B. https://shop.example.com) – ohne Pfad, Query oder Fragment"}},- "fields": {- "products_count": {- "label": "Produkte"+ "api_keys": {+ "badge": {+ "never_used": "Nie",+ "revoked": "Widerrufen"},- "prices_count": {- "label": "Preise"+ "by_email": "von {{email}}",+ "create_key_cta": "Schlüssel erstellen",+ "create_sheet_description": "Wählen Sie einen Schlüsseltyp und anschließend die Berechtigungen aus, die er verwenden darf.",+ "create_sheet_title": "API-Schlüssel erstellen",+ "delete_confirm": {+ "message": "Dadurch wird der Schlüssel dauerhaft entfernt. Bevorzugen Sie das Widerrufen, falls Sie den Zugriff später wiederherstellen möchten.",+ "title": "Schlüssel löschen?"},- "customer_id": {- "label": "Kunde"+ "dropdown": {+ "copy_token_aria": "Token kopieren",+ "revoke": "Schlüssel widerrufen"},- "role_id": {- "label": "Rolle"+ "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.",+ "edit_sheet_title": "API-Schlüssel bearbeiten",+ "empty_description": "Erstellen Sie einen, um zu beginnen.",+ "errors": {+ "failed_to_create": "Schlüssel konnte nicht erstellt werden",+ "failed_to_delete": "Schlüssel konnte nicht gelöscht werden",+ "failed_to_update": "Schlüssel konnte nicht aktualisiert werden"},- "role_ids": {- "label": "Rollen"+ "key_type": {+ "publishable_description": "Kann gefahrlos im clientseitigen Code offengelegt werden. Gewährt öffentlichen/Gast-Zugriff.",+ "publishable_title": "Veröffentlichbarer Schlüssel",+ "secret_description": "Server-zu-Server. Jeder Schlüssel führt eine explizite Liste von Berechtigungen.",+ "secret_title": "Geheimer Schlüssel"},- "tax_category_id": {- "label": "Steuerkategorie"+ "revoke_confirm": {+ "message": "Jede Integration, die diesen Schlüssel verwendet, funktioniert sofort nicht mehr.",+ "title": "Schlüssel widerrufen?"},- "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"+ "scope_picker": {+ "full_access_hint": "– Lesen + Schreiben für jede Ressource",+ "full_access_label": "Vollzugriff (write_all)",+ "read_all_hint": "– Lesen für jede Ressource",+ "read_all_label": "Alles lesen (read_all)",+ "read_aria": "{{resource}} lesen",+ "read_header": "Lesen",+ "resource_header": "Ressource",+ "resources": {+ "api_keys": "API-Schlüssel",+ "categories": "Kategorien",+ "customers": "Kunden",+ "dashboard": "Dashboard",+ "fulfillments": "Fulfillments",+ "gift_cards": "Geschenkkarten",+ "orders": "Bestellungen",+ "payments": "Zahlungen",+ "products": "Produkte",+ "promotions": "Aktionen",+ "refunds": "Rückerstattungen",+ "settings": "Einstellungen",+ "stock": "Bestand",+ "store_credits": "Guthaben",+ "webhooks": "Webhooks"},- "match_policy": {- "label": "Übereinstimmungsregel"- }+ "show_more_aria_one": "{{count}} weiteren Geltungsbereich anzeigen",+ "show_more_aria_other": "{{count}} weitere Geltungsbereiche anzeigen",+ "write_aria": "{{resource}} schreiben",+ "write_header": "Schreiben"},- "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::Taxon": "Kategorien",- "Spree::OptionType": "Optionstypen"- }- },- "storefront_visible": {- "label": "Im Storefront sichtbar",- "column_label": "Storefront"- },- "searchable": {- "label": "Durchsuchbar",- "help": "Werte in die Storefront-Produktsuche aufnehmen (nur Kurztext, Langtext und Zahl). Nach dem Aktivieren mit Meilisearch rake spree:search:reindex ausführen, damit bestehende Produkte aktualisiert werden."- },- "sortable": {- "label": "Sortierbar",- "help": "Storefront-Produktlisten nach diesem Feld sortieren lassen (nur Kurztext und Zahl). Nach dem Aktivieren mit Meilisearch rake spree:search:reindex ausführen, damit bestehende Produkte aktualisiert 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.",+ "validation": {+ "scope_required": "Wählen Sie mindestens einen Geltungsbereich aus"},- "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."- }+ "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."+ },+ "calculators": {+ "default_refund_amount": "Standard-Erstattungsbetrag",+ "default_tax": "Standardsteuer",+ "digital_delivery": "Digitale Lieferung",+ "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"+ },+ "categories": {+ "add_cta": "Neue Kategorie",+ "collapse": "Zuklappen",+ "columns": {+ "name": "Name",+ "products": "Produkte"},- "allowed_origin": {- "origin": {- "label": "Ursprung",- "placeholder": "https://admin.example.com",- "help": "Nur Schema + Host (+ optionaler Port). Kein Pfad, keine Query, kein Fragment."+ "delete_confirm": "Die Kategorie „{{name}}“ und alle Unterkategorien löschen?",+ "delete_label": "Kategorie löschen",+ "empty": "Noch keine Kategorien.",+ "expand": "Aufklappen",+ "fields": {+ "parent": {+ "label": "Übergeordnete Kategorie",+ "placeholder": "Oberste Ebene"}},- "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"- }- },- "storefront_access": {- "label": "Storefront-Zugriff",- "help": "Legt fest, was anonyme Besucher in diesem Vertriebskanal sehen. Leer lassen, um die Store-Einstellung zu übernehmen. Wenn Preise verborgen sind, müssen Gäste sich zum Bezahlen anmelden.",- "inherit": "Vom Store übernehmen",- "options": {- "public": "Öffentlich – alle können stöbern und Preise sehen",- "prices_hidden": "Preise verborgen – Besucher müssen sich anmelden, um Preise zu sehen",- "login_required": "Anmeldung erforderlich – Besucher müssen sich anmelden, um zu stöbern"- }- },- "guest_checkout": {- "label": "Gast-Checkout",- "help": "Ob Kunden in diesem Vertriebskanal ohne Konto zur Kasse gehen können. Leer lassen, um die Store-Einstellung zu übernehmen.",- "inherit": "Vom Store übernehmen",- "options": {- "true": "Erlaubt",- "false": "Nicht erlaubt"- }- }+ "images": {+ "help": "Wird in Kategorie-Bannern verwendet. Empfohlen 1920×1080.",+ "label": "Bild",+ "square_help": "Wird in der kompakten Navigation verwendet. Empfohlen 400×400.",+ "square_label": "Quadratisches Bild",+ "title": "Bilder"},- "invitation_acceptance": {- "password": {- "label": "Passwort"- },- "password_confirmation": {- "label": "Passwort bestätigen"- }+ "load_failed": "Kategorien konnten nicht geladen werden. Bitte erneut versuchen.",+ "messages": {+ "created": "Kategorie erstellt",+ "deleted": "Kategorie gelöscht",+ "move_failed": "Kategorie konnte nicht verschoben werden",+ "updated": "Kategorie aktualisiert"},- "customer_group": {- "name": {- "placeholder": "z. B. VIP-Kunden"- },- "description": {- "placeholder": "Optionale interne Beschreibung"- }+ "navigation": {+ "title": "Navigation"},- "price_list": {- "name": {- "label": "Name",- "placeholder": "z. B. EU-Großhandel",- "help": "Interne Bezeichnung — wird Kunden nie angezeigt."+ "new_title": "Neue Kategorie",+ "no_results": "Keine Kategorien gefunden.",+ "products": {+ "add_cta": "Produkte hinzufügen",+ "column_product": "Produkt",+ "empty": "Noch keine Produkte in dieser Kategorie.",+ "filter_placeholder": "Produkte filtern…",+ "no_matches": "Keine Produkte entsprechen dem Filter.",+ "picker_description": "Suchen und wählen Sie Produkte für diese Kategorie aus.",+ "picker_title": "Produkte zur Kategorie hinzufügen",+ "remove": "Aus Kategorie entfernen",+ "remove_selected": "Entfernen",+ "search_placeholder": "Produkte suchen…",+ "select_all": "Alle auswählen",+ "select_row": "Produkt auswählen",+ "selected_count_one": "{{count}} ausgewählt",+ "selected_count_other": "{{count}} ausgewählt",+ "title": "Produkte"+ },+ "products_count_one": "{{count}} Produkt",+ "products_count_other": "{{count}} Produkte",+ "search_placeholder": "Kategorien suchen…",+ "seo": {+ "preview_slug_placeholder": "kategorie-slug",+ "title": "Suchmaschinenoptimierung"+ },+ "title": "Kategorien"+ },+ "channels": {+ "messages": {+ "created": "Kanal erstellt",+ "deleted": "Kanal gelöscht",+ "updated": "Kanal aktualisiert"+ }+ },+ "components": {+ "adjustment_action_editor": {+ "calculator_label": "Kalkulator",+ "loading_calculators": "Kalkulatoren werden geladen…",+ "no_extra_settings": "Dieser Kalkulator hat keine zusätzlichen Einstellungen.",+ "select_calculator": "Kalkulator auswählen",+ "settings_label": "Kalkulator-Einstellungen"+ },+ "custom_fields": {+ "default_resource": "Datensätzen",+ "empty_description": "Erfassen Sie strukturierte Details wie Material, Passform oder Pflegehinweise.",+ "empty_title": "Noch keine benutzerdefinierten Felder",+ "errors": {+ "failed_to_save": "Benutzerdefiniertes Feld konnte nicht gespeichert werden"},- "description": {- "label": "Beschreibung",- "placeholder": "Optionale interne Beschreibung"+ "manage_in_settings": "In den Einstellungen verwalten",+ "new_definition_description": "Definieren Sie ein benutzerdefiniertes Feld, um typisierte, strukturierte Informationen zu Ihren {{resource}} zu speichern.",+ "new_definition_title": "Neues benutzerdefiniertes Feld",+ "section_title": "Benutzerdefinierte Felder",+ "set_up": "Benutzerdefinierte Felder einrichten",+ "values_save_partial_failed": "Einige benutzerdefinierte Felder konnten nicht gespeichert werden: {{fields}}",+ "values_saved": "Benutzerdefinierte Felder gespeichert"+ },+ "market_combobox": {+ "empty": "Keine passenden Märkte",+ "search_placeholder": "Märkte suchen…"+ }+ },+ "custom_field_definitions": {+ "add_cta": "Benutzerdefiniertes Feld hinzufügen",+ "create_description": "Definieren Sie ein typisiertes Feld, das Ihr Team in jedem passenden Datensatz ausfüllen kann.",+ "create_label": "Benutzerdefiniertes Feld erstellen",+ "delete_confirm": {+ "message": "{{label}} wird zusammen mit allen dafür gespeicherten Werten entfernt.",+ "title": "Benutzerdefiniertes Feld löschen?"+ },+ "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.",+ "empty": "Noch keine Definitionen benutzerdefinierter Felder",+ "errors": {+ "failed_to_create": "Benutzerdefiniertes Feld konnte nicht erstellt werden",+ "failed_to_delete": "Benutzerdefiniertes Feld konnte nicht gelöscht werden",+ "failed_to_update": "Benutzerdefiniertes Feld konnte nicht aktualisiert werden"+ },+ "messages": {+ "created": "Benutzerdefiniertes Feld erstellt",+ "deleted": "Benutzerdefiniertes Feld gelöscht",+ "updated": "Benutzerdefiniertes Feld aktualisiert"+ },+ "search_placeholder": "Nach Bezeichnung, Namespace oder Schlüssel suchen…",+ "storefront_visible": {+ "admin_only": "Nur Administration",+ "visible": "Sichtbar"+ },+ "table_title": "Definitionen benutzerdefinierter Felder"+ },+ "customer_groups": {+ "autocomplete": {+ "empty": "Keine passenden Kundengruppen",+ "placeholder": "Kundengruppen suchen…"+ },+ "messages": {+ "create_failed": "Kundengruppe konnte nicht erstellt werden",+ "created": "Kundengruppe erstellt",+ "delete_failed": "Kundengruppe konnte nicht gelöscht werden",+ "deleted": "Kundengruppe gelöscht",+ "update_failed": "Kundengruppe konnte nicht aktualisiert werden",+ "updated": "Kundengruppe aktualisiert"+ }+ },+ "customers": {+ "autocomplete": {+ "empty": "Keine passenden Kunden",+ "placeholder": "Kunden suchen…"+ },+ "columns": {+ "groups": "Gruppen",+ "last_order": "Letzte Bestellung",+ "newsletter": "Newsletter",+ "orders": "Bestellungen",+ "total_spent": "Gesamtausgaben"+ },+ "detail": {+ "address": {+ "default_billing": "Standard-Rechnungsadresse",+ "default_shipping": "Standard-Lieferadresse",+ "delete_confirm_message": "Diese Adresse löschen?",+ "set_default_billing": "Als Standard-Rechnungsadresse festlegen",+ "set_default_shipping": "Als Standard-Lieferadresse festlegen"},- "starts_at": {- "label": "Beginnt",- "placeholder": "Sofort",- "help": "Wann diese Liste aktiv wird. Leer lassen, um bei Aktivierung sofort zu starten."+ "customer_since": "Kunde seit",+ "delete_label": "Kunde löschen",+ "edit_profile_description": "Aktualisieren Sie die Profilinformationen des Kunden.",+ "groups": {+ "edit_description": "Gruppen hinzufügen oder entfernen, denen dieser Kunde angehört.",+ "edit_title": "Kundengruppen bearbeiten",+ "empty": "In keinen Gruppen",+ "save_failed": "Kundengruppen konnten nicht aktualisiert werden",+ "title": "Kundengruppen"},- "ends_at": {- "label": "Endet",- "placeholder": "Nie",- "help": "Leer lassen für kein Enddatum."+ "last_order_placed": "Letzte Bestellung aufgegeben",+ "no_internal_notes": "Keine internen Notizen",+ "not_subscribed_to_marketing": "Marketing nicht abonniert",+ "orders_table": {+ "date": "Datum",+ "order": "Bestellung"},- "match_policy": {- "label": "Übereinstimmungsregel",- "all": "Alle Regeln müssen zutreffen",- "any": "Eine beliebige Regel darf zutreffen"+ "store_credit": {+ "add_description": "Stellen Sie diesem Kundenkonto Guthaben aus.",+ "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.",+ "empty": "Kein Guthaben ausgestellt",+ "table": {+ "category": "Kategorie",+ "memo": "Notiz",+ "remaining": "Verbleibend",+ "used": "Verwendet"+ },+ "title": "Guthaben"},- "status": {- "active": "Aktiv",- "scheduled": "Geplant",- "inactive": "Inaktiv",- "draft": "Entwurf"- }+ "subscribed_to_marketing": "Marketing abonniert"},- "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."+ "groups": {+ "bulk_add_action": "Zu Gruppe hinzufügen…",+ "bulk_add_failed": "Kunden konnten nicht zu Gruppen hinzugefügt werden",+ "bulk_added": "{{count}} Kunden zu Gruppen hinzugefügt",+ "bulk_remove_action": "Aus Gruppe entfernen…",+ "bulk_remove_failed": "Kunden konnten nicht aus Gruppen entfernt werden",+ "bulk_removed": "{{count}} Kunden aus Gruppen entfernt",+ "columns": {+ "customers": "Kunden"},- "markets": {- "label": "Märkte",- "help": "Leer lassen, um diese Regel in jedem Markt anzuwenden."+ "count_one": "{{count}} Kunde",+ "count_other": "{{count}} Kunden",+ "create_description": "Erstellen Sie eine Kundengruppe, um Ihre Kunden für Aktionen, Analysen oder Marketing zu segmentieren.",+ "create_label": "Kundengruppe erstellen",+ "default_name": "Diese Gruppe",+ "delete_confirm": {+ "message": "{{name}} wird entfernt. Kunden in dieser Gruppe werden nicht gelöscht.",+ "title": "Kundengruppe löschen?"},- "channels": {- "label": "Vertriebskanäle",- "help": "Leer lassen, um diese Regel auf jeden Vertriebskanal anzuwenden."+ "edit_description": "Aktualisieren Sie den Namen oder die Beschreibung.",+ "picker": {+ "add_description": "Wählen Sie die Gruppen aus, zu denen diese Kunden hinzugefügt werden sollen.",+ "add_title": "Zu Gruppen hinzufügen",+ "remove_description": "Wählen Sie die Gruppen aus, aus denen diese Kunden entfernt werden sollen.",+ "remove_title": "Aus Gruppen entfernen"},- "min_quantity": {- "help": "Dieser Preis gilt nur, wenn ein Kunde mindestens so viele Einheiten eines einzelnen Artikels bestellt."+ "table": {+ "empty": "Noch keine Kundengruppen",+ "search_placeholder": "Nach Name suchen…",+ "title": "Kundengruppen"},- "max_quantity": {- "help": "Leer lassen für keine Obergrenze."+ "view_members": "Mitglieder anzeigen"+ },+ "new_sheet_description": "Hier angelegte Kunden haben kein Passwort festgelegt. Sie erhalten beim ersten Anmelden einen Magic Link.",+ "row_actions": {+ "delete_confirm": "{{email}} löschen? Kunden mit abgeschlossenen Bestellungen können nicht entfernt werden."+ },+ "table": {+ "empty": "Noch keine Kunden",+ "search_placeholder": "Nach E-Mail oder Name suchen…"+ },+ "tags": {+ "bulk_add_action": "Tags hinzufügen…",+ "bulk_add_failed": "Tags konnten nicht hinzugefügt werden",+ "bulk_added": "Tags zu {n} Kunden hinzugefügt",+ "bulk_remove_action": "Tags entfernen…",+ "bulk_remove_failed": "Tags konnten nicht entfernt werden",+ "bulk_removed": "Tags von {n} Kunden entfernt",+ "picker": {+ "add_description": "Wählen oder erstellen Sie Tags, die diesen Kunden hinzugefügt werden sollen.",+ "add_title": "Tags hinzufügen",+ "remove_description": "Wählen Sie Tags aus, die von diesen Kunden entfernt werden sollen.",+ "remove_title": "Tags entfernen"+ }+ }+ },+ "delivery_methods": {+ "add_cta": "Versandart hinzufügen",+ "add_sheet_title": "Neue Versandart",+ "create_description": "Konfiguriere, wie Bestellungen die Kundschaft erreichen: Versand, digital oder Abholung.",+ "create_label": "Versandart erstellen",+ "delete_confirm": {+ "message": "\"{{name}}\" löschen? Storefronts bieten sie sofort nicht mehr an.",+ "title": "Versandart löschen"+ },+ "edit_description": "Konfiguration dieser Versandart aktualisieren.",+ "edit_sheet_title": "Versandart bearbeiten",+ "empty": "Noch keine Versandarten.",+ "fulfillment_types": {+ "digital": "Digital",+ "pickup": "Abholung",+ "pickup_point": "Abholstation",+ "shipping": "Versand"+ },+ "messages": {+ "created": "Versandart erstellt",+ "deleted": "Versandart gelöscht",+ "updated": "Versandart aktualisiert"+ },+ "no_zones_hint": "Noch keine Lieferzonen definiert — die Methode gilt überall.",+ "search_placeholder": "Versandarten durchsuchen…"+ },+ "delivery_zones": {+ "add_cta": "Lieferzone hinzufügen",+ "add_member": "Mitglied hinzufügen",+ "add_sheet_title": "Neue Lieferzone",+ "create_description": "Gruppiere Länder, Bundesländer oder Postleitzahlen zu einem Liefergebiet.",+ "create_label": "Lieferzone erstellen",+ "delete_confirm": {+ "message": "\"{{name}}\" löschen? Versandarten mit dieser Zone treffen diese Gebiete nicht mehr.",+ "title": "Lieferzone löschen"+ },+ "edit_description": "Die folgenden Mitglieder ersetzen beim Speichern die gesamte Liste.",+ "edit_sheet_title": "Lieferzone bearbeiten",+ "empty": "Noch keine Lieferzonen.",+ "from_placeholder": "Von",+ "member_types": {+ "country": "Land",+ "postal_code": "Postleitzahl",+ "state": "Bundesland"+ },+ "members_column": "Mitglieder",+ "members_count": "{{count}} Mitglieder",+ "messages": {+ "created": "Lieferzone erstellt",+ "deleted": "Lieferzone gelöscht",+ "updated": "Lieferzone aktualisiert"+ },+ "no_members_hint": "Noch keine Mitglieder — füge Länder, Bundesländer oder PLZ-Regeln hinzu.",+ "prefix_placeholder": "Präfix",+ "search_placeholder": "Lieferzonen durchsuchen…",+ "select_country": "Land wählen",+ "state_placeholder": "Bundesland-Kürzel oder Name",+ "to_placeholder": "Bis"+ },+ "errors": {+ "forbidden_description": "Sie haben keine Berechtigung, diese Seite anzuzeigen.",+ "forbidden_title": "Nicht berechtigt",+ "not_found_description": "Die gesuchte Seite existiert nicht.",+ "not_found_title": "Seite nicht gefunden",+ "plugin_route_title": "Diese Seite konnte nicht dargestellt werden"+ },+ "fields": {+ "allowed_origin": {+ "origin": {+ "help": "Nur Schema + Host (+ optionaler Port). Kein Pfad, keine Query, kein Fragment.",+ "label": "Ursprung",+ "placeholder": "https://admin.example.com"}},- "stock_location": {- "name": {- "placeholder": "Lager Brooklyn"+ "api_key": {+ "channel": {+ "all_channels": "All channels",+ "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",+ "label": "Channel"},- "admin_name": {- "label": "Interner Name",- "placeholder": "Optional — wird nur im Admin angezeigt"+ "key_type": {+ "label": "Typ"},- "kind": {- "label": "Art"+ "name": {+ "label": "Name",+ "placeholder": "Backend-Integration, Storefront-Prod, …",+ "required": "Name ist erforderlich"},+ "scopes": {+ "label": "Geltungsbereiche"+ }+ },+ "channel": {"active": {- "label": "Aktiv",- "help": "Inaktive Standorte erscheinen nicht in der Fulfillment-Auswahl."+ "help": "Inaktive Verkaufskanäle nehmen keine Bestellungen mehr an und werden vom X-Spree-Channel-Header nicht erkannt.",+ "label": "Aktiv"+ },+ "code": {+ "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.",+ "label": "Code",+ "placeholder": "Automatisch aus dem Namen abgeleitet"},"default": {- "label": "Standardstandort",- "help": "Neue Lagerbestände werden hierher übernommen. Nur ein Standort kann Standard sein."+ "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.",+ "label": "Standardkanal"},- "backorderable_default": {- "label": "Standardmäßig nachbestellbar",- "help": "Neue Lagerbestände erlauben standardmäßig Nachbestellungen, wenn der Bestand erschöpft ist."+ "guest_checkout": {+ "help": "Ob Kunden in diesem Vertriebskanal ohne Konto zur Kasse gehen können. Leer lassen, um die Store-Einstellung zu übernehmen.",+ "inherit": "Vom Store übernehmen",+ "label": "Gast-Checkout",+ "options": {+ "false": "Nicht erlaubt",+ "true": "Erlaubt"+ }},- "propagate_all_variants": {- "label": "Lagerbestände für alle Varianten automatisch anlegen",- "help": "Lagerbestände an diesem Standort für jede Produktvariante anlegen."+ "name": {+ "placeholder": "z. B. POS, Großhandel, Meta Shop"},- "pickup_enabled": {- "label": "Abholung durch Kunden erlauben",- "help": "Kunden können Bestellungen an diesem Standort beim Checkout abholen."+ "order_routing_strategy": {+ "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",+ "label": "Strategie für das Bestell-Routing",+ "options": {+ "Spree::OrderRouting::Strategy::Legacy": "Legacy",+ "Spree::OrderRouting::Strategy::Rules": "Regeln (geordnet)"+ }},- "pickup_stock_policy": {- "label": "Bestandsrichtlinie"+ "storefront_access": {+ "help": "Legt fest, was anonyme Besucher in diesem Vertriebskanal sehen. Leer lassen, um die Store-Einstellung zu übernehmen. Wenn Preise verborgen sind, müssen Gäste sich zum Bezahlen anmelden.",+ "inherit": "Vom Store übernehmen",+ "label": "Storefront-Zugriff",+ "options": {+ "login_required": "Anmeldung erforderlich – Besucher müssen sich anmelden, um zu stöbern",+ "prices_hidden": "Preise verborgen – Besucher müssen sich anmelden, um Preise zu sehen",+ "public": "Öffentlich – alle können stöbern und Preise sehen"+ }+ }+ },+ "custom_field_definition": {+ "field_type": {+ "label": "Typ",+ "options": {+ "boolean": "Boolescher Wert",+ "json": "JSON",+ "long_text": "Langer Text",+ "number": "Zahl",+ "rich_text": "Formatierter Text",+ "short_text": "Kurzer Text"+ },+ "read_only_help": "Der Typ kann nicht mehr geändert werden, sobald Werte vorhanden sind — andernfalls würden gespeicherte Werte falsch interpretiert."},- "pickup_ready_in_minutes": {- "label": "Bereit in (Minuten)",- "placeholder": "60"+ "key": {+ "invalid_format": "Nur Buchstaben, Zahlen und Unterstriche",+ "label": "Schlüssel",+ "placeholder": "z. B. material"},- "pickup_instructions": {- "label": "Abholhinweise",- "placeholder": "Wohin der Kunde gehen soll, um seine Bestellung abzuholen."+ "label": {+ "label": "Bezeichnung",+ "placeholder": "z. B. Material"+ },+ "namespace": {+ "label": "Namensraum",+ "placeholder": "custom"+ },+ "resource_type": {+ "label": "Gilt für",+ "options": {+ "Spree::OptionType": "Optionstypen",+ "Spree::Order": "Bestellungen",+ "Spree::Product": "Produkte",+ "Spree::Taxon": "Kategorien",+ "Spree::User": "Kunden",+ "Spree::Variant": "Varianten"+ },+ "read_only_help": "Der Eigentümer kann nicht mehr geändert werden, sobald Werte für dieses Feld vorhanden sind."+ },+ "searchable": {+ "help": "Werte in die Storefront-Produktsuche aufnehmen (nur Kurztext, Langtext und Zahl). Nach dem Aktivieren mit Meilisearch rake spree:search:reindex ausführen, damit bestehende Produkte aktualisiert werden.",+ "label": "Durchsuchbar"+ },+ "sortable": {+ "help": "Storefront-Produktlisten nach diesem Feld sortieren lassen (nur Kurztext und Zahl). Nach dem Aktivieren mit Meilisearch rake spree:search:reindex ausführen, damit bestehende Produkte aktualisiert werden.",+ "label": "Sortierbar"+ },+ "storefront_visible": {+ "column_label": "Storefront",+ "label": "Im Storefront sichtbar"}},- "payment_method": {- "type": {- "label": "Anbieter",- "placeholder": "Anbieter auswählen"+ "customer": {+ "accepts_email_marketing": {+ "label": "Für Marketing angemeldet"},- "name": {- "placeholder": "z. B. Kreditkarte (Stripe)"+ "customer_groups": {+ "label": "Kundengruppen"+ },+ "internal_note": {+ "label": "Interne Notiz",+ "placeholder": "Nur für Mitarbeiter sichtbare Hinweise zu diesem Kunden…"},+ "tags": {+ "label": "Tags"+ }+ },+ "customer_group": {"description": {- "placeholder": "Kundenseitige Beschreibung, die beim Checkout angezeigt wird"+ "placeholder": "Optionale interne Beschreibung"+ },+ "name": {+ "placeholder": "z. B. VIP-Kunden"+ }+ },+ "customer_id": {+ "label": "Kunde"+ },+ "delivery_method": {+ "admin_name": {+ "label": "Interner Name"+ },+ "calculator": {+ "label": "Tarifrechner"+ },+ "code": {+ "label": "Code"+ },+ "delivery_zones": {+ "label": "Lieferzonen"+ },+ "fulfillment_type": {+ "label": "Fulfillment-Typ"},"storefront_visible": {- "label": "Im Storefront sichtbar"+ "help": "Kundschaft kann diese Methode im Checkout wählen."},- "active": {- "label": "Aktiv",- "help": "Inaktive Methoden werden beim Checkout ausgeblendet."+ "tax_category": {+ "label": "Steuerkategorie"},- "auto_capture": {- "label": "Automatischer Einzug",- "help": "Bei Autorisierung automatisch einziehen. Wenn deaktiviert, müssen Sie manuell einziehen."+ "tracking_url": {+ "label": "Tracking-URL-Vorlage"+ },+ "transit_days_max": {+ "label": "Laufzeit (max. Tage)"},- "provider_configuration": "Anbieterkonfiguration"+ "transit_days_min": {+ "label": "Laufzeit (min. Tage)"+ }},- "market": {- "name": {- "placeholder": "z. B. Europa"+ "gift_card": {+ "amount": {+ "label": "Betrag"+ },+ "code": {+ "help": "Leer lassen für automatische Generierung. Bei Stapeln wird dies zum Präfix.",+ "label": "Code"},"currency": {- "label": "Währung",- "help": "ISO-4217-Währung für alle Preise in diesem Markt."+ "label": "Währung"},- "default_locale": {- "label": "Standardsprache",- "help": "Storefront-Sprache für Käufer in diesem Markt."+ "customer_id": {+ "label": "Kunde"},- "supported_locales": {- "label": "Unterstützte Sprachen",- "help": "Weitere Sprachen, zu denen Käufer wechseln können. Die Standardsprache ist immer enthalten."+ "expires_at": {+ "label": "Läuft ab",+ "placeholder": "Kein Ablauf"+ },+ "quantity": {+ "help": "Bei 1 wird eine einzelne Karte ausgegeben. Bei mehr als 1 wird ein Stapel mit automatisch generierten Codes ausgegeben.",+ "label": "Menge"+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "Passwort"},+ "password_confirmation": {+ "label": "Passwort bestätigen"+ }+ },+ "market": {"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."+ "help": "Wählen Sie die Länder aus, die dieser Markt abdeckt. Jedes Land kann pro Store höchstens einem Markt angehören.",+ "label": "Länder"},- "tax_inclusive": {- "label": "Preise inklusive Steuer",- "help": "Preise mit enthaltener Steuer anzeigen. In EU-Märkten üblich."+ "currency": {+ "help": "ISO-4217-Währung für alle Preise in diesem Markt.",+ "label": "Währung"},"default": {- "label": "Standardmarkt",- "help": "Käufer ohne bekanntes Land sehen diesen Markt. Pro Store kann nur einer Standard sein."+ "help": "Käufer ohne bekanntes Land sehen diesen Markt. Pro Store kann nur einer Standard sein.",+ "label": "Standardmarkt"+ },+ "default_locale": {+ "help": "Storefront-Sprache für Käufer in diesem Markt.",+ "label": "Standardsprache"+ },+ "name": {+ "placeholder": "z. B. Europa"+ },+ "supported_locales": {+ "help": "Weitere Sprachen, zu denen Käufer wechseln können. Die Standardsprache ist immer enthalten.",+ "label": "Unterstützte Sprachen"+ },+ "tax_inclusive": {+ "help": "Preise mit enthaltener Steuer anzeigen. In EU-Märkten üblich.",+ "label": "Preise inklusive Steuer"+ }+ },+ "match_policy": {+ "label": "Abgleichrichtlinie"+ },+ "media": {+ "alt": {+ "label": "Alt-Text",+ "placeholder": "Beschreiben Sie das Bild für Barrierefreiheit und SEO"}},"option_type": {- "name": {- "label": "Interner Name",- "placeholder": "z. B. shirt-size",- "help": "Bezeichner in Kleinbuchstaben. Muss im gesamten Store eindeutig sein."+ "filterable": {+ "help": "Diese Option als Filter in Produktlisten des Storefronts anzeigen.",+ "label": "Filterbar"+ },+ "kind": {+ "help": "Steuert, wie die Option im Storefront dargestellt wird. Farbmuster zeigt eine Hex-Farbe; Schaltflächen zeigen ein Vorschaubild.",+ "label": "Art"},"label": {+ "help": "Wird Kunden im Storefront angezeigt.","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."+ "placeholder": "z. B. Hemdgröße"},- "filterable": {- "label": "Filterbar",- "help": "Diese Option als Filter in Produktlisten des Storefronts anzeigen."+ "name": {+ "help": "Bezeichner in Kleinbuchstaben. Muss im gesamten Store eindeutig sein.",+ "label": "Interner Name",+ "placeholder": "z. B. shirt-size"}},"option_value": {- "name": {- "label": "Interner Name",- "placeholder": "z. B. small"- },- "label": {- "label": "Bezeichnung",- "placeholder": "z. B. Klein"- },"color_code": {"label": "Farbe"},"image": {"label": "Bild"+ },+ "label": {+ "label": "Bezeichnung",+ "placeholder": "z. B. Klein"+ },+ "name": {+ "label": "Interner Name",+ "placeholder": "z. B. small"}},- "variant": {- "sku": {- "label": "SKU",- "placeholder": "PRODUCT-RED-S"- },- "barcode": {- "label": "Barcode"+ "order": {+ "channel": {+ "help": "Die Bestellung einem bestimmten Verkaufskanal zuordnen. Standardmäßig der Online-Kanal des Stores.",+ "label": "Verkaufskanal",+ "placeholder": "Store-Standard verwenden"},- "weight": {- "label": "Gewicht"+ "coupon_code": {+ "label": "Gutscheincode",+ "placeholder": "Optional"},- "weight_unit": {- "label": "Einheit"+ "customer_note": {+ "label": "Kundennotiz (für Kunden sichtbar)"},- "height": {- "label": "Höhe"+ "email": {+ "label": "Oder eine Gast-E-Mail verwenden",+ "placeholder": "[email protected]"},- "width": {- "label": "Breite"+ "internal_note": {+ "label": "Interne Notiz (nur Mitarbeiter)"+ }+ },+ "payment_method": {+ "active": {+ "help": "Inaktive Methoden werden beim Checkout ausgeblendet.",+ "label": "Aktiv"},- "depth": {- "label": "Tiefe"+ "auto_capture": {+ "help": "Bei Autorisierung automatisch einziehen. Wenn deaktiviert, müssen Sie manuell einziehen.",+ "label": "Automatischer Einzug"},- "dimensions_unit": {- "label": "Einheit"+ "description": {+ "placeholder": "Kundenseitige Beschreibung, die beim Checkout angezeigt wird"},- "preorderable": {- "label": "Für Vorbestellung verfügbar",- "help": "Verkaufe diese Variante, bevor sie auf Lager ist. Begrenze die Menge mit dem Nachbestellungslimit, gib eingehenden Bestand als Lagerbestand ein oder lass es für unbegrenzt leer."+ "name": {+ "placeholder": "z. B. Kreditkarte (Stripe)"},- "preorder_ships_at": {- "label": "Versand bis",- "placeholder": "Datum wählen",- "help": "Wann du Vorbestellungen voraussichtlich versendest. Wird Kunden als Lieferversprechen angezeigt; die Vorbestellung endet, sobald dieses Datum verstreicht."+ "provider_configuration": "Anbieterkonfiguration",+ "storefront_visible": {+ "label": "Im Storefront sichtbar"},- "backorder_limit": {- "label": "Nachbestellungslimit",- "placeholder": "Unbegrenzt",- "help": "Maximale Anzahl an Einheiten, die über den verfügbaren Bestand hinaus verkauft werden — begrenzt Nachbestellungen und Vorbestellungen. Leer lassen für unbegrenzt."+ "type": {+ "label": "Anbieter",+ "placeholder": "Anbieter auswählen"}},- "api_key": {- "name": {- "label": "Name",- "placeholder": "Backend-Integration, Storefront-Prod, …",- "required": "Name ist erforderlich"+ "price_list": {+ "description": {+ "label": "Beschreibung",+ "placeholder": "Optionale interne Beschreibung"},- "key_type": {- "label": "Typ"+ "ends_at": {+ "help": "Leer lassen für kein Enddatum.",+ "label": "Endet",+ "placeholder": "Nie"},- "scopes": {- "label": "Geltungsbereiche"+ "match_policy": {+ "all": "Alle Regeln müssen zutreffen",+ "any": "Eine beliebige Regel darf zutreffen",+ "label": "Übereinstimmungsregel"},- "channel": {- "label": "Channel",- "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",- "all_channels": "All channels"- }- },- "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"+ "help": "Interne Bezeichnung — wird Kunden nie angezeigt.",+ "label": "Name",+ "placeholder": "z. B. EU-Großhandel"},- "storefront_access": {- "label": "Storefront-Zugriff",- "help": "Store-weite Vorgabe dafür, was anonyme Besucher sehen. Vertriebskanäle können dies überschreiben. Wenn Preise verborgen sind, müssen Gäste sich zum Bezahlen anmelden.",- "options": {- "public": "Öffentlich – alle können stöbern und Preise sehen",- "prices_hidden": "Preise verborgen – Besucher müssen sich anmelden, um Preise zu sehen",- "login_required": "Anmeldung erforderlich – Besucher müssen sich anmelden, um zu stöbern"- }+ "starts_at": {+ "help": "Wann diese Liste aktiv wird. Leer lassen, um bei Aktivierung sofort zu starten.",+ "label": "Beginnt",+ "placeholder": "Sofort"},- "guest_checkout": {- "label": "Gast-Checkout",- "help": "Store-weite Vorgabe dafür, ob Kunden ohne Konto zur Kasse gehen können. Vertriebskanäle können dies überschreiben."+ "status": {+ "active": "Aktiv",+ "draft": "Entwurf",+ "inactive": "Inaktiv",+ "scheduled": "Geplant"+ }+ },+ "price_rule": {+ "channels": {+ "help": "Leer lassen, um diese Regel auf jeden Vertriebskanal anzuwenden.",+ "label": "Vertriebskanäle"},- "mail_from_address": {- "label": "Absenderadresse",- "placeholder": "[email protected]",- "help": "Wird als Absenderadresse bei jeder transaktionalen E-Mail verwendet."+ "customer_groups": {+ "help": "Leer lassen, um diese Regel auf jeden Kunden unabhängig von der Gruppe anzuwenden.",+ "label": "Kundengruppen"},- "customer_support_email": {- "label": "E-Mail des Kundensupports",- "placeholder": "[email protected]",- "help": "Antwortadresse, die Kunden in Storefront-E-Mails angezeigt wird."+ "customers": {+ "help": "Leer lassen, um diese Regel auf jeden angemeldeten Kunden anzuwenden.",+ "label": "Kunden"},- "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."+ "markets": {+ "help": "Leer lassen, um diese Regel in jedem Markt anzuwenden.",+ "label": "Märkte"},- "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."+ "max_quantity": {+ "help": "Leer lassen für keine Obergrenze."},- "mailer_logo": {- "label": "E-Mail-Logo",- "help": "PNG oder JPG mit transparentem Hintergrund. Eingebettet in die Kopfzeilen transaktionaler E-Mails."+ "min_quantity": {+ "help": "Dieser Preis gilt nur, wenn ein Kunde mindestens so viele Einheiten eines einzelnen Artikels bestellt."}},- "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."- }+ "prices_count": {+ "label": "Preise"},"product": {- "name": {- "label": "Name",- "placeholder": "Produktname"+ "available_on": {+ "label": "Verfügbar ab"+ },+ "category_ids": {+ "label": "Kategorien"+ },+ "channels": {+ "label": "Verkaufskanäle"},"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"+ "make_active_at": {+ "label": "Aktiv schalten am"},- "channels": {- "label": "Verkaufskanäle"+ "name": {+ "label": "Name",+ "placeholder": "Produktname"},"tags": {"label": "Tags"@@ -633,870 +841,1282 @@},"product_publication": {"published_at": {+ "help": "Leer lassen, um sofort live zu gehen.","label": "Veröffentlichen ab",- "placeholder": "Sofort live",- "help": "Leer lassen, um sofort live zu gehen."+ "placeholder": "Sofort live"},"unpublished_at": {+ "help": "Leer lassen, um unbegrenzt gelistet zu bleiben.","label": "Veröffentlichung beenden am",- "placeholder": "Nie",- "help": "Leer lassen, um unbegrenzt gelistet zu bleiben."+ "placeholder": "Nie"}},- "gift_card": {+ "products_count": {+ "label": "Produkte"+ },+ "profile": {+ "avatar": {+ "help": "Wird im gesamten Admin neben Ihrem Namen angezeigt. Quadratische Bilder sehen am besten aus.",+ "label": "Foto"+ },+ "email": {+ "label": "E-Mail"+ },+ "first_name": {+ "label": "Vorname"+ },+ "last_name": {+ "label": "Nachname"+ },+ "selected_locale": {+ "help": "Sprache, die im gesamten Admin-Dashboard verwendet wird. Betrifft nur Ihre Ansicht.",+ "label": "Sprache"+ }+ },+ "promotion": {"code": {- "label": "Code",- "help": "Leer lassen für automatische Generierung. Bei Stapeln wird dies zum Präfix."+ "placeholder": "SOMMER2026"},- "amount": {- "label": "Betrag"+ "code_prefix": {+ "help": "Jeder generierte Code beginnt mit diesem Präfix.",+ "label": "Code-Präfix (optional)",+ "placeholder": "VIP"},- "currency": {- "label": "Währung"+ "description": {+ "placeholder": "Interne Beschreibung (optional)"},"expires_at": {- "label": "Läuft ab","placeholder": "Kein Ablauf"},- "customer_id": {- "label": "Kunde"+ "kind": {+ "label": "Wie wird diese Aktion angewendet?"},- "quantity": {- "label": "Menge",- "help": "Bei 1 wird eine einzelne Karte ausgegeben. Bei mehr als 1 wird ein Stapel mit automatisch generierten Codes ausgegeben."+ "match_policy": {+ "label": "Übereinstimmungsregel"+ },+ "multi_codes": {+ "help": "Nützlich für Einmalcodes — jeder Kunde löst einen anderen Code ein.",+ "label": "Eine Reihe eindeutiger Codes generieren"+ },+ "name": {+ "placeholder": "Sommer-Sale"+ },+ "number_of_codes": {+ "label": "Anzahl der Codes",+ "placeholder": "100"+ },+ "starts_at": {+ "placeholder": "Kein Startdatum"+ },+ "usage_limit": {+ "label": "Nutzungslimit",+ "placeholder": "Unbegrenzt"}},- "customer": {- "tags": {- "label": "Tags"+ "role_id": {+ "label": "Rolle"+ },+ "role_ids": {+ "label": "Rollen"+ },+ "stock_location": {+ "active": {+ "help": "Inaktive Standorte erscheinen nicht in der Fulfillment-Auswahl.",+ "label": "Aktiv"},- "customer_groups": {- "label": "Kundengruppen"+ "admin_name": {+ "label": "Interner Name",+ "placeholder": "Optional — wird nur im Admin angezeigt"},- "accepts_email_marketing": {- "label": "Für Marketing angemeldet"+ "backorderable_default": {+ "help": "Neue Lagerbestände erlauben standardmäßig Nachbestellungen, wenn der Bestand erschöpft ist.",+ "label": "Standardmäßig nachbestellbar"},- "internal_note": {- "label": "Interne Notiz",- "placeholder": "Nur für Mitarbeiter sichtbare Hinweise zu diesem Kunden…"+ "default": {+ "help": "Neue Lagerbestände werden hierher übernommen. Nur ein Standort kann Standard sein.",+ "label": "Standardstandort"+ },+ "kind": {+ "label": "Art"+ },+ "name": {+ "placeholder": "Lager Brooklyn"+ },+ "pickup_enabled": {+ "help": "Kunden können Bestellungen an diesem Standort beim Checkout abholen.",+ "label": "Abholung durch Kunden erlauben"+ },+ "pickup_instructions": {+ "label": "Abholhinweise",+ "placeholder": "Wohin der Kunde gehen soll, um seine Bestellung abzuholen."+ },+ "pickup_ready_in_minutes": {+ "label": "Bereit in (Minuten)",+ "placeholder": "60"+ },+ "pickup_stock_policy": {+ "label": "Bestandsrichtlinie"+ },+ "propagate_all_variants": {+ "help": "Lagerbestände an diesem Standort für jede Produktvariante anlegen.",+ "label": "Lagerbestände für alle Varianten automatisch anlegen"+ }+ },+ "store": {+ "customer_support_email": {+ "help": "Antwortadresse, die Kunden in Storefront-E-Mails angezeigt wird.",+ "label": "E-Mail des Kundensupports",+ "placeholder": "[email protected]"+ },+ "guest_checkout": {+ "help": "Store-weite Vorgabe dafür, ob Kunden ohne Konto zur Kasse gehen können. Vertriebskanäle können dies überschreiben.",+ "label": "Gast-Checkout"+ },+ "mail_from_address": {+ "help": "Wird als Absenderadresse bei jeder transaktionalen E-Mail verwendet.",+ "label": "Absenderadresse",+ "placeholder": "[email protected]"+ },+ "mailer_logo": {+ "help": "PNG oder JPG mit transparentem Hintergrund. Eingebettet in die Kopfzeilen transaktionaler E-Mails.",+ "label": "E-Mail-Logo"+ },+ "name": {+ "label": "Store-Name"+ },+ "new_order_notifications_email": {+ "help": "Empfänger von Benachrichtigungen über „neue Bestellung aufgegeben“. Leer lassen, um zu deaktivieren.",+ "label": "Benachrichtigungen über neue Bestellungen",+ "placeholder": "[email protected]"+ },+ "preferred_admin_locale": {+ "label": "Admin-Sprache",+ "placeholder": "Standardsprache verwenden"+ },+ "preferred_send_consumer_transactional_emails": {+ "help": "Wenn deaktiviert, werden keine Bestellbestätigungen, Versand- oder Erstattungs-E-Mails gesendet.",+ "label": "Transaktionale E-Mails an Kunden senden"+ },+ "preferred_timezone": {+ "label": "Zeitzone",+ "placeholder": "Zeitzone auswählen"+ },+ "preferred_unit_system": {+ "label": "Einheitensystem"+ },+ "preferred_weight_unit": {+ "label": "Gewichtseinheit"+ },+ "storefront_access": {+ "help": "Store-weite Vorgabe dafür, was anonyme Besucher sehen. Vertriebskanäle können dies überschreiben. Wenn Preise verborgen sind, müssen Gäste sich zum Bezahlen anmelden.",+ "label": "Storefront-Zugriff",+ "options": {+ "login_required": "Anmeldung erforderlich – Besucher müssen sich anmelden, um zu stöbern",+ "prices_hidden": "Preise verborgen – Besucher müssen sich anmelden, um Preise zu sehen",+ "public": "Öffentlich – alle können stöbern und Preise sehen"+ }}},"store_credit": {"amount": {"label": "Betrag"},- "currency": {- "label": "Währung"- },"category_id": {"label": "Kategorie"},+ "currency": {+ "label": "Währung"+ },"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)"+ "storefront_visible": {+ "label": "Im Storefront sichtbar"+ },+ "tax_category": {+ "description": {+ "placeholder": "Optionale interne Beschreibung"},- "internal_note": {- "label": "Interne Notiz (nur Mitarbeiter)"+ "is_default": {+ "help": "Wenn Sie dies festlegen, wird der bisherige Standard aufgehoben. Produkte ohne explizite Kategorie greifen auf diese zurück.",+ "label": "Standard"},- "coupon_code": {- "label": "Gutscheincode",- "placeholder": "Optional"+ "name": {+ "placeholder": "z. B. Ermäßigter Satz"},- "channel": {- "label": "Verkaufskanal",- "placeholder": "Store-Standard verwenden",- "help": "Die Bestellung einem bestimmten Verkaufskanal zuordnen. Standardmäßig der Online-Kanal des Stores."+ "tax_code": {+ "label": "Steuercode",+ "placeholder": "Code des externen Steueranbieters (Avalara usw.)"}},- "media": {- "alt": {- "label": "Alt-Text",- "placeholder": "Beschreiben Sie das Bild für Barrierefreiheit und SEO"- }+ "tax_category_id": {+ "label": "Steuerkategorie"},- "profile": {- "email": {- "label": "E-Mail"+ "variant": {+ "backorder_limit": {+ "help": "Maximale Anzahl an Einheiten, die über den verfügbaren Bestand hinaus verkauft werden — begrenzt Nachbestellungen und Vorbestellungen. Leer lassen für unbegrenzt.",+ "label": "Nachbestellungslimit",+ "placeholder": "Unbegrenzt"},- "first_name": {- "label": "Vorname"+ "barcode": {+ "label": "Barcode"},- "last_name": {- "label": "Nachname"+ "depth": {+ "label": "Tiefe"},- "avatar": {- "label": "Foto",- "help": "Wird im gesamten Admin neben Ihrem Namen angezeigt. Quadratische Bilder sehen am besten aus."+ "dimensions_unit": {+ "label": "Einheit"},- "selected_locale": {- "label": "Sprache",- "help": "Sprache, die im gesamten Admin-Dashboard verwendet wird. Betrifft nur Ihre Ansicht."- }- },- "match_policy": {- "label": "Abgleichrichtlinie"- }- },- "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"+ "height": {+ "label": "Höhe"},- "channel": {- "label": "Kanäle"+ "preorder_ships_at": {+ "help": "Wann du Vorbestellungen voraussichtlich versendest. Wird Kunden als Lieferversprechen angezeigt; die Vorbestellung endet, sobald dieses Datum verstreicht.",+ "label": "Versand bis",+ "placeholder": "Datum wählen"},- "market": {- "label": "Märkte"+ "preorderable": {+ "help": "Verkaufe diese Variante, bevor sie auf Lager ist. Begrenze die Menge mit dem Nachbestellungslimit, gib eingehenden Bestand als Lagerbestand ein oder lass es für unbegrenzt leer.",+ "label": "Für Vorbestellung verfügbar"},- "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."- }- }+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUCT-RED-S"},- "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."- }- }+ "weight": {+ "label": "Gewicht"},- "customer_group": {- "label": "Kundengruppen",- "search_placeholder": "Kundengruppen suchen…",- "empty": "Keine passenden Kundengruppen"+ "weight_unit": {+ "label": "Einheit"},- "customer": {- "label": "Kunden",- "search_placeholder": "Kunden nach Namen oder E-Mail suchen…",- "empty": "Keine passenden Kunden"+ "width": {+ "label": "Breite"}},- "table": {- "search_placeholder": "Nach Namen suchen…",- "empty": "Noch keine Aktionen",- "no_end": "Kein Enddatum"+ "webhook_endpoint": {+ "active": {+ "help": "Inaktive Endpunkte empfangen keine Zustellungen.",+ "label": "Aktiv"+ },+ "name": {+ "help": "Optionale Bezeichnung, die in dieser Liste angezeigt wird.",+ "label": "Name",+ "placeholder": "z. B. Bestell-Pipeline"+ },+ "subscriptions": {+ "help": "Wählen Sie aus, welche Ereignisse einen Webhook auslösen sollen. Wählen Sie nichts aus, um jedes Ereignis zu empfangen.",+ "label": "Ereignisse"+ },+ "url": {+ "label": "Ziel-URL",+ "placeholder": "https://example.com/webhooks"+ }+ }+ },+ "gift_cards": {+ "batch_autocomplete": {+ "empty": "Keine passenden Chargen",+ "placeholder": "Chargen nach Präfix suchen…"},- "code": {- "automatic": "Automatisch",- "multi": "multi"+ "columns": {+ "batch": "Charge",+ "customer": "Kunde",+ "issued_by": "Ausgestellt von",+ "remaining": "Verbleibend",+ "used": "Verwendet"},- "basics_card": {- "title": "Grundlagen"+ "messages": {+ "batch_create_failed": "Geschenkkarten-Charge konnte nicht erstellt werden",+ "batch_created": "Geschenkkarten-Charge erstellt",+ "create_failed": "Geschenkkarte konnte nicht erstellt werden",+ "created": "Geschenkkarte erstellt",+ "delete_failed": "Geschenkkarte konnte nicht gelöscht werden",+ "deleted": "Geschenkkarte gelöscht",+ "update_failed": "Geschenkkarte konnte nicht aktualisiert werden",+ "updated": "Geschenkkarte aktualisiert"},- "trigger_card": {- "title": "Auslöser"+ "statuses": {+ "canceled": "Storniert",+ "expired": "Abgelaufen",+ "partially_redeemed": "Teilweise eingelöst",+ "redeemed": "Eingelöst"},- "schedule_card": {- "title": "Zeitplan & Limits"+ "table": {+ "empty": "Noch keine Geschenkkarten",+ "search_placeholder": "Nach Code suchen…"+ }+ },+ "imports": {+ "download_original": "Originaldatei herunterladen",+ "failed": {+ "description": "Die Datei konnte nicht verarbeitet werden.",+ "title": "Import fehlgeschlagen"},- "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."+ "failed_rows": {+ "error": "Fehler",+ "hide_data": "Zeilendaten ausblenden",+ "next_page": "Nächste Seite",+ "prev_page": "Vorherige Seite",+ "row_number": "Zeile",+ "title": "Fehlgeschlagene Zeilen",+ "view_data": "Zeilendaten anzeigen"},- "remove_rule_confirm": {- "title": "Regel entfernen?",- "message": "Wird entfernt, sobald Sie die Aktion speichern."+ "load_failed": "Der Import konnte nicht geladen werden.",+ "mapping": {+ "description": "Ordnen Sie die Spalten Ihrer Datei den Feldern für {{type}} zu.",+ "field": "Feld",+ "file_column": "Dateispalte",+ "missing_required": "Ordnen Sie die erforderlichen Felder zu, um fortzufahren: {{fields}}",+ "not_mapped": "Nicht zugeordnet",+ "required": "Erforderlich",+ "sample": "Beispiel",+ "start": "Import starten",+ "starting": "Wird gestartet…",+ "title": "Spalten zuordnen"},- "rule_summary": {- "product_count": "{{count}} Produkte",- "category_count": "{{count}} Kategorien",- "customer_count": "{{count}} Kunden"+ "processing": {+ "failed_count": "{{failed}} fehlgeschlagen",+ "note": "Sie können diese Seite verlassen — der Import läuft im Hintergrund weiter.",+ "preparing": "Zeilen werden vorbereitet…",+ "progress": "{{processed}} von {{total}} Zeilen verarbeitet",+ "retrying": "Fehlgeschlagene Zeilen werden wiederholt · {{remaining}} verbleibend",+ "title": "Zeilen werden verarbeitet"},- "rule_picker": {- "title": "Regel hinzufügen",- "description": "Wählen Sie einen Regeltyp zur Konfiguration."+ "results": {+ "completed_title": "Import abgeschlossen",+ "retry_failed": "Fehlgeschlagene Zeilen wiederholen ({{failed}})",+ "retrying": "Wird wiederholt…",+ "summary": "{{completed}} Zeilen importiert · {{failed}} fehlgeschlagen",+ "view_records": "{{type}} anzeigen"},- "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."+ "status": {+ "completed": "Abgeschlossen",+ "completed_mapping": "In Warteschlange",+ "failed": "Fehlgeschlagen",+ "mapping": "Zuordnung",+ "pending": "Ausstehend",+ "processing": "In Bearbeitung"},- "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"+ "steps": {+ "complete": "Fertig",+ "map_fields": "Felder zuordnen",+ "process_rows": "Zeilen verarbeiten"},- "remove_action_confirm": {- "title": "Aktion entfernen?",- "message": "Wird entfernt, sobald Sie die Aktion speichern."+ "try_again": "Erneut versuchen",+ "types": {+ "customers": "Kunden",+ "product_translations": "Produktübersetzungen",+ "products": "Produkte"},- "action_summary": {- "variant_count": "{{count}} Varianten"+ "wizard_title": "Import"+ },+ "invitation": {+ "accepting": "Wird angenommen…",+ "could_not_accept": "Einladung konnte nicht angenommen werden",+ "create_and_accept": "Konto erstellen & annehmen",+ "create_to_accept": ". Erstellen Sie Ihr Konto, um anzunehmen.",+ "generic_error_message": "Etwas ist schiefgelaufen. Bitte versuchen Sie es erneut.",+ "generic_error_title": "Einladung konnte nicht geladen werden",+ "invited_as_role": " als {{role}}",+ "invited_by": "{{email}} hat Sie eingeladen",+ "invited_generic": "Sie wurden eingeladen",+ "join_store": "{{store}} beitreten",+ "loading": "Einladung wird geladen…",+ "missing_token_message": "Dieser Link scheint unvollständig zu sein. Bitten Sie die Person, die Sie eingeladen hat, ihn erneut zu senden.",+ "missing_token_title": "Einladungs-Token fehlt",+ "not_found_message": "Diese Einladung ist abgelaufen, wurde widerrufen oder bereits angenommen. Bitten Sie die einladende Person, eine neue zu senden.",+ "not_found_title": "Einladung nicht gefunden",+ "sign_in_and_accept": "Anmelden & annehmen",+ "sign_in_to_accept": ". Melden Sie sich an, um anzunehmen."+ },+ "markets": {+ "add_cta": "Markt hinzufügen",+ "columns": {+ "default": "Standard"},- "action_picker": {- "title": "Aktion hinzufügen",- "description": "Wählen Sie, was passieren soll, wenn die Aktion zutrifft."+ "create_description": "Fassen Sie Länder zu einer einzigen Preisregion mit eigener Währung und eigenen Sprachen zusammen.",+ "create_label": "Markt erstellen",+ "delete_confirm": {+ "message": "{{name}} wird entfernt. Bestellungen, die zuvor in diesem Markt aufgegeben wurden, bleiben erhalten.",+ "title": "Markt löschen?"},- "action_edit": {- "description": "Konfigurieren Sie die Parameter der Aktion.",- "no_options": "Diese Aktion hat keine konfigurierbaren Optionen."+ "edit_description": "Aktualisieren Sie Name, Währung, Sprachen oder die Länderabdeckung.",+ "empty": "Noch keine Märkte",+ "errors": {+ "failed_to_create": "Markt konnte nicht erstellt werden",+ "failed_to_delete": "Markt konnte nicht gelöscht werden",+ "failed_to_update": "Markt konnte nicht aktualisiert werden"},- "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"+ "messages": {+ "created": "Markt erstellt",+ "deleted": "Markt gelöscht",+ "updated": "Markt aktualisiert"+ },+ "search_placeholder": "Nach Name suchen…",+ "tax_exclusive": "Exklusive",+ "tax_inclusive": "Inklusive"+ },+ "nav": {+ "account": "Konto",+ "categories": "Kategorien",+ "customer_groups": "Gruppen",+ "customers": "Kunden",+ "draft_orders": "Bestellentwürfe",+ "getting_started": "Erste Schritte",+ "gift_cards": "Geschenkkarten",+ "home": "Startseite",+ "options": "Optionen",+ "orders": "Bestellungen",+ "price_lists": "Preislisten",+ "products": "Produkte",+ "promotions": "Aktionen",+ "reports": "Berichte",+ "settings": "Einstellungen",+ "transfers": "Umlagerungen"+ },+ "option_types": {+ "columns": {+ "values": "Werte"+ },+ "kinds": {+ "buttons": "Schaltflächen",+ "color_swatch": "Farbfeld",+ "dropdown": "Dropdown"+ },+ "messages": {+ "created": "Optionstyp erstellt",+ "deleted": "Optionstyp gelöscht",+ "updated": "Optionstyp aktualisiert"+ },+ "table": {+ "empty": "Noch keine Optionstypen",+ "search_placeholder": "Nach Name suchen…"+ },+ "value_count_one": "{{count}} Wert",+ "value_count_other": "{{count}} Werte"+ },+ "order_routing_rules": {+ "messages": {+ "created": "Routing-Regel hinzugefügt",+ "deleted": "Routing-Regel entfernt"+ },+ "types": {+ "default_location": {+ "description": "Bevorzugt den als Standard markierten Lagerort",+ "name": "Standard-Lagerort"+ },+ "minimize_splits": {+ "description": "Bevorzugt den Lagerort, der die meisten Artikel allein liefern kann, und vermeidet Teillieferungen",+ "name": "Teillieferungen minimieren"+ },+ "preferred_location": {+ "description": "Versand vom am Auftrag hinterlegten Lagerort, sofern gesetzt",+ "name": "Bevorzugter Lagerort"}+ }+ },+ "orders": {+ "columns": {+ "customer": "Kunde",+ "date": "Datum",+ "fulfillment": "Abwicklung",+ "items": "Artikel",+ "number": "Nummer",+ "payment": "Zahlung",+ "sku": "SKU",+ "tags": "Tags"},- "rule_types": {- "category": {- "name": "Kategorien",- "description": "Bestellung enthält Produkte aus den angegebenen Kategorien"+ "detail": {+ "add_line_item": {+ "title": "Position hinzufügen"},- "country": {- "name": "Land",- "description": "Auf Bestellungen mit Lieferadresse in einem bestimmten Land beschränken"+ "address_edit": {+ "billing_title": "Rechnungsadresse bearbeiten",+ "shipping_title": "Lieferadresse bearbeiten"+ },+ "adjustment_lines": {+ "add_discount": "Rabatt hinzufügen",+ "add_discount_description": "Erstellt einen manuellen Rabatt. Ohne Zielposition wird der Betrag auf alle Positionen verteilt.",+ "add_fee": "Gebühr hinzufügen",+ "add_fee_description": "Erstellt eine Gebühr wie Zuschlag, Bearbeitung oder Geschenkverpackung.",+ "amount_field": "Betrag",+ "delete_discount_message": "Rabatt \"{{label}}\" aus dieser Bestellung entfernen? Die Summen werden neu berechnet.",+ "delete_discount_title": "Rabatt löschen",+ "delete_fee_message": "Gebühr \"{{label}}\" aus dieser Bestellung entfernen? Die Summen werden neu berechnet.",+ "delete_fee_title": "Gebühr löschen",+ "discounts": "Rabatte",+ "empty": "Noch keine Steuern, Rabatte oder Gebühren für diese Bestellung.",+ "fees": "Gebühren",+ "kind_field": "Art",+ "kind_promotion": "Aktion",+ "label_field": "Bezeichnung",+ "target_field": "Gilt für",+ "target_order": "Gesamte Bestellung",+ "taxes": "Steuern",+ "title": "Steuern, Rabatte & Gebühren",+ "value_field": "Wert",+ "value_type_field": "Typ",+ "value_type_flat": "Betrag",+ "value_type_percent": "Prozent"},- "currency": {- "name": "Währung",- "description": "Auf Bestellungen in einer bestimmten Währung beschränken"+ "completed_prefix": "Abgeschlossen",+ "confirm": {+ "approve_message": "Diesen Auftrag genehmigen?",+ "cancel_message": "Möchten Sie diesen Auftrag wirklich stornieren?",+ "cancel_shipment_message": "Diese Lieferung stornieren?",+ "capture_message": "Diese Zahlung einziehen?",+ "complete_message": "Diesen Auftragsentwurf jetzt abschließen?",+ "remove_gift_card_message": "Diese Geschenkkarte aus dem Auftrag entfernen?",+ "remove_item_message": "Diesen Artikel aus dem Auftrag entfernen?",+ "remove_store_credit_message": "Guthaben aus dem Auftrag entfernen?",+ "resume_message": "Diesen stornierten Auftrag wieder aufnehmen?",+ "ship_message": "Diese Lieferung versenden?",+ "void_message": "Diese Zahlung stornieren?"},- "customer": {- "name": "Kunden",- "description": "Nur für die angegebenen Kunden verfügbar"+ "dropdown": {+ "cancel_shipment": "Lieferung stornieren",+ "complete_order": "Auftrag abschließen",+ "edit_quantity": "Menge bearbeiten",+ "preview_order": "Auftrag in der Vorschau anzeigen",+ "resend_confirmation": "Bestätigung erneut senden",+ "void_payment": "Zahlung stornieren"},- "customer_group": {- "name": "Kundengruppe(n)",- "description": "Nur für Kunden in den angegebenen Kundengruppen verfügbar"+ "edit_quantity": {+ "description": "Legen Sie die Menge für diese Position fest.",+ "title": "Menge bearbeiten"},- "customer_logged_in": {- "name": "Nur angemeldete Kunden",- "description": "Nur für angemeldete Kunden verfügbar"+ "errors": {+ "approve_failed": "Auftrag konnte nicht genehmigt werden",+ "cancel_failed": "Auftrag konnte nicht storniert werden",+ "complete_failed": "Auftrag konnte nicht abgeschlossen werden",+ "confirmation_send_failed": "Bestätigung konnte nicht gesendet werden",+ "resume_failed": "Auftrag konnte nicht wieder aufgenommen werden"},- "first_order": {- "name": "Erste Bestellung",- "description": "Muss die erste Bestellung des Kunden sein"+ "gift_card_section": {+ "applied_suffix": "angewendet",+ "apply_balance": "Verfügbares Guthaben des Kunden anwenden",+ "apply_dialog_description": "Geben Sie einen Geschenkkartencode ein, der auf diesen Auftrag angewendet werden soll.",+ "apply_dialog_title": "Geschenkkarte anwenden",+ "code_placeholder": "GIFT-XXXX-YYYY",+ "gift_card_label": "Geschenkkarte",+ "none_applied": "Keine angewendet",+ "requires_customer": "Erfordert einen Kunden",+ "store_credit_label": "Guthaben",+ "title": "Geschenkkarte & Guthaben"},- "item_total": {- "name": "Warenwert",- "description": "Bestellsumme erfüllt diese Kriterien"+ "items_table": {+ "item": "Artikel",+ "price": "Preis",+ "qty": "Anz."},- "one_use_per_user": {- "name": "Einmalige Nutzung pro Benutzer",- "description": "Nur einmalige Nutzung pro Benutzer"+ "load_failed_message": "Auftrag {{orderId}} konnte nicht geladen werden.",+ "messages": {+ "approved": "Auftrag genehmigt",+ "canceled": "Auftrag storniert",+ "captured": "Zahlung eingezogen",+ "completed": "Auftrag abgeschlossen",+ "confirmation_sent": "Bestätigung gesendet",+ "resumed": "Auftrag wieder aufgenommen",+ "shipped": "Lieferung versendet",+ "voided": "Zahlung storniert"},- "option_value": {- "name": "Optionswert(e)",- "description": "Bestellung enthält Produkte mit übereinstimmenden Optionswerten"+ "no_customer": "Keine Kundeninformationen",+ "no_line_items": "Keine Positionen",+ "payment_form": {+ "amount_help": "Leer lassen, um standardmäßig den offenen Saldo zu verwenden.",+ "capture_immediately": "Sofort einziehen",+ "description": "Belasten Sie eine Zahlungsmethode für diesen Auftrag.",+ "method_label": "Zahlungsmethode",+ "method_placeholder": "Zahlungsmethode auswählen",+ "no_saved_cards": "Der Kunde hat keine gespeicherten Karten für diese Zahlungsmethode.",+ "source_label": "Quelle",+ "source_placeholder": "Gespeicherte Karte auswählen…",+ "source_requires_customer": "Diese Zahlungsmethode erfordert eine gespeicherte Quelle. Weisen Sie der Bestellung zunächst einen Kunden zu.",+ "title": "Zahlung hinzufügen"},- "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"+ "payments_table": {+ "method": "Methode",+ "number": "Nummer",+ "state": "Status"},- "create_item_adjustments": {- "name": "Anpassung je Bestellposition erstellen",- "description": "Erstellt eine Aktionsgutschrift als Anpassung für eine Bestellposition"+ "section_customer_note": "Besondere Anweisungen",+ "section_internal_note": "Interne Notiz",+ "summary": {+ "adjustments": "Anpassungen",+ "approved_by": "Genehmigt von",+ "canceled_at": "Storniert am",+ "canceler": "Storniert von",+ "outstanding_balance": "Offener Saldo",+ "payment_total": "Zahlungssumme",+ "promotions": "Aktionen",+ "tax_additional": "Steuer (zusätzlich)",+ "tax_included": "Steuer (inklusive)"},- "create_line_items": {- "name": "Bestellpositionen erstellen",- "description": "Fügt dem Warenkorb die angegebene Menge der Variante hinzu"+ "tracking": {+ "add_title": "Sendungsverfolgung hinzufügen",+ "description": "Aktualisieren Sie die Sendungsnummer für diese Lieferung.",+ "edit_title": "Sendungsverfolgung bearbeiten",+ "label": "Sendungsnummer",+ "prefix": "Tracking",+ "shipped_prefix": "Versendet"},- "free_shipping": {- "name": "Kostenloser Versand",- "description": "Macht alle Sendungen der Bestellung kostenlos"+ "variant_search": {+ "description": "Suchen Sie nach einer Produktvariante, die diesem Auftrag hinzugefügt werden soll.",+ "empty": "Keine Varianten gefunden",+ "label": "Variante suchen",+ "placeholder": "Produktname oder SKU eingeben (min. 3 Zeichen)…",+ "sku_prefix": "SKU"}},- "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"+ "fulfillment_statuses": {+ "backorder": "Lieferrückstand",+ "canceled": "Storniert",+ "fulfilled": "Abgewickelt",+ "partial": "Teilweise",+ "pending": "Ausstehend",+ "ready": "Bereit"},- "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"+ "item_count_one": "{{count}} Artikel",+ "item_count_other": "{{count}} Artikel",+ "new": {+ "add_variant": "Variante hinzufügen",+ "creates_draft_note": "Erstellt einen Auftragsentwurf. Fügen Sie nach der Erstellung Zahlungen hinzu und schließen Sie ihn ab.",+ "items_table": {+ "qty": "Anz.",+ "sku": "SKU",+ "variant": "Variante"+ },+ "use_default_addresses": "Standard-Rechnungs- und Lieferadresse des Kunden verwenden"},- "custom_fields": {- "section_title": "Benutzerdefinierte Felder",- "set_up": "Benutzerdefinierte Felder einrichten",- "manage_in_settings": "In den Einstellungen verwalten",- "empty_title": "Noch keine benutzerdefinierten Felder",- "empty_description": "Erfassen Sie strukturierte Details wie Material, Passform oder Pflegehinweise.",- "values_saved": "Benutzerdefinierte Felder gespeichert",- "values_save_partial_failed": "Einige benutzerdefinierte Felder konnten nicht gespeichert werden: {{fields}}",- "new_definition_title": "Neues benutzerdefiniertes Feld",- "new_definition_description": "Definieren Sie ein benutzerdefiniertes Feld, um typisierte, strukturierte Informationen zu Ihren {{resource}} zu speichern.",- "default_resource": "Datensätzen",- "errors": {- "failed_to_save": "Benutzerdefiniertes Feld konnte nicht gespeichert werden"- }+ "payment_statuses": {+ "balance_due": "Offener Betrag",+ "credit_owed": "Guthaben",+ "failed": "Fehlgeschlagen",+ "paid": "Bezahlt",+ "void": "Storniert"},- "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"+ "statuses": {+ "canceled": "Storniert",+ "draft": "Entwurf",+ "placed": "Aufgegeben"+ },+ "table": {+ "empty": "Keine Bestellungen gefunden",+ "search_placeholder": "Bestellungen suchen…"}},"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"+ "channels": {+ "add_cta": "Neuer Verkaufskanal",+ "add_sheet_title": "Verkaufskanal hinzufügen",+ "create_description": "Verkaufskanäle gruppieren Bestellungen und Produktlistings — \"online\", \"pos\", eine Marktplatz-Integration usw.",+ "create_label": "Verkaufskanal erstellen",+ "delete_confirm": {+ "message": "{{name}} wird entfernt. Damit verknüpfte Produkte und Bestellungen verlieren ihre Verkaufskanal-Referenz.",+ "title": "Verkaufskanal löschen?"},- "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."- },- "order_routing_rules": {- "title": "Auftragsrouting-Regeln",- "help": "Bei der Routing-Strategie „Regeln (geordnet)“ werden die Regeln von oben nach unten ausgewertet – die erste Regel, die einen Lagerort eindeutig bestimmt, gewinnt; bei Gleichstand entscheidet die nächste Regel.",- "empty": "Keine Routing-Regeln – Bestellungen verwenden den Standard-Lagerort.",- "add_cta": "Regel hinzufügen",- "picker_title": "Routing-Regel hinzufügen",- "edit_preferences": "Regel-Einstellungen bearbeiten",- "active_toggle": "Regel aktiv",- "delete_confirm": {- "title": "Routing-Regel löschen?",- "message": "{{name}} wird aus der Routing-Reihenfolge dieses Kanals entfernt."- }+ "edit_description": "Benennen Sie einen Verkaufskanal um oder pausieren Sie ihn. Inaktive Verkaufskanäle nehmen keine Bestellungen mehr an.",+ "edit_sheet_title": "Verkaufskanal bearbeiten",+ "empty_message": "Noch keine Verkaufskanäle",+ "no_channels_found": "Keine Verkaufskanäle gefunden",+ "order_routing_rules": {+ "active_toggle": "Regel aktiv",+ "add_cta": "Regel hinzufügen",+ "delete_confirm": {+ "message": "{{name}} wird aus der Routing-Reihenfolge dieses Kanals entfernt.",+ "title": "Routing-Regel löschen?"+ },+ "edit_preferences": "Regel-Einstellungen bearbeiten",+ "empty": "Keine Routing-Regeln – Bestellungen verwenden den Standard-Lagerort.",+ "help": "Bei der Routing-Strategie „Regeln (geordnet)“ werden die Regeln von oben nach unten ausgewertet – die erste Regel, die einen Lagerort eindeutig bestimmt, gewinnt; bei Gleichstand entscheidet die nächste Regel.",+ "picker_title": "Routing-Regel hinzufügen",+ "title": "Auftragsrouting-Regeln"},"search_placeholder": "Verkaufskanäle suchen…",- "no_channels_found": "Keine Verkaufskanäle gefunden",+ "title": "Verkaufskanäle","validation": {"code_format": "Nur Kleinbuchstaben, Zahlen, Bindestriche und Unterstriche"}},"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",+ "add_address": "Adresse hinzufügen",+ "addresses_empty": "Keine Adressen hinterlegt.",+ "edit_address": "Adresse bearbeiten",+ "edit_credit": "Guthaben bearbeiten",+ "issue_credit": "Guthaben ausstellen",+ "orders_empty": "Noch keine Bestellungen.","section_addresses": "Adressen",+ "section_internal_note": "Interne Notiz","section_orders": "Bestellungen",+ "section_profile": "Profil","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"- }+ "stat_avg_order_value": "Durchschn. Bestellwert",+ "stat_orders": "Bestellungen",+ "stat_total_spent": "Gesamtausgaben",+ "store_credit_empty": "Kein Guthaben ausgegeben."+ },+ "edit_sheet_title": "Kunde bearbeiten",+ "groups": {+ "add_cta": "Kundengruppe hinzufügen",+ "add_sheet_title": "Kundengruppe hinzufügen",+ "edit_sheet_title": "Kundengruppe bearbeiten",+ "title": "Kundengruppen"+ },+ "groups_cta": "Kundengruppen",+ "new_cta": "Neuer Kunde"},- "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…"+ "getting_started": {+ "description": "Schließen Sie diese Schritte ab, um Ihren Shop zu starten.",+ "progress": "{{done}} von {{total}} erledigt",+ "storefront_sheet": {+ "api_url_label": "Store API URL",+ "deploy_button": "Auf Vercel bereitstellen",+ "deploy_copy": "Die Bereitstellung klont das Open-Source-Storefront in Ihr Git-Konto und baut es auf Vercel mit vorausgefüllten Zugangsdaten. Kopieren Sie anschließend dessen URL in das Feld unten.",+ "deploy_title": "Empfohlen: das offizielle Next.js-Storefront bereitstellen",+ "description": "Verwenden Sie diese Zugangsdaten in jedem Client, der mit der Store API kommuniziert — Web-Storefront, mobile App oder anderes.",+ "env_description": "Ihre Spree Store API URL und Ihr Publishable Key. Beide sind aus Ihrem Store vorausgefüllt — passen Sie sie bei Bedarf vor der Bereitstellung an.",+ "invalid_url": "Das sieht nicht nach einer gültigen Storefront-URL aus.",+ "key_error": "Ihr Publishable API-Schlüssel konnte nicht geladen werden.",+ "local_installation_instructions": "Anleitung zur lokalen Installation",+ "publishable_key_label": "Publishable API-Schlüssel",+ "save": "Speichern & Einrichtung abschließen",+ "saved": "Storefront-URL gespeichert: {{url}}",+ "see_online_demo": "Online-Demo ansehen",+ "storefront_url_help": "Die URL, über die Kunden Ihr Storefront erreichen. Sie wird zur Basis für Links in Kunden-E-Mails und automatisch als zugelassener Origin hinzugefügt, damit browserbasierte Storefronts die Store API aufrufen können.",+ "storefront_url_label": "Storefront-URL",+ "storefront_url_placeholder": "https://myshop.com",+ "title": "Storefront verbinden"},- "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"+ "tasks": {+ "add_products": {+ "cta": "Produkte hinzufügen",+ "description": "Fügen Sie Ihrem Shop Produkte hinzu — eigene oder laden Sie Drittanbieter ein, gemeinsam zu verkaufen.",+ "import_cta": "Produkte aus CSV importieren",+ "title": "Produkte hinzufügen"},- "empty_payments": "Noch keine Zahlungen.",- "empty_shipments": "Noch keine Sendungen.",- "no_delivery_method": "Keine Versandmethode ausgewählt.",- "empty_history": "Noch kein Verlauf.",+ "set_customer_support_email": {+ "cta": "E-Mail-Einstellungen",+ "description": "Wird in Ihrem Storefront als Kontaktpunkt für Kundenfragen und Support angezeigt.",+ "title": "Kundensupport-E-Mail festlegen"+ },+ "setup_payment_method": {+ "cta": "Zahlungsmethoden einrichten",+ "description": "Um Zahlungen zu empfangen, richten Sie mindestens einen Online-Zahlungsanbieter ein.",+ "title": "Zahlungsmethoden einrichten"+ },+ "setup_storefront": {+ "cta": "Storefront verbinden",+ "description": "Verbinden Sie Ihr Web-Storefront oder Ihre mobile App mit Ihren Store-API-Zugangsdaten und speichern Sie Ihre Storefront-URL.",+ "title": "Storefront einrichten"+ },+ "setup_taxes_collection": {+ "cta": "Steuereinstellungen",+ "description": "Um Steuern zu erheben, richten Sie Ihre Steuersätze ein.",+ "title": "Steuererhebung einrichten"+ }+ },+ "title": "Erste Schritte"+ },+ "home": {+ "columns": {+ "price": "Preis",+ "product": "Produkt",+ "sold": "Verkauft"+ },+ "metric_short": {+ "avg_order_value": "Ø-Wert",+ "orders": "Bestellungen",+ "sales": "Umsatz"+ },+ "metrics": {+ "avg_order_value": "Ø Bestellwert",+ "orders": "Bestellungen gesamt",+ "sales": "Gesamtumsatz"+ },+ "subtitle": "Überblick über die Leistung Ihres Shops",+ "title": "Dashboard",+ "top_products": "Top-Produkte",+ "top_products_description": "Meistverkaufte Produkte in Ihrem Shop."+ },+ "orders": {+ "detail": {"actions": {"approve": "Genehmigen","cancel": "Bestellung stornieren",- "resume": "Fortsetzen",- "refund": "Erstatten","capture": "Einziehen",- "void": "Stornieren","mark_paid": "Als bezahlt markieren",- "ship": "Als versendet markieren"+ "refund": "Erstatten",+ "resume": "Fortsetzen",+ "ship": "Als versendet markieren",+ "void": "Stornieren"},"dialogs": {- "cancel_title": "Bestellung stornieren?","approve_title": "Bestellung genehmigen?",+ "cancel_title": "Bestellung stornieren?","refund_title": "Zahlung erstatten?"+ },+ "empty_history": "Noch kein Verlauf.",+ "empty_payments": "Noch keine Zahlungen.",+ "empty_shipments": "Noch keine Sendungen.",+ "no_delivery_method": "Keine Versandmethode ausgewählt.",+ "section_billing_address": "Rechnungsadresse",+ "section_customer": "Kunde",+ "section_customer_note": "Kundennotiz",+ "section_fulfillments": "Fulfillments",+ "section_history": "Verlauf",+ "section_internal_note": "Interne Notiz",+ "section_items": "Artikel",+ "section_payments": "Zahlungen",+ "section_shipping_address": "Lieferadresse",+ "section_summary": "Zusammenfassung",+ "summary": {+ "channel": "Verkaufskanal",+ "created_by": "Erstellt von",+ "ip_address": "IP-Adresse",+ "locale": "Sprache",+ "market": "Markt"}+ },+ "drafts_title": "Bestellentwürfe",+ "new": {+ "add_line_item": "Position hinzufügen",+ "search_variant": "Variante suchen…",+ "section_billing": "Rechnung",+ "section_customer": "Kunde",+ "section_items": "Artikel",+ "section_notes": "Notizen",+ "section_summary": "Zusammenfassung",+ "select_customer": "Kunde auswählen",+ "title": "Neue Bestellung"}},"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",- "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",- "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_add_failed": "Produkte konnten nicht zu Kategorien hinzugefügt werden",+ "categories_add_title": "Zu Kategorien hinzufügen",+ "categories_added": "{n} Produkte zu Kategorien hinzugefügt","categories_remove_description": "Wählen Sie die Kategorien, aus denen diese Produkte entfernt werden sollen.",- "channels_add_title": "Zu Verkaufskanälen hinzufügen",+ "categories_remove_failed": "Produkte konnten nicht aus Kategorien entfernt werden",+ "categories_remove_title": "Aus Kategorien entfernen",+ "categories_removed": "{n} Produkte aus Kategorien entfernt","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.",+ "channels_add_failed": "Produkte konnten nicht auf Verkaufskanälen gelistet werden",+ "channels_add_title": "Zu Verkaufskanälen hinzufügen",+ "channels_added": "{n} Produkte auf Verkaufskanälen gelistet",+ "channels_remove_description": "Wählen Sie die Verkaufskanäle, von denen diese Produkte ausgelistet werden sollen.",+ "channels_remove_failed": "Produkte konnten nicht von Verkaufskanälen ausgelistet werden",+ "channels_remove_title": "Aus Verkaufskanälen entfernen",+ "channels_removed": "{n} Produkte von Verkaufskanälen ausgelistet","delete_confirm": {- "title": "{n} Produkte löschen?",- "message": "Ausgewählte Produkte werden entfernt. Diese Aktion kann nicht rückgängig gemacht werden."+ "message": "Ausgewählte Produkte werden entfernt. Diese Aktion kann nicht rückgängig gemacht werden.",+ "title": "{n} Produkte löschen?"},- "status_updated": "Status für {n} Produkte aktualisiert",+ "delete_failed": "Produkte konnten nicht gelöscht werden",+ "deleted": "{n} Produkte gelöscht",+ "remove_categories_action": "Aus Kategorien entfernen…",+ "remove_channels_action": "Aus Verkaufskanälen entfernen…",+ "remove_tags_action": "Tags entfernen…",+ "set_status_action": "Status festlegen…",+ "status_sheet_description": "Wählen Sie den Status, der auf die ausgewählten Produkte angewendet werden soll.",+ "status_sheet_title": "Produktstatus festlegen","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",+ "status_updated": "Status für {n} Produkte aktualisiert",+ "tags_add_description": "Wählen oder erstellen Sie Tags, die zu diesen Produkten hinzugefügt werden sollen.","tags_add_failed": "Tags konnten nicht hinzugefügt werden",- "tags_removed": "Tags von {n} Produkten entfernt",+ "tags_add_title": "Tags hinzufügen",+ "tags_added": "Tags zu {n} Produkten hinzugefügt",+ "tags_remove_description": "Wählen Sie Tags, die von diesen Produkten entfernt werden sollen.","tags_remove_failed": "Tags konnten nicht entfernt werden",- "deleted": "{n} Produkte gelöscht",- "delete_failed": "Produkte konnten nicht gelöscht werden"+ "tags_remove_title": "Tags entfernen",+ "tags_removed": "Tags von {n} Produkten entfernt"},- "media_empty": "Noch keine Medien.",- "media_upload": "Medien hochladen",- "variants_empty": "Noch keine Varianten.",- "status_options": {- "draft": "Entwurf",- "active": "Aktiv",- "archived": "Archiviert"+ "clone_failed": "Produkt konnte nicht dupliziert werden",+ "clone_succeeded": "Produkt dupliziert",+ "delete_failed": "Produkt konnte nicht gelöscht werden",+ "delete_succeeded": "Produkt gelöscht",+ "edit": {+ "bulk_prices": {+ "no_variants": "Fügen Sie mindestens eine Variante hinzu, um die Preisbearbeitung zu starten."+ }},"inventory": {- "out_of_stock": "Nicht auf Lager",+ "in_stock": "{{count}} auf Lager","on_backorder": "Im Rückstand",- "in_stock": "{{count}} auf Lager"+ "out_of_stock": "Nicht 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."+ "media_empty": "Noch keine Medien.",+ "media_upload": "Medien hochladen",+ "new": {+ "create_failed": "Produkt konnte nicht erstellt werden",+ "create_succeeded": "Produkt erstellt",+ "description": "Richten Sie Ihr Produkt ein — fügen Sie Varianten, Preise, Bestand, Medien und benutzerdefinierte Felder hinzu",+ "preview_slug_placeholder": "ihr-produkt-slug",+ "save_label": "Produkt erstellen",+ "title": "Neues Produkt"},"options": {+ "add_value": "Optionswert hinzufügen","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"- }+ },+ "values_empty": "Noch keine Werte.",+ "values_section": "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."+ "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.",+ "title": "Preisliste aktivieren?"},+ "add_cta": "Neue Preisliste",+ "add_products_cta": "Produkte hinzufügen",+ "add_rule": "Regel hinzufügen",+ "add_rule_help": "Wählen Sie einen Regeltyp zum Konfigurieren.",+ "basics_section": "Grunddaten",+ "deactivate": "Deaktivieren","deactivate_confirm": {- "title": "Preisliste deaktivieren?",- "message": "\"{{name}}\" gilt ab sofort nicht mehr für Kunden. Bestehende Bestellungen sind nicht betroffen."+ "message": "\"{{name}}\" gilt ab sofort nicht mehr für Kunden. Bestehende Bestellungen sind nicht betroffen.",+ "title": "Preisliste deaktivieren?"},- "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."+ "delete_confirm": {+ "message": "Beim Entfernen von \"{{name}}\" werden ihre Preise gelöscht. Dies kann nicht rückgängig gemacht werden.",+ "title": "Preisliste löschen?"},"edit_prices": {- "title": "Preise bearbeiten — {{name}}",- "currency_label": "Währung",- "empty": "Noch keine Produkte in dieser Liste.","add_products_link": "Produkte hinzufügen","columns": {+ "compare_at_price": "Vergleichspreis",+ "price": "Preis","product": "Produkt",- "variant": "Variante","sku": "SKU",- "price": "Preis",- "compare_at_price": "Vergleichspreis"+ "variant": "Variante"},- "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.",+ "currency_label": "Währung","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."- }+ "message_currency": "Beim Wechsel der Währung werden Ihre ungespeicherten Preise verworfen.",+ "title": "Ungespeicherte Preise verwerfen?"+ },+ "empty": "Noch keine Produkte in dieser Liste.",+ "empty_no_base_prices": "Noch keine Basispreise.",+ "empty_pick_products": "Wählen Sie Produkte auf der Preisliste aus, um mit der Preisfestlegung zu beginnen.",+ "grid_aria": "Variantenpreise",+ "no_matches_for_filters": "Keine Preise entsprechen den aktuellen Filtern.",+ "no_matches_for_search": "Keine Preise entsprechen \"{{search}}\".",+ "price_aria": "Preis für {{label}}",+ "save_cta": "Preise speichern",+ "save_failed": "Preise konnten nicht gespeichert werden",+ "save_success_one": "{{count}} Preis gespeichert",+ "save_success_other": "{{count}} Preise gespeichert",+ "search_placeholder": "Nach Produkt, SKU oder Option suchen…",+ "title": "Preise bearbeiten — {{name}}",+ "variant_default": "Standard"},+ "edit_prices_cta": "Preise bearbeiten",+ "no_changes": "Keine Änderungen zum Speichern.",+ "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.","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",- "tab_storefront_access": "Storefront-Zugriff"+ "products_empty_search": "Keine passenden Produkte",+ "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_section": "Produkte",+ "products_selected_one": "{{count}} Produkt ausgewählt.",+ "products_selected_other": "{{count}} Produkte ausgewählt.",+ "remove_rule_confirm": {+ "message": "Die Regel wird entfernt, wenn Sie die Preisliste speichern.",+ "title": "Regel entfernen?"+ },+ "remove_selected": "Auswahl entfernen",+ "rule_click_to_configure": "Zum Konfigurieren klicken",+ "rule_default_description": "Passen Sie die Parameter der Regel an.",+ "rule_name_overflow": "{{names}} +{{count}} weitere",+ "rule_no_options": "Diese Regel hat keine konfigurierbaren Optionen — ihre bloße Existenz wendet die Einschränkung an.",+ "rule_types_all_used": "Jeder verfügbare Regeltyp befindet sich bereits auf dieser Liste.",+ "rule_types_empty": "Keine Regeltypen registriert.",+ "rules_empty": "Keine Regeln — diese Liste gilt für jeden Käufer.",+ "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_section": "Regeln",+ "schedule": "Planen",+ "schedule_confirm": {+ "message": "\"{{name}}\" geht am {{starts_at}} live und bleibt bis zum Enddatum aktiv.",+ "title": "Preisliste planen?"+ },+ "schedule_section": "Zeitplan",+ "sheet_title_create": "Preisliste erstellen",+ "sheet_title_edit": "Preisliste bearbeiten",+ "subtitle": "Gezielte Preisgestaltung für Kundengruppen, Regionen oder Mengenstaffeln.",+ "title": "Preislisten",+ "unschedule": "Planung aufheben",+ "unschedule_confirm": {+ "message": "\"{{name}}\" wird am geplanten Datum nicht mehr aktiviert. Sie können sie später erneut planen oder manuell aktivieren.",+ "title": "Planung der Preisliste aufheben?"+ }},- "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.",- "load_failed_title": "E-Mail-Einstellungen konnten nicht geladen werden"+ "publishing": {+ "caption_hidden_after": "Wird am {{date}} ausgeblendet",+ "caption_live": "Jetzt für Kunden sichtbar",+ "caption_not_available": "Ausgeblendet — Produkt ist {{product_status}}",+ "caption_scheduled": "Geht am {{date}} live",+ "caption_unpublished": "Wurde am {{date}} ausgeblendet",+ "caption_window": "Live {{start}} → {{end}}",+ "empty": "Noch auf keinem Verkaufskanal gelistet.",+ "inactive_marker": "Inaktiv",+ "manage_cta": "Verwalten",+ "manage_description": "Wählen Sie aus, welche Verkaufskanäle dieses Produkt listen. Deaktivieren Sie einen Kanal, um es überall auszulisten.",+ "manage_title": "Verkaufskanäle verwalten",+ "no_channels": "Keine Verkaufskanäle verfügbar. Erstellen Sie einen unter Einstellungen → Verkaufskanäle.",+ "status_hidden": "Ausgeblendet",+ "status_live": "Live",+ "status_not_available": "Nicht verfügbar",+ "status_scheduled": "Geplant",+ "title": "Veröffentlichung"},- "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",+ "section_basics": "Grunddaten",+ "section_categorization": "Kategorisierung",+ "section_inventory": "Bestand",+ "section_media": "Medien",+ "section_organization": "Organisation",+ "section_pricing": "Preisgestaltung",+ "section_seo": "SEO",+ "section_variants": "Varianten",+ "status_options": {+ "active": "Aktiv",+ "archived": "Archiviert",+ "draft": "Entwurf"+ },+ "transfers": {+ "description_external": "Externer Wareneingang in <strong>{{destination}}</strong>.",+ "description_internal": "Bestand verschoben von <strong>{{source}}</strong> nach <strong>{{destination}}</strong>.",+ "edit_sheet_title": "Übertragung {{number}}",+ "items_empty": "Noch keine Artikel.",+ "section_from": "Von",+ "section_items": "Artikel",+ "section_to": "Nach",+ "sheet_title": "Neue Bestandsübertragung"+ },+ "variants_empty": "Noch keine Varianten.",+ "variants_one": "{{count}} Variante",+ "variants_other": "{{count}} Varianten"+ },+ "profile": {+ "load_failed_title": "Ihr Profil konnte nicht geladen werden",+ "personal_details": "Persönliche Daten",+ "subtitle": "Verwalten Sie Ihre persönlichen Daten und Ihre Admin-Sprache.",+ "title": "Profil"+ },+ "promotions": {+ "create_cta": "Aktion erstellen",+ "gift_cards": {+ "batch_section": "Stapel",+ "create_batch_cta": "{{count}} Geschenkkarten erstellen",+ "create_label": "Geschenkkarte erstellen","delete_confirm": {- "title": "Webhook-Endpunkt löschen?",- "message": "{{name}} erhält ab sofort keine Zustellungen mehr. Der bisherige Zustellverlauf wird ebenfalls entfernt."+ "message": "Dadurch wird die Geschenkkarte storniert und kann nicht mehr eingelöst werden.",+ "title": "Geschenkkarte löschen?"},- "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"+ "edit_sheet_title": "Geschenkkarte",+ "new_cta": "Neue Geschenkkarte",+ "new_sheet_title": "Neue Geschenkkarte",+ "no_customer": "Kein Kunde zugeordnet",+ "not_found": "Geschenkkarte nicht gefunden.",+ "prefix": {+ "auto_placeholder": "Wird automatisch generiert, wenn leer",+ "label": "Präfix",+ "placeholder": "z. B. WELCOME — Codes lauten dann WELCOME-abc123"},- "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.",+ "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."+ },+ "status_options": {+ "expired": "Abgelaufen",+ "redeemed": "Eingelöst",+ "void": "Storniert"+ },+ "usage": {+ "issued_by": "Ausgestellt von",+ "remaining": "Verbleibend",+ "title": "Nutzung",+ "used": "Verwendet"+ },+ "validation": {+ "amount_positive": "Der Betrag muss größer als null sein",+ "amount_required": "Der Betrag ist erforderlich",+ "currency_required": "Die Währung ist erforderlich",+ "prefix_required": "Für Stapel ist ein Präfix erforderlich"+ }+ },+ "loading": "Aktion wird geladen…",+ "new_title": "Neue Aktion"+ },+ "settings": {+ "allowed_origins": {+ "add_sheet_title": "Erlaubten Ursprung hinzufügen",+ "edit_sheet_title": "Erlaubten Ursprung bearbeiten"+ },+ "api_keys": {+ "empty_publishable": "Noch keine veröffentlichbaren Schlüssel.",+ "empty_secret": "Noch keine geheimen Schlüssel.",+ "new_cta": "Neuer Schlüssel",+ "publishable_help": "Wird von Ihrem Storefront verwendet. Kann gefahrlos im clientseitigen Code offengelegt werden.",+ "publishable_section": "Veröffentlichbare Schlüssel",+ "save_secret_description": "Kopieren Sie diesen Wert jetzt — wir zeigen ihn nicht erneut an.",+ "save_secret_title": "Speichern Sie Ihren geheimen Schlüssel",+ "scope_badge": {+ "full_access": "Vollzugriff",+ "read_all": "Alles lesen"+ },+ "secret_help": "Nur Server-zu-Server. Beschränken Sie jeden Schlüssel auf die benötigten Operationen.",+ "secret_section": "Geheime Schlüssel",+ "subtitle": "Autorisieren Sie Integrationen und Apps für den Zugriff auf die Admin-API.",+ "table": {+ "all_channels": "All channels",+ "channel": "Channel",+ "key": "Schlüssel",+ "last_used_at": "Zuletzt verwendet",+ "scopes": "Berechtigungen"+ },+ "title": "API-Schlüssel"+ },+ "custom_field_definitions": {+ "add_sheet_title": "Benutzerdefiniertes Feld hinzufügen",+ "edit_sheet_title": "Benutzerdefiniertes Feld bearbeiten"+ },+ "emails": {+ "load_failed_title": "E-Mail-Einstellungen konnten nicht geladen werden",+ "logo_dimensions_help": "Empfohlen: 204×104 Pixel.",+ "section_addresses": "E-Mail-Adressen",+ "section_delivery": "Zustellung",+ "section_logo": "Logo",+ "subtitle": "Absenderadressen, Benachrichtigungen und das in Transaktions-E-Mails eingebettete Logo.",+ "title": "E-Mail-Einstellungen"+ },+ "imports": {+ "delete_confirm": {+ "message": "Dies entfernt {{number}}, seine Zeilen und die hochgeladene Datei.",+ "title": "Import löschen?"+ },+ "empty_title": "Noch keine Importe",+ "search_placeholder": "Nach Nummer suchen…",+ "table": {+ "failed_count": "{{failed}} fehlgeschlagen",+ "number": "Nummer",+ "rows": "Zeilen",+ "status": "Status",+ "type": "Typ"+ },+ "title": "Importe"+ },+ "markets": {+ "add_sheet_title": "Markt hinzufügen",+ "edit_sheet_title": "Markt bearbeiten"+ },+ "payment_methods": {+ "add_sheet_title": "Zahlungsmethode hinzufügen",+ "edit_sheet_title": "Zahlungsmethode bearbeiten"+ },+ "stock_locations": {+ "add_sheet_title": "Lagerstandort hinzufügen",+ "edit_sheet_title": "Lagerstandort bearbeiten",+ "search_placeholder": "Lagerstandorte suchen…"+ },+ "store": {+ "subtitle": "Allgemeine Konfiguration und shopweite Standardwerte.",+ "tab_general": "Allgemein",+ "tab_standards": "Standards und Formate",+ "tab_storefront_access": "Storefront-Zugriff",+ "title": "Shop-Einstellungen"+ },+ "tax_categories": {+ "add_sheet_title": "Steuerkategorie hinzufügen",+ "edit_sheet_title": "Steuerkategorie bearbeiten"+ },+ "webhooks": {"actions": {- "send_test": "Test senden","disable": "Deaktivieren","enable": "Wieder aktivieren",- "view_deliveries": "Zustellungen anzeigen",- "redeliver": "Erneut zustellen"+ "redeliver": "Erneut zustellen",+ "send_test": "Test senden",+ "view_deliveries": "Zustellungen anzeigen"},- "status": {- "inactive": "Inaktiv",- "disabled": "Automatisch deaktiviert",- "disabled_reason": "Deaktiviert: {{reason}}"+ "add_sheet_title": "Webhook-Endpunkt hinzufügen",+ "delete_confirm": {+ "message": "{{name}} erhält ab sofort keine Zustellungen mehr. Der bisherige Zustellverlauf wird ebenfalls entfernt.",+ "title": "Webhook-Endpunkt löschen?"},- "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"+ "deliveries": {+ "detail": {+ "copy_payload_aria": "Anfrage-Payload kopieren",+ "copy_response_aria": "Antworttext kopieren",+ "delivered_at": "Zugestellt am",+ "error_type": "Fehlertyp",+ "event": "Ereignis",+ "execution_time": "Ausführungszeit",+ "request_errors": "Transportfehler",+ "request_payload": "Anfrage-Payload",+ "response_body": "Antworttext",+ "response_body_truncated": "Der Antworttext wurde auf {{limit}} Zeichen gekürzt.",+ "response_code": "Antwortcode",+ "url": "Ziel-URL"+ },+ "detail_sheet_title": "Zustelldetails",+ "empty": "Noch keine Zustellungen — senden Sie einen Test, um Ihren Endpunkt zu verifizieren.",+ "redeliver_queued": "Erneute Zustellung in Warteschlange gestellt.",+ "search_placeholder": "Nach Ereignisnamen suchen…",+ "status": {+ "error": "Fehler",+ "failure": "Fehlgeschlagen",+ "pending": "Ausstehend",+ "success": "Erfolgreich"+ },+ "table": {+ "code": "Antwort",+ "delivered_at": "Zugestellt am",+ "event": "Ereignis",+ "execution_time": "Dauer"+ },+ "test_failed": "Test-Webhook konnte nicht gesendet werden.",+ "test_sent": "Test-Webhook in Warteschlange gestellt."},- "table": {- "url": "URL",- "events": "Ereignisse",- "recent_deliveries": "Letzte 7 Tage",- "last_delivery": "Letzte Zustellung",- "copy_url_aria": "URL kopieren"+ "deliveries_sheet_title": "Letzte Zustellungen",+ "detail": {+ "delete_label": "Endpunkt löschen",+ "details_title": "Details",+ "edit_title": "Endpunkt bearbeiten",+ "load_failed_title": "Dieser Webhook-Endpunkt konnte nicht geladen werden",+ "subscriptions": "Ereignisse",+ "url": "Ziel-URL"},- "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",+ "edit_sheet_title": "Webhook-Endpunkt bearbeiten",+ "empty_description": "Erstellen Sie einen Endpunkt, um bei jedem abonnierten Ereignis einen signierten POST zu erhalten.",+ "empty_title": "Noch keine Webhook-Endpunkte","event_groups": {"asset": "Asset","custom": "Benutzerdefiniert","customer": "Kunde","digital": "Digital",+ "fulfillment": "Fulfillment","gift_card": "Geschenkkarte","gift_card_batch": "Geschenkkarten-Stapel","import_export": "Import / Export",@@ -1513,7 +2133,6 @@"refund": "Erstattung","report": "Bericht","return": "Rücksendung",- "shipment": "Sendung","stock_item": "Bestandsartikel","stock_movement": "Bestandsbewegung","stock_reservation": "Bestandsreservierung",@@ -1522,1214 +2141,716 @@"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.",+ "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",+ "health": {+ "auto_disabled_alert": "Dieser Endpunkt wurde nach wiederholten Zustellfehlern automatisch deaktiviert.",+ "degraded": "Beeinträchtigt ({{percentage}} %)",+ "disabled": "Deaktiviert",+ "failing": "Fehlerhaft ({{percentage}} %)",+ "healthy": "Gesund ({{percentage}} %)",+ "label": "Zustand",+ "metric_failed": "Fehlgeschlagen",+ "metric_successful": "Erfolgreich",+ "metric_total": "Zustellungen",+ "no_deliveries": "Noch keine Zustellungen",+ "re_enable_cta": "Wieder aktivieren",+ "row_counters_failed_one": "{{count}} fehlgeschlagen",+ "row_counters_failed_other": "{{count}} fehlgeschlagen",+ "row_counters_successful_one": "{{count}} erfolgreich",+ "row_counters_successful_other": "{{count}} erfolgreich"+ },+ "new_cta": "Neuer Endpunkt",+ "save_secret_description": "Verifizieren Sie eingehende Webhook-Signaturen mit diesem Schlüssel. Wir zeigen ihn nicht erneut an.",+ "save_secret_title": "Speichern Sie Ihr Signaturgeheimnis",+ "search_placeholder": "Nach URL suchen…",+ "status": {+ "disabled": "Automatisch deaktiviert",+ "disabled_reason": "Deaktiviert: {{reason}}",+ "inactive": "Inaktiv"+ },+ "subtitle": "Abonnieren Sie HTTPS-Endpunkte für Ereignisse, die von Ihrem Shop ausgelöst werden.","table": {- "key": "Schlüssel",- "scopes": "Berechtigungen",- "last_used_at": "Zuletzt verwendet",- "channel": "Channel",- "all_channels": "All channels"+ "copy_url_aria": "URL kopieren",+ "events": "Ereignisse",+ "last_delivery": "Letzte Zustellung",+ "recent_deliveries": "Letzte 7 Tage",+ "url": "URL"},- "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"+ "title": "Webhooks"+ }+ },+ "staff": {+ "actions": {+ "remove": "Aus Team entfernen",+ "resend": "Erneut senden"},- "tax_categories": {- "add_sheet_title": "Steuerkategorie hinzufügen",- "edit_sheet_title": "Steuerkategorie bearbeiten"+ "edit_sheet": {+ "title": "Teammitglied 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"- },- "imports": {- "title": "Importe",- "search_placeholder": "Nach Nummer suchen…",- "empty_title": "Noch keine Importe",- "table": {- "number": "Nummer",- "type": "Typ",- "status": "Status",- "rows": "Zeilen",- "failed_count": "{{failed}} fehlgeschlagen"- },- "delete_confirm": {- "title": "Import löschen?",- "message": "Dies entfernt {{number}}, seine Zeilen und die hochgeladene Datei."- }- }- },- "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"- },- "getting_started": {- "title": "Erste Schritte",- "description": "Schließen Sie diese Schritte ab, um Ihren Shop zu starten.",- "progress": "{{done}} von {{total}} erledigt",- "tasks": {- "setup_payment_method": {- "title": "Zahlungsmethoden einrichten",- "description": "Um Zahlungen zu empfangen, richten Sie mindestens einen Online-Zahlungsanbieter ein.",- "cta": "Zahlungsmethoden einrichten"- },- "add_products": {- "title": "Produkte hinzufügen",- "description": "Fügen Sie Ihrem Shop Produkte hinzu — eigene oder laden Sie Drittanbieter ein, gemeinsam zu verkaufen.",- "cta": "Produkte hinzufügen",- "import_cta": "Produkte aus CSV importieren"- },- "set_customer_support_email": {- "title": "Kundensupport-E-Mail festlegen",- "description": "Wird in Ihrem Storefront als Kontaktpunkt für Kundenfragen und Support angezeigt.",- "cta": "E-Mail-Einstellungen"- },- "setup_taxes_collection": {- "title": "Steuererhebung einrichten",- "description": "Um Steuern zu erheben, richten Sie Ihre Steuersätze ein.",- "cta": "Steuereinstellungen"- },- "setup_storefront": {- "title": "Storefront einrichten",- "description": "Verbinden Sie Ihr Web-Storefront oder Ihre mobile App mit Ihren Store-API-Zugangsdaten und speichern Sie Ihre Storefront-URL.",- "cta": "Storefront verbinden"- }- },- "storefront_sheet": {- "title": "Storefront verbinden",- "description": "Verwenden Sie diese Zugangsdaten in jedem Client, der mit der Store API kommuniziert — Web-Storefront, mobile App oder anderes.",- "api_url_label": "Store API URL",- "publishable_key_label": "Publishable API-Schlüssel",- "deploy_title": "Empfohlen: das offizielle Next.js-Storefront bereitstellen",- "deploy_copy": "Die Bereitstellung klont das Open-Source-Storefront in Ihr Git-Konto und baut es auf Vercel mit vorausgefüllten Zugangsdaten. Kopieren Sie anschließend dessen URL in das Feld unten.",- "deploy_button": "Auf Vercel bereitstellen",- "env_description": "Ihre Spree Store API URL und Ihr Publishable Key. Beide sind aus Ihrem Store vorausgefüllt — passen Sie sie bei Bedarf vor der Bereitstellung an.",- "storefront_url_label": "Storefront-URL",- "storefront_url_help": "Die URL, über die Kunden Ihr Storefront erreichen. Sie wird zur Basis für Links in Kunden-E-Mails und automatisch als zugelassener Origin hinzugefügt, damit browserbasierte Storefronts die Store API aufrufen können.",- "save": "Speichern & Einrichtung abschließen",- "saved": "Storefront-URL gespeichert: {{url}}",- "invalid_url": "Das sieht nicht nach einer gültigen Storefront-URL aus.",- "see_online_demo": "Online-Demo ansehen",- "local_installation_instructions": "Anleitung zur lokalen Installation",- "key_error": "Ihr Publishable API-Schlüssel konnte nicht geladen werden.",- "storefront_url_placeholder": "https://myshop.com"- }- }- },- "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",- "validation": {- "role_required": "Wählen Sie eine Rolle",- "roles_required": "Wählen Sie mindestens eine Rolle"- }- },- "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."+ "empty": "Noch keine Teammitglieder",+ "empty_description": "Laden Sie ein Teammitglied ein, um an diesem Shop mitzuarbeiten.",+ "invitations_section": "Ausstehende Einladungen",+ "invite_cta": "Teammitglied einladen",+ "invite_sheet": {+ "description": "Wir senden ihm einen Link per E-Mail, um sein Passwort festzulegen.",+ "title": "Teammitglied einladen"},- "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."+ "members_section": "Mitglieder",+ "messages": {+ "removed": "Aus Team entfernt",+ "revoked": "Einladung widerrufen",+ "updated": "Team aktualisiert"},+ "subtitle": "Admin-Teammitglieder und Rollen verwalten","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."+ "member": "Mitglied",+ "role": "Rolle",+ "roles": "Rollen"},- "groups": {- "title": "Kundengruppen",- "empty": "In keinen Gruppen",- "edit_title": "Kundengruppen bearbeiten",- "edit_description": "Gruppen hinzufügen oder entfernen, denen dieser Kunde angehört.",- "save_failed": "Kundengruppen konnten nicht aktualisiert werden"- }- },- "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"+ "title": "Team"}},- "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.",- "code_placeholder": "GIFT-XXXX-YYYY"- },- "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"+ "payment_methods": {+ "add_cta": "Zahlungsmethode hinzufügen",+ "columns": {+ "storefront": "Onlineshop"},- "table": {- "search_placeholder": "Bestellungen suchen…",- "empty": "Keine Bestellungen gefunden"+ "create_description": "Wählen Sie einen Anbieter und konfigurieren Sie dessen Zugangsdaten.",+ "create_label": "Zahlungsmethode erstellen",+ "delete_confirm": {+ "message": "{{name}} steht beim Checkout nicht mehr zur Verfügung.",+ "title": "Zahlungsmethode löschen?"},- "columns": {- "number": "Nummer",- "date": "Datum",- "customer": "Kunde",- "payment": "Zahlung",- "fulfillment": "Abwicklung",- "items": "Artikel",- "tags": "Tags",- "sku": "SKU"+ "edit_description": "Aktualisieren Sie Name, Sichtbarkeit oder Status.",+ "empty": "Keine Zahlungsarten konfiguriert",+ "messages": {+ "created": "Zahlungsmethode erstellt",+ "deleted": "Zahlungsmethode gelöscht",+ "updated": "Zahlungsmethode aktualisiert"},- "item_count_one": "{{count}} Artikel",- "item_count_other": "{{count}} Artikel",- "statuses": {- "draft": "Entwurf",- "placed": "Aufgegeben",- "canceled": "Storniert"+ "provider_description": "Anbieter: {{provider}}",+ "search_placeholder": "Nach Name suchen…",+ "status": {+ "disabled": "Deaktiviert"},- "payment_statuses": {- "balance_due": "Offener Betrag",- "credit_owed": "Guthaben",- "failed": "Fehlgeschlagen",- "paid": "Bezahlt",- "void": "Storniert"+ "storefront": {+ "admin_only": "Nur Administration",+ "visible": "Sichtbar"},- "fulfillment_statuses": {- "backorder": "Lieferrückstand",- "canceled": "Storniert",- "partial": "Teilweise",- "pending": "Ausstehend",- "ready": "Bereit",- "fulfilled": "Abgewickelt"- }+ "title": "Zahlungsarten"+ },+ "preferences": {+ "additional_item": "Kosten für jeden weiteren Artikel",+ "amount": "Betrag",+ "base_amount": "Grundbetrag",+ "base_percent": "Grundprozentsatz",+ "currency": "Währung",+ "discount_amount": "Rabattbetrag",+ "first_item": "Kosten für den ersten Artikel",+ "flat_percent": "Fester Prozentsatz",+ "max_items": "Maximale Artikelanzahl",+ "max_quantity": "Höchstmenge",+ "min_quantity": "Mindestmenge",+ "minimal_amount": "Mindestbetrag",+ "normal_amount": "Normalbetrag",+ "percent": "Prozent",+ "preferred_amount": "Betrag",+ "preferred_percent": "Prozent"},"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",+ "columns": {+ "in_stock": "Auf Lager",+ "price": "Preis",+ "sku": "SKU"+ },+ "delete_confirm": "Möchten Sie dieses Produkt wirklich löschen?",+ "delete_label": "Produkt löschen",+ "inventory": {+ "backorder_aria": "Nachbestellung bei {{location}} zulassen",+ "columns": {+ "backorder": "Nachbestellung",+ "location": "Standort",+ "on_hand": "Verfügbar"+ },+ "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.",+ "on_hand_aria": "Verfügbar bei {{location}}",+ "unknown_location": "Unbekannter Standort"+ },"media": {+ "assigned_variants_help": "Wählen Sie die Varianten aus, die dieses Bild repräsentiert. Leer lassen, um es auf alle Varianten anzuwenden.",+ "assigned_variants_label": "Zugeordnete Varianten","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.",+ "file_types_hint": "PNG, JPG, WebP bis zu 10 MB","upload_failed": "Hochladen von {{name}} fehlgeschlagen: {{message}}","upload_status_failed": "Fehlgeschlagen"},+ "no_categories_found": "Keine Kategorien gefunden",+ "options": {+ "add_cta": "Optionstyp hinzufügen",+ "count_one": "{{count}} Wert",+ "count_other": "{{count}} Werte",+ "create_description": "Definieren Sie eine Option, die Varianten verwenden können (z. B. Größe, Farbe).",+ "create_label": "Optionstyp erstellen",+ "delete_confirm": {+ "message": "Dadurch werden auch alle zugehörigen Werte gelöscht. Varianten, die diese Werte verwenden, verlieren sie.",+ "title": "Optionstyp löschen?"+ },+ "edit_description": "Bearbeiten Sie den Optionstyp und seine Werte.",+ "image_upload_failed": "Bild konnte nicht hochgeladen werden",+ "kinds": {+ "buttons": "Schaltflächen",+ "color_swatch": "Farbmuster",+ "dropdown": "Dropdown"+ },+ "value_label_placeholder": "z. B. Small",+ "value_name_placeholder": "z. B. small",+ "values_help": "Werte zum Neuordnen ziehen. Der erste Wert ist der Standard für neue Varianten."+ },+ "price_lists": {+ "errors": {+ "failed_to_activate": "Preisliste konnte nicht aktiviert werden",+ "failed_to_deactivate": "Preisliste konnte nicht deaktiviert werden"+ },+ "messages": {+ "activated": "Preisliste aktiviert",+ "created": "Preisliste erstellt",+ "deactivated": "Preisliste deaktiviert",+ "deleted": "Preisliste gelöscht",+ "updated": "Preisliste aktualisiert"+ },+ "validation": {+ "ends_after_starts": "Muss nach dem Startdatum liegen."+ }+ },+ "save_label": "Produkt speichern","seo": {- "slug_placeholder": "produkt-url-handle",+ "meta_description_placeholder": "SEO-Beschreibung","meta_title_placeholder": "SEO-Titel",- "meta_description_placeholder": "SEO-Beschreibung"+ "slug_placeholder": "produkt-url-handle"},"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)",+ "delete_confirm": {+ "message": "Durch diesen Transfer erstellte Bestandsbewegungen werden rückgängig gemacht.",+ "title": "Diesen Transfer löschen?"+ },"destination_placeholder": "Zielstandort auswählen",+ "details_card": "Details","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)…",+ "external_label": "Extern (Lieferanten-Wareneingang)",+ "fields": {+ "created": "Erstellt",+ "external_receive": "Externer Wareneingang",+ "immutable_note": "Bestandstransfers sind nach dem Erstellen unveränderlich.",+ "internal": "Intern",+ "reference": "Referenz",+ "type": "Typ"+ },"items_table": {- "variant": "Variante",+ "qty": "Anz.","sku": "SKU",- "qty": "Anz."+ "variant": "Variante"+ },+ "new_cta": "Neuer Transfer",+ "reference_label": "Referenz",+ "reference_placeholder": "Bestellnummer, Lieferantenrechnung, …",+ "review_description": "Überprüfen Sie den Transfer vor dem Erstellen. Artikel können danach nicht mehr geändert werden.",+ "search_items_placeholder": "Nach Name oder SKU suchen (3+ Zeichen)…"+ },+ "variant_media_picker": {+ "add_count_one": "{{count}} hinzufügen",+ "add_count_other": "{{count}} hinzufügen",+ "empty_all_linked": "Alle Produktmedien sind bereits mit dieser Variante verknüpft.",+ "empty_no_media": "Noch keine Produktmedien — laden Sie zuerst Bilder auf dem Produkt hoch.",+ "title": "Aus Produktgalerie auswählen",+ "trigger": "Aus Produktgalerie auswählen"+ },+ "variants": {+ "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",+ "default_variant": "Standardvariante",+ "edit_row_aria": "{{name}} bearbeiten",+ "edit_variant": "Variante bearbeiten — {{name}}",+ "errors": {+ "failed_to_create_option_type": "Optionstyp konnte nicht erstellt werden",+ "failed_to_create_value": "Wert konnte nicht erstellt werden"+ },+ "keep": "Alle behalten",+ "option_type_label": "Optionstyp",+ "option_type_placeholder": "Optionstyp auswählen",+ "orphan_warning": "{{count}} vorhandene Variante(n) werden beim Speichern entfernt:",+ "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:",+ "remove_row_aria": "{{name}} entfernen",+ "sheet": {+ "availability": "Verfügbarkeit",+ "identity": "Identität",+ "tax_category_placeholder": "Vom Produkt übernehmen"+ },+ "title": "Varianten",+ "variant_label": "Variante"+ }+ },+ "promotions": {+ "action_edit": {+ "description": "Konfigurieren Sie die Parameter der Aktion.",+ "no_options": "Diese Aktion hat keine konfigurierbaren Optionen."+ },+ "action_picker": {+ "description": "Wählen Sie, was passieren soll, wenn die Aktion zutrifft.",+ "title": "Aktion hinzufügen"+ },+ "action_summary": {+ "variant_count": "{{count}} Varianten"+ },+ "action_types": {+ "create_adjustment": {+ "description": "Erstellt eine Aktionsgutschrift als Anpassung für die Bestellung",+ "name": "Anpassung für gesamte Bestellung erstellen"+ },+ "create_item_adjustments": {+ "description": "Erstellt eine Aktionsgutschrift als Anpassung für eine Bestellposition",+ "name": "Anpassung je Bestellposition erstellen"+ },+ "create_line_items": {+ "description": "Fügt dem Warenkorb die angegebene Menge der Variante hinzu",+ "name": "Bestellpositionen erstellen"+ },+ "free_shipping": {+ "description": "Macht alle Sendungen der Bestellung kostenlos",+ "name": "Kostenloser Versand"+ }+ },+ "actions_card": {+ "add_action": "Aktion hinzufügen",+ "description": "Was passiert, wenn die Aktion zutrifft.",+ "empty": "Noch keine Aktionen. Eine Aktion ohne Aktionen bewirkt nichts, wenn sie angewendet wird."+ },+ "basics_card": {+ "title": "Grundlagen"+ },+ "code": {+ "automatic": "Automatisch",+ "multi": "multi"+ },+ "coupon_codes": {+ "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.",+ "export_csv": "CSV exportieren",+ "states": {+ "partially_used": "Teilweise verwendet",+ "used": "Verwendet"+ },+ "title": "Gutscheincodes",+ "unused": "Ungenutzt",+ "used": "Genutzt"+ },+ "delete_confirm": {+ "default_name": "Diese Aktion",+ "message": "{{name}} wird dauerhaft entfernt. Aktionen, auf die abgeschlossene Bestellungen verweisen, können nicht gelöscht werden.",+ "title": "Aktion löschen?"+ },+ "errors": {+ "failed_to_add_action": "Aktion konnte nicht hinzugefügt werden",+ "failed_to_add_rule": "Regel konnte nicht hinzugefügt werden",+ "failed_to_remove_action": "Aktion konnte nicht entfernt werden",+ "failed_to_remove_rule": "Regel konnte nicht entfernt werden",+ "failed_to_update_action": "Aktion konnte nicht aktualisiert werden",+ "failed_to_update_rule": "Regel konnte nicht aktualisiert werden"+ },+ "generate_code": {+ "title": "Zufälligen Code generieren"+ },+ "kinds": {+ "automatic": "Automatisch (kein Code)",+ "coupon_code": "Gutscheincode"+ },+ "match_policies": {+ "all": "Alle Regeln müssen zutreffen",+ "all_hint": "Alle Regeln müssen zutreffen.",+ "any": "Mindestens eine Regel muss zutreffen",+ "any_hint": "Mindestens eine Regel muss zutreffen."+ },+ "messages": {+ "action_added": "Aktion hinzugefügt",+ "action_removed": "Aktion entfernt",+ "action_updated": "Aktion aktualisiert",+ "rule_added": "Regel hinzugefügt",+ "rule_removed": "Regel entfernt",+ "rule_updated": "Regel aktualisiert"+ },+ "remove_action_confirm": {+ "message": "Wird entfernt, sobald Sie die Aktion speichern.",+ "title": "Aktion entfernen?"+ },+ "remove_rule_confirm": {+ "message": "Wird entfernt, sobald Sie die Aktion speichern.",+ "title": "Regel entfernen?"+ },+ "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."+ },+ "rule_picker": {+ "description": "Wählen Sie einen Regeltyp zur Konfiguration.",+ "title": "Regel hinzufügen"+ },+ "rule_summary": {+ "category_count": "{{count}} Kategorien",+ "customer_count": "{{count}} Kunden",+ "product_count": "{{count}} Produkte"+ },+ "rule_types": {+ "category": {+ "description": "Bestellung enthält Produkte aus den angegebenen Kategorien",+ "name": "Kategorien"+ },+ "country": {+ "description": "Auf Bestellungen mit Lieferadresse in einem bestimmten Land beschränken",+ "name": "Land"+ },+ "currency": {+ "description": "Auf Bestellungen in einer bestimmten Währung beschränken",+ "name": "Währung"+ },+ "customer": {+ "description": "Nur für die angegebenen Kunden verfügbar",+ "name": "Kunden"+ },+ "customer_group": {+ "description": "Nur für Kunden in den angegebenen Kundengruppen verfügbar",+ "name": "Kundengruppe(n)"+ },+ "customer_logged_in": {+ "description": "Nur für angemeldete Kunden verfügbar",+ "name": "Nur angemeldete Kunden"+ },+ "first_order": {+ "description": "Muss die erste Bestellung des Kunden sein",+ "name": "Erste Bestellung"+ },+ "item_total": {+ "description": "Bestellsumme erfüllt diese Kriterien",+ "name": "Warenwert"},- "delete_confirm": {- "title": "Diesen Transfer löschen?",- "message": "Durch diesen Transfer erstellte Bestandsbewegungen werden rückgängig gemacht."+ "one_use_per_user": {+ "description": "Nur einmalige Nutzung pro Benutzer",+ "name": "Einmalige Nutzung pro Benutzer"},- "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."+ "option_value": {+ "description": "Bestellung enthält Produkte mit übereinstimmenden Optionswerten",+ "name": "Optionswert(e)"+ },+ "product": {+ "description": "Bestellung enthält die angegebenen Produkte",+ "name": "Produkt(e)"}},- "options": {- "kinds": {- "dropdown": "Dropdown",- "color_swatch": "Farbmuster",- "buttons": "Schaltflächen"+ "rule_types_all_used": "Jeder verfügbare Regeltyp ist dieser Aktion bereits zugeordnet.",+ "rule_types_empty": "Keine Regeltypen registriert.",+ "rules": {+ "category": {+ "empty": "Keine passenden Kategorien",+ "label": "Kategorien",+ "match_policy": {+ "all": {+ "description": "Die Bestellung muss ein Produkt aus jeder Kategorie enthalten.",+ "label": "Alle diese Kategorien"+ },+ "any": {+ "description": "Die Bestellung muss ein Produkt aus mindestens einer enthalten.",+ "label": "Beliebige dieser Kategorien"+ }+ },+ "search_placeholder": "Kategorien suchen…"},- "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."+ "channel": {+ "label": "Kanäle"},- "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",- "availability": "Verfügbarkeit",- "tax_category_placeholder": "Vom Produkt übernehmen"+ "country": {+ "empty": "Keine passenden Länder",+ "label": "Länder",+ "search_placeholder": "Länder suchen…"},- "errors": {- "failed_to_create_value": "Wert konnte nicht erstellt werden",- "failed_to_create_option_type": "Optionstyp konnte nicht erstellt werden"- }- },- "inventory": {- "columns": {- "location": "Standort",- "on_hand": "Verfügbar",- "backorder": "Nachbestellung"+ "customer": {+ "empty": "Keine passenden Kunden",+ "label": "Kunden",+ "search_placeholder": "Kunden nach Namen oder E-Mail suchen…"},- "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.",- "unknown_location": "Unbekannter Standort"- },- "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"+ "customer_group": {+ "empty": "Keine passenden Kundengruppen",+ "label": "Kundengruppen",+ "search_placeholder": "Kundengruppen suchen…"},- "errors": {- "failed_to_activate": "Preisliste konnte nicht aktiviert werden",- "failed_to_deactivate": "Preisliste konnte nicht deaktiviert werden"+ "market": {+ "label": "Märkte"},- "validation": {- "ends_after_starts": "Muss nach dem Startdatum liegen."+ "product": {+ "empty": "Keine passenden Produkte",+ "label": "Produkte",+ "match_policy": {+ "all": {+ "description": "Die Bestellung muss jedes Produkt enthalten.",+ "label": "Alle diese Produkte"+ },+ "any": {+ "description": "Die Bestellung muss mindestens eines enthalten.",+ "label": "Beliebige dieser Produkte"+ },+ "none": {+ "description": "Die Bestellung darf keines davon enthalten.",+ "label": "Keines dieser Produkte"+ }+ },+ "search_placeholder": "Produkte nach Namen suchen…"}},- "variant_media_picker": {- "trigger": "Aus Produktgalerie auswählen",- "title": "Aus Produktgalerie auswählen",- "empty_no_media": "Noch keine Produktmedien — laden Sie zuerst Bilder auf dem Produkt hoch.",- "empty_all_linked": "Alle Produktmedien sind bereits mit dieser Variante verknüpft.",- "add_count_one": "{{count}} hinzufügen",- "add_count_other": "{{count}} hinzufügen"- }- },- "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."+ "rules_card": {+ "add_rule": "Regel hinzufügen",+ "description": "Bedingungen, die festlegen, ob die Aktion angewendet wird.",+ "empty": "Keine Regeln. Ohne Regeln gilt die Aktion immer (vorbehaltlich Zeitplan und Nutzungslimit).",+ "title": "Regeln"},- "title": "Zahlungsarten",- "search_placeholder": "Nach Name suchen…",- "empty": "Keine Zahlungsarten konfiguriert",- "columns": {- "storefront": "Onlineshop"+ "schedule_card": {+ "title": "Zeitplan & Limits"},- "storefront": {- "visible": "Sichtbar",- "admin_only": "Nur Administration"+ "table": {+ "empty": "Noch keine Aktionen",+ "no_end": "Kein Enddatum",+ "search_placeholder": "Nach Namen suchen…"},- "status": {- "disabled": "Deaktiviert"+ "trigger_card": {+ "title": "Auslöser"},- "messages": {- "created": "Zahlungsmethode erstellt",- "updated": "Zahlungsmethode aktualisiert",- "deleted": "Zahlungsmethode gelöscht"+ "trigger_summary": {+ "locked_help": "Auslöser-Einstellungen können nach der Erstellung nicht geändert werden. Erstellen Sie eine neue Aktion, um sie zu ändern.",+ "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:"+ },+ "validation": {+ "code_required": "Code ist erforderlich (oder klicken Sie auf „Generieren“)",+ "expiry_after_start": "Das Ablaufdatum muss nach dem Startdatum liegen",+ "number_of_codes_required": "Wählen Sie aus, wie viele Codes generiert werden sollen",+ "prefix_required": "Präfix ist für Stapel mit mehreren Codes erforderlich"}},- "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"+ "settings": {+ "webhooks": {+ "errors": {+ "redeliver_failed": "Erneute Zustellung fehlgeschlagen",+ "send_test_failed": "Test-Webhook konnte nicht gesendet werden"+ },+ "messages": {+ "removed": "Webhook-Endpunkt entfernt",+ "updated": "Webhook-Endpunkt aktualisiert"+ }}},- "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"+ "settings_nav": {+ "groups": {+ "audit": "Audit",+ "fulfillment": "Fulfillment",+ "payments": "Zahlungen & Steuern",+ "store": "Shop",+ "team": "Team & Zugriff"},- "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"+ "items": {+ "allowed_origins": "Zugelassene Ursprünge",+ "api_keys": "API-Schlüssel",+ "channels": "Verkaufskanäle",+ "custom_field_definitions": "Benutzerdefinierte Felder",+ "delivery_methods": "Versandarten",+ "delivery_zones": "Lieferzonen",+ "emails": "E-Mails",+ "imports": "Importe",+ "markets": "Märkte",+ "payment_methods": "Zahlungsmethoden",+ "profile": "Profil",+ "staff": "Mitarbeiter",+ "stock_locations": "Lagerstandorte",+ "store": "Shop",+ "tax_categories": "Steuerkategorien",+ "webhooks": "Webhooks"}},- "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"+ "staff": {+ "actions": {+ "copy_invitation_link": "Einladungslink kopieren",+ "invitation_link_copied": "Einladungslink kopiert"},- "delete_confirm": {- "title": "Benutzerdefiniertes Feld löschen?",- "message": "{{label}} wird zusammen mit allen dafür gespeicherten Werten entfernt."+ "actions_aria": "Aktionen",+ "autocomplete": {+ "empty": "Keine Mitarbeiter gefunden",+ "placeholder": "Mitarbeiter suchen…"},- "messages": {- "created": "Benutzerdefiniertes Feld erstellt",- "updated": "Benutzerdefiniertes Feld aktualisiert",- "deleted": "Benutzerdefiniertes Feld gelöscht"+ "confirm": {+ "remove_message": "{{name}} verliert den Zugriff auf diesen Shop.",+ "remove_title": "Aus Shop entfernen?",+ "revoke_message": "{{email}} kann diese Einladung nicht mehr annehmen.",+ "revoke_title": "Einladung zurückziehen?"+ },+ "edit": {+ "roles_label": "Rollen für diesen Shop"},+ "edit_description": "Aktualisieren Sie die Profildaten und zugewiesenen Rollen für diesen Mitarbeiter.","errors": {- "failed_to_create": "Benutzerdefiniertes Feld konnte nicht erstellt werden",- "failed_to_update": "Benutzerdefiniertes Feld konnte nicht aktualisiert werden",- "failed_to_delete": "Benutzerdefiniertes Feld konnte nicht gelöscht werden"- }- },- "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"+ "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"},- "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."+ "invite": {+ "email_placeholder": "[email protected]",+ "no_roles": "Keine Rollen verfügbar.",+ "roles_loading": "Rollen werden geladen…",+ "roles_placeholder": "Rolle auswählen"},+ "validation": {+ "role_required": "Wählen Sie eine Rolle",+ "roles_required": "Wählen Sie mindestens eine Rolle"+ }+ },+ "stock_items": {"messages": {- "added": "Erlaubter Ursprung hinzugefügt",- "updated": "Erlaubter Ursprung aktualisiert",- "removed": "Erlaubter Ursprung entfernt"+ "stock_item_deleted": "Bestandsposition gelöscht",+ "stock_updated": "Bestand aktualisiert"}},"stock_locations": {"add_cta": "Lagerort hinzufügen",- "create_label": "Lagerort erstellen",+ "badges": {+ "default": "Standard",+ "enabled": "Aktiviert",+ "inactive": "Inaktiv"+ },+ "columns": {+ "default": "Standard",+ "location": "Standort",+ "pickup": "Abholung",+ "type": "Typ"+ },"create_description": "Fügen Sie ein Lager, ein Geschäft oder einen Abholpunkt hinzu, von dem aus Bestellungen abgewickelt werden.",+ "create_label": "Lagerort erstellen",+ "delete_confirm": {+ "message": "{{name}} wird entfernt. Bestandsartikel an diesem Standort werden nicht gelöscht.",+ "title": "Lagerort löschen?"+ },"edit_description": "Aktualisieren Sie Name, Adresse, Abholung oder Bestandsrichtlinien.",+ "empty": "Noch keine Lagerstandorte","kinds": {- "warehouse": "Lager",+ "fulfillment_center": "Fulfillment-Center","store": "Geschäft",- "fulfillment_center": "Fulfillment-Center"+ "warehouse": "Lager"},"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."+ "any": "Übertragungen von anderen Standorten zulassen",+ "local": "Nur Artikel an diesem Standort"},+ "search_placeholder": "Nach Name suchen…","section_pickup": "Abholung","stock_items": {- "title": "Bestand an diesem Standort",+ "empty": "An diesem Standort sind noch keine Bestandsartikel vorhanden.",+ "empty_search": "Keine Bestandsartikel entsprechen Ihrer Suche.","help": "Passen Sie die verfügbaren und nachbestellbaren Mengen pro Variante an.",+ "low_stock_marker": "niedriger Bestand","search_placeholder": "SKU oder Produkt suchen…","table": {- "variant": "Variante",+ "backorder": "Nachbestellung","on_hand": "Verfügbar",- "backorder": "Nachbestellung"+ "variant": "Variante"},- "empty": "An diesem Standort sind noch keine Bestandsartikel vorhanden.",- "empty_search": "Keine Bestandsartikel entsprechen Ihrer Suche.",+ "title": "Bestand an diesem Standort","unknown_product": "Unbekanntes Produkt","variant_count_one": "{{count}} Variante",- "variant_count_other": "{{count}} Varianten",- "low_stock_marker": "niedriger Bestand"- },- "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"+ "variant_count_other": "{{count}} Varianten"}},"stock_transfers": {- "title": "Lagerumbuchungen",- "table": {- "search_placeholder": "Nach Nummer oder Referenz suchen…",- "empty": "Noch keine Lagerumbuchungen"- },"columns": {- "number": "Nummer","direction": "Richtung",+ "number": "Nummer","reference": "Referenz"},"direction": {- "internal": "Umbuchung zwischen Standorten",- "external_receive": "Externer Wareneingang"- },- "messages": {- "recorded": "Lagerübertrag erfasst",- "deleted": "Lagerübertrag gelöscht"+ "external_receive": "Externer Wareneingang",+ "internal": "Umbuchung zwischen Standorten"},"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",- "min_quantity": "Mindestmenge",- "max_quantity": "Höchstmenge"- },- "channels": {- "messages": {- "created": "Kanal erstellt",- "updated": "Kanal aktualisiert",- "deleted": "Kanal gelöscht"- }- },- "order_routing_rules": {- "messages": {- "created": "Routing-Regel hinzugefügt",- "deleted": "Routing-Regel entfernt"+ "failed_to_delete": "Lagerübertrag konnte nicht gelöscht werden",+ "failed_to_record": "Lagerübertrag konnte nicht erfasst werden"},- "types": {- "preferred_location": {- "name": "Bevorzugter Lagerort",- "description": "Versand vom am Auftrag hinterlegten Lagerort, sofern gesetzt"- },- "minimize_splits": {- "name": "Teillieferungen minimieren",- "description": "Bevorzugt den Lagerort, der die meisten Artikel allein liefern kann, und vermeidet Teillieferungen"- },- "default_location": {- "name": "Standard-Lagerort",- "description": "Bevorzugt den als Standard markierten Lagerort"- }- }- },- "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"+ "deleted": "Lagerübertrag gelöscht",+ "recorded": "Lagerübertrag erfasst"},- "autocomplete": {- "placeholder": "Kundengruppen suchen…",- "empty": "Keine passenden Kundengruppen"- }+ "table": {+ "empty": "Noch keine Lagerumbuchungen",+ "search_placeholder": "Nach Nummer oder Referenz suchen…"+ },+ "title": "Lagerumbuchungen"},- "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"- }+ "store": {+ "load_failed_title": "Laden der Store-Einstellungen fehlgeschlagen",+ "unit_systems": {+ "imperial": "Imperial",+ "metric": "Metrisch"+ },+ "weight_units": {+ "g": "Gramm (g)",+ "kg": "Kilogramm (kg)",+ "lb": "Pfund (lb)",+ "oz": "Unze (oz)"}},- "stock_items": {+ "tax_categories": {+ "add_cta": "Steuerkategorie hinzufügen",+ "create_description": "Gruppieren Sie Produkte nach steuerlicher Behandlung (Standard, ermäßigt, befreit, …).",+ "create_label": "Steuerkategorie erstellen",+ "delete_confirm": {+ "message": "{{name}} wird entfernt. Produkte in dieser Kategorie greifen auf die Standardkategorie zurück.",+ "title": "Steuerkategorie löschen?"+ },+ "edit_description": "Aktualisieren Sie den Namen, den Code oder die Standardmarkierung.",+ "empty": "Noch keine Steuerkategorien","messages": {- "stock_updated": "Bestand aktualisiert",- "stock_item_deleted": "Bestandsposition gelöscht"- }+ "created": "Steuerkategorie erstellt",+ "deleted": "Steuerkategorie gelöscht",+ "updated": "Steuerkategorie aktualisiert"+ },+ "search_placeholder": "Nach Name suchen…"},"translations": {- "title": "Übersetzungen",- "locale": "Sprache",- "source": "Quelle",- "save": "Übersetzungen speichern",- "saved": "Übersetzungen gespeichert",- "save_error": "Übersetzungen konnten nicht gespeichert werden",- "no_locales": "Fügen Sie Ihrem Shop weitere Sprachen hinzu, um dieses Produkt zu übersetzen.",- "manage": "Übersetzungen verwalten",- "field": "Feld","coverage_summary": "{{translated}} von {{total}} Sprachen übersetzt","dirty_summary": "{{count}} nicht gespeicherte Änderung(en)","discard_confirm": {- "title": "Änderungen verwerfen?",- "message": "Sie haben {{count}} nicht gespeicherte Übersetzungsänderung(en). Verwerfen?"+ "message": "Sie haben {{count}} nicht gespeicherte Übersetzungsänderung(en). Verwerfen?",+ "title": "Änderungen verwerfen?"},+ "field": "Feld",+ "load_error": "Übersetzungen konnten nicht geladen werden",+ "locale": "Sprache",+ "manage": "Übersetzungen verwalten",+ "no_locales": "Fügen Sie Ihrem Shop weitere Sprachen hinzu, um dieses Produkt zu übersetzen.","original": "Original",- "load_error": "Übersetzungen konnten nicht geladen werden"- },- "categories": {- "title": "Kategorien",- "add_cta": "Neue Kategorie",- "empty": "Noch keine Kategorien.",- "expand": "Aufklappen",- "collapse": "Zuklappen",- "delete_confirm": "Die Kategorie „{{name}}“ und alle Unterkategorien löschen?",- "columns": {- "name": "Name",- "products": "Produkte"- },- "fields": {- "parent": {- "label": "Übergeordnete Kategorie",- "placeholder": "Oberste Ebene"- }- },- "messages": {- "created": "Kategorie erstellt",- "updated": "Kategorie aktualisiert",- "deleted": "Kategorie gelöscht",- "move_failed": "Kategorie konnte nicht verschoben werden"- },- "seo": {- "title": "Suchmaschinenoptimierung",- "preview_slug_placeholder": "kategorie-slug"- },- "products_count_one": "{{count}} Produkt",- "products_count_other": "{{count}} Produkte",- "search_placeholder": "Kategorien suchen…",- "no_results": "Keine Kategorien gefunden.",- "new_title": "Neue Kategorie",- "delete_label": "Kategorie löschen",- "images": {- "title": "Bilder",- "label": "Bild",- "square_label": "Quadratisches Bild",- "help": "Wird in Kategorie-Bannern verwendet. Empfohlen 1920×1080.",- "square_help": "Wird in der kompakten Navigation verwendet. Empfohlen 400×400."- },- "navigation": {- "title": "Navigation"- },- "products": {- "title": "Produkte",- "search_placeholder": "Produkte suchen…",- "empty": "Noch keine Produkte in dieser Kategorie.",- "remove": "Aus Kategorie entfernen",- "add_cta": "Produkte hinzufügen",- "picker_title": "Produkte zur Kategorie hinzufügen",- "picker_description": "Suchen und wählen Sie Produkte für diese Kategorie aus.",- "select_all": "Alle auswählen",- "select_row": "Produkt auswählen",- "remove_selected": "Entfernen",- "selected_count_one": "{{count}} ausgewählt",- "selected_count_other": "{{count}} ausgewählt",- "column_product": "Produkt",- "filter_placeholder": "Produkte filtern…",- "no_matches": "Keine Produkte entsprechen dem Filter."- },- "load_failed": "Kategorien konnten nicht geladen werden. Bitte erneut versuchen."- },- "imports": {- "download_original": "Originaldatei herunterladen",- "load_failed": "Der Import konnte nicht geladen werden.",- "try_again": "Erneut versuchen",- "wizard_title": "Import",- "steps": {- "map_fields": "Felder zuordnen",- "process_rows": "Zeilen verarbeiten",- "complete": "Fertig"- },- "status": {- "pending": "Ausstehend",- "mapping": "Zuordnung",- "completed_mapping": "In Warteschlange",- "processing": "In Bearbeitung",- "completed": "Abgeschlossen",- "failed": "Fehlgeschlagen"- },- "types": {- "products": "Produkte",- "customers": "Kunden",- "product_translations": "Produktübersetzungen"- },- "mapping": {- "title": "Spalten zuordnen",- "description": "Ordnen Sie die Spalten Ihrer Datei den Feldern für {{type}} zu.",- "field": "Feld",- "file_column": "Dateispalte",- "sample": "Beispiel",- "not_mapped": "Nicht zugeordnet",- "required": "Erforderlich",- "missing_required": "Ordnen Sie die erforderlichen Felder zu, um fortzufahren: {{fields}}",- "start": "Import starten",- "starting": "Wird gestartet…"- },- "processing": {- "title": "Zeilen werden verarbeitet",- "preparing": "Zeilen werden vorbereitet…",- "progress": "{{processed}} von {{total}} Zeilen verarbeitet",- "failed_count": "{{failed}} fehlgeschlagen",- "retrying": "Fehlgeschlagene Zeilen werden wiederholt · {{remaining}} verbleibend",- "note": "Sie können diese Seite verlassen — der Import läuft im Hintergrund weiter."- },- "results": {- "completed_title": "Import abgeschlossen",- "summary": "{{completed}} Zeilen importiert · {{failed}} fehlgeschlagen",- "retry_failed": "Fehlgeschlagene Zeilen wiederholen ({{failed}})",- "retrying": "Wird wiederholt…",- "view_records": "{{type}} anzeigen"- },- "failed": {- "title": "Import fehlgeschlagen",- "description": "Die Datei konnte nicht verarbeitet werden."- },- "failed_rows": {- "next_page": "Nächste Seite",- "prev_page": "Vorherige Seite",- "title": "Fehlgeschlagene Zeilen",- "row_number": "Zeile",- "error": "Fehler",- "view_data": "Zeilendaten anzeigen",- "hide_data": "Zeilendaten ausblenden"- }+ "save": "Übersetzungen speichern",+ "save_error": "Übersetzungen konnten nicht gespeichert werden",+ "saved": "Übersetzungen gespeichert",+ "source": "Quelle",+ "title": "Übersetzungen"}}}diff --git a/packages/dashboard/src/locales/en.json b/packages/dashboard/src/locales/en.jsonindex 0cb4b14025..0b5fd27e42 100644--- a/packages/dashboard/src/locales/en.json+++ b/packages/dashboard/src/locales/en.json@@ -1,320 +1,628 @@{"admin": {"a11y": {- "edit_media": "Edit image",- "delete_image": "Delete image"+ "delete_image": "Delete image",+ "edit_media": "Edit image"},- "gift_cards": {- "statuses": {- "partially_redeemed": "Partially redeemed",- "redeemed": "Redeemed",- "canceled": "Canceled",- "expired": "Expired"- },- "columns": {- "used": "Used",- "remaining": "Remaining",- "batch": "Batch",- "customer": "Customer",- "issued_by": "Issued by"- },- "table": {- "search_placeholder": "Search by code…",- "empty": "No gift cards yet"+ "allowed_origins": {+ "add_cta": "Add allowed origin",+ "create_description": "Browsers loaded from this origin can call the admin API. The CORS allowlist and admin cookie session both rely on this list — keep it tight.",+ "create_label": "Add origin",+ "delete_confirm": {+ "message": "{{origin}} will no longer be able to call the admin API from a browser. Existing server-to-server requests are not affected.",+ "title": "Remove allowed origin?"},+ "edit_description": "Updating an origin immediately changes who can call the admin API from a browser.",+ "empty": "No allowed origins yet","messages": {- "created": "Gift card created",- "create_failed": "Failed to create gift card",- "updated": "Gift card updated",- "update_failed": "Failed to update gift card",- "deleted": "Gift card deleted",- "delete_failed": "Failed to delete gift card",- "batch_created": "Gift card batch created",- "batch_create_failed": "Failed to create gift card batch"+ "added": "Allowed origin added",+ "removed": "Allowed origin removed",+ "updated": "Allowed origin updated"},- "batch_autocomplete": {- "placeholder": "Search batches by prefix…",- "empty": "No batches match"+ "search_placeholder": "Search by origin…",+ "table_title": "Allowed origins",+ "validation": {+ "bare_origin": "Must be a bare origin (e.g. https://shop.example.com) — no path, query, or fragment"}},- "option_types": {- "kinds": {- "dropdown": "Dropdown",- "color_swatch": "Color swatch",- "buttons": "Buttons"+ "api_keys": {+ "badge": {+ "never_used": "Never",+ "revoked": "Revoked"},- "columns": {- "values": "Values"+ "by_email": "by {{email}}",+ "create_key_cta": "Create key",+ "create_sheet_description": "Choose a key type, then pick the scopes it can use.",+ "create_sheet_title": "Create API key",+ "delete_confirm": {+ "message": "This permanently removes the key. Prefer revoke if you might restore access later.",+ "title": "Delete key?"},- "value_count_one": "{{count}} value",- "value_count_other": "{{count}} values",- "table": {- "search_placeholder": "Search by name…",- "empty": "No option types yet"+ "dropdown": {+ "copy_token_aria": "Copy token",+ "revoke": "Revoke key"},- "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."+ "edit_sheet_description": "Rename this key. Scopes are fixed when a key is created and can't be changed.",+ "edit_sheet_title": "Edit API key",+ "empty_description": "Create one to get started.",+ "errors": {+ "failed_to_create": "Failed to create key",+ "failed_to_delete": "Failed to delete key",+ "failed_to_update": "Failed to update key"},- "search_placeholder": "Search by name…",- "empty": "No markets yet",- "tax_inclusive": "Inclusive",- "tax_exclusive": "Exclusive",+ "key_type": {+ "publishable_description": "Safe to expose in client-side code. Grants public/guest access.",+ "publishable_title": "Publishable key",+ "secret_description": "Server-to-server. Each key carries an explicit list of scopes.",+ "secret_title": "Secret key"+ },+ "revoke_confirm": {+ "message": "Any integration using this key will stop working immediately.",+ "title": "Revoke key?"+ },+ "scope_picker": {+ "full_access_hint": "— read + write on every resource",+ "full_access_label": "Full access (write_all)",+ "read_all_hint": "— read on every resource",+ "read_all_label": "Read all (read_all)",+ "read_aria": "Read {{resource}}",+ "read_header": "Read",+ "resource_header": "Resource",+ "resources": {+ "api_keys": "API keys",+ "categories": "Categories",+ "customers": "Customers",+ "dashboard": "Dashboard",+ "fulfillments": "Fulfillments",+ "gift_cards": "Gift cards",+ "orders": "Orders",+ "payments": "Payments",+ "products": "Products",+ "promotions": "Promotions",+ "refunds": "Refunds",+ "settings": "Settings",+ "stock": "Stock",+ "store_credits": "Store credits",+ "webhooks": "Webhooks"+ },+ "show_more_aria_one": "Show {{count}} more scope",+ "show_more_aria_other": "Show {{count}} more scopes",+ "write_aria": "Write {{resource}}",+ "write_header": "Write"+ },+ "scopes_immutable_help": "Scopes can't be changed after a key is created. To change them, create a new key with the scopes you need and revoke this one.",+ "validation": {+ "scope_required": "Pick at least one scope"+ },+ "warning_treat_like_password": "Treat this key like a password. Store it in your secrets manager — we can't show it again."+ },+ "calculators": {+ "default_refund_amount": "Default Refund Amount",+ "default_tax": "Default Tax",+ "digital_delivery": "Digital Delivery",+ "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"+ },+ "categories": {+ "add_cta": "New category",+ "collapse": "Collapse","columns": {- "default": "Default"+ "name": "Name",+ "products": "Products"+ },+ "delete_confirm": "Delete the category \"{{name}}\" and all its subcategories?",+ "delete_label": "Delete category",+ "empty": "No categories yet.",+ "expand": "Expand",+ "fields": {+ "parent": {+ "label": "Parent category",+ "placeholder": "Top level"+ }+ },+ "images": {+ "help": "Used in category banners. Recommended 1920×1080.",+ "label": "Image",+ "square_help": "Used in compact navigation. Recommended 400×400.",+ "square_label": "Square image",+ "title": "Images"},+ "load_failed": "Failed to load categories. Please try again.","messages": {- "created": "Market created",- "updated": "Market updated",- "deleted": "Market deleted"+ "created": "Category created",+ "deleted": "Category deleted",+ "move_failed": "Could not move the category",+ "updated": "Category updated"},- "errors": {- "failed_to_create": "Failed to create market",- "failed_to_update": "Failed to update market",- "failed_to_delete": "Failed to delete market"- }- },- "errors": {- "not_found_title": "Page not found",- "not_found_description": "The page you’re looking for doesn’t exist.",- "forbidden_title": "Not authorized",- "forbidden_description": "You don’t have permission to view this page.",- "plugin_route_title": "This page failed to render"+ "navigation": {+ "title": "Navigation"+ },+ "new_title": "New category",+ "no_results": "No categories match your search.",+ "products": {+ "add_cta": "Add products",+ "column_product": "Product",+ "empty": "No products in this category yet.",+ "filter_placeholder": "Filter products…",+ "no_matches": "No products match your filter.",+ "picker_description": "Search and select products to add to this category.",+ "picker_title": "Add products to category",+ "remove": "Remove from category",+ "remove_selected": "Remove",+ "search_placeholder": "Search products…",+ "select_all": "Select all",+ "select_row": "Select product",+ "selected_count_one": "{{count}} selected",+ "selected_count_other": "{{count}} selected",+ "title": "Products"+ },+ "products_count_one": "{{count}} product",+ "products_count_other": "{{count}} products",+ "search_placeholder": "Search categories…",+ "seo": {+ "preview_slug_placeholder": "category-slug",+ "title": "Search engine optimization"+ },+ "title": "Categories"},- "nav": {- "home": "Home",- "account": "Account",- "orders": "Orders",- "draft_orders": "Draft Orders",- "products": "Products",- "price_lists": "Price Lists",- "categories": "Categories",- "options": "Options",- "transfers": "Transfers",- "customers": "Customers",- "customer_groups": "Groups",- "promotions": "Promotions",- "gift_cards": "Gift Cards",- "reports": "Reports",- "settings": "Settings",- "getting_started": "Getting Started"+ "channels": {+ "messages": {+ "created": "Channel created",+ "deleted": "Channel deleted",+ "updated": "Channel updated"+ }},- "settings_nav": {- "groups": {- "store": "Store",- "payments": "Payments & taxes",- "fulfillment": "Fulfillment",- "team": "Team & access",- "audit": "Audit"+ "components": {+ "adjustment_action_editor": {+ "calculator_label": "Calculator",+ "loading_calculators": "Loading calculators…",+ "no_extra_settings": "This calculator has no extra settings.",+ "select_calculator": "Select a calculator",+ "settings_label": "Calculator settings"},- "items": {- "store": "Store",- "emails": "Emails",- "channels": "Sales channels",- "payment_methods": "Payment methods",- "tax_categories": "Tax categories",- "markets": "Markets",- "stock_locations": "Stock locations",- "custom_field_definitions": "Custom fields",- "staff": "Staff",- "api_keys": "API keys",- "webhooks": "Webhooks",- "allowed_origins": "Allowed origins",- "profile": "Profile",- "imports": "Imports"+ "custom_fields": {+ "default_resource": "records",+ "empty_description": "Track structured details like material, fit, or care instructions.",+ "empty_title": "No custom fields yet",+ "errors": {+ "failed_to_save": "Failed to save custom field"+ },+ "manage_in_settings": "Manage in settings",+ "new_definition_description": "Define a custom field to store typed, structured information on your {{resource}}.",+ "new_definition_title": "New custom field",+ "section_title": "Custom fields",+ "set_up": "Set up custom fields",+ "values_save_partial_failed": "Some custom fields could not be saved: {{fields}}",+ "values_saved": "Custom fields saved"+ },+ "market_combobox": {+ "empty": "No markets match",+ "search_placeholder": "Search markets…"}},- "fields": {- "products_count": {- "label": "Products"+ "custom_field_definitions": {+ "add_cta": "Add custom field",+ "create_description": "Define a typed field your team can fill in on any matching record.",+ "create_label": "Create custom field",+ "delete_confirm": {+ "message": "{{label}} will be removed along with every value stored for it.",+ "title": "Delete custom field?"},- "prices_count": {- "label": "Prices"+ "edit_description": "Update the label, key, or storefront visibility. The owner can't change once values exist.",+ "empty": "No custom field definitions yet",+ "errors": {+ "failed_to_create": "Failed to create custom field definition",+ "failed_to_delete": "Failed to delete custom field definition",+ "failed_to_update": "Failed to update custom field definition"},- "customer_id": {- "label": "Customer"+ "messages": {+ "created": "Custom field definition created",+ "deleted": "Custom field definition deleted",+ "updated": "Custom field definition updated"},- "role_id": {- "label": "Role"+ "search_placeholder": "Search by label, namespace, or key…",+ "storefront_visible": {+ "admin_only": "Admin only",+ "visible": "Visible"},- "role_ids": {- "label": "Roles"+ "table_title": "Custom field definitions"+ },+ "customer_groups": {+ "autocomplete": {+ "empty": "No customer groups match",+ "placeholder": "Search customer groups…"},- "match_policy": {- "label": "Match policy"+ "messages": {+ "create_failed": "Failed to create customer group",+ "created": "Customer group created",+ "delete_failed": "Failed to delete customer group",+ "deleted": "Customer group deleted",+ "update_failed": "Failed to update customer group",+ "updated": "Customer group updated"+ }+ },+ "customers": {+ "autocomplete": {+ "empty": "No customers match",+ "placeholder": "Search customers…"},- "tax_category_id": {- "label": "Tax category"+ "columns": {+ "groups": "Groups",+ "last_order": "Last order",+ "newsletter": "Newsletter",+ "orders": "Orders",+ "total_spent": "Total spent"},- "promotion": {- "name": {- "placeholder": "Summer Sale"+ "detail": {+ "address": {+ "default_billing": "Default billing",+ "default_shipping": "Default shipping",+ "delete_confirm_message": "Delete this address?",+ "set_default_billing": "Set as default billing",+ "set_default_shipping": "Set as default shipping"},- "description": {- "placeholder": "Internal description (optional)"+ "customer_since": "Customer since",+ "delete_label": "Delete customer",+ "edit_profile_description": "Update the customer's profile information.",+ "groups": {+ "edit_description": "Add or remove the groups this customer belongs to.",+ "edit_title": "Edit customer groups",+ "empty": "Not in any groups",+ "save_failed": "Failed to update customer groups",+ "title": "Customer groups"},- "kind": {- "label": "How is this promotion applied?"+ "last_order_placed": "Last order placed",+ "no_internal_notes": "No internal notes",+ "not_subscribed_to_marketing": "Not subscribed to marketing",+ "orders_table": {+ "date": "Date",+ "order": "Order"},- "code": {- "placeholder": "SUMMER2026"+ "store_credit": {+ "add_description": "Issue store credit to this customer's account.",+ "delete_confirm_message": "Delete this store credit?",+ "edit_description": "Adjust the amount, category, or memo. Used balance cannot be edited.",+ "empty": "No store credits issued",+ "table": {+ "category": "Category",+ "memo": "Memo",+ "remaining": "Remaining",+ "used": "Used"+ },+ "title": "Store credit"},- "multi_codes": {- "label": "Generate a batch of unique codes",- "help": "Useful for one-time-use codes — each customer redeems a different code."+ "subscribed_to_marketing": "Subscribed to marketing"+ },+ "groups": {+ "bulk_add_action": "Add to group…",+ "bulk_add_failed": "Failed to add customers to groups",+ "bulk_added": "Added {{count}} customers to groups",+ "bulk_remove_action": "Remove from group…",+ "bulk_remove_failed": "Failed to remove customers from groups",+ "bulk_removed": "Removed {{count}} customers from groups",+ "columns": {+ "customers": "Customers"},- "number_of_codes": {- "label": "Number of codes",- "placeholder": "100"+ "count_one": "{{count}} customer",+ "count_other": "{{count}} customers",+ "create_description": "Create a customer group to segment your customers for promotions, analytics, or marketing.",+ "create_label": "Create customer group",+ "default_name": "This group",+ "delete_confirm": {+ "message": "{{name}} will be removed. Customers in this group are not deleted.",+ "title": "Delete customer group?"},- "code_prefix": {- "label": "Code prefix (optional)",- "placeholder": "VIP",- "help": "Each generated code will start with this prefix."+ "edit_description": "Update the name or description.",+ "picker": {+ "add_description": "Pick the groups to add these customers to.",+ "add_title": "Add to groups",+ "remove_description": "Pick the groups to remove these customers from.",+ "remove_title": "Remove from groups"},- "starts_at": {- "placeholder": "No start date"+ "table": {+ "empty": "No customer groups yet",+ "search_placeholder": "Search by name…",+ "title": "Customer Groups"},- "expires_at": {- "placeholder": "No expiry"+ "view_members": "View members"+ },+ "new_sheet_description": "Customers created here have no password set. They'll get a magic link the first time they sign in.",+ "row_actions": {+ "delete_confirm": "Delete {{email}}? Customers with completed orders cannot be removed."+ },+ "table": {+ "empty": "No customers yet",+ "search_placeholder": "Search by email or name…"+ },+ "tags": {+ "bulk_add_action": "Add tags…",+ "bulk_add_failed": "Failed to add tags",+ "bulk_added": "Added tags to {n} customers",+ "bulk_remove_action": "Remove tags…",+ "bulk_remove_failed": "Failed to remove tags",+ "bulk_removed": "Removed tags from {n} customers",+ "picker": {+ "add_description": "Pick or create tags to add to these customers.",+ "add_title": "Add tags",+ "remove_description": "Pick tags to remove from these customers.",+ "remove_title": "Remove tags"+ }+ }+ },+ "delivery_methods": {+ "add_cta": "Add delivery method",+ "add_sheet_title": "New delivery method",+ "create_description": "Configure how orders reach customers: shipping, digital delivery or pickup.",+ "create_label": "Create delivery method",+ "delete_confirm": {+ "message": "Delete \"{{name}}\"? Storefronts will stop offering it immediately.",+ "title": "Delete delivery method"+ },+ "edit_description": "Update this delivery method’s configuration.",+ "edit_sheet_title": "Edit delivery method",+ "empty": "No delivery methods yet.",+ "fulfillment_types": {+ "digital": "Digital",+ "pickup": "Pickup",+ "pickup_point": "Pickup point",+ "shipping": "Shipping"+ },+ "messages": {+ "created": "Delivery method created",+ "deleted": "Delivery method deleted",+ "updated": "Delivery method updated"+ },+ "no_zones_hint": "No delivery zones defined yet — the method applies everywhere.",+ "search_placeholder": "Search delivery methods…"+ },+ "delivery_zones": {+ "add_cta": "Add delivery zone",+ "add_member": "Add member",+ "add_sheet_title": "New delivery zone",+ "create_description": "Group countries, states or postal codes into an area served by delivery methods.",+ "create_label": "Create delivery zone",+ "delete_confirm": {+ "message": "Delete \"{{name}}\"? Delivery methods using it will stop matching these areas.",+ "title": "Delete delivery zone"+ },+ "edit_description": "Members below replace the zone’s full member list on save.",+ "edit_sheet_title": "Edit delivery zone",+ "empty": "No delivery zones yet.",+ "from_placeholder": "From",+ "member_types": {+ "country": "Country",+ "postal_code": "Postal code",+ "state": "State"+ },+ "members_column": "Members",+ "members_count": "{{count}} members",+ "messages": {+ "created": "Delivery zone created",+ "deleted": "Delivery zone deleted",+ "updated": "Delivery zone updated"+ },+ "no_members_hint": "No members yet — add countries, states or postal code rules.",+ "prefix_placeholder": "Prefix",+ "search_placeholder": "Search delivery zones…",+ "select_country": "Select country",+ "state_placeholder": "State code or name",+ "to_placeholder": "To"+ },+ "errors": {+ "forbidden_description": "You don’t have permission to view this page.",+ "forbidden_title": "Not authorized",+ "not_found_description": "The page you’re looking for doesn’t exist.",+ "not_found_title": "Page not found",+ "plugin_route_title": "This page failed to render"+ },+ "fields": {+ "allowed_origin": {+ "origin": {+ "help": "Bare scheme + host (+ optional port). No path, query, or fragment.",+ "label": "Origin",+ "placeholder": "https://admin.example.com"+ }+ },+ "api_key": {+ "channel": {+ "all_channels": "All channels",+ "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",+ "label": "Channel"},- "usage_limit": {- "label": "Usage limit",- "placeholder": "Unlimited"+ "key_type": {+ "label": "Type"},- "match_policy": {- "label": "Match policy"+ "name": {+ "label": "Name",+ "placeholder": "Backend integration, Storefront prod, …",+ "required": "Name is required"+ },+ "scopes": {+ "label": "Scopes"}},- "custom_field_definition": {- "label": {- "label": "Label",- "placeholder": "e.g. Material"+ "channel": {+ "active": {+ "help": "Inactive sales channels stop accepting orders and aren't matched by the X-Spree-Channel header.",+ "label": "Active"},- "namespace": {- "label": "Namespace",- "placeholder": "custom"+ "code": {+ "help": "Stable identifier used by API clients via the X-Spree-Channel header and for order attribution. Leave blank to auto-derive from the name. Lowercase letters, numbers, hyphens, underscores.",+ "label": "Code",+ "placeholder": "Auto-derived from name"},- "key": {- "label": "Key",- "placeholder": "e.g. material",- "invalid_format": "Letters, numbers, underscore only"+ "default": {+ "help": "Exactly one channel per store is the default. Used as the fallback when no channel is selected and as the auto-publish target for new products.",+ "label": "Default channel"+ },+ "guest_checkout": {+ "help": "Whether shoppers can check out without an account on this channel. Leave blank to inherit the store setting.",+ "inherit": "Inherit from store",+ "label": "Guest checkout",+ "options": {+ "false": "Not allowed",+ "true": "Allowed"+ }+ },+ "name": {+ "placeholder": "e.g. POS, Wholesale, Meta Shop"+ },+ "order_routing_strategy": {+ "help": "Overrides the store-level routing strategy for orders attributed to this channel. Leave blank to inherit.",+ "inherit": "Inherit from store",+ "label": "Order routing strategy",+ "options": {+ "Spree::OrderRouting::Strategy::Legacy": "Legacy",+ "Spree::OrderRouting::Strategy::Rules": "Rules (ordered)"+ }},+ "storefront_access": {+ "help": "Controls what anonymous visitors can see on this channel. Leave blank to inherit the store setting. When prices are hidden, guests must sign in to check out.",+ "inherit": "Inherit from store",+ "label": "Storefront access",+ "options": {+ "login_required": "Login required — visitors must sign in to browse",+ "prices_hidden": "Prices hidden — visitors must sign in to see prices",+ "public": "Public — anyone can browse and see prices"+ }+ }+ },+ "custom_field_definition": {"field_type": {"label": "Type",- "read_only_help": "The type can't be changed once values exist — switching it would leave stored values misinterpreted.","options": {- "short_text": "Short text",+ "boolean": "Boolean",+ "json": "JSON","long_text": "Long text",- "rich_text": "Rich text","number": "Number",- "boolean": "Boolean",- "json": "JSON"- }+ "rich_text": "Rich text",+ "short_text": "Short text"+ },+ "read_only_help": "The type can't be changed once values exist — switching it would leave stored values misinterpreted."+ },+ "key": {+ "invalid_format": "Letters, numbers, underscore only",+ "label": "Key",+ "placeholder": "e.g. material"+ },+ "label": {+ "label": "Label",+ "placeholder": "e.g. Material"+ },+ "namespace": {+ "label": "Namespace",+ "placeholder": "custom"},"resource_type": {"label": "Applies to",- "read_only_help": "The owner can't be changed once values exist for this field.","options": {- "Spree::Product": "Products",- "Spree::Variant": "Variants",+ "Spree::OptionType": "Option types","Spree::Order": "Orders",- "Spree::User": "Customers",+ "Spree::Product": "Products","Spree::Taxon": "Categories",- "Spree::OptionType": "Option types"- }- },- "storefront_visible": {- "label": "Visible on storefront",- "column_label": "Storefront"+ "Spree::User": "Customers",+ "Spree::Variant": "Variants"+ },+ "read_only_help": "The owner can't be changed once values exist for this field."},"searchable": {- "label": "Searchable",- "help": "Include values in storefront product text search (short text, long text, and number only). After enabling with Meilisearch, run rake spree:search:reindex so existing products are updated."+ "help": "Include values in storefront product text search (short text, long text, and number only). After enabling with Meilisearch, run rake spree:search:reindex so existing products are updated.",+ "label": "Searchable"},"sortable": {- "label": "Sortable",- "help": "Allow storefront product listings to sort by this field (short text and number only). After enabling with Meilisearch, run rake spree:search:reindex so existing products are updated."+ "help": "Allow storefront product listings to sort by this field (short text and number only). After enabling with Meilisearch, run rake spree:search:reindex so existing products are updated.",+ "label": "Sortable"+ },+ "storefront_visible": {+ "column_label": "Storefront",+ "label": "Visible on storefront"}},- "tax_category": {- "name": {- "placeholder": "e.g. Reduced rate"+ "customer": {+ "accepts_email_marketing": {+ "label": "Subscribed to marketing"},- "tax_code": {- "label": "Tax code",- "placeholder": "External tax provider code (Avalara, etc.)"+ "customer_groups": {+ "label": "Customer groups"+ },+ "internal_note": {+ "label": "Internal note",+ "placeholder": "Staff-only context about this customer…"},+ "tags": {+ "label": "Tags"+ }+ },+ "customer_group": {"description": {"placeholder": "Optional internal description"},- "is_default": {- "label": "Default",- "help": "Setting this demotes the previous default. Products without an explicit category fall back to this one."+ "name": {+ "placeholder": "e.g. VIP customers"}},- "allowed_origin": {- "origin": {- "label": "Origin",- "placeholder": "https://admin.example.com",- "help": "Bare scheme + host (+ optional port). No path, query, or fragment."- }+ "customer_id": {+ "label": "Customer"},- "channel": {- "name": {- "placeholder": "e.g. POS, Wholesale, Meta Shop"+ "delivery_method": {+ "admin_name": {+ "label": "Internal name"+ },+ "calculator": {+ "label": "Rate calculator"},"code": {- "label": "Code",- "placeholder": "Auto-derived from name",- "help": "Stable identifier used by API clients via the X-Spree-Channel header and for order attribution. Leave blank to auto-derive from the name. Lowercase letters, numbers, hyphens, underscores."+ "label": "Code"},- "active": {- "label": "Active",- "help": "Inactive sales channels stop accepting orders and aren't matched by the X-Spree-Channel header."+ "delivery_zones": {+ "label": "Delivery zones"},- "default": {- "label": "Default channel",- "help": "Exactly one channel per store is the default. Used as the fallback when no channel is selected and as the auto-publish target for new products."+ "fulfillment_type": {+ "label": "Fulfillment type"},- "order_routing_strategy": {- "label": "Order routing strategy",- "help": "Overrides the store-level routing strategy for orders attributed to this channel. Leave blank to inherit.",- "inherit": "Inherit from store",- "options": {- "Spree::OrderRouting::Strategy::Rules": "Rules (ordered)",- "Spree::OrderRouting::Strategy::Legacy": "Legacy"- }+ "storefront_visible": {+ "help": "Customers can select this method at checkout."},- "storefront_access": {- "label": "Storefront access",- "help": "Controls what anonymous visitors can see on this channel. Leave blank to inherit the store setting. When prices are hidden, guests must sign in to check out.",- "inherit": "Inherit from store",- "options": {- "public": "Public — anyone can browse and see prices",- "prices_hidden": "Prices hidden — visitors must sign in to see prices",- "login_required": "Login required — visitors must sign in to browse"- }+ "tax_category": {+ "label": "Tax category"},- "guest_checkout": {- "label": "Guest checkout",- "help": "Whether shoppers can check out without an account on this channel. Leave blank to inherit the store setting.",- "inherit": "Inherit from store",- "options": {- "true": "Allowed",- "false": "Not allowed"- }+ "tracking_url": {+ "label": "Tracking URL template"+ },+ "transit_days_max": {+ "label": "Transit days (max)"+ },+ "transit_days_min": {+ "label": "Transit days (min)"+ }+ },+ "gift_card": {+ "amount": {+ "label": "Amount"+ },+ "code": {+ "help": "Leave blank to auto-generate. For batches, this becomes the prefix.",+ "label": "Code"+ },+ "currency": {+ "label": "Currency"+ },+ "customer_id": {+ "label": "Customer"+ },+ "expires_at": {+ "label": "Expires",+ "placeholder": "No expiry"+ },+ "quantity": {+ "help": "1 issues a single card. More than 1 issues a batch with auto-generated codes.",+ "label": "Quantity"}},"invitation_acceptance": {@@ -325,269 +633,370 @@"label": "Confirm password"}},- "customer_group": {+ "market": {+ "country_isos": {+ "help": "Pick the countries this market covers. Each country can belong to at most one market per store.",+ "label": "Countries"+ },+ "currency": {+ "help": "ISO 4217 currency used for all prices in this market.",+ "label": "Currency"+ },+ "default": {+ "help": "Shoppers without a known country see this market. Only one can be default per store.",+ "label": "Default market"+ },+ "default_locale": {+ "help": "Storefront language for shoppers in this market.",+ "label": "Default locale"+ },"name": {- "placeholder": "e.g. VIP customers"+ "placeholder": "e.g. Europe"},- "description": {- "placeholder": "Optional internal description"+ "supported_locales": {+ "help": "Additional languages shoppers can switch to. The default locale is always included.",+ "label": "Supported locales"+ },+ "tax_inclusive": {+ "help": "Display prices with tax included. Common in EU markets.",+ "label": "Tax-inclusive pricing"}},- "price_list": {+ "match_policy": {+ "label": "Match policy"+ },+ "media": {+ "alt": {+ "label": "Alt text",+ "placeholder": "Describe the image for accessibility and SEO"+ }+ },+ "option_type": {+ "filterable": {+ "help": "Show this option as a filter in storefront product listings.",+ "label": "Filterable"+ },+ "kind": {+ "help": "Controls how the option renders on the storefront. Color swatch shows a hex color; buttons show a thumbnail image.",+ "label": "Kind"+ },+ "label": {+ "help": "Shown to customers on the storefront.",+ "label": "Label",+ "placeholder": "e.g. Shirt size"+ },"name": {- "label": "Name",- "placeholder": "e.g. EU wholesale",- "help": "Internal label — never shown to customers."+ "help": "Lowercase identifier. Must be unique across the store.",+ "label": "Internal name",+ "placeholder": "e.g. shirt-size"+ }+ },+ "option_value": {+ "color_code": {+ "label": "Color"+ },+ "image": {+ "label": "Image"+ },+ "label": {+ "label": "Label",+ "placeholder": "e.g. Small"+ },+ "name": {+ "label": "Internal name",+ "placeholder": "e.g. small"+ }+ },+ "order": {+ "channel": {+ "help": "Attribute the order to a specific sales channel. Defaults to the store's online channel.",+ "label": "Sales channel",+ "placeholder": "Use store default"+ },+ "coupon_code": {+ "label": "Coupon code",+ "placeholder": "Optional"+ },+ "customer_note": {+ "label": "Customer note (visible to customer)"+ },+ "email": {+ "label": "Or use a guest email",+ "placeholder": "[email protected]"+ },+ "internal_note": {+ "label": "Internal note (staff only)"+ }+ },+ "payment_method": {+ "active": {+ "help": "Inactive methods are hidden from checkout.",+ "label": "Active"+ },+ "auto_capture": {+ "help": "Capture funds automatically on authorization. When off, you must capture manually.",+ "label": "Auto-capture"},+ "description": {+ "placeholder": "Customer-facing description shown at checkout"+ },+ "name": {+ "placeholder": "e.g. Credit card (Stripe)"+ },+ "provider_configuration": "Provider configuration",+ "storefront_visible": {+ "label": "Visible on storefront"+ },+ "type": {+ "label": "Provider",+ "placeholder": "Select a provider"+ }+ },+ "price_list": {"description": {"label": "Description","placeholder": "Optional internal description"},- "starts_at": {- "label": "Starts",- "placeholder": "Immediately",- "help": "When this list becomes active. Leave blank to start immediately on activation."- },"ends_at": {+ "help": "Leave blank for no end date.","label": "Ends",- "placeholder": "Never",- "help": "Leave blank for no end date."+ "placeholder": "Never"},"match_policy": {- "label": "Match policy","all": "All rules must match",- "any": "Any rule may match"+ "any": "Any rule may match",+ "label": "Match policy"+ },+ "name": {+ "help": "Internal label — never shown to customers.",+ "label": "Name",+ "placeholder": "e.g. EU wholesale"+ },+ "starts_at": {+ "help": "When this list becomes active. Leave blank to start immediately on activation.",+ "label": "Starts",+ "placeholder": "Immediately"},"status": {"active": "Active",- "scheduled": "Scheduled",+ "draft": "Draft","inactive": "Inactive",- "draft": "Draft"+ "scheduled": "Scheduled"}},"price_rule": {- "customers": {- "label": "Customers",- "help": "Leave empty to apply this rule to every signed-in customer."+ "channels": {+ "help": "Leave empty to apply this rule on every sales channel.",+ "label": "Sales channels"},"customer_groups": {- "label": "Customer groups",- "help": "Leave empty to apply this rule to every customer regardless of group."+ "help": "Leave empty to apply this rule to every customer regardless of group.",+ "label": "Customer groups"+ },+ "customers": {+ "help": "Leave empty to apply this rule to every signed-in customer.",+ "label": "Customers"},"markets": {- "label": "Markets",- "help": "Leave empty to apply this rule in every market."+ "help": "Leave empty to apply this rule in every market.",+ "label": "Markets"},- "channels": {- "label": "Sales channels",- "help": "Leave empty to apply this rule on every sales channel."+ "max_quantity": {+ "help": "Leave empty for no upper limit."},"min_quantity": {"help": "This price applies only when a customer orders at least this many of a single item."- },- "max_quantity": {- "help": "Leave empty for no upper limit."}},- "stock_location": {- "name": {- "placeholder": "Brooklyn warehouse"+ "prices_count": {+ "label": "Prices"+ },+ "product": {+ "available_on": {+ "label": "Available on"},- "admin_name": {- "label": "Internal name",- "placeholder": "Optional — shown only in the admin"+ "category_ids": {+ "label": "Categories"},- "kind": {- "label": "Kind"+ "channels": {+ "label": "Sales channels"},- "active": {- "label": "Active",- "help": "Inactive locations don't appear in fulfillment selection."+ "description": {+ "label": "Description",+ "placeholder": "Write a product description…"},- "default": {- "label": "Default location",- "help": "New stock items propagate here. Only one location can be default."+ "discontinue_on": {+ "label": "Discontinue on"},- "backorderable_default": {- "label": "Backorderable by default",- "help": "New stock items default to allowing backorders when out of stock."+ "make_active_at": {+ "label": "Make active at"},- "propagate_all_variants": {- "label": "Auto-create stock items for all variants",- "help": "Create stock items at this location for every product variant."+ "name": {+ "label": "Name",+ "placeholder": "Product name"},- "pickup_enabled": {- "label": "Allow customer pickup",- "help": "Customers can pick orders up from this location at checkout."+ "tags": {+ "label": "Tags"+ }+ },+ "product_publication": {+ "published_at": {+ "help": "Leave empty to go live immediately.",+ "label": "Publish from",+ "placeholder": "Live immediately"},- "pickup_stock_policy": {- "label": "Stock policy"+ "unpublished_at": {+ "help": "Leave empty to keep listed indefinitely.",+ "label": "Unpublish on",+ "placeholder": "Never"+ }+ },+ "products_count": {+ "label": "Products"+ },+ "profile": {+ "avatar": {+ "help": "Shown next to your name across the admin. Square images look best.",+ "label": "Photo"},- "pickup_ready_in_minutes": {- "label": "Ready in (minutes)",- "placeholder": "60"+ "email": {+ "label": "Email"},- "pickup_instructions": {- "label": "Pickup instructions",- "placeholder": "Where the customer should go to collect their order."+ "first_name": {+ "label": "First name"+ },+ "last_name": {+ "label": "Last name"+ },+ "selected_locale": {+ "help": "Language used across the admin dashboard. Only affects what you see.",+ "label": "Language"}},- "payment_method": {- "type": {- "label": "Provider",- "placeholder": "Select a provider"+ "promotion": {+ "code": {+ "placeholder": "SUMMER2026"},- "name": {- "placeholder": "e.g. Credit card (Stripe)"+ "code_prefix": {+ "help": "Each generated code will start with this prefix.",+ "label": "Code prefix (optional)",+ "placeholder": "VIP"},"description": {- "placeholder": "Customer-facing description shown at checkout"+ "placeholder": "Internal description (optional)"},- "storefront_visible": {- "label": "Visible on storefront"+ "expires_at": {+ "placeholder": "No expiry"},- "active": {- "label": "Active",- "help": "Inactive methods are hidden from checkout."+ "kind": {+ "label": "How is this promotion applied?"},- "auto_capture": {- "label": "Auto-capture",- "help": "Capture funds automatically on authorization. When off, you must capture manually."+ "match_policy": {+ "label": "Match policy"+ },+ "multi_codes": {+ "help": "Useful for one-time-use codes — each customer redeems a different code.",+ "label": "Generate a batch of unique codes"},- "provider_configuration": "Provider configuration"- },- "market": {"name": {- "placeholder": "e.g. Europe"+ "placeholder": "Summer Sale"},- "currency": {- "label": "Currency",- "help": "ISO 4217 currency used for all prices in this market."+ "number_of_codes": {+ "label": "Number of codes",+ "placeholder": "100"},- "default_locale": {- "label": "Default locale",- "help": "Storefront language for shoppers in this market."+ "starts_at": {+ "placeholder": "No start date"},- "supported_locales": {- "label": "Supported locales",- "help": "Additional languages shoppers can switch to. The default locale is always included."- },- "country_isos": {- "label": "Countries",- "help": "Pick the countries this market covers. Each country can belong to at most one market per store."- },- "tax_inclusive": {- "label": "Tax-inclusive pricing",- "help": "Display prices with tax included. Common in EU markets."- },- "default": {- "label": "Default market",- "help": "Shoppers without a known country see this market. Only one can be default per store."+ "usage_limit": {+ "label": "Usage limit",+ "placeholder": "Unlimited"}},- "option_type": {- "name": {- "label": "Internal name",- "placeholder": "e.g. shirt-size",- "help": "Lowercase identifier. Must be unique across the store."- },- "label": {- "label": "Label",- "placeholder": "e.g. Shirt size",- "help": "Shown to customers on the storefront."- },- "kind": {- "label": "Kind",- "help": "Controls how the option renders on the storefront. Color swatch shows a hex color; buttons show a thumbnail image."- },- "filterable": {- "label": "Filterable",- "help": "Show this option as a filter in storefront product listings."- }+ "role_id": {+ "label": "Role"},- "option_value": {- "name": {- "label": "Internal name",- "placeholder": "e.g. small"- },- "label": {- "label": "Label",- "placeholder": "e.g. Small"- },- "color_code": {- "label": "Color"- },- "image": {- "label": "Image"- }+ "role_ids": {+ "label": "Roles"},- "variant": {- "sku": {- "label": "SKU",- "placeholder": "PRODUCT-RED-S"+ "stock_location": {+ "active": {+ "help": "Inactive locations don't appear in fulfillment selection.",+ "label": "Active"},- "barcode": {- "label": "Barcode"+ "admin_name": {+ "label": "Internal name",+ "placeholder": "Optional — shown only in the admin"},- "weight": {- "label": "Weight"+ "backorderable_default": {+ "help": "New stock items default to allowing backorders when out of stock.",+ "label": "Backorderable by default"},- "weight_unit": {- "label": "Unit"+ "default": {+ "help": "New stock items propagate here. Only one location can be default.",+ "label": "Default location"},- "height": {- "label": "Height"+ "kind": {+ "label": "Kind"},- "width": {- "label": "Width"+ "name": {+ "placeholder": "Brooklyn warehouse"},- "depth": {- "label": "Depth"+ "pickup_enabled": {+ "help": "Customers can pick orders up from this location at checkout.",+ "label": "Allow customer pickup"},- "dimensions_unit": {- "label": "Unit"+ "pickup_instructions": {+ "label": "Pickup instructions",+ "placeholder": "Where the customer should go to collect their order."},- "preorderable": {- "label": "Available for pre-order",- "help": "Sell this variant before it's in stock. Cap how many you'll take with the backorder limit, enter incoming stock as the count, or leave it blank for unlimited."+ "pickup_ready_in_minutes": {+ "label": "Ready in (minutes)",+ "placeholder": "60"},- "preorder_ships_at": {- "label": "Ships by",- "placeholder": "Select a date",- "help": "When you expect to ship pre-orders. Shown to customers as the delivery promise; the pre-order ends once this date passes."+ "pickup_stock_policy": {+ "label": "Stock policy"},- "backorder_limit": {- "label": "Backorder limit",- "placeholder": "Unlimited",- "help": "Maximum number of units sold beyond available stock — caps backorders and pre-orders. Leave blank for unlimited."+ "propagate_all_variants": {+ "help": "Create stock items at this location for every product variant.",+ "label": "Auto-create stock items for all variants"}},- "api_key": {- "name": {- "label": "Name",- "placeholder": "Backend integration, Storefront prod, …",- "required": "Name is required"+ "store": {+ "customer_support_email": {+ "help": "Reply-to address shown to customers in storefront emails.",+ "label": "Customer support email",+ "placeholder": "[email protected]"},- "key_type": {- "label": "Type"+ "guest_checkout": {+ "help": "Store-wide default for whether shoppers can check out without an account. Channels can override this.",+ "label": "Guest checkout"},- "scopes": {- "label": "Scopes"+ "mail_from_address": {+ "help": "Used as the From address on every transactional email.",+ "label": "Sender address",+ "placeholder": "[email protected]"+ },+ "mailer_logo": {+ "help": "PNG or JPG with a transparent background. Embedded in transactional email headers.",+ "label": "Email logo"},- "channel": {- "label": "Channel",- "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",- "all_channels": "All channels"- }- },- "store": {"name": {"label": "Store name"},+ "new_order_notifications_email": {+ "help": "Recipient of \"new order placed\" notifications. Leave blank to disable.",+ "label": "New order notifications",+ "placeholder": "[email protected]"+ },"preferred_admin_locale": {"label": "Admin language","placeholder": "Use the default language"},+ "preferred_send_consumer_transactional_emails": {+ "help": "When off, no order confirmation, shipping, or refund emails are sent.",+ "label": "Send transactional emails to customers"+ },"preferred_timezone": {"label": "Timezone","placeholder": "Select a timezone"@@ -599,952 +1008,1115 @@"label": "Weight unit"},"storefront_access": {- "label": "Storefront access","help": "Store-wide default for what anonymous visitors can see. Channels can override this. When prices are hidden, guests must sign in to check out.",+ "label": "Storefront access","options": {- "public": "Public — anyone can browse and see prices",+ "login_required": "Login required — visitors must sign in to browse","prices_hidden": "Prices hidden — visitors must sign in to see prices",- "login_required": "Login required — visitors must sign in to browse"+ "public": "Public — anyone can browse and see prices"}- },- "guest_checkout": {- "label": "Guest checkout",- "help": "Store-wide default for whether shoppers can check out without an account. Channels can override this."- },- "mail_from_address": {- "label": "Sender address",- "placeholder": "[email protected]",- "help": "Used as the From address on every transactional email."- },- "customer_support_email": {- "label": "Customer support email",- "placeholder": "[email protected]",- "help": "Reply-to address shown to customers in storefront emails."- },- "new_order_notifications_email": {- "label": "New order notifications",- "placeholder": "[email protected]",- "help": "Recipient of \"new order placed\" notifications. Leave blank to disable."- },- "preferred_send_consumer_transactional_emails": {- "label": "Send transactional emails to customers",- "help": "When off, no order confirmation, shipping, or refund emails are sent."- },- "mailer_logo": {- "label": "Email logo",- "help": "PNG or JPG with a transparent background. Embedded in transactional email headers."}},- "webhook_endpoint": {- "name": {- "label": "Name",- "placeholder": "e.g. Order pipeline",- "help": "Optional label shown in this list."+ "store_credit": {+ "amount": {+ "label": "Amount"},- "url": {- "label": "Destination URL",- "placeholder": "https://example.com/webhooks"+ "category_id": {+ "label": "Category"},- "active": {- "label": "Active",- "help": "Inactive endpoints don't receive deliveries."+ "currency": {+ "label": "Currency"},- "subscriptions": {- "label": "Events",- "help": "Select which events should trigger a webhook. Choose nothing to receive every event."+ "memo": {+ "label": "Memo",+ "placeholder": "Reason for issuing this credit"}},- "product": {- "name": {- "label": "Name",- "placeholder": "Product name"- },+ "storefront_visible": {+ "label": "Visible in storefront"+ },+ "tax_category": {"description": {- "label": "Description",- "placeholder": "Write a product description…"- },- "make_active_at": {- "label": "Make active at"- },- "available_on": {- "label": "Available on"- },- "discontinue_on": {- "label": "Discontinue on"+ "placeholder": "Optional internal description"},- "category_ids": {- "label": "Categories"+ "is_default": {+ "help": "Setting this demotes the previous default. Products without an explicit category fall back to this one.",+ "label": "Default"},- "channels": {- "label": "Sales channels"+ "name": {+ "placeholder": "e.g. Reduced rate"},- "tags": {- "label": "Tags"+ "tax_code": {+ "label": "Tax code",+ "placeholder": "External tax provider code (Avalara, etc.)"}},- "product_publication": {- "published_at": {- "label": "Publish from",- "placeholder": "Live immediately",- "help": "Leave empty to go live immediately."- },- "unpublished_at": {- "label": "Unpublish on",- "placeholder": "Never",- "help": "Leave empty to keep listed indefinitely."- }+ "tax_category_id": {+ "label": "Tax category"},- "gift_card": {- "code": {- "label": "Code",- "help": "Leave blank to auto-generate. For batches, this becomes the prefix."+ "variant": {+ "backorder_limit": {+ "help": "Maximum number of units sold beyond available stock — caps backorders and pre-orders. Leave blank for unlimited.",+ "label": "Backorder limit",+ "placeholder": "Unlimited"},- "amount": {- "label": "Amount"+ "barcode": {+ "label": "Barcode"},- "currency": {- "label": "Currency"+ "depth": {+ "label": "Depth"},- "expires_at": {- "label": "Expires",- "placeholder": "No expiry"+ "dimensions_unit": {+ "label": "Unit"},- "customer_id": {- "label": "Customer"+ "height": {+ "label": "Height"},- "quantity": {- "label": "Quantity",- "help": "1 issues a single card. More than 1 issues a batch with auto-generated codes."- }- },- "customer": {- "tags": {- "label": "Tags"+ "preorder_ships_at": {+ "help": "When you expect to ship pre-orders. Shown to customers as the delivery promise; the pre-order ends once this date passes.",+ "label": "Ships by",+ "placeholder": "Select a date"},- "customer_groups": {- "label": "Customer groups"+ "preorderable": {+ "help": "Sell this variant before it's in stock. Cap how many you'll take with the backorder limit, enter incoming stock as the count, or leave it blank for unlimited.",+ "label": "Available for pre-order"},- "accepts_email_marketing": {- "label": "Subscribed to marketing"+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUCT-RED-S"},- "internal_note": {- "label": "Internal note",- "placeholder": "Staff-only context about this customer…"+ "weight": {+ "label": "Weight"+ },+ "weight_unit": {+ "label": "Unit"+ },+ "width": {+ "label": "Width"}},- "store_credit": {- "amount": {- "label": "Amount"+ "webhook_endpoint": {+ "active": {+ "help": "Inactive endpoints don't receive deliveries.",+ "label": "Active"},- "currency": {- "label": "Currency"+ "name": {+ "help": "Optional label shown in this list.",+ "label": "Name",+ "placeholder": "e.g. Order pipeline"},- "category_id": {- "label": "Category"+ "subscriptions": {+ "help": "Select which events should trigger a webhook. Choose nothing to receive every event.",+ "label": "Events"},- "memo": {- "label": "Memo",- "placeholder": "Reason for issuing this credit"- }- },- "order": {- "email": {- "label": "Or use a guest email",- "placeholder": "[email protected]"- },- "customer_note": {- "label": "Customer note (visible to customer)"- },- "internal_note": {- "label": "Internal note (staff only)"- },- "coupon_code": {- "label": "Coupon code",- "placeholder": "Optional"- },- "channel": {- "label": "Sales channel",- "placeholder": "Use store default",- "help": "Attribute the order to a specific sales channel. Defaults to the store's online channel."- }- },- "media": {- "alt": {- "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"- },- "avatar": {- "label": "Photo",- "help": "Shown next to your name across the admin. Square images look best."- },- "selected_locale": {- "label": "Language",- "help": "Language used across the admin dashboard. Only affects what you see."+ "url": {+ "label": "Destination URL",+ "placeholder": "https://example.com/webhooks"}}},- "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"+ "gift_cards": {+ "batch_autocomplete": {+ "empty": "No batches match",+ "placeholder": "Search batches by prefix…"},- "generate_code": {- "title": "Generate a random code"+ "columns": {+ "batch": "Batch",+ "customer": "Customer",+ "issued_by": "Issued by",+ "remaining": "Remaining",+ "used": "Used"},- "kinds": {- "coupon_code": "Coupon code",- "automatic": "Automatic (no code)"+ "messages": {+ "batch_create_failed": "Failed to create gift card batch",+ "batch_created": "Gift card batch created",+ "create_failed": "Failed to create gift card",+ "created": "Gift card created",+ "delete_failed": "Failed to delete gift card",+ "deleted": "Gift card deleted",+ "update_failed": "Failed to update gift card",+ "updated": "Gift card updated"},- "match_policies": {- "all": "All rules must match",- "any": "Any rule may match",- "all_hint": "All rules must match.",- "any_hint": "Any rule may match."+ "statuses": {+ "canceled": "Canceled",+ "expired": "Expired",+ "partially_redeemed": "Partially redeemed",+ "redeemed": "Redeemed"},- "rules_card": {- "title": "Rules",- "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"+ "table": {+ "empty": "No gift cards yet",+ "search_placeholder": "Search by code…"+ }+ },+ "imports": {+ "download_original": "Download original file",+ "failed": {+ "description": "The file could not be processed.",+ "title": "Import failed"},- "validation": {- "code_required": "Code is required (or click Generate)",- "prefix_required": "Prefix is required for multi-code batches",- "number_of_codes_required": "Pick how many codes to generate",- "expiry_after_start": "Expiry must be after the start date"+ "failed_rows": {+ "error": "Error",+ "hide_data": "Hide row data",+ "next_page": "Next page",+ "prev_page": "Previous page",+ "row_number": "Row",+ "title": "Failed rows",+ "view_data": "View row data"},- "delete_confirm": {- "title": "Delete promotion?",- "message": "{{name}} will be removed permanently. Promotions referenced by completed orders cannot be deleted.",- "default_name": "This promotion"+ "load_failed": "Could not load the import.",+ "mapping": {+ "description": "Match the columns from your file to {{type}} fields.",+ "field": "Field",+ "file_column": "File column",+ "missing_required": "Map the required fields to continue: {{fields}}",+ "not_mapped": "Not mapped",+ "required": "Required",+ "sample": "Example",+ "start": "Start import",+ "starting": "Starting…",+ "title": "Map columns"},- "rules": {- "country": {- "label": "Countries",- "search_placeholder": "Search countries…",- "empty": "No countries match"- },- "channel": {- "label": "Channels"- },- "market": {- "label": "Markets"- },- "product": {- "label": "Products",- "search_placeholder": "Search products by name…",- "empty": "No products match",- "match_policy": {- "any": {- "label": "Any of these products",- "description": "Order must contain at least one."- },- "all": {- "label": "All of these products",- "description": "Order must contain every product."- },- "none": {- "label": "None of these products",- "description": "Order must not contain any of them."- }- }- },- "category": {- "label": "Categories",- "search_placeholder": "Search categories…",- "empty": "No categories match",- "match_policy": {- "any": {- "label": "Any of these categories",- "description": "Order must contain a product in at least one."- },- "all": {- "label": "All of these categories",- "description": "Order must contain a product in every category."- }- }- },- "customer_group": {- "label": "Customer groups",- "search_placeholder": "Search customer groups…",- "empty": "No customer groups match"- },- "customer": {- "label": "Customers",- "search_placeholder": "Search customers by name or email…",- "empty": "No customers match"- }+ "processing": {+ "failed_count": "{{failed}} failed",+ "note": "You can leave this page — the import continues in the background.",+ "preparing": "Preparing rows…",+ "progress": "{{processed}} of {{total}} rows processed",+ "retrying": "Retrying failed rows · {{remaining}} remaining",+ "title": "Processing rows"},- "basics_card": {- "title": "Basics"+ "results": {+ "completed_title": "Import completed",+ "retry_failed": "Retry failed rows ({{failed}})",+ "retrying": "Retrying…",+ "summary": "{{completed}} rows imported · {{failed}} failed",+ "view_records": "View {{type}}"},- "trigger_card": {- "title": "Trigger"+ "status": {+ "completed": "Completed",+ "completed_mapping": "Queued",+ "failed": "Failed",+ "mapping": "Mapping",+ "pending": "Pending",+ "processing": "Processing"},- "schedule_card": {- "title": "Schedule & limits"+ "steps": {+ "complete": "Complete",+ "map_fields": "Map fields",+ "process_rows": "Process rows"},- "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."+ "try_again": "Try again",+ "types": {+ "customers": "Customers",+ "product_translations": "Product translations",+ "products": "Products"},- "remove_rule_confirm": {- "title": "Remove rule?",- "message": "Removed when you save the promotion."+ "wizard_title": "Import"+ },+ "invitation": {+ "accepting": "Accepting…",+ "could_not_accept": "Could not accept invitation",+ "create_and_accept": "Create account & accept",+ "create_to_accept": ". Create your account to accept.",+ "generic_error_message": "Something went wrong. Please try again.",+ "generic_error_title": "Could not load invitation",+ "invited_as_role": " as {{role}}",+ "invited_by": "{{email}} invited you",+ "invited_generic": "You have been invited",+ "join_store": "Join {{store}}",+ "loading": "Loading invitation…",+ "missing_token_message": "This link looks incomplete. Ask whoever invited you to send it again.",+ "missing_token_title": "Missing invitation token",+ "not_found_message": "This invitation has expired, been revoked, or already been accepted. Ask the inviter to send a new one.",+ "not_found_title": "Invitation not found",+ "sign_in_and_accept": "Sign in & accept",+ "sign_in_to_accept": ". Sign in to accept."+ },+ "markets": {+ "add_cta": "Add market",+ "columns": {+ "default": "Default"},- "rule_summary": {- "product_count": "{{count}} products",- "category_count": "{{count}} categories",- "customer_count": "{{count}} customers"+ "create_description": "Group countries into a single pricing region with its own currency and locales.",+ "create_label": "Create market",+ "delete_confirm": {+ "message": "{{name}} will be removed. Orders previously placed in this market remain intact.",+ "title": "Delete market?"},- "rule_picker": {- "title": "Add rule",- "description": "Pick a rule type to configure."+ "edit_description": "Update name, currency, locales, or country coverage.",+ "empty": "No markets yet",+ "errors": {+ "failed_to_create": "Failed to create market",+ "failed_to_delete": "Failed to delete market",+ "failed_to_update": "Failed to update market"},- "rule_edit": {- "description": "Tune the rule's parameters.",- "no_options": "This rule has no configurable options — its presence alone applies the constraint."+ "messages": {+ "created": "Market created",+ "deleted": "Market deleted",+ "updated": "Market updated"},- "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"+ "search_placeholder": "Search by name…",+ "tax_exclusive": "Exclusive",+ "tax_inclusive": "Inclusive"+ },+ "nav": {+ "account": "Account",+ "categories": "Categories",+ "customer_groups": "Groups",+ "customers": "Customers",+ "draft_orders": "Draft Orders",+ "getting_started": "Getting Started",+ "gift_cards": "Gift Cards",+ "home": "Home",+ "options": "Options",+ "orders": "Orders",+ "price_lists": "Price Lists",+ "products": "Products",+ "promotions": "Promotions",+ "reports": "Reports",+ "settings": "Settings",+ "transfers": "Transfers"+ },+ "option_types": {+ "columns": {+ "values": "Values"},- "remove_action_confirm": {- "title": "Remove action?",- "message": "Removed when you save the promotion."+ "kinds": {+ "buttons": "Buttons",+ "color_swatch": "Color swatch",+ "dropdown": "Dropdown"},- "action_summary": {- "variant_count": "{{count}} variants"+ "messages": {+ "created": "Option type created",+ "deleted": "Option type deleted",+ "updated": "Option type updated"},- "action_picker": {- "title": "Add action",- "description": "Pick what should happen when the promotion qualifies."+ "table": {+ "empty": "No option types yet",+ "search_placeholder": "Search by name…"},- "action_edit": {- "description": "Configure the action's parameters.",- "no_options": "This action has no configurable options."+ "value_count_one": "{{count}} value",+ "value_count_other": "{{count}} values"+ },+ "order_routing_rules": {+ "messages": {+ "created": "Routing rule added",+ "deleted": "Routing rule removed"},- "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"+ "types": {+ "default_location": {+ "description": "Prefer the stock location marked as default",+ "name": "Default location"+ },+ "minimize_splits": {+ "description": "Prefer the location that can fulfill the most items on its own, avoiding split shipments",+ "name": "Minimize splits"+ },+ "preferred_location": {+ "description": "Fulfill from the location pinned on the order, when one is set",+ "name": "Preferred location"}+ }+ },+ "orders": {+ "columns": {+ "customer": "Customer",+ "date": "Date",+ "fulfillment": "Fulfillment",+ "items": "Items",+ "number": "Number",+ "payment": "Payment",+ "sku": "SKU",+ "tags": "Tags"},- "rule_types": {- "category": {- "name": "Categories",- "description": "Order includes products in specified categories"+ "detail": {+ "add_line_item": {+ "title": "Add Line Item"},- "country": {- "name": "Country",- "description": "Limit to orders with shipping address in a specific country"+ "address_edit": {+ "billing_title": "Edit Billing Address",+ "shipping_title": "Edit Shipping Address"+ },+ "adjustment_lines": {+ "add_discount": "Add discount",+ "add_discount_description": "Creates a manual discount. Without a target line item the amount is distributed across all items.",+ "add_fee": "Add fee",+ "add_fee_description": "Creates a fee such as a surcharge, handling or gift wrap charge.",+ "amount_field": "Amount",+ "delete_discount_message": "Remove the discount \"{{label}}\" from this order? Totals will be recalculated.",+ "delete_discount_title": "Delete discount",+ "delete_fee_message": "Remove the fee \"{{label}}\" from this order? Totals will be recalculated.",+ "delete_fee_title": "Delete fee",+ "discounts": "Discounts",+ "empty": "No taxes, discounts or fees on this order yet.",+ "fees": "Fees",+ "kind_field": "Kind",+ "kind_promotion": "Promotion",+ "label_field": "Label",+ "target_field": "Applies to",+ "target_order": "Whole order",+ "taxes": "Taxes",+ "title": "Taxes, discounts & fees",+ "value_field": "Value",+ "value_type_field": "Type",+ "value_type_flat": "Amount",+ "value_type_percent": "Percent"},- "currency": {- "name": "Currency",- "description": "Limit to orders in a specific currency"+ "completed_prefix": "Completed",+ "confirm": {+ "approve_message": "Approve this order?",+ "cancel_message": "Are you sure you want to cancel this order?",+ "cancel_shipment_message": "Cancel this fulfillment?",+ "capture_message": "Capture this payment?",+ "complete_message": "Complete this draft order now?",+ "remove_gift_card_message": "Remove this gift card from the order?",+ "remove_item_message": "Remove this item from the order?",+ "remove_store_credit_message": "Remove store credit from the order?",+ "resume_message": "Resume this canceled order?",+ "ship_message": "Ship this fulfillment?",+ "void_message": "Void this payment?"},- "customer": {- "name": "Customers",- "description": "Available only to the specified customers"+ "dropdown": {+ "cancel_shipment": "Cancel Shipment",+ "complete_order": "Complete Order",+ "edit_quantity": "Edit Quantity",+ "preview_order": "Preview Order",+ "resend_confirmation": "Resend Confirmation",+ "void_payment": "Void Payment"},- "customer_group": {- "name": "Customer Group(s)",- "description": "Available only to customers in specified customer group(s)"+ "edit_quantity": {+ "description": "Set the quantity for this line item.",+ "title": "Edit Quantity"},- "customer_logged_in": {- "name": "Only logged in customers",- "description": "Available only to logged in customers"+ "errors": {+ "approve_failed": "Failed to approve order",+ "cancel_failed": "Failed to cancel order",+ "complete_failed": "Failed to complete order",+ "confirmation_send_failed": "Failed to send confirmation",+ "resume_failed": "Failed to resume order"},- "first_order": {- "name": "First order",- "description": "Must be the customer's first order"+ "gift_card_section": {+ "applied_suffix": "applied",+ "apply_balance": "Apply customer's available balance",+ "apply_dialog_description": "Enter a gift card code to apply to this order.",+ "apply_dialog_title": "Apply Gift Card",+ "code_placeholder": "GIFT-XXXX-YYYY",+ "gift_card_label": "Gift card",+ "none_applied": "None applied",+ "requires_customer": "Requires a customer",+ "store_credit_label": "Store credit",+ "title": "Gift Card & Store Credit"},- "item_total": {- "name": "Item total",- "description": "Order total meets these criteria"+ "items_table": {+ "item": "Item",+ "price": "Price",+ "qty": "Qty"},- "one_use_per_user": {- "name": "One Use Per User",- "description": "Only One Use Per User"+ "load_failed_message": "We couldn't load order {{orderId}}.",+ "messages": {+ "approved": "Order approved",+ "canceled": "Order canceled",+ "captured": "Payment captured",+ "completed": "Order completed",+ "confirmation_sent": "Confirmation sent",+ "resumed": "Order resumed",+ "shipped": "Fulfillment shipped",+ "voided": "Payment voided"},- "option_value": {- "name": "Option Value(s)",- "description": "Order includes products with matching option value(s)"+ "no_customer": "No customer information",+ "no_line_items": "No line items",+ "payment_form": {+ "amount_help": "Leave blank to default to the outstanding balance.",+ "capture_immediately": "Capture immediately",+ "description": "Charge a payment method against this order.",+ "method_label": "Payment method",+ "method_placeholder": "Choose a payment method",+ "no_saved_cards": "Customer has no saved cards for this payment method.",+ "source_label": "Source",+ "source_placeholder": "Choose a saved card…",+ "source_requires_customer": "This payment method requires a saved source. Assign a customer to the order first.",+ "title": "Add Payment"},- "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"+ "payments_table": {+ "method": "Method",+ "number": "Number",+ "state": "State"},- "create_item_adjustments": {- "name": "Create per-line-item adjustment",- "description": "Creates a promotion credit adjustment on a line item"+ "section_customer_note": "Special Instructions",+ "section_internal_note": "Internal Note",+ "summary": {+ "adjustments": "Adjustments",+ "approved_by": "Approved by",+ "canceled_at": "Canceled at",+ "canceler": "Canceler",+ "outstanding_balance": "Outstanding balance",+ "payment_total": "Payment total",+ "promotions": "Promotions",+ "tax_additional": "Tax (additional)",+ "tax_included": "Tax (included)"},- "create_line_items": {- "name": "Create line items",- "description": "Populates the cart with the specified quantity of variant"+ "tracking": {+ "add_title": "Add Tracking",+ "description": "Update the tracking number for this shipment.",+ "edit_title": "Edit Tracking",+ "label": "Tracking Number",+ "prefix": "Tracking",+ "shipped_prefix": "Shipped"},- "free_shipping": {- "name": "Free shipping",- "description": "Makes all shipments for the order free"+ "variant_search": {+ "description": "Search for a product variant to add to this order.",+ "empty": "No variants found",+ "label": "Search variant",+ "placeholder": "Type product name or SKU (min 3 chars)…",+ "sku_prefix": "SKU"}},- "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"+ "fulfillment_statuses": {+ "backorder": "Backorder",+ "canceled": "Canceled",+ "fulfilled": "Fulfilled",+ "partial": "Partial",+ "pending": "Pending",+ "ready": "Ready"},- "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"+ "item_count_one": "{{count}} item",+ "item_count_other": "{{count}} items",+ "new": {+ "add_variant": "Add a variant",+ "creates_draft_note": "Creates a draft order. Add payments and complete it after creation.",+ "items_table": {+ "qty": "Qty",+ "sku": "SKU",+ "variant": "Variant"+ },+ "use_default_addresses": "Use customer's default billing & shipping addresses"},- "custom_fields": {- "section_title": "Custom fields",- "set_up": "Set up custom fields",- "manage_in_settings": "Manage in settings",- "empty_title": "No custom fields yet",- "empty_description": "Track structured details like material, fit, or care instructions.",- "values_saved": "Custom fields saved",- "values_save_partial_failed": "Some custom fields could not be saved: {{fields}}",- "new_definition_title": "New custom field",- "new_definition_description": "Define a custom field to store typed, structured information on your {{resource}}.",- "default_resource": "records",- "errors": {- "failed_to_save": "Failed to save custom field"- }+ "payment_statuses": {+ "balance_due": "Balance due",+ "credit_owed": "Credit owed",+ "failed": "Failed",+ "paid": "Paid",+ "void": "Void"},- "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"+ "statuses": {+ "canceled": "Canceled",+ "draft": "Draft",+ "placed": "Placed"+ },+ "table": {+ "empty": "No orders found",+ "search_placeholder": "Search orders…"}},"pages": {- "home": {- "top_products": "Top Products",- "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",- "subtitle": "Manage admin teammates and roles",- "invite_cta": "Invite teammate",- "members_section": "Members",- "invitations_section": "Pending invitations",- "empty": "No staff yet",- "empty_description": "Invite a teammate to collaborate on this store.",- "table": {- "member": "Member",- "roles": "Roles",- "role": "Role"- },- "invite_sheet": {- "title": "Invite teammate",- "description": "We'll email them a link to set their password."- },- "edit_sheet": {- "title": "Edit teammate"- },- "actions": {- "resend": "Resend",- "remove": "Remove from staff"- },- "messages": {- "revoked": "Invitation revoked",- "updated": "Staff updated",- "removed": "Removed from staff"- }- },"channels": {- "title": "Sales channels",- "empty_message": "No sales channels yet","add_cta": "New sales channel","add_sheet_title": "Add sales channel",- "edit_sheet_title": "Edit sales channel",- "create_label": "Create sales channel","create_description": "Sales channels group orders and product listings — \"online\", \"pos\", a marketplace integration, etc.",- "edit_description": "Rename a sales channel or pause it. Inactive sales channels stop accepting orders.",+ "create_label": "Create sales channel","delete_confirm": {- "title": "Delete sales channel?",- "message": "{{name}} will be removed. Products and orders attached to it will lose their sales-channel reference."+ "message": "{{name}} will be removed. Products and orders attached to it will lose their sales-channel reference.",+ "title": "Delete sales channel?"},+ "edit_description": "Rename a sales channel or pause it. Inactive sales channels stop accepting orders.",+ "edit_sheet_title": "Edit sales channel",+ "empty_message": "No sales channels yet",+ "no_channels_found": "No sales channels found","order_routing_rules": {- "title": "Order routing rules",- "help": "When the routing strategy is Rules (ordered), rules are evaluated top to bottom — the first rule that singles out a stock location wins, and ties carry to the next rule.",- "empty": "No routing rules — orders fall back to the default stock location.",- "add_cta": "Add rule",- "picker_title": "Add a routing rule",- "edit_preferences": "Edit rule settings","active_toggle": "Rule active",+ "add_cta": "Add rule","delete_confirm": {- "title": "Delete routing rule?",- "message": "{{name}} will be removed from this channel's routing order."- }+ "message": "{{name}} will be removed from this channel's routing order.",+ "title": "Delete routing rule?"+ },+ "edit_preferences": "Edit rule settings",+ "empty": "No routing rules — orders fall back to the default stock location.",+ "help": "When the routing strategy is Rules (ordered), rules are evaluated top to bottom — the first rule that singles out a stock location wins, and ties carry to the next rule.",+ "picker_title": "Add a routing rule",+ "title": "Order routing rules"},"search_placeholder": "Search sales channels…",- "no_channels_found": "No sales channels found",+ "title": "Sales channels","validation": {"code_format": "Lowercase letters, numbers, hyphens, underscores only"}},"customers": {- "new_cta": "New Customer","create_label": "Create customer",- "edit_sheet_title": "Edit customer",- "groups_cta": "Customer groups",- "groups": {- "title": "Customer groups",- "add_cta": "Add customer group",- "edit_sheet_title": "Edit customer group",- "add_sheet_title": "Add customer group"- },"detail": {- "stat_total_spent": "Total spent",- "stat_orders": "Orders",- "stat_avg_order_value": "Avg order value",- "section_profile": "Profile",- "section_addresses": "Addresses",- "section_orders": "Orders",- "section_store_credit": "Store credit",- "section_internal_note": "Internal note",- "section_tags": "Tags",- "addresses_empty": "No addresses on file.",- "orders_empty": "No orders yet.",- "store_credit_empty": "No store credit issued.","add_address": "Add address",+ "addresses_empty": "No addresses on file.","edit_address": "Edit address",+ "edit_credit": "Edit store credit","issue_credit": "Issue store credit",- "edit_credit": "Edit store credit"- }+ "orders_empty": "No orders yet.",+ "section_addresses": "Addresses",+ "section_internal_note": "Internal note",+ "section_orders": "Orders",+ "section_profile": "Profile",+ "section_store_credit": "Store credit",+ "section_tags": "Tags",+ "stat_avg_order_value": "Avg order value",+ "stat_orders": "Orders",+ "stat_total_spent": "Total spent",+ "store_credit_empty": "No store credit issued."+ },+ "edit_sheet_title": "Edit customer",+ "groups": {+ "add_cta": "Add customer group",+ "add_sheet_title": "Add customer group",+ "edit_sheet_title": "Edit customer group",+ "title": "Customer groups"+ },+ "groups_cta": "Customer groups",+ "new_cta": "New Customer"},- "orders": {- "drafts_title": "Draft Orders",- "new": {- "title": "New Order",- "section_customer": "Customer",- "section_items": "Items",- "section_billing": "Billing",- "section_notes": "Notes",- "section_summary": "Summary",- "add_line_item": "Add line item",- "select_customer": "Select customer",- "search_variant": "Search variant…"+ "getting_started": {+ "description": "Finish these steps to launch your store.",+ "progress": "{{done}} of {{total}} completed",+ "storefront_sheet": {+ "api_url_label": "Store API URL",+ "deploy_button": "Deploy to Vercel",+ "deploy_copy": "Deploying clones the open-source storefront to your Git account and builds it on Vercel with your credentials prefilled. Once it finishes, copy its URL into the field below.",+ "deploy_title": "Recommended: deploy the official Next.js storefront",+ "description": "Use these credentials in any client that talks to the Store API — a web storefront, a mobile app, or anything else.",+ "env_description": "Your Spree Store API URL and publishable key. Both are prefilled from your store — adjust them before deploying if needed.",+ "invalid_url": "This doesn't look like a valid storefront URL.",+ "key_error": "Couldn't load your publishable API key.",+ "local_installation_instructions": "Local installation instructions",+ "publishable_key_label": "Publishable API key",+ "save": "Save & finish setup",+ "saved": "Storefront URL saved: {{url}}",+ "see_online_demo": "See online demo",+ "storefront_url_help": "The URL customers use to reach your storefront. It becomes the base for links in customer emails and is automatically added as an allowed origin so browser-based storefronts can call the Store API.",+ "storefront_url_label": "Storefront URL",+ "storefront_url_placeholder": "https://myshop.com",+ "title": "Connect your storefront"},- "detail": {- "section_summary": "Summary",- "section_items": "Items",- "section_payments": "Payments",- "section_shipments": "Shipments",- "section_customer": "Customer",- "section_shipping_address": "Shipping address",- "section_billing_address": "Billing address",- "section_internal_note": "Internal note",- "section_customer_note": "Customer note",- "section_history": "History",- "summary": {- "created_by": "Created by",- "market": "Market",- "locale": "Locale",- "channel": "Sales channel",- "ip_address": "IP address"+ "tasks": {+ "add_products": {+ "cta": "Add products",+ "description": "Add products to your store — your own, or invite third-party vendors to sell together.",+ "import_cta": "Import products from CSV",+ "title": "Add products"},- "empty_payments": "No payments yet.",- "empty_shipments": "No shipments yet.",- "no_delivery_method": "No delivery method selected.",- "empty_history": "No history yet.",+ "set_customer_support_email": {+ "cta": "Email settings",+ "description": "Shown on your storefront as the contact point for customer questions and support.",+ "title": "Set customer support email"+ },+ "setup_payment_method": {+ "cta": "Set up payment methods",+ "description": "To collect payments, set up at least one online payment provider.",+ "title": "Set up payment methods"+ },+ "setup_storefront": {+ "cta": "Connect storefront",+ "description": "Connect your web storefront or mobile app with your Store API credentials, and save your storefront URL.",+ "title": "Set up storefront"+ },+ "setup_taxes_collection": {+ "cta": "Tax settings",+ "description": "To collect taxes, set up your tax rates.",+ "title": "Set up taxes collection"+ }+ },+ "title": "Getting Started"+ },+ "home": {+ "columns": {+ "price": "Price",+ "product": "Product",+ "sold": "Sold"+ },+ "metric_short": {+ "avg_order_value": "AOV",+ "orders": "Orders",+ "sales": "Sales"+ },+ "metrics": {+ "avg_order_value": "Avg Order Value",+ "orders": "Total Orders",+ "sales": "Total Sales"+ },+ "subtitle": "Overview of your store performance",+ "title": "Dashboard",+ "top_products": "Top Products",+ "top_products_description": "Best-selling products in your store."+ },+ "orders": {+ "detail": {"actions": {"approve": "Approve","cancel": "Cancel order",- "resume": "Resume",- "refund": "Refund","capture": "Capture",- "void": "Void","mark_paid": "Mark as paid",- "ship": "Mark as shipped"+ "refund": "Refund",+ "resume": "Resume",+ "ship": "Mark as shipped",+ "void": "Void"},"dialogs": {- "cancel_title": "Cancel order?","approve_title": "Approve order?",+ "cancel_title": "Cancel order?","refund_title": "Refund payment?"+ },+ "empty_history": "No history yet.",+ "empty_payments": "No payments yet.",+ "empty_shipments": "No shipments yet.",+ "no_delivery_method": "No delivery method selected.",+ "section_billing_address": "Billing address",+ "section_customer": "Customer",+ "section_customer_note": "Customer note",+ "section_fulfillments": "Fulfillments",+ "section_history": "History",+ "section_internal_note": "Internal note",+ "section_items": "Items",+ "section_payments": "Payments",+ "section_shipping_address": "Shipping address",+ "section_summary": "Summary",+ "summary": {+ "channel": "Sales channel",+ "created_by": "Created by",+ "ip_address": "IP address",+ "locale": "Locale",+ "market": "Market"}+ },+ "drafts_title": "Draft Orders",+ "new": {+ "add_line_item": "Add line item",+ "search_variant": "Search variant…",+ "section_billing": "Billing",+ "section_customer": "Customer",+ "section_items": "Items",+ "section_notes": "Notes",+ "section_summary": "Summary",+ "select_customer": "Select customer",+ "title": "New Order"}},"products": {"add_cta": "Add product",- "new": {- "title": "New product",- "description": "Set up your product — add variants, prices, inventory, media, and custom fields",- "save_label": "Create product",- "create_succeeded": "Product created",- "create_failed": "Failed to create product",- "preview_slug_placeholder": "your-product-slug"- },- "edit": {- "bulk_prices": {- "no_variants": "Add at least one variant to start editing prices."- }- },- "section_basics": "Basics",- "section_media": "Media",- "section_pricing": "Pricing",- "section_inventory": "Inventory",- "section_seo": "SEO",- "section_categorization": "Categorization",- "section_organization": "Organization",- "section_variants": "Variants",- "publishing": {- "title": "Publishing",- "manage_cta": "Manage",- "manage_title": "Manage sales channels",- "manage_description": "Pick which sales channels list this product. Toggle a channel off to unlist it everywhere.",- "empty": "Not listed on any sales channel yet.",- "no_channels": "No sales channels available. Create one in Settings → Sales channels.",- "inactive_marker": "Inactive",- "status_live": "Live",- "status_scheduled": "Scheduled",- "status_hidden": "Hidden",- "status_not_available": "Not available",- "caption_live": "Visible to customers now",- "caption_scheduled": "Goes live {{date}}",- "caption_hidden_after": "Comes down {{date}}",- "caption_unpublished": "Was hidden on {{date}}",- "caption_window": "Live {{start}} → {{end}}",- "caption_not_available": "Hidden — product is {{product_status}}"- },- "clone_succeeded": "Product duplicated",- "clone_failed": "Failed to duplicate product",- "delete_succeeded": "Product deleted",- "delete_failed": "Failed to delete product","bulk": {- "set_status_action": "Set status…","add_categories_action": "Add to categories…",- "remove_categories_action": "Remove from categories…","add_channels_action": "Add to sales channels…",- "remove_channels_action": "Remove from sales channels…","add_tags_action": "Add tags…",- "remove_tags_action": "Remove tags…",- "status_sheet_title": "Set product status",- "status_sheet_description": "Pick the status to apply to the selected products.",- "categories_add_title": "Add to categories","categories_add_description": "Pick the categories to add these products to.",- "categories_remove_title": "Remove from categories",+ "categories_add_failed": "Failed to add products to categories",+ "categories_add_title": "Add to categories",+ "categories_added": "Added {n} products to categories","categories_remove_description": "Pick the categories to remove these products from.",- "channels_add_title": "Add to sales channels",+ "categories_remove_failed": "Failed to remove products from categories",+ "categories_remove_title": "Remove from categories",+ "categories_removed": "Removed {n} products from categories","channels_add_description": "Pick the sales channels to list these products on.",- "channels_remove_title": "Remove from sales channels",+ "channels_add_failed": "Failed to list products on sales channels",+ "channels_add_title": "Add to sales channels",+ "channels_added": "Listed {n} products on sales channels","channels_remove_description": "Pick the sales channels to unlist these products from.",- "tags_add_title": "Add tags",- "tags_add_description": "Pick or create tags to add to these products.",- "tags_remove_title": "Remove tags",- "tags_remove_description": "Pick tags to remove from these products.",+ "channels_remove_failed": "Failed to unlist products from sales channels",+ "channels_remove_title": "Remove from sales channels",+ "channels_removed": "Unlisted {n} products from sales channels","delete_confirm": {- "title": "Delete {n} products?",- "message": "Selected products will be removed. This action cannot be undone."+ "message": "Selected products will be removed. This action cannot be undone.",+ "title": "Delete {n} products?"},- "status_updated": "Updated status on {n} products",+ "delete_failed": "Failed to delete products",+ "deleted": "Deleted {n} products",+ "remove_categories_action": "Remove from categories…",+ "remove_channels_action": "Remove from sales channels…",+ "remove_tags_action": "Remove tags…",+ "set_status_action": "Set status…",+ "status_sheet_description": "Pick the status to apply to the selected products.",+ "status_sheet_title": "Set product status","status_update_failed": "Failed to update product status",- "categories_added": "Added {n} products to categories",- "categories_add_failed": "Failed to add products to categories",- "categories_removed": "Removed {n} products from categories",- "categories_remove_failed": "Failed to remove products from categories",- "channels_added": "Listed {n} products on sales channels",- "channels_add_failed": "Failed to list products on sales channels",- "channels_removed": "Unlisted {n} products from sales channels",- "channels_remove_failed": "Failed to unlist products from sales channels",- "tags_added": "Added tags to {n} products",+ "status_updated": "Updated status on {n} products",+ "tags_add_description": "Pick or create tags to add to these products.","tags_add_failed": "Failed to add tags",- "tags_removed": "Removed tags from {n} products",+ "tags_add_title": "Add tags",+ "tags_added": "Added tags to {n} products",+ "tags_remove_description": "Pick tags to remove from these products.","tags_remove_failed": "Failed to remove tags",- "deleted": "Deleted {n} products",- "delete_failed": "Failed to delete products"+ "tags_remove_title": "Remove tags",+ "tags_removed": "Removed tags from {n} products"},- "media_empty": "No media yet.",- "media_upload": "Upload media",- "variants_empty": "No variants yet.",- "status_options": {- "draft": "Draft",- "active": "Active",- "archived": "Archived"+ "clone_failed": "Failed to duplicate product",+ "clone_succeeded": "Product duplicated",+ "delete_failed": "Failed to delete product",+ "delete_succeeded": "Product deleted",+ "edit": {+ "bulk_prices": {+ "no_variants": "Add at least one variant to start editing prices."+ }},"inventory": {- "out_of_stock": "Out of stock",+ "in_stock": "{{count}} in stock","on_backorder": "On backorder",- "in_stock": "{{count}} in stock"- },- "variants_one": "{{count}} variant",- "variants_other": "{{count}} variants",- "transfers": {- "sheet_title": "New stock transfer",- "edit_sheet_title": "Transfer {{number}}",- "description_internal": "Inventory moved from <strong>{{source}}</strong> to <strong>{{destination}}</strong>.",- "description_external": "External receive into <strong>{{destination}}</strong>.",- "section_from": "From",- "section_to": "To",- "section_items": "Items",- "items_empty": "No items yet."+ "out_of_stock": "Out of stock"},- "options": {- "sheet_title_create": "Create option type",- "sheet_title_edit": "Edit option type",- "values_section": "Values",- "values_empty": "No values yet.",+ "media_empty": "No media yet.",+ "media_upload": "Upload media",+ "new": {+ "create_failed": "Failed to create product",+ "create_succeeded": "Product created",+ "description": "Set up your product — add variants, prices, inventory, media, and custom fields",+ "preview_slug_placeholder": "your-product-slug",+ "save_label": "Create product",+ "title": "New product"+ },+ "options": {"add_value": "Add option value",+ "sheet_title_create": "Create option type",+ "sheet_title_edit": "Edit option type","table": {"values": "Values"- }+ },+ "values_empty": "No values yet.",+ "values_section": "Values"},"price_lists": {- "title": "Price Lists",- "subtitle": "Targeted pricing for customer groups, regions, or volume tiers.",- "add_cta": "New price list",- "sheet_title_create": "Create price list",- "sheet_title_edit": "Edit price list",- "delete_confirm": {- "title": "Delete price list?",- "message": "Removing \"{{name}}\" deletes its prices. This cannot be undone."- },"activate": "Activate",- "deactivate": "Deactivate",- "schedule": "Schedule",- "unschedule": "Unschedule",- "edit_prices_cta": "Edit prices",- "add_products_cta": "Add products",- "remove_selected": "Remove selected",- "basics_section": "Basics",- "schedule_section": "Schedule",- "products_section": "Products",- "rules_section": "Rules",- "add_rule": "Add rule",- "rule_click_to_configure": "Click to configure",- "rule_no_options": "This rule has no configurable options — its presence alone applies the constraint.",- "rule_name_overflow": "{{names}} +{{count}} more",- "remove_rule_confirm": {- "title": "Remove rule?",- "message": "The rule is removed when you save the price list."- },- "rules_help": "Conditions that decide when this list applies. Use \"all\" to require every rule, \"any\" to take the first match.",- "rules_empty": "No rules — this list applies to every shopper.",- "add_rule_help": "Pick a rule type to configure.",- "rule_types_empty": "No rule types registered.",- "rule_types_all_used": "Every available rule type is already on this list.",- "rule_default_description": "Tune the rule's parameters.",- "products_help": "Pick the products this list applies to. Placeholder prices are created on save — fill them in below.",- "products_search_placeholder": "Search products by name…",- "products_empty_search": "No products match",- "products_selected_one": "{{count}} product selected.",- "products_selected_other": "{{count}} products selected.",- "prices_help_one": "{{count}} price configured. Open the bulk editor to update it.",- "prices_help_other": "{{count}} prices configured. Open the bulk editor to update them.",- "prices_help_zero": "Pick products above to seed placeholder prices, then open the bulk editor.","activate_confirm": {- "title": "Activate price list?","message": "\"{{name}}\" will apply to qualifying customers immediately and stay active until manually deactivated.",- "message_with_end": "\"{{name}}\" will apply to qualifying customers immediately and stay active until manually deactivated or its end date ({{ends_at}})."- },- "schedule_confirm": {- "title": "Schedule price list?",- "message": "\"{{name}}\" will go live on {{starts_at}} and stay active until its end date."+ "message_with_end": "\"{{name}}\" will apply to qualifying customers immediately and stay active until manually deactivated or its end date ({{ends_at}}).",+ "title": "Activate price list?"},+ "add_cta": "New price list",+ "add_products_cta": "Add products",+ "add_rule": "Add rule",+ "add_rule_help": "Pick a rule type to configure.",+ "basics_section": "Basics",+ "deactivate": "Deactivate","deactivate_confirm": {- "title": "Deactivate price list?",- "message": "\"{{name}}\" will stop applying to customers immediately. Existing orders are unaffected."+ "message": "\"{{name}}\" will stop applying to customers immediately. Existing orders are unaffected.",+ "title": "Deactivate price list?"},- "unschedule_confirm": {- "title": "Unschedule price list?",- "message": "\"{{name}}\" will no longer activate on its scheduled date. You can re-schedule or activate it manually later."+ "delete_confirm": {+ "message": "Removing \"{{name}}\" deletes its prices. This cannot be undone.",+ "title": "Delete price list?"},"edit_prices": {- "title": "Edit prices — {{name}}",- "currency_label": "Currency",- "empty": "No products in this list yet.","add_products_link": "Add products","columns": {+ "compare_at_price": "Compare-at price",+ "price": "Price","product": "Product",- "variant": "Variant","sku": "SKU",- "price": "Price",- "compare_at_price": "Compare-at price"+ "variant": "Variant"},- "variant_default": "Default",- "grid_aria": "Variant prices",- "search_placeholder": "Search by product, SKU, or option…",- "price_aria": "Price for {{label}}","compare_at_aria": "Compare-at price for {{label}}",- "save_cta": "Save prices",- "save_success_one": "Saved {{count}} price",- "save_success_other": "Saved {{count}} prices",- "save_failed": "Failed to save prices","count_summary_one": "{{count}} price in {{currency}}","count_summary_other": "{{count}} prices in {{currency}}",- "no_matches_for_filters": "No prices match the current filters.",- "no_matches_for_search": "No prices match \"{{search}}\".",- "empty_pick_products": "Pick products on the price list to start setting prices.",- "empty_no_base_prices": "No base prices yet.",+ "currency_label": "Currency","dirty_summary_one": "{{count}} unsaved change","dirty_summary_other": "{{count}} unsaved changes","discard_confirm": {- "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."- }+ "message_currency": "Switching currency will discard your unsaved prices.",+ "title": "Discard unsaved prices?"+ },+ "empty": "No products in this list yet.",+ "empty_no_base_prices": "No base prices yet.",+ "empty_pick_products": "Pick products on the price list to start setting prices.",+ "grid_aria": "Variant prices",+ "no_matches_for_filters": "No prices match the current filters.",+ "no_matches_for_search": "No prices match \"{{search}}\".",+ "price_aria": "Price for {{label}}",+ "save_cta": "Save prices",+ "save_failed": "Failed to save prices",+ "save_success_one": "Saved {{count}} price",+ "save_success_other": "Saved {{count}} prices",+ "search_placeholder": "Search by product, SKU, or option…",+ "title": "Edit prices — {{name}}",+ "variant_default": "Default"},+ "edit_prices_cta": "Edit prices",+ "no_changes": "No changes to save.",+ "prices_help_one": "{{count}} price configured. Open the bulk editor to update it.",+ "prices_help_other": "{{count}} prices configured. Open the bulk editor to update them.",+ "prices_help_zero": "Pick products above to seed placeholder prices, then open the bulk editor.","products_empty": "No products yet — add one to start editing prices.",- "no_changes": "No changes to save."- }+ "products_empty_search": "No products match",+ "products_help": "Pick the products this list applies to. Placeholder prices are created on save — fill them in below.",+ "products_search_placeholder": "Search products by name…",+ "products_section": "Products",+ "products_selected_one": "{{count}} product selected.",+ "products_selected_other": "{{count}} products selected.",+ "remove_rule_confirm": {+ "message": "The rule is removed when you save the price list.",+ "title": "Remove rule?"+ },+ "remove_selected": "Remove selected",+ "rule_click_to_configure": "Click to configure",+ "rule_default_description": "Tune the rule's parameters.",+ "rule_name_overflow": "{{names}} +{{count}} more",+ "rule_no_options": "This rule has no configurable options — its presence alone applies the constraint.",+ "rule_types_all_used": "Every available rule type is already on this list.",+ "rule_types_empty": "No rule types registered.",+ "rules_empty": "No rules — this list applies to every shopper.",+ "rules_help": "Conditions that decide when this list applies. Use \"all\" to require every rule, \"any\" to take the first match.",+ "rules_section": "Rules",+ "schedule": "Schedule",+ "schedule_confirm": {+ "message": "\"{{name}}\" will go live on {{starts_at}} and stay active until its end date.",+ "title": "Schedule price list?"+ },+ "schedule_section": "Schedule",+ "sheet_title_create": "Create price list",+ "sheet_title_edit": "Edit price list",+ "subtitle": "Targeted pricing for customer groups, regions, or volume tiers.",+ "title": "Price Lists",+ "unschedule": "Unschedule",+ "unschedule_confirm": {+ "message": "\"{{name}}\" will no longer activate on its scheduled date. You can re-schedule or activate it manually later.",+ "title": "Unschedule price list?"+ }+ },+ "publishing": {+ "caption_hidden_after": "Comes down {{date}}",+ "caption_live": "Visible to customers now",+ "caption_not_available": "Hidden — product is {{product_status}}",+ "caption_scheduled": "Goes live {{date}}",+ "caption_unpublished": "Was hidden on {{date}}",+ "caption_window": "Live {{start}} → {{end}}",+ "empty": "Not listed on any sales channel yet.",+ "inactive_marker": "Inactive",+ "manage_cta": "Manage",+ "manage_description": "Pick which sales channels list this product. Toggle a channel off to unlist it everywhere.",+ "manage_title": "Manage sales channels",+ "no_channels": "No sales channels available. Create one in Settings → Sales channels.",+ "status_hidden": "Hidden",+ "status_live": "Live",+ "status_not_available": "Not available",+ "status_scheduled": "Scheduled",+ "title": "Publishing"+ },+ "section_basics": "Basics",+ "section_categorization": "Categorization",+ "section_inventory": "Inventory",+ "section_media": "Media",+ "section_organization": "Organization",+ "section_pricing": "Pricing",+ "section_seo": "SEO",+ "section_variants": "Variants",+ "status_options": {+ "active": "Active",+ "archived": "Archived",+ "draft": "Draft"+ },+ "transfers": {+ "description_external": "External receive into <strong>{{destination}}</strong>.",+ "description_internal": "Inventory moved from <strong>{{source}}</strong> to <strong>{{destination}}</strong>.",+ "edit_sheet_title": "Transfer {{number}}",+ "items_empty": "No items yet.",+ "section_from": "From",+ "section_items": "Items",+ "section_to": "To",+ "sheet_title": "New stock transfer"+ },+ "variants_empty": "No variants yet.",+ "variants_one": "{{count}} variant",+ "variants_other": "{{count}} variants"+ },+ "profile": {+ "load_failed_title": "Couldn't load your profile",+ "personal_details": "Personal Details",+ "subtitle": "Manage your personal details and admin language.",+ "title": "Profile"+ },+ "promotions": {+ "create_cta": "Create promotion",+ "gift_cards": {+ "batch_section": "Batch",+ "create_batch_cta": "Create {{count}} gift cards",+ "create_label": "Create gift card",+ "delete_confirm": {+ "message": "This will void the gift card and prevent it from being redeemed.",+ "title": "Delete gift card?"+ },+ "edit_sheet_title": "Gift card",+ "new_cta": "New gift card",+ "new_sheet_title": "New gift card",+ "no_customer": "No customer attached",+ "not_found": "Gift card not found.",+ "prefix": {+ "auto_placeholder": "Auto-generated when blank",+ "label": "Prefix",+ "placeholder": "e.g. WELCOME — codes will be WELCOME-abc123"+ },+ "sheet": {+ "create_description": "Issue a single gift card or generate a batch with auto-generated codes.",+ "edit_description": "Update the gift card's customer or expiry. The code and amount are immutable once issued."+ },+ "status_options": {+ "expired": "Expired",+ "redeemed": "Redeemed",+ "void": "Void"+ },+ "usage": {+ "issued_by": "Issued by",+ "remaining": "Remaining",+ "title": "Usage",+ "used": "Used"+ },+ "validation": {+ "amount_positive": "Amount must be greater than zero",+ "amount_required": "Amount is required",+ "currency_required": "Currency is required",+ "prefix_required": "Prefix is required for batches"+ }+ },+ "loading": "Loading promotion…",+ "new_title": "New promotion"},"settings": {- "store": {- "title": "Store settings",- "subtitle": "General configuration and store-wide defaults.",- "tab_general": "General",- "tab_standards": "Standards and formats",- "tab_storefront_access": "Storefront access"+ "allowed_origins": {+ "add_sheet_title": "Add allowed origin",+ "edit_sheet_title": "Edit allowed origin"+ },+ "api_keys": {+ "empty_publishable": "No publishable keys yet.",+ "empty_secret": "No secret keys yet.",+ "new_cta": "New key",+ "publishable_help": "Used by your storefront. Safe to expose in client-side code.",+ "publishable_section": "Publishable keys",+ "save_secret_description": "Copy this value now — we won't show it again.",+ "save_secret_title": "Save your secret key",+ "scope_badge": {+ "full_access": "Full access",+ "read_all": "Read all"+ },+ "secret_help": "Server-to-server only. Scope each key to the operations it needs.",+ "secret_section": "Secret keys",+ "subtitle": "Authorize integrations and apps to call the Admin API.",+ "table": {+ "all_channels": "All channels",+ "channel": "Channel",+ "key": "Key",+ "last_used_at": "Last used",+ "scopes": "Scopes"+ },+ "title": "API keys"+ },+ "custom_field_definitions": {+ "add_sheet_title": "Add custom field",+ "edit_sheet_title": "Edit custom field"},"emails": {- "title": "Email settings",- "subtitle": "Sender addresses, notifications, and the logo embedded in transactional emails.",- "section_delivery": "Delivery",+ "load_failed_title": "Couldn't load email settings",+ "logo_dimensions_help": "Recommended: 204×104 pixels.","section_addresses": "Email addresses",+ "section_delivery": "Delivery","section_logo": "Logo",- "logo_dimensions_help": "Recommended: 204×104 pixels.",- "load_failed_title": "Couldn't load email settings"+ "subtitle": "Sender addresses, notifications, and the logo embedded in transactional emails.",+ "title": "Email settings"},- "webhooks": {- "title": "Webhooks",- "subtitle": "Subscribe HTTPS endpoints to events fired by your store.",- "search_placeholder": "Search by URL…",- "new_cta": "New endpoint",- "empty_title": "No webhook endpoints yet",- "empty_description": "Create an endpoint to receive a signed POST every time a subscribed event fires.",- "add_sheet_title": "Add webhook endpoint",- "edit_sheet_title": "Edit webhook endpoint",- "deliveries_sheet_title": "Recent deliveries",+ "imports": {"delete_confirm": {- "title": "Delete webhook endpoint?",- "message": "{{name}} will stop receiving deliveries immediately. Past delivery history is also removed."+ "message": "This removes {{number}}, its rows and the uploaded file.",+ "title": "Delete import?"},- "detail": {- "load_failed_title": "Couldn't load this webhook endpoint",- "delete_label": "Delete endpoint",- "details_title": "Details",- "edit_title": "Edit endpoint",- "url": "Destination URL",- "subscriptions": "Events"+ "empty_title": "No imports yet",+ "search_placeholder": "Search by number…",+ "table": {+ "failed_count": "{{failed}} failed",+ "number": "Number",+ "rows": "Rows",+ "status": "Status",+ "type": "Type"},- "save_secret_title": "Save your signing secret",- "save_secret_description": "Verify incoming webhook signatures with this key. We won't show it again.",+ "title": "Imports"+ },+ "markets": {+ "add_sheet_title": "Add market",+ "edit_sheet_title": "Edit market"+ },+ "payment_methods": {+ "add_sheet_title": "Add payment method",+ "edit_sheet_title": "Edit payment method"+ },+ "stock_locations": {+ "add_sheet_title": "Add stock location",+ "edit_sheet_title": "Edit stock location",+ "search_placeholder": "Search stock locations…"+ },+ "store": {+ "subtitle": "General configuration and store-wide defaults.",+ "tab_general": "General",+ "tab_standards": "Standards and formats",+ "tab_storefront_access": "Storefront access",+ "title": "Store settings"+ },+ "tax_categories": {+ "add_sheet_title": "Add tax category",+ "edit_sheet_title": "Edit tax category"+ },+ "webhooks": {"actions": {- "send_test": "Send test","disable": "Disable","enable": "Re-enable",- "view_deliveries": "View deliveries",- "redeliver": "Redeliver"+ "redeliver": "Redeliver",+ "send_test": "Send test",+ "view_deliveries": "View deliveries"},- "status": {- "inactive": "Inactive",- "disabled": "Auto-disabled",- "disabled_reason": "Disabled: {{reason}}"+ "add_sheet_title": "Add webhook endpoint",+ "delete_confirm": {+ "message": "{{name}} will stop receiving deliveries immediately. Past delivery history is also removed.",+ "title": "Delete webhook endpoint?"},- "health": {- "label": "Health",- "healthy": "Healthy ({{percentage}}%)",- "degraded": "Degraded ({{percentage}}%)",- "failing": "Failing ({{percentage}}%)",- "disabled": "Disabled",- "no_deliveries": "No deliveries yet",- "auto_disabled_alert": "This endpoint was automatically disabled after repeated delivery failures.",- "re_enable_cta": "Re-enable",- "metric_total": "Deliveries",- "metric_successful": "Successful",- "metric_failed": "Failed",- "row_counters_successful_one": "{{count}} successful",- "row_counters_successful_other": "{{count}} successful",- "row_counters_failed_one": "{{count}} failed",- "row_counters_failed_other": "{{count}} failed"+ "deliveries": {+ "detail": {+ "copy_payload_aria": "Copy request payload",+ "copy_response_aria": "Copy response body",+ "delivered_at": "Delivered at",+ "error_type": "Error type",+ "event": "Event",+ "execution_time": "Execution time",+ "request_errors": "Transport error",+ "request_payload": "Request payload",+ "response_body": "Response body",+ "response_body_truncated": "Response body was truncated to {{limit}} characters.",+ "response_code": "Response code",+ "url": "Destination URL"+ },+ "detail_sheet_title": "Delivery details",+ "empty": "No deliveries yet — send a test to verify your endpoint.",+ "redeliver_queued": "Redelivery queued.",+ "search_placeholder": "Search by event name…",+ "status": {+ "error": "Error",+ "failure": "Failed",+ "pending": "Pending",+ "success": "Succeeded"+ },+ "table": {+ "code": "Response",+ "delivered_at": "Delivered at",+ "event": "Event",+ "execution_time": "Duration"+ },+ "test_failed": "Failed to send test webhook.",+ "test_sent": "Test webhook queued."},- "table": {- "url": "URL",- "events": "Events",- "recent_deliveries": "Last 7 days",- "last_delivery": "Last delivery",- "copy_url_aria": "Copy URL"+ "deliveries_sheet_title": "Recent deliveries",+ "detail": {+ "delete_label": "Delete endpoint",+ "details_title": "Details",+ "edit_title": "Edit endpoint",+ "load_failed_title": "Couldn't load this webhook endpoint",+ "subscriptions": "Events",+ "url": "Destination URL"},- "events_all": "All events",- "events_count_one": "{{count}} event",- "events_count_other": "{{count}} events",- "events_custom_input_placeholder": "custom.event_name",- "events_remove_aria": "Remove {{event}}",+ "edit_sheet_title": "Edit webhook endpoint",+ "empty_description": "Create an endpoint to receive a signed POST every time a subscribed event fires.",+ "empty_title": "No webhook endpoints yet","event_groups": {"asset": "Asset","custom": "Custom","customer": "Customer","digital": "Digital",+ "fulfillment": "Fulfillment","gift_card": "Gift card","gift_card_batch": "Gift card batch","import_export": "Import / Export",@@ -1561,7 +2133,6 @@"refund": "Refund","report": "Report","return": "Return",- "shipment": "Shipment","stock_item": "Stock item","stock_movement": "Stock movement","stock_reservation": "Stock reservation",@@ -1570,1166 +2141,716 @@"variant": "Variant","wishlist": "Wishlist"},- "deliveries": {- "table": {- "event": "Event",- "code": "Response",- "execution_time": "Duration",- "delivered_at": "Delivered at"- },- "status": {- "pending": "Pending",- "success": "Succeeded",- "failure": "Failed",- "error": "Error"- },- "empty": "No deliveries yet — send a test to verify your endpoint.",- "search_placeholder": "Search by event name…",- "test_sent": "Test webhook queued.",- "test_failed": "Failed to send test webhook.",- "redeliver_queued": "Redelivery queued.",- "detail_sheet_title": "Delivery details",- "detail": {- "event": "Event",- "url": "Destination URL",- "delivered_at": "Delivered at",- "response_code": "Response code",- "execution_time": "Execution time",- "error_type": "Error type",- "request_errors": "Transport error",- "request_payload": "Request payload",- "response_body": "Response body",- "response_body_truncated": "Response body was truncated to {{limit}} characters.",- "copy_payload_aria": "Copy request payload",- "copy_response_aria": "Copy response body"- }- }- },- "api_keys": {- "title": "API keys",- "subtitle": "Authorize integrations and apps to call the Admin API.",- "publishable_section": "Publishable keys",- "publishable_help": "Used by your storefront. Safe to expose in client-side code.",- "secret_section": "Secret keys",- "secret_help": "Server-to-server only. Scope each key to the operations it needs.",- "new_cta": "New key",- "empty_publishable": "No publishable keys yet.",- "empty_secret": "No secret keys yet.",+ "events_all": "All events",+ "events_count_one": "{{count}} event",+ "events_count_other": "{{count}} events",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "Remove {{event}}",+ "health": {+ "auto_disabled_alert": "This endpoint was automatically disabled after repeated delivery failures.",+ "degraded": "Degraded ({{percentage}}%)",+ "disabled": "Disabled",+ "failing": "Failing ({{percentage}}%)",+ "healthy": "Healthy ({{percentage}}%)",+ "label": "Health",+ "metric_failed": "Failed",+ "metric_successful": "Successful",+ "metric_total": "Deliveries",+ "no_deliveries": "No deliveries yet",+ "re_enable_cta": "Re-enable",+ "row_counters_failed_one": "{{count}} failed",+ "row_counters_failed_other": "{{count}} failed",+ "row_counters_successful_one": "{{count}} successful",+ "row_counters_successful_other": "{{count}} successful"+ },+ "new_cta": "New endpoint",+ "save_secret_description": "Verify incoming webhook signatures with this key. We won't show it again.",+ "save_secret_title": "Save your signing secret",+ "search_placeholder": "Search by URL…",+ "status": {+ "disabled": "Auto-disabled",+ "disabled_reason": "Disabled: {{reason}}",+ "inactive": "Inactive"+ },+ "subtitle": "Subscribe HTTPS endpoints to events fired by your store.","table": {- "key": "Key",- "scopes": "Scopes",- "last_used_at": "Last used",- "channel": "Channel",- "all_channels": "All channels"+ "copy_url_aria": "Copy URL",+ "events": "Events",+ "last_delivery": "Last delivery",+ "recent_deliveries": "Last 7 days",+ "url": "URL"},- "save_secret_title": "Save your secret key",- "save_secret_description": "Copy this value now — we won't show it again.",- "scope_badge": {- "full_access": "Full access",- "read_all": "Read all"- }- },- "payment_methods": {- "add_sheet_title": "Add payment method",- "edit_sheet_title": "Edit payment method"- },- "tax_categories": {- "add_sheet_title": "Add tax category",- "edit_sheet_title": "Edit tax category"+ "title": "Webhooks"+ }+ },+ "staff": {+ "actions": {+ "remove": "Remove from staff",+ "resend": "Resend"},- "markets": {- "add_sheet_title": "Add market",- "edit_sheet_title": "Edit market"+ "edit_sheet": {+ "title": "Edit teammate"},- "custom_field_definitions": {- "add_sheet_title": "Add custom field",- "edit_sheet_title": "Edit custom field"+ "empty": "No staff yet",+ "empty_description": "Invite a teammate to collaborate on this store.",+ "invitations_section": "Pending invitations",+ "invite_cta": "Invite teammate",+ "invite_sheet": {+ "description": "We'll email them a link to set their password.",+ "title": "Invite teammate"},- "stock_locations": {- "add_sheet_title": "Add stock location",- "edit_sheet_title": "Edit stock location",- "search_placeholder": "Search stock locations…"+ "members_section": "Members",+ "messages": {+ "removed": "Removed from staff",+ "revoked": "Invitation revoked",+ "updated": "Staff updated"},- "allowed_origins": {- "add_sheet_title": "Add allowed origin",- "edit_sheet_title": "Edit allowed origin"+ "subtitle": "Manage admin teammates and roles",+ "table": {+ "member": "Member",+ "role": "Role",+ "roles": "Roles"},- "imports": {- "title": "Imports",- "search_placeholder": "Search by number…",- "empty_title": "No imports yet",- "table": {- "number": "Number",- "type": "Type",- "status": "Status",- "rows": "Rows",- "failed_count": "{{failed}} failed"- },- "delete_confirm": {- "title": "Delete import?",- "message": "This removes {{number}}, its rows and the uploaded file."- }- }- },- "promotions": {- "new_title": "New promotion",- "create_cta": "Create promotion",- "loading": "Loading promotion…",- "gift_cards": {- "new_sheet_title": "New gift card",- "edit_sheet_title": "Gift card",- "not_found": "Gift card not found.",- "new_cta": "New gift card",- "create_label": "Create gift card",- "batch_section": "Batch",- "create_batch_cta": "Create {{count}} gift cards",- "status_options": {- "redeemed": "Redeemed",- "expired": "Expired",- "void": "Void"- },- "sheet": {- "create_description": "Issue a single gift card or generate a batch with auto-generated codes.",- "edit_description": "Update the gift card's customer or expiry. The code and amount are immutable once issued."- },- "delete_confirm": {- "title": "Delete gift card?",- "message": "This will void the gift card and prevent it from being redeemed."- },- "validation": {- "amount_positive": "Amount must be greater than zero",- "amount_required": "Amount is required",- "prefix_required": "Prefix is required for batches",- "currency_required": "Currency is required"- },- "prefix": {- "label": "Prefix",- "placeholder": "e.g. WELCOME — codes will be WELCOME-abc123",- "auto_placeholder": "Auto-generated when blank"- },- "no_customer": "No customer attached",- "usage": {- "title": "Usage",- "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"- },- "getting_started": {- "title": "Getting Started",- "description": "Finish these steps to launch your store.",- "progress": "{{done}} of {{total}} completed",- "tasks": {- "setup_payment_method": {- "title": "Set up payment methods",- "description": "To collect payments, set up at least one online payment provider.",- "cta": "Set up payment methods"- },- "add_products": {- "title": "Add products",- "description": "Add products to your store — your own, or invite third-party vendors to sell together.",- "cta": "Add products",- "import_cta": "Import products from CSV"- },- "set_customer_support_email": {- "title": "Set customer support email",- "description": "Shown on your storefront as the contact point for customer questions and support.",- "cta": "Email settings"- },- "setup_taxes_collection": {- "title": "Set up taxes collection",- "description": "To collect taxes, set up your tax rates.",- "cta": "Tax settings"- },- "setup_storefront": {- "title": "Set up storefront",- "description": "Connect your web storefront or mobile app with your Store API credentials, and save your storefront URL.",- "cta": "Connect storefront"- }- },- "storefront_sheet": {- "title": "Connect your storefront",- "description": "Use these credentials in any client that talks to the Store API — a web storefront, a mobile app, or anything else.",- "api_url_label": "Store API URL",- "publishable_key_label": "Publishable API key",- "deploy_title": "Recommended: deploy the official Next.js storefront",- "deploy_copy": "Deploying clones the open-source storefront to your Git account and builds it on Vercel with your credentials prefilled. Once it finishes, copy its URL into the field below.",- "deploy_button": "Deploy to Vercel",- "env_description": "Your Spree Store API URL and publishable key. Both are prefilled from your store — adjust them before deploying if needed.",- "storefront_url_label": "Storefront URL",- "storefront_url_help": "The URL customers use to reach your storefront. It becomes the base for links in customer emails and is automatically added as an allowed origin so browser-based storefronts can call the Store API.",- "save": "Save & finish setup",- "saved": "Storefront URL saved: {{url}}",- "invalid_url": "This doesn't look like a valid storefront URL.",- "see_online_demo": "See online demo",- "local_installation_instructions": "Local installation instructions",- "key_error": "Couldn't load your publishable API key.",- "storefront_url_placeholder": "https://myshop.com"- }- }- },- "invitation": {- "missing_token_title": "Missing invitation token",- "missing_token_message": "This link looks incomplete. Ask whoever invited you to send it again.",- "loading": "Loading invitation…",- "not_found_title": "Invitation not found",- "not_found_message": "This invitation has expired, been revoked, or already been accepted. Ask the inviter to send a new one.",- "generic_error_title": "Could not load invitation",- "generic_error_message": "Something went wrong. Please try again.",- "join_store": "Join {{store}}",- "invited_by": "{{email}} invited you",- "invited_generic": "You have been invited",- "invited_as_role": " as {{role}}",- "sign_in_to_accept": ". Sign in to accept.",- "create_to_accept": ". Create your account to accept.",- "could_not_accept": "Could not accept invitation",- "accepting": "Accepting…",- "sign_in_and_accept": "Sign in & accept",- "create_and_accept": "Create account & accept"- },- "staff": {- "actions": {- "copy_invitation_link": "Copy invitation link",- "invitation_link_copied": "Invitation link copied"- },- "autocomplete": {- "placeholder": "Search staff…",- "empty": "No staff match"- },- "confirm": {- "remove_title": "Remove from store?",- "remove_message": "{{name}} will lose access to this store.",- "revoke_title": "Revoke invitation?",- "revoke_message": "{{email}} will no longer be able to accept this invitation."- },- "errors": {- "failed_to_remove": "Failed to remove staff",- "failed_to_resend": "Failed to resend invitation",- "failed_to_revoke": "Failed to revoke invitation"- },- "invite": {- "email_placeholder": "[email protected]",- "roles_loading": "Loading roles…",- "roles_placeholder": "Select a role",- "no_roles": "No roles available."- },- "edit": {- "roles_label": "Roles for this store"- },- "edit_description": "Update profile details and assigned roles for this staff member.",- "actions_aria": "Actions",- "validation": {- "role_required": "Pick a role",- "roles_required": "Pick at least one role"- }- },- "api_keys": {- "empty_description": "Create one to get started.",- "create_sheet_title": "Create API key",- "create_sheet_description": "Choose a key type, then pick the scopes it can use.",- "edit_sheet_title": "Edit API key",- "edit_sheet_description": "Rename this key. Scopes are fixed when a key is created and can't be changed.",- "scopes_immutable_help": "Scopes can't be changed after a key is created. To change them, create a new key with the scopes you need and revoke this one.",- "key_type": {- "secret_title": "Secret key",- "secret_description": "Server-to-server. Each key carries an explicit list of scopes.",- "publishable_title": "Publishable key",- "publishable_description": "Safe to expose in client-side code. Grants public/guest access."- },- "scope_picker": {- "resource_header": "Resource",- "read_header": "Read",- "write_header": "Write",- "read_aria": "Read {{resource}}",- "write_aria": "Write {{resource}}",- "full_access_label": "Full access (write_all)",- "read_all_label": "Read all (read_all)",- "resources": {- "orders": "Orders",- "products": "Products",- "promotions": "Promotions",- "customers": "Customers",- "payments": "Payments",- "fulfillments": "Fulfillments",- "refunds": "Refunds",- "gift_cards": "Gift cards",- "store_credits": "Store credits",- "stock": "Stock",- "categories": "Categories",- "settings": "Settings",- "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.",- "revoke_confirm": {- "title": "Revoke key?",- "message": "Any integration using this key will stop working immediately."+ "title": "Staff"+ }+ },+ "payment_methods": {+ "add_cta": "Add payment method",+ "columns": {+ "storefront": "Storefront"},+ "create_description": "Pick a provider and configure its credentials.",+ "create_label": "Create payment method","delete_confirm": {- "title": "Delete key?",- "message": "This permanently removes the key. Prefer revoke if you might restore access later."+ "message": "{{name}} will no longer be available at checkout.",+ "title": "Delete payment method?"},- "dropdown": {- "revoke": "Revoke key",- "copy_token_aria": "Copy token"+ "edit_description": "Update name, visibility, or status.",+ "empty": "No payment methods configured",+ "messages": {+ "created": "Payment method created",+ "deleted": "Payment method deleted",+ "updated": "Payment method updated"},- "badge": {- "revoked": "Revoked",- "never_used": "Never"+ "provider_description": "Provider: {{provider}}",+ "search_placeholder": "Search by name…",+ "status": {+ "disabled": "Disabled"},- "errors": {- "failed_to_delete": "Failed to delete key",- "failed_to_update": "Failed to update key",- "failed_to_create": "Failed to create key"+ "storefront": {+ "admin_only": "Admin only",+ "visible": "Visible"},- "by_email": "by {{email}}",- "create_key_cta": "Create key",- "validation": {- "scope_required": "Pick at least one scope"- }+ "title": "Payment Methods"},- "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",- "bulk_removed": "Removed {{count}} customers from groups",- "bulk_add_failed": "Failed to add customers to groups",- "bulk_remove_failed": "Failed to remove customers from groups",- "picker": {- "add_title": "Add to groups",- "add_description": "Pick the groups to add these customers to.",- "remove_title": "Remove from groups",- "remove_description": "Pick the groups to remove these customers from."- },- "view_members": "View members",- "count_one": "{{count}} customer",- "count_other": "{{count}} customers",- "create_label": "Create customer group",- "create_description": "Create a customer group to segment your customers for promotions, analytics, or marketing.",- "edit_description": "Update the name or description.",- "default_name": "This group",- "delete_confirm": {- "title": "Delete customer group?",- "message": "{{name}} will be removed. Customers in this group are not deleted."- }- },- "tags": {- "bulk_add_action": "Add tags…",- "bulk_remove_action": "Remove tags…",- "bulk_added": "Added tags to {n} customers",- "bulk_removed": "Removed tags from {n} customers",- "bulk_add_failed": "Failed to add tags",- "bulk_remove_failed": "Failed to remove tags",- "picker": {- "add_title": "Add tags",- "add_description": "Pick or create tags to add to these customers.",- "remove_title": "Remove tags",- "remove_description": "Pick tags to remove from these customers."- }- },- "row_actions": {- "delete_confirm": "Delete {{email}}? Customers with completed orders cannot be removed."- },- "detail": {- "delete_label": "Delete customer",- "edit_profile_description": "Update the customer's profile information.",- "subscribed_to_marketing": "Subscribed to marketing",- "not_subscribed_to_marketing": "Not subscribed to marketing",- "customer_since": "Customer since",- "last_order_placed": "Last order placed",- "orders_table": {- "order": "Order",- "date": "Date"- },- "no_internal_notes": "No internal notes",- "address": {- "default_billing": "Default billing",- "default_shipping": "Default shipping",- "set_default_billing": "Set as default billing",- "set_default_shipping": "Set as default shipping",- "delete_confirm_message": "Delete this address?"- },- "store_credit": {- "title": "Store credit",- "empty": "No store credits issued",- "table": {- "used": "Used",- "remaining": "Remaining",- "category": "Category",- "memo": "Memo"- },- "delete_confirm_message": "Delete this store credit?",- "edit_description": "Adjust the amount, category, or memo. Used balance cannot be edited.",- "add_description": "Issue store credit to this customer's account."- },- "groups": {- "title": "Customer groups",- "empty": "Not in any groups",- "edit_title": "Edit customer groups",- "edit_description": "Add or remove the groups this customer belongs to.",- "save_failed": "Failed to update customer groups"- }- },- "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"- }+ "preferences": {+ "additional_item": "Additional Item Cost",+ "amount": "Amount",+ "base_amount": "Base Amount",+ "base_percent": "Base Percent",+ "currency": "Currency",+ "discount_amount": "Discount Amount",+ "first_item": "First Item Cost",+ "flat_percent": "Flat Percent",+ "max_items": "Max Items",+ "max_quantity": "Maximum quantity",+ "min_quantity": "Minimum quantity",+ "minimal_amount": "Minimal Amount",+ "normal_amount": "Normal Amount",+ "percent": "Percent",+ "preferred_amount": "Amount",+ "preferred_percent": "Percent"},- "orders": {- "table": {- "search_placeholder": "Search orders…",- "empty": "No orders found"- },+ "products": {+ "category_search_placeholder": "Search categories…","columns": {- "number": "Number",- "date": "Date",- "customer": "Customer",- "payment": "Payment",- "fulfillment": "Fulfillment",- "items": "Items",- "tags": "Tags",+ "in_stock": "In Stock",+ "price": "Price","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"+ "delete_confirm": "Are you sure you want to delete this product?",+ "delete_label": "Delete product",+ "inventory": {+ "backorder_aria": "Allow backorder at {{location}}",+ "columns": {+ "backorder": "Backorder",+ "location": "Location",+ "on_hand": "On hand"+ },+ "empty_no_locations": "Add a stock location in Settings to start tracking inventory.",+ "empty_no_variants": "Stock levels are managed per stock location. Add a variant to start tracking inventory.",+ "on_hand_aria": "On hand at {{location}}",+ "unknown_location": "Unknown location"},- "fulfillment_statuses": {- "backorder": "Backorder",- "canceled": "Canceled",- "partial": "Partial",- "pending": "Pending",- "ready": "Ready",- "fulfilled": "Fulfilled"+ "media": {+ "assigned_variants_help": "Pick the variants this image represents. Leave blank to apply to all variants.",+ "assigned_variants_label": "Assigned variants",+ "delete_confirm": "Delete this media? This cannot be undone.",+ "drop_hint": "Drag & drop media here, or click to browse",+ "edit_title": "Edit media",+ "file_types_hint": "PNG, JPG, WebP up to 10MB",+ "upload_failed": "Failed to upload {{name}}: {{message}}",+ "upload_status_failed": "Failed"},- "new": {- "use_default_addresses": "Use customer's default billing & shipping addresses",- "add_variant": "Add a variant",- "items_table": {- "variant": "Variant",- "sku": "SKU",- "qty": "Qty"+ "no_categories_found": "No categories found",+ "options": {+ "add_cta": "Add option type",+ "count_one": "{{count}} value",+ "count_other": "{{count}} values",+ "create_description": "Define an option that variants can use (e.g. size, color).",+ "create_label": "Create option type",+ "delete_confirm": {+ "message": "This will also delete all of its values. Variants using these values will lose them.",+ "title": "Delete option type?"},- "creates_draft_note": "Creates a draft order. Add payments and complete it after creation."- },- "detail": {- "load_failed_message": "We couldn't load order {{orderId}}.",- "confirm": {- "complete_message": "Complete this draft order now?",- "approve_message": "Approve this order?",- "resume_message": "Resume this canceled order?",- "cancel_message": "Are you sure you want to cancel this order?",- "remove_item_message": "Remove this item from the order?",- "ship_message": "Ship this fulfillment?",- "cancel_shipment_message": "Cancel this fulfillment?",- "capture_message": "Capture this payment?",- "void_message": "Void this payment?",- "remove_gift_card_message": "Remove this gift card from the order?",- "remove_store_credit_message": "Remove store credit from the order?"+ "edit_description": "Edit the option type and its values.",+ "image_upload_failed": "Failed to upload image",+ "kinds": {+ "buttons": "Buttons",+ "color_swatch": "Color swatch",+ "dropdown": "Dropdown"},- "dropdown": {- "complete_order": "Complete Order",- "preview_order": "Preview Order",- "resend_confirmation": "Resend Confirmation",- "edit_quantity": "Edit Quantity",- "cancel_shipment": "Cancel Shipment",- "void_payment": "Void Payment"+ "value_label_placeholder": "e.g. Small",+ "value_name_placeholder": "e.g. small",+ "values_help": "Drag values to reorder. The first value is the default for new variants."+ },+ "price_lists": {+ "errors": {+ "failed_to_activate": "Failed to activate price list",+ "failed_to_deactivate": "Failed to deactivate price list"},"messages": {- "canceled": "Order canceled",- "completed": "Order completed",- "approved": "Order approved",- "resumed": "Order resumed",- "shipped": "Fulfillment shipped",- "captured": "Payment captured",- "voided": "Payment voided",- "confirmation_sent": "Confirmation sent"- },- "errors": {- "cancel_failed": "Failed to cancel order",- "complete_failed": "Failed to complete order",- "approve_failed": "Failed to approve order",- "resume_failed": "Failed to resume order",- "confirmation_send_failed": "Failed to send confirmation"+ "activated": "Price list activated",+ "created": "Price list created",+ "deactivated": "Price list deactivated",+ "deleted": "Price list deleted",+ "updated": "Price list updated"},- "variant_search": {- "description": "Search for a product variant to add to this order.",- "label": "Search variant",- "empty": "No variants found",- "sku_prefix": "SKU",- "placeholder": "Type product name or SKU (min 3 chars)…"+ "validation": {+ "ends_after_starts": "Must be after start date."+ }+ },+ "save_label": "Save product",+ "seo": {+ "meta_description_placeholder": "SEO description",+ "meta_title_placeholder": "SEO title",+ "slug_placeholder": "product-url-handle"+ },+ "tax_category_placeholder": "Select tax category",+ "transfers": {+ "create_description": "Move stock between locations, or receive new stock from an external vendor.",+ "delete_confirm": {+ "message": "Stock movements created by this transfer will be reversed.",+ "title": "Delete this transfer?"},- "edit_quantity": {- "title": "Edit Quantity",- "description": "Set the quantity for this line item."+ "destination_placeholder": "Select destination location",+ "details_card": "Details",+ "different_locations_error": "Source and destination must differ.",+ "external_label": "External (vendor receive)",+ "fields": {+ "created": "Created",+ "external_receive": "External receive",+ "immutable_note": "Stock transfers are immutable once created.",+ "internal": "Internal",+ "reference": "Reference",+ "type": "Type"},"items_table": {- "item": "Item",- "price": "Price",- "qty": "Qty"- },- "tracking": {- "label": "Tracking Number",- "description": "Update the tracking number for this shipment.",- "prefix": "Tracking",- "shipped_prefix": "Shipped",- "edit_title": "Edit Tracking",- "add_title": "Add Tracking"+ "qty": "Qty",+ "sku": "SKU",+ "variant": "Variant"},- "payments_table": {- "number": "Number",- "method": "Method",- "state": "State"+ "new_cta": "New transfer",+ "reference_label": "Reference",+ "reference_placeholder": "PO number, vendor invoice, …",+ "review_description": "Review the transfer before creating. Items can't be changed afterwards.",+ "search_items_placeholder": "Search by name or SKU (3+ chars)…"+ },+ "variant_media_picker": {+ "add_count_one": "Add {{count}}",+ "add_count_other": "Add {{count}}",+ "empty_all_linked": "All product media is already linked to this variant.",+ "empty_no_media": "No product media yet — upload images on the product first.",+ "title": "Select from product gallery",+ "trigger": "Select from product gallery"+ },+ "variants": {+ "add_option": "Add option",+ "create_option_type": "Create new option type",+ "create_option_type_title": "New option type",+ "create_value": "New value",+ "create_value_title": "New option value",+ "default_variant": "Default variant",+ "edit_row_aria": "Edit {{name}}",+ "edit_variant": "Edit variant — {{name}}",+ "errors": {+ "failed_to_create_option_type": "Failed to create option type",+ "failed_to_create_value": "Failed to create value"},- "payment_form": {- "description": "Charge a payment method against this order.",- "method_label": "Payment method",- "method_placeholder": "Choose a payment method",- "source_label": "Source",- "amount_help": "Leave blank to default to the outstanding balance.",- "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…"+ "keep": "Keep all",+ "option_type_label": "Option type",+ "option_type_placeholder": "Pick an option type",+ "orphan_warning": "{{count}} existing variant(s) will be removed on save:",+ "orphan_warning_one": "{{count}} existing variant no longer matches the selected options and will be removed on save:",+ "orphan_warning_other": "{{count}} existing variants no longer match the selected options and will be removed on save:",+ "remove_row_aria": "Remove {{name}}",+ "sheet": {+ "availability": "Availability",+ "identity": "Identity",+ "tax_category_placeholder": "Inherit from product"},- "summary": {- "canceled_at": "Canceled at",- "canceler": "Canceler",- "approved_by": "Approved by",- "promotions": "Promotions",- "adjustments": "Adjustments",- "tax_included": "Tax (included)",- "tax_additional": "Tax (additional)",- "payment_total": "Payment total",- "outstanding_balance": "Outstanding balance"+ "title": "Variants",+ "variant_label": "Variant"+ }+ },+ "promotions": {+ "action_edit": {+ "description": "Configure the action's parameters.",+ "no_options": "This action has no configurable options."+ },+ "action_picker": {+ "description": "Pick what should happen when the promotion qualifies.",+ "title": "Add action"+ },+ "action_summary": {+ "variant_count": "{{count}} variants"+ },+ "action_types": {+ "create_adjustment": {+ "description": "Creates a promotion credit adjustment on the order",+ "name": "Create whole-order adjustment"},- "gift_card_section": {- "title": "Gift Card & Store Credit",- "gift_card_label": "Gift card",- "store_credit_label": "Store credit",- "none_applied": "None applied",- "applied_suffix": "applied",- "apply_balance": "Apply customer's available balance",- "requires_customer": "Requires a customer",- "apply_dialog_title": "Apply Gift Card",- "apply_dialog_description": "Enter a gift card code to apply to this order.",- "code_placeholder": "GIFT-XXXX-YYYY"+ "create_item_adjustments": {+ "description": "Creates a promotion credit adjustment on a line item",+ "name": "Create per-line-item adjustment"},- "address_edit": {- "shipping_title": "Edit Shipping Address",- "billing_title": "Edit Billing Address"+ "create_line_items": {+ "description": "Populates the cart with the specified quantity of variant",+ "name": "Create line items"},- "no_customer": "No customer information",- "section_customer_note": "Special Instructions",- "section_internal_note": "Internal Note",- "completed_prefix": "Completed",- "add_line_item": {- "title": "Add Line Item"+ "free_shipping": {+ "description": "Makes all shipments for the order free",+ "name": "Free shipping"+ }+ },+ "actions_card": {+ "add_action": "Add action",+ "description": "What happens when the promotion qualifies.",+ "empty": "No actions yet. A promotion without actions doesn't do anything when applied."+ },+ "basics_card": {+ "title": "Basics"+ },+ "code": {+ "automatic": "Automatic",+ "multi": "multi"+ },+ "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.",+ "export_csv": "Export CSV",+ "states": {+ "partially_used": "Partially used",+ "used": "Used"},- "no_line_items": "No line items"- }- },- "products": {- "save_label": "Save product",- "delete_label": "Delete product",- "delete_confirm": "Are you sure you want to delete this product?",- "category_search_placeholder": "Search categories…",- "no_categories_found": "No categories found",- "media": {- "delete_confirm": "Delete this media? This cannot be undone.",- "drop_hint": "Drag & drop media here, or click to browse",- "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.",- "upload_failed": "Failed to upload {{name}}: {{message}}",- "upload_status_failed": "Failed"+ "title": "Coupon codes",+ "unused": "Unused",+ "used": "Used"+ },+ "delete_confirm": {+ "default_name": "This promotion",+ "message": "{{name}} will be removed permanently. Promotions referenced by completed orders cannot be deleted.",+ "title": "Delete promotion?"+ },+ "errors": {+ "failed_to_add_action": "Failed to add action",+ "failed_to_add_rule": "Failed to add rule",+ "failed_to_remove_action": "Failed to remove action",+ "failed_to_remove_rule": "Failed to remove rule",+ "failed_to_update_action": "Failed to update action",+ "failed_to_update_rule": "Failed to update rule"+ },+ "generate_code": {+ "title": "Generate a random code"+ },+ "kinds": {+ "automatic": "Automatic (no code)",+ "coupon_code": "Coupon code"+ },+ "match_policies": {+ "all": "All rules must match",+ "all_hint": "All rules must match.",+ "any": "Any rule may match",+ "any_hint": "Any rule may match."+ },+ "messages": {+ "action_added": "Action added",+ "action_removed": "Action removed",+ "action_updated": "Action updated",+ "rule_added": "Rule added",+ "rule_removed": "Rule removed",+ "rule_updated": "Rule updated"+ },+ "remove_action_confirm": {+ "message": "Removed when you save the promotion.",+ "title": "Remove action?"+ },+ "remove_rule_confirm": {+ "message": "Removed when you save the promotion.",+ "title": "Remove rule?"+ },+ "rule_edit": {+ "description": "Tune the rule's parameters.",+ "no_options": "This rule has no configurable options — its presence alone applies the constraint."},- "seo": {- "slug_placeholder": "product-url-handle",- "meta_title_placeholder": "SEO title",- "meta_description_placeholder": "SEO description"+ "rule_picker": {+ "description": "Pick a rule type to configure.",+ "title": "Add rule"},- "tax_category_placeholder": "Select tax category",- "transfers": {- "new_cta": "New transfer",- "create_description": "Move stock between locations, or receive new stock from an external vendor.",- "external_label": "External (vendor receive)",- "destination_placeholder": "Select destination location",- "different_locations_error": "Source and destination must differ.",- "reference_label": "Reference",- "reference_placeholder": "PO number, vendor invoice, …",- "search_items_placeholder": "Search by name or SKU (3+ chars)…",- "items_table": {- "variant": "Variant",- "sku": "SKU",- "qty": "Qty"+ "rule_summary": {+ "category_count": "{{count}} categories",+ "customer_count": "{{count}} customers",+ "product_count": "{{count}} products"+ },+ "rule_types": {+ "category": {+ "description": "Order includes products in specified categories",+ "name": "Categories"},- "delete_confirm": {- "title": "Delete this transfer?",- "message": "Stock movements created by this transfer will be reversed."+ "country": {+ "description": "Limit to orders with shipping address in a specific country",+ "name": "Country"},- "review_description": "Review the transfer before creating. Items can't be changed afterwards.",- "details_card": "Details",- "fields": {- "type": "Type",- "internal": "Internal",- "external_receive": "External receive",- "reference": "Reference",- "created": "Created",- "immutable_note": "Stock transfers are immutable once created."- }- },- "options": {- "kinds": {- "dropdown": "Dropdown",- "color_swatch": "Color swatch",- "buttons": "Buttons"+ "currency": {+ "description": "Limit to orders in a specific currency",+ "name": "Currency"},- "add_cta": "Add option type",- "create_label": "Create option type",- "create_description": "Define an option that variants can use (e.g. size, color).",- "edit_description": "Edit the option type and its values.",- "delete_confirm": {- "title": "Delete option type?",- "message": "This will also delete all of its values. Variants using these values will lose them."+ "customer": {+ "description": "Available only to the specified customers",+ "name": "Customers"},- "values_help": "Drag values to reorder. The first value is the default for new variants.",- "count_one": "{{count}} value",- "count_other": "{{count}} values",- "value_name_placeholder": "e.g. small",- "value_label_placeholder": "e.g. Small",- "image_upload_failed": "Failed to upload image"- },- "variants": {- "title": "Variants",- "default_variant": "Default variant",- "variant_label": "Variant",- "add_option": "Add option",- "create_option_type": "Create new option type",- "create_option_type_title": "New option type",- "create_value": "New value",- "create_value_title": "New option value",- "option_type_label": "Option type",- "option_type_placeholder": "Pick an option type",- "edit_variant": "Edit variant — {{name}}",- "edit_row_aria": "Edit {{name}}",- "remove_row_aria": "Remove {{name}}",- "orphan_warning_one": "{{count}} existing variant no longer matches the selected options and will be removed on save:",- "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",- "sheet": {- "identity": "Identity",- "availability": "Availability",- "tax_category_placeholder": "Inherit from product"+ "customer_group": {+ "description": "Available only to customers in specified customer group(s)",+ "name": "Customer Group(s)"},- "errors": {- "failed_to_create_value": "Failed to create value",- "failed_to_create_option_type": "Failed to create option type"+ "customer_logged_in": {+ "description": "Available only to logged in customers",+ "name": "Only logged in customers"+ },+ "first_order": {+ "description": "Must be the customer's first order",+ "name": "First order"+ },+ "item_total": {+ "description": "Order total meets these criteria",+ "name": "Item total"+ },+ "one_use_per_user": {+ "description": "Only One Use Per User",+ "name": "One Use Per User"+ },+ "option_value": {+ "description": "Order includes products with matching option value(s)",+ "name": "Option Value(s)"+ },+ "product": {+ "description": "Order includes specified product(s)",+ "name": "Product(s)"}},- "inventory": {- "columns": {- "location": "Location",- "on_hand": "On hand",- "backorder": "Backorder"+ "rule_types_all_used": "Every available rule type is already on this promotion.",+ "rule_types_empty": "No rule types registered.",+ "rules": {+ "category": {+ "empty": "No categories match",+ "label": "Categories",+ "match_policy": {+ "all": {+ "description": "Order must contain a product in every category.",+ "label": "All of these categories"+ },+ "any": {+ "description": "Order must contain a product in at least one.",+ "label": "Any of these categories"+ }+ },+ "search_placeholder": "Search categories…"},- "on_hand_aria": "On hand at {{location}}",- "backorder_aria": "Allow backorder at {{location}}",- "empty_no_locations": "Add a stock location in Settings to start tracking inventory.",- "empty_no_variants": "Stock levels are managed per stock location. Add a variant to start tracking inventory.",- "unknown_location": "Unknown location"- },- "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"+ "channel": {+ "label": "Channels"},- "errors": {- "failed_to_activate": "Failed to activate price list",- "failed_to_deactivate": "Failed to deactivate price list"+ "country": {+ "empty": "No countries match",+ "label": "Countries",+ "search_placeholder": "Search countries…"},- "validation": {- "ends_after_starts": "Must be after start date."+ "customer": {+ "empty": "No customers match",+ "label": "Customers",+ "search_placeholder": "Search customers by name or email…"+ },+ "customer_group": {+ "empty": "No customer groups match",+ "label": "Customer groups",+ "search_placeholder": "Search customer groups…"+ },+ "market": {+ "label": "Markets"+ },+ "product": {+ "empty": "No products match",+ "label": "Products",+ "match_policy": {+ "all": {+ "description": "Order must contain every product.",+ "label": "All of these products"+ },+ "any": {+ "description": "Order must contain at least one.",+ "label": "Any of these products"+ },+ "none": {+ "description": "Order must not contain any of them.",+ "label": "None of these products"+ }+ },+ "search_placeholder": "Search products by name…"}},- "variant_media_picker": {- "trigger": "Select from product gallery",- "title": "Select from product gallery",- "empty_no_media": "No product media yet — upload images on the product first.",- "empty_all_linked": "All product media is already linked to this variant.",- "add_count_one": "Add {{count}}",- "add_count_other": "Add {{count}}"- }- },- "payment_methods": {- "add_cta": "Add payment method",- "create_description": "Pick a provider and configure its credentials.",- "edit_description": "Update name, visibility, or status.",- "create_label": "Create payment method",- "provider_description": "Provider: {{provider}}",- "delete_confirm": {- "title": "Delete payment method?",- "message": "{{name}} will no longer be available at checkout."+ "rules_card": {+ "add_rule": "Add rule",+ "description": "Conditions that decide whether the promotion applies.",+ "empty": "No rules. Without rules, the promotion always qualifies (subject to schedule and usage limit).",+ "title": "Rules"},- "title": "Payment Methods",- "search_placeholder": "Search by name…",- "empty": "No payment methods configured",- "columns": {- "storefront": "Storefront"+ "schedule_card": {+ "title": "Schedule & limits"},- "storefront": {- "visible": "Visible",- "admin_only": "Admin only"+ "table": {+ "empty": "No promotions yet",+ "no_end": "No end",+ "search_placeholder": "Search by name…"},- "status": {- "disabled": "Disabled"+ "trigger_card": {+ "title": "Trigger"},- "messages": {- "created": "Payment method created",- "updated": "Payment method updated",- "deleted": "Payment method deleted"+ "trigger_summary": {+ "locked_help": "Trigger settings can't be changed after creation. Make a new promotion to change them.",+ "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:"+ },+ "validation": {+ "code_required": "Code is required (or click Generate)",+ "expiry_after_start": "Expiry must be after the start date",+ "number_of_codes_required": "Pick how many codes to generate",+ "prefix_required": "Prefix is required for multi-code batches"}},- "tax_categories": {- "add_cta": "Add tax category",- "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."+ "settings": {+ "webhooks": {+ "errors": {+ "redeliver_failed": "Failed to redeliver",+ "send_test_failed": "Failed to send test webhook"+ },+ "messages": {+ "removed": "Webhook endpoint removed",+ "updated": "Webhook endpoint updated"+ }+ }+ },+ "settings_nav": {+ "groups": {+ "audit": "Audit",+ "fulfillment": "Fulfillment",+ "payments": "Payments & taxes",+ "store": "Store",+ "team": "Team & access"},- "messages": {- "created": "Tax category created",- "updated": "Tax category updated",- "deleted": "Tax category deleted"+ "items": {+ "allowed_origins": "Allowed origins",+ "api_keys": "API keys",+ "channels": "Sales channels",+ "custom_field_definitions": "Custom fields",+ "delivery_methods": "Delivery methods",+ "delivery_zones": "Delivery zones",+ "emails": "Emails",+ "imports": "Imports",+ "markets": "Markets",+ "payment_methods": "Payment methods",+ "profile": "Profile",+ "staff": "Staff",+ "stock_locations": "Stock locations",+ "store": "Store",+ "tax_categories": "Tax categories",+ "webhooks": "Webhooks"}},- "custom_field_definitions": {- "add_cta": "Add custom field",- "create_label": "Create custom field",- "create_description": "Define a typed field your team can fill in on any matching record.",- "edit_description": "Update the label, key, or storefront visibility. The owner can't change once values exist.",- "table_title": "Custom field definitions",- "search_placeholder": "Search by label, namespace, or key…",- "empty": "No custom field definitions yet",- "storefront_visible": {- "visible": "Visible",- "admin_only": "Admin only"+ "staff": {+ "actions": {+ "copy_invitation_link": "Copy invitation link",+ "invitation_link_copied": "Invitation link copied"},- "delete_confirm": {- "title": "Delete custom field?",- "message": "{{label}} will be removed along with every value stored for it."+ "actions_aria": "Actions",+ "autocomplete": {+ "empty": "No staff match",+ "placeholder": "Search staff…"},- "messages": {- "created": "Custom field definition created",- "updated": "Custom field definition updated",- "deleted": "Custom field definition deleted"+ "confirm": {+ "remove_message": "{{name}} will lose access to this store.",+ "remove_title": "Remove from store?",+ "revoke_message": "{{email}} will no longer be able to accept this invitation.",+ "revoke_title": "Revoke invitation?"+ },+ "edit": {+ "roles_label": "Roles for this store"},+ "edit_description": "Update profile details and assigned roles for this staff member.","errors": {- "failed_to_create": "Failed to create custom field definition",- "failed_to_update": "Failed to update custom field definition",- "failed_to_delete": "Failed to delete custom field definition"- }- },- "allowed_origins": {- "add_cta": "Add allowed origin",- "create_label": "Add origin",- "create_description": "Browsers loaded from this origin can call the admin API. The CORS allowlist and admin cookie session both rely on this list — keep it tight.",- "edit_description": "Updating an origin immediately changes who can call the admin API from a browser.",- "table_title": "Allowed origins",- "search_placeholder": "Search by origin…",- "empty": "No allowed origins yet",- "validation": {- "bare_origin": "Must be a bare origin (e.g. https://shop.example.com) — no path, query, or fragment"+ "failed_to_remove": "Failed to remove staff",+ "failed_to_resend": "Failed to resend invitation",+ "failed_to_revoke": "Failed to revoke invitation"},- "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."+ "invite": {+ "email_placeholder": "[email protected]",+ "no_roles": "No roles available.",+ "roles_loading": "Loading roles…",+ "roles_placeholder": "Select a role"},- "messages": {- "added": "Allowed origin added",- "updated": "Allowed origin updated",- "removed": "Allowed origin removed"+ "validation": {+ "role_required": "Pick a role",+ "roles_required": "Pick at least one role"}},- "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"- },+ "stock_items": {"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_item_deleted": "Stock item deleted",+ "stock_updated": "Stock updated"}},"stock_locations": {"add_cta": "Add stock location",- "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",+ "badges": {+ "default": "Default",+ "enabled": "Enabled",+ "inactive": "Inactive"+ },"columns": {- "type": "Type",+ "default": "Default","location": "Location","pickup": "Pickup",- "default": "Default"+ "type": "Type"},- "badges": {- "enabled": "Enabled",- "inactive": "Inactive",- "default": "Default"+ "create_description": "Add a warehouse, store, or pickup point to fulfill orders from.",+ "create_label": "Create stock location",+ "delete_confirm": {+ "message": "{{name}} will be removed. Stock items at this location are not deleted.",+ "title": "Delete stock location?"},+ "edit_description": "Update name, address, pickup, or stock policies.",+ "empty": "No stock locations yet","kinds": {- "warehouse": "Warehouse",+ "fulfillment_center": "Fulfillment center","store": "Store",- "fulfillment_center": "Fulfillment center"+ "warehouse": "Warehouse"},"pickup_stock_policies": {- "local": "Only items at this location",- "any": "Allow transfers from other locations"- },- "delete_confirm": {- "title": "Delete stock location?",- "message": "{{name}} will be removed. Stock items at this location are not deleted."+ "any": "Allow transfers from other locations",+ "local": "Only items at this location"},+ "search_placeholder": "Search by name…","section_pickup": "Pickup","stock_items": {- "title": "Stock at this location",+ "empty": "No stock items at this location yet.",+ "empty_search": "No stock items match your search.","help": "Adjust on-hand and backorderable counts per variant.",+ "low_stock_marker": "low stock","search_placeholder": "Search SKU or product…","table": {- "variant": "Variant",+ "backorder": "Backorder","on_hand": "On hand",- "backorder": "Backorder"+ "variant": "Variant"},- "empty": "No stock items at this location yet.",- "empty_search": "No stock items match your search.",+ "title": "Stock at this location","unknown_product": "Unknown product","variant_count_one": "{{count}} variant",- "variant_count_other": "{{count}} variants",- "low_stock_marker": "low stock"+ "variant_count_other": "{{count}} variants"}},+ "stock_transfers": {+ "columns": {+ "direction": "Direction",+ "number": "Number",+ "reference": "Reference"+ },+ "direction": {+ "external_receive": "External receive",+ "internal": "Transfer between locations"+ },+ "errors": {+ "failed_to_delete": "Failed to delete stock transfer",+ "failed_to_record": "Failed to record stock transfer"+ },+ "messages": {+ "deleted": "Stock transfer deleted",+ "recorded": "Stock transfer recorded"+ },+ "table": {+ "empty": "No stock transfers yet",+ "search_placeholder": "Search by number or reference…"+ },+ "title": "Stock Transfers"+ },"store": {"load_failed_title": "Failed to load store settings","unit_systems": {- "metric": "Metric",- "imperial": "Imperial"+ "imperial": "Imperial",+ "metric": "Metric"},"weight_units": {- "kg": "Kilogram (kg)","g": "Gram (g)",+ "kg": "Kilogram (kg)","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",- "min_quantity": "Minimum quantity",- "max_quantity": "Maximum quantity"- },- "channels": {- "messages": {- "created": "Channel created",- "updated": "Channel updated",- "deleted": "Channel deleted"- }- },- "order_routing_rules": {- "messages": {- "created": "Routing rule added",- "deleted": "Routing rule removed"+ "tax_categories": {+ "add_cta": "Add tax category",+ "create_description": "Group products by tax treatment (standard, reduced, exempt, …).",+ "create_label": "Create tax category",+ "delete_confirm": {+ "message": "{{name}} will be removed. Products in this category fall back to the default.",+ "title": "Delete tax category?"},- "types": {- "preferred_location": {- "name": "Preferred location",- "description": "Fulfill from the location pinned on the order, when one is set"- },- "minimize_splits": {- "name": "Minimize splits",- "description": "Prefer the location that can fulfill the most items on its own, avoiding split shipments"- },- "default_location": {- "name": "Default location",- "description": "Prefer the stock location marked as default"- }- }- },- "customer_groups": {+ "edit_description": "Update the name, code, or default flag.",+ "empty": "No tax categories yet","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"+ "created": "Tax category created",+ "deleted": "Tax category deleted",+ "updated": "Tax category updated"},- "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"- }+ "search_placeholder": "Search by name…"},"translations": {- "title": "Translations",- "locale": "Locale",- "source": "Source",- "save": "Save translations",- "saved": "Translations saved",- "save_error": "Could not save translations",- "no_locales": "Add more locales to your store to translate this product.",- "manage": "Manage translations",- "field": "Field","coverage_summary": "{{translated}} of {{total}} locales translated","dirty_summary": "{{count}} unsaved change(s)","discard_confirm": {- "title": "Discard changes?",- "message": "You have {{count}} unsaved translation change(s). Discard them?"+ "message": "You have {{count}} unsaved translation change(s). Discard them?",+ "title": "Discard changes?"},+ "field": "Field",+ "load_error": "Could not load translations",+ "locale": "Locale",+ "manage": "Manage translations",+ "no_locales": "Add more locales to your store to translate this product.","original": "Original",- "load_error": "Could not load translations"- },- "categories": {- "title": "Categories",- "add_cta": "New category",- "empty": "No categories yet.",- "expand": "Expand",- "collapse": "Collapse",- "delete_confirm": "Delete the category \"{{name}}\" and all its subcategories?",- "columns": {- "name": "Name",- "products": "Products"- },- "fields": {- "parent": {- "label": "Parent category",- "placeholder": "Top level"- }- },- "messages": {- "created": "Category created",- "updated": "Category updated",- "deleted": "Category deleted",- "move_failed": "Could not move the category"- },- "seo": {- "title": "Search engine optimization",- "preview_slug_placeholder": "category-slug"- },- "products_count_one": "{{count}} product",- "products_count_other": "{{count}} products",- "search_placeholder": "Search categories…",- "no_results": "No categories match your search.",- "new_title": "New category",- "delete_label": "Delete category",- "images": {- "title": "Images",- "label": "Image",- "square_label": "Square image",- "help": "Used in category banners. Recommended 1920×1080.",- "square_help": "Used in compact navigation. Recommended 400×400."- },- "navigation": {- "title": "Navigation"- },- "products": {- "title": "Products",- "search_placeholder": "Search products…",- "empty": "No products in this category yet.",- "remove": "Remove from category",- "add_cta": "Add products",- "picker_title": "Add products to category",- "picker_description": "Search and select products to add to this category.",- "select_all": "Select all",- "select_row": "Select product",- "remove_selected": "Remove",- "selected_count_one": "{{count}} selected",- "selected_count_other": "{{count}} selected",- "column_product": "Product",- "filter_placeholder": "Filter products…",- "no_matches": "No products match your filter."- },- "load_failed": "Failed to load categories. Please try again."- },- "imports": {- "download_original": "Download original file",- "load_failed": "Could not load the import.",- "try_again": "Try again",- "wizard_title": "Import",- "steps": {- "map_fields": "Map fields",- "process_rows": "Process rows",- "complete": "Complete"- },- "status": {- "pending": "Pending",- "mapping": "Mapping",- "completed_mapping": "Queued",- "processing": "Processing",- "completed": "Completed",- "failed": "Failed"- },- "types": {- "products": "Products",- "customers": "Customers",- "product_translations": "Product translations"- },- "mapping": {- "title": "Map columns",- "description": "Match the columns from your file to {{type}} fields.",- "field": "Field",- "file_column": "File column",- "sample": "Example",- "not_mapped": "Not mapped",- "required": "Required",- "missing_required": "Map the required fields to continue: {{fields}}",- "start": "Start import",- "starting": "Starting…"- },- "processing": {- "title": "Processing rows",- "preparing": "Preparing rows…",- "progress": "{{processed}} of {{total}} rows processed",- "failed_count": "{{failed}} failed",- "retrying": "Retrying failed rows · {{remaining}} remaining",- "note": "You can leave this page — the import continues in the background."- },- "results": {- "completed_title": "Import completed",- "summary": "{{completed}} rows imported · {{failed}} failed",- "retry_failed": "Retry failed rows ({{failed}})",- "retrying": "Retrying…",- "view_records": "View {{type}}"- },- "failed": {- "title": "Import failed",- "description": "The file could not be processed."- },- "failed_rows": {- "next_page": "Next page",- "prev_page": "Previous page",- "title": "Failed rows",- "row_number": "Row",- "error": "Error",- "view_data": "View row data",- "hide_data": "Hide row data"- }+ "save": "Save translations",+ "save_error": "Could not save translations",+ "saved": "Translations saved",+ "source": "Source",+ "title": "Translations"}}}diff --git a/packages/dashboard/src/locales/fr.json b/packages/dashboard/src/locales/fr.jsonindex 8bcef75370..ae4eda899d 100644--- a/packages/dashboard/src/locales/fr.json+++ b/packages/dashboard/src/locales/fr.json@@ -1,631 +1,839 @@{"admin": {"a11y": {- "edit_media": "Modifier l'image",- "delete_image": "Supprimer l'image"+ "delete_image": "Supprimer l'image",+ "edit_media": "Modifier 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"+ "allowed_origins": {+ "add_cta": "Ajouter une origine autorisée",+ "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.",+ "create_label": "Ajouter une origine",+ "delete_confirm": {+ "message": "{{origin}} ne pourra plus appeler l'API admin depuis un navigateur. Les requêtes existantes de serveur à serveur ne sont pas affectées.",+ "title": "Supprimer l'origine autorisée ?"},+ "edit_description": "La mise à jour d'une origine modifie immédiatement qui peut appeler l'API admin depuis un navigateur.",+ "empty": "Aucune origine autorisée 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"- }- },- "errors": {- "not_found_title": "Page introuvable",- "not_found_description": "La page que vous recherchez n’existe pas.",- "forbidden_title": "Non autorisé",- "forbidden_description": "Vous n’avez pas la permission de voir cette page.",- "plugin_route_title": "Le rendu de cette page a échoué"- },- "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",- "getting_started": "Premiers pas"- },- "settings_nav": {- "groups": {- "store": "Boutique",- "payments": "Paiements et taxes",- "fulfillment": "Traitement des commandes",- "team": "Équipe et accès",- "audit": "Audit"+ "added": "Origine autorisée ajoutée",+ "removed": "Origine autorisée supprimée",+ "updated": "Origine autorisée mise à jour"},- "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",- "imports": "Imports"+ "search_placeholder": "Rechercher par origine…",+ "table_title": "Origines autorisées",+ "validation": {+ "bare_origin": "Doit être une origine simple (par ex. https://shop.example.com) — sans chemin, requête ni fragment"}},- "fields": {- "products_count": {- "label": "Produits"+ "api_keys": {+ "badge": {+ "never_used": "Jamais",+ "revoked": "Révoquée"},- "prices_count": {- "label": "Prix"+ "by_email": "par {{email}}",+ "create_key_cta": "Créer la clé",+ "create_sheet_description": "Choisissez un type de clé, puis sélectionnez les portées qu'elle peut utiliser.",+ "create_sheet_title": "Créer une clé API",+ "delete_confirm": {+ "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.",+ "title": "Supprimer la clé ?"},- "customer_id": {- "label": "Client"+ "dropdown": {+ "copy_token_aria": "Copier le jeton",+ "revoke": "Révoquer la clé"},- "role_id": {- "label": "Rôle"+ "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.",+ "edit_sheet_title": "Modifier la clé API",+ "empty_description": "Créez-en une pour commencer.",+ "errors": {+ "failed_to_create": "Échec de la création de la clé",+ "failed_to_delete": "Échec de la suppression de la clé",+ "failed_to_update": "Échec de la mise à jour de la clé"},- "role_ids": {- "label": "Rôles"+ "key_type": {+ "publishable_description": "Peut être exposée sans risque dans le code côté client. Accorde un accès public/invité.",+ "publishable_title": "Clé publiable",+ "secret_description": "Serveur à serveur. Chaque clé porte une liste explicite de portées.",+ "secret_title": "Clé secrète"},- "tax_category_id": {- "label": "Catégorie de taxe"+ "revoke_confirm": {+ "message": "Toute intégration utilisant cette clé cessera immédiatement de fonctionner.",+ "title": "Révoquer la clé ?"},- "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é"+ "scope_picker": {+ "full_access_hint": "– lecture + écriture sur chaque ressource",+ "full_access_label": "Accès complet (write_all)",+ "read_all_hint": "– lecture sur chaque ressource",+ "read_all_label": "Tout lire (read_all)",+ "read_aria": "Lire {{resource}}",+ "read_header": "Lecture",+ "resource_header": "Ressource",+ "resources": {+ "api_keys": "Clés API",+ "categories": "Catégories",+ "customers": "Clients",+ "dashboard": "Tableau de bord",+ "fulfillments": "Exécutions des commandes",+ "gift_cards": "Cartes cadeaux",+ "orders": "Commandes",+ "payments": "Paiements",+ "products": "Produits",+ "promotions": "Promotions",+ "refunds": "Remboursements",+ "settings": "Paramètres",+ "stock": "Stock",+ "store_credits": "Avoirs en boutique",+ "webhooks": "Webhooks"},- "match_policy": {- "label": "Règle de correspondance"- }+ "show_more_aria_one": "Afficher {{count}} portée supplémentaire",+ "show_more_aria_other": "Afficher {{count}} portées supplémentaires",+ "write_aria": "Écrire {{resource}}",+ "write_header": "Écriture"},- "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::Taxon": "Catégories",- "Spree::OptionType": "Types d'options"- }- },- "storefront_visible": {- "label": "Visible sur la boutique",- "column_label": "Boutique"- },- "searchable": {- "label": "Recherchable",- "help": "Inclure les valeurs dans la recherche de produits de la boutique (texte court, texte long et nombre uniquement). Après activation avec Meilisearch, exécutez rake spree:search:reindex pour mettre à jour les produits existants."- },- "sortable": {- "label": "Triable",- "help": "Autoriser le tri des listes de produits de la boutique par ce champ (texte court et nombre uniquement). Après activation avec Meilisearch, exécutez rake spree:search:reindex pour mettre à jour les produits existants."- }+ "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.",+ "validation": {+ "scope_required": "Sélectionnez au moins une portée"},- "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."- }+ "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."+ },+ "calculators": {+ "default_refund_amount": "Montant de remboursement par défaut",+ "default_tax": "Taxe par défaut",+ "digital_delivery": "Livraison numérique",+ "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"+ },+ "categories": {+ "add_cta": "Nouvelle catégorie",+ "collapse": "Réduire",+ "columns": {+ "name": "Nom",+ "products": "Produits"},- "allowed_origin": {- "origin": {- "label": "Origine",- "placeholder": "https://admin.example.com",- "help": "Schéma + hôte simples (+ port facultatif). Aucun chemin, requête ou fragment."+ "delete_confirm": "Supprimer la catégorie « {{name}} » et toutes ses sous-catégories ?",+ "delete_label": "Supprimer la catégorie",+ "empty": "Aucune catégorie pour le moment.",+ "expand": "Développer",+ "fields": {+ "parent": {+ "label": "Catégorie parente",+ "placeholder": "Niveau supérieur"}},- "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"- }- },- "storefront_access": {- "label": "Accès à la vitrine",- "help": "Contrôle ce que les visiteurs anonymes peuvent voir sur ce canal. Laisser vide pour hériter du paramètre de la boutique. Lorsque les prix sont masqués, les invités doivent se connecter pour passer à la caisse.",- "inherit": "Hériter de la boutique",- "options": {- "public": "Public — tout le monde peut parcourir et voir les prix",- "prices_hidden": "Prix masqués — les visiteurs doivent se connecter pour voir les prix",- "login_required": "Connexion requise — les visiteurs doivent se connecter pour parcourir"- }- },- "guest_checkout": {- "label": "Commande invité",- "help": "Indique si les clients peuvent commander sans compte sur ce canal. Laisser vide pour hériter du paramètre de la boutique.",- "inherit": "Hériter de la boutique",- "options": {- "true": "Autorisé",- "false": "Non autorisé"- }- }+ "images": {+ "help": "Utilisée dans les bannières de catégorie. Recommandé 1920×1080.",+ "label": "Image",+ "square_help": "Utilisée dans la navigation compacte. Recommandé 400×400.",+ "square_label": "Image carrée",+ "title": "Images"},- "invitation_acceptance": {- "password": {- "label": "Mot de passe"- },- "password_confirmation": {- "label": "Confirmer le mot de passe"- }+ "load_failed": "Échec du chargement des catégories. Veuillez réessayer.",+ "messages": {+ "created": "Catégorie créée",+ "deleted": "Catégorie supprimée",+ "move_failed": "Impossible de déplacer la catégorie",+ "updated": "Catégorie mise à jour"},- "customer_group": {- "name": {- "placeholder": "ex. Clients VIP"- },- "description": {- "placeholder": "Description interne facultative"- }+ "navigation": {+ "title": "Navigation"},- "price_list": {- "name": {- "label": "Nom",- "placeholder": "ex. Vente en gros UE",- "help": "Libellé interne — jamais affiché aux clients."+ "new_title": "Nouvelle catégorie",+ "no_results": "Aucune catégorie ne correspond.",+ "products": {+ "add_cta": "Ajouter des produits",+ "column_product": "Produit",+ "empty": "Aucun produit dans cette catégorie pour le moment.",+ "filter_placeholder": "Filtrer les produits…",+ "no_matches": "Aucun produit ne correspond au filtre.",+ "picker_description": "Recherchez et sélectionnez des produits à ajouter à cette catégorie.",+ "picker_title": "Ajouter des produits à la catégorie",+ "remove": "Retirer de la catégorie",+ "remove_selected": "Retirer",+ "search_placeholder": "Rechercher des produits…",+ "select_all": "Tout sélectionner",+ "select_row": "Sélectionner le produit",+ "selected_count_one": "{{count}} sélectionné",+ "selected_count_other": "{{count}} sélectionnés",+ "title": "Produits"+ },+ "products_count_one": "{{count}} produit",+ "products_count_other": "{{count}} produits",+ "search_placeholder": "Rechercher des catégories…",+ "seo": {+ "preview_slug_placeholder": "slug-categorie",+ "title": "Optimisation pour les moteurs de recherche"+ },+ "title": "Catégories"+ },+ "channels": {+ "messages": {+ "created": "Canal créé",+ "deleted": "Canal supprimé",+ "updated": "Canal mis à jour"+ }+ },+ "components": {+ "adjustment_action_editor": {+ "calculator_label": "Calculateur",+ "loading_calculators": "Chargement des calculateurs…",+ "no_extra_settings": "Ce calculateur n'a aucun paramètre supplémentaire.",+ "select_calculator": "Sélectionner un calculateur",+ "settings_label": "Paramètres du calculateur"+ },+ "custom_fields": {+ "default_resource": "enregistrements",+ "empty_description": "Suivez des détails structurés comme la matière, la coupe ou les instructions d’entretien.",+ "empty_title": "Aucun champ personnalisé pour le moment",+ "errors": {+ "failed_to_save": "Impossible d’enregistrer le champ personnalisé"},- "description": {- "label": "Description",- "placeholder": "Description interne facultative"+ "manage_in_settings": "Gérer dans les paramètres",+ "new_definition_description": "Définissez un champ personnalisé pour stocker des informations typées et structurées sur vos {{resource}}.",+ "new_definition_title": "Nouveau champ personnalisé",+ "section_title": "Champs personnalisés",+ "set_up": "Configurer les champs personnalisés",+ "values_save_partial_failed": "Certains champs personnalisés n’ont pas pu être enregistrés : {{fields}}",+ "values_saved": "Champs personnalisés enregistrés"+ },+ "market_combobox": {+ "empty": "Aucun marché ne correspond",+ "search_placeholder": "Rechercher des marchés…"+ }+ },+ "custom_field_definitions": {+ "add_cta": "Ajouter un champ personnalisé",+ "create_description": "Définissez un champ typé que votre équipe peut renseigner sur tout enregistrement correspondant.",+ "create_label": "Créer un champ personnalisé",+ "delete_confirm": {+ "message": "{{label}} sera supprimé, ainsi que toutes les valeurs qui y sont enregistrées.",+ "title": "Supprimer le champ personnalisé ?"+ },+ "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.",+ "empty": "Aucune définition de champ personnalisé pour le moment",+ "errors": {+ "failed_to_create": "Impossible de créer le champ personnalisé",+ "failed_to_delete": "Impossible de supprimer le champ personnalisé",+ "failed_to_update": "Impossible de mettre à jour le champ personnalisé"+ },+ "messages": {+ "created": "Champ personnalisé créé",+ "deleted": "Champ personnalisé supprimé",+ "updated": "Champ personnalisé mis à jour"+ },+ "search_placeholder": "Rechercher par libellé, espace de noms ou clé…",+ "storefront_visible": {+ "admin_only": "Admin uniquement",+ "visible": "Visible"+ },+ "table_title": "Définitions de champs personnalisés"+ },+ "customer_groups": {+ "autocomplete": {+ "empty": "Aucun groupe de clients correspondant",+ "placeholder": "Rechercher des groupes de clients…"+ },+ "messages": {+ "create_failed": "Échec de la création du groupe de clients",+ "created": "Groupe de clients créé",+ "delete_failed": "Échec de la suppression du groupe de clients",+ "deleted": "Groupe de clients supprimé",+ "update_failed": "Échec de la mise à jour du groupe de clients",+ "updated": "Groupe de clients mis à jour"+ }+ },+ "customers": {+ "autocomplete": {+ "empty": "Aucun client correspondant",+ "placeholder": "Rechercher des clients…"+ },+ "columns": {+ "groups": "Groupes",+ "last_order": "Dernière commande",+ "newsletter": "Newsletter",+ "orders": "Commandes",+ "total_spent": "Total dépensé"+ },+ "detail": {+ "address": {+ "default_billing": "Facturation par défaut",+ "default_shipping": "Livraison par défaut",+ "delete_confirm_message": "Supprimer cette adresse ?",+ "set_default_billing": "Définir comme facturation par défaut",+ "set_default_shipping": "Définir comme livraison par défaut"},- "starts_at": {- "label": "Début",- "placeholder": "Immédiatement",- "help": "Moment où cette liste devient active. Laissez vide pour démarrer immédiatement à l'activation."+ "customer_since": "Client depuis",+ "delete_label": "Supprimer le client",+ "edit_profile_description": "Mettez à jour les informations du profil du client.",+ "groups": {+ "edit_description": "Ajoutez ou retirez les groupes auxquels ce client appartient.",+ "edit_title": "Modifier les groupes de clients",+ "empty": "Dans aucun groupe",+ "save_failed": "Échec de la mise à jour des groupes de clients",+ "title": "Groupes de clients"},- "ends_at": {- "label": "Fin",- "placeholder": "Jamais",- "help": "Laissez vide pour aucune date de fin."+ "last_order_placed": "Dernière commande passée",+ "no_internal_notes": "Aucune note interne",+ "not_subscribed_to_marketing": "Non abonné au marketing",+ "orders_table": {+ "date": "Date",+ "order": "Commande"},- "match_policy": {- "label": "Règle de correspondance",- "all": "Toutes les règles doivent correspondre",- "any": "N'importe quelle règle peut correspondre"+ "store_credit": {+ "add_description": "Émettez un avoir en boutique sur le compte de ce client.",+ "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é.",+ "empty": "Aucun avoir en boutique émis",+ "table": {+ "category": "Catégorie",+ "memo": "Note",+ "remaining": "Restant",+ "used": "Utilisé"+ },+ "title": "Avoir en boutique"},- "status": {- "active": "Active",- "scheduled": "Programmée",- "inactive": "Inactive",- "draft": "Brouillon"- }+ "subscribed_to_marketing": "Abonné au marketing"},- "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."+ "groups": {+ "bulk_add_action": "Ajouter au groupe…",+ "bulk_add_failed": "Échec de l'ajout des clients aux groupes",+ "bulk_added": "{{count}} clients ajoutés aux groupes",+ "bulk_remove_action": "Retirer du groupe…",+ "bulk_remove_failed": "Échec du retrait des clients des groupes",+ "bulk_removed": "{{count}} clients retirés des groupes",+ "columns": {+ "customers": "Clients"},- "markets": {- "label": "Marchés",- "help": "Laissez vide pour appliquer cette règle sur tous les marchés."+ "count_one": "{{count}} client",+ "count_other": "{{count}} clients",+ "create_description": "Créez un groupe de clients pour segmenter vos clients à des fins de promotions, d'analyses ou de marketing.",+ "create_label": "Créer un groupe de clients",+ "default_name": "Ce groupe",+ "delete_confirm": {+ "message": "{{name}} sera supprimé. Les clients de ce groupe ne sont pas supprimés.",+ "title": "Supprimer le groupe de clients ?"},- "channels": {- "label": "Canaux de vente",- "help": "Laissez vide pour appliquer cette règle à tous les canaux de vente."+ "edit_description": "Modifiez le nom ou la description.",+ "picker": {+ "add_description": "Choisissez les groupes auxquels ajouter ces clients.",+ "add_title": "Ajouter aux groupes",+ "remove_description": "Choisissez les groupes desquels retirer ces clients.",+ "remove_title": "Retirer des groupes"},- "min_quantity": {- "help": "Ce prix s’applique uniquement lorsqu’un client commande au moins cette quantité d’un même article."+ "table": {+ "empty": "Aucun groupe de clients pour le moment",+ "search_placeholder": "Rechercher par nom…",+ "title": "Groupes de clients"},- "max_quantity": {- "help": "Laissez vide pour ne pas fixer de limite supérieure."+ "view_members": "Voir les membres"+ },+ "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.",+ "row_actions": {+ "delete_confirm": "Supprimer {{email}} ? Les clients ayant des commandes finalisées ne peuvent pas être supprimés."+ },+ "table": {+ "empty": "Aucun client pour le moment",+ "search_placeholder": "Rechercher par e-mail ou nom…"+ },+ "tags": {+ "bulk_add_action": "Ajouter des étiquettes…",+ "bulk_add_failed": "Échec de l'ajout des étiquettes",+ "bulk_added": "Étiquettes ajoutées à {n} clients",+ "bulk_remove_action": "Retirer des étiquettes…",+ "bulk_remove_failed": "Échec du retrait des étiquettes",+ "bulk_removed": "Étiquettes retirées de {n} clients",+ "picker": {+ "add_description": "Choisissez ou créez des étiquettes à ajouter à ces clients.",+ "add_title": "Ajouter des étiquettes",+ "remove_description": "Choisissez les étiquettes à retirer de ces clients.",+ "remove_title": "Retirer des étiquettes"+ }+ }+ },+ "delivery_methods": {+ "add_cta": "Ajouter une méthode",+ "add_sheet_title": "Nouvelle méthode de livraison",+ "create_description": "Configurez comment les commandes parviennent aux clients : expédition, numérique ou retrait.",+ "create_label": "Créer la méthode",+ "delete_confirm": {+ "message": "Supprimer « {{name}} » ? Les boutiques cesseront de la proposer immédiatement.",+ "title": "Supprimer la méthode"+ },+ "edit_description": "Mettre à jour la configuration de cette méthode de livraison.",+ "edit_sheet_title": "Modifier la méthode",+ "empty": "Aucune méthode de livraison.",+ "fulfillment_types": {+ "digital": "Numérique",+ "pickup": "Retrait",+ "pickup_point": "Point relais",+ "shipping": "Expédition"+ },+ "messages": {+ "created": "Méthode de livraison créée",+ "deleted": "Méthode de livraison supprimée",+ "updated": "Méthode de livraison mise à jour"+ },+ "no_zones_hint": "Aucune zone définie — la méthode s’applique partout.",+ "search_placeholder": "Rechercher des méthodes…"+ },+ "delivery_zones": {+ "add_cta": "Ajouter une zone",+ "add_member": "Ajouter un membre",+ "add_sheet_title": "Nouvelle zone de livraison",+ "create_description": "Regroupez pays, états ou codes postaux en une zone desservie.",+ "create_label": "Créer la zone",+ "delete_confirm": {+ "message": "Supprimer « {{name}} » ? Les méthodes utilisant cette zone ne correspondront plus à ces régions.",+ "title": "Supprimer la zone"+ },+ "edit_description": "Les membres ci-dessous remplacent la liste complète à l’enregistrement.",+ "edit_sheet_title": "Modifier la zone",+ "empty": "Aucune zone de livraison.",+ "from_placeholder": "De",+ "member_types": {+ "country": "Pays",+ "postal_code": "Code postal",+ "state": "État"+ },+ "members_column": "Membres",+ "members_count": "{{count}} membres",+ "messages": {+ "created": "Zone de livraison créée",+ "deleted": "Zone de livraison supprimée",+ "updated": "Zone de livraison mise à jour"+ },+ "no_members_hint": "Aucun membre — ajoutez des pays, états ou règles de code postal.",+ "prefix_placeholder": "Préfixe",+ "search_placeholder": "Rechercher des zones…",+ "select_country": "Choisir un pays",+ "state_placeholder": "Code ou nom de l’état",+ "to_placeholder": "À"+ },+ "errors": {+ "forbidden_description": "Vous n’avez pas la permission de voir cette page.",+ "forbidden_title": "Non autorisé",+ "not_found_description": "La page que vous recherchez n’existe pas.",+ "not_found_title": "Page introuvable",+ "plugin_route_title": "Le rendu de cette page a échoué"+ },+ "fields": {+ "allowed_origin": {+ "origin": {+ "help": "Schéma + hôte simples (+ port facultatif). Aucun chemin, requête ou fragment.",+ "label": "Origine",+ "placeholder": "https://admin.example.com"}},- "stock_location": {- "name": {- "placeholder": "Entrepôt de Brooklyn"+ "api_key": {+ "channel": {+ "all_channels": "All channels",+ "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",+ "label": "Channel"},- "admin_name": {- "label": "Nom interne",- "placeholder": "Facultatif — affiché uniquement dans l'administration"+ "key_type": {+ "label": "Type"},- "kind": {- "label": "Type"+ "name": {+ "label": "Nom",+ "placeholder": "Intégration backend, Boutique prod, …",+ "required": "Le nom est requis"},+ "scopes": {+ "label": "Portées"+ }+ },+ "channel": {"active": {- "label": "Actif",- "help": "Les emplacements inactifs n'apparaissent pas dans la sélection d'expédition."+ "help": "Les canaux de vente inactifs cessent d'accepter les commandes et ne correspondent pas à l'en-tête X-Spree-Channel.",+ "label": "Actif"+ },+ "code": {+ "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.",+ "label": "Code",+ "placeholder": "Dérivé automatiquement du nom"},"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."+ "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.",+ "label": "Canal 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."+ "guest_checkout": {+ "help": "Indique si les clients peuvent commander sans compte sur ce canal. Laisser vide pour hériter du paramètre de la boutique.",+ "inherit": "Hériter de la boutique",+ "label": "Commande invité",+ "options": {+ "false": "Non autorisé",+ "true": "Autorisé"+ }},- "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."+ "name": {+ "placeholder": "ex. POS, Vente en gros, Meta Shop"},- "pickup_enabled": {- "label": "Autoriser le retrait par le client",- "help": "Les clients peuvent retirer leurs commandes à cet emplacement lors du paiement."+ "order_routing_strategy": {+ "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",+ "label": "Stratégie d'acheminement des commandes",+ "options": {+ "Spree::OrderRouting::Strategy::Legacy": "Héritée",+ "Spree::OrderRouting::Strategy::Rules": "Règles (ordonnées)"+ }},- "pickup_stock_policy": {- "label": "Règle de stock"+ "storefront_access": {+ "help": "Contrôle ce que les visiteurs anonymes peuvent voir sur ce canal. Laisser vide pour hériter du paramètre de la boutique. Lorsque les prix sont masqués, les invités doivent se connecter pour passer à la caisse.",+ "inherit": "Hériter de la boutique",+ "label": "Accès à la vitrine",+ "options": {+ "login_required": "Connexion requise — les visiteurs doivent se connecter pour parcourir",+ "prices_hidden": "Prix masqués — les visiteurs doivent se connecter pour voir les prix",+ "public": "Public — tout le monde peut parcourir et voir les prix"+ }+ }+ },+ "custom_field_definition": {+ "field_type": {+ "label": "Type",+ "options": {+ "boolean": "Booléen",+ "json": "JSON",+ "long_text": "Texte long",+ "number": "Nombre",+ "rich_text": "Texte enrichi",+ "short_text": "Texte court"+ },+ "read_only_help": "Le type ne peut pas être modifié une fois que des valeurs existent — le changer rendrait les valeurs enregistrées inexploitables."},- "pickup_ready_in_minutes": {- "label": "Prêt dans (minutes)",- "placeholder": "60"+ "key": {+ "invalid_format": "Lettres, chiffres et tirets bas uniquement",+ "label": "Clé",+ "placeholder": "ex. matiere"},- "pickup_instructions": {- "label": "Instructions de retrait",- "placeholder": "Où le client doit se rendre pour récupérer sa commande."+ "label": {+ "label": "Libellé",+ "placeholder": "ex. Matière"+ },+ "namespace": {+ "label": "Espace de noms",+ "placeholder": "custom"+ },+ "resource_type": {+ "label": "S'applique à",+ "options": {+ "Spree::OptionType": "Types d'options",+ "Spree::Order": "Commandes",+ "Spree::Product": "Produits",+ "Spree::Taxon": "Catégories",+ "Spree::User": "Clients",+ "Spree::Variant": "Variantes"+ },+ "read_only_help": "Le propriétaire ne peut pas être modifié une fois que des valeurs existent pour ce champ."+ },+ "searchable": {+ "help": "Inclure les valeurs dans la recherche de produits de la boutique (texte court, texte long et nombre uniquement). Après activation avec Meilisearch, exécutez rake spree:search:reindex pour mettre à jour les produits existants.",+ "label": "Recherchable"+ },+ "sortable": {+ "help": "Autoriser le tri des listes de produits de la boutique par ce champ (texte court et nombre uniquement). Après activation avec Meilisearch, exécutez rake spree:search:reindex pour mettre à jour les produits existants.",+ "label": "Triable"+ },+ "storefront_visible": {+ "column_label": "Boutique",+ "label": "Visible sur la boutique"}},- "payment_method": {- "type": {- "label": "Fournisseur",- "placeholder": "Sélectionner un fournisseur"+ "customer": {+ "accepts_email_marketing": {+ "label": "Abonné au marketing"},- "name": {- "placeholder": "ex. Carte de crédit (Stripe)"+ "customer_groups": {+ "label": "Groupes de clients"+ },+ "internal_note": {+ "label": "Note interne",+ "placeholder": "Contexte réservé au personnel à propos de ce client…"},+ "tags": {+ "label": "Étiquettes"+ }+ },+ "customer_group": {"description": {- "placeholder": "Description visible par le client affichée lors du paiement"+ "placeholder": "Description interne facultative"+ },+ "name": {+ "placeholder": "ex. Clients VIP"+ }+ },+ "customer_id": {+ "label": "Client"+ },+ "delivery_method": {+ "admin_name": {+ "label": "Nom interne"+ },+ "calculator": {+ "label": "Calculateur de tarif"+ },+ "code": {+ "label": "Code"+ },+ "delivery_zones": {+ "label": "Zones de livraison"+ },+ "fulfillment_type": {+ "label": "Type de traitement"},"storefront_visible": {- "label": "Visible sur la boutique"+ "help": "Les clients peuvent choisir cette méthode au paiement."},- "active": {- "label": "Active",- "help": "Les méthodes inactives sont masquées lors du paiement."+ "tax_category": {+ "label": "Catégorie de taxe"},- "auto_capture": {- "label": "Capture automatique",- "help": "Capturer les fonds automatiquement à l'autorisation. Si désactivé, vous devez capturer manuellement."+ "tracking_url": {+ "label": "Modèle d’URL de suivi"+ },+ "transit_days_max": {+ "label": "Délai (jours max)"},- "provider_configuration": "Configuration du fournisseur"+ "transit_days_min": {+ "label": "Délai (jours min)"+ }},- "market": {- "name": {- "placeholder": "ex. Europe"+ "gift_card": {+ "amount": {+ "label": "Montant"+ },+ "code": {+ "help": "Laissez vide pour générer automatiquement. Pour les lots, ceci devient le préfixe.",+ "label": "Code"},"currency": {- "label": "Devise",- "help": "Devise ISO 4217 utilisée pour tous les prix de ce marché."+ "label": "Devise"},- "default_locale": {- "label": "Langue par défaut",- "help": "Langue de la boutique pour les acheteurs de ce marché."+ "customer_id": {+ "label": "Client"},- "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."+ "expires_at": {+ "label": "Expire",+ "placeholder": "Aucune expiration"+ },+ "quantity": {+ "help": "1 émet une seule carte. Plus de 1 émet un lot avec des codes générés automatiquement.",+ "label": "Quantité"+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "Mot de passe"},+ "password_confirmation": {+ "label": "Confirmer le mot de passe"+ }+ },+ "market": {"country_isos": {- "label": "Pays",- "help": "Choisissez les pays couverts par ce marché. Chaque pays ne peut appartenir qu'à un seul marché par boutique."+ "help": "Choisissez les pays couverts par ce marché. Chaque pays ne peut appartenir qu'à un seul marché par boutique.",+ "label": "Pays"},- "tax_inclusive": {- "label": "Prix taxes comprises",- "help": "Afficher les prix taxes comprises. Courant sur les marchés de l'UE."+ "currency": {+ "help": "Devise ISO 4217 utilisée pour tous les prix de ce marché.",+ "label": "Devise"},"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."+ "help": "Les acheteurs dont le pays est inconnu voient ce marché. Un seul peut être défini par défaut par boutique.",+ "label": "Marché par défaut"+ },+ "default_locale": {+ "help": "Langue de la boutique pour les acheteurs de ce marché.",+ "label": "Langue par défaut"+ },+ "name": {+ "placeholder": "ex. Europe"+ },+ "supported_locales": {+ "help": "Langues supplémentaires vers lesquelles les acheteurs peuvent basculer. La langue par défaut est toujours incluse.",+ "label": "Langues prises en charge"+ },+ "tax_inclusive": {+ "help": "Afficher les prix taxes comprises. Courant sur les marchés de l'UE.",+ "label": "Prix taxes comprises"+ }+ },+ "match_policy": {+ "label": "Politique de correspondance"+ },+ "media": {+ "alt": {+ "label": "Texte alternatif",+ "placeholder": "Décrivez l'image pour l'accessibilité et le référencement"}},"option_type": {- "name": {- "label": "Nom interne",- "placeholder": "ex. taille-chemise",- "help": "Identifiant en minuscules. Doit être unique dans la boutique."+ "filterable": {+ "help": "Afficher cette option comme filtre dans les listes de produits de la boutique.",+ "label": "Filtrable"+ },+ "kind": {+ "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.",+ "label": "Type"},"label": {+ "help": "Affiché aux clients sur la boutique.","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."+ "placeholder": "ex. Taille de chemise"},- "filterable": {- "label": "Filtrable",- "help": "Afficher cette option comme filtre dans les listes de produits de la boutique."+ "name": {+ "help": "Identifiant en minuscules. Doit être unique dans la boutique.",+ "label": "Nom interne",+ "placeholder": "ex. taille-chemise"}},"option_value": {- "name": {- "label": "Nom interne",- "placeholder": "ex. petit"- },- "label": {- "label": "Libellé",- "placeholder": "ex. Petit"- },"color_code": {"label": "Couleur"},"image": {"label": "Image"+ },+ "label": {+ "label": "Libellé",+ "placeholder": "ex. Petit"+ },+ "name": {+ "label": "Nom interne",+ "placeholder": "ex. petit"}},- "variant": {- "sku": {- "label": "SKU",- "placeholder": "PRODUIT-ROUGE-S"- },- "barcode": {- "label": "Code-barres"+ "order": {+ "channel": {+ "help": "Attribuer la commande à un canal de vente spécifique. Par défaut, le canal en ligne de la boutique.",+ "label": "Canal de vente",+ "placeholder": "Utiliser la valeur par défaut de la boutique"},- "weight": {- "label": "Poids"+ "coupon_code": {+ "label": "Code promo",+ "placeholder": "Facultatif"},- "weight_unit": {- "label": "Unité"+ "customer_note": {+ "label": "Note du client (visible par le client)"},- "height": {- "label": "Hauteur"+ "email": {+ "label": "Ou utiliser un e-mail d'invité",+ "placeholder": "[email protected]"},- "width": {- "label": "Largeur"+ "internal_note": {+ "label": "Note interne (personnel uniquement)"+ }+ },+ "payment_method": {+ "active": {+ "help": "Les méthodes inactives sont masquées lors du paiement.",+ "label": "Active"},- "depth": {- "label": "Profondeur"+ "auto_capture": {+ "help": "Capturer les fonds automatiquement à l'autorisation. Si désactivé, vous devez capturer manuellement.",+ "label": "Capture automatique"},- "dimensions_unit": {- "label": "Unité"+ "description": {+ "placeholder": "Description visible par le client affichée lors du paiement"},- "preorderable": {- "label": "Disponible en précommande",- "help": "Vendez cette variante avant qu'elle soit en stock. Plafonnez les quantités avec la limite de réassort, saisissez le stock à recevoir comme quantité, ou laissez vide pour un nombre illimité."+ "name": {+ "placeholder": "ex. Carte de crédit (Stripe)"},- "preorder_ships_at": {- "label": "Expédié avant le",- "placeholder": "Choisir une date",- "help": "Date à laquelle vous prévoyez d'expédier les précommandes. Affichée aux clients comme promesse de livraison ; la précommande se termine une fois cette date passée."+ "provider_configuration": "Configuration du fournisseur",+ "storefront_visible": {+ "label": "Visible sur la boutique"},- "backorder_limit": {- "label": "Limite de réassort",- "placeholder": "Illimité",- "help": "Nombre maximum d'unités vendues au-delà du stock disponible — plafonne les réassorts et les précommandes. Laissez vide pour illimité."+ "type": {+ "label": "Fournisseur",+ "placeholder": "Sélectionner un fournisseur"}},- "api_key": {- "name": {- "label": "Nom",- "placeholder": "Intégration backend, Boutique prod, …",- "required": "Le nom est requis"+ "price_list": {+ "description": {+ "label": "Description",+ "placeholder": "Description interne facultative"},- "key_type": {- "label": "Type"+ "ends_at": {+ "help": "Laissez vide pour aucune date de fin.",+ "label": "Fin",+ "placeholder": "Jamais"},- "scopes": {- "label": "Portées"+ "match_policy": {+ "all": "Toutes les règles doivent correspondre",+ "any": "N'importe quelle règle peut correspondre",+ "label": "Règle de correspondance"},- "channel": {- "label": "Channel",- "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",- "all_channels": "All channels"- }- },- "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"+ "help": "Libellé interne — jamais affiché aux clients.",+ "label": "Nom",+ "placeholder": "ex. Vente en gros UE"},- "storefront_access": {- "label": "Accès à la vitrine",- "help": "Valeur par défaut à l'échelle de la boutique pour ce que les visiteurs anonymes peuvent voir. Les canaux peuvent la remplacer. Lorsque les prix sont masqués, les invités doivent se connecter pour passer à la caisse.",- "options": {- "public": "Public — tout le monde peut parcourir et voir les prix",- "prices_hidden": "Prix masqués — les visiteurs doivent se connecter pour voir les prix",- "login_required": "Connexion requise — les visiteurs doivent se connecter pour parcourir"- }+ "starts_at": {+ "help": "Moment où cette liste devient active. Laissez vide pour démarrer immédiatement à l'activation.",+ "label": "Début",+ "placeholder": "Immédiatement"},- "guest_checkout": {- "label": "Commande invité",- "help": "Valeur par défaut à l'échelle de la boutique pour la possibilité de commander sans compte. Les canaux peuvent la remplacer."+ "status": {+ "active": "Active",+ "draft": "Brouillon",+ "inactive": "Inactive",+ "scheduled": "Programmée"+ }+ },+ "price_rule": {+ "channels": {+ "help": "Laissez vide pour appliquer cette règle à tous les canaux de vente.",+ "label": "Canaux de vente"},- "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_groups": {+ "help": "Laissez vide pour appliquer cette règle à tous les clients quel que soit leur groupe.",+ "label": "Groupes de clients"},- "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."+ "customers": {+ "help": "Laissez vide pour appliquer cette règle à tous les clients connectés.",+ "label": "Clients"},- "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."+ "markets": {+ "help": "Laissez vide pour appliquer cette règle sur tous les marchés.",+ "label": "Marchés"},- "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é."+ "max_quantity": {+ "help": "Laissez vide pour ne pas fixer de limite supérieure."},- "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."+ "min_quantity": {+ "help": "Ce prix s’applique uniquement lorsqu’un client commande au moins cette quantité d’un même article."}},- "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."- }+ "prices_count": {+ "label": "Prix"},"product": {- "name": {- "label": "Nom",- "placeholder": "Nom du produit"+ "available_on": {+ "label": "Disponible le"+ },+ "category_ids": {+ "label": "Catégories"+ },+ "channels": {+ "label": "Canaux de vente"},"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"+ "make_active_at": {+ "label": "Activer le"},- "channels": {- "label": "Canaux de vente"+ "name": {+ "label": "Nom",+ "placeholder": "Nom du produit"},"tags": {"label": "Étiquettes"@@ -633,870 +841,1282 @@},"product_publication": {"published_at": {+ "help": "Laissez vide pour une mise en ligne immédiate.","label": "Publier à partir du",- "placeholder": "En ligne immédiatement",- "help": "Laissez vide pour une mise en ligne immédiate."+ "placeholder": "En ligne immédiatement"},"unpublished_at": {+ "help": "Laissez vide pour garder le produit listé indéfiniment.","label": "Dépublier le",- "placeholder": "Jamais",- "help": "Laissez vide pour garder le produit listé indéfiniment."+ "placeholder": "Jamais"}},- "gift_card": {+ "products_count": {+ "label": "Produits"+ },+ "profile": {+ "avatar": {+ "help": "Affichée à côté de votre nom dans toute l'administration. Les images carrées sont recommandées.",+ "label": "Photo"+ },+ "email": {+ "label": "E-mail"+ },+ "first_name": {+ "label": "Prénom"+ },+ "last_name": {+ "label": "Nom"+ },+ "selected_locale": {+ "help": "Langue utilisée dans tout le tableau de bord d'administration. N'affecte que ce que vous voyez.",+ "label": "Langue"+ }+ },+ "promotion": {"code": {- "label": "Code",- "help": "Laissez vide pour générer automatiquement. Pour les lots, ceci devient le préfixe."+ "placeholder": "ETE2026"},- "amount": {- "label": "Montant"+ "code_prefix": {+ "help": "Chaque code généré commencera par ce préfixe.",+ "label": "Préfixe de code (facultatif)",+ "placeholder": "VIP"},- "currency": {- "label": "Devise"+ "description": {+ "placeholder": "Description interne (facultatif)"},"expires_at": {- "label": "Expire","placeholder": "Aucune expiration"},- "customer_id": {- "label": "Client"+ "kind": {+ "label": "Comment cette promotion est-elle appliquée ?"},- "quantity": {- "label": "Quantité",- "help": "1 émet une seule carte. Plus de 1 émet un lot avec des codes générés automatiquement."+ "match_policy": {+ "label": "Règle de correspondance"+ },+ "multi_codes": {+ "help": "Utile pour les codes à usage unique — chaque client utilise un code différent.",+ "label": "Générer un lot de codes uniques"+ },+ "name": {+ "placeholder": "Soldes d'été"+ },+ "number_of_codes": {+ "label": "Nombre de codes",+ "placeholder": "100"+ },+ "starts_at": {+ "placeholder": "Aucune date de début"+ },+ "usage_limit": {+ "label": "Limite d'utilisation",+ "placeholder": "Illimité"}},- "customer": {- "tags": {- "label": "Étiquettes"+ "role_id": {+ "label": "Rôle"+ },+ "role_ids": {+ "label": "Rôles"+ },+ "stock_location": {+ "active": {+ "help": "Les emplacements inactifs n'apparaissent pas dans la sélection d'expédition.",+ "label": "Actif"},- "customer_groups": {- "label": "Groupes de clients"+ "admin_name": {+ "label": "Nom interne",+ "placeholder": "Facultatif — affiché uniquement dans l'administration"},- "accepts_email_marketing": {- "label": "Abonné au marketing"+ "backorderable_default": {+ "help": "Les nouveaux articles en stock autorisent par défaut les commandes en attente en cas de rupture de stock.",+ "label": "Réapprovisionnable par défaut"},- "internal_note": {- "label": "Note interne",- "placeholder": "Contexte réservé au personnel à propos de ce client…"+ "default": {+ "help": "Les nouveaux articles en stock sont propagés ici. Un seul emplacement peut être défini par défaut.",+ "label": "Emplacement par défaut"+ },+ "kind": {+ "label": "Type"+ },+ "name": {+ "placeholder": "Entrepôt de Brooklyn"+ },+ "pickup_enabled": {+ "help": "Les clients peuvent retirer leurs commandes à cet emplacement lors du paiement.",+ "label": "Autoriser le retrait par le client"+ },+ "pickup_instructions": {+ "label": "Instructions de retrait",+ "placeholder": "Où le client doit se rendre pour récupérer sa commande."+ },+ "pickup_ready_in_minutes": {+ "label": "Prêt dans (minutes)",+ "placeholder": "60"+ },+ "pickup_stock_policy": {+ "label": "Règle de stock"+ },+ "propagate_all_variants": {+ "help": "Créer des articles en stock à cet emplacement pour chaque variante de produit.",+ "label": "Créer automatiquement des articles en stock pour toutes les variantes"+ }+ },+ "store": {+ "customer_support_email": {+ "help": "Adresse de réponse affichée aux clients dans les e-mails de la boutique.",+ "label": "E-mail du support client",+ "placeholder": "[email protected]"+ },+ "guest_checkout": {+ "help": "Valeur par défaut à l'échelle de la boutique pour la possibilité de commander sans compte. Les canaux peuvent la remplacer.",+ "label": "Commande invité"+ },+ "mail_from_address": {+ "help": "Utilisée comme adresse d'expéditeur sur chaque e-mail transactionnel.",+ "label": "Adresse d'expéditeur",+ "placeholder": "[email protected]"+ },+ "mailer_logo": {+ "help": "PNG ou JPG avec un fond transparent. Intégré dans les en-têtes des e-mails transactionnels.",+ "label": "Logo des e-mails"+ },+ "name": {+ "label": "Nom de la boutique"+ },+ "new_order_notifications_email": {+ "help": "Destinataire des notifications « nouvelle commande passée ». Laissez vide pour désactiver.",+ "label": "Notifications de nouvelles commandes",+ "placeholder": "[email protected]"+ },+ "preferred_admin_locale": {+ "label": "Langue de l'administration",+ "placeholder": "Utiliser la langue par défaut"+ },+ "preferred_send_consumer_transactional_emails": {+ "help": "Si désactivé, aucun e-mail de confirmation de commande, d'expédition ou de remboursement n'est envoyé.",+ "label": "Envoyer les e-mails transactionnels aux clients"+ },+ "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"+ },+ "storefront_access": {+ "help": "Valeur par défaut à l'échelle de la boutique pour ce que les visiteurs anonymes peuvent voir. Les canaux peuvent la remplacer. Lorsque les prix sont masqués, les invités doivent se connecter pour passer à la caisse.",+ "label": "Accès à la vitrine",+ "options": {+ "login_required": "Connexion requise — les visiteurs doivent se connecter pour parcourir",+ "prices_hidden": "Prix masqués — les visiteurs doivent se connecter pour voir les prix",+ "public": "Public — tout le monde peut parcourir et voir les prix"+ }}},"store_credit": {"amount": {"label": "Montant"},- "currency": {- "label": "Devise"- },"category_id": {"label": "Catégorie"},+ "currency": {+ "label": "Devise"+ },"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)"+ "storefront_visible": {+ "label": "Visible en boutique"+ },+ "tax_category": {+ "description": {+ "placeholder": "Description interne facultative"},- "internal_note": {- "label": "Note interne (personnel uniquement)"+ "is_default": {+ "help": "Activer cette option rétrograde la valeur par défaut précédente. Les produits sans catégorie explicite utilisent celle-ci.",+ "label": "Par défaut"},- "coupon_code": {- "label": "Code promo",- "placeholder": "Facultatif"+ "name": {+ "placeholder": "ex. Taux réduit"},- "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."+ "tax_code": {+ "label": "Code de taxe",+ "placeholder": "Code du fournisseur de taxe externe (Avalara, etc.)"}},- "media": {- "alt": {- "label": "Texte alternatif",- "placeholder": "Décrivez l'image pour l'accessibilité et le référencement"- }+ "tax_category_id": {+ "label": "Catégorie de taxe"},- "profile": {- "email": {- "label": "E-mail"+ "variant": {+ "backorder_limit": {+ "help": "Nombre maximum d'unités vendues au-delà du stock disponible — plafonne les réassorts et les précommandes. Laissez vide pour illimité.",+ "label": "Limite de réassort",+ "placeholder": "Illimité"},- "first_name": {- "label": "Prénom"+ "barcode": {+ "label": "Code-barres"},- "last_name": {- "label": "Nom"+ "depth": {+ "label": "Profondeur"},- "avatar": {- "label": "Photo",- "help": "Affichée à côté de votre nom dans toute l'administration. Les images carrées sont recommandées."+ "dimensions_unit": {+ "label": "Unité"},- "selected_locale": {- "label": "Langue",- "help": "Langue utilisée dans tout le tableau de bord d'administration. N'affecte que ce que vous voyez."- }- },- "match_policy": {- "label": "Politique de correspondance"- }- },- "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"+ "height": {+ "label": "Hauteur"},- "channel": {- "label": "Canaux"+ "preorder_ships_at": {+ "help": "Date à laquelle vous prévoyez d'expédier les précommandes. Affichée aux clients comme promesse de livraison ; la précommande se termine une fois cette date passée.",+ "label": "Expédié avant le",+ "placeholder": "Choisir une date"},- "market": {- "label": "Marchés"+ "preorderable": {+ "help": "Vendez cette variante avant qu'elle soit en stock. Plafonnez les quantités avec la limite de réassort, saisissez le stock à recevoir comme quantité, ou laissez vide pour un nombre illimité.",+ "label": "Disponible en précommande"},- "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."- }- }+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUIT-ROUGE-S"},- "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."- }- }+ "weight": {+ "label": "Poids"},- "customer_group": {- "label": "Groupes de clients",- "search_placeholder": "Rechercher des groupes de clients…",- "empty": "Aucun groupe de clients ne correspond"+ "weight_unit": {+ "label": "Unité"},- "customer": {- "label": "Clients",- "search_placeholder": "Rechercher des clients par nom ou e-mail…",- "empty": "Aucun client ne correspond"+ "width": {+ "label": "Largeur"}},- "table": {- "search_placeholder": "Rechercher par nom…",- "empty": "Aucune promotion pour le moment",- "no_end": "Sans fin"+ "webhook_endpoint": {+ "active": {+ "help": "Les points de terminaison inactifs ne reçoivent pas de livraisons.",+ "label": "Actif"+ },+ "name": {+ "help": "Libellé facultatif affiché dans cette liste.",+ "label": "Nom",+ "placeholder": "ex. Pipeline de commandes"+ },+ "subscriptions": {+ "help": "Sélectionnez les événements qui doivent déclencher un webhook. Ne choisissez rien pour recevoir tous les événements.",+ "label": "Événements"+ },+ "url": {+ "label": "URL de destination",+ "placeholder": "https://example.com/webhooks"+ }+ }+ },+ "gift_cards": {+ "batch_autocomplete": {+ "empty": "Aucun lot correspondant",+ "placeholder": "Rechercher des lots par préfixe…"},- "code": {- "automatic": "Automatique",- "multi": "multi"+ "columns": {+ "batch": "Lot",+ "customer": "Client",+ "issued_by": "Émise par",+ "remaining": "Restant",+ "used": "Utilisé"},- "basics_card": {- "title": "Informations de base"+ "messages": {+ "batch_create_failed": "Échec de la création du lot de cartes cadeaux",+ "batch_created": "Lot de cartes cadeaux créé",+ "create_failed": "Échec de la création de la carte cadeau",+ "created": "Carte cadeau créée",+ "delete_failed": "Échec de la suppression de la carte cadeau",+ "deleted": "Carte cadeau supprimée",+ "update_failed": "Échec de la mise à jour de la carte cadeau",+ "updated": "Carte cadeau mise à jour"},- "trigger_card": {- "title": "Déclencheur"+ "statuses": {+ "canceled": "Annulée",+ "expired": "Expirée",+ "partially_redeemed": "Partiellement utilisée",+ "redeemed": "Utilisée"},- "schedule_card": {- "title": "Planification et limites"+ "table": {+ "empty": "Aucune carte cadeau pour le moment",+ "search_placeholder": "Rechercher par code…"+ }+ },+ "imports": {+ "download_original": "Télécharger le fichier d'origine",+ "failed": {+ "description": "Le fichier n'a pas pu être traité.",+ "title": "Échec de l'import"},- "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."+ "failed_rows": {+ "error": "Erreur",+ "hide_data": "Masquer les données",+ "next_page": "Page suivante",+ "prev_page": "Page précédente",+ "row_number": "Ligne",+ "title": "Lignes en échec",+ "view_data": "Voir les données"},- "remove_rule_confirm": {- "title": "Supprimer la règle ?",- "message": "Supprimée lorsque vous enregistrez la promotion."+ "load_failed": "Impossible de charger l'import.",+ "mapping": {+ "description": "Associez les colonnes de votre fichier aux champs {{type}}.",+ "field": "Champ",+ "file_column": "Colonne du fichier",+ "missing_required": "Associez les champs requis pour continuer : {{fields}}",+ "not_mapped": "Non associée",+ "required": "Requis",+ "sample": "Exemple",+ "start": "Lancer l'import",+ "starting": "Lancement…",+ "title": "Associer les colonnes"},- "rule_summary": {- "product_count": "{{count}} produits",- "category_count": "{{count}} catégories",- "customer_count": "{{count}} clients"+ "processing": {+ "failed_count": "{{failed}} en échec",+ "note": "Vous pouvez quitter cette page — l'import continue en arrière-plan.",+ "preparing": "Préparation des lignes…",+ "progress": "{{processed}} lignes traitées sur {{total}}",+ "retrying": "Nouvelle tentative des lignes en échec · {{remaining}} restantes",+ "title": "Traitement des lignes"},- "rule_picker": {- "title": "Ajouter une règle",- "description": "Choisissez un type de règle à configurer."+ "results": {+ "completed_title": "Import terminé",+ "retry_failed": "Réessayer les lignes en échec ({{failed}})",+ "retrying": "Nouvelle tentative…",+ "summary": "{{completed}} lignes importées · {{failed}} en échec",+ "view_records": "Voir {{type}}"},- "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."+ "status": {+ "completed": "Terminé",+ "completed_mapping": "En file",+ "failed": "Échoué",+ "mapping": "Association",+ "pending": "En attente",+ "processing": "En cours"},- "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"+ "steps": {+ "complete": "Terminé",+ "map_fields": "Associer les champs",+ "process_rows": "Traiter les lignes"},- "remove_action_confirm": {- "title": "Supprimer l'action ?",- "message": "Supprimée lorsque vous enregistrez la promotion."+ "try_again": "Réessayer",+ "types": {+ "customers": "Clients",+ "product_translations": "Traductions de produits",+ "products": "Produits"},- "action_summary": {- "variant_count": "{{count}} variantes"+ "wizard_title": "Import"+ },+ "invitation": {+ "accepting": "Acceptation…",+ "could_not_accept": "Impossible d'accepter l'invitation",+ "create_and_accept": "Créer un compte et accepter",+ "create_to_accept": ". Créez votre compte pour accepter.",+ "generic_error_message": "Une erreur s'est produite. Veuillez réessayer.",+ "generic_error_title": "Impossible de charger l'invitation",+ "invited_as_role": " en tant que {{role}}",+ "invited_by": "{{email}} vous a invité",+ "invited_generic": "Vous avez été invité",+ "join_store": "Rejoindre {{store}}",+ "loading": "Chargement de l'invitation…",+ "missing_token_message": "Ce lien semble incomplet. Demandez à la personne qui vous a invité de vous le renvoyer.",+ "missing_token_title": "Jeton d'invitation manquant",+ "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.",+ "not_found_title": "Invitation introuvable",+ "sign_in_and_accept": "Se connecter et accepter",+ "sign_in_to_accept": ". Connectez-vous pour accepter."+ },+ "markets": {+ "add_cta": "Ajouter un marché",+ "columns": {+ "default": "Par défaut"},- "action_picker": {- "title": "Ajouter une action",- "description": "Choisissez ce qui doit se passer lorsque la promotion s'applique."+ "create_description": "Regroupez des pays dans une seule région tarifaire avec sa propre devise et ses propres langues.",+ "create_label": "Créer un marché",+ "delete_confirm": {+ "message": "{{name}} sera supprimé. Les commandes précédemment passées sur ce marché restent intactes.",+ "title": "Supprimer le marché ?"},- "action_edit": {- "description": "Configurez les paramètres de l'action.",- "no_options": "Cette action n'a aucune option configurable."+ "edit_description": "Mettez à jour le nom, la devise, les langues ou la couverture géographique.",+ "empty": "Aucun marché pour le moment",+ "errors": {+ "failed_to_create": "Échec de la création du marché",+ "failed_to_delete": "Échec de la suppression du marché",+ "failed_to_update": "Échec de la mise à jour du marché"},- "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é"+ "messages": {+ "created": "Marché créé",+ "deleted": "Marché supprimé",+ "updated": "Marché mis à jour"+ },+ "search_placeholder": "Rechercher par nom…",+ "tax_exclusive": "HT",+ "tax_inclusive": "TTC"+ },+ "nav": {+ "account": "Compte",+ "categories": "Catégories",+ "customer_groups": "Groupes",+ "customers": "Clients",+ "draft_orders": "Commandes provisoires",+ "getting_started": "Premiers pas",+ "gift_cards": "Cartes cadeaux",+ "home": "Accueil",+ "options": "Options",+ "orders": "Commandes",+ "price_lists": "Listes de prix",+ "products": "Produits",+ "promotions": "Promotions",+ "reports": "Rapports",+ "settings": "Paramètres",+ "transfers": "Transferts"+ },+ "option_types": {+ "columns": {+ "values": "Valeurs"+ },+ "kinds": {+ "buttons": "Boutons",+ "color_swatch": "Nuancier de couleur",+ "dropdown": "Liste déroulante"+ },+ "messages": {+ "created": "Type d'option créé",+ "deleted": "Type d'option supprimé",+ "updated": "Type d'option mis à jour"+ },+ "table": {+ "empty": "Aucun type d'option pour le moment",+ "search_placeholder": "Rechercher par nom…"+ },+ "value_count_one": "{{count}} valeur",+ "value_count_other": "{{count}} valeurs"+ },+ "order_routing_rules": {+ "messages": {+ "created": "Règle de routage ajoutée",+ "deleted": "Règle de routage supprimée"+ },+ "types": {+ "default_location": {+ "description": "Privilégie le lieu de stock marqué comme défaut",+ "name": "Lieu de stock par défaut"+ },+ "minimize_splits": {+ "description": "Privilégie le lieu capable d'expédier le plus d'articles à lui seul, évitant les envois fractionnés",+ "name": "Minimiser les envois fractionnés"+ },+ "preferred_location": {+ "description": "Expédier depuis le lieu épinglé sur la commande, s'il est défini",+ "name": "Lieu de stock préféré"}+ }+ },+ "orders": {+ "columns": {+ "customer": "Client",+ "date": "Date",+ "fulfillment": "Traitement",+ "items": "Articles",+ "number": "Numéro",+ "payment": "Paiement",+ "sku": "SKU",+ "tags": "Étiquettes"},- "rule_types": {- "category": {- "name": "Catégories",- "description": "La commande contient des produits des catégories spécifiées"+ "detail": {+ "add_line_item": {+ "title": "Ajouter un article"},- "country": {- "name": "Pays",- "description": "Limiter aux commandes dont l'adresse de livraison se trouve dans un pays spécifique"+ "address_edit": {+ "billing_title": "Modifier l'adresse de facturation",+ "shipping_title": "Modifier l'adresse de livraison"+ },+ "adjustment_lines": {+ "add_discount": "Ajouter une remise",+ "add_discount_description": "Crée une remise manuelle. Sans article cible, le montant est réparti sur tous les articles.",+ "add_fee": "Ajouter des frais",+ "add_fee_description": "Crée des frais tels que supplément, manutention ou emballage cadeau.",+ "amount_field": "Montant",+ "delete_discount_message": "Retirer la remise « {{label}} » de cette commande ? Les totaux seront recalculés.",+ "delete_discount_title": "Supprimer la remise",+ "delete_fee_message": "Retirer les frais « {{label}} » de cette commande ? Les totaux seront recalculés.",+ "delete_fee_title": "Supprimer les frais",+ "discounts": "Remises",+ "empty": "Aucune taxe, remise ou frais sur cette commande pour le moment.",+ "fees": "Frais",+ "kind_field": "Nature",+ "kind_promotion": "Promotion",+ "label_field": "Libellé",+ "target_field": "S'applique à",+ "target_order": "Commande entière",+ "taxes": "Taxes",+ "title": "Taxes, remises et frais",+ "value_field": "Valeur",+ "value_type_field": "Type",+ "value_type_flat": "Montant",+ "value_type_percent": "Pourcentage"},- "currency": {- "name": "Devise",- "description": "Limiter aux commandes dans une devise spécifique"+ "completed_prefix": "Terminée",+ "confirm": {+ "approve_message": "Approuver cette commande ?",+ "cancel_message": "Voulez-vous vraiment annuler cette commande ?",+ "cancel_shipment_message": "Annuler cet envoi ?",+ "capture_message": "Capturer ce paiement ?",+ "complete_message": "Finaliser cette commande brouillon maintenant ?",+ "remove_gift_card_message": "Retirer cette carte cadeau de la commande ?",+ "remove_item_message": "Retirer cet article de la commande ?",+ "remove_store_credit_message": "Retirer l'avoir de la commande ?",+ "resume_message": "Reprendre cette commande annulée ?",+ "ship_message": "Expédier cet envoi ?",+ "void_message": "Annuler ce paiement ?"},- "customer": {- "name": "Clients",- "description": "Disponible uniquement pour les clients spécifiés"+ "dropdown": {+ "cancel_shipment": "Annuler l'envoi",+ "complete_order": "Finaliser la commande",+ "edit_quantity": "Modifier la quantité",+ "preview_order": "Aperçu de la commande",+ "resend_confirmation": "Renvoyer la confirmation",+ "void_payment": "Annuler le paiement"},- "customer_group": {- "name": "Groupe(s) de clients",- "description": "Disponible uniquement pour les clients des groupes de clients spécifiés"+ "edit_quantity": {+ "description": "Définissez la quantité pour cette ligne d'article.",+ "title": "Modifier la quantité"},- "customer_logged_in": {- "name": "Uniquement les clients connectés",- "description": "Disponible uniquement pour les clients connectés"+ "errors": {+ "approve_failed": "Échec de l'approbation de la commande",+ "cancel_failed": "Échec de l'annulation de la commande",+ "complete_failed": "Échec de la finalisation de la commande",+ "confirmation_send_failed": "Échec de l'envoi de la confirmation",+ "resume_failed": "Échec de la reprise de la commande"},- "first_order": {- "name": "Première commande",- "description": "Doit être la première commande du client"+ "gift_card_section": {+ "applied_suffix": "appliqué",+ "apply_balance": "Appliquer le solde disponible du client",+ "apply_dialog_description": "Saisissez un code de carte cadeau à appliquer à cette commande.",+ "apply_dialog_title": "Appliquer une carte cadeau",+ "code_placeholder": "GIFT-XXXX-YYYY",+ "gift_card_label": "Carte cadeau",+ "none_applied": "Aucun appliqué",+ "requires_customer": "Nécessite un client",+ "store_credit_label": "Avoir",+ "title": "Carte cadeau et avoir"},- "item_total": {- "name": "Total des articles",- "description": "Le total de la commande répond à ces critères"+ "items_table": {+ "item": "Article",+ "price": "Prix",+ "qty": "Qté"},- "one_use_per_user": {- "name": "Une utilisation par utilisateur",- "description": "Une seule utilisation par utilisateur"+ "load_failed_message": "Impossible de charger la commande {{orderId}}.",+ "messages": {+ "approved": "Commande approuvée",+ "canceled": "Commande annulée",+ "captured": "Paiement capturé",+ "completed": "Commande finalisée",+ "confirmation_sent": "Confirmation envoyée",+ "resumed": "Commande reprise",+ "shipped": "Envoi expédié",+ "voided": "Paiement annulé"},- "option_value": {- "name": "Valeur(s) d'option",- "description": "La commande contient des produits avec des valeurs d'option correspondantes"+ "no_customer": "Aucune information client",+ "no_line_items": "Aucun article",+ "payment_form": {+ "amount_help": "Laissez vide pour utiliser par défaut le solde restant dû.",+ "capture_immediately": "Capturer immédiatement",+ "description": "Prélevez un moyen de paiement sur cette commande.",+ "method_label": "Moyen de paiement",+ "method_placeholder": "Choisir un moyen de paiement",+ "no_saved_cards": "Le client n'a aucune carte enregistrée pour ce moyen de paiement.",+ "source_label": "Source",+ "source_placeholder": "Choisir une carte enregistrée…",+ "source_requires_customer": "Ce moyen de paiement nécessite une source enregistrée. Veuillez d'abord associer un client à la commande.",+ "title": "Ajouter un paiement"},- "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"+ "payments_table": {+ "method": "Méthode",+ "number": "Numéro",+ "state": "État"},- "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"+ "section_customer_note": "Instructions spéciales",+ "section_internal_note": "Note interne",+ "summary": {+ "adjustments": "Ajustements",+ "approved_by": "Approuvé par",+ "canceled_at": "Annulée le",+ "canceler": "Annulé par",+ "outstanding_balance": "Solde restant dû",+ "payment_total": "Total des paiements",+ "promotions": "Promotions",+ "tax_additional": "Taxe (supplémentaire)",+ "tax_included": "Taxe (incluse)"},- "create_line_items": {- "name": "Créer des lignes d'article",- "description": "Ajoute au panier la quantité spécifiée de la variante"+ "tracking": {+ "add_title": "Ajouter un suivi",+ "description": "Mettez à jour le numéro de suivi de cet envoi.",+ "edit_title": "Modifier le suivi",+ "label": "Numéro de suivi",+ "prefix": "Suivi",+ "shipped_prefix": "Expédié"},- "free_shipping": {- "name": "Livraison gratuite",- "description": "Rend gratuites toutes les expéditions de la commande"+ "variant_search": {+ "description": "Recherchez une variante de produit à ajouter à cette commande.",+ "empty": "Aucune variante trouvée",+ "label": "Rechercher une variante",+ "placeholder": "Saisissez le nom du produit ou le SKU (3 caractères min.)…",+ "sku_prefix": "SKU"}},- "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"+ "fulfillment_statuses": {+ "backorder": "Commande en attente",+ "canceled": "Annulé",+ "fulfilled": "Traité",+ "partial": "Partiel",+ "pending": "En attente",+ "ready": "Prêt"},- "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"+ "item_count_one": "{{count}} article",+ "item_count_other": "{{count}} articles",+ "new": {+ "add_variant": "Ajouter une variante",+ "creates_draft_note": "Crée une commande brouillon. Ajoutez des paiements et finalisez-la après la création.",+ "items_table": {+ "qty": "Qté",+ "sku": "SKU",+ "variant": "Variante"+ },+ "use_default_addresses": "Utiliser les adresses de facturation et de livraison par défaut du client"},- "custom_fields": {- "section_title": "Champs personnalisés",- "set_up": "Configurer les champs personnalisés",- "manage_in_settings": "Gérer dans les paramètres",- "empty_title": "Aucun champ personnalisé pour le moment",- "empty_description": "Suivez des détails structurés comme la matière, la coupe ou les instructions d’entretien.",- "values_saved": "Champs personnalisés enregistrés",- "values_save_partial_failed": "Certains champs personnalisés n’ont pas pu être enregistrés : {{fields}}",- "new_definition_title": "Nouveau champ personnalisé",- "new_definition_description": "Définissez un champ personnalisé pour stocker des informations typées et structurées sur vos {{resource}}.",- "default_resource": "enregistrements",- "errors": {- "failed_to_save": "Impossible d’enregistrer le champ personnalisé"- }+ "payment_statuses": {+ "balance_due": "Solde dû",+ "credit_owed": "Crédit dû",+ "failed": "Échouée",+ "paid": "Payée",+ "void": "Annulée"},- "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"+ "statuses": {+ "canceled": "Annulée",+ "draft": "Brouillon",+ "placed": "Passée"+ },+ "table": {+ "empty": "Aucune commande trouvée",+ "search_placeholder": "Rechercher des commandes…"}},"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"+ "channels": {+ "add_cta": "Nouveau canal de vente",+ "add_sheet_title": "Ajouter 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.",+ "create_label": "Créer un canal de vente",+ "delete_confirm": {+ "message": "{{name}} sera supprimé. Les produits et commandes qui y sont rattachés perdront leur référence de canal de vente.",+ "title": "Supprimer le canal de vente ?"},- "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."- },- "order_routing_rules": {- "title": "Règles de routage des commandes",- "help": "Avec la stratégie de routage « Règles (ordonnées) », les règles sont évaluées de haut en bas — la première règle qui désigne un seul lieu de stock l'emporte ; en cas d'égalité, la règle suivante départage.",- "empty": "Aucune règle de routage — les commandes utilisent le lieu de stock par défaut.",- "add_cta": "Ajouter une règle",- "picker_title": "Ajouter une règle de routage",- "edit_preferences": "Modifier les paramètres de la règle",- "active_toggle": "Règle active",- "delete_confirm": {- "title": "Supprimer la règle de routage ?",- "message": "{{name}} sera retirée de l'ordre de routage de ce canal."- }+ "edit_description": "Renommez un canal de vente ou mettez-le en pause. Les canaux de vente inactifs cessent d'accepter les commandes.",+ "edit_sheet_title": "Modifier le canal de vente",+ "empty_message": "Aucun canal de vente pour le moment",+ "no_channels_found": "Aucun canal de vente trouvé",+ "order_routing_rules": {+ "active_toggle": "Règle active",+ "add_cta": "Ajouter une règle",+ "delete_confirm": {+ "message": "{{name}} sera retirée de l'ordre de routage de ce canal.",+ "title": "Supprimer la règle de routage ?"+ },+ "edit_preferences": "Modifier les paramètres de la règle",+ "empty": "Aucune règle de routage — les commandes utilisent le lieu de stock par défaut.",+ "help": "Avec la stratégie de routage « Règles (ordonnées) », les règles sont évaluées de haut en bas — la première règle qui désigne un seul lieu de stock l'emporte ; en cas d'égalité, la règle suivante départage.",+ "picker_title": "Ajouter une règle de routage",+ "title": "Règles de routage des commandes"},"search_placeholder": "Rechercher des canaux de vente…",- "no_channels_found": "Aucun canal de vente trouvé",+ "title": "Canaux de vente","validation": {"code_format": "Lettres minuscules, chiffres, tirets et underscores uniquement"}},"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",+ "add_address": "Ajouter une adresse",+ "addresses_empty": "Aucune adresse enregistrée.",+ "edit_address": "Modifier l'adresse",+ "edit_credit": "Modifier l'avoir en boutique",+ "issue_credit": "Émettre un avoir en boutique",+ "orders_empty": "Aucune commande pour le moment.","section_addresses": "Adresses",+ "section_internal_note": "Note interne","section_orders": "Commandes",+ "section_profile": "Profil","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"- }+ "stat_avg_order_value": "Valeur moyenne des commandes",+ "stat_orders": "Commandes",+ "stat_total_spent": "Total dépensé",+ "store_credit_empty": "Aucun avoir en boutique émis."+ },+ "edit_sheet_title": "Modifier le client",+ "groups": {+ "add_cta": "Ajouter un groupe de clients",+ "add_sheet_title": "Ajouter un groupe de clients",+ "edit_sheet_title": "Modifier le groupe de clients",+ "title": "Groupes de clients"+ },+ "groups_cta": "Groupes de clients",+ "new_cta": "Nouveau client"},- "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…"+ "getting_started": {+ "description": "Terminez ces étapes pour lancer votre boutique.",+ "progress": "{{done}} sur {{total}} terminées",+ "storefront_sheet": {+ "api_url_label": "URL de la Store API",+ "deploy_button": "Déployer sur Vercel",+ "deploy_copy": "Le déploiement clone la boutique open-source sur votre compte Git et la construit sur Vercel avec vos identifiants préremplis. Une fois terminé, copiez son URL dans le champ ci-dessous.",+ "deploy_title": "Recommandé : déployer la boutique Next.js officielle",+ "description": "Utilisez ces identifiants dans tout client qui communique avec la Store API — boutique web, application mobile ou autre.",+ "env_description": "Votre URL de Store API Spree et votre clé publiable. Les deux sont préremplies depuis votre boutique — ajustez-les avant le déploiement si nécessaire.",+ "invalid_url": "Cela ne ressemble pas à une URL de boutique valide.",+ "key_error": "Impossible de charger votre clé API publiable.",+ "local_installation_instructions": "Instructions d'installation locale",+ "publishable_key_label": "Clé API publiable",+ "save": "Enregistrer et terminer",+ "saved": "URL de la boutique enregistrée : {{url}}",+ "see_online_demo": "Voir la démo en ligne",+ "storefront_url_help": "L'URL que vos clients utilisent pour accéder à votre boutique. Elle sert de base aux liens dans les e-mails clients et est automatiquement ajoutée comme origine autorisée pour que les boutiques web puissent appeler la Store API.",+ "storefront_url_label": "URL de la boutique",+ "storefront_url_placeholder": "https://myshop.com",+ "title": "Connecter votre boutique"},- "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"+ "tasks": {+ "add_products": {+ "cta": "Ajouter des produits",+ "description": "Ajoutez des produits à votre boutique — les vôtres, ou invitez des vendeurs tiers à vendre avec vous.",+ "import_cta": "Importer des produits depuis un CSV",+ "title": "Ajouter des produits"},- "empty_payments": "Aucun paiement pour le moment.",- "empty_shipments": "Aucune expédition pour le moment.",- "no_delivery_method": "Aucune méthode de livraison sélectionnée.",- "empty_history": "Aucun historique pour le moment.",+ "set_customer_support_email": {+ "cta": "Paramètres e-mail",+ "description": "Affiché sur votre boutique comme point de contact pour les questions et le support client.",+ "title": "Définir l'e-mail du support client"+ },+ "setup_payment_method": {+ "cta": "Configurer les paiements",+ "description": "Pour encaisser des paiements, configurez au moins un prestataire de paiement en ligne.",+ "title": "Configurer les moyens de paiement"+ },+ "setup_storefront": {+ "cta": "Connecter la boutique",+ "description": "Connectez votre boutique web ou votre application mobile avec vos identifiants Store API et enregistrez l'URL de votre boutique.",+ "title": "Configurer la boutique"+ },+ "setup_taxes_collection": {+ "cta": "Paramètres des taxes",+ "description": "Pour collecter les taxes, configurez vos taux de taxe.",+ "title": "Configurer la collecte des taxes"+ }+ },+ "title": "Premiers pas"+ },+ "home": {+ "columns": {+ "price": "Prix",+ "product": "Produit",+ "sold": "Vendu"+ },+ "metric_short": {+ "avg_order_value": "Panier moy.",+ "orders": "Commandes",+ "sales": "Ventes"+ },+ "metrics": {+ "avg_order_value": "Panier moyen",+ "orders": "Commandes totales",+ "sales": "Ventes totales"+ },+ "subtitle": "Aperçu des performances de votre boutique",+ "title": "Tableau de bord",+ "top_products": "Meilleurs produits",+ "top_products_description": "Produits les plus vendus de votre boutique."+ },+ "orders": {+ "detail": {"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"+ "refund": "Rembourser",+ "resume": "Reprendre",+ "ship": "Marquer comme expédiée",+ "void": "Annuler"},"dialogs": {- "cancel_title": "Annuler la commande ?","approve_title": "Approuver la commande ?",+ "cancel_title": "Annuler la commande ?","refund_title": "Rembourser le paiement ?"+ },+ "empty_history": "Aucun historique pour le moment.",+ "empty_payments": "Aucun paiement pour le moment.",+ "empty_shipments": "Aucune expédition pour le moment.",+ "no_delivery_method": "Aucune méthode de livraison sélectionnée.",+ "section_billing_address": "Adresse de facturation",+ "section_customer": "Client",+ "section_customer_note": "Note du client",+ "section_fulfillments": "Traitements",+ "section_history": "Historique",+ "section_internal_note": "Note interne",+ "section_items": "Articles",+ "section_payments": "Paiements",+ "section_shipping_address": "Adresse de livraison",+ "section_summary": "Récapitulatif",+ "summary": {+ "channel": "Canal de vente",+ "created_by": "Créée par",+ "ip_address": "Adresse IP",+ "locale": "Langue",+ "market": "Marché"}+ },+ "drafts_title": "Brouillons de commandes",+ "new": {+ "add_line_item": "Ajouter une ligne d'article",+ "search_variant": "Rechercher une variante…",+ "section_billing": "Facturation",+ "section_customer": "Client",+ "section_items": "Articles",+ "section_notes": "Notes",+ "section_summary": "Récapitulatif",+ "select_customer": "Sélectionner un client",+ "title": "Nouvelle commande"}},"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",- "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",- "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_add_failed": "Échec de l'ajout des produits aux catégories",+ "categories_add_title": "Ajouter aux catégories",+ "categories_added": "{n} produits ajoutés aux catégories","categories_remove_description": "Choisissez les catégories desquelles retirer ces produits.",- "channels_add_title": "Ajouter aux canaux de vente",+ "categories_remove_failed": "Échec du retrait des produits des catégories",+ "categories_remove_title": "Retirer des catégories",+ "categories_removed": "{n} produits retirés des catégories","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.",+ "channels_add_failed": "Échec du référencement des produits sur les canaux de vente",+ "channels_add_title": "Ajouter aux canaux de vente",+ "channels_added": "{n} produits répertoriés sur les canaux de vente",+ "channels_remove_description": "Choisissez les canaux de vente desquels retirer ces produits.",+ "channels_remove_failed": "Échec du retrait des produits des canaux de vente",+ "channels_remove_title": "Retirer des canaux de vente",+ "channels_removed": "{n} produits retirés des canaux de vente","delete_confirm": {- "title": "Supprimer {n} produits ?",- "message": "Les produits sélectionnés seront supprimés. Cette action est irréversible."+ "message": "Les produits sélectionnés seront supprimés. Cette action est irréversible.",+ "title": "Supprimer {n} produits ?"},- "status_updated": "Statut mis à jour sur {n} produits",+ "delete_failed": "Échec de la suppression des produits",+ "deleted": "{n} produits supprimés",+ "remove_categories_action": "Retirer des catégories…",+ "remove_channels_action": "Retirer des canaux de vente…",+ "remove_tags_action": "Retirer des étiquettes…",+ "set_status_action": "Définir le statut…",+ "status_sheet_description": "Choisissez le statut à appliquer aux produits sélectionnés.",+ "status_sheet_title": "Définir le statut du produit","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",+ "status_updated": "Statut mis à jour sur {n} produits",+ "tags_add_description": "Choisissez ou créez des étiquettes à ajouter à ces produits.","tags_add_failed": "Échec de l'ajout des étiquettes",- "tags_removed": "Étiquettes retirées de {n} produits",+ "tags_add_title": "Ajouter des étiquettes",+ "tags_added": "Étiquettes ajoutées à {n} produits",+ "tags_remove_description": "Choisissez les étiquettes à retirer de ces produits.","tags_remove_failed": "Échec du retrait des étiquettes",- "deleted": "{n} produits supprimés",- "delete_failed": "Échec de la suppression des produits"+ "tags_remove_title": "Retirer des étiquettes",+ "tags_removed": "Étiquettes retirées de {n} 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",- "active": "Actif",- "archived": "Archivé"+ "clone_failed": "Échec de la duplication du produit",+ "clone_succeeded": "Produit dupliqué",+ "delete_failed": "Échec de la suppression du produit",+ "delete_succeeded": "Produit supprimé",+ "edit": {+ "bulk_prices": {+ "no_variants": "Ajoutez au moins une variante pour commencer à modifier les prix."+ }},"inventory": {- "out_of_stock": "En rupture de stock",+ "in_stock": "{{count}} en stock","on_backorder": "En réapprovisionnement",- "in_stock": "{{count}} en stock"+ "out_of_stock": "En rupture de 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."+ "media_empty": "Aucun média pour le moment.",+ "media_upload": "Téléverser un média",+ "new": {+ "create_failed": "Échec de la création du produit",+ "create_succeeded": "Produit créé",+ "description": "Configurez votre produit — ajoutez des variantes, des prix, des stocks, des médias et des champs personnalisés",+ "preview_slug_placeholder": "slug-de-votre-produit",+ "save_label": "Créer le produit",+ "title": "Nouveau produit"},"options": {+ "add_value": "Ajouter une valeur d'option","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"- }+ },+ "values_empty": "Aucune valeur pour le moment.",+ "values_section": "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."+ "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}}).",+ "title": "Activer la liste de prix ?"},+ "add_cta": "Nouvelle liste de prix",+ "add_products_cta": "Ajouter des produits",+ "add_rule": "Ajouter une règle",+ "add_rule_help": "Choisissez un type de règle à configurer.",+ "basics_section": "Informations de base",+ "deactivate": "Désactiver","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."+ "message": "« {{name}} » cessera immédiatement de s'appliquer aux clients. Les commandes existantes ne sont pas affectées.",+ "title": "Désactiver la liste de prix ?"},- "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."+ "delete_confirm": {+ "message": "Supprimer « {{name}} » supprime ses prix. Cette action est irréversible.",+ "title": "Supprimer la liste de prix ?"},"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": {+ "compare_at_price": "Prix de comparaison",+ "price": "Prix","product": "Produit",- "variant": "Variante","sku": "SKU",- "price": "Prix",- "compare_at_price": "Prix de comparaison"+ "variant": "Variante"},- "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.",+ "currency_label": "Devise","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."- }+ "message_currency": "Changer de devise abandonnera vos prix non enregistrés.",+ "title": "Abandonner les prix non enregistrés ?"+ },+ "empty": "Aucun produit dans cette liste pour le moment.",+ "empty_no_base_prices": "Aucun prix de base pour le moment.",+ "empty_pick_products": "Choisissez des produits dans la liste de prix pour commencer à définir les prix.",+ "grid_aria": "Prix des variantes",+ "no_matches_for_filters": "Aucun prix ne correspond aux filtres actuels.",+ "no_matches_for_search": "Aucun prix ne correspond à « {{search}} ».",+ "price_aria": "Prix pour {{label}}",+ "save_cta": "Enregistrer les prix",+ "save_failed": "Échec de l'enregistrement des prix",+ "save_success_one": "{{count}} prix enregistré",+ "save_success_other": "{{count}} prix enregistrés",+ "search_placeholder": "Rechercher par produit, SKU ou option…",+ "title": "Modifier les prix — {{name}}",+ "variant_default": "Par défaut"},+ "edit_prices_cta": "Modifier les prix",+ "no_changes": "Aucune modification à enregistrer.",+ "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é.","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",- "tab_storefront_access": "Accès à la vitrine"+ "products_empty_search": "Aucun produit ne correspond",+ "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_section": "Produits",+ "products_selected_one": "{{count}} produit sélectionné.",+ "products_selected_other": "{{count}} produits sélectionnés.",+ "remove_rule_confirm": {+ "message": "La règle est supprimée lorsque vous enregistrez la liste de prix.",+ "title": "Retirer la règle ?"+ },+ "remove_selected": "Retirer la sélection",+ "rule_click_to_configure": "Cliquez pour configurer",+ "rule_default_description": "Ajustez les paramètres de la règle.",+ "rule_name_overflow": "{{names}} +{{count}} de plus",+ "rule_no_options": "Cette règle n'a aucune option configurable — sa seule présence applique la contrainte.",+ "rule_types_all_used": "Tous les types de règles disponibles sont déjà sur cette liste.",+ "rule_types_empty": "Aucun type de règle enregistré.",+ "rules_empty": "Aucune règle — cette liste s'applique à tous les acheteurs.",+ "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_section": "Règles",+ "schedule": "Planifier",+ "schedule_confirm": {+ "message": "« {{name}} » sera mise en ligne le {{starts_at}} et restera active jusqu'à sa date de fin.",+ "title": "Planifier la liste de prix ?"+ },+ "schedule_section": "Planification",+ "sheet_title_create": "Créer une liste de prix",+ "sheet_title_edit": "Modifier la liste de prix",+ "subtitle": "Tarification ciblée pour des groupes de clients, des régions ou des paliers de volume.",+ "title": "Listes de prix",+ "unschedule": "Déplanifier",+ "unschedule_confirm": {+ "message": "« {{name}} » ne s'activera plus à sa date planifiée. Vous pourrez la replanifier ou l'activer manuellement plus tard.",+ "title": "Déplanifier la liste de prix ?"+ }},- "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.",- "load_failed_title": "Impossible de charger les paramètres d'e-mail"+ "publishing": {+ "caption_hidden_after": "Retiré le {{date}}",+ "caption_live": "Visible par les clients dès maintenant",+ "caption_not_available": "Masqué — le produit est {{product_status}}",+ "caption_scheduled": "Mise en ligne le {{date}}",+ "caption_unpublished": "A été masqué le {{date}}",+ "caption_window": "En ligne du {{start}} au {{end}}",+ "empty": "Pas encore répertorié sur un canal de vente.",+ "inactive_marker": "Inactif",+ "manage_cta": "Gérer",+ "manage_description": "Choisissez les canaux de vente sur lesquels ce produit est répertorié. Désactivez un canal pour le retirer partout.",+ "manage_title": "Gérer les canaux de vente",+ "no_channels": "Aucun canal de vente disponible. Créez-en un dans Paramètres → Canaux de vente.",+ "status_hidden": "Masqué",+ "status_live": "En ligne",+ "status_not_available": "Indisponible",+ "status_scheduled": "Planifié",+ "title": "Publication"},- "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",+ "section_basics": "Informations de base",+ "section_categorization": "Catégorisation",+ "section_inventory": "Stock",+ "section_media": "Médias",+ "section_organization": "Organisation",+ "section_pricing": "Tarification",+ "section_seo": "SEO",+ "section_variants": "Variantes",+ "status_options": {+ "active": "Actif",+ "archived": "Archivé",+ "draft": "Brouillon"+ },+ "transfers": {+ "description_external": "Réception externe dans <strong>{{destination}}</strong>.",+ "description_internal": "Stock déplacé de <strong>{{source}}</strong> vers <strong>{{destination}}</strong>.",+ "edit_sheet_title": "Transfert {{number}}",+ "items_empty": "Aucun article pour le moment.",+ "section_from": "De",+ "section_items": "Articles",+ "section_to": "Vers",+ "sheet_title": "Nouveau transfert de stock"+ },+ "variants_empty": "Aucune variante pour le moment.",+ "variants_one": "{{count}} variante",+ "variants_other": "{{count}} variantes"+ },+ "profile": {+ "load_failed_title": "Impossible de charger votre profil",+ "personal_details": "Informations personnelles",+ "subtitle": "Gérez vos informations personnelles et votre langue d'administration.",+ "title": "Profil"+ },+ "promotions": {+ "create_cta": "Créer une promotion",+ "gift_cards": {+ "batch_section": "Lot",+ "create_batch_cta": "Créer {{count}} cartes cadeaux",+ "create_label": "Créer une carte cadeau","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é."+ "message": "Cela annulera la carte cadeau et l'empêchera d'être utilisée.",+ "title": "Supprimer la carte cadeau ?"},- "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"+ "edit_sheet_title": "Carte cadeau",+ "new_cta": "Nouvelle carte cadeau",+ "new_sheet_title": "Nouvelle carte cadeau",+ "no_customer": "Aucun client rattaché",+ "not_found": "Carte cadeau introuvable.",+ "prefix": {+ "auto_placeholder": "Généré automatiquement si laissé vide",+ "label": "Préfixe",+ "placeholder": "ex. WELCOME — les codes seront WELCOME-abc123"},- "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.",+ "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."+ },+ "status_options": {+ "expired": "Expirée",+ "redeemed": "Utilisée",+ "void": "Annulée"+ },+ "usage": {+ "issued_by": "Émise par",+ "remaining": "Restant",+ "title": "Utilisation",+ "used": "Utilisé"+ },+ "validation": {+ "amount_positive": "Le montant doit être supérieur à zéro",+ "amount_required": "Le montant est requis",+ "currency_required": "La devise est requise",+ "prefix_required": "Le préfixe est requis pour les lots"+ }+ },+ "loading": "Chargement de la promotion…",+ "new_title": "Nouvelle promotion"+ },+ "settings": {+ "allowed_origins": {+ "add_sheet_title": "Ajouter une origine autorisée",+ "edit_sheet_title": "Modifier l'origine autorisée"+ },+ "api_keys": {+ "empty_publishable": "Aucune clé publiable pour le moment.",+ "empty_secret": "Aucune clé secrète pour le moment.",+ "new_cta": "Nouvelle clé",+ "publishable_help": "Utilisées par votre vitrine. Peuvent être exposées en toute sécurité dans le code côté client.",+ "publishable_section": "Clés publiables",+ "save_secret_description": "Copiez cette valeur maintenant — nous ne l'afficherons plus.",+ "save_secret_title": "Enregistrez votre clé secrète",+ "scope_badge": {+ "full_access": "Accès complet",+ "read_all": "Lecture de tout"+ },+ "secret_help": "Uniquement de serveur à serveur. Limitez chaque clé aux opérations dont elle a besoin.",+ "secret_section": "Clés secrètes",+ "subtitle": "Autorisez des intégrations et des applications à appeler l'API d'administration.",+ "table": {+ "all_channels": "All channels",+ "channel": "Channel",+ "key": "Clé",+ "last_used_at": "Dernière utilisation",+ "scopes": "Portées"+ },+ "title": "Clés API"+ },+ "custom_field_definitions": {+ "add_sheet_title": "Ajouter un champ personnalisé",+ "edit_sheet_title": "Modifier le champ personnalisé"+ },+ "emails": {+ "load_failed_title": "Impossible de charger les paramètres d'e-mail",+ "logo_dimensions_help": "Recommandé : 204 × 104 pixels.",+ "section_addresses": "Adresses e-mail",+ "section_delivery": "Distribution",+ "section_logo": "Logo",+ "subtitle": "Adresses d'expéditeur, notifications et logo intégré aux e-mails transactionnels.",+ "title": "Paramètres d'e-mail"+ },+ "imports": {+ "delete_confirm": {+ "message": "Cela supprime {{number}}, ses lignes et le fichier téléversé.",+ "title": "Supprimer l'import ?"+ },+ "empty_title": "Aucun import pour l'instant",+ "search_placeholder": "Rechercher par numéro…",+ "table": {+ "failed_count": "{{failed}} en échec",+ "number": "Numéro",+ "rows": "Lignes",+ "status": "Statut",+ "type": "Type"+ },+ "title": "Imports"+ },+ "markets": {+ "add_sheet_title": "Ajouter un marché",+ "edit_sheet_title": "Modifier le marché"+ },+ "payment_methods": {+ "add_sheet_title": "Ajouter un mode de paiement",+ "edit_sheet_title": "Modifier le mode de paiement"+ },+ "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…"+ },+ "store": {+ "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",+ "tab_storefront_access": "Accès à la vitrine",+ "title": "Paramètres de la boutique"+ },+ "tax_categories": {+ "add_sheet_title": "Ajouter une catégorie de taxe",+ "edit_sheet_title": "Modifier la catégorie de taxe"+ },+ "webhooks": {"actions": {- "send_test": "Envoyer un test","disable": "Désactiver","enable": "Réactiver",- "view_deliveries": "Voir les livraisons",- "redeliver": "Relivrer"+ "redeliver": "Relivrer",+ "send_test": "Envoyer un test",+ "view_deliveries": "Voir les livraisons"},- "status": {- "inactive": "Inactif",- "disabled": "Désactivé automatiquement",- "disabled_reason": "Désactivé : {{reason}}"+ "add_sheet_title": "Ajouter un point de terminaison de webhook",+ "delete_confirm": {+ "message": "{{name}} cessera immédiatement de recevoir des livraisons. L'historique des livraisons passées est également supprimé.",+ "title": "Supprimer le point de terminaison de webhook ?"},- "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"+ "deliveries": {+ "detail": {+ "copy_payload_aria": "Copier la charge utile de la requête",+ "copy_response_aria": "Copier le corps de la réponse",+ "delivered_at": "Livré le",+ "error_type": "Type d'erreur",+ "event": "Événement",+ "execution_time": "Temps d'exécution",+ "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.",+ "response_code": "Code de réponse",+ "url": "URL de destination"+ },+ "detail_sheet_title": "Détails de la livraison",+ "empty": "Aucune livraison pour le moment — envoyez un test pour vérifier votre point de terminaison.",+ "redeliver_queued": "Relivraison mise en file d'attente.",+ "search_placeholder": "Rechercher par nom d'événement…",+ "status": {+ "error": "Erreur",+ "failure": "Échouée",+ "pending": "En attente",+ "success": "Réussie"+ },+ "table": {+ "code": "Réponse",+ "delivered_at": "Livré le",+ "event": "Événement",+ "execution_time": "Durée"+ },+ "test_failed": "Échec de l'envoi du webhook de test.",+ "test_sent": "Webhook de test mis en file d'attente."},- "table": {- "url": "URL",- "events": "Événements",- "recent_deliveries": "7 derniers jours",- "last_delivery": "Dernière livraison",- "copy_url_aria": "Copier l'URL"+ "deliveries_sheet_title": "Livraisons récentes",+ "detail": {+ "delete_label": "Supprimer le point de terminaison",+ "details_title": "Détails",+ "edit_title": "Modifier le point de terminaison",+ "load_failed_title": "Impossible de charger ce point de terminaison de webhook",+ "subscriptions": "Événements",+ "url": "URL de destination"},- "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}}",+ "edit_sheet_title": "Modifier le point de terminaison de webhook",+ "empty_description": "Créez un point de terminaison pour recevoir un POST signé à chaque déclenchement d'un événement abonné.",+ "empty_title": "Aucun point de terminaison de webhook pour le moment","event_groups": {"asset": "Ressource","custom": "Personnalisé","customer": "Client","digital": "Numérique",+ "fulfillment": "Traitement des commandes","gift_card": "Carte cadeau","gift_card_batch": "Lot de cartes cadeaux","import_export": "Import / Export",@@ -1513,7 +2133,6 @@"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",@@ -1522,1214 +2141,716 @@"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.",+ "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}}",+ "health": {+ "auto_disabled_alert": "Ce point de terminaison a été automatiquement désactivé après des échecs de livraison répétés.",+ "degraded": "Dégradé ({{percentage}} %)",+ "disabled": "Désactivé",+ "failing": "En échec ({{percentage}} %)",+ "healthy": "Sain ({{percentage}} %)",+ "label": "État",+ "metric_failed": "Échouées",+ "metric_successful": "Réussies",+ "metric_total": "Livraisons",+ "no_deliveries": "Aucune livraison pour le moment",+ "re_enable_cta": "Réactiver",+ "row_counters_failed_one": "{{count}} échouée",+ "row_counters_failed_other": "{{count}} échouées",+ "row_counters_successful_one": "{{count}} réussie",+ "row_counters_successful_other": "{{count}} réussies"+ },+ "new_cta": "Nouveau point de terminaison",+ "save_secret_description": "Vérifiez les signatures des webhooks entrants avec cette clé. Nous ne l'afficherons plus.",+ "save_secret_title": "Enregistrez votre clé secrète de signature",+ "search_placeholder": "Rechercher par URL…",+ "status": {+ "disabled": "Désactivé automatiquement",+ "disabled_reason": "Désactivé : {{reason}}",+ "inactive": "Inactif"+ },+ "subtitle": "Abonnez des points de terminaison HTTPS aux événements déclenchés par votre boutique.","table": {- "key": "Clé",- "scopes": "Portées",- "last_used_at": "Dernière utilisation",- "channel": "Channel",- "all_channels": "All channels"+ "copy_url_aria": "Copier l'URL",+ "events": "Événements",+ "last_delivery": "Dernière livraison",+ "recent_deliveries": "7 derniers jours",+ "url": "URL"},- "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"- }+ "title": "Webhooks"+ }+ },+ "staff": {+ "actions": {+ "remove": "Retirer de l'équipe",+ "resend": "Renvoyer"},- "payment_methods": {- "add_sheet_title": "Ajouter un mode de paiement",- "edit_sheet_title": "Modifier le mode de paiement"+ "edit_sheet": {+ "title": "Modifier le collaborateur"},- "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"- },- "imports": {- "title": "Imports",- "search_placeholder": "Rechercher par numéro…",- "empty_title": "Aucun import pour l'instant",- "table": {- "number": "Numéro",- "type": "Type",- "status": "Statut",- "rows": "Lignes",- "failed_count": "{{failed}} en échec"- },- "delete_confirm": {- "title": "Supprimer l'import ?",- "message": "Cela supprime {{number}}, ses lignes et le fichier téléversé."- }- }- },- "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"- },- "getting_started": {- "title": "Premiers pas",- "description": "Terminez ces étapes pour lancer votre boutique.",- "progress": "{{done}} sur {{total}} terminées",- "tasks": {- "setup_payment_method": {- "title": "Configurer les moyens de paiement",- "description": "Pour encaisser des paiements, configurez au moins un prestataire de paiement en ligne.",- "cta": "Configurer les paiements"- },- "add_products": {- "title": "Ajouter des produits",- "description": "Ajoutez des produits à votre boutique — les vôtres, ou invitez des vendeurs tiers à vendre avec vous.",- "cta": "Ajouter des produits",- "import_cta": "Importer des produits depuis un CSV"- },- "set_customer_support_email": {- "title": "Définir l'e-mail du support client",- "description": "Affiché sur votre boutique comme point de contact pour les questions et le support client.",- "cta": "Paramètres e-mail"- },- "setup_taxes_collection": {- "title": "Configurer la collecte des taxes",- "description": "Pour collecter les taxes, configurez vos taux de taxe.",- "cta": "Paramètres des taxes"- },- "setup_storefront": {- "title": "Configurer la boutique",- "description": "Connectez votre boutique web ou votre application mobile avec vos identifiants Store API et enregistrez l'URL de votre boutique.",- "cta": "Connecter la boutique"- }- },- "storefront_sheet": {- "title": "Connecter votre boutique",- "description": "Utilisez ces identifiants dans tout client qui communique avec la Store API — boutique web, application mobile ou autre.",- "api_url_label": "URL de la Store API",- "publishable_key_label": "Clé API publiable",- "deploy_title": "Recommandé : déployer la boutique Next.js officielle",- "deploy_copy": "Le déploiement clone la boutique open-source sur votre compte Git et la construit sur Vercel avec vos identifiants préremplis. Une fois terminé, copiez son URL dans le champ ci-dessous.",- "deploy_button": "Déployer sur Vercel",- "env_description": "Votre URL de Store API Spree et votre clé publiable. Les deux sont préremplies depuis votre boutique — ajustez-les avant le déploiement si nécessaire.",- "storefront_url_label": "URL de la boutique",- "storefront_url_help": "L'URL que vos clients utilisent pour accéder à votre boutique. Elle sert de base aux liens dans les e-mails clients et est automatiquement ajoutée comme origine autorisée pour que les boutiques web puissent appeler la Store API.",- "save": "Enregistrer et terminer",- "saved": "URL de la boutique enregistrée : {{url}}",- "invalid_url": "Cela ne ressemble pas à une URL de boutique valide.",- "see_online_demo": "Voir la démo en ligne",- "local_installation_instructions": "Instructions d'installation locale",- "key_error": "Impossible de charger votre clé API publiable.",- "storefront_url_placeholder": "https://myshop.com"- }- }- },- "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",- "validation": {- "role_required": "Choisissez un rôle",- "roles_required": "Choisissez au moins un rôle"- }- },- "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."+ "empty": "Aucun membre pour le moment",+ "empty_description": "Invitez un collaborateur à participer à cette boutique.",+ "invitations_section": "Invitations en attente",+ "invite_cta": "Inviter un collaborateur",+ "invite_sheet": {+ "description": "Nous lui enverrons par e-mail un lien pour définir son mot de passe.",+ "title": "Inviter un collaborateur"},- "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."+ "members_section": "Membres",+ "messages": {+ "removed": "Retiré de l'équipe",+ "revoked": "Invitation révoquée",+ "updated": "Équipe mise à jour"},+ "subtitle": "Gérez les collaborateurs et les rôles d'administration","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."+ "member": "Membre",+ "role": "Rôle",+ "roles": "Rôles"},- "groups": {- "title": "Groupes de clients",- "empty": "Dans aucun groupe",- "edit_title": "Modifier les groupes de clients",- "edit_description": "Ajoutez ou retirez les groupes auxquels ce client appartient.",- "save_failed": "Échec de la mise à jour des groupes de clients"- }- },- "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"+ "title": "Équipe"}},- "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.",- "code_placeholder": "GIFT-XXXX-YYYY"- },- "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"+ "payment_methods": {+ "add_cta": "Ajouter un moyen de paiement",+ "columns": {+ "storefront": "Boutique"},- "table": {- "search_placeholder": "Rechercher des commandes…",- "empty": "Aucune commande trouvée"+ "create_description": "Choisissez un fournisseur et configurez ses identifiants.",+ "create_label": "Créer un moyen de paiement",+ "delete_confirm": {+ "message": "{{name}} ne sera plus disponible au paiement.",+ "title": "Supprimer le moyen de paiement ?"},- "columns": {- "number": "Numéro",- "date": "Date",- "customer": "Client",- "payment": "Paiement",- "fulfillment": "Traitement",- "items": "Articles",- "tags": "Étiquettes",- "sku": "SKU"+ "edit_description": "Mettez à jour le nom, la visibilité ou le statut.",+ "empty": "Aucun moyen de paiement configuré",+ "messages": {+ "created": "Moyen de paiement créé",+ "deleted": "Moyen de paiement supprimé",+ "updated": "Moyen de paiement mis à jour"},- "item_count_one": "{{count}} article",- "item_count_other": "{{count}} articles",- "statuses": {- "draft": "Brouillon",- "placed": "Passée",- "canceled": "Annulée"+ "provider_description": "Fournisseur : {{provider}}",+ "search_placeholder": "Rechercher par nom…",+ "status": {+ "disabled": "Désactivé"},- "payment_statuses": {- "balance_due": "Solde dû",- "credit_owed": "Crédit dû",- "failed": "Échouée",- "paid": "Payée",- "void": "Annulée"+ "storefront": {+ "admin_only": "Administration uniquement",+ "visible": "Visible"},- "fulfillment_statuses": {- "backorder": "Commande en attente",- "canceled": "Annulé",- "partial": "Partiel",- "pending": "En attente",- "ready": "Prêt",- "fulfilled": "Traité"- }+ "title": "Moyens de paiement"+ },+ "preferences": {+ "additional_item": "Coût de chaque article supplémentaire",+ "amount": "Montant",+ "base_amount": "Montant de base",+ "base_percent": "Pourcentage de base",+ "currency": "Devise",+ "discount_amount": "Montant de la remise",+ "first_item": "Coût du premier article",+ "flat_percent": "Pourcentage fixe",+ "max_items": "Nombre maximal d'articles",+ "max_quantity": "Quantité maximale",+ "min_quantity": "Quantité minimale",+ "minimal_amount": "Montant minimal",+ "normal_amount": "Montant normal",+ "percent": "Pourcentage",+ "preferred_amount": "Montant",+ "preferred_percent": "Pourcentage"},"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",+ "columns": {+ "in_stock": "En stock",+ "price": "Prix",+ "sku": "SKU"+ },+ "delete_confirm": "Voulez-vous vraiment supprimer ce produit ?",+ "delete_label": "Supprimer le produit",+ "inventory": {+ "backorder_aria": "Autoriser le réassort à {{location}}",+ "columns": {+ "backorder": "Réassort",+ "location": "Emplacement",+ "on_hand": "En stock"+ },+ "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.",+ "on_hand_aria": "En stock à {{location}}",+ "unknown_location": "Emplacement inconnu"+ },"media": {+ "assigned_variants_help": "Sélectionnez les variantes que cette image représente. Laissez vide pour l'appliquer à toutes les variantes.",+ "assigned_variants_label": "Variantes associées","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.",+ "file_types_hint": "PNG, JPG, WebP jusqu'à 10 Mo","upload_failed": "Échec du téléversement de {{name}} : {{message}}","upload_status_failed": "Échec"},+ "no_categories_found": "Aucune catégorie trouvée",+ "options": {+ "add_cta": "Ajouter un type d'option",+ "count_one": "{{count}} valeur",+ "count_other": "{{count}} valeurs",+ "create_description": "Définissez une option que les variantes peuvent utiliser (par ex. taille, couleur).",+ "create_label": "Créer un type d'option",+ "delete_confirm": {+ "message": "Cela supprimera également toutes ses valeurs. Les variantes utilisant ces valeurs les perdront.",+ "title": "Supprimer le type d'option ?"+ },+ "edit_description": "Modifiez le type d'option et ses valeurs.",+ "image_upload_failed": "Échec du téléversement de l'image",+ "kinds": {+ "buttons": "Boutons",+ "color_swatch": "Nuancier de couleurs",+ "dropdown": "Liste déroulante"+ },+ "value_label_placeholder": "par ex. Petit",+ "value_name_placeholder": "par ex. small",+ "values_help": "Faites glisser les valeurs pour les réorganiser. La première valeur est celle par défaut pour les nouvelles variantes."+ },+ "price_lists": {+ "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"+ },+ "messages": {+ "activated": "Liste de prix activée",+ "created": "Liste de prix créée",+ "deactivated": "Liste de prix désactivée",+ "deleted": "Liste de prix supprimée",+ "updated": "Liste de prix mise à jour"+ },+ "validation": {+ "ends_after_starts": "Doit être postérieur à la date de début."+ }+ },+ "save_label": "Enregistrer le produit","seo": {- "slug_placeholder": "url-du-produit",+ "meta_description_placeholder": "Description SEO","meta_title_placeholder": "Titre SEO",- "meta_description_placeholder": "Description SEO"+ "slug_placeholder": "url-du-produit"},"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)",+ "delete_confirm": {+ "message": "Les mouvements de stock créés par ce transfert seront annulés.",+ "title": "Supprimer ce transfert ?"+ },"destination_placeholder": "Sélectionner l'emplacement de destination",+ "details_card": "Détails","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)…",+ "external_label": "Externe (réception fournisseur)",+ "fields": {+ "created": "Créé le",+ "external_receive": "Réception externe",+ "immutable_note": "Les transferts de stock sont immuables une fois créés.",+ "internal": "Interne",+ "reference": "Référence",+ "type": "Type"+ },"items_table": {- "variant": "Variante",+ "qty": "Qté","sku": "SKU",- "qty": "Qté"+ "variant": "Variante"+ },+ "new_cta": "Nouveau transfert",+ "reference_label": "Référence",+ "reference_placeholder": "Numéro de bon de commande, facture fournisseur, …",+ "review_description": "Vérifiez le transfert avant de le créer. Les articles ne pourront plus être modifiés ensuite.",+ "search_items_placeholder": "Rechercher par nom ou SKU (3 caractères ou plus)…"+ },+ "variant_media_picker": {+ "add_count_one": "Ajouter {{count}}",+ "add_count_other": "Ajouter {{count}}",+ "empty_all_linked": "Tous les médias produit sont déjà liés à cette variante.",+ "empty_no_media": "Aucun média produit — téléversez d’abord des images sur le produit.",+ "title": "Sélectionner dans la galerie produit",+ "trigger": "Sélectionner dans la galerie produit"+ },+ "variants": {+ "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",+ "default_variant": "Variante par défaut",+ "edit_row_aria": "Modifier {{name}}",+ "edit_variant": "Modifier la variante — {{name}}",+ "errors": {+ "failed_to_create_option_type": "Impossible de créer le type d’option",+ "failed_to_create_value": "Impossible de créer la valeur"+ },+ "keep": "Tout conserver",+ "option_type_label": "Type d'option",+ "option_type_placeholder": "Choisissez un type d'option",+ "orphan_warning": "{{count}} variante(s) existante(s) seront supprimées à l'enregistrement :",+ "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 :",+ "remove_row_aria": "Retirer {{name}}",+ "sheet": {+ "availability": "Disponibilité",+ "identity": "Identité",+ "tax_category_placeholder": "Hériter du produit"+ },+ "title": "Variantes",+ "variant_label": "Variante"+ }+ },+ "promotions": {+ "action_edit": {+ "description": "Configurez les paramètres de l'action.",+ "no_options": "Cette action n'a aucune option configurable."+ },+ "action_picker": {+ "description": "Choisissez ce qui doit se passer lorsque la promotion s'applique.",+ "title": "Ajouter une action"+ },+ "action_summary": {+ "variant_count": "{{count}} variantes"+ },+ "action_types": {+ "create_adjustment": {+ "description": "Crée un ajustement de crédit promotionnel sur la commande",+ "name": "Créer un ajustement sur l'ensemble de la commande"+ },+ "create_item_adjustments": {+ "description": "Crée un ajustement de crédit promotionnel sur une ligne d'article",+ "name": "Créer un ajustement par ligne d'article"+ },+ "create_line_items": {+ "description": "Ajoute au panier la quantité spécifiée de la variante",+ "name": "Créer des lignes d'article"+ },+ "free_shipping": {+ "description": "Rend gratuites toutes les expéditions de la commande",+ "name": "Livraison gratuite"+ }+ },+ "actions_card": {+ "add_action": "Ajouter une action",+ "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."+ },+ "basics_card": {+ "title": "Informations de base"+ },+ "code": {+ "automatic": "Automatique",+ "multi": "multi"+ },+ "coupon_codes": {+ "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.",+ "export_csv": "Exporter en CSV",+ "states": {+ "partially_used": "Partiellement utilisé",+ "used": "Utilisé"+ },+ "title": "Codes de coupon",+ "unused": "Inutilisé",+ "used": "Utilisé"+ },+ "delete_confirm": {+ "default_name": "Cette 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.",+ "title": "Supprimer la promotion ?"+ },+ "errors": {+ "failed_to_add_action": "Échec de l'ajout de l'action",+ "failed_to_add_rule": "Échec de l'ajout de la règle",+ "failed_to_remove_action": "Échec de la suppression de l'action",+ "failed_to_remove_rule": "Échec de la suppression de la règle",+ "failed_to_update_action": "Échec de la mise à jour de l'action",+ "failed_to_update_rule": "Échec de la mise à jour de la règle"+ },+ "generate_code": {+ "title": "Générer un code aléatoire"+ },+ "kinds": {+ "automatic": "Automatique (sans code)",+ "coupon_code": "Code de réduction"+ },+ "match_policies": {+ "all": "Toutes les règles doivent correspondre",+ "all_hint": "Toutes les règles doivent correspondre.",+ "any": "Au moins une règle doit correspondre",+ "any_hint": "Au moins une règle doit correspondre."+ },+ "messages": {+ "action_added": "Action ajoutée",+ "action_removed": "Action supprimée",+ "action_updated": "Action mise à jour",+ "rule_added": "Règle ajoutée",+ "rule_removed": "Règle supprimée",+ "rule_updated": "Règle mise à jour"+ },+ "remove_action_confirm": {+ "message": "Supprimée lorsque vous enregistrez la promotion.",+ "title": "Supprimer l'action ?"+ },+ "remove_rule_confirm": {+ "message": "Supprimée lorsque vous enregistrez la promotion.",+ "title": "Supprimer la règle ?"+ },+ "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."+ },+ "rule_picker": {+ "description": "Choisissez un type de règle à configurer.",+ "title": "Ajouter une règle"+ },+ "rule_summary": {+ "category_count": "{{count}} catégories",+ "customer_count": "{{count}} clients",+ "product_count": "{{count}} produits"+ },+ "rule_types": {+ "category": {+ "description": "La commande contient des produits des catégories spécifiées",+ "name": "Catégories"+ },+ "country": {+ "description": "Limiter aux commandes dont l'adresse de livraison se trouve dans un pays spécifique",+ "name": "Pays"+ },+ "currency": {+ "description": "Limiter aux commandes dans une devise spécifique",+ "name": "Devise"+ },+ "customer": {+ "description": "Disponible uniquement pour les clients spécifiés",+ "name": "Clients"+ },+ "customer_group": {+ "description": "Disponible uniquement pour les clients des groupes de clients spécifiés",+ "name": "Groupe(s) de clients"+ },+ "customer_logged_in": {+ "description": "Disponible uniquement pour les clients connectés",+ "name": "Uniquement les clients connectés"+ },+ "first_order": {+ "description": "Doit être la première commande du client",+ "name": "Première commande"+ },+ "item_total": {+ "description": "Le total de la commande répond à ces critères",+ "name": "Total des articles"},- "delete_confirm": {- "title": "Supprimer ce transfert ?",- "message": "Les mouvements de stock créés par ce transfert seront annulés."+ "one_use_per_user": {+ "description": "Une seule utilisation par utilisateur",+ "name": "Une utilisation par utilisateur"},- "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."+ "option_value": {+ "description": "La commande contient des produits avec des valeurs d'option correspondantes",+ "name": "Valeur(s) d'option"+ },+ "product": {+ "description": "La commande contient le(s) produit(s) spécifié(s)",+ "name": "Produit(s)"}},- "options": {- "kinds": {- "dropdown": "Liste déroulante",- "color_swatch": "Nuancier de couleurs",- "buttons": "Boutons"+ "rule_types_all_used": "Tous les types de règle disponibles sont déjà appliqués à cette promotion.",+ "rule_types_empty": "Aucun type de règle enregistré.",+ "rules": {+ "category": {+ "empty": "Aucune catégorie ne correspond",+ "label": "Catégories",+ "match_policy": {+ "all": {+ "description": "La commande doit contenir un produit dans chaque catégorie.",+ "label": "Toutes ces catégories"+ },+ "any": {+ "description": "La commande doit contenir un produit appartenant à au moins une.",+ "label": "L'une de ces catégories"+ }+ },+ "search_placeholder": "Rechercher des catégories…"},- "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."+ "channel": {+ "label": "Canaux"},- "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é",- "availability": "Disponibilité",- "tax_category_placeholder": "Hériter du produit"+ "country": {+ "empty": "Aucun pays ne correspond",+ "label": "Pays",+ "search_placeholder": "Rechercher des pays…"},- "errors": {- "failed_to_create_value": "Impossible de créer la valeur",- "failed_to_create_option_type": "Impossible de créer le type d’option"- }- },- "inventory": {- "columns": {- "location": "Emplacement",- "on_hand": "En stock",- "backorder": "Réassort"+ "customer": {+ "empty": "Aucun client ne correspond",+ "label": "Clients",+ "search_placeholder": "Rechercher des clients par nom ou e-mail…"},- "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.",- "unknown_location": "Emplacement inconnu"- },- "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"+ "customer_group": {+ "empty": "Aucun groupe de clients ne correspond",+ "label": "Groupes de clients",+ "search_placeholder": "Rechercher des groupes de clients…"},- "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"+ "market": {+ "label": "Marchés"},- "validation": {- "ends_after_starts": "Doit être postérieur à la date de début."+ "product": {+ "empty": "Aucun produit ne correspond",+ "label": "Produits",+ "match_policy": {+ "all": {+ "description": "La commande doit contenir chaque produit.",+ "label": "Tous ces produits"+ },+ "any": {+ "description": "La commande doit en contenir au moins un.",+ "label": "L'un de ces produits"+ },+ "none": {+ "description": "La commande ne doit en contenir aucun.",+ "label": "Aucun de ces produits"+ }+ },+ "search_placeholder": "Rechercher des produits par nom…"}},- "variant_media_picker": {- "trigger": "Sélectionner dans la galerie produit",- "title": "Sélectionner dans la galerie produit",- "empty_no_media": "Aucun média produit — téléversez d’abord des images sur le produit.",- "empty_all_linked": "Tous les médias produit sont déjà liés à cette variante.",- "add_count_one": "Ajouter {{count}}",- "add_count_other": "Ajouter {{count}}"- }- },- "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."+ "rules_card": {+ "add_rule": "Ajouter une règle",+ "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).",+ "title": "Règles"},- "title": "Moyens de paiement",- "search_placeholder": "Rechercher par nom…",- "empty": "Aucun moyen de paiement configuré",- "columns": {- "storefront": "Boutique"+ "schedule_card": {+ "title": "Planification et limites"},- "storefront": {- "visible": "Visible",- "admin_only": "Administration uniquement"+ "table": {+ "empty": "Aucune promotion pour le moment",+ "no_end": "Sans fin",+ "search_placeholder": "Rechercher par nom…"},- "status": {- "disabled": "Désactivé"+ "trigger_card": {+ "title": "Déclencheur"},- "messages": {- "created": "Moyen de paiement créé",- "updated": "Moyen de paiement mis à jour",- "deleted": "Moyen de paiement supprimé"+ "trigger_summary": {+ "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.",+ "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 :"+ },+ "validation": {+ "code_required": "Le code est requis (ou cliquez sur Générer)",+ "expiry_after_start": "La date d'expiration doit être postérieure à la date de début",+ "number_of_codes_required": "Choisissez le nombre de codes à générer",+ "prefix_required": "Le préfixe est requis pour les lots de plusieurs codes"}},- "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"+ "settings": {+ "webhooks": {+ "errors": {+ "redeliver_failed": "Échec de la nouvelle livraison",+ "send_test_failed": "Échec de l'envoi du webhook de test"+ },+ "messages": {+ "removed": "Point de terminaison webhook supprimé",+ "updated": "Point de terminaison webhook mis à jour"+ }}},- "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é"+ "settings_nav": {+ "groups": {+ "audit": "Audit",+ "fulfillment": "Traitement des commandes",+ "payments": "Paiements et taxes",+ "store": "Boutique",+ "team": "Équipe et accès"},- "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é"+ "items": {+ "allowed_origins": "Origines autorisées",+ "api_keys": "Clés API",+ "channels": "Canaux de vente",+ "custom_field_definitions": "Champs personnalisés",+ "delivery_methods": "Méthodes de livraison",+ "delivery_zones": "Zones de livraison",+ "emails": "E-mails",+ "imports": "Imports",+ "markets": "Marchés",+ "payment_methods": "Modes de paiement",+ "profile": "Profil",+ "staff": "Personnel",+ "stock_locations": "Emplacements de stock",+ "store": "Boutique",+ "tax_categories": "Catégories de taxe",+ "webhooks": "Webhooks"}},- "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"+ "staff": {+ "actions": {+ "copy_invitation_link": "Copier le lien d'invitation",+ "invitation_link_copied": "Lien d'invitation copié"},- "delete_confirm": {- "title": "Supprimer le champ personnalisé ?",- "message": "{{label}} sera supprimé, ainsi que toutes les valeurs qui y sont enregistrées."+ "actions_aria": "Actions",+ "autocomplete": {+ "empty": "Aucun membre du personnel correspondant",+ "placeholder": "Rechercher du personnel…"},- "messages": {- "created": "Champ personnalisé créé",- "updated": "Champ personnalisé mis à jour",- "deleted": "Champ personnalisé supprimé"+ "confirm": {+ "remove_message": "{{name}} perdra l'accès à cette boutique.",+ "remove_title": "Retirer de la boutique ?",+ "revoke_message": "{{email}} ne pourra plus accepter cette invitation.",+ "revoke_title": "Révoquer l'invitation ?"+ },+ "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.","errors": {- "failed_to_create": "Impossible de créer le champ personnalisé",- "failed_to_update": "Impossible de mettre à jour le champ personnalisé",- "failed_to_delete": "Impossible de supprimer le champ personnalisé"- }- },- "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"+ "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"},- "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."+ "invite": {+ "email_placeholder": "[email protected]",+ "no_roles": "Aucun rôle disponible.",+ "roles_loading": "Chargement des rôles…",+ "roles_placeholder": "Sélectionner un rôle"},+ "validation": {+ "role_required": "Choisissez un rôle",+ "roles_required": "Choisissez au moins un rôle"+ }+ },+ "stock_items": {"messages": {- "added": "Origine autorisée ajoutée",- "updated": "Origine autorisée mise à jour",- "removed": "Origine autorisée supprimée"+ "stock_item_deleted": "Article en stock supprimé",+ "stock_updated": "Stock mis à jour"}},"stock_locations": {"add_cta": "Ajouter un emplacement de stock",- "create_label": "Créer un emplacement de stock",+ "badges": {+ "default": "Par défaut",+ "enabled": "Activé",+ "inactive": "Inactif"+ },+ "columns": {+ "default": "Par défaut",+ "location": "Emplacement",+ "pickup": "Retrait",+ "type": "Type"+ },"create_description": "Ajoutez un entrepôt, un magasin ou un point de retrait pour traiter les commandes.",+ "create_label": "Créer un emplacement de stock",+ "delete_confirm": {+ "message": "{{name}} sera supprimé. Les articles en stock à cet emplacement ne sont pas supprimés.",+ "title": "Supprimer l'emplacement de stock ?"+ },"edit_description": "Mettez à jour le nom, l'adresse, le retrait ou les politiques de stock.",+ "empty": "Aucun emplacement de stock pour le moment","kinds": {- "warehouse": "Entrepôt",+ "fulfillment_center": "Centre de distribution","store": "Magasin",- "fulfillment_center": "Centre de distribution"+ "warehouse": "Entrepôt"},"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."+ "any": "Autoriser les transferts depuis d'autres emplacements",+ "local": "Uniquement les articles à cet emplacement"},+ "search_placeholder": "Rechercher par nom…","section_pickup": "Retrait","stock_items": {- "title": "Stock à cet emplacement",+ "empty": "Aucun article en stock à cet emplacement pour le moment.",+ "empty_search": "Aucun article en stock ne correspond à votre recherche.","help": "Ajustez les quantités disponibles et en réassort par variante.",+ "low_stock_marker": "stock faible","search_placeholder": "Rechercher un SKU ou un produit…","table": {- "variant": "Variante",+ "backorder": "Réassort","on_hand": "Disponible",- "backorder": "Réassort"+ "variant": "Variante"},- "empty": "Aucun article en stock à cet emplacement pour le moment.",- "empty_search": "Aucun article en stock ne correspond à votre recherche.",+ "title": "Stock à cet emplacement","unknown_product": "Produit inconnu","variant_count_one": "{{count}} variante",- "variant_count_other": "{{count}} variantes",- "low_stock_marker": "stock faible"- },- "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é"+ "variant_count_other": "{{count}} variantes"}},"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",+ "number": "Numéro","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é"+ "external_receive": "Réception externe",+ "internal": "Transfert entre emplacements"},"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",- "min_quantity": "Quantité minimale",- "max_quantity": "Quantité maximale"- },- "channels": {- "messages": {- "created": "Canal créé",- "updated": "Canal mis à jour",- "deleted": "Canal supprimé"- }- },- "order_routing_rules": {- "messages": {- "created": "Règle de routage ajoutée",- "deleted": "Règle de routage supprimée"+ "failed_to_delete": "Échec de la suppression du transfert de stock",+ "failed_to_record": "Échec de l'enregistrement du transfert de stock"},- "types": {- "preferred_location": {- "name": "Lieu de stock préféré",- "description": "Expédier depuis le lieu épinglé sur la commande, s'il est défini"- },- "minimize_splits": {- "name": "Minimiser les envois fractionnés",- "description": "Privilégie le lieu capable d'expédier le plus d'articles à lui seul, évitant les envois fractionnés"- },- "default_location": {- "name": "Lieu de stock par défaut",- "description": "Privilégie le lieu de stock marqué comme défaut"- }- }- },- "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"+ "deleted": "Transfert de stock supprimé",+ "recorded": "Transfert de stock enregistré"},- "autocomplete": {- "placeholder": "Rechercher des groupes de clients…",- "empty": "Aucun groupe de clients correspondant"- }+ "table": {+ "empty": "Aucun transfert de stock pour le moment",+ "search_placeholder": "Rechercher par numéro ou référence…"+ },+ "title": "Transferts de stock"},- "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"- }+ "store": {+ "load_failed_title": "Échec du chargement des paramètres de la boutique",+ "unit_systems": {+ "imperial": "Impérial",+ "metric": "Métrique"+ },+ "weight_units": {+ "g": "Gramme (g)",+ "kg": "Kilogramme (kg)",+ "lb": "Livre (lb)",+ "oz": "Once (oz)"}},- "stock_items": {+ "tax_categories": {+ "add_cta": "Ajouter une catégorie de taxe",+ "create_description": "Regroupez les produits par traitement fiscal (standard, réduit, exonéré, …).",+ "create_label": "Créer une catégorie de taxe",+ "delete_confirm": {+ "message": "{{name}} sera supprimée. Les produits de cette catégorie reviendront à la catégorie par défaut.",+ "title": "Supprimer la catégorie de taxe ?"+ },+ "edit_description": "Modifiez le nom, le code ou l'indicateur par défaut.",+ "empty": "Aucune catégorie de taxe pour le moment","messages": {- "stock_updated": "Stock mis à jour",- "stock_item_deleted": "Article en stock supprimé"- }+ "created": "Catégorie de taxe créée",+ "deleted": "Catégorie de taxe supprimée",+ "updated": "Catégorie de taxe mise à jour"+ },+ "search_placeholder": "Rechercher par nom…"},"translations": {- "title": "Traductions",- "locale": "Langue",- "source": "Source",- "save": "Enregistrer les traductions",- "saved": "Traductions enregistrées",- "save_error": "Impossible d enregistrer les traductions",- "no_locales": "Ajoutez d autres langues à votre boutique pour traduire ce produit.",- "manage": "Gérer les traductions",- "field": "Champ","coverage_summary": "{{translated}} sur {{total}} langues traduites","dirty_summary": "{{count}} modification(s) non enregistrée(s)","discard_confirm": {- "title": "Annuler les modifications ?",- "message": "Vous avez {{count}} modification(s) de traduction non enregistrée(s). Les annuler ?"+ "message": "Vous avez {{count}} modification(s) de traduction non enregistrée(s). Les annuler ?",+ "title": "Annuler les modifications ?"},+ "field": "Champ",+ "load_error": "Impossible de charger les traductions",+ "locale": "Langue",+ "manage": "Gérer les traductions",+ "no_locales": "Ajoutez d autres langues à votre boutique pour traduire ce produit.","original": "Original",- "load_error": "Impossible de charger les traductions"- },- "categories": {- "title": "Catégories",- "add_cta": "Nouvelle catégorie",- "empty": "Aucune catégorie pour le moment.",- "expand": "Développer",- "collapse": "Réduire",- "delete_confirm": "Supprimer la catégorie « {{name}} » et toutes ses sous-catégories ?",- "columns": {- "name": "Nom",- "products": "Produits"- },- "fields": {- "parent": {- "label": "Catégorie parente",- "placeholder": "Niveau supérieur"- }- },- "messages": {- "created": "Catégorie créée",- "updated": "Catégorie mise à jour",- "deleted": "Catégorie supprimée",- "move_failed": "Impossible de déplacer la catégorie"- },- "seo": {- "title": "Optimisation pour les moteurs de recherche",- "preview_slug_placeholder": "slug-categorie"- },- "products_count_one": "{{count}} produit",- "products_count_other": "{{count}} produits",- "search_placeholder": "Rechercher des catégories…",- "no_results": "Aucune catégorie ne correspond.",- "new_title": "Nouvelle catégorie",- "delete_label": "Supprimer la catégorie",- "images": {- "title": "Images",- "label": "Image",- "square_label": "Image carrée",- "help": "Utilisée dans les bannières de catégorie. Recommandé 1920×1080.",- "square_help": "Utilisée dans la navigation compacte. Recommandé 400×400."- },- "navigation": {- "title": "Navigation"- },- "products": {- "title": "Produits",- "search_placeholder": "Rechercher des produits…",- "empty": "Aucun produit dans cette catégorie pour le moment.",- "remove": "Retirer de la catégorie",- "add_cta": "Ajouter des produits",- "picker_title": "Ajouter des produits à la catégorie",- "picker_description": "Recherchez et sélectionnez des produits à ajouter à cette catégorie.",- "select_all": "Tout sélectionner",- "select_row": "Sélectionner le produit",- "remove_selected": "Retirer",- "selected_count_one": "{{count}} sélectionné",- "selected_count_other": "{{count}} sélectionnés",- "column_product": "Produit",- "filter_placeholder": "Filtrer les produits…",- "no_matches": "Aucun produit ne correspond au filtre."- },- "load_failed": "Échec du chargement des catégories. Veuillez réessayer."- },- "imports": {- "download_original": "Télécharger le fichier d'origine",- "load_failed": "Impossible de charger l'import.",- "try_again": "Réessayer",- "wizard_title": "Import",- "steps": {- "map_fields": "Associer les champs",- "process_rows": "Traiter les lignes",- "complete": "Terminé"- },- "status": {- "pending": "En attente",- "mapping": "Association",- "completed_mapping": "En file",- "processing": "En cours",- "completed": "Terminé",- "failed": "Échoué"- },- "types": {- "products": "Produits",- "customers": "Clients",- "product_translations": "Traductions de produits"- },- "mapping": {- "title": "Associer les colonnes",- "description": "Associez les colonnes de votre fichier aux champs {{type}}.",- "field": "Champ",- "file_column": "Colonne du fichier",- "sample": "Exemple",- "not_mapped": "Non associée",- "required": "Requis",- "missing_required": "Associez les champs requis pour continuer : {{fields}}",- "start": "Lancer l'import",- "starting": "Lancement…"- },- "processing": {- "title": "Traitement des lignes",- "preparing": "Préparation des lignes…",- "progress": "{{processed}} lignes traitées sur {{total}}",- "failed_count": "{{failed}} en échec",- "retrying": "Nouvelle tentative des lignes en échec · {{remaining}} restantes",- "note": "Vous pouvez quitter cette page — l'import continue en arrière-plan."- },- "results": {- "completed_title": "Import terminé",- "summary": "{{completed}} lignes importées · {{failed}} en échec",- "retry_failed": "Réessayer les lignes en échec ({{failed}})",- "retrying": "Nouvelle tentative…",- "view_records": "Voir {{type}}"- },- "failed": {- "title": "Échec de l'import",- "description": "Le fichier n'a pas pu être traité."- },- "failed_rows": {- "next_page": "Page suivante",- "prev_page": "Page précédente",- "title": "Lignes en échec",- "row_number": "Ligne",- "error": "Erreur",- "view_data": "Voir les données",- "hide_data": "Masquer les données"- }+ "save": "Enregistrer les traductions",+ "save_error": "Impossible d enregistrer les traductions",+ "saved": "Traductions enregistrées",+ "source": "Source",+ "title": "Traductions"}}}diff --git a/packages/dashboard/src/locales/pl.json b/packages/dashboard/src/locales/pl.jsonindex 3f7b878a1b..5abcf3168e 100644--- a/packages/dashboard/src/locales/pl.json+++ b/packages/dashboard/src/locales/pl.json@@ -1,631 +1,843 @@{"admin": {"a11y": {- "edit_media": "Edytuj obraz",- "delete_image": "Usuń obraz"+ "delete_image": "Usuń obraz",+ "edit_media": "Edytuj 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"+ "allowed_origins": {+ "add_cta": "Dodaj dozwolone ź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łą.",+ "create_label": "Dodaj źródło",+ "delete_confirm": {+ "message": "{{origin}} nie będzie już mogło wywoływać API administratora z przeglądarki. Istniejące żądania serwer–serwer nie zostaną naruszone.",+ "title": "Usunąć dozwolone źródło?"},+ "edit_description": "Aktualizacja źródła natychmiast zmienia, kto może wywoływać API administratora z przeglądarki.",+ "empty": "Brak dozwolonych źródeł","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"- }- },- "errors": {- "not_found_title": "Nie znaleziono strony",- "not_found_description": "Strona, której szukasz, nie istnieje.",- "forbidden_title": "Brak uprawnień",- "forbidden_description": "Nie masz uprawnień do wyświetlenia tej strony.",- "plugin_route_title": "Nie udało się wyświetlić tej strony"- },- "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",- "getting_started": "Pierwsze kroki"- },- "settings_nav": {- "groups": {- "store": "Sklep",- "payments": "Płatności i podatki",- "fulfillment": "Realizacja zamówień",- "team": "Zespół i dostęp",- "audit": "Audyt"+ "added": "Dodano dozwolone źródło",+ "removed": "Usunięto dozwolone źródło",+ "updated": "Zaktualizowano dozwolone źródło"},- "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",- "imports": "Importy"+ "search_placeholder": "Szukaj według źródła…",+ "table_title": "Dozwolone źródła",+ "validation": {+ "bare_origin": "Musi być samym źródłem (np. https://shop.example.com) — bez ścieżki, parametrów zapytania ani fragmentu"}},- "fields": {- "products_count": {- "label": "Produkty"+ "api_keys": {+ "badge": {+ "never_used": "Nigdy",+ "revoked": "Unieważniony"},- "prices_count": {- "label": "Ceny"+ "by_email": "przez {{email}}",+ "create_key_cta": "Utwórz klucz",+ "create_sheet_description": "Wybierz typ klucza, a następnie zakresy, których może używać.",+ "create_sheet_title": "Utwórz klucz API",+ "delete_confirm": {+ "message": "Spowoduje to trwałe usunięcie klucza. Jeśli możesz chcieć przywrócić dostęp później, lepiej unieważnij klucz.",+ "title": "Usunąć klucz?"},- "customer_id": {- "label": "Klient"+ "dropdown": {+ "copy_token_aria": "Kopiuj token",+ "revoke": "Unieważnij klucz"},- "role_id": {- "label": "Rola"+ "edit_sheet_description": "Zmień nazwę tego klucza. Zakresy są ustalane przy tworzeniu klucza i nie można ich zmienić.",+ "edit_sheet_title": "Edytuj klucz API",+ "empty_description": "Utwórz klucz, aby rozpocząć.",+ "errors": {+ "failed_to_create": "Nie udało się utworzyć klucza",+ "failed_to_delete": "Nie udało się usunąć klucza",+ "failed_to_update": "Nie udało się zaktualizować klucza"},- "role_ids": {- "label": "Role"+ "key_type": {+ "publishable_description": "Bezpieczny do użycia w kodzie po stronie klienta. Zapewnia dostęp publiczny/gościa.",+ "publishable_title": "Klucz publiczny",+ "secret_description": "Komunikacja serwer-serwer. Każdy klucz zawiera jawną listę zakresów.",+ "secret_title": "Klucz tajny"},- "tax_category_id": {- "label": "Kategoria podatkowa"+ "revoke_confirm": {+ "message": "Każda integracja używająca tego klucza natychmiast przestanie działać.",+ "title": "Unieważnić klucz?"},- "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ń"+ "scope_picker": {+ "full_access_hint": "– odczyt + zapis dla każdego zasobu",+ "full_access_label": "Pełny dostęp (write_all)",+ "read_all_hint": "– odczyt dla każdego zasobu",+ "read_all_label": "Odczyt wszystkiego (read_all)",+ "read_aria": "Odczyt: {{resource}}",+ "read_header": "Odczyt",+ "resource_header": "Zasób",+ "resources": {+ "api_keys": "Klucze API",+ "categories": "Kategorie",+ "customers": "Klienci",+ "dashboard": "Panel",+ "fulfillments": "Realizacje",+ "gift_cards": "Karty podarunkowe",+ "orders": "Zamówienia",+ "payments": "Płatności",+ "products": "Produkty",+ "promotions": "Promocje",+ "refunds": "Zwroty pieniędzy",+ "settings": "Ustawienia",+ "stock": "Stan magazynowy",+ "store_credits": "Środki w sklepie",+ "webhooks": "Webhooki"},- "match_policy": {- "label": "Reguła dopasowania"- }+ "show_more_aria_few": "Pokaż {{count}} dodatkowe zakresy",+ "show_more_aria_many": "Pokaż {{count}} dodatkowych zakresów",+ "show_more_aria_one": "Pokaż {{count}} dodatkowy zakres",+ "show_more_aria_other": "Pokaż {{count}} dodatkowych zakresów",+ "write_aria": "Zapis: {{resource}}",+ "write_header": "Zapis"},- "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::Taxon": "Kategorie",- "Spree::OptionType": "Typy opcji"- }- },- "storefront_visible": {- "label": "Widoczne w sklepie",- "column_label": "Sklep"- },- "searchable": {- "label": "Przeszukiwalne",- "help": "Uwzględnij wartości w wyszukiwaniu produktów storefront (tylko krótki tekst, długi tekst i liczba). Po włączeniu z Meilisearch uruchom rake spree:search:reindex, aby zaktualizować istniejące produkty."- },- "sortable": {- "label": "Sortowalne",- "help": "Pozwól sortować listy produktów storefront według tego pola (tylko krótki tekst i liczba). Po włączeniu z Meilisearch uruchom rake spree:search:reindex, aby zaktualizować istniejące produkty."- }+ "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.",+ "validation": {+ "scope_required": "Wybierz co najmniej jeden zakres"},- "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."- }+ "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ć."+ },+ "calculators": {+ "default_refund_amount": "Domyślna kwota zwrotu",+ "default_tax": "Domyślny podatek",+ "digital_delivery": "Dostawa cyfrowa",+ "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"+ },+ "categories": {+ "add_cta": "Nowa kategoria",+ "collapse": "Zwiń",+ "columns": {+ "name": "Nazwa",+ "products": "Produkty"},- "allowed_origin": {- "origin": {- "label": "Źródło",- "placeholder": "https://admin.example.com",- "help": "Sam schemat + host (+ opcjonalnie port). Bez ścieżki, zapytania ani fragmentu."+ "delete_confirm": "Usunąć kategorię „{{name}}” i wszystkie jej podkategorie?",+ "delete_label": "Usuń kategorię",+ "empty": "Brak kategorii.",+ "expand": "Rozwiń",+ "fields": {+ "parent": {+ "label": "Kategoria nadrzędna",+ "placeholder": "Najwyższy poziom"}},- "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"- }- },- "storefront_access": {- "label": "Dostęp do sklepu",- "help": "Określa, co anonimowi odwiedzający widzą w tym kanale. Pozostaw puste, aby dziedziczyć ustawienie sklepu. Gdy ceny są ukryte, goście muszą się zalogować, aby sfinalizować zakup.",- "inherit": "Dziedzicz ze sklepu",- "options": {- "public": "Publiczny — każdy może przeglądać i widzieć ceny",- "prices_hidden": "Ceny ukryte — odwiedzający muszą się zalogować, aby zobaczyć ceny",- "login_required": "Wymagane logowanie — odwiedzający muszą się zalogować, aby przeglądać"- }- },- "guest_checkout": {- "label": "Zakupy jako gość",- "help": "Czy klienci mogą składać zamówienia bez konta w tym kanale. Pozostaw puste, aby dziedziczyć ustawienie sklepu.",- "inherit": "Dziedzicz ze sklepu",- "options": {- "true": "Dozwolone",- "false": "Niedozwolone"- }- }+ "images": {+ "help": "Używany w banerach kategorii. Zalecane 1920×1080.",+ "label": "Obraz",+ "square_help": "Używany w kompaktowej nawigacji. Zalecane 400×400.",+ "square_label": "Obraz kwadratowy",+ "title": "Obrazy"},- "invitation_acceptance": {- "password": {- "label": "Hasło"- },- "password_confirmation": {- "label": "Potwierdź hasło"- }+ "load_failed": "Nie udało się załadować kategorii. Spróbuj ponownie.",+ "messages": {+ "created": "Kategoria utworzona",+ "deleted": "Kategoria usunięta",+ "move_failed": "Nie udało się przenieść kategorii",+ "updated": "Kategoria zaktualizowana"},- "customer_group": {- "name": {- "placeholder": "np. Klienci VIP"- },- "description": {- "placeholder": "Opcjonalny opis wewnętrzny"- }+ "navigation": {+ "title": "Nawigacja"},- "price_list": {- "name": {- "label": "Nazwa",- "placeholder": "np. Hurt UE",- "help": "Etykieta wewnętrzna — nigdy nie pokazywana klientom."+ "new_title": "Nowa kategoria",+ "no_results": "Brak pasujących kategorii.",+ "products": {+ "add_cta": "Dodaj produkty",+ "column_product": "Produkt",+ "empty": "Brak produktów w tej kategorii.",+ "filter_placeholder": "Filtruj produkty…",+ "no_matches": "Żaden produkt nie pasuje do filtra.",+ "picker_description": "Wyszukaj i wybierz produkty do dodania do tej kategorii.",+ "picker_title": "Dodaj produkty do kategorii",+ "remove": "Usuń z kategorii",+ "remove_selected": "Usuń",+ "search_placeholder": "Szukaj produktów…",+ "select_all": "Zaznacz wszystko",+ "select_row": "Zaznacz produkt",+ "selected_count_one": "Zaznaczono {{count}}",+ "selected_count_other": "Zaznaczono {{count}}",+ "title": "Produkty"+ },+ "products_count_one": "{{count}} produkt",+ "products_count_other": "{{count}} produktów",+ "search_placeholder": "Szukaj kategorii…",+ "seo": {+ "preview_slug_placeholder": "slug-kategorii",+ "title": "Optymalizacja pod wyszukiwarki"+ },+ "title": "Kategorie"+ },+ "channels": {+ "messages": {+ "created": "Kanał utworzony",+ "deleted": "Kanał usunięty",+ "updated": "Kanał zaktualizowany"+ }+ },+ "components": {+ "adjustment_action_editor": {+ "calculator_label": "Kalkulator",+ "loading_calculators": "Ładowanie kalkulatorów…",+ "no_extra_settings": "Ten kalkulator nie ma dodatkowych ustawień.",+ "select_calculator": "Wybierz kalkulator",+ "settings_label": "Ustawienia kalkulatora"+ },+ "custom_fields": {+ "default_resource": "rekordy",+ "empty_description": "Śledź ustrukturyzowane szczegóły, takie jak materiał, krój czy instrukcje pielęgnacji.",+ "empty_title": "Brak pól niestandardowych",+ "errors": {+ "failed_to_save": "Nie udało się zapisać pola niestandardowego"},- "description": {- "label": "Opis",- "placeholder": "Opcjonalny opis wewnętrzny"+ "manage_in_settings": "Zarządzaj w ustawieniach",+ "new_definition_description": "Zdefiniuj pole niestandardowe, aby przechowywać typowane, ustrukturyzowane informacje dla: {{resource}}.",+ "new_definition_title": "Nowe pole niestandardowe",+ "section_title": "Pola niestandardowe",+ "set_up": "Skonfiguruj pola niestandardowe",+ "values_save_partial_failed": "Niektórych pól niestandardowych nie udało się zapisać: {{fields}}",+ "values_saved": "Pola niestandardowe zapisane"+ },+ "market_combobox": {+ "empty": "Brak pasujących rynków",+ "search_placeholder": "Szukaj rynków…"+ }+ },+ "custom_field_definitions": {+ "add_cta": "Dodaj pole niestandardowe",+ "create_description": "Zdefiniuj typowane pole, które Twój zespół może wypełnić w dowolnym pasującym rekordzie.",+ "create_label": "Utwórz pole niestandardowe",+ "delete_confirm": {+ "message": "{{label}} zostanie usunięte wraz z każdą zapisaną dla niego wartością.",+ "title": "Usunąć pole niestandardowe?"+ },+ "edit_description": "Zaktualizuj etykietę, klucz lub widoczność w sklepie. Właściciela nie można zmienić po zapisaniu wartości.",+ "empty": "Brak definicji pól niestandardowych",+ "errors": {+ "failed_to_create": "Nie udało się utworzyć definicji pola niestandardowego",+ "failed_to_delete": "Nie udało się usunąć definicji pola niestandardowego",+ "failed_to_update": "Nie udało się zaktualizować definicji pola niestandardowego"+ },+ "messages": {+ "created": "Definicja pola niestandardowego utworzona",+ "deleted": "Definicja pola niestandardowego usunięta",+ "updated": "Definicja pola niestandardowego zaktualizowana"+ },+ "search_placeholder": "Szukaj według etykiety, przestrzeni nazw lub klucza…",+ "storefront_visible": {+ "admin_only": "Tylko administrator",+ "visible": "Widoczne"+ },+ "table_title": "Definicje pól niestandardowych"+ },+ "customer_groups": {+ "autocomplete": {+ "empty": "Brak pasujących grup klientów",+ "placeholder": "Szukaj grup klientów…"+ },+ "messages": {+ "create_failed": "Nie udało się utworzyć grupy klientów",+ "created": "Utworzono grupę klientów",+ "delete_failed": "Nie udało się usunąć grupy klientów",+ "deleted": "Usunięto grupę klientów",+ "update_failed": "Nie udało się zaktualizować grupy klientów",+ "updated": "Zaktualizowano grupę klientów"+ }+ },+ "customers": {+ "autocomplete": {+ "empty": "Brak pasujących klientów",+ "placeholder": "Szukaj klientów…"+ },+ "columns": {+ "groups": "Grupy",+ "last_order": "Ostatnie zamówienie",+ "newsletter": "Newsletter",+ "orders": "Zamówienia",+ "total_spent": "Łączne wydatki"+ },+ "detail": {+ "address": {+ "default_billing": "Domyślny adres rozliczeniowy",+ "default_shipping": "Domyślny adres dostawy",+ "delete_confirm_message": "Usunąć ten adres?",+ "set_default_billing": "Ustaw jako domyślny adres rozliczeniowy",+ "set_default_shipping": "Ustaw jako domyślny adres dostawy"},- "starts_at": {- "label": "Rozpoczyna się",- "placeholder": "Natychmiast",- "help": "Kiedy ta lista staje się aktywna. Pozostaw puste, aby rozpocząć natychmiast po aktywacji."+ "customer_since": "Klient od",+ "delete_label": "Usuń klienta",+ "edit_profile_description": "Zaktualizuj dane profilu klienta.",+ "groups": {+ "edit_description": "Dodaj lub usuń grupy, do których należy ten klient.",+ "edit_title": "Edytuj grupy klientów",+ "empty": "W żadnej grupie",+ "save_failed": "Nie udało się zaktualizować grup klientów",+ "title": "Grupy klientów"},- "ends_at": {- "label": "Kończy się",- "placeholder": "Nigdy",- "help": "Pozostaw puste, aby nie ustawiać daty zakończenia."+ "last_order_placed": "Ostatnie złożone zamówienie",+ "no_internal_notes": "Brak notatek wewnętrznych",+ "not_subscribed_to_marketing": "Niezapisany do newslettera marketingowego",+ "orders_table": {+ "date": "Data",+ "order": "Zamówienie"},- "match_policy": {- "label": "Reguła dopasowania",- "all": "Wszystkie reguły muszą być spełnione",- "any": "Dowolna reguła może być spełniona"+ "store_credit": {+ "add_description": "Przyznaj kredyt sklepowy na konto tego klienta.",+ "delete_confirm_message": "Usunąć ten kredyt sklepowy?",+ "edit_description": "Dostosuj kwotę, kategorię lub notatkę. Wykorzystanego salda nie można edytować.",+ "empty": "Nie wydano żadnych kredytów sklepowych",+ "table": {+ "category": "Kategoria",+ "memo": "Notatka",+ "remaining": "Pozostało",+ "used": "Wykorzystano"+ },+ "title": "Kredyt sklepowy"},- "status": {- "active": "Aktywna",- "scheduled": "Zaplanowana",- "inactive": "Nieaktywna",- "draft": "Wersja robocza"- }+ "subscribed_to_marketing": "Zapisany do newslettera marketingowego"},- "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."+ "groups": {+ "bulk_add_action": "Dodaj do grupy…",+ "bulk_add_failed": "Nie udało się dodać klientów do grup",+ "bulk_added": "Dodano {{count}} klientów do grup",+ "bulk_remove_action": "Usuń z grupy…",+ "bulk_remove_failed": "Nie udało się usunąć klientów z grup",+ "bulk_removed": "Usunięto {{count}} klientów z grup",+ "columns": {+ "customers": "Klienci"},- "markets": {- "label": "Rynki",- "help": "Pozostaw puste, aby zastosować tę regułę na każdym rynku."+ "count_few": "{{count}} klienci",+ "count_many": "{{count}} klientów",+ "count_one": "{{count}} klient",+ "count_other": "{{count}} klientów",+ "create_description": "Utwórz grupę klientów, aby segmentować klientów na potrzeby promocji, analityki lub marketingu.",+ "create_label": "Utwórz grupę klientów",+ "default_name": "Ta grupa",+ "delete_confirm": {+ "message": "{{name}} zostanie usunięta. Klienci z tej grupy nie zostaną usunięci.",+ "title": "Usunąć grupę klientów?"},- "channels": {- "label": "Kanały sprzedaży",- "help": "Pozostaw puste, aby zastosować tę regułę do każdego kanału sprzedaży."+ "edit_description": "Zaktualizuj nazwę lub opis.",+ "picker": {+ "add_description": "Wybierz grupy, do których chcesz dodać tych klientów.",+ "add_title": "Dodaj do grup",+ "remove_description": "Wybierz grupy, z których chcesz usunąć tych klientów.",+ "remove_title": "Usuń z grup"},- "min_quantity": {- "help": "Ta cena obowiązuje tylko wtedy, gdy klient zamówi co najmniej tyle sztuk jednego produktu."+ "table": {+ "empty": "Brak grup klientów",+ "search_placeholder": "Szukaj według nazwy…",+ "title": "Grupy klientów"},- "max_quantity": {- "help": "Pozostaw puste, aby nie ustawiać górnego limitu."+ "view_members": "Wyświetl członków"+ },+ "new_sheet_description": "Klienci utworzeni w tym miejscu nie mają ustawionego hasła. Przy pierwszym logowaniu otrzymają magiczny link.",+ "row_actions": {+ "delete_confirm": "Usunąć {{email}}? Klientów ze zrealizowanymi zamówieniami nie można usunąć."+ },+ "table": {+ "empty": "Brak klientów",+ "search_placeholder": "Szukaj według e-maila lub nazwy…"+ },+ "tags": {+ "bulk_add_action": "Dodaj tagi…",+ "bulk_add_failed": "Nie udało się dodać tagów",+ "bulk_added": "Dodano tagi do {n} klientów",+ "bulk_remove_action": "Usuń tagi…",+ "bulk_remove_failed": "Nie udało się usunąć tagów",+ "bulk_removed": "Usunięto tagi z {n} klientów",+ "picker": {+ "add_description": "Wybierz lub utwórz tagi, które chcesz dodać do tych klientów.",+ "add_title": "Dodaj tagi",+ "remove_description": "Wybierz tagi, które chcesz usunąć z tych klientów.",+ "remove_title": "Usuń tagi"}+ }+ },+ "delivery_methods": {+ "add_cta": "Dodaj metodę dostawy",+ "add_sheet_title": "Nowa metoda dostawy",+ "create_description": "Skonfiguruj, jak zamówienia trafiają do klientów: wysyłka, dostawa cyfrowa lub odbiór.",+ "create_label": "Utwórz metodę dostawy",+ "delete_confirm": {+ "message": "Usunąć „{{name}}”? Sklepy natychmiast przestaną ją oferować.",+ "title": "Usuń metodę dostawy"+ },+ "edit_description": "Zaktualizuj konfigurację tej metody dostawy.",+ "edit_sheet_title": "Edytuj metodę dostawy",+ "empty": "Brak metod dostawy.",+ "fulfillment_types": {+ "digital": "Cyfrowa",+ "pickup": "Odbiór",+ "pickup_point": "Punkt odbioru",+ "shipping": "Wysyłka"},- "stock_location": {- "name": {- "placeholder": "Magazyn Brooklyn"+ "messages": {+ "created": "Utworzono metodę dostawy",+ "deleted": "Usunięto metodę dostawy",+ "updated": "Zaktualizowano metodę dostawy"+ },+ "no_zones_hint": "Brak stref dostawy — metoda obowiązuje wszędzie.",+ "search_placeholder": "Szukaj metod dostawy…"+ },+ "delivery_zones": {+ "add_cta": "Dodaj strefę dostawy",+ "add_member": "Dodaj członka",+ "add_sheet_title": "Nowa strefa dostawy",+ "create_description": "Pogrupuj kraje, regiony lub kody pocztowe w obszar obsługiwany przez metody dostawy.",+ "create_label": "Utwórz strefę dostawy",+ "delete_confirm": {+ "message": "Usunąć „{{name}}”? Metody dostawy korzystające z tej strefy przestaną pasować do tych obszarów.",+ "title": "Usuń strefę dostawy"+ },+ "edit_description": "Poniżsi członkowie zastąpią przy zapisie pełną listę strefy.",+ "edit_sheet_title": "Edytuj strefę dostawy",+ "empty": "Brak stref dostawy.",+ "from_placeholder": "Od",+ "member_types": {+ "country": "Kraj",+ "postal_code": "Kod pocztowy",+ "state": "Region"+ },+ "members_column": "Członkowie",+ "members_count": "{{count}} członków",+ "messages": {+ "created": "Utworzono strefę dostawy",+ "deleted": "Usunięto strefę dostawy",+ "updated": "Zaktualizowano strefę dostawy"+ },+ "no_members_hint": "Brak członków — dodaj kraje, regiony lub reguły kodów pocztowych.",+ "prefix_placeholder": "Prefiks",+ "search_placeholder": "Szukaj stref dostawy…",+ "select_country": "Wybierz kraj",+ "state_placeholder": "Kod lub nazwa regionu",+ "to_placeholder": "Do"+ },+ "errors": {+ "forbidden_description": "Nie masz uprawnień do wyświetlenia tej strony.",+ "forbidden_title": "Brak uprawnień",+ "not_found_description": "Strona, której szukasz, nie istnieje.",+ "not_found_title": "Nie znaleziono strony",+ "plugin_route_title": "Nie udało się wyświetlić tej strony"+ },+ "fields": {+ "allowed_origin": {+ "origin": {+ "help": "Sam schemat + host (+ opcjonalnie port). Bez ścieżki, zapytania ani fragmentu.",+ "label": "Źródło",+ "placeholder": "https://admin.example.com"+ }+ },+ "api_key": {+ "channel": {+ "all_channels": "All channels",+ "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",+ "label": "Channel"},- "admin_name": {- "label": "Nazwa wewnętrzna",- "placeholder": "Opcjonalnie — widoczne tylko w panelu administracyjnym"+ "key_type": {+ "label": "Typ"},- "kind": {- "label": "Rodzaj"+ "name": {+ "label": "Nazwa",+ "placeholder": "Integracja backendu, Sklep produkcyjny, …",+ "required": "Nazwa jest wymagana"},+ "scopes": {+ "label": "Zakresy"+ }+ },+ "channel": {"active": {- "label": "Aktywna",- "help": "Nieaktywne lokalizacje nie pojawiają się w wyborze realizacji zamówień."+ "help": "Nieaktywne kanały sprzedaży przestają przyjmować zamówienia i nie są dopasowywane przez nagłówek X-Spree-Channel.",+ "label": "Aktywny"+ },+ "code": {+ "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.",+ "label": "Kod",+ "placeholder": "Wyprowadzany automatycznie z nazwy"},"default": {- "label": "Lokalizacja domyślna",- "help": "Nowe pozycje magazynowe są tu propagowane. Tylko jedna lokalizacja może być domyślna."+ "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.",+ "label": "Kanał domyślny"},- "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."+ "guest_checkout": {+ "help": "Czy klienci mogą składać zamówienia bez konta w tym kanale. Pozostaw puste, aby dziedziczyć ustawienie sklepu.",+ "inherit": "Dziedzicz ze sklepu",+ "label": "Zakupy jako gość",+ "options": {+ "false": "Niedozwolone",+ "true": "Dozwolone"+ }},- "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."+ "name": {+ "placeholder": "np. POS, Hurt, Sklep Meta"},- "pickup_enabled": {- "label": "Zezwól na odbiór osobisty",- "help": "Klienci mogą odbierać zamówienia z tej lokalizacji podczas składania zamówienia."+ "order_routing_strategy": {+ "help": "Zastępuje strategię routingu na poziomie sklepu dla zamówień przypisanych do tego kanału. Pozostaw puste, aby dziedziczyć.",+ "inherit": "Dziedzicz ze sklepu",+ "label": "Strategia routingu zamówień",+ "options": {+ "Spree::OrderRouting::Strategy::Legacy": "Starsza",+ "Spree::OrderRouting::Strategy::Rules": "Reguły (uporządkowane)"+ }},- "pickup_stock_policy": {- "label": "Polityka stanów magazynowych"+ "storefront_access": {+ "help": "Określa, co anonimowi odwiedzający widzą w tym kanale. Pozostaw puste, aby dziedziczyć ustawienie sklepu. Gdy ceny są ukryte, goście muszą się zalogować, aby sfinalizować zakup.",+ "inherit": "Dziedzicz ze sklepu",+ "label": "Dostęp do sklepu",+ "options": {+ "login_required": "Wymagane logowanie — odwiedzający muszą się zalogować, aby przeglądać",+ "prices_hidden": "Ceny ukryte — odwiedzający muszą się zalogować, aby zobaczyć ceny",+ "public": "Publiczny — każdy może przeglądać i widzieć ceny"+ }+ }+ },+ "custom_field_definition": {+ "field_type": {+ "label": "Typ",+ "options": {+ "boolean": "Wartość logiczna",+ "json": "JSON",+ "long_text": "Długi tekst",+ "number": "Liczba",+ "rich_text": "Tekst sformatowany",+ "short_text": "Krótki tekst"+ },+ "read_only_help": "Typu nie można zmienić, gdy istnieją już wartości — zmiana spowodowałaby błędną interpretację zapisanych wartości."},- "pickup_ready_in_minutes": {- "label": "Gotowe za (minuty)",- "placeholder": "60"+ "key": {+ "invalid_format": "Tylko litery, cyfry i podkreślenia",+ "label": "Klucz",+ "placeholder": "np. material"},- "pickup_instructions": {- "label": "Instrukcje odbioru",- "placeholder": "Gdzie klient ma się udać, aby odebrać swoje zamówienie."+ "label": {+ "label": "Etykieta",+ "placeholder": "np. Materiał"+ },+ "namespace": {+ "label": "Przestrzeń nazw",+ "placeholder": "custom"+ },+ "resource_type": {+ "label": "Dotyczy",+ "options": {+ "Spree::OptionType": "Typy opcji",+ "Spree::Order": "Zamówienia",+ "Spree::Product": "Produkty",+ "Spree::Taxon": "Kategorie",+ "Spree::User": "Klienci",+ "Spree::Variant": "Warianty"+ },+ "read_only_help": "Właściciela nie można zmienić, gdy istnieją już wartości dla tego pola."+ },+ "searchable": {+ "help": "Uwzględnij wartości w wyszukiwaniu produktów storefront (tylko krótki tekst, długi tekst i liczba). Po włączeniu z Meilisearch uruchom rake spree:search:reindex, aby zaktualizować istniejące produkty.",+ "label": "Przeszukiwalne"+ },+ "sortable": {+ "help": "Pozwól sortować listy produktów storefront według tego pola (tylko krótki tekst i liczba). Po włączeniu z Meilisearch uruchom rake spree:search:reindex, aby zaktualizować istniejące produkty.",+ "label": "Sortowalne"+ },+ "storefront_visible": {+ "column_label": "Sklep",+ "label": "Widoczne w sklepie"}},- "payment_method": {- "type": {- "label": "Dostawca",- "placeholder": "Wybierz dostawcę"+ "customer": {+ "accepts_email_marketing": {+ "label": "Zapisany do marketingu"},- "name": {- "placeholder": "np. Karta kredytowa (Stripe)"+ "customer_groups": {+ "label": "Grupy klientów"+ },+ "internal_note": {+ "label": "Notatka wewnętrzna",+ "placeholder": "Kontekst dotyczący tego klienta tylko dla personelu…"},+ "tags": {+ "label": "Tagi"+ }+ },+ "customer_group": {"description": {- "placeholder": "Opis widoczny dla klienta podczas składania zamówienia"+ "placeholder": "Opcjonalny opis wewnętrzny"+ },+ "name": {+ "placeholder": "np. Klienci VIP"+ }+ },+ "customer_id": {+ "label": "Klient"+ },+ "delivery_method": {+ "admin_name": {+ "label": "Nazwa wewnętrzna"+ },+ "calculator": {+ "label": "Kalkulator stawek"+ },+ "code": {+ "label": "Kod"+ },+ "delivery_zones": {+ "label": "Strefy dostawy"+ },+ "fulfillment_type": {+ "label": "Typ realizacji"},"storefront_visible": {- "label": "Widoczna w sklepie"+ "help": "Klienci mogą wybrać tę metodę przy kasie."},- "active": {- "label": "Aktywna",- "help": "Nieaktywne metody są ukryte podczas składania zamówienia."+ "tax_category": {+ "label": "Kategoria podatkowa"},- "auto_capture": {- "label": "Automatyczne pobranie",- "help": "Pobieraj środki automatycznie po autoryzacji. Gdy wyłączone, musisz pobrać je ręcznie."+ "tracking_url": {+ "label": "Szablon URL śledzenia"+ },+ "transit_days_max": {+ "label": "Dni dostawy (maks)"},- "provider_configuration": "Konfiguracja dostawcy"+ "transit_days_min": {+ "label": "Dni dostawy (min)"+ }},- "market": {- "name": {- "placeholder": "np. Europa"+ "gift_card": {+ "amount": {+ "label": "Kwota"+ },+ "code": {+ "help": "Pozostaw puste, aby wygenerować automatycznie. W przypadku partii staje się to prefiksem.",+ "label": "Kod"},"currency": {- "label": "Waluta",- "help": "Waluta ISO 4217 używana dla wszystkich cen na tym rynku."+ "label": "Waluta"},- "default_locale": {- "label": "Domyślne ustawienia regionalne",- "help": "Język sklepu dla kupujących na tym rynku."+ "customer_id": {+ "label": "Klient"},- "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."+ "expires_at": {+ "label": "Wygasa",+ "placeholder": "Brak daty wygaśnięcia"+ },+ "quantity": {+ "help": "1 wydaje pojedynczą kartę. Więcej niż 1 wydaje partię z automatycznie wygenerowanymi kodami.",+ "label": "Ilość"+ }+ },+ "invitation_acceptance": {+ "password": {+ "label": "Hasło"},+ "password_confirmation": {+ "label": "Potwierdź hasło"+ }+ },+ "market": {"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."+ "help": "Wybierz kraje obejmowane przez ten rynek. Każdy kraj może należeć do co najwyżej jednego rynku w obrębie sklepu.",+ "label": "Kraje"},- "tax_inclusive": {- "label": "Ceny z podatkiem",- "help": "Wyświetlaj ceny z uwzględnionym podatkiem. Powszechne na rynkach UE."+ "currency": {+ "help": "Waluta ISO 4217 używana dla wszystkich cen na tym rynku.",+ "label": "Waluta"},"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."+ "help": "Kupujący bez znanego kraju widzą ten rynek. Tylko jeden może być domyślny w obrębie sklepu.",+ "label": "Rynek domyślny"+ },+ "default_locale": {+ "help": "Język sklepu dla kupujących na tym rynku.",+ "label": "Domyślne ustawienia regionalne"+ },+ "name": {+ "placeholder": "np. Europa"+ },+ "supported_locales": {+ "help": "Dodatkowe języki, na które kupujący mogą się przełączyć. Domyślne ustawienia regionalne są zawsze uwzględnione.",+ "label": "Obsługiwane ustawienia regionalne"+ },+ "tax_inclusive": {+ "help": "Wyświetlaj ceny z uwzględnionym podatkiem. Powszechne na rynkach UE.",+ "label": "Ceny z podatkiem"+ }+ },+ "match_policy": {+ "label": "Polityka dopasowania"+ },+ "media": {+ "alt": {+ "label": "Tekst alternatywny",+ "placeholder": "Opisz obraz na potrzeby dostępności i SEO"}},"option_type": {- "name": {- "label": "Nazwa wewnętrzna",- "placeholder": "np. rozmiar-koszuli",- "help": "Identyfikator zapisany małymi literami. Musi być unikalny w obrębie sklepu."+ "filterable": {+ "help": "Pokaż tę opcję jako filtr na listach produktów w sklepie.",+ "label": "Możliwość filtrowania"+ },+ "kind": {+ "help": "Określa sposób renderowania opcji w sklepie. Próbka koloru pokazuje kolor w formacie heksadecymalnym; przyciski pokazują miniaturę.",+ "label": "Rodzaj"},"label": {+ "help": "Pokazywana klientom w sklepie.","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ę."+ "placeholder": "np. Rozmiar koszuli"},- "filterable": {- "label": "Możliwość filtrowania",- "help": "Pokaż tę opcję jako filtr na listach produktów w sklepie."+ "name": {+ "help": "Identyfikator zapisany małymi literami. Musi być unikalny w obrębie sklepu.",+ "label": "Nazwa wewnętrzna",+ "placeholder": "np. rozmiar-koszuli"}},"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"+ },+ "label": {+ "label": "Etykieta",+ "placeholder": "np. Mały"+ },+ "name": {+ "label": "Nazwa wewnętrzna",+ "placeholder": "np. mały"}},- "variant": {- "sku": {- "label": "SKU",- "placeholder": "PRODUKT-CZERWONY-S"- },- "barcode": {- "label": "Kod kreskowy"+ "order": {+ "channel": {+ "help": "Przypisz zamówienie do konkretnego kanału sprzedaży. Domyślnie do kanału internetowego sklepu.",+ "label": "Kanał sprzedaży",+ "placeholder": "Użyj domyślnego sklepu"},- "weight": {- "label": "Waga"+ "coupon_code": {+ "label": "Kod kuponu",+ "placeholder": "Opcjonalnie"},- "weight_unit": {- "label": "Jednostka"+ "customer_note": {+ "label": "Notatka klienta (widoczna dla klienta)"},- "height": {- "label": "Wysokość"+ "email": {+ "label": "Lub użyj adresu e-mail gościa",+ "placeholder": "[email protected]"},- "width": {- "label": "Szerokość"+ "internal_note": {+ "label": "Notatka wewnętrzna (tylko dla personelu)"+ }+ },+ "payment_method": {+ "active": {+ "help": "Nieaktywne metody są ukryte podczas składania zamówienia.",+ "label": "Aktywna"},- "depth": {- "label": "Głębokość"+ "auto_capture": {+ "help": "Pobieraj środki automatycznie po autoryzacji. Gdy wyłączone, musisz pobrać je ręcznie.",+ "label": "Automatyczne pobranie"},- "dimensions_unit": {- "label": "Jednostka"+ "description": {+ "placeholder": "Opis widoczny dla klienta podczas składania zamówienia"},- "preorderable": {- "label": "Dostępne w przedsprzedaży",- "help": "Sprzedawaj ten wariant, zanim trafi do magazynu. Ogranicz liczbę limitem zamówień oczekujących, wpisz przychodzący stan jako ilość lub pozostaw puste dla nieograniczonej liczby."+ "name": {+ "placeholder": "np. Karta kredytowa (Stripe)"},- "preorder_ships_at": {- "label": "Wysyłka do",- "placeholder": "Wybierz datę",- "help": "Kiedy planujesz wysłać zamówienia przedpremierowe. Pokazywane klientom jako obietnica dostawy; przedsprzedaż kończy się po upływie tej daty."+ "provider_configuration": "Konfiguracja dostawcy",+ "storefront_visible": {+ "label": "Widoczna w sklepie"},- "backorder_limit": {- "label": "Limit zamówień oczekujących",- "placeholder": "Bez limitu",- "help": "Maksymalna liczba jednostek sprzedanych ponad dostępny stan — ogranicza zamówienia oczekujące i przedsprzedaż. Pozostaw puste dla braku limitu."+ "type": {+ "label": "Dostawca",+ "placeholder": "Wybierz dostawcę"}},- "api_key": {- "name": {- "label": "Nazwa",- "placeholder": "Integracja backendu, Sklep produkcyjny, …",- "required": "Nazwa jest wymagana"+ "price_list": {+ "description": {+ "label": "Opis",+ "placeholder": "Opcjonalny opis wewnętrzny"},- "key_type": {- "label": "Typ"+ "ends_at": {+ "help": "Pozostaw puste, aby nie ustawiać daty zakończenia.",+ "label": "Kończy się",+ "placeholder": "Nigdy"},- "scopes": {- "label": "Zakresy"+ "match_policy": {+ "all": "Wszystkie reguły muszą być spełnione",+ "any": "Dowolna reguła może być spełniona",+ "label": "Reguła dopasowania"},- "channel": {- "label": "Channel",- "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",- "all_channels": "All channels"- }- },- "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"+ "help": "Etykieta wewnętrzna — nigdy nie pokazywana klientom.",+ "label": "Nazwa",+ "placeholder": "np. Hurt UE"},- "storefront_access": {- "label": "Dostęp do sklepu",- "help": "Domyślne ustawienie dla całego sklepu określające, co widzą anonimowi odwiedzający. Kanały mogą je nadpisać. Gdy ceny są ukryte, goście muszą się zalogować, aby sfinalizować zakup.",- "options": {- "public": "Publiczny — każdy może przeglądać i widzieć ceny",- "prices_hidden": "Ceny ukryte — odwiedzający muszą się zalogować, aby zobaczyć ceny",- "login_required": "Wymagane logowanie — odwiedzający muszą się zalogować, aby przeglądać"- }+ "starts_at": {+ "help": "Kiedy ta lista staje się aktywna. Pozostaw puste, aby rozpocząć natychmiast po aktywacji.",+ "label": "Rozpoczyna się",+ "placeholder": "Natychmiast"},- "guest_checkout": {- "label": "Zakupy jako gość",- "help": "Domyślne ustawienie dla całego sklepu określające, czy klienci mogą składać zamówienia bez konta. Kanały mogą je nadpisać."+ "status": {+ "active": "Aktywna",+ "draft": "Wersja robocza",+ "inactive": "Nieaktywna",+ "scheduled": "Zaplanowana"+ }+ },+ "price_rule": {+ "channels": {+ "help": "Pozostaw puste, aby zastosować tę regułę do każdego kanału sprzedaży.",+ "label": "Kanały sprzedaży"},- "mail_from_address": {- "label": "Adres nadawcy",- "placeholder": "[email protected]",- "help": "Używany jako adres nadawcy w każdej wiadomości transakcyjnej."+ "customer_groups": {+ "help": "Pozostaw puste, aby zastosować tę regułę do każdego klienta niezależnie od grupy.",+ "label": "Grupy klientów"},- "customer_support_email": {- "label": "E-mail obsługi klienta",- "placeholder": "[email protected]",- "help": "Adres zwrotny pokazywany klientom w wiadomościach ze sklepu."+ "customers": {+ "help": "Pozostaw puste, aby zastosować tę regułę do każdego zalogowanego klienta.",+ "label": "Klienci"},- "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ć."+ "markets": {+ "help": "Pozostaw puste, aby zastosować tę regułę na każdym rynku.",+ "label": "Rynki"},- "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."+ "max_quantity": {+ "help": "Pozostaw puste, aby nie ustawiać górnego limitu."},- "mailer_logo": {- "label": "Logo e-mail",- "help": "PNG lub JPG z przezroczystym tłem. Osadzane w nagłówkach wiadomości transakcyjnych."+ "min_quantity": {+ "help": "Ta cena obowiązuje tylko wtedy, gdy klient zamówi co najmniej tyle sztuk jednego produktu."}},- "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."- }+ "prices_count": {+ "label": "Ceny"},"product": {- "name": {- "label": "Nazwa",- "placeholder": "Nazwa produktu"+ "available_on": {+ "label": "Dostępny od"+ },+ "category_ids": {+ "label": "Kategorie"+ },+ "channels": {+ "label": "Kanały sprzedaży"},"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"+ "make_active_at": {+ "label": "Aktywuj o"},- "channels": {- "label": "Kanały sprzedaży"+ "name": {+ "label": "Nazwa",+ "placeholder": "Nazwa produktu"},"tags": {"label": "Tagi"@@ -633,2135 +845,2044 @@},"product_publication": {"published_at": {+ "help": "Pozostaw puste, aby opublikować natychmiast.","label": "Publikuj od",- "placeholder": "Na żywo natychmiast",- "help": "Pozostaw puste, aby opublikować natychmiast."+ "placeholder": "Na żywo natychmiast"},"unpublished_at": {+ "help": "Pozostaw puste, aby utrzymać na liście bezterminowo.","label": "Cofnij publikację",- "placeholder": "Nigdy",- "help": "Pozostaw puste, aby utrzymać na liście bezterminowo."+ "placeholder": "Nigdy"}},- "gift_card": {+ "products_count": {+ "label": "Produkty"+ },+ "profile": {+ "avatar": {+ "help": "Wyświetlane obok Twojego imienia w całym panelu administracyjnym. Najlepiej wyglądają zdjęcia kwadratowe.",+ "label": "Zdjęcie"+ },+ "email": {+ "label": "E-mail"+ },+ "first_name": {+ "label": "Imię"+ },+ "last_name": {+ "label": "Nazwisko"+ },+ "selected_locale": {+ "help": "Język używany w całym panelu administracyjnym. Wpływa tylko na to, co widzisz.",+ "label": "Język"+ }+ },+ "promotion": {"code": {- "label": "Kod",- "help": "Pozostaw puste, aby wygenerować automatycznie. W przypadku partii staje się to prefiksem."+ "placeholder": "LATO2026"},- "amount": {- "label": "Kwota"+ "code_prefix": {+ "help": "Każdy wygenerowany kod będzie zaczynał się od tego prefiksu.",+ "label": "Prefiks kodu (opcjonalnie)",+ "placeholder": "VIP"},- "currency": {- "label": "Waluta"+ "description": {+ "placeholder": "Opis wewnętrzny (opcjonalnie)"},"expires_at": {- "label": "Wygasa","placeholder": "Brak daty wygaśnięcia"},- "customer_id": {- "label": "Klient"+ "kind": {+ "label": "W jaki sposób jest stosowana ta promocja?"},- "quantity": {- "label": "Ilość",- "help": "1 wydaje pojedynczą kartę. Więcej niż 1 wydaje partię z automatycznie wygenerowanymi kodami."- }- },- "customer": {- "tags": {- "label": "Tagi"+ "match_policy": {+ "label": "Reguła dopasowania"},- "customer_groups": {- "label": "Grupy klientów"+ "multi_codes": {+ "help": "Przydatne w przypadku kodów jednorazowych — każdy klient realizuje inny kod.",+ "label": "Wygeneruj partię unikalnych kodów"},- "accepts_email_marketing": {- "label": "Zapisany do marketingu"+ "name": {+ "placeholder": "Wyprzedaż letnia"},- "internal_note": {- "label": "Notatka wewnętrzna",- "placeholder": "Kontekst dotyczący tego klienta tylko dla personelu…"+ "number_of_codes": {+ "label": "Liczba kodów",+ "placeholder": "100"+ },+ "starts_at": {+ "placeholder": "Brak daty rozpoczęcia"+ },+ "usage_limit": {+ "label": "Limit użyć",+ "placeholder": "Bez ograniczeń"}},- "store_credit": {- "amount": {- "label": "Kwota"+ "role_id": {+ "label": "Rola"+ },+ "role_ids": {+ "label": "Role"+ },+ "stock_location": {+ "active": {+ "help": "Nieaktywne lokalizacje nie pojawiają się w wyborze realizacji zamówień.",+ "label": "Aktywna"},- "currency": {- "label": "Waluta"+ "admin_name": {+ "label": "Nazwa wewnętrzna",+ "placeholder": "Opcjonalnie — widoczne tylko w panelu administracyjnym"},- "category_id": {- "label": "Kategoria"+ "backorderable_default": {+ "help": "Nowe pozycje magazynowe domyślnie zezwalają na zamówienia oczekujące, gdy brakuje towaru.",+ "label": "Domyślnie dostępne na zamówienie"},- "memo": {- "label": "Notatka",- "placeholder": "Powód przyznania tego kredytu"- }- },- "order": {- "email": {- "label": "Lub użyj adresu e-mail gościa",- "placeholder": "[email protected]"+ "default": {+ "help": "Nowe pozycje magazynowe są tu propagowane. Tylko jedna lokalizacja może być domyślna.",+ "label": "Lokalizacja domyślna"},- "customer_note": {- "label": "Notatka klienta (widoczna dla klienta)"+ "kind": {+ "label": "Rodzaj"},- "internal_note": {- "label": "Notatka wewnętrzna (tylko dla personelu)"+ "name": {+ "placeholder": "Magazyn Brooklyn"},- "coupon_code": {- "label": "Kod kuponu",- "placeholder": "Opcjonalnie"+ "pickup_enabled": {+ "help": "Klienci mogą odbierać zamówienia z tej lokalizacji podczas składania zamówienia.",+ "label": "Zezwól na odbiór osobisty"},- "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"+ "pickup_instructions": {+ "label": "Instrukcje odbioru",+ "placeholder": "Gdzie klient ma się udać, aby odebrać swoje zamówienie."+ },+ "pickup_ready_in_minutes": {+ "label": "Gotowe za (minuty)",+ "placeholder": "60"+ },+ "pickup_stock_policy": {+ "label": "Polityka stanów magazynowych"+ },+ "propagate_all_variants": {+ "help": "Twórz pozycje magazynowe w tej lokalizacji dla każdego wariantu produktu.",+ "label": "Automatycznie twórz pozycje magazynowe dla wszystkich wariantów"}},- "profile": {- "email": {- "label": "E-mail"+ "store": {+ "customer_support_email": {+ "help": "Adres zwrotny pokazywany klientom w wiadomościach ze sklepu.",+ "label": "E-mail obsługi klienta",+ "placeholder": "[email protected]"},- "first_name": {- "label": "Imię"+ "guest_checkout": {+ "help": "Domyślne ustawienie dla całego sklepu określające, czy klienci mogą składać zamówienia bez konta. Kanały mogą je nadpisać.",+ "label": "Zakupy jako gość"},- "last_name": {- "label": "Nazwisko"+ "mail_from_address": {+ "help": "Używany jako adres nadawcy w każdej wiadomości transakcyjnej.",+ "label": "Adres nadawcy",+ "placeholder": "[email protected]"},- "avatar": {- "label": "Zdjęcie",- "help": "Wyświetlane obok Twojego imienia w całym panelu administracyjnym. Najlepiej wyglądają zdjęcia kwadratowe."+ "mailer_logo": {+ "help": "PNG lub JPG z przezroczystym tłem. Osadzane w nagłówkach wiadomości transakcyjnych.",+ "label": "Logo e-mail"},- "selected_locale": {- "label": "Język",- "help": "Język używany w całym panelu administracyjnym. Wpływa tylko na to, co widzisz."- }- },- "match_policy": {- "label": "Polityka dopasowania"- }- },- "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"+ "name": {+ "label": "Nazwa sklepu"},- "channel": {- "label": "Kanały"+ "new_order_notifications_email": {+ "help": "Odbiorca powiadomień „złożono nowe zamówienie”. Pozostaw puste, aby wyłączyć.",+ "label": "Powiadomienia o nowych zamówieniach",+ "placeholder": "[email protected]"},- "market": {- "label": "Rynki"+ "preferred_admin_locale": {+ "label": "Język panelu administracyjnego",+ "placeholder": "Użyj języka domyślnego"},- "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."- }- }+ "preferred_send_consumer_transactional_emails": {+ "help": "Gdy wyłączone, nie są wysyłane żadne wiadomości z potwierdzeniem zamówienia, wysyłki ani zwrotu.",+ "label": "Wysyłaj wiadomości transakcyjne do klientów"},- "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."- }- }+ "preferred_timezone": {+ "label": "Strefa czasowa",+ "placeholder": "Wybierz strefę czasową"},- "customer_group": {- "label": "Grupy klientów",- "search_placeholder": "Szukaj grup klientów…",- "empty": "Brak pasujących grup klientów"+ "preferred_unit_system": {+ "label": "System jednostek"},- "customer": {- "label": "Klienci",- "search_placeholder": "Szukaj klientów po nazwie lub adresie e-mail…",- "empty": "Brak pasujących klientów"+ "preferred_weight_unit": {+ "label": "Jednostka wagi"+ },+ "storefront_access": {+ "help": "Domyślne ustawienie dla całego sklepu określające, co widzą anonimowi odwiedzający. Kanały mogą je nadpisać. Gdy ceny są ukryte, goście muszą się zalogować, aby sfinalizować zakup.",+ "label": "Dostęp do sklepu",+ "options": {+ "login_required": "Wymagane logowanie — odwiedzający muszą się zalogować, aby przeglądać",+ "prices_hidden": "Ceny ukryte — odwiedzający muszą się zalogować, aby zobaczyć ceny",+ "public": "Publiczny — każdy może przeglądać i widzieć ceny"+ }}},- "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."+ "store_credit": {+ "amount": {+ "label": "Kwota"+ },+ "category_id": {+ "label": "Kategoria"+ },+ "currency": {+ "label": "Waluta"+ },+ "memo": {+ "label": "Notatka",+ "placeholder": "Powód przyznania tego kredytu"+ }},- "action_edit": {- "description": "Skonfiguruj parametry akcji.",- "no_options": "Ta akcja nie ma konfigurowalnych opcji."+ "storefront_visible": {+ "label": "Widoczna w sklepie"},- "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"+ "tax_category": {+ "description": {+ "placeholder": "Opcjonalny opis wewnętrzny"+ },+ "is_default": {+ "help": "Ustawienie tej kategorii degraduje poprzednią domyślną. Produkty bez wyraźnie przypisanej kategorii korzystają z tej kategorii.",+ "label": "Domyślna"+ },+ "name": {+ "placeholder": "np. Stawka obniżona"+ },+ "tax_code": {+ "label": "Kod podatkowy",+ "placeholder": "Kod zewnętrznego dostawcy podatkowego (Avalara itp.)"}},- "rule_types": {- "category": {- "name": "Kategorie",- "description": "Zamówienie zawiera produkty z określonych kategorii"+ "tax_category_id": {+ "label": "Kategoria podatkowa"+ },+ "variant": {+ "backorder_limit": {+ "help": "Maksymalna liczba jednostek sprzedanych ponad dostępny stan — ogranicza zamówienia oczekujące i przedsprzedaż. Pozostaw puste dla braku limitu.",+ "label": "Limit zamówień oczekujących",+ "placeholder": "Bez limitu"},- "country": {- "name": "Kraj",- "description": "Ogranicz do zamówień z adresem dostawy w określonym kraju"+ "barcode": {+ "label": "Kod kreskowy"},- "currency": {- "name": "Waluta",- "description": "Ogranicz do zamówień w określonej walucie"+ "depth": {+ "label": "Głębokość"},- "customer": {- "name": "Klienci",- "description": "Dostępne tylko dla określonych klientów"+ "dimensions_unit": {+ "label": "Jednostka"},- "customer_group": {- "name": "Grupa(-y) klientów",- "description": "Dostępne tylko dla klientów z określonych grup klientów"+ "height": {+ "label": "Wysokość"},- "customer_logged_in": {- "name": "Tylko zalogowani klienci",- "description": "Dostępne tylko dla zalogowanych klientów"+ "preorder_ships_at": {+ "help": "Kiedy planujesz wysłać zamówienia przedpremierowe. Pokazywane klientom jako obietnica dostawy; przedsprzedaż kończy się po upływie tej daty.",+ "label": "Wysyłka do",+ "placeholder": "Wybierz datę"},- "first_order": {- "name": "Pierwsze zamówienie",- "description": "Musi być pierwszym zamówieniem klienta"+ "preorderable": {+ "help": "Sprzedawaj ten wariant, zanim trafi do magazynu. Ogranicz liczbę limitem zamówień oczekujących, wpisz przychodzący stan jako ilość lub pozostaw puste dla nieograniczonej liczby.",+ "label": "Dostępne w przedsprzedaży"},- "item_total": {- "name": "Wartość produktów",- "description": "Suma zamówienia spełnia te kryteria"+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUKT-CZERWONY-S"},- "one_use_per_user": {- "name": "Jedno użycie na użytkownika",- "description": "Tylko jedno użycie na użytkownika"+ "weight": {+ "label": "Waga"},- "option_value": {- "name": "Wartość (wartości) opcji",- "description": "Zamówienie zawiera produkty z pasującymi wartościami opcji"+ "weight_unit": {+ "label": "Jednostka"},- "product": {- "name": "Produkt(y)",- "description": "Zamówienie zawiera określone produkty"+ "width": {+ "label": "Szerokość"}},- "action_types": {- "create_adjustment": {- "name": "Utwórz korektę dla całego zamówienia",- "description": "Tworzy korektę kredytową promocji dla zamówienia"+ "webhook_endpoint": {+ "active": {+ "help": "Nieaktywne punkty końcowe nie otrzymują dostarczeń.",+ "label": "Aktywny"},- "create_item_adjustments": {- "name": "Utwórz korektę dla poszczególnych pozycji",- "description": "Tworzy korektę kredytową promocji dla pozycji zamówienia"+ "name": {+ "help": "Opcjonalna etykieta pokazywana na tej liście.",+ "label": "Nazwa",+ "placeholder": "np. Potok zamówień"},- "create_line_items": {- "name": "Utwórz pozycje zamówienia",- "description": "Dodaje do koszyka określoną ilość wariantu"+ "subscriptions": {+ "help": "Wybierz, które zdarzenia mają wyzwalać webhook. Nie wybieraj nic, aby otrzymywać każde zdarzenie.",+ "label": "Zdarzenia"},- "free_shipping": {- "name": "Darmowa wysyłka",- "description": "Sprawia, że wszystkie przesyłki w zamówieniu są bezpłatne"+ "url": {+ "label": "Docelowy adres URL",+ "placeholder": "https://example.com/webhooks"}+ }+ },+ "gift_cards": {+ "batch_autocomplete": {+ "empty": "Brak pasujących partii",+ "placeholder": "Szukaj partii według prefiksu…"+ },+ "columns": {+ "batch": "Partia",+ "customer": "Klient",+ "issued_by": "Wystawiona przez",+ "remaining": "Pozostało",+ "used": "Wykorzystano"},"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łę"+ "batch_create_failed": "Nie udało się utworzyć partii kart podarunkowych",+ "batch_created": "Partia kart podarunkowych została utworzona",+ "create_failed": "Nie udało się utworzyć karty podarunkowej",+ "created": "Karta podarunkowa została utworzona",+ "delete_failed": "Nie udało się usunąć karty podarunkowej",+ "deleted": "Karta podarunkowa została usunięta",+ "update_failed": "Nie udało się zaktualizować karty podarunkowej",+ "updated": "Karta podarunkowa została zaktualizowana"},- "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"+ "statuses": {+ "canceled": "Anulowana",+ "expired": "Wygasła",+ "partially_redeemed": "Częściowo zrealizowana",+ "redeemed": "Zrealizowana"+ },+ "table": {+ "empty": "Brak kart podarunkowych",+ "search_placeholder": "Szukaj według kodu…"}},- "components": {- "market_combobox": {- "search_placeholder": "Szukaj rynków…",- "empty": "Brak pasujących rynków"+ "imports": {+ "download_original": "Pobierz oryginalny plik",+ "failed": {+ "description": "Nie udało się przetworzyć pliku.",+ "title": "Import nieudany"},- "custom_fields": {- "section_title": "Pola niestandardowe",- "set_up": "Skonfiguruj pola niestandardowe",- "manage_in_settings": "Zarządzaj w ustawieniach",- "empty_title": "Brak pól niestandardowych",- "empty_description": "Śledź ustrukturyzowane szczegóły, takie jak materiał, krój czy instrukcje pielęgnacji.",- "values_saved": "Pola niestandardowe zapisane",- "values_save_partial_failed": "Niektórych pól niestandardowych nie udało się zapisać: {{fields}}",- "new_definition_title": "Nowe pole niestandardowe",- "new_definition_description": "Zdefiniuj pole niestandardowe, aby przechowywać typowane, ustrukturyzowane informacje dla: {{resource}}.",- "default_resource": "rekordy",- "errors": {- "failed_to_save": "Nie udało się zapisać pola niestandardowego"- }+ "failed_rows": {+ "error": "Błąd",+ "hide_data": "Ukryj dane wiersza",+ "next_page": "Następna strona",+ "prev_page": "Poprzednia strona",+ "row_number": "Wiersz",+ "title": "Nieudane wiersze",+ "view_data": "Pokaż dane wiersza"},- "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"- }+ "load_failed": "Nie udało się wczytać importu.",+ "mapping": {+ "description": "Dopasuj kolumny z pliku do pól: {{type}}.",+ "field": "Pole",+ "file_column": "Kolumna pliku",+ "missing_required": "Aby kontynuować, dopasuj wymagane pola: {{fields}}",+ "not_mapped": "Niedopasowane",+ "required": "Wymagane",+ "sample": "Przykład",+ "start": "Rozpocznij import",+ "starting": "Rozpoczynanie…",+ "title": "Dopasuj kolumny"+ },+ "processing": {+ "failed_count": "{{failed}} nieudanych",+ "note": "Możesz opuścić tę stronę — import będzie kontynuowany w tle.",+ "preparing": "Przygotowywanie wierszy…",+ "progress": "Przetworzono {{processed}} z {{total}} wierszy",+ "retrying": "Ponawianie nieudanych wierszy · pozostało {{remaining}}",+ "title": "Przetwarzanie wierszy"+ },+ "results": {+ "completed_title": "Import zakończony",+ "retry_failed": "Ponów nieudane wiersze ({{failed}})",+ "retrying": "Ponawianie…",+ "summary": "Zaimportowano {{completed}} wierszy · {{failed}} nieudanych",+ "view_records": "Zobacz: {{type}}"+ },+ "status": {+ "completed": "Zakończony",+ "completed_mapping": "W kolejce",+ "failed": "Nieudany",+ "mapping": "Dopasowywanie",+ "pending": "Oczekujący",+ "processing": "Przetwarzanie"+ },+ "steps": {+ "complete": "Gotowe",+ "map_fields": "Dopasuj pola",+ "process_rows": "Przetwórz wiersze"+ },+ "try_again": "Spróbuj ponownie",+ "types": {+ "customers": "Klienci",+ "product_translations": "Tłumaczenia produktów",+ "products": "Produkty"+ },+ "wizard_title": "Import"},- "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"+ "invitation": {+ "accepting": "Akceptowanie…",+ "could_not_accept": "Nie udało się zaakceptować zaproszenia",+ "create_and_accept": "Utwórz konto i zaakceptuj",+ "create_to_accept": ". Utwórz konto, aby zaakceptować.",+ "generic_error_message": "Coś poszło nie tak. Spróbuj ponownie.",+ "generic_error_title": "Nie udało się wczytać zaproszenia",+ "invited_as_role": " jako {{role}}",+ "invited_by": "{{email}} zaprosił(a) Cię",+ "invited_generic": "Zostałeś(-aś) zaproszony(-a)",+ "join_store": "Dołącz do {{store}}",+ "loading": "Wczytywanie zaproszenia…",+ "missing_token_message": "Ten link wygląda na niekompletny. Poproś osobę, która Cię zaprosiła, o ponowne przesłanie go.",+ "missing_token_title": "Brak tokenu zaproszenia",+ "not_found_message": "To zaproszenie wygasło, zostało unieważnione lub już je zaakceptowano. Poproś osobę zapraszającą o wysłanie nowego.",+ "not_found_title": "Nie znaleziono zaproszenia",+ "sign_in_and_accept": "Zaloguj się i zaakceptuj",+ "sign_in_to_accept": ". Zaloguj się, aby zaakceptować."+ },+ "markets": {+ "add_cta": "Dodaj rynek",+ "columns": {+ "default": "Domyślny"+ },+ "create_description": "Pogrupuj kraje w jeden region cenowy z własną walutą i ustawieniami regionalnymi.",+ "create_label": "Utwórz rynek",+ "delete_confirm": {+ "message": "{{name}} zostanie usunięty. Zamówienia złożone wcześniej na tym rynku pozostaną nienaruszone.",+ "title": "Usunąć rynek?"+ },+ "edit_description": "Zaktualizuj nazwę, walutę, ustawienia regionalne lub zasięg krajów.",+ "empty": "Brak rynków",+ "errors": {+ "failed_to_create": "Nie udało się utworzyć rynku",+ "failed_to_delete": "Nie udało się usunąć rynku",+ "failed_to_update": "Nie udało się zaktualizować rynku"+ },+ "messages": {+ "created": "Rynek utworzony",+ "deleted": "Rynek usunięty",+ "updated": "Rynek zaktualizowany"+ },+ "search_placeholder": "Szukaj według nazwy…",+ "tax_exclusive": "Bez podatku",+ "tax_inclusive": "Z podatkiem"+ },+ "nav": {+ "account": "Konto",+ "categories": "Kategorie",+ "customer_groups": "Grupy",+ "customers": "Klienci",+ "draft_orders": "Zamówienia robocze",+ "getting_started": "Pierwsze kroki",+ "gift_cards": "Karty podarunkowe",+ "home": "Strona główna",+ "options": "Opcje",+ "orders": "Zamówienia",+ "price_lists": "Cenniki",+ "products": "Produkty",+ "promotions": "Promocje",+ "reports": "Raporty",+ "settings": "Ustawienia",+ "transfers": "Transfery"+ },+ "option_types": {+ "columns": {+ "values": "Wartości"+ },+ "kinds": {+ "buttons": "Przyciski",+ "color_swatch": "Próbka koloru",+ "dropdown": "Lista rozwijana"+ },+ "messages": {+ "created": "Typ opcji utworzony",+ "deleted": "Typ opcji usunięty",+ "updated": "Typ opcji zaktualizowany"+ },+ "table": {+ "empty": "Brak typów opcji",+ "search_placeholder": "Szukaj według nazwy…"+ },+ "value_count_few": "{{count}} wartości",+ "value_count_many": "{{count}} wartości",+ "value_count_one": "{{count}} wartość",+ "value_count_other": "{{count}} wartości"+ },+ "order_routing_rules": {+ "messages": {+ "created": "Dodano regułę routingu",+ "deleted": "Usunięto regułę routingu"+ },+ "types": {+ "default_location": {+ "description": "Preferuje lokalizację magazynową oznaczoną jako domyślna",+ "name": "Domyślna lokalizacja"},- "metric_short": {- "sales": "Sprzedaż",- "orders": "Zamówienia",- "avg_order_value": "Śr. wart."+ "minimize_splits": {+ "description": "Preferuje lokalizację, która samodzielnie zrealizuje najwięcej pozycji, unikając dzielenia przesyłek",+ "name": "Minimalizuj podziały"},- "columns": {- "product": "Produkt",- "price": "Cena",- "sold": "Sprzedano"+ "preferred_location": {+ "description": "Realizuj z lokalizacji przypiętej do zamówienia, jeśli została ustawiona",+ "name": "Preferowana lokalizacja"}+ }+ },+ "orders": {+ "columns": {+ "customer": "Klient",+ "date": "Data",+ "fulfillment": "Realizacja",+ "items": "Pozycje",+ "number": "Numer",+ "payment": "Płatność",+ "sku": "SKU",+ "tags": "Tagi"},- "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"+ "detail": {+ "add_line_item": {+ "title": "Dodaj pozycję"},- "invite_sheet": {- "title": "Zaproś współpracownika",- "description": "Wyślemy mu e-mailem link do ustawienia hasła."+ "address_edit": {+ "billing_title": "Edytuj adres rozliczeniowy",+ "shipping_title": "Edytuj adres wysyłki"+ },+ "adjustment_lines": {+ "add_discount": "Dodaj rabat",+ "add_discount_description": "Tworzy ręczny rabat. Bez wskazania pozycji kwota zostanie rozdzielona na wszystkie pozycje.",+ "add_fee": "Dodaj opłatę",+ "add_fee_description": "Tworzy opłatę, np. dopłatę, koszt obsługi lub pakowanie na prezent.",+ "amount_field": "Kwota",+ "delete_discount_message": "Usunąć rabat „{{label}}” z tego zamówienia? Sumy zostaną przeliczone.",+ "delete_discount_title": "Usuń rabat",+ "delete_fee_message": "Usunąć opłatę „{{label}}” z tego zamówienia? Sumy zostaną przeliczone.",+ "delete_fee_title": "Usuń opłatę",+ "discounts": "Rabaty",+ "empty": "Brak podatków, rabatów lub opłat dla tego zamówienia.",+ "fees": "Opłaty",+ "kind_field": "Rodzaj",+ "kind_promotion": "Promocja",+ "label_field": "Etykieta",+ "target_field": "Dotyczy",+ "target_order": "Całe zamówienie",+ "taxes": "Podatki",+ "title": "Podatki, rabaty i opłaty",+ "value_field": "Wartość",+ "value_type_field": "Typ",+ "value_type_flat": "Kwota",+ "value_type_percent": "Procent"},- "edit_sheet": {- "title": "Edytuj współpracownika"+ "completed_prefix": "Zrealizowano",+ "confirm": {+ "approve_message": "Zatwierdzić to zamówienie?",+ "cancel_message": "Czy na pewno chcesz anulować to zamówienie?",+ "cancel_shipment_message": "Anulować tę realizację?",+ "capture_message": "Pobrać tę płatność?",+ "complete_message": "Sfinalizować teraz to zamówienie robocze?",+ "remove_gift_card_message": "Usunąć tę kartę podarunkową z zamówienia?",+ "remove_item_message": "Usunąć tę pozycję z zamówienia?",+ "remove_store_credit_message": "Usunąć kredyt sklepowy z zamówienia?",+ "resume_message": "Wznowić to anulowane zamówienie?",+ "ship_message": "Wysłać tę realizację?",+ "void_message": "Unieważnić tę płatność?"},- "actions": {- "resend": "Wyślij ponownie",- "remove": "Usuń z zespołu"+ "dropdown": {+ "cancel_shipment": "Anuluj wysyłkę",+ "complete_order": "Sfinalizuj zamówienie",+ "edit_quantity": "Edytuj ilość",+ "preview_order": "Podgląd zamówienia",+ "resend_confirmation": "Wyślij ponownie potwierdzenie",+ "void_payment": "Unieważnij płatność"},- "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."+ "edit_quantity": {+ "description": "Ustaw ilość dla tej pozycji.",+ "title": "Edytuj ilość"},- "order_routing_rules": {- "title": "Reguły routingu zamówień",- "help": "Przy strategii routingu „Reguły (uporządkowane)” reguły są oceniane od góry do dołu — wygrywa pierwsza reguła, która jednoznacznie wskaże lokalizację magazynową; przy remisie decyduje kolejna reguła.",- "empty": "Brak reguł routingu — zamówienia trafiają do domyślnej lokalizacji magazynowej.",- "add_cta": "Dodaj regułę",- "picker_title": "Dodaj regułę routingu",- "edit_preferences": "Edytuj ustawienia reguły",- "active_toggle": "Reguła aktywna",- "delete_confirm": {- "title": "Usunąć regułę routingu?",- "message": "{{name}} zostanie usunięta z kolejności routingu tego kanału."- }+ "errors": {+ "approve_failed": "Nie udało się zatwierdzić zamówienia",+ "cancel_failed": "Nie udało się anulować zamówienia",+ "complete_failed": "Nie udało się sfinalizować zamówienia",+ "confirmation_send_failed": "Nie udało się wysłać potwierdzenia",+ "resume_failed": "Nie udało się wznowić zamówienia"},- "search_placeholder": "Szukaj kanałów sprzedaży…",- "no_channels_found": "Nie znaleziono kanałów sprzedaży",- "validation": {- "code_format": "Tylko małe litery, cyfry, myślniki i podkreślenia"- }- },- "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"+ "gift_card_section": {+ "applied_suffix": "zastosowano",+ "apply_balance": "Zastosuj dostępne saldo klienta",+ "apply_dialog_description": "Wprowadź kod karty podarunkowej, aby zastosować ją do tego zamówienia.",+ "apply_dialog_title": "Zastosuj kartę podarunkową",+ "code_placeholder": "GIFT-XXXX-YYYY",+ "gift_card_label": "Karta podarunkowa",+ "none_applied": "Brak zastosowanych",+ "requires_customer": "Wymaga klienta",+ "store_credit_label": "Kredyt sklepowy",+ "title": "Karta podarunkowa i kredyt sklepowy"},- "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…"+ "items_table": {+ "item": "Pozycja",+ "price": "Cena",+ "qty": "Ilość"+ },+ "load_failed_message": "Nie udało się załadować zamówienia {{orderId}}.",+ "messages": {+ "approved": "Zamówienie zatwierdzone",+ "canceled": "Zamówienie anulowane",+ "captured": "Płatność pobrana",+ "completed": "Zamówienie sfinalizowane",+ "confirmation_sent": "Potwierdzenie wysłane",+ "resumed": "Zamówienie wznowione",+ "shipped": "Realizacja wysłana",+ "voided": "Płatność unieważniona"+ },+ "no_customer": "Brak informacji o kliencie",+ "no_line_items": "Brak pozycji",+ "payment_form": {+ "amount_help": "Pozostaw puste, aby użyć domyślnie pozostałego salda.",+ "capture_immediately": "Pobierz natychmiast",+ "description": "Obciąż metodę płatności w ramach tego zamówienia.",+ "method_label": "Metoda płatności",+ "method_placeholder": "Wybierz metodę płatności",+ "no_saved_cards": "Klient nie ma zapisanych kart dla tej metody płatności.",+ "source_label": "Źródło",+ "source_placeholder": "Wybierz zapisaną kartę…",+ "source_requires_customer": "Ta metoda płatności wymaga zapisanego źródła. Najpierw przypisz klienta do zamówienia.",+ "title": "Dodaj płatność"+ },+ "payments_table": {+ "method": "Metoda",+ "number": "Numer",+ "state": "Stan"+ },+ "section_customer_note": "Specjalne instrukcje",+ "section_internal_note": "Notatka wewnętrzna",+ "summary": {+ "adjustments": "Korekty",+ "approved_by": "Zatwierdzone przez",+ "canceled_at": "Anulowano",+ "canceler": "Anulujący",+ "outstanding_balance": "Pozostałe saldo",+ "payment_total": "Suma płatności",+ "promotions": "Promocje",+ "tax_additional": "Podatek (dodatkowy)",+ "tax_included": "Podatek (wliczony)"+ },+ "tracking": {+ "add_title": "Dodaj śledzenie",+ "description": "Zaktualizuj numer śledzenia dla tej przesyłki.",+ "edit_title": "Edytuj śledzenie",+ "label": "Numer śledzenia",+ "prefix": "Śledzenie",+ "shipped_prefix": "Wysłano"+ },+ "variant_search": {+ "description": "Wyszukaj wariant produktu, aby dodać go do tego zamówienia.",+ "empty": "Nie znaleziono wariantów",+ "label": "Wyszukaj wariant",+ "placeholder": "Wpisz nazwę produktu lub SKU (min. 3 znaki)…",+ "sku_prefix": "SKU"+ }+ },+ "fulfillment_statuses": {+ "backorder": "Zamówienie oczekujące",+ "canceled": "Anulowane",+ "fulfilled": "Zrealizowane",+ "partial": "Częściowa",+ "pending": "Oczekująca",+ "ready": "Gotowe"+ },+ "item_count_few": "{{count}} pozycje",+ "item_count_many": "{{count}} pozycji",+ "item_count_one": "{{count}} pozycja",+ "item_count_other": "{{count}} pozycji",+ "new": {+ "add_variant": "Dodaj wariant",+ "creates_draft_note": "Tworzy zamówienie robocze. Dodaj płatności i sfinalizuj je po utworzeniu.",+ "items_table": {+ "qty": "Ilość",+ "sku": "SKU",+ "variant": "Wariant"+ },+ "use_default_addresses": "Użyj domyślnych adresów rozliczeniowego i wysyłki klienta"+ },+ "payment_statuses": {+ "balance_due": "Należność",+ "credit_owed": "Nadpłata",+ "failed": "Nieudana",+ "paid": "Opłacone",+ "void": "Unieważnione"+ },+ "statuses": {+ "canceled": "Anulowane",+ "draft": "Szkic",+ "placed": "Złożone"+ },+ "table": {+ "empty": "Nie znaleziono zamówień",+ "search_placeholder": "Szukaj zamówień…"+ }+ },+ "pages": {+ "channels": {+ "add_cta": "Nowy kanał sprzedaży",+ "add_sheet_title": "Dodaj kanał sprzedaży",+ "create_description": "Kanały sprzedaży grupują zamówienia i oferty produktów — „online”, „pos”, integracja z marketplace itp.",+ "create_label": "Utwórz kanał sprzedaży",+ "delete_confirm": {+ "message": "{{name}} zostanie usunięty. Produkty i zamówienia z nim powiązane stracą odniesienie do kanału sprzedaży.",+ "title": "Usunąć kanał sprzedaży?"+ },+ "edit_description": "Zmień nazwę kanału sprzedaży lub wstrzymaj go. Nieaktywne kanały sprzedaży przestają przyjmować zamówienia.",+ "edit_sheet_title": "Edytuj kanał sprzedaży",+ "empty_message": "Brak kanałów sprzedaży",+ "no_channels_found": "Nie znaleziono kanałów sprzedaży",+ "order_routing_rules": {+ "active_toggle": "Reguła aktywna",+ "add_cta": "Dodaj regułę",+ "delete_confirm": {+ "message": "{{name}} zostanie usunięta z kolejności routingu tego kanału.",+ "title": "Usunąć regułę routingu?"+ },+ "edit_preferences": "Edytuj ustawienia reguły",+ "empty": "Brak reguł routingu — zamówienia trafiają do domyślnej lokalizacji magazynowej.",+ "help": "Przy strategii routingu „Reguły (uporządkowane)” reguły są oceniane od góry do dołu — wygrywa pierwsza reguła, która jednoznacznie wskaże lokalizację magazynową; przy remisie decyduje kolejna reguła.",+ "picker_title": "Dodaj regułę routingu",+ "title": "Reguły routingu zamówień"},+ "search_placeholder": "Szukaj kanałów sprzedaży…",+ "title": "Kanały sprzedaży",+ "validation": {+ "code_format": "Tylko małe litery, cyfry, myślniki i podkreślenia"+ }+ },+ "customers": {+ "create_label": "Utwórz klienta","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",+ "add_address": "Dodaj adres",+ "addresses_empty": "Brak zapisanych adresów.",+ "edit_address": "Edytuj adres",+ "edit_credit": "Edytuj kredyt sklepowy",+ "issue_credit": "Przyznaj kredyt sklepowy",+ "orders_empty": "Brak zamówień.",+ "section_addresses": "Adresy","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"+ "section_orders": "Zamówienia",+ "section_profile": "Profil",+ "section_store_credit": "Kredyt sklepowy",+ "section_tags": "Tagi",+ "stat_avg_order_value": "Średnia wartość zamówienia",+ "stat_orders": "Zamówienia",+ "stat_total_spent": "Łącznie wydano",+ "store_credit_empty": "Nie przyznano kredytu sklepowego."+ },+ "edit_sheet_title": "Edytuj klienta",+ "groups": {+ "add_cta": "Dodaj grupę klientów",+ "add_sheet_title": "Dodaj grupę klientów",+ "edit_sheet_title": "Edytuj grupę klientów",+ "title": "Grupy klientów"+ },+ "groups_cta": "Grupy klientów",+ "new_cta": "Nowy klient"+ },+ "getting_started": {+ "description": "Ukończ te kroki, aby uruchomić swój sklep.",+ "progress": "{{done}} z {{total}} ukończone",+ "storefront_sheet": {+ "api_url_label": "Adres URL Store API",+ "deploy_button": "Wdróż na Vercel",+ "deploy_copy": "Wdrożenie klonuje sklep open-source na Twoje konto Git i buduje go na Vercel z wypełnionymi danymi uwierzytelniającymi. Po zakończeniu skopiuj jego adres URL do pola poniżej.",+ "deploy_title": "Zalecane: wdróż oficjalny sklep Next.js",+ "description": "Użyj tych danych uwierzytelniających w dowolnym kliencie łączącym się ze Store API — sklepie internetowym, aplikacji mobilnej lub czymkolwiek innym.",+ "env_description": "Adres URL Store API oraz publiczny klucz API Twojego Spree. Oba są wstępnie wypełnione — w razie potrzeby dostosuj je przed wdrożeniem.",+ "invalid_url": "To nie wygląda na prawidłowy adres URL sklepu.",+ "key_error": "Nie udało się załadować publicznego klucza API.",+ "local_installation_instructions": "Instrukcje instalacji lokalnej",+ "publishable_key_label": "Publiczny klucz API",+ "save": "Zapisz i zakończ konfigurację",+ "saved": "Adres URL sklepu zapisany: {{url}}",+ "see_online_demo": "Zobacz demo online",+ "storefront_url_help": "Adres URL, którego klienci używają, aby dotrzeć do Twojego sklepu. Staje się podstawą linków w wiadomościach e-mail i jest automatycznie dodawany jako dozwolone źródło, aby sklepy przeglądarkowe mogły korzystać ze Store API.",+ "storefront_url_label": "Adres URL sklepu",+ "storefront_url_placeholder": "https://myshop.com",+ "title": "Połącz swój sklep"+ },+ "tasks": {+ "add_products": {+ "cta": "Dodaj produkty",+ "description": "Dodaj produkty do swojego sklepu — własne lub zaproś zewnętrznych sprzedawców do wspólnej sprzedaży.",+ "import_cta": "Importuj produkty z pliku CSV",+ "title": "Dodaj produkty"},- "empty_payments": "Brak płatności.",- "empty_shipments": "Brak przesyłek.",- "no_delivery_method": "Nie wybrano metody dostawy.",- "empty_history": "Brak historii.",+ "set_customer_support_email": {+ "cta": "Ustawienia e-mail",+ "description": "Wyświetlany w Twoim sklepie jako punkt kontaktowy dla pytań i wsparcia klientów.",+ "title": "Ustaw e-mail obsługi klienta"+ },+ "setup_payment_method": {+ "cta": "Skonfiguruj płatności",+ "description": "Aby przyjmować płatności, skonfiguruj co najmniej jednego dostawcę płatności online.",+ "title": "Skonfiguruj metody płatności"+ },+ "setup_storefront": {+ "cta": "Połącz sklep",+ "description": "Połącz swój sklep internetowy lub aplikację mobilną za pomocą danych uwierzytelniających Store API i zapisz adres URL sklepu.",+ "title": "Skonfiguruj sklep"+ },+ "setup_taxes_collection": {+ "cta": "Ustawienia podatków",+ "description": "Aby pobierać podatki, skonfiguruj stawki podatkowe.",+ "title": "Skonfiguruj pobieranie podatków"+ }+ },+ "title": "Pierwsze kroki"+ },+ "home": {+ "columns": {+ "price": "Cena",+ "product": "Produkt",+ "sold": "Sprzedano"+ },+ "metric_short": {+ "avg_order_value": "Śr. wart.",+ "orders": "Zamówienia",+ "sales": "Sprzedaż"+ },+ "metrics": {+ "avg_order_value": "Śr. wartość zamówienia",+ "orders": "Łączna liczba zamówień",+ "sales": "Łączna sprzedaż"+ },+ "subtitle": "Przegląd wyników Twojego sklepu",+ "title": "Pulpit",+ "top_products": "Najlepsze produkty",+ "top_products_description": "Najlepiej sprzedające się produkty w Twoim sklepie."+ },+ "orders": {+ "detail": {"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"+ "refund": "Zwrot środków",+ "resume": "Wznów",+ "ship": "Oznacz jako wysłane",+ "void": "Unieważnij"},"dialogs": {- "cancel_title": "Anulować zamówienie?","approve_title": "Zatwierdzić zamówienie?",+ "cancel_title": "Anulować zamówienie?","refund_title": "Zwrócić płatność?"+ },+ "empty_history": "Brak historii.",+ "empty_payments": "Brak płatności.",+ "empty_shipments": "Brak przesyłek.",+ "no_delivery_method": "Nie wybrano metody dostawy.",+ "section_billing_address": "Adres rozliczeniowy",+ "section_customer": "Klient",+ "section_customer_note": "Notatka klienta",+ "section_fulfillments": "Realizacje",+ "section_history": "Historia",+ "section_internal_note": "Notatka wewnętrzna",+ "section_items": "Pozycje",+ "section_payments": "Płatności",+ "section_shipping_address": "Adres dostawy",+ "section_summary": "Podsumowanie",+ "summary": {+ "channel": "Kanał sprzedaży",+ "created_by": "Utworzone przez",+ "ip_address": "Adres IP",+ "locale": "Język",+ "market": "Rynek"}+ },+ "drafts_title": "Wersje robocze zamówień",+ "new": {+ "add_line_item": "Dodaj pozycję",+ "search_variant": "Szukaj wariantu…",+ "section_billing": "Rozliczenie",+ "section_customer": "Klient",+ "section_items": "Pozycje",+ "section_notes": "Notatki",+ "section_summary": "Podsumowanie",+ "select_customer": "Wybierz klienta",+ "title": "Nowe zamówienie"}},"products": {"add_cta": "Dodaj produkt",- "new": {- "title": "Nowy produkt",- "description": "Skonfiguruj swój produkt — dodaj warianty, ceny, stan magazynowy, multimedia i pola niestandardowe",- "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",- "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_add_failed": "Nie udało się dodać produktów do kategorii",+ "categories_add_title": "Dodaj do kategorii",+ "categories_added": "Dodano {n} produktów do kategorii","categories_remove_description": "Wybierz kategorie, z których chcesz usunąć te produkty.",- "channels_add_title": "Dodaj do kanałów sprzedaży",+ "categories_remove_failed": "Nie udało się usunąć produktów z kategorii",+ "categories_remove_title": "Usuń z kategorii",+ "categories_removed": "Usunięto {n} produktów z kategorii","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_add_failed": "Nie udało się wystawić produktów na kanałach sprzedaży",+ "channels_add_title": "Dodaj do kanałów sprzedaży",+ "channels_added": "Wystawiono {n} produktów na kanałach 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.",+ "channels_remove_failed": "Nie udało się wycofać produktów z kanałów sprzedaży",+ "channels_remove_title": "Usuń z kanałów sprzedaży",+ "channels_removed": "Wycofano {n} produktów z kanałów sprzedaży","delete_confirm": {- "title": "Usunąć {n} produktów?",- "message": "Wybrane produkty zostaną usunięte. Tej operacji nie można cofnąć."+ "message": "Wybrane produkty zostaną usunięte. Tej operacji nie można cofnąć.",+ "title": "Usunąć {n} produktów?"},- "status_updated": "Zaktualizowano status {n} produktów",+ "delete_failed": "Nie udało się usunąć produktów",+ "deleted": "Usunięto {n} produktów",+ "remove_categories_action": "Usuń z kategorii…",+ "remove_channels_action": "Usuń z kanałów sprzedaży…",+ "remove_tags_action": "Usuń tagi…",+ "set_status_action": "Ustaw status…",+ "status_sheet_description": "Wybierz status do zastosowania do wybranych produktów.",+ "status_sheet_title": "Ustaw status produktu","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",+ "status_updated": "Zaktualizowano status {n} produktów",+ "tags_add_description": "Wybierz lub utwórz tagi, które chcesz dodać do tych produktów.","tags_add_failed": "Nie udało się dodać tagów",- "tags_removed": "Usunięto tagi z {n} produktów",+ "tags_add_title": "Dodaj tagi",+ "tags_added": "Dodano tagi do {n} produktów",+ "tags_remove_description": "Wybierz tagi, które chcesz usunąć z tych 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"+ "tags_remove_title": "Usuń tagi",+ "tags_removed": "Usunięto tagi z {n} produktów"},- "media_empty": "Brak multimediów.",- "media_upload": "Prześlij multimedia",- "variants_empty": "Brak wariantów.",- "status_options": {- "draft": "Wersja robocza",- "active": "Aktywne",- "archived": "Zarchiwizowany"+ "clone_failed": "Nie udało się zduplikować produktu",+ "clone_succeeded": "Produkt zduplikowany",+ "delete_failed": "Nie udało się usunąć produktu",+ "delete_succeeded": "Produkt usunięty",+ "edit": {+ "bulk_prices": {+ "no_variants": "Dodaj co najmniej jeden wariant, aby rozpocząć edycję cen."+ }},"inventory": {- "out_of_stock": "Brak w magazynie",+ "in_stock": "{{count}} w magazynie","on_backorder": "Na zamówienie",- "in_stock": "{{count}} w magazynie"+ "out_of_stock": "Brak 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."+ "media_empty": "Brak multimediów.",+ "media_upload": "Prześlij multimedia",+ "new": {+ "create_failed": "Nie udało się utworzyć produktu",+ "create_succeeded": "Produkt utworzony",+ "description": "Skonfiguruj swój produkt — dodaj warianty, ceny, stan magazynowy, multimedia i pola niestandardowe",+ "preview_slug_placeholder": "twoj-slug-produktu",+ "save_label": "Utwórz produkt",+ "title": "Nowy produkt"},"options": {+ "add_value": "Dodaj wartość opcji","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"- }+ },+ "values_empty": "Brak wartości.",+ "values_section": "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."+ "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}}).",+ "title": "Aktywować cennik?"},+ "add_cta": "Nowy cennik",+ "add_products_cta": "Dodaj produkty",+ "add_rule": "Dodaj regułę",+ "add_rule_help": "Wybierz typ reguły do skonfigurowania.",+ "basics_section": "Podstawy",+ "deactivate": "Dezaktywuj","deactivate_confirm": {- "title": "Dezaktywować cennik?",- "message": "„{{name}}” natychmiast przestanie obowiązywać klientów. Istniejące zamówienia pozostają bez zmian."+ "message": "„{{name}}” natychmiast przestanie obowiązywać klientów. Istniejące zamówienia pozostają bez zmian.",+ "title": "Dezaktywować cennik?"},- "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."+ "delete_confirm": {+ "message": "Usunięcie „{{name}}” spowoduje usunięcie jego cen. Tej operacji nie można cofnąć.",+ "title": "Usunąć cennik?"},"edit_prices": {- "title": "Edytuj ceny — {{name}}",- "currency_label": "Waluta",- "empty": "Brak produktów na tym cenniku.","add_products_link": "Dodaj produkty","columns": {+ "compare_at_price": "Cena porównawcza",+ "price": "Cena","product": "Produkt",- "variant": "Wariant","sku": "SKU",- "price": "Cena",- "compare_at_price": "Cena porównawcza"+ "variant": "Wariant"},- "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_few": "{{count}} ceny w {{currency}}",+ "count_summary_many": "{{count}} cen w {{currency}}","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.",+ "currency_label": "Waluta",+ "dirty_summary_few": "{{count}} niezapisane zmiany",+ "dirty_summary_many": "{{count}} niezapisanych zmian","dirty_summary_one": "{{count}} niezapisana zmiana","dirty_summary_other": "{{count}} niezapisanych zmian","discard_confirm": {- "title": "Odrzucić niezapisane ceny?",+ "message_close_few": "Masz {{count}} niezapisane ceny. Zamknięcie spowoduje ich odrzucenie.",+ "message_close_many": "Masz {{count}} niezapisanych cen. Zamknięcie spowoduje ich odrzucenie.","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."+ "title": "Odrzucić niezapisane ceny?"},- "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",+ "empty": "Brak produktów na tym cenniku.",+ "empty_no_base_prices": "Brak cen podstawowych.",+ "empty_pick_products": "Wybierz produkty na cenniku, aby rozpocząć ustawianie cen.",+ "grid_aria": "Ceny wariantów",+ "no_matches_for_filters": "Brak cen pasujących do bieżących filtrów.",+ "no_matches_for_search": "Brak cen pasujących do „{{search}}”.",+ "price_aria": "Cena dla {{label}}",+ "save_cta": "Zapisz ceny",+ "save_failed": "Nie udało się zapisać cen","save_success_few": "Zapisano {{count}} ceny",- "save_success_many": "Zapisano {{count}} cen"+ "save_success_many": "Zapisano {{count}} cen",+ "save_success_one": "Zapisano {{count}} cenę",+ "save_success_other": "Zapisano {{count}} cen",+ "search_placeholder": "Szukaj po produkcie, SKU lub opcji…",+ "title": "Edytuj ceny — {{name}}",+ "variant_default": "Domyślny"},- "products_empty": "Brak produktów — dodaj jeden, aby rozpocząć edycję cen.",+ "edit_prices_cta": "Edytuj ceny","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ć.",+ "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.",+ "products_empty": "Brak produktów — dodaj jeden, aby rozpocząć edycję cen.",+ "products_empty_search": "Brak pasujących produktów",+ "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_section": "Produkty","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",- "tab_storefront_access": "Dostęp do sklepu"- },- "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.",- "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"+ "products_selected_many": "Wybrano {{count}} produktów.",+ "products_selected_one": "Wybrano {{count}} produkt.",+ "products_selected_other": "Wybrano {{count}} produktów.",+ "remove_rule_confirm": {+ "message": "Reguła zostanie usunięta po zapisaniu cennika.",+ "title": "Usunąć regułę?"},- "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",- "channel": "Channel",- "all_channels": "All channels"+ "remove_selected": "Usuń zaznaczone",+ "rule_click_to_configure": "Kliknij, aby skonfigurować",+ "rule_default_description": "Dostosuj parametry reguły.",+ "rule_name_overflow": "{{names}} +{{count}} więcej",+ "rule_no_options": "Ta reguła nie ma konfigurowalnych opcji — jej obecność sama w sobie nakłada ograniczenie.",+ "rule_types_all_used": "Każdy dostępny typ reguły jest już na tym cenniku.",+ "rule_types_empty": "Brak zarejestrowanych typów reguł.",+ "rules_empty": "Brak reguł — ten cennik dotyczy każdego kupującego.",+ "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_section": "Reguły",+ "schedule": "Zaplanuj",+ "schedule_confirm": {+ "message": "„{{name}}” zostanie uruchomiony {{starts_at}} i pozostanie aktywny do swojej daty zakończenia.",+ "title": "Zaplanować cennik?"},- "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"+ "schedule_section": "Harmonogram",+ "sheet_title_create": "Utwórz cennik",+ "sheet_title_edit": "Edytuj cennik",+ "subtitle": "Ceny ukierunkowane na grupy klientów, regiony lub progi ilościowe.",+ "title": "Cenniki",+ "unschedule": "Anuluj harmonogram",+ "unschedule_confirm": {+ "message": "„{{name}}” nie będzie już aktywowany w zaplanowanej dacie. Możesz go później ponownie zaplanować lub aktywować ręcznie.",+ "title": "Anulować harmonogram cennika?"}},- "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"+ "publishing": {+ "caption_hidden_after": "Zniknie {{date}}",+ "caption_live": "Widoczny dla klientów teraz",+ "caption_not_available": "Ukryty — produkt ma status {{product_status}}",+ "caption_scheduled": "Pojawi się {{date}}",+ "caption_unpublished": "Został ukryty {{date}}",+ "caption_window": "Aktywny {{start}} → {{end}}",+ "empty": "Jeszcze nie wystawiony w żadnym kanale sprzedaży.",+ "inactive_marker": "Nieaktywny",+ "manage_cta": "Zarządzaj",+ "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.",+ "manage_title": "Zarządzaj kanałami sprzedaży",+ "no_channels": "Brak dostępnych kanałów sprzedaży. Utwórz jeden w Ustawienia → Kanały sprzedaży.",+ "status_hidden": "Ukryty",+ "status_live": "Aktywny",+ "status_not_available": "Niedostępny",+ "status_scheduled": "Zaplanowany",+ "title": "Publikacja"},- "stock_locations": {- "add_sheet_title": "Dodaj lokalizację magazynową",- "edit_sheet_title": "Edytuj lokalizację magazynową",- "search_placeholder": "Szukaj lokalizacji magazynowych…"+ "section_basics": "Podstawy",+ "section_categorization": "Kategoryzacja",+ "section_inventory": "Stan magazynowy",+ "section_media": "Multimedia",+ "section_organization": "Organizacja",+ "section_pricing": "Ceny",+ "section_seo": "SEO",+ "section_variants": "Warianty",+ "status_options": {+ "active": "Aktywne",+ "archived": "Zarchiwizowany",+ "draft": "Wersja robocza"},- "allowed_origins": {- "add_sheet_title": "Dodaj dozwolone źródło",- "edit_sheet_title": "Edytuj dozwolone źródło"+ "transfers": {+ "description_external": "Przyjęcie zewnętrzne do <strong>{{destination}}</strong>.",+ "description_internal": "Stan magazynowy przeniesiony z <strong>{{source}}</strong> do <strong>{{destination}}</strong>.",+ "edit_sheet_title": "Transfer {{number}}",+ "items_empty": "Brak pozycji.",+ "section_from": "Z",+ "section_items": "Pozycje",+ "section_to": "Do",+ "sheet_title": "Nowy transfer magazynowy"},- "imports": {- "title": "Importy",- "search_placeholder": "Szukaj po numerze…",- "empty_title": "Brak importów",- "table": {- "number": "Numer",- "type": "Typ",- "status": "Status",- "rows": "Wiersze",- "failed_count": "{{failed}} nieudanych"- },- "delete_confirm": {- "title": "Usunąć import?",- "message": "Spowoduje to usunięcie {{number}}, jego wierszy i przesłanego pliku."- }- }+ "variants_empty": "Brak wariantów.",+ "variants_few": "{{count}} warianty",+ "variants_many": "{{count}} wariantów",+ "variants_one": "{{count}} wariant",+ "variants_other": "{{count}} wariantów"+ },+ "profile": {+ "load_failed_title": "Nie udało się załadować Twojego profilu",+ "personal_details": "Dane osobowe",+ "subtitle": "Zarządzaj swoimi danymi osobowymi i językiem administratora.",+ "title": "Profil"},"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"+ "create_label": "Utwórz kartę podarunkową",+ "delete_confirm": {+ "message": "Spowoduje to unieważnienie karty podarunkowej i uniemożliwi jej realizację.",+ "title": "Usunąć kartę podarunkową?"+ },+ "edit_sheet_title": "Karta podarunkowa",+ "new_cta": "Nowa karta podarunkowa",+ "new_sheet_title": "Nowa karta podarunkowa",+ "no_customer": "Brak przypisanego klienta",+ "not_found": "Nie znaleziono karty podarunkowej.",+ "prefix": {+ "auto_placeholder": "Generowany automatycznie, gdy puste",+ "label": "Prefiks",+ "placeholder": "np. WELCOME — kody będą miały postać WELCOME-abc123"},"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"+ "status_options": {+ "expired": "Wygasła",+ "redeemed": "Zrealizowana",+ "void": "Unieważniona"},- "no_customer": "Brak przypisanego klienta","usage": {- "title": "Wykorzystanie",- "used": "Wykorzystano",+ "issued_by": "Wydane przez","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"- },- "getting_started": {- "title": "Pierwsze kroki",- "description": "Ukończ te kroki, aby uruchomić swój sklep.",- "progress": "{{done}} z {{total}} ukończone",- "tasks": {- "setup_payment_method": {- "title": "Skonfiguruj metody płatności",- "description": "Aby przyjmować płatności, skonfiguruj co najmniej jednego dostawcę płatności online.",- "cta": "Skonfiguruj płatności"- },- "add_products": {- "title": "Dodaj produkty",- "description": "Dodaj produkty do swojego sklepu — własne lub zaproś zewnętrznych sprzedawców do wspólnej sprzedaży.",- "cta": "Dodaj produkty",- "import_cta": "Importuj produkty z pliku CSV"- },- "set_customer_support_email": {- "title": "Ustaw e-mail obsługi klienta",- "description": "Wyświetlany w Twoim sklepie jako punkt kontaktowy dla pytań i wsparcia klientów.",- "cta": "Ustawienia e-mail"- },- "setup_taxes_collection": {- "title": "Skonfiguruj pobieranie podatków",- "description": "Aby pobierać podatki, skonfiguruj stawki podatkowe.",- "cta": "Ustawienia podatków"+ "title": "Wykorzystanie",+ "used": "Wykorzystano"},- "setup_storefront": {- "title": "Skonfiguruj sklep",- "description": "Połącz swój sklep internetowy lub aplikację mobilną za pomocą danych uwierzytelniających Store API i zapisz adres URL sklepu.",- "cta": "Połącz sklep"+ "validation": {+ "amount_positive": "Kwota musi być większa od zera",+ "amount_required": "Kwota jest wymagana",+ "currency_required": "Waluta jest wymagana",+ "prefix_required": "Prefiks jest wymagany dla partii"}},- "storefront_sheet": {- "title": "Połącz swój sklep",- "description": "Użyj tych danych uwierzytelniających w dowolnym kliencie łączącym się ze Store API — sklepie internetowym, aplikacji mobilnej lub czymkolwiek innym.",- "api_url_label": "Adres URL Store API",- "publishable_key_label": "Publiczny klucz API",- "deploy_title": "Zalecane: wdróż oficjalny sklep Next.js",- "deploy_copy": "Wdrożenie klonuje sklep open-source na Twoje konto Git i buduje go na Vercel z wypełnionymi danymi uwierzytelniającymi. Po zakończeniu skopiuj jego adres URL do pola poniżej.",- "deploy_button": "Wdróż na Vercel",- "env_description": "Adres URL Store API oraz publiczny klucz API Twojego Spree. Oba są wstępnie wypełnione — w razie potrzeby dostosuj je przed wdrożeniem.",- "storefront_url_label": "Adres URL sklepu",- "storefront_url_help": "Adres URL, którego klienci używają, aby dotrzeć do Twojego sklepu. Staje się podstawą linków w wiadomościach e-mail i jest automatycznie dodawany jako dozwolone źródło, aby sklepy przeglądarkowe mogły korzystać ze Store API.",- "save": "Zapisz i zakończ konfigurację",- "saved": "Adres URL sklepu zapisany: {{url}}",- "invalid_url": "To nie wygląda na prawidłowy adres URL sklepu.",- "see_online_demo": "Zobacz demo online",- "local_installation_instructions": "Instrukcje instalacji lokalnej",- "key_error": "Nie udało się załadować publicznego klucza API.",- "storefront_url_placeholder": "https://myshop.com"- }- }- },- "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",- "validation": {- "role_required": "Wybierz rolę",- "roles_required": "Wybierz co najmniej jedną rolę"- }- },- "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ąć."+ "loading": "Ładowanie promocji…",+ "new_title": "Nowa promocja"},- "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?"+ "settings": {+ "allowed_origins": {+ "add_sheet_title": "Dodaj dozwolone źródło",+ "edit_sheet_title": "Edytuj dozwolone źródło"},- "store_credit": {- "title": "Kredyt sklepowy",- "empty": "Nie wydano żadnych kredytów sklepowych",- "table": {- "used": "Wykorzystano",- "remaining": "Pozostało",- "category": "Kategoria",- "memo": "Notatka"+ "api_keys": {+ "empty_publishable": "Brak kluczy publicznych.",+ "empty_secret": "Brak kluczy tajnych.",+ "new_cta": "Nowy klucz",+ "publishable_help": "Używane przez Twój sklep internetowy. Bezpieczne do udostępnienia w kodzie po stronie klienta.",+ "publishable_section": "Klucze publiczne",+ "save_secret_description": "Skopiuj tę wartość teraz — nie pokażemy jej ponownie.",+ "save_secret_title": "Zapisz swój klucz tajny",+ "scope_badge": {+ "full_access": "Pełny dostęp",+ "read_all": "Odczyt wszystkiego"},- "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."- },- "groups": {- "title": "Grupy klientów",- "empty": "W żadnej grupie",- "edit_title": "Edytuj grupy klientów",- "edit_description": "Dodaj lub usuń grupy, do których należy ten klient.",- "save_failed": "Nie udało się zaktualizować grup klientów"- }- },- "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?"+ "secret_help": "Tylko serwer-serwer. Ogranicz zakres każdego klucza do operacji, których potrzebuje.",+ "secret_section": "Klucze tajne",+ "subtitle": "Autoryzuj integracje i aplikacje do wywoływania Admin API.",+ "table": {+ "all_channels": "All channels",+ "channel": "Channel",+ "key": "Klucz",+ "last_used_at": "Ostatnio użyto",+ "scopes": "Zakresy"+ },+ "title": "Klucze API"},- "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ść"+ "custom_field_definitions": {+ "add_sheet_title": "Dodaj pole niestandardowe",+ "edit_sheet_title": "Edytuj pole niestandardowe"},- "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"+ "emails": {+ "load_failed_title": "Nie udało się załadować ustawień e-mail",+ "logo_dimensions_help": "Zalecane: 204×104 piksele.",+ "section_addresses": "Adresy e-mail",+ "section_delivery": "Dostarczanie",+ "section_logo": "Logo",+ "subtitle": "Adresy nadawców, powiadomienia i logo umieszczane w e-mailach transakcyjnych.",+ "title": "Ustawienia e-mail"},- "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"+ "imports": {+ "delete_confirm": {+ "message": "Spowoduje to usunięcie {{number}}, jego wierszy i przesłanego pliku.",+ "title": "Usunąć import?"+ },+ "empty_title": "Brak importów",+ "search_placeholder": "Szukaj po numerze…",+ "table": {+ "failed_count": "{{failed}} nieudanych",+ "number": "Numer",+ "rows": "Wiersze",+ "status": "Status",+ "type": "Typ"+ },+ "title": "Importy"},- "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)…"+ "markets": {+ "add_sheet_title": "Dodaj rynek",+ "edit_sheet_title": "Edytuj rynek"},- "edit_quantity": {- "title": "Edytuj ilość",- "description": "Ustaw ilość dla tej pozycji."+ "payment_methods": {+ "add_sheet_title": "Dodaj metodę płatności",+ "edit_sheet_title": "Edytuj metodę płatności"},- "items_table": {- "item": "Pozycja",- "price": "Cena",- "qty": "Ilość"+ "stock_locations": {+ "add_sheet_title": "Dodaj lokalizację magazynową",+ "edit_sheet_title": "Edytuj lokalizację magazynową",+ "search_placeholder": "Szukaj lokalizacji magazynowych…"},- "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"+ "store": {+ "subtitle": "Ogólna konfiguracja i domyślne ustawienia dla całego sklepu.",+ "tab_general": "Ogólne",+ "tab_standards": "Standardy i formaty",+ "tab_storefront_access": "Dostęp do sklepu",+ "title": "Ustawienia sklepu"},- "payments_table": {- "number": "Numer",- "method": "Metoda",- "state": "Stan"+ "tax_categories": {+ "add_sheet_title": "Dodaj kategorię podatkową",+ "edit_sheet_title": "Edytuj kategorię podatkową"},- "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ę…"+ "webhooks": {+ "actions": {+ "disable": "Wyłącz",+ "enable": "Włącz ponownie",+ "redeliver": "Dostarcz ponownie",+ "send_test": "Wyślij test",+ "view_deliveries": "Wyświetl dostarczenia"+ },+ "add_sheet_title": "Dodaj punkt końcowy webhooka",+ "delete_confirm": {+ "message": "{{name}} natychmiast przestanie otrzymywać dostarczenia. Dotychczasowa historia dostarczeń również zostanie usunięta.",+ "title": "Usunąć punkt końcowy webhooka?"+ },+ "deliveries": {+ "detail": {+ "copy_payload_aria": "Kopiuj ładunek żądania",+ "copy_response_aria": "Kopiuj treść odpowiedzi",+ "delivered_at": "Dostarczono",+ "error_type": "Typ błędu",+ "event": "Zdarzenie",+ "execution_time": "Czas wykonania",+ "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.",+ "response_code": "Kod odpowiedzi",+ "url": "Docelowy URL"+ },+ "detail_sheet_title": "Szczegóły dostarczenia",+ "empty": "Brak dostarczeń — wyślij test, aby zweryfikować swój punkt końcowy.",+ "redeliver_queued": "Ponowne dostarczenie dodane do kolejki.",+ "search_placeholder": "Szukaj po nazwie zdarzenia…",+ "status": {+ "error": "Błąd",+ "failure": "Nieudane",+ "pending": "Oczekujące",+ "success": "Udane"+ },+ "table": {+ "code": "Odpowiedź",+ "delivered_at": "Dostarczono",+ "event": "Zdarzenie",+ "execution_time": "Czas trwania"+ },+ "test_failed": "Nie udało się wysłać testowego webhooka.",+ "test_sent": "Testowy webhook dodany do kolejki."+ },+ "deliveries_sheet_title": "Ostatnie dostarczenia",+ "detail": {+ "delete_label": "Usuń punkt końcowy",+ "details_title": "Szczegóły",+ "edit_title": "Edytuj punkt końcowy",+ "load_failed_title": "Nie udało się załadować tego punktu końcowego webhooka",+ "subscriptions": "Zdarzenia",+ "url": "Docelowy URL"+ },+ "edit_sheet_title": "Edytuj punkt końcowy webhooka",+ "empty_description": "Utwórz punkt końcowy, aby otrzymywać podpisane żądanie POST za każdym razem, gdy wyzwalane jest subskrybowane zdarzenie.",+ "empty_title": "Brak punktów końcowych webhooków",+ "event_groups": {+ "asset": "Zasób",+ "custom": "Niestandardowe",+ "customer": "Klient",+ "digital": "Cyfrowy",+ "fulfillment": "Realizacja",+ "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",+ "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ń"+ },+ "events_all": "Wszystkie zdarzenia",+ "events_count_few": "{{count}} zdarzenia",+ "events_count_many": "{{count}} zdarzeń",+ "events_count_one": "{{count}} zdarzenie",+ "events_count_other": "{{count}} zdarzeń",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "Usuń {{event}}",+ "health": {+ "auto_disabled_alert": "Ten punkt końcowy został automatycznie wyłączony po wielokrotnych niepowodzeniach dostarczenia.",+ "degraded": "Pogorszony ({{percentage}}%)",+ "disabled": "Wyłączony",+ "failing": "Zawodny ({{percentage}}%)",+ "healthy": "Sprawny ({{percentage}}%)",+ "label": "Kondycja",+ "metric_failed": "Nieudane",+ "metric_successful": "Udane",+ "metric_total": "Dostarczenia",+ "no_deliveries": "Brak dostarczeń",+ "re_enable_cta": "Włącz ponownie",+ "row_counters_failed_few": "{{count}} nieudane",+ "row_counters_failed_many": "{{count}} nieudanych",+ "row_counters_failed_one": "{{count}} nieudane",+ "row_counters_failed_other": "{{count}} nieudanych",+ "row_counters_successful_few": "{{count}} udane",+ "row_counters_successful_many": "{{count}} udanych",+ "row_counters_successful_one": "{{count}} udane",+ "row_counters_successful_other": "{{count}} udanych"+ },+ "new_cta": "Nowy punkt końcowy",+ "save_secret_description": "Weryfikuj podpisy przychodzących webhooków za pomocą tego klucza. Nie pokażemy go ponownie.",+ "save_secret_title": "Zapisz swój sekret podpisujący",+ "search_placeholder": "Szukaj po URL…",+ "status": {+ "disabled": "Automatycznie wyłączony",+ "disabled_reason": "Wyłączony: {{reason}}",+ "inactive": "Nieaktywny"+ },+ "subtitle": "Subskrybuj punkty końcowe HTTPS dla zdarzeń wyzwalanych przez Twój sklep.",+ "table": {+ "copy_url_aria": "Kopiuj URL",+ "events": "Zdarzenia",+ "last_delivery": "Ostatnie dostarczenie",+ "recent_deliveries": "Ostatnie 7 dni",+ "url": "URL"+ },+ "title": "Webhooki"+ }+ },+ "staff": {+ "actions": {+ "remove": "Usuń z zespołu",+ "resend": "Wyślij ponownie"},- "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"+ "edit_sheet": {+ "title": "Edytuj współpracownika"},- "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.",- "code_placeholder": "GIFT-XXXX-YYYY"+ "empty": "Brak członków zespołu",+ "empty_description": "Zaproś współpracownika do współpracy nad tym sklepem.",+ "invitations_section": "Oczekujące zaproszenia",+ "invite_cta": "Zaproś współpracownika",+ "invite_sheet": {+ "description": "Wyślemy mu e-mailem link do ustawienia hasła.",+ "title": "Zaproś współpracownika"},- "address_edit": {- "shipping_title": "Edytuj adres wysyłki",- "billing_title": "Edytuj adres rozliczeniowy"+ "members_section": "Członkowie",+ "messages": {+ "removed": "Usunięto z zespołu",+ "revoked": "Zaproszenie cofnięte",+ "updated": "Zespół zaktualizowany"},- "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ę"+ "subtitle": "Zarządzaj współpracownikami i rolami administratorów",+ "table": {+ "member": "Członek",+ "role": "Rola",+ "roles": "Role"},- "no_line_items": "Brak pozycji"- },- "table": {- "search_placeholder": "Szukaj zamówień…",- "empty": "Nie znaleziono zamówień"- },+ "title": "Zespół"+ }+ },+ "payment_methods": {+ "add_cta": "Dodaj metodę płatności","columns": {- "number": "Numer",- "date": "Data",- "customer": "Klient",- "payment": "Płatność",- "fulfillment": "Realizacja",- "items": "Pozycje",- "tags": "Tagi",- "sku": "SKU"+ "storefront": "Sklep"+ },+ "create_description": "Wybierz dostawcę i skonfiguruj jego dane uwierzytelniające.",+ "create_label": "Utwórz metodę płatności",+ "delete_confirm": {+ "message": "{{name}} nie będzie już dostępna przy realizacji zamówienia.",+ "title": "Usunąć metodę płatności?"},- "item_count_one": "{{count}} pozycja",- "item_count_other": "{{count}} pozycji",- "statuses": {- "draft": "Szkic",- "placed": "Złożone",- "canceled": "Anulowane"+ "edit_description": "Zaktualizuj nazwę, widoczność lub status.",+ "empty": "Nie skonfigurowano metod płatności",+ "messages": {+ "created": "Utworzono metodę płatności",+ "deleted": "Usunięto metodę płatności",+ "updated": "Zaktualizowano metodę płatności"},- "payment_statuses": {- "balance_due": "Należność",- "credit_owed": "Nadpłata",- "failed": "Nieudana",- "paid": "Opłacone",- "void": "Unieważnione"+ "provider_description": "Dostawca: {{provider}}",+ "search_placeholder": "Szukaj według nazwy…",+ "status": {+ "disabled": "Wyłączona"},- "fulfillment_statuses": {- "backorder": "Zamówienie oczekujące",- "canceled": "Anulowane",- "partial": "Częściowa",- "pending": "Oczekująca",- "ready": "Gotowe",- "fulfilled": "Zrealizowane"+ "storefront": {+ "admin_only": "Tylko panel administracyjny",+ "visible": "Widoczna"},- "item_count_few": "{{count}} pozycje",- "item_count_many": "{{count}} pozycji"+ "title": "Metody płatności"+ },+ "preferences": {+ "additional_item": "Koszt każdej kolejnej pozycji",+ "amount": "Kwota",+ "base_amount": "Kwota podstawowa",+ "base_percent": "Procent podstawowy",+ "currency": "Waluta",+ "discount_amount": "Kwota rabatu",+ "first_item": "Koszt pierwszej pozycji",+ "flat_percent": "Stały procent",+ "max_items": "Maksymalna liczba pozycji",+ "max_quantity": "Maksymalna ilość",+ "min_quantity": "Minimalna ilość",+ "minimal_amount": "Kwota minimalna",+ "normal_amount": "Kwota normalna",+ "percent": "Procent",+ "preferred_amount": "Kwota",+ "preferred_percent": "Procent"},"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",+ "columns": {+ "in_stock": "Na stanie",+ "price": "Cena",+ "sku": "SKU"+ },+ "delete_confirm": "Czy na pewno chcesz usunąć ten produkt?",+ "delete_label": "Usuń produkt",+ "inventory": {+ "backorder_aria": "Zezwól na zamówienia oczekujące w lokalizacji {{location}}",+ "columns": {+ "backorder": "Zamówienie oczekujące",+ "location": "Lokalizacja",+ "on_hand": "Na stanie"+ },+ "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.",+ "on_hand_aria": "Na stanie w lokalizacji {{location}}",+ "unknown_location": "Nieznana lokalizacja"+ },"media": {+ "assigned_variants_help": "Wybierz warianty, które reprezentuje to zdjęcie. Pozostaw puste, aby zastosować do wszystkich wariantów.",+ "assigned_variants_label": "Przypisane warianty","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.",+ "file_types_hint": "PNG, JPG, WebP do 10 MB","upload_failed": "Nie udało się przesłać {{name}}: {{message}}","upload_status_failed": "Niepowodzenie"},+ "no_categories_found": "Nie znaleziono kategorii",+ "options": {+ "add_cta": "Dodaj typ opcji",+ "count_few": "{{count}} wartości",+ "count_many": "{{count}} wartości",+ "count_one": "{{count}} wartość",+ "count_other": "{{count}} wartości",+ "create_description": "Zdefiniuj opcję, której mogą używać warianty (np. rozmiar, kolor).",+ "create_label": "Utwórz typ opcji",+ "delete_confirm": {+ "message": "Spowoduje to również usunięcie wszystkich jego wartości. Warianty korzystające z tych wartości je utracą.",+ "title": "Usunąć typ opcji?"+ },+ "edit_description": "Edytuj typ opcji i jego wartości.",+ "image_upload_failed": "Nie udało się przesłać obrazu",+ "kinds": {+ "buttons": "Przyciski",+ "color_swatch": "Próbka koloru",+ "dropdown": "Lista rozwijana"+ },+ "value_label_placeholder": "np. Małe",+ "value_name_placeholder": "np. small",+ "values_help": "Przeciągnij wartości, aby zmienić kolejność. Pierwsza wartość jest domyślna dla nowych wariantów."+ },+ "price_lists": {+ "errors": {+ "failed_to_activate": "Nie udało się aktywować cennika",+ "failed_to_deactivate": "Nie udało się dezaktywować cennika"+ },+ "messages": {+ "activated": "Aktywowano cennik",+ "created": "Utworzono cennik",+ "deactivated": "Dezaktywowano cennik",+ "deleted": "Usunięto cennik",+ "updated": "Zaktualizowano cennik"+ },+ "validation": {+ "ends_after_starts": "Musi być po dacie rozpoczęcia."+ }+ },+ "save_label": "Zapisz produkt","seo": {- "slug_placeholder": "adres-url-produktu",+ "meta_description_placeholder": "Opis SEO","meta_title_placeholder": "Tytuł SEO",- "meta_description_placeholder": "Opis SEO"+ "slug_placeholder": "adres-url-produktu"},"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)",+ "delete_confirm": {+ "message": "Ruchy magazynowe utworzone przez ten transfer zostaną cofnięte.",+ "title": "Usunąć ten transfer?"+ },"destination_placeholder": "Wybierz lokalizację docelową",+ "details_card": "Szczegóły","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)…",+ "external_label": "Zewnętrzny (przyjęcie od dostawcy)",+ "fields": {+ "created": "Utworzono",+ "external_receive": "Przyjęcie zewnętrzne",+ "immutable_note": "Transfery magazynowe są niezmienne po utworzeniu.",+ "internal": "Wewnętrzny",+ "reference": "Numer referencyjny",+ "type": "Typ"+ },"items_table": {- "variant": "Wariant",+ "qty": "Ilość","sku": "SKU",- "qty": "Ilość"+ "variant": "Wariant"},- "delete_confirm": {- "title": "Usunąć ten transfer?",- "message": "Ruchy magazynowe utworzone przez ten transfer zostaną cofnięte."+ "new_cta": "Nowy transfer",+ "reference_label": "Numer referencyjny",+ "reference_placeholder": "Numer zamówienia, faktura dostawcy, …",+ "review_description": "Sprawdź transfer przed utworzeniem. Pozycji nie można później zmienić.",+ "search_items_placeholder": "Szukaj według nazwy lub SKU (min. 3 znaki)…"+ },+ "variant_media_picker": {+ "add_count_one": "Dodaj {{count}}",+ "add_count_other": "Dodaj {{count}}",+ "empty_all_linked": "Wszystkie media produktu są już powiązane z tym wariantem.",+ "empty_no_media": "Brak mediów produktu — najpierw prześlij obrazy do produktu.",+ "title": "Wybierz z galerii produktu",+ "trigger": "Wybierz z galerii produktu"+ },+ "variants": {+ "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",+ "default_variant": "Wariant domyślny",+ "edit_row_aria": "Edytuj {{name}}",+ "edit_variant": "Edytuj wariant — {{name}}",+ "errors": {+ "failed_to_create_option_type": "Nie udało się utworzyć typu opcji",+ "failed_to_create_value": "Nie udało się utworzyć wartości"+ },+ "keep": "Zachowaj wszystkie",+ "option_type_label": "Typ opcji",+ "option_type_placeholder": "Wybierz typ opcji",+ "orphan_warning": "{{count}} istniejący(ch) wariant(ów) zostanie usuniętych 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_one": "{{count}} istniejący wariant nie pasuje już do wybranych opcji i zostanie usunięty przy zapisie:",+ "orphan_warning_other": "{{count}} istniejących wariantów nie pasuje już do wybranych opcji i zostanie usuniętych przy zapisie:",+ "remove_row_aria": "Usuń {{name}}",+ "sheet": {+ "availability": "Dostępność",+ "identity": "Tożsamość",+ "tax_category_placeholder": "Dziedzicz z produktu"+ },+ "title": "Warianty",+ "variant_label": "Wariant"+ }+ },+ "promotions": {+ "action_edit": {+ "description": "Skonfiguruj parametry akcji.",+ "no_options": "Ta akcja nie ma konfigurowalnych opcji."+ },+ "action_picker": {+ "description": "Wybierz, co ma się stać, gdy promocja zostanie spełniona.",+ "title": "Dodaj akcję"+ },+ "action_summary": {+ "variant_count": "{{count}} wariantów"+ },+ "action_types": {+ "create_adjustment": {+ "description": "Tworzy korektę kredytową promocji dla zamówienia",+ "name": "Utwórz korektę dla całego zamówienia"+ },+ "create_item_adjustments": {+ "description": "Tworzy korektę kredytową promocji dla pozycji zamówienia",+ "name": "Utwórz korektę dla poszczególnych pozycji"+ },+ "create_line_items": {+ "description": "Dodaje do koszyka określoną ilość wariantu",+ "name": "Utwórz pozycje zamówienia"+ },+ "free_shipping": {+ "description": "Sprawia, że wszystkie przesyłki w zamówieniu są bezpłatne",+ "name": "Darmowa wysyłka"+ }+ },+ "actions_card": {+ "add_action": "Dodaj akcję",+ "description": "Co się dzieje, gdy promocja zostanie spełniona.",+ "empty": "Brak akcji. Promocja bez akcji nie powoduje żadnego efektu po zastosowaniu."+ },+ "basics_card": {+ "title": "Podstawowe informacje"+ },+ "code": {+ "automatic": "Automatyczna",+ "multi": "multi"+ },+ "coupon_codes": {+ "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.",+ "export_csv": "Eksportuj CSV",+ "states": {+ "partially_used": "Częściowo wykorzystany",+ "used": "Wykorzystany"+ },+ "title": "Kody kuponów",+ "unused": "Nieużyty",+ "used": "Użyty"+ },+ "delete_confirm": {+ "default_name": "Ta promocja",+ "message": "{{name}} zostanie trwale usunięta. Promocji powiązanych z zrealizowanymi zamówieniami nie można usunąć.",+ "title": "Usunąć promocję?"+ },+ "errors": {+ "failed_to_add_action": "Nie udało się dodać akcji",+ "failed_to_add_rule": "Nie udało się dodać reguły",+ "failed_to_remove_action": "Nie udało się usunąć akcji",+ "failed_to_remove_rule": "Nie udało się usunąć reguły",+ "failed_to_update_action": "Nie udało się zaktualizować akcji",+ "failed_to_update_rule": "Nie udało się zaktualizować reguły"+ },+ "generate_code": {+ "title": "Wygeneruj losowy kod"+ },+ "kinds": {+ "automatic": "Automatyczna (bez kodu)",+ "coupon_code": "Kod kuponu"+ },+ "match_policies": {+ "all": "Wszystkie reguły muszą być spełnione",+ "all_hint": "Wszystkie reguły muszą być spełnione.",+ "any": "Dowolna reguła może być spełniona",+ "any_hint": "Dowolna reguła może być spełniona."+ },+ "messages": {+ "action_added": "Dodano akcję",+ "action_removed": "Usunięto akcję",+ "action_updated": "Zaktualizowano akcję",+ "rule_added": "Dodano regułę",+ "rule_removed": "Usunięto regułę",+ "rule_updated": "Zaktualizowano regułę"+ },+ "remove_action_confirm": {+ "message": "Zostanie usunięta po zapisaniu promocji.",+ "title": "Usunąć akcję?"+ },+ "remove_rule_confirm": {+ "message": "Zostanie usunięta po zapisaniu promocji.",+ "title": "Usunąć regułę?"+ },+ "rule_edit": {+ "description": "Dostosuj parametry reguły.",+ "no_options": "Ta reguła nie ma konfigurowalnych opcji — sama jej obecność wymusza ograniczenie."+ },+ "rule_picker": {+ "description": "Wybierz typ reguły do skonfigurowania.",+ "title": "Dodaj regułę"+ },+ "rule_summary": {+ "category_count": "{{count}} kategorii",+ "customer_count": "{{count}} klientów",+ "product_count": "{{count}} produktów"+ },+ "rule_types": {+ "category": {+ "description": "Zamówienie zawiera produkty z określonych kategorii",+ "name": "Kategorie"+ },+ "country": {+ "description": "Ogranicz do zamówień z adresem dostawy w określonym kraju",+ "name": "Kraj"+ },+ "currency": {+ "description": "Ogranicz do zamówień w określonej walucie",+ "name": "Waluta"+ },+ "customer": {+ "description": "Dostępne tylko dla określonych klientów",+ "name": "Klienci"+ },+ "customer_group": {+ "description": "Dostępne tylko dla klientów z określonych grup klientów",+ "name": "Grupa(-y) klientów"+ },+ "customer_logged_in": {+ "description": "Dostępne tylko dla zalogowanych klientów",+ "name": "Tylko zalogowani klienci"+ },+ "first_order": {+ "description": "Musi być pierwszym zamówieniem klienta",+ "name": "Pierwsze zamówienie"+ },+ "item_total": {+ "description": "Suma zamówienia spełnia te kryteria",+ "name": "Wartość produktów"+ },+ "one_use_per_user": {+ "description": "Tylko jedno użycie na użytkownika",+ "name": "Jedno użycie na użytkownika"+ },+ "option_value": {+ "description": "Zamówienie zawiera produkty z pasującymi wartościami opcji",+ "name": "Wartość (wartości) opcji"},- "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."+ "product": {+ "description": "Zamówienie zawiera określone produkty",+ "name": "Produkt(y)"}},- "options": {- "kinds": {- "dropdown": "Lista rozwijana",- "color_swatch": "Próbka koloru",- "buttons": "Przyciski"+ "rule_types_all_used": "Każdy dostępny typ reguły jest już przypisany do tej promocji.",+ "rule_types_empty": "Brak zarejestrowanych typów reguł.",+ "rules": {+ "category": {+ "empty": "Brak pasujących kategorii",+ "label": "Kategorie",+ "match_policy": {+ "all": {+ "description": "Zamówienie musi zawierać produkt z każdej kategorii.",+ "label": "Wszystkie te kategorie"+ },+ "any": {+ "description": "Zamówienie musi zawierać produkt z co najmniej jednej.",+ "label": "Dowolna z tych kategorii"+ }+ },+ "search_placeholder": "Szukaj kategorii…"},- "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ą."+ "channel": {+ "label": "Kanały"},- "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ść",- "availability": "Dostępność",- "tax_category_placeholder": "Dziedzicz z produktu"+ "country": {+ "empty": "Brak pasujących krajów",+ "label": "Kraje",+ "search_placeholder": "Szukaj krajów…"},- "errors": {- "failed_to_create_value": "Nie udało się utworzyć wartości",- "failed_to_create_option_type": "Nie udało się utworzyć typu opcji"- }- },- "inventory": {- "columns": {- "location": "Lokalizacja",- "on_hand": "Na stanie",- "backorder": "Zamówienie oczekujące"+ "customer": {+ "empty": "Brak pasujących klientów",+ "label": "Klienci",+ "search_placeholder": "Szukaj klientów po nazwie lub adresie e-mail…"},- "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.",- "unknown_location": "Nieznana lokalizacja"- },- "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"+ "customer_group": {+ "empty": "Brak pasujących grup klientów",+ "label": "Grupy klientów",+ "search_placeholder": "Szukaj grup klientów…"},- "errors": {- "failed_to_activate": "Nie udało się aktywować cennika",- "failed_to_deactivate": "Nie udało się dezaktywować cennika"+ "market": {+ "label": "Rynki"},- "validation": {- "ends_after_starts": "Musi być po dacie rozpoczęcia."+ "product": {+ "empty": "Brak pasujących produktów",+ "label": "Produkty",+ "match_policy": {+ "all": {+ "description": "Zamówienie musi zawierać każdy produkt.",+ "label": "Wszystkie te produkty"+ },+ "any": {+ "description": "Zamówienie musi zawierać co najmniej jeden.",+ "label": "Dowolny z tych produktów"+ },+ "none": {+ "description": "Zamówienie nie może zawierać żadnego z nich.",+ "label": "Żaden z tych produktów"+ }+ },+ "search_placeholder": "Szukaj produktów po nazwie…"}},- "variant_media_picker": {- "trigger": "Wybierz z galerii produktu",- "title": "Wybierz z galerii produktu",- "empty_no_media": "Brak mediów produktu — najpierw prześlij obrazy do produktu.",- "empty_all_linked": "Wszystkie media produktu są już powiązane z tym wariantem.",- "add_count_one": "Dodaj {{count}}",- "add_count_other": "Dodaj {{count}}"- }- },- "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."+ "rules_card": {+ "add_rule": "Dodaj regułę",+ "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).",+ "title": "Reguły"},- "title": "Metody płatności",- "search_placeholder": "Szukaj według nazwy…",- "empty": "Nie skonfigurowano metod płatności",- "columns": {- "storefront": "Sklep"+ "schedule_card": {+ "title": "Harmonogram i limity"},- "storefront": {- "visible": "Widoczna",- "admin_only": "Tylko panel administracyjny"+ "table": {+ "empty": "Brak promocji",+ "no_end": "Bez końca",+ "search_placeholder": "Szukaj według nazwy…"},- "status": {- "disabled": "Wyłączona"+ "trigger_card": {+ "title": "Wyzwalacz"},- "messages": {- "created": "Utworzono metodę płatności",- "updated": "Zaktualizowano metodę płatności",- "deleted": "Usunięto metodę płatności"+ "trigger_summary": {+ "locked_help": "Ustawień wyzwalacza nie można zmienić po utworzeniu. Aby je zmienić, utwórz nową promocję.",+ "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:"+ },+ "validation": {+ "code_required": "Kod jest wymagany (lub kliknij Wygeneruj)",+ "expiry_after_start": "Data wygaśnięcia musi być późniejsza niż data rozpoczęcia",+ "number_of_codes_required": "Wybierz, ile kodów wygenerować",+ "prefix_required": "Prefiks jest wymagany dla partii wielu kodów"}},- "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"+ "settings": {+ "webhooks": {+ "errors": {+ "redeliver_failed": "Ponowne dostarczenie nie powiodło się",+ "send_test_failed": "Nie udało się wysłać testowego webhooka"+ },+ "messages": {+ "removed": "Usunięto punkt końcowy webhooka",+ "updated": "Zaktualizowano punkt końcowy webhooka"+ }}},- "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"+ "settings_nav": {+ "groups": {+ "audit": "Audyt",+ "fulfillment": "Realizacja zamówień",+ "payments": "Płatności i podatki",+ "store": "Sklep",+ "team": "Zespół i dostęp"},- "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"+ "items": {+ "allowed_origins": "Dozwolone źródła",+ "api_keys": "Klucze API",+ "channels": "Kanały sprzedaży",+ "custom_field_definitions": "Pola niestandardowe",+ "delivery_methods": "Metody dostawy",+ "delivery_zones": "Strefy dostawy",+ "emails": "Wiadomości e-mail",+ "imports": "Importy",+ "markets": "Rynki",+ "payment_methods": "Metody płatności",+ "profile": "Profil",+ "staff": "Zespół",+ "stock_locations": "Lokalizacje magazynowe",+ "store": "Sklep",+ "tax_categories": "Kategorie podatkowe",+ "webhooks": "Webhooki"}},- "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"+ "staff": {+ "actions": {+ "copy_invitation_link": "Kopiuj link z zaproszeniem",+ "invitation_link_copied": "Link z zaproszeniem skopiowany"},- "delete_confirm": {- "title": "Usunąć pole niestandardowe?",- "message": "{{label}} zostanie usunięte wraz z każdą zapisaną dla niego wartością."+ "actions_aria": "Akcje",+ "autocomplete": {+ "empty": "Brak pasującego personelu",+ "placeholder": "Szukaj personelu…"},- "messages": {- "created": "Definicja pola niestandardowego utworzona",- "updated": "Definicja pola niestandardowego zaktualizowana",- "deleted": "Definicja pola niestandardowego usunięta"+ "confirm": {+ "remove_message": "{{name}} utraci dostęp do tego sklepu.",+ "remove_title": "Usunąć ze sklepu?",+ "revoke_message": "{{email}} nie będzie już mógł zaakceptować tego zaproszenia.",+ "revoke_title": "Cofnąć zaproszenie?"+ },+ "edit": {+ "roles_label": "Role dla tego sklepu"},+ "edit_description": "Zaktualizuj dane profilu i przypisane role tego członka personelu.","errors": {- "failed_to_create": "Nie udało się utworzyć definicji pola niestandardowego",- "failed_to_update": "Nie udało się zaktualizować definicji pola niestandardowego",- "failed_to_delete": "Nie udało się usunąć definicji pola niestandardowego"- }- },- "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"+ "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"},- "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."+ "invite": {+ "email_placeholder": "[email protected]",+ "no_roles": "Brak dostępnych ról.",+ "roles_loading": "Wczytywanie ról…",+ "roles_placeholder": "Wybierz rolę"},+ "validation": {+ "role_required": "Wybierz rolę",+ "roles_required": "Wybierz co najmniej jedną rolę"+ }+ },+ "stock_items": {"messages": {- "added": "Dodano dozwolone źródło",- "updated": "Zaktualizowano dozwolone źródło",- "removed": "Usunięto dozwolone źródło"+ "stock_item_deleted": "Usunięto pozycję magazynową",+ "stock_updated": "Zaktualizowano stan magazynowy"}},"stock_locations": {"add_cta": "Dodaj lokalizację magazynową",- "create_label": "Utwórz lokalizację magazynową",+ "badges": {+ "default": "Domyślna",+ "enabled": "Włączone",+ "inactive": "Nieaktywna"+ },+ "columns": {+ "default": "Domyślna",+ "location": "Lokalizacja",+ "pickup": "Odbiór",+ "type": "Typ"+ },"create_description": "Dodaj magazyn, sklep lub punkt odbioru, z którego będą realizowane zamówienia.",+ "create_label": "Utwórz lokalizację magazynową",+ "delete_confirm": {+ "message": "{{name}} zostanie usunięta. Produkty na stanie w tej lokalizacji nie zostaną usunięte.",+ "title": "Usunąć lokalizację magazynową?"+ },"edit_description": "Zaktualizuj nazwę, adres, odbiór lub zasady dotyczące zapasów.",+ "empty": "Brak lokalizacji magazynowych","kinds": {- "warehouse": "Magazyn",+ "fulfillment_center": "Centrum realizacji zamówień","store": "Sklep",- "fulfillment_center": "Centrum realizacji zamówień"+ "warehouse": "Magazyn"},"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."+ "any": "Zezwól na transfery z innych lokalizacji",+ "local": "Tylko produkty w tej lokalizacji"},+ "search_placeholder": "Szukaj według nazwy…","section_pickup": "Odbiór","stock_items": {- "title": "Zapasy w tej lokalizacji",+ "empty": "Brak zapasów w tej lokalizacji.",+ "empty_search": "Żadne zapasy nie pasują do wyszukiwania.","help": "Dostosuj liczbę dostępnych i możliwych do zamówienia z opóźnieniem dla każdego wariantu.",+ "low_stock_marker": "niski stan","search_placeholder": "Szukaj SKU lub produktu…","table": {- "variant": "Wariant",+ "backorder": "Zamówienie oczekujące","on_hand": "Na stanie",- "backorder": "Zamówienie oczekujące"+ "variant": "Wariant"},- "empty": "Brak zapasów w tej lokalizacji.",- "empty_search": "Żadne zapasy nie pasują do wyszukiwania.",+ "title": "Zapasy w tej lokalizacji","unknown_product": "Nieznany produkt","variant_count_one": "{{count}} wariant",- "variant_count_other": "{{count}} wariantów",- "low_stock_marker": "niski stan"- },- "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"+ "variant_count_other": "{{count}} wariantów"}},"stock_transfers": {- "title": "Transfery magazynowe",- "table": {- "search_placeholder": "Szukaj według numeru lub referencji…",- "empty": "Brak transferów magazynowych"- },"columns": {- "number": "Numer","direction": "Kierunek",+ "number": "Numer","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"+ "external_receive": "Przyjęcie zewnętrzne",+ "internal": "Transfer między lokalizacjami"},"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",- "min_quantity": "Minimalna ilość",- "max_quantity": "Maksymalna ilość"- },- "channels": {- "messages": {- "created": "Kanał utworzony",- "updated": "Kanał zaktualizowany",- "deleted": "Kanał usunięty"- }- },- "order_routing_rules": {- "messages": {- "created": "Dodano regułę routingu",- "deleted": "Usunięto regułę routingu"+ "failed_to_delete": "Nie udało się usunąć przesunięcia magazynowego",+ "failed_to_record": "Nie udało się zarejestrować przesunięcia magazynowego"},- "types": {- "preferred_location": {- "name": "Preferowana lokalizacja",- "description": "Realizuj z lokalizacji przypiętej do zamówienia, jeśli została ustawiona"- },- "minimize_splits": {- "name": "Minimalizuj podziały",- "description": "Preferuje lokalizację, która samodzielnie zrealizuje najwięcej pozycji, unikając dzielenia przesyłek"- },- "default_location": {- "name": "Domyślna lokalizacja",- "description": "Preferuje lokalizację magazynową oznaczoną jako domyślna"- }- }- },- "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"+ "deleted": "Usunięto przesunięcie magazynowe",+ "recorded": "Zarejestrowano przesunięcie magazynowe"},- "autocomplete": {- "placeholder": "Szukaj grup klientów…",- "empty": "Brak pasujących grup klientów"- }+ "table": {+ "empty": "Brak transferów magazynowych",+ "search_placeholder": "Szukaj według numeru lub referencji…"+ },+ "title": "Transfery magazynowe"},- "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ę"- }+ "store": {+ "load_failed_title": "Nie udało się załadować ustawień sklepu",+ "unit_systems": {+ "imperial": "Imperialny",+ "metric": "Metryczny"+ },+ "weight_units": {+ "g": "Gram (g)",+ "kg": "Kilogram (kg)",+ "lb": "Funt (lb)",+ "oz": "Uncja (oz)"}},- "stock_items": {+ "tax_categories": {+ "add_cta": "Dodaj kategorię podatkową",+ "create_description": "Grupuj produkty według sposobu opodatkowania (standardowa, obniżona, zwolniona, …).",+ "create_label": "Utwórz kategorię podatkową",+ "delete_confirm": {+ "message": "{{name}} zostanie usunięta. Produkty w tej kategorii zostaną przypisane do domyślnej.",+ "title": "Usunąć kategorię podatkową?"+ },+ "edit_description": "Zaktualizuj nazwę, kod lub oznaczenie domyślne.",+ "empty": "Brak kategorii podatkowych","messages": {- "stock_updated": "Zaktualizowano stan magazynowy",- "stock_item_deleted": "Usunięto pozycję magazynową"- }+ "created": "Kategoria podatkowa utworzona",+ "deleted": "Kategoria podatkowa usunięta",+ "updated": "Kategoria podatkowa zaktualizowana"+ },+ "search_placeholder": "Szukaj według nazwy…"},"translations": {- "title": "Tłumaczenia",- "locale": "Język",- "source": "Źródło",- "save": "Zapisz tłumaczenia",- "saved": "Tłumaczenia zapisane",- "save_error": "Nie można zapisać tłumaczeń",- "no_locales": "Dodaj więcej języków do swojego sklepu, aby przetłumaczyć ten produkt.",- "manage": "Zarządzaj tłumaczeniami",- "field": "Pole","coverage_summary": "Przetłumaczono {{translated}} z {{total}} języków","dirty_summary": "{{count}} niezapisanych zmian","discard_confirm": {- "title": "Odrzucić zmiany?",- "message": "Masz {{count}} niezapisanych zmian tłumaczeń. Odrzucić je?"+ "message": "Masz {{count}} niezapisanych zmian tłumaczeń. Odrzucić je?",+ "title": "Odrzucić zmiany?"},+ "field": "Pole",+ "load_error": "Nie można załadować tłumaczeń",+ "locale": "Język",+ "manage": "Zarządzaj tłumaczeniami",+ "no_locales": "Dodaj więcej języków do swojego sklepu, aby przetłumaczyć ten produkt.","original": "Oryginał",- "load_error": "Nie można załadować tłumaczeń"- },- "categories": {- "title": "Kategorie",- "add_cta": "Nowa kategoria",- "empty": "Brak kategorii.",- "expand": "Rozwiń",- "collapse": "Zwiń",- "delete_confirm": "Usunąć kategorię „{{name}}” i wszystkie jej podkategorie?",- "columns": {- "name": "Nazwa",- "products": "Produkty"- },- "fields": {- "parent": {- "label": "Kategoria nadrzędna",- "placeholder": "Najwyższy poziom"- }- },- "messages": {- "created": "Kategoria utworzona",- "updated": "Kategoria zaktualizowana",- "deleted": "Kategoria usunięta",- "move_failed": "Nie udało się przenieść kategorii"- },- "seo": {- "title": "Optymalizacja pod wyszukiwarki",- "preview_slug_placeholder": "slug-kategorii"- },- "products_count_one": "{{count}} produkt",- "products_count_other": "{{count}} produktów",- "search_placeholder": "Szukaj kategorii…",- "no_results": "Brak pasujących kategorii.",- "new_title": "Nowa kategoria",- "delete_label": "Usuń kategorię",- "images": {- "title": "Obrazy",- "label": "Obraz",- "square_label": "Obraz kwadratowy",- "help": "Używany w banerach kategorii. Zalecane 1920×1080.",- "square_help": "Używany w kompaktowej nawigacji. Zalecane 400×400."- },- "navigation": {- "title": "Nawigacja"- },- "products": {- "title": "Produkty",- "search_placeholder": "Szukaj produktów…",- "empty": "Brak produktów w tej kategorii.",- "remove": "Usuń z kategorii",- "add_cta": "Dodaj produkty",- "picker_title": "Dodaj produkty do kategorii",- "picker_description": "Wyszukaj i wybierz produkty do dodania do tej kategorii.",- "select_all": "Zaznacz wszystko",- "select_row": "Zaznacz produkt",- "remove_selected": "Usuń",- "selected_count_one": "Zaznaczono {{count}}",- "selected_count_other": "Zaznaczono {{count}}",- "column_product": "Produkt",- "filter_placeholder": "Filtruj produkty…",- "no_matches": "Żaden produkt nie pasuje do filtra."- },- "load_failed": "Nie udało się załadować kategorii. Spróbuj ponownie."- },- "imports": {- "download_original": "Pobierz oryginalny plik",- "load_failed": "Nie udało się wczytać importu.",- "try_again": "Spróbuj ponownie",- "wizard_title": "Import",- "steps": {- "map_fields": "Dopasuj pola",- "process_rows": "Przetwórz wiersze",- "complete": "Gotowe"- },- "status": {- "pending": "Oczekujący",- "mapping": "Dopasowywanie",- "completed_mapping": "W kolejce",- "processing": "Przetwarzanie",- "completed": "Zakończony",- "failed": "Nieudany"- },- "types": {- "products": "Produkty",- "customers": "Klienci",- "product_translations": "Tłumaczenia produktów"- },- "mapping": {- "title": "Dopasuj kolumny",- "description": "Dopasuj kolumny z pliku do pól: {{type}}.",- "field": "Pole",- "file_column": "Kolumna pliku",- "sample": "Przykład",- "not_mapped": "Niedopasowane",- "required": "Wymagane",- "missing_required": "Aby kontynuować, dopasuj wymagane pola: {{fields}}",- "start": "Rozpocznij import",- "starting": "Rozpoczynanie…"- },- "processing": {- "title": "Przetwarzanie wierszy",- "preparing": "Przygotowywanie wierszy…",- "progress": "Przetworzono {{processed}} z {{total}} wierszy",- "failed_count": "{{failed}} nieudanych",- "retrying": "Ponawianie nieudanych wierszy · pozostało {{remaining}}",- "note": "Możesz opuścić tę stronę — import będzie kontynuowany w tle."- },- "results": {- "completed_title": "Import zakończony",- "summary": "Zaimportowano {{completed}} wierszy · {{failed}} nieudanych",- "retry_failed": "Ponów nieudane wiersze ({{failed}})",- "retrying": "Ponawianie…",- "view_records": "Zobacz: {{type}}"- },- "failed": {- "title": "Import nieudany",- "description": "Nie udało się przetworzyć pliku."- },- "failed_rows": {- "next_page": "Następna strona",- "prev_page": "Poprzednia strona",- "title": "Nieudane wiersze",- "row_number": "Wiersz",- "error": "Błąd",- "view_data": "Pokaż dane wiersza",- "hide_data": "Ukryj dane wiersza"- }+ "save": "Zapisz tłumaczenia",+ "save_error": "Nie można zapisać tłumaczeń",+ "saved": "Tłumaczenia zapisane",+ "source": "Źródło",+ "title": "Tłumaczenia"}}}diff --git a/packages/dashboard/src/locales/zh-CN.json b/packages/dashboard/src/locales/zh-CN.jsonindex 79e2b84aad..197ced3c35 100644--- a/packages/dashboard/src/locales/zh-CN.json+++ b/packages/dashboard/src/locales/zh-CN.json@@ -1,317 +1,628 @@{"admin": {"a11y": {- "edit_media": "编辑图片",- "delete_image": "删除图片"+ "delete_image": "删除图片",+ "edit_media": "编辑图片"},- "gift_cards": {- "statuses": {- "partially_redeemed": "部分已兑换",- "redeemed": "已兑换",- "canceled": "已取消",- "expired": "已过期"- },- "columns": {- "used": "已使用",- "remaining": "剩余",- "batch": "批次",- "customer": "客户",- "issued_by": "发放人"- },- "table": {- "search_placeholder": "按代码搜索…",- "empty": "暂无礼品卡"+ "allowed_origins": {+ "add_cta": "添加允许的来源",+ "create_description": "从该来源加载的浏览器可以调用管理 API。CORS 允许列表和管理后台 Cookie 会话都依赖此列表——请保持精简。",+ "create_label": "添加来源",+ "delete_confirm": {+ "message": "{{origin}} 将无法再从浏览器调用管理 API。现有的服务器对服务器请求不受影响。",+ "title": "移除允许的来源?"},+ "edit_description": "更新来源会立即改变哪些浏览器可以调用管理 API。",+ "empty": "暂无允许的来源","messages": {- "created": "礼品卡已创建",- "create_failed": "创建礼品卡失败",- "updated": "礼品卡已更新",- "update_failed": "更新礼品卡失败",- "deleted": "礼品卡已删除",- "delete_failed": "删除礼品卡失败",- "batch_created": "礼品卡批次已创建",- "batch_create_failed": "创建礼品卡批次失败"+ "added": "已添加允许的来源",+ "removed": "已移除允许的来源",+ "updated": "已更新允许的来源"},- "batch_autocomplete": {- "placeholder": "按前缀搜索批次…",- "empty": "无匹配的批次"+ "search_placeholder": "按来源搜索…",+ "table_title": "允许的来源",+ "validation": {+ "bare_origin": "必须是纯来源(例如 https://shop.example.com)——不含路径、查询或片段"}},- "option_types": {- "kinds": {- "dropdown": "下拉菜单",- "color_swatch": "颜色样本",- "buttons": "按钮"+ "api_keys": {+ "badge": {+ "never_used": "从未使用",+ "revoked": "已撤销"},- "columns": {- "values": "值"+ "by_email": "由 {{email}}",+ "create_key_cta": "创建密钥",+ "create_sheet_description": "选择密钥类型,然后选择它可以使用的权限范围。",+ "create_sheet_title": "创建 API key",+ "delete_confirm": {+ "message": "此操作将永久删除密钥。如果以后可能需要恢复访问权限,建议改用撤销。",+ "title": "删除密钥?"},- "value_count_one": "{{count}} 个值",- "value_count_other": "{{count}} 个值",- "table": {- "search_placeholder": "按名称搜索…",- "empty": "暂无选项类型"+ "dropdown": {+ "copy_token_aria": "复制 token",+ "revoke": "撤销密钥"},- "messages": {- "created": "选项类型已创建",- "updated": "选项类型已更新",- "deleted": "选项类型已删除"- }- },- "markets": {- "add_cta": "添加市场",- "create_description": "将多个国家/地区归入一个定价区域,使用其专属货币和区域设置。",- "edit_description": "更新名称、货币、区域设置或国家/地区覆盖范围。",- "create_label": "创建市场",- "delete_confirm": {- "title": "删除市场?",- "message": "{{name}} 将被移除。此前在该市场中下达的订单将保持不变。"+ "edit_sheet_description": "重命名此密钥。权限范围在创建密钥时即已固定,无法更改。",+ "edit_sheet_title": "编辑 API key",+ "empty_description": "创建一个以开始使用。",+ "errors": {+ "failed_to_create": "创建密钥失败",+ "failed_to_delete": "删除密钥失败",+ "failed_to_update": "更新密钥失败"},- "search_placeholder": "按名称搜索…",- "empty": "暂无市场",- "tax_inclusive": "含税",- "tax_exclusive": "不含税",+ "key_type": {+ "publishable_description": "可安全地暴露在客户端代码中。授予公开/访客访问权限。",+ "publishable_title": "Publishable key",+ "secret_description": "服务器到服务器。每个密钥都带有明确的权限范围列表。",+ "secret_title": "Secret key"+ },+ "revoke_confirm": {+ "message": "任何使用此密钥的集成都将立即停止工作。",+ "title": "撤销密钥?"+ },+ "scope_picker": {+ "full_access_hint": "— 对每个资源的读取 + 写入",+ "full_access_label": "完全访问 (write_all)",+ "read_all_hint": "— 对每个资源的读取",+ "read_all_label": "全部读取 (read_all)",+ "read_aria": "读取 {{resource}}",+ "read_header": "读取",+ "resource_header": "资源",+ "resources": {+ "api_keys": "API keys",+ "categories": "分类",+ "customers": "客户",+ "dashboard": "仪表盘",+ "fulfillments": "履约",+ "gift_cards": "礼品卡",+ "orders": "订单",+ "payments": "支付",+ "products": "商品",+ "promotions": "优惠",+ "refunds": "退款",+ "settings": "设置",+ "stock": "库存",+ "store_credits": "店铺信用",+ "webhooks": "Webhooks"+ },+ "show_more_aria_one": "显示另外 {{count}} 个权限范围",+ "show_more_aria_other": "显示另外 {{count}} 个权限范围",+ "write_aria": "写入 {{resource}}",+ "write_header": "写入"+ },+ "scopes_immutable_help": "密钥创建后权限范围无法更改。如需更改,请使用所需的权限范围创建一个新密钥,并撤销此密钥。",+ "validation": {+ "scope_required": "请至少选择一个权限范围"+ },+ "warning_treat_like_password": "请像对待密码一样对待此密钥。将其存储在密钥管理器中——我们无法再次显示它。"+ },+ "calculators": {+ "default_refund_amount": "默认退款金额",+ "default_tax": "默认税费",+ "digital_delivery": "数字交付",+ "flat_percent_item_total": "固定百分比",+ "flat_rate": "固定费率",+ "flexi_rate": "弹性费率",+ "per_item": "按件计费",+ "percent_on_line_item": "按订单项百分比",+ "price_sack": "价格袋",+ "tiered_flat_rate": "阶梯固定费率",+ "tiered_percent": "阶梯百分比"+ },+ "categories": {+ "add_cta": "新建分类",+ "collapse": "收起","columns": {- "default": "默认"+ "name": "名称",+ "products": "商品"+ },+ "delete_confirm": "删除分类“{{name}}”及其所有子分类?",+ "delete_label": "删除分类",+ "empty": "暂无分类。",+ "expand": "展开",+ "fields": {+ "parent": {+ "label": "父分类",+ "placeholder": "顶级"+ }+ },+ "images": {+ "help": "用于分类横幅。推荐 1920×1080。",+ "label": "图片",+ "square_help": "用于紧凑导航。推荐 400×400。",+ "square_label": "方形图片",+ "title": "图片"},+ "load_failed": "加载分类失败。请重试。","messages": {- "created": "市场已创建",- "updated": "市场已更新",- "deleted": "市场已删除"+ "created": "分类已创建",+ "deleted": "分类已删除",+ "move_failed": "无法移动分类",+ "updated": "分类已更新"},- "errors": {- "failed_to_create": "创建市场失败",- "failed_to_update": "更新市场失败",- "failed_to_delete": "删除市场失败"- }- },- "errors": {- "not_found_title": "页面未找到",- "not_found_description": "您访问的页面不存在。",- "forbidden_title": "未授权",- "forbidden_description": "您没有权限查看此页面。",- "plugin_route_title": "此页面渲染失败"+ "navigation": {+ "title": "导航"+ },+ "new_title": "新建分类",+ "no_results": "没有匹配的分类。",+ "products": {+ "add_cta": "添加商品",+ "column_product": "商品",+ "empty": "此分类中暂无商品。",+ "filter_placeholder": "筛选商品…",+ "no_matches": "没有商品匹配筛选条件。",+ "picker_description": "搜索并选择要添加到此分类的商品。",+ "picker_title": "向分类添加商品",+ "remove": "从分类中移除",+ "remove_selected": "移除",+ "search_placeholder": "搜索商品…",+ "select_all": "全选",+ "select_row": "选择商品",+ "selected_count_one": "已选择 {{count}} 个",+ "selected_count_other": "已选择 {{count}} 个",+ "title": "商品"+ },+ "products_count_one": "{{count}} 个商品",+ "products_count_other": "{{count}} 个商品",+ "search_placeholder": "搜索分类…",+ "seo": {+ "preview_slug_placeholder": "category-slug",+ "title": "搜索引擎优化"+ },+ "title": "分类"},- "nav": {- "home": "首页",- "account": "账户",- "orders": "订单",- "draft_orders": "草稿订单",- "products": "商品",- "price_lists": "价格表",- "categories": "分类",- "options": "选项",- "transfers": "调拨",- "customers": "客户",- "customer_groups": "分组",- "promotions": "促销",- "gift_cards": "礼品卡",- "reports": "报表",- "settings": "设置",- "getting_started": "快速入门"+ "channels": {+ "messages": {+ "created": "渠道已创建",+ "deleted": "渠道已删除",+ "updated": "渠道已更新"+ }},- "settings_nav": {- "groups": {- "store": "店铺",- "payments": "支付与税务",- "fulfillment": "履约",- "team": "团队与权限",- "audit": "审计"+ "components": {+ "adjustment_action_editor": {+ "calculator_label": "计算器",+ "loading_calculators": "正在加载计算器…",+ "no_extra_settings": "此计算器没有额外设置。",+ "select_calculator": "选择一个计算器",+ "settings_label": "计算器设置"},- "items": {- "store": "店铺",- "emails": "邮件",- "channels": "销售渠道",- "payment_methods": "支付方式",- "tax_categories": "税收类别",- "markets": "市场",- "stock_locations": "库存地点",- "custom_field_definitions": "自定义字段",- "staff": "员工",- "api_keys": "API 密钥",- "webhooks": "Webhooks",- "allowed_origins": "允许的来源",- "profile": "个人资料",- "imports": "导入"+ "custom_fields": {+ "default_resource": "记录",+ "empty_description": "记录结构化的详细信息,例如材质、版型或保养说明。",+ "empty_title": "尚无自定义字段",+ "errors": {+ "failed_to_save": "保存自定义字段失败"+ },+ "manage_in_settings": "在设置中管理",+ "new_definition_description": "定义自定义字段,以在您的{{resource}}上存储有类型的结构化信息。",+ "new_definition_title": "新建自定义字段",+ "section_title": "自定义字段",+ "set_up": "设置自定义字段",+ "values_save_partial_failed": "部分自定义字段无法保存:{{fields}}",+ "values_saved": "自定义字段已保存"+ },+ "market_combobox": {+ "empty": "没有匹配的市场",+ "search_placeholder": "搜索市场…"}},- "fields": {- "products_count": {- "label": "商品"+ "custom_field_definitions": {+ "add_cta": "添加自定义字段",+ "create_description": "定义一个有类型的字段,您的团队可以在任何匹配的记录上填写。",+ "create_label": "创建自定义字段",+ "delete_confirm": {+ "message": "{{label}} 及为其存储的所有值都将被移除。",+ "title": "删除自定义字段?"},- "prices_count": {- "label": "价格"+ "edit_description": "更新标签、键或店面可见性。一旦存在值,所有者将无法更改。",+ "empty": "暂无自定义字段定义",+ "errors": {+ "failed_to_create": "创建自定义字段定义失败",+ "failed_to_delete": "删除自定义字段定义失败",+ "failed_to_update": "更新自定义字段定义失败"},- "customer_id": {- "label": "客户"+ "messages": {+ "created": "自定义字段定义已创建",+ "deleted": "自定义字段定义已删除",+ "updated": "自定义字段定义已更新"},- "role_id": {- "label": "角色"+ "search_placeholder": "按标签、命名空间或键搜索…",+ "storefront_visible": {+ "admin_only": "仅管理员",+ "visible": "可见"},- "role_ids": {- "label": "角色"+ "table_title": "自定义字段定义"+ },+ "customer_groups": {+ "autocomplete": {+ "empty": "没有匹配的客户组",+ "placeholder": "搜索客户组…"},- "tax_category_id": {- "label": "税务类别"+ "messages": {+ "create_failed": "创建客户组失败",+ "created": "客户组已创建",+ "delete_failed": "删除客户组失败",+ "deleted": "客户组已删除",+ "update_failed": "更新客户组失败",+ "updated": "客户组已更新"+ }+ },+ "customers": {+ "autocomplete": {+ "empty": "没有匹配的客户",+ "placeholder": "搜索客户…"},- "promotion": {- "name": {- "placeholder": "夏季促销"+ "columns": {+ "groups": "分组",+ "last_order": "最近订单",+ "newsletter": "订阅资讯",+ "orders": "订单",+ "total_spent": "消费总额"+ },+ "detail": {+ "address": {+ "default_billing": "默认账单地址",+ "default_shipping": "默认收货地址",+ "delete_confirm_message": "删除此地址?",+ "set_default_billing": "设为默认账单地址",+ "set_default_shipping": "设为默认收货地址"},- "description": {- "placeholder": "内部说明(可选)"+ "customer_since": "注册时间",+ "delete_label": "删除客户",+ "edit_profile_description": "更新客户的个人资料信息。",+ "groups": {+ "edit_description": "添加或移除此客户所属的群组。",+ "edit_title": "编辑客户群组",+ "empty": "不在任何群组中",+ "save_failed": "更新客户群组失败",+ "title": "客户群组"},- "kind": {- "label": "此优惠如何应用?"+ "last_order_placed": "最近下单时间",+ "no_internal_notes": "暂无内部备注",+ "not_subscribed_to_marketing": "未订阅营销资讯",+ "orders_table": {+ "date": "日期",+ "order": "订单"},- "code": {- "placeholder": "SUMMER2026"+ "store_credit": {+ "add_description": "向此客户账户发放商店积分。",+ "delete_confirm_message": "删除此商店积分?",+ "edit_description": "调整金额、类别或备注。已使用的余额无法编辑。",+ "empty": "未发放商店积分",+ "table": {+ "category": "类别",+ "memo": "备注",+ "remaining": "剩余",+ "used": "已使用"+ },+ "title": "商店积分"},- "multi_codes": {- "label": "批量生成唯一优惠码",- "help": "适用于一次性使用的优惠码——每位客户兑换不同的优惠码。"+ "subscribed_to_marketing": "已订阅营销资讯"+ },+ "groups": {+ "bulk_add_action": "添加到分组…",+ "bulk_add_failed": "添加客户到分组失败",+ "bulk_added": "已将 {{count}} 位客户添加到分组",+ "bulk_remove_action": "从分组移除…",+ "bulk_remove_failed": "从分组移除客户失败",+ "bulk_removed": "已将 {{count}} 位客户从分组移除",+ "columns": {+ "customers": "客户"},- "number_of_codes": {- "label": "优惠码数量",- "placeholder": "100"+ "count_one": "{{count}} 位客户",+ "count_other": "{{count}} 位客户",+ "create_description": "创建客户分组,以便对客户进行细分,用于优惠、分析或营销。",+ "create_label": "创建客户分组",+ "default_name": "此分组",+ "delete_confirm": {+ "message": "{{name}} 将被移除。此分组中的客户不会被删除。",+ "title": "删除客户分组?"},- "code_prefix": {- "label": "优惠码前缀(可选)",- "placeholder": "VIP",- "help": "每个生成的优惠码都将以此前缀开头。"+ "edit_description": "更新名称或描述。",+ "picker": {+ "add_description": "选择要将这些客户添加到的分组。",+ "add_title": "添加到分组",+ "remove_description": "选择要将这些客户移除的分组。",+ "remove_title": "从分组移除"},- "starts_at": {- "placeholder": "无开始日期"+ "table": {+ "empty": "暂无客户分组",+ "search_placeholder": "按名称搜索…",+ "title": "客户分组"},- "expires_at": {- "placeholder": "无过期时间"+ "view_members": "查看成员"+ },+ "new_sheet_description": "在此创建的客户未设置密码。他们首次登录时将收到一个魔法链接。",+ "row_actions": {+ "delete_confirm": "删除 {{email}}?已有已完成订单的客户无法被移除。"+ },+ "table": {+ "empty": "暂无客户",+ "search_placeholder": "按邮箱或姓名搜索…"+ },+ "tags": {+ "bulk_add_action": "添加标签…",+ "bulk_add_failed": "添加标签失败",+ "bulk_added": "已为 {n} 位客户添加标签",+ "bulk_remove_action": "移除标签…",+ "bulk_remove_failed": "移除标签失败",+ "bulk_removed": "已从 {n} 位客户移除标签",+ "picker": {+ "add_description": "选择或创建要添加到这些客户的标签。",+ "add_title": "添加标签",+ "remove_description": "选择要从这些客户移除的标签。",+ "remove_title": "移除标签"+ }+ }+ },+ "delivery_methods": {+ "add_cta": "添加配送方式",+ "add_sheet_title": "新建配送方式",+ "create_description": "配置订单送达客户的方式:物流、数字交付或自提。",+ "create_label": "创建配送方式",+ "delete_confirm": {+ "message": "删除“{{name}}”?店面将立即停止提供该方式。",+ "title": "删除配送方式"+ },+ "edit_description": "更新该配送方式的配置。",+ "edit_sheet_title": "编辑配送方式",+ "empty": "暂无配送方式。",+ "fulfillment_types": {+ "digital": "数字",+ "pickup": "自提",+ "pickup_point": "自提点",+ "shipping": "物流"+ },+ "messages": {+ "created": "配送方式已创建",+ "deleted": "配送方式已删除",+ "updated": "配送方式已更新"+ },+ "no_zones_hint": "尚未定义配送区域——该方式适用于所有地区。",+ "search_placeholder": "搜索配送方式…"+ },+ "delivery_zones": {+ "add_cta": "添加配送区域",+ "add_member": "添加成员",+ "add_sheet_title": "新建配送区域",+ "create_description": "将国家、省份或邮编组合为配送服务区域。",+ "create_label": "创建配送区域",+ "delete_confirm": {+ "message": "删除“{{name}}”?使用该区域的配送方式将不再匹配这些地区。",+ "title": "删除配送区域"+ },+ "edit_description": "保存时下方成员将替换该区域的全部成员。",+ "edit_sheet_title": "编辑配送区域",+ "empty": "暂无配送区域。",+ "from_placeholder": "起",+ "member_types": {+ "country": "国家",+ "postal_code": "邮政编码",+ "state": "省/州"+ },+ "members_column": "成员",+ "members_count": "{{count}} 个成员",+ "messages": {+ "created": "配送区域已创建",+ "deleted": "配送区域已删除",+ "updated": "配送区域已更新"+ },+ "no_members_hint": "暂无成员——请添加国家、省份或邮编规则。",+ "prefix_placeholder": "前缀",+ "search_placeholder": "搜索配送区域…",+ "select_country": "选择国家",+ "state_placeholder": "省份代码或名称",+ "to_placeholder": "止"+ },+ "errors": {+ "forbidden_description": "您没有权限查看此页面。",+ "forbidden_title": "未授权",+ "not_found_description": "您访问的页面不存在。",+ "not_found_title": "页面未找到",+ "plugin_route_title": "此页面渲染失败"+ },+ "fields": {+ "allowed_origin": {+ "origin": {+ "help": "仅包含协议 + 主机(+ 可选端口)。不含路径、查询参数或片段。",+ "label": "来源",+ "placeholder": "https://admin.example.com"+ }+ },+ "api_key": {+ "channel": {+ "all_channels": "All channels",+ "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",+ "label": "Channel"},- "usage_limit": {- "label": "使用次数限制",- "placeholder": "不限"+ "key_type": {+ "label": "类型"},- "match_policy": {- "label": "匹配策略"+ "name": {+ "label": "名称",+ "placeholder": "后端集成、店面生产环境、…",+ "required": "名称为必填项"+ },+ "scopes": {+ "label": "权限范围"}},- "custom_field_definition": {- "label": {- "label": "标签",- "placeholder": "例如:材质"+ "channel": {+ "active": {+ "help": "已停用的销售渠道将停止接受订单,且不会被 X-Spree-Channel header 匹配。",+ "label": "启用"},- "namespace": {- "label": "命名空间",- "placeholder": "custom"+ "code": {+ "help": "API 客户端通过 X-Spree-Channel header 使用的稳定标识符,也用于订单归因。留空则自动从名称派生。仅限小写字母、数字、连字符、下划线。",+ "label": "代码",+ "placeholder": "自动从名称派生"},- "key": {- "label": "键名",- "placeholder": "例如:material",- "invalid_format": "仅限字母、数字和下划线"+ "default": {+ "help": "每个商店有且仅有一个默认渠道。在未选择渠道时用作回退,并作为新产品的自动发布目标。",+ "label": "默认渠道"+ },+ "guest_checkout": {+ "help": "顾客是否可以在此渠道中无需账户即可结账。留空则继承店铺设置。",+ "inherit": "继承店铺设置",+ "label": "访客结账",+ "options": {+ "false": "不允许",+ "true": "允许"+ }+ },+ "name": {+ "placeholder": "例如 POS、Wholesale、Meta Shop"+ },+ "order_routing_strategy": {+ "help": "为归因到此渠道的订单覆盖商店级别的路由策略。留空则继承。",+ "inherit": "从商店继承",+ "label": "订单路由策略",+ "options": {+ "Spree::OrderRouting::Strategy::Legacy": "旧版",+ "Spree::OrderRouting::Strategy::Rules": "规则(有序)"+ }},+ "storefront_access": {+ "help": "控制匿名访客在此渠道中可以看到的内容。留空则继承店铺设置。 隐藏价格时,访客须登录后才能结账。",+ "inherit": "继承店铺设置",+ "label": "店铺访问权限",+ "options": {+ "login_required": "需要登录 — 访客须登录后才能浏览",+ "prices_hidden": "隐藏价格 — 访客须登录后才能查看价格",+ "public": "公开 — 任何人都可以浏览并查看价格"+ }+ }+ },+ "custom_field_definition": {"field_type": {"label": "类型",- "read_only_help": "一旦存在值,类型便无法更改——更改类型会导致已存储的值被错误解析。","options": {- "short_text": "短文本",+ "boolean": "布尔值",+ "json": "JSON","long_text": "长文本",- "rich_text": "富文本","number": "数字",- "boolean": "布尔值",- "json": "JSON"- }+ "rich_text": "富文本",+ "short_text": "短文本"+ },+ "read_only_help": "一旦存在值,类型便无法更改——更改类型会导致已存储的值被错误解析。"+ },+ "key": {+ "invalid_format": "仅限字母、数字和下划线",+ "label": "键名",+ "placeholder": "例如:material"+ },+ "label": {+ "label": "标签",+ "placeholder": "例如:材质"+ },+ "namespace": {+ "label": "命名空间",+ "placeholder": "custom"},"resource_type": {"label": "适用于",- "read_only_help": "一旦此字段存在值,所属对象便无法更改。","options": {- "Spree::Product": "商品",- "Spree::Variant": "变体",+ "Spree::OptionType": "选项类型","Spree::Order": "订单",- "Spree::User": "客户",+ "Spree::Product": "商品","Spree::Taxon": "分类",- "Spree::OptionType": "选项类型"- }- },- "storefront_visible": {- "label": "在网店中显示",- "column_label": "网店"+ "Spree::User": "客户",+ "Spree::Variant": "变体"+ },+ "read_only_help": "一旦此字段存在值,所属对象便无法更改。"},"searchable": {- "label": "可搜索",- "help": "将值纳入店面商品全文搜索(仅短文本、长文本和数字)。启用 Meilisearch 后请运行 rake spree:search:reindex,以便更新现有商品。"+ "help": "将值纳入店面商品全文搜索(仅短文本、长文本和数字)。启用 Meilisearch 后请运行 rake spree:search:reindex,以便更新现有商品。",+ "label": "可搜索"},"sortable": {- "label": "可排序",- "help": "允许店面商品列表按此字段排序(仅短文本和数字)。启用 Meilisearch 后请运行 rake spree:search:reindex,以便更新现有商品。"+ "help": "允许店面商品列表按此字段排序(仅短文本和数字)。启用 Meilisearch 后请运行 rake spree:search:reindex,以便更新现有商品。",+ "label": "可排序"+ },+ "storefront_visible": {+ "column_label": "网店",+ "label": "在网店中显示"}},- "tax_category": {- "name": {- "placeholder": "例如:低税率"+ "customer": {+ "accepts_email_marketing": {+ "label": "已订阅营销邮件"},- "tax_code": {- "label": "税码",- "placeholder": "外部税务服务商代码(Avalara 等)"+ "customer_groups": {+ "label": "客户组"+ },+ "internal_note": {+ "label": "内部备注",+ "placeholder": "仅员工可见的客户相关备注…"},+ "tags": {+ "label": "标签"+ }+ },+ "customer_group": {"description": {"placeholder": "可选的内部描述"},- "is_default": {- "label": "默认",- "help": "设置后将取消之前的默认项。没有明确指定类别的商品将回退至此类别。"+ "name": {+ "placeholder": "例如:VIP 客户"}},- "allowed_origin": {- "origin": {- "label": "来源",- "placeholder": "https://admin.example.com",- "help": "仅包含协议 + 主机(+ 可选端口)。不含路径、查询参数或片段。"- }+ "customer_id": {+ "label": "客户"},- "channel": {- "name": {- "placeholder": "例如 POS、Wholesale、Meta Shop"+ "delivery_method": {+ "admin_name": {+ "label": "内部名称"+ },+ "calculator": {+ "label": "运费计算器"},"code": {- "label": "代码",- "placeholder": "自动从名称派生",- "help": "API 客户端通过 X-Spree-Channel header 使用的稳定标识符,也用于订单归因。留空则自动从名称派生。仅限小写字母、数字、连字符、下划线。"+ "label": "代码"},- "active": {- "label": "启用",- "help": "已停用的销售渠道将停止接受订单,且不会被 X-Spree-Channel header 匹配。"+ "delivery_zones": {+ "label": "配送区域"},- "default": {- "label": "默认渠道",- "help": "每个商店有且仅有一个默认渠道。在未选择渠道时用作回退,并作为新产品的自动发布目标。"+ "fulfillment_type": {+ "label": "履约类型"},- "order_routing_strategy": {- "label": "订单路由策略",- "help": "为归因到此渠道的订单覆盖商店级别的路由策略。留空则继承。",- "inherit": "从商店继承",- "options": {- "Spree::OrderRouting::Strategy::Rules": "规则(有序)",- "Spree::OrderRouting::Strategy::Legacy": "旧版"- }+ "storefront_visible": {+ "help": "客户可在结账时选择该方式。"},- "storefront_access": {- "label": "店铺访问权限",- "help": "控制匿名访客在此渠道中可以看到的内容。留空则继承店铺设置。 隐藏价格时,访客须登录后才能结账。",- "inherit": "继承店铺设置",- "options": {- "public": "公开 — 任何人都可以浏览并查看价格",- "prices_hidden": "隐藏价格 — 访客须登录后才能查看价格",- "login_required": "需要登录 — 访客须登录后才能浏览"- }+ "tax_category": {+ "label": "税种"},- "guest_checkout": {- "label": "访客结账",- "help": "顾客是否可以在此渠道中无需账户即可结账。留空则继承店铺设置。",- "inherit": "继承店铺设置",- "options": {- "true": "允许",- "false": "不允许"- }+ "tracking_url": {+ "label": "追踪 URL 模板"+ },+ "transit_days_max": {+ "label": "运输天数(最多)"+ },+ "transit_days_min": {+ "label": "运输天数(最少)"+ }+ },+ "gift_card": {+ "amount": {+ "label": "金额"+ },+ "code": {+ "help": "留空以自动生成。批量发行时,此项将作为前缀。",+ "label": "代码"+ },+ "currency": {+ "label": "货币"+ },+ "customer_id": {+ "label": "客户"+ },+ "expires_at": {+ "label": "过期时间",+ "placeholder": "永不过期"+ },+ "quantity": {+ "help": "为 1 时发行单张礼品卡。大于 1 时批量发行并自动生成代码。",+ "label": "数量"}},"invitation_acceptance": {@@ -322,269 +633,370 @@"label": "确认密码"}},- "customer_group": {+ "market": {+ "country_isos": {+ "help": "选择此市场涵盖的国家/地区。每个国家/地区在每个商店中最多只能属于一个市场。",+ "label": "国家/地区"+ },+ "currency": {+ "help": "用于此市场所有价格的 ISO 4217 货币。",+ "label": "货币"+ },+ "default": {+ "help": "没有已知国家/地区的购物者会看到此市场。每个商店只能有一个默认市场。",+ "label": "默认市场"+ },+ "default_locale": {+ "help": "此市场中购物者的店面语言。",+ "label": "默认语言区域"+ },"name": {- "placeholder": "例如:VIP 客户"+ "placeholder": "例如:欧洲"},- "description": {- "placeholder": "可选的内部描述"+ "supported_locales": {+ "help": "购物者可切换到的其他语言。始终包含默认语言区域。",+ "label": "支持的语言区域"+ },+ "tax_inclusive": {+ "help": "显示含税价格。在欧盟市场较为常见。",+ "label": "含税定价"}},- "price_list": {+ "match_policy": {+ "label": "匹配策略"+ },+ "media": {+ "alt": {+ "label": "替代文本",+ "placeholder": "为无障碍访问和 SEO 描述该图片"+ }+ },+ "option_type": {+ "filterable": {+ "help": "在店面商品列表中将此选项显示为筛选项。",+ "label": "可筛选"+ },+ "kind": {+ "help": "控制该选项在店面的呈现方式。色块显示十六进制颜色;按钮显示缩略图。",+ "label": "类型"+ },+ "label": {+ "help": "在店面向客户展示。",+ "label": "标签",+ "placeholder": "例如 衬衫尺码"+ },"name": {- "label": "名称",- "placeholder": "例如:欧盟批发",- "help": "内部标签 — 不会向客户展示。"+ "help": "小写标识符。在整个店铺中必须唯一。",+ "label": "内部名称",+ "placeholder": "例如 shirt-size"+ }+ },+ "option_value": {+ "color_code": {+ "label": "颜色"+ },+ "image": {+ "label": "图片"+ },+ "label": {+ "label": "标签",+ "placeholder": "例如 Small"+ },+ "name": {+ "label": "内部名称",+ "placeholder": "例如 small"+ }+ },+ "order": {+ "channel": {+ "help": "将订单归属于特定销售渠道。默认为店铺的线上渠道。",+ "label": "销售渠道",+ "placeholder": "使用店铺默认"+ },+ "coupon_code": {+ "label": "优惠码",+ "placeholder": "可选"+ },+ "customer_note": {+ "label": "客户备注(客户可见)"+ },+ "email": {+ "label": "或使用访客邮箱",+ "placeholder": "[email protected]"+ },+ "internal_note": {+ "label": "内部备注(仅员工可见)"+ }+ },+ "payment_method": {+ "active": {+ "help": "未启用的方式将在结账时隐藏。",+ "label": "启用"+ },+ "auto_capture": {+ "help": "授权后自动收取款项。关闭时,需手动收款。",+ "label": "自动收款"+ },+ "description": {+ "placeholder": "结账时向客户展示的描述"+ },+ "name": {+ "placeholder": "例如:信用卡 (Stripe)"},+ "provider_configuration": "服务商配置",+ "storefront_visible": {+ "label": "在店面显示"+ },+ "type": {+ "label": "服务商",+ "placeholder": "选择服务商"+ }+ },+ "price_list": {"description": {"label": "描述","placeholder": "可选的内部描述"},- "starts_at": {- "label": "开始时间",- "placeholder": "立即",- "help": "此列表何时生效。留空则在激活时立即开始。"- },"ends_at": {+ "help": "留空表示无结束日期。","label": "结束时间",- "placeholder": "永不",- "help": "留空表示无结束日期。"+ "placeholder": "永不"},"match_policy": {- "label": "匹配策略","all": "必须满足所有规则",- "any": "满足任一规则即可"+ "any": "满足任一规则即可",+ "label": "匹配策略"+ },+ "name": {+ "help": "内部标签 — 不会向客户展示。",+ "label": "名称",+ "placeholder": "例如:欧盟批发"+ },+ "starts_at": {+ "help": "此列表何时生效。留空则在激活时立即开始。",+ "label": "开始时间",+ "placeholder": "立即"},"status": {"active": "生效中",- "scheduled": "已排期",+ "draft": "草稿","inactive": "未生效",- "draft": "草稿"+ "scheduled": "已排期"}},"price_rule": {- "customers": {- "label": "客户",- "help": "留空则此规则适用于每位已登录的客户。"+ "channels": {+ "help": "留空则此规则适用于所有销售渠道。",+ "label": "销售渠道"},"customer_groups": {- "label": "客户群组",- "help": "留空则此规则适用于所有客户,不论其所属群组。"+ "help": "留空则此规则适用于所有客户,不论其所属群组。",+ "label": "客户群组"+ },+ "customers": {+ "help": "留空则此规则适用于每位已登录的客户。",+ "label": "客户"},"markets": {- "label": "市场",- "help": "留空则此规则适用于所有市场。"+ "help": "留空则此规则适用于所有市场。",+ "label": "市场"},- "channels": {- "label": "销售渠道",- "help": "留空则此规则适用于所有销售渠道。"+ "max_quantity": {+ "help": "留空表示没有上限。"},"min_quantity": {"help": "仅当客户订购单个商品达到此数量时,才应用此价格。"- },- "max_quantity": {- "help": "留空表示没有上限。"}},- "stock_location": {- "name": {- "placeholder": "布鲁克林仓库"+ "prices_count": {+ "label": "价格"+ },+ "product": {+ "available_on": {+ "label": "上架日期"},- "admin_name": {- "label": "内部名称",- "placeholder": "可选 — 仅在后台显示"+ "category_ids": {+ "label": "分类"},- "kind": {- "label": "类型"+ "channels": {+ "label": "销售渠道"},- "active": {- "label": "启用",- "help": "停用的库存地点不会出现在履约选择中。"+ "description": {+ "label": "描述",+ "placeholder": "撰写产品描述…"},- "default": {- "label": "默认库存地点",- "help": "新库存项会同步到此地点。只能设置一个默认地点。"+ "discontinue_on": {+ "label": "下架日期"},- "backorderable_default": {- "label": "默认允许缺货下单",- "help": "新库存项在缺货时默认允许缺货下单。"+ "make_active_at": {+ "label": "激活日期"},- "propagate_all_variants": {- "label": "为所有变体自动创建库存项",- "help": "为每个商品变体在此地点创建库存项。"+ "name": {+ "label": "名称",+ "placeholder": "产品名称"},- "pickup_enabled": {- "label": "允许客户自提",- "help": "客户可在结账时选择从此地点自提订单。"+ "tags": {+ "label": "标签"+ }+ },+ "product_publication": {+ "published_at": {+ "help": "留空则立即上线。",+ "label": "发布开始时间",+ "placeholder": "立即上线"},- "pickup_stock_policy": {- "label": "库存策略"+ "unpublished_at": {+ "help": "留空则一直保持上架。",+ "label": "下架时间",+ "placeholder": "永不"+ }+ },+ "products_count": {+ "label": "商品"+ },+ "profile": {+ "avatar": {+ "help": "在管理后台中显示在您的姓名旁边。方形图片效果最佳。",+ "label": "照片"},- "pickup_ready_in_minutes": {- "label": "备货时间(分钟)",- "placeholder": "60"+ "email": {+ "label": "邮箱"},- "pickup_instructions": {- "label": "自提说明",- "placeholder": "客户应前往何处领取订单。"+ "first_name": {+ "label": "名字"+ },+ "last_name": {+ "label": "姓氏"+ },+ "selected_locale": {+ "help": "管理后台使用的语言。仅影响您看到的界面。",+ "label": "语言"}},- "payment_method": {- "type": {- "label": "服务商",- "placeholder": "选择服务商"+ "promotion": {+ "code": {+ "placeholder": "SUMMER2026"},- "name": {- "placeholder": "例如:信用卡 (Stripe)"+ "code_prefix": {+ "help": "每个生成的优惠码都将以此前缀开头。",+ "label": "优惠码前缀(可选)",+ "placeholder": "VIP"},"description": {- "placeholder": "结账时向客户展示的描述"+ "placeholder": "内部说明(可选)"},- "storefront_visible": {- "label": "在店面显示"+ "expires_at": {+ "placeholder": "无过期时间"},- "active": {- "label": "启用",- "help": "未启用的方式将在结账时隐藏。"+ "kind": {+ "label": "此优惠如何应用?"},- "auto_capture": {- "label": "自动收款",- "help": "授权后自动收取款项。关闭时,需手动收款。"+ "match_policy": {+ "label": "匹配策略"},- "provider_configuration": "服务商配置"- },- "market": {- "name": {- "placeholder": "例如:欧洲"+ "multi_codes": {+ "help": "适用于一次性使用的优惠码——每位客户兑换不同的优惠码。",+ "label": "批量生成唯一优惠码"},- "currency": {- "label": "货币",- "help": "用于此市场所有价格的 ISO 4217 货币。"+ "name": {+ "placeholder": "夏季促销"},- "default_locale": {- "label": "默认语言区域",- "help": "此市场中购物者的店面语言。"+ "number_of_codes": {+ "label": "优惠码数量",+ "placeholder": "100"},- "supported_locales": {- "label": "支持的语言区域",- "help": "购物者可切换到的其他语言。始终包含默认语言区域。"+ "starts_at": {+ "placeholder": "无开始日期"},- "country_isos": {- "label": "国家/地区",- "help": "选择此市场涵盖的国家/地区。每个国家/地区在每个商店中最多只能属于一个市场。"- },- "tax_inclusive": {- "label": "含税定价",- "help": "显示含税价格。在欧盟市场较为常见。"- },- "default": {- "label": "默认市场",- "help": "没有已知国家/地区的购物者会看到此市场。每个商店只能有一个默认市场。"+ "usage_limit": {+ "label": "使用次数限制",+ "placeholder": "不限"}},- "option_type": {- "name": {- "label": "内部名称",- "placeholder": "例如 shirt-size",- "help": "小写标识符。在整个店铺中必须唯一。"- },- "label": {- "label": "标签",- "placeholder": "例如 衬衫尺码",- "help": "在店面向客户展示。"- },- "kind": {- "label": "类型",- "help": "控制该选项在店面的呈现方式。色块显示十六进制颜色;按钮显示缩略图。"- },- "filterable": {- "label": "可筛选",- "help": "在店面商品列表中将此选项显示为筛选项。"- }+ "role_id": {+ "label": "角色"},- "option_value": {- "name": {- "label": "内部名称",- "placeholder": "例如 small"- },- "label": {- "label": "标签",- "placeholder": "例如 Small"- },- "color_code": {- "label": "颜色"- },- "image": {- "label": "图片"- }+ "role_ids": {+ "label": "角色"},- "variant": {- "sku": {- "label": "SKU",- "placeholder": "PRODUCT-RED-S"+ "stock_location": {+ "active": {+ "help": "停用的库存地点不会出现在履约选择中。",+ "label": "启用"},- "barcode": {- "label": "条形码"+ "admin_name": {+ "label": "内部名称",+ "placeholder": "可选 — 仅在后台显示"},- "weight": {- "label": "重量"+ "backorderable_default": {+ "help": "新库存项在缺货时默认允许缺货下单。",+ "label": "默认允许缺货下单"},- "weight_unit": {- "label": "单位"+ "default": {+ "help": "新库存项会同步到此地点。只能设置一个默认地点。",+ "label": "默认库存地点"},- "height": {- "label": "高度"+ "kind": {+ "label": "类型"},- "width": {- "label": "宽度"+ "name": {+ "placeholder": "布鲁克林仓库"},- "depth": {- "label": "深度"+ "pickup_enabled": {+ "help": "客户可在结账时选择从此地点自提订单。",+ "label": "允许客户自提"},- "dimensions_unit": {- "label": "单位"+ "pickup_instructions": {+ "label": "自提说明",+ "placeholder": "客户应前往何处领取订单。"},- "preorderable": {- "label": "可预购",- "help": "在有货之前销售此变体。用缺货下单上限来限制数量,将到货数量填入库存,或留空表示无限量。"+ "pickup_ready_in_minutes": {+ "label": "备货时间(分钟)",+ "placeholder": "60"},- "preorder_ships_at": {- "label": "发货时间",- "placeholder": "选择日期",- "help": "你预计发出预购订单的时间。作为交付承诺向顾客展示;该日期过后预购结束。"+ "pickup_stock_policy": {+ "label": "库存策略"},- "backorder_limit": {- "label": "缺货下单上限",- "placeholder": "无限量",- "help": "超出可用库存销售的最大数量——用于限制缺货下单和预购。留空表示无限量。"+ "propagate_all_variants": {+ "help": "为每个商品变体在此地点创建库存项。",+ "label": "为所有变体自动创建库存项"}},- "api_key": {- "name": {- "label": "名称",- "placeholder": "后端集成、店面生产环境、…",- "required": "名称为必填项"+ "store": {+ "customer_support_email": {+ "help": "在店面邮件中向客户显示的回复(Reply-to)地址。",+ "label": "客户支持邮箱",+ "placeholder": "[email protected]"},- "key_type": {- "label": "类型"+ "guest_checkout": {+ "help": "店铺范围内的默认设置,控制顾客是否可以无需账户即可结账。渠道可以覆盖此设置。",+ "label": "访客结账"},- "scopes": {- "label": "权限范围"+ "mail_from_address": {+ "help": "作为每封交易类邮件的发件人(From)地址。",+ "label": "发件人地址",+ "placeholder": "[email protected]"+ },+ "mailer_logo": {+ "help": "采用透明背景的 PNG 或 JPG 图片。嵌入在交易类邮件的页眉中。",+ "label": "邮件徽标"},- "channel": {- "label": "Channel",- "help": "Binding locks this key to one channel — a bound key rejects requests for other channels. Leave on 'All channels' for a store-wide key.",- "all_channels": "All channels"- }- },- "store": {"name": {"label": "店铺名称"},+ "new_order_notifications_email": {+ "help": "“新订单已下单”通知的接收人。留空则禁用。",+ "label": "新订单通知",+ "placeholder": "[email protected]"+ },"preferred_admin_locale": {"label": "后台语言","placeholder": "使用默认语言"},+ "preferred_send_consumer_transactional_emails": {+ "help": "关闭后,将不会发送订单确认、发货或退款邮件。",+ "label": "向客户发送交易类邮件"+ },"preferred_timezone": {"label": "时区","placeholder": "选择时区"@@ -596,955 +1008,1115 @@"label": "重量单位"},"storefront_access": {- "label": "店铺访问权限","help": "店铺范围内的默认设置,控制匿名访客可以看到的内容。渠道可以覆盖此设置。隐藏价格时,访客须登录后才能结账。",+ "label": "店铺访问权限","options": {- "public": "公开 — 任何人都可以浏览并查看价格",+ "login_required": "需要登录 — 访客须登录后才能浏览","prices_hidden": "隐藏价格 — 访客须登录后才能查看价格",- "login_required": "需要登录 — 访客须登录后才能浏览"+ "public": "公开 — 任何人都可以浏览并查看价格"}- },- "guest_checkout": {- "label": "访客结账",- "help": "店铺范围内的默认设置,控制顾客是否可以无需账户即可结账。渠道可以覆盖此设置。"- },- "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": "在此列表中显示的可选标签。"+ "store_credit": {+ "amount": {+ "label": "金额"},- "url": {- "label": "目标 URL",- "placeholder": "https://example.com/webhooks"+ "category_id": {+ "label": "类别"},- "active": {- "label": "启用",- "help": "未启用的端点不会接收推送。"+ "currency": {+ "label": "货币"},- "subscriptions": {- "label": "事件",- "help": "选择哪些事件应触发 Webhook。不选择任何事件则接收所有事件。"+ "memo": {+ "label": "备注",+ "placeholder": "签发此项信用额度的原因"}},- "product": {- "name": {- "label": "名称",- "placeholder": "产品名称"- },+ "storefront_visible": {+ "label": "店面可见"+ },+ "tax_category": {"description": {- "label": "描述",- "placeholder": "撰写产品描述…"- },- "make_active_at": {- "label": "激活日期"- },- "available_on": {- "label": "上架日期"- },- "discontinue_on": {- "label": "下架日期"+ "placeholder": "可选的内部描述"},- "category_ids": {- "label": "分类"+ "is_default": {+ "help": "设置后将取消之前的默认项。没有明确指定类别的商品将回退至此类别。",+ "label": "默认"},- "channels": {- "label": "销售渠道"+ "name": {+ "placeholder": "例如:低税率"},- "tags": {- "label": "标签"+ "tax_code": {+ "label": "税码",+ "placeholder": "外部税务服务商代码(Avalara 等)"}},- "product_publication": {- "published_at": {- "label": "发布开始时间",- "placeholder": "立即上线",- "help": "留空则立即上线。"- },- "unpublished_at": {- "label": "下架时间",- "placeholder": "永不",- "help": "留空则一直保持上架。"- }+ "tax_category_id": {+ "label": "税务类别"},- "gift_card": {- "code": {- "label": "代码",- "help": "留空以自动生成。批量发行时,此项将作为前缀。"+ "variant": {+ "backorder_limit": {+ "help": "超出可用库存销售的最大数量——用于限制缺货下单和预购。留空表示无限量。",+ "label": "缺货下单上限",+ "placeholder": "无限量"},- "amount": {- "label": "金额"+ "barcode": {+ "label": "条形码"},- "currency": {- "label": "货币"+ "depth": {+ "label": "深度"},- "expires_at": {- "label": "过期时间",- "placeholder": "永不过期"+ "dimensions_unit": {+ "label": "单位"},- "customer_id": {- "label": "客户"+ "height": {+ "label": "高度"},- "quantity": {- "label": "数量",- "help": "为 1 时发行单张礼品卡。大于 1 时批量发行并自动生成代码。"- }- },- "customer": {- "tags": {- "label": "标签"+ "preorder_ships_at": {+ "help": "你预计发出预购订单的时间。作为交付承诺向顾客展示;该日期过后预购结束。",+ "label": "发货时间",+ "placeholder": "选择日期"},- "customer_groups": {- "label": "客户组"+ "preorderable": {+ "help": "在有货之前销售此变体。用缺货下单上限来限制数量,将到货数量填入库存,或留空表示无限量。",+ "label": "可预购"},- "accepts_email_marketing": {- "label": "已订阅营销邮件"+ "sku": {+ "label": "SKU",+ "placeholder": "PRODUCT-RED-S"},- "internal_note": {- "label": "内部备注",- "placeholder": "仅员工可见的客户相关备注…"+ "weight": {+ "label": "重量"+ },+ "weight_unit": {+ "label": "单位"+ },+ "width": {+ "label": "宽度"}},- "store_credit": {- "amount": {- "label": "金额"+ "webhook_endpoint": {+ "active": {+ "help": "未启用的端点不会接收推送。",+ "label": "启用"},- "currency": {- "label": "货币"+ "name": {+ "help": "在此列表中显示的可选标签。",+ "label": "名称",+ "placeholder": "例如:订单流水线"},- "category_id": {- "label": "类别"+ "subscriptions": {+ "help": "选择哪些事件应触发 Webhook。不选择任何事件则接收所有事件。",+ "label": "事件"},- "memo": {- "label": "备注",- "placeholder": "签发此项信用额度的原因"+ "url": {+ "label": "目标 URL",+ "placeholder": "https://example.com/webhooks"}- },- "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": "姓氏"- },- "avatar": {- "label": "照片",- "help": "在管理后台中显示在您的姓名旁边。方形图片效果最佳。"- },- "selected_locale": {- "label": "语言",- "help": "管理后台使用的语言。仅影响您看到的界面。"- }- },- "match_policy": {- "label": "匹配策略"}},- "promotions": {- "rule_types_empty": "未注册任何规则类型。",- "rule_types_all_used": "所有可用的规则类型都已添加到此优惠中。",- "table": {- "search_placeholder": "按名称搜索…",- "empty": "暂无优惠活动",- "no_end": "无结束日期"- },- "code": {- "automatic": "自动",- "multi": "multi"+ "gift_cards": {+ "batch_autocomplete": {+ "empty": "无匹配的批次",+ "placeholder": "按前缀搜索批次…"},- "generate_code": {- "title": "生成随机代码"+ "columns": {+ "batch": "批次",+ "customer": "客户",+ "issued_by": "发放人",+ "remaining": "剩余",+ "used": "已使用"},- "kinds": {- "coupon_code": "优惠码",- "automatic": "自动(无需代码)"+ "messages": {+ "batch_create_failed": "创建礼品卡批次失败",+ "batch_created": "礼品卡批次已创建",+ "create_failed": "创建礼品卡失败",+ "created": "礼品卡已创建",+ "delete_failed": "删除礼品卡失败",+ "deleted": "礼品卡已删除",+ "update_failed": "更新礼品卡失败",+ "updated": "礼品卡已更新"},- "match_policies": {- "all": "必须满足所有规则",- "any": "满足任一规则即可",- "all_hint": "必须满足所有规则。",- "any_hint": "满足任一规则即可。"+ "statuses": {+ "canceled": "已取消",+ "expired": "已过期",+ "partially_redeemed": "部分已兑换",+ "redeemed": "已兑换"},- "rules_card": {- "title": "规则",- "description": "决定优惠是否适用的条件。",- "empty": "暂无规则。没有规则时,优惠始终满足条件(受排期和使用次数限制约束)。",- "add_rule": "添加规则"+ "table": {+ "empty": "暂无礼品卡",+ "search_placeholder": "按代码搜索…"+ }+ },+ "imports": {+ "download_original": "下载原始文件",+ "failed": {+ "description": "无法处理该文件。",+ "title": "导入失败"},- "validation": {- "code_required": "代码为必填项(或点击生成)",- "prefix_required": "多代码批次需要前缀",- "number_of_codes_required": "请选择要生成的代码数量",- "expiry_after_start": "到期时间必须晚于开始日期"+ "failed_rows": {+ "error": "错误",+ "hide_data": "隐藏行数据",+ "next_page": "下一页",+ "prev_page": "上一页",+ "row_number": "行号",+ "title": "失败的行",+ "view_data": "查看行数据"},- "delete_confirm": {- "title": "删除优惠?",- "message": "{{name}} 将被永久移除。被已完成订单引用的优惠无法删除。",- "default_name": "此优惠"+ "load_failed": "无法加载导入。",+ "mapping": {+ "description": "将文件中的列与{{type}}字段进行匹配。",+ "field": "字段",+ "file_column": "文件列",+ "missing_required": "请先匹配必填字段:{{fields}}",+ "not_mapped": "未匹配",+ "required": "必填",+ "sample": "示例",+ "start": "开始导入",+ "starting": "正在开始…",+ "title": "匹配列"},- "rules": {- "country": {- "label": "国家/地区",- "search_placeholder": "搜索国家/地区…",- "empty": "没有匹配的国家/地区"- },- "channel": {- "label": "渠道"- },- "market": {- "label": "市场"- },- "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": "没有匹配的客户"- }+ "processing": {+ "failed_count": "{{failed}} 条失败",+ "note": "您可以离开此页面——导入将在后台继续进行。",+ "preparing": "正在准备行…",+ "progress": "已处理 {{processed}} / {{total}} 行",+ "retrying": "正在重试失败的行 · 剩余 {{remaining}} 条",+ "title": "正在处理行"},- "basics_card": {- "title": "基本信息"+ "results": {+ "completed_title": "导入完成",+ "retry_failed": "重试失败的行({{failed}})",+ "retrying": "正在重试…",+ "summary": "已导入 {{completed}} 行 · {{failed}} 条失败",+ "view_records": "查看{{type}}"},- "trigger_card": {- "title": "触发条件"+ "status": {+ "completed": "已完成",+ "completed_mapping": "已排队",+ "failed": "失败",+ "mapping": "匹配中",+ "pending": "待处理",+ "processing": "处理中"},- "schedule_card": {- "title": "排期与限制"+ "steps": {+ "complete": "完成",+ "map_fields": "匹配字段",+ "process_rows": "处理行"},- "trigger_summary": {- "multi_code": "多码优惠券({{count}} 个码)",- "multi_code_with_prefix": "多码优惠券({{count}} 个带前缀 \"{{prefix}}\" 的码)",- "show_codes": "显示优惠码",- "single_code": "单个优惠码:",- "locked_help": "触发设置在创建后无法更改。如需更改,请新建一个促销活动。"+ "try_again": "重试",+ "types": {+ "customers": "客户",+ "product_translations": "产品翻译",+ "products": "产品"},- "remove_rule_confirm": {- "title": "移除规则?",- "message": "保存促销时移除。"+ "wizard_title": "导入"+ },+ "invitation": {+ "accepting": "正在接受…",+ "could_not_accept": "无法接受邀请",+ "create_and_accept": "创建账户并接受",+ "create_to_accept": "。创建账户以接受。",+ "generic_error_message": "出现了一些问题。请重试。",+ "generic_error_title": "无法加载邀请",+ "invited_as_role": ",担任 {{role}}",+ "invited_by": "{{email}} 邀请了你",+ "invited_generic": "你已被邀请",+ "join_store": "加入 {{store}}",+ "loading": "正在加载邀请…",+ "missing_token_message": "此链接似乎不完整。请让邀请你的人重新发送一次。",+ "missing_token_title": "缺少邀请令牌",+ "not_found_message": "此邀请已过期、被撤销或已被接受。请让邀请人发送一个新的邀请。",+ "not_found_title": "未找到邀请",+ "sign_in_and_accept": "登录并接受",+ "sign_in_to_accept": "。登录以接受。"+ },+ "markets": {+ "add_cta": "添加市场",+ "columns": {+ "default": "默认"},- "rule_summary": {- "product_count": "{{count}} 个商品",- "category_count": "{{count}} 个分类",- "customer_count": "{{count}} 位客户"+ "create_description": "将多个国家/地区归入一个定价区域,使用其专属货币和区域设置。",+ "create_label": "创建市场",+ "delete_confirm": {+ "message": "{{name}} 将被移除。此前在该市场中下达的订单将保持不变。",+ "title": "删除市场?"},- "rule_picker": {- "title": "添加规则",- "description": "选择要配置的规则类型。"+ "edit_description": "更新名称、货币、区域设置或国家/地区覆盖范围。",+ "empty": "暂无市场",+ "errors": {+ "failed_to_create": "创建市场失败",+ "failed_to_delete": "删除市场失败",+ "failed_to_update": "更新市场失败"},- "rule_edit": {- "description": "调整规则的参数。",- "no_options": "此规则没有可配置的选项 — 仅其存在即可应用该约束。"+ "messages": {+ "created": "市场已创建",+ "deleted": "市场已删除",+ "updated": "市场已更新"},- "actions_card": {- "description": "促销满足条件时执行的操作。",- "empty": "暂无操作。没有操作的促销在应用时不会产生任何效果。",- "add_action": "添加操作"+ "search_placeholder": "按名称搜索…",+ "tax_exclusive": "不含税",+ "tax_inclusive": "含税"+ },+ "nav": {+ "account": "账户",+ "categories": "分类",+ "customer_groups": "分组",+ "customers": "客户",+ "draft_orders": "草稿订单",+ "getting_started": "快速入门",+ "gift_cards": "礼品卡",+ "home": "首页",+ "options": "选项",+ "orders": "订单",+ "price_lists": "价格表",+ "products": "商品",+ "promotions": "促销",+ "reports": "报表",+ "settings": "设置",+ "transfers": "调拨"+ },+ "option_types": {+ "columns": {+ "values": "值"},- "remove_action_confirm": {- "title": "移除操作?",- "message": "保存促销活动时移除。"+ "kinds": {+ "buttons": "按钮",+ "color_swatch": "颜色样本",+ "dropdown": "下拉菜单"},- "action_summary": {- "variant_count": "{{count}} 个变体"+ "messages": {+ "created": "选项类型已创建",+ "deleted": "选项类型已删除",+ "updated": "选项类型已更新"},- "action_picker": {- "title": "添加操作",- "description": "选择当促销满足条件时应执行的操作。"+ "table": {+ "empty": "暂无选项类型",+ "search_placeholder": "按名称搜索…"},- "action_edit": {- "description": "配置该操作的参数。",- "no_options": "此操作没有可配置的选项。"+ "value_count_one": "{{count}} 个值",+ "value_count_other": "{{count}} 个值"+ },+ "order_routing_rules": {+ "messages": {+ "created": "已添加路由规则",+ "deleted": "已移除路由规则"},- "coupon_codes": {- "title": "优惠券代码",- "description": "此促销活动自动生成的代码。只读 — 通过更改促销活动的代码数量设置来重新生成。",- "description_with_count": "{{count}} 个自动生成的代码。只读 — 通过更改促销活动的代码数量设置来重新生成。",- "empty": "尚未生成任何代码。",- "unused": "未使用",- "used": "已使用",- "export_csv": "导出 CSV",- "states": {- "used": "已使用",- "partially_used": "部分使用"+ "types": {+ "default_location": {+ "description": "优先选择标记为默认的库存地点",+ "name": "默认库存地点"+ },+ "minimize_splits": {+ "description": "优先选择能独立满足最多商品的地点,避免拆分发货",+ "name": "减少拆单"+ },+ "preferred_location": {+ "description": "如订单已指定库存地点,则从该地点发货",+ "name": "首选库存地点"}+ }+ },+ "orders": {+ "columns": {+ "customer": "客户",+ "date": "日期",+ "fulfillment": "履约",+ "items": "商品",+ "number": "编号",+ "payment": "付款",+ "sku": "SKU",+ "tags": "标签"},- "rule_types": {- "category": {- "name": "分类",- "description": "订单包含指定分类中的商品"+ "detail": {+ "add_line_item": {+ "title": "添加订单项"},- "country": {- "name": "国家/地区",- "description": "仅限收货地址在指定国家/地区的订单"+ "address_edit": {+ "billing_title": "编辑账单地址",+ "shipping_title": "编辑收货地址"+ },+ "adjustment_lines": {+ "add_discount": "添加折扣",+ "add_discount_description": "创建手动折扣。未选择目标商品时,金额将分摊到所有商品。",+ "add_fee": "添加费用",+ "add_fee_description": "创建附加费、手续费或礼品包装等费用。",+ "amount_field": "金额",+ "delete_discount_message": "从该订单中移除折扣“{{label}}”?总计将重新计算。",+ "delete_discount_title": "删除折扣",+ "delete_fee_message": "从该订单中移除费用“{{label}}”?总计将重新计算。",+ "delete_fee_title": "删除费用",+ "discounts": "折扣",+ "empty": "该订单暂无税费、折扣或费用。",+ "fees": "费用",+ "kind_field": "种类",+ "kind_promotion": "促销",+ "label_field": "名称",+ "target_field": "适用于",+ "target_order": "整个订单",+ "taxes": "税费",+ "title": "税费、折扣与费用",+ "value_field": "数值",+ "value_type_field": "类型",+ "value_type_flat": "金额",+ "value_type_percent": "百分比"},- "currency": {- "name": "货币",- "description": "仅限使用指定货币的订单"+ "completed_prefix": "已完成",+ "confirm": {+ "approve_message": "批准此订单吗?",+ "cancel_message": "确定要取消此订单吗?",+ "cancel_shipment_message": "取消此履约单吗?",+ "capture_message": "捕获此付款吗?",+ "complete_message": "现在完成此草稿订单吗?",+ "remove_gift_card_message": "从订单中移除此礼品卡吗?",+ "remove_item_message": "从订单中移除此商品吗?",+ "remove_store_credit_message": "从订单中移除商店积分吗?",+ "resume_message": "恢复此已取消的订单吗?",+ "ship_message": "发货此履约单吗?",+ "void_message": "作废此付款吗?"},- "customer": {- "name": "客户",- "description": "仅对指定客户可用"+ "dropdown": {+ "cancel_shipment": "取消发货",+ "complete_order": "完成订单",+ "edit_quantity": "编辑数量",+ "preview_order": "预览订单",+ "resend_confirmation": "重新发送确认",+ "void_payment": "作废付款"},- "customer_group": {- "name": "客户组",- "description": "仅对指定客户组中的客户可用"+ "edit_quantity": {+ "description": "设置该订单行项目的数量。",+ "title": "编辑数量"},- "customer_logged_in": {- "name": "仅限已登录客户",- "description": "仅对已登录客户可用"+ "errors": {+ "approve_failed": "批准订单失败",+ "cancel_failed": "取消订单失败",+ "complete_failed": "完成订单失败",+ "confirmation_send_failed": "发送确认失败",+ "resume_failed": "恢复订单失败"},- "first_order": {- "name": "首次订单",- "description": "必须是客户的首次订单"+ "gift_card_section": {+ "applied_suffix": "已应用",+ "apply_balance": "应用客户的可用余额",+ "apply_dialog_description": "输入要应用到此订单的礼品卡代码。",+ "apply_dialog_title": "应用礼品卡",+ "code_placeholder": "GIFT-XXXX-YYYY",+ "gift_card_label": "礼品卡",+ "none_applied": "未应用",+ "requires_customer": "需要客户",+ "store_credit_label": "店铺积分",+ "title": "礼品卡和店铺积分"},- "item_total": {- "name": "商品总额",- "description": "订单总额满足这些条件"+ "items_table": {+ "item": "商品",+ "price": "价格",+ "qty": "数量"},- "one_use_per_user": {- "name": "每位用户限用一次",- "description": "每位用户仅限使用一次"+ "load_failed_message": "无法加载订单 {{orderId}}。",+ "messages": {+ "approved": "订单已批准",+ "canceled": "订单已取消",+ "captured": "付款已收取",+ "completed": "订单已完成",+ "confirmation_sent": "确认信息已发送",+ "resumed": "订单已恢复",+ "shipped": "发货已发出",+ "voided": "付款已作废"},- "option_value": {- "name": "选项值",- "description": "订单包含具有匹配选项值的商品"+ "no_customer": "无客户信息",+ "no_line_items": "无订单项",+ "payment_form": {+ "amount_help": "留空则默认为未结清的余额。",+ "capture_immediately": "立即扣款",+ "description": "对此订单的某种支付方式进行收款。",+ "method_label": "支付方式",+ "method_placeholder": "选择一种支付方式",+ "no_saved_cards": "客户没有用于此支付方式的已保存银行卡。",+ "source_label": "来源",+ "source_placeholder": "选择一张已保存的银行卡…",+ "source_requires_customer": "此支付方式需要已保存的来源。请先为订单分配一位客户。",+ "title": "添加付款"},- "product": {- "name": "商品",- "description": "订单包含指定商品"- }- },- "action_types": {- "create_adjustment": {- "name": "创建整单调整",- "description": "在订单上创建优惠抵扣调整"+ "payments_table": {+ "method": "方式",+ "number": "编号",+ "state": "州/省"},- "create_item_adjustments": {- "name": "创建按行项目调整",- "description": "在某个订单项上创建优惠抵扣调整"+ "section_customer_note": "特别说明",+ "section_internal_note": "内部备注",+ "summary": {+ "adjustments": "调整",+ "approved_by": "审批人",+ "canceled_at": "取消时间",+ "canceler": "取消人",+ "outstanding_balance": "未结余额",+ "payment_total": "支付总额",+ "promotions": "优惠",+ "tax_additional": "税(额外)",+ "tax_included": "税(含)"},- "create_line_items": {- "name": "创建订单项",- "description": "向购物车填充指定数量的变体"+ "tracking": {+ "add_title": "添加物流单号",+ "description": "更新此发货单的物流单号。",+ "edit_title": "编辑物流单号",+ "label": "物流单号",+ "prefix": "物流",+ "shipped_prefix": "已发货"},- "free_shipping": {- "name": "免运费",- "description": "使订单的所有发货免运费"+ "variant_search": {+ "description": "搜索要添加到此订单的商品变体。",+ "empty": "未找到变体",+ "label": "搜索变体",+ "placeholder": "输入商品名称或 SKU(至少 3 个字符)…",+ "sku_prefix": "SKU"}},- "messages": {- "action_added": "操作已添加",- "action_updated": "操作已更新",- "action_removed": "操作已移除",- "rule_added": "规则已添加",- "rule_updated": "规则已更新",- "rule_removed": "规则已移除"+ "fulfillment_statuses": {+ "backorder": "缺货补订",+ "canceled": "已取消",+ "fulfilled": "已履行",+ "partial": "部分完成",+ "pending": "待处理",+ "ready": "已就绪"},- "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": "没有匹配的市场"+ "item_count_one": "{{count}} 件商品",+ "item_count_other": "{{count}} 件商品",+ "new": {+ "add_variant": "添加变体",+ "creates_draft_note": "创建一个草稿订单。创建后可添加付款并完成订单。",+ "items_table": {+ "qty": "数量",+ "sku": "SKU",+ "variant": "变体"+ },+ "use_default_addresses": "使用客户的默认账单和配送地址"},- "custom_fields": {- "section_title": "自定义字段",- "set_up": "设置自定义字段",- "manage_in_settings": "在设置中管理",- "empty_title": "尚无自定义字段",- "empty_description": "记录结构化的详细信息,例如材质、版型或保养说明。",- "values_saved": "自定义字段已保存",- "values_save_partial_failed": "部分自定义字段无法保存:{{fields}}",- "new_definition_title": "新建自定义字段",- "new_definition_description": "定义自定义字段,以在您的{{resource}}上存储有类型的结构化信息。",- "default_resource": "记录",- "errors": {- "failed_to_save": "保存自定义字段失败"- }+ "payment_statuses": {+ "balance_due": "待付款",+ "credit_owed": "应退款",+ "failed": "失败",+ "paid": "已付款",+ "void": "已作废"},- "adjustment_action_editor": {- "calculator_label": "计算器",- "loading_calculators": "正在加载计算器…",- "select_calculator": "选择一个计算器",- "no_extra_settings": "此计算器没有额外设置。",- "settings_label": "计算器设置"+ "statuses": {+ "canceled": "已取消",+ "draft": "草稿",+ "placed": "已下单"+ },+ "table": {+ "empty": "未找到订单",+ "search_placeholder": "搜索订单…"}},"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": "重命名销售渠道或将其暂停。已停用的销售渠道将停止接收订单。",+ "create_label": "创建销售渠道","delete_confirm": {- "title": "删除销售渠道?",- "message": "{{name}} 将被移除。关联到该渠道的商品和订单将失去其销售渠道引用。"+ "message": "{{name}} 将被移除。关联到该渠道的商品和订单将失去其销售渠道引用。",+ "title": "删除销售渠道?"},+ "edit_description": "重命名销售渠道或将其暂停。已停用的销售渠道将停止接收订单。",+ "edit_sheet_title": "编辑销售渠道",+ "empty_message": "暂无销售渠道",+ "no_channels_found": "未找到销售渠道","order_routing_rules": {- "title": "订单路由规则",- "help": "当路由策略为“规则(有序)”时,规则自上而下依次评估——第一个能唯一确定库存地点的规则胜出;平局则由下一条规则决定。",- "empty": "暂无路由规则——订单将使用默认库存地点。",- "add_cta": "添加规则",- "picker_title": "添加路由规则",- "edit_preferences": "编辑规则设置","active_toggle": "规则已启用",+ "add_cta": "添加规则","delete_confirm": {- "title": "删除路由规则?",- "message": "{{name}} 将从此渠道的路由顺序中移除。"- }+ "message": "{{name}} 将从此渠道的路由顺序中移除。",+ "title": "删除路由规则?"+ },+ "edit_preferences": "编辑规则设置",+ "empty": "暂无路由规则——订单将使用默认库存地点。",+ "help": "当路由策略为“规则(有序)”时,规则自上而下依次评估——第一个能唯一确定库存地点的规则胜出;平局则由下一条规则决定。",+ "picker_title": "添加路由规则",+ "title": "订单路由规则"},"search_placeholder": "搜索销售渠道…",- "no_channels_found": "未找到销售渠道",+ "title": "销售渠道","validation": {"code_format": "仅允许小写字母、数字、连字符和下划线"}},"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": "添加地址",+ "addresses_empty": "暂无已保存的地址。","edit_address": "编辑地址",+ "edit_credit": "编辑商店积分","issue_credit": "发放商店积分",- "edit_credit": "编辑商店积分"- }+ "orders_empty": "暂无订单。",+ "section_addresses": "地址",+ "section_internal_note": "内部备注",+ "section_orders": "订单",+ "section_profile": "资料",+ "section_store_credit": "商店积分",+ "section_tags": "标签",+ "stat_avg_order_value": "平均订单金额",+ "stat_orders": "订单",+ "stat_total_spent": "消费总额",+ "store_credit_empty": "尚未发放商店积分。"+ },+ "edit_sheet_title": "编辑客户",+ "groups": {+ "add_cta": "添加客户分组",+ "add_sheet_title": "添加客户分组",+ "edit_sheet_title": "编辑客户分组",+ "title": "客户分组"+ },+ "groups_cta": "客户分组",+ "new_cta": "新建客户"},- "orders": {- "drafts_title": "草稿订单",- "new": {- "title": "新建订单",- "section_customer": "客户",- "section_items": "商品",- "section_billing": "账单",- "section_notes": "备注",- "section_summary": "概览",- "add_line_item": "添加订单项",- "select_customer": "选择客户",- "search_variant": "搜索变体…"+ "getting_started": {+ "description": "完成这些步骤即可上线您的店铺。",+ "progress": "已完成 {{done}}/{{total}}",+ "storefront_sheet": {+ "api_url_label": "Store API URL",+ "deploy_button": "部署到 Vercel",+ "deploy_copy": "部署会将开源店铺前台克隆到您的 Git 账户,并在 Vercel 上使用预填的凭据构建。完成后,将其 URL 复制到下方字段。",+ "deploy_title": "推荐:部署官方 Next.js 店铺前台",+ "description": "在任何与 Store API 通信的客户端中使用这些凭据——网页店铺前台、移动应用或其他任何客户端。",+ "env_description": "您的 Spree Store API URL 和可发布密钥。两者均已从您的店铺预填——如有需要,请在部署前调整。",+ "invalid_url": "这看起来不是有效的店铺前台 URL。",+ "key_error": "无法加载您的可发布 API 密钥。",+ "local_installation_instructions": "本地安装说明",+ "publishable_key_label": "可发布 API 密钥",+ "save": "保存并完成设置",+ "saved": "店铺前台 URL 已保存:{{url}}",+ "see_online_demo": "查看在线演示",+ "storefront_url_help": "客户访问您店铺前台所用的 URL。它将成为客户邮件中链接的基础,并自动添加为允许的来源,以便基于浏览器的店铺前台调用 Store API。",+ "storefront_url_label": "店铺前台 URL",+ "storefront_url_placeholder": "https://myshop.com",+ "title": "连接您的店铺前台"},- "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 地址"+ "tasks": {+ "add_products": {+ "cta": "添加商品",+ "description": "为您的店铺添加商品——您自己的商品,或邀请第三方卖家共同销售。",+ "import_cta": "从 CSV 导入产品",+ "title": "添加商品"},- "empty_payments": "暂无付款。",- "empty_shipments": "暂无发货。",- "no_delivery_method": "未选择配送方式。",- "empty_history": "暂无历史记录。",+ "set_customer_support_email": {+ "cta": "邮件设置",+ "description": "显示在店铺前台,作为客户咨询和支持的联系方式。",+ "title": "设置客服邮箱"+ },+ "setup_payment_method": {+ "cta": "设置支付方式",+ "description": "要收款,请至少设置一个在线支付服务商。",+ "title": "设置支付方式"+ },+ "setup_storefront": {+ "cta": "连接店铺前台",+ "description": "使用 Store API 凭据连接您的网页店铺前台或移动应用,并保存店铺前台 URL。",+ "title": "设置店铺前台"+ },+ "setup_taxes_collection": {+ "cta": "税费设置",+ "description": "要收取税费,请设置您的税率。",+ "title": "设置税费"+ }+ },+ "title": "快速入门"+ },+ "home": {+ "columns": {+ "price": "价格",+ "product": "商品",+ "sold": "已售"+ },+ "metric_short": {+ "avg_order_value": "客单价",+ "orders": "订单数",+ "sales": "销售额"+ },+ "metrics": {+ "avg_order_value": "平均订单金额",+ "orders": "总订单数",+ "sales": "总销售额"+ },+ "subtitle": "您的店铺业绩概览",+ "title": "仪表盘",+ "top_products": "热销商品",+ "top_products_description": "您店铺中最畅销的商品。"+ },+ "orders": {+ "detail": {"actions": {"approve": "批准","cancel": "取消订单",- "resume": "恢复",- "refund": "退款","capture": "扣款",- "void": "作废","mark_paid": "标记为已付款",- "ship": "标记为已发货"+ "refund": "退款",+ "resume": "恢复",+ "ship": "标记为已发货",+ "void": "作废"},"dialogs": {- "cancel_title": "取消订单?","approve_title": "批准订单?",+ "cancel_title": "取消订单?","refund_title": "退款付款?"+ },+ "empty_history": "暂无历史记录。",+ "empty_payments": "暂无付款。",+ "empty_shipments": "暂无发货。",+ "no_delivery_method": "未选择配送方式。",+ "section_billing_address": "账单地址",+ "section_customer": "客户",+ "section_customer_note": "客户备注",+ "section_fulfillments": "履约单",+ "section_history": "历史记录",+ "section_internal_note": "内部备注",+ "section_items": "商品",+ "section_payments": "付款",+ "section_shipping_address": "收货地址",+ "section_summary": "概览",+ "summary": {+ "channel": "销售渠道",+ "created_by": "创建人",+ "ip_address": "IP 地址",+ "locale": "语言区域",+ "market": "市场"}+ },+ "drafts_title": "草稿订单",+ "new": {+ "add_line_item": "添加订单项",+ "search_variant": "搜索变体…",+ "section_billing": "账单",+ "section_customer": "客户",+ "section_items": "商品",+ "section_notes": "备注",+ "section_summary": "概览",+ "select_customer": "选择客户",+ "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": "变体",- "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_add_failed": "将商品添加到分类失败",+ "categories_add_title": "添加到分类",+ "categories_added": "已将 {n} 个商品添加到分类","categories_remove_description": "选择要将这些商品从中移除的分类。",- "channels_add_title": "添加到销售渠道",+ "categories_remove_failed": "将商品从分类中移除失败",+ "categories_remove_title": "从分类中移除",+ "categories_removed": "已将 {n} 个商品从分类中移除","channels_add_description": "选择要上架这些商品的销售渠道。",- "channels_remove_title": "从销售渠道中移除",+ "channels_add_failed": "在销售渠道上架商品失败",+ "channels_add_title": "添加到销售渠道",+ "channels_added": "已在销售渠道上架 {n} 个商品","channels_remove_description": "选择要将这些商品下架的销售渠道。",- "tags_add_title": "添加标签",- "tags_add_description": "选择或创建要添加到这些商品的标签。",- "tags_remove_title": "移除标签",- "tags_remove_description": "选择要从这些商品移除的标签。",+ "channels_remove_failed": "将商品从销售渠道下架失败",+ "channels_remove_title": "从销售渠道中移除",+ "channels_removed": "已将 {n} 个商品从销售渠道下架","delete_confirm": {- "title": "删除 {n} 个商品?",- "message": "所选商品将被移除。此操作无法撤销。"+ "message": "所选商品将被移除。此操作无法撤销。",+ "title": "删除 {n} 个商品?"},- "status_updated": "已更新 {n} 个商品的状态",+ "delete_failed": "删除商品失败",+ "deleted": "已删除 {n} 个商品",+ "remove_categories_action": "从分类中移除…",+ "remove_channels_action": "从销售渠道中移除…",+ "remove_tags_action": "移除标签…",+ "set_status_action": "设置状态…",+ "status_sheet_description": "选择要应用到所选商品的状态。",+ "status_sheet_title": "设置商品状态","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} 个商品添加标签",+ "status_updated": "已更新 {n} 个商品的状态",+ "tags_add_description": "选择或创建要添加到这些商品的标签。","tags_add_failed": "添加标签失败",- "tags_removed": "已从 {n} 个商品移除标签",+ "tags_add_title": "添加标签",+ "tags_added": "已为 {n} 个商品添加标签",+ "tags_remove_description": "选择要从这些商品移除的标签。","tags_remove_failed": "移除标签失败",- "deleted": "已删除 {n} 个商品",- "delete_failed": "删除商品失败"+ "tags_remove_title": "移除标签",+ "tags_removed": "已从 {n} 个商品移除标签"},- "media_empty": "暂无媒体。",- "media_upload": "上传媒体",- "variants_empty": "暂无变体。",- "status_options": {- "draft": "草稿",- "active": "启用",- "archived": "已归档"+ "clone_failed": "复制商品失败",+ "clone_succeeded": "商品已复制",+ "delete_failed": "删除商品失败",+ "delete_succeeded": "商品已删除",+ "edit": {+ "bulk_prices": {+ "no_variants": "至少添加一个变体以开始编辑价格。"+ }},"inventory": {- "out_of_stock": "缺货",+ "in_stock": "库存 {{count}} 件","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": "暂无商品。"+ "out_of_stock": "缺货"},- "options": {- "sheet_title_create": "创建选项类型",- "sheet_title_edit": "编辑选项类型",- "values_section": "值",- "values_empty": "暂无值。",+ "media_empty": "暂无媒体。",+ "media_upload": "上传媒体",+ "new": {+ "create_failed": "创建商品失败",+ "create_succeeded": "商品已创建",+ "description": "设置您的商品 — 添加变体、价格、库存、媒体和自定义字段",+ "preview_slug_placeholder": "your-product-slug",+ "save_label": "创建商品",+ "title": "新建商品"+ },+ "options": {"add_value": "添加选项值",+ "sheet_title_create": "创建选项类型",+ "sheet_title_edit": "编辑选项类型","table": {"values": "值"- }+ },+ "values_empty": "暂无值。",+ "values_section": "值"},"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}} 上线,并持续生效至其结束日期。"+ "message_with_end": "“{{name}}”将立即应用于符合条件的客户,并保持有效,直至手动停用或到达结束日期({{ends_at}})。",+ "title": "激活价格列表?"},+ "add_cta": "新建价格表",+ "add_products_cta": "添加商品",+ "add_rule": "添加规则",+ "add_rule_help": "选择要配置的规则类型。",+ "basics_section": "基本信息",+ "deactivate": "停用","deactivate_confirm": {- "title": "停用价格表?",- "message": "\"{{name}}\" 将立即对客户停止生效。已有订单不受影响。"+ "message": "\"{{name}}\" 将立即对客户停止生效。已有订单不受影响。",+ "title": "停用价格表?"},- "unschedule_confirm": {- "title": "取消价格表的排期?",- "message": "\"{{name}}\" 将不再在其排定的日期激活。您可以稍后重新排期或手动激活它。"+ "delete_confirm": {+ "message": "移除\"{{name}}\"将删除其价格。此操作无法撤销。",+ "title": "删除价目表?"},"edit_prices": {- "title": "编辑价格 — {{name}}",- "currency_label": "货币",- "empty": "此列表中暂无商品。","add_products_link": "添加商品","columns": {+ "compare_at_price": "对比价",+ "price": "价格","product": "商品",- "variant": "变体","sku": "SKU",- "price": "价格",- "compare_at_price": "对比价"+ "variant": "变体"},- "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": "暂无基础价格。",+ "currency_label": "货币","dirty_summary_one": "{{count}} 项未保存的更改","dirty_summary_other": "{{count}} 项未保存的更改","discard_confirm": {- "title": "放弃未保存的价格?","message_close_one": "您有 {{count}} 个未保存的价格。关闭将放弃它。","message_close_other": "您有 {{count}} 个未保存的价格。关闭将放弃它们。",- "message_currency": "切换货币将放弃您未保存的价格。"- }+ "message_currency": "切换货币将放弃您未保存的价格。",+ "title": "放弃未保存的价格?"+ },+ "empty": "此列表中暂无商品。",+ "empty_no_base_prices": "暂无基础价格。",+ "empty_pick_products": "在价目表中选择商品以开始设置价格。",+ "grid_aria": "变体价格",+ "no_matches_for_filters": "没有价格符合当前筛选条件。",+ "no_matches_for_search": "没有价格匹配 \"{{search}}\"。",+ "price_aria": "{{label}} 的价格",+ "save_cta": "保存价格",+ "save_failed": "保存价格失败",+ "save_success_one": "已保存 {{count}} 个价格",+ "save_success_other": "已保存 {{count}} 个价格",+ "search_placeholder": "按商品、SKU 或选项搜索…",+ "title": "编辑价格 — {{name}}",+ "variant_default": "默认"},+ "edit_prices_cta": "编辑价格",+ "no_changes": "没有需要保存的更改。",+ "prices_help_one": "已配置 {{count}} 个价格。打开批量编辑器进行更新。",+ "prices_help_other": "已配置 {{count}} 个价格。打开批量编辑器进行更新。",+ "prices_help_zero": "在上方选择商品以生成占位价格,然后打开批量编辑器。","products_empty": "暂无商品——添加一个以开始编辑价格。",- "no_changes": "没有需要保存的更改。"- }+ "products_empty_search": "没有匹配的商品",+ "products_help": "选择此价格表适用的商品。保存时会创建占位价格——请在下方填写。",+ "products_search_placeholder": "按名称搜索商品…",+ "products_section": "商品",+ "products_selected_one": "已选择 {{count}} 个商品。",+ "products_selected_other": "已选择 {{count}} 个商品。",+ "remove_rule_confirm": {+ "message": "保存价格列表时将移除该规则。",+ "title": "移除规则?"+ },+ "remove_selected": "移除所选",+ "rule_click_to_configure": "点击进行配置",+ "rule_default_description": "调整该规则的参数。",+ "rule_name_overflow": "{{names}} 等 {{count}} 项",+ "rule_no_options": "此规则没有可配置选项——只要存在即应用该约束。",+ "rule_types_all_used": "所有可用的规则类型均已添加到此价格表。",+ "rule_types_empty": "未注册任何规则类型。",+ "rules_empty": "暂无规则——此价格表适用于所有购物者。",+ "rules_help": "决定此价格表何时生效的条件。使用“全部”要求满足每条规则,使用“任意”取第一个匹配项。",+ "rules_section": "规则",+ "schedule": "安排",+ "schedule_confirm": {+ "message": "\"{{name}}\" 将于 {{starts_at}} 上线,并持续生效至其结束日期。",+ "title": "排定价目表上线时间?"+ },+ "schedule_section": "安排",+ "sheet_title_create": "创建价格表",+ "sheet_title_edit": "编辑价格表",+ "subtitle": "针对客户群体、地区或批量层级的定向定价。",+ "title": "价格表",+ "unschedule": "取消安排",+ "unschedule_confirm": {+ "message": "\"{{name}}\" 将不再在其排定的日期激活。您可以稍后重新排期或手动激活它。",+ "title": "取消价格表的排期?"+ }+ },+ "publishing": {+ "caption_hidden_after": "将于 {{date}} 下架",+ "caption_live": "现在对客户可见",+ "caption_not_available": "已隐藏 — 产品状态为 {{product_status}}",+ "caption_scheduled": "将于 {{date}} 上线",+ "caption_unpublished": "已于 {{date}} 隐藏",+ "caption_window": "上线时间 {{start}} → {{end}}",+ "empty": "尚未在任何销售渠道上展示。",+ "inactive_marker": "未启用",+ "manage_cta": "管理",+ "manage_description": "选择哪些销售渠道展示此产品。关闭某个渠道即可在所有位置下架。",+ "manage_title": "管理销售渠道",+ "no_channels": "暂无可用的销售渠道。请在 设置 → 销售渠道 中创建。",+ "status_hidden": "已隐藏",+ "status_live": "已上线",+ "status_not_available": "不可用",+ "status_scheduled": "已排期",+ "title": "发布"+ },+ "section_basics": "基本信息",+ "section_categorization": "分类",+ "section_inventory": "库存",+ "section_media": "媒体",+ "section_organization": "组织",+ "section_pricing": "价格",+ "section_seo": "SEO",+ "section_variants": "变体",+ "status_options": {+ "active": "启用",+ "archived": "已归档",+ "draft": "草稿"+ },+ "transfers": {+ "description_external": "外部收货至 <strong>{{destination}}</strong>。",+ "description_internal": "库存从 <strong>{{source}}</strong> 调拨至 <strong>{{destination}}</strong>。",+ "edit_sheet_title": "调拨 {{number}}",+ "items_empty": "暂无商品。",+ "section_from": "从",+ "section_items": "商品",+ "section_to": "至",+ "sheet_title": "新建库存调拨"+ },+ "variants_empty": "暂无变体。",+ "variants_one": "{{count}} 个变体",+ "variants_other": "{{count}} 个变体"+ },+ "profile": {+ "load_failed_title": "无法加载您的个人资料",+ "personal_details": "个人详细信息",+ "subtitle": "管理您的个人详细信息和管理后台语言。",+ "title": "个人资料"+ },+ "promotions": {+ "create_cta": "创建优惠活动",+ "gift_cards": {+ "batch_section": "批次",+ "create_batch_cta": "创建 {{count}} 张礼品卡",+ "create_label": "创建礼品卡",+ "delete_confirm": {+ "message": "此操作将作废该礼品卡并使其无法兑换。",+ "title": "删除礼品卡?"+ },+ "edit_sheet_title": "礼品卡",+ "new_cta": "新建礼品卡",+ "new_sheet_title": "新建礼品卡",+ "no_customer": "未关联客户",+ "not_found": "未找到礼品卡。",+ "prefix": {+ "auto_placeholder": "留空时自动生成",+ "label": "前缀",+ "placeholder": "例如 WELCOME — 代码将为 WELCOME-abc123"+ },+ "sheet": {+ "create_description": "签发单张礼品卡,或生成一批带自动生成代码的礼品卡。",+ "edit_description": "更新礼品卡的客户或有效期。代码和金额在签发后不可更改。"+ },+ "status_options": {+ "expired": "已过期",+ "redeemed": "已兑换",+ "void": "已作废"+ },+ "usage": {+ "issued_by": "签发人",+ "remaining": "剩余",+ "title": "使用情况",+ "used": "已使用"+ },+ "validation": {+ "amount_positive": "金额必须大于零",+ "amount_required": "金额为必填项",+ "currency_required": "货币为必填项",+ "prefix_required": "批次需填写前缀"+ }+ },+ "loading": "正在加载优惠活动…",+ "new_title": "新建优惠活动"},"settings": {- "store": {- "title": "店铺设置",- "subtitle": "通用配置与店铺级默认设置。",- "tab_general": "通用",- "tab_standards": "标准与格式",- "tab_storefront_access": "店铺访问权限"+ "allowed_origins": {+ "add_sheet_title": "添加允许的来源",+ "edit_sheet_title": "编辑允许的来源"+ },+ "api_keys": {+ "empty_publishable": "暂无可公开密钥。",+ "empty_secret": "暂无私密密钥。",+ "new_cta": "新建密钥",+ "publishable_help": "供您的店面使用。可安全地暴露在客户端代码中。",+ "publishable_section": "可公开密钥",+ "save_secret_description": "请立即复制此值 — 我们不会再次显示它。",+ "save_secret_title": "保存您的私密密钥",+ "scope_badge": {+ "full_access": "完全访问",+ "read_all": "读取全部"+ },+ "secret_help": "仅限服务器到服务器使用。请为每个密钥限定所需的操作范围。",+ "secret_section": "私密密钥",+ "subtitle": "授权集成和应用调用 Admin API。",+ "table": {+ "all_channels": "All channels",+ "channel": "Channel",+ "key": "密钥",+ "last_used_at": "最近使用",+ "scopes": "范围"+ },+ "title": "API 密钥"+ },+ "custom_field_definitions": {+ "add_sheet_title": "添加自定义字段",+ "edit_sheet_title": "编辑自定义字段"},"emails": {- "title": "邮件设置",- "subtitle": "发件人地址、通知,以及嵌入在交易邮件中的徽标。",- "section_delivery": "发送",+ "load_failed_title": "无法加载邮件设置",+ "logo_dimensions_help": "推荐:204×104 像素。","section_addresses": "邮件地址",+ "section_delivery": "发送","section_logo": "徽标",- "logo_dimensions_help": "推荐:204×104 像素。",- "load_failed_title": "无法加载邮件设置"+ "subtitle": "发件人地址、通知,以及嵌入在交易邮件中的徽标。",+ "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": "最近的投递记录",+ "imports": {"delete_confirm": {- "title": "删除 webhook 端点?",- "message": "{{name}} 将立即停止接收投递。过往的投递历史也将被删除。"+ "message": "这将删除 {{number}} 及其行数据和上传的文件。",+ "title": "删除导入?"},- "detail": {- "load_failed_title": "无法加载此 Webhook 端点",- "delete_label": "删除端点",- "details_title": "详情",- "edit_title": "编辑端点",- "url": "目标 URL",- "subscriptions": "事件"+ "empty_title": "暂无导入",+ "search_placeholder": "按编号搜索…",+ "table": {+ "failed_count": "{{failed}} 条失败",+ "number": "编号",+ "rows": "行数",+ "status": "状态",+ "type": "类型"},- "save_secret_title": "保存你的签名密钥",- "save_secret_description": "使用此密钥验证传入的 Webhook 签名。我们不会再次显示它。",+ "title": "导入"+ },+ "markets": {+ "add_sheet_title": "添加市场",+ "edit_sheet_title": "编辑市场"+ },+ "payment_methods": {+ "add_sheet_title": "添加支付方式",+ "edit_sheet_title": "编辑支付方式"+ },+ "stock_locations": {+ "add_sheet_title": "添加库存位置",+ "edit_sheet_title": "编辑库存位置",+ "search_placeholder": "搜索库存位置…"+ },+ "store": {+ "subtitle": "通用配置与店铺级默认设置。",+ "tab_general": "通用",+ "tab_standards": "标准与格式",+ "tab_storefront_access": "店铺访问权限",+ "title": "店铺设置"+ },+ "tax_categories": {+ "add_sheet_title": "添加税收类别",+ "edit_sheet_title": "编辑税收类别"+ },+ "webhooks": {"actions": {- "send_test": "发送测试","disable": "停用","enable": "重新启用",- "view_deliveries": "查看投递记录",- "redeliver": "重新投递"+ "redeliver": "重新投递",+ "send_test": "发送测试",+ "view_deliveries": "查看投递记录"},- "status": {- "inactive": "未启用",- "disabled": "自动禁用",- "disabled_reason": "已禁用:{{reason}}"+ "add_sheet_title": "添加 Webhook 端点",+ "delete_confirm": {+ "message": "{{name}} 将立即停止接收投递。过往的投递历史也将被删除。",+ "title": "删除 webhook 端点?"},- "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}} 次失败"+ "deliveries": {+ "detail": {+ "copy_payload_aria": "复制请求负载",+ "copy_response_aria": "复制响应正文",+ "delivered_at": "投递时间",+ "error_type": "错误类型",+ "event": "事件",+ "execution_time": "执行耗时",+ "request_errors": "传输错误",+ "request_payload": "请求负载",+ "response_body": "响应正文",+ "response_body_truncated": "响应正文已被截断至 {{limit}} 个字符。",+ "response_code": "响应代码",+ "url": "目标 URL"+ },+ "detail_sheet_title": "投递详情",+ "empty": "暂无投递记录 — 发送一次测试以验证你的端点。",+ "redeliver_queued": "重新投递已加入队列。",+ "search_placeholder": "按事件名称搜索…",+ "status": {+ "error": "错误",+ "failure": "失败",+ "pending": "待处理",+ "success": "成功"+ },+ "table": {+ "code": "响应",+ "delivered_at": "投递时间",+ "event": "事件",+ "execution_time": "耗时"+ },+ "test_failed": "发送测试 Webhook 失败。",+ "test_sent": "测试 Webhook 已加入队列。"},- "table": {- "url": "URL",- "events": "事件",- "recent_deliveries": "最近 7 天",- "last_delivery": "最近一次投递",- "copy_url_aria": "复制 URL"+ "deliveries_sheet_title": "最近的投递记录",+ "detail": {+ "delete_label": "删除端点",+ "details_title": "详情",+ "edit_title": "编辑端点",+ "load_failed_title": "无法加载此 Webhook 端点",+ "subscriptions": "事件",+ "url": "目标 URL"},- "events_all": "所有事件",- "events_count_one": "{{count}} 个事件",- "events_count_other": "{{count}} 个事件",- "events_custom_input_placeholder": "custom.event_name",- "events_remove_aria": "移除 {{event}}",+ "edit_sheet_title": "编辑 Webhook 端点",+ "empty_description": "创建一个端点,在订阅的事件触发时接收已签名的 POST 请求。",+ "empty_title": "暂无 Webhook 端点","event_groups": {"asset": "资源","custom": "自定义","customer": "客户","digital": "数字内容",+ "fulfillment": "履约","gift_card": "礼品卡","gift_card_batch": "礼品卡批次","import_export": "导入 / 导出",@@ -1561,7 +2133,6 @@"refund": "退款","report": "报表","return": "退货",- "shipment": "发货","stock_item": "库存项","stock_movement": "库存变动","stock_reservation": "库存预留",@@ -1570,1166 +2141,716 @@"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": "暂无私密密钥。",+ "events_all": "所有事件",+ "events_count_one": "{{count}} 个事件",+ "events_count_other": "{{count}} 个事件",+ "events_custom_input_placeholder": "custom.event_name",+ "events_remove_aria": "移除 {{event}}",+ "health": {+ "auto_disabled_alert": "此端点因多次投递失败已被自动禁用。",+ "degraded": "降级 ({{percentage}}%)",+ "disabled": "已禁用",+ "failing": "故障中 ({{percentage}}%)",+ "healthy": "正常 ({{percentage}}%)",+ "label": "运行状况",+ "metric_failed": "失败",+ "metric_successful": "成功",+ "metric_total": "投递次数",+ "no_deliveries": "暂无投递记录",+ "re_enable_cta": "重新启用",+ "row_counters_failed_one": "{{count}} 次失败",+ "row_counters_failed_other": "{{count}} 次失败",+ "row_counters_successful_one": "{{count}} 次成功",+ "row_counters_successful_other": "{{count}} 次成功"+ },+ "new_cta": "新建端点",+ "save_secret_description": "使用此密钥验证传入的 Webhook 签名。我们不会再次显示它。",+ "save_secret_title": "保存你的签名密钥",+ "search_placeholder": "按 URL 搜索…",+ "status": {+ "disabled": "自动禁用",+ "disabled_reason": "已禁用:{{reason}}",+ "inactive": "未启用"+ },+ "subtitle": "订阅 HTTPS 端点以接收店铺触发的事件。","table": {- "key": "密钥",- "scopes": "范围",- "last_used_at": "最近使用",- "channel": "Channel",- "all_channels": "All channels"+ "copy_url_aria": "复制 URL",+ "events": "事件",+ "last_delivery": "最近一次投递",+ "recent_deliveries": "最近 7 天",+ "url": "URL"},- "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": "编辑税收类别"+ "title": "Webhooks"+ }+ },+ "staff": {+ "actions": {+ "remove": "从员工中移除",+ "resend": "重新发送"},- "markets": {- "add_sheet_title": "添加市场",- "edit_sheet_title": "编辑市场"+ "edit_sheet": {+ "title": "编辑团队成员"},- "custom_field_definitions": {- "add_sheet_title": "添加自定义字段",- "edit_sheet_title": "编辑自定义字段"+ "empty": "暂无员工",+ "empty_description": "邀请团队成员协作管理此店铺。",+ "invitations_section": "待处理邀请",+ "invite_cta": "邀请团队成员",+ "invite_sheet": {+ "description": "我们将通过电子邮件向其发送设置密码的链接。",+ "title": "邀请团队成员"},- "stock_locations": {- "add_sheet_title": "添加库存位置",- "edit_sheet_title": "编辑库存位置",- "search_placeholder": "搜索库存位置…"+ "members_section": "成员",+ "messages": {+ "removed": "已从员工中移除",+ "revoked": "邀请已撤销",+ "updated": "员工已更新"},- "allowed_origins": {- "add_sheet_title": "添加允许的来源",- "edit_sheet_title": "编辑允许的来源"+ "subtitle": "管理后台团队成员和角色",+ "table": {+ "member": "成员",+ "role": "角色",+ "roles": "角色"},- "imports": {- "title": "导入",- "search_placeholder": "按编号搜索…",- "empty_title": "暂无导入",- "table": {- "number": "编号",- "type": "类型",- "status": "状态",- "rows": "行数",- "failed_count": "{{failed}} 条失败"- },- "delete_confirm": {- "title": "删除导入?",- "message": "这将删除 {{number}} 及其行数据和上传的文件。"- }- }- },- "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": "无法加载您的个人资料"- },- "getting_started": {- "title": "快速入门",- "description": "完成这些步骤即可上线您的店铺。",- "progress": "已完成 {{done}}/{{total}}",- "tasks": {- "setup_payment_method": {- "title": "设置支付方式",- "description": "要收款,请至少设置一个在线支付服务商。",- "cta": "设置支付方式"- },- "add_products": {- "title": "添加商品",- "description": "为您的店铺添加商品——您自己的商品,或邀请第三方卖家共同销售。",- "cta": "添加商品",- "import_cta": "从 CSV 导入产品"- },- "set_customer_support_email": {- "title": "设置客服邮箱",- "description": "显示在店铺前台,作为客户咨询和支持的联系方式。",- "cta": "邮件设置"- },- "setup_taxes_collection": {- "title": "设置税费",- "description": "要收取税费,请设置您的税率。",- "cta": "税费设置"- },- "setup_storefront": {- "title": "设置店铺前台",- "description": "使用 Store API 凭据连接您的网页店铺前台或移动应用,并保存店铺前台 URL。",- "cta": "连接店铺前台"- }- },- "storefront_sheet": {- "title": "连接您的店铺前台",- "description": "在任何与 Store API 通信的客户端中使用这些凭据——网页店铺前台、移动应用或其他任何客户端。",- "api_url_label": "Store API URL",- "publishable_key_label": "可发布 API 密钥",- "deploy_title": "推荐:部署官方 Next.js 店铺前台",- "deploy_copy": "部署会将开源店铺前台克隆到您的 Git 账户,并在 Vercel 上使用预填的凭据构建。完成后,将其 URL 复制到下方字段。",- "deploy_button": "部署到 Vercel",- "env_description": "您的 Spree Store API URL 和可发布密钥。两者均已从您的店铺预填——如有需要,请在部署前调整。",- "storefront_url_label": "店铺前台 URL",- "storefront_url_help": "客户访问您店铺前台所用的 URL。它将成为客户邮件中链接的基础,并自动添加为允许的来源,以便基于浏览器的店铺前台调用 Store API。",- "save": "保存并完成设置",- "saved": "店铺前台 URL 已保存:{{url}}",- "invalid_url": "这看起来不是有效的店铺前台 URL。",- "see_online_demo": "查看在线演示",- "local_installation_instructions": "本地安装说明",- "key_error": "无法加载您的可发布 API 密钥。",- "storefront_url_placeholder": "https://myshop.com"- }- }- },- "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": "操作",- "validation": {- "role_required": "请选择一个角色",- "roles_required": "请至少选择一个角色"- }- },- "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": "任何使用此密钥的集成都将立即停止工作。"+ "title": "员工"+ }+ },+ "payment_methods": {+ "add_cta": "添加支付方式",+ "columns": {+ "storefront": "店面"},+ "create_description": "选择服务商并配置其凭据。",+ "create_label": "创建支付方式","delete_confirm": {- "title": "删除密钥?",- "message": "此操作将永久删除密钥。如果以后可能需要恢复访问权限,建议改用撤销。"+ "message": "{{name}} 将不再在结账时可用。",+ "title": "删除支付方式?"},- "dropdown": {- "revoke": "撤销密钥",- "copy_token_aria": "复制 token"+ "edit_description": "更新名称、可见性或状态。",+ "empty": "尚未配置支付方式",+ "messages": {+ "created": "支付方式已创建",+ "deleted": "支付方式已删除",+ "updated": "支付方式已更新"},- "badge": {- "revoked": "已撤销",- "never_used": "从未使用"+ "provider_description": "服务商:{{provider}}",+ "search_placeholder": "按名称搜索…",+ "status": {+ "disabled": "已禁用"},- "errors": {- "failed_to_delete": "删除密钥失败",- "failed_to_update": "更新密钥失败",- "failed_to_create": "创建密钥失败"+ "storefront": {+ "admin_only": "仅管理员",+ "visible": "可见"},- "by_email": "由 {{email}}",- "create_key_cta": "创建密钥",- "validation": {- "scope_required": "请至少选择一个权限范围"- }+ "title": "支付方式"},- "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": "向此客户账户发放商店积分。"- },- "groups": {- "title": "客户群组",- "empty": "不在任何群组中",- "edit_title": "编辑客户群组",- "edit_description": "添加或移除此客户所属的群组。",- "save_failed": "更新客户群组失败"- }- },- "new_sheet_description": "在此创建的客户未设置密码。他们首次登录时将收到一个魔法链接。",- "autocomplete": {- "placeholder": "搜索客户…",- "empty": "没有匹配的客户"- }+ "preferences": {+ "additional_item": "附加件费用",+ "amount": "金额",+ "base_amount": "基础金额",+ "base_percent": "基础百分比",+ "currency": "货币",+ "discount_amount": "折扣金额",+ "first_item": "首件费用",+ "flat_percent": "固定百分比",+ "max_items": "最大件数",+ "max_quantity": "最大数量",+ "min_quantity": "最小数量",+ "minimal_amount": "最小金额",+ "normal_amount": "标准金额",+ "percent": "百分比",+ "preferred_amount": "金额",+ "preferred_percent": "百分比"},- "orders": {- "table": {- "search_placeholder": "搜索订单…",- "empty": "未找到订单"- },+ "products": {+ "category_search_placeholder": "搜索分类…","columns": {- "number": "编号",- "date": "日期",- "customer": "客户",- "payment": "付款",- "fulfillment": "履约",- "items": "商品",- "tags": "标签",+ "in_stock": "库存",+ "price": "价格","sku": "SKU"},- "item_count_one": "{{count}} 件商品",- "item_count_other": "{{count}} 件商品",- "statuses": {- "draft": "草稿",- "placed": "已下单",- "canceled": "已取消"- },- "payment_statuses": {- "balance_due": "待付款",- "credit_owed": "应退款",- "failed": "失败",- "paid": "已付款",- "void": "已作废"+ "delete_confirm": "确定要删除此产品吗?",+ "delete_label": "删除产品",+ "inventory": {+ "backorder_aria": "允许在 {{location}} 延期交货",+ "columns": {+ "backorder": "延期交货",+ "location": "库存地点",+ "on_hand": "现有库存"+ },+ "empty_no_locations": "在「设置」中添加库存地点以开始跟踪库存。",+ "empty_no_variants": "库存水平按库存地点管理。添加一个变体以开始跟踪库存。",+ "on_hand_aria": "{{location}} 的现有库存",+ "unknown_location": "未知位置"},- "fulfillment_statuses": {- "backorder": "缺货补订",- "canceled": "已取消",- "partial": "部分完成",- "pending": "待处理",- "ready": "已就绪",- "fulfilled": "已履行"+ "media": {+ "assigned_variants_help": "选择此图片所代表的变体。留空则应用于所有变体。",+ "assigned_variants_label": "关联的变体",+ "delete_confirm": "删除此媒体?此操作无法撤销。",+ "drop_hint": "将媒体拖放到此处,或点击浏览",+ "edit_title": "编辑媒体",+ "file_types_hint": "PNG、JPG、WebP,最大 10MB",+ "upload_failed": "上传 {{name}} 失败:{{message}}",+ "upload_status_failed": "失败"},- "new": {- "use_default_addresses": "使用客户的默认账单和配送地址",- "add_variant": "添加变体",- "items_table": {- "variant": "变体",- "sku": "SKU",- "qty": "数量"+ "no_categories_found": "未找到分类",+ "options": {+ "add_cta": "添加选项类型",+ "count_one": "{{count}} 个值",+ "count_other": "{{count}} 个值",+ "create_description": "定义变体可使用的选项(例如尺寸、颜色)。",+ "create_label": "创建选项类型",+ "delete_confirm": {+ "message": "此操作还将删除其所有值。使用这些值的变体将失去这些值。",+ "title": "删除选项类型?"},- "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": "从订单中移除商店积分吗?"+ "edit_description": "编辑选项类型及其值。",+ "image_upload_failed": "图片上传失败",+ "kinds": {+ "buttons": "按钮",+ "color_swatch": "颜色色板",+ "dropdown": "下拉菜单"},- "dropdown": {- "complete_order": "完成订单",- "preview_order": "预览订单",- "resend_confirmation": "重新发送确认",- "edit_quantity": "编辑数量",- "cancel_shipment": "取消发货",- "void_payment": "作废付款"+ "value_label_placeholder": "例如 Small",+ "value_name_placeholder": "例如 small",+ "values_help": "拖动值以重新排序。第一个值是新变体的默认值。"+ },+ "price_lists": {+ "errors": {+ "failed_to_activate": "启用价目表失败",+ "failed_to_deactivate": "停用价目表失败"},"messages": {- "canceled": "订单已取消",- "completed": "订单已完成",- "approved": "订单已批准",- "resumed": "订单已恢复",- "shipped": "发货已发出",- "captured": "付款已收取",- "voided": "付款已作废",- "confirmation_sent": "确认信息已发送"- },- "errors": {- "cancel_failed": "取消订单失败",- "complete_failed": "完成订单失败",- "approve_failed": "批准订单失败",- "resume_failed": "恢复订单失败",- "confirmation_send_failed": "发送确认失败"+ "activated": "价目表已启用",+ "created": "价目表已创建",+ "deactivated": "价目表已停用",+ "deleted": "价目表已删除",+ "updated": "价目表已更新"},- "variant_search": {- "description": "搜索要添加到此订单的商品变体。",- "label": "搜索变体",- "empty": "未找到变体",- "sku_prefix": "SKU",- "placeholder": "输入商品名称或 SKU(至少 3 个字符)…"+ "validation": {+ "ends_after_starts": "必须晚于开始日期。"+ }+ },+ "save_label": "保存产品",+ "seo": {+ "meta_description_placeholder": "SEO 描述",+ "meta_title_placeholder": "SEO 标题",+ "slug_placeholder": "product-url-handle"+ },+ "tax_category_placeholder": "选择税务类别",+ "transfers": {+ "create_description": "在不同地点之间调拨库存,或从外部供应商接收新库存。",+ "delete_confirm": {+ "message": "此调拨创建的库存变动将被撤销。",+ "title": "删除此调拨?"},- "edit_quantity": {- "title": "编辑数量",- "description": "设置该订单行项目的数量。"+ "destination_placeholder": "选择目标地点",+ "details_card": "详情",+ "different_locations_error": "来源地点和目标地点必须不同。",+ "external_label": "外部(供应商接收)",+ "fields": {+ "created": "创建时间",+ "external_receive": "外部接收",+ "immutable_note": "库存调拨一经创建即不可更改。",+ "internal": "内部",+ "reference": "参考编号",+ "type": "类型"},"items_table": {- "item": "商品",- "price": "价格",- "qty": "数量"- },- "tracking": {- "label": "物流单号",- "description": "更新此发货单的物流单号。",- "prefix": "物流",- "shipped_prefix": "已发货",- "edit_title": "编辑物流单号",- "add_title": "添加物流单号"+ "qty": "数量",+ "sku": "SKU",+ "variant": "变体"},- "payments_table": {- "number": "编号",- "method": "方式",- "state": "州/省"+ "new_cta": "新建调拨",+ "reference_label": "参考编号",+ "reference_placeholder": "采购订单号、供应商发票…",+ "review_description": "创建前请检查此调拨。创建后将无法更改商品项。",+ "search_items_placeholder": "按名称或 SKU 搜索(3 个以上字符)…"+ },+ "variant_media_picker": {+ "add_count_one": "添加 {{count}} 个",+ "add_count_other": "添加 {{count}} 个",+ "empty_all_linked": "所有产品媒体已关联到此变体。",+ "empty_no_media": "尚无产品媒体 — 请先在产品上上传图片。",+ "title": "从产品图库选择",+ "trigger": "从产品图库选择"+ },+ "variants": {+ "add_option": "添加选项",+ "create_option_type": "新建选项类型",+ "create_option_type_title": "新选项类型",+ "create_value": "新值",+ "create_value_title": "新选项值",+ "default_variant": "默认变体",+ "edit_row_aria": "编辑 {{name}}",+ "edit_variant": "编辑变体 — {{name}}",+ "errors": {+ "failed_to_create_option_type": "创建选项类型失败",+ "failed_to_create_value": "创建值失败"},- "payment_form": {- "description": "对此订单的某种支付方式进行收款。",- "method_label": "支付方式",- "method_placeholder": "选择一种支付方式",- "source_label": "来源",- "amount_help": "留空则默认为未结清的余额。",- "capture_immediately": "立即扣款",- "title": "添加付款",- "source_requires_customer": "此支付方式需要已保存的来源。请先为订单分配一位客户。",- "no_saved_cards": "客户没有用于此支付方式的已保存银行卡。",- "source_placeholder": "选择一张已保存的银行卡…"+ "keep": "全部保留",+ "option_type_label": "选项类型",+ "option_type_placeholder": "请选择选项类型",+ "orphan_warning": "有 {{count}} 个现有变体将在保存时被移除:",+ "orphan_warning_one": "有 {{count}} 个现有变体不再与所选选项匹配,将在保存时被移除:",+ "orphan_warning_other": "有 {{count}} 个现有变体不再与所选选项匹配,将在保存时被移除:",+ "remove_row_aria": "移除 {{name}}",+ "sheet": {+ "availability": "可用性",+ "identity": "标识",+ "tax_category_placeholder": "继承自商品"},- "summary": {- "canceled_at": "取消时间",- "canceler": "取消人",- "approved_by": "审批人",- "promotions": "优惠",- "adjustments": "调整",- "tax_included": "税(含)",- "tax_additional": "税(额外)",- "payment_total": "支付总额",- "outstanding_balance": "未结余额"+ "title": "变体",+ "variant_label": "变体"+ }+ },+ "promotions": {+ "action_edit": {+ "description": "配置该操作的参数。",+ "no_options": "此操作没有可配置的选项。"+ },+ "action_picker": {+ "description": "选择当促销满足条件时应执行的操作。",+ "title": "添加操作"+ },+ "action_summary": {+ "variant_count": "{{count}} 个变体"+ },+ "action_types": {+ "create_adjustment": {+ "description": "在订单上创建优惠抵扣调整",+ "name": "创建整单调整"},- "gift_card_section": {- "title": "礼品卡和店铺积分",- "gift_card_label": "礼品卡",- "store_credit_label": "店铺积分",- "none_applied": "未应用",- "applied_suffix": "已应用",- "apply_balance": "应用客户的可用余额",- "requires_customer": "需要客户",- "apply_dialog_title": "应用礼品卡",- "apply_dialog_description": "输入要应用到此订单的礼品卡代码。",- "code_placeholder": "GIFT-XXXX-YYYY"+ "create_item_adjustments": {+ "description": "在某个订单项上创建优惠抵扣调整",+ "name": "创建按行项目调整"},- "address_edit": {- "shipping_title": "编辑收货地址",- "billing_title": "编辑账单地址"+ "create_line_items": {+ "description": "向购物车填充指定数量的变体",+ "name": "创建订单项"},- "no_customer": "无客户信息",- "section_customer_note": "特别说明",- "section_internal_note": "内部备注",- "completed_prefix": "已完成",- "add_line_item": {- "title": "添加订单项"+ "free_shipping": {+ "description": "使订单的所有发货免运费",+ "name": "免运费"+ }+ },+ "actions_card": {+ "add_action": "添加操作",+ "description": "促销满足条件时执行的操作。",+ "empty": "暂无操作。没有操作的促销在应用时不会产生任何效果。"+ },+ "basics_card": {+ "title": "基本信息"+ },+ "code": {+ "automatic": "自动",+ "multi": "multi"+ },+ "coupon_codes": {+ "description": "此促销活动自动生成的代码。只读 — 通过更改促销活动的代码数量设置来重新生成。",+ "description_with_count": "{{count}} 个自动生成的代码。只读 — 通过更改促销活动的代码数量设置来重新生成。",+ "empty": "尚未生成任何代码。",+ "export_csv": "导出 CSV",+ "states": {+ "partially_used": "部分使用",+ "used": "已使用"},- "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": "失败"+ "title": "优惠券代码",+ "unused": "未使用",+ "used": "已使用"+ },+ "delete_confirm": {+ "default_name": "此优惠",+ "message": "{{name}} 将被永久移除。被已完成订单引用的优惠无法删除。",+ "title": "删除优惠?"+ },+ "errors": {+ "failed_to_add_action": "添加操作失败",+ "failed_to_add_rule": "添加规则失败",+ "failed_to_remove_action": "移除操作失败",+ "failed_to_remove_rule": "移除规则失败",+ "failed_to_update_action": "更新操作失败",+ "failed_to_update_rule": "更新规则失败"+ },+ "generate_code": {+ "title": "生成随机代码"+ },+ "kinds": {+ "automatic": "自动(无需代码)",+ "coupon_code": "优惠码"+ },+ "match_policies": {+ "all": "必须满足所有规则",+ "all_hint": "必须满足所有规则。",+ "any": "满足任一规则即可",+ "any_hint": "满足任一规则即可。"+ },+ "messages": {+ "action_added": "操作已添加",+ "action_removed": "操作已移除",+ "action_updated": "操作已更新",+ "rule_added": "规则已添加",+ "rule_removed": "规则已移除",+ "rule_updated": "规则已更新"+ },+ "remove_action_confirm": {+ "message": "保存促销活动时移除。",+ "title": "移除操作?"+ },+ "remove_rule_confirm": {+ "message": "保存促销时移除。",+ "title": "移除规则?"+ },+ "rule_edit": {+ "description": "调整规则的参数。",+ "no_options": "此规则没有可配置的选项 — 仅其存在即可应用该约束。"},- "seo": {- "slug_placeholder": "product-url-handle",- "meta_title_placeholder": "SEO 标题",- "meta_description_placeholder": "SEO 描述"+ "rule_picker": {+ "description": "选择要配置的规则类型。",+ "title": "添加规则"},- "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": "数量"+ "rule_summary": {+ "category_count": "{{count}} 个分类",+ "customer_count": "{{count}} 位客户",+ "product_count": "{{count}} 个商品"+ },+ "rule_types": {+ "category": {+ "description": "订单包含指定分类中的商品",+ "name": "分类"},- "delete_confirm": {- "title": "删除此调拨?",- "message": "此调拨创建的库存变动将被撤销。"+ "country": {+ "description": "仅限收货地址在指定国家/地区的订单",+ "name": "国家/地区"},- "review_description": "创建前请检查此调拨。创建后将无法更改商品项。",- "details_card": "详情",- "fields": {- "type": "类型",- "internal": "内部",- "external_receive": "外部接收",- "reference": "参考编号",- "created": "创建时间",- "immutable_note": "库存调拨一经创建即不可更改。"- }- },- "options": {- "kinds": {- "dropdown": "下拉菜单",- "color_swatch": "颜色色板",- "buttons": "按钮"+ "currency": {+ "description": "仅限使用指定货币的订单",+ "name": "货币"},- "add_cta": "添加选项类型",- "create_label": "创建选项类型",- "create_description": "定义变体可使用的选项(例如尺寸、颜色)。",- "edit_description": "编辑选项类型及其值。",- "delete_confirm": {- "title": "删除选项类型?",- "message": "此操作还将删除其所有值。使用这些值的变体将失去这些值。"+ "customer": {+ "description": "仅对指定客户可用",+ "name": "客户"},- "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": "标识",- "availability": "可用性",- "tax_category_placeholder": "继承自商品"+ "customer_group": {+ "description": "仅对指定客户组中的客户可用",+ "name": "客户组"},- "errors": {- "failed_to_create_value": "创建值失败",- "failed_to_create_option_type": "创建选项类型失败"+ "customer_logged_in": {+ "description": "仅对已登录客户可用",+ "name": "仅限已登录客户"+ },+ "first_order": {+ "description": "必须是客户的首次订单",+ "name": "首次订单"+ },+ "item_total": {+ "description": "订单总额满足这些条件",+ "name": "商品总额"+ },+ "one_use_per_user": {+ "description": "每位用户仅限使用一次",+ "name": "每位用户限用一次"+ },+ "option_value": {+ "description": "订单包含具有匹配选项值的商品",+ "name": "选项值"+ },+ "product": {+ "description": "订单包含指定商品",+ "name": "商品"}},- "inventory": {- "columns": {- "location": "库存地点",- "on_hand": "现有库存",- "backorder": "延期交货"+ "rule_types_all_used": "所有可用的规则类型都已添加到此优惠中。",+ "rule_types_empty": "未注册任何规则类型。",+ "rules": {+ "category": {+ "empty": "没有匹配的分类",+ "label": "分类",+ "match_policy": {+ "all": {+ "description": "订单必须包含每个分类中的商品。",+ "label": "所有这些分类"+ },+ "any": {+ "description": "订单必须包含至少一个分类中的商品。",+ "label": "这些分类中的任意一个"+ }+ },+ "search_placeholder": "搜索分类…"},- "on_hand_aria": "{{location}} 的现有库存",- "backorder_aria": "允许在 {{location}} 延期交货",- "empty_no_locations": "在「设置」中添加库存地点以开始跟踪库存。",- "empty_no_variants": "库存水平按库存地点管理。添加一个变体以开始跟踪库存。",- "unknown_location": "未知位置"- },- "columns": {- "sku": "SKU",- "price": "价格",- "in_stock": "库存"- },- "price_lists": {- "messages": {- "created": "价目表已创建",- "updated": "价目表已更新",- "deleted": "价目表已删除",- "activated": "价目表已启用",- "deactivated": "价目表已停用"+ "channel": {+ "label": "渠道"},- "errors": {- "failed_to_activate": "启用价目表失败",- "failed_to_deactivate": "停用价目表失败"+ "country": {+ "empty": "没有匹配的国家/地区",+ "label": "国家/地区",+ "search_placeholder": "搜索国家/地区…"},- "validation": {- "ends_after_starts": "必须晚于开始日期。"+ "customer": {+ "empty": "没有匹配的客户",+ "label": "客户",+ "search_placeholder": "按姓名或邮箱搜索客户…"+ },+ "customer_group": {+ "empty": "没有匹配的客户组",+ "label": "客户组",+ "search_placeholder": "搜索客户组…"+ },+ "market": {+ "label": "市场"+ },+ "product": {+ "empty": "没有匹配的商品",+ "label": "商品",+ "match_policy": {+ "all": {+ "description": "订单必须包含每一个商品。",+ "label": "所有这些商品"+ },+ "any": {+ "description": "订单必须至少包含其中一个。",+ "label": "这些商品中的任意一个"+ },+ "none": {+ "description": "订单不得包含其中任何一个。",+ "label": "这些商品都不包含"+ }+ },+ "search_placeholder": "按名称搜索商品…"}},- "variant_media_picker": {- "trigger": "从产品图库选择",- "title": "从产品图库选择",- "empty_no_media": "尚无产品媒体 — 请先在产品上上传图片。",- "empty_all_linked": "所有产品媒体已关联到此变体。",- "add_count_one": "添加 {{count}} 个",- "add_count_other": "添加 {{count}} 个"- }- },- "payment_methods": {- "add_cta": "添加支付方式",- "create_description": "选择服务商并配置其凭据。",- "edit_description": "更新名称、可见性或状态。",- "create_label": "创建支付方式",- "provider_description": "服务商:{{provider}}",- "delete_confirm": {- "title": "删除支付方式?",- "message": "{{name}} 将不再在结账时可用。"+ "rules_card": {+ "add_rule": "添加规则",+ "description": "决定优惠是否适用的条件。",+ "empty": "暂无规则。没有规则时,优惠始终满足条件(受排期和使用次数限制约束)。",+ "title": "规则"},- "title": "支付方式",- "search_placeholder": "按名称搜索…",- "empty": "尚未配置支付方式",- "columns": {- "storefront": "店面"+ "schedule_card": {+ "title": "排期与限制"},- "storefront": {- "visible": "可见",- "admin_only": "仅管理员"+ "table": {+ "empty": "暂无优惠活动",+ "no_end": "无结束日期",+ "search_placeholder": "按名称搜索…"},- "status": {- "disabled": "已禁用"+ "trigger_card": {+ "title": "触发条件"},- "messages": {- "created": "支付方式已创建",- "updated": "支付方式已更新",- "deleted": "支付方式已删除"+ "trigger_summary": {+ "locked_help": "触发设置在创建后无法更改。如需更改,请新建一个促销活动。",+ "multi_code": "多码优惠券({{count}} 个码)",+ "multi_code_with_prefix": "多码优惠券({{count}} 个带前缀 \"{{prefix}}\" 的码)",+ "show_codes": "显示优惠码",+ "single_code": "单个优惠码:"+ },+ "validation": {+ "code_required": "代码为必填项(或点击生成)",+ "expiry_after_start": "到期时间必须晚于开始日期",+ "number_of_codes_required": "请选择要生成的代码数量",+ "prefix_required": "多代码批次需要前缀"}},- "tax_categories": {- "add_cta": "添加税务类别",- "create_description": "按税务处理方式对商品进行分组(标准、减免、免税等)。",- "edit_description": "更新名称、代码或默认标志。",- "create_label": "创建税务类别",- "search_placeholder": "按名称搜索…",- "empty": "暂无税务类别",- "delete_confirm": {- "title": "删除税务类别?",- "message": "将移除 {{name}}。此类别中的商品将回退到默认类别。"+ "settings": {+ "webhooks": {+ "errors": {+ "redeliver_failed": "重新投递失败",+ "send_test_failed": "发送测试 Webhook 失败"+ },+ "messages": {+ "removed": "Webhook 端点已移除",+ "updated": "Webhook 端点已更新"+ }+ }+ },+ "settings_nav": {+ "groups": {+ "audit": "审计",+ "fulfillment": "履约",+ "payments": "支付与税务",+ "store": "店铺",+ "team": "团队与权限"},- "messages": {- "created": "税务类别已创建",- "updated": "税务类别已更新",- "deleted": "税务类别已删除"+ "items": {+ "allowed_origins": "允许的来源",+ "api_keys": "API 密钥",+ "channels": "销售渠道",+ "custom_field_definitions": "自定义字段",+ "delivery_methods": "配送方式",+ "delivery_zones": "配送区域",+ "emails": "邮件",+ "imports": "导入",+ "markets": "市场",+ "payment_methods": "支付方式",+ "profile": "个人资料",+ "staff": "员工",+ "stock_locations": "库存地点",+ "store": "店铺",+ "tax_categories": "税收类别",+ "webhooks": "Webhooks"}},- "custom_field_definitions": {- "add_cta": "添加自定义字段",- "create_label": "创建自定义字段",- "create_description": "定义一个有类型的字段,您的团队可以在任何匹配的记录上填写。",- "edit_description": "更新标签、键或店面可见性。一旦存在值,所有者将无法更改。",- "table_title": "自定义字段定义",- "search_placeholder": "按标签、命名空间或键搜索…",- "empty": "暂无自定义字段定义",- "storefront_visible": {- "visible": "可见",- "admin_only": "仅管理员"+ "staff": {+ "actions": {+ "copy_invitation_link": "复制邀请链接",+ "invitation_link_copied": "邀请链接已复制"},- "delete_confirm": {- "title": "删除自定义字段?",- "message": "{{label}} 及为其存储的所有值都将被移除。"+ "actions_aria": "操作",+ "autocomplete": {+ "empty": "无匹配的员工",+ "placeholder": "搜索员工…"},- "messages": {- "created": "自定义字段定义已创建",- "updated": "自定义字段定义已更新",- "deleted": "自定义字段定义已删除"+ "confirm": {+ "remove_message": "{{name}} 将失去对此店铺的访问权限。",+ "remove_title": "从店铺中移除?",+ "revoke_message": "{{email}} 将无法再接受此邀请。",+ "revoke_title": "撤销邀请?"+ },+ "edit": {+ "roles_label": "此店铺的角色"},+ "edit_description": "更新此员工的个人资料详情和分配的角色。","errors": {- "failed_to_create": "创建自定义字段定义失败",- "failed_to_update": "更新自定义字段定义失败",- "failed_to_delete": "删除自定义字段定义失败"- }- },- "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)——不含路径、查询或片段"+ "failed_to_remove": "移除员工失败",+ "failed_to_resend": "重新发送邀请失败",+ "failed_to_revoke": "撤销邀请失败"},- "delete_confirm": {- "title": "移除允许的来源?",- "message": "{{origin}} 将无法再从浏览器调用管理 API。现有的服务器对服务器请求不受影响。"+ "invite": {+ "email_placeholder": "[email protected]",+ "no_roles": "暂无可用角色。",+ "roles_loading": "正在加载角色…",+ "roles_placeholder": "选择一个角色"},- "messages": {- "added": "已添加允许的来源",- "updated": "已更新允许的来源",- "removed": "已移除允许的来源"+ "validation": {+ "role_required": "请选择一个角色",+ "roles_required": "请至少选择一个角色"}},- "stock_transfers": {- "title": "库存调拨",- "table": {- "search_placeholder": "按编号或参考信息搜索…",- "empty": "暂无库存调拨"- },- "columns": {- "number": "编号",- "direction": "方向",- "reference": "参考信息"- },- "direction": {- "internal": "在库存地点之间调拨",- "external_receive": "外部收货"- },+ "stock_items": {"messages": {- "recorded": "库存调拨已记录",- "deleted": "库存调拨已删除"- },- "errors": {- "failed_to_record": "记录库存调拨失败",- "failed_to_delete": "删除库存调拨失败"+ "stock_item_deleted": "库存项已删除",+ "stock_updated": "库存已更新"}},"stock_locations": {"add_cta": "添加库存地点",- "create_label": "创建库存地点",- "create_description": "添加仓库、门店或自提点,用于履行订单。",- "edit_description": "更新名称、地址、自提或库存策略。",- "search_placeholder": "按名称搜索…",- "empty": "暂无库存地点",+ "badges": {+ "default": "默认",+ "enabled": "已启用",+ "inactive": "未激活"+ },"columns": {- "type": "类型",+ "default": "默认","location": "地点","pickup": "自提",- "default": "默认"+ "type": "类型"},- "badges": {- "enabled": "已启用",- "inactive": "未激活",- "default": "默认"+ "create_description": "添加仓库、门店或自提点,用于履行订单。",+ "create_label": "创建库存地点",+ "delete_confirm": {+ "message": "{{name}} 将被移除。此地点的库存项不会被删除。",+ "title": "删除库存地点?"},+ "edit_description": "更新名称、地址、自提或库存策略。",+ "empty": "暂无库存地点","kinds": {- "warehouse": "仓库",+ "fulfillment_center": "履约中心","store": "门店",- "fulfillment_center": "履约中心"+ "warehouse": "仓库"},"pickup_stock_policies": {- "local": "仅限此地点的商品",- "any": "允许从其他地点调拨"- },- "delete_confirm": {- "title": "删除库存地点?",- "message": "{{name}} 将被移除。此地点的库存项不会被删除。"+ "any": "允许从其他地点调拨",+ "local": "仅限此地点的商品"},+ "search_placeholder": "按名称搜索…","section_pickup": "自提","stock_items": {- "title": "此地点的库存",+ "empty": "此地点暂无库存项。",+ "empty_search": "没有与搜索匹配的库存项。","help": "按变体调整在库数量和可缺货预订数量。",+ "low_stock_marker": "库存不足","search_placeholder": "搜索 SKU 或商品…","table": {- "variant": "变体",+ "backorder": "缺货预订","on_hand": "在库",- "backorder": "缺货预订"+ "variant": "变体"},- "empty": "此地点暂无库存项。",- "empty_search": "没有与搜索匹配的库存项。",+ "title": "此地点的库存","unknown_product": "未知产品","variant_count_one": "{{count}} 个变体",- "variant_count_other": "{{count}} 个变体",- "low_stock_marker": "库存不足"+ "variant_count_other": "{{count}} 个变体"}},+ "stock_transfers": {+ "columns": {+ "direction": "方向",+ "number": "编号",+ "reference": "参考信息"+ },+ "direction": {+ "external_receive": "外部收货",+ "internal": "在库存地点之间调拨"+ },+ "errors": {+ "failed_to_delete": "删除库存调拨失败",+ "failed_to_record": "记录库存调拨失败"+ },+ "messages": {+ "deleted": "库存调拨已删除",+ "recorded": "库存调拨已记录"+ },+ "table": {+ "empty": "暂无库存调拨",+ "search_placeholder": "按编号或参考信息搜索…"+ },+ "title": "库存调拨"+ },"store": {"load_failed_title": "加载店铺设置失败","unit_systems": {- "metric": "公制",- "imperial": "英制"+ "imperial": "英制",+ "metric": "公制"},"weight_units": {- "kg": "千克 (kg)","g": "克 (g)",+ "kg": "千克 (kg)","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": "百分比",- "min_quantity": "最小数量",- "max_quantity": "最大数量"- },- "channels": {- "messages": {- "created": "渠道已创建",- "updated": "渠道已更新",- "deleted": "渠道已删除"- }- },- "order_routing_rules": {- "messages": {- "created": "已添加路由规则",- "deleted": "已移除路由规则"+ "tax_categories": {+ "add_cta": "添加税务类别",+ "create_description": "按税务处理方式对商品进行分组(标准、减免、免税等)。",+ "create_label": "创建税务类别",+ "delete_confirm": {+ "message": "将移除 {{name}}。此类别中的商品将回退到默认类别。",+ "title": "删除税务类别?"},- "types": {- "preferred_location": {- "name": "首选库存地点",- "description": "如订单已指定库存地点,则从该地点发货"- },- "minimize_splits": {- "name": "减少拆单",- "description": "优先选择能独立满足最多商品的地点,避免拆分发货"- },- "default_location": {- "name": "默认库存地点",- "description": "优先选择标记为默认的库存地点"- }- }- },- "customer_groups": {+ "edit_description": "更新名称、代码或默认标志。",+ "empty": "暂无税务类别","messages": {- "created": "客户组已创建",- "create_failed": "创建客户组失败",- "updated": "客户组已更新",- "update_failed": "更新客户组失败",- "deleted": "客户组已删除",- "delete_failed": "删除客户组失败"+ "created": "税务类别已创建",+ "deleted": "税务类别已删除",+ "updated": "税务类别已更新"},- "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": "库存项已删除"- }+ "search_placeholder": "按名称搜索…"},"translations": {- "title": "翻译",- "locale": "语言",- "source": "源",- "save": "保存翻译",- "saved": "翻译已保存",- "save_error": "无法保存翻译",- "no_locales": "向您的商店添加更多语言以翻译此产品。",- "manage": "管理翻译",- "field": "字段","coverage_summary": "已翻译 {{total}} 种语言中的 {{translated}} 种","dirty_summary": "{{count}} 项未保存的更改","discard_confirm": {- "title": "放弃更改?",- "message": "您有 {{count}} 项未保存的翻译更改。要放弃吗?"+ "message": "您有 {{count}} 项未保存的翻译更改。要放弃吗?",+ "title": "放弃更改?"},+ "field": "字段",+ "load_error": "无法加载翻译",+ "locale": "语言",+ "manage": "管理翻译",+ "no_locales": "向您的商店添加更多语言以翻译此产品。","original": "原文",- "load_error": "无法加载翻译"- },- "categories": {- "title": "分类",- "add_cta": "新建分类",- "empty": "暂无分类。",- "expand": "展开",- "collapse": "收起",- "delete_confirm": "删除分类“{{name}}”及其所有子分类?",- "columns": {- "name": "名称",- "products": "商品"- },- "fields": {- "parent": {- "label": "父分类",- "placeholder": "顶级"- }- },- "messages": {- "created": "分类已创建",- "updated": "分类已更新",- "deleted": "分类已删除",- "move_failed": "无法移动分类"- },- "seo": {- "title": "搜索引擎优化",- "preview_slug_placeholder": "category-slug"- },- "products_count_one": "{{count}} 个商品",- "products_count_other": "{{count}} 个商品",- "search_placeholder": "搜索分类…",- "no_results": "没有匹配的分类。",- "new_title": "新建分类",- "delete_label": "删除分类",- "images": {- "title": "图片",- "label": "图片",- "square_label": "方形图片",- "help": "用于分类横幅。推荐 1920×1080。",- "square_help": "用于紧凑导航。推荐 400×400。"- },- "navigation": {- "title": "导航"- },- "products": {- "title": "商品",- "search_placeholder": "搜索商品…",- "empty": "此分类中暂无商品。",- "remove": "从分类中移除",- "add_cta": "添加商品",- "picker_title": "向分类添加商品",- "picker_description": "搜索并选择要添加到此分类的商品。",- "select_all": "全选",- "select_row": "选择商品",- "remove_selected": "移除",- "selected_count_one": "已选择 {{count}} 个",- "selected_count_other": "已选择 {{count}} 个",- "column_product": "商品",- "filter_placeholder": "筛选商品…",- "no_matches": "没有商品匹配筛选条件。"- },- "load_failed": "加载分类失败。请重试。"- },- "imports": {- "download_original": "下载原始文件",- "load_failed": "无法加载导入。",- "try_again": "重试",- "wizard_title": "导入",- "steps": {- "map_fields": "匹配字段",- "process_rows": "处理行",- "complete": "完成"- },- "status": {- "pending": "待处理",- "mapping": "匹配中",- "completed_mapping": "已排队",- "processing": "处理中",- "completed": "已完成",- "failed": "失败"- },- "types": {- "products": "产品",- "customers": "客户",- "product_translations": "产品翻译"- },- "mapping": {- "title": "匹配列",- "description": "将文件中的列与{{type}}字段进行匹配。",- "field": "字段",- "file_column": "文件列",- "sample": "示例",- "not_mapped": "未匹配",- "required": "必填",- "missing_required": "请先匹配必填字段:{{fields}}",- "start": "开始导入",- "starting": "正在开始…"- },- "processing": {- "title": "正在处理行",- "preparing": "正在准备行…",- "progress": "已处理 {{processed}} / {{total}} 行",- "failed_count": "{{failed}} 条失败",- "retrying": "正在重试失败的行 · 剩余 {{remaining}} 条",- "note": "您可以离开此页面——导入将在后台继续进行。"- },- "results": {- "completed_title": "导入完成",- "summary": "已导入 {{completed}} 行 · {{failed}} 条失败",- "retry_failed": "重试失败的行({{failed}})",- "retrying": "正在重试…",- "view_records": "查看{{type}}"- },- "failed": {- "title": "导入失败",- "description": "无法处理该文件。"- },- "failed_rows": {- "next_page": "下一页",- "prev_page": "上一页",- "title": "失败的行",- "row_number": "行号",- "error": "错误",- "view_data": "查看行数据",- "hide_data": "隐藏行数据"- }+ "save": "保存翻译",+ "save_error": "无法保存翻译",+ "saved": "翻译已保存",+ "source": "源",+ "title": "翻译"}}}diff --git a/packages/dashboard/src/nav/settings.ts b/packages/dashboard/src/nav/settings.tsindex 49e96b5f66..745553a7d5 100644--- a/packages/dashboard/src/nav/settings.ts+++ b/packages/dashboard/src/nav/settings.ts@@ -5,10 +5,12 @@ import {GlobeLockIcon,KeyRoundIcon,MailIcon,+ MapIcon,PercentIcon,RadioTowerIcon,StoreIcon,TagIcon,+ TruckIcon,UploadIcon,UsersRoundIcon,WarehouseIcon,@@ -93,6 +95,26 @@ settingsNav.add({subject: Subject.Market,})+settingsNav.add({+ key: 'settings.delivery-methods',+ labelKey: 'admin.settings_nav.items.delivery_methods',+ path: '/delivery-methods',+ icon: TruckIcon,+ group: 'fulfillment',+ position: 80,+ subject: Subject.DeliveryMethod,+})++settingsNav.add({+ key: 'settings.delivery-zones',+ labelKey: 'admin.settings_nav.items.delivery_zones',+ path: '/delivery-zones',+ icon: MapIcon,+ group: 'fulfillment',+ position: 90,+ subject: Subject.DeliveryZone,+})+settingsNav.add({key: 'settings.stock-locations',labelKey: 'admin.settings_nav.items.stock_locations',diff --git a/packages/dashboard/src/routeTree.gen.ts b/packages/dashboard/src/routeTree.gen.tsindex 1e00ebbc22..ed5339c4f8 100644--- a/packages/dashboard/src/routeTree.gen.ts+++ b/packages/dashboard/src/routeTree.gen.ts@@ -33,6 +33,8 @@ import { Route as SettingsProfileRouteImport } from './routes/_authenticated/$stimport { Route as SettingsPaymentMethodsRouteImport } from './routes/_authenticated/$storeId/settings/payment-methods'import { Route as SettingsMarketsRouteImport } from './routes/_authenticated/$storeId/settings/markets'import { Route as SettingsEmailsRouteImport } from './routes/_authenticated/$storeId/settings/emails'+import { Route as SettingsDeliveryZonesRouteImport } from './routes/_authenticated/$storeId/settings/delivery-zones'+import { Route as SettingsDeliveryMethodsRouteImport } from './routes/_authenticated/$storeId/settings/delivery-methods'import { Route as SettingsCustomFieldDefinitionsRouteImport } from './routes/_authenticated/$storeId/settings/custom-field-definitions'import { Route as SettingsChannelsRouteImport } from './routes/_authenticated/$storeId/settings/channels'import { Route as SettingsApiKeysRouteImport } from './routes/_authenticated/$storeId/settings/api-keys'@@ -179,6 +181,16 @@ const SettingsEmailsRoute = SettingsEmailsRouteImport.update({path: '/emails',getParentRoute: () => SettingsRoute,} as any)+const SettingsDeliveryZonesRoute = SettingsDeliveryZonesRouteImport.update({+ id: '/delivery-zones',+ path: '/delivery-zones',+ getParentRoute: () => SettingsRoute,+} as any)+const SettingsDeliveryMethodsRoute = SettingsDeliveryMethodsRouteImport.update({+ id: '/delivery-methods',+ path: '/delivery-methods',+ getParentRoute: () => SettingsRoute,+} as any)const SettingsCustomFieldDefinitionsRoute =SettingsCustomFieldDefinitionsRouteImport.update({id: '/custom-field-definitions',@@ -336,6 +348,8 @@ export interface FileRoutesByFullPath {'/$storeId/settings/api-keys': typeof SettingsApiKeysRoute'/$storeId/settings/channels': typeof SettingsChannelsRoute'/$storeId/settings/custom-field-definitions': typeof SettingsCustomFieldDefinitionsRoute+ '/$storeId/settings/delivery-methods': typeof SettingsDeliveryMethodsRoute+ '/$storeId/settings/delivery-zones': typeof SettingsDeliveryZonesRoute'/$storeId/settings/emails': typeof SettingsEmailsRoute'/$storeId/settings/markets': typeof SettingsMarketsRoute'/$storeId/settings/payment-methods': typeof SettingsPaymentMethodsRoute@@ -384,6 +398,8 @@ export interface FileRoutesByTo {'/$storeId/settings/api-keys': typeof SettingsApiKeysRoute'/$storeId/settings/channels': typeof SettingsChannelsRoute'/$storeId/settings/custom-field-definitions': typeof SettingsCustomFieldDefinitionsRoute+ '/$storeId/settings/delivery-methods': typeof SettingsDeliveryMethodsRoute+ '/$storeId/settings/delivery-zones': typeof SettingsDeliveryZonesRoute'/$storeId/settings/emails': typeof SettingsEmailsRoute'/$storeId/settings/markets': typeof SettingsMarketsRoute'/$storeId/settings/payment-methods': typeof SettingsPaymentMethodsRoute@@ -436,6 +452,8 @@ export interface FileRoutesById {'/_authenticated/$storeId/settings/api-keys': typeof SettingsApiKeysRoute'/_authenticated/$storeId/settings/channels': typeof SettingsChannelsRoute'/_authenticated/$storeId/settings/custom-field-definitions': typeof SettingsCustomFieldDefinitionsRoute+ '/_authenticated/$storeId/settings/delivery-methods': typeof SettingsDeliveryMethodsRoute+ '/_authenticated/$storeId/settings/delivery-zones': typeof SettingsDeliveryZonesRoute'/_authenticated/$storeId/settings/emails': typeof SettingsEmailsRoute'/_authenticated/$storeId/settings/markets': typeof SettingsMarketsRoute'/_authenticated/$storeId/settings/payment-methods': typeof SettingsPaymentMethodsRoute@@ -488,6 +506,8 @@ export interface FileRouteTypes {| '/$storeId/settings/api-keys'| '/$storeId/settings/channels'| '/$storeId/settings/custom-field-definitions'+ | '/$storeId/settings/delivery-methods'+ | '/$storeId/settings/delivery-zones'| '/$storeId/settings/emails'| '/$storeId/settings/markets'| '/$storeId/settings/payment-methods'@@ -536,6 +556,8 @@ export interface FileRouteTypes {| '/$storeId/settings/api-keys'| '/$storeId/settings/channels'| '/$storeId/settings/custom-field-definitions'+ | '/$storeId/settings/delivery-methods'+ | '/$storeId/settings/delivery-zones'| '/$storeId/settings/emails'| '/$storeId/settings/markets'| '/$storeId/settings/payment-methods'@@ -587,6 +609,8 @@ export interface FileRouteTypes {| '/_authenticated/$storeId/settings/api-keys'| '/_authenticated/$storeId/settings/channels'| '/_authenticated/$storeId/settings/custom-field-definitions'+ | '/_authenticated/$storeId/settings/delivery-methods'+ | '/_authenticated/$storeId/settings/delivery-zones'| '/_authenticated/$storeId/settings/emails'| '/_authenticated/$storeId/settings/markets'| '/_authenticated/$storeId/settings/payment-methods'@@ -789,6 +813,20 @@ declare module '@tanstack/react-router' {preLoaderRoute: typeof SettingsEmailsRouteImportparentRoute: typeof SettingsRoute}+ '/_authenticated/$storeId/settings/delivery-zones': {+ id: '/_authenticated/$storeId/settings/delivery-zones'+ path: '/delivery-zones'+ fullPath: '/$storeId/settings/delivery-zones'+ preLoaderRoute: typeof SettingsDeliveryZonesRouteImport+ parentRoute: typeof SettingsRoute+ }+ '/_authenticated/$storeId/settings/delivery-methods': {+ id: '/_authenticated/$storeId/settings/delivery-methods'+ path: '/delivery-methods'+ fullPath: '/$storeId/settings/delivery-methods'+ preLoaderRoute: typeof SettingsDeliveryMethodsRouteImport+ parentRoute: typeof SettingsRoute+ }'/_authenticated/$storeId/settings/custom-field-definitions': {id: '/_authenticated/$storeId/settings/custom-field-definitions'path: '/custom-field-definitions'@@ -972,6 +1010,8 @@ interface SettingsRouteChildren {SettingsApiKeysRoute: typeof SettingsApiKeysRouteSettingsChannelsRoute: typeof SettingsChannelsRouteSettingsCustomFieldDefinitionsRoute: typeof SettingsCustomFieldDefinitionsRoute+ SettingsDeliveryMethodsRoute: typeof SettingsDeliveryMethodsRoute+ SettingsDeliveryZonesRoute: typeof SettingsDeliveryZonesRouteSettingsEmailsRoute: typeof SettingsEmailsRouteSettingsMarketsRoute: typeof SettingsMarketsRouteSettingsPaymentMethodsRoute: typeof SettingsPaymentMethodsRoute@@ -991,6 +1031,8 @@ const SettingsRouteChildren: SettingsRouteChildren = {SettingsApiKeysRoute: SettingsApiKeysRoute,SettingsChannelsRoute: SettingsChannelsRoute,SettingsCustomFieldDefinitionsRoute: SettingsCustomFieldDefinitionsRoute,+ SettingsDeliveryMethodsRoute: SettingsDeliveryMethodsRoute,+ SettingsDeliveryZonesRoute: SettingsDeliveryZonesRoute,SettingsEmailsRoute: SettingsEmailsRoute,SettingsMarketsRoute: SettingsMarketsRoute,SettingsPaymentMethodsRoute: SettingsPaymentMethodsRoute,diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsxindex 4413b9004a..9cf65b50cc 100644--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx@@ -1,4 +1,4 @@-import type { Order, Variant } from '@spree/admin-sdk'+import type { Discount, Fee, Order, Variant } from '@spree/admin-sdk'import {AddressFormDialog,type AddressParams,@@ -87,7 +87,15 @@ import {CustomFieldsInlineCard,EditableApiCustomFieldsProvider,} from '../../../../components/spree/custom-fields/custom-fields-inline'-import { orderQueryKey, useOrder, useOrderMutation } from '../../../../hooks/use-order'+import {+ orderQueryKey,+ useOrder,+ useOrderAdjustmentLinesMutation,+ useOrderDiscounts,+ useOrderFees,+ useOrderMutation,+ useOrderTaxLines,+} from '../../../../hooks/use-order'import { spreeJsonLinkResolver } from '../../../../lib/json-link-resolver'export const Route = createFileRoute('/_authenticated/$storeId/orders/$orderId')({@@ -138,6 +146,7 @@ function OrderDetailPage() {<LineItemsCard order={order} /><ShipmentsCard order={order} /><PaymentsCard order={order} />+ <AdjustmentLinesCard order={order} /><OrderSummaryCard order={order} /><EditableApiCustomFieldsProviderownerType="Spree::Order"@@ -794,7 +803,7 @@ function ShipmentsCard({ order }: { order: Order }) {<CardHeader><CardTitle><TruckIcon className="size-4" />- {t('admin.pages.orders.detail.section_shipments')}+ {t('admin.pages.orders.detail.section_fulfillments')}<Badge variant="outline">{fulfillments.length}</Badge></CardTitle><CardAction className="flex items-center gap-2">@@ -1279,6 +1288,446 @@ function AddPaymentDialog({)}+// ---------------------------------------------------------------------------+// Adjustment lines: taxes, discounts & fees (typed rows)+// ---------------------------------------------------------------------------++function AdjustmentLineRow({+ label,+ meta,+ amount,+ onDelete,+ deleting,+}: {+ label: ReactNode+ meta?: ReactNode+ amount: string+ onDelete?: () => void+ deleting?: boolean+}) {+ return (+ <div className="flex items-center justify-between gap-3 px-5 py-2">+ <div className="flex min-w-0 items-center gap-2">+ <span className="truncate text-sm">{label}</span>+ {meta}+ </div>+ <div className="flex shrink-0 items-center gap-2">+ <span className="text-sm tabular-nums">{amount}</span>+ {onDelete && (+ <Button+ variant="ghost"+ size="icon-sm"+ onClick={onDelete}+ disabled={deleting}+ aria-label={i18n.t('admin.actions.delete')}+ >+ <TrashIcon className="size-3.5" />+ </Button>+ )}+ </div>+ </div>+ )+}++function AdjustmentLinesCard({ order }: { order: Order }) {+ const { t } = useTranslation()+ const { orderId } = Route.useParams()+ const confirm = useConfirm()+ const [addDiscountOpen, setAddDiscountOpen] = useState(false)+ const [addFeeOpen, setAddFeeOpen] = useState(false)++ const { data: taxLines } = useOrderTaxLines(orderId)+ const { data: discounts } = useOrderDiscounts(orderId)+ const { data: fees } = useOrderFees(orderId)++ const deleteDiscountMutation = useOrderAdjustmentLinesMutation(orderId, (id: string) =>+ adminClient.orders.discounts.delete(orderId, id),+ )+ const deleteFeeMutation = useOrderAdjustmentLinesMutation(orderId, (id: string) =>+ adminClient.orders.fees.delete(orderId, id),+ )++ const taxRows = taxLines?.data ?? []+ const discountRows = discounts?.data ?? []+ const feeRows = fees?.data ?? []++ // Tax rows grouped by label so a rate charged on many lines reads as one row.+ const taxGroups = new Map<string, { label: string; amount: number }>()+ for (const row of taxRows) {+ const existing = taxGroups.get(row.label)+ if (existing) {+ existing.amount += Number.parseFloat(row.amount)+ } else {+ taxGroups.set(row.label, { label: row.label, amount: Number.parseFloat(row.amount) })+ }+ }++ async function handleDeleteDiscount(row: Discount) {+ const confirmed = await confirm({+ title: t('admin.orders.detail.adjustment_lines.delete_discount_title'),+ message: t('admin.orders.detail.adjustment_lines.delete_discount_message', {+ label: row.label,+ }),+ confirmLabel: t('admin.actions.delete'),+ variant: 'destructive',+ })+ if (confirmed) deleteDiscountMutation.mutate(row.id)+ }++ async function handleDeleteFee(row: Fee) {+ const confirmed = await confirm({+ title: t('admin.orders.detail.adjustment_lines.delete_fee_title'),+ message: t('admin.orders.detail.adjustment_lines.delete_fee_message', { label: row.label }),+ confirmLabel: t('admin.actions.delete'),+ variant: 'destructive',+ })+ if (confirmed) deleteFeeMutation.mutate(row.id)+ }++ return (+ <Card>+ <CardHeader>+ <CardTitle>{t('admin.orders.detail.adjustment_lines.title')}</CardTitle>+ <CardAction>+ <div className="flex gap-2">+ <Button variant="outline" size="sm" onClick={() => setAddDiscountOpen(true)}>+ <PlusIcon className="size-4" />+ {t('admin.orders.detail.adjustment_lines.add_discount')}+ </Button>+ <Button variant="outline" size="sm" onClick={() => setAddFeeOpen(true)}>+ <PlusIcon className="size-4" />+ {t('admin.orders.detail.adjustment_lines.add_fee')}+ </Button>+ </div>+ </CardAction>+ </CardHeader>++ {taxRows.length === 0 && discountRows.length === 0 && feeRows.length === 0 ? (+ <CardContent>+ <p className="text-sm text-muted-foreground">+ {t('admin.orders.detail.adjustment_lines.empty')}+ </p>+ </CardContent>+ ) : (+ <div className="pb-2">+ {taxGroups.size > 0 && (+ <>+ <p className="px-5 pt-1 pb-1 font-medium text-muted-foreground text-xs uppercase">+ {t('admin.orders.detail.adjustment_lines.taxes')}+ </p>+ {[...taxGroups.values()].map((group) => (+ <AdjustmentLineRow+ key={group.label}+ label={group.label}+ amount={formatPrice({+ amount: group.amount.toFixed(2),+ currency: order.currency,+ display_amount: null,+ })}+ />+ ))}+ </>+ )}++ {discountRows.length > 0 && (+ <>+ <p className="px-5 pt-3 pb-1 font-medium text-muted-foreground text-xs uppercase">+ {t('admin.orders.detail.adjustment_lines.discounts')}+ </p>+ {discountRows.map((row) => (+ <AdjustmentLineRow+ key={row.id}+ label={row.label}+ meta={+ <>+ {row.code && <Badge variant="outline">{row.code}</Badge>}+ {row.kind === 'promotion' && (+ <Badge variant="secondary">+ {t('admin.orders.detail.adjustment_lines.kind_promotion')}+ </Badge>+ )}+ </>+ }+ amount={row.display_amount}+ onDelete={row.kind === 'manual' ? () => handleDeleteDiscount(row) : undefined}+ deleting={deleteDiscountMutation.isPending}+ />+ ))}+ </>+ )}++ {feeRows.length > 0 && (+ <>+ <p className="px-5 pt-3 pb-1 font-medium text-muted-foreground text-xs uppercase">+ {t('admin.orders.detail.adjustment_lines.fees')}+ </p>+ {feeRows.map((row) => (+ <AdjustmentLineRow+ key={row.id}+ label={row.label}+ meta={row.kind ? <Badge variant="outline">{row.kind}</Badge> : undefined}+ amount={row.display_amount}+ onDelete={() => handleDeleteFee(row)}+ deleting={deleteFeeMutation.isPending}+ />+ ))}+ </>+ )}+ </div>+ )}++ <AddDiscountDialog order={order} open={addDiscountOpen} onOpenChange={setAddDiscountOpen} />+ <AddFeeDialog order={order} open={addFeeOpen} onOpenChange={setAddFeeOpen} />+ </Card>+ )+}++function AddDiscountDialog({+ order,+ open,+ onOpenChange,+}: {+ order: Order+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const { orderId } = Route.useParams()+ const [target, setTarget] = useState('order')+ const [valueType, setValueType] = useState('flat')++ const mutation = useOrderAdjustmentLinesMutation(+ orderId,+ (params: {+ label: string+ value: string+ value_type: 'flat' | 'percent'+ line_item_id?: string+ }) => adminClient.orders.discounts.create(orderId, params),+ )++ const targetOptions = [+ { value: 'order', label: t('admin.orders.detail.adjustment_lines.target_order') },+ ...(order.items ?? []).map((item) => ({ value: item.id, label: item.name ?? item.id })),+ ]+ const valueTypeOptions = [+ { value: 'flat', label: t('admin.orders.detail.adjustment_lines.value_type_flat') },+ { value: 'percent', label: t('admin.orders.detail.adjustment_lines.value_type_percent') },+ ]++ function handleSubmit(e: FormEvent<HTMLFormElement>) {+ e.preventDefault()+ const fd = new FormData(e.currentTarget)+ mutation.mutate(+ {+ label: fd.get('label') as string,+ value: fd.get('value') as string,+ value_type: valueType as 'flat' | 'percent',+ ...(target !== 'order' ? { line_item_id: target } : {}),+ },+ { onSuccess: () => onOpenChange(false) },+ )+ }++ return (+ <Dialog open={open} onOpenChange={onOpenChange}>+ <DialogContent>+ <DialogHeader>+ <DialogTitle>{t('admin.orders.detail.adjustment_lines.add_discount')}</DialogTitle>+ <DialogDescription>+ {t('admin.orders.detail.adjustment_lines.add_discount_description')}+ </DialogDescription>+ </DialogHeader>+ <form onSubmit={handleSubmit}>+ <DialogBody>+ <FieldGroup>+ <Field>+ <FieldLabel htmlFor="discount-label">+ {t('admin.orders.detail.adjustment_lines.label_field')}+ </FieldLabel>+ <Input id="discount-label" name="label" required />+ </Field>+ <div className="grid grid-cols-2 gap-3">+ <Field>+ <FieldLabel htmlFor="discount-value">+ {t('admin.orders.detail.adjustment_lines.value_field')}+ </FieldLabel>+ <Input+ id="discount-value"+ name="value"+ type="number"+ step="0.01"+ min="0.01"+ required+ />+ </Field>+ <Field>+ <FieldLabel>+ {t('admin.orders.detail.adjustment_lines.value_type_field')}+ </FieldLabel>+ <Select+ items={valueTypeOptions}+ value={valueType}+ onValueChange={(v) => setValueType(v as string)}+ >+ <SelectTrigger>+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {valueTypeOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ </Field>+ </div>+ <Field>+ <FieldLabel>{t('admin.orders.detail.adjustment_lines.target_field')}</FieldLabel>+ <Select+ items={targetOptions}+ value={target}+ onValueChange={(v) => setTarget(v as string)}+ >+ <SelectTrigger>+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {targetOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ </Field>+ </FieldGroup>+ </DialogBody>+ <DialogFooter>+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>+ {t('admin.actions.cancel')}+ </Button>+ <Button type="submit" disabled={mutation.isPending}>+ {mutation.isPending+ ? t('admin.actions.saving')+ : t('admin.orders.detail.adjustment_lines.add_discount')}+ </Button>+ </DialogFooter>+ </form>+ </DialogContent>+ </Dialog>+ )+}++function AddFeeDialog({+ order,+ open,+ onOpenChange,+}: {+ order: Order+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const { orderId } = Route.useParams()+ const [target, setTarget] = useState('order')++ const mutation = useOrderAdjustmentLinesMutation(+ orderId,+ (params: { label: string; amount: string; kind?: string; line_item_id?: string }) =>+ adminClient.orders.fees.create(orderId, params),+ )++ const targetOptions = [+ { value: 'order', label: t('admin.orders.detail.adjustment_lines.target_order') },+ ...(order.items ?? []).map((item) => ({ value: item.id, label: item.name ?? item.id })),+ ]++ function handleSubmit(e: FormEvent<HTMLFormElement>) {+ e.preventDefault()+ const fd = new FormData(e.currentTarget)+ const kind = (fd.get('kind') as string).trim()+ mutation.mutate(+ {+ label: fd.get('label') as string,+ amount: fd.get('amount') as string,+ ...(kind ? { kind } : {}),+ ...(target !== 'order' ? { line_item_id: target } : {}),+ },+ { onSuccess: () => onOpenChange(false) },+ )+ }++ return (+ <Dialog open={open} onOpenChange={onOpenChange}>+ <DialogContent>+ <DialogHeader>+ <DialogTitle>{t('admin.orders.detail.adjustment_lines.add_fee')}</DialogTitle>+ <DialogDescription>+ {t('admin.orders.detail.adjustment_lines.add_fee_description')}+ </DialogDescription>+ </DialogHeader>+ <form onSubmit={handleSubmit}>+ <DialogBody>+ <FieldGroup>+ <Field>+ <FieldLabel htmlFor="fee-label">+ {t('admin.orders.detail.adjustment_lines.label_field')}+ </FieldLabel>+ <Input id="fee-label" name="label" required />+ </Field>+ <div className="grid grid-cols-2 gap-3">+ <Field>+ <FieldLabel htmlFor="fee-amount">+ {t('admin.orders.detail.adjustment_lines.amount_field')}+ </FieldLabel>+ <Input id="fee-amount" name="amount" type="number" step="0.01" min="0" required />+ </Field>+ <Field>+ <FieldLabel htmlFor="fee-kind">+ {t('admin.orders.detail.adjustment_lines.kind_field')}+ </FieldLabel>+ <Input id="fee-kind" name="kind" placeholder="surcharge" />+ </Field>+ </div>+ <Field>+ <FieldLabel>{t('admin.orders.detail.adjustment_lines.target_field')}</FieldLabel>+ <Select+ items={targetOptions}+ value={target}+ onValueChange={(v) => setTarget(v as string)}+ >+ <SelectTrigger>+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {targetOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ </Field>+ </FieldGroup>+ </DialogBody>+ <DialogFooter>+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>+ {t('admin.actions.cancel')}+ </Button>+ <Button type="submit" disabled={mutation.isPending}>+ {mutation.isPending+ ? t('admin.actions.saving')+ : t('admin.orders.detail.adjustment_lines.add_fee')}+ </Button>+ </DialogFooter>+ </form>+ </DialogContent>+ </Dialog>+ )+}+// ---------------------------------------------------------------------------// Order Summary// ---------------------------------------------------------------------------diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/delivery-methods.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/delivery-methods.tsxnew file mode 100644index 0000000000..2f84151928--- /dev/null+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/delivery-methods.tsx@@ -0,0 +1,576 @@+import { zodResolver } from '@hookform/resolvers/zod'+import type { DeliveryMethod } from '@spree/admin-sdk'+import {+ adminClient,+ Can,+ mapSpreeErrorsToForm,+ ResourceTable,+ resourceSearchSchema,+ Subject,+ usePermissions,+} from '@spree/dashboard-core'+import {+ Button,+ Checkbox,+ Field,+ FieldError,+ FieldGroup,+ FieldLabel,+ Input,+ RowActions,+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+ Sheet,+ SheetContent,+ SheetDescription,+ SheetFooter,+ SheetHeader,+ SheetTitle,+ Switch,+ useConfirm,+ useRowClickBridge,+} from '@spree/dashboard-ui'+import { createFileRoute, useNavigate } from '@tanstack/react-router'+import { PlusIcon } from 'lucide-react'+import { useEffect } from 'react'+import { Controller, type UseFormReturn, useForm } from 'react-hook-form'+import { useTranslation } from 'react-i18next'+import { z } from 'zod/v4'+import {+ useCreateDeliveryMethod,+ useDeleteDeliveryMethod,+ useDeliveryCalculators,+ useDeliveryMethod,+ useUpdateDeliveryMethod,+} from '../../../../hooks/use-delivery-methods'+import { useDeliveryZones } from '../../../../hooks/use-delivery-zones'+import { useTaxCategories } from '../../../../hooks/use-tax-categories'+import {+ DELIVERY_METHOD_DEFAULTS,+ type DeliveryMethodFormValues,+ deliveryMethodFormSchema,+ deliveryMethodValuesToParams,+ FULFILLMENT_TYPES,+} from '../../../../schemas/delivery-method'+import '../../../../tables/delivery-methods'++const deliveryMethodsSearchSchema = resourceSearchSchema.extend({+ edit: z.string().optional(),+ new: z.coerce.boolean().optional(),+})++export const Route = createFileRoute('/_authenticated/$storeId/settings/delivery-methods')({+ validateSearch: deliveryMethodsSearchSchema,+ component: DeliveryMethodsPage,+})++function DeliveryMethodsPage() {+ const { t } = useTranslation()+ const search = Route.useSearch() as z.infer<typeof deliveryMethodsSearchSchema>+ const navigate = useNavigate()+ const confirm = useConfirm()+ const deleteMutation = useDeleteDeliveryMethod()+ const { permissions } = usePermissions()++ const editId = search.edit+ const isCreating = !!search.new++ const closeSheet = () =>+ navigate({+ search: (prev: Record<string, unknown>) => {+ const { edit: _e, new: _n, ...rest } = prev+ return rest as never+ },+ })++ const openCreate = () =>+ navigate({ search: (prev: Record<string, unknown>) => ({ ...prev, new: true }) as never })++ const openEdit = (id: string) =>+ navigate({ search: (prev: Record<string, unknown>) => ({ ...prev, edit: id }) as never })++ useRowClickBridge('data-delivery-method-id', openEdit)++ async function handleDelete(deliveryMethod: DeliveryMethod) {+ const ok = await confirm({+ title: t('admin.delivery_methods.delete_confirm.title'),+ message: t('admin.delivery_methods.delete_confirm.message', {+ name: deliveryMethod.name ?? '',+ }),+ variant: 'destructive',+ confirmLabel: t('admin.actions.delete'),+ })+ if (!ok) return+ await deleteMutation.mutateAsync(deliveryMethod.id).catch(() => undefined)+ }++ return (+ <>+ <ResourceTable<DeliveryMethod>+ tableKey="delivery-methods"+ queryKey="delivery-methods"+ queryFn={(params) => adminClient.deliveryMethods.list(params)}+ searchParams={search}+ rowActions={(deliveryMethod) => (+ <RowActions+ actions={[+ { key: 'edit', onSelect: () => openEdit(deliveryMethod.id) },+ {+ key: 'delete',+ destructive: true,+ visible: permissions.can('destroy', Subject.DeliveryMethod),+ disabled: deleteMutation.isPending,+ onSelect: () => handleDelete(deliveryMethod),+ },+ ]}+ />+ )}+ actions={+ <Can I="create" a={Subject.DeliveryMethod}>+ <Button size="sm" className="h-[2.125rem]" onClick={openCreate}>+ <PlusIcon className="size-4" />+ {t('admin.delivery_methods.add_cta')}+ </Button>+ </Can>+ }+ />++ {isCreating && <CreateDeliveryMethodSheet open onOpenChange={(o) => !o && closeSheet()} />}+ {editId && (+ <EditDeliveryMethodSheet id={editId} open onOpenChange={(o) => !o && closeSheet()} />+ )}+ </>+ )+}++function CreateDeliveryMethodSheet({+ open,+ onOpenChange,+}: {+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const createMutation = useCreateDeliveryMethod()+ const form = useForm<DeliveryMethodFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(deliveryMethodFormSchema) as any,+ defaultValues: DELIVERY_METHOD_DEFAULTS,+ })++ async function onSubmit(values: DeliveryMethodFormValues) {+ try {+ await createMutation.mutateAsync(deliveryMethodValuesToParams(values))+ form.reset(DELIVERY_METHOD_DEFAULTS)+ onOpenChange(false)+ } catch (err) {+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err+ }+ }++ return (+ <Sheet+ open={open}+ onOpenChange={(next) => {+ if (!next) form.reset(DELIVERY_METHOD_DEFAULTS)+ onOpenChange(next)+ }}+ >+ <SheetContent>+ <SheetHeader>+ <SheetTitle>{t('admin.delivery_methods.add_sheet_title')}</SheetTitle>+ <SheetDescription>{t('admin.delivery_methods.create_description')}</SheetDescription>+ </SheetHeader>+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">+ <DeliveryMethodFormFields form={form} />+ </div>+ <SheetFooter>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => onOpenChange(false)}+ disabled={form.formState.isSubmitting}+ >+ {t('admin.actions.cancel')}+ </Button>+ <Button type="submit" size="sm" disabled={form.formState.isSubmitting}>+ {form.formState.isSubmitting+ ? t('admin.actions.creating')+ : t('admin.delivery_methods.create_label')}+ </Button>+ </SheetFooter>+ </form>+ </SheetContent>+ </Sheet>+ )+}++function EditDeliveryMethodSheet({+ id,+ open,+ onOpenChange,+}: {+ id: string+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const { data: deliveryMethod, isLoading } = useDeliveryMethod(id)+ const updateMutation = useUpdateDeliveryMethod(id)++ const form = useForm<DeliveryMethodFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(deliveryMethodFormSchema) as any,+ defaultValues: DELIVERY_METHOD_DEFAULTS,+ })++ useEffect(() => {+ if (deliveryMethod) {+ form.reset({+ name: deliveryMethod.name,+ admin_name: deliveryMethod.admin_name ?? '',+ code: deliveryMethod.code ?? '',+ fulfillment_type:+ (deliveryMethod.fulfillment_type as DeliveryMethodFormValues['fulfillment_type']) ??+ 'shipping',+ storefront_visible: deliveryMethod.storefront_visible,+ tracking_url: deliveryMethod.tracking_url ?? '',+ estimated_transit_business_days_min:+ deliveryMethod.estimated_transit_business_days_min?.toString() ?? '',+ estimated_transit_business_days_max:+ deliveryMethod.estimated_transit_business_days_max?.toString() ?? '',+ tax_category_id: deliveryMethod.tax_category_id ?? '',+ calculator_type: deliveryMethod.calculator_type ?? '',+ calculator_preferences:+ (deliveryMethod.calculator_preferences as Record<string, unknown>) ?? {},+ delivery_zone_ids: deliveryMethod.delivery_zone_ids ?? [],+ })+ }+ }, [deliveryMethod, form])++ async function onSubmit(values: DeliveryMethodFormValues) {+ try {+ await updateMutation.mutateAsync(deliveryMethodValuesToParams(values))+ form.reset(values)+ onOpenChange(false)+ } catch (err) {+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err+ }+ }++ return (+ <Sheet open={open} onOpenChange={onOpenChange}>+ <SheetContent>+ <SheetHeader>+ <SheetTitle>+ {deliveryMethod?.name ?? t('admin.delivery_methods.edit_sheet_title')}+ </SheetTitle>+ <SheetDescription>{t('admin.delivery_methods.edit_description')}</SheetDescription>+ </SheetHeader>+ {isLoading ? (+ <div className="p-4 text-sm text-muted-foreground">{t('admin.common.loading')}</div>+ ) : (+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">+ <DeliveryMethodFormFields form={form} />+ </div>+ <SheetFooter>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => onOpenChange(false)}+ disabled={form.formState.isSubmitting}+ >+ {t('admin.actions.cancel')}+ </Button>+ <Button+ type="submit"+ size="sm"+ disabled={form.formState.isSubmitting || !form.formState.isDirty}+ >+ {form.formState.isSubmitting ? t('admin.actions.saving') : t('admin.actions.save')}+ </Button>+ </SheetFooter>+ </form>+ )}+ </SheetContent>+ </Sheet>+ )+}++function DeliveryMethodFormFields({ form }: { form: UseFormReturn<DeliveryMethodFormValues> }) {+ const { t } = useTranslation()+ const { errors } = form.formState+ const { data: calculators } = useDeliveryCalculators()+ const { data: zones } = useDeliveryZones()+ const { data: taxCategories } = useTaxCategories()++ const fulfillmentType = form.watch('fulfillment_type')+ const calculatorType = form.watch('calculator_type')++ const fulfillmentTypeOptions = FULFILLMENT_TYPES.map((value) => ({+ value,+ label: t(`admin.delivery_methods.fulfillment_types.${value}`),+ }))++ const calculatorOptions = (calculators?.data ?? []).map((calculator) => ({+ value: calculator.type,+ label: calculator.name,+ }))++ const selectedCalculator = (calculators?.data ?? []).find((c) => c.type === calculatorType)+ const preferenceSchema = (selectedCalculator?.preference_schema ?? []) as Array<{+ key: string+ type: string+ default: unknown+ }>++ const taxCategoryOptions = [+ { value: '', label: t('admin.common.none') },+ ...(taxCategories?.data ?? []).map((tc) => ({ value: tc.id, label: tc.name })),+ ]++ return (+ <FieldGroup>+ {errors.root?.message && (+ <p className="text-sm text-destructive" role="alert">+ {errors.root.message}+ </p>+ )}+ <Field>+ <FieldLabel htmlFor="name">{t('admin.fields.name.label')}</FieldLabel>+ <Input+ id="name"+ autoFocus+ aria-invalid={!!errors.name || undefined}+ {...form.register('name')}+ />+ <FieldError errors={[errors.name]} />+ </Field>++ <div className="grid grid-cols-2 gap-3">+ <Field>+ <FieldLabel htmlFor="admin_name">+ {t('admin.fields.delivery_method.admin_name.label')}+ </FieldLabel>+ <Input id="admin_name" {...form.register('admin_name')} />+ </Field>+ <Field>+ <FieldLabel htmlFor="code">{t('admin.fields.delivery_method.code.label')}</FieldLabel>+ <Input id="code" {...form.register('code')} />+ </Field>+ </div>++ <Field>+ <FieldLabel>{t('admin.fields.delivery_method.fulfillment_type.label')}</FieldLabel>+ <Controller+ name="fulfillment_type"+ control={form.control}+ render={({ field }) => (+ <Select+ items={fulfillmentTypeOptions}+ value={field.value}+ onValueChange={field.onChange}+ >+ <SelectTrigger>+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {fulfillmentTypeOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ )}+ />+ </Field>++ {(fulfillmentType === 'shipping' || fulfillmentType === 'pickup_point') && (+ <>+ <Field>+ <FieldLabel>{t('admin.fields.delivery_method.calculator.label')}</FieldLabel>+ <Controller+ name="calculator_type"+ control={form.control}+ render={({ field }) => (+ <Select+ items={calculatorOptions}+ value={field.value ?? ''}+ onValueChange={field.onChange}+ >+ <SelectTrigger>+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {calculatorOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ )}+ />+ </Field>++ {preferenceSchema+ .filter((preference) => preference.type !== 'boolean')+ .map((preference) => (+ <Field key={preference.key}>+ <FieldLabel htmlFor={`calculator-${preference.key}`}>+ {t(`admin.fields.calculator.${preference.key}.label`, {+ defaultValue: preference.key,+ })}+ </FieldLabel>+ <Controller+ name={`calculator_preferences.${preference.key}`}+ control={form.control}+ render={({ field }) => (+ <Input+ id={`calculator-${preference.key}`}+ value={(field.value as string | number | undefined)?.toString() ?? ''}+ onChange={(e) => field.onChange(e.target.value)}+ />+ )}+ />+ </Field>+ ))}++ <Field>+ <FieldLabel>{t('admin.fields.delivery_method.delivery_zones.label')}</FieldLabel>+ <Controller+ name="delivery_zone_ids"+ control={form.control}+ render={({ field }) => (+ <div className="flex flex-col gap-2">+ {(zones?.data ?? []).length === 0 && (+ <span className="text-xs text-muted-foreground">+ {t('admin.delivery_methods.no_zones_hint')}+ </span>+ )}+ {(zones?.data ?? []).map((zone) => {+ const checked = field.value.includes(zone.id)+ return (+ <label+ key={zone.id}+ htmlFor={`delivery-zone-${zone.id}`}+ className="flex items-center gap-2 text-sm"+ >+ <Checkbox+ id={`delivery-zone-${zone.id}`}+ checked={checked}+ onCheckedChange={(next) => {+ field.onChange(+ next+ ? [...field.value, zone.id]+ : field.value.filter((zoneId: string) => zoneId !== zone.id),+ )+ }}+ />+ {zone.name}+ </label>+ )+ })}+ </div>+ )}+ />+ </Field>+ </>+ )}++ <div className="grid grid-cols-2 gap-3">+ <Field>+ <FieldLabel htmlFor="estimated_transit_business_days_min">+ {t('admin.fields.delivery_method.transit_days_min.label')}+ </FieldLabel>+ <Input+ id="estimated_transit_business_days_min"+ type="number"+ min="1"+ {...form.register('estimated_transit_business_days_min')}+ />+ </Field>+ <Field>+ <FieldLabel htmlFor="estimated_transit_business_days_max">+ {t('admin.fields.delivery_method.transit_days_max.label')}+ </FieldLabel>+ <Input+ id="estimated_transit_business_days_max"+ type="number"+ min="1"+ {...form.register('estimated_transit_business_days_max')}+ />+ </Field>+ </div>++ <Field>+ <FieldLabel>{t('admin.fields.delivery_method.tax_category.label')}</FieldLabel>+ <Controller+ name="tax_category_id"+ control={form.control}+ render={({ field }) => (+ <Select+ items={taxCategoryOptions}+ value={field.value ?? ''}+ onValueChange={field.onChange}+ >+ <SelectTrigger>+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {taxCategoryOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ )}+ />+ </Field>++ <Field>+ <FieldLabel htmlFor="tracking_url">+ {t('admin.fields.delivery_method.tracking_url.label')}+ </FieldLabel>+ <Input+ id="tracking_url"+ placeholder="https://carrier.example/track?num=:tracking"+ {...form.register('tracking_url')}+ />+ </Field>++ <Field>+ <div className="flex items-start justify-between gap-4">+ <div className="flex flex-col">+ <FieldLabel htmlFor="storefront_visible" className="cursor-pointer">+ {t('admin.fields.storefront_visible.label')}+ </FieldLabel>+ <span className="text-xs text-muted-foreground">+ {t('admin.fields.delivery_method.storefront_visible.help')}+ </span>+ </div>+ <Controller+ name="storefront_visible"+ control={form.control}+ render={({ field }) => (+ <Switch+ id="storefront_visible"+ checked={!!field.value}+ onCheckedChange={field.onChange}+ />+ )}+ />+ </div>+ </Field>+ </FieldGroup>+ )+}diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/delivery-zones.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/delivery-zones.tsxnew file mode 100644index 0000000000..6f73084b56--- /dev/null+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/delivery-zones.tsx@@ -0,0 +1,449 @@+import { zodResolver } from '@hookform/resolvers/zod'+import type { DeliveryZone } from '@spree/admin-sdk'+import {+ adminClient,+ Can,+ mapSpreeErrorsToForm,+ ResourceTable,+ resourceSearchSchema,+ Subject,+ usePermissions,+} from '@spree/dashboard-core'+import {+ Button,+ Field,+ FieldError,+ FieldGroup,+ FieldLabel,+ Input,+ RowActions,+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+ Sheet,+ SheetContent,+ SheetDescription,+ SheetFooter,+ SheetHeader,+ SheetTitle,+ Textarea,+ useConfirm,+ useRowClickBridge,+} from '@spree/dashboard-ui'+import { useQuery } from '@tanstack/react-query'+import { createFileRoute, useNavigate } from '@tanstack/react-router'+import { PlusIcon, Trash2Icon } from 'lucide-react'+import { useEffect } from 'react'+import { Controller, type UseFormReturn, useFieldArray, useForm } from 'react-hook-form'+import { useTranslation } from 'react-i18next'+import { z } from 'zod/v4'+import {+ useCreateDeliveryZone,+ useDeleteDeliveryZone,+ useDeliveryZone,+ useUpdateDeliveryZone,+} from '../../../../hooks/use-delivery-zones'+import {+ DELIVERY_ZONE_DEFAULTS,+ type DeliveryZoneFormValues,+ deliveryZoneFormSchema,+ deliveryZoneValuesToParams,+ MEMBER_TYPES,+} from '../../../../schemas/delivery-zone'+import '../../../../tables/delivery-zones'++const deliveryZonesSearchSchema = resourceSearchSchema.extend({+ edit: z.string().optional(),+ new: z.coerce.boolean().optional(),+})++export const Route = createFileRoute('/_authenticated/$storeId/settings/delivery-zones')({+ validateSearch: deliveryZonesSearchSchema,+ component: DeliveryZonesPage,+})++function DeliveryZonesPage() {+ const { t } = useTranslation()+ const search = Route.useSearch() as z.infer<typeof deliveryZonesSearchSchema>+ const navigate = useNavigate()+ const confirm = useConfirm()+ const deleteMutation = useDeleteDeliveryZone()+ const { permissions } = usePermissions()++ const editId = search.edit+ const isCreating = !!search.new++ const closeSheet = () =>+ navigate({+ search: (prev: Record<string, unknown>) => {+ const { edit: _e, new: _n, ...rest } = prev+ return rest as never+ },+ })++ const openCreate = () =>+ navigate({ search: (prev: Record<string, unknown>) => ({ ...prev, new: true }) as never })++ const openEdit = (id: string) =>+ navigate({ search: (prev: Record<string, unknown>) => ({ ...prev, edit: id }) as never })++ useRowClickBridge('data-delivery-zone-id', openEdit)++ async function handleDelete(zone: DeliveryZone) {+ const ok = await confirm({+ title: t('admin.delivery_zones.delete_confirm.title'),+ message: t('admin.delivery_zones.delete_confirm.message', { name: zone.name ?? '' }),+ variant: 'destructive',+ confirmLabel: t('admin.actions.delete'),+ })+ if (!ok) return+ await deleteMutation.mutateAsync(zone.id).catch(() => undefined)+ }++ return (+ <>+ <ResourceTable<DeliveryZone>+ tableKey="delivery-zones"+ queryKey="delivery-zones"+ queryFn={(params) => adminClient.deliveryZones.list(params)}+ searchParams={search}+ rowActions={(zone) => (+ <RowActions+ actions={[+ { key: 'edit', onSelect: () => openEdit(zone.id) },+ {+ key: 'delete',+ destructive: true,+ visible: permissions.can('destroy', Subject.DeliveryZone),+ disabled: deleteMutation.isPending,+ onSelect: () => handleDelete(zone),+ },+ ]}+ />+ )}+ actions={+ <Can I="create" a={Subject.DeliveryZone}>+ <Button size="sm" className="h-[2.125rem]" onClick={openCreate}>+ <PlusIcon className="size-4" />+ {t('admin.delivery_zones.add_cta')}+ </Button>+ </Can>+ }+ />++ {isCreating && <CreateDeliveryZoneSheet open onOpenChange={(o) => !o && closeSheet()} />}+ {editId && (+ <EditDeliveryZoneSheet id={editId} open onOpenChange={(o) => !o && closeSheet()} />+ )}+ </>+ )+}++function CreateDeliveryZoneSheet({+ open,+ onOpenChange,+}: {+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const createMutation = useCreateDeliveryZone()+ const form = useForm<DeliveryZoneFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(deliveryZoneFormSchema) as any,+ defaultValues: DELIVERY_ZONE_DEFAULTS,+ })++ async function onSubmit(values: DeliveryZoneFormValues) {+ try {+ await createMutation.mutateAsync(deliveryZoneValuesToParams(values))+ form.reset(DELIVERY_ZONE_DEFAULTS)+ onOpenChange(false)+ } catch (err) {+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err+ }+ }++ return (+ <Sheet+ open={open}+ onOpenChange={(next) => {+ if (!next) form.reset(DELIVERY_ZONE_DEFAULTS)+ onOpenChange(next)+ }}+ >+ <SheetContent>+ <SheetHeader>+ <SheetTitle>{t('admin.delivery_zones.add_sheet_title')}</SheetTitle>+ <SheetDescription>{t('admin.delivery_zones.create_description')}</SheetDescription>+ </SheetHeader>+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">+ <DeliveryZoneFormFields form={form} />+ </div>+ <SheetFooter>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => onOpenChange(false)}+ disabled={form.formState.isSubmitting}+ >+ {t('admin.actions.cancel')}+ </Button>+ <Button type="submit" size="sm" disabled={form.formState.isSubmitting}>+ {form.formState.isSubmitting+ ? t('admin.actions.creating')+ : t('admin.delivery_zones.create_label')}+ </Button>+ </SheetFooter>+ </form>+ </SheetContent>+ </Sheet>+ )+}++function EditDeliveryZoneSheet({+ id,+ open,+ onOpenChange,+}: {+ id: string+ open: boolean+ onOpenChange: (open: boolean) => void+}) {+ const { t } = useTranslation()+ const { data: zone, isLoading } = useDeliveryZone(id)+ const updateMutation = useUpdateDeliveryZone(id)++ const form = useForm<DeliveryZoneFormValues>({+ // eslint-disable-next-line @typescript-eslint/no-explicit-any+ resolver: zodResolver(deliveryZoneFormSchema) as any,+ defaultValues: DELIVERY_ZONE_DEFAULTS,+ })++ useEffect(() => {+ if (zone) {+ form.reset({+ name: zone.name,+ description: zone.description ?? '',+ members: zone.members.map((member) => ({+ member_type:+ member.member_type as DeliveryZoneFormValues['members'][number]['member_type'],+ country_iso: member.country_iso ?? '',+ state_abbr: member.state_abbr ?? '',+ postal_code_prefix: member.postal_code_prefix ?? '',+ postal_code_from: member.postal_code_from ?? '',+ postal_code_to: member.postal_code_to ?? '',+ })),+ })+ }+ }, [zone, form])++ async function onSubmit(values: DeliveryZoneFormValues) {+ try {+ await updateMutation.mutateAsync(deliveryZoneValuesToParams(values))+ form.reset(values)+ onOpenChange(false)+ } catch (err) {+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err+ }+ }++ return (+ <Sheet open={open} onOpenChange={onOpenChange}>+ <SheetContent>+ <SheetHeader>+ <SheetTitle>{zone?.name ?? t('admin.delivery_zones.edit_sheet_title')}</SheetTitle>+ <SheetDescription>{t('admin.delivery_zones.edit_description')}</SheetDescription>+ </SheetHeader>+ {isLoading ? (+ <div className="p-4 text-sm text-muted-foreground">{t('admin.common.loading')}</div>+ ) : (+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">+ <DeliveryZoneFormFields form={form} />+ </div>+ <SheetFooter>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => onOpenChange(false)}+ disabled={form.formState.isSubmitting}+ >+ {t('admin.actions.cancel')}+ </Button>+ <Button+ type="submit"+ size="sm"+ disabled={form.formState.isSubmitting || !form.formState.isDirty}+ >+ {form.formState.isSubmitting ? t('admin.actions.saving') : t('admin.actions.save')}+ </Button>+ </SheetFooter>+ </form>+ )}+ </SheetContent>+ </Sheet>+ )+}++function DeliveryZoneFormFields({ form }: { form: UseFormReturn<DeliveryZoneFormValues> }) {+ const { t } = useTranslation()+ const { errors } = form.formState+ const membersArray = useFieldArray({ control: form.control, name: 'members' })++ const { data: countries } = useQuery({+ queryKey: ['countries'],+ queryFn: () => adminClient.countries.list({ limit: 300 }),+ staleTime: 1000 * 60 * 60,+ })++ const countryOptions = (countries?.data ?? []).map((country) => ({+ value: country.iso,+ label: country.name,+ }))++ const memberTypeOptions = MEMBER_TYPES.map((value) => ({+ value,+ label: t(`admin.delivery_zones.member_types.${value}`),+ }))++ return (+ <FieldGroup>+ {errors.root?.message && (+ <p className="text-sm text-destructive" role="alert">+ {errors.root.message}+ </p>+ )}+ <Field>+ <FieldLabel htmlFor="name">{t('admin.fields.name.label')}</FieldLabel>+ <Input+ id="name"+ autoFocus+ aria-invalid={!!errors.name || undefined}+ {...form.register('name')}+ />+ <FieldError errors={[errors.name]} />+ </Field>++ <Field>+ <FieldLabel htmlFor="description">{t('admin.fields.description.label')}</FieldLabel>+ <Textarea id="description" rows={2} {...form.register('description')} />+ </Field>++ <div className="flex items-center justify-between">+ <FieldLabel>{t('admin.delivery_zones.members_column')}</FieldLabel>+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => membersArray.append({ member_type: 'country', country_iso: '' })}+ >+ <PlusIcon className="size-4" />+ {t('admin.delivery_zones.add_member')}+ </Button>+ </div>++ {membersArray.fields.length === 0 && (+ <p className="text-sm text-muted-foreground">{t('admin.delivery_zones.no_members_hint')}</p>+ )}++ {membersArray.fields.map((member, index) => {+ const memberType = form.watch(`members.${index}.member_type`)+ return (+ <div key={member.id} className="flex flex-col gap-2 rounded-md border p-3">+ <div className="flex items-center gap-2">+ <Controller+ name={`members.${index}.member_type`}+ control={form.control}+ render={({ field }) => (+ <Select+ items={memberTypeOptions}+ value={field.value}+ onValueChange={field.onChange}+ >+ <SelectTrigger className="flex-1">+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {memberTypeOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ )}+ />+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ onClick={() => membersArray.remove(index)}+ aria-label={t('admin.actions.delete')}+ >+ <Trash2Icon className="size-4" />+ </Button>+ </div>++ <Controller+ name={`members.${index}.country_iso`}+ control={form.control}+ render={({ field }) => (+ <Select+ items={countryOptions}+ value={field.value ?? ''}+ onValueChange={field.onChange}+ >+ <SelectTrigger>+ <SelectValue>+ {(value) =>+ countryOptions.find((option) => option.value === value)?.label ??+ t('admin.delivery_zones.select_country')+ }+ </SelectValue>+ </SelectTrigger>+ <SelectContent>+ {countryOptions.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ )}+ />++ {memberType === 'state' && (+ <Input+ placeholder={t('admin.delivery_zones.state_placeholder')}+ {...form.register(`members.${index}.state_abbr`)}+ />+ )}++ {memberType === 'postal_code' && (+ <div className="grid grid-cols-3 gap-2">+ <Input+ placeholder={t('admin.delivery_zones.prefix_placeholder')}+ {...form.register(`members.${index}.postal_code_prefix`)}+ />+ <Input+ placeholder={t('admin.delivery_zones.from_placeholder')}+ {...form.register(`members.${index}.postal_code_from`)}+ />+ <Input+ placeholder={t('admin.delivery_zones.to_placeholder')}+ {...form.register(`members.${index}.postal_code_to`)}+ />+ </div>+ )}+ </div>+ )+ })}+ </FieldGroup>+ )+}diff --git a/packages/dashboard/src/schemas/delivery-method.ts b/packages/dashboard/src/schemas/delivery-method.tsnew file mode 100644index 0000000000..4d6bc1537b--- /dev/null+++ b/packages/dashboard/src/schemas/delivery-method.ts@@ -0,0 +1,58 @@+import { z } from 'zod/v4'++export const FULFILLMENT_TYPES = ['shipping', 'digital', 'pickup', 'pickup_point'] as const++export const deliveryMethodFormSchema = z.object({+ name: z.string().min(1),+ admin_name: z.string().optional(),+ code: z.string().optional(),+ fulfillment_type: z.enum(FULFILLMENT_TYPES),+ storefront_visible: z.boolean(),+ tracking_url: z.string().optional(),+ estimated_transit_business_days_min: z.string().optional(),+ estimated_transit_business_days_max: z.string().optional(),+ tax_category_id: z.string().optional(),+ calculator_type: z.string().optional(),+ calculator_preferences: z.record(z.string(), z.unknown()).optional(),+ delivery_zone_ids: z.array(z.string()),+})++export type DeliveryMethodFormValues = z.infer<typeof deliveryMethodFormSchema>++export const DELIVERY_METHOD_DEFAULTS: DeliveryMethodFormValues = {+ name: '',+ admin_name: '',+ code: '',+ fulfillment_type: 'shipping',+ storefront_visible: true,+ tracking_url: '',+ estimated_transit_business_days_min: '',+ estimated_transit_business_days_max: '',+ tax_category_id: '',+ calculator_type: '',+ calculator_preferences: {},+ delivery_zone_ids: [],+}++export function deliveryMethodValuesToParams(values: DeliveryMethodFormValues) {+ return {+ name: values.name,+ admin_name: values.admin_name || null,+ code: values.code || null,+ fulfillment_type: values.fulfillment_type,+ storefront_visible: values.storefront_visible,+ tracking_url: values.tracking_url || null,+ estimated_transit_business_days_min: values.estimated_transit_business_days_min+ ? Number(values.estimated_transit_business_days_min)+ : null,+ estimated_transit_business_days_max: values.estimated_transit_business_days_max+ ? Number(values.estimated_transit_business_days_max)+ : null,+ tax_category_id: values.tax_category_id || null,+ ...(values.calculator_type ? { calculator_type: values.calculator_type } : {}),+ ...(values.calculator_preferences && Object.keys(values.calculator_preferences).length > 0+ ? { calculator_preferences: values.calculator_preferences }+ : {}),+ delivery_zone_ids: values.delivery_zone_ids,+ }+}diff --git a/packages/dashboard/src/schemas/delivery-zone.ts b/packages/dashboard/src/schemas/delivery-zone.tsnew file mode 100644index 0000000000..2b9c4b55a1--- /dev/null+++ b/packages/dashboard/src/schemas/delivery-zone.ts@@ -0,0 +1,42 @@+import { z } from 'zod/v4'++export const MEMBER_TYPES = ['country', 'state', 'postal_code'] as const++export const deliveryZoneMemberSchema = z.object({+ member_type: z.enum(MEMBER_TYPES),+ country_iso: z.string().optional(),+ state_abbr: z.string().optional(),+ postal_code_prefix: z.string().optional(),+ postal_code_from: z.string().optional(),+ postal_code_to: z.string().optional(),+})++export const deliveryZoneFormSchema = z.object({+ name: z.string().min(1),+ description: z.string().optional(),+ members: z.array(deliveryZoneMemberSchema),+})++export type DeliveryZoneMemberValues = z.infer<typeof deliveryZoneMemberSchema>+export type DeliveryZoneFormValues = z.infer<typeof deliveryZoneFormSchema>++export const DELIVERY_ZONE_DEFAULTS: DeliveryZoneFormValues = {+ name: '',+ description: '',+ members: [],+}++export function deliveryZoneValuesToParams(values: DeliveryZoneFormValues) {+ return {+ name: values.name,+ description: values.description || null,+ members: values.members.map((member) => ({+ member_type: member.member_type,+ ...(member.country_iso ? { country_iso: member.country_iso } : {}),+ ...(member.state_abbr ? { state_abbr: member.state_abbr } : {}),+ ...(member.postal_code_prefix ? { postal_code_prefix: member.postal_code_prefix } : {}),+ ...(member.postal_code_from ? { postal_code_from: member.postal_code_from } : {}),+ ...(member.postal_code_to ? { postal_code_to: member.postal_code_to } : {}),+ })),+ }+}diff --git a/packages/dashboard/src/schemas/webhook-endpoint.ts b/packages/dashboard/src/schemas/webhook-endpoint.tsindex f17a8c8dae..b0b7d74486 100644--- a/packages/dashboard/src/schemas/webhook-endpoint.ts+++ b/packages/dashboard/src/schemas/webhook-endpoint.ts@@ -201,14 +201,15 @@ export const WEBHOOK_EVENT_GROUPS: readonly WebhookEventGroup[] = [],},{- labelKey: 'admin.pages.settings.webhooks.event_groups.shipment',+ labelKey: 'admin.pages.settings.webhooks.event_groups.fulfillment',events: [- 'shipment.canceled',- 'shipment.created',- 'shipment.deleted',- 'shipment.resumed',- 'shipment.shipped',- 'shipment.updated',+ 'fulfillment.canceled',+ 'fulfillment.created',+ 'fulfillment.deleted',+ 'fulfillment.fulfilled',+ 'fulfillment.ready',+ 'fulfillment.resumed',+ 'fulfillment.updated',],},{diff --git a/packages/dashboard/src/tables/delivery-methods.tsx b/packages/dashboard/src/tables/delivery-methods.tsxnew file mode 100644index 0000000000..1bc6ee1fc2--- /dev/null+++ b/packages/dashboard/src/tables/delivery-methods.tsx@@ -0,0 +1,55 @@+import type { DeliveryMethod } from '@spree/admin-sdk'+import { defineTable } from '@spree/dashboard-core'+import { ActiveBadge, Badge, ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'+import { TruckIcon } from 'lucide-react'++defineTable<DeliveryMethod>('delivery-methods', {+ title: i18n.t('admin.settings_nav.items.delivery_methods'),+ searchParam: 'name_cont',+ searchPlaceholder: i18n.t('admin.delivery_methods.search_placeholder'),+ defaultSort: { field: 'name', direction: 'asc' },+ emptyIcon: <TruckIcon className="size-8 text-muted-foreground" />,+ emptyMessage: i18n.t('admin.delivery_methods.empty'),+ columns: [+ {+ key: 'name',+ label: i18n.t('admin.fields.name.label'),+ sortable: true,+ filterable: true,+ default: true,+ render: (dm) => (+ <ResourceNameCell+ id={dm.id}+ dataAttr="data-delivery-method-id"+ name={dm.name}+ secondary={dm.admin_name}+ />+ ),+ },+ {+ key: 'fulfillment_type',+ label: i18n.t('admin.fields.delivery_method.fulfillment_type.label'),+ default: true,+ render: (dm) => (+ <Badge variant="outline">+ {i18n.t(`admin.delivery_methods.fulfillment_types.${dm.fulfillment_type}`, {+ defaultValue: dm.fulfillment_type,+ })}+ </Badge>+ ),+ },+ {+ key: 'storefront_visible',+ label: i18n.t('admin.fields.storefront_visible.label'),+ default: true,+ render: (dm) => (+ <ActiveBadge+ active={dm.storefront_visible}+ activeLabel={i18n.t('admin.fields.storefront_visible.label')}+ dashWhenInactive+ />+ ),+ },+ ],+})diff --git a/packages/dashboard/src/tables/delivery-zones.tsx b/packages/dashboard/src/tables/delivery-zones.tsxnew file mode 100644index 0000000000..095aaabc9b--- /dev/null+++ b/packages/dashboard/src/tables/delivery-zones.tsx@@ -0,0 +1,38 @@+import type { DeliveryZone } from '@spree/admin-sdk'+import { defineTable } from '@spree/dashboard-core'+import { ResourceNameCell } from '@spree/dashboard-ui'+import i18n from 'i18next'+import { MapIcon } from 'lucide-react'++defineTable<DeliveryZone>('delivery-zones', {+ title: i18n.t('admin.settings_nav.items.delivery_zones'),+ searchParam: 'name_cont',+ searchPlaceholder: i18n.t('admin.delivery_zones.search_placeholder'),+ defaultSort: { field: 'name', direction: 'asc' },+ emptyIcon: <MapIcon className="size-8 text-muted-foreground" />,+ emptyMessage: i18n.t('admin.delivery_zones.empty'),+ columns: [+ {+ key: 'name',+ label: i18n.t('admin.fields.name.label'),+ sortable: true,+ filterable: true,+ default: true,+ render: (zone) => (+ <ResourceNameCell+ id={zone.id}+ dataAttr="data-delivery-zone-id"+ name={zone.name}+ secondary={zone.description}+ />+ ),+ },+ {+ key: 'members',+ label: i18n.t('admin.delivery_zones.members_column'),+ default: true,+ render: (zone) =>+ i18n.t('admin.delivery_zones.members_count', { count: zone.members.length }),+ },+ ],+})diff --git a/packages/sdk/examples/delivery-methods/list.ts b/packages/sdk/examples/delivery-methods/list.tsnew file mode 100644index 0000000000..0d91028fea--- /dev/null+++ b/packages/sdk/examples/delivery-methods/list.ts@@ -0,0 +1,15 @@+import { createClient } from '@spree/sdk'++const client = createClient({+ baseUrl: 'https://your-store.com',+ publishableKey: '<api-key>',+})++// region:example+const { data: pickupMethods } = await client.deliveryMethods.list({+ fulfillment_type: 'pickup',+})++// endregion:example++export { pickupMethods }diff --git a/packages/sdk/examples/delivery-methods/pickup-locations.ts b/packages/sdk/examples/delivery-methods/pickup-locations.tsnew file mode 100644index 0000000000..d9fa69bda7--- /dev/null+++ b/packages/sdk/examples/delivery-methods/pickup-locations.ts@@ -0,0 +1,15 @@+import { createClient } from '@spree/sdk'++const client = createClient({+ baseUrl: 'https://your-store.com',+ publishableKey: '<api-key>',+})++// region:example+const { data: pickupLocations } = await client.deliveryMethods.pickupLocations('dm_abc123', {+ cart_id: 'cart_abc123',+})++// endregion:example++export { pickupLocations }diff --git a/packages/sdk/src/store-client.ts b/packages/sdk/src/store-client.tsindex 99cd59865f..c99759ca8b 100644--- a/packages/sdk/src/store-client.ts+++ b/packages/sdk/src/store-client.ts@@ -25,6 +25,7 @@ import type {CreditCard,Currency,Customer,+ DeliveryMethod,GiftCard,Locale,LoginCredentials,@@ -43,6 +44,7 @@ import type {RegisterParams,RequestPasswordResetParams,ResetPasswordParams,+ StockLocation,StoreCredit,UpdateCartParams,UpdateLineItemParams,@@ -230,6 +232,54 @@ export class StoreClient {// Policies// ============================================+ readonly deliveryMethods = {+ /**+ * List storefront-visible delivery methods.+ * Filter by fulfillment_type to discover pickup options.+ */+ list: (+ params?: { fulfillment_type?: 'shipping' | 'digital' | 'pickup' | 'pickup_point' },+ options?: RequestOptions,+ ): Promise<ListResponse<DeliveryMethod>> =>+ this.request<ListResponse<DeliveryMethod>>('GET', '/delivery_methods', {+ ...options,+ params: params,+ }),++ get: (id: string, options?: RequestOptions): Promise<DeliveryMethod> =>+ this.request<DeliveryMethod>('GET', `/delivery_methods/${id}`, options),++ /**+ * Pickup-enabled stock locations for a pickup delivery method.+ * Pass cart_id to keep only locations able to fulfill the whole cart+ * from local stock.+ */+ pickupLocations: (+ id: string,+ params?: { cart_id?: string },+ options?: RequestOptions,+ ): Promise<{ data: StockLocation[] }> =>+ this.request<{ data: StockLocation[] }>('GET', `/delivery_methods/${id}/pickup_locations`, {+ ...options,+ params: params,+ }),++ /** Third-party pickup points near the customer (pickup_point methods). */+ pickupPoints: (+ id: string,+ params: { latitude: number; longitude: number },+ options?: RequestOptions,+ ): Promise<{ data: Array<Record<string, unknown>> }> =>+ this.request<{ data: Array<Record<string, unknown>> }>(+ 'GET',+ `/delivery_methods/${id}/pickup_points`,+ {+ ...options,+ params: params,+ },+ ),+ }+readonly policies = {/*** List store policies (return policy, privacy policy, terms of service, etc.)diff --git a/packages/sdk/src/types/generated/AppliedPromotion.ts b/packages/sdk/src/types/generated/AppliedPromotion.tsnew file mode 100644index 0000000000..83cd1845b1--- /dev/null+++ b/packages/sdk/src/types/generated/AppliedPromotion.ts@@ -0,0 +1,15 @@+// Typelizer digest e4784c1dfe28a79bb174fbbd802587d1+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface AppliedPromotion {+ id: string;+ promotion_id: string;+ name: string;+ description: string | null;+ code: string | null;+ amount: string | null;+ display_amount: string | null;+}++export default AppliedPromotion;diff --git a/packages/sdk/src/types/generated/Cart.ts b/packages/sdk/src/types/generated/Cart.tsindex 2b4be4b0f9..96388f879c 100644--- a/packages/sdk/src/types/generated/Cart.ts+++ b/packages/sdk/src/types/generated/Cart.ts@@ -1,7 +1,7 @@-// Typelizer digest 18aa08b4b16a43bcdc08e11808cd3c1a+// Typelizer digest 3d56d7fbb58794a17f00610bc537ac71//// DO NOT MODIFY: This file was automatically generated by Typelizer.-import type {Discount, LineItem, Fulfillment, Payment, Address, PaymentMethod, GiftCard, Market} from '@/types'+import type {AppliedPromotion, LineItem, Fulfillment, Payment, Address, PaymentMethod, GiftCard, Market} from '@/types'interface Cart {id: string;@@ -42,7 +42,7 @@ interface Cart {completed_steps: Array<string>;requirements: Array<{step: string, field: string, message: string}>;shipping_eq_billing_address: boolean;- discounts: Array<Discount>;+ discounts: Array<AppliedPromotion>;items: Array<LineItem>;fulfillments: Array<Fulfillment>;payments: Array<Payment>;diff --git a/packages/sdk/src/types/generated/DeliveryMethod.ts b/packages/sdk/src/types/generated/DeliveryMethod.tsindex 4c1a127a59..dcccda99e5 100644--- a/packages/sdk/src/types/generated/DeliveryMethod.ts+++ b/packages/sdk/src/types/generated/DeliveryMethod.ts@@ -1,4 +1,4 @@-// Typelizer digest 73976ea026b1762e293030c42cb9a7fb+// Typelizer digest 5646780f39aad6c6b74f3bae591bf8cd//// DO NOT MODIFY: This file was automatically generated by Typelizer.@@ -6,6 +6,9 @@ interface DeliveryMethod {id: string;name: string;code: string | null;+ fulfillment_type: string;+ estimated_transit_business_days_min: number | null;+ estimated_transit_business_days_max: number | null;}export default DeliveryMethod;diff --git a/packages/sdk/src/types/generated/DeliveryZone.ts b/packages/sdk/src/types/generated/DeliveryZone.tsnew file mode 100644index 0000000000..cd56682daf--- /dev/null+++ b/packages/sdk/src/types/generated/DeliveryZone.ts@@ -0,0 +1,13 @@+// Typelizer digest 59706ef94f66c40ea1b67c017afacf7c+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.+import type {DeliveryZoneMember} from '@/types'++interface DeliveryZone {+ id: string;+ name: string;+ description: string | null;+ members: Array<DeliveryZoneMember>;+}++export default DeliveryZone;diff --git a/packages/sdk/src/types/generated/DeliveryZoneMember.ts b/packages/sdk/src/types/generated/DeliveryZoneMember.tsnew file mode 100644index 0000000000..cbfd584a78--- /dev/null+++ b/packages/sdk/src/types/generated/DeliveryZoneMember.ts@@ -0,0 +1,16 @@+// Typelizer digest 8049b869db0751c4b93919393de54931+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface DeliveryZoneMember {+ id: string;+ member_type: string;+ postal_code_prefix: string | null;+ postal_code_from: string | null;+ postal_code_to: string | null;+ country_iso: string | null;+ state_abbr: string | null;+ state_name: string | null;+}++export default DeliveryZoneMember;diff --git a/packages/sdk/src/types/generated/Discount.ts b/packages/sdk/src/types/generated/Discount.tsindex ae6ada5d47..250c302475 100644--- a/packages/sdk/src/types/generated/Discount.ts+++ b/packages/sdk/src/types/generated/Discount.ts@@ -1,13 +1,17 @@-// Typelizer digest 8b92b5d8ef68697c93ef497e34efe969+// Typelizer digest cb4906b2695a014aa186047e9265d3c1//// DO NOT MODIFY: This file was automatically generated by Typelizer.interface Discount {id: string;- promotion_id: string;- name: string;- description: string | null;+ label: string;+ kind: string;code: string | null;+ value_type: string | null;+ value: string | null;+ promotion_id: string | null;+ line_item_id: string | null;+ fulfillment_id: string | null;amount: string | null;display_amount: string | null;}diff --git a/packages/sdk/src/types/generated/Fee.ts b/packages/sdk/src/types/generated/Fee.tsnew file mode 100644index 0000000000..c824e70d29--- /dev/null+++ b/packages/sdk/src/types/generated/Fee.ts@@ -0,0 +1,15 @@+// Typelizer digest d109205ff1892c57cd82ecfa1bb540d2+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface Fee {+ id: string;+ label: string;+ kind: string;+ line_item_id: string | null;+ fulfillment_id: string | null;+ amount: string | null;+ display_amount: string | null;+}++export default Fee;diff --git a/packages/sdk/src/types/generated/Fulfillment.ts b/packages/sdk/src/types/generated/Fulfillment.tsindex 68c8ca3ede..b4781a0bd4 100644--- a/packages/sdk/src/types/generated/Fulfillment.ts+++ b/packages/sdk/src/types/generated/Fulfillment.ts@@ -1,4 +1,4 @@-// Typelizer digest 2b24c989e30e00e133595c66d998827f+// Typelizer digest 6aeaca0e5388fa62ee8edfd278b010f6//// DO NOT MODIFY: This file was automatically generated by Typelizer.import type {DeliveryMethod, StockLocation, DeliveryRate} from '@/types'@@ -8,6 +8,8 @@ interface Fulfillment {number: string;tracking: string | null;tracking_url: string | null;+ pickup_point_data: Record<string, unknown> | null;+ selected_delivery_rate_id: string | null;cost: string | null;display_cost: string | null;total: string | null;diff --git a/packages/sdk/src/types/generated/Order.ts b/packages/sdk/src/types/generated/Order.tsindex d5878afe2a..362d33d1db 100644--- a/packages/sdk/src/types/generated/Order.ts+++ b/packages/sdk/src/types/generated/Order.ts@@ -1,7 +1,7 @@-// Typelizer digest 39b608bc4333e1f86bb7c3bf988c6d69+// Typelizer digest 5e5999265905b5fa1d9bfcdeabad6efd//// DO NOT MODIFY: This file was automatically generated by Typelizer.-import type {Discount, LineItem, Fulfillment, Payment, Address, GiftCard, Market} from '@/types'+import type {AppliedPromotion, LineItem, Fulfillment, Payment, Address, GiftCard, Market} from '@/types'interface Order {id: string;@@ -39,7 +39,7 @@ interface Order {store_credit_total: string | null;display_store_credit_total: string | null;covered_by_store_credit: boolean;- discounts: Array<Discount>;+ discounts: Array<AppliedPromotion>;items: Array<LineItem>;fulfillments: Array<Fulfillment>;payments: Array<Payment>;diff --git a/packages/sdk/src/types/generated/TaxLine.ts b/packages/sdk/src/types/generated/TaxLine.tsnew file mode 100644index 0000000000..84bd8deb3f--- /dev/null+++ b/packages/sdk/src/types/generated/TaxLine.ts@@ -0,0 +1,18 @@+// Typelizer digest c5b80613947830fd18a613ad64e647d8+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.++interface TaxLine {+ id: string;+ label: string;+ included: boolean;+ rate: string;+ tax_rate_id: string | null;+ line_item_id: string | null;+ fulfillment_id: string | null;+ fee_id: string | null;+ amount: string | null;+ display_amount: string | null;+}++export default TaxLine;diff --git a/packages/sdk/src/types/generated/index.ts b/packages/sdk/src/types/generated/index.tsindex 6f10c4c837..3e4f36ab16 100644--- a/packages/sdk/src/types/generated/index.ts+++ b/packages/sdk/src/types/generated/index.ts@@ -1,7 +1,8 @@-// Typelizer digest 5e93d6bfdf9260da1f0f8ff732aebb87+// Typelizer digest af38c3d2c47b5db8a900b9c388b07063//// DO NOT MODIFY: This file was automatically generated by Typelizer.export type { default as Address } from './Address'+export type { default as AppliedPromotion } from './AppliedPromotion'export type { default as Base } from './Base'export type { default as Cart } from './Cart'export type { default as Category } from './Category'@@ -15,9 +16,12 @@ export type { default as CustomerGroup } from './CustomerGroup'export type { default as Customer } from './Customer'export type { default as DeliveryMethod } from './DeliveryMethod'export type { default as DeliveryRate } from './DeliveryRate'+export type { default as DeliveryZoneMember } from './DeliveryZoneMember'+export type { default as DeliveryZone } from './DeliveryZone'export type { default as DigitalLink } from './DigitalLink'export type { default as Digital } from './Digital'export type { default as Discount } from './Discount'+export type { default as Fee } from './Fee'export type { default as Fulfillment } from './Fulfillment'export type { default as GiftCardBatch } from './GiftCardBatch'export type { default as GiftCard } from './GiftCard'@@ -57,6 +61,7 @@ export type { default as State } from './State'export type { default as StockLocation } from './StockLocation'export type { default as StockReservation } from './StockReservation'export type { default as StoreCredit } from './StoreCredit'+export type { default as TaxLine } from './TaxLine'export type { default as Variant } from './Variant'export type { default as WishlistItem } from './WishlistItem'export type { default as Wishlist } from './Wishlist'diff --git a/packages/sdk/src/zod/generated/AppliedPromotion.ts b/packages/sdk/src/zod/generated/AppliedPromotion.tsnew file mode 100644index 0000000000..276ef71cde--- /dev/null+++ b/packages/sdk/src/zod/generated/AppliedPromotion.ts@@ -0,0 +1,14 @@+// This file is auto-generated. Do not edit directly.+import { z } from 'zod';++export const AppliedPromotionSchema = z.object({+ id: z.string(),+ promotion_id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ code: z.string().nullable(),+ amount: z.string().nullable(),+ display_amount: z.string().nullable(),+});++export type AppliedPromotion = z.infer<typeof AppliedPromotionSchema>;diff --git a/packages/sdk/src/zod/generated/Cart.ts b/packages/sdk/src/zod/generated/Cart.tsindex d6a6f75b7b..97a5f57227 100644--- a/packages/sdk/src/zod/generated/Cart.ts+++ b/packages/sdk/src/zod/generated/Cart.ts@@ -1,7 +1,7 @@// This file is auto-generated. Do not edit directly.import { z } from 'zod';import { AddressSchema } from './Address';-import { DiscountSchema } from './Discount';+import { AppliedPromotionSchema } from './AppliedPromotion';import { FulfillmentSchema } from './Fulfillment';import { GiftCardSchema } from './GiftCard';import { LineItemSchema } from './LineItem';@@ -48,7 +48,7 @@ export const CartSchema = z.object({completed_steps: z.array(z.string()),requirements: z.array(z.object({ step: z.string(), field: z.string(), message: z.string() })),shipping_eq_billing_address: z.boolean(),- discounts: z.array(DiscountSchema),+ discounts: z.array(AppliedPromotionSchema),items: z.array(LineItemSchema),fulfillments: z.array(FulfillmentSchema),payments: z.array(PaymentSchema),diff --git a/packages/sdk/src/zod/generated/DeliveryMethod.ts b/packages/sdk/src/zod/generated/DeliveryMethod.tsindex 8701d5ec4e..fbdaa41698 100644--- a/packages/sdk/src/zod/generated/DeliveryMethod.ts+++ b/packages/sdk/src/zod/generated/DeliveryMethod.ts@@ -5,6 +5,9 @@ export const DeliveryMethodSchema = z.object({id: z.string(),name: z.string(),code: z.string().nullable(),+ fulfillment_type: z.string(),+ estimated_transit_business_days_min: z.number().nullable(),+ estimated_transit_business_days_max: z.number().nullable(),});export type DeliveryMethod = z.infer<typeof DeliveryMethodSchema>;diff --git a/packages/sdk/src/zod/generated/DeliveryZone.ts b/packages/sdk/src/zod/generated/DeliveryZone.tsnew file mode 100644index 0000000000..5782027719--- /dev/null+++ b/packages/sdk/src/zod/generated/DeliveryZone.ts@@ -0,0 +1,12 @@+// This file is auto-generated. Do not edit directly.+import { z } from 'zod';+import { DeliveryZoneMemberSchema } from './DeliveryZoneMember';++export const DeliveryZoneSchema = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ members: z.array(DeliveryZoneMemberSchema),+});++export type DeliveryZone = z.infer<typeof DeliveryZoneSchema>;diff --git a/packages/sdk/src/zod/generated/DeliveryZoneMember.ts b/packages/sdk/src/zod/generated/DeliveryZoneMember.tsnew file mode 100644index 0000000000..f4ddf015b4--- /dev/null+++ b/packages/sdk/src/zod/generated/DeliveryZoneMember.ts@@ -0,0 +1,15 @@+// This file is auto-generated. Do not edit directly.+import { z } from 'zod';++export const DeliveryZoneMemberSchema = z.object({+ id: z.string(),+ member_type: z.string(),+ postal_code_prefix: z.string().nullable(),+ postal_code_from: z.string().nullable(),+ postal_code_to: z.string().nullable(),+ country_iso: z.string().nullable(),+ state_abbr: z.string().nullable(),+ state_name: z.string().nullable(),+});++export type DeliveryZoneMember = z.infer<typeof DeliveryZoneMemberSchema>;diff --git a/packages/sdk/src/zod/generated/Discount.ts b/packages/sdk/src/zod/generated/Discount.tsindex 81fb762de7..3bcf0e86d3 100644--- a/packages/sdk/src/zod/generated/Discount.ts+++ b/packages/sdk/src/zod/generated/Discount.ts@@ -3,10 +3,14 @@ import { z } from 'zod';export const DiscountSchema = z.object({id: z.string(),- promotion_id: z.string(),- name: z.string(),- description: z.string().nullable(),+ label: z.string(),+ kind: z.string(),code: z.string().nullable(),+ value_type: z.string().nullable(),+ value: z.string().nullable(),+ promotion_id: z.string().nullable(),+ line_item_id: z.string().nullable(),+ fulfillment_id: z.string().nullable(),amount: z.string().nullable(),display_amount: z.string().nullable(),});diff --git a/packages/sdk/src/zod/generated/Fee.ts b/packages/sdk/src/zod/generated/Fee.tsnew file mode 100644index 0000000000..1b93cf6af0--- /dev/null+++ b/packages/sdk/src/zod/generated/Fee.ts@@ -0,0 +1,14 @@+// This file is auto-generated. Do not edit directly.+import { z } from 'zod';++export const FeeSchema = z.object({+ id: z.string(),+ label: z.string(),+ kind: z.string(),+ line_item_id: z.string().nullable(),+ fulfillment_id: z.string().nullable(),+ amount: z.string().nullable(),+ display_amount: z.string().nullable(),+});++export type Fee = z.infer<typeof FeeSchema>;diff --git a/packages/sdk/src/zod/generated/Fulfillment.ts b/packages/sdk/src/zod/generated/Fulfillment.tsindex 768b74f158..29ad6b0212 100644--- a/packages/sdk/src/zod/generated/Fulfillment.ts+++ b/packages/sdk/src/zod/generated/Fulfillment.ts@@ -9,6 +9,8 @@ export const FulfillmentSchema = z.object({number: z.string(),tracking: z.string().nullable(),tracking_url: z.string().nullable(),+ pickup_point_data: z.record(z.string(), z.unknown()).nullable(),+ selected_delivery_rate_id: z.string().nullable(),cost: z.string().nullable(),display_cost: z.string().nullable(),total: z.string().nullable(),diff --git a/packages/sdk/src/zod/generated/Order.ts b/packages/sdk/src/zod/generated/Order.tsindex dcf8001003..bf9fe9fc3d 100644--- a/packages/sdk/src/zod/generated/Order.ts+++ b/packages/sdk/src/zod/generated/Order.ts@@ -1,7 +1,7 @@// This file is auto-generated. Do not edit directly.import { z } from 'zod';import { AddressSchema } from './Address';-import { DiscountSchema } from './Discount';+import { AppliedPromotionSchema } from './AppliedPromotion';import { FulfillmentSchema } from './Fulfillment';import { GiftCardSchema } from './GiftCard';import { LineItemSchema } from './LineItem';@@ -44,7 +44,7 @@ export const OrderSchema = z.object({store_credit_total: z.string().nullable(),display_store_credit_total: z.string().nullable(),covered_by_store_credit: z.boolean(),- discounts: z.array(DiscountSchema),+ discounts: z.array(AppliedPromotionSchema),items: z.array(LineItemSchema),fulfillments: z.array(FulfillmentSchema),payments: z.array(PaymentSchema),diff --git a/packages/sdk/src/zod/generated/TaxLine.ts b/packages/sdk/src/zod/generated/TaxLine.tsnew file mode 100644index 0000000000..cdfc455520--- /dev/null+++ b/packages/sdk/src/zod/generated/TaxLine.ts@@ -0,0 +1,17 @@+// This file is auto-generated. Do not edit directly.+import { z } from 'zod';++export const TaxLineSchema = z.object({+ id: z.string(),+ label: z.string(),+ included: z.boolean(),+ rate: z.string(),+ tax_rate_id: z.string().nullable(),+ line_item_id: z.string().nullable(),+ fulfillment_id: z.string().nullable(),+ fee_id: z.string().nullable(),+ amount: z.string().nullable(),+ display_amount: z.string().nullable(),+});++export type TaxLine = z.infer<typeof TaxLineSchema>;diff --git a/packages/sdk/src/zod/generated/index.ts b/packages/sdk/src/zod/generated/index.tsindex c995c71b30..fbfd94d369 100644--- a/packages/sdk/src/zod/generated/index.ts+++ b/packages/sdk/src/zod/generated/index.ts@@ -1,5 +1,6 @@// This file is auto-generated. Do not edit directly.export { AddressSchema, type Address } from './Address';+export { AppliedPromotionSchema, type AppliedPromotion } from './AppliedPromotion';export { BaseSchema, type Base } from './Base';export { CartSchema, type Cart } from './Cart';export { CategorySchema, type Category } from './Category';@@ -13,9 +14,12 @@ export { CustomerSchema, type Customer } from './Customer';export { CustomerGroupSchema, type CustomerGroup } from './CustomerGroup';export { DeliveryMethodSchema, type DeliveryMethod } from './DeliveryMethod';export { DeliveryRateSchema, type DeliveryRate } from './DeliveryRate';+export { DeliveryZoneSchema, type DeliveryZone } from './DeliveryZone';+export { DeliveryZoneMemberSchema, type DeliveryZoneMember } from './DeliveryZoneMember';export { DigitalSchema, type Digital } from './Digital';export { DigitalLinkSchema, type DigitalLink } from './DigitalLink';export { DiscountSchema, type Discount } from './Discount';+export { FeeSchema, type Fee } from './Fee';export { FulfillmentSchema, type Fulfillment } from './Fulfillment';export { GiftCardSchema, type GiftCard } from './GiftCard';export { GiftCardBatchSchema, type GiftCardBatch } from './GiftCardBatch';@@ -55,6 +59,7 @@ export { StateSchema, type State } from './State';export { StockLocationSchema, type StockLocation } from './StockLocation';export { StockReservationSchema, type StockReservation } from './StockReservation';export { StoreCreditSchema, type StoreCredit } from './StoreCredit';+export { TaxLineSchema, type TaxLine } from './TaxLine';export { VariantSchema, type Variant } from './Variant';export { WishlistSchema, type Wishlist } from './Wishlist';export { WishlistItemSchema, type WishlistItem } from './WishlistItem';diff --git a/spree/api/app/controllers/concerns/spree/api/v3/error_handler.rb b/spree/api/app/controllers/concerns/spree/api/v3/error_handler.rbindex 339339e6d2..19f86e23ea 100644--- a/spree/api/app/controllers/concerns/spree/api/v3/error_handler.rb+++ b/spree/api/app/controllers/concerns/spree/api/v3/error_handler.rb@@ -36,6 +36,7 @@ module Spree# Order errorsorder_not_found: 'order_not_found',order_cannot_complete: 'order_cannot_complete',+ discount_not_editable: 'discount_not_editable',# Line item errorsline_item_not_found: 'line_item_not_found',diff --git a/spree/api/app/controllers/spree/api/v3/admin/delivery_methods_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/delivery_methods_controller.rbnew file mode 100644index 0000000000..b62ae8715b--- /dev/null+++ b/spree/api/app/controllers/spree/api/v3/admin/delivery_methods_controller.rb@@ -0,0 +1,115 @@+module Spree+ module Api+ module V3+ module Admin+ class DeliveryMethodsController < ResourceController+ scoped_resource :settings++ # GET /api/v3/admin/delivery_methods/calculators+ # Registered delivery calculator classes with their preference+ # schemas, so admin UIs can render configuration forms.+ def calculators+ authorize! :create, model_class++ data = Spree::DeliveryMethod.calculators.map do |calculator_class|+ {+ type: calculator_class.to_s,+ name: calculator_class.description,+ preference_schema: calculator_class.respond_to?(:serialized_preference_schema) ? calculator_class.serialized_preference_schema : []+ }+ end++ render json: { data: data }+ end++ def create+ @resource = model_class.new(assignable_params)+ authorize_resource!(@resource, :create)+ assign_calculator(@resource)++ if @resource.errors.empty? && @resource.save+ render json: serialize_resource(@resource), status: :created+ else+ render_validation_error(@resource.errors)+ end+ end++ def update+ @resource.assign_attributes(assignable_params)+ assign_calculator(@resource)++ if @resource.errors.empty? && @resource.save+ render json: serialize_resource(@resource)+ else+ render_validation_error(@resource.errors)+ end+ end++ protected++ def model_class+ Spree::DeliveryMethod+ end++ def serializer_class+ Spree.api.admin_delivery_method_serializer+ end++ def scope+ Spree::DeliveryMethod.accessible_by(current_ability, :show)+ end++ def permitted_params+ params.permit(+ :name, :admin_name, :code, :fulfillment_type, :fulfillment_provider,+ :pickup_point_provider, :storefront_visible, :tracking_url,+ :estimated_transit_business_days_min, :estimated_transit_business_days_max,+ :tax_category_id, :calculator_type,+ delivery_zone_ids: [], calculator_preferences: {}+ )+ end++ def collection_includes+ [:calculator, :tax_category, :delivery_zones]+ end++ private++ # Resolves prefixed-ID params to records; calculator handled separately.+ def assignable_params+ attributes = permitted_params.except(:tax_category_id, :delivery_zone_ids, :calculator_type, :calculator_preferences)+ if params.key?(:tax_category_id)+ attributes[:tax_category] = params[:tax_category_id].present? ? Spree::TaxCategory.find_by_prefix_id!(params[:tax_category_id]) : nil+ end+ if params.key?(:delivery_zone_ids)+ attributes[:delivery_zones] = Array(params[:delivery_zone_ids]).map { |id| Spree::DeliveryZone.find_by_prefix_id!(id) }+ end+ attributes+ end++ def assign_calculator(delivery_method)+ calculator_type = permitted_params[:calculator_type]+ preferences = permitted_params[:calculator_preferences]++ if calculator_type.present? && delivery_method.calculator&.type != calculator_type+ unless Spree::DeliveryMethod.calculators.map(&:to_s).include?(calculator_type)+ delivery_method.errors.add(:calculator_type, :invalid)+ return+ end++ delivery_method.calculator = calculator_type.constantize.new+ end++ return if preferences.blank? || delivery_method.calculator.nil?++ preferences.each do |key, value|+ next unless delivery_method.calculator.has_preference?(key)++ delivery_method.calculator.set_preference(key, value)+ end+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/controllers/spree/api/v3/admin/delivery_zones_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/delivery_zones_controller.rbnew file mode 100644index 0000000000..2630957938--- /dev/null+++ b/spree/api/app/controllers/spree/api/v3/admin/delivery_zones_controller.rb@@ -0,0 +1,94 @@+module Spree+ module Api+ module V3+ module Admin+ # Delivery zones with typed members (country / state / postal_code).+ # Members are managed atomically through the zone: `members` in the+ # payload replaces the full member set.+ class DeliveryZonesController < ResourceController+ scoped_resource :settings++ def create+ @resource = model_class.new(zone_params)+ authorize_resource!(@resource, :create)++ build_members(@resource) if params.key?(:members)++ if @resource.save+ render json: serialize_resource(@resource), status: :created+ else+ render_validation_error(@resource.errors)+ end+ end++ def update+ @resource.assign_attributes(zone_params)++ model_class.transaction do+ if params.key?(:members)+ @resource.members.destroy_all+ build_members(@resource)+ end++ if @resource.save+ render json: serialize_resource(@resource)+ else+ render_validation_error(@resource.errors)+ raise ActiveRecord::Rollback+ end+ end+ end++ protected++ def model_class+ Spree::DeliveryZone+ end++ def serializer_class+ Spree.api.admin_delivery_zone_serializer+ end++ def scope+ Spree::DeliveryZone.accessible_by(current_ability, :show)+ end++ def permitted_params+ params.permit(+ :name, :description,+ members: [:member_type, :country_iso, :state_abbr, :postal_code_prefix, :postal_code_from, :postal_code_to]+ )+ end++ def collection_includes+ [members: [:country, :state]]+ end++ private++ def zone_params+ permitted_params.except(:members)+ end++ def build_members(zone)+ Array(permitted_params[:members]).each do |member|+ attributes = member.to_h.symbolize_keys+ country_iso = attributes.delete(:country_iso)+ state_abbr = attributes.delete(:state_abbr)++ country = Spree::Country.find_by!(iso: country_iso.to_s.upcase) if country_iso.present?+ attributes[:country] = country if country+ if state_abbr.present?+ scope = country ? country.states : Spree::State+ attributes[:state] = scope.find_by(abbr: state_abbr) || scope.find_by!(name: state_abbr)+ attributes[:country] ||= attributes[:state].country+ end++ zone.members.build(attributes)+ end+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/controllers/spree/api/v3/admin/orders/discounts_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/orders/discounts_controller.rbnew file mode 100644index 0000000000..bbb97061fd--- /dev/null+++ b/spree/api/app/controllers/spree/api/v3/admin/orders/discounts_controller.rb@@ -0,0 +1,96 @@+module Spree+ module Api+ module V3+ module Admin+ module Orders+ # Typed Spree::Discount rows on an order. Manual rows have full CRUD;+ # promotion-sourced rows are read-only (recalculation owns them) and+ # respond 422 to update/destroy. Mutations re-sum the order totals —+ # this is the sanctioned post-placement discount path and works on+ # completed orders.+ class DiscountsController < BaseController+ scoped_resource :orders++ # POST /api/v3/admin/orders/:order_id/discounts+ def create+ with_order_lock do+ line_item = @parent.line_items.find_by_prefix_id!(params[:line_item_id]) if params[:line_item_id].present?++ result = Spree.order_add_manual_discount_service.call(+ order: @parent,+ label: params[:label],+ value: params[:value].presence || params[:amount],+ value_type: params[:value_type].presence || 'flat',+ line_item: line_item+ )++ if result.success?+ render json: { data: serialize_collection(result.value) }, status: :created+ else+ render_error(code: ERROR_CODES[:validation_error], message: result.error.to_s, status: :unprocessable_entity)+ end+ end+ end++ # PATCH /api/v3/admin/orders/:order_id/discounts/:id+ def update+ with_order_lock do+ return render_promotion_row_error if @resource.promotion?++ if @resource.update(permitted_params)+ @parent.updater.resum_typed_totals!+ render json: serialize_resource(@resource)+ else+ render_validation_error(@resource.errors)+ end+ end+ end++ # DELETE /api/v3/admin/orders/:order_id/discounts/:id+ def destroy+ with_order_lock do+ return render_promotion_row_error if @resource.promotion?++ @resource.destroy!+ @parent.updater.resum_typed_totals!+ head :no_content+ end+ end++ protected++ def model_class+ Spree::Discount+ end++ def serializer_class+ Spree.api.admin_discount_serializer+ end++ def scope+ @parent.discounts+ end++ def permitted_params+ params.permit(:label, :amount)+ end++ def collection_includes+ [:promotion, :line_item, :fulfillment]+ end++ private++ def render_promotion_row_error+ render_error(+ code: ERROR_CODES[:discount_not_editable],+ message: Spree.t('errors.messages.promotion_discount_not_editable'),+ status: :unprocessable_entity+ )+ end+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/controllers/spree/api/v3/admin/orders/fees_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/orders/fees_controller.rbnew file mode 100644index 0000000000..5a1a17d7dc--- /dev/null+++ b/spree/api/app/controllers/spree/api/v3/admin/orders/fees_controller.rb@@ -0,0 +1,84 @@+module Spree+ module Api+ module V3+ module Admin+ module Orders+ # Typed Spree::Fee rows (surcharge, handling, gift wrap, COD).+ # Full CRUD — all fee rows are admin-managed. Order-level when no+ # line_item/fulfillment target is given. Mutations re-sum the order+ # totals and work on completed orders (sanctioned post-placement+ # edit path).+ class FeesController < BaseController+ scoped_resource :orders++ # POST /api/v3/admin/orders/:order_id/fees+ def create+ with_order_lock do+ @resource = @parent.fees.build(permitted_params.reverse_merge(kind: 'surcharge').merge(target_attributes))++ if @resource.save+ @parent.updater.resum_typed_totals!+ render json: serialize_resource(@resource), status: :created+ else+ render_validation_error(@resource.errors)+ end+ end+ end++ # PATCH /api/v3/admin/orders/:order_id/fees/:id+ def update+ with_order_lock do+ if @resource.update(permitted_params)+ @parent.updater.resum_typed_totals!+ render json: serialize_resource(@resource)+ else+ render_validation_error(@resource.errors)+ end+ end+ end++ # DELETE /api/v3/admin/orders/:order_id/fees/:id+ def destroy+ with_order_lock do+ @resource.destroy!+ @parent.updater.resum_typed_totals!+ head :no_content+ end+ end++ protected++ def model_class+ Spree::Fee+ end++ def serializer_class+ Spree.api.admin_fee_serializer+ end++ def scope+ @parent.fees+ end++ def permitted_params+ params.permit(:label, :amount, :kind)+ end++ def collection_includes+ [:line_item, :fulfillment]+ end++ private++ def target_attributes+ attributes = {}+ attributes[:line_item] = @parent.line_items.find_by_prefix_id!(params[:line_item_id]) if params[:line_item_id].present?+ attributes[:fulfillment] = @parent.fulfillments.find_by_prefix_id!(params[:fulfillment_id]) if params[:fulfillment_id].present?+ attributes+ end+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/controllers/spree/api/v3/admin/orders/fulfillments_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/orders/fulfillments_controller.rbindex 7a3f0c32e6..bea636016d 100644--- a/spree/api/app/controllers/spree/api/v3/admin/orders/fulfillments_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/admin/orders/fulfillments_controller.rb@@ -100,7 +100,7 @@ module Spreefulfilment_changer = @resource.transfer_to_location(variant, quantity, stock_location)if fulfilment_changer.run!- fulfillments = @order.reload.shipments+ fulfillments = @order.reload.fulfillmentsrender json: {data: fulfillments.map { |s| serialize_resource(s) }}diff --git a/spree/api/app/controllers/spree/api/v3/admin/orders/tax_lines_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/orders/tax_lines_controller.rbnew file mode 100644index 0000000000..72a6be0db3--- /dev/null+++ b/spree/api/app/controllers/spree/api/v3/admin/orders/tax_lines_controller.rb@@ -0,0 +1,32 @@+module Spree+ module Api+ module V3+ module Admin+ module Orders+ # Read-only: tax lines are written exclusively by the tax provider.+ class TaxLinesController < BaseController+ scoped_resource :orders++ protected++ def model_class+ Spree::TaxLine+ end++ def serializer_class+ Spree.api.admin_tax_line_serializer+ end++ def scope+ @parent.tax_lines+ end++ def collection_includes+ [:tax_rate, :line_item, :fulfillment, :fee]+ end+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/controllers/spree/api/v3/admin/orders_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/orders_controller.rbindex 4308b227b6..21e7278441 100644--- a/spree/api/app/controllers/spree/api/v3/admin/orders_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/admin/orders_controller.rb@@ -103,7 +103,12 @@ module Spree# Override scope — Order uses SingleStoreResource (for_store)def scope- current_store.orders.accessible_by(current_ability, :show).preload_associations_lazily+ base = current_store.orders.accessible_by(current_ability, :show).preload_associations_lazily++ # Transient completion drafts (status draft + cart_id set) belong+ # to in-flight checkouts, never to the admin. Admin drafts are the+ # cart-less ones.+ base.where(cart_id: nil).or(base.where.not(status: 'draft'))enddef set_resourcediff --git a/spree/api/app/controllers/spree/api/v3/store/carts/fulfillments_controller.rb b/spree/api/app/controllers/spree/api/v3/store/carts/fulfillments_controller.rbindex eee6d48271..d5dd1bd049 100644--- a/spree/api/app/controllers/spree/api/v3/store/carts/fulfillments_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/carts/fulfillments_controller.rb@@ -11,7 +11,7 @@ module Spree# GET /api/v3/store/carts/:cart_id/fulfillmentsdef index- fulfillments = @cart.shipments.includes(shipping_rates: :shipping_method)+ fulfillments = @cart.fulfillments.includes(delivery_rates: :delivery_method)render json: {data: fulfillments.map { |s| Spree.api.fulfillment_serializer.new(s, params: serializer_params).to_h },meta: { count: fulfillments.size }@@ -19,18 +19,22 @@ module Spreeend# PATCH /api/v3/store/carts/:cart_id/fulfillments/:id- # Select a delivery rate for a specific fulfillment+ # Selects a delivery rate, and for pickup_point methods a concrete+ # pickup point (validated against the provider, then frozen into+ # pickup_point_data).def updatewith_order_lock do- fulfillment = @cart.shipments.find_by_prefix_id!(params[:id])+ fulfillment = @cart.fulfillments.find_by_prefix_id!(params[:id])if permitted_params[:selected_delivery_rate_id].present?fulfillment.selected_delivery_rate_id = permitted_params[:selected_delivery_rate_id]end- # Auto-advance (e.g. delivery → payment) after rate selection.- # Temporary — Spree 6 removes the checkout state machine.- try_advance+ if permitted_params[:pickup_point_external_id].present?+ return unless assign_pickup_point(fulfillment, permitted_params[:pickup_point_external_id])+ end++ recalculaterender_cartend@@ -39,10 +43,10 @@ module Spreeprivatedef permitted_params- params.permit(:selected_delivery_rate_id)+ params.permit(:selected_delivery_rate_id, :pickup_point_external_id)end- def try_advance+ def recalculatereturn if @cart.complete? || @cart.canceled?@cart.update_with_updater!@@ -51,6 +55,32 @@ module Spreeensure@cart.reloadend++ # @return [Boolean] false when the response has already been rendered+ def assign_pickup_point(fulfillment, external_id)+ provider = fulfillment.delivery_method&.pickup_point_provider_instance+ if provider.nil?+ render_error(+ code: ERROR_CODES[:validation_error],+ message: Spree.t('errors.messages.no_pickup_point_provider'),+ status: :unprocessable_entity+ )+ return false+ end++ point = provider.find_by_external_id(external_id)+ if point.nil?+ render_error(+ code: ERROR_CODES[:record_not_found],+ message: Spree.t('errors.messages.pickup_point_not_found'),+ status: :not_found+ )+ return false+ end++ fulfillment.update!(pickup_point_data: point.to_pickup_point_data)+ true+ endendendenddiff --git a/spree/api/app/controllers/spree/api/v3/store/carts_controller.rb b/spree/api/app/controllers/spree/api/v3/store/carts_controller.rbindex 7d912dd20b..1570485c8f 100644--- a/spree/api/app/controllers/spree/api/v3/store/carts_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/carts_controller.rb@@ -161,6 +161,7 @@ module Spree:locale,:shipping_address_id,:billing_address_id,+ :preferred_stock_location_id,:use_shipping,shipping_address: address_params,billing_address: address_params,diff --git a/spree/api/app/controllers/spree/api/v3/store/delivery_methods_controller.rb b/spree/api/app/controllers/spree/api/v3/store/delivery_methods_controller.rbnew file mode 100644index 0000000000..9ffd752d55--- /dev/null+++ b/spree/api/app/controllers/spree/api/v3/store/delivery_methods_controller.rb@@ -0,0 +1,75 @@+module Spree+ module Api+ module V3+ module Store+ # Storefront delivery method discovery — primarily for pickup flows:+ # list pickup-capable methods, then their pickup locations (merchant+ # stock locations) or third-party pickup points near the customer.+ class DeliveryMethodsController < ResourceController+ # GET /api/v3/store/delivery_methods/:id/pickup_locations+ # Pickup-enabled stock locations. With ?cart_id= the list is+ # narrowed to locations that can fulfill the whole cart from local+ # stock (package-scoped availability).+ def pickup_locations+ locations = Spree::StockLocation.active.pickup_enabled+ locations = locations.select { |location| covers_cart?(location, pickup_cart) } if pickup_cart++ render json: { data: locations.map { |location| Spree.api.stock_location_serializer.new(location, params: serializer_params).to_h } }+ end++ # GET /api/v3/store/delivery_methods/:id/pickup_points?latitude=&longitude=+ def pickup_points+ provider = find_resource.pickup_point_provider_instance+ if provider.nil?+ return render_error(code: ERROR_CODES[:record_not_found], message: Spree.t('errors.messages.no_pickup_point_provider'), status: :not_found)+ end++ latitude = params[:latitude].presence&.to_f+ longitude = params[:longitude].presence&.to_f+ if latitude.nil? || longitude.nil?+ return render_error(code: ERROR_CODES[:parameter_missing], message: 'latitude and longitude are required', status: :bad_request)+ end++ points = provider.find_nearby(latitude: latitude, longitude: longitude)+ render json: { data: points.map(&:to_pickup_point_data) }+ end++ protected++ def model_class+ Spree::DeliveryMethod+ end++ def serializer_class+ Spree.api.delivery_method_serializer+ end++ def scope+ scope = Spree::DeliveryMethod.storefront_visible+ scope = scope.by_fulfillment_type(params[:fulfillment_type]) if params[:fulfillment_type].present?+ scope+ end++ private++ def pickup_cart+ return @pickup_cart if defined?(@pickup_cart)++ @pickup_cart = params[:cart_id].present? ? current_store.carts.find_by_prefix_id!(params[:cart_id]) : nil+ end++ # Every cart item must be on hand at the location (local stock only —+ # a pickup location can't promise items it would need transferred).+ def covers_cart?(location, cart)+ cart.line_items.includes(:variant).all? do |line_item|+ next true unless line_item.variant.should_track_inventory?++ stock_item = location.stock_item(line_item.variant)+ stock_item.present? && stock_item.count_on_hand >= line_item.quantity+ end+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/applied_promotion_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/applied_promotion_serializer.rbnew file mode 100644index 0000000000..f561183d88--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/admin/applied_promotion_serializer.rb@@ -0,0 +1,15 @@+module Spree+ module Api+ module V3+ module Admin+ class AppliedPromotionSerializer < V3::AppliedPromotionSerializer+ # The Admin API has no guest gating — money fields inherited from the+ # store serializer are always present, so override their nullability.+ typelize amount: [:string, nullable: false], display_amount: [:string, nullable: false]++ attributes created_at: :iso8601, updated_at: :iso8601+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/delivery_method_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/delivery_method_serializer.rbindex d3d91fa17e..c7c7b2d554 100644--- a/spree/api/app/serializers/spree/api/v3/admin/delivery_method_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/admin/delivery_method_serializer.rb@@ -3,7 +3,33 @@ module Spreemodule V3module Adminclass DeliveryMethodSerializer < V3::DeliveryMethodSerializer- attributes created_at: :iso8601, updated_at: :iso8601+ typelize admin_name: [:string, nullable: true], fulfillment_type: :string,+ fulfillment_provider: :string, pickup_point_provider: [:string, nullable: true],+ storefront_visible: :boolean, tracking_url: [:string, nullable: true],+ tax_category_id: [:string, nullable: true],+ delivery_zone_ids: [:string, multi: true],+ calculator_type: [:string, nullable: true],+ calculator_preferences: ['Record<string, unknown>', nullable: true]++ attributes :admin_name, :fulfillment_type, :fulfillment_provider, :pickup_point_provider,+ :storefront_visible, :tracking_url,+ created_at: :iso8601, updated_at: :iso8601, deleted_at: :iso8601++ attribute :tax_category_id do |record|+ record.tax_category&.prefixed_id+ end++ attribute :delivery_zone_ids do |record|+ record.delivery_zones.map(&:prefixed_id)+ end++ attribute :calculator_type do |record|+ record.calculator&.type+ end++ attribute :calculator_preferences do |record|+ record.calculator.respond_to?(:serialized_preferences) ? record.calculator.serialized_preferences : record.calculator&.preferences+ endendendenddiff --git a/spree/api/app/serializers/spree/api/v3/admin/delivery_zone_member_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/delivery_zone_member_serializer.rbnew file mode 100644index 0000000000..06237191d5--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/admin/delivery_zone_member_serializer.rb@@ -0,0 +1,11 @@+module Spree+ module Api+ module V3+ module Admin+ class DeliveryZoneMemberSerializer < V3::DeliveryZoneMemberSerializer+ attributes created_at: :iso8601, updated_at: :iso8601+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/delivery_zone_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/delivery_zone_serializer.rbnew file mode 100644index 0000000000..5d2a586aaa--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/admin/delivery_zone_serializer.rb@@ -0,0 +1,19 @@+module Spree+ module Api+ module V3+ module Admin+ class DeliveryZoneSerializer < V3::DeliveryZoneSerializer+ typelize delivery_method_ids: [:string, multi: true]++ attributes created_at: :iso8601, updated_at: :iso8601++ attribute :delivery_method_ids do |record|+ record.delivery_methods.map(&:prefixed_id)+ end++ many :members, resource: proc { Spree.api.admin_delivery_zone_member_serializer }+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/discount_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/discount_serializer.rbindex f78410fb21..f94b6c5fd3 100644--- a/spree/api/app/serializers/spree/api/v3/admin/discount_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/admin/discount_serializer.rb@@ -3,11 +3,10 @@ module Spreemodule V3module Adminclass DiscountSerializer < V3::DiscountSerializer- # The Admin API has no guest gating — money fields inherited from the- # store serializer are always present, so override their nullability.- typelize amount: [:string, nullable: false], display_amount: [:string, nullable: false]+ typelize amount: [:string, nullable: false], display_amount: [:string, nullable: false],+ metadata: ['Record<string, unknown>', nullable: true]- attributes created_at: :iso8601, updated_at: :iso8601+ attributes :metadata, created_at: :iso8601, updated_at: :iso8601endendenddiff --git a/spree/api/app/serializers/spree/api/v3/admin/fee_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/fee_serializer.rbnew file mode 100644index 0000000000..093a2a0ba2--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/admin/fee_serializer.rb@@ -0,0 +1,14 @@+module Spree+ module Api+ module V3+ module Admin+ class FeeSerializer < V3::FeeSerializer+ typelize amount: [:string, nullable: false], display_amount: [:string, nullable: false],+ metadata: ['Record<string, unknown>', nullable: true]++ attributes :metadata, created_at: :iso8601, updated_at: :iso8601+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/fulfillment_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/fulfillment_serializer.rbindex 45f8881b46..0b135a0813 100644--- a/spree/api/app/serializers/spree/api/v3/admin/fulfillment_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/admin/fulfillment_serializer.rb@@ -30,9 +30,9 @@ module Spreeend# Override inherited associations to use admin serializers- one :shipping_method, key: :delivery_method, resource: proc { Spree.api.admin_delivery_method_serializer }, if: proc { expand?('delivery_method') }+ one :delivery_method, resource: proc { Spree.api.admin_delivery_method_serializer }, if: proc { expand?('delivery_method') }one :stock_location, resource: proc { Spree.api.admin_stock_location_serializer }, if: proc { expand?('stock_location') }- many :shipping_rates, key: :delivery_rates, resource: proc { Spree.api.admin_delivery_rate_serializer }, if: proc { expand?('delivery_rates') }+ many :delivery_rates, resource: proc { Spree.api.admin_delivery_rate_serializer }, if: proc { expand?('delivery_rates') }one :order,resource: proc { Spree.api.admin_order_serializer },diff --git a/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rbindex 7e78f709c7..5ec9965f0e 100644--- a/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rb@@ -69,7 +69,7 @@ module Spreeend# Override inherited associations to use admin serializers- many :order_promotions, key: :discounts, resource: proc { Spree.api.admin_discount_serializer }, if: proc { expand?('discounts') }+ many :order_promotions, key: :discounts, resource: proc { Spree.api.admin_applied_promotion_serializer }, if: proc { expand?('discounts') }many :line_items, key: :items, resource: proc { Spree.api.admin_line_item_serializer }, if: proc { expand?('items') }many :fulfillments, resource: proc { Spree.api.admin_fulfillment_serializer }, if: proc { expand?('fulfillments') }many :payments, resource: proc { Spree.api.admin_payment_serializer }, if: proc { expand?('payments') }diff --git a/spree/api/app/serializers/spree/api/v3/admin/tax_line_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/tax_line_serializer.rbnew file mode 100644index 0000000000..2b6f0e433d--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/admin/tax_line_serializer.rb@@ -0,0 +1,14 @@+module Spree+ module Api+ module V3+ module Admin+ class TaxLineSerializer < V3::TaxLineSerializer+ typelize amount: [:string, nullable: false], display_amount: [:string, nullable: false],+ provider_id: [:string, nullable: true], metadata: ['Record<string, unknown>', nullable: true]++ attributes :provider_id, :metadata, created_at: :iso8601, updated_at: :iso8601+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/applied_promotion_serializer.rb b/spree/api/app/serializers/spree/api/v3/applied_promotion_serializer.rbnew file mode 100644index 0000000000..86bff09a09--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/applied_promotion_serializer.rb@@ -0,0 +1,23 @@+module Spree+ module Api+ module V3+ # Summary of promotions applied to a Cart or Order (serves the embedded+ # `discounts` key). Distinct from DiscountSerializer, which serializes+ # the typed Spree::Discount money rows.+ class AppliedPromotionSerializer < BaseSerializer+ typelize name: :string, description: [:string, nullable: true], code: [:string, nullable: true],+ amount: [:string, nullable: true], display_amount: [:string, nullable: true], promotion_id: :string++ attribute :promotion_id do |record|+ record.promotion&.prefixed_id+ end++ attributes :name, :description, :code++ # Nulled for gated (prices_hidden) guests so an applied discount can't+ # leak the amount the cart/order totals already withhold.+ money_attributes :amount, :display_amount+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/cart_serializer.rb b/spree/api/app/serializers/spree/api/v3/cart_serializer.rbindex e173457d7c..d907215ece 100644--- a/spree/api/app/serializers/spree/api/v3/cart_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/cart_serializer.rb@@ -83,7 +83,7 @@ module Spreeorder.shipping_eq_billing_address?end- many :order_promotions, key: :discounts, resource: proc { Spree.api.discount_serializer }+ many :order_promotions, key: :discounts, resource: proc { Spree.api.applied_promotion_serializer }many :line_items, key: :items, resource: proc { Spree.api.line_item_serializer }many :fulfillments, resource: proc { Spree.api.fulfillment_serializer }many :payments, resource: proc { Spree.api.payment_serializer }diff --git a/spree/api/app/serializers/spree/api/v3/delivery_method_serializer.rb b/spree/api/app/serializers/spree/api/v3/delivery_method_serializer.rbindex 055e223eb0..e634f931ee 100644--- a/spree/api/app/serializers/spree/api/v3/delivery_method_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/delivery_method_serializer.rb@@ -2,9 +2,12 @@ module Spreemodule Apimodule V3class DeliveryMethodSerializer < BaseSerializer- typelize name: :string, code: [:string, nullable: true]+ typelize name: :string, code: [:string, nullable: true], fulfillment_type: :string,+ estimated_transit_business_days_min: [:number, nullable: true],+ estimated_transit_business_days_max: [:number, nullable: true]- attributes :name, :code+ attributes :name, :code, :fulfillment_type,+ :estimated_transit_business_days_min, :estimated_transit_business_days_maxendendenddiff --git a/spree/api/app/serializers/spree/api/v3/delivery_zone_member_serializer.rb b/spree/api/app/serializers/spree/api/v3/delivery_zone_member_serializer.rbnew file mode 100644index 0000000000..3c393af4e0--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/delivery_zone_member_serializer.rb@@ -0,0 +1,27 @@+module Spree+ module Api+ module V3+ class DeliveryZoneMemberSerializer < BaseSerializer+ typelize member_type: :string, country_iso: [:string, nullable: true],+ state_abbr: [:string, nullable: true], state_name: [:string, nullable: true],+ postal_code_prefix: [:string, nullable: true],+ postal_code_from: [:string, nullable: true],+ postal_code_to: [:string, nullable: true]++ attributes :member_type, :postal_code_prefix, :postal_code_from, :postal_code_to++ attribute :country_iso do |record|+ record.country&.iso+ end++ attribute :state_abbr do |record|+ record.state&.abbr+ end++ attribute :state_name do |record|+ record.state&.name+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/delivery_zone_serializer.rb b/spree/api/app/serializers/spree/api/v3/delivery_zone_serializer.rbnew file mode 100644index 0000000000..9e52f4c41c--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/delivery_zone_serializer.rb@@ -0,0 +1,13 @@+module Spree+ module Api+ module V3+ class DeliveryZoneSerializer < BaseSerializer+ typelize name: :string, description: [:string, nullable: true]++ attributes :name, :description++ many :members, resource: proc { Spree.api.delivery_zone_member_serializer }+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/discount_serializer.rb b/spree/api/app/serializers/spree/api/v3/discount_serializer.rbindex 090a8e970c..700fb72f64 100644--- a/spree/api/app/serializers/spree/api/v3/discount_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/discount_serializer.rb@@ -1,20 +1,34 @@module Spreemodule Apimodule V3- # Unified discount serializer for applied promotions on Cart and Order.- # Replaces CartPromotionSerializer and OrderPromotionSerializer.+ # A typed Spree::Discount money row (promotion-sourced or manual) on a+ # line item or fulfillment. The embedded `discounts` key on Cart/Order+ # stays the applied-promotion summary — see AppliedPromotionSerializer.class DiscountSerializer < BaseSerializer- typelize name: :string, description: [:string, nullable: true], code: [:string, nullable: true],- amount: [:string, nullable: true], display_amount: [:string, nullable: true], promotion_id: :string+ typelize label: :string, kind: :string, code: [:string, nullable: true],+ value: [:string, nullable: true], value_type: [:string, nullable: true],+ amount: [:string, nullable: true], display_amount: [:string, nullable: true],+ promotion_id: [:string, nullable: true], line_item_id: [:string, nullable: true],+ fulfillment_id: [:string, nullable: true]++ attributes :label, :kind, :code, :value_type++ attribute :value do |record|+ record.value&.to_s+ endattribute :promotion_id do |record|record.promotion&.prefixed_idend- attributes :name, :description, :code+ attribute :line_item_id do |record|+ record.line_item&.prefixed_id+ end++ attribute :fulfillment_id do |record|+ record.fulfillment&.prefixed_id+ end- # Nulled for gated (prices_hidden) guests so an applied discount can't- # leak the amount the cart/order totals already withhold.money_attributes :amount, :display_amountendenddiff --git a/spree/api/app/serializers/spree/api/v3/fee_serializer.rb b/spree/api/app/serializers/spree/api/v3/fee_serializer.rbnew file mode 100644index 0000000000..211cb8d11d--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/fee_serializer.rb@@ -0,0 +1,25 @@+module Spree+ module Api+ module V3+ # An extensible charge (typed row): surcharge, handling, gift wrap, COD.+ # Order-level when both adjustable IDs are null.+ class FeeSerializer < BaseSerializer+ typelize label: :string, kind: :string,+ amount: [:string, nullable: true], display_amount: [:string, nullable: true],+ line_item_id: [:string, nullable: true], fulfillment_id: [:string, nullable: true]++ attributes :label, :kind++ attribute :line_item_id do |record|+ record.line_item&.prefixed_id+ end++ attribute :fulfillment_id do |record|+ record.fulfillment&.prefixed_id+ end++ money_attributes :amount, :display_amount+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/fulfillment_serializer.rb b/spree/api/app/serializers/spree/api/v3/fulfillment_serializer.rbindex 37d1ecda05..e91d93f07a 100644--- a/spree/api/app/serializers/spree/api/v3/fulfillment_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/fulfillment_serializer.rb@@ -11,9 +11,11 @@ module Spreeadditional_tax_total: [:string, nullable: true], display_additional_tax_total: [:string, nullable: true],included_tax_total: [:string, nullable: true], display_included_tax_total: [:string, nullable: true],tax_total: [:string, nullable: true], display_tax_total: [:string, nullable: true],- items: 'Array<{ item_id: string; variant_id: string; quantity: number }>'+ items: 'Array<{ item_id: string; variant_id: string; quantity: number }>',+ pickup_point_data: ['Record<string, unknown>', nullable: true],+ selected_delivery_rate_id: [:string, nullable: true]- attributes :number, :tracking, :tracking_url+ attributes :number, :tracking, :tracking_url, :pickup_point_data, :selected_delivery_rate_id# Nulled for gated (prices_hidden) guests so a fulfillment can't leak the# shipping/tax amounts the cart/order totals already withhold.@@ -24,16 +26,16 @@ module Spree:included_tax_total, :display_included_tax_total,:tax_total, :display_tax_total- attribute :status do |shipment|- shipment.state- end+ attributes :status+ # Column-backed since 6.0; the fallback covers rows created before the+ # fulfillment_type backfill ran.attribute :fulfillment_type do |shipment|- shipment.digital? ? 'digital' : 'shipping'+ shipment.fulfillment_type.presence || (shipment.digital? ? 'digital' : 'shipping')endattribute :fulfilled_at do |shipment|- shipment.shipped_at&.iso8601+ shipment.fulfilled_at&.iso8601end# Which items (and how many) are in this fulfillment.@@ -50,9 +52,9 @@ module Spreeendend- one :shipping_method, key: :delivery_method, resource: proc { Spree.api.delivery_method_serializer }+ one :delivery_method, resource: proc { Spree.api.delivery_method_serializer }one :stock_location, resource: proc { Spree.api.stock_location_serializer }- many :shipping_rates, key: :delivery_rates, resource: proc { Spree.api.delivery_rate_serializer }+ many :delivery_rates, resource: proc { Spree.api.delivery_rate_serializer }endendenddiff --git a/spree/api/app/serializers/spree/api/v3/order_serializer.rb b/spree/api/app/serializers/spree/api/v3/order_serializer.rbindex 69b93ff75b..b91d13943b 100644--- a/spree/api/app/serializers/spree/api/v3/order_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/order_serializer.rb@@ -61,7 +61,7 @@ module Spreeorder.covered_by_store_credit?end- many :order_promotions, key: :discounts, resource: proc { Spree.api.discount_serializer }+ many :order_promotions, key: :discounts, resource: proc { Spree.api.applied_promotion_serializer }many :line_items, key: :items, resource: proc { Spree.api.line_item_serializer }many :fulfillments, resource: proc { Spree.api.fulfillment_serializer }many :payments, resource: proc { Spree.api.payment_serializer }diff --git a/spree/api/app/serializers/spree/api/v3/tax_line_serializer.rb b/spree/api/app/serializers/spree/api/v3/tax_line_serializer.rbnew file mode 100644index 0000000000..d765337938--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/tax_line_serializer.rb@@ -0,0 +1,37 @@+module Spree+ module Api+ module V3+ # A single tax charge (typed row) on a line item, fulfillment or fee.+ class TaxLineSerializer < BaseSerializer+ typelize label: :string, rate: :string, included: :boolean,+ amount: [:string, nullable: true], display_amount: [:string, nullable: true],+ tax_rate_id: [:string, nullable: true], line_item_id: [:string, nullable: true],+ fulfillment_id: [:string, nullable: true], fee_id: [:string, nullable: true]++ attributes :label, :included++ attribute :rate do |record|+ record.rate&.to_s+ end++ attribute :tax_rate_id do |record|+ record.tax_rate&.prefixed_id+ end++ attribute :line_item_id do |record|+ record.line_item&.prefixed_id+ end++ attribute :fulfillment_id do |record|+ record.fulfillment&.prefixed_id+ end++ attribute :fee_id do |record|+ record.fee&.prefixed_id+ end++ money_attributes :amount, :display_amount+ end+ end+ end+enddiff --git a/spree/api/config/routes.rb b/spree/api/config/routes.rbindex cacbfe58d7..b457dbb378 100644--- a/spree/api/config/routes.rb+++ b/spree/api/config/routes.rb@@ -53,6 +53,14 @@ Spree::Core::Engine.add_routes doresource :store_credits, only: [:create, :destroy], controller: 'carts/store_credits'end+ # Delivery methods (pickup discovery)+ resources :delivery_methods, only: [:index, :show] do+ member do+ get :pickup_locations+ get :pickup_points+ end+ end+# Orders (single order lookup, guest-accessible via order token)resources :orders, only: [:show]@@ -287,6 +295,13 @@ Spree::Core::Engine.add_routes doresources :stock_transfers, only: [:index, :show, :create, :destroy]# Payment Methods+ resources :delivery_methods do+ collection do+ get :calculators+ end+ end+ resources :delivery_zones+resources :payment_methods docollection doget :types@@ -404,6 +419,9 @@ Spree::Core::Engine.add_routes doendendresources :refunds, controller: 'orders/refunds', only: [:index, :create]+ resources :tax_lines, controller: 'orders/tax_lines', only: [:index, :show]+ resources :discounts, controller: 'orders/discounts', only: [:index, :show, :create, :update, :destroy]+ resources :fees, controller: 'orders/fees', only: [:index, :show, :create, :update, :destroy]resources :gift_cards, controller: 'orders/gift_cards', only: [:create, :destroy]resource :store_credits, controller: 'orders/store_credits', only: [:create, :destroy]enddiff --git a/spree/api/lib/spree/api/dependencies.rb b/spree/api/lib/spree/api/dependencies.rbindex 9bb3a52918..4a9b25170c 100644--- a/spree/api/lib/spree/api/dependencies.rb+++ b/spree/api/lib/spree/api/dependencies.rb@@ -42,7 +42,12 @@ module Spreestock_location_serializer: 'Spree::Api::V3::StockLocationSerializer',category_serializer: 'Spree::Api::V3::CategorySerializer',collection_serializer: 'Spree::Api::V3::CollectionSerializer',+ applied_promotion_serializer: 'Spree::Api::V3::AppliedPromotionSerializer',discount_serializer: 'Spree::Api::V3::DiscountSerializer',+ tax_line_serializer: 'Spree::Api::V3::TaxLineSerializer',+ delivery_zone_serializer: 'Spree::Api::V3::DeliveryZoneSerializer',+ delivery_zone_member_serializer: 'Spree::Api::V3::DeliveryZoneMemberSerializer',+ fee_serializer: 'Spree::Api::V3::FeeSerializer',digital_link_serializer: 'Spree::Api::V3::DigitalLinkSerializer',gift_card_serializer: 'Spree::Api::V3::GiftCardSerializer',currency_serializer: 'Spree::Api::V3::CurrencySerializer',@@ -85,7 +90,12 @@ module Spree# v3 admin serializers (API v3 Admin)admin_country_serializer: 'Spree::Api::V3::Admin::CountrySerializer',admin_state_serializer: 'Spree::Api::V3::Admin::StateSerializer',+ admin_applied_promotion_serializer: 'Spree::Api::V3::Admin::AppliedPromotionSerializer',admin_discount_serializer: 'Spree::Api::V3::Admin::DiscountSerializer',+ admin_tax_line_serializer: 'Spree::Api::V3::Admin::TaxLineSerializer',+ admin_delivery_zone_serializer: 'Spree::Api::V3::Admin::DeliveryZoneSerializer',+ admin_delivery_zone_member_serializer: 'Spree::Api::V3::Admin::DeliveryZoneMemberSerializer',+ admin_fee_serializer: 'Spree::Api::V3::Admin::FeeSerializer',admin_customer_serializer: 'Spree::Api::V3::Admin::CustomerSerializer',admin_newsletter_subscriber_serializer: 'Spree::Api::V3::Admin::NewsletterSubscriberSerializer',admin_order_serializer: 'Spree::Api::V3::Admin::OrderSerializer',diff --git a/spree/api/spec/controllers/spree/api/v3/admin/delivery_methods_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/delivery_methods_controller_spec.rbnew file mode 100644index 0000000000..62a9f7bdb2--- /dev/null+++ b/spree/api/spec/controllers/spree/api/v3/admin/delivery_methods_controller_spec.rb@@ -0,0 +1,107 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::DeliveryMethodsController, type: :controller do+ render_views++ include_context 'API v3 Admin authenticated'++ before { request.headers.merge!(headers) }++ describe 'GET #index' do+ let!(:delivery_method) { create(:shipping_method, name: 'UPS Ground') }++ it 'lists delivery methods with admin fields' do+ get :index, params: {}, as: :json++ expect(response).to have_http_status(:ok)+ data = json_response['data'].find { |row| row['name'] == 'UPS Ground' }+ expect(data).to be_present+ expect(data['fulfillment_type']).to eq('shipping')+ expect(data['calculator_type']).to be_present+ end+ end++ describe 'GET #calculators' do+ it 'lists registered calculators with preference schemas' do+ get :calculators, params: {}, as: :json++ expect(response).to have_http_status(:ok)+ types = json_response['data'].map { |row| row['type'] }+ expect(types).to include('Spree::Calculator::Shipping::FlatRate')+ flat_rate = json_response['data'].find { |row| row['type'] == 'Spree::Calculator::Shipping::FlatRate' }+ expect(flat_rate['preference_schema']).to be_an(Array)+ end+ end++ describe 'POST #create' do+ let!(:zone) { create(:delivery_zone) }++ it 'creates a delivery method with calculator and zones' do+ post :create, params: {+ name: 'Express',+ fulfillment_type: 'shipping',+ storefront_visible: true,+ calculator_type: 'Spree::Calculator::Shipping::FlatRate',+ calculator_preferences: { amount: 12.5 },+ delivery_zone_ids: [zone.prefixed_id]+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['name']).to eq('Express')+ expect(json_response['calculator_type']).to eq('Spree::Calculator::Shipping::FlatRate')+ expect(json_response['delivery_zone_ids']).to eq([zone.prefixed_id])++ delivery_method = Spree::DeliveryMethod.find_by_prefix_id(json_response['id'])+ expect(delivery_method.calculator.preferred_amount).to eq(12.5)+ end++ it 'creates a pickup method without a calculator requirement' do+ post :create, params: {+ name: 'Store pickup',+ fulfillment_type: 'pickup',+ calculator_type: 'Spree::Calculator::Shipping::FlatRate'+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['fulfillment_type']).to eq('pickup')+ end++ it 'rejects unknown calculator types' do+ post :create, params: {+ name: 'Sneaky',+ fulfillment_type: 'shipping',+ calculator_type: 'Kernel'+ }, as: :json++ expect(response).to have_http_status(:unprocessable_content)+ end+ end++ describe 'PATCH #update' do+ let!(:delivery_method) { create(:shipping_method, name: 'UPS Ground') }++ it 'updates attributes and calculator preferences' do+ patch :update, params: {+ id: delivery_method.prefixed_id,+ name: 'UPS Ground v2',+ calculator_preferences: { amount: 99 }+ }, as: :json++ expect(response).to have_http_status(:ok)+ expect(delivery_method.reload.name).to eq('UPS Ground v2')+ expect(delivery_method.calculator.preferred_amount).to eq(99)+ end+ end++ describe 'DELETE #destroy' do+ let!(:delivery_method) { create(:shipping_method) }++ it 'soft deletes the delivery method' do+ delete :destroy, params: { id: delivery_method.prefixed_id }, as: :json++ expect(response).to have_http_status(:no_content)+ expect(Spree::DeliveryMethod.find_by(id: delivery_method.id)).to be_nil+ expect(Spree::DeliveryMethod.with_deleted.find(delivery_method.id)).to be_present+ end+ end+enddiff --git a/spree/api/spec/controllers/spree/api/v3/admin/delivery_zones_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/delivery_zones_controller_spec.rbnew file mode 100644index 0000000000..ec385e2ad9--- /dev/null+++ b/spree/api/spec/controllers/spree/api/v3/admin/delivery_zones_controller_spec.rb@@ -0,0 +1,88 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::DeliveryZonesController, type: :controller do+ render_views++ include_context 'API v3 Admin authenticated'++ let!(:country) { Spree::Country.find_by(iso: 'US') || create(:country_us) }++ before { request.headers.merge!(headers) }++ describe 'GET #index' do+ let!(:zone) { create(:delivery_zone, name: 'Domestic') }++ it 'lists delivery zones' do+ get :index, params: {}, as: :json++ expect(response).to have_http_status(:ok)+ expect(json_response['data'].map { |z| z['name'] }).to include('Domestic')+ end+ end++ describe 'POST #create' do+ it 'creates a zone with typed members' do+ post :create, params: {+ name: 'US North-East',+ members: [+ { member_type: 'country', country_iso: 'US' },+ { member_type: 'postal_code', country_iso: 'US', postal_code_prefix: '10' }+ ]+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['name']).to eq('US North-East')+ expect(json_response['members'].length).to eq(2)+ expect(json_response['members'].map { |m| m['member_type'] }).to contain_exactly('country', 'postal_code')+ expect(json_response['members'].find { |m| m['member_type'] == 'postal_code' }['postal_code_prefix']).to eq('10')+ end++ it 'validates member shapes' do+ post :create, params: {+ name: 'Broken',+ members: [{ member_type: 'postal_code' }]+ }, as: :json++ expect(response).to have_http_status(:unprocessable_content)+ end+ end++ describe 'PATCH #update' do+ let!(:zone) do+ create(:delivery_zone, name: 'Domestic').tap do |z|+ z.members.create!(member_type: 'country', country: country)+ end+ end++ it 'replaces the member set atomically' do+ patch :update, params: {+ id: zone.prefixed_id,+ name: 'Domestic v2',+ members: [{ member_type: 'postal_code', country_iso: 'US', postal_code_from: '10000', postal_code_to: '19999' }]+ }, as: :json++ expect(response).to have_http_status(:ok)+ expect(zone.reload.name).to eq('Domestic v2')+ expect(zone.members.count).to eq(1)+ expect(zone.members.first.member_type).to eq('postal_code')+ end++ it 'keeps members untouched when the payload has none' do+ patch :update, params: { id: zone.prefixed_id, name: 'Renamed' }, as: :json++ expect(response).to have_http_status(:ok)+ expect(zone.reload.members.count).to eq(1)+ end+ end++ describe 'DELETE #destroy' do+ let!(:zone) { create(:delivery_zone) }++ it 'deletes the zone' do+ delete :destroy, params: { id: zone.prefixed_id }, as: :json++ expect(response).to have_http_status(:no_content)+ expect(Spree::DeliveryZone.exists?(zone.id)).to be(false)+ end+ end+enddiff --git a/spree/api/spec/controllers/spree/api/v3/admin/orders/discounts_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/orders/discounts_controller_spec.rbnew file mode 100644index 0000000000..2858ecef0f--- /dev/null+++ b/spree/api/spec/controllers/spree/api/v3/admin/orders/discounts_controller_spec.rb@@ -0,0 +1,118 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::Orders::DiscountsController, type: :controller do+ render_views++ include_context 'API v3 Admin authenticated'++ let!(:order) { create(:completed_order_with_totals, store: store) }+ let(:line_item) { order.line_items.first }++ before { request.headers.merge!(headers) }++ describe 'GET #index' do+ let!(:manual_discount) do+ create(:discount, order: order, line_item: line_item, amount: -2, label: 'Loyalty', kind: 'manual')+ end++ it 'lists typed discount rows' do+ get :index, params: { order_id: order.prefixed_id }, as: :json++ expect(response).to have_http_status(:ok)+ expect(json_response['data'].length).to eq(1)+ expect(json_response['data'].first['label']).to eq('Loyalty')+ expect(json_response['data'].first['kind']).to eq('manual')+ expect(json_response['data'].first['line_item_id']).to eq(line_item.prefixed_id)+ end+ end++ describe 'POST #create' do+ it 'creates a line-item discount and re-sums totals' do+ original_total = order.total++ post :create, params: {+ order_id: order.prefixed_id,+ line_item_id: line_item.prefixed_id,+ label: 'Appeasement',+ value: 3,+ value_type: 'flat'+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['data'].length).to eq(1)+ expect(json_response['data'].first['amount']).to eq('-3.0')+ expect(order.reload.total).to eq(original_total - 3)+ end++ it 'distributes an order-level discount across line items' do+ post :create, params: {+ order_id: order.prefixed_id,+ label: 'Order apology',+ value: 4,+ value_type: 'flat'+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['data'].sum { |row| BigDecimal(row['amount']) }).to eq(-4)+ expect(json_response['data']).to all(include('kind' => 'manual'))+ end++ it 'supports percent discounts' do+ post :create, params: {+ order_id: order.prefixed_id,+ line_item_id: line_item.prefixed_id,+ label: 'Percent off',+ value: 50,+ value_type: 'percent'+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(BigDecimal(json_response['data'].first['amount'])).to eq(-(line_item.amount / 2).round(2))+ end++ it 'rejects a non-positive value' do+ post :create, params: { order_id: order.prefixed_id, label: 'Bad', value: -5 }, as: :json++ expect(response).to have_http_status(:unprocessable_content)+ end+ end++ describe 'PATCH #update' do+ let!(:manual_discount) do+ create(:discount, order: order, line_item: line_item, amount: -2, label: 'Loyalty', kind: 'manual')+ end++ it 'updates a manual discount' do+ patch :update, params: { order_id: order.prefixed_id, id: manual_discount.prefixed_id, label: 'Renamed' }, as: :json++ expect(response).to have_http_status(:ok)+ expect(manual_discount.reload.label).to eq('Renamed')+ end++ it 'refuses to edit promotion-sourced rows' do+ manual_discount.update_columns(kind: 'promotion')++ patch :update, params: { order_id: order.prefixed_id, id: manual_discount.prefixed_id, label: 'Nope' }, as: :json++ expect(response).to have_http_status(:unprocessable_content)+ expect(json_response['error']['code']).to eq('discount_not_editable')+ end+ end++ describe 'DELETE #destroy' do+ let!(:manual_discount) do+ create(:discount, order: order, line_item: line_item, amount: -2, label: 'Loyalty', kind: 'manual')+ end++ it 'removes the row and re-sums totals' do+ order.updater.resum_typed_totals!+ with_discount_total = order.reload.total++ delete :destroy, params: { order_id: order.prefixed_id, id: manual_discount.prefixed_id }, as: :json++ expect(response).to have_http_status(:no_content)+ expect(order.reload.total).to eq(with_discount_total + 2)+ expect(Spree::Discount.exists?(manual_discount.id)).to be(false)+ end+ end+enddiff --git a/spree/api/spec/controllers/spree/api/v3/admin/orders/fees_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/orders/fees_controller_spec.rbnew file mode 100644index 0000000000..5e718e4f95--- /dev/null+++ b/spree/api/spec/controllers/spree/api/v3/admin/orders/fees_controller_spec.rb@@ -0,0 +1,84 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::Orders::FeesController, type: :controller do+ render_views++ include_context 'API v3 Admin authenticated'++ let!(:order) { create(:completed_order_with_totals, store: store) }+ let(:line_item) { order.line_items.first }++ before { request.headers.merge!(headers) }++ describe 'GET #index' do+ let!(:fee) { create(:fee, order: order, amount: 5, label: 'Handling', kind: 'handling') }++ it 'lists fee rows' do+ get :index, params: { order_id: order.prefixed_id }, as: :json++ expect(response).to have_http_status(:ok)+ expect(json_response['data'].length).to eq(1)+ expect(json_response['data'].first['label']).to eq('Handling')+ expect(json_response['data'].first['amount']).to eq('5.0')+ end+ end++ describe 'POST #create' do+ it 'creates an order-level fee and re-sums totals' do+ original_total = order.total++ post :create, params: { order_id: order.prefixed_id, label: 'Gift wrap', amount: 4, kind: 'gift_wrap' }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['label']).to eq('Gift wrap')+ expect(json_response['line_item_id']).to be_nil+ expect(order.reload.total).to eq(original_total + 4)+ expect(order.fee_total).to eq(4)+ end++ it 'creates a line-item fee' do+ post :create, params: {+ order_id: order.prefixed_id, line_item_id: line_item.prefixed_id, label: 'Restocking', amount: 2+ }, as: :json++ expect(response).to have_http_status(:created)+ expect(json_response['line_item_id']).to eq(line_item.prefixed_id)+ expect(json_response['kind']).to eq('surcharge')+ end++ it 'rejects a negative amount' do+ post :create, params: { order_id: order.prefixed_id, label: 'Credit', amount: -3 }, as: :json++ expect(response).to have_http_status(:unprocessable_content)+ end+ end++ describe 'PATCH #update' do+ let!(:fee) { create(:fee, order: order, amount: 5, label: 'Handling', kind: 'handling') }++ it 'updates the fee and re-sums totals' do+ order.updater.resum_typed_totals!+ with_fee_total = order.reload.total++ patch :update, params: { order_id: order.prefixed_id, id: fee.prefixed_id, amount: 8 }, as: :json++ expect(response).to have_http_status(:ok)+ expect(fee.reload.amount).to eq(8)+ expect(order.reload.total).to eq(with_fee_total + 3)+ end+ end++ describe 'DELETE #destroy' do+ let!(:fee) { create(:fee, order: order, amount: 5, label: 'Handling', kind: 'handling') }++ it 'removes the fee and re-sums totals' do+ order.updater.resum_typed_totals!+ with_fee_total = order.reload.total++ delete :destroy, params: { order_id: order.prefixed_id, id: fee.prefixed_id }, as: :json++ expect(response).to have_http_status(:no_content)+ expect(order.reload.total).to eq(with_fee_total - 5)+ end+ end+enddiff --git a/spree/api/spec/controllers/spree/api/v3/admin/orders/tax_lines_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/orders/tax_lines_controller_spec.rbnew file mode 100644index 0000000000..6b867f53a5--- /dev/null+++ b/spree/api/spec/controllers/spree/api/v3/admin/orders/tax_lines_controller_spec.rb@@ -0,0 +1,43 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::Orders::TaxLinesController, type: :controller do+ render_views++ include_context 'API v3 Admin authenticated'++ let!(:order) { create(:completed_order_with_totals, store: store) }+ let(:line_item) { order.line_items.first }+ let!(:tax_line) do+ create(:tax_line, order: order, line_item: line_item, amount: 1.5, rate: 0.15, label: 'VAT 15%')+ end++ before { request.headers.merge!(headers) }++ describe 'GET #index' do+ it 'lists tax lines' do+ get :index, params: { order_id: order.prefixed_id }, as: :json++ expect(response).to have_http_status(:ok)+ expect(json_response['data'].length).to eq(1)+ expect(json_response['data'].first['label']).to eq('VAT 15%')+ expect(json_response['data'].first['rate']).to eq('0.15')+ expect(json_response['data'].first['line_item_id']).to eq(line_item.prefixed_id)+ end+ end++ describe 'GET #show' do+ it 'returns a tax line' do+ get :show, params: { order_id: order.prefixed_id, id: tax_line.prefixed_id }, as: :json++ expect(response).to have_http_status(:ok)+ expect(json_response['id']).to eq(tax_line.prefixed_id)+ expect(json_response['amount']).to eq('1.5')+ end+ end++ it 'does not route create' do+ expect {+ post :create, params: { order_id: order.prefixed_id }, as: :json+ }.to raise_error(ActionController::UrlGenerationError)+ end+enddiff --git a/spree/api/spec/controllers/spree/api/v3/admin/promotion_actions_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/promotion_actions_controller_spec.rbindex 0b3d797903..e8d6c997c1 100644--- a/spree/api/spec/controllers/spree/api/v3/admin/promotion_actions_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/admin/promotion_actions_controller_spec.rb@@ -18,7 +18,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionActionsController, type: :controlexpect(response).to have_http_status(:created)expect(promotion.reload.promotion_actions.map(&:type))- .to include('Spree::PromotionActions::CreateAdjustment')+ .to include('Spree::Promotion::Actions::CreateAdjustment')endit "404s for a promotion that belongs to another store" dodiff --git a/spree/api/spec/controllers/spree/api/v3/admin/promotion_rules_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/promotion_rules_controller_spec.rbindex e6cbb4a259..698621bb2a 100644--- a/spree/api/spec/controllers/spree/api/v3/admin/promotion_rules_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/admin/promotion_rules_controller_spec.rb@@ -17,7 +17,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionRulesController, type: :controlle}, as: :jsonexpect(response).to have_http_status(:created)- expect(promotion.reload.promotion_rules.map(&:type)).to include('Spree::PromotionRules::FirstOrder')+ expect(promotion.reload.promotion_rules.map(&:type)).to include('Spree::Promotion::Rules::FirstOrder')endit 'creates a channel rule, storing the selected channel IDs in preferences' do@@ -30,7 +30,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionRulesController, type: :controlle}, as: :jsonexpect(response).to have_http_status(:created)- rule = promotion.reload.promotion_rules.find { |r| r.is_a?(Spree::PromotionRules::Channel) }+ rule = promotion.reload.promotion_rules.find { |r| r.is_a?(Spree::Promotion::Rules::Channel) }expect(rule).to be_presentexpect(rule.preferred_channel_ids.map(&:to_s)).to eq([channel.id.to_s])end@@ -45,7 +45,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionRulesController, type: :controlle}, as: :jsonexpect(response).to have_http_status(:created)- rule = promotion.reload.promotion_rules.find { |r| r.is_a?(Spree::PromotionRules::Market) }+ rule = promotion.reload.promotion_rules.find { |r| r.is_a?(Spree::Promotion::Rules::Market) }expect(rule).to be_presentexpect(rule.preferred_market_ids.map(&:to_s)).to eq([market.id.to_s])enddiff --git a/spree/api/spec/controllers/spree/api/v3/admin/promotions_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/admin/promotions_controller_spec.rbindex 352999ef41..9c0adc97b7 100644--- a/spree/api/spec/controllers/spree/api/v3/admin/promotions_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/admin/promotions_controller_spec.rb@@ -75,7 +75,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller dopromotion = Spree::Promotion.find_by_prefix_id(json_response['id'])expect(promotion.rules.size).to eq(1)rule = promotion.rules.first- expect(rule).to be_a(Spree::PromotionRules::Currency)+ expect(rule).to be_a(Spree::Promotion::Rules::Currency)expect(rule.preferred_currency).to eq('EUR')end@@ -91,7 +91,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)rule = Spree::Promotion.find_by_prefix_id(json_response['id']).rules.first- expect(rule).to be_a(Spree::PromotionRules::ItemTotal)+ expect(rule).to be_a(Spree::Promotion::Rules::ItemTotal)expect(rule.preferred_amount_min).to eq(50.0)expect(rule.preferred_operator_min).to eq('gte')expect(rule.preferred_amount_max).to eq(500.0)@@ -115,7 +115,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)promotion = Spree::Promotion.find_by_prefix_id(json_response['id'])rule = promotion.rules.first- expect(rule).to be_a(Spree::PromotionRules::Product)+ expect(rule).to be_a(Spree::Promotion::Rules::Product)expect(rule.product_ids).to contain_exactly(product_a.id, product_b.id)expect(rule.preferred_match_policy).to eq('any')end@@ -135,7 +135,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)rule = Spree::Promotion.find_by_prefix_id(json_response['id']).rules.first- expect(rule).to be_a(Spree::PromotionRules::Category)+ expect(rule).to be_a(Spree::Promotion::Rules::Category)expect(rule.taxon_ids).to eq([taxon.id])end@@ -152,7 +152,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)promotion = Spree::Promotion.find_by_prefix_id(json_response['id'])types = promotion.rules.map(&:class)- expect(types).to contain_exactly(Spree::PromotionRules::Currency, Spree::PromotionRules::FirstOrder)+ expect(types).to contain_exactly(Spree::Promotion::Rules::Currency, Spree::Promotion::Rules::FirstOrder)endit 'silently ignores rules with an unknown type' do@@ -168,7 +168,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)promotion = Spree::Promotion.find_by_prefix_id(json_response['id'])expect(promotion.rules.size).to eq(1)- expect(promotion.rules.first).to be_a(Spree::PromotionRules::Currency)+ expect(promotion.rules.first).to be_a(Spree::Promotion::Rules::Currency)endend@@ -177,7 +177,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller dopost :create,params: base_params.merge(actions: [{- type: 'create_item_discounts',+ type: 'create_item_adjustments',calculator: {type: 'flat_rate',preferences: { amount: '25.0', currency: 'USD' }@@ -188,7 +188,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)action = Spree::Promotion.find_by_prefix_id(json_response['id']).actions.first- expect(action).to be_a(Spree::PromotionActions::CreateItemDiscounts)+ expect(action).to be_a(Spree::Promotion::Actions::CreateItemAdjustments)expect(action.calculator).to be_a(Spree::Calculator::FlatRate)expect(action.calculator.preferred_amount).to eq(25.0)expect(action.calculator.preferred_currency).to eq('USD')@@ -203,7 +203,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)action = Spree::Promotion.find_by_prefix_id(json_response['id']).actions.first- expect(action).to be_a(Spree::PromotionActions::FreeShipping)+ expect(action).to be_a(Spree::Promotion::Actions::FreeShipping)endit 'creates a CreateAdjustment action with FlatPercentItemTotal calculator' do@@ -232,7 +232,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doparams: base_params.merge(rules: [{ type: 'currency', preferences: { currency: 'USD' } }],actions: [{- type: 'create_item_discounts',+ type: 'create_item_adjustments',calculator: { type: 'flat_rate', preferences: { amount: '5.0' } }}]),@@ -255,7 +255,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)promotion = Spree::Promotion.find_by_prefix_id(json_response['id'])- expect(promotion.rules.first).to be_a(Spree::PromotionRules::Currency)+ expect(promotion.rules.first).to be_a(Spree::Promotion::Rules::Currency)expect(promotion.rules.first.preferred_currency).to eq('EUR')end@@ -271,7 +271,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)rule = Spree::Promotion.find_by_prefix_id(json_response['id']).rules.first- expect(rule).to be_a(Spree::PromotionRules::Category)+ expect(rule).to be_a(Spree::Promotion::Rules::Category)expect(rule.taxon_ids).to eq([taxon.id])end@@ -279,7 +279,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller dopost :create,params: base_params.merge(actions: [{- type: 'create_item_discounts',+ type: 'create_item_adjustments',calculator: { type: 'flat_rate', preferences: { amount: '12.5' } }}]),@@ -287,7 +287,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:created)action = Spree::Promotion.find_by_prefix_id(json_response['id']).actions.first- expect(action).to be_a(Spree::PromotionActions::CreateItemDiscounts)+ expect(action).to be_a(Spree::Promotion::Actions::CreateItemAdjustments)expect(action.calculator).to be_a(Spree::Calculator::FlatRate)expect(action.calculator.preferred_amount).to eq(12.5)end@@ -346,8 +346,8 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doendit 'updates an existing rule by prefixed id' do- rule = create(:promotion_rule, promotion: promotion, type: 'Spree::PromotionRules::Currency')- rule.becomes(Spree::PromotionRules::Currency).update!(preferred_currency: 'USD')+ rule = create(:promotion_rule, promotion: promotion, type: 'Spree::Promotion::Rules::Currency')+ rule.becomes(Spree::Promotion::Rules::Currency).update!(preferred_currency: 'USD')patch :update,params: {@@ -361,12 +361,12 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doas: :jsonexpect(response).to have_http_status(:ok)- expect(rule.becomes(Spree::PromotionRules::Currency).reload.preferred_currency).to eq('CAD')+ expect(rule.becomes(Spree::Promotion::Rules::Currency).reload.preferred_currency).to eq('CAD')expect(promotion.reload.rules.size).to eq(1)endit 'replaces product_ids on an existing Product rule' do- rule = Spree::PromotionRules::Product.create!(promotion: promotion)+ rule = Spree::Promotion::Rules::Product.create!(promotion: promotion)product_a = create(:product)product_b = create(:product)rule.products = [product_a]@@ -388,7 +388,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doendit 'destroys rules omitted from the payload' do- rule = Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD')+ rule = Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD')patch :update, params: { id: promotion.prefixed_id, rules: [] }, as: :json@@ -398,8 +398,8 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doendit 'destroys removed rules while keeping the ones explicitly passed' do- keep = Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD')- drop = Spree::PromotionRules::FirstOrder.create!(promotion: promotion)+ keep = Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD')+ drop = Spree::Promotion::Rules::FirstOrder.create!(promotion: promotion)patch :update,params: {@@ -469,7 +469,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionsController, type: :controller doexpect(response).to have_http_status(:ok)types = promotion.reload.actions.map(&:class)- expect(types).to include(Spree::PromotionActions::FreeShipping)+ expect(types).to include(Spree::Promotion::Actions::FreeShipping)endendenddiff --git a/spree/api/spec/controllers/spree/api/v3/store/carts_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/carts_controller_spec.rbindex 50946b9696..2bb2890ada 100644--- a/spree/api/spec/controllers/spree/api/v3/store/carts_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/store/carts_controller_spec.rb@@ -611,7 +611,7 @@ RSpec.describe Spree::Api::V3::Store::CartsController, type: :controller doendcontext 'updating market' do- let!(:market) { create(:market, store: store, countries: [country]) }+ let!(:market) { store.default_market }it 'updates the cart market' dopatch :update, params: { id: order.prefixed_id, market_id: market.prefixed_id }@@ -655,13 +655,16 @@ RSpec.describe Spree::Api::V3::Store::CartsController, type: :controller doexpect(json_response['market_id']).to eq(eu_market.prefixed_id)end- it 'returns validation error when no market exists for currency' do+ it 'keeps the current market when no market exists for the currency' doorder.update!(market: market)patch :update, params: { id: order.prefixed_id, currency: 'GBP' }- expect(response).to have_http_status(:unprocessable_content)- expect(json_response['error']['code']).to eq('validation_error')+ # GBP is store-supported via the legacy column; without a GBP market+ # the cart keeps its current market.+ expect(response).to have_http_status(:ok)+ expect(json_response['currency']).to eq('GBP')+ expect(json_response['market_id']).to eq(market.prefixed_id)endenddiff --git a/spree/api/spec/controllers/spree/api/v3/store/delivery_methods_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/delivery_methods_controller_spec.rbnew file mode 100644index 0000000000..f7a412e770--- /dev/null+++ b/spree/api/spec/controllers/spree/api/v3/store/delivery_methods_controller_spec.rb@@ -0,0 +1,108 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Store::DeliveryMethodsController, type: :controller do+ render_views++ include_context 'API v3 Store'++ let!(:shipping_method) { create(:shipping_method, name: 'Standard', storefront_visible: true) }+ let!(:pickup_method) do+ create(:shipping_method, name: 'Store pickup', storefront_visible: true).tap do |dm|+ dm.update!(fulfillment_type: 'pickup')+ end+ end+ let!(:hidden_method) { create(:shipping_method, name: 'Internal', storefront_visible: false) }++ before { request.headers['X-Spree-Api-Key'] = api_key.token }++ describe 'GET #index' do+ it 'lists storefront-visible delivery methods' do+ get :index, params: {}, as: :json++ names = json_response['data'].map { |row| row['name'] }+ expect(names).to include('Standard', 'Store pickup')+ expect(names).not_to include('Internal')+ end++ it 'filters by fulfillment_type' do+ get :index, params: { fulfillment_type: 'pickup' }, as: :json++ expect(json_response['data'].map { |row| row['name'] }).to eq(['Store pickup'])+ end+ end++ describe 'GET #pickup_locations' do+ let!(:pickup_location) { create(:stock_location, name: 'Downtown', pickup_enabled: true) }+ let!(:warehouse) { create(:stock_location, name: 'Warehouse', pickup_enabled: false, backorderable_default: false) }++ it 'lists pickup-enabled stock locations' do+ get :pickup_locations, params: { id: pickup_method.prefixed_id }, as: :json++ expect(response).to have_http_status(:ok)+ names = json_response['data'].map { |row| row['name'] }+ expect(names).to include('Downtown')+ expect(names).not_to include('Warehouse')+ end++ context 'with a cart' do+ let(:cart) { create(:cart_with_line_items, store: store, customer: user) }+ let(:variant) { cart.line_items.first.variant }++ it 'keeps locations that can fulfill the whole cart from local stock' do+ pickup_location.stock_item_or_create(variant).set_count_on_hand(10)++ get :pickup_locations, params: { id: pickup_method.prefixed_id, cart_id: cart.prefixed_id }, as: :json++ expect(json_response['data'].map { |row| row['name'] }).to include('Downtown')+ end++ it 'drops locations without local stock for the cart' do+ pickup_location.stock_item_or_create(variant).set_count_on_hand(0)++ get :pickup_locations, params: { id: pickup_method.prefixed_id, cart_id: cart.prefixed_id }, as: :json++ expect(json_response['data'].map { |row| row['name'] }).not_to include('Downtown')+ end+ end+ end++ describe 'GET #pickup_points' do+ it 'returns 404 when the method has no pickup point provider' do+ get :pickup_points, params: { id: pickup_method.prefixed_id, latitude: 52.2, longitude: 21.0 }, as: :json++ expect(response).to have_http_status(:not_found)+ end++ context 'with a provider configured' do+ before do+ test_provider = Class.new(Spree::PickupPointProvider::Base) do+ def find_nearby(latitude:, longitude:, limit: 20)+ [Spree::PickupPointOption.new(external_id: 'LOCKER1', name: 'Locker One', city: 'Warsaw', provider: 'test')]+ end++ def find_by_external_id(external_id)+ return unless external_id == 'LOCKER1'++ Spree::PickupPointOption.new(external_id: 'LOCKER1', name: 'Locker One', city: 'Warsaw', provider: 'test')+ end+ end+ stub_const('TestPickupPointProvider', test_provider)+ pickup_method.update!(fulfillment_type: 'pickup_point', pickup_point_provider: 'TestPickupPointProvider')+ end++ it 'returns nearby points' do+ get :pickup_points, params: { id: pickup_method.prefixed_id, latitude: 52.2, longitude: 21.0 }, as: :json++ expect(response).to have_http_status(:ok)+ expect(json_response['data'].first['external_id']).to eq('LOCKER1')+ expect(json_response['data'].first['name']).to eq('Locker One')+ end++ it 'requires coordinates' do+ get :pickup_points, params: { id: pickup_method.prefixed_id }, as: :json++ expect(response).to have_http_status(:bad_request)+ end+ end+ end+enddiff --git a/spree/api/spec/controllers/spree/api/v3/store/markets_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/markets_controller_spec.rbindex 8a3bd782db..96ba1afdcd 100644--- a/spree/api/spec/controllers/spree/api/v3/store/markets_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/store/markets_controller_spec.rb@@ -9,7 +9,13 @@ RSpec.describe Spree::Api::V3::Store::MarketsController, type: :controller dolet!(:germany) { Spree::Country.find_by(iso: 'DE') || create(:country, iso: 'DE', name: 'Germany') }let!(:france) { Spree::Country.find_by(iso: 'FR') || create(:country, iso: 'FR', name: 'France') }- let!(:na_market) { create(:market, :default, name: 'North America', store: store, countries: [usa], currency: 'USD', default_locale: 'en', supported_locales: 'en,es') }+ # The store's bootstrap market already owns the US country — reshape it+ # into the North America fixture instead of colliding with it.+ let!(:na_market) do+ store.default_market.tap do |market|+ market.update!(name: 'North America', currency: 'USD', default_locale: 'en', supported_locales: 'en,es')+ end+ endlet!(:eu_market) { create(:market, name: 'Europe', store: store, countries: [germany, france], currency: 'EUR', default_locale: 'de', supported_locales: 'de,en,fr', tax_inclusive: true) }before dodiff --git a/spree/api/spec/integration/spree/api/v3/admin/delivery_settings_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/delivery_settings_spec.rbnew file mode 100644index 0000000000..b5ee99fdea--- /dev/null+++ b/spree/api/spec/integration/spree/api/v3/admin/delivery_settings_spec.rb@@ -0,0 +1,164 @@+# frozen_string_literal: true++require 'swagger_helper'++RSpec.describe 'Admin Delivery Settings API', type: :request, swagger_doc: 'api-reference/admin.yaml' do+ include_context 'API v3 Admin'++ let(:Authorization) { "Bearer #{admin_jwt_token}" }+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }++ path '/api/v3/admin/delivery_methods' do+ get 'List delivery methods' do+ tags 'Delivery'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Returns all delivery methods with calculator and zone configuration.'+ admin_scope :read, :settings++ admin_sdk_example 'delivery-methods/list'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true++ response '200', 'delivery methods found' do+ before { create(:shipping_method, name: 'UPS Ground') }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].map { |row| row['name'] }).to include('UPS Ground')+ end+ end+ end++ post 'Create delivery method' do+ tags 'Delivery'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Creates a delivery method. fulfillment_type is one of shipping, digital, pickup, pickup_point.'+ admin_scope :write, :settings++ admin_sdk_example 'delivery-methods/create'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ name: { type: :string, example: 'Express' },+ admin_name: { type: :string, nullable: true },+ code: { type: :string, nullable: true },+ fulfillment_type: { type: :string, enum: %w[shipping digital pickup pickup_point], example: 'shipping' },+ storefront_visible: { type: :boolean, example: true },+ tracking_url: { type: :string, nullable: true },+ estimated_transit_business_days_min: { type: :integer, nullable: true },+ estimated_transit_business_days_max: { type: :integer, nullable: true },+ tax_category_id: { type: :string, nullable: true },+ calculator_type: { type: :string, example: 'Spree::Calculator::Shipping::FlatRate' },+ calculator_preferences: { type: :object, example: { amount: 12.5 } },+ delivery_zone_ids: { type: :array, items: { type: :string } }+ },+ required: %w[name]+ }++ response '201', 'delivery method created' do+ let(:body) do+ {+ name: 'Express',+ fulfillment_type: 'shipping',+ storefront_visible: true,+ calculator_type: 'Spree::Calculator::Shipping::FlatRate',+ calculator_preferences: { amount: 12.5 }+ }+ end++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['name']).to eq('Express')+ expect(data['calculator_type']).to eq('Spree::Calculator::Shipping::FlatRate')+ end+ end+ end+ end++ path '/api/v3/admin/delivery_methods/calculators' do+ get 'List delivery calculators' do+ tags 'Delivery'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Registered delivery calculator classes with preference schemas for building configuration forms.'+ admin_scope :write, :settings++ admin_sdk_example 'delivery-methods/calculators'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true++ response '200', 'calculators found' do+ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].map { |row| row['type'] }).to include('Spree::Calculator::Shipping::FlatRate')+ end+ end+ end+ end++ path '/api/v3/admin/delivery_zones' do+ post 'Create delivery zone' do+ tags 'Delivery'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Creates a delivery zone with typed members: country, state, or postal_code (prefix or from/to range).'+ admin_scope :write, :settings++ admin_sdk_example 'delivery-zones/create'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ name: { type: :string, example: 'US North-East' },+ description: { type: :string, nullable: true },+ members: {+ type: :array,+ items: {+ type: :object,+ properties: {+ member_type: { type: :string, enum: %w[country state postal_code] },+ country_iso: { type: :string, nullable: true, example: 'US' },+ state_abbr: { type: :string, nullable: true },+ postal_code_prefix: { type: :string, nullable: true },+ postal_code_from: { type: :string, nullable: true },+ postal_code_to: { type: :string, nullable: true }+ },+ required: %w[member_type]+ }+ }+ },+ required: %w[name]+ }++ response '201', 'delivery zone created' do+ before { Spree::Country.find_by(iso: 'US') || create(:country_us) }++ let(:body) do+ {+ name: 'US North-East',+ members: [+ { member_type: 'country', country_iso: 'US' },+ { member_type: 'postal_code', country_iso: 'US', postal_code_prefix: '10' }+ ]+ }+ end++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['members'].length).to eq(2)+ end+ end+ end+ end+enddiff --git a/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rbindex 826656ced5..1b87aba985 100644--- a/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/admin/markets_spec.rb@@ -258,7 +258,7 @@ RSpec.describe 'Admin Markets API', type: :request, swagger_doc: 'api-reference/response '422', 'cannot delete default or last market' dolet(:'x-spree-api-key') { secret_api_key.plaintext_token }- let(:id) { market.prefixed_id }+ let(:id) { store.default_market.prefixed_id }schema '$ref' => '#/components/schemas/ErrorResponse'diff --git a/spree/api/spec/integration/spree/api/v3/admin/order_adjustment_lines_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/order_adjustment_lines_spec.rbnew file mode 100644index 0000000000..b3b623287f--- /dev/null+++ b/spree/api/spec/integration/spree/api/v3/admin/order_adjustment_lines_spec.rb@@ -0,0 +1,141 @@+# frozen_string_literal: true++require 'swagger_helper'++RSpec.describe 'Admin Order Adjustment Lines API', type: :request, swagger_doc: 'api-reference/admin.yaml' do+ include_context 'API v3 Admin'++ let!(:order) { create(:completed_order_with_totals, store: store) }+ let(:line_item) { order.line_items.first }+ let(:order_id) { order.prefixed_id }+ let(:Authorization) { "Bearer #{admin_jwt_token}" }+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }++ path '/api/v3/admin/orders/{order_id}/tax_lines' do+ get 'List tax lines' do+ tags 'Orders'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Typed tax rows on the order. Read-only — written exclusively by the tax provider.'+ admin_scope :read, :orders++ admin_sdk_example 'orders/tax-lines-list'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :order_id, in: :path, type: :string, required: true, description: 'Order prefixed ID'++ response '200', 'tax lines found' do+ before { create(:tax_line, order: order, line_item: line_item, amount: 1.5, rate: 0.15, label: 'VAT 15%') }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].first['label']).to eq('VAT 15%')+ end+ end+ end+ end++ path '/api/v3/admin/orders/{order_id}/discounts' do+ get 'List discounts' do+ tags 'Orders'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Typed discount rows (promotion-sourced and manual) on the order.'+ admin_scope :read, :orders++ admin_sdk_example 'orders/discounts-list'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :order_id, in: :path, type: :string, required: true, description: 'Order prefixed ID'++ response '200', 'discounts found' do+ before { create(:discount, order: order, line_item: line_item, amount: -2, label: 'Loyalty', kind: 'manual') }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].first['kind']).to eq('manual')+ end+ end+ end++ post 'Create manual discount' do+ tags 'Orders'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Creates a manual discount. With line_item_id a single row is created; without it the amount is distributed across line items (largest remainder). This is the sanctioned post-placement discount path and works on completed orders.'+ admin_scope :write, :orders++ admin_sdk_example 'orders/discounts-create'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :order_id, in: :path, type: :string, required: true, description: 'Order prefixed ID'+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ label: { type: :string, example: 'Customer appeasement' },+ value: { type: :number, example: 10 },+ value_type: { type: :string, enum: %w[flat percent], example: 'flat' },+ line_item_id: { type: :string, nullable: true, example: 'item_abc123', description: 'Target line item; omit to distribute order-level' }+ },+ required: %w[label value]+ }++ response '201', 'discount created' do+ let(:body) { { label: 'Appeasement', value: 3, value_type: 'flat', line_item_id: line_item.prefixed_id } }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].first['amount']).to eq('-3.0')+ end+ end++ response '422', 'invalid discount' do+ let(:body) { { label: 'Bad', value: -1 } }++ run_test!+ end+ end+ end++ path '/api/v3/admin/orders/{order_id}/fees' do+ post 'Create fee' do+ tags 'Orders'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Creates a fee (surcharge, handling, gift wrap, COD). Order-level when no target is given. Works on completed orders.'+ admin_scope :write, :orders++ admin_sdk_example 'orders/fees-create'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :Authorization, in: :header, type: :string, required: true+ parameter name: :order_id, in: :path, type: :string, required: true, description: 'Order prefixed ID'+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ label: { type: :string, example: 'Gift wrap' },+ amount: { type: :number, example: 4 },+ kind: { type: :string, example: 'gift_wrap', description: "Defaults to 'surcharge'" },+ line_item_id: { type: :string, nullable: true },+ fulfillment_id: { type: :string, nullable: true }+ },+ required: %w[label amount]+ }++ response '201', 'fee created' do+ let(:body) { { label: 'Gift wrap', amount: 4, kind: 'gift_wrap' } }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['label']).to eq('Gift wrap')+ expect(data['amount']).to eq('4.0')+ end+ end+ end+ end+enddiff --git a/spree/api/spec/integration/spree/api/v3/admin/promotion_actions_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/promotion_actions_spec.rbindex 780f8b36f3..c13b2f0b6f 100644--- a/spree/api/spec/integration/spree/api/v3/admin/promotion_actions_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/admin/promotion_actions_spec.rb@@ -27,7 +27,7 @@ RSpec.describe 'Admin Promotion Actions API', type: :request, swagger_doc: 'api-let(:'x-spree-api-key') { secret_api_key.plaintext_token }before do- Spree::PromotionActions::FreeShipping.create!(promotion: promotion)+ Spree::Promotion::Actions::FreeShipping.create!(promotion: promotion)endrun_test! do |response|@@ -44,7 +44,7 @@ RSpec.describe 'Admin Promotion Actions API', type: :request, swagger_doc: 'api-produces 'application/json'consumes 'application/json'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_discounts`). Fully-qualified Ruby class names are also accepted for backward compatibility.'+ 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.'admin_scope :write, :promotionsadmin_sdk_example 'promotion-actions/create'@@ -86,7 +86,7 @@ RSpec.describe 'Admin Promotion Actions API', type: :request, swagger_doc: 'api-parameter name: :promotion_id, in: :path, type: :string, required: trueparameter name: :id, in: :path, type: :string, required: true- let(:action) { Spree::PromotionActions::FreeShipping.create!(promotion: promotion) }+ let(:action) { Spree::Promotion::Actions::FreeShipping.create!(promotion: promotion) }let(:id) { action.prefixed_id }delete 'Delete an action from a promotion' dodiff --git a/spree/api/spec/integration/spree/api/v3/admin/promotion_rules_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/promotion_rules_spec.rbindex 66b4af6a14..84cc78022d 100644--- a/spree/api/spec/integration/spree/api/v3/admin/promotion_rules_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/admin/promotion_rules_spec.rb@@ -27,7 +27,7 @@ RSpec.describe 'Admin Promotion Rules API', type: :request, swagger_doc: 'api-relet(:'x-spree-api-key') { secret_api_key.plaintext_token }before do- Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD')+ Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD')endrun_test! do |response|@@ -86,7 +86,7 @@ RSpec.describe 'Admin Promotion Rules API', type: :request, swagger_doc: 'api-reparameter name: :promotion_id, in: :path, type: :string, required: trueparameter name: :id, in: :path, type: :string, required: true- let(:rule) { Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD') }+ let(:rule) { Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD') }let(:id) { rule.prefixed_id }patch 'Update a rule\'s preferences' dodiff --git a/spree/api/spec/integration/spree/api/v3/admin/promotions_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/promotions_spec.rbindex ee097bfe01..14c21f5244 100644--- a/spree/api/spec/integration/spree/api/v3/admin/promotions_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/admin/promotions_spec.rb@@ -137,7 +137,7 @@ RSpec.describe 'Admin Promotions API', type: :request, swagger_doc: 'api-referen],actions: [{- type: 'create_item_discounts',+ type: 'create_item_adjustments',calculator: {type: 'percent_on_line_item',preferences: { percent: 25 }@@ -153,19 +153,19 @@ RSpec.describe 'Admin Promotions API', type: :request, swagger_doc: 'api-referenpromotion = Spree::Promotion.find_by_prefix_id(data['id'])expect(promotion.rules.map(&:class)).to contain_exactly(- Spree::PromotionRules::Currency,- Spree::PromotionRules::ItemTotal,- Spree::PromotionRules::Product+ Spree::Promotion::Rules::Currency,+ Spree::Promotion::Rules::ItemTotal,+ Spree::Promotion::Rules::Product)expect(promotion.actions.map(&:class)).to contain_exactly(- Spree::PromotionActions::CreateItemDiscounts,- Spree::PromotionActions::FreeShipping+ Spree::Promotion::Actions::CreateItemAdjustments,+ Spree::Promotion::Actions::FreeShipping)- product_rule = promotion.rules.find { |r| r.is_a?(Spree::PromotionRules::Product) }+ product_rule = promotion.rules.find { |r| r.is_a?(Spree::Promotion::Rules::Product) }expect(product_rule.product_ids).to contain_exactly(product_a.id, product_b.id)- adjustment_action = promotion.actions.find { |a| a.is_a?(Spree::PromotionActions::CreateItemDiscounts) }+ adjustment_action = promotion.actions.find { |a| a.is_a?(Spree::Promotion::Actions::CreateItemAdjustments) }expect(adjustment_action.calculator).to be_a(Spree::Calculator::PercentOnLineItem)expect(adjustment_action.calculator.preferred_percent).to eq(25)end@@ -284,13 +284,13 @@ RSpec.describe 'Admin Promotions API', type: :request, swagger_doc: 'api-referenresponse '200', 'rules and actions reconciled to desired set' dolet(:'x-spree-api-key') { secret_api_key.plaintext_token }let!(:existing_rule) do- Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD')+ Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD')endlet!(:existing_action) docalc = Spree::Calculator::FlatRate.new(preferred_amount: 10)- Spree::PromotionActions::CreateItemDiscounts.create!(promotion: promotion, calculator: calc)+ Spree::Promotion::Actions::CreateItemAdjustments.create!(promotion: promotion, calculator: calc)end- let!(:dropped_rule) { Spree::PromotionRules::FirstOrder.create!(promotion: promotion) }+ let!(:dropped_rule) { Spree::Promotion::Rules::FirstOrder.create!(promotion: promotion) }let(:body) do{@@ -313,7 +313,7 @@ RSpec.describe 'Admin Promotions API', type: :request, swagger_doc: 'api-referen# Swap calculator type on existing action{id: existing_action.prefixed_id,- type: 'create_item_discounts',+ type: 'create_item_adjustments',calculator: {type: 'percent_on_line_item',preferences: { percent: 15 }@@ -329,8 +329,8 @@ RSpec.describe 'Admin Promotions API', type: :request, swagger_doc: 'api-referen# Existing currency rule was updated, FirstOrder dropped, ItemTotal addedexpect(promotion.rules.map(&:class)).to contain_exactly(- Spree::PromotionRules::Currency,- Spree::PromotionRules::ItemTotal+ Spree::Promotion::Rules::Currency,+ Spree::Promotion::Rules::ItemTotal)expect(existing_rule.reload.preferred_currency).to eq('EUR')expect(Spree::PromotionRule.where(id: dropped_rule.id)).to be_empty@@ -345,7 +345,7 @@ RSpec.describe 'Admin Promotions API', type: :request, swagger_doc: 'api-referenresponse '200', 'rules and actions cleared with empty arrays' dolet(:'x-spree-api-key') { secret_api_key.plaintext_token }let!(:rule_to_drop) do- Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD')+ Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD')endlet(:body) { { rules: [], actions: [] } }diff --git a/spree/api/spec/integration/spree/api/v3/store/countries_spec.rb b/spree/api/spec/integration/spree/api/v3/store/countries_spec.rbindex ffdfec2c95..ecb4f3ec96 100644--- a/spree/api/spec/integration/spree/api/v3/store/countries_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/countries_spec.rb@@ -10,7 +10,11 @@ RSpec.describe 'Countries API', type: :request, swagger_doc: 'api-reference/storlet!(:new_york) { Spree::State.find_by(abbr: 'NY', country: usa) || create(:state, country: usa, name: 'New York', abbr: 'NY') }let!(:germany) { Spree::Country.find_by(iso: 'DE') || create(:country, iso: 'DE', name: 'Germany', states_required: false) }- let!(:na_market) { create(:market, :default, name: 'North America', store: store, countries: [usa], currency: 'USD', default_locale: 'en', supported_locales: 'en,es') }+ let!(:na_market) do+ store.default_market.tap do |market|+ market.update!(name: 'North America', currency: 'USD', default_locale: 'en', supported_locales: 'en,es')+ end+ endlet!(:eu_market) { create(:market, name: 'Europe', store: store, countries: [germany], currency: 'EUR', default_locale: 'de', supported_locales: 'de,en') }path '/api/v3/store/countries' dodiff --git a/spree/api/spec/integration/spree/api/v3/store/currencies_spec.rb b/spree/api/spec/integration/spree/api/v3/store/currencies_spec.rbindex cd88a63d25..f03fc858b4 100644--- a/spree/api/spec/integration/spree/api/v3/store/currencies_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/currencies_spec.rb@@ -8,7 +8,11 @@ RSpec.describe 'Currencies API', type: :request, swagger_doc: 'api-reference/stolet!(:usa) { Spree::Country.find_by(iso: 'US') || create(:country, iso: 'US', name: 'United States') }let!(:germany) { Spree::Country.find_by(iso: 'DE') || create(:country, iso: 'DE', name: 'Germany') }- let!(:na_market) { create(:market, :default, name: 'North America', store: store, countries: [usa], currency: 'USD', default_locale: 'en') }+ let!(:na_market) do+ store.default_market.tap do |market|+ market.update!(name: 'North America', currency: 'USD', default_locale: 'en')+ end+ endlet!(:eu_market) { create(:market, name: 'Europe', store: store, countries: [germany], currency: 'EUR', default_locale: 'de') }path '/api/v3/store/currencies' dodiff --git a/spree/api/spec/integration/spree/api/v3/store/delivery_methods_spec.rb b/spree/api/spec/integration/spree/api/v3/store/delivery_methods_spec.rbnew file mode 100644index 0000000000..a4bca6590b--- /dev/null+++ b/spree/api/spec/integration/spree/api/v3/store/delivery_methods_spec.rb@@ -0,0 +1,67 @@+# frozen_string_literal: true++require 'swagger_helper'++RSpec.describe 'Store Delivery Methods API', type: :request, swagger_doc: 'api-reference/store.yaml' do+ include_context 'API v3 Store'++ let(:'x-spree-api-key') { api_key.token }++ path '/api/v3/store/delivery_methods' do+ get 'List delivery methods' do+ tags 'Delivery'+ produces 'application/json'+ security [api_key: []]+ description 'Storefront-visible delivery methods. Filter by fulfillment_type to discover pickup options.'++ sdk_example 'delivery-methods/list'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :fulfillment_type, in: :query, type: :string, required: false,+ description: 'Filter: shipping, digital, pickup, pickup_point'++ response '200', 'delivery methods found' do+ before do+ create(:shipping_method, name: 'Standard')+ create(:shipping_method, name: 'Store pickup').update!(fulfillment_type: 'pickup')+ end++ let(:fulfillment_type) { 'pickup' }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].map { |row| row['name'] }).to eq(['Store pickup'])+ end+ end+ end+ end++ path '/api/v3/store/delivery_methods/{id}/pickup_locations' do+ get 'List pickup locations' do+ tags 'Delivery'+ produces 'application/json'+ security [api_key: []]+ description 'Pickup-enabled stock locations for a pickup delivery method. Pass cart_id to keep only locations that can fulfill the whole cart from local stock.'++ sdk_example 'delivery-methods/pickup-locations'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: :id, in: :path, type: :string, required: true, description: 'Delivery method prefixed ID'+ parameter name: :cart_id, in: :query, type: :string, required: false, description: 'Cart prefixed ID for availability filtering'++ response '200', 'pickup locations found' do+ let(:pickup_method) do+ create(:shipping_method, name: 'Store pickup').tap { |dm| dm.update!(fulfillment_type: 'pickup') }+ end+ let(:id) { pickup_method.prefixed_id }++ before { create(:stock_location, name: 'Downtown', pickup_enabled: true) }++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['data'].map { |row| row['name'] }).to include('Downtown')+ end+ end+ end+ end+enddiff --git a/spree/api/spec/integration/spree/api/v3/store/locales_spec.rb b/spree/api/spec/integration/spree/api/v3/store/locales_spec.rbindex cef0c51eab..f3a9c56b24 100644--- a/spree/api/spec/integration/spree/api/v3/store/locales_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/locales_spec.rb@@ -8,7 +8,11 @@ RSpec.describe 'Locales API', type: :request, swagger_doc: 'api-reference/store.let!(:usa) { Spree::Country.find_by(iso: 'US') || create(:country, iso: 'US', name: 'United States') }let!(:germany) { Spree::Country.find_by(iso: 'DE') || create(:country, iso: 'DE', name: 'Germany') }- let!(:na_market) { create(:market, :default, name: 'North America', store: store, countries: [usa], currency: 'USD', default_locale: 'en') }+ let!(:na_market) do+ store.default_market.tap do |market|+ market.update!(name: 'North America', currency: 'USD', default_locale: 'en')+ end+ endlet!(:eu_market) { create(:market, name: 'Europe', store: store, countries: [germany], currency: 'EUR', default_locale: 'de') }path '/api/v3/store/locales' dodiff --git a/spree/api/spec/integration/spree/api/v3/store/markets_spec.rb b/spree/api/spec/integration/spree/api/v3/store/markets_spec.rbindex 177502c984..a1c72eb3d5 100644--- a/spree/api/spec/integration/spree/api/v3/store/markets_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/markets_spec.rb@@ -10,7 +10,11 @@ RSpec.describe 'Markets API', type: :request, swagger_doc: 'api-reference/store.let!(:germany) { Spree::Country.find_by(iso: 'DE') || create(:country, iso: 'DE', name: 'Germany', states_required: false) }let!(:france) { Spree::Country.find_by(iso: 'FR') || create(:country, iso: 'FR', name: 'France', states_required: false) }- let!(:na_market) { create(:market, :default, name: 'North America', store: store, countries: [usa], currency: 'USD', default_locale: 'en', supported_locales: 'en,es') }+ let!(:na_market) do+ store.default_market.tap do |market|+ market.update!(name: 'North America', currency: 'USD', default_locale: 'en', supported_locales: 'en,es')+ end+ endlet!(:eu_market) { create(:market, name: 'Europe', store: store, countries: [germany, france], currency: 'EUR', default_locale: 'de', supported_locales: 'de,en,fr', tax_inclusive: true) }path '/api/v3/store/markets' dodiff --git a/spree/api/spec/serializers/spree/api/v3/admin/promotion_action_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/admin/promotion_action_serializer_spec.rbindex b6731ad660..46ad58ce82 100644--- a/spree/api/spec/serializers/spree/api/v3/admin/promotion_action_serializer_spec.rb+++ b/spree/api/spec/serializers/spree/api/v3/admin/promotion_action_serializer_spec.rb@@ -13,7 +13,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionActionSerializer do# of the example so the masking behaviour can be asserted without# needing a full new STI subclass + registry registration.let(:action) do- action = Spree::PromotionActions::FreeShipping.create!(promotion: promotion)+ action = Spree::Promotion::Actions::FreeShipping.create!(promotion: promotion)action.preferences[:api_secret] = 'sk_action_super_secret_value'action.preferences[:webhook_url] = 'https://example.com/hook'@@ -42,7 +42,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionActionSerializer dodescribe 'nested calculator preferences masking' dolet(:action) do- Spree::PromotionActions::CreateAdjustment.create!(+ Spree::Promotion::Actions::CreateAdjustment.create!(promotion: promotion,calculator: Spree::Calculator::FlatRate.new(preferred_amount: 5))diff --git a/spree/api/spec/serializers/spree/api/v3/admin/promotion_rule_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/admin/promotion_rule_serializer_spec.rbindex 8be6742fb0..500a8f64e4 100644--- a/spree/api/spec/serializers/spree/api/v3/admin/promotion_rule_serializer_spec.rb+++ b/spree/api/spec/serializers/spree/api/v3/admin/promotion_rule_serializer_spec.rb@@ -13,7 +13,7 @@ RSpec.describe Spree::Api::V3::Admin::PromotionRuleSerializer do# into its schema for the duration of the example so the masking# path can be asserted without a full new STI subclass.let(:rule) do- rule = Spree::PromotionRules::Currency.create!(promotion: promotion, preferred_currency: 'USD')+ rule = Spree::Promotion::Rules::Currency.create!(promotion: promotion, preferred_currency: 'USD')rule.preferences[:api_secret] = 'sk_rule_super_secret_value'stubbed_schema = [diff --git a/spree/api/spec/serializers/spree/api/v3/price_gating_spec.rb b/spree/api/spec/serializers/spree/api/v3/price_gating_spec.rbindex 9ef0ac0663..4602db6731 100644--- a/spree/api/spec/serializers/spree/api/v3/price_gating_spec.rb+++ b/spree/api/spec/serializers/spree/api/v3/price_gating_spec.rb@@ -111,15 +111,36 @@ RSpec.describe 'v3 Store serializer price gating' doendend- describe Spree::Api::V3::DiscountSerializer do- # The record is a lightweight applied-discount presenter responding to the- # money methods; a struct keeps the gating assertion factory-free.- let(:discount) do+ describe Spree::Api::V3::AppliedPromotionSerializer do+ # The record is a lightweight applied-promotion presenter responding to+ # the money methods; a struct keeps the gating assertion factory-free.+ let(:applied_promotion) doStruct.new(:name, :description, :code, :amount, :display_amount, :promotion, keyword_init: true).new(name: 'Promo', description: nil, code: 'SAVE10', amount: '5.0', display_amount: '$5.00', promotion: nil)end+ it 'nulls the amount for gated guests' do+ hash = serialize(described_class, applied_promotion, hide: true)++ expect(hash['amount']).to be_nil+ expect(hash['display_amount']).to be_nil+ end++ it 'serializes the amount when not gated' do+ expect(serialize(described_class, applied_promotion, hide: false)['amount']).to be_present+ end+ end++ describe Spree::Api::V3::DiscountSerializer do+ let(:discount) do+ Struct.new(:label, :kind, :code, :value, :value_type, :amount, :display_amount,+ :promotion, :line_item, :fulfillment, keyword_init: true).new(+ label: 'Promo', kind: 'promotion', code: 'SAVE10', value: '10.0', value_type: 'flat',+ amount: '-5.0', display_amount: '-$5.00', promotion: nil, line_item: nil, fulfillment: nil+ )+ end+it 'nulls the amount for gated guests' dohash = serialize(described_class, discount, hide: true)diff --git a/spree/core/app/helpers/spree/fulfillment_helper.rb b/spree/core/app/helpers/spree/fulfillment_helper.rbnew file mode 100644index 0000000000..3fe9fcef5c--- /dev/null+++ b/spree/core/app/helpers/spree/fulfillment_helper.rb@@ -0,0 +1,12 @@+module Spree+ module FulfillmentHelper+ def fulfillment_tracking_link_to(fulfillment:, name: nil, html_options: {})+ tracking_url = fulfillment.tracking_url.presence+ return '' unless tracking_url++ display_text = name || fulfillment.tracking.presence || tracking_url++ link_to display_text, tracking_url, html_options+ end+ end+enddiff --git a/spree/core/app/helpers/spree/shipment_helper.rb b/spree/core/app/helpers/spree/shipment_helper.rbindex 672e1e7959..c5cdc9d2e9 100644--- a/spree/core/app/helpers/spree/shipment_helper.rb+++ b/spree/core/app/helpers/spree/shipment_helper.rb@@ -1,12 +1,11 @@module Spree+ # Deprecated: use Spree::FulfillmentHelper. Removed in Spree 6.1.module ShipmentHelper- def shipment_tracking_link_to(shipment:, name: nil, html_options: {})- tracking_url = shipment.tracking_url.presence- return '' unless tracking_url-- display_text = name || shipment.tracking.presence || tracking_url+ include Spree::FulfillmentHelper- link_to display_text, tracking_url, html_options+ def shipment_tracking_link_to(shipment:, name: nil, html_options: {})+ Spree::Deprecation.warn('shipment_tracking_link_to is deprecated and will be removed in Spree 6.1. Use fulfillment_tracking_link_to instead.')+ fulfillment_tracking_link_to(fulfillment: shipment, name: name, html_options: html_options)endendenddiff --git a/spree/core/app/models/concerns/spree/stores/markets.rb b/spree/core/app/models/concerns/spree/stores/markets.rbindex 3cc02772df..bed494b8b2 100644--- a/spree/core/app/models/concerns/spree/stores/markets.rb+++ b/spree/core/app/models/concerns/spree/stores/markets.rb@@ -8,6 +8,7 @@ module Spreehas_one :default_market, -> { default }, class_name: 'Spree::Market'after_create :ensure_default_market+ after_update :sync_default_market_settingsend# Returns the default country, derived from the default market@@ -82,24 +83,26 @@ module Spree# Returns supported currencies derived from markets, falling back to store attributes# @return [Array<Money::Currency>]def supported_currencies_list- @supported_currencies_list ||= if has_markets?- markets.pluck(:currency).uniq.map do |code|- ::Money::Currency.find(code)- end.compact.sort_by { |c| c.iso_code == default_currency ? 0 : 1 }- else- legacy_supported_currencies_list- end+ # Union of market currencies and the legacy store column — column+ # configuration stays honored until it is explicitly migrated onto+ # markets (every store owns at least a bootstrap market in 6.0).+ @supported_currencies_list ||= begin+ market_codes = has_markets? ? markets.pluck(:currency) : []+ legacy_codes = legacy_supported_currencies_list.map(&:iso_code)+ (market_codes + legacy_codes).uniq.filter_map { |code| ::Money::Currency.find(code) }.+ sort_by { |currency| currency.iso_code == default_currency ? 0 : 1 }+ endend# Supported locale codes derived from markets, falling back to store# attributes.# @return [Array<String>]def supported_locales_list- @supported_locales_list ||= if has_markets?- (markets.flat_map(&:supported_locales_list) << default_locale).compact.uniq.sort- else- legacy_supported_locales_list- end+ # Same union semantics as +supported_currencies_list+.+ @supported_locales_list ||= begin+ market_locales = has_markets? ? markets.flat_map(&:supported_locales_list) : []+ (market_locales + legacy_supported_locales_list + [default_locale]).compact.uniq.sort+ endend# Supported locales as rich Spree::Locale objects (name, default?, rtl?).@@ -117,25 +120,75 @@ module Spreeprivate+ # Every store owns a default market — Cart and Order require one.+ # Resolution order: the country given at creation, the legacy+ # default_country column, then US (created if the countries table is+ # empty, e.g. bare test databases).def ensure_default_marketreturn if markets.exists?- country = @default_country_for_market- return if country.blank?+ country = @default_country_for_market ||+ Spree::Country.find_by(id: read_attribute(:default_country_id)) ||+ Spree::Country.by_iso('US') ||+ create_fallback_countryiso_country = ISO3166::Country[country.iso]Spree::Events.disable domarkets.create!(name: country.name,- currency: iso_country&.currency_code || read_attribute(:default_currency) || 'USD',- default_locale: iso_country&.languages_official&.first || read_attribute(:default_locale) || 'en',+ currency: read_attribute(:default_currency) || iso_country&.currency_code || 'USD',+ default_locale: read_attribute(:default_locale) || iso_country&.languages_official&.first || 'en',+ supported_locales: read_attribute(:supported_locales),default: true,+ bootstrap_default: true,countries: [country])endend+ # Store-level locale/currency edits keep steering the storefront: the+ # legacy columns stay writable and propagate onto the default market+ # (which is what readers delegate to).+ # Diffs against the market rather than dirty-tracking — long-lived store+ # instances (spec globals, app singletons) can carry stale change state.+ def sync_default_market_settings+ association(:default_market).reset+ market = default_market+ return if market.blank?++ updates = {}+ new_locale = read_attribute(:default_locale)+ new_currency = read_attribute(:default_currency)+ updates[:default_locale] = new_locale if new_locale.present? && market.default_locale != new_locale+ updates[:currency] = new_currency if new_currency.present? && market.currency != new_currency+ return if updates.empty?++ market.update_columns(updates.merge(updated_at: Time.current))+ association(:default_market).reset+ clear_market_derived_memoization+ end++ def clear_market_derived_memoization+ @supported_currencies_list = nil+ @supported_locales_list = nil+ @supported_locales = nil+ @has_markets = nil+ end++ def create_fallback_country+ iso_country = ISO3166::Country['US']+ Spree::Country.create!(+ iso_name: iso_country.local_name.upcase,+ iso: iso_country.alpha2,+ iso3: iso_country.alpha3,+ name: iso_country.local_name,+ numcode: iso_country.number,+ states_required: false,+ zipcode_required: true+ )+ end+def legacy_supported_currencies_list([default_currency] + read_attribute(:supported_currencies).to_s.split(',')).uniq.map(&:to_s).map do |code|::Money::Currency.find(code.strip)diff --git a/spree/core/app/models/spree/adjusters/largest_remainder.rb b/spree/core/app/models/spree/adjusters/largest_remainder.rbnew file mode 100644index 0000000000..84d6cf777d--- /dev/null+++ b/spree/core/app/models/spree/adjusters/largest_remainder.rb@@ -0,0 +1,24 @@+module Spree+ module Adjusters+ # Largest-remainder apportionment of an integer cent total across weights.+ # Shared by promotion order-level distribution and manual admin discounts+ # so both split identically (sum of shares always equals the total).+ module LargestRemainder+ module_function++ # @param total_cents [Integer]+ # @param weights [Array<Numeric>] proportional bases (sum must be > 0)+ # @return [Array<Integer>] per-weight shares in cents, summing to total_cents+ def largest_remainder_shares(total_cents, weights)+ weights_sum = weights.sum+ raw = weights.map { |weight| Rational(total_cents) * Rational(weight) / Rational(weights_sum) }+ shares = raw.map(&:floor)+ remainder = total_cents - shares.sum+ raw.each_with_index.sort_by { |value, index| [shares[index] - value, index] }.first(remainder).each do |_, index|+ shares[index] += 1+ end+ shares+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/adjusters/promotion.rb b/spree/core/app/models/spree/adjusters/promotion.rbindex 3d0b9bb8fd..99f76e1cca 100644--- a/spree/core/app/models/spree/adjusters/promotion.rb+++ b/spree/core/app/models/spree/adjusters/promotion.rb@@ -134,7 +134,7 @@ module Spreereturn if bases_sum <= 0total_cents = [chosen[:amount].abs, bases_sum].min * 100- shares = largest_remainder_shares(total_cents.round, bases)+ shares = Spree::Adjusters::LargestRemainder.largest_remainder_shares(total_cents.round, bases)line_items.each_with_index do |line_item, index|amount = -BigDecimal(shares[index]) / 100@@ -144,17 +144,6 @@ module Spreeendend- def largest_remainder_shares(total_cents, weights)- weights_sum = weights.sum- raw = weights.map { |weight| Rational(total_cents) * Rational(weight) / Rational(weights_sum) }- shares = raw.map(&:floor)- remainder = total_cents - shares.sum- raw.each_with_index.sort_by { |value, index| [shares[index] - value, index] }.first(remainder).each do |_, index|- shares[index] += 1- end- shares- end-# Combined discounts never push an adjustable's net below zero.def clamp(amount, base)[amount, -[base, BigDecimal(0)].max].maxdiff --git a/spree/core/app/models/spree/cart.rb b/spree/core/app/models/spree/cart.rbindex a48cd9b188..938a45805d 100644--- a/spree/core/app/models/spree/cart.rb+++ b/spree/core/app/models/spree/cart.rb@@ -49,12 +49,38 @@ module Spreealias_attribute :ship_total, :delivery_totalbelongs_to :store, class_name: 'Spree::Store'- belongs_to :market, class_name: 'Spree::Market', optional: true- belongs_to :channel, class_name: 'Spree::Channel', optional: true+ belongs_to :market, class_name: 'Spree::Market'+ belongs_to :channel, class_name: 'Spree::Channel'belongs_to :customer, class_name: "::#{Spree.user_class}", optional: truebelongs_to :ship_address, class_name: 'Spree::Address', optional: true, dependent: :destroybelongs_to :bill_address, class_name: 'Spree::Address', optional: true, dependent: :destroybelongs_to :gift_card, class_name: 'Spree::GiftCard', optional: true+ # Pickup location choice is a preference (mirrors the admin-user+ # preference of the same name), copied to the order column at completion.+ preference :stock_location_id, :integer, nullable: true+ alias_method :assign_stock_location_id_preference, :preferred_stock_location_id=++ # Accepts the public prefixed ID (+sloc_...+) or a raw ID; validates the+ # location is pickup-enabled so the storefront can only select real+ # pickup locations.+ def preferred_stock_location_id=(value)+ if value.blank?+ assign_stock_location_id_preference(nil)+ return+ end++ location = if Spree::PrefixedId.prefixed_id?(value)+ Spree::StockLocation.pickup_enabled.find_by_prefix_id!(value)+ else+ Spree::StockLocation.pickup_enabled.find(value)+ end+ assign_stock_location_id_preference(location.id)+ end++ # @return [Spree::StockLocation, nil]+ def preferred_stock_location+ Spree::StockLocation.find_by(id: preferred_stock_location_id)+ endalias_method :user, :customeralias_method :user=, :customer=@@ -99,7 +125,6 @@ module Spreebefore_validation :ensure_channel_presencevalidates :store, :currency, presence: true- validates :market, presence: true, if: -> { store&.markets&.exists? }validate :currency_must_be_supported_by_storescope :complete, -> { where.not(completed_at: nil) }diff --git a/spree/core/app/models/spree/delivery_method.rb b/spree/core/app/models/spree/delivery_method.rbindex c453f242c0..0a04d2007b 100644--- a/spree/core/app/models/spree/delivery_method.rb+++ b/spree/core/app/models/spree/delivery_method.rb@@ -33,7 +33,12 @@ module Spreebelongs_to :tax_category, -> { with_deleted }, class_name: 'Spree::TaxCategory', optional: true+ attribute :display_on, :string, default: 'both'attribute :fulfillment_type, :string, default: 'shipping'++ # Every method rates through a calculator; pickup/digital methods default+ # to free so API/dashboard creation doesn't have to send one.+ before_validation :ensure_calculator, on: :createattribute :fulfillment_provider, :string, default: 'Spree::FulfillmentProvider::Manual'scope :by_fulfillment_type, ->(type) { where(fulfillment_type: type) }@@ -91,6 +96,10 @@ module Spreefulfillment_type == 'pickup'end+ def ensure_calculator+ self.calculator ||= Spree::Calculator::Shipping::FlatRate.new(preferred_amount: 0)+ end+def pickup_point?fulfillment_type == 'pickup_point'end@@ -105,6 +114,13 @@ module Spree@provider ||= (fulfillment_provider.presence || 'Spree::FulfillmentProvider::Manual').constantize.newend+ # The third-party pickup point network behind a pickup_point method.+ #+ # @return [Spree::PickupPointProvider::Base, nil]+ def pickup_point_provider_instance+ @pickup_point_provider_instance ||= pickup_point_provider.presence&.constantize&.new+ end+def self.calculators# calculator registry key keeps its historical namespree_calculators.shipping_methods.diff --git a/spree/core/app/models/spree/market.rb b/spree/core/app/models/spree/market.rbindex 1f62bc0603..99c88f0842 100644--- a/spree/core/app/models/spree/market.rb+++ b/spree/core/app/models/spree/market.rb@@ -27,6 +27,11 @@ module Spree## Callbacks#+ # Set by Stores::Markets#ensure_default_market — the store-creation+ # bootstrap market skips the shipping-coverage check (no delivery setup+ # can exist for a store that is still being created).+ attr_accessor :bootstrap_default+before_save :ensure_single_defaultbefore_destroy :ensure_can_be_deleted@@ -131,9 +136,19 @@ module Spreereturn unless default? && default_changed?self.class.where(store_id: store_id, default: true).where.not(id: id).update_all(default: false)++ # The demotion happens via update_all — drop the owning store's cached+ # associations so same-instance reads see the new default immediately.+ if store && !store.destroyed?+ store.association(:default_market).reset+ store.association(:markets).reset if store.association_cached?(:markets)+ endenddef ensure_can_be_deleted+ # Cascading from the store's own destruction — the default/last-market+ # guards only protect live stores.+ return if destroyed_by_associationreturn if can_be_deleted?if default?diff --git a/spree/core/app/models/spree/market_country.rb b/spree/core/app/models/spree/market_country.rbindex 77b3ffa036..932adaf9f4 100644--- a/spree/core/app/models/spree/market_country.rb+++ b/spree/core/app/models/spree/market_country.rb@@ -17,6 +17,10 @@ module Spreestore = market.storereturn if store.blank?+ # Bootstrap: a store gets its default market during its own creation —+ # no delivery setup can constrain coverage for it yet.+ return if market.bootstrap_default+ return if Spree::DeliveryMethod.none?unless store.countries_with_shipping_coverage.exists?(id: country.id)errors.add(:country, :not_in_shipping_zone)diff --git a/spree/core/app/models/spree/order.rb b/spree/core/app/models/spree/order.rbindex f458a0ce6c..162b473229 100644--- a/spree/core/app/models/spree/order.rb+++ b/spree/core/app/models/spree/order.rb@@ -170,8 +170,8 @@ module Spreealias_attribute :shipping_address_id, :ship_address_idbelongs_to :store, class_name: 'Spree::Store'- belongs_to :market, class_name: 'Spree::Market', optional: true- belongs_to :channel, class_name: 'Spree::Channel', optional: true+ belongs_to :market, class_name: 'Spree::Market'+ belongs_to :channel, class_name: 'Spree::Channel'belongs_to :preferred_stock_location, class_name: 'Spree::StockLocation', optional: truewith_options dependent: :destroy do@@ -268,7 +268,6 @@ module Spreevalidates :delivery_total, MONEY_VALIDATIONvalidates :promo_total, NEGATIVE_MONEY_VALIDATIONvalidates :total, MONEY_VALIDATION- validates :market, presence: true, if: :store_has_markets?validate :currency_must_be_supported_by_storevalidate :locale_must_be_supported_by_store@@ -373,7 +372,7 @@ module Spreeend# Sum of the eligible promotion adjustments applied to the order itself- # (whole-order discounts created by PromotionActions::CreateAdjustment,+ # (whole-order discounts created by Promotion::Actions::CreateAdjustment,# distributed proportionally across line items), as opposed to promotions# applied to individual line items or fulfillments. Zero or negative.#diff --git a/spree/core/app/models/spree/order_updater.rb b/spree/core/app/models/spree/order_updater.rbindex 35dcf87fde..98b5e9eb34 100644--- a/spree/core/app/models/spree/order_updater.rb+++ b/spree/core/app/models/spree/order_updater.rb@@ -108,7 +108,27 @@ module Spreeendrecalculate_adjustments+ sum_typed_rows_into_order+ update_order_total+ end++ # The sanctioned post-placement edit path: re-sums typed rows into order+ # and per-adjustable totals WITHOUT re-running promotion competition or+ # tax estimation (both stay frozen once completed). Called by the admin+ # tax_lines/discounts/fees endpoints after writing rows directly.+ def resum_typed_totals!+ refresh_discount_and_fee_columns+ refresh_tax_columns+ sum_typed_rows_into_order+ update_order_total+ persist_totals+ end++ def update_item_count+ order.item_count = quantity+ end+ def sum_typed_rows_into_orderdiscounts_sum = order.discounts.reload.sum(&:amount)fees = order.fees.reload.to_atax_sums = order.tax_lines.reload.group_by(&:included?).transform_values { |lines| lines.sum(&:amount) }@@ -123,12 +143,6 @@ module Spree# discounts distribute to line items, so fees are the only residents.order.taxable_adjustment_total = 0order.non_taxable_adjustment_total = fees.select(&:order_level?).sum(&:amount)-- update_order_total- end-- def update_item_count- order.item_count = quantityenddef update_item_totaldiff --git a/spree/core/app/models/spree/permission_sets/configuration_management.rb b/spree/core/app/models/spree/permission_sets/configuration_management.rbindex 119238a550..dafdfc43e6 100644--- a/spree/core/app/models/spree/permission_sets/configuration_management.rb+++ b/spree/core/app/models/spree/permission_sets/configuration_management.rb@@ -17,8 +17,10 @@ module Spreecan :manage, Spree::PaymentMethodcan :manage, Spree::Gateway- # Shipping configuration- can :manage, Spree::ShippingMethod+ # Delivery configuration+ can :manage, Spree::DeliveryMethod+ can :manage, Spree::DeliveryZone+ can :manage, Spree::DeliveryZoneMembercan :manage, Spree::ShippingCategorycan :manage, Spree::Zonecan :manage, Spree::ZoneMemberdiff --git a/spree/core/app/models/spree/promotion.rb b/spree/core/app/models/spree/promotion.rbindex fe38d326f1..150e6a33bf 100644--- a/spree/core/app/models/spree/promotion.rb+++ b/spree/core/app/models/spree/promotion.rb@@ -243,7 +243,7 @@ module Spreeenddef products- rules.where(type: %w[Spree::PromotionRules::Product Spree::Promotion::Rules::Product]).map(&:products).flatten.uniq+ rules.where(type: %w[Spree::Promotion::Rules::Product Spree::Promotion::Rules::Product]).map(&:products).flatten.uniqenddef usage_limit_exceeded?(promotable)diff --git a/spree/core/app/models/spree/promotion/actions/create_adjustment.rb b/spree/core/app/models/spree/promotion/actions/create_adjustment.rbindex 8e66d1381a..ef34136117 100644--- a/spree/core/app/models/spree/promotion/actions/create_adjustment.rb+++ b/spree/core/app/models/spree/promotion/actions/create_adjustment.rb@@ -1,2 +1,34 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionActions::CreateAdjustment.-Spree::Promotion::Actions::CreateAdjustment = Spree::PromotionActions::CreateAdjustment+module Spree+ class Promotion+ module Actions+ # A whole-order discount. The winning order-level amount is distributed+ # proportionally across line items at application time (largest-remainder+ # over each line's remaining discounted base) — no order-attached rows.+ class CreateAdjustment < PromotionAction+ include Spree::CalculatedAdjustments++ before_validation -> { self.calculator ||= Calculator::FlatPercentItemTotal.new }++ def self.additional_permitted_attributes+ [calculator: [:type, { preferences: {} }]]+ end++ def discount_scope+ :order+ end++ def perform(options = {})+ apply_via_adjuster(options)+ end++ def compute_amount(order)+ [order_total(order), compute(order)].min * -1+ end++ def order_total(order)+ order.item_total + order.ship_total - order.shipping_discount+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/actions/create_item_adjustments.rb b/spree/core/app/models/spree/promotion/actions/create_item_adjustments.rbindex 09e6f8e0a3..0ce1f61c33 100644--- a/spree/core/app/models/spree/promotion/actions/create_item_adjustments.rb+++ b/spree/core/app/models/spree/promotion/actions/create_item_adjustments.rb@@ -1,2 +1,34 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionActions::CreateItemDiscounts.-Spree::Promotion::Actions::CreateItemAdjustments = Spree::PromotionActions::CreateItemDiscounts+module Spree+ class Promotion+ module Actions+ # Writes per-line-item promotion Discount rows (winner-only competition+ # handled by Spree::Adjusters::Promotion on every recalculation).+ class CreateItemAdjustments < PromotionAction+ include Spree::CalculatedAdjustments++ before_validation -> { self.calculator ||= Calculator::PercentOnLineItem.new }++ def self.additional_permitted_attributes+ [calculator: [:type, { preferences: {} }]]+ end++ def discount_scope+ :line_item+ end++ def perform(options = {})+ apply_via_adjuster(options)+ end++ # Negative-total protection is the adjuster's job: every discount row is+ # clamped against its line's remaining discounted base, so the order net+ # can never go below zero.+ def compute_amount(line_item)+ return 0 unless promotion.line_item_actionable?(line_item.order, line_item)++ [line_item.amount, compute(line_item)].min * -1+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/actions/create_line_items.rb b/spree/core/app/models/spree/promotion/actions/create_line_items.rbindex 6d05b34237..dcfdf81f55 100644--- a/spree/core/app/models/spree/promotion/actions/create_line_items.rb+++ b/spree/core/app/models/spree/promotion/actions/create_line_items.rb@@ -1,2 +1,138 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionActions::CreateLineItems.-Spree::Promotion::Actions::CreateLineItems = Spree::PromotionActions::CreateLineItems+module Spree+ class Promotion+ module Actions+ class CreateLineItems < Spree::PromotionAction+ has_many :promotion_action_line_items, foreign_key: :promotion_action_id, dependent: :destroy++ attribute :promotion_action_line_items_attributes++ after_save :handle_promotion_action_line_items++ def self.additional_permitted_attributes+ [line_items: [:variant_id, :quantity]]+ end++ # API v3 flat alias for `promotion_action_line_items_attributes`.+ # Accepts an array of `{ variant_id:, quantity: }` rows; the list+ # is the *desired* set, so anything missing on save is removed.+ def line_items=(rows)+ self.promotion_action_line_items_attributes = rows+ end++ delegate :eligible?, to: :promotion++ # Adds a line item to the Order if the promotion is eligible+ #+ # This doesn't play right with Add to Cart events because at the moment+ # the item was added to cart the promo may not be eligible. However it+ # might become eligible as the order gets updated.+ #+ # e.g.+ # - A promo adds a line item to cart if order total greater then $30+ # - Customer add 1 item of $10 to cart+ # - This action shouldn't perform because the order is not eligible+ # - Customer increases item quantity to 5 (order total goes to $50)+ # - Now the order is eligible for the promo and the action should perform+ #+ # Another complication is when the same line item created by the promo+ # is also added to cart on a separate action.+ #+ # e.g.+ # - Promo adds 1 item A to cart if order total greater then $30+ # - Customer add 2 items B to cart, current order total is $40+ # - This action performs adding item A to cart since order is eligible+ # - Customer changes his mind and updates item B quantity to 1+ # - At this point order is no longer eligible and one might expect+ # that item A should be removed+ #+ # It doesn't remove items from the order here because there's no way+ # it can know whether that item was added via this promo action or if+ # it was manually populated somewhere else. In that case the item+ # needs to be manually removed from the order by the customer+ def perform(options = {})+ order = options[:order]+ return unless eligible? order++ action_taken = false+ promotion_action_line_items.each do |item|+ current_quantity = order.quantity_of(item.variant)+ next unless current_quantity < item.quantity && item_available?(item)++ line_item = Spree.cart_add_item_service.call(order: order,+ variant: item.variant,+ quantity: item.quantity - current_quantity).value+ action_taken = true if line_item.try(:valid?)+ end+ action_taken+ end++ # Called by promotion handler when a promotion is removed+ # This will find any line item matching the ones defined in the PromotionAction+ # and remove the same quantity as was added by the PromotionAction.+ # Should help to prevent some of cases listed above the #perform method+ def revert(options = {})+ order = options[:order]+ return if eligible?(order)++ action_taken = false+ promotion_action_line_items.each do |item|+ line_item = order.find_line_item_by_variant(item.variant)+ next unless line_item.present?++ Spree.cart_remove_item_service.call(order: order,+ variant: item.variant,+ quantity: (item.quantity || 1))+ action_taken = true+ end++ action_taken+ end++ # Checks that there's enough stock to add the line item to the order+ def item_available?(item)+ quantifier = Spree::Stock::Quantifier.new(item.variant)+ quantifier.can_supply? item.quantity+ end++ private++ # Handles the creation, updating, and pruning of promotion action+ # line items. The submitted list is the *desired* set — variants+ # not present are deleted, ones that are get upserted. Accepts+ # both the legacy Rails admin hash shape (`{ "0" => attrs }`) and+ # a flat array from the API. Variant IDs may be raw or prefixed.+ def handle_promotion_action_line_items+ return unless promotion_action_line_items_attributes++ rows = promotion_action_line_items_attributes.is_a?(Hash) ? promotion_action_line_items_attributes.values : promotion_action_line_items_attributes+ rows = rows.map { |row| row.respond_to?(:to_h) ? row.to_h.with_indifferent_access : row.with_indifferent_access }++ rows = rows.map do |row|+ variant_id = row['variant_id']+ variant_id = Spree::Variant.find_by_param(variant_id)&.id if Spree::PrefixedId.prefixed_id?(variant_id)+ row.merge('variant_id' => variant_id)+ end++ desired_variant_ids = rows.map { |row| row['variant_id'] }.compact+ promotion_action_line_items.where.not(variant_id: desired_variant_ids).delete_all++ return if rows.empty?++ opts = {}+ opts[:unique_by] = [:promotion_action_id, :variant_id] unless mysql_adapter?++ promotion_action_line_items.upsert_all(+ rows.map do |params|+ {+ variant_id: params['variant_id'],+ quantity: params['quantity'],+ promotion_action_id: id+ }+ end,+ **opts+ )+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/actions/free_shipping.rb b/spree/core/app/models/spree/promotion/actions/free_shipping.rbindex ce807bc09a..c17eb8ef8a 100644--- a/spree/core/app/models/spree/promotion/actions/free_shipping.rb+++ b/spree/core/app/models/spree/promotion/actions/free_shipping.rb@@ -1,2 +1,26 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionActions::FreeShipping.-Spree::Promotion::Actions::FreeShipping = Spree::PromotionActions::FreeShipping+module Spree+ class Promotion+ module Actions+ # Writes a fulfillment-attached Discount covering the fulfillment cost.+ # The row persists even at zero amount — Order#has_free_shipping? tests+ # row existence.+ class FreeShipping < Spree::PromotionAction+ def discount_scope+ :fulfillment+ end++ def persist_at_zero?+ true+ end++ def perform(options = {})+ apply_via_adjuster(options)+ end++ def compute_amount(fulfillment)+ fulfillment.cost * -1+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/category.rb b/spree/core/app/models/spree/promotion/rules/category.rbindex 58a498e9f5..66ab0f2afb 100644--- a/spree/core/app/models/spree/promotion/rules/category.rb+++ b/spree/core/app/models/spree/promotion/rules/category.rb@@ -1,2 +1,175 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Category.-Spree::Promotion::Rules::Category = Spree::PromotionRules::Category+module Spree+ class Promotion+ module Rules+ # Promotion rule matching an order against a set of Spree::Category records.+ # Renamed from Spree::Promotion::Rules::Taxon in 6.0 (alias kept for one+ # release). Existing spree_promotion_rules.type strings are backfilled by the+ # Phase 4 data migration; the alias keeps old rows resolving until then.+ class Category < Spree::PromotionRule+ #+ # Associations+ #+ has_many :promotion_rule_categories, class_name: 'Spree::PromotionRuleCategory',+ foreign_key: 'promotion_rule_id',+ dependent: :destroy+ has_many :categories, through: :promotion_rule_categories, class_name: 'Spree::Category', source: :category++ def self.additional_permitted_attributes+ [category_ids: []]+ end++ # Wire-format shorthand is `category`. `key` (instance) cascades through `api_type`.+ def self.api_type+ 'category'+ end++ # Decode prefixed IDs before delegating to the generated setter (direct+ # calls bypass PrefixedId's assign_attributes auto-resolver).+ def category_ids=(ids)+ super(Array(ids).map do |id|+ Spree::PrefixedId.prefixed_id?(id) ? Spree::Category.find_by_param!(id).id : id+ end)+ end++ #+ # Preferences+ #+ MATCH_POLICIES = %w(any all)+ preference :match_policy, :string, default: MATCH_POLICIES.first++ #+ # Attributes+ #+ attr_accessor :category_ids_to_add++ #+ # Callbacks+ #+ after_save :add_categories++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible_category_ids+ @eligible_category_ids ||= promotion_rule_categories.pluck(:category_id)+ end++ def eligible?(order, _options = {})+ return true if eligible_category_ids.empty?++ order_category_ids_with_ancestors = category_ids_in_order_including_ancestors(order)++ if preferred_match_policy == 'all'+ unless eligible_category_ids.all? { |id| order_category_ids_with_ancestors.include?(id) }+ eligibility_errors.add(:base, eligibility_error_message(:missing_taxon))+ end+ else+ unless eligible_category_ids.any? { |id| order_category_ids_with_ancestors.include?(id) }+ eligibility_errors.add(:base, eligibility_error_message(:no_matching_taxons))+ end+ end++ eligibility_errors.empty?+ end++ def actionable?(line_item)+ Spree::ProductCategory.where(category_id: eligible_category_ids_including_children, product_id: line_item.product_id).exists?+ end++ #+ # Deprecated aliases (removed in 6.1)+ #+ # @deprecated Use #categories.+ def taxons+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxons is deprecated and will be removed in Spree 6.1. Use #categories instead.')+ categories+ end++ # @deprecated Use #categories=.+ def taxons=(value)+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxons= is deprecated and will be removed in Spree 6.1. Use #categories= instead.')+ self.categories = value+ end++ # @deprecated Use #category_ids.+ def taxon_ids+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxon_ids is deprecated and will be removed in Spree 6.1. Use #category_ids instead.')+ category_ids+ end++ # @deprecated Use #category_ids=.+ def taxon_ids=(ids)+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxon_ids= is deprecated and will be removed in Spree 6.1. Use #category_ids= instead.')+ self.category_ids = ids+ end++ # @deprecated Use #eligible_category_ids.+ def eligible_taxon_ids+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#eligible_taxon_ids is deprecated and will be removed in Spree 6.1. Use #eligible_category_ids instead.')+ eligible_category_ids+ end++ # @deprecated Use #category_ids_to_add.+ def taxon_ids_to_add+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxon_ids_to_add is deprecated and will be removed in Spree 6.1. Use #category_ids_to_add instead.')+ category_ids_to_add+ end++ def taxon_ids_to_add=(ids)+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxon_ids_to_add= is deprecated and will be removed in Spree 6.1. Use #category_ids_to_add= instead.')+ self.category_ids_to_add = ids+ end++ def taxon_ids_string+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxon_ids_string is deprecated and will be removed in Spree 6.1. Use #category_ids instead.')+ categories.pluck(:id).join(',')+ end++ def taxon_ids_string=(s)+ Spree::Deprecation.warn('Spree::Promotion::Rules::Category#taxon_ids_string= is deprecated and will be removed in Spree 6.1. Use #category_ids= instead.')+ ids = s.to_s.split(',').map(&:strip)+ self.categories = Spree::Category.for_stores(stores).find(ids)+ end++ private++ # IDs of categories in rule including all their children+ def eligible_category_ids_including_children+ @eligible_category_ids_including_children ||= begin+ return [] if eligible_category_ids.empty?++ Spree::Category.where(id: eligible_category_ids).flat_map(&:cached_self_and_descendants_ids).uniq+ end+ end++ # IDs of categories in order that match rule categories (or their children), plus all ancestors+ def category_ids_in_order_including_ancestors(order)+ # Get category IDs from order products that are within rule categories or their children+ order_category_ids = Spree::ProductCategory.where(product_id: order.product_ids, category_id: eligible_category_ids_including_children).pluck(:category_id).uniq++ return [] if order_category_ids.empty?++ # Get those categories plus all their ancestors+ Spree::Category.where(id: order_category_ids).flat_map { |category| category.self_and_ancestors.ids }.uniq+ end++ def add_categories+ return if category_ids_to_add.nil?++ promotion_rule_categories.delete_all++ if category_ids_to_add.any?+ Spree::PromotionRuleCategory.insert_all(+ category_ids_to_add.map { |category_id| { category_id: category_id, promotion_rule_id: id } }+ )+ end++ # Clear memoized values+ @eligible_category_ids = nil+ @eligible_category_ids_including_children = nil+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/channel.rb b/spree/core/app/models/spree/promotion/rules/channel.rbindex 504bf581a8..a695ddb54b 100644--- a/spree/core/app/models/spree/promotion/rules/channel.rb+++ b/spree/core/app/models/spree/promotion/rules/channel.rb@@ -1,2 +1,37 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Channel.-Spree::Promotion::Rules::Channel = Spree::PromotionRules::Channel+# A rule to limit a promotion based on the order's channel.+module Spree+ class Promotion+ module Rules+ class Channel < Spree::PromotionRule+ # Stored as raw IDs. Accepts prefixed IDs (`ch_…`) from API+ # callers and decodes them on write so eligibility checks compare+ # against the order's raw `channel_id` directly. Scope confines the+ # existence check to the promotion's store so cross-store channel+ # IDs can't sneak in.+ preference :channel_ids, :array, default: [],+ parse_on_set: normalize_id_preference(+ klass: Spree::Channel,+ scope: ->(rule) { rule.promotion&.store&.channels || Spree::Channel.none }+ )++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def channels+ return Spree::Channel.none if preferred_channel_ids.blank?++ promotion.store.channels.where(id: preferred_channel_ids)+ end++ def eligible?(order, _options = {})+ return false if preferred_channel_ids.empty?+ return true if preferred_channel_ids.map(&:to_s).include?(order.channel_id.to_s)++ eligibility_errors.add(:base, eligibility_error_message(:no_matching_channel))+ false+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/country.rb b/spree/core/app/models/spree/promotion/rules/country.rbindex dc4a2a438b..651c99b77e 100644--- a/spree/core/app/models/spree/promotion/rules/country.rb+++ b/spree/core/app/models/spree/promotion/rules/country.rb@@ -1,2 +1,63 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Country.-Spree::Promotion::Rules::Country = Spree::PromotionRules::Country+# A rule to limit a promotion based on shipment country. Stores an+# array of ISO codes — countries are inherently identified by ISO+# in the API. The legacy single `country_id` / `country_iso`+# preferences still work; they fold into the multi-country list.+module Spree+ class Promotion+ module Rules+ class Country < Spree::PromotionRule+ preference :country_isos, :array, default: [], parse_on_set: lambda { |values|+ normalize_id_preference.call(values).map(&:upcase)+ }+ preference :country_id, :integer # legacy single-country shortcut+ preference :country_iso, :string # legacy ISO-based shortcut++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def countries+ isos = preferred_country_isos.presence || [preferred_country_iso].compact_blank+ return Spree::Country.none if isos.blank?++ Spree::Country.where(iso: isos.map { |s| s.to_s.upcase })+ end++ def eligible?(order, options = {})+ allowed_isos = eligible_country_isos(order)+ shipping_iso = options[:country_iso] || order.ship_address&.country_iso++ return true if allowed_isos.include?(shipping_iso)++ eligibility_errors.add(:base, eligibility_error_message(:wrong_country))+ false+ end++ # Effective list of eligible country ISOs, merging legacy+ # single-country preferences into the multi-country list.+ # Order-of-precedence: explicit ISO list > legacy single ISO+ # > legacy single ID > store default. Memoized per-instance —+ # eligibility checks fire repeatedly per cart change.+ def eligible_country_isos(order = nil)+ @eligible_country_isos ||= compute_eligible_country_isos(order)+ end++ private++ def compute_eligible_country_isos(order)+ return preferred_country_isos.map { |v| v.to_s.upcase } if preferred_country_isos.present?+ return [preferred_country_iso.to_s.upcase] if preferred_country_iso.present?++ if preferred_country_id.present?+ iso = Spree::Country.where(id: preferred_country_id).pick(:iso)+ return [iso.to_s.upcase] if iso.present?+ end++ return [] if order.nil?++ [order.store&.default_country&.iso, order.store&.default_market&.default_country&.iso].compact.map(&:upcase).uniq+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/currency.rb b/spree/core/app/models/spree/promotion/rules/currency.rbindex 12a64a643f..435e892e02 100644--- a/spree/core/app/models/spree/promotion/rules/currency.rb+++ b/spree/core/app/models/spree/promotion/rules/currency.rb@@ -1,2 +1,21 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Currency.-Spree::Promotion::Rules::Currency = Spree::PromotionRules::Currency+# A rule to limit a promotion based on order currency.+module Spree+ class Promotion+ module Rules+ class Currency < Spree::PromotionRule+ preference :currency, :string++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(order, options = {})+ return true if order.currency == preferred_currency++ eligibility_errors.add(:base, eligibility_error_message(:wrong_currency))+ false+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/customer_group.rb b/spree/core/app/models/spree/promotion/rules/customer_group.rbindex a2c27706e6..379b7e3044 100644--- a/spree/core/app/models/spree/promotion/rules/customer_group.rb+++ b/spree/core/app/models/spree/promotion/rules/customer_group.rb@@ -1,2 +1,31 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::CustomerGroup.-Spree::Promotion::Rules::CustomerGroup = Spree::PromotionRules::CustomerGroup+module Spree+ class Promotion+ module Rules+ class CustomerGroup < Spree::PromotionRule+ # Stored as raw IDs. Accepts prefixed IDs (`cg_…`) from API+ # callers and decodes them on write so eligibility checks can+ # compare against raw `customer_group_id` rows directly.+ preference :customer_group_ids, :array, default: [], parse_on_set: normalize_id_preference(klass: Spree::CustomerGroup)++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def customer_groups+ return Spree::CustomerGroup.none if preferred_customer_group_ids.blank?++ Spree::CustomerGroup.where(id: preferred_customer_group_ids)+ end++ def eligible?(order, _options = {})+ return false unless order.user_id.present?+ return false if preferred_customer_group_ids.empty?++ user_customer_group_ids = Spree::CustomerGroupUser.where(user_id: order.user_id).pluck(:customer_group_id).map(&:to_s)++ (preferred_customer_group_ids.map(&:to_s) & user_customer_group_ids).any?+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/first_order.rb b/spree/core/app/models/spree/promotion/rules/first_order.rbindex 099f804b74..552fd44bbf 100644--- a/spree/core/app/models/spree/promotion/rules/first_order.rb+++ b/spree/core/app/models/spree/promotion/rules/first_order.rb@@ -1,2 +1,44 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::FirstOrder.-Spree::Promotion::Rules::FirstOrder = Spree::PromotionRules::FirstOrder+module Spree+ class Promotion+ module Rules+ class FirstOrder < Spree::PromotionRule+ attr_reader :user, :email, :store++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(order, options = {})+ @user = order.try(:user) || options[:user]+ @email = if options[:email].present?+ order.email = options[:email]+ order.email+ elsif order.email.present?+ order.email+ end+ @store = order.store++ if user || email+ if !completed_orders.blank? && completed_orders.first != order+ eligibility_errors.add(:base, eligibility_error_message(:not_first_order))+ end+ else+ eligibility_errors.add(:base, eligibility_error_message(:no_user_or_email_specified))+ end++ eligibility_errors.empty?+ end++ private++ def completed_orders+ user ? user.orders.for_store(store).complete : orders_by_email+ end++ def orders_by_email+ store.orders.where(email: email).complete+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/item_total.rb b/spree/core/app/models/spree/promotion/rules/item_total.rbindex 49be687de8..9bcd8e7abf 100644--- a/spree/core/app/models/spree/promotion/rules/item_total.rb+++ b/spree/core/app/models/spree/promotion/rules/item_total.rb@@ -1,2 +1,68 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::ItemTotal.-Spree::Promotion::Rules::ItemTotal = Spree::PromotionRules::ItemTotal+# A rule to apply to an order greater than (or greater than or equal to)+# a specific amount+module Spree+ class Promotion+ module Rules+ class ItemTotal < Spree::PromotionRule+ preference :amount_min, :decimal, default: 100.00+ preference :operator_min, :string, default: '>'+ preference :amount_max, :decimal, default: nil, nullable: true+ preference :operator_max, :string, default: '<'++ OPERATORS_MIN = ['gt', 'gte']+ OPERATORS_MAX = ['lt', 'lte']++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(order, _options = {})+ item_total = order.item_total++ lower_limit_condition = item_total.send(preferred_operator_min == 'gte' ? :>= : :>, BigDecimal(preferred_amount_min.to_s))++ if preferred_amount_max.present?+ upper_limit_condition = item_total.send(preferred_operator_max == 'lte' ? :<= : :<, BigDecimal(preferred_amount_max.to_s))+ else+ upper_limit_condition = true+ end++ eligibility_errors.add(:base, ineligible_message_max(order)) unless upper_limit_condition+ eligibility_errors.add(:base, ineligible_message_min(order)) unless lower_limit_condition++ eligibility_errors.empty?+ end++ private++ def formatted_amount_min(order)+ Spree::Money.new(preferred_amount_min, currency: order.currency).to_s+ end++ def formatted_amount_max(order)+ if preferred_amount_max.present?+ Spree::Money.new(preferred_amount_max, currency: order.currency).to_s+ else+ Spree.t('no_maximum')+ end+ end++ def ineligible_message_max(order)+ if preferred_operator_max == 'lt'+ eligibility_error_message(:item_total_more_than_or_equal, amount: formatted_amount_max(order))+ else+ eligibility_error_message(:item_total_more_than, amount: formatted_amount_max(order))+ end+ end++ def ineligible_message_min(order)+ if preferred_operator_min == 'gte'+ eligibility_error_message(:item_total_less_than, amount: formatted_amount_min(order))+ else+ eligibility_error_message(:item_total_less_than_or_equal, amount: formatted_amount_min(order))+ end+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/market.rb b/spree/core/app/models/spree/promotion/rules/market.rbindex 42b3fecc45..0992322d22 100644--- a/spree/core/app/models/spree/promotion/rules/market.rb+++ b/spree/core/app/models/spree/promotion/rules/market.rb@@ -1,2 +1,37 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Market.-Spree::Promotion::Rules::Market = Spree::PromotionRules::Market+# A rule to limit a promotion based on the order's market.+module Spree+ class Promotion+ module Rules+ class Market < Spree::PromotionRule+ # Stored as raw IDs. Accepts prefixed IDs (`mkt_…`) from API+ # callers and decodes them on write so eligibility checks compare+ # against the order's raw `market_id` directly. Scope confines the+ # existence check to the promotion's store so cross-store market+ # IDs can't sneak in.+ preference :market_ids, :array, default: [],+ parse_on_set: normalize_id_preference(+ klass: Spree::Market,+ scope: ->(rule) { rule.promotion&.store&.markets || Spree::Market.none }+ )++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def markets+ return Spree::Market.none if preferred_market_ids.blank?++ promotion.store.markets.where(id: preferred_market_ids)+ end++ def eligible?(order, _options = {})+ return false if preferred_market_ids.empty?+ return true if preferred_market_ids.map(&:to_s).include?(order.market_id.to_s)++ eligibility_errors.add(:base, eligibility_error_message(:no_matching_market))+ false+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/one_use_per_user.rb b/spree/core/app/models/spree/promotion/rules/one_use_per_user.rbindex d617beb154..75c825d59b 100644--- a/spree/core/app/models/spree/promotion/rules/one_use_per_user.rb+++ b/spree/core/app/models/spree/promotion/rules/one_use_per_user.rb@@ -1,2 +1,23 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::OneUsePerUser.-Spree::Promotion::Rules::OneUsePerUser = Spree::PromotionRules::OneUsePerUser+module Spree+ class Promotion+ module Rules+ class OneUsePerUser < Spree::PromotionRule+ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(order, _options = {})+ if order.user.present?+ if promotion.used_by?(order.user, [order])+ eligibility_errors.add(:base, eligibility_error_message(:limit_once_per_user))+ end+ else+ eligibility_errors.add(:base, eligibility_error_message(:no_user_specified))+ end++ eligibility_errors.empty?+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/option_value.rb b/spree/core/app/models/spree/promotion/rules/option_value.rbindex f31098bfd6..43dba11d24 100644--- a/spree/core/app/models/spree/promotion/rules/option_value.rb+++ b/spree/core/app/models/spree/promotion/rules/option_value.rb@@ -1,2 +1,38 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::OptionValue.-Spree::Promotion::Rules::OptionValue = Spree::PromotionRules::OptionValue+module Spree+ class Promotion+ module Rules+ class OptionValue < Spree::PromotionRule+ MATCH_POLICIES = %w(any)+ preference :match_policy, :string, default: MATCH_POLICIES.first+ preference :eligible_values, :array, default: [], parse_on_set: lambda { |values|+ values.flat_map { |v| v.to_s.split(',').compact_blank.map(&:strip) }+ }++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(promotable, _options = {})+ return false if eligible_option_value_variant_ids.empty?++ case preferred_match_policy+ when 'any'+ Spree::OptionValueVariant.where(id: eligible_option_value_variant_ids, variant_id: promotable.variant_ids).exists?+ end+ end++ def actionable?(line_item)+ return false if eligible_option_value_variant_ids.empty?++ Spree::OptionValueVariant.where(id: eligible_option_value_variant_ids, variant_id: line_item.variant_id).exists?+ end++ private++ def eligible_option_value_variant_ids+ @eligible_option_value_variant_ids ||= preferred_eligible_values.map(&:to_s)+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/product.rb b/spree/core/app/models/spree/promotion/rules/product.rbindex f3fafe9f6e..e6e6cea47a 100644--- a/spree/core/app/models/spree/promotion/rules/product.rb+++ b/spree/core/app/models/spree/promotion/rules/product.rb@@ -1,2 +1,116 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Product.-Spree::Promotion::Rules::Product = Spree::PromotionRules::Product+# A rule to limit a promotion based on products in the order.+# Can require all or any of the products to be present.+# Valid products either come from assigned product group or are assigned directly to the rule.+module Spree+ class Promotion+ module Rules+ class Product < Spree::PromotionRule+ #+ # Associations+ #+ has_many :product_promotion_rules, class_name: 'Spree::ProductPromotionRule',+ foreign_key: :promotion_rule_id,+ dependent: :destroy+ has_many :products, through: :product_promotion_rules, class_name: 'Spree::Product'++ def self.additional_permitted_attributes+ [product_ids: []]+ end++ #+ # Preferences+ #+ MATCH_POLICIES = %w(any all none)+ preference :match_policy, :string, default: MATCH_POLICIES.first++ #+ # Attributes+ #+ attr_accessor :product_ids_to_add++ #+ # Callbacks+ #+ after_save :add_products++ # scope/association that is used to test eligibility+ def eligible_products+ products+ end++ def eligible_product_ids+ @eligible_product_ids ||= product_promotion_rules.pluck(:product_id)+ end++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(order, _options = {})+ return true if eligible_product_ids.empty?++ if preferred_match_policy == 'all'+ unless eligible_product_ids.all? { |p| order.product_ids.include?(p) }+ eligibility_errors.add(:base, eligibility_error_message(:missing_product))+ end+ elsif preferred_match_policy == 'any'+ unless order.product_ids.any? { |p| eligible_product_ids.include?(p) }+ eligibility_errors.add(:base, eligibility_error_message(:no_applicable_products))+ end+ else+ unless order.product_ids.none? { |p| eligible_product_ids.include?(p) }+ eligibility_errors.add(:base, eligibility_error_message(:has_excluded_product))+ end+ end++ eligibility_errors.empty?+ end++ def actionable?(line_item)+ case preferred_match_policy+ when 'any', 'all'+ eligible_product_ids.include? line_item.variant.product_id+ when 'none'+ eligible_product_ids.exclude? line_item.variant.product_id+ else+ raise "unexpected match policy: #{preferred_match_policy.inspect}"+ end+ end++ def product_ids_string+ ActiveSupport::Deprecation.warn(+ 'Please use `product_ids=` instead.'+ )+ product_ids.join(',')+ end++ def product_ids_string=(s)+ ActiveSupport::Deprecation.warn(+ 'Please use `product_ids=` instead.'+ )+ self.product_ids = s+ end++ private++ def add_products+ return if product_ids_to_add.nil?++ product_promotion_rules.delete_all++ if product_ids_to_add.any?+ Spree::ProductPromotionRule.insert_all(+ product_ids_to_add.map { |product_id| { product_id: product_id, promotion_rule_id: id } }+ )+ end++ # Invalidate cache after bulk operations+ touch++ # Clear memoized values+ @eligible_product_ids = nil+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/taxon.rb b/spree/core/app/models/spree/promotion/rules/taxon.rbindex 2095b1ffec..ed7bff9cad 100644--- a/spree/core/app/models/spree/promotion/rules/taxon.rb+++ b/spree/core/app/models/spree/promotion/rules/taxon.rb@@ -1,2 +1,16 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::Taxon.-Spree::Promotion::Rules::Taxon = Spree::PromotionRules::Taxon+# frozen_string_literal: true++module Spree+ class Promotion+ module Rules+ # Deprecation alias for Spree::Promotion::Rules::Category, renamed from+ # Spree::Promotion::Rules::Taxon in 6.0. A true constant alias, so old STI type+ # strings (`'Spree::Promotion::Rules::Taxon'`) still instantiate correctly until+ # the Phase 4 migration rewrites them. The warning fires when this file loads.+ # Removed in 6.1.+ Taxon = Category++ Spree::Deprecation.warn('Spree::Promotion::Rules::Taxon is deprecated and will be removed in Spree 6.1. Use Spree::Promotion::Rules::Category instead.')+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/user.rb b/spree/core/app/models/spree/promotion/rules/user.rbindex 05c1a0d3f2..ee3283ccd2 100644--- a/spree/core/app/models/spree/promotion/rules/user.rb+++ b/spree/core/app/models/spree/promotion/rules/user.rb@@ -1,2 +1,94 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::User.-Spree::Promotion::Rules::User = Spree::PromotionRules::User+module Spree+ class Promotion+ module Rules+ class User < Spree::PromotionRule+ #+ # Associations+ #+ has_many :promotion_rule_users, class_name: 'Spree::PromotionRuleUser',+ foreign_key: :promotion_rule_id,+ dependent: :destroy+ has_many :users, through: :promotion_rule_users, class_name: "::#{Spree.user_class}"++ # Customers, not admin users — the rule keys off `Spree::Order#user_id`.+ # The data layer keeps the `users` association (legacy column name);+ # the API exposes the same set as `customer_ids`.+ def self.additional_permitted_attributes+ [customer_ids: []]+ end++ # Wire-format shorthand is `customer` (the model is still `User`+ # pre-6.0 rename, see docs/plans/6.0-platform-auth.md).+ def self.api_type+ 'customer'+ end++ def customer_ids+ user_ids+ end++ def customer_ids=(ids)+ self.user_ids = ids+ end++ #+ # Attributes+ #+ attr_accessor :user_ids_to_add++ #+ # Callbacks+ #+ after_save :add_users++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible_user_ids+ @eligible_user_ids ||= promotion_rule_users.pluck(:user_id)+ end++ def eligible?(order, _options = {})+ eligible_user_ids.include?(order.user_id)+ end++ def user_ids_string+ ActiveSupport::Deprecation.warn(+ 'Spree::Promotion::Rules::User#user_ids_string is deprecated and will be removed in Spree 5.5. ' \+ 'Please use `user_ids` instead.'+ )+ user_ids.join(',')+ end++ def user_ids_string=(s)+ ActiveSupport::Deprecation.warn(+ 'Spree::Promotion::Rules::User#user_ids_string= is deprecated and will be removed in Spree 5.5. ' \+ 'Please use `user_ids=` instead.'+ )+ self.user_ids = s+ end++ private++ def add_users+ return if user_ids_to_add.nil?++ promotion_rule_users.delete_all++ if user_ids_to_add.any?+ Spree::PromotionRuleUser.insert_all(+ user_ids_to_add.map { |user_id| { user_id: user_id, promotion_rule_id: id } }+ )+ end++ # Invalidate cache after bulk operations+ touch++ # Clear memoized values+ @eligible_user_ids = nil+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion/rules/user_logged_in.rb b/spree/core/app/models/spree/promotion/rules/user_logged_in.rbindex e72e8e0c3a..378e4f67f7 100644--- a/spree/core/app/models/spree/promotion/rules/user_logged_in.rb+++ b/spree/core/app/models/spree/promotion/rules/user_logged_in.rb@@ -1,2 +1,24 @@-# Legacy constant path — removed in 6.1. Real class: Spree::PromotionRules::UserLoggedIn.-Spree::Promotion::Rules::UserLoggedIn = Spree::PromotionRules::UserLoggedIn+module Spree+ class Promotion+ module Rules+ class UserLoggedIn < Spree::PromotionRule+ # Wire-format shorthand is `customer_logged_in` (the model is still+ # `UserLoggedIn` pre-6.0 rename, see docs/plans/6.0-platform-auth.md).+ def self.api_type+ 'customer_logged_in'+ end++ def applicable?(promotable)+ promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)+ end++ def eligible?(order, _options = {})+ unless order.user.present?+ eligibility_errors.add(:base, eligibility_error_message(:no_user_specified))+ end+ eligibility_errors.empty?+ end+ end+ end+ end+enddiff --git a/spree/core/app/models/spree/promotion_action.rb b/spree/core/app/models/spree/promotion_action.rbindex 9ac9ddb3e8..f7007fb4b3 100644--- a/spree/core/app/models/spree/promotion_action.rb+++ b/spree/core/app/models/spree/promotion_action.rb@@ -60,11 +60,11 @@ module Spreedef self.types_for_discount_scope(scope)case scopewhen :line_item- %w[Spree::PromotionActions::CreateItemDiscounts Spree::Promotion::Actions::CreateItemAdjustments]+ %w[Spree::Promotion::Actions::CreateItemAdjustments Spree::Promotion::Actions::CreateItemAdjustments]when :fulfillment- %w[Spree::PromotionActions::FreeShipping Spree::Promotion::Actions::FreeShipping]+ %w[Spree::Promotion::Actions::FreeShipping Spree::Promotion::Actions::FreeShipping]when :order- %w[Spree::PromotionActions::CreateAdjustment Spree::Promotion::Actions::CreateAdjustment]+ %w[Spree::Promotion::Actions::CreateAdjustment Spree::Promotion::Actions::CreateAdjustment]else[]enddiff --git a/spree/core/app/models/spree/promotion_action_line_item.rb b/spree/core/app/models/spree/promotion_action_line_item.rbindex 911cff4184..69ba28a003 100644--- a/spree/core/app/models/spree/promotion_action_line_item.rb+++ b/spree/core/app/models/spree/promotion_action_line_item.rb@@ -1,6 +1,6 @@module Spreeclass PromotionActionLineItem < Spree.base_class- belongs_to :promotion_action, class_name: 'Spree::PromotionActions::CreateLineItems'+ belongs_to :promotion_action, class_name: 'Spree::Promotion::Actions::CreateLineItems'belongs_to :variant, class_name: 'Spree::Variant'validates :promotion_action, :variant, :quantity, presence: truediff --git a/spree/core/app/models/spree/promotion_actions/create_adjustment.rb b/spree/core/app/models/spree/promotion_actions/create_adjustment.rbdeleted file mode 100644index b6409b8506..0000000000--- a/spree/core/app/models/spree/promotion_actions/create_adjustment.rb+++ /dev/null@@ -1,32 +0,0 @@-module Spree- module PromotionActions- # A whole-order discount. The winning order-level amount is distributed- # proportionally across line items at application time (largest-remainder- # over each line's remaining discounted base) — no order-attached rows.- class CreateAdjustment < PromotionAction- include Spree::CalculatedAdjustments-- before_validation -> { self.calculator ||= Calculator::FlatPercentItemTotal.new }-- def self.additional_permitted_attributes- [calculator: [:type, { preferences: {} }]]- end-- def discount_scope- :order- end-- def perform(options = {})- apply_via_adjuster(options)- end-- def compute_amount(order)- [order_total(order), compute(order)].min * -1- end-- def order_total(order)- order.item_total + order.ship_total - order.shipping_discount- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_actions/create_item_discounts.rb b/spree/core/app/models/spree/promotion_actions/create_item_discounts.rbdeleted file mode 100644index 73c2f71b6c..0000000000--- a/spree/core/app/models/spree/promotion_actions/create_item_discounts.rb+++ /dev/null@@ -1,32 +0,0 @@-module Spree- module PromotionActions- # Writes per-line-item promotion Discount rows (winner-only competition- # handled by Spree::Adjusters::Promotion on every recalculation).- class CreateItemDiscounts < PromotionAction- include Spree::CalculatedAdjustments-- before_validation -> { self.calculator ||= Calculator::PercentOnLineItem.new }-- def self.additional_permitted_attributes- [calculator: [:type, { preferences: {} }]]- end-- def discount_scope- :line_item- end-- def perform(options = {})- apply_via_adjuster(options)- end-- # Negative-total protection is the adjuster's job: every discount row is- # clamped against its line's remaining discounted base, so the order net- # can never go below zero.- def compute_amount(line_item)- return 0 unless promotion.line_item_actionable?(line_item.order, line_item)-- [line_item.amount, compute(line_item)].min * -1- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_actions/create_line_items.rb b/spree/core/app/models/spree/promotion_actions/create_line_items.rbdeleted file mode 100644index 70d3b1f1f4..0000000000--- a/spree/core/app/models/spree/promotion_actions/create_line_items.rb+++ /dev/null@@ -1,136 +0,0 @@-module Spree- module PromotionActions- class CreateLineItems < Spree::PromotionAction- has_many :promotion_action_line_items, foreign_key: :promotion_action_id, dependent: :destroy-- attribute :promotion_action_line_items_attributes-- after_save :handle_promotion_action_line_items-- def self.additional_permitted_attributes- [line_items: [:variant_id, :quantity]]- end-- # API v3 flat alias for `promotion_action_line_items_attributes`.- # Accepts an array of `{ variant_id:, quantity: }` rows; the list- # is the *desired* set, so anything missing on save is removed.- def line_items=(rows)- self.promotion_action_line_items_attributes = rows- end-- delegate :eligible?, to: :promotion-- # Adds a line item to the Order if the promotion is eligible- #- # This doesn't play right with Add to Cart events because at the moment- # the item was added to cart the promo may not be eligible. However it- # might become eligible as the order gets updated.- #- # e.g.- # - A promo adds a line item to cart if order total greater then $30- # - Customer add 1 item of $10 to cart- # - This action shouldn't perform because the order is not eligible- # - Customer increases item quantity to 5 (order total goes to $50)- # - Now the order is eligible for the promo and the action should perform- #- # Another complication is when the same line item created by the promo- # is also added to cart on a separate action.- #- # e.g.- # - Promo adds 1 item A to cart if order total greater then $30- # - Customer add 2 items B to cart, current order total is $40- # - This action performs adding item A to cart since order is eligible- # - Customer changes his mind and updates item B quantity to 1- # - At this point order is no longer eligible and one might expect- # that item A should be removed- #- # It doesn't remove items from the order here because there's no way- # it can know whether that item was added via this promo action or if- # it was manually populated somewhere else. In that case the item- # needs to be manually removed from the order by the customer- def perform(options = {})- order = options[:order]- return unless eligible? order-- action_taken = false- promotion_action_line_items.each do |item|- current_quantity = order.quantity_of(item.variant)- next unless current_quantity < item.quantity && item_available?(item)-- line_item = Spree.cart_add_item_service.call(order: order,- variant: item.variant,- quantity: item.quantity - current_quantity).value- action_taken = true if line_item.try(:valid?)- end- action_taken- end-- # Called by promotion handler when a promotion is removed- # This will find any line item matching the ones defined in the PromotionAction- # and remove the same quantity as was added by the PromotionAction.- # Should help to prevent some of cases listed above the #perform method- def revert(options = {})- order = options[:order]- return if eligible?(order)-- action_taken = false- promotion_action_line_items.each do |item|- line_item = order.find_line_item_by_variant(item.variant)- next unless line_item.present?-- Spree.cart_remove_item_service.call(order: order,- variant: item.variant,- quantity: (item.quantity || 1))- action_taken = true- end-- action_taken- end-- # Checks that there's enough stock to add the line item to the order- def item_available?(item)- quantifier = Spree::Stock::Quantifier.new(item.variant)- quantifier.can_supply? item.quantity- end-- private-- # Handles the creation, updating, and pruning of promotion action- # line items. The submitted list is the *desired* set — variants- # not present are deleted, ones that are get upserted. Accepts- # both the legacy Rails admin hash shape (`{ "0" => attrs }`) and- # a flat array from the API. Variant IDs may be raw or prefixed.- def handle_promotion_action_line_items- return unless promotion_action_line_items_attributes-- rows = promotion_action_line_items_attributes.is_a?(Hash) ? promotion_action_line_items_attributes.values : promotion_action_line_items_attributes- rows = rows.map { |row| row.respond_to?(:to_h) ? row.to_h.with_indifferent_access : row.with_indifferent_access }-- rows = rows.map do |row|- variant_id = row['variant_id']- variant_id = Spree::Variant.find_by_param(variant_id)&.id if Spree::PrefixedId.prefixed_id?(variant_id)- row.merge('variant_id' => variant_id)- end-- desired_variant_ids = rows.map { |row| row['variant_id'] }.compact- promotion_action_line_items.where.not(variant_id: desired_variant_ids).delete_all-- return if rows.empty?-- opts = {}- opts[:unique_by] = [:promotion_action_id, :variant_id] unless mysql_adapter?-- promotion_action_line_items.upsert_all(- rows.map do |params|- {- variant_id: params['variant_id'],- quantity: params['quantity'],- promotion_action_id: id- }- end,- **opts- )- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_actions/free_shipping.rb b/spree/core/app/models/spree/promotion_actions/free_shipping.rbdeleted file mode 100644index a972835626..0000000000--- a/spree/core/app/models/spree/promotion_actions/free_shipping.rb+++ /dev/null@@ -1,24 +0,0 @@-module Spree- module PromotionActions- # Writes a fulfillment-attached Discount covering the fulfillment cost.- # The row persists even at zero amount — Order#has_free_shipping? tests- # row existence.- class FreeShipping < Spree::PromotionAction- def discount_scope- :fulfillment- end-- def persist_at_zero?- true- end-- def perform(options = {})- apply_via_adjuster(options)- end-- def compute_amount(fulfillment)- fulfillment.cost * -1- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_handler/coupon.rb b/spree/core/app/models/spree/promotion_handler/coupon.rbindex 9c3fb0c337..989c3f9bb5 100644--- a/spree/core/app/models/spree/promotion_handler/coupon.rb+++ b/spree/core/app/models/spree/promotion_handler/coupon.rb@@ -126,7 +126,7 @@ module Spreedef remove_promotion_line_items(promotion)create_line_item_actions_ids = promotion.actions.- where(type: %w[Spree::PromotionActions::CreateLineItems Spree::Promotion::Actions::CreateLineItems]).pluck(:id)+ where(type: %w[Spree::Promotion::Actions::CreateLineItems Spree::Promotion::Actions::CreateLineItems]).pluck(:id)Spree::PromotionActionLineItem.where(promotion_action: create_line_item_actions_ids).find_each do |item|line_item = order.find_line_item_by_variant(item.variant)@@ -183,7 +183,7 @@ module Spree# Check for applied line items.created_line_items = promotion.actions.detect do |a|Object.const_get(a.type).ancestors.include?(- Spree::PromotionActions::CreateLineItems+ Spree::Promotion::Actions::CreateLineItems)enddiff --git a/spree/core/app/models/spree/promotion_rule_category.rb b/spree/core/app/models/spree/promotion_rule_category.rbindex 3d734bb8f6..b50e0b48ef 100644--- a/spree/core/app/models/spree/promotion_rule_category.rb+++ b/spree/core/app/models/spree/promotion_rule_category.rb@@ -1,5 +1,5 @@module Spree- # Join model between a Spree::PromotionRules::Category rule and a+ # Join model between a Spree::Promotion::Rules::Category rule and a# Spree::Category. Renamed from Spree::PromotionRuleTaxon in 6.0 (alias kept for# one release).class PromotionRuleCategory < Spree.base_classdiff --git a/spree/core/app/models/spree/promotion_rules/category.rb b/spree/core/app/models/spree/promotion_rules/category.rbdeleted file mode 100644index 9cdcf6225b..0000000000--- a/spree/core/app/models/spree/promotion_rules/category.rb+++ /dev/null@@ -1,173 +0,0 @@-module Spree- module PromotionRules- # Promotion rule matching an order against a set of Spree::Category records.- # Renamed from Spree::Promotion::Rules::Taxon in 6.0 (alias kept for one- # release). Existing spree_promotion_rules.type strings are backfilled by the- # Phase 4 data migration; the alias keeps old rows resolving until then.- class Category < Spree::PromotionRule- #- # Associations- #- has_many :promotion_rule_categories, class_name: 'Spree::PromotionRuleCategory',- foreign_key: 'promotion_rule_id',- dependent: :destroy- has_many :categories, through: :promotion_rule_categories, class_name: 'Spree::Category', source: :category-- def self.additional_permitted_attributes- [category_ids: []]- end-- # Wire-format shorthand is `category`. `key` (instance) cascades through `api_type`.- def self.api_type- 'category'- end-- # Decode prefixed IDs before delegating to the generated setter (direct- # calls bypass PrefixedId's assign_attributes auto-resolver).- def category_ids=(ids)- super(Array(ids).map do |id|- Spree::PrefixedId.prefixed_id?(id) ? Spree::Category.find_by_param!(id).id : id- end)- end-- #- # Preferences- #- MATCH_POLICIES = %w(any all)- preference :match_policy, :string, default: MATCH_POLICIES.first-- #- # Attributes- #- attr_accessor :category_ids_to_add-- #- # Callbacks- #- after_save :add_categories-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible_category_ids- @eligible_category_ids ||= promotion_rule_categories.pluck(:category_id)- end-- def eligible?(order, _options = {})- return true if eligible_category_ids.empty?-- order_category_ids_with_ancestors = category_ids_in_order_including_ancestors(order)-- if preferred_match_policy == 'all'- unless eligible_category_ids.all? { |id| order_category_ids_with_ancestors.include?(id) }- eligibility_errors.add(:base, eligibility_error_message(:missing_taxon))- end- else- unless eligible_category_ids.any? { |id| order_category_ids_with_ancestors.include?(id) }- eligibility_errors.add(:base, eligibility_error_message(:no_matching_taxons))- end- end-- eligibility_errors.empty?- end-- def actionable?(line_item)- Spree::ProductCategory.where(category_id: eligible_category_ids_including_children, product_id: line_item.product_id).exists?- end-- #- # Deprecated aliases (removed in 6.1)- #- # @deprecated Use #categories.- def taxons- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxons is deprecated and will be removed in Spree 6.1. Use #categories instead.')- categories- end-- # @deprecated Use #categories=.- def taxons=(value)- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxons= is deprecated and will be removed in Spree 6.1. Use #categories= instead.')- self.categories = value- end-- # @deprecated Use #category_ids.- def taxon_ids- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxon_ids is deprecated and will be removed in Spree 6.1. Use #category_ids instead.')- category_ids- end-- # @deprecated Use #category_ids=.- def taxon_ids=(ids)- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxon_ids= is deprecated and will be removed in Spree 6.1. Use #category_ids= instead.')- self.category_ids = ids- end-- # @deprecated Use #eligible_category_ids.- def eligible_taxon_ids- Spree::Deprecation.warn('Spree::PromotionRules::Category#eligible_taxon_ids is deprecated and will be removed in Spree 6.1. Use #eligible_category_ids instead.')- eligible_category_ids- end-- # @deprecated Use #category_ids_to_add.- def taxon_ids_to_add- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxon_ids_to_add is deprecated and will be removed in Spree 6.1. Use #category_ids_to_add instead.')- category_ids_to_add- end-- def taxon_ids_to_add=(ids)- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxon_ids_to_add= is deprecated and will be removed in Spree 6.1. Use #category_ids_to_add= instead.')- self.category_ids_to_add = ids- end-- def taxon_ids_string- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxon_ids_string is deprecated and will be removed in Spree 6.1. Use #category_ids instead.')- categories.pluck(:id).join(',')- end-- def taxon_ids_string=(s)- Spree::Deprecation.warn('Spree::PromotionRules::Category#taxon_ids_string= is deprecated and will be removed in Spree 6.1. Use #category_ids= instead.')- ids = s.to_s.split(',').map(&:strip)- self.categories = Spree::Category.for_stores(stores).find(ids)- end-- private-- # IDs of categories in rule including all their children- def eligible_category_ids_including_children- @eligible_category_ids_including_children ||= begin- return [] if eligible_category_ids.empty?-- Spree::Category.where(id: eligible_category_ids).flat_map(&:cached_self_and_descendants_ids).uniq- end- end-- # IDs of categories in order that match rule categories (or their children), plus all ancestors- def category_ids_in_order_including_ancestors(order)- # Get category IDs from order products that are within rule categories or their children- order_category_ids = Spree::ProductCategory.where(product_id: order.product_ids, category_id: eligible_category_ids_including_children).pluck(:category_id).uniq-- return [] if order_category_ids.empty?-- # Get those categories plus all their ancestors- Spree::Category.where(id: order_category_ids).flat_map { |category| category.self_and_ancestors.ids }.uniq- end-- def add_categories- return if category_ids_to_add.nil?-- promotion_rule_categories.delete_all-- if category_ids_to_add.any?- Spree::PromotionRuleCategory.insert_all(- category_ids_to_add.map { |category_id| { category_id: category_id, promotion_rule_id: id } }- )- end-- # Clear memoized values- @eligible_category_ids = nil- @eligible_category_ids_including_children = nil- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/channel.rb b/spree/core/app/models/spree/promotion_rules/channel.rbdeleted file mode 100644index 91f7c363a7..0000000000--- a/spree/core/app/models/spree/promotion_rules/channel.rb+++ /dev/null@@ -1,35 +0,0 @@-# A rule to limit a promotion based on the order's channel.-module Spree- module PromotionRules- class Channel < Spree::PromotionRule- # Stored as raw IDs. Accepts prefixed IDs (`ch_…`) from API- # callers and decodes them on write so eligibility checks compare- # against the order's raw `channel_id` directly. Scope confines the- # existence check to the promotion's store so cross-store channel- # IDs can't sneak in.- preference :channel_ids, :array, default: [],- parse_on_set: normalize_id_preference(- klass: Spree::Channel,- scope: ->(rule) { rule.promotion&.store&.channels || Spree::Channel.none }- )-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def channels- return Spree::Channel.none if preferred_channel_ids.blank?-- promotion.store.channels.where(id: preferred_channel_ids)- end-- def eligible?(order, _options = {})- return false if preferred_channel_ids.empty?- return true if preferred_channel_ids.map(&:to_s).include?(order.channel_id.to_s)-- eligibility_errors.add(:base, eligibility_error_message(:no_matching_channel))- false- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/country.rb b/spree/core/app/models/spree/promotion_rules/country.rbdeleted file mode 100644index db7e3b932e..0000000000--- a/spree/core/app/models/spree/promotion_rules/country.rb+++ /dev/null@@ -1,61 +0,0 @@-# A rule to limit a promotion based on shipment country. Stores an-# array of ISO codes — countries are inherently identified by ISO-# in the API. The legacy single `country_id` / `country_iso`-# preferences still work; they fold into the multi-country list.-module Spree- module PromotionRules- class Country < Spree::PromotionRule- preference :country_isos, :array, default: [], parse_on_set: lambda { |values|- normalize_id_preference.call(values).map(&:upcase)- }- preference :country_id, :integer # legacy single-country shortcut- preference :country_iso, :string # legacy ISO-based shortcut-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def countries- isos = preferred_country_isos.presence || [preferred_country_iso].compact_blank- return Spree::Country.none if isos.blank?-- Spree::Country.where(iso: isos.map { |s| s.to_s.upcase })- end-- def eligible?(order, options = {})- allowed_isos = eligible_country_isos(order)- shipping_iso = options[:country_iso] || order.ship_address&.country_iso-- return true if allowed_isos.include?(shipping_iso)-- eligibility_errors.add(:base, eligibility_error_message(:wrong_country))- false- end-- # Effective list of eligible country ISOs, merging legacy- # single-country preferences into the multi-country list.- # Order-of-precedence: explicit ISO list > legacy single ISO- # > legacy single ID > store default. Memoized per-instance —- # eligibility checks fire repeatedly per cart change.- def eligible_country_isos(order = nil)- @eligible_country_isos ||= compute_eligible_country_isos(order)- end-- private-- def compute_eligible_country_isos(order)- return preferred_country_isos.map { |v| v.to_s.upcase } if preferred_country_isos.present?- return [preferred_country_iso.to_s.upcase] if preferred_country_iso.present?-- if preferred_country_id.present?- iso = Spree::Country.where(id: preferred_country_id).pick(:iso)- return [iso.to_s.upcase] if iso.present?- end-- return [] if order.nil?-- [order.store&.default_country&.iso, order.store&.default_market&.default_country&.iso].compact.map(&:upcase).uniq- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/currency.rb b/spree/core/app/models/spree/promotion_rules/currency.rbdeleted file mode 100644index 217eb0c510..0000000000--- a/spree/core/app/models/spree/promotion_rules/currency.rb+++ /dev/null@@ -1,19 +0,0 @@-# A rule to limit a promotion based on order currency.-module Spree- module PromotionRules- class Currency < Spree::PromotionRule- preference :currency, :string-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(order, options = {})- return true if order.currency == preferred_currency-- eligibility_errors.add(:base, eligibility_error_message(:wrong_currency))- false- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/customer_group.rb b/spree/core/app/models/spree/promotion_rules/customer_group.rbdeleted file mode 100644index 24bda25e4c..0000000000--- a/spree/core/app/models/spree/promotion_rules/customer_group.rb+++ /dev/null@@ -1,29 +0,0 @@-module Spree- module PromotionRules- class CustomerGroup < Spree::PromotionRule- # Stored as raw IDs. Accepts prefixed IDs (`cg_…`) from API- # callers and decodes them on write so eligibility checks can- # compare against raw `customer_group_id` rows directly.- preference :customer_group_ids, :array, default: [], parse_on_set: normalize_id_preference(klass: Spree::CustomerGroup)-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def customer_groups- return Spree::CustomerGroup.none if preferred_customer_group_ids.blank?-- Spree::CustomerGroup.where(id: preferred_customer_group_ids)- end-- def eligible?(order, _options = {})- return false unless order.user_id.present?- return false if preferred_customer_group_ids.empty?-- user_customer_group_ids = Spree::CustomerGroupUser.where(user_id: order.user_id).pluck(:customer_group_id).map(&:to_s)-- (preferred_customer_group_ids.map(&:to_s) & user_customer_group_ids).any?- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/first_order.rb b/spree/core/app/models/spree/promotion_rules/first_order.rbdeleted file mode 100644index 37cf191bdd..0000000000--- a/spree/core/app/models/spree/promotion_rules/first_order.rb+++ /dev/null@@ -1,42 +0,0 @@-module Spree- module PromotionRules- class FirstOrder < Spree::PromotionRule- attr_reader :user, :email, :store-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(order, options = {})- @user = order.try(:user) || options[:user]- @email = if options[:email].present?- order.email = options[:email]- order.email- elsif order.email.present?- order.email- end- @store = order.store-- if user || email- if !completed_orders.blank? && completed_orders.first != order- eligibility_errors.add(:base, eligibility_error_message(:not_first_order))- end- else- eligibility_errors.add(:base, eligibility_error_message(:no_user_or_email_specified))- end-- eligibility_errors.empty?- end-- private-- def completed_orders- user ? user.orders.for_store(store).complete : orders_by_email- end-- def orders_by_email- store.orders.where(email: email).complete- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/item_total.rb b/spree/core/app/models/spree/promotion_rules/item_total.rbdeleted file mode 100644index 0df8d524bd..0000000000--- a/spree/core/app/models/spree/promotion_rules/item_total.rb+++ /dev/null@@ -1,66 +0,0 @@-# A rule to apply to an order greater than (or greater than or equal to)-# a specific amount-module Spree- module PromotionRules- class ItemTotal < Spree::PromotionRule- preference :amount_min, :decimal, default: 100.00- preference :operator_min, :string, default: '>'- preference :amount_max, :decimal, default: nil, nullable: true- preference :operator_max, :string, default: '<'-- OPERATORS_MIN = ['gt', 'gte']- OPERATORS_MAX = ['lt', 'lte']-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(order, _options = {})- item_total = order.item_total-- lower_limit_condition = item_total.send(preferred_operator_min == 'gte' ? :>= : :>, BigDecimal(preferred_amount_min.to_s))-- if preferred_amount_max.present?- upper_limit_condition = item_total.send(preferred_operator_max == 'lte' ? :<= : :<, BigDecimal(preferred_amount_max.to_s))- else- upper_limit_condition = true- end-- eligibility_errors.add(:base, ineligible_message_max(order)) unless upper_limit_condition- eligibility_errors.add(:base, ineligible_message_min(order)) unless lower_limit_condition-- eligibility_errors.empty?- end-- private-- def formatted_amount_min(order)- Spree::Money.new(preferred_amount_min, currency: order.currency).to_s- end-- def formatted_amount_max(order)- if preferred_amount_max.present?- Spree::Money.new(preferred_amount_max, currency: order.currency).to_s- else- Spree.t('no_maximum')- end- end-- def ineligible_message_max(order)- if preferred_operator_max == 'lt'- eligibility_error_message(:item_total_more_than_or_equal, amount: formatted_amount_max(order))- else- eligibility_error_message(:item_total_more_than, amount: formatted_amount_max(order))- end- end-- def ineligible_message_min(order)- if preferred_operator_min == 'gte'- eligibility_error_message(:item_total_less_than, amount: formatted_amount_min(order))- else- eligibility_error_message(:item_total_less_than_or_equal, amount: formatted_amount_min(order))- end- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/market.rb b/spree/core/app/models/spree/promotion_rules/market.rbdeleted file mode 100644index 5c4ffe61e0..0000000000--- a/spree/core/app/models/spree/promotion_rules/market.rb+++ /dev/null@@ -1,35 +0,0 @@-# A rule to limit a promotion based on the order's market.-module Spree- module PromotionRules- class Market < Spree::PromotionRule- # Stored as raw IDs. Accepts prefixed IDs (`mkt_…`) from API- # callers and decodes them on write so eligibility checks compare- # against the order's raw `market_id` directly. Scope confines the- # existence check to the promotion's store so cross-store market- # IDs can't sneak in.- preference :market_ids, :array, default: [],- parse_on_set: normalize_id_preference(- klass: Spree::Market,- scope: ->(rule) { rule.promotion&.store&.markets || Spree::Market.none }- )-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def markets- return Spree::Market.none if preferred_market_ids.blank?-- promotion.store.markets.where(id: preferred_market_ids)- end-- def eligible?(order, _options = {})- return false if preferred_market_ids.empty?- return true if preferred_market_ids.map(&:to_s).include?(order.market_id.to_s)-- eligibility_errors.add(:base, eligibility_error_message(:no_matching_market))- false- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/one_use_per_user.rb b/spree/core/app/models/spree/promotion_rules/one_use_per_user.rbdeleted file mode 100644index 7ca72af271..0000000000--- a/spree/core/app/models/spree/promotion_rules/one_use_per_user.rb+++ /dev/null@@ -1,21 +0,0 @@-module Spree- module PromotionRules- class OneUsePerUser < Spree::PromotionRule- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(order, _options = {})- if order.user.present?- if promotion.used_by?(order.user, [order])- eligibility_errors.add(:base, eligibility_error_message(:limit_once_per_user))- end- else- eligibility_errors.add(:base, eligibility_error_message(:no_user_specified))- end-- eligibility_errors.empty?- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/option_value.rb b/spree/core/app/models/spree/promotion_rules/option_value.rbdeleted file mode 100644index 37818cae4d..0000000000--- a/spree/core/app/models/spree/promotion_rules/option_value.rb+++ /dev/null@@ -1,36 +0,0 @@-module Spree- module PromotionRules- class OptionValue < Spree::PromotionRule- MATCH_POLICIES = %w(any)- preference :match_policy, :string, default: MATCH_POLICIES.first- preference :eligible_values, :array, default: [], parse_on_set: lambda { |values|- values.flat_map { |v| v.to_s.split(',').compact_blank.map(&:strip) }- }-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(promotable, _options = {})- return false if eligible_option_value_variant_ids.empty?-- case preferred_match_policy- when 'any'- Spree::OptionValueVariant.where(id: eligible_option_value_variant_ids, variant_id: promotable.variant_ids).exists?- end- end-- def actionable?(line_item)- return false if eligible_option_value_variant_ids.empty?-- Spree::OptionValueVariant.where(id: eligible_option_value_variant_ids, variant_id: line_item.variant_id).exists?- end-- private-- def eligible_option_value_variant_ids- @eligible_option_value_variant_ids ||= preferred_eligible_values.map(&:to_s)- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/product.rb b/spree/core/app/models/spree/promotion_rules/product.rbdeleted file mode 100644index e24bae2751..0000000000--- a/spree/core/app/models/spree/promotion_rules/product.rb+++ /dev/null@@ -1,114 +0,0 @@-# A rule to limit a promotion based on products in the order.-# Can require all or any of the products to be present.-# Valid products either come from assigned product group or are assigned directly to the rule.-module Spree- module PromotionRules- class Product < Spree::PromotionRule- #- # Associations- #- has_many :product_promotion_rules, class_name: 'Spree::ProductPromotionRule',- foreign_key: :promotion_rule_id,- dependent: :destroy- has_many :products, through: :product_promotion_rules, class_name: 'Spree::Product'-- def self.additional_permitted_attributes- [product_ids: []]- end-- #- # Preferences- #- MATCH_POLICIES = %w(any all none)- preference :match_policy, :string, default: MATCH_POLICIES.first-- #- # Attributes- #- attr_accessor :product_ids_to_add-- #- # Callbacks- #- after_save :add_products-- # scope/association that is used to test eligibility- def eligible_products- products- end-- def eligible_product_ids- @eligible_product_ids ||= product_promotion_rules.pluck(:product_id)- end-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(order, _options = {})- return true if eligible_product_ids.empty?-- if preferred_match_policy == 'all'- unless eligible_product_ids.all? { |p| order.product_ids.include?(p) }- eligibility_errors.add(:base, eligibility_error_message(:missing_product))- end- elsif preferred_match_policy == 'any'- unless order.product_ids.any? { |p| eligible_product_ids.include?(p) }- eligibility_errors.add(:base, eligibility_error_message(:no_applicable_products))- end- else- unless order.product_ids.none? { |p| eligible_product_ids.include?(p) }- eligibility_errors.add(:base, eligibility_error_message(:has_excluded_product))- end- end-- eligibility_errors.empty?- end-- def actionable?(line_item)- case preferred_match_policy- when 'any', 'all'- eligible_product_ids.include? line_item.variant.product_id- when 'none'- eligible_product_ids.exclude? line_item.variant.product_id- else- raise "unexpected match policy: #{preferred_match_policy.inspect}"- end- end-- def product_ids_string- ActiveSupport::Deprecation.warn(- 'Please use `product_ids=` instead.'- )- product_ids.join(',')- end-- def product_ids_string=(s)- ActiveSupport::Deprecation.warn(- 'Please use `product_ids=` instead.'- )- self.product_ids = s- end-- private-- def add_products- return if product_ids_to_add.nil?-- product_promotion_rules.delete_all-- if product_ids_to_add.any?- Spree::ProductPromotionRule.insert_all(- product_ids_to_add.map { |product_id| { product_id: product_id, promotion_rule_id: id } }- )- end-- # Invalidate cache after bulk operations- touch-- # Clear memoized values- @eligible_product_ids = nil- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/taxon.rb b/spree/core/app/models/spree/promotion_rules/taxon.rbdeleted file mode 100644index d5a3dec4f4..0000000000--- a/spree/core/app/models/spree/promotion_rules/taxon.rb+++ /dev/null@@ -1,14 +0,0 @@-# frozen_string_literal: true--module Spree- module PromotionRules- # Deprecation alias for Spree::Promotion::Rules::Category, renamed from- # Spree::Promotion::Rules::Taxon in 6.0. A true constant alias, so old STI type- # strings (`'Spree::Promotion::Rules::Taxon'`) still instantiate correctly until- # the Phase 4 migration rewrites them. The warning fires when this file loads.- # Removed in 6.1.- Taxon = Category-- Spree::Deprecation.warn('Spree::PromotionRules::Taxon is deprecated and will be removed in Spree 6.1. Use Spree::PromotionRules::Category instead.')- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/user.rb b/spree/core/app/models/spree/promotion_rules/user.rbdeleted file mode 100644index 04b5972d9e..0000000000--- a/spree/core/app/models/spree/promotion_rules/user.rb+++ /dev/null@@ -1,92 +0,0 @@-module Spree- module PromotionRules- class User < Spree::PromotionRule- #- # Associations- #- has_many :promotion_rule_users, class_name: 'Spree::PromotionRuleUser',- foreign_key: :promotion_rule_id,- dependent: :destroy- has_many :users, through: :promotion_rule_users, class_name: "::#{Spree.user_class}"-- # Customers, not admin users — the rule keys off `Spree::Order#user_id`.- # The data layer keeps the `users` association (legacy column name);- # the API exposes the same set as `customer_ids`.- def self.additional_permitted_attributes- [customer_ids: []]- end-- # Wire-format shorthand is `customer` (the model is still `User`- # pre-6.0 rename, see docs/plans/6.0-platform-auth.md).- def self.api_type- 'customer'- end-- def customer_ids- user_ids- end-- def customer_ids=(ids)- self.user_ids = ids- end-- #- # Attributes- #- attr_accessor :user_ids_to_add-- #- # Callbacks- #- after_save :add_users-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible_user_ids- @eligible_user_ids ||= promotion_rule_users.pluck(:user_id)- end-- def eligible?(order, _options = {})- eligible_user_ids.include?(order.user_id)- end-- def user_ids_string- ActiveSupport::Deprecation.warn(- 'Spree::Promotion::Rules::User#user_ids_string is deprecated and will be removed in Spree 5.5. ' \- 'Please use `user_ids` instead.'- )- user_ids.join(',')- end-- def user_ids_string=(s)- ActiveSupport::Deprecation.warn(- 'Spree::Promotion::Rules::User#user_ids_string= is deprecated and will be removed in Spree 5.5. ' \- 'Please use `user_ids=` instead.'- )- self.user_ids = s- end-- private-- def add_users- return if user_ids_to_add.nil?-- promotion_rule_users.delete_all-- if user_ids_to_add.any?- Spree::PromotionRuleUser.insert_all(- user_ids_to_add.map { |user_id| { user_id: user_id, promotion_rule_id: id } }- )- end-- # Invalidate cache after bulk operations- touch-- # Clear memoized values- @eligible_user_ids = nil- end- end- end-enddiff --git a/spree/core/app/models/spree/promotion_rules/user_logged_in.rb b/spree/core/app/models/spree/promotion_rules/user_logged_in.rbdeleted file mode 100644index b6af300886..0000000000--- a/spree/core/app/models/spree/promotion_rules/user_logged_in.rb+++ /dev/null@@ -1,22 +0,0 @@-module Spree- module PromotionRules- class UserLoggedIn < Spree::PromotionRule- # Wire-format shorthand is `customer_logged_in` (the model is still- # `UserLoggedIn` pre-6.0 rename, see docs/plans/6.0-platform-auth.md).- def self.api_type- 'customer_logged_in'- end-- def applicable?(promotable)- promotable.is_a?(Spree::Order) || promotable.is_a?(Spree::Cart)- end-- def eligible?(order, _options = {})- unless order.user.present?- eligibility_errors.add(:base, eligibility_error_message(:no_user_specified))- end- eligibility_errors.empty?- end- end- end-enddiff --git a/spree/core/app/services/spree/carts/complete.rb b/spree/core/app/services/spree/carts/complete.rbindex 5edf722520..46a57e2bff 100644--- a/spree/core/app/services/spree/carts/complete.rb+++ b/spree/core/app/services/spree/carts/complete.rb@@ -110,6 +110,7 @@ module Spreeuser: cart.customer,token: cart.token,accept_marketing: cart.accept_marketing,+ preferred_stock_location_id: cart.preferred_stock_location_id,special_instructions: cart.special_instructions,last_ip_address: cart.last_ip_address,ship_address: cart.ship_address&.dup,diff --git a/spree/core/app/services/spree/orders/add_manual_discount.rb b/spree/core/app/services/spree/orders/add_manual_discount.rbnew file mode 100644index 0000000000..8a7a5305b4--- /dev/null+++ b/spree/core/app/services/spree/orders/add_manual_discount.rb@@ -0,0 +1,82 @@+module Spree+ module Orders+ # Creates manual (admin-issued) discount rows on an order and re-sums its+ # totals — the sanctioned post-placement discount path. A line-item target+ # gets a single row; an order-level discount is distributed across line+ # items largest-remainder over their discounted bases (there are no+ # order-attached discount rows). Amounts are clamped so no line goes+ # below zero.+ class AddManualDiscount+ prepend Spree::ServiceModule::Base++ # @param order [Spree::Order]+ # @param label [String]+ # @param value [Numeric] positive magnitude ("10" = 10 off / 10 percent off)+ # @param value_type [String] 'flat' or 'percent'+ # @param line_item [Spree::LineItem, nil] nil distributes order-level+ # @return [Spree::ServiceModule::Result] value is the created rows+ def call(order:, label:, value:, value_type: 'flat', line_item: nil)+ value = BigDecimal(value.to_s)+ return failure(nil, Spree.t('errors.messages.discount_value_must_be_positive')) unless value.positive?+ return failure(nil, Spree.t('errors.messages.discount_value_type_invalid')) unless %w[flat percent].include?(value_type)++ rows = order.with_lock do+ created = line_item ? [line_item_row(order, line_item, label, value, value_type)].compact : distributed_rows(order, label, value, value_type)+ order.updater.resum_typed_totals! if created.any?+ created+ end++ return failure(nil, Spree.t('errors.messages.discount_has_no_effect')) if rows.empty?++ success(rows)+ end++ private++ def line_item_row(order, line_item, label, value, value_type)+ base = discountable_base(line_item)+ amount = -[amount_for(base, value, value_type), base].min+ return if amount.zero?++ create_row(order, line_item, label, amount, value, value_type)+ end++ def distributed_rows(order, label, value, value_type)+ line_items = order.line_items.to_a+ bases = line_items.map { |line_item| [discountable_base(line_item), BigDecimal(0)].max }+ bases_sum = bases.sum+ return [] if bases_sum <= 0++ total = [amount_for(bases_sum, value, value_type), bases_sum].min+ shares = Spree::Adjusters::LargestRemainder.largest_remainder_shares((total * 100).round, bases)++ line_items.each_with_index.filter_map do |line_item, index|+ amount = -BigDecimal(shares[index]) / 100+ next if amount.zero?++ create_row(order, line_item, label, amount, value, value_type)+ end+ end++ def amount_for(base, value, value_type)+ value_type == 'percent' ? (base * value / 100).round(2) : value+ end++ # Remaining discountable base: amount net of already-applied discounts.+ def discountable_base(line_item)+ line_item.amount + line_item.owner.discounts.where(line_item_id: line_item.id).sum(:amount)+ end++ def create_row(order, line_item, label, amount, value, value_type)+ order.discounts.create!(+ line_item: line_item,+ label: label,+ amount: amount,+ kind: 'manual',+ value: value,+ value_type: value_type+ )+ end+ end+ end+enddiff --git a/spree/core/config/locales/en.yml b/spree/core/config/locales/en.ymlindex 5f1532eaf4..4fc140731d 100644--- a/spree/core/config/locales/en.yml+++ b/spree/core/config/locales/en.yml@@ -925,12 +925,18 @@ en:delivery_zone_prefix_and_range_exclusive: cannot be combined with a from/to rangedelivery_zone_range_inverted: must be greater than or equal to postal_code_fromdelivery_zone_range_not_supported: postal code ranges are not supported for this country — use prefixes+ discount_has_no_effect: discount would have no effect on this order+ discount_value_must_be_positive: discount value must be a positive number+ discount_value_type_invalid: value_type must be flat or percentexactly_one_adjustable: must be attached to exactly one adjustableexactly_one_of_cart_or_order: must belong to exactly one of cart or orderinvalid_order_routing_rule: is not a registered order routing ruleinvalid_order_routing_strategy: is not a registered order routing strategyinvalid_storefront_access: is not a valid storefront access levelmust_be_origin_only: must be an origin (scheme and host) without path, query, or fragment+ no_pickup_point_provider: this delivery method has no pickup point provider configured+ pickup_point_not_found: pickup point could not be found with this provider+ promotion_discount_not_editable: promotion discounts are managed by recalculation and cannot be editedstore_association_can_not_be_changed: The store association can not be changedstore_is_already_set: Store is already setservices:@@ -974,6 +980,17 @@ en:free_shipping: Free Shippingfrom: Fromfront_end: Front End+ fulfillment_mailer:+ fulfilled_email:+ dear_customer: Dear %{name},+ delivery_method: 'Delivery method: %{delivery_method}'+ fulfillment_summary: Fulfillment summary for order+ instructions: Your order %{number} has been fulfilled+ store_team: "%{store_name} Team"+ subject: Fulfillment Notification+ thanks: Thank you for your business.+ track_information: 'Tracking Information: %{tracking}'+ track_link: 'Tracking Link: %{url}'fulfillments:errors:insufficient_quantity: Requested quantity (%{requested}) for item %{item} exceeds its unfulfilled quantity (%{available})diff --git a/spree/core/db/migrate/20260729100001_add_checkout_columns_to_spree_carts.rb b/spree/core/db/migrate/20260729100001_add_checkout_columns_to_spree_carts.rbindex d2b721bf39..c7b84fe62e 100644--- a/spree/core/db/migrate/20260729100001_add_checkout_columns_to_spree_carts.rb+++ b/spree/core/db/migrate/20260729100001_add_checkout_columns_to_spree_carts.rb@@ -1,18 +1,18 @@class AddCheckoutColumnsToSpreeCarts < ActiveRecord::Migration[7.2]def changechange_table :spree_carts do |t|- t.decimal :item_total, precision: 10, scale: 2- t.decimal :adjustment_total, precision: 10, scale: 2- t.decimal :included_tax_total, precision: 10, scale: 2- t.decimal :additional_tax_total, precision: 10, scale: 2- t.decimal :taxable_adjustment_total, precision: 10, scale: 2- t.decimal :non_taxable_adjustment_total, precision: 10, scale: 2- t.decimal :promo_total, precision: 10, scale: 2- t.decimal :fee_total, precision: 10, scale: 2- t.decimal :delivery_total, precision: 10, scale: 2- t.decimal :total, precision: 10, scale: 2- t.decimal :payment_total, precision: 10, scale: 2- t.integer :item_count+ t.decimal :item_total, precision: 10, scale: 2, default: 0.0+ t.decimal :adjustment_total, precision: 10, scale: 2, default: 0.0+ t.decimal :included_tax_total, precision: 10, scale: 2, default: 0.0+ t.decimal :additional_tax_total, precision: 10, scale: 2, default: 0.0+ t.decimal :taxable_adjustment_total, precision: 10, scale: 2, default: 0.0+ t.decimal :non_taxable_adjustment_total, precision: 10, scale: 2, default: 0.0+ t.decimal :promo_total, precision: 10, scale: 2, default: 0.0+ t.decimal :fee_total, precision: 10, scale: 2, default: 0.0+ t.decimal :delivery_total, precision: 10, scale: 2, default: 0.0+ t.decimal :total, precision: 10, scale: 2, default: 0.0+ t.decimal :payment_total, precision: 10, scale: 2, default: 0.0+ t.integer :item_count, default: 0t.string :coupon_codeenddiff --git a/spree/core/lib/spree/core/dependencies.rb b/spree/core/lib/spree/core/dependencies.rbindex 503d319d66..3cabb16cbe 100644--- a/spree/core/lib/spree/core/dependencies.rb+++ b/spree/core/lib/spree/core/dependencies.rb@@ -49,6 +49,7 @@ module Spreeorder_approve_service: 'Spree::Orders::Approve',order_cancel_service: 'Spree::Orders::Cancel',order_complete_service: 'Spree::Orders::Complete',+ order_add_manual_discount_service: 'Spree::Orders::AddManualDiscount',order_create_service: 'Spree::Orders::Create',order_update_service: 'Spree::Orders::Update',order_updater: 'Spree::OrderUpdater',diff --git a/spree/core/lib/spree/core/engine.rb b/spree/core/lib/spree/core/engine.rbindex 97e6fa0d97..fba31de4eb 100644--- a/spree/core/lib/spree/core/engine.rb+++ b/spree/core/lib/spree/core/engine.rb@@ -39,7 +39,7 @@ module Spree:subscribers,:store_authentication_strategies,:admin_authentication_strategies)- SpreeCalculators = Struct.new(:shipping_methods, :tax_rates, :promotion_actions_create_adjustments, :promotion_actions_create_item_discounts, :promotion_actions_create_item_adjustments)+ SpreeCalculators = Struct.new(:shipping_methods, :tax_rates, :promotion_actions_create_adjustments, :promotion_actions_create_item_adjustments)PromoEnvironment = Struct.new(:rules, :actions)PricingEnvironment = Struct.new(:rules)OrderRoutingEnvironment = Struct.new(:strategies, :rules)@@ -203,30 +203,26 @@ module SpreeSpree::Calculator::TieredFlatRate]- Rails.application.config.spree.calculators.promotion_actions_create_item_discounts = [+ Rails.application.config.spree.calculators.promotion_actions_create_item_adjustments = [Spree::Calculator::PercentOnLineItem,Spree::Calculator::FlatRate,Spree::Calculator::FlexiRate]- # Legacy registry key — removed in 6.1. Kept so extensions appending- # to it keep working; CreateItemDiscounts reads the new key above.- Rails.application.config.spree.calculators.promotion_actions_create_item_adjustments =- Rails.application.config.spree.calculators.promotion_actions_create_item_discountsRails.application.config.spree.promotions.rules.concat [- Spree::PromotionRules::Currency,- Spree::PromotionRules::Country,- Spree::PromotionRules::Channel,- Spree::PromotionRules::Market,- Spree::PromotionRules::ItemTotal,- Spree::PromotionRules::Product,- Spree::PromotionRules::User,- Spree::PromotionRules::CustomerGroup,- Spree::PromotionRules::FirstOrder,- Spree::PromotionRules::UserLoggedIn,- Spree::PromotionRules::OneUsePerUser,- Spree::PromotionRules::Category,- Spree::PromotionRules::OptionValue,+ Spree::Promotion::Rules::Currency,+ Spree::Promotion::Rules::Country,+ Spree::Promotion::Rules::Channel,+ Spree::Promotion::Rules::Market,+ Spree::Promotion::Rules::ItemTotal,+ Spree::Promotion::Rules::Product,+ Spree::Promotion::Rules::User,+ Spree::Promotion::Rules::CustomerGroup,+ Spree::Promotion::Rules::FirstOrder,+ Spree::Promotion::Rules::UserLoggedIn,+ Spree::Promotion::Rules::OneUsePerUser,+ Spree::Promotion::Rules::Category,+ Spree::Promotion::Rules::OptionValue,]# Default registry. MarketRule is included so existing installs@@ -245,10 +241,10 @@ module Spree]Rails.application.config.spree.promotions.actions = [- PromotionActions::CreateAdjustment,- PromotionActions::CreateItemDiscounts,- PromotionActions::CreateLineItems,- PromotionActions::FreeShipping+ Promotion::Actions::CreateAdjustment,+ Promotion::Actions::CreateItemAdjustments,+ Promotion::Actions::CreateLineItems,+ Promotion::Actions::FreeShipping]Rails.application.config.spree.data_feed_types = [diff --git a/spree/core/lib/spree/core/preferences/preferable.rb b/spree/core/lib/spree/core/preferences/preferable.rbindex 461b7972a7..ef8762419f 100644--- a/spree/core/lib/spree/core/preferences/preferable.rb+++ b/spree/core/lib/spree/core/preferences/preferable.rb@@ -76,8 +76,12 @@ module Spree::Preferences::Preferableenddef defined_preferences- methods.grep(/\Apreferred_.*=\Z/).map do |pref_method|- pref_method.to_s.gsub(/\Apreferred_|=\Z/, '').to_sym+ # Only real `preference`-macro definitions carry a `_default` getter —+ # the name grep alone would also catch `preferred_*` association writers+ # (e.g. Order#preferred_stock_location=).+ methods.grep(/\Apreferred_.*=\Z/).filter_map do |pref_method|+ name = pref_method.to_s.gsub(/\Apreferred_|=\Z/, '').to_sym+ name if respond_to?(self.class.preference_default_getter_method(name))endenddiff --git a/spree/core/lib/spree/core/preferences/preferable_class_methods.rb b/spree/core/lib/spree/core/preferences/preferable_class_methods.rbindex 0a14fe320a..d2e7e9ffdb 100644--- a/spree/core/lib/spree/core/preferences/preferable_class_methods.rb+++ b/spree/core/lib/spree/core/preferences/preferable_class_methods.rb@@ -12,7 +12,9 @@ module Spree::Preferences# cache_key will be nil for new objects, then if we check if there# is a pending preference before going to defaultdefine_method preference_getter_method(name) do- preferences.fetch(name) do+ # Rows persisted before the model gained preferences can load with a+ # NULL column — treat that as "no stored preferences".+ (preferences || {}).fetch(name) dodefault.callendend@@ -26,6 +28,7 @@ module Spree::Preferencesvalue = parse_on_set.arity.abs > 1 ? parse_on_set.call(value, self) : parse_on_set.call(value)endvalue = convert_preference_value(value, type, nullable: nullable)+ self.preferences = {} if preferences.nil?preferences[name] = valueSpree::Deprecation.warn("`#{name}` is deprecated. #{deprecated}") if deprecateddiff --git a/spree/core/lib/spree/testing_support/factories/promotion_action_factory.rb b/spree/core/lib/spree/testing_support/factories/promotion_action_factory.rbindex 5a98042983..de49278899 100644--- a/spree/core/lib/spree/testing_support/factories/promotion_action_factory.rb+++ b/spree/core/lib/spree/testing_support/factories/promotion_action_factory.rb@@ -3,12 +3,12 @@ FactoryBot.define doassociation :promotionend- factory :promotion_action_create_adjustment, class: Spree::PromotionActions::CreateAdjustment do+ factory :promotion_action_create_adjustment, class: Spree::Promotion::Actions::CreateAdjustment doassociation :promotionassociation :calculator, factory: :flat_rate_calculatorend- factory :promotion_action_create_line_items, class: Spree::PromotionActions::CreateLineItems do+ factory :promotion_action_create_line_items, class: Spree::Promotion::Actions::CreateLineItems doassociation :promotionendenddiff --git a/spree/core/lib/spree/testing_support/factories/promotion_factory.rb b/spree/core/lib/spree/testing_support/factories/promotion_factory.rbindex b73cd07971..0998179bcf 100644--- a/spree/core/lib/spree/testing_support/factories/promotion_factory.rb+++ b/spree/core/lib/spree/testing_support/factories/promotion_factory.rb@@ -30,7 +30,7 @@ FactoryBot.define doafter(:create) do |promotion, evaluator|calculator = Spree::Calculator::FlatRate.newcalculator.preferred_amount = evaluator.adjustment_rate- Spree::PromotionActions::CreateItemDiscounts.create!(calculator: calculator, promotion: promotion)+ Spree::Promotion::Actions::CreateItemAdjustments.create!(calculator: calculator, promotion: promotion)endend@@ -52,7 +52,7 @@ FactoryBot.define doafter(:create) do |promotion, evaluator|calculator = Spree::Calculator::FlatRate.newcalculator.preferred_amount = evaluator.weighted_order_adjustment_amount- Spree::PromotionActions::CreateAdjustment.create!(calculator: calculator, promotion: promotion)+ Spree::Promotion::Actions::CreateAdjustment.create!(calculator: calculator, promotion: promotion)endend@@ -63,7 +63,7 @@ FactoryBot.define doname { 'Free Shipping Promotion' }after(:create) do |promotion|- Spree::PromotionActions::FreeShipping.create!(promotion: promotion)+ Spree::Promotion::Actions::FreeShipping.create!(promotion: promotion)endfactory :free_shipping_promotion_with_item_total_rule, traits: [:with_item_total_rule]diff --git a/spree/core/lib/tasks/categories_and_collections.rake b/spree/core/lib/tasks/categories_and_collections.rakeindex 7db7bca910..3467acb8fc 100644--- a/spree/core/lib/tasks/categories_and_collections.rake+++ b/spree/core/lib/tasks/categories_and_collections.rake@@ -164,7 +164,7 @@ namespace :spree do[ActionText::RichText, :record_type, 'Spree::Taxon', 'Spree::Category'],[FriendlyId::Slug, :sluggable_type, 'Spree::Taxon', 'Spree::Category'],[Spree::PromotionRule, :type, 'Spree::Promotion::Rules::Taxon', 'Spree::Promotion::Rules::Category'],- [Spree::PromotionRule, :type, 'Spree::PromotionRules::Taxon', 'Spree::PromotionRules::Category']+ [Spree::PromotionRule, :type, 'Spree::Promotion::Rules::Taxon', 'Spree::Promotion::Rules::Category']].each do |model, column, from, to|count = model.where(column => from).update_all(column => to)puts " #{model.table_name}.#{column}: #{count} rows #{from} -> #{to}"diff --git a/spree/core/spec/helpers/base_helper_spec.rb b/spree/core/spec/helpers/base_helper_spec.rbindex 404d7c6664..06c8c082eb 100644--- a/spree/core/spec/helpers/base_helper_spec.rb+++ b/spree/core/spec/helpers/base_helper_spec.rb@@ -22,14 +22,15 @@ describe Spree::BaseHelper, type: :helper docreate(:market, store: current_store, countries: [country], currency: 'USD', default: true)end- it 'returns only the countries from markets' do- expect(available_countries).to eq([country])+ it 'returns the countries from all markets including the bootstrap market' do+ us = Spree::Country.find_by(iso: 'US')+ expect(available_countries).to contain_exactly(country, us)endend- context 'without markets' do- it 'returns complete list of countries' do- expect(available_countries).to contain_exactly(*Spree::Country.all)+ context 'without extra markets' do+ it 'returns the bootstrap market country' do+ expect(available_countries.map(&:iso)).to eq(['US'])endendenddiff --git a/spree/core/spec/lib/spree/core/controller_helpers/locale_spec.rb b/spree/core/spec/lib/spree/core/controller_helpers/locale_spec.rbindex d801b2dd0f..f6f47ead79 100644--- a/spree/core/spec/lib/spree/core/controller_helpers/locale_spec.rb+++ b/spree/core/spec/lib/spree/core/controller_helpers/locale_spec.rb@@ -71,8 +71,10 @@ describe Spree::Core::ControllerHelpers::Locale, type: :controller doallow(I18n).to receive(:default_locale).and_return(:de)end- it 'fallbacks to the default application locale' do- expect(controller.current_locale.to_s).to eq('de')+ it 'still resolves through the bootstrap market locale' do+ # Every store owns a default market in 6.0, so the application+ # locale fallback no longer participates.+ expect(controller.current_locale.to_s).to eq('en')endendenddiff --git a/spree/core/spec/lib/tasks/categories_and_collections_spec.rb b/spree/core/spec/lib/tasks/categories_and_collections_spec.rbindex dc768592b9..13c8ad9b63 100644--- a/spree/core/spec/lib/tasks/categories_and_collections_spec.rb+++ b/spree/core/spec/lib/tasks/categories_and_collections_spec.rb@@ -83,14 +83,14 @@ describe 'spree:migrate_taxons_to_categories_and_collections' docreate(:metafield).tap { |m| m.update_column(:resource_type, 'Spree::Taxon') }endlet!(:promotion_rule) do- create(:promotion_rule_taxon).tap { |r| r.update_column(:type, 'Spree::PromotionRules::Taxon') }+ create(:promotion_rule_taxon).tap { |r| r.update_column(:type, 'Spree::Promotion::Rules::Taxon') }endit 'rewrites Spree::Taxon* strings to Spree::Category*' dosubject.invokeexpect(metafield.reload.resource_type).to eq('Spree::Category')- expect(Spree::PromotionRule.where(id: promotion_rule.id).pick(:type)).to eq('Spree::PromotionRules::Category')+ expect(Spree::PromotionRule.where(id: promotion_rule.id).pick(:type)).to eq('Spree::Promotion::Rules::Category')endenddiff --git a/spree/core/spec/models/spree/adjusters/promotion_spec.rb b/spree/core/spec/models/spree/adjusters/promotion_spec.rbindex 62c11a684a..9b49fff14d 100644--- a/spree/core/spec/models/spree/adjusters/promotion_spec.rb+++ b/spree/core/spec/models/spree/adjusters/promotion_spec.rb@@ -61,7 +61,7 @@ describe Spree::Adjusters::Promotion, type: :model doit 'clamps so a line never goes below zero' dopromo = create(:promotion, kind: :automatic, code: nil, stores: [store])- action = Spree::PromotionActions::CreateItemDiscounts.create!(+ action = Spree::Promotion::Actions::CreateItemAdjustments.create!(promotion: promo,calculator: Spree::Calculator::FlatRate.new(preferred_amount: 999))diff --git a/spree/core/spec/models/spree/country_spec.rb b/spree/core/spec/models/spree/country_spec.rbindex 48a07cc5c9..a9bf92d931 100644--- a/spree/core/spec/models/spree/country_spec.rb+++ b/spree/core/spec/models/spree/country_spec.rb@@ -50,7 +50,7 @@ describe Spree::Country, type: :model doenddescribe '#current_market' do- let!(:market) { create(:market, store: store, countries: [america], currency: 'USD') }+ let!(:market) { store.default_market }before doallow(Spree::Current).to receive(:store).and_return(store)diff --git a/spree/core/spec/models/spree/current_spec.rb b/spree/core/spec/models/spree/current_spec.rbindex db194333cf..780a615f3a 100644--- a/spree/core/spec/models/spree/current_spec.rb+++ b/spree/core/spec/models/spree/current_spec.rb@@ -192,11 +192,11 @@ RSpec.describe Spree::Current doendend- context 'when market is not set and store has no markets' do+ context 'when market is not set' dolet!(:store) { create(:store, default: true) }- it 'returns nil' do- expect(described_class.market).to be_nil+ it 'falls back to the store default market' do+ expect(described_class.market).to eq(store.default_market)endendenddiff --git a/spree/core/spec/models/spree/market_spec.rb b/spree/core/spec/models/spree/market_spec.rbindex eee9f872fe..7d460bb081 100644--- a/spree/core/spec/models/spree/market_spec.rb+++ b/spree/core/spec/models/spree/market_spec.rb@@ -69,13 +69,13 @@ RSpec.describe Spree::Market, type: :model doendit 'falls back to first by position' do- market = create(:market, store: store, position: 1)- create(:market, store: store, position: 2)+ store.markets.update_all(default: false)+ market = store.markets.order(:position).firstexpect(described_class.default_for_store(store)).to eq(market)end- it 'returns nil for store without markets' do- expect(described_class.default_for_store(store)).to be_nil+ it 'always resolves — every store owns an auto-created default market' do+ expect(described_class.default_for_store(store)).to eq(store.default_market)endend@@ -209,7 +209,7 @@ RSpec.describe Spree::Market, type: :model doendit 'returns false for the only market in a store' do- market = create(:market, store: store)+ market = store.markets.soleexpect(market.can_be_deleted?).to be falseend@@ -230,7 +230,8 @@ RSpec.describe Spree::Market, type: :model doendit 'does not allow destroying the only market in a store' do- market = create(:market, store: store)+ market = store.markets.sole+ market.update_column(:default, false)expect(market.destroy).to be falseexpect(market.reload.deleted_at).to be_nilexpect(market.errors[:base]).to include(I18n.t('activerecord.errors.models.spree/market.attributes.base.cannot_destroy_last_market'))@@ -245,7 +246,8 @@ RSpec.describe Spree::Market, type: :model doit 'does not affect markets in other stores when checking for last market' doother_store = create(:store)create(:market, store: other_store)- market = create(:market, store: store)+ market = store.markets.sole+ market.update_column(:default, false)expect(market.destroy).to be falseexpect(market.errors[:base]).to include(I18n.t('activerecord.errors.models.spree/market.attributes.base.cannot_destroy_last_market'))enddiff --git a/spree/core/spec/models/spree/order/totals_spec.rb b/spree/core/spec/models/spree/order/totals_spec.rbindex 4b04632db8..14997ccb6d 100644--- a/spree/core/spec/models/spree/order/totals_spec.rb+++ b/spree/core/spec/models/spree/order/totals_spec.rb@@ -9,7 +9,7 @@ module Spreecontext 'adds item to cart and activates promo' dolet(:promotion) { create(:promotion, name: 'Huhu', kind: :automatic) }let(:calculator) { Calculator::FlatPercentItemTotal.new(preferred_flat_percent: 10) }- let!(:action) { PromotionActions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Promotion::Actions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }before { Spree::Carts::AddItem.call(order: order, variant: shirt).value }diff --git a/spree/core/spec/models/spree/order_updater_spec.rb b/spree/core/spec/models/spree/order_updater_spec.rbindex 34769e075f..e06b539762 100644--- a/spree/core/spec/models/spree/order_updater_spec.rb+++ b/spree/core/spec/models/spree/order_updater_spec.rb@@ -36,7 +36,7 @@ module Spreelet(:calculator) { Calculator::FlatPercentItemTotal.new(preferred_flat_percent: 10) }let(:promotion_action) do- PromotionActions::CreateAdjustment.create!(calculator: calculator,+ Promotion::Actions::CreateAdjustment.create!(calculator: calculator,promotion: promotion)enddiff --git a/spree/core/spec/models/spree/promotion_actions/create_adjustment_spec.rb b/spree/core/spec/models/spree/promotion/actions/create_adjustment_spec.rbsimilarity index 94%rename from spree/core/spec/models/spree/promotion_actions/create_adjustment_spec.rbrename to spree/core/spec/models/spree/promotion/actions/create_adjustment_spec.rbindex f70b22e717..f7df1b216b 100644--- a/spree/core/spec/models/spree/promotion_actions/create_adjustment_spec.rb+++ b/spree/core/spec/models/spree/promotion/actions/create_adjustment_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionActions::CreateAdjustment, type: :model do+describe Spree::Promotion::Actions::CreateAdjustment, type: :model dolet(:order) { create(:order_with_line_items, line_items_count: 2) }let(:promotion) { create(:promotion, kind: :automatic, code: nil, stores: [order.store]) }let(:action) dodiff --git a/spree/core/spec/models/spree/promotion_actions/create_item_discounts_spec.rb b/spree/core/spec/models/spree/promotion/actions/create_item_adjustments_spec.rbsimilarity index 96%rename from spree/core/spec/models/spree/promotion_actions/create_item_discounts_spec.rbrename to spree/core/spec/models/spree/promotion/actions/create_item_adjustments_spec.rbindex 6ed0430256..56c454256b 100644--- a/spree/core/spec/models/spree/promotion_actions/create_item_discounts_spec.rb+++ b/spree/core/spec/models/spree/promotion/actions/create_item_adjustments_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionActions::CreateItemDiscounts, type: :model do+describe Spree::Promotion::Actions::CreateItemAdjustments, type: :model dolet(:order) { create(:order_with_line_items, line_items_count: 2) }let(:promotion) { create(:promotion, kind: :automatic, code: nil, stores: [order.store]) }let(:action) dodiff --git a/spree/core/spec/models/spree/promotion_actions/create_line_items_spec.rb b/spree/core/spec/models/spree/promotion/actions/create_line_items_spec.rbsimilarity index 96%rename from spree/core/spec/models/spree/promotion_actions/create_line_items_spec.rbrename to spree/core/spec/models/spree/promotion/actions/create_line_items_spec.rbindex 7860dbc00c..b3857249af 100644--- a/spree/core/spec/models/spree/promotion_actions/create_line_items_spec.rb+++ b/spree/core/spec/models/spree/promotion/actions/create_line_items_spec.rb@@ -1,8 +1,8 @@require 'spec_helper'-describe Spree::PromotionActions::CreateLineItems, type: :model do+describe Spree::Promotion::Actions::CreateLineItems, type: :model dolet(:order) { create(:order) }- let(:action) { Spree::PromotionActions::CreateLineItems.create!(promotion: promotion) }+ let(:action) { Spree::Promotion::Actions::CreateLineItems.create!(promotion: promotion) }let(:promotion) { create(:promotion) }let(:shirt) { create(:variant) }let(:mug) { create(:variant) }diff --git a/spree/core/spec/models/spree/promotion_actions/free_shipping_spec.rb b/spree/core/spec/models/spree/promotion/actions/free_shipping_spec.rbsimilarity index 95%rename from spree/core/spec/models/spree/promotion_actions/free_shipping_spec.rbrename to spree/core/spec/models/spree/promotion/actions/free_shipping_spec.rbindex dc546fc7ef..3206b9bbbe 100644--- a/spree/core/spec/models/spree/promotion_actions/free_shipping_spec.rb+++ b/spree/core/spec/models/spree/promotion/actions/free_shipping_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionActions::FreeShipping, type: :model do+describe Spree::Promotion::Actions::FreeShipping, type: :model dolet(:order) { create(:order_with_line_items, line_items_count: 1) }let(:promotion) { create(:promotion, kind: :automatic, code: nil, stores: [order.store]) }let(:action) { described_class.create!(promotion: promotion) }diff --git a/spree/core/spec/models/spree/promotion_rules/channel_spec.rb b/spree/core/spec/models/spree/promotion/rules/channel_spec.rbsimilarity index 97%rename from spree/core/spec/models/spree/promotion_rules/channel_spec.rbrename to spree/core/spec/models/spree/promotion/rules/channel_spec.rbindex fddd71af98..813c8bb9f5 100644--- a/spree/core/spec/models/spree/promotion_rules/channel_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/channel_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::Channel, type: :model do+describe Spree::Promotion::Rules::Channel, type: :model dolet(:store) { @default_store }let(:promotion) { create(:promotion, store: store) }let(:rule) { described_class.new(promotion: promotion) }diff --git a/spree/core/spec/models/spree/promotion_rules/country_spec.rb b/spree/core/spec/models/spree/promotion/rules/country_spec.rbsimilarity index 97%rename from spree/core/spec/models/spree/promotion_rules/country_spec.rbrename to spree/core/spec/models/spree/promotion/rules/country_spec.rbindex fd41c2a5d0..4315504d04 100644--- a/spree/core/spec/models/spree/promotion_rules/country_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/country_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::Country, type: :model do+describe Spree::Promotion::Rules::Country, type: :model dolet!(:store) { create(:store, default_country: other_country) }let(:rule) { described_class.new }let(:order) { create(:order, store: store) }diff --git a/spree/core/spec/models/spree/promotion_rules/currency_spec.rb b/spree/core/spec/models/spree/promotion/rules/currency_spec.rbsimilarity index 94%rename from spree/core/spec/models/spree/promotion_rules/currency_spec.rbrename to spree/core/spec/models/spree/promotion/rules/currency_spec.rbindex e6d8ee8ec3..de95e7a619 100644--- a/spree/core/spec/models/spree/promotion_rules/currency_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/currency_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::Currency, type: :model do+describe Spree::Promotion::Rules::Currency, type: :model dolet(:store) { @default_store }let(:rule) { described_class.new }let(:order) { create(:order, store: store) }diff --git a/spree/core/spec/models/spree/promotion_rules/customer_group_spec.rb b/spree/core/spec/models/spree/promotion/rules/customer_group_spec.rbsimilarity index 94%rename from spree/core/spec/models/spree/promotion_rules/customer_group_spec.rbrename to spree/core/spec/models/spree/promotion/rules/customer_group_spec.rbindex ea38a3c2e8..d2e1441674 100644--- a/spree/core/spec/models/spree/promotion_rules/customer_group_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/customer_group_spec.rb@@ -1,8 +1,8 @@require 'spec_helper'-describe Spree::PromotionRules::CustomerGroup, type: :model do+describe Spree::Promotion::Rules::CustomerGroup, type: :model dolet(:store) { @default_store }- let(:rule) { Spree::PromotionRules::CustomerGroup.new }+ let(:rule) { Spree::Promotion::Rules::CustomerGroup.new }let(:customer_group) { create(:customer_group, store: store) }let(:other_customer_group) { create(:customer_group, store: store) }let(:user) { create(:user) }diff --git a/spree/core/spec/models/spree/promotion_rules/first_order_spec.rb b/spree/core/spec/models/spree/promotion/rules/first_order_spec.rbsimilarity index 97%rename from spree/core/spec/models/spree/promotion_rules/first_order_spec.rbrename to spree/core/spec/models/spree/promotion/rules/first_order_spec.rbindex 842e5f38b1..e1fced8443 100644--- a/spree/core/spec/models/spree/promotion_rules/first_order_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/first_order_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::FirstOrder, type: :model do+describe Spree::Promotion::Rules::FirstOrder, type: :model dolet(:store) { @default_store }let(:rule) { described_class.new }let(:user) { create(:user) }diff --git a/spree/core/spec/models/spree/promotion_rules/item_total_spec.rb b/spree/core/spec/models/spree/promotion/rules/item_total_spec.rbsimilarity index 98%rename from spree/core/spec/models/spree/promotion_rules/item_total_spec.rbrename to spree/core/spec/models/spree/promotion/rules/item_total_spec.rbindex 13d385f870..303b318a33 100644--- a/spree/core/spec/models/spree/promotion_rules/item_total_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/item_total_spec.rb@@ -1,8 +1,8 @@require 'spec_helper'-describe Spree::PromotionRules::ItemTotal, type: :model do+describe Spree::Promotion::Rules::ItemTotal, type: :model dolet!(:store) { @default_store }- let(:rule) { Spree::PromotionRules::ItemTotal.new }+ let(:rule) { Spree::Promotion::Rules::ItemTotal.new }let(:order) { build(:order, store: store) }before dodiff --git a/spree/core/spec/models/spree/promotion_rules/market_spec.rb b/spree/core/spec/models/spree/promotion/rules/market_spec.rbsimilarity index 97%rename from spree/core/spec/models/spree/promotion_rules/market_spec.rbrename to spree/core/spec/models/spree/promotion/rules/market_spec.rbindex b7c2531b22..92ffca4059 100644--- a/spree/core/spec/models/spree/promotion_rules/market_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/market_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::Market, type: :model do+describe Spree::Promotion::Rules::Market, type: :model dolet(:store) { @default_store }let(:promotion) { create(:promotion, store: store) }let(:rule) { described_class.new(promotion: promotion) }diff --git a/spree/core/spec/models/spree/promotion_rules/one_use_per_user_spec.rb b/spree/core/spec/models/spree/promotion/rules/one_use_per_user_spec.rbsimilarity index 95%rename from spree/core/spec/models/spree/promotion_rules/one_use_per_user_spec.rbrename to spree/core/spec/models/spree/promotion/rules/one_use_per_user_spec.rbindex 18ee7860ab..802ee13881 100644--- a/spree/core/spec/models/spree/promotion_rules/one_use_per_user_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/one_use_per_user_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::OneUsePerUser, type: :model do+describe Spree::Promotion::Rules::OneUsePerUser, type: :model dolet(:rule) { described_class.new }describe '#eligible?(order)' dodiff --git a/spree/core/spec/models/spree/promotion_rules/option_value_spec.rb b/spree/core/spec/models/spree/promotion/rules/option_value_spec.rbsimilarity index 98%rename from spree/core/spec/models/spree/promotion_rules/option_value_spec.rbrename to spree/core/spec/models/spree/promotion/rules/option_value_spec.rbindex 97bc305ea0..1a16596f1c 100644--- a/spree/core/spec/models/spree/promotion_rules/option_value_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/option_value_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::OptionValue do+describe Spree::Promotion::Rules::OptionValue dolet(:rule) { described_class.new }describe 'setting eligible values' dodiff --git a/spree/core/spec/models/spree/promotion_rules/product_spec.rb b/spree/core/spec/models/spree/promotion/rules/product_spec.rbsimilarity index 98%rename from spree/core/spec/models/spree/promotion_rules/product_spec.rbrename to spree/core/spec/models/spree/promotion/rules/product_spec.rbindex c13c4263be..32617b2642 100644--- a/spree/core/spec/models/spree/promotion_rules/product_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/product_spec.rb@@ -1,7 +1,7 @@require 'spec_helper'-describe Spree::PromotionRules::Product, type: :model do- let(:rule) { Spree::PromotionRules::Product.new(rule_options) }+describe Spree::Promotion::Rules::Product, type: :model do+ let(:rule) { Spree::Promotion::Rules::Product.new(rule_options) }let(:rule_options) { {} }describe '#eligible?(order)' dodiff --git a/spree/core/spec/models/spree/promotion_rules/taxon_spec.rb b/spree/core/spec/models/spree/promotion/rules/taxon_spec.rbsimilarity index 98%rename from spree/core/spec/models/spree/promotion_rules/taxon_spec.rbrename to spree/core/spec/models/spree/promotion/rules/taxon_spec.rbindex 6d062f127e..db016c6132 100644--- a/spree/core/spec/models/spree/promotion_rules/taxon_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/taxon_spec.rb@@ -1,6 +1,6 @@require 'spec_helper'-describe Spree::PromotionRules::Category, type: :model do+describe Spree::Promotion::Rules::Category, type: :model dolet(:store) { @default_store }let(:promotion) { create(:promotion) }let(:rule) { create(:promotion_rule_taxon, promotion: promotion) }diff --git a/spree/core/spec/models/spree/promotion_rules/user_logged_in_spec.rb b/spree/core/spec/models/spree/promotion/rules/user_logged_in_spec.rbsimilarity index 84%rename from spree/core/spec/models/spree/promotion_rules/user_logged_in_spec.rbrename to spree/core/spec/models/spree/promotion/rules/user_logged_in_spec.rbindex 86b4ff3238..4985ec3cd2 100644--- a/spree/core/spec/models/spree/promotion_rules/user_logged_in_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/user_logged_in_spec.rb@@ -1,7 +1,7 @@require 'spec_helper'-describe Spree::PromotionRules::UserLoggedIn, type: :model do- let(:rule) { Spree::PromotionRules::UserLoggedIn.new }+describe Spree::Promotion::Rules::UserLoggedIn, type: :model do+ let(:rule) { Spree::Promotion::Rules::UserLoggedIn.new }context '#eligible?(order)' dolet(:order) { Spree::Order.new }diff --git a/spree/core/spec/models/spree/promotion_rules/user_spec.rb b/spree/core/spec/models/spree/promotion/rules/user_spec.rbsimilarity index 95%rename from spree/core/spec/models/spree/promotion_rules/user_spec.rbrename to spree/core/spec/models/spree/promotion/rules/user_spec.rbindex a3b2fb662a..5a1ac30740 100644--- a/spree/core/spec/models/spree/promotion_rules/user_spec.rb+++ b/spree/core/spec/models/spree/promotion/rules/user_spec.rb@@ -1,7 +1,7 @@require 'spec_helper'-describe Spree::PromotionRules::User, type: :model do- let(:rule) { Spree::PromotionRules::User.new }+describe Spree::Promotion::Rules::User, type: :model do+ let(:rule) { Spree::Promotion::Rules::User.new }let(:random_user) { create :user }let(:user_placing_order) { create :user }diff --git a/spree/core/spec/models/spree/promotion_handler/cart_spec.rb b/spree/core/spec/models/spree/promotion_handler/cart_spec.rbindex d6e8ee5037..ad0f18aee9 100644--- a/spree/core/spec/models/spree/promotion_handler/cart_spec.rb+++ b/spree/core/spec/models/spree/promotion_handler/cart_spec.rb@@ -12,7 +12,7 @@ module Spreelet(:calculator) { Calculator::FlatPercentItemTotal.new(preferred_flat_percent: 10) }context 'activates in LineItem level' do- let!(:action) { PromotionActions::CreateItemDiscounts.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Promotion::Actions::CreateItemAdjustments.create(promotion: promotion, calculator: calculator) }let(:adjustable) { line_item }shared_context 'creates the adjustment' do@@ -28,14 +28,14 @@ module Spreeendcontext 'promotion includes item involved' do- let!(:rule) { PromotionRules::Product.create(products: [line_item.product], promotion: promotion) }+ let!(:rule) { Promotion::Rules::Product.create(products: [line_item.product], promotion: promotion) }include_context 'creates the adjustment'endcontext 'promotion has item total rule' dolet(:shirt) { create(:product, store: order.store) }- let!(:rule) { PromotionRules::ItemTotal.create(preferred_operator_min: 'gt', preferred_amount_min: 50, preferred_operator_max: 'lt', preferred_amount_max: 150, promotion: promotion) }+ let!(:rule) { Promotion::Rules::ItemTotal.create(preferred_operator_min: 'gt', preferred_amount_min: 50, preferred_operator_max: 'lt', preferred_amount_max: 150, promotion: promotion) }before do# Makes the order eligible for this promotion@@ -48,7 +48,7 @@ module Spreeendcontext 'activates in Order level' do- let!(:action) { PromotionActions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Promotion::Actions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }let(:adjustable) { order }shared_context 'creates the adjustment' do@@ -71,7 +71,7 @@ module Spreecontext 'promotion has item total rule' dolet(:shirt) { create(:product, store: order.store) }- let!(:rule) { PromotionRules::ItemTotal.create(preferred_operator_min: 'gt', preferred_amount_min: 50, preferred_operator_max: 'lt', preferred_amount_max: 150, promotion: promotion) }+ let!(:rule) { Promotion::Rules::ItemTotal.create(preferred_operator_min: 'gt', preferred_amount_min: 50, preferred_operator_max: 'lt', preferred_amount_max: 150, promotion: promotion) }before do# Makes the order eligible for this promotiondiff --git a/spree/core/spec/models/spree/promotion_handler/coupon_spec.rb b/spree/core/spec/models/spree/promotion_handler/coupon_spec.rbindex 3a6ac0e1f9..7b150213fa 100644--- a/spree/core/spec/models/spree/promotion_handler/coupon_spec.rb+++ b/spree/core/spec/models/spree/promotion_handler/coupon_spec.rb@@ -127,7 +127,7 @@ module Spreeallow(order).to receive_messages coupon_code: '10off'calculator = Calculator::FlatRate.new(preferred_amount: 10)general_promo = create(:promotion, name: 'General Promo', store: order.store)- PromotionActions::CreateItemDiscounts.create(promotion: general_promo, calculator: calculator) # general_action+ Promotion::Actions::CreateItemAdjustments.create(promotion: general_promo, calculator: calculator) # general_actionSpree::Carts::AddItem.call(order: order, variant: create(:variant))end@@ -141,7 +141,7 @@ module Spreeendcontext 'with a free-shipping adjustment action' do- let!(:action) { PromotionActions::FreeShipping.create(promotion: promotion) }+ let!(:action) { Promotion::Actions::FreeShipping.create(promotion: promotion) }context 'right coupon code given' dolet(:order) { create(:order_with_line_items, line_items_count: 3, store: store) }@@ -166,7 +166,7 @@ module Spreeendcontext 'with a whole-order adjustment action' do- let!(:action) { PromotionActions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Promotion::Actions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }context 'right coupon given' dolet(:order) { create(:order_with_line_items, store: store, line_items_count: 1) }@@ -285,7 +285,7 @@ module Spreecontext 'with a CreateLineItems action' dolet!(:variant) { create(:variant) }- let!(:action) { PromotionActions::CreateLineItems.create(promotion: promotion) }+ let!(:action) { Promotion::Actions::CreateLineItems.create(promotion: promotion) }let(:order) { create(:order, store: store) }before do@@ -313,7 +313,7 @@ module Spreeendlet!(:promotion) { create(:promotion, name: 'promo', code: nil, multi_codes: true, number_of_codes: 1) }let!(:coupon_code) { promotion.coupon_codes.first }- let!(:action) { Spree::PromotionActions::CreateItemDiscounts.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Spree::Promotion::Actions::CreateItemAdjustments.create(promotion: promotion, calculator: calculator) }context 'valid coupon' dobefore { order.coupon_code = coupon_code.code }@@ -387,7 +387,7 @@ module Spreecontext 'one common promotion code' dolet!(:promotion) { create(:promotion, name: 'promo', code: '10off', usage_limit: 1) }let!(:action) do- Spree::PromotionActions::CreateItemDiscounts.create(promotion: promotion,+ Spree::Promotion::Actions::CreateItemAdjustments.create(promotion: promotion,calculator: calculator)endlet!(:order_2) { create(:order_with_line_items, line_items_count: 3, user: user) }@@ -427,7 +427,7 @@ module Spreeendlet!(:action) do- Spree::PromotionActions::CreateItemDiscounts.create(promotion: promotion,+ Spree::Promotion::Actions::CreateItemAdjustments.create(promotion: promotion,calculator: calculator)enddiff --git a/spree/core/spec/models/spree/promotion_handler/free_shipping_spec.rb b/spree/core/spec/models/spree/promotion_handler/free_shipping_spec.rbindex 95283d8556..2027b43a32 100644--- a/spree/core/spec/models/spree/promotion_handler/free_shipping_spec.rb+++ b/spree/core/spec/models/spree/promotion_handler/free_shipping_spec.rb@@ -12,7 +12,7 @@ module Spreecontext 'activates in Shipment level' dolet(:promotion) { create(:promotion, name: 'Free Shipping', store: order.store, kind: :automatic) }- let!(:action) { PromotionActions::FreeShipping.create(promotion: promotion) }+ let!(:action) { Promotion::Actions::FreeShipping.create(promotion: promotion) }it 'creates the adjustment' doexpect { subject.activate }.to change { shipment.discounts.count }.by(1)@@ -21,7 +21,7 @@ module Spreecontext 'if promo has a code' dolet(:promotion) { create(:promotion, name: 'Free Shipping', store: order.store, code: 'code') }- let!(:action) { Spree::PromotionActions::FreeShipping.create(promotion: promotion) }+ let!(:action) { Spree::Promotion::Actions::FreeShipping.create(promotion: promotion) }it 'does adjust the shipment when applied to order' doorder.promotions << promotion@@ -36,7 +36,7 @@ module Spreecontext 'if promo has multiple codes' dolet(:promotion) { create(:promotion, name: 'Free Shipping', store: order.store, multi_codes: true, number_of_codes: 1) }- let!(:action) { Spree::PromotionActions::FreeShipping.create(promotion: promotion) }+ let!(:action) { Spree::Promotion::Actions::FreeShipping.create(promotion: promotion) }it 'does adjust the shipment when applied to order' doorder.promotions << promotion@@ -51,7 +51,7 @@ module Spreecontext 'if promo has a path' dolet(:promotion) { create(:promotion, name: 'Free Shipping', store: order.store, kind: :automatic, path: 'path') }- let!(:action) { PromotionActions::FreeShipping.create(promotion: promotion) }+ let!(:action) { Promotion::Actions::FreeShipping.create(promotion: promotion) }it 'does not adjust the shipment' doexpect { subject.activate }.not_to change { shipment.discounts.count }diff --git a/spree/core/spec/models/spree/promotion_handler/page_spec.rb b/spree/core/spec/models/spree/promotion_handler/page_spec.rbindex 6cb8cd253a..5028b09e9d 100644--- a/spree/core/spec/models/spree/promotion_handler/page_spec.rb+++ b/spree/core/spec/models/spree/promotion_handler/page_spec.rb@@ -9,7 +9,7 @@ module Spreebefore docalculator = Calculator::FlatPercentItemTotal.new(preferred_flat_percent: 10)- action = PromotionActions::CreateItemDiscounts.create(calculator: calculator)+ action = Promotion::Actions::CreateItemAdjustments.create(calculator: calculator)promotion.actions << actionenddiff --git a/spree/core/spec/models/spree/promotion_handler/promotion_duplicator_spec.rb b/spree/core/spec/models/spree/promotion_handler/promotion_duplicator_spec.rbindex 04866ebc07..8e75e967e4 100644--- a/spree/core/spec/models/spree/promotion_handler/promotion_duplicator_spec.rb+++ b/spree/core/spec/models/spree/promotion_handler/promotion_duplicator_spec.rb@@ -22,7 +22,7 @@ describe Spree::PromotionHandler::PromotionDuplicator doendbefore do- Spree::PromotionActions::CreateItemDiscounts.create!(calculator: calculator, promotion: promotion)+ Spree::Promotion::Actions::CreateItemAdjustments.create!(calculator: calculator, promotion: promotion)enddescribe '#duplicate' dodiff --git a/spree/core/spec/models/spree/promotion_spec.rb b/spree/core/spec/models/spree/promotion_spec.rbindex b637f1b2c2..17005aa7c5 100644--- a/spree/core/spec/models/spree/promotion_spec.rb+++ b/spree/core/spec/models/spree/promotion_spec.rb@@ -169,8 +169,8 @@ describe Spree::Promotion, type: :model dolet(:promotion) { create(:promotion, name: 'delete me', kind: :automatic) }before do- promotion.actions << Spree::PromotionActions::CreateAdjustment.new- promotion.rules << Spree::PromotionRules::FirstOrder.new+ promotion.actions << Spree::Promotion::Actions::CreateAdjustment.new+ promotion.rules << Spree::Promotion::Rules::FirstOrder.newpromotion.save!end@@ -201,8 +201,8 @@ describe Spree::Promotion, type: :model dolet(:promotion) { create(:promotion, name: 'delete me', kind: :automatic) }before do- promotion.actions << Spree::PromotionActions::CreateAdjustment.new- promotion.rules << Spree::PromotionRules::FirstOrder.new+ promotion.actions << Spree::Promotion::Actions::CreateAdjustment.new+ promotion.rules << Spree::Promotion::Rules::FirstOrder.newpromotion.save!end@@ -256,8 +256,8 @@ describe Spree::Promotion, type: :model doenddescribe '#activate' do- let(:action1) { Spree::PromotionActions::CreateAdjustment.create!(promotion: promotion) }- let(:action2) { Spree::PromotionActions::CreateAdjustment.create!(promotion: promotion) }+ let(:action1) { Spree::Promotion::Actions::CreateAdjustment.create!(promotion: promotion) }+ let(:action2) { Spree::Promotion::Actions::CreateAdjustment.create!(promotion: promotion) }let(:user) { create(:user) }let(:order) { create(:order, user: user) }let(:payload) { { order: order, user: user } }@@ -371,7 +371,7 @@ describe Spree::Promotion, type: :model dolet!(:action) docalculator = Spree::Calculator::FlatRate.new- action = Spree::PromotionActions::CreateAdjustment.create(promotion: promotion, calculator: calculator)+ action = Spree::Promotion::Actions::CreateAdjustment.create(promotion: promotion, calculator: calculator)promotion.actions << actionactionend@@ -402,7 +402,7 @@ describe Spree::Promotion, type: :model docontext 'with multiple actions on the same order' dolet!(:second_action) docalculator = Spree::Calculator::FlatRate.new- action = Spree::PromotionActions::CreateAdjustment.create(promotion: promotion, calculator: calculator)+ action = Spree::Promotion::Actions::CreateAdjustment.create(promotion: promotion, calculator: calculator)promotion.actions << actionactionend@@ -449,12 +449,12 @@ describe Spree::Promotion, type: :model dolet(:line_item) { create :line_item, order: order }let(:promotion) { create(:promotion, name: 'promo', code: '10off') }let(:order_action) do- action = Spree::PromotionActions::CreateAdjustment.create(calculator: Spree::Calculator::FlatPercentItemTotal.new)+ action = Spree::Promotion::Actions::CreateAdjustment.create(calculator: Spree::Calculator::FlatPercentItemTotal.new)promotion.actions << actionactionendlet(:item_action) do- action = Spree::PromotionActions::CreateItemDiscounts.create(calculator: Spree::Calculator::FlatPercentItemTotal.new)+ action = Spree::Promotion::Actions::CreateItemAdjustments.create(calculator: Spree::Calculator::FlatPercentItemTotal.new)promotion.actions << actionactionend@@ -497,7 +497,7 @@ describe Spree::Promotion, type: :model dolet(:promotion) { create(:promotion, kind: :automatic) }context 'when it has product rules with products associated' do- let(:promotion_rule) { create(:promotion_rule, promotion: promotion, type: 'Spree::PromotionRules::Product') }+ let(:promotion_rule) { create(:promotion_rule, promotion: promotion, type: 'Spree::Promotion::Rules::Product') }before dopromotion.promotion_rules << promotion_rule@@ -598,8 +598,8 @@ describe Spree::Promotion, type: :model docontext "with 'all' match policy" do# Two distinct STI subclasses — uniqueness scopes on `(promotion_id, type)`,# so re-using the abstract base would fail validation for the second row.- let(:promo1) { Spree::PromotionRules::FirstOrder.create!(promotion: promotion) }- let(:promo2) { Spree::PromotionRules::OneUsePerUser.create!(promotion: promotion) }+ let(:promo1) { Spree::Promotion::Rules::FirstOrder.create!(promotion: promotion) }+ let(:promo2) { Spree::Promotion::Rules::OneUsePerUser.create!(promotion: promotion) }before { promotion.match_policy = 'all' }@@ -922,12 +922,12 @@ describe Spree::Promotion, type: :model dopromotion.reloadexpect(promotion.rules.size).to eq(1)- expect(promotion.rules.first).to be_a(Spree::PromotionRules::ItemTotal)+ expect(promotion.rules.first).to be_a(Spree::Promotion::Rules::ItemTotal)expect(promotion.rules.first.preferred_amount_min).to eq(50)endit 'updates an existing rule when matched by id' do- existing = promotion.rules.create!(type: 'Spree::PromotionRules::ItemTotal', preferences: { amount_min: 10 })+ existing = promotion.rules.create!(type: 'Spree::Promotion::Rules::ItemTotal', preferences: { amount_min: 10 })promotion.rules = [{ id: existing.id, type: 'item_total', preferences: { amount_min: 99 } }]promotion.reload@@ -938,8 +938,8 @@ describe Spree::Promotion, type: :model doendit 'destroys rules omitted from the payload' do- kept = promotion.rules.create!(type: 'Spree::PromotionRules::ItemTotal', preferences: { amount_min: 10 })- removed = promotion.rules.create!(type: 'Spree::PromotionRules::FirstOrder')+ kept = promotion.rules.create!(type: 'Spree::Promotion::Rules::ItemTotal', preferences: { amount_min: 10 })+ removed = promotion.rules.create!(type: 'Spree::Promotion::Rules::FirstOrder')promotion.rules = [{ id: kept.id, type: 'item_total' }]promotion.reload@@ -949,7 +949,7 @@ describe Spree::Promotion, type: :model doendit 'destroys all rules when given an empty array' do- promotion.rules.create!(type: 'Spree::PromotionRules::ItemTotal')+ promotion.rules.create!(type: 'Spree::Promotion::Rules::ItemTotal')promotion.rules = []promotion.reload@@ -961,8 +961,8 @@ describe Spree::Promotion, type: :model do# the in-memory collection WITHOUT a reload, since the admin serializer# renders `rule_ids` off the loaded association on the same object.it 'reflects a partial removal in the loaded collection without reload' do- kept = promotion.rules.create!(type: 'Spree::PromotionRules::ItemTotal', preferences: { amount_min: 10 })- removed = promotion.rules.create!(type: 'Spree::PromotionRules::FirstOrder')+ kept = promotion.rules.create!(type: 'Spree::Promotion::Rules::ItemTotal', preferences: { amount_min: 10 })+ removed = promotion.rules.create!(type: 'Spree::Promotion::Rules::FirstOrder')promotion.promotion_rules.load # eager-load, as the controller scope does@@ -984,13 +984,13 @@ describe Spree::Promotion, type: :model dopromotion.reloadrule = promotion.rules.first- expect(rule).to be_a(Spree::PromotionRules::Product)+ expect(rule).to be_a(Spree::Promotion::Rules::Product)expect(rule.products).to contain_exactly(product, other_product)expect(rule.preferred_match_policy).to eq('any')endit 'replaces product_ids on an existing Product rule' do- rule = promotion.rules.create!(type: 'Spree::PromotionRules::Product')+ rule = promotion.rules.create!(type: 'Spree::Promotion::Rules::Product')rule.products = [product]promotion.rules = [{ id: rule.id, type: 'product', product_ids: [other_product.id] }]@@ -1004,7 +1004,7 @@ describe Spree::Promotion, type: :model dopromotion.reloadrule = promotion.rules.first- expect(rule).to be_a(Spree::PromotionRules::Category)+ expect(rule).to be_a(Spree::Promotion::Rules::Category)expect(rule.taxons).to contain_exactly(taxon)end@@ -1018,7 +1018,7 @@ describe Spree::Promotion, type: :model dofresh.save!rule = fresh.reload.rules.first- expect(rule).to be_a(Spree::PromotionRules::Category)+ expect(rule).to be_a(Spree::Promotion::Rules::Category)expect(rule.taxons).to contain_exactly(taxon)end@@ -1044,7 +1044,7 @@ describe Spree::Promotion, type: :model doendit 'falls through to AR when assigned PromotionRule instances' do- rule = Spree::PromotionRules::FirstOrder.new+ rule = Spree::Promotion::Rules::FirstOrder.newpromotion.rules = [rule]expect(promotion.rules).to include(rule)@@ -1065,7 +1065,7 @@ describe Spree::Promotion, type: :model dopromotion.reloadaction = promotion.actions.first- expect(action).to be_a(Spree::PromotionActions::CreateAdjustment)+ expect(action).to be_a(Spree::Promotion::Actions::CreateAdjustment)expect(action.calculator).to be_a(Spree::Calculator::FlatRate)expect(action.calculator.preferred_amount).to eq(7.5)expect(action.calculator.preferred_currency).to eq('USD')@@ -1073,7 +1073,7 @@ describe Spree::Promotion, type: :model doit 'updates the calculator type on an existing action' doaction = promotion.actions.create!(- type: 'Spree::PromotionActions::CreateAdjustment',+ type: 'Spree::Promotion::Actions::CreateAdjustment',calculator: Spree::Calculator::FlatRate.new(preferred_amount: 5))@@ -1094,12 +1094,12 @@ describe Spree::Promotion, type: :model dopromotion.actions = [{ type: 'free_shipping' }]promotion.reload- expect(promotion.actions.first).to be_a(Spree::PromotionActions::FreeShipping)+ expect(promotion.actions.first).to be_a(Spree::Promotion::Actions::FreeShipping)endit 'destroys actions omitted from the payload' do- kept = promotion.actions.create!(type: 'Spree::PromotionActions::FreeShipping')- removed = promotion.actions.create!(type: 'Spree::PromotionActions::CreateAdjustment')+ kept = promotion.actions.create!(type: 'Spree::Promotion::Actions::FreeShipping')+ removed = promotion.actions.create!(type: 'Spree::Promotion::Actions::CreateAdjustment')promotion.actions = [{ id: kept.id, type: 'free_shipping' }]promotion.reloaddiff --git a/spree/core/spec/models/spree/promotion_tax_recalculation_spec.rb b/spree/core/spec/models/spree/promotion_tax_recalculation_spec.rbindex c12871d69e..a7b8da020f 100644--- a/spree/core/spec/models/spree/promotion_tax_recalculation_spec.rb+++ b/spree/core/spec/models/spree/promotion_tax_recalculation_spec.rb@@ -33,13 +33,13 @@ describe 'Promotion discounts and the taxable basis', type: :model dodef line_item_promotion(calculator)create(:promotion, code: 'DISCOUNT', store: store).tap do |promotion|- Spree::PromotionActions::CreateItemDiscounts.create!(calculator: calculator, promotion: promotion)+ Spree::Promotion::Actions::CreateItemAdjustments.create!(calculator: calculator, promotion: promotion)endenddef whole_order_promotion(calculator)create(:promotion, code: 'DISCOUNT', store: store).tap do |promotion|- Spree::PromotionActions::CreateAdjustment.create!(calculator: calculator, promotion: promotion)+ Spree::Promotion::Actions::CreateAdjustment.create!(calculator: calculator, promotion: promotion)endenddiff --git a/spree/core/spec/models/spree/shipping_method_spec.rb b/spree/core/spec/models/spree/shipping_method_spec.rbindex 30b278ba86..86d79f3c3e 100644--- a/spree/core/spec/models/spree/shipping_method_spec.rb+++ b/spree/core/spec/models/spree/shipping_method_spec.rb@@ -80,7 +80,10 @@ describe Spree::ShippingMethod, type: :model doexpect(subject.errors.messages[:name].size).to eq(1)end- it 'validates presence of display_on' do+ it 'defaults display_on and rejects explicit blank' do+ expect(subject.display_on).to eq('both')++ subject.display_on = nilsubject.valid?expect(subject.errors.messages[:display_on].size).not_to be_zeroenddiff --git a/spree/core/spec/models/spree/store_spec.rb b/spree/core/spec/models/spree/store_spec.rbindex 95374863c9..9f7d073ddd 100644--- a/spree/core/spec/models/spree/store_spec.rb+++ b/spree/core/spec/models/spree/store_spec.rb@@ -249,8 +249,9 @@ describe Spree::Store, type: :model, without_global_store: true docontext 'when default_country_iso is not set' dolet(:store) { build(:store) }- it 'does not create a market' do- expect { store.save! }.not_to change(Spree::Market, :count)+ it 'creates a fallback default market so the store always owns one' do+ expect { store.save! }.to change(Spree::Market, :count).by(1)+ expect(store.default_market.currency).to eq('USD')endendend@@ -388,7 +389,7 @@ describe Spree::Store, type: :model, without_global_store: true doit 'returns countries from all markets' docountries = subject.countries_available_for_checkout- expect(countries.map(&:iso)).to contain_exactly('DE', 'FR')+ expect(countries.map(&:iso)).to contain_exactly('DE', 'FR', 'US')endend@@ -495,9 +496,10 @@ describe Spree::Store, type: :model, without_global_store: true docreate(:market, store: store, currency: 'EUR')end- it 'derives currencies from markets' do+ it 'derives currencies from markets plus the legacy column' do+ # The factory column ('USD,EUR,GBP') stays honored alongside markets.expect(store.supported_currencies_list).to contain_exactly(- ::Money::Currency.find('USD'), ::Money::Currency.find('EUR')+ ::Money::Currency.find('USD'), ::Money::Currency.find('EUR'), ::Money::Currency.find('GBP'))end@@ -662,9 +664,10 @@ describe Spree::Store, type: :model, without_global_store: true doendend- context 'without any markets' do- it 'returns nil' do- expect(store.default_market).to be_nil+ context 'without an explicit default' do+ it 'returns the auto-created bootstrap market' do+ expect(store.default_market).to be_present+ expect(store.default_market.default).to be(true)endendend@@ -698,7 +701,7 @@ describe Spree::Store, type: :model, without_global_store: true doit 'returns countries from all markets' docountries = store.countries_from_markets- expect(countries.pluck(:iso)).to contain_exactly(country_a.iso, country_b.iso, country_c.iso)+ expect(countries.pluck(:iso)).to contain_exactly(country_a.iso, country_b.iso, country_c.iso, 'US')endit 'returns an ActiveRecord relation' do@@ -722,8 +725,8 @@ describe Spree::Store, type: :model, without_global_store: true doendcontext 'without markets' do- it 'returns empty relation' do- expect(store.countries_from_markets).to be_empty+ it 'returns the bootstrap market country' do+ expect(store.countries_from_markets.pluck(:iso)).to eq(['US'])endendenddiff --git a/spree/core/spec/models/spree/taxon_category_aliases_spec.rb b/spree/core/spec/models/spree/taxon_category_aliases_spec.rbindex 4d8128cd78..af48dfea13 100644--- a/spree/core/spec/models/spree/taxon_category_aliases_spec.rb+++ b/spree/core/spec/models/spree/taxon_category_aliases_spec.rb@@ -9,7 +9,7 @@ RSpec.describe 'Taxon -> Category deprecation aliases' doexpect(Spree::Taxon).to equal(Spree::Category)expect(Spree::Classification).to equal(Spree::ProductCategory)expect(Spree::PromotionRuleTaxon).to equal(Spree::PromotionRuleCategory)- expect(Spree::PromotionRules::Taxon).to equal(Spree::PromotionRules::Category)+ expect(Spree::Promotion::Rules::Taxon).to equal(Spree::Promotion::Rules::Category)endenddiff --git a/spree/core/spec/presenters/spree/search_provider/product_presenter_spec.rb b/spree/core/spec/presenters/spree/search_provider/product_presenter_spec.rbindex 00e7e184be..55ada68c3f 100644--- a/spree/core/spec/presenters/spree/search_provider/product_presenter_spec.rb+++ b/spree/core/spec/presenters/spree/search_provider/product_presenter_spec.rb@@ -141,7 +141,7 @@ module Spreeendcontext 'with multiple markets' do- let!(:us_market) { create(:market, store: store, name: 'US', currency: 'USD', default_locale: 'en') }+ let!(:us_market) { store.default_market }let!(:eu_market) { create(:market, store: store, name: 'EU', currency: 'EUR', default_locale: 'de', supported_locales: 'de,fr') }# Product with prices in both currencies@@ -195,7 +195,7 @@ module Spreeendcontext 'with market but product has no price in that currency' do- let!(:us_market) { create(:market, store: store, name: 'US', currency: 'USD', default_locale: 'en') }+ let!(:us_market) { store.default_market }let!(:eu_market) { create(:market, store: store, name: 'EU', currency: 'EUR', default_locale: 'de') }# Product with USD price only — no EUR pricediff --git a/spree/core/spec/services/spree/carts/legacy_add_item_spec.rb b/spree/core/spec/services/spree/carts/legacy_add_item_spec.rbindex cbabd49abe..e7e8516613 100644--- a/spree/core/spec/services/spree/carts/legacy_add_item_spec.rb+++ b/spree/core/spec/services/spree/carts/legacy_add_item_spec.rb@@ -69,7 +69,7 @@ module Spreelet(:calculator) { Spree::Calculator::FlatRate.new(preferred_amount: 10) }context 'one active order promotion' do- let!(:action) { Spree::PromotionActions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Spree::Promotion::Actions::CreateAdjustment.create(promotion: promotion, calculator: calculator) }before dosubject.call(order: order, variant: variant, quantity: 1)@@ -84,7 +84,7 @@ module Spreeendcontext 'one active line item promotion' do- let!(:action) { Spree::PromotionActions::CreateItemDiscounts.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Spree::Promotion::Actions::CreateItemAdjustments.create(promotion: promotion, calculator: calculator) }before dosubject.call(order: order, variant: variant, quantity: 1)@@ -111,7 +111,7 @@ module Spreeendlet(:variant) { create(:variant, price: 1000) }let(:calculator) { Spree::Calculator::PercentOnLineItem.new(preferred_percent: 50) }- let!(:action) { Spree::PromotionActions::CreateItemDiscounts.create(promotion: promotion, calculator: calculator) }+ let!(:action) { Spree::Promotion::Actions::CreateItemAdjustments.create(promotion: promotion, calculator: calculator) }it 'updates included_tax_total' doexpect(order.included_tax_total.to_f).to eq(0.00)diff --git a/spree/core/spec/services/spree/carts/update_spec.rb b/spree/core/spec/services/spree/carts/update_spec.rbindex b43a6b0f47..2f4398e601 100644--- a/spree/core/spec/services/spree/carts/update_spec.rb+++ b/spree/core/spec/services/spree/carts/update_spec.rb@@ -75,7 +75,7 @@ module Spreecontext 'auto-switches market to match currency' dolet(:us_country) { Spree::Country.find_by(iso: 'US') || create(:country, iso: 'US') }let(:de_country) { create(:country, iso: 'DE', name: 'Germany') }- let!(:us_market) { create(:market, store: store, countries: [us_country]) }+ let!(:us_market) { store.default_market }let!(:eu_market) { create(:market, :eu, store: store, countries: [de_country]) }let(:order) { create(:order_with_line_items, user: user, store: store, market: us_market, currency: 'USD') }@@ -101,11 +101,13 @@ module Spreeexpect(order.reload.market).to eq(us_market)end- it 'returns failure when no market exists for currency' do+ it 'keeps the current market when no market exists for the currency' do+ # GBP is store-supported via the legacy column; without a GBP+ # market the cart keeps its current market.result = described_class.call(cart: order, params: { currency: 'GBP' })- expect(result).to be_failure- expect(order.reload.currency).to eq('USD')+ expect(result).to be_success+ expect(order.reload.currency).to eq('GBP')expect(order.market).to eq(us_market)endend@@ -114,7 +116,8 @@ module Spreedescribe 'updating market' dolet(:us_country) { Spree::Country.find_by(iso: 'US') || create(:country, iso: 'US') }let(:de_country) { create(:country, iso: 'DE', name: 'Germany') }- let!(:us_market) { create(:market, :default, store: store, countries: [us_country]) }+ # The store's bootstrap market already owns the US country.+ let!(:us_market) { store.default_market }let!(:eu_market) { create(:market, :eu, store: store, countries: [de_country]) }context 'with valid market_id' dodiff --git a/spree/emails/app/mailers/spree/fulfillment_mailer.rb b/spree/emails/app/mailers/spree/fulfillment_mailer.rbnew file mode 100644index 0000000000..bba8b1163b--- /dev/null+++ b/spree/emails/app/mailers/spree/fulfillment_mailer.rb@@ -0,0 +1,17 @@+module Spree+ class FulfillmentMailer < BaseMailer+ helper Spree::MailHelper+ helper Spree::FulfillmentHelper++ def fulfilled_email(fulfillment, resend = false)+ @fulfillment = fulfillment.respond_to?(:id) ? fulfillment : Spree::Fulfillment.find(fulfillment)+ @order = @fulfillment.order+ current_store = @fulfillment.store+ with_store_locale(current_store, @order.locale) do+ subject = order_email_subject(current_store, Spree.t('fulfillment_mailer.fulfilled_email.subject'), @order.number, resend: resend)+ mail(to: @order.email, subject: subject, store_url: current_store.storefront_url,+ template_path: 'spree/fulfillment_mailer', template_name: 'fulfilled_email')+ end+ end+ end+enddiff --git a/spree/emails/app/mailers/spree/order_mailer.rb b/spree/emails/app/mailers/spree/order_mailer.rbindex dd4f03aaae..3feadad025 100644--- a/spree/emails/app/mailers/spree/order_mailer.rb+++ b/spree/emails/app/mailers/spree/order_mailer.rb@@ -32,7 +32,7 @@ module Spreedef payment_link_email(order_id)@order = Spree::Order.incomplete.not_canceled.find(order_id)@current_store = @order.store- @checkout_payment_url = spree.checkout_state_url(@order.token, :payment, host: @current_store.storefront_url)+ @checkout_payment_url = URI.join(@current_store.storefront_url, "/checkout/#{@order.token}/payment").to_swith_store_locale(@current_store, @order.locale) domail(to: @order.email, subject: Spree.t('order_mailer.payment_link_email.subject', number: @order.number),diff --git a/spree/emails/app/mailers/spree/shipment_mailer.rb b/spree/emails/app/mailers/spree/shipment_mailer.rbindex afc509f28f..72b815563b 100644--- a/spree/emails/app/mailers/spree/shipment_mailer.rb+++ b/spree/emails/app/mailers/spree/shipment_mailer.rb@@ -1,16 +1,9 @@module Spree- class ShipmentMailer < BaseMailer- helper Spree::MailHelper- helper Spree::ShipmentHelper-+ # Deprecated: use Spree::FulfillmentMailer. Removed in Spree 6.1.+ class ShipmentMailer < FulfillmentMailerdef shipped_email(shipment, resend = false)- @shipment = shipment.respond_to?(:id) ? shipment : Spree::Shipment.find(shipment)- @order = @shipment.order- current_store = @shipment.store- with_store_locale(current_store, @order.locale) do- subject = order_email_subject(current_store, Spree.t('shipment_mailer.shipped_email.subject'), @order.number, resend: resend)- mail(to: @order.email, subject: subject, store_url: current_store.storefront_url)- end+ Spree::Deprecation.warn('Spree::ShipmentMailer#shipped_email is deprecated and will be removed in Spree 6.1. Use Spree::FulfillmentMailer#fulfilled_email instead.')+ fulfilled_email(shipment, resend)endendenddiff --git a/spree/emails/app/subscribers/spree/fulfillment_email_subscriber.rb b/spree/emails/app/subscribers/spree/fulfillment_email_subscriber.rbnew file mode 100644index 0000000000..aa34c65ae0--- /dev/null+++ b/spree/emails/app/subscribers/spree/fulfillment_email_subscriber.rb@@ -0,0 +1,24 @@+# frozen_string_literal: true++module Spree+ class FulfillmentEmailSubscriber < Spree::Subscriber+ subscribes_to 'fulfillment.fulfilled'++ def handle(event)+ fulfillment = find_fulfillment(event)+ return unless fulfillment++ store = fulfillment.store+ return unless store.prefers_send_consumer_transactional_emails?++ FulfillmentMailer.fulfilled_email(fulfillment.id).deliver_later+ end++ private++ def find_fulfillment(event)+ fulfillment_id = event.payload['id']+ Spree::Fulfillment.find_by_prefix_id(fulfillment_id)+ end+ end+enddiff --git a/spree/emails/app/subscribers/spree/shipment_email_subscriber.rb b/spree/emails/app/subscribers/spree/shipment_email_subscriber.rbdeleted file mode 100644index 2fc006558f..0000000000--- a/spree/emails/app/subscribers/spree/shipment_email_subscriber.rb+++ /dev/null@@ -1,24 +0,0 @@-# frozen_string_literal: true--module Spree- class ShipmentEmailSubscriber < Spree::Subscriber- subscribes_to 'shipment.shipped'-- def handle(event)- shipment = find_shipment(event)- return unless shipment-- store = shipment.store- return unless store.prefers_send_consumer_transactional_emails?-- ShipmentMailer.shipped_email(shipment.id).deliver_later- end-- private-- def find_shipment(event)- shipment_id = event.payload['id']- Spree::Shipment.find_by_prefix_id(shipment_id)- end- end-enddiff --git a/spree/emails/app/views/spree/fulfillment_mailer/fulfilled_email.html.erb b/spree/emails/app/views/spree/fulfillment_mailer/fulfilled_email.html.erbnew file mode 100644index 0000000000..245ddf4dbb--- /dev/null+++ b/spree/emails/app/views/spree/fulfillment_mailer/fulfilled_email.html.erb@@ -0,0 +1,22 @@+<%= render 'spree/shared/purchased_items_styles' %>++<%= render layout: 'spree/shared/mailer_hero' do %>+ <h1><%= Spree.t('fulfillment_mailer.fulfilled_email.subject') %></h1>+ <p class="greeting"><%= Spree.t('fulfillment_mailer.fulfilled_email.dear_customer', name: name_for(@fulfillment.order)) %></p>+ <p><%= Spree.t('fulfillment_mailer.fulfilled_email.instructions', number: @fulfillment.order.number) %></p>+ <% if @fulfillment.delivery_method %>+ <p><%= Spree.t('fulfillment_mailer.fulfilled_email.delivery_method', delivery_method: @fulfillment.delivery_method.name) %></p>+ <% end %>+ <% if @fulfillment.tracking %>+ <p><%= Spree.t('fulfillment_mailer.fulfilled_email.track_information', tracking: @fulfillment.tracking) %></p>+ <% end %>+ <% if @fulfillment.tracking_url %>+ <p><%= Spree.t('fulfillment_mailer.fulfilled_email.track_link', url: fulfillment_tracking_link_to(fulfillment: @fulfillment)).html_safe %></p>+ <% end %>+<% end %>++<%= render 'spree/shared/order_summary_section',+ heading: Spree.t('fulfillment_mailer.fulfilled_email.fulfillment_summary'),+ line_items: @fulfillment.manifest.map(&:line_item),+ order: @fulfillment.order,+ totals: false %>diff --git a/spree/emails/app/views/spree/fulfillment_mailer/fulfilled_email.text.erb b/spree/emails/app/views/spree/fulfillment_mailer/fulfilled_email.text.erbnew file mode 100644index 0000000000..83a72956c8--- /dev/null+++ b/spree/emails/app/views/spree/fulfillment_mailer/fulfilled_email.text.erb@@ -0,0 +1,17 @@+<%= Spree.t('fulfillment_mailer.fulfilled_email.dear_customer', name: name_for(@fulfillment.order)) %>++<%= Spree.t('fulfillment_mailer.fulfilled_email.instructions', number: @fulfillment.order.number) %>++============================================================+<%= Spree.t('fulfillment_mailer.fulfilled_email.fulfillment_summary') %>+============================================================+<% @fulfillment.manifest.each do |item| %>+ <%= item.variant.sku %> <%= item.variant.product.name %> <%= item.variant.options_text %>+<% end %>+============================================================++<%= Spree.t('fulfillment_mailer.fulfilled_email.track_information', tracking: @fulfillment.tracking) if @fulfillment.tracking %>+<%= Spree.t('fulfillment_mailer.fulfilled_email.track_link', url: @fulfillment.tracking_url) if @fulfillment.tracking_url %>++<%= Spree.t('fulfillment_mailer.fulfilled_email.thanks') %>+<%= Spree.t('fulfillment_mailer.fulfilled_email.store_team', store_name: current_store.name) %>diff --git a/spree/emails/app/views/spree/shared/_purchased_items_table.html.erb b/spree/emails/app/views/spree/shared/_purchased_items_table.html.erbindex 3720dd7631..07cd196cea 100644--- a/spree/emails/app/views/spree/shared/_purchased_items_table.html.erb+++ b/spree/emails/app/views/spree/shared/_purchased_items_table.html.erb@@ -9,7 +9,7 @@sub: label,value: Spree::Money.new(discounts.sum(&:amount), currency: order.currency) %><% end %>- <% order.shipments.group_by { |s| s.selected_shipping_rate&.name }.each do |name, shipments| %>+ <% order.fulfillments.group_by { |f| f.selected_delivery_rate&.name }.each do |name, shipments| %><%= render 'spree/shared/purchased_items_table/summary_row',label: Spree.t(:shipping),sub: name,diff --git a/spree/emails/app/views/spree/shared/_purchased_items_table.text.erb b/spree/emails/app/views/spree/shared/_purchased_items_table.text.erbindex e91793a598..47d672f4b7 100644--- a/spree/emails/app/views/spree/shared/_purchased_items_table.text.erb+++ b/spree/emails/app/views/spree/shared/_purchased_items_table.text.erb@@ -7,7 +7,7 @@<%= Spree.t(:promotion) %>: <%= label %> <%= Spree::Money.new(discounts.sum(&:amount), currency: order.currency) %><% end %>-<% order.shipments.group_by { |s| s.selected_shipping_rate.try(:name) }.each do |name, shipments| %>+<% order.fulfillments.group_by { |f| f.selected_delivery_rate.try(:name) }.each do |name, shipments| %><%= Spree.t(:shipping) %>: <%= name %> <%= Spree::Money.new(shipments.sum(&:discounted_cost), currency: order.currency) %><% end %>diff --git a/spree/emails/app/views/spree/shipment_mailer/shipped_email.html.erb b/spree/emails/app/views/spree/shipment_mailer/shipped_email.html.erbdeleted file mode 100644index 9912491bfc..0000000000--- a/spree/emails/app/views/spree/shipment_mailer/shipped_email.html.erb+++ /dev/null@@ -1,20 +0,0 @@-<%= render 'spree/shared/purchased_items_styles' %>--<%= render layout: 'spree/shared/mailer_hero' do %>- <h1><%= Spree.t('shipment_mailer.shipped_email.subject') %></h1>- <p class="greeting"><%= Spree.t('shipment_mailer.shipped_email.dear_customer', name: name_for(@shipment.order)) %></p>- <p><%= Spree.t('shipment_mailer.shipped_email.instructions', number: @shipment.order.number) %></p>- <p><%= Spree.t('shipment_mailer.shipped_email.shipping_method', shipping_method: @shipment.shipping_method.name) %></p>- <% if @shipment.tracking %>- <p><%= Spree.t('shipment_mailer.shipped_email.track_information', tracking: @shipment.tracking) %></p>- <% end %>- <% if @shipment.tracking_url %>- <p><%= Spree.t('shipment_mailer.shipped_email.track_link', url: shipment_tracking_link_to(shipment: @shipment)).html_safe %></p>- <% end %>-<% end %>--<%= render 'spree/shared/order_summary_section',- heading: Spree.t('shipment_mailer.shipped_email.shipment_summary'),- line_items: @shipment.manifest.map(&:line_item),- order: @shipment.order,- totals: false %>diff --git a/spree/emails/app/views/spree/shipment_mailer/shipped_email.text.erb b/spree/emails/app/views/spree/shipment_mailer/shipped_email.text.erbdeleted file mode 100644index c3e765f8d8..0000000000--- a/spree/emails/app/views/spree/shipment_mailer/shipped_email.text.erb+++ /dev/null@@ -1,17 +0,0 @@-<%= Spree.t('shipment_mailer.shipped_email.dear_customer', name: name_for(@shipment.order)) %>--<%= Spree.t('shipment_mailer.shipped_email.instructions', number: @shipment.order.number) %>--============================================================-<%= Spree.t('shipment_mailer.shipped_email.shipment_summary') %>-============================================================-<% @shipment.manifest.each do |item| %>- <%= item.variant.sku %> <%= item.variant.product.name %> <%= item.variant.options_text %>-<% end %>-============================================================--<%= Spree.t('shipment_mailer.shipped_email.track_information', tracking: @shipment.tracking) if @shipment.tracking %>-<%= Spree.t('shipment_mailer.shipped_email.track_link', url: @shipment.tracking_url) if @shipment.tracking_url %>--<%= Spree.t('shipment_mailer.shipped_email.thanks') %>-<%= Spree.t('shipment_mailer.shipped_email.store_team', store_name: current_store.name) %>diff --git a/spree/emails/lib/spree/emails/engine.rb b/spree/emails/lib/spree/emails/engine.rbindex 93ce9e45ae..e31714def4 100644--- a/spree/emails/lib/spree/emails/engine.rb+++ b/spree/emails/lib/spree/emails/engine.rb@@ -21,7 +21,7 @@ module Spreeconfig.after_initialize doSpree.subscribers.concat [Spree::OrderEmailSubscriber,- Spree::ShipmentEmailSubscriber,+ Spree::FulfillmentEmailSubscriber,Spree::ReimbursementEmailSubscriber,Spree::NewsletterSubscriberEmailSubscriber,Spree::CustomerEmailSubscriberdiff --git a/spree/emails/lib/spree/emails/previews/fulfillment_preview.rb b/spree/emails/lib/spree/emails/previews/fulfillment_preview.rbnew file mode 100644index 0000000000..76d2136e1c--- /dev/null+++ b/spree/emails/lib/spree/emails/previews/fulfillment_preview.rb@@ -0,0 +1,12 @@+require 'spree/core/previews/preview_data'++# Preview Spree fulfillment emails at /rails/mailers/spree/fulfillment+class Spree::FulfillmentPreview < ActionMailer::Preview+ include Spree::PreviewData::LocaleParam++ def fulfilled_email+ fulfillment = Spree::Fulfillment.fulfilled.last+ fulfillment.order.locale = locale if fulfillment && locale.present?+ Spree::FulfillmentMailer.fulfilled_email(fulfillment)+ end+enddiff --git a/spree/emails/lib/spree/emails/previews/shipment_preview.rb b/spree/emails/lib/spree/emails/previews/shipment_preview.rbdeleted file mode 100644index ea55e1b8ed..0000000000--- a/spree/emails/lib/spree/emails/previews/shipment_preview.rb+++ /dev/null@@ -1,12 +0,0 @@-require 'spree/core/previews/preview_data'--# Preview Spree shipment emails at /rails/mailers/spree/shipment-class Spree::ShipmentPreview < ActionMailer::Preview- include Spree::PreviewData::LocaleParam-- def shipped_email- shipment = Spree::Shipment.shipped.last- shipment.order.locale = locale if shipment && locale.present?- Spree::ShipmentMailer.shipped_email(shipment)- end-enddiff --git a/spree/emails/spec/mailers/spree/fulfillment_mailer_spec.rb b/spree/emails/spec/mailers/spree/fulfillment_mailer_spec.rbnew file mode 100644index 0000000000..df2f41a584--- /dev/null+++ b/spree/emails/spec/mailers/spree/fulfillment_mailer_spec.rb@@ -0,0 +1,130 @@+require 'spec_helper'+require 'email_spec'++describe Spree::FulfillmentMailer, type: :mailer do+ include EmailSpec::Helpers+ include EmailSpec::Matchers++ let(:store) { @default_store }+ let(:order) { create(:shipped_order, store: store, email: '[email protected]', user: nil) }+ let(:fulfillment) { order.fulfillments.first }+ let(:delivery_method) { fulfillment.delivery_method }++ before do+ delivery_method.update(tracking_url: 'http://example.com/tracking')+ end++ context ':from not set explicitly' do+ it 'falls back to store mail from address' do+ message = described_class.fulfilled_email(fulfillment)+ expect(message.from).to eq([store.mail_from_address])+ end+ end++ context ':reply_to not set explicitly' do+ it 'uses store customer support email' do+ message = described_class.fulfilled_email(fulfillment)+ expect(message.reply_to).to eq([store.customer_support_email])+ end+ end++ # Regression test for #2196+ it "doesn't include out of stock in the email body" do+ fulfillment_email = described_class.fulfilled_email(fulfillment)+ expect(fulfillment_email.body).not_to include(%q{Out of Stock})+ end++ # The fulfillment may cover only part of the order, so whole-order amounts+ # would be misleading next to the fulfilled-items list.+ it "doesn't include order totals in the email body" do+ fulfillment_email = described_class.fulfilled_email(fulfillment)+ expect(fulfillment_email).not_to have_body_text(Spree.t('order_mailer.total'))+ end++ it 'accepts a fulfillment id as an alternative to a Fulfillment object' do+ expect do+ described_class.fulfilled_email(fulfillment.id).body+ end.not_to raise_error+ end++ context 'legacy ShipmentMailer bridge' do+ it 'still delivers through shipped_email with a deprecation warning' do+ expect(Spree::Deprecation).to receive(:warn).at_least(:once)+ message = Spree::ShipmentMailer.shipped_email(fulfillment)+ expect(message.subject).to be_present+ expect(message.body.to_s.presence || message.html_part&.body&.to_s).to be_present+ end+ end++ context 'emails must be translatable' do+ context 'pt-BR locale' do+ before do+ I18n.enforce_available_locales = false+ pt_br_fulfilled_email = { spree: { fulfillment_mailer: { fulfilled_email: { dear_customer: 'Caro Cliente,' } } } }+ I18n.backend.store_translations :'pt-BR', pt_br_fulfilled_email+ store.update(default_locale: 'pt-BR')+ order.update_column(:locale, 'pt-BR')+ end++ after do+ I18n.enforce_available_locales = true+ I18n.locale = :en+ store.update(default_locale: 'en')+ end++ specify do+ fulfilled_email = described_class.fulfilled_email(fulfillment)+ expect(fulfilled_email).to have_body_text('Caro Cliente,')+ end++ specify 'translates the subject in the order locale' do+ I18n.backend.store_translations :'pt-BR', {+ spree: { fulfillment_mailer: { fulfilled_email: { subject: 'Notificação de Envio' } } }+ }+ fulfilled_email = described_class.fulfilled_email(fulfillment)+ expect(fulfilled_email.subject).to include('Notificação de Envio')+ end+ end+ end++ context 'uses order locale for emails' do+ before do+ I18n.enforce_available_locales = false+ pt_br_fulfilled_email = { spree: { fulfillment_mailer: { fulfilled_email: { dear_customer: 'Caro Cliente,' } } } }+ I18n.backend.store_translations :'pt-BR', pt_br_fulfilled_email++ # Store stays with default_locale 'en', but order has locale 'pt-BR'+ order.update_column(:locale, 'pt-BR')+ end++ after do+ I18n.enforce_available_locales = true+ I18n.locale = :en+ end++ it 'sends the fulfilled email in the order locale' do+ fulfilled_email = described_class.fulfilled_email(fulfillment)+ expect(fulfilled_email).to have_body_text('Caro Cliente,')+ end+ end++ context 'fulfilled_email' do+ let(:fulfilled_email) { described_class.fulfilled_email(fulfillment) }++ specify do+ expect(fulfilled_email).to have_body_text(order.number)+ end++ specify do+ expect(fulfilled_email).to have_body_text(delivery_method.name)+ end++ specify do+ expect(fulfilled_email).to have_body_text("href=\"#{fulfillment.tracking_url}\"")+ end++ specify "shows order's user name in email body" do+ expect(fulfilled_email).to have_body_text("Dear #{order.name}")+ end+ end+enddiff --git a/spree/emails/spec/mailers/spree/order_mailer_spec.rb b/spree/emails/spec/mailers/spree/order_mailer_spec.rbindex 2805f834f1..6f89f0738d 100644--- a/spree/emails/spec/mailers/spree/order_mailer_spec.rb+++ b/spree/emails/spec/mailers/spree/order_mailer_spec.rb@@ -338,17 +338,13 @@ describe Spree::OrderMailer, type: :mailer dolet(:payment_link_email) { described_class.payment_link_email(order_for_payment.id) }let(:order_for_payment) { create(:order_with_line_items, store: store) }- let(:payment_url) { "http://shop.com/checkout/#{order_for_payment.token}/payment" }+ let(:payment_url) { "#{store.storefront_url.chomp('/')}/checkout/#{order_for_payment.token}/payment" }- before do- allow(Spree::Core::Engine.routes.url_helpers).to receive(:checkout_state_url).and_return(payment_url)- end-- it 'sends an email with the payment link' do+ it 'sends an email with the cart checkout payment link' doexpect(payment_link_email.from).to contain_exactly(store.mail_from_address)expect(payment_link_email.to).to contain_exactly(order_for_payment.email)expect(payment_link_email.subject).to eq("Payment link for order ##{order_for_payment.number}")- expect(payment_link_email.body).to include(payment_url)+ expect(payment_link_email.body.to_s).to include(payment_url)endendenddiff --git a/spree/emails/spec/mailers/spree/shipment_mailer_spec.rb b/spree/emails/spec/mailers/spree/shipment_mailer_spec.rbdeleted file mode 100644index e59a85c0fe..0000000000--- a/spree/emails/spec/mailers/spree/shipment_mailer_spec.rb+++ /dev/null@@ -1,123 +0,0 @@-require 'spec_helper'-require 'email_spec'--describe Spree::ShipmentMailer, type: :mailer do- include EmailSpec::Helpers- include EmailSpec::Matchers-- let(:store) { @default_store }- let(:order) { create(:shipped_order, store: store, email: '[email protected]', user: nil) }- let(:shipment) { order.shipments.first }- let(:shipping_method) { shipment.shipping_method }-- before do- shipping_method.update(tracking_url: 'http://example.com/tracking')- end-- context ':from not set explicitly' do- it 'falls back to store mail from address' do- message = described_class.shipped_email(shipment)- expect(message.from).to eq([store.mail_from_address])- end- end-- context ':reply_to not set explicitly' do- it 'uses store customer support email' do- message = described_class.shipped_email(shipment)- expect(message.reply_to).to eq([store.customer_support_email])- end- end-- # Regression test for #2196- it "doesn't include out of stock in the email body" do- shipment_email = described_class.shipped_email(shipment)- expect(shipment_email.body).not_to include(%q{Out of Stock})- end-- # The shipment may cover only part of the order, so whole-order amounts- # would be misleading next to the shipped-items list.- it "doesn't include order totals in the email body" do- shipment_email = described_class.shipped_email(shipment)- expect(shipment_email).not_to have_body_text(Spree.t('order_mailer.total'))- end-- it 'shipment_email accepts an shipment id as an alternative to an Shipment object' do- expect do- described_class.shipped_email(shipment.id).body- end.not_to raise_error- end-- context 'emails must be translatable' do- context 'shipped_email' do- context 'pt-BR locale' do- before do- I18n.enforce_available_locales = false- pt_br_shipped_email = { spree: { shipment_mailer: { shipped_email: { dear_customer: 'Caro Cliente,' } } } }- I18n.backend.store_translations :'pt-BR', pt_br_shipped_email- store.update(default_locale: 'pt-BR')- order.update_column(:locale, 'pt-BR')- end-- after do- I18n.enforce_available_locales = true- I18n.locale = :en- store.update(default_locale: 'en')- end-- specify do- shipped_email = described_class.shipped_email(shipment)- expect(shipped_email).to have_body_text('Caro Cliente,')- end-- specify 'translates the subject in the order locale' do- I18n.backend.store_translations :'pt-BR', {- spree: { shipment_mailer: { shipped_email: { subject: 'Notificação de Envio' } } }- }- shipped_email = described_class.shipped_email(shipment)- expect(shipped_email.subject).to include('Notificação de Envio')- end- end- end- end-- context 'uses order locale for emails' do- before do- I18n.enforce_available_locales = false- pt_br_shipped_email = { spree: { shipment_mailer: { shipped_email: { dear_customer: 'Caro Cliente,' } } } }- I18n.backend.store_translations :'pt-BR', pt_br_shipped_email-- # Store stays with default_locale 'en', but order has locale 'pt-BR'- order.update_column(:locale, 'pt-BR')- end-- after do- I18n.enforce_available_locales = true- I18n.locale = :en- end-- it 'sends shipped_email in order locale' do- shipped_email = described_class.shipped_email(shipment)- expect(shipped_email).to have_body_text('Caro Cliente,')- end- end-- context 'shipped_email' do- let(:shipped_email) { described_class.shipped_email(shipment) }-- specify do- expect(shipped_email).to have_body_text(order.number)- end-- specify do- expect(shipped_email).to have_body_text(shipping_method.name)- end-- specify do- expect(shipped_email).to have_body_text("href=\"#{shipment.tracking_url}\"")- end-- specify 'shows order\'s user name in email body' do- expect(shipped_email).to have_body_text("Dear #{order.name}")- end- end-enddiff --git a/spree/emails/spec/subscribers/spree/fulfillment_email_subscriber_spec.rb b/spree/emails/spec/subscribers/spree/fulfillment_email_subscriber_spec.rbnew file mode 100644index 0000000000..265a1c4582--- /dev/null+++ b/spree/emails/spec/subscribers/spree/fulfillment_email_subscriber_spec.rb@@ -0,0 +1,46 @@+# frozen_string_literal: true++require 'spec_helper'++RSpec.describe Spree::FulfillmentEmailSubscriber do+ let(:store) { create(:store) }+ let(:order) { create(:completed_order_with_totals, store: store) }+ let(:fulfillment) { order.fulfillments.first }+ let(:subscriber) { described_class.new }++ def mock_event(fulfillment)+ double('Event', payload: { 'id' => fulfillment.prefixed_id })+ end++ before do+ store.update!(preferences: store.preferences.merge(send_consumer_transactional_emails: true))+ end++ describe 'fulfillment.fulfilled event' do+ it 'sends the fulfilled email' do+ expect(Spree::FulfillmentMailer).to receive(:fulfilled_email).with(fulfillment.id).and_return(double(deliver_later: true))++ subscriber.handle(mock_event(fulfillment))+ end++ context 'when store does not prefer transactional emails' do+ before do+ store.update!(preferences: store.preferences.merge(send_consumer_transactional_emails: false))+ end++ it 'does not send the fulfilled email' do+ expect(Spree::FulfillmentMailer).not_to receive(:fulfilled_email)++ subscriber.handle(mock_event(fulfillment))+ end+ end++ context 'when fulfillment not found' do+ it 'does not raise an error' do+ fulfillment.destroy++ expect { subscriber.handle(mock_event(fulfillment)) }.not_to raise_error+ end+ end+ end+enddiff --git a/spree/emails/spec/subscribers/spree/shipment_email_subscriber_spec.rb b/spree/emails/spec/subscribers/spree/shipment_email_subscriber_spec.rbdeleted file mode 100644index b6b71ce1e5..0000000000--- a/spree/emails/spec/subscribers/spree/shipment_email_subscriber_spec.rb+++ /dev/null@@ -1,46 +0,0 @@-# frozen_string_literal: true--require 'spec_helper'--RSpec.describe Spree::ShipmentEmailSubscriber do- let(:store) { create(:store) }- let(:order) { create(:completed_order_with_totals, store: store) }- let(:shipment) { order.shipments.first }- let(:subscriber) { described_class.new }-- def mock_event(shipment)- double('Event', payload: { 'id' => shipment.prefixed_id })- end-- before do- store.update!(preferences: store.preferences.merge(send_consumer_transactional_emails: true))- end-- describe 'shipment.shipped event' do- it 'sends shipped email' do- expect(Spree::ShipmentMailer).to receive(:shipped_email).with(shipment.id).and_return(double(deliver_later: true))-- subscriber.handle(mock_event(shipment))- end-- context 'when store does not prefer transactional emails' do- before do- store.update!(preferences: store.preferences.merge(send_consumer_transactional_emails: false))- end-- it 'does not send shipped email' do- expect(Spree::ShipmentMailer).not_to receive(:shipped_email)-- subscriber.handle(mock_event(shipment))- end- end-- context 'when shipment not found' do- it 'does not raise an error' do- shipment.destroy-- expect { subscriber.handle(mock_event(shipment)) }.not_to raise_error- end- end- end-end