feat(core-flows,order,medusa): exchange endpoints (#8396)

packages/core/core-flows/src/order/workflows/claim/confirm-claim-request.ts

@@ -57,6 +57,7 @@ function prepareFulfillmentData({
   items,
   shippingOption,
   deliveryAddress,
+  isReturn,
 }: {
   order: OrderDTO
   items: any[]
@@ -73,16 +74,17 @@ function prepareFulfillmentData({
     }
   }
   deliveryAddress?: Record<string, any>
+  isReturn?: boolean
 }) {
   const orderItemsMap = new Map<string, Required<OrderDTO>["items"][0]>(
     order.items!.map((i) => [i.id, i])
   )
   const fulfillmentItems = items.map((i) => {
-    const orderItem = orderItemsMap.get(i.item_id)!
+    const orderItem = orderItemsMap.get(i.item_id) ?? i.item
     return {
       line_item_id: i.item_id,
-      quantity: i.quantity,
-      return_quantity: i.quantity,
+      quantity: !isReturn ? i.quantity : undefined,
+      return_quantity: isReturn ? i.quantity : undefined,
       title: orderItem.variant_title ?? orderItem.title,
       sku: orderItem.variant_sku || "",
       barcode: orderItem.variant_barcode || "",
@@ -270,11 +272,12 @@ export const confirmClaimRequestWorkflow = createWorkflow(
           "id",
           "version",
           "canceled_at",
-          "additional_items.id",
-          "additional_items.title",
-          "additional_items.variant_title",
-          "additional_items.variant_sku",
-          "additional_items.variant_barcode",
+          "additional_items.item_id",
+          "additional_items.quantity",
+          "additional_items.item.title",
+          "additional_items.item.variant_title",
+          "additional_items.item.variant_sku",
+          "additional_items.item.variant_barcode",
         ],
         variables: { id: claimId },
         list: false,
@@ -345,6 +348,7 @@ export const confirmClaimRequestWorkflow = createWorkflow(
           order,
           items: order.items!,
           shippingOption: returnShippingOption,
+          isReturn: true,
         },
         prepareFulfillmentData
       )

packages/core/core-flows/src/order/workflows/claim/remove-claim-add-item-action.ts

@@ -0,0 +1,97 @@
+import {
+  OrderChangeActionDTO,
+  OrderChangeDTO,
+  OrderClaimDTO,
+  OrderDTO,
+  OrderWorkflow,
+} from "@medusajs/types"
+import { ChangeActionType, OrderChangeStatus } from "@medusajs/utils"
+import {
+  WorkflowData,
+  WorkflowResponse,
+  createStep,
+  createWorkflow,
+} from "@medusajs/workflows-sdk"
+import { useRemoteQueryStep } from "../../../common"
+import {
+  deleteOrderChangeActionsStep,
+  previewOrderChangeStep,
+} from "../../steps"
+import {
+  throwIfIsCancelled,
+  throwIfOrderChangeIsNotActive,
+} from "../../utils/order-validation"
+
+const validationStep = createStep(
+  "remove-item-claim-add-action-validation",
+  async function ({
+    order,
+    orderChange,
+    orderClaim,
+    input,
+  }: {
+    order: OrderDTO
+    orderClaim: OrderClaimDTO
+    orderChange: OrderChangeDTO
+    input: OrderWorkflow.DeleteOrderClaimItemActionWorkflowInput
+  }) {
+    throwIfIsCancelled(order, "Order")
+    throwIfIsCancelled(orderClaim, "Claim")
+    throwIfOrderChangeIsNotActive({ orderChange })
+
+    const associatedAction = (orderChange.actions ?? []).find(
+      (a) => a.id === input.action_id
+    ) as OrderChangeActionDTO
+
+    if (!associatedAction) {
+      throw new Error(
+        `No item claim found for claim ${input.claim_id} in order change ${orderChange.id}`
+      )
+    } else if (associatedAction.action !== ChangeActionType.ITEM_ADD) {
+      throw new Error(`Action ${associatedAction.id} is not adding an item`)
+    }
+  }
+)
+
+export const removeAddItemClaimActionWorkflowId = "remove-item-claim-add-action"
+export const removeAddItemClaimActionWorkflow = createWorkflow(
+  removeAddItemClaimActionWorkflowId,
+  function (
+    input: WorkflowData<OrderWorkflow.DeleteOrderClaimItemActionWorkflowInput>
+  ): WorkflowResponse<OrderDTO> {
+    const orderClaim: OrderClaimDTO = useRemoteQueryStep({
+      entry_point: "order_claim",
+      fields: ["id", "status", "order_id", "canceled_at"],
+      variables: { id: input.claim_id },
+      list: false,
+      throw_if_key_not_found: true,
+    })
+
+    const order: OrderDTO = useRemoteQueryStep({
+      entry_point: "orders",
+      fields: ["id", "status", "canceled_at", "items.*"],
+      variables: { id: orderClaim.order_id },
+      list: false,
+      throw_if_key_not_found: true,
+    }).config({ name: "order-query" })
+
+    const orderChange: OrderChangeDTO = useRemoteQueryStep({
+      entry_point: "order_change",
+      fields: ["id", "status", "version", "actions.*"],
+      variables: {
+        filters: {
+          order_id: orderClaim.order_id,
+          claim_id: orderClaim.id,
+          status: [OrderChangeStatus.PENDING, OrderChangeStatus.REQUESTED],
+        },
+      },
+      list: false,
+    }).config({ name: "order-change-query" })
+
+    validationStep({ order, input, orderClaim, orderChange })
+
+    deleteOrderChangeActionsStep({ ids: [input.action_id] })
+
+    return new WorkflowResponse(previewOrderChangeStep(order.id))
+  }
+)

packages/core/core-flows/src/order/workflows/exchange/confirm-exchange-request.ts

@@ -52,6 +52,7 @@ function prepareFulfillmentData({
   items,
   shippingOption,
   deliveryAddress,
+  isReturn,
 }: {
   order: OrderDTO
   items: any[]
@@ -68,16 +69,17 @@ function prepareFulfillmentData({
     }
   }
   deliveryAddress?: Record<string, any>
+  isReturn?: boolean
 }) {
   const orderItemsMap = new Map<string, Required<OrderDTO>["items"][0]>(
     order.items!.map((i) => [i.id, i])
   )
   const fulfillmentItems = items.map((i) => {
-    const orderItem = orderItemsMap.get(i.item_id)!
+    const orderItem = orderItemsMap.get(i.item_id) ?? i.item
     return {
       line_item_id: i.item_id,
-      quantity: i.quantity,
-      return_quantity: i.quantity,
+      quantity: !isReturn ? i.quantity : undefined,
+      return_quantity: isReturn ? i.quantity : undefined,
       title: orderItem.variant_title ?? orderItem.title,
       sku: orderItem.variant_sku || "",
       barcode: orderItem.variant_barcode || "",
@@ -257,11 +259,12 @@ export const confirmExchangeRequestWorkflow = createWorkflow(
           "id",
           "version",
           "canceled_at",
-          "additional_items.id",
-          "additional_items.title",
-          "additional_items.variant_title",
-          "additional_items.variant_sku",
-          "additional_items.variant_barcode",
+          "additional_items.item_id",
+          "additional_items.quantity",
+          "additional_items.item.title",
+          "additional_items.item.variant_title",
+          "additional_items.item.variant_sku",
+          "additional_items.item.variant_barcode",
         ],
         variables: { id: exchangeId },
         list: false,
@@ -332,6 +335,7 @@ export const confirmExchangeRequestWorkflow = createWorkflow(
           order,
           items: order.items!,
           shippingOption: returnShippingOption,
+          isReturn: true,
         },
         prepareFulfillmentData
       )

packages/core/core-flows/src/order/workflows/exchange/remove-exchange-item-action.ts

@@ -0,0 +1,97 @@
+import {
+  OrderChangeActionDTO,
+  OrderChangeDTO,
+  OrderDTO,
+  OrderExchangeDTO,
+  OrderWorkflow,
+} from "@medusajs/types"
+import { ChangeActionType, OrderChangeStatus } from "@medusajs/utils"
+import {
+  WorkflowData,
+  WorkflowResponse,
+  createStep,
+  createWorkflow,
+} from "@medusajs/workflows-sdk"
+import { useRemoteQueryStep } from "../../../common"
+import {
+  deleteOrderChangeActionsStep,
+  previewOrderChangeStep,
+} from "../../steps"
+import {
+  throwIfIsCancelled,
+  throwIfOrderChangeIsNotActive,
+} from "../../utils/order-validation"
+
+const validationStep = createStep(
+  "remove-item-exchange-action-validation",
+  async function ({
+    order,
+    orderChange,
+    orderExchange,
+    input,
+  }: {
+    order: OrderDTO
+    orderExchange: OrderExchangeDTO
+    orderChange: OrderChangeDTO
+    input: OrderWorkflow.DeleteOrderExchangeItemActionWorkflowInput
+  }) {
+    throwIfIsCancelled(order, "Order")
+    throwIfIsCancelled(orderExchange, "Exchange")
+    throwIfOrderChangeIsNotActive({ orderChange })
+
+    const associatedAction = (orderChange.actions ?? []).find(
+      (a) => a.id === input.action_id
+    ) as OrderChangeActionDTO
+
+    if (!associatedAction) {
+      throw new Error(
+        `No item exchange found for exchange ${input.exchange_id} in order change ${orderChange.id}`
+      )
+    } else if (associatedAction.action !== ChangeActionType.ITEM_ADD) {
+      throw new Error(`Action ${associatedAction.id} is not adding an item`)
+    }
+  }
+)
+
+export const removeItemExchangeActionWorkflowId = "remove-item-exchange-action"
+export const removeItemExchangeActionWorkflow = createWorkflow(
+  removeItemExchangeActionWorkflowId,
+  function (
+    input: WorkflowData<OrderWorkflow.DeleteOrderExchangeItemActionWorkflowInput>
+  ): WorkflowResponse<OrderDTO> {
+    const orderExchange: OrderExchangeDTO = useRemoteQueryStep({
+      entry_point: "order_exchange",
+      fields: ["id", "status", "order_id", "canceled_at"],
+      variables: { id: input.exchange_id },
+      list: false,
+      throw_if_key_not_found: true,
+    })
+
+    const order: OrderDTO = useRemoteQueryStep({
+      entry_point: "orders",
+      fields: ["id", "status", "canceled_at", "items.*"],
+      variables: { id: orderExchange.order_id },
+      list: false,
+      throw_if_key_not_found: true,
+    }).config({ name: "order-query" })
+
+    const orderChange: OrderChangeDTO = useRemoteQueryStep({
+      entry_point: "order_change",
+      fields: ["id", "status", "version", "actions.*"],
+      variables: {
+        filters: {
+          order_id: orderExchange.order_id,
+          exchange_id: orderExchange.id,
+          status: [OrderChangeStatus.PENDING, OrderChangeStatus.REQUESTED],
+        },
+      },
+      list: false,
+    }).config({ name: "order-change-query" })
+
+    validationStep({ order, input, orderExchange, orderChange })
+
+    deleteOrderChangeActionsStep({ ids: [input.action_id] })
+
+    return new WorkflowResponse(previewOrderChangeStep(order.id))
+  }
+)

packages/core/core-flows/src/order/workflows/index.ts

@@ -11,6 +11,7 @@ export * from "./claim/claim-item"
 export * from "./claim/claim-request-item-return"
 export * from "./claim/confirm-claim-request"
 export * from "./claim/create-claim-shipping-method"
+export * from "./claim/remove-claim-add-item-action"
 export * from "./claim/remove-claim-item-action"
 export * from "./claim/remove-claim-shipping-method"
 export * from "./claim/update-claim-add-item"
@@ -32,6 +33,7 @@ export * from "./exchange/confirm-exchange-request"
 export * from "./exchange/create-exchange-shipping-method"
 export * from "./exchange/exchange-add-new-item"
 export * from "./exchange/exchange-request-item-return"
+export * from "./exchange/remove-exchange-item-action"
 export * from "./exchange/remove-exchange-shipping-method"
 export * from "./exchange/update-exchange-add-item"
 export * from "./exchange/update-exchange-shipping-method"

packages/medusa/src/api/admin/claims/[id]/outbound/items/[action_id]/route.ts

@@ -1,5 +1,5 @@
 import {
-  removeItemClaimActionWorkflow,
+  removeAddItemClaimActionWorkflow,
   updateClaimAddItemWorkflow,
 } from "@medusajs/core-flows"
 import {
@@ -55,7 +55,7 @@ export const DELETE = async (
 
   const { id, action_id } = req.params
 
-  const { result: orderPreview } = await removeItemClaimActionWorkflow(
+  const { result: orderPreview } = await removeAddItemClaimActionWorkflow(
     req.scope
   ).run({
     input: {

packages/medusa/src/api/admin/claims/query-config.ts

@@ -4,7 +4,6 @@ export const defaultAdminClaimFields = [
   "order_id",
   "return_id",
   "display_id",
-  "location_id",
   "order_version",
   "refund_amount",
   "created_at",

packages/medusa/src/api/admin/claims/validators.ts

@@ -143,6 +143,17 @@ export type AdminPostClaimsRequestReturnItemsReqSchemaType = z.infer<
   typeof AdminPostClaimsRequestReturnItemsReqSchema
 >
 
+export const AdminPostClaimsRequestItemsReturnActionReqSchema = z.object({
+  quantity: z.number().optional(),
+  internal_note: z.string().nullish().optional(),
+  reason_id: z.string().nullish().optional(),
+  metadata: z.record(z.unknown()).nullish().optional(),
+})
+
+export type AdminPostClaimsRequestItemsReturnActionReqSchemaType = z.infer<
+  typeof AdminPostClaimsRequestItemsReturnActionReqSchema
+>
+
 export const AdminPostClaimItemsReqSchema = z.object({
   items: z.array(
     z.object({

packages/medusa/src/api/admin/exchanges/[id]/cancel/route.ts

@@ -0,0 +1,23 @@
+import { cancelOrderExchangeWorkflow } from "@medusajs/core-flows"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../types/routing"
+import { AdminPostCancelExchangeReqSchemaType } from "../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostCancelExchangeReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  const workflow = cancelOrderExchangeWorkflow(req.scope)
+  const { result } = await workflow.run({
+    input: {
+      ...req.validatedBody,
+      exchange_id: id,
+    },
+  })
+
+  res.status(200).json({ exchange: result })
+}

packages/medusa/src/api/admin/exchanges/[id]/inbound/items/[action_id]/route.ts

@@ -0,0 +1,96 @@
+import {
+  removeItemReturnActionWorkflow,
+  updateRequestItemReturnWorkflow,
+} from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../../types/routing"
+import { defaultAdminDetailsReturnFields } from "../../../../../returns/query-config"
+import { AdminPostExchangesRequestItemsReturnActionReqSchemaType } from "../../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExchangesRequestItemsReturnActionReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id, action_id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const [exchange] = await remoteQuery(
+    remoteQueryObjectFromString({
+      entryPoint: "order_exchange",
+      variables: {
+        id,
+      },
+      fields: ["return_id"],
+    }),
+    undefined,
+    {
+      throwIfKeyNotFound: true,
+    }
+  )
+
+  const { result } = await updateRequestItemReturnWorkflow(req.scope).run({
+    input: {
+      data: { ...req.validatedBody },
+      return_id: exchange.return_id,
+      exchange_id: exchange.id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "return",
+    variables: {
+      id: exchange.return_id,
+    },
+    fields: defaultAdminDetailsReturnFields,
+  })
+
+  const [orderReturn] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    return: orderReturn,
+  })
+}
+
+export const DELETE = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { id, action_id } = req.params
+
+  const { result: orderPreview } = await removeItemReturnActionWorkflow(
+    req.scope
+  ).run({
+    input: {
+      return_id: id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "return",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+  const [orderReturn] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: orderPreview,
+    return: orderReturn,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/inbound/items/route.ts

@@ -0,0 +1,60 @@
+import { orderExchangeRequestItemReturnWorkflow } from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../types/routing"
+import { defaultAdminDetailsReturnFields } from "../../../../returns/query-config"
+import { AdminPostExchangesReturnRequestItemsReqSchemaType } from "../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExchangesReturnRequestItemsReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const [exchange] = await remoteQuery(
+    remoteQueryObjectFromString({
+      entryPoint: "order_exchange",
+      variables: {
+        id,
+      },
+      fields: ["return_id"],
+    }),
+    undefined,
+    {
+      throwIfKeyNotFound: true,
+    }
+  )
+
+  const { result } = await orderExchangeRequestItemReturnWorkflow(
+    req.scope
+  ).run({
+    input: {
+      ...req.validatedBody,
+      return_id: exchange.return_id,
+      exchange_id: id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "return",
+    variables: {
+      id: exchange.return_id,
+    },
+    fields: defaultAdminDetailsReturnFields,
+  })
+
+  const [orderReturn] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    return: orderReturn,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/inbound/shipping-method/[action_id]/route.ts

@@ -0,0 +1,110 @@
+import {
+  removeReturnShippingMethodWorkflow,
+  updateReturnShippingMethodWorkflow,
+} from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../../types/routing"
+import { defaultAdminDetailsReturnFields } from "../../../../../returns/query-config"
+import { AdminPostExchangesShippingActionReqSchemaType } from "../../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExchangesShippingActionReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id, action_id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const [exchange] = await remoteQuery(
+    remoteQueryObjectFromString({
+      entryPoint: "order_exchange",
+      variables: {
+        id,
+      },
+      fields: ["return_id"],
+    }),
+    undefined,
+    {
+      throwIfKeyNotFound: true,
+    }
+  )
+
+  const { result } = await updateReturnShippingMethodWorkflow(req.scope).run({
+    input: {
+      data: { ...req.validatedBody },
+      return_id: exchange.return_id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    exchange: orderExchange,
+  })
+}
+
+export const DELETE = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { id, action_id } = req.params
+
+  const [exchange] = await remoteQuery(
+    remoteQueryObjectFromString({
+      entryPoint: "order_exchange",
+      variables: {
+        id,
+      },
+      fields: ["return_id"],
+    }),
+    undefined,
+    {
+      throwIfKeyNotFound: true,
+    }
+  )
+
+  const { result: orderPreview } = await removeReturnShippingMethodWorkflow(
+    req.scope
+  ).run({
+    input: {
+      return_id: exchange.return_id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "return",
+    variables: {
+      id: exchange.return_id,
+    },
+    fields: defaultAdminDetailsReturnFields,
+  })
+
+  const [orderReturn] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: orderPreview,
+    return: orderReturn,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/inbound/shipping-method/route.ts

@@ -0,0 +1,58 @@
+import { createExchangeShippingMethodWorkflow } from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../types/routing"
+import { defaultAdminDetailsReturnFields } from "../../../../returns/query-config"
+import { AdminPostReturnsShippingReqSchemaType } from "../../../../returns/validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostReturnsShippingReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const [exchange] = await remoteQuery(
+    remoteQueryObjectFromString({
+      entryPoint: "order_exchange",
+      variables: {
+        id,
+      },
+      fields: ["return_id"],
+    }),
+    undefined,
+    {
+      throwIfKeyNotFound: true,
+    }
+  )
+
+  const { result } = await createExchangeShippingMethodWorkflow(req.scope).run({
+    input: {
+      ...req.validatedBody,
+      return_id: exchange.return_id,
+      exchange_id: id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "return",
+    variables: {
+      id: exchange.return_id,
+    },
+    fields: defaultAdminDetailsReturnFields,
+  })
+
+  const [orderReturn] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    return: orderReturn,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/outbound/items/[action_id]/route.ts

@@ -0,0 +1,83 @@
+import {
+  removeItemExchangeActionWorkflow,
+  updateExchangeAddItemWorkflow,
+} from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../../types/routing"
+import { AdminPostExhangesItemsActionReqSchemaType } from "../../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExhangesItemsActionReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id, action_id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { result } = await updateExchangeAddItemWorkflow(req.scope).run({
+    input: {
+      data: { ...req.validatedBody },
+      exchange_id: id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    exchange: orderExchange,
+  })
+}
+
+export const DELETE = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { id, action_id } = req.params
+
+  const { result: orderPreview } = await removeItemExchangeActionWorkflow(
+    req.scope
+  ).run({
+    input: {
+      exchange_id: id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: orderPreview,
+    exchange: orderExchange,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/outbound/items/route.ts

@@ -0,0 +1,42 @@
+import { orderExchangeAddNewItemWorkflow } from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../types/routing"
+import { AdminPostExchangesAddItemsReqSchemaType } from "../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExchangesAddItemsReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { result } = await orderExchangeAddNewItemWorkflow(req.scope).run({
+    input: { ...req.validatedBody, exchange_id: id },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    exchange: orderExchange,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/outbound/shipping-method/[action_id]/route.ts

@@ -0,0 +1,83 @@
+import {
+  removeExchangeShippingMethodWorkflow,
+  updateExchangeShippingMethodWorkflow,
+} from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../../types/routing"
+import { AdminPostExchangesShippingActionReqSchemaType } from "../../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExchangesShippingActionReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id, action_id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { result } = await updateExchangeShippingMethodWorkflow(req.scope).run({
+    input: {
+      data: { ...req.validatedBody },
+      exchange_id: id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    exchange: orderExchange,
+  })
+}
+
+export const DELETE = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { id, action_id } = req.params
+
+  const { result: orderPreview } = await removeExchangeShippingMethodWorkflow(
+    req.scope
+  ).run({
+    input: {
+      exchange_id: id,
+      action_id,
+    },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: orderPreview,
+    exchange: orderExchange,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/outbound/shipping-method/route.ts

@@ -0,0 +1,41 @@
+import { createExchangeShippingMethodWorkflow } from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../../types/routing"
+import { AdminPostExchangesShippingReqSchemaType } from "../../../validators"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostExchangesShippingReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { result } = await createExchangeShippingMethodWorkflow(req.scope).run({
+    input: { ...req.validatedBody, exchange_id: id },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [orderExchange] = await remoteQuery(queryObject)
+
+  res.json({
+    order_preview: result,
+    exchange: orderExchange,
+  })
+}

packages/medusa/src/api/admin/exchanges/[id]/request/route.ts

@@ -0,0 +1,80 @@
+import {
+  cancelBeginOrderExchangeWorkflow,
+  confirmExchangeRequestWorkflow,
+} from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../../../types/routing"
+import { defaultAdminDetailsReturnFields } from "../../../returns/query-config"
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const { result } = await confirmExchangeRequestWorkflow(req.scope).run({
+    input: { exchange_id: id },
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [orderExchange] = await remoteQuery(queryObject, undefined, {
+    throwIfKeyNotFound: true,
+  })
+
+  let orderReturn
+  if (orderExchange.return_id) {
+    const [orderReturnData] = await remoteQuery(
+      remoteQueryObjectFromString({
+        entryPoint: "return",
+        variables: {
+          id: orderExchange.return_id,
+        },
+        fields: defaultAdminDetailsReturnFields,
+      })
+    )
+    orderReturn = orderReturnData
+  }
+
+  res.json({
+    order_preview: result,
+    exchange: orderExchange,
+    return: orderReturn,
+  })
+}
+
+export const DELETE = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const { id } = req.params
+
+  await cancelBeginOrderExchangeWorkflow(req.scope).run({
+    input: {
+      exchange_id: id,
+    },
+  })
+
+  res.status(200).json({
+    id,
+    object: "exchange",
+    deleted: true,
+  })
+}

packages/medusa/src/api/admin/exchanges/middlewares.ts

@@ -0,0 +1,212 @@
+import { MiddlewareRoute } from "@medusajs/framework"
+import { validateAndTransformBody } from "../../utils/validate-body"
+import { validateAndTransformQuery } from "../../utils/validate-query"
+import * as QueryConfig from "./query-config"
+import {
+  AdminGetOrdersOrderParams,
+  AdminGetOrdersParams,
+  AdminPostCancelExchangeReqSchema,
+  AdminPostExchangesAddItemsReqSchema,
+  AdminPostExchangesRequestItemsReturnActionReqSchema,
+  AdminPostExchangesReturnRequestItemsReqSchema,
+  AdminPostExchangesShippingActionReqSchema,
+  AdminPostExchangesShippingReqSchema,
+  AdminPostExhangesItemsActionReqSchema,
+  AdminPostOrderExchangesReqSchema,
+} from "./validators"
+
+export const adminExchangeRoutesMiddlewares: MiddlewareRoute[] = [
+  {
+    method: ["GET"],
+    matcher: "/admin/exchanges",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersParams,
+        QueryConfig.listTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["GET"],
+    matcher: "/admin/exchanges/:id",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges",
+    middlewares: [
+      validateAndTransformBody(AdminPostOrderExchangesReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/inbound/items",
+    middlewares: [
+      validateAndTransformBody(AdminPostExchangesReturnRequestItemsReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/inbound/items/:action_id",
+    middlewares: [
+      validateAndTransformBody(
+        AdminPostExchangesRequestItemsReturnActionReqSchema
+      ),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["DELETE"],
+    matcher: "/admin/exchanges/:id/inbound/items/:action_id",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/inbound/shipping-method",
+    middlewares: [
+      validateAndTransformBody(AdminPostExchangesShippingReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/inbound/shipping-method/:action_id",
+    middlewares: [
+      validateAndTransformBody(AdminPostExchangesShippingActionReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["DELETE"],
+    matcher: "/admin/exchanges/:id/inbound/shipping-method/:action_id",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/outbound/items",
+    middlewares: [
+      validateAndTransformBody(AdminPostExchangesAddItemsReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/outbound/items/:action_id",
+    middlewares: [
+      validateAndTransformBody(AdminPostExhangesItemsActionReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["DELETE"],
+    matcher: "/admin/exchanges/:id/outbound/items/:action_id",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/outbound/shipping-method",
+    middlewares: [
+      validateAndTransformBody(AdminPostExchangesShippingReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/outbound/shipping-method/:action_id",
+    middlewares: [
+      validateAndTransformBody(AdminPostExchangesShippingActionReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["DELETE"],
+    matcher: "/admin/exchanges/:id/outbound/shipping-method/:action_id",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/request",
+    middlewares: [
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+  {
+    method: ["DELETE"],
+    matcher: "/admin/exchanges/:id/request",
+    middlewares: [],
+  },
+  {
+    method: ["DELETE"],
+    matcher: "/admin/exchanges/:id",
+    middlewares: [],
+  },
+  {
+    method: ["POST"],
+    matcher: "/admin/exchanges/:id/cancel",
+    middlewares: [
+      validateAndTransformBody(AdminPostCancelExchangeReqSchema),
+      validateAndTransformQuery(
+        AdminGetOrdersOrderParams,
+        QueryConfig.retrieveTransformQueryConfig
+      ),
+    ],
+  },
+]

packages/medusa/src/api/admin/exchanges/query-config.ts

@@ -0,0 +1,27 @@
+export const defaultAdminExchangeFields = [
+  "id",
+  "type",
+  "order_id",
+  "return_id",
+  "display_id",
+  "order_version",
+  "created_at",
+  "updated_at",
+  "canceled_at",
+]
+
+export const defaultAdminDetailsExchangeFields = [
+  ...defaultAdminExchangeFields,
+  "additional_items.*",
+]
+
+export const retrieveTransformQueryConfig = {
+  defaultFields: defaultAdminDetailsExchangeFields,
+  isList: false,
+}
+
+export const listTransformQueryConfig = {
+  defaults: defaultAdminExchangeFields,
+  defaultLimit: 20,
+  isList: true,
+}

packages/medusa/src/api/admin/exchanges/route.ts

@@ -0,0 +1,74 @@
+import { beginExchangeOrderWorkflow } from "@medusajs/core-flows"
+import {
+  ContainerRegistrationKeys,
+  ModuleRegistrationName,
+  promiseAll,
+  remoteQueryObjectFromString,
+} from "@medusajs/utils"
+import {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "../../../types/routing"
+import { AdminPostOrderExchangesReqSchemaType } from "./validators"
+
+export const GET = async (
+  req: AuthenticatedMedusaRequest,
+  res: MedusaResponse
+) => {
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchanges",
+    variables: {
+      filters: {
+        ...req.filterableFields,
+      },
+      ...req.remoteQueryConfig.pagination,
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const { rows: exchanges, metadata } = await remoteQuery(queryObject)
+
+  res.json({
+    exchanges,
+    count: metadata.count,
+    offset: metadata.skip,
+    limit: metadata.take,
+  })
+}
+
+export const POST = async (
+  req: AuthenticatedMedusaRequest<AdminPostOrderExchangesReqSchemaType>,
+  res: MedusaResponse
+) => {
+  const input = req.validatedBody as AdminPostOrderExchangesReqSchemaType
+  const remoteQuery = req.scope.resolve(ContainerRegistrationKeys.REMOTE_QUERY)
+  const orderModuleService = req.scope.resolve(ModuleRegistrationName.ORDER)
+
+  const workflow = beginExchangeOrderWorkflow(req.scope)
+  const { result } = await workflow.run({
+    input,
+  })
+
+  const queryObject = remoteQueryObjectFromString({
+    entryPoint: "order_exchange",
+    variables: {
+      id: result.exchange_id,
+      filters: {
+        ...req.filterableFields,
+      },
+    },
+    fields: req.remoteQueryConfig.fields,
+  })
+
+  const [order, orderExchange] = await promiseAll([
+    orderModuleService.retrieveOrder(result.order_id),
+    remoteQuery(queryObject),
+  ])
+
+  res.json({
+    order,
+    exchange: orderExchange[0],
+  })
+}

packages/medusa/src/api/admin/exchanges/validators.ts

@@ -0,0 +1,170 @@
+import { z } from "zod"
+import {
+  createFindParams,
+  createOperatorMap,
+  createSelectParams,
+} from "../../utils/validators"
+
+export const AdminGetOrdersOrderParams = createSelectParams().merge(
+  z.object({
+    id: z.union([z.string(), z.array(z.string())]).optional(),
+    status: z.union([z.string(), z.array(z.string())]).optional(),
+    created_at: createOperatorMap().optional(),
+    updated_at: createOperatorMap().optional(),
+    deleted_at: createOperatorMap().optional(),
+  })
+)
+
+export type AdminGetOrdersOrderParamsType = z.infer<
+  typeof AdminGetOrdersOrderParams
+>
+
+/**
+ * Parameters used to filter and configure the pagination of the retrieved order.
+ */
+export const AdminGetOrdersParams = createFindParams({
+  limit: 15,
+  offset: 0,
+}).merge(
+  z.object({
+    id: z.union([z.string(), z.array(z.string())]).optional(),
+    order_id: z.union([z.string(), z.array(z.string())]).optional(),
+    status: z.union([z.string(), z.array(z.string())]).optional(),
+    created_at: createOperatorMap().optional(),
+    updated_at: createOperatorMap().optional(),
+    deleted_at: createOperatorMap().optional(),
+  })
+)
+
+export type AdminGetOrdersParamsType = z.infer<typeof AdminGetOrdersParams>
+
+export const AdminPostOrderExchangesReqSchema = z.object({
+  order_id: z.string(),
+  description: z.string().optional(),
+  internal_note: z.string().optional(),
+  metadata: z.record(z.unknown()).nullish(),
+})
+export type AdminPostOrderExchangesReqSchemaType = z.infer<
+  typeof AdminPostOrderExchangesReqSchema
+>
+
+export const AdminPostReceiveExchangesReqSchema = z.object({
+  internal_note: z.string().optional(),
+  description: z.string().optional(),
+  metadata: z.record(z.unknown()).nullish(),
+})
+export type AdminPostReceiveExchangesReqSchemaType = z.infer<
+  typeof AdminPostReceiveExchangesReqSchema
+>
+
+const ReceiveItemSchema = z.object({
+  id: z.string(),
+  quantity: z.number().min(1),
+  internal_note: z.string().optional(),
+})
+export const AdminPostReceiveExchangeItemsReqSchema = z.object({
+  items: z.array(ReceiveItemSchema),
+})
+export type AdminPostReceiveExchangeItemsReqSchemaType = z.infer<
+  typeof AdminPostReceiveExchangeItemsReqSchema
+>
+
+export const AdminPostCancelExchangeReqSchema = z.object({
+  no_notification: z.boolean().optional(),
+})
+export type AdminPostCancelExchangeReqSchemaType = z.infer<
+  typeof AdminPostCancelExchangeReqSchema
+>
+
+export const AdminPostExchangesRequestItemsReturnActionReqSchema = z.object({
+  quantity: z.number().optional(),
+  internal_note: z.string().nullish().optional(),
+  reason_id: z.string().nullish().optional(),
+  metadata: z.record(z.unknown()).nullish().optional(),
+})
+
+export type AdminPostExchangesRequestItemsReturnActionReqSchemaType = z.infer<
+  typeof AdminPostExchangesRequestItemsReturnActionReqSchema
+>
+
+export const AdminPostExchangesShippingReqSchema = z.object({
+  shipping_option_id: z.string(),
+  custom_price: z.number().optional(),
+  description: z.string().optional(),
+  internal_note: z.string().optional(),
+  metadata: z.record(z.unknown()).optional(),
+})
+
+export type AdminPostExchangesShippingReqSchemaType = z.infer<
+  typeof AdminPostExchangesShippingReqSchema
+>
+
+export const AdminPostExchangesShippingActionReqSchema = z.object({
+  custom_price: z.number().optional(),
+  internal_note: z.string().nullish().optional(),
+  metadata: z.record(z.unknown()).nullish().optional(),
+})
+
+export type AdminPostExchangesShippingActionReqSchemaType = z.infer<
+  typeof AdminPostExchangesShippingActionReqSchema
+>
+
+export const AdminPostExchangesAddItemsReqSchema = z.object({
+  items: z.array(
+    z.object({
+      variant_id: z.string(),
+      quantity: z.number(),
+      unit_price: z.number().optional(),
+      internal_note: z.string().optional(),
+      allow_backorder: z.boolean().optional(),
+      metadata: z.record(z.unknown()).optional(),
+    })
+  ),
+})
+
+export type AdminPostExchangesAddItemsReqSchemaType = z.infer<
+  typeof AdminPostExchangesAddItemsReqSchema
+>
+
+export const AdminPostExchangesReturnRequestItemsReqSchema = z.object({
+  items: z.array(
+    z.object({
+      id: z.string(),
+      quantity: z.number(),
+      description: z.string().optional(),
+      internal_note: z.string().optional(),
+      reason_id: z.string().optional(),
+      metadata: z.record(z.unknown()).optional(),
+    })
+  ),
+})
+
+export type AdminPostExchangesReturnRequestItemsReqSchemaType = z.infer<
+  typeof AdminPostExchangesReturnRequestItemsReqSchema
+>
+
+export const AdminPostExchangesDismissItemsActionReqSchema = z.object({
+  quantity: z.number().optional(),
+  internal_note: z.string().nullish().optional(),
+})
+
+export type AdminPostExchangesDismissItemsActionReqSchemaType = z.infer<
+  typeof AdminPostExchangesDismissItemsActionReqSchema
+>
+
+export const AdminPostExchangesConfirmRequestReqSchema = z.object({
+  no_notification: z.boolean().optional(),
+})
+
+export type AdminPostExchangesConfirmRequestReqSchemaType = z.infer<
+  typeof AdminPostExchangesConfirmRequestReqSchema
+>
+
+export const AdminPostExhangesItemsActionReqSchema = z.object({
+  quantity: z.number().optional(),
+  internal_note: z.string().nullish().optional(),
+})
+
+export type AdminPostExhangesItemsActionReqSchemaType = z.infer<
+  typeof AdminPostExhangesItemsActionReqSchema
+>

packages/medusa/src/api/middlewares.ts

@@ -7,6 +7,7 @@ import { adminCurrencyRoutesMiddlewares } from "./admin/currencies/middlewares"
 import { adminCustomerGroupRoutesMiddlewares } from "./admin/customer-groups/middlewares"
 import { adminCustomerRoutesMiddlewares } from "./admin/customers/middlewares"
 import { adminDraftOrderRoutesMiddlewares } from "./admin/draft-orders/middlewares"
+import { adminExchangeRoutesMiddlewares } from "./admin/exchanges/middlewares"
 import { adminFulfillmentProvidersRoutesMiddlewares } from "./admin/fulfillment-providers/middlewares"
 import { adminFulfillmentSetsRoutesMiddlewares } from "./admin/fulfillment-sets/middlewares"
 import { adminFulfillmentsRoutesMiddlewares } from "./admin/fulfillments/middlewares"
@@ -106,4 +107,5 @@ export default defineMiddlewares([
   ...storeReturnReasonRoutesMiddlewares,
   ...adminReturnReasonRoutesMiddlewares,
   ...adminClaimRoutesMiddlewares,
+  ...adminExchangeRoutesMiddlewares,
 ])

packages/modules/order/src/services/actions/cancel-claim.ts

@@ -43,6 +43,7 @@ export async function cancelClaim(
         "claim_items.is_additional_item",
         "claim_items.quantity",
         "additional_items.id",
+        "additional_items.item_id",
         "additional_items.quantity",
         "additional_items.is_additional_item",
       ],

packages/modules/order/src/services/actions/cancel-exchange.ts

@@ -8,16 +8,16 @@ import { ChangeActionType, promiseAll } from "@medusajs/utils"
 async function createOrderChange(
   service,
   data,
-  returnRef,
+  exchangeOrder,
   actions,
   sharedContext
 ) {
   return await service.createOrderChange_(
     {
-      order_id: returnRef.order_id,
-      exchange_id: returnRef.id,
-      reference: "return",
-      reference_id: returnRef.id,
+      order_id: exchangeOrder.order_id,
+      exchange_id: exchangeOrder.id,
+      reference: "exchange",
+      reference_id: exchangeOrder.id,
       description: data.description,
       internal_note: data.internal_note,
       created_by: data.created_by,
@@ -33,40 +33,23 @@ export async function cancelExchange(
   data: OrderTypes.CancelOrderExchangeDTO,
   sharedContext?: Context
 ) {
-  const exchangeOrder = await this.retrieveExchange(
+  const exchangeOrder = await this.retrieveOrderExchange(
     data.exchange_id,
     {
       select: [
         "id",
         "order_id",
-        "return.id",
-        "return.items.item_id",
-        "return.items.quantity",
         "additional_items.id",
+        "additional_items.item_id",
         "additional_items.quantity",
       ],
-      relations: ["return.items", "additional_items", "shipping_methods"],
+      relations: ["additional_items", "shipping_methods"],
     },
     sharedContext
   )
 
   const actions: CreateOrderChangeActionDTO[] = []
 
-  exchangeOrder.return.items.forEach((item) => {
-    actions.push({
-      action: ChangeActionType.CANCEL_RETURN_ITEM,
-      order_id: exchangeOrder.order_id,
-      exchange_id: exchangeOrder.id,
-      return_id: exchangeOrder.return.id,
-      reference: "return",
-      reference_id: exchangeOrder.return.id,
-      details: {
-        reference_id: item.item_id,
-        quantity: item.quantity,
-      },
-    })
-  })
-
   exchangeOrder.additional_items.forEach((item) => {
     actions.push({
       action: ChangeActionType.ITEM_REMOVE,
@@ -88,7 +71,6 @@ export async function cancelExchange(
       action: ChangeActionType.SHIPPING_REMOVE,
       order_id: exchangeOrder.order_id,
       exchange_id: exchangeOrder.id,
-      return_id: exchangeOrder.return.id,
       reference: "exchange",
       reference_id: shipping.id,
       amount: shipping.price,
@@ -104,7 +86,7 @@ export async function cancelExchange(
   )
 
   await promiseAll([
-    this.updateExchanges(
+    this.updateOrderExchanges(
       [
         {
           data: {

packages/modules/order/src/services/actions/create-claim.ts

@@ -125,6 +125,7 @@ async function processAdditionalItems(
         details: {
           reference_id: item.id,
           quantity: item.quantity,
+          unit_price: item.unit_price ?? hasItem.item.unit_price,
           metadata: item.metadata,
         },
       })
@@ -144,6 +145,7 @@ async function processAdditionalItems(
       additionalNewItems.push(
         em.create(OrderClaimItem, {
           quantity: item.quantity,
+          unit_price: item.unit_price,
           note: item.note,
           metadata: item.metadata,
           is_additional_item: true,

packages/modules/order/src/services/actions/create-exchange.ts

@@ -92,6 +92,7 @@ async function processAdditionalItems(
         details: {
           reference_id: item.id,
           quantity: item.quantity,
+          unit_price: item.unit_price ?? hasItem.item.unit_price,
           metadata: item.metadata,
         },
       })
@@ -111,6 +112,7 @@ async function processAdditionalItems(
       additionalNewItems.push(
         em.create(OrderExchangeItem, {
           quantity: item.quantity,
+          unit_price: item.unit_price,
           note: item.note,
           metadata: item.metadata,
           is_additional_item: true,

packages/modules/order/src/services/order-module-service.ts

@@ -3206,7 +3206,7 @@ export default class OrderModuleService<
     const ret = await this.cancelClaim_(data, sharedContext)
 
     return await this.retrieveOrderClaim(ret.id, {
-      relations: ["additional_items", "claim_items"],
+      relations: ["additional_items", "claim_items", "return", "return.items"],
     })
   }
 
@@ -3266,7 +3266,7 @@ export default class OrderModuleService<
     const ret = await this.cancelExchange_(data, sharedContext)
 
     return await this.retrieveOrderExchange(ret.id, {
-      relations: ["items"],
+      relations: ["additional_items", "return", "return.items"],
     })
   }
 

packages/modules/order/src/utils/actions/cancel-item-fulfillment.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -26,7 +21,7 @@ OrderChangeProcessing.registerActionType(
     },
     validate({ action, currentOrder }) {
       const refId = action.details?.reference_id
-      if (!isDefined(refId)) {
+      if (refId == null) {
         throw new MedusaError(
           MedusaError.Types.INVALID_DATA,
           "Reference ID is required."

packages/modules/order/src/utils/actions/cancel-return.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -22,24 +17,17 @@ OrderChangeProcessing.registerActionType(ChangeActionType.CANCEL_RETURN_ITEM, {
 
     setActionReference(existing, action, options)
 
-    return action.details.unit_price * action.details.quantity
+    return MathBN.mult(existing.unit_price, action.details.quantity)
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Details reference ID is required."
       )
     }
 
-    if (!isDefined(action.amount) && !isDefined(action.details?.unit_price)) {
-      throw new MedusaError(
-        MedusaError.Types.INVALID_DATA,
-        `Unit price of item ${action.reference_id} is required if no action.amount is provided.`
-      )
-    }
-
     const existing = currentOrder.items.find((item) => item.id === refId)
 
     if (!existing) {

packages/modules/order/src/utils/actions/fulfill-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -24,7 +19,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.FULFILL_ITEM, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Reference ID is required."

packages/modules/order/src/utils/actions/item-add.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { VirtualOrder } from "@types"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
@@ -45,7 +40,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.ITEM_ADD, {
   validate({ action }) {
     const refId = action.details?.reference_id
 
-    if (!isDefined(action.amount) && !isDefined(action.details?.unit_price)) {
+    if (action.amount == null && action.details?.unit_price == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         `Unit price of item ${refId} is required if no action.amount is provided.`

packages/modules/order/src/utils/actions/item-remove.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -34,7 +29,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.ITEM_REMOVE, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Reference ID is required."
@@ -49,13 +44,6 @@ OrderChangeProcessing.registerActionType(ChangeActionType.ITEM_REMOVE, {
       )
     }
 
-    if (!isDefined(action.amount) && !isDefined(action.details?.unit_price)) {
-      throw new MedusaError(
-        MedusaError.Types.INVALID_DATA,
-        `Unit price of item ${refId} is required if no action.amount is provided.`
-      )
-    }
-
     if (!action.details?.quantity) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,

packages/modules/order/src/utils/actions/receive-damaged-return-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -42,7 +37,7 @@ OrderChangeProcessing.registerActionType(
     },
     validate({ action, currentOrder }) {
       const refId = action.details?.reference_id
-      if (!isDefined(refId)) {
+      if (refId == null) {
         throw new MedusaError(
           MedusaError.Types.INVALID_DATA,
           "Details reference ID is required."

packages/modules/order/src/utils/actions/receive-return-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -34,7 +29,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.RECEIVE_RETURN_ITEM, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Details reference ID is required."

packages/modules/order/src/utils/actions/reinstate-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -23,7 +18,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.REINSTATE_ITEM, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Details reference ID is required."

packages/modules/order/src/utils/actions/return-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -27,7 +22,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.RETURN_ITEM, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Details reference ID is required."

packages/modules/order/src/utils/actions/ship-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -24,7 +19,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.SHIP_ITEM, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Reference ID is required."

packages/modules/order/src/utils/actions/shipping-add.ts

@@ -1,4 +1,4 @@
-import { ChangeActionType, MedusaError, isDefined } from "@medusajs/utils"
+import { ChangeActionType, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -33,7 +33,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.SHIPPING_ADD, {
       )
     }
 
-    if (!isDefined(action.amount)) {
+    if (action.amount == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Amount is required."

packages/modules/order/src/utils/actions/shipping-remove.ts

@@ -1,4 +1,4 @@
-import { ChangeActionType, MedusaError, isDefined } from "@medusajs/utils"
+import { ChangeActionType, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 
 OrderChangeProcessing.registerActionType(ChangeActionType.SHIPPING_REMOVE, {
@@ -24,12 +24,5 @@ OrderChangeProcessing.registerActionType(ChangeActionType.SHIPPING_REMOVE, {
         "Reference ID is required."
       )
     }
-
-    if (!isDefined(action.amount)) {
-      throw new MedusaError(
-        MedusaError.Types.INVALID_DATA,
-        "Amount is required."
-      )
-    }
   },
 })

packages/modules/order/src/utils/actions/write-off-item.ts

@@ -1,9 +1,4 @@
-import {
-  ChangeActionType,
-  MathBN,
-  MedusaError,
-  isDefined,
-} from "@medusajs/utils"
+import { ChangeActionType, MathBN, MedusaError } from "@medusajs/utils"
 import { OrderChangeProcessing } from "../calculate-order-change"
 import { setActionReference } from "../set-action-reference"
 
@@ -23,7 +18,7 @@ OrderChangeProcessing.registerActionType(ChangeActionType.WRITE_OFF_ITEM, {
   },
   validate({ action, currentOrder }) {
     const refId = action.details?.reference_id
-    if (!isDefined(refId)) {
+    if (refId == null) {
       throw new MedusaError(
         MedusaError.Types.INVALID_DATA,
         "Details reference ID is required."