spree_api 6.0.0.beta4 → 6.0.0.rc2

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

@@ -20,18 +20,10 @@ module Spree
                    fulfillment_id: 'string | null',
                    commission_rate_id: 'string | null',
                    kind: [:string, enum: Spree::CommissionRate::KINDS],
-                   rate: :string,
-                   tax_rate: :string,
                    taxability_reason: 'string | null',
-                   country_code: 'string | null',
+                   country_code: [:string, nullable: true, enum: Spree::IsoData.country_codes, enum_type_name: 'CountryCode'],
                    state_code: 'string | null',
-                   amount: :string,
-                   tax_amount: :string,
-                   total: :string,
-                   currency: :string,
-                   display_amount: :string,
-                   display_tax_amount: :string,
-                   display_total: :string
+                   currency: [:string, enum: Spree::Money::Rounding::CURRENCY_CODES, enum_type_name: 'CurrencyCode']
 
           # The treatment, in Spree::TaxLine's vocabulary — a seller's invoice
           # has to explain why its fee was taxed the way it was, and the
@@ -39,14 +31,11 @@ module Spree
           attributes :kind, :currency, :taxability_reason, :country_code, :state_code,
                      created_at: :iso8601, updated_at: :iso8601
 
-          # Strings, so the figures a seller is invoiced round-trip exactly.
-          %i[rate tax_rate amount tax_amount total].each do |decimal|
-            attribute(decimal) { |line| line.public_send(decimal)&.to_s }
-          end
-
-          %i[display_amount display_tax_amount display_total].each do |formatted|
-            attribute(formatted) { |line| line.public_send(formatted).to_s }
-          end
+          rate_attributes :rate, :tax_rate
+          money_attributes :amount, :tax_amount, :total
+          typelize rate: [:string, nullable: false], tax_rate: [:string, nullable: false],
+                   amount: [:string, nullable: false], tax_amount: [:string, nullable: false],
+                   total: [:string, nullable: false]
 
           %i[order seller line_item fulfillment commission_rate].each do |association|
             attribute(:"#{association}_id") { |line| line.public_send(association)&.prefixed_id }

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

@@ -10,21 +10,16 @@ module Spree
         # were actually charged (Spree::CommissionLine) on their own branch,
         # never the rules that produced it.
         class CommissionRateSerializer < V3::BaseSerializer
-          # Decimals serialize as strings, like every other money-ish field on
-          # the admin API: a rate has to round-trip exactly, and a float does
-          # not promise that.
           typelize name: :string,
                    code: 'string | null',
                    enabled: :boolean,
                    position: :number,
                    global: :boolean,
                    kind: [:string, enum: Spree::CommissionRate::KINDS],
-                   value: :string,
                    amounts: 'Record<string, string>',
                    bounds: 'Record<string, { min_amount: string | null; max_amount: string | null }>',
                    tax_inclusive: :boolean,
                    include_shipping: :boolean,
-                   commission_tax_rate: 'string | null',
                    metadata: 'Record<string, unknown> | null',
                    deleted_at: 'string | null'
 
@@ -32,22 +27,23 @@ module Spree
                      :tax_inclusive, :include_shipping, :metadata,
                      deleted_at: :iso8601, created_at: :iso8601, updated_at: :iso8601
 
-          %i[value commission_tax_rate].each do |decimal|
-            attribute(decimal) { |rate| rate.public_send(decimal)&.to_s }
-          end
+          # +value+ is the percentage a percentage rate charges; a flat fee's
+          # money lives in +amounts+, per currency.
+          rate_attributes :value, :commission_tax_rate
+          typelize value: [:string, nullable: false]
 
           # What a flat fee charges, per currency. Empty on a percentage rate,
           # which needs no amount of its own.
           attribute :amounts do |rate|
-            rate.amounts.transform_values(&:to_s)
+            rate.amounts.to_h { |currency, amount| [currency, Spree::Money::Rounding.format(amount, currency)] }
           end
 
           # The floor and cap a percentage charges within, per currency. Each
           # holds only in its own currency, so a rate may bound some and leave
           # others unbounded.
           attribute :bounds do |rate|
