Price the order
pinflower_quote_orderUse this when the buyer has chosen what to order and you have the details: it prices the order exactly as the checkout will charge it — the bouquet(s), add-ons, the shop's launch discount or the buyer's promo code, the delivery fee — and checks the time, without creating anything. Collect first: the bouquet(s) (bouquet_id from search; several bouquets of ONE florist with quantities in items); delivery or pickup; for delivery the street address with house number in Prague (or address_mode 'ask_recipient' when the courier should agree the address with the recipient — a surprise); the recipient's name and phone when someone else receives the flowers; the date and a time (one of the times pinflower_get_bouquet offers, or 'asap', or 'agree_with_recipient'); the buyer's name, e-mail and phone (+420…); an optional card message and note for the florist; and ask whether they have a promo code; ask whether it is a purchase for a company (IČO). Above 10 000 Kč the buyer's billing address is required. Read the breakdown and the terms link back to the buyer; after their yes call pinflower_create_order with the same arguments, terms_accepted=true and confirmed_total_czk. Call it again after any change.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | 'today', 'tomorrow' or YYYY-MM-DD. | |
| time | Yes | HH:MM from the offered times, 'asap', or 'agree_with_recipient' (the florist agrees the time with the recipient by phone; delivery only). | |
| unit | No | Apartment, floor, company at the door. | |
| buyer | Yes | ||
| items | No | Several bouquets from the SAME florist, with quantities. | |
| locale | No | ||
| address | No | Delivery to a known address: street and house number in Prague. | |
| company | No | Buying for a company — the invoice is issued to it. | |
| recipient | No | Who receives the flowers, when it is someone else than the buyer — the courier calls them; required when the address or the time is agreed with the recipient. | |
| bouquet_id | No | One bouquet (shortcut for items with a single line). | |
| fulfilment | No | ||
| promo_code | No | The buyer's promo code, if they have one — works for guests and signed-in buyers alike; the checkout checks it. | |
| address_mode | No | ask_recipient = the courier/florist agrees the address with the recipient by phone (a surprise); no address needed, delivery priced at the whole-city rate. | |
| card_message | No | ||
| courier_note | No | Bell name, entrance, gate code. | |
| florist_note | No | ||
| billing_address | No | The buyer's billing address — required by Czech tax rules when the order is over 10 000 Kč (unless buying for a company). | |
| marketing_opt_in | No | Only true if the buyer asked for news and offers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| discount | No | ||
| goods_czk | Yes | ||
| next_step | Yes | ||
| terms_url | Yes | ||
| total_czk | Yes | ||
| delivery_fee_czk | Yes |