spree_api 6.0.0.beta4 → 6.0.0.rc2

data/app/request_schemas/spree/api/v3/admin/promotion_action_line_item_request_schema.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # A variant and quantity the `create_line_items` promotion action adds.
+        class PromotionActionLineItemRequestSchema < Spree::Api::V3::RequestSchema
+          publishes 'PromotionActionLineItemParams'
+
+          attribute :variant_id, :id, required: true
+          attribute :quantity, :integer, required: true
+        end
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/admin/promotion_action_request_schema.rb

@@ -0,0 +1,19 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # The keys of a promotion action beyond `type`, shared by the promotion action endpoints and the `actions` written with a promotion.
+        class PromotionActionRequestSchema < Spree::Api::V3::RequestSchema
+          attribute :preferences, :hash,
+            description: "Values for the action kind's settings schema, from `GET /promotion_actions/types`."
+          attribute :calculator, :object, shape: Spree::Api::V3::Admin::PromotionActionCalculatorRequestSchema,
+            permit: false,
+            description: 'For adjustment actions.'
+          attribute :line_items, :array, of: Spree::Api::V3::Admin::PromotionActionLineItemRequestSchema,
+            permit: false,
+            description: 'For `create_line_items`: the variants to add and their quantities. Variants left out are removed.'
+        end
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/admin/promotion_rule_request_schema.rb

@@ -0,0 +1,22 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # The keys of a promotion rule or action beyond `type`, shared by the
+        # nested promotion rule and action endpoints and by the `rules` and
+        # `actions` written with a promotion. Kind-specific keys are read
+        # per kind from its `additional_permitted_attributes`, so they are
+        # documented here and left out of the permit list.
+        class PromotionRuleRequestSchema < Spree::Api::V3::RequestSchema
+          attribute :preferences, :hash,
+            description: "Values for the rule kind's settings schema, from `GET /promotion_rules/types`."
+          attribute :product_ids, :array, of: :id, permit: false, description: 'For the `product` rule.'
+          attribute :category_ids, :array, of: :id, permit: false, description: 'For the `category` rule.'
+          attribute :customer_ids, :array, of: :id,
+            permit: false,
+            description: 'For the `user` rule: the customers who qualify.'
+        end
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/admin/reason_request_schema.rb

@@ -0,0 +1,14 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # A reason staff pick from: claim, refund, return and order
+        # cancellation reasons all take the same body.
+        class ReasonRequestSchema < Spree::Api::V3::RequestSchema
+          attribute :name, :string, required: true, on: :create
+          attribute :active, :boolean, description: 'Whether the reason is offered on new records.'
+        end
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/admin/tax_identifier_request_schema.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # A customer's or a company's tax registration, as staff write it.
+        class TaxIdentifierRequestSchema < Spree::Api::V3::RequestSchema
+          attribute :kind, :string,
+            example: 'gb_vat',
+            description: "#{Spree::Api::V3::TaxIdentifierRequestSchema::KIND_DESCRIPTION}"
+          attribute :value, :string, example: 'GB123456789'
+        end
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/custom_field_value_request_schema.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Api
+    module V3
+      # A custom field value written inline with its owner (product, category, seller…).
+      class CustomFieldValueRequestSchema < Spree::Api::V3::RequestSchema
+        publishes 'CustomFieldValueParams'
+
+        attribute :id, :id
+        attribute :custom_field_definition_id, :id
+        attribute :value, :any,
+          description: 'A scalar for text, number and boolean fields; a list or a hash for JSON fields.'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/file_upload_request_schema.rb

@@ -0,0 +1,20 @@
+module Spree
+  module Api
+    module V3
+      # A file sent to `POST /files` (Spree::Api::V3::FileUploads): its
+      # details for a direct upload, or its bytes in a multipart request.
+      class FileUploadRequestSchema < Spree::Api::V3::RequestSchema
+        attribute :filename, :string, required: true, example: 'registration.pdf'
+        attribute :content_type, :string, required: true, example: 'application/pdf'
+        attribute :byte_size, :integer, example: 51_234
+        attribute :checksum, :string,
+          example: 'rL0Y20zC+Fzt72VPzMSk2A==',
+          description: 'Base64-encoded MD5 digest of the file; the storage service checks the bytes against it.'
+        attribute :visibility, :string,
+          choices: Spree::FileUpload::VISIBILITIES,
+          description: '`public` (the default) for images, videos and CSV files anyone may fetch, `private` for any type.'
+        attribute :file, :string, format: :binary, description: 'The bytes, for a multipart upload.'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/media_request_schema.rb