-            rate.bounds.transform_values do |bound|
-              bound.transform_values { |amount| amount&.to_s }
+            rate.bounds.to_h do |currency, bound|
+              [currency, bound.transform_values { |amount| Spree::Money::Rounding.format(amount, currency) }]
             end
           end
 

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

@@ -13,7 +13,6 @@ module Spree
           typelize type: [:string, comment: 'Rule type. Built-in: seller_rule, category_rule, product_rule, item_total_rule. Extensions may register more.'],
                    commission_rate_id: :string,
                    preferences: 'Record<string, unknown>',
-                   preference_schema: 'Array<{ key: string; type: string; default: unknown }>',
                    product_ids: 'Array<string> | null',
                    seller_ids: 'Array<string> | null',
                    category_ids: 'Array<string> | null'
@@ -24,12 +23,9 @@ module Spree
             rule.class.api_type
           end
 
-          attribute :commission_rate_id do |rule|
-            rule.commission_rate&.prefixed_id
-          end
+          prefixed_id_attributes :commission_rate
 
           attribute :preferences, &:serialized_preferences
-          attribute :preference_schema, &:serialized_preference_schema
 
           # Reference lists are returned as prefixed IDs to match the rest of
           # the API. Product ids are read through a join table; seller and

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

@@ -4,7 +4,11 @@ module Spree
       module Admin
         # No timestamps: countries are reference data supplied by the countries
         # gem rather than records, so they have no created_at/updated_at.
+        # The dashboard names countries with Intl.DisplayNames in the admin's
+        # own language, so the Admin API sends the ISO code alone.
         class CountrySerializer < V3::CountrySerializer
+          _attributes.delete(:name)
+
           many :states,
                resource: proc { Spree.api.admin_state_serializer },
                if: proc { params[:expand]&.include?('states') }

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

@@ -16,13 +16,7 @@ module Spree
           attributes :code, :state,
                      created_at: :iso8601, updated_at: :iso8601
 
-          attribute :promotion_id do |coupon|
-            coupon.promotion&.prefixed_id
-          end
-
-          attribute :order_id do |coupon|
-            coupon.order&.prefixed_id
-          end
+          prefixed_id_attributes :promotion, :order
         end
       end
     end

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

@@ -7,13 +7,7 @@ module Spree
                    payment_method_id: [:string, nullable: true],
                    metadata: 'Record<string, unknown>'
 
-          attribute :customer_id do |credit_card|
-            credit_card.customer&.prefixed_id
-          end
-
-          attribute :payment_method_id do |credit_card|
-            credit_card.payment_method&.prefixed_id
-          end
+          prefixed_id_attributes :customer, :payment_method
 
           attributes :metadata,
                      created_at: :iso8601, updated_at: :iso8601

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

@@ -9,15 +9,19 @@ module Spree
                    key: :string,
                    label: :string,
                    field_type: Spree::CustomField::FIELD_TYPE_TOKENS,
-                   resource_type: [:string, comment: 'Class name of the resource the field attaches to, for example Spree::Product, Spree::Order or Spree::Customer. Extensions may register more.'],
+                   resource_type: [:string, comment: 'Shorthand of the resource the field attaches to, for example product, variant, order, customer or category. Discover the full list from the resource_types endpoint; extensions may register more.'],
                    storefront_visible: :boolean,
                    searchable: :boolean,
                    sortable: :boolean,
                    filter_key: :string
 
-          attributes :namespace, :key, :label, :field_type, :resource_type, :storefront_visible,
+          attributes :namespace, :key, :label, :field_type, :storefront_visible,
                      :searchable, :sortable, :filter_key,
                      created_at: :iso8601, updated_at: :iso8601
+
+          attribute :resource_type do |definition|
+            Spree::Base.polymorphic_api_type(definition.resource_type)
+          end
         end
       end
     end

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

@@ -5,13 +5,14 @@ module Spree
         # Admin API Customer Serializer
         # Full customer data including admin-only fields
         class CustomerSerializer < V3::CustomerSerializer
