feat(medusa): Allow creating DraftOrders without items (#2719)

.changeset/good-needles-shave.md

@@ -0,0 +1,5 @@
+---
+"@medusajs/medusa": patch
+---
+
+feat(medusa): Create draft orders without items

integration-tests/api/__tests__/admin/draft-order/draft-order.js

@@ -381,6 +381,30 @@ describe("/admin/draft-orders", () => {
       expect(response.status).toEqual(200)
     })
 
+    it("creates a draft order without a single item", async () => {
+      const api = useApi()
+
+      const payload = {
+        email: "oli@test.dk",
+        shipping_address: "oli-shipping",
+        region_id: "test-region",
+        customer_id: "oli-test",
+        shipping_methods: [
+          {
+            option_id: "test-option",
+          },
+        ],
+      }
+
+      const response = await api.post(
+        "/admin/draft-orders",
+        payload,
+        adminReqConfig
+      )
+      expect(response.data.draft_order.cart.items).toEqual([])
+      expect(response.status).toEqual(200)
+    })
+
     it("creates a draft order with product variant with custom price and custom item price set to 0", async () => {
       const api = useApi()
 

packages/medusa/src/api/routes/admin/draft-orders/create-draft-order.ts

@@ -39,7 +39,6 @@ import { IsType } from "../../../../utils/validators/is-type"
  *         type: object
  *         required:
  *           - email
- *           - items
  *           - region_id
  *           - shipping_methods
  *         properties:
@@ -270,7 +269,8 @@ export class AdminPostDraftOrdersReq {
   @Type(() => Item)
   @IsNotEmpty()
   @ValidateNested({ each: true })
-  items: Item[]
+  @IsOptional()
+  items?: Item[]
 
   @IsString()
   region_id: string

packages/medusa/src/services/__tests__/draft-order.js

@@ -209,17 +209,12 @@ describe("DraftOrderService", () => {
       }
     })
 
-    it("fails on missing items", async () => {
+    it("creating a draft order without items is allowed", async () => {
-      try {
       await draftOrderService.create({
         region_id: "test-region",
         items: [],
+        shipping_methods: []
       })
-      } catch (error) {
-        expect(error.message).toEqual(
-          `Items are required to create a draft order`
-        )
-      }
     })
   })
 

packages/medusa/src/services/draft-order.ts

@@ -259,13 +259,6 @@ class DraftOrderService extends TransactionBaseService {
           )
         }
 
-        if (!data.items || !data.items.length) {
-          throw new MedusaError(
-            MedusaError.Types.INVALID_DATA,
-            `Items are required to create a draft order`
-          )
-        }
-
         const {
           shipping_methods,
           no_notification_order,
@@ -310,7 +303,7 @@ class DraftOrderService extends TransactionBaseService {
         const lineItemServiceTx =
           this.lineItemService_.withTransaction(transactionManager)
 
-        for (const item of items) {
+        for (const item of (items || [])) {
           if (item.variant_id) {
             const line = await lineItemServiceTx.generate(
               item.variant_id,

packages/medusa/src/types/draft-orders.ts

@@ -9,7 +9,7 @@ export type DraftOrderCreateProps = {
   billing_address?: Partial<AddressPayload>
   shipping_address_id?: string
   shipping_address?: Partial<AddressPayload>
-  items: Item[]
+  items?: Item[]
   region_id: string
   discounts?: Discount[]
   customer_id?: string