Rohlik

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.

get_user_info

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_announcements

Get complete checkout form data with all sections and validation status. Returns address, payment, timeslot, packaging, cart total, card-hold total (amount blocked on card for online payment, slightly higher than the basket estimate when weighted items are present), validation warnings, and (when an upcoming order exists) a `suborder` block describing whether the cart can be merged into it. Use to review checkout before finalizing.

get_checkout

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_discounted_items

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.

get_all_user_favorites

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 — no items or warranty data). For upcoming/both, also returns the delivery slot (deliverySlot.timeRange), delay or delivery status (deliveryAnnouncements with type/isDelayed/content), the order's current courier note (deliveryNote) and, for internal Maia callers, courierInfo (courierName, courierPhone, courierPhoneSpelled — the phone as spoken words in the tenant language, courierPhoneSpelledEn — the same in English; voice agents read verbatim the one matching the language the conversation is currently in). Delivered orders carry warrantyInfo with warranty data (disabledData - items that can't be claimed, enabledData - items that can be claimed); both lists together contain all products that were in the order. selectedPackaging indicates order packaging type (REUSABLE_BAGS, PAPER_BAGS, FORCED_PAPER_BAGS, AUTOMATICALLY_RENEWED_REUSABLE_BAGS): FORCED_PAPER_BAGS = reusable bags were selected but could not be provided for that delivery; AUTOMATICALLY_RENEWED_REUSABLE_BAGS = reusable bags restored after a forced-paper order. priceComposition includes reusableBagsDeposit and packagingFee. Use for reordering, claims, bags/packaging inquiries, shopping lists creation, spending tracking.

fetch_orders

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

get_products_composition_batch

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_product_details

Get recipe cooking instructions, ingredient list, and optional product mapping. Use after search to see prep steps and shopping requirements. Example queries: 'jak dlouho vařit', 'vhodná příloha'. Mapping shows matching products with prices.

get_recipe_detail

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.

get_user_addresses

Get shopping list details with products, prices, and stock. Use after preview to see list contents.

get_user_shopping_list_detail

See all user's saved shopping lists with names and item counts. Use as first step when working with shopping lists - shows what lists exist before viewing details or adding items.

get_user_shopping_lists_preview

Builds a representative "typical" order from the user's recent delivered orders: frequently bought items with median quantities, sized to the median value of those orders (floored at the minimum order amount). With add_to_cart=true it also adds the typical-order quantities to the cart (only the difference from what the cart already holds; repeating the call adds nothing more). With revert=true it removes those quantities again, deleting a cart line when its whole quantity is removed. The two flags cannot be combined.

get_typical_order

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.

request_delivery_expansion

Use this when the user is ready to continue checkout on the Rohlik website. Renders a ChatGPT widget with the tenant's external checkout link and takes no arguments.

open_web_checkout

Cancel the user's active delivery-timeslot reservation, freeing the held slot. Takes no arguments and affects only the current user's reservation. Independent of checkout: it changes no checkout, payment, or packaging state.

unreserve_timeslot

Remove one product from the cart entirely, by product ID. Removing every item at once is clear_cart.

remove_cart_item

Remove one or more products from an existing shopping list — up to 15 at once (extra IDs are dropped and reported in `warning`). Pass all product IDs in the `product_ids` array. Use when user wants to delete specific items from their list.

remove_products_from_shopping_list

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

repeat_order

Temporarily reserve a delivery timeslot while the user keeps shopping. Accepts the numeric slot ID and slot type of a timeslot listing entry whose reservationEnabled field is true; EXPRESS slots and entries with reservationEnabled false cannot be reserved. Independent of checkout: it reads and changes no checkout, payment, or packaging state. FAPI still validates whether the current cart can be delivered in the selected slot.

reserve_timeslot

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.

search_address

Changes the checkout delivery slot of a new order. A slot chosen in the timeslot widget is already applied server-side. Whole-hour slots (10:00-11:00) and quarter-hour slots (10:00-10:15) are distinct entries.

change_timeslot_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.

select_delivery_address_checkout

Set the printed delivery note (receipt) preference for the current checkout to the given value. Requires a payment method to be already selected in checkout.

toggle_delivery_note_checkout

Use this when the user asks to view or review their current shopping cart in ChatGPT. Reads the live cart server-side and takes no arguments.

display_cart

Use this when the user is choosing a delivery time for checkout in ChatGPT. Requires a selected delivery address and reads checkout state server-side. Shows 1-hour slots only for the given day (timeslots_day, default today).

display_delivery_timeslots

Use this when the user searches for or asks to see grocery products in the Rohlik catalog. Searches by keyword and displays the matching products as an interactive widget with live prices, availability, images, and add-to-cart. Accepts optional validated catalog filters (e.g. bio, gluten-free). Shows up to 12 matches.

display_products

Submit a product wish from a customer who is missing a product in the Rohlik/Knuspr range. Posts the suggestion to the Rohlik product suggestions system for product-team visibility. WHEN TO CALL: - Customer explicitly asks to stock a product that is not yet in the catalogue ("could you add X to your range?") → call right away. - A specific product still isn't found after retrying the search with different wording (brand dropped, generic product name, local tenant language) → offer the customer to forward the request to the assortment team; call this tool if the customer agrees. NOT THIS TOOL: sold-out or temporarily unavailable products (they ARE in the assortment). CONSENT: - Ask whether the customer agrees to be contacted by e-mail about this specific wish before submitting it. - Pass consent_given=True only after an explicit yes in this conversation. - If the customer declines or does not answer, submit the wish with consent_given=False; declining does not block the wish.

submit_product_wish

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.

update_cart_item

Update the courier payment method (CARD_ON_PLACE or CASH) and/or toggle applying account credits to the order (use_credits). At least one of the two parameters is required. Note: CASH is NOT available for DE and AT tenants. This sets courier payment only; it does not process online card payment.

update_payment_method_checkout

Find recipes by ingredients, meal type, or dietary needs. Semantic search. Example queries: 'recept z brokolice a brambor', 'recepty z vepřového masa', 'co mohu uvařit z produktů z mé poslední objednávky', 'mám v lednici špenát', 'bezlepkové a bez laktózy', 'jaterní dieta', 'diabetik', 'vegetarián', 'tip na recepty', 'jednoduché jídlo', 'recepty pro dva dospělé'.