Sales order barcode allocate (#6072)

* Bug fix for BarcodePOReceive endpoint

- Existing scan must match "stockitem" to raise an error

* bug fix: barcode.js

- Handle new return data from barcode scan endpoint

* Add barcode endpoint for allocating stock to sales order

* Improve logic for preventing over allocation of stock item to sales order

* Test for sufficient quantity

* Bump API version

* Bug fix and extra check

* Cleanup unit tests

* Add unit testing for new endpoint

* Add blank page for app sales orders docs

* Add docs for new barcode features in app

* Fix unit tests

* Remove debug statement

docs/docs/app/barcode.md

@@ -112,3 +112,15 @@ From the [Purchase Order detail page](./po.md#purchase-order-detail) page, the f
 #### Scan Received Parts
 
 Receive incoming purchase order items against the selected purchase order. Scanning a *new* barcode which is associated with an item in an incoming purchase order will receive the item into stock.
+
+### Sales Order Actions
+
+The following barcode actions are available for [Sales Orders](./so.md):
+
+#### Add Line Item
+
+Add a new line item to the selected order by scanning a *Part* barcode
+
+#### Assign Stock
+
+Allocate stock items to the selected sales order by scanning a *StockItem* barcode

docs/docs/app/po.md

@@ -4,7 +4,7 @@ title: Purchase Orders
 
 ## Purchase Order List
 
-The purchase order list display shows all current *outstanding* purchase orders. (Purchase orders which have been completed are not shown here).
+The purchase order list display lists all purchase orders:
 
 {% with id="po_list", url="app/po_list.png", maxheight="240px", description="Purchase order list" %}
 {% include "img.html" %}
@@ -14,7 +14,7 @@ Select an individual purchase order to display the detail view for that order.
 
 ### Filtering
 
-Available purchase orders can be subsequently filtered using the search input at the top of the screen
+Displayed purchase orders can be subsequently filtered using the search input at the top of the screen
 
 ## Purchase Order Detail
 

docs/docs/app/so.md

@@ -0,0 +1,37 @@
+---
+title: Sales Orders
+---
+
+## Sales Order List
+
+The sales order list display shows all sales orders:
+
+{% with id="so_list", url="app/so_list.png", maxheight="240px", description="Sales order list" %}
+{% include "img.html" %}
+{% endwith %}
+
+Select an individual sales order to display the detail view for that order.
+
+### Filtering
+
+Displayed sales orders can be subsequently filtered using the search input at the top of the screen
+
+## Sales Order Detail
+
+Select an individual order to show the detailed view for that order:
+
+{% with id="so_detail", url="app/so_detail.png", maxheight="240px", description="Sales order details" %}
+{% include "img.html" %}
+{% endwith %}
+
+### Edit Order Details
+
+From the detail view, select the *Edit* button in the top-right of the screen. This opens the sales order editing display.
+
+### Line Items
+
+View the line items associated with the selected order:
+
+{% with id="so_lines", url="app/so_lines.png", maxheight="240px", description="Sales order lines" %}
+{% include "img.html" %}
+{% endwith %}

docs/mkdocs.yml

@@ -174,6 +174,7 @@ nav:
     - Parts: app/part.md
     - Stock: app/stock.md
     - Purchase Orders: app/po.md
+    - Sales Orders: app/so.md
     - Settings: app/settings.md
     - Privacy: app/privacy.md
     - Translation: app/translation.md