+You cannot delete requisitions that have been created from an Internal Order, or have had a shipment created from them.
+
### Viewing a Requisition
@@ -87,6 +105,60 @@ You will then see the detail view of the requisition:
+#### Enter a Customer Reference
+
+The customer reference is automatically generated when the customer creates an
+Internal Order, but you can also enter a customer reference manually.
+
+#### View or edit the Requisition Information Panel
+
+The information Panel allows you to see or edit information about the
+Requisition. It is divided into three sections:
+
+- Additional Info
+- Related documents
+- Actions
+
+We are planning to add more sections in the future as Open mSupply grows.
+
+##### How to open and close the information Panel?
+
+To open the Information Panel, you can tap on the `More` button, located in the
+top right corner of the Requisition page.
+
+You can close the Information Panel by tapping on the `X Close` button on the
+top right corner of the information panel.
+
+
+
+##### Additional Info
+
+In the **Additional Info** section you can:
+
+- See who created the Requisition (name of the user)
+- See when the Requisition was created
+- View and edit the Requisition color. To edit the color, tap on the colored
+ circle and select a color from the pop-up
+- Write or edit a comment
+
+##### Related Documents
+
+In the **Related Documents** section you can see other related transactions for
+the Requisition.
+
+If you have created shipments for the Requisition, the shipment numbers will
+appear in this section along with a link to view the shipment.
+
+##### Actions
+
+**Copy to clipboard**: You can tap on the `Copy to Clipboard` button to copy
+the Requisition details to the clipboard.
+
+#### Requisition Detail
+
+
+
| Column | Description |
| :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Code** | Code of the item |
@@ -99,19 +171,52 @@ You will then see the detail view of the requisition:
| **Issued** | The quantity that has already been issued in `Outbound Shipments` |
| **Remaining** | The quantity remaining to be supplied to the customer. The calculation is 'Supply - Issued'. This quantity will be re-calculated after an `Outbound Shipment` has been created. |
-Clicking on an individual item in this view, will then show you details of the particular item. Here you can adjust the quantity to supply:
+One way to adjust the supply quantity, is to click the button `Supply requested`
+at the top of the page. This will automatically set the supply quantity to be
+that of the quantity requested for each item.
-
+
-The requested quantity is also shown, along with the stock item details.
+Click the button and you are asked
+for confirmation before the adjustment happens:
-The `My Store` tab indicates if the store have enough stock to meet the customer's requested quantity as well as the requested quantities from other customers. The two bars show the following:
+
-_The first bar:_
+The other way to adjust the supply quantity is to click on the item line in the
+table. This will open the line details page where you will see information about
+the item such as your stock on hand, and the requested quantity.
-- Your stock on hand for this item
-- Any incoming stock for this item that has been `Shipped`, but not yet `Delivered`
-- The quantity being requested for this item in any `Internal Orders`
+
+
+Once the `Quantity to supply` field is entered, a green tick will appear next to the item name, to help you track your progress.
+
+
+
+You can navigate between different items by:
+
+- Clicking on the item name in the list to the left of the screen
+- Using the `Previous` and `Next` buttons at the bottom of the screen
+
+
+
+##### Customer Store Stats
+
+Clicking on the `Graph Icon` next to the `Requested quantity` field will open a
+graph showing you the details of the stock at the customer's store.
+
+The request quantity charts will only show if the Requisition was created from an Internal Order.
+
+- The customer's _Target Quantity_ for this item. This is calculated as: Target MOS x AMC
+- The customer's stock on hand for this item
+
+
+
+##### Your Store Stats
+
+Clicking on the `Graph Icon` next to the `Quantity to Supply` field will open a
+graph showing you the details of the stock at your store.
This message will be displayed if your store currently doesn't have any stock available.
@@ -119,23 +224,32 @@ This message will be displayed if your store currently doesn't have any stock av
+_The first bar:_
+
+- Your stock on hand for this item
+- Any incoming stock for this item that has been `Shipped`, but not yet `Delivered`
+- The quantity being requested for this item in any `Internal Orders`
+
_The second bar:_
- The quantity being requested for this item in this Requisition
- The quantity being requested in other Requisitions
-
+
-The `Customer` tab shows the customer's stock situation for this item:
+To go back to the Requisition view, tap on the `Close` button at the top right
+corner of the screen or click on the `Requisition Number` at the top left of the
+screen.
+
-- The customer's _Target Quantity_ for this item. This is calculated as: Target MOS x AMC
-- The customer's stock on hand for this item
-
-Another way to adjust the supply quantity, is to click the button `Supply requested` at the top of the page. This will automatically set the supply quantity to be that of the quantity requested for that item. Click the button and you are asked for confirmation before the adjustment happens:
+#### Creating an Outbound Shipment from a Requisition
-
+Once you are happy with the supply quantities, you can create an `Outbound
+Shipment` which will supply the items requested by going back to the Requisition
+Detail page.
-To create an Outbound Shipment which will supply the items requested, click on the `Create Shipment` button. This will create a shipment, add all of the items which are not fully supplied, and then, open that shipment in a new tab. Before doing so, you are prompted to confirm:
+Click on the `Create Shipment` button. This will create a shipment, add all of the items which are not fully supplied, and then, open that shipment in a new tab. Before doing so, you are prompted to confirm:
@@ -144,3 +258,54 @@ If the supply quantity is changed for any item/s in the requisition after a ship
After creating the shipment, you will see the shipment number, along with a link to view it, in the `Related documents` section of the additional details panel on the right of the screen.
+
+Clicking an item line in the table will redirect you to the line details page. Here you can adjust the
+quantity to supply and add a comment:
+
+### Manual Requisition
+
+Usually, Requisitions will be sent to you by your Customers. However, if they aren't using mSupply, you can create a Requisition manually.
+
+#### Creating a Manual Requisition
+
+1. Go to `Distribution` > `Requisition`
+2. Press the `Create Requisition` button at the top right of the page
+
+
+
+3. A new window will appear where you can select the customer for whom you want
+ to create the requisition. You can search for the customer by typing their
+ name or code in the search bar or by scrolling through the list of customers.
+
+
+
+4. Once you have selected the customer, you will be taken to the requisition
+ detail page where you can add items to the requisition.
+
+
+You cannot change the customer name after the requisition has been created. If you have made a mistake in selecting the customer, you will need to delete the requisition and create a new one.
+
+
+#### Adding lines to a Requisition
+
+Tap on the `Add Item` button (top right corner).
+
+A new `Add Item` window will open. You can look up an item by:
+
+- Reading through the list of available items
+- or by typing some or all of the item name
+- or by typing some or all of an item code
+
+Once your item is highlighted, tap on the name or press `Enter`.
+
+
+
+Once the item has been selected, you will be redirected to the line edit page.
+Here you can enter the customer's stock on hand, average monthly consumption and
+requested quantity. You can also enter how much you are going to supply to the
+customer and any comments. The values are saved automatically.
+
+
+
+After this, the workflow will follow the [same steps](#viewing-a-requisition)
+as for a requisition created from an Internal Order.
diff --git a/content/docs/programs/images/add_program_requisition.png b/content/docs/programs/images/add_program_requisition.png
new file mode 100644
index 00000000..4f816460
Binary files /dev/null and b/content/docs/programs/images/add_program_requisition.png differ
diff --git a/content/docs/programs/images/add_requisition_button.png b/content/docs/programs/images/add_requisition_button.png
new file mode 100644
index 00000000..ea7805a4
Binary files /dev/null and b/content/docs/programs/images/add_requisition_button.png differ
diff --git a/content/docs/programs/images/program_requisition_detail_view.gif b/content/docs/programs/images/program_requisition_detail_view.gif
new file mode 100644
index 00000000..3053209f
Binary files /dev/null and b/content/docs/programs/images/program_requisition_detail_view.gif differ
diff --git a/content/docs/programs/images/program_requisition_line_edit.png b/content/docs/programs/images/program_requisition_line_edit.png
new file mode 100644
index 00000000..c8a925fd
Binary files /dev/null and b/content/docs/programs/images/program_requisition_line_edit.png differ
diff --git a/content/docs/programs/images/requisition-detail.png b/content/docs/programs/images/requisition-detail.png
index 9adfba4c..7168f5a0 100644
Binary files a/content/docs/programs/images/requisition-detail.png and b/content/docs/programs/images/requisition-detail.png differ
diff --git a/content/docs/programs/requisitions.md b/content/docs/programs/requisitions.md
index 722c0831..54b54d7f 100644
--- a/content/docs/programs/requisitions.md
+++ b/content/docs/programs/requisitions.md
@@ -73,6 +73,59 @@ The list view has gained some additional columns, showing the program related da
- **Order type**: the name of the order type ( typically, a normal or emergency order )
- **Period**: the name of the period selected
-And the detail view also has program information shown:
+#### Manual Program Requisitions
+
+Program Requisitions can also be created manually. This would typically be for customers who do not use mSupply, or in exceptional circumstances.
+
+See the configuration steps above, and also the [Customer
+tag](https://docs.msupply.org.nz/names:adding_and_editing#tags_tab)
+documentation to find out how to set up programs and add tags to customers.
+
+On the Requisitions page, click on the `New Requisition` button (top right
+corner).
+
+
+
+If you have programs set up, you'll see a different modal to the usual one:
+
+
+
+From the `Program` tab, you can create a Program Requisition by selecting the:
+
+- Program
+- Customer
+- Order Type
+- Period
+
+Only when you have selected all of the above, can you click `Create`.
+
+You will now be redirected to the Requisition detail page. The lines will be
+pre-populated with the items from the program; this means that you cannot add
+items manually to the Requisition.
+
+
+
+The line edit page will also contain the extra columns as well:
+
+| Column | Description |
+| :------------------------ | :-------------------------------------------------------------------------------------------------------- |
+| **Initial stock on hand** | The customer's stock on hand at the start of the program period |
+| **Incoming** | The customer's incoming stock in units for this item |
+| **Outgoing** | The customer's outgoing stock in units for this item |
+| **Losses** | Inventory Adjustment |
+| **Additions** | Inventory Adjustment |
+| **Available** | Initial stock on hand + incoming stock +/- inventory adjustment - outgoing stock |
+| **Short Expiry** | Sum of available stock for the item which has an expiry date after the program end date |
+| **Days out of stock** | (Target MOS \* AMC) - available stock |
+| **AMC** | The customer's average monthly consumption for this item |
+| **MOS** | Months of stock for the item |
+| **Reason** | A reason will be provided if their is a difference between the supply quantity and the requested quantity |
+
+
+
+An additional section will be visible in the side panel showing the program
+information.