+          without_formatted_money
+
           typelize failed_attempts: :number,
                    tags: [:string, multi: true],
                    internal_note: [:string, nullable: true], internal_note_html: [:string, nullable: true],
                    metadata: 'Record<string, unknown>',
                    orders_count: :number,
                    total_spent: :string,
-                   display_total_spent: :string,
                    last_order_completed_at: [:string, nullable: true],
                    default_billing_address_id: [:string, nullable: true],
                    default_shipping_address_id: [:string, nullable: true],
@@ -28,9 +29,7 @@ module Spree
             user.anonymized_at&.iso8601
           end
 
-          attribute :anonymized do |user|
-            user.anonymized?
-          end
+          attribute :anonymized, &:anonymized?
 
           attribute :tags do |user|
             user.tags.map(&:name) # not pluck as we preload tags
@@ -44,13 +43,7 @@ module Spree
             user.respond_to?(:internal_note) ? user.internal_note.presence : nil
           end
 
-          attribute :default_billing_address_id do |user|
-            user.bill_address&.prefixed_id
-          end
-
-          attribute :default_shipping_address_id do |user|
-            user.ship_address&.prefixed_id
-          end
+          prefixed_id_attributes default_billing_address_id: :bill_address, default_shipping_address_id: :ship_address
 
           # Order aggregates: prefer attributes precomputed on the scope (see
           # CustomersController#scope) to avoid N+1 on list endpoints. Fall
@@ -61,13 +54,8 @@ module Spree
           end
 
           attribute :total_spent do |user|
-            (user.attributes['total_spent'] || user.orders.complete.sum(:total)).to_s
-          end
-
-          attribute :display_total_spent do |user|
             amount = user.attributes['total_spent'] || user.orders.complete.sum(:total)
-            currency = Spree::Current.currency || Spree::Current.store&.default_currency
-            Spree::Money.new(amount, currency: currency).to_s
+            Spree::Money::Rounding.format(amount, (current_store || Spree::Current.store)&.default_currency)
           end
 
           attribute :last_order_completed_at do |user|

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

@@ -19,14 +19,10 @@ module Spree
 
           attributes :email, :error_message, created_at: :iso8601, updated_at: :iso8601
 
-          attribute :customer_id do |data_request|
-            data_request.customer&.prefixed_id
-          end
+          prefixed_id_attributes :customer
 
           # Null when the subject asked for it themselves.
-          attribute :requested_by_id do |data_request|
-            data_request.requested_by&.prefixed_id
-          end
+          prefixed_id_attributes :requested_by
 
           one :customer, resource: proc { Spree.api.admin_customer_serializer }, if: proc { expand?('customer') }
         end

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

@@ -6,7 +6,6 @@ module Spree
           typelize type: [:string, comment: 'Rule type. Built-in: item_total_rule, weight_rule, excluded_products_rule, channel_rule, volume_rule, company_rule. Extensions may register more.'],
                    active: :boolean,
                    preferences: 'Record<string, unknown>',
-                   preference_schema: "Array<{ key: string; type: string; default: unknown; choices?: string[] }>",
                    product_ids: [:string, multi: true]
 
           attributes :active, created_at: :iso8601, updated_at: :iso8601
@@ -18,7 +17,6 @@ module Spree
           end
 
           attribute :preferences, &:serialized_preferences
-          attribute :preference_schema, &:serialized_preference_schema
 
           # Association-backed config (ExcludedProductsRule); empty for
           # preference-only rules. Same name read and written.

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

@@ -4,33 +4,38 @@ module Spree
       module Admin
         class DeliveryMethodSerializer < V3::DeliveryMethodSerializer
           typelize admin_name: [:string, nullable: true],
