Recommendation Item Object

recommendations are the mechnism by which practitioners create prescriptions to suggest supplements to their patients once a recommendation is sent via email, it remains accessible to the patient in their store dashboard they may reorder these recommendations at any given time addtiionally the practitioner may specify a recurrening schedule to automatically ship refills at automatic intervals creating recommendations requires a patient id , so a patient record must be created prior to creating a recommendation { "item id" "ae483c8c 11b5 4aa7 871f 17080ab7cdb4", "sku" "sp907", "qty" 1, "note" "take 1 in the morning and 1 at bedtime ", "autoship interval" "30d", "fullfillment type" "1l", "availability" "in stock" "doctor id" 25, "location id" 123, "additional options" \[] } } core attributes item id uuid the main identifier for this object sku string the sku for the recommended item you can derive skus from the catalog product object qty integer the recommended quantity for this item default 1 note string a note specific to this item typically dosage instrunctions autoship interval string the interval at which to ship this item to the patient default once possible values are the literal string of once or a timespec comprised of an integer and a time unit the time unit is once of d for days, w for weeks or m for months example 30d this will ship the item every 30 days a valid credit card must be on file for this to succeed fulfillment type string this allows control over how the item will be delivered default automatic automatic the primary use case is in practice / on location fulfillment where the practitioner hands the item to the patient unless specifically set for in practice fulfillment, the system will pick the proper fulfillment options based on our internal item definitions accepted values lc one time local fulfillment use this code to fulfill a single purchase on location 1l first time local fulfillment use this code when add an autoship item but fulfill the initial item on location availability string read only read only the availability property reports the stock status for an item availability can also be checked prior to adding items to a recommendation, using the availability endpoint in stock the item is available for purchase at time of recommendation this is not a guarantee that the item will remain in stock by the time the recommendation is converted to a purchase, depending on the time between recommendation and purchase backordered this item is available purchase but it will be back ordered the item will ship once it's back in stock out of stock this item is currently not available for purchase doctor id integer the id of a doctor object associated with this item commonly only set when different than the doctor associated with the patient record location id integer the id of a location object associated with this item commonly only set when different than the location associated with the patient additional options array read only read only an array of supplemental item data such as a birthdate or patient name for tests