Gurkerl

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

Retrieve past/upcoming orders with details (max 15 orders). REQUIRED: provide at least one of order_id, limit, date_from, or date_to — calling without any parameter will fail. 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. For upcoming/both, also returns courier ETA, number, delay or delivery status. Returns full order details with warranty data (disabledData - items that can't be claimed, enabledData - items that can be claimed). Both enabledData and disabledData contain products that were in the order. selectedPackaging indicates order packaging type (REUSABLE_BAGS, PAPER_BAGS, FORCED_PAPER_BAGS). priceComposition includes reusableBagsDeposit and packagingFee. Use for reordering, claims, bags/packaging inquiries, shopping lists creation, spending tracking.

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.

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 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 currently discounted items. Returns the general list of items on sale, not a search for a specific product by name.

Fetch FAQ content for user's region (auto-detected). Returns markdown. Use for questions about store policies, loyalty programs, terms. Pass category slug (general, xtra_general, warranty, returnable_bags, terms_general, etc).

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, and product info when you already know which products you need.

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

Get recipe cooking instructions, ingredient list, and optional product mapping. Use after search to see prep steps and shopping requirements. Example queries: 'wie lang kochen', 'passende Beilage'. Mapping shows matching products with prices.

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.

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.

Retrieve user's account profile, Xtra and other club membership details, trial vs paid status, free express deliveries, minimum order value, available credits/vouchers and similar.

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

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.

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.

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.

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

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

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.

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.

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.

Find recipes by ingredients, meal type, or dietary needs. Semantic search. Example queries: 'Rezept mit Brokkoli und Erdäpfeln', 'Rezepte mit Schweinefleisch', 'was kann ich aus meiner letzten Bestellung kochen', 'ich hab Spinat im Kühlschrank', 'glutenfrei und laktosefrei', 'Leberdiät', 'Diabetiker', 'Vegetarier', 'Rezeptideen', 'einfaches Gericht', 'Rezepte für zwei Erwachsene'.

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.

Toggle suborder mode for the current checkout. When enabled, the cart is merged into the customer's upcoming order and reuses its delivery slot, address, payment method, and packaging at no extra delivery fee. Eligibility is exposed in `get_checkout` under `suborder.available`.

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.

Toggle printed delivery note preference.

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.

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 payment method to courier payment (CARD_ON_PLACE or CASH). Note: CASH is NOT available for DE and AT tenants. This sets courier payment only; it does not process online card payment.