CommCare Supply uses out of the box handlers to facilitate stock reporting via SMS. This makes it easy to set up a system by which mobile workers can update stock information on product at their facility or location without needing any special additional hardware or software downloads than what they already have in a standard mobile device. In order to use SMS functionality users should follow the steps below:
Configure their domain to send and receive SMS messages
To learn about setting up an SMS Gateway, and configureing a domain for SMS see the following:
Configure basic CommCare Supply Settings - Locations, Products, Mobile Workers, Programs, etc.
See the CommCare Supply Overview for information on how to set up a domain to use CommCare Supply
Note: In order to submit stock reports via SMS, locations must be configured such that mobile workers are only associated with one at a time. In instances where mobile workers can view and edit location cases other than there own (such as in the case where users can locations descended from the one to which they are associated), users will by default only be able to report stock via SMS on their primary location.
Configure CommCare Supply actions and codes
To configure CommCare Supply specific SMS actions, navigate to SMS from the Setup tab in the top menu bar
Next, decide which actions should be supported via SMS.
When reporting stock, there are four possible actions:
| Action | Effect on stock | Example |
|---|---|---|
| Stock on Hand | This allows users to report the current stock on hand. Stock for any product reported on will automatically adjust to the value reported. If the stock on hand reported is less than the previous stock on hand for that product, the difference will be counted as consumption. If more the different will be tracked as an uncounted receipt but will not contribute to consumption. | 1) If previous SOH = 10 User reports SOH = 6 Consumption for that transaction = 4 2) If previous SOH = 10 User reports SOH = 14 Receipts for that transaction = 4 |
| Receipts | This action allows users to report on new stock received. The value reported by this transaction type is added to the previous stock on hand to calculate the current stock on hand | If previous SOH = 10 User reports receipt = 6 New SOH = 16 |
| Consumption | This action allows users to report how much of a product has been consumed or used The value reported by this transaction type is subtracted from the previous stock on hand to calculate the current stock on hand | If previous SOH = 10 User reports consumption = 6 New SOH = 4 |
| Stock Out | This action will set the Stock on Hand of whichever products are reported to 0 The value of the previous stock on hand will be calculated as consumption | If previous SOH = 10 User reports a Stock out New SOH = 0 Consumption for that transaction = 10 |