As a buyer/supplier/manager, I want to see delivery/pickup info in the 'New order' email
(Note: Likely needs #3449 done first to avoid increasing confusion of emails going out with incorrect date for manager-created orders.)
There are three different email templates that are sent when an order is created: one to the market manager, supplier, and buyer. Each of these users needs slightly different information, especially when it comes to fulfillment/delivery/pickup as a supplier might need to bring that order to the food hub on Thursday 10 am - 6 pm while the buyer is expecting to receive the order Friday 9-5.
Different delivery schedule configuration scenarios
It's important to understand that there are different delivery and pickup scenarios that can be set up in Local Orbit on a DeliverySchedule and therefore a Delivery:
- Suppliers deliver directly to buyer
- Suppliers drop at drop-point, market delivers to buyer
- Suppliers drop at drop-point, buyers come to the drop-point to pick up their orders
- Suppliers drop at drop-point, buyers come to different location to pick up their orders
- Market picks up from supplier's location, market delivers to buyer
- Market picks up from supplier's location, buyers come to the drop-point to pick up their orders
- Market picks up from supplier's location, buyers come to different location to pick up their orders
Asides
- The delivery_schedules form UI is so so so horrible and broken but I don't want to try to tackle that yet. The most notable borkage is that there is a "Market will pick up from supplier location." checkbox that basically invalidates whatever you've selected in the dropdown above it.
- Another wack thing in UI is delivery cycle day is on top but the rest of fulfillment and delivery/pickup date/times are on bottom of form making it hard to grok.
- In LO, the UI says Deliveries but it really means Deliveries/Pickups everwhere you see that.
- Right now the above scenarios are configurable per delivery, but local food logistics need to be more granular than that to support different exceptions to the rule. For example, Ohio Valley Food Connection has most of their suppliers drive their orders to the food hub, but there are a few big suppliers who won't do that so Ohio Valley goes to the farm to pick up those orders. In the future, we need to rethink how we define all the different pieces of the supply chain to accurately explain to suppliers, drivers, food hub coordinators, buyers when and where to expect order items.
Email changes I propose we add the following info just above the gray box on each of the three emails. It essential will match what is shown in the gray box on left of /admin/orders/XXXXX
Buyer
if delivering to buyer
"To be picked up at:"
else
"Will be delivered to:"
end
[Order address]
[Buyer delivery/pickup date and time]
Examples
- To be picked up at: 123 Food Hub Ave Honolulu, HI 96791 Tuesday June 26, 2018 between 9:00AM and 5:00PM
- Will be delivered to: 2335 Kalakaua Ave #L126 Honolulu, HI 96815 Tuesday June 26, 2018 between 9:00AM and 5:00PM
Supplier
if supplier delivers direct to buyer
"[Supplier org name] will deliver to [Buyer org name]"
[Buyer address]
elsif supplier drops to aggregation drop point
"[Supplier org name] will deliver to [Location label]"
[Drop-point address]
else
"Market will pick up from supplier's location"
end
[Supplier fulfillment date and time]
Examples
- Lokoea Farms will deliver to Fete: 2335 Kalakaua Ave #L126 Honolulu, HI 96815 Tuesday June 26, 2018 between 9:00AM and 5:00PM
- Lokoea Farms will deliver to Farm Link Regional Hub: 123 Food Hub Ave Honolulu, HI 96791 Tuesday June 26, 2018 between 9:00AM and 5:00PM
- Market will pick up from supplier's location: 789 Farm Rd Honolulu, HI 96815 Tuesday June 26, 2018 between 9:00AM and 5:00PM
Market Manager
if supplier delivers direct to buyer
"Suppliers will deliver to [Buyer org name]"
[Buyer address]
elsif supplier drops to aggregation drop point
"Suppliers will deliver to [Location label]"
[Drop-point address]
else
"Market will pick up from suppliers' locations"
end
[Supplier fulfillment date and time]
if supplier NOT delivering directly to buyer
if delivering to buyer
"[Buyer org name] will pick up at:"
else
"Market will deliver to [Buyer org name]:"
end
[Order address]
[Buyer delivery/pickup date and time]
end
Examples
- Suppliers will deliver to Farm Link Regional Hub: 123 Food Hub Ave Honolulu, HI 96791 Thursday June 28, 2018 between 9:00AM and 5:00PM Market will deliver to Fete: 2335 Kalakaua Ave #L126 Honolulu, HI 96815 Friday June 29, 2018 between 10:00AM and 4:00PM
- Market will pick up from suppliers' locations Thursday June 28, 2018 between 9:00AM and 5:00PM Ann Yoshida will pick up at 333 Ward Ave Honolulu, HI 96816 Saturday June 30, 2018 between 8:00AM and 12:00PM
[JIRA Import Details] Issue URL: https://localorbit.atlassian.net/browse/LO-1110 Reporter: Rob Barreca Issue Type: Story