-                   fulfillment_provider: :string, pickup_point_provider: [:string, nullable: true],
-                   rate_provider: [:string, nullable: true],
+                   fulfillment_provider: [:string, comment: 'Fulfillment provider. Built-in: manual, digital, pickup, pickup_point. Provider gems register more (e.g. easy_post).'],
+                   pickup_point_provider: [:string, nullable: true, comment: 'Pickup point network. None built in; provider gems register them.'],
+                   rate_provider: [:string, nullable: true, comment: 'Rate provider; null prices through the calculator. Built-in: internal, freight. Provider gems register more (e.g. easy_post).'],
                    storefront_visible: :boolean, tracking_url: [:string, nullable: true],
                    tax_category_id: [:string, nullable: true],
                    delivery_profile_id: :string,
                    delivery_origin_group_id: [:string, nullable: true],
                    delivery_zone_id: [:string, nullable: true],
                    stock_location_ids: [:string, multi: true],
-                   calculator_type: [:string, nullable: true],
-                   calculator_preferences: ['Record<string, unknown>', nullable: true],
+                   calculator: 'TypedDeliveryCalculator | null',
                    markup_flat: [:string, nullable: true],
                    markup_percent: [:string, nullable: true],
                    available_to_sellers: :boolean,
                    seller_id: [:string, nullable: true],
                    seller_name: [:string, nullable: true]
 
-          attributes :admin_name, :fulfillment_provider, :pickup_point_provider,
-                     :rate_provider, :storefront_visible, :tracking_url,
-                     :markup_flat, :markup_percent, :available_to_sellers,
+          attributes :admin_name, :storefront_visible, :tracking_url, :available_to_sellers,
                      created_at: :iso8601, updated_at: :iso8601, deleted_at: :iso8601
 
+          # The flat markup is charged in whatever currency the rate is quoted
+          # in, so it is shown as stored rather than rounded to one currency:
+          # a rounded figure would be saved back.
+          attribute :markup_flat do |record|
+            Spree::Money::Rounding.format(record.markup_flat, (current_store || Spree::Current.store)&.default_currency, unit_price: true)
+          end
+
+          rate_attributes :markup_percent
+
           # Which seller runs this method, so the operator's list can say
           # whose it is. Null is the marketplace's own
           # (docs/plans/6.0-multi-vendor-marketplace.md, Decision 13).
-          attribute :seller_id do |record|
-            record.seller&.prefixed_id
-          end
+          prefixed_id_attributes :seller
 
           attribute :seller_name do |record|
             record.seller&.name
@@ -42,32 +47,17 @@ module Spree
           # eligibility without a request per method.
           many :delivery_method_rules, key: :rules, resource: proc { Spree.api.admin_delivery_method_rule_serializer }
 
-          attribute :tax_category_id do |record|
-            record.tax_category&.prefixed_id
-          end
-
-          attribute :delivery_profile_id do |record|
-            record.delivery_profile&.prefixed_id
-          end
-
-          attribute :delivery_origin_group_id do |record|
-            record.delivery_origin_group&.prefixed_id
-          end
-
-          attribute :delivery_zone_id do |record|
-            record.delivery_zone&.prefixed_id
-          end
+          prefixed_id_attributes :tax_category, :delivery_profile, :delivery_origin_group, :delivery_zone
 
           attribute :stock_location_ids do |record|
             record.pickup_locations.map(&:prefixed_id)
           end
 
-          attribute :calculator_type do |record|
-            record.calculator&.class&.api_type
-          end
+          api_type_attributes :fulfillment_provider, :pickup_point_provider, :rate_provider
 
-          attribute :calculator_preferences do |record|
-            record.calculator.respond_to?(:serialized_preferences) ? record.calculator.serialized_preferences : record.calculator&.preferences
+          attribute :calculator do |record|
+            calculator = record.calculator
+            { type: calculator.class.api_type, preferences: calculator.serialized_preferences } if calculator
           end
         end
       end

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

@@ -7,7 +7,15 @@ module Spree
                    markup_flat: [:string, nullable: true], markup_percent: [:string, nullable: true],
                    position: :number
 
-          attributes :carrier, :service, :label, :markup_flat, :markup_percent, :position
+          attributes :carrier, :service, :label
+
+          attribute :markup_flat do |record|
+            Spree::Money::Rounding.format(record.markup_flat, (current_store || Spree::Current.store)&.default_currency, unit_price: true)
+          end
+
+          rate_attributes :markup_percent
+
+          attributes :position
         end
       end
     end

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

