Record VVM status with physical stock count


Record VVM status with physical stock count (recording VVM status should be optional, not required)

As an immunization nurse, I want to record the VVM status for each lot of vaccines during my physical stock count so that I can have have an accurate record of the number of viable vaccines in my inventory and their approximate VVM stage rating.

Please check the related wiki page for background the features. In addition, background on VVM

Acceptance criteria:

  • VVM status field should be present on the Physical Count stock management page

  • VVM status is recorded as either "Stage 1" or "Stage 2" using a drop-down selection.

  • Dropdown should appear to the right of the "Current stock" number field

  • One VVM status is recorded per lot

  • VVM status field is not required to be filled in (optional)

, how do we indicate that this ticket only applies for the Vaccine program? Do we need design for how we would do 'configuration' or setup? Should we break this up into smaller tickets?

I suggest for this ticket we put the VVM field onto the form for all programs and all products. It's a small field, and it is always optional, so users can skip it for any products that do not have a VVM. As a next ticket after this, I suggest this ticket: "Configure VVM field availability per program or per product." We will need to ask Josh if this is something that might come with the GS1 data model (does it know which products have VVMs?). It might end up being a per-product configurable setting flag that is loaded in with the product list. OR if not, it could be a per-program configurable setting in RefData. If it's a per-program setting, we could expose it in the admin UI as a toggle.


Josh Zamor
June 8, 2017, 2:26 AM

I'm not clear on when the VVM status would later be reported on, if it would be at all. That is, here we record the VVM status of a lot in the physical inventory, however I wouldn't imagine that I'd see that VVM status later on the stock card. At least in VIMS we knew we didn't want to see the VVM status later, as the VVM status changes over time. Once it's recorded, and the SOP carried out with regard to disposing of no longer viable vials, the particular status of a lot in inventory may no longer be accurate.

If this is still the prevailing wisdom, the way I would encourage us to store VVM status, is either in a stock card's (when the stock card is one for a vaccine lot) extra data (would need to be added), or in a separate reporting table. Which one we choose might depend on what the reporting requirements are expected to be. Extra data is what we used for VIMS and should still be a safe choice if we're unsure of reporting requirements.

Mary Jo Kochendorfer
June 8, 2017, 3:26 PM

To clarify, there will not be a view of VVM within the stock card. Let's move forward with extraData.

Mary Jo Kochendorfer
June 8, 2017, 3:36 PM

For now, let's move forward with by product. However, will speak with to confirm and check about the GS1 piece.

Paweł Albecki
June 19, 2017, 11:58 AM

All works:
VVM status field is present in Physical inventory, we can choose either "Stage 1" or "Stage 2" using a drop-down selection, one status is recorded per lot, status field is not required to be filled in. After get stock card in response we have extraData with submitted vmm status present in line item with reason Balance adjustment.

Brandon Bowersox-Johnson
June 19, 2017, 10:03 PM

This is exciting. I have spoken with Josh about the GS1 piece, and there is nothing we need to do for that within this ticket itself.

I have created a next ticket for making the use of VVM configurable by product. I'm putting that on grooming for the coming sprint. Just FYI. CC



Paweł Nawrocki


Mary Jo Kochendorfer



Story Points


Time tracking


Time remaining


Epic Link




Fix versions