Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To learn about setting up an SMS Gateway, and configureing configuring a domain for SMS see the following:

 

Gateway Options for SMS

SMS Basics

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 their 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.

...

ActionEffect on stockExample
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

 

To determine which of these actions to support in an SMS deployment, add or remove stock actions from the table on the SMS configuration page

Image Added

 

This table comes pre-populated with the above actions and keywords.  The SMS keywords determine which action an SMS reporter will use.  By using these keywords and referencing products using the product code, SMS users are able to squeeze as much information as they can into the 160 character SMS limit.  Users can add new keywords for this actions by clicking the "+ New Action" button below the table.  They can also modify existing action in the table or delete them using the red "Remove" buttons.  The formula for reporting via SMS is:

<SMS_keyword> <product_code> <value>

Given the keywords above, in order to report a stock on hand of 25 for condoms (let's assume the product code for condoms is co) a user would text

soh co 25

This format allows users to report on multiple products at once - to report a receipt of 25 condoms and 15 Depo Provera (product code dp) a user could text

r co 25 dp 15

Though users can report on multiple stocks per SMS, they can currently only report on one stock action per SMS (eg. users cannot yet report a receipt and a stock on hand in the same SMS).

Configuring Requisitions - Not yet fully supported - Coming soon