@@ -11,9 +11,7 @@ module Spree
           attributes :name, :position,
                      created_at: :iso8601, updated_at: :iso8601
 
-          attribute :delivery_profile_id do |record|
-            record.delivery_profile&.prefixed_id
-          end
+          prefixed_id_attributes :delivery_profile
 
           # Empty means every store location.
           attribute :stock_location_ids do |record|

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

@@ -3,6 +3,14 @@ module Spree
     module V3
       module Admin
         class DeliveryRateSerializer < V3::DeliveryRateSerializer
+          without_formatted_money
+
+          # No guest price gating here, so the inherited money fields are always present.
+          typelize cost: [:string, nullable: false],
+                   total: [:string, nullable: false],
+                   additional_tax_total: [:string, nullable: false],
+                   included_tax_total: [:string, nullable: false], tax_total: [:string, nullable: false]
+
           typelize metadata: ['Record<string, unknown>', nullable: true]
 
           # Raw carrier payload (quote ids, service codes) — operational

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

@@ -10,9 +10,7 @@ module Spree
           # Operational detail, so admin-only.
           attributes :details, created_at: :iso8601, updated_at: :iso8601
 
-          attribute :shipping_label_id do |delivery|
-            delivery.shipping_label&.prefixed_id
-          end
+          prefixed_id_attributes :shipping_label
         end
       end
     end

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

@@ -9,13 +9,7 @@ module Spree
 
           attributes created_at: :iso8601, updated_at: :iso8601
 
-          attribute :delivery_profile_id do |record|
-            record.delivery_profile&.prefixed_id
-          end
-
-          attribute :delivery_origin_group_id do |record|
-            record.delivery_origin_group&.prefixed_id
-          end
+          prefixed_id_attributes :delivery_profile, :delivery_origin_group
 
           attribute :delivery_method_ids do |record|
             record.delivery_methods.map(&:prefixed_id)

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

@@ -10,14 +10,16 @@ module Spree
                    authorized_days: [:number, nullable: true],
                    effective_authorized_clicks: :number,
                    effective_authorized_days: :number,
-                   provider_type: [:string, nullable: true],
+                   provider_type: [:string, nullable: true, comment: 'Digital asset provider; null is an uploaded file. Built-in: file. Extensions may register more.'],
                    provider_name: [:string, comment: 'Digital asset provider name. Built-in: File. Extensions may register more.'],
                    provider_settings: 'Record<string, unknown>',
                    download_url: [:string, nullable: true]
 
-          attributes :authorized_clicks, :authorized_days, :byte_size, :provider_type, :provider_settings
+          attributes :authorized_clicks, :authorized_days, :byte_size, :provider_settings
           attributes created_at: :iso8601, updated_at: :iso8601
 
+          api_type_attributes :provider_type
+
           # Human-readable source for the admin listing. Blank provider_type is
           # the uploaded-file default, so this reads "File" there.
           attribute :provider_name do |digital_asset|

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

@@ -3,7 +3,9 @@ module Spree
     module V3
       module Admin
         class DiscountSerializer < V3::DiscountSerializer
-          typelize amount: [:string, nullable: false], display_amount: [:string, nullable: false],
+          without_formatted_money
+
+          typelize amount: [:string, nullable: false],
                    metadata: ['Record<string, unknown>', nullable: true]
 
           attributes :metadata, created_at: :iso8601, updated_at: :iso8601

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