@@ -0,0 +1,27 @@
+module Spree
+  module Api
+    module V3
+      # What a media row itself carries, whichever endpoint writes it. Not
+      # published on its own: each endpoint adds how the file arrives.
+      class MediaRequestSchema < Spree::Api::V3::RequestSchema
+        attribute :alt, :string, nullable: true, example: 'Front view'
+        attribute :position, :integer, example: 1
+        attribute :media_type, :string,
+          choices: Spree::Media::MEDIA_TYPES,
+          example: 'image',
+          description: 'Defaults to `image`. `video` needs a `signed_id`; `external_video` needs an `external_video_url`.'
+        attribute :external_video_url, :string,
+          nullable: true,
+          description: 'YouTube or Vimeo link. Required when `media_type` is `external_video`.'
+        attribute :poster_signed_id, :string,
+          description: "A `signed_id` from `files.upload()` for a video's poster frame."
+        attribute :focal_point_x, :number,
+          nullable: true,
+          description: 'Where the image is anchored when cropped, from 0 to 1.'
+        attribute :focal_point_y, :number,
+          nullable: true,
+          description: 'Where the image is anchored when cropped, from 0 to 1.'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/price_request_schema.rb

@@ -0,0 +1,17 @@
+module Spree
+  module Api
+    module V3
+      # A variant's price in one currency.
+      class PriceRequestSchema < Spree::Api::V3::RequestSchema
+        publishes 'PriceParams'
+
+        attribute :currency, :currency, required: true, example: 'USD'
+        attribute :amount, :decimal,
+          required: true,
+          example: '29.99',
+          description: 'A canonical decimal string (`"1234.56"`: period decimal, no grouping). The API does not parse localized input.'
+        attribute :compare_at_amount, :decimal, nullable: true, example: '39.99'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/stock_level_request_schema.rb

@@ -0,0 +1,18 @@
+module Spree
+  module Api
+    module V3
+      # A variant's stock at one location.
+      class StockLevelRequestSchema < Spree::Api::V3::RequestSchema
+        publishes 'StockLevelParams'
+
+        # Rows are matched by location: an `id` would be ignored.
+        attribute :stock_location_id, :id, required: true, description: 'The location holding the stock (`sloc_...`).'
+        attribute :count_on_hand, :integer,
+          required: true,
+          description: 'Units physically at the location, not units available to sell: stock promised to placed orders counts until it ships. Sent as the count the shelf should end at; the API records the difference as an adjustment in the stock history.'
+        attribute :backorderable, :boolean,
+          description: 'Whether this location sells the variant beyond what it holds.'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/store/address_request_schema.rb

@@ -0,0 +1,29 @@
+module Spree
+  module Api
+    module V3
+      module Store
+        # An address as a shopper writes it on the Store API: on a cart and in
+        # their own address book. Not published on its own.
+        class AddressRequestSchema < Spree::Api::V3::RequestSchema
+          attribute :first_name, :string
+          attribute :last_name, :string
+          attribute :company, :string
+          attribute :address1, :string
+          attribute :address2, :string
+          attribute :city, :string
+          attribute :postal_code, :string
+          attribute :phone, :string
+          attribute :country_code, :country,
+            example: 'US',
+            description: 'ISO 3166-1 alpha-2 country code, such as `US` or `DE`.'
+          attribute :state_code, :string,
+            example: 'NY',
+            description: 'ISO 3166-2 subdivision code without the country prefix, such as `CA` or `NY`.'
+          attribute :state_name, :string, description: 'The state name, for countries without predefined states.'
+          attribute :country_iso, :string, deprecated: 'Use `country_code`. Removed in 6.1.'
+          attribute :state_abbr, :string, deprecated: 'Use `state_code`. Removed in 6.1.'
+        end
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/tax_identifier_request_schema.rb

