As an implementer, I want the option to include "Maximum Stock Quantity" (H) attribute in the requisition template (to display throughout the workflow) so that the storeroom manager/approvers can see the maximum quantity of stock that the facility should have on hand to inform the requested quantities.

Definition: Maximum stock calculated based on consumption and max stock parameters. This is quantified in dispensing units.

Note: we would like to change the MaxMonthsStock attribute name so not to imply months when it could mean periods. being done in

Looking forward
A potential extension point here. An implementor may want to define their own formula for calculating the maximum stock quantity attribute. Would need to be able to extend. We will create a new ticket to add the extension point. Or want to add in F into this calculation.

Acceptance Criteria
Verify that:

• the Maximum Stock Quantity (H) can be added and configured to a Requisition template for a specific program

• the attribute is calculated, but which calculation is based on user selection (or extension point), so there needs to be mechanism for the user to select from the following options (please check the following calculations) (instead of providing options, for now we will just implement the default):

  • "Default" option is calculated by P * MaxMonthsStock, where P = Average Consumption

  • "Normalized Consumption x 2" is calculated by N * 2

  • "Dispensed Quantity x 2" is calculated by (Need input from JSI or someone to know what 'dispensed quantity refers to)

• if attribute is selected for the template, the attribute is displayed in the defined order on the requisition form

• if attribute is not selected, it does not appear on the requisition form

• the attribute can be assigned a display order (currently moving up and down but at this time just needs an display order attribute)

• the display order is enforced in the requisition form

• user permissions are enforced

• API endpoints would allow for future extension on the calculation (similar to AMC )

Additional information on max months of stock
An implementor defines max months of stock for a product, in a program, for a facility type. It’s part of a Facility Type Approved Product aka Facility Approved Product. The idea is this: for a full-supply product at a regional hospital (facility type), you might want to approve them to be supplied with bottles of 500 pills of Ibuprofen 500mg (product’s pack) and that they can have up to 3 months of stock (using either consumption or target population as the basis for calculating per month needs). It’s per facility type as a district hospital may not be allowed to be supplied with the 500 pill bottles, but rather the 50 pill bottles, and they should only have 2 months of stock.