Guides
Shipping
Some shops ship instead of, or as well as, pickup. How to recognise them and what the assistant does differently.
Pickup is the default. A shop that ships says so on its offers, and such offers can be found at any distance.
#Recognise a shop that ships
fulfillment on an offer | Meaning |
|---|---|
shipping | The shop ships. There is no pickup. |
pickup_or_shipping | The buyer can choose. |
To search only shops that ship, pass filters.merchant_kind: "online_store" to product_search.
Warning
Never promise delivery or a courier for an offer that is not marked this way.
#What the assistant does
- Build the cart as usual.
- Ask the buyer for a delivery address, or whether to use their saved home address.
- Call
cart_set_shipping. It returns the shipping options for that address with their fees and latest delivery dates, and the items, shipping, tax and total. - Tell the buyer the shipping fee and the latest delivery date.
- Ask for approval and place the order as usual. Do not give a pickup code for a shipped order.
#Shipping options
option_code | Meaning |
|---|---|
standard | Standard shipping. |
express | Faster shipping. |
same_day | Same-day, where the shop offers it. |
pickup | The buyer collects at the shop, where the shop allows it. No address needed. |
Left out, the cheapest option for the address is selected; the answer lists all of them.
#Addresses that are refused
PO boxes, military addresses, states the shop does not ship to, and addresses outside the US are refused, with the field to fix.
#Approval
Any change to the address, recipient or option clears the buyer's approval of the cart. Ask again.