@@ -0,0 +1,18 @@
+module Spree
+  module Api
+    module V3
+      # A tax registration. Each endpoint publishes it under its own name
+      # (`TaxIdentifierParams`, `SellerTaxIdentifierParams`). `kind` is
+      # registry-driven, so a plain string: any kind is stored, and one with a
+      # validator in Spree.tax_identifier_validators is checked by it.
+      class TaxIdentifierRequestSchema < Spree::Api::V3::RequestSchema
+        KIND_DESCRIPTION = 'The registration the number belongs to, such as `eu_vat` or `gb_vat`. ' \
+                           'Any kind is accepted; one with a registered validator is checked by it. ' \
+                           'Built-in: `eu_vat`. Extensions may register more.'.freeze
+
+        attribute :kind, :string, required: true, example: 'eu_vat', description: KIND_DESCRIPTION
+        attribute :value, :string, required: true, example: 'DE123456789'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/variant_option_request_schema.rb

@@ -0,0 +1,13 @@
+module Spree
+  module Api
+    module V3
+      # One option pair of a variant, such as size Small. Option types and values are created when missing.
+      class VariantOptionRequestSchema < Spree::Api::V3::RequestSchema
+        publishes 'VariantOptionParams'
+
+        attribute :name, :string, required: true, example: 'size'
+        attribute :value, :string, required: true, example: 'Small'
+      end
+    end
+  end
+end

data/app/request_schemas/spree/api/v3/variant_request_schema.rb

@@ -0,0 +1,52 @@
+module Spree
+  module Api
+    module V3
+      # A variant's own attributes, shared by the variant endpoints and the
+      # variants nested in a product payload. Not published on its own: each
+      # endpoint includes these fields into its own type.
+      class VariantRequestSchema < Spree::Api::V3::RequestSchema
+        attribute :sku, :string
+        attribute :barcode, :string
+        attribute :cost_price, :decimal, nullable: true
+        attribute :cost_currency, :currency
+        attribute :weight, :number, nullable: true
+        attribute :height, :number, nullable: true
+        attribute :width, :number, nullable: true
+        attribute :depth, :number, nullable: true
+        attribute :weight_unit, :string, choices: Spree::Variant::WEIGHT_UNITS
+        attribute :dimensions_unit, :string, choices: Spree::Variant::DIMENSION_UNITS
+        attribute :hs_code, :string
+        attribute :customs_description, :string
+        attribute :country_of_origin, :country
+        attribute :minimum_order_quantity, :integer, nullable: true
+        attribute :order_multiple, :integer, nullable: true
+        attribute :purchase_unit, :string
+        attribute :units_per_carton, :integer, nullable: true, description: 'How many units fill one carton.'
+        attribute :carton_package_type_id, :id,
+          nullable: true,
+          description: 'The carton this variant is packed into: a package type of kind `carton`. Its dimensions are shared by every product packed the same way, so a corrected carton size fixes all of them at once.'
+        attribute :carton_weight, :number,
+          nullable: true,
+          description: "What one packed carton weighs, in the variant's weight unit."
+        attribute :cartons_per_pallet, :integer, nullable: true, description: 'How many cartons stack on one pallet.'
+        attribute :seller_id, :id
+        attribute :delivery_profile_id, :id, nullable: true
+        attribute :track_inventory, :boolean
+        attribute :preorderable, :boolean,
+          description: "Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap comes from `backorder_limit`, an incoming stock count, or backorder."
+        attribute :preorder_ships_at, :datetime,
+          nullable: true,
+          description: 'The "ships by" date shown to customers while the variant is a pre-order. Once it passes, the variant is no longer a pre-order. Null clears it.'
+        attribute :backorder_limit, :integer,
+          nullable: true,
+          description: 'Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is unlimited.'
+        attribute :tax_category_id, :id
+        attribute :position, :integer
+        attribute :prices, :array, of: Spree::Api::V3::PriceRequestSchema,
+          description: 'Per-currency prices. Upserted by currency.'
+        attribute :stock_levels, :array, of: Spree::Api::V3::StockLevelRequestSchema,
+          description: 'Stock per location. Upserted by location; omitted locations are removed.'
+      end
+    end
+  end
+end

data/app/serializers/concerns/spree/api/v3/purchase_summary.rb

