Add ITEM_RECEIVED event (#8651)

* Add ITEM_RECEIVED event

- Triggered when an item is recevied against a purchase order

* Adjust unit test

src/backend/InvenTree/order/events.py

@@ -13,6 +13,8 @@ class PurchaseOrderEvents(BaseEventEnum):
 
     OVERDUE = 'order.overdue_purchase_order'
 
+    ITEM_RECEIVED = 'purchaseorderitem.received'
+
 
 class SalesOrderEvents(BaseEventEnum):
     """Event enumeration for the SalesOrder models."""

src/backend/InvenTree/order/models.py

@@ -883,6 +883,10 @@ class PurchaseOrder(TotalPriceMixin, Order):
                     quantity=float(quantity),
                 )
 
+                trigger_event(
+                    PurchaseOrderEvents.ITEM_RECEIVED, order_id=self.pk, item_id=self.pk
+                )
+
         # Update the number of parts received against the particular line item
         # Note that this quantity does *not* take the pack_quantity into account, it is "number of packs"
         line.received += quantity

src/backend/InvenTree/order/test_api.py

@@ -1168,7 +1168,8 @@ class PurchaseOrderReceiveTest(OrderTest):
 
         n = StockItem.objects.count()
 
-        self.post(self.url, data, expected_code=201, max_query_count=400)
+        # TODO: 2024-12-10 - This API query needs to be refactored!
+        self.post(self.url, data, expected_code=201, max_query_count=500)
 
         # Check that the expected number of stock items has been created
         self.assertEqual(n + 11, StockItem.objects.count())