@@ -0,0 +1,19 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class EmailTemplateDraftSerializer < V3::BaseSerializer
+          typelize subject: [:string, nullable: true],
+                   body: :string,
+                   lock_version: :number,
+                   updated_by_id: [:string, nullable: true],
+                   updated_by_type: [:string, nullable: true, enum: Spree::Actor::BUILT_IN_KINDS, enum_type_name: 'ActorKind']
+
+          attributes :subject, :body, :lock_version, created_at: :iso8601, updated_at: :iso8601
+
+          actor_attributes :updated_by
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # A rendered preview of an email template, with the variables it was
+        # rendered with, as example values for the editor.
+        class EmailTemplatePreviewSerializer < V3::BaseSerializer
+          typelize id: [:string, nullable: true],
+                   subject: :string,
+                   html: :string,
+                   text: :string,
+                   email_key: :string,
+                   variables: 'Record<string, unknown>'
+
+          attribute :subject do |preview|
+            preview.rendered.subject
+          end
+
+          attribute :html do |preview|
+            preview.rendered.html
+          end
+
+          attribute :text do |preview|
+            preview.rendered.text
+          end
+
+          # The email the preview renders: the template itself, or for the
+          # layout and partials, the email shown around them.
+          attribute :email_key do |preview|
+            preview.email.key.tr('/', '.')
+          end
+
+          attribute :variables, &:variables
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class EmailTemplateRevisionSerializer < V3::BaseSerializer
+          typelize subject: [:string, nullable: true],
+                   body: :string,
+                   published_by_id: [:string, nullable: true],
+                   published_by_type: [:string, nullable: true, enum: Spree::Actor::BUILT_IN_KINDS, enum_type_name: 'ActorKind']
+
+          attributes :subject, :body, created_at: :iso8601
+
+          actor_attributes :published_by
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        class EmailTemplateSampleRecordSerializer < V3::BaseSerializer
+          typelize label: :string, created_at: :string
+
+          attributes :label, created_at: :iso8601
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+module Spree
+  module Api
+    module V3
+      module Admin
+        # An editable email template for one language: what customers receive
+        # now (the store's published version, else Spree's default), Spree's
+        # default, and the draft in progress.
+        class EmailTemplateSerializer < V3::BaseSerializer
+          typelize key: :string,
+                   kind: [:string, enum: Spree::Emails::EditableTemplates::KINDS.map(&:to_s)],
+                   language: :string,
+                   customized: :boolean,
+                   customized_languages: [:string, multi: true],
+                   subject: [:string, nullable: true],
+                   body: :string,
+                   published_at: [:string, nullable: true],
+                   published_language: [:string, nullable: true],
+                   default_subject: [:string, nullable: true],
+                   default_body: :string,
+                   default_changed: :boolean,
+                   base_subject: [:string, nullable: true],
+                   base_body: [:string, nullable: true],
+                   draft: ['EmailTemplateDraft', nullable: true]
+
+          attributes :key, :subject, :body
+
+          # A language code, or `any` for the version every language uses.
+          attribute :language, &:locale
+
+          attribute :customized_languages, &:customized_locales
+
+          attribute :kind do |entry|
+            entry.kind.to_s
+          end
+
+          attribute :customized, &:customized?
+
+          attribute :published_at do |entry|
+            entry.published&.published_at&.iso8601
+          end
+
+          attributes :default_subject, :default_body
+
+          # `any` when this language has no version of its own and customers
+          # receive the one for every language.
+          attribute :published_language, &:published_locale
+
+          attribute :default_changed do |entry|
+            entry.outdated_version.present?
+          end
+
+          # The default the store's version started from, when Spree's default
+          # has changed since: compare it with `default_body` to see what changed.
+          attributes :base_subject, :base_body
+
+          one :draft, resource: proc { Spree.api.admin_email_template_draft_serializer }
+        end
+      end
+    end
+  end
+end

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

@@ -5,6 +5,11 @@ module Spree
     module V3
       module Admin
         class ExchangeLineItemSerializer < V3::ExchangeLineItemSerializer
+          # No guest price gating here, so the inherited money fields are always present.
+          typelize original_price: [:string, nullable: false], new_variant_price: [:string, nullable: false],
+                   price_difference: [:string, nullable: false], original_tax_total: [:string, nullable: false],
+                   new_tax_total: [:string, nullable: false]
+
           attributes created_at: :iso8601, updated_at: :iso8601
 
           one :original_variant, resource: proc { Spree.api.admin_variant_serializer }, if: proc { expand?('original_variant') }