@@ -0,0 +1,48 @@
+module Spree
+  module Api
+    module V3
+      # The money summary a cart, an order and a multi-seller purchase all
+      # carry, declared once so a storefront renders any of them with one
+      # component, and a fix to one is a fix to all three.
+      #
+      # Every amount is nulled for a guest the storefront hides prices from,
+      # the payments' own included.
+      module PurchaseSummary
+        extend ActiveSupport::Concern
+
+        included do
+          typelize covered_by_store_credit: :boolean
+
+          money_attributes :item_total, :display_item_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,
+                           :delivery_total, :display_delivery_total,
+                           :fee_total, :display_fee_total,
+                           :gift_card_total, :display_gift_card_total,
+                           :store_credit_total, :display_store_credit_total,
+                           :total, :display_total,
+                           :amount_due, :display_amount_due,
+                           descriptions: {
+                             item_total: 'The line items: each price times its quantity, before discounts, fees and delivery.',
+                             discount_total: 'What promotions take off, as a negative amount. Manual discounts are not included.',
+                             tax_total: 'All tax, both included in prices and added on top.',
+                             included_tax_total: 'Tax already included in the prices, as in a store whose prices are tax-inclusive.',
+                             additional_tax_total: 'Tax added on top of the prices.',
+                             delivery_total: 'What delivery costs, before delivery discounts.',
+                             fee_total: 'Every fee charged, such as handling or a customs duty.',
+                             gift_card_total: 'What a gift card pays.',
+                             store_credit_total: 'What store credit pays, apart from gift cards.',
+                             total: 'What the customer pays in all: items, delivery, fees and added tax, less discounts.',
+                             amount_due: 'What is left to pay after payments and store credit.'
+                           }
+
+          attribute :covered_by_store_credit, &:covered_by_store_credit?
+
+          many :payments, resource: proc { Spree.api.payment_serializer }
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v3/address_serializer.rb

@@ -6,8 +6,10 @@ module Spree
                  address1: [:string, nullable: true], address2: [:string, nullable: true],
                  city: [:string, nullable: true], postal_code: [:string, nullable: true], phone: [:string, nullable: true],
                  company: [:string, nullable: true], state_code: [:string, nullable: true],
-                 state_abbr: [:string, nullable: true], state_name: [:string, nullable: true],
-                 state_text: [:string, nullable: true], country_code: :string, country_iso: :string,
+                 state_abbr: [:string, nullable: true, deprecated: 'Use `state_code`. Removed in 6.1.'],
+                 state_name: [:string, nullable: true],
+                 state_text: [:string, nullable: true], country_code: [:string, enum: Spree::IsoData.country_codes, enum_type_name: 'CountryCode'],
+                 country_iso: [:string, deprecated: 'Use `country_code`. Removed in 6.1.'],
                  country_name: :string,
                  quick_checkout: :boolean, is_default_billing: :boolean, is_default_shipping: :boolean,
                  label: [:string, nullable: true]

data/app/serializers/spree/api/v3/admin/address_serializer.rb

@@ -3,6 +3,9 @@ module Spree
     module V3
       module Admin
         class AddressSerializer < V3::AddressSerializer
+          # The Store API keeps these deprecated names until 6.1.
+          %i[state_abbr country_iso].each { |key| _attributes.delete(key) }
+
           typelize customer_id: [:string, nullable: true],
                    owner_id: [:string, nullable: true],
                    owner_type: [:string, nullable: true],
@@ -24,18 +27,16 @@ module Spree
             address.longitude&.to_f
           end
 
-          attribute :customer_id do |address|
-            address.customer_owner&.prefixed_id
-          end
+          prefixed_id_attributes customer_id: :customer_owner
 
           # Who the row belongs to — a customer's book, a company node's, or a
           # seller's billing address. `customer_id` above stays as the
           # customer-only shorthand the customers surface reads.
-          attribute :owner_id do |address|
-            address.owner&.prefixed_id
-          end
+          prefixed_id_attributes :owner
 
-          attributes :owner_type
+          attribute :owner_type do |address|
+            Spree::Base.polymorphic_api_type(address.owner_type)
+          end
         end
       end
     end

data/app/serializers/spree/api/v3/admin/api_key_serializer.rb

