feat: /api/v1/shipment/sales-items/by-printing-order/KD20135142/

api_v1/views/shipment/test_api.py

@@ -241,6 +241,56 @@ class SalesItemByPrintingOrderAPITestCase(TestCase):
         self.assertEqual(item["shipment_id"], self.shipment.id)
         self.assertEqual(item["shipment_date"], "2026-01-14")
 
+    def test_get_sales_items_by_external_order_id(self):
+        """测试通过 external_order_id 查询销售品"""
+        url = "/api/v1/shipment/sales-items/by-printing-order/EXT-PO-001/"
+        response = self.client.get(url)
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        data = response.json()
+
+        self.assertEqual(data["count"], 2)
+        item_ids = [item["id"] for item in data["results"]]
+        self.assertIn(self.sales_item1.id, item_ids)
+        self.assertIn(self.sales_item2.id, item_ids)
+        self.assertNotIn(self.sales_item3.id, item_ids)
+
+    def test_get_sales_items_by_external_order_id_multiple_matches(self):
+        """测试 external_order_id 匹配多个生产订单时报错"""
+        other_order = printing_models.PrintingOrder.objects.create(
+            merchant=self.merchant,
+            customer=self.customer,
+            fabric="测试面料3",
+            width="160cm",
+            process=self.process,
+            created_by=self.user,
+            external_order_id="EXT-DUPLICATED",
+        )
+        printing_models.PrintingOrder.objects.create(
+            merchant=self.merchant,
+            customer=self.customer,
+            fabric="测试面料4",
+            width="170cm",
+            process=self.process,
+            created_by=self.user,
+            external_order_id="EXT-DUPLICATED",
+        )
+        printing_models.PrintingJob.objects.create(
+            merchant=self.merchant,
+            printing_order=other_order,
+            product=self.product,
+            quantity=50,
+            unit="米",
+            created_by=self.user,
+        )
+
+        response = self.client.get(
+            "/api/v1/shipment/sales-items/by-printing-order/EXT-DUPLICATED/"
+        )
+
+        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+        self.assertIn("匹配到多个生产订单", response.json()["detail"])
+
     def test_get_sales_items_printing_order_not_found(self):
         """测试生产订单不存在"""
         url = "/api/v1/shipment/sales-items/by-printing-order/99999/"