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. Takes: 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; the recipient's name and phone when someone else receives the flowers; the date and a time (one of the bouquet's offered times, or 'asap'); the buyer's name, e-mail and phone (+420…); an optional card message and note for the florist; the buyer's promo code if they have one. Above 10 000 Kč the buyer's billing address is required. Also on offer: address_mode 'ask_recipient' when the florist should agree the address with the recipient by phone — a surprise (the recipient's name and phone are then required); time 'agree_with_recipient' when the florist should agree the time with the recipient by phone (the recipient's name and phone are then required); add-ons per bouquet (listed in the bouquet details); recipient.care_reminder=true — the free (0 Kč) care reminder for the recipient, offered once when someone else receives the flowers; company details (IČO) for a purchase by a company. Returns the breakdown, the total, the terms link and an order_intent; it creates nothing. The total is valid for exactly these details.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | 'today', 'tomorrow' or YYYY-MM-DD. | |
| time | Yes | HH:MM from the offered times, or '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. | |
| 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 | true = 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 |