@@ -27,17 +27,13 @@ module Spree
                      created_at: :iso8601, updated_at: :iso8601,
                      revoked_at: :iso8601, last_used_at: :iso8601
 
-          attribute :channel_id do |key|
-            key.channel&.prefixed_id
-          end
+          prefixed_id_attributes :channel
 
           # Returned only on the create response — `plaintext_token` is held in
           # memory on the model after `generate_token` and is never persisted
           # for secret keys, so we serialize it whenever it's available rather
           # than gating on the action.
-          attribute :plaintext_token do |key|
-            key.plaintext_token
-          end
+          attributes :plaintext_token
 
           # A key can be minted by another key, which has no email — so the
           # address is answered only for the actors that have one, and

data/app/serializers/spree/api/v3/admin/applied_promotion_serializer.rb

@@ -3,9 +3,11 @@ module Spree
     module V3
       module Admin
         class AppliedPromotionSerializer < V3::AppliedPromotionSerializer
+          without_formatted_money
+
           # 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]
 
           attributes created_at: :iso8601, updated_at: :iso8601
         end

data/app/serializers/spree/api/v3/admin/cart_serializer.rb

@@ -12,7 +12,9 @@ module Spree
         # are redeclared with admin counterparts — admin serializers never
         # reference store serializers.
         class CartSerializer < V3::CartSerializer
-          %i[fulfillments payments payment_methods gift_card discounts fees].each { |key| _attributes.delete(key) }
+          without_formatted_money
+
+          %i[fulfillments payments payment_methods gift_card discounts fees number].each { |key| _attributes.delete(key) }
 
           typelize completed_at: [:string, nullable: true]
 

data/app/serializers/spree/api/v3/admin/catalog_assignment_serializer.rb

@@ -18,9 +18,7 @@ module Spree
             assignment.assignable_type.demodulize.underscore
           end
 
-          attribute :assignable_id do |assignment|
-            assignment.assignable&.prefixed_id
-          end
+          prefixed_id_attributes :assignable
 
           attribute :assignable_name do |assignment|
             assignment.assignable.try(:name)

data/app/serializers/spree/api/v3/admin/catalog_order_minimum_serializer.rb

@@ -5,17 +5,12 @@ module Spree
         # The least a whole order must come to under a catalog's agreement,
         # in one currency.
         class CatalogOrderMinimumSerializer < V3::BaseSerializer
-          typelize currency: :string, amount: :string, display_amount: :string
+          typelize currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode']
 
           attributes :currency, created_at: :iso8601, updated_at: :iso8601
 
-          attribute :amount do |minimum|
-            minimum.amount.to_s
-          end
-
-          attribute :display_amount do |minimum|
-            minimum.display_amount.to_s
-          end
+          money_attributes :amount
+          typelize amount: [:string, nullable: false]
         end
       end
     end

data/app/serializers/spree/api/v3/admin/catalog_price_serializer.rb

@@ -17,8 +17,7 @@ module Spree
           _attributes.delete(:id)
 
           typelize id: 'string | null', label: 'string | null', sku: 'string | null',
-                   amount: :string, display_amount: :string,
-                   currency: :string, source: [:string, enum: Spree::CatalogPrice::SOURCES], break_count: :number
+                   currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode'], source: [:string, enum: Spree::CatalogPrice::SOURCES], break_count: :number
 
           # The variant this prices, so a row can name what it is showing —
           # a product's variants can be priced differently, and one figure
@@ -33,9 +32,9 @@ module Spree
           # though it were the only one.
           attributes :currency, :source, :break_count
 
-          attribute :amount, &:display_value
+          money_attributes :amount, unit_price: true
+          typelize amount: [:string, nullable: false]
 
-          attributes :display_amount
 
           # The ladder itself, so the agreement page can show what a buyer
           # pays at each threshold without opening the price sheet

data/app/serializers/spree/api/v3/admin/catalog_price_tier_serializer.rb

@@ -11,11 +11,12 @@ module Spree
         class CatalogPriceTierSerializer < V3::BaseSerializer
           _attributes.delete(:id)
 
-          typelize min_quantity: :number, amount: :string, display_amount: :string
+          typelize min_quantity: :number
 
-          attributes :min_quantity, :display_amount
+          attributes :min_quantity
 
