Cart
cart_set_shipping
Set the delivery address and shipping option for a cart from a shop that ships.
Only for shops that ship. It returns the shipping options for the address with their fees and latest delivery dates.
| Type | Write: changes a cart or an order |
| Needs a cart the buyer approved | No |
| Moves money | No |
Tool description (what the assistant sees)
Sets where a cart from a shop that ships goes: a delivery address (or saved_home: true), the recipient, and the shipping option. Returns the options for that address with their fees and latest delivery dates, the selected one, and the items, shipping, tax and total. option_code pickup picks collecting at the shop where the shop allows it, with no address. PO boxes, military addresses, states the shop does not ship to and addresses outside the US are refused with the field to fix. Any change clears the buyer's approval of the cart. Nothing is reserved or charged.#Parameters
| Name | Type | Required | Description |
|---|---|---|---|
cart_id | uuid | Yes | The cart. |
address | object | No | Where the shop ships the order: line1, city, state and zip, with an optional line2. Leave out with saved_home: true, or to change only the option on a cart that already has an address. |
saved_home | boolean | No | true ships to the buyer's saved home address. Do not send address with it. |
recipient | object | No | Who receives the order: name and phone. Leave out when it is the buyer; their name and verified phone are used. |
option_code | string | No | standard, express, same_day or pickup. Left out: the cheapest option for this address. pickup means the buyer collects at the shop, only where the shop allows it, and needs no address. |
#What to call next
Tell the buyer the shipping fee and the latest delivery date, then cart_approve.