Rohlik.cz

Showing 25 of 61 from the live probe.

• Get Announcements

  Retrieve active announcements for the user's region (delivery disruptions, weather warnings, technical issues, general notices). Returns a list of announcements with type (informative/positive/warning/negative), title, and content.

• Get Products Composition Batch

  Retrieve composition, nutritional, and allergen data for products by ID. Covers ingredients, nutrition, and allergens.

• Batch Search Products

  Search products by keyword, filters, or recommendations — up to 4 queries at once. Use for finding products, gifts, price comparisons, availability checks. Example queries: 'máte ovoce', 'nejlevnější jogurt', 'doporuč mi víno', 'doporuč mi něco na svačinu', 'dárek pro mamku', 'nejdražší', 'nejlevnější', 'bio potraviny pro děti', 'potraviny v akci bez palmového oleje', 'novinky', 'vegan'. IMPORTANT: `queries` is the ONLY top-level parameter. Each query object inside `queries` contains ALL search

• Get Discounted Items

  Get currently discounted items: by default the user's favorite products on sale first, followed by general deals. Not a search for a specific product by name.

• Get Product Details

  Fetch current details for multiple products at once by their IDs. Use after getting product IDs from order history, favorites, shopping lists, or recipe ingredients. Efficiently retrieves up-to-date pricing, availability, product info, and expected replenishment timing for products that are not currently available.

• Get Cart

  View everything currently in the shopping cart with prices, quantities, and total cost. Use for reviewing before checkout, checking what's already added, calculating totals, or identifying savings from current promotions.

• Update Cart Item

  Change the quantity of a product already in the cart. Use when the user wants more or fewer of an already-added item, or to reduce amounts before checkout. A quantity of 0 removes the item from the cart.

• Remove Cart Item

  Take a specific product out of the cart entirely. Use when the user changes their mind about an individual item or wants to remove something specific before ordering. For removing ALL items at once, use clear_cart instead — do NOT call this repeatedly to empty a cart.

• Clear Cart

  Empty the entire cart at once, removing all items. Use only when the user explicitly wants to remove ALL items — phrases like 'remove everything', 'empty my cart', 'start over', or 'clear the whole cart'. Do NOT use for partial cleanup or ambiguous requests like 'clean up my cart a bit'. Cannot be undone. For removing a single specific item, use remove_cart_item instead.

• Add Items To Cart

  Add products to the shopping cart for later checkout. Items added here are NOT part of any existing order until the customer completes checkout (optionally as a suborder of an upcoming order — see `suborder` in get_checkout). Use after finding products through search, from favorites, recipe ingredients, or shopping lists. Accepts multiple items at once for efficiency. Always confirm: item was added to cart, not yet to an order.

• Get User Addresses

  List saved delivery addresses for the user. Use when the user needs to select a delivery address during checkout, when discussing delivery options, or when the user wants to see their saved locations.

• Select Delivery Address Checkout

  Sets a delivery address for the current cart/checkout. Accepts address_id from get_user_addresses or search_address. Returns is_delivered_to indicating whether the address is within the delivery zone. If is_delivered_to is false, the address is outside the delivery area — use request_delivery_expansion to register for notifications when delivery becomes available there.

• Search Address

  Searches for addresses by text query using autocomplete. Returns matching addresses with their IDs, display names, coordinates, and is_delivered_to indicating whether the address is within the delivery zone. If is_delivered_to is false, the address is outside the delivery area — use request_delivery_expansion to register for notifications. If true, use select_delivery_address_checkout to set it.

• Request Delivery Expansion

  Submits an address to the delivery expansion waiting list so the user is notified when delivery becomes available at that address. Requires address_id from search_address or get_user_addresses. Optionally records an email or phone number for the notification.

• Get User Info

  Retrieve user's account profile (name, email, address) and Xtra membership details: active status and dates, trial vs paid, membership/subscription type, and remaining limits (free express deliveries, orders exempt from the minimum order value), plus available credits/vouchers.

• Fetch Orders

  Retrieve past/upcoming/cancelled orders with details (max 15 orders). When called without parameters, returns the 5 most recent orders, including ones not yet delivered. Parameter selection: TIME PERIODS ('last year', 'December') → use date_from + date_to (YYYY-MM-DD). RECENT COUNT ('last 3 orders') → use limit. SPECIFIC ORDER → use order_id. Set order_type to delivered/upcoming/both/cancelled ('cancelled' returns cancelled orders, which no other order_type includes; these carry basic info only

• Repeat Order

  Add all items from previous order to current cart. Use for repeat purchases. Needs order_id from order history.

• Analyze Spending

  Analyze user spending patterns. Returns total spend, order count, average order value, monthly breakdown, and trends. Use date_from/date_to for time periods (YYYY-MM-DD format).

• Get Typical Order

  Retrieves frequent items and builds an average order from user purchase history. When add_to_cart=true, adds a median-priced average users order to cart (SIDE EFFECT — do NOT call twice). When revert=true, removes those same quantities from the cart, deleting a cart line when the whole quantity is removed (SIDE EFFECT). ALWAYS use for user queries about their 'usual order' or item buying patterns.

• Update Order Courier Note

  Change the delivery note to the courier on an ALREADY PLACED upcoming order (e.g. a door code, floor, entrance, 'leave at reception'). Requires the order_id. REPLACES the note (max 250 characters); pass an empty string to clear. The order's current note is returned by fetch_orders. For an order still being created in checkout use update_courier_instructions_checkout.

• Get Alternative Timeslots

  Get timeslot availability for an existing upcoming order including both available and unavailable slots. Returns the scheduled (non-express) slots for all days, grouped per day, each with slotId, type, timeWindow, price, capacity and — for restricted slots — unavailabilityReason (the raw API value, e.g. EXPIRATION, SOLD_OUT_PRODUCT, SUPPLY_INTERRUPTION). 15-minute and zero-capacity slots are excluded unless the include_* flags are set. Use when rescheduling an existing upcoming order.

• Change Order Timeslot

  Changes the delivery timeslot for a confirmed upcoming order (NOT related to the shopping cart). Change delivery timeslot for existing order to any available day (not limited to same day). PREREQUISITE: call get_alternative_timeslots first to get valid slot_id and slot_type. Types: ON_TIME (scheduled window), VIRTUAL (flexible). Express slots are not offered for rescheduling. Match exact customer time - whole-hour slots differ from quarter-hour slots.

• Reserve Timeslot

  Temporarily reserve a delivery timeslot while the user keeps shopping. Accepts the numeric slot ID and slot type from a timeslot listing entry whose reservationEnabled field is true. Do not call this for reservationEnabled false or EXPRESS slots. This is not a checkout tool: do not call get_checkout, payment, or packaging tools for this request, and do not offer checkout as a fallback unless the user asks. FAPI still validates whether the current cart can be delivered in the selected slot.

• Unreserve Timeslot

  Cancel the user's active delivery-timeslot reservation, freeing the held slot. Takes no arguments and affects only the current user's reservation. This is not checkout and must not call get_checkout, payment, or packaging tools.

• Get All User Favorites

  See all products the user has marked as favorites. Use for quick reordering of beloved products, understanding taste preferences, or suggesting similar items the user might enjoy. Returns only a lightweight list (name, price, availability) without further details. If you need a product's description, composition, or other details, call get_product_details.