-          attribute :amount, &:display_value
+          money_attributes :amount, unit_price: true
+          typelize amount: [:string, nullable: false]
         end
       end
     end

data/app/serializers/spree/api/v3/admin/catalog_product_term_serializer.rb

@@ -28,9 +28,7 @@ module Spree
           # True when the product's variants carry different terms, so the
           # editor shows "mixed" rather than claiming one variant's pair is
           # the product's.
-          attribute :mixed do |term|
-            term.mixed?
-          end
+          attribute :mixed, &:mixed?
         end
       end
     end

data/app/serializers/spree/api/v3/admin/catalog_quantity_rule_serializer.rb

@@ -15,9 +15,7 @@ module Spree
           attributes :minimum_order_quantity, :order_multiple,
                      created_at: :iso8601, updated_at: :iso8601
 
-          attribute :variant_id do |rule|
-            rule.variant&.prefixed_id
-          end
+          prefixed_id_attributes :variant
 
           attribute :variant_sku do |rule|
             rule.variant&.sku

data/app/serializers/spree/api/v3/admin/channel_serializer.rb

@@ -4,16 +4,15 @@ module Spree
       module Admin
         class ChannelSerializer < V3::ChannelSerializer
           typelize store_id: :string,
-                   preferred_order_routing_strategy: [:string, nullable: true],
-                   preferred_storefront_access: [:string, nullable: true],
-                   preferred_guest_checkout: [:boolean, nullable: true],
+                   order_routing_strategy: [:string, nullable: true, comment: 'Order routing strategy; null inherits the store setting. Built-in: rules. Extensions may register more.'],
                    stock_location_ids: [:string, multi: true],
                    default_catalog_id: [:string, nullable: true]
 
-          attributes :preferred_order_routing_strategy,
-                     :preferred_storefront_access,
-                     :preferred_guest_checkout,
-                     created_at: :iso8601, updated_at: :iso8601
+          attributes created_at: :iso8601, updated_at: :iso8601
+
+          preference_attributes Spree::Channel, except: %i[order_routing_strategy]
+
+          api_type_attributes :order_routing_strategy
 
           # Fulfillment-origin allowlist; empty means every store location
           # serves this channel.
@@ -23,9 +22,7 @@ module Spree
 
           # When set, only the default catalog's products are visible on this
           # channel; unset means every publication.
-          attribute :default_catalog_id do |record|
-            record.default_catalog&.prefixed_id
-          end
+          prefixed_id_attributes :default_catalog
         end
       end
     end

data/app/serializers/spree/api/v3/admin/claim_line_item_serializer.rb

@@ -5,6 +5,13 @@ module Spree
     module V3
       module Admin
         class ClaimLineItemSerializer < V3::ClaimLineItemSerializer
+          without_formatted_money
+
+          # No guest price gating here, so the inherited money fields are always present.
+          typelize refund_amount: [:string, nullable: false], paid_amount: [:string, nullable: false],
+                   pre_tax_amount: [:string, nullable: false], included_tax_total: [:string, nullable: false],
+                   additional_tax_total: [:string, nullable: false], tax_total: [:string, nullable: false]
+
           attributes created_at: :iso8601, updated_at: :iso8601
 
           one :variant, resource: proc { Spree.api.admin_variant_serializer }, if: proc { expand?('variant') }

data/app/serializers/spree/api/v3/admin/claim_reason_serializer.rb

@@ -11,9 +11,7 @@ module Spree
 
           # Lets the dashboard hide destructive controls instead of offering a
           # delete that the model will refuse.
-          attribute :can_be_deleted do |reason|
-            reason.can_be_deleted?
-          end
+          attribute :can_be_deleted, &:can_be_deleted?
         end
       end
     end

data/app/serializers/spree/api/v3/admin/claim_serializer.rb

@@ -5,6 +5,11 @@ module Spree
     module V3
       module Admin
         class ClaimSerializer < V3::ClaimSerializer
+          without_formatted_money
+
+          # No guest price gating here, so the inherited money fields are always present.
+          typelize refund_total: [:string, nullable: false]
+
           typelize memo: [:string, nullable: true],
                    metadata: 'Record<string, unknown>',
                    created_by_id: [:string, nullable: true],