@spree/seller-dashboard 1.0.0-rc.2 → 1.0.0-rc.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spree/seller-dashboard",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "license": "MIT",
   "type": "module",
   "description": "Spree marketplace seller panel — the seller-facing counterpart to the admin dashboard.",
@@ -49,9 +49,9 @@
     "react-hook-form": "^7.65.0",
     "react-i18next": "^17.0.8",
     "zod": "^4.4.3",
-    "@spree/dashboard-core": "1.0.0-rc.2",
-    "@spree/dashboard-ui": "1.0.0-rc.2",
-    "@spree/seller-sdk": "1.0.0-rc.1"
+    "@spree/dashboard-ui": "1.0.0-rc.3",
+    "@spree/seller-sdk": "1.0.0-rc.3",
+    "@spree/dashboard-core": "1.0.0-rc.3"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/api-client.ts

@@ -1,4 +1,4 @@
-import { setApiClient } from '@spree/dashboard-core'
+import { runtimeListParams, setApiClient } from '@spree/dashboard-core'
 import type { SellerApiClient, SellerExportCreateParams } from '@spree/seller-sdk'
 import { createSellerClient } from '@spree/seller-sdk'
 
@@ -71,7 +71,7 @@ export function createSellerApiClient({
     // The shared address form reads countries through the registered client,
     // so it works in a panel that has no admin credential.
     listCountries: () => sellerClient().countries.list(),
-    createDirectUpload: (params) => sellerClient().directUploads.create(params),
+    uploadFile: (file, options) => sellerClient().files.upload(file, options),
     // A file download is a bare fetch, so it does not go through the client
     // and picks up none of its headers. Without the seller header the Seller
     // API refuses the request before the action runs, so an export would
@@ -89,7 +89,7 @@ export function createSellerApiClient({
     // the marketplace and translations of catalog copy are its merchandising,
     // so the Seller API refuses both and the wizard offers neither.
     imports: {
-      list: (params) => sellerClient().imports.list(params),
+      list: (params) => sellerClient().imports.list(runtimeListParams(params)),
       get: (id) => sellerClient().imports.get(id),
       create: (params) =>
         sellerClient().imports.create({
@@ -101,7 +101,10 @@ export function createSellerApiClient({
       completeMapping: (id, params) => sellerClient().imports.completeMapping(id, params),
       retryFailedRows: (id) => sellerClient().imports.retryFailedRows(id),
       delete: (id) => sellerClient().imports.delete(id),
-      rows: { list: (importId, params) => sellerClient().imports.rows.list(importId, params) },
+      rows: {
+        list: (importId, params) =>
+          sellerClient().imports.rows.list(importId, runtimeListParams(params)),
+      },
       types: ['products'],
       // This panel's product list is keyed `seller-products`, so core's
       // default `products` invalidation would miss it and the list would sit
@@ -115,7 +118,7 @@ export function createSellerApiClient({
     // stock levels and is named on historical fulfillments, so the Seller API
     // does not offer it and the page hides the action accordingly.
     stockLocations: {
-      list: (params) => sellerClient().stockLocations.list(params),
+      list: (params) => sellerClient().stockLocations.list(runtimeListParams(params)),
       get: (id) => sellerClient().stockLocations.get(id),
       create: (params) => sellerClient().stockLocations.create(params),
       update: (id, params) => sellerClient().stockLocations.update(id, params),
@@ -126,16 +129,18 @@ export function createSellerApiClient({
     // shared Categorization card offers just these two
     // (docs/plans/6.0-multi-vendor-marketplace.md, Decision 13).
     productTypes: {
-      list: (params) => sellerClient().productTypes.list(params),
+      list: (params) => sellerClient().productTypes.list(runtimeListParams(params)),
       get: (id) => sellerClient().productTypes.get(id),
     },
-    deliveryProfiles: { list: (params) => sellerClient().deliveryProfiles.list(params) },
+    deliveryProfiles: {
+      list: (params) => sellerClient().deliveryProfiles.list(runtimeListParams(params)),
+    },
     // What this seller packs into: their own boxes and cartons, plus the
     // marketplace's shared packaging, which the API lists read-only. Backs
     // both the packaging settings page and the variant editor's carton
     // picker (docs/plans/6.0-seller-package-types.md).
     packageTypes: {
-      list: (params) => sellerClient().packageTypes.list(params),
+      list: (params) => sellerClient().packageTypes.list(runtimeListParams(params)),
       get: (id) => sellerClient().packageTypes.get(id),
       create: (params) => sellerClient().packageTypes.create(params),
       update: (id, params) => sellerClient().packageTypes.update(id, params),

package/src/components/finance/balance-summary.tsx

@@ -1,3 +1,4 @@
+import { formatMoney, useMoneyLocale } from '@spree/dashboard-core'
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@spree/dashboard-ui'
 import type { Balance } from '@spree/seller-sdk'
 import { useTranslation } from 'react-i18next'
@@ -16,6 +17,7 @@ import { useTranslation } from 'react-i18next'
  */
 export function BalanceSummary({ balances }: { balances: Balance[] }) {
   const { t } = useTranslation()
+  const locale = useMoneyLocale()
 
   if (balances.length === 0) {
     return (
@@ -30,31 +32,37 @@ export function BalanceSummary({ balances }: { balances: Balance[] }) {
 
   return (
     <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3">
-      {balances.map((balance) => (
-        <Card key={`${balance.currency}-${balance.settlement_currency}`}>
-          <CardHeader>
-            <CardTitle>
-              {t('earnings.balance.owed', { currency: balance.settlement_currency })}
-            </CardTitle>
-            {balance.converted && (
-              <CardDescription>
-                {t('earnings.balance.converted', { currency: balance.currency })}
-              </CardDescription>
-            )}
-          </CardHeader>
-          <CardContent className="flex flex-col gap-3">
-            <span className="text-2xl font-semibold tabular-nums">{balance.display_balance}</span>
-            <dl className="flex flex-col gap-1 text-sm">
-              <Figure label={t('earnings.balance.earned')} value={balance.display_earned} />
+      {balances.map((balance) => {
+        // Earned and pending are what the sales were worth; the rest is what
+        // the account holds, in the currency it settles in.
+        const sold = (amount: string) => formatMoney(amount, balance.currency, locale)
+        const held = (amount: string) => formatMoney(amount, balance.settlement_currency, locale)
+        return (
+          <Card key={`${balance.currency}-${balance.settlement_currency}`}>
+            <CardHeader>
+              <CardTitle>
+                {t('earnings.balance.owed', { currency: balance.settlement_currency })}
+              </CardTitle>
               {balance.converted && (
-                <Figure label={t('earnings.balance.payable')} value={balance.display_payable} />
+                <CardDescription>
+                  {t('earnings.balance.converted', { currency: balance.currency })}
+                </CardDescription>
               )}
-              <Figure label={t('earnings.balance.paid')} value={balance.display_paid} />
-              <Figure label={t('earnings.balance.pending')} value={balance.display_pending} />
-            </dl>
-          </CardContent>
-        </Card>
-      ))}
+            </CardHeader>
+            <CardContent className="flex flex-col gap-3">
+              <span className="text-2xl font-semibold tabular-nums">{held(balance.balance)}</span>
+              <dl className="flex flex-col gap-1 text-sm">
+                <Figure label={t('earnings.balance.earned')} value={sold(balance.earned)} />
+                {balance.converted && (
+                  <Figure label={t('earnings.balance.payable')} value={held(balance.payable)} />
+                )}
+                <Figure label={t('earnings.balance.paid')} value={held(balance.paid)} />
+                <Figure label={t('earnings.balance.pending')} value={sold(balance.pending)} />
+              </dl>
+            </CardContent>
+          </Card>
+        )
+      })}
     </div>
   )
 }

package/src/components/orders/fulfillment-edit-dialog.tsx

@@ -1,5 +1,6 @@
+import { formatMoney, useMoneyLocale } from '@spree/dashboard-core'
 import { FulfillmentEditDialog as SharedFulfillmentEditDialog } from '@spree/dashboard-ui'
-import { type Fulfillment, SpreeError } from '@spree/seller-sdk'
+import { type Fulfillment, isZeroMoney, SpreeError } from '@spree/seller-sdk'
 import { useState } from 'react'
 import { useTranslation } from 'react-i18next'
 import { useFulfillmentActions } from '../../hooks/use-fulfillments'
@@ -27,7 +28,8 @@ export function FulfillmentEditDialog({
   const { t } = useTranslation()
   const { update } = useFulfillmentActions(orderId)
   const { data: locationsData } = useStockLocations(open)
-  const { refetch: refetchOrder } = useOrder(orderId)
+  const { data: order, refetch: refetchOrder } = useOrder(orderId)
+  const locale = useMoneyLocale()
   const [errorMessage, setErrorMessage] = useState<string>()
 
   const originOptions = (locationsData?.data ?? []).map((location) => ({
@@ -38,7 +40,12 @@ export function FulfillmentEditDialog({
   const rateOptions = (fulfillment.delivery_rates ?? []).map((rate) => ({
     value: rate.id,
     label: `${rate.name} — ${
-      Number.parseFloat(rate.cost) === 0 ? t('orders.fulfillments.free') : rate.display_cost
+      rate.unpriced
+        ? t('orders.fulfillments.quoted_after_review')
+        : isZeroMoney(rate.cost)
+          ? t('orders.fulfillments.free')
+          : // A rate is quoted in its order's currency.
+            formatMoney(rate.cost, order?.currency ?? '', locale) || rate.cost
     }`,
   }))
 

package/src/components/orders/fulfillment-label-upload-dialog.tsx

@@ -9,6 +9,7 @@ import {
   mapSpreeErrorsToForm,
 } from '@spree/dashboard-core'
 import { LabelUploadDialog } from '@spree/dashboard-ui'
+import type { CurrencyCode } from '@spree/seller-sdk'
 import { useState } from 'react'
 import { useForm } from 'react-hook-form'
 import { useTranslation } from 'react-i18next'
@@ -25,7 +26,7 @@ export function FulfillmentLabelUploadDialog({
 }: {
   orderId: string
   fulfillmentId: string
-  currency: string
+  currency: CurrencyCode
   open: boolean
   onOpenChange: (open: boolean) => void
 }) {
@@ -59,7 +60,7 @@ export function FulfillmentLabelUploadDialog({
     try {
       await uploadLabel.mutateAsync({
         fulfillmentId,
-        file: file.signedId,
+        file_signed_id: file.signedId,
         tracking_number: values.tracking_number.trim(),
         carrier: values.carrier.trim() || undefined,
         cost: values.cost.trim() || undefined,

package/src/components/orders/order-cards.tsx

@@ -1,4 +1,10 @@
-import { AddressFormDialog, formatStoreDateTime } from '@spree/dashboard-core'
+import {
+  AddressFormDialog,
+  formatMoney,
+  formatStoreDateTime,
+  isPositiveMoney,
+  useMoneyLocale,
+} from '@spree/dashboard-core'
 import {
   AddressBlock,
   Button,
@@ -15,6 +21,7 @@ import {
 } from '@spree/dashboard-ui'
 import { EllipsisVerticalIcon, PencilIcon } from '@spree/dashboard-ui/icons'
 import type { Order, OrderAddressParams } from '@spree/seller-sdk'
+import { isZeroMoney } from '@spree/seller-sdk'
 import { type ReactNode, useState } from 'react'
 import { useTranslation } from 'react-i18next'
 import { sellerClient } from '../../api-client'
@@ -69,10 +76,11 @@ function formatDate(iso: string | null | undefined, timezone: string) {
  */
 export function OrderSummaryCard({ order }: { order: Order }) {
   const { t } = useTranslation()
+  const locale = useMoneyLocale()
+  const money = (amount: string | null) => formatMoney(amount, order.currency, locale)
   const timezone = useStoreTimezone()
 
-  const amount = (value: string | null | undefined) => Number.parseFloat(value ?? '0')
-  const outstanding = amount(order.amount_due)
+  const outstanding = isPositiveMoney(order.amount_due)
   const placed = Boolean(order.completed_at)
 
   return (
@@ -118,43 +126,43 @@ export function OrderSummaryCard({ order }: { order: Order }) {
 
         <Separator />
 
-        <SummaryRow label={t('orders.summary.subtotal')} value={order.display_item_total} />
+        <SummaryRow label={t('orders.summary.subtotal')} value={money(order.item_total)} />
 
-        {amount(order.delivery_total) > 0 && (
-          <SummaryRow label={t('orders.summary.shipping')} value={order.display_delivery_total} />
+        {isPositiveMoney(order.delivery_total) && (
+          <SummaryRow label={t('orders.summary.shipping')} value={money(order.delivery_total)} />
         )}
 
-        {amount(order.discount_total) !== 0 && (
-          <SummaryRow label={t('orders.summary.promotions')} value={order.display_discount_total} />
+        {!isZeroMoney(order.discount_total) && (
+          <SummaryRow label={t('orders.summary.promotions')} value={money(order.discount_total)} />
         )}
 
-        {amount(order.adjustment_total) !== 0 && (
+        {!isZeroMoney(order.adjustment_total) && (
           <SummaryRow
             label={t('orders.summary.adjustments')}
-            value={order.display_adjustment_total}
+            value={money(order.adjustment_total)}
           />
         )}
 
-        {amount(order.included_tax_total) > 0 && (
+        {isPositiveMoney(order.included_tax_total) && (
           <SummaryRow
             label={t('orders.summary.tax_included')}
-            value={order.display_included_tax_total}
+            value={money(order.included_tax_total)}
           />
         )}
 
         {/* Shown on a placed order even at zero, so "no tax was charged" reads
             as an answer rather than a missing row. */}
-        {(amount(order.additional_tax_total) > 0 ||
-          (placed && amount(order.included_tax_total) === 0)) && (
+        {(isPositiveMoney(order.additional_tax_total) ||
+          (placed && isZeroMoney(order.included_tax_total))) && (
           <SummaryRow
             label={t('orders.summary.tax_additional')}
-            value={order.display_additional_tax_total}
+            value={money(order.additional_tax_total)}
           />
         )}
 
         <Separator />
 
-        <SummaryRow label={t('orders.summary.total')} value={order.display_total} bold />
+        <SummaryRow label={t('orders.summary.total')} value={money(order.total)} bold />
 
         {/* What the marketplace charged the seller on this sale. Below the
             order total because it is not part of what the buyer paid — it is
@@ -178,19 +186,19 @@ export function OrderSummaryCard({ order }: { order: Order }) {
 
             <SummaryRow
               label={t('orders.summary.commission_fee')}
-              value={order.display_commission_amount_total}
+              value={money(order.commission_amount_total)}
             />
 
-            {amount(order.commission_tax_total) > 0 && (
+            {isPositiveMoney(order.commission_tax_total) && (
               <SummaryRow
                 label={t('orders.summary.commission_tax')}
-                value={order.display_commission_tax_total}
+                value={money(order.commission_tax_total)}
               />
             )}
 
             <SummaryRow
               label={t('orders.summary.commission_total')}
-              value={order.display_commission_total}
+              value={money(order.commission_total)}
               bold
             />
           </>
@@ -200,14 +208,14 @@ export function OrderSummaryCard({ order }: { order: Order }) {
 
         <SummaryRow
           label={t('orders.summary.payment_total')}
-          value={order.display_payment_total}
+          value={money(order.payment_total)}
           highlight
         />
         <SummaryRow
           label={t('orders.summary.outstanding_balance')}
-          value={order.display_amount_due}
+          value={money(order.amount_due)}
           highlight
-          danger={outstanding > 0}
+          danger={outstanding}
         />
       </div>
     </Card>

package/src/components/orders/order-earnings-card.tsx

@@ -1,4 +1,4 @@
-import { formatStoreDateTime } from '@spree/dashboard-core'
+import { formatStoreDateTime, Money } from '@spree/dashboard-core'
 import {
   Card,
   CardContent,
@@ -88,7 +88,9 @@ export function OrderEarningsCard({ order }: { order: Order }) {
                     </span>
                   )}
                 </TableCell>
-                <TableCell className="text-right tabular-nums">{transfer.display_amount}</TableCell>
+                <TableCell className="text-right tabular-nums">
+                  <Money amount={transfer.amount} currency={transfer.currency} />
+                </TableCell>
               </TableRow>
             ))}
           </TableBody>

package/src/components/orders/order-payment-card.tsx

@@ -1,3 +1,4 @@
+import { formatMoney, useMoneyLocale } from '@spree/dashboard-core'
 import {
   Card,
   CardAction,
@@ -31,7 +32,10 @@ import { ReadRow } from '../read-row'
  */
 export function OrderPaymentCard({ order }: { order: Order }) {
   const { t } = useTranslation()
+  const locale = useMoneyLocale()
   const splits = order.payment_splits ?? []
+  const money = (amount: string | null | undefined, currency = order.currency) =>
+    formatMoney(amount, currency, locale)
 
   return (
     <Card>
@@ -53,10 +57,8 @@ export function OrderPaymentCard({ order }: { order: Order }) {
       </CardHeader>
 
       <CardContent className="flex flex-col gap-3">
-        <ReadRow label={t('orders.summary.payment_total')}>{order.display_payment_total}</ReadRow>
-        <ReadRow label={t('orders.summary.outstanding_balance')}>
-          {order.display_amount_due}
-        </ReadRow>
+        <ReadRow label={t('orders.summary.payment_total')}>{money(order.payment_total)}</ReadRow>
+        <ReadRow label={t('orders.summary.outstanding_balance')}>{money(order.amount_due)}</ReadRow>
       </CardContent>
 
       {splits.length > 0 && (
@@ -77,11 +79,17 @@ export function OrderPaymentCard({ order }: { order: Order }) {
             <TableBody>
               {splits.map((split) => (
                 <TableRow key={split.id}>
-                  <TableCell className="tabular-nums">{split.display_authorized_amount}</TableCell>
-                  <TableCell className="tabular-nums">{split.display_captured_amount}</TableCell>
-                  <TableCell className="tabular-nums">{split.display_refunded_amount}</TableCell>
+                  <TableCell className="tabular-nums">
+                    {money(split.authorized_amount, split.currency)}
+                  </TableCell>
+                  <TableCell className="tabular-nums">
+                    {money(split.captured_amount, split.currency)}
+                  </TableCell>
+                  <TableCell className="tabular-nums">
+                    {money(split.refunded_amount, split.currency)}
+                  </TableCell>
                   <TableCell className="text-right tabular-nums">
-                    {split.display_refundable_amount}
+                    {money(split.refundable_amount, split.currency)}
                   </TableCell>
                 </TableRow>
               ))}

package/src/components/orders/post-sale-cards.tsx

@@ -1,4 +1,4 @@
-import { currencyParts } from '@spree/dashboard-core'
+import { currencyParts, formatMoney, isPositiveMoney, useMoneyLocale } from '@spree/dashboard-core'
 import {
   Button,
   Card,
@@ -23,6 +23,7 @@ import {
   ShieldAlertIcon,
 } from '@spree/dashboard-ui/icons'
 import type { Claim, Order } from '@spree/seller-sdk'
+import { sumMoney } from '@spree/seller-sdk'
 import i18n from 'i18next'
 import { useState } from 'react'
 import { useTranslation } from 'react-i18next'
@@ -47,6 +48,7 @@ const CLAIM_ACTIONABLE = ['open', 'approved']
  */
 export function ExchangesCard({ order }: { order: Order }) {
   const { t } = useTranslation()
+  const locale = useMoneyLocale()
   const confirm = useConfirm()
   const { data } = useOrderExchanges(order.id)
   const { approve, receive, fulfill, cancel } = useExchangeActions(order.id)
@@ -113,7 +115,7 @@ export function ExchangesCard({ order }: { order: Order }) {
                             // A dearer replacement leaves the customer owing the
                             // difference, which fulfilling puts on the order.
                             if (
-                              Number(exchange.price_difference) > 0 &&
+                              isPositiveMoney(exchange.price_difference) &&
                               !(await confirm({
                                 message: t('orders.post_sale.exchanges.balance_due_confirm'),
                                 confirmLabel: t('orders.post_sale.exchanges.fulfill'),
@@ -152,7 +154,7 @@ export function ExchangesCard({ order }: { order: Order }) {
               ))}
               <p className="text-muted-foreground text-sm">
                 {t('orders.post_sale.exchanges.price_difference', {
-                  amount: exchange.display_price_difference,
+                  amount: formatMoney(exchange.price_difference, order.currency, locale),
                 })}
               </p>
             </CardContent>
@@ -322,14 +324,9 @@ function ResolveClaimDialog({
   // A claim opened without per-item amounts has a refund_total of zero, and
   // the workflow refuses to refund nothing — offer what the customer paid for
   // the claimed items instead, which is also the ceiling it enforces.
-  const recorded = Number(claim.refund_total)
-  const paid = lines.reduce((sum, line) => sum + Number(line.paid_amount ?? 0), 0)
+  const paid = sumMoney(lines.map((line) => line.paid_amount))
   const defaultAmount =
-    Number.isFinite(recorded) && recorded > 0
-      ? claim.refund_total
-      : paid > 0
-        ? paid.toFixed(2)
-        : claim.refund_total
+    isPositiveMoney(claim.refund_total) || !isPositiveMoney(paid) ? claim.refund_total : paid
 
   return (
     <ClaimResolveDialog

package/src/components/orders/post-sale-create-dialogs.tsx

@@ -1,4 +1,4 @@
-import { currencyParts } from '@spree/dashboard-core'
+import { currencyParts, paidForUnits } from '@spree/dashboard-core'
 import {
   Field,
   FieldLabel,
@@ -137,8 +137,7 @@ export function CreateClaimDialog({
         id: item.id,
         label: unitLabel(item),
         quantity: item.quantity,
-        discountedAmount: item.discounted_amount,
-        additionalTaxTotal: item.additional_tax_total,
+        paidFor: (quantity: number) => paidForUnits(item, quantity, order.currency),
       }))}
       currencySymbol={currencySymbol}
       reasonField={<ClaimReasonField value={reasonId} onChange={setReasonId} />}

package/src/components/orders/returns-card.tsx

@@ -1,4 +1,11 @@
-import { currencyParts } from '@spree/dashboard-core'
+import {
+  currencyParts,
+  formatMoney,
+  isPositiveMoney,
+  returnOwesNothing,
+  returnRefundSummary,
+  useMoneyLocale,
+} from '@spree/dashboard-core'
 import {
   Badge,
   Button,
@@ -14,8 +21,6 @@ import {
   DropdownMenuTrigger,
   ReturnReceiveDialog,
   ReturnRefundDialog,
-  returnOwesNothing,
-  returnRefundSummary,
   StatusBadge,
   useConfirm,
 } from '@spree/dashboard-ui'
@@ -138,7 +143,7 @@ export function ReturnsCard({ order }: { order: Order }) {
                 {returnRecord.return_line_items?.map((line) => (
                   <ReturnLineRow key={line.id} line={line} />
                 ))}
-                <RefundSummary returnRecord={returnRecord} />
+                <RefundSummary returnRecord={returnRecord} currency={order.currency} />
               </CardContent>
             </Card>
           ))
@@ -165,9 +170,10 @@ export function ReturnsCard({ order }: { order: Order }) {
   )
 }
 
-function RefundSummary({ returnRecord }: { returnRecord: Return }) {
+function RefundSummary({ returnRecord, currency }: { returnRecord: Return; currency: string }) {
   const { t } = useTranslation()
-  const summary = returnRefundSummary(returnRecord)
+  const locale = useMoneyLocale()
+  const summary = returnRefundSummary(returnRecord, currency, locale)
 
   return (
     <p className="text-muted-foreground text-sm">
@@ -260,9 +266,10 @@ function RefundDialog({
   return (
     <ReturnRefundDialog
       refundableTotal={returnRecord.refundable_total}
+      owesNothing={returnOwesNothing(returnRecord.refundable_total)}
       refundTaxTotal={
-        Number(returnRecord.refund_tax_total) > 0
-          ? returnRecord.display_refund_tax_total
+        isPositiveMoney(returnRecord.refund_tax_total)
+          ? formatMoney(returnRecord.refund_tax_total, order.currency, i18n.language)
           : undefined
       }
       currencySymbol={currencySymbol}

package/src/components/orders/shipping-label-row.tsx

@@ -1,4 +1,10 @@
-import { downloadFromApi, getApiClient, useAuth } from '@spree/dashboard-core'
+import {
+  downloadFromApi,
+  formatMoney,
+  getApiClient,
+  useAuth,
+  useMoneyLocale,
+} from '@spree/dashboard-core'
 import {
   Badge,
   Button,
@@ -19,6 +25,7 @@ import {
 import type { ShippingLabel } from '@spree/seller-sdk'
 import { useTranslation } from 'react-i18next'
 import { useFulfillmentActions } from '../../hooks/use-fulfillments'
+import { useOrder } from '../../hooks/use-order'
 
 /**
  * The label bound to a parcel: what it cost and how to print it.
@@ -41,6 +48,11 @@ export function ShippingLabelRow({
   const { token } = useAuth()
   const confirm = useConfirm()
   const { deleteLabel } = useFulfillmentActions(orderId)
+  const locale = useMoneyLocale()
+  const { data: order } = useOrder(orderId)
+  // A label with no currency of its own was bought in the order's.
+  const labelCurrency = label.currency ?? order?.currency
+  const cost = labelCurrency ? formatMoney(label.cost, labelCurrency, locale) : ''
 
   const deletable = label.source === 'uploaded'
 
@@ -83,9 +95,9 @@ export function ShippingLabelRow({
         {label.source === 'uploaded' && (
           <Badge variant="secondary">{t('orders.fulfillments.label_uploaded')}</Badge>
         )}
-        {label.display_cost && (
+        {cost && (
           <span className="text-muted-foreground">
-            {t('orders.fulfillments.label_cost', { amount: label.display_cost })}
+            {t('orders.fulfillments.label_cost', { amount: cost })}
           </span>
         )}
       </div>

package/src/components/seller-returns-location-card.tsx

@@ -17,7 +17,7 @@ import {
   toastManager,
 } from '@spree/dashboard-ui'
 import { PencilIcon, PlusIcon } from '@spree/dashboard-ui/icons'
-import type { StockLocationParams } from '@spree/seller-sdk'
+import type { StockLocationUpdateParams } from '@spree/seller-sdk'
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
 import { useParams } from '@tanstack/react-router'
 import { useState } from 'react'
@@ -46,11 +46,11 @@ export function SellerReturnsLocationCard({ headless = false }: { headless?: boo
   // more locations than one page holds would otherwise see one address while
   // the server sent their returns to another, with nothing on screen saying
   // so — and they would edit the wrong one.
-  const activeParams = { active_true: true, limit: 1 }
+  const activeParams = { active_eq: true, limit: 1 }
   const { data: takesReturns, isError: returnsFailed } = useQuery({
     queryKey: ['seller', sellerId, 'stock-locations', 'returns'],
     queryFn: () =>
-      sellerClient().stockLocations.list({ ...activeParams, returns_enabled_true: true }),
+      sellerClient().stockLocations.list({ ...activeParams, returns_enabled_eq: true }),
   })
   const hasReturnsLocation = (takesReturns?.data.length ?? 0) > 0
   const { data: anyActive, isError: anyFailed } = useQuery({
@@ -67,7 +67,7 @@ export function SellerReturnsLocationCard({ headless = false }: { headless?: boo
   const title = t('profile.returns_address')
 
   const save = useMutation({
-    mutationFn: (params: StockLocationParams) => {
+    mutationFn: (params: StockLocationUpdateParams) => {
       if (!location) throw new Error(t('common.error'))
       return sellerClient().stockLocations.update(location.id, params)
     },

package/src/components/seller-tax-identifiers-card.tsx

@@ -37,7 +37,7 @@ export function SellerTaxIdentifiersCard() {
     onSuccess: refresh,
   })
   const remove = useMutation({
-    mutationFn: (id: string) => sellerClient().taxIdentifiers.remove(id),
+    mutationFn: (id: string) => sellerClient().taxIdentifiers.delete(id),
     onSuccess: refresh,
   })
   const validate = useMutation({

package/src/hooks/use-fulfillments.ts

@@ -1,5 +1,6 @@
 import { useResourceKeyBuilder } from '@spree/dashboard-core'
 import { toastManager } from '@spree/dashboard-ui'
+import type { CurrencyCode } from '@spree/seller-sdk'
 import { useMutation, useQueryClient } from '@tanstack/react-query'
 import { sellerClient } from '../api-client'
 
@@ -125,14 +126,14 @@ export function useFulfillmentActions(orderId: string) {
       ...params
     }: {
       fulfillmentId: string
-      file: string
+      file_signed_id: string
       // Required: a label with no tracking number is refused server-side,
       // since nothing could then follow the parcel it prints.
       tracking_number: string
       carrier?: string
       service?: string
       cost?: string
-      currency?: string
+      currency?: CurrencyCode
     }) => sellerClient().orders.fulfillments.labels.create(orderId, fulfillmentId, params),
   )
 

package/src/hooks/use-store-timezone.ts

@@ -22,5 +22,5 @@ export function useStoreTimezone(): string {
     enabled: Boolean(sellerId),
   })
 
-  return profile?.preferred_timezone ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? 'UTC'
+  return profile?.timezone ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? 'UTC'
 }

package/src/locales/ar.json

@@ -474,6 +474,7 @@
       "packing_slip_title": "قائمة التعبئة — الطلب {{number}}",
       "print_label": "طباعة الملصق",
       "print_packing_slip": "طباعة قائمة التعبئة",
+      "quoted_after_review": "يُسعَّر بعد المراجعة",
       "ship_to": "الشحن إلى",
       "ships_from_label": "يُشحن من",
       "split": "تقسيم",

package/src/locales/de.json

@@ -470,6 +470,7 @@
       "packing_slip_title": "Lieferschein — Bestellung {{number}}",
       "print_label": "Etikett drucken",
       "print_packing_slip": "Lieferschein drucken",
+      "quoted_after_review": "Preis nach Prüfung",
       "ship_to": "Lieferung an",
       "ships_from_label": "Versand ab",
       "split": "Teilen",

package/src/locales/en.json

@@ -470,6 +470,7 @@
       "packing_slip_title": "Packing slip — order {{number}}",
       "print_label": "Print label",
       "print_packing_slip": "Print packing slip",
+      "quoted_after_review": "Quoted after review",
       "ship_to": "Ship to",
       "ships_from_label": "Ships from",
       "split": "Split",

package/src/locales/fr.json

@@ -470,6 +470,7 @@
       "packing_slip_title": "Bon de livraison — commande {{number}}",
       "print_label": "Imprimer l’étiquette",
       "print_packing_slip": "Imprimer le bon de livraison",
+      "quoted_after_review": "Prix après vérification",
       "ship_to": "Livrer à",
       "ships_from_label": "Expédié depuis",
       "split": "Scinder",

package/src/locales/pl.json

@@ -472,6 +472,7 @@
       "packing_slip_title": "List przewozowy — zamówienie {{number}}",
       "print_label": "Drukuj etykietę",
       "print_packing_slip": "Drukuj list przewozowy",
+      "quoted_after_review": "Wycena po weryfikacji",
       "ship_to": "Wysyłka do",
       "ships_from_label": "Wysyłka z",
       "split": "Podziel",

package/src/locales/zh-CN.json

@@ -469,6 +469,7 @@
       "packing_slip_title": "装箱单 — 订单 {{number}}",
       "print_label": "打印面单",
       "print_packing_slip": "打印装箱单",
+      "quoted_after_review": "审核后报价",
       "ship_to": "收货地址",
       "ships_from_label": "发货地",
       "split": "拆分",

package/src/pages/delivery-methods.tsx

@@ -1,5 +1,6 @@
 import {
   defaultPreferences,
+  filterPreferenceSchema,
   PageHeader,
   PreferencesForm,
   type ResourceSearch,
@@ -37,7 +38,7 @@ import {
   useRowClickBridge,
 } from '@spree/dashboard-ui'
 import { PlusIcon, TrashIcon } from '@spree/dashboard-ui/icons'
-import type { DeliveryMethod, DeliveryPreferenceField } from '@spree/seller-sdk'
+import type { DeliveryMethod, PreferenceSchema } from '@spree/seller-sdk'
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
 import { useParams } from '@tanstack/react-router'
 import { useEffect, useState } from 'react'
@@ -166,8 +167,7 @@ interface DeliveryMethodFormValues {
   storefront_visible: boolean
   delivery_profile_id: string
   delivery_zone_id: string
-  calculator_type: string
-  calculator_preferences: Record<string, unknown>
+  calculator: { type: string; preferences: Record<string, unknown> }
   rules: RuleDraft[]
 }
 
@@ -177,8 +177,7 @@ const DEFAULTS: DeliveryMethodFormValues = {
   storefront_visible: true,
   delivery_profile_id: '',
   delivery_zone_id: '',
-  calculator_type: '',
-  calculator_preferences: {},
+  calculator: { type: '', preferences: {} },
   rules: [],
 }
 
@@ -231,7 +230,7 @@ function DeliveryMethodSheet({
 
   const form = useForm<DeliveryMethodFormValues>({ defaultValues: DEFAULTS })
   const profileId = form.watch('delivery_profile_id')
-  const calculatorType = form.watch('calculator_type')
+  const calculatorType = form.watch('calculator.type')
   const rules = form.watch('rules')
 
   // A zone only means something under its profile, so the picker follows
@@ -252,8 +251,10 @@ function DeliveryMethodSheet({
       storefront_visible: method.storefront_visible,
       delivery_profile_id: method.delivery_profile_id ?? '',
       delivery_zone_id: method.delivery_zone_id ?? '',
-      calculator_type: method.calculator_type ?? '',
-      calculator_preferences: method.calculator_preferences ?? {},
+      calculator: {
+        type: method.calculator?.type ?? '',
+        preferences: method.calculator?.preferences ?? {},
+      },
       rules: (method.rules ?? []).map((rule) => ({
         id: rule.id,
         type: rule.type,
@@ -274,19 +275,18 @@ function DeliveryMethodSheet({
   // the picker blank would show an empty Pricing box while the server
   // quietly created the method free.
   useEffect(() => {
-    if (methodId || form.getValues('calculator_type')) return
+    if (methodId || form.getValues('calculator.type')) return
     const flatRate = calculators?.data.find((calculator) => calculator.type === 'flat_rate')
     if (!flatRate) return
 
-    form.setValue('calculator_type', flatRate.type)
-    form.setValue(
-      'calculator_preferences',
-      defaultPreferences(renderableSchema(flatRate.preference_schema)),
-    )
+    form.setValue('calculator', {
+      type: flatRate.type,
+      preferences: defaultPreferences(renderableSchema(flatRate.schema)),
+    })
   }, [calculators, methodId, form])
 
   const calculatorSchema = renderableSchema(
-    calculators?.data.find((calculator) => calculator.type === calculatorType)?.preference_schema,
+    calculators?.data.find((calculator) => calculator.type === calculatorType)?.schema,
   )
 
   const save = useMutation({
@@ -297,8 +297,10 @@ function DeliveryMethodSheet({
         storefront_visible: values.storefront_visible,
         delivery_profile_id: values.delivery_profile_id || undefined,
         delivery_zone_id: values.delivery_zone_id || null,
-        ...(values.calculator_type ? { calculator_type: values.calculator_type } : {}),
-        calculator_preferences: values.calculator_preferences,
+        calculator: {
+          ...(values.calculator.type ? { type: values.calculator.type } : {}),
+          preferences: values.calculator.preferences,
+        },
         // The array replaces the whole set: a rule dropped here is deleted,
         // which is why every surviving row is re-sent with its id.
         rules: values.rules.map((rule) => ({
@@ -329,9 +331,7 @@ function DeliveryMethodSheet({
   const { errors } = form.formState
 
   function addRule(type: string) {
-    const schema = renderableSchema(
-      ruleTypes?.data.find((rule) => rule.type === type)?.preference_schema,
-    )
+    const schema = renderableSchema(ruleTypes?.data.find((rule) => rule.type === type)?.schema)
     form.setValue('rules', [...rules, { type, preferences: defaultPreferences(schema) }])
   }
 
@@ -482,7 +482,7 @@ function DeliveryMethodSheet({
                   </FieldLabel>
                   <Controller
                     control={form.control}
-                    name="calculator_type"
+                    name="calculator.type"
                     render={({ field }) => (
                       <Select
                         value={field.value}
@@ -490,9 +490,9 @@ function DeliveryMethodSheet({
                           field.onChange(next)
                           const schema = renderableSchema(
                             calculators?.data.find((calculator) => calculator.type === next)
-                              ?.preference_schema,
+                              ?.schema,
                           )
-                          form.setValue('calculator_preferences', defaultPreferences(schema))
+                          form.setValue('calculator.preferences', defaultPreferences(schema))
                         }}
                       >
                         <SelectTrigger id="delivery-method-calculator">
@@ -521,7 +521,7 @@ function DeliveryMethodSheet({
 
                 <Controller
                   control={form.control}
-                  name="calculator_preferences"
+                  name="calculator.preferences"
                   render={({ field }) => (
                     <PreferencesForm
                       schema={calculatorSchema}
@@ -582,7 +582,7 @@ function DeliveryMethodSheet({
                       </div>
 
                       <PreferencesForm
-                        schema={renderableSchema(definition?.preference_schema)}
+                        schema={renderableSchema(definition?.schema)}
                         currencyOptions={currencyOptions}
                         values={rule.preferences}
                         onChange={(next) =>
@@ -632,16 +632,19 @@ function DeliveryMethodSheet({
 }
 
 /**
- * The fields of a preference schema the shared form can render.
+ * The part of a preference schema the shared form can render.
  *
- * Drops `hash`-typed preferences — today the flat-rate calculator's
+ * Drops keyed maps — today the flat-rate calculator's
  * per-currency `amounts` map, which the operator edits through a dedicated
  * multi-currency control and the generic form would show as the hash itself
  * in a text box. A seller quotes in the store's currency, so `amount` and
  * `currency` are the whole question.
  */
-function renderableSchema(
-  schema: DeliveryPreferenceField[] | undefined,
-): DeliveryPreferenceField[] {
-  return (schema ?? []).filter((field) => field.type !== 'hash')
+function renderableSchema(schema: PreferenceSchema | undefined): PreferenceSchema | undefined {
+  if (!schema) return undefined
+
+  return filterPreferenceSchema(
+    schema,
+    (_key, property) => typeof property.additionalProperties !== 'object',
+  )
 }

package/src/pages/onboarding.tsx

@@ -244,7 +244,7 @@ function RequirementAction({ requirement }: { requirement: RequirementStatus })
     mutationFn: () =>
       sellerClient().requirementSubmissions.create(requirement.id, {
         note: note || undefined,
-        file: file.signedId || undefined,
+        file_signed_id: file.signedId || undefined,
       }),
     onSuccess: () => {
       setNote('')
@@ -349,6 +349,7 @@ function RequirementAction({ requirement }: { requirement: RequirementStatus })
               value={file}
               onChange={setFile}
               accept={requirement.accepted_content_types?.join(',')}
+              private
               label={t('onboarding.document_label')}
               help={t('onboarding.document_help')}
             />

package/src/pages/payout.tsx

@@ -1,4 +1,11 @@
-import { formatStoreDateTime, PageHeader, Slot } from '@spree/dashboard-core'
+import {
+  formatMoney,
+  formatStoreDateTime,
+  Money,
+  PageHeader,
+  Slot,
+  useMoneyLocale,
+} from '@spree/dashboard-core'
 import {
   Card,
   CardHeader,
@@ -32,6 +39,7 @@ import { useStoreTimezone } from '../hooks/use-store-timezone'
  */
 export function PayoutPage() {
   const { t } = useTranslation()
+  const locale = useMoneyLocale()
   const { sellerId, payoutId } = useParams({ from: '/_authenticated/$sellerId/payouts/$payoutId' })
 
   const timezone = useStoreTimezone()
@@ -54,7 +62,7 @@ export function PayoutPage() {
     <ResourceLayout
       header={
         <PageHeader
-          title={payout.display_amount}
+          title={formatMoney(payout.amount, payout.currency, locale)}
           subtitle={formatStoreDateTime(payout.created_at, timezone)}
           backTo="payouts"
           badges={
@@ -121,7 +129,7 @@ export function PayoutPage() {
                       {t(`earnings.kinds.${transfer.kind}`, { defaultValue: transfer.kind })}
                     </TableCell>
                     <TableCell className="text-right tabular-nums">
-                      {transfer.display_amount}
+                      <Money amount={transfer.amount} currency={transfer.currency} />
                     </TableCell>
                   </TableRow>
                 ))}
@@ -140,7 +148,9 @@ export function PayoutPage() {
               <CardTitle>{t('payouts.detail.settlement')}</CardTitle>
             </CardHeader>
             <div className="flex flex-col gap-3 px-6 pb-6">
-              <ReadRow label={t('payouts.columns.amount')}>{payout.display_amount}</ReadRow>
+              <ReadRow label={t('payouts.columns.amount')}>
+                <Money amount={payout.amount} currency={payout.currency} />
+              </ReadRow>
               <ReadRow label={t('payouts.columns.reference')}>{payout.reference}</ReadRow>
               <ReadRow label={t('payouts.detail.period')}>
                 {payout.period_start && payout.period_end

package/src/pages/product.tsx

@@ -19,7 +19,7 @@ import {
   variantToWirePayload,
 } from '@spree/dashboard-core'
 import { FormActions, ResourceLayout, StatusBadge, toastManager } from '@spree/dashboard-ui'
-import type { ProductParams } from '@spree/seller-sdk'
+import type { ProductCreateParams } from '@spree/seller-sdk'
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
 import { useNavigate, useParams } from '@tanstack/react-router'
 import { useEffect } from 'react'
@@ -119,7 +119,7 @@ export function ProductPage({ mode }: { mode: 'new' | 'edit' }) {
       values: ProductFormValues
       extensionValues: Record<string, unknown>
     }) => {
-      const payload: ProductParams = {
+      const payload: ProductCreateParams = {
         ...extensionValues,
         name: values.name,
         description: values.description,
@@ -150,7 +150,7 @@ export function ProductPage({ mode }: { mode: 'new' | 'edit' }) {
         })),
         variants: (values.variants ?? []).map((variant, index) =>
           variantToWirePayload(variant, index),
-        ) as ProductParams['variants'],
+        ) as ProductCreateParams['variants'],
       }
 
       return productId

package/src/pages/team.tsx

@@ -175,7 +175,7 @@ function MemberRow({ member, lastOne }: { member: TeamMember; lastOne: boolean }
   const confirm = useConfirm()
 
   const remove = useMutation({
-    mutationFn: (id: string) => sellerClient().team.remove(id),
+    mutationFn: (id: string) => sellerClient().team.delete(id),
     onSuccess: () => {
       toastManager.add({ type: 'success', title: t('team.messages.removed') })
       void queryClient.invalidateQueries({ queryKey: ['seller', sellerId, 'team'] })
@@ -302,7 +302,7 @@ function InvitationRow({ invitation }: { invitation: Invitation }) {
   })
 
   const revoke = useMutation({
-    mutationFn: (id: string) => sellerClient().invitations.revoke(id),
+    mutationFn: (id: string) => sellerClient().invitations.delete(id),
     onSuccess: () => {
       toastManager.add({ type: 'success', title: t('team.messages.revoked') })
       void invalidate()

package/src/tables/delivery-methods.tsx

@@ -6,7 +6,7 @@ import i18n from 'i18next'
 
 defineTable<DeliveryMethod>('seller-delivery-methods', {
   title: i18n.t('delivery_methods.title'),
-  searchParam: 'name_cont',
+  searchParam: 'search',
   searchPlaceholder: i18n.t('delivery_methods.search_placeholder'),
   defaultSort: { field: 'name', direction: 'asc' },
   emptyIcon: <TruckIcon className="size-8 text-muted-foreground" />,

package/src/tables/orders.tsx

@@ -1,4 +1,4 @@
-import { defineTable, formatStoreDateTime } from '@spree/dashboard-core'
+import { defineTable, formatMoney, formatStoreDateTime } from '@spree/dashboard-core'
 import { ResourceNameCell, StatusBadge } from '@spree/dashboard-ui'
 import { PackageIcon } from '@spree/dashboard-ui/icons'
 import type { Order } from '@spree/seller-sdk'
@@ -110,7 +110,7 @@ defineTable<Order>('seller-orders', {
       key: 'total',
       label: i18n.t('orders.columns.total'),
       default: true,
-      render: (order) => order.display_total as string,
+      render: (order) => formatMoney(order.total, order.currency, i18n.language),
     },
   ],
 })

package/src/tables/payouts.tsx

@@ -1,4 +1,4 @@
-import { defineTable, formatStoreDateTime } from '@spree/dashboard-core'
+import { defineTable, formatMoney, formatStoreDateTime } from '@spree/dashboard-core'
 import { ResourceNameCell, StatusBadge } from '@spree/dashboard-ui'
 import { HandCoinsIcon } from '@spree/dashboard-ui/icons'
 import type { Payout } from '@spree/seller-sdk'
@@ -22,7 +22,7 @@ const STATUSES = ['pending', 'processing', 'completed', 'failed', 'unresolved']
 
 defineTable<Payout>('seller-payouts', {
   title: i18n.t('payouts.title'),
-  searchParam: 'reference_cont',
+  searchParam: 'search',
   searchPlaceholder: i18n.t('payouts.search_placeholder'),
   defaultSort: { field: 'created_at', direction: 'desc' },
   emptyIcon: <HandCoinsIcon className="size-8 text-muted-foreground" />,
@@ -81,7 +81,7 @@ defineTable<Payout>('seller-payouts', {
       sortable: true,
       default: true,
       className: 'text-right tabular-nums',
-      render: (payout) => payout.display_amount,
+      render: (payout) => formatMoney(payout.amount, payout.currency, i18n.language),
     },
   ],
 })

package/src/tables/policies.tsx

@@ -6,7 +6,7 @@ import i18n from 'i18next'
 
 defineTable<Policy>('seller-policies', {
   title: i18n.t('policies.title'),
-  searchParam: 'name_cont',
+  searchParam: 'search',
   searchPlaceholder: i18n.t('policies.search_placeholder'),
   defaultSort: { field: 'name', direction: 'asc' },
   emptyIcon: <ScrollTextIcon className="size-8 text-muted-foreground" />,

package/src/tables/products.tsx

@@ -1,4 +1,4 @@
-import { defineTable } from '@spree/dashboard-core'
+import { defineTable, formatPrice } from '@spree/dashboard-core'
 import { ResourceNameCell, StatusBadge, Thumbnail } from '@spree/dashboard-ui'
 import { PackageIcon } from '@spree/dashboard-ui/icons'
 import type { Product } from '@spree/seller-sdk'
@@ -9,7 +9,7 @@ const PRODUCT_STATUSES = ['active', 'draft', 'proposed', 'rejected', 'archived']
 
 defineTable<Product>('seller-products', {
   title: i18n.t('products.title'),
-  searchParam: 'name_cont',
+  searchParam: 'search',
   searchPlaceholder: i18n.t('products.search_placeholder'),
   defaultSort: { field: 'created_at', direction: 'desc' },
   emptyIcon: <PackageIcon className="size-8 text-muted-foreground" />,
@@ -50,7 +50,7 @@ defineTable<Product>('seller-products', {
       key: 'price',
       label: i18n.t('products.columns.price'),
       default: true,
-      render: (product) => product.price?.display_amount ?? '—',
+      render: (product) => formatPrice(product.price ?? null),
     },
   ],
 })

package/src/tables/transfers.tsx

@@ -1,4 +1,4 @@
-import { defineTable, formatStoreDateTime, useTenantId } from '@spree/dashboard-core'
+import { defineTable, formatMoney, formatStoreDateTime, useTenantId } from '@spree/dashboard-core'
 import { StatusBadge } from '@spree/dashboard-ui'
 import { BanknoteIcon } from '@spree/dashboard-ui/icons'
 import type { Transfer } from '@spree/seller-sdk'
@@ -51,7 +51,7 @@ defineTable<Transfer>('seller-transfers', {
   // Without this the toolbar sends `name_cont`, which the ledger does not
   // whitelist — Ransack drops an unknown condition, so the box would look
   // like it worked and return everything.
-  searchParam: 'reference_cont',
+  searchParam: 'search',
   searchPlaceholder: i18n.t('earnings.search_placeholder'),
   defaultSort: { field: 'created_at', direction: 'desc' },
   emptyIcon: <BanknoteIcon className="size-8 text-muted-foreground" />,
@@ -112,7 +112,7 @@ defineTable<Transfer>('seller-transfers', {
       sortable: true,
       default: true,
       className: 'text-right tabular-nums',
-      render: (transfer) => transfer.display_amount,
+      render: (transfer) => formatMoney(transfer.amount, transfer.currency, i18n.language),
     },
   ],
 })