Knuspr

Call only when the user wants to change the delivery slot. The slot chosen in the timeslot widget is already applied.

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.

Create a recurring scheduled task that runs on a cron schedule and delivers notifications. Use when the user asks to be reminded, notified, or alerted about anything on a recurring basis. Be specific about what to check and when to notify.

Start a new empty shopping list with a custom name. Use before adding products to the list when user wants to create a new list.

Credit returnable bottles/crates to the current customer's order (NOT eco-bags). Each package needs a cargoId (from get_customer_returnables) and a count. IMPORTANT: 'count' is the desired final total of credited pieces for that type — it replaces the current value, it is not additive. If order_id is omitted the latest delivered order is used automatically. REQUIRES EXPLICIT CUSTOMER CONFIRMATION: before calling this tool, state the exact returnable types and final counts to the customer and get their confirmation — only call after the customer confirms. Guardrails: max 1 correction call per order. Check corrections_remaining from get_customer_returnables first — if 0, escalate to human instead. Orders older than 72 hours (3 days) are NOT eligible — escalate to human instead. In CZ, keg/sud returnables are NOT eligible for automated crediting — escalate to a human instead of retrying. For eco-bags use adjust_user_reusable_bags instead.

Delete an entire shopping list. Use when user wants to remove a list they no longer need.

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.

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.

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.

Get detailed timeslot availability for existing order including both available and unavailable slots with restriction reasons (EXPIRATION, SOLD_OUT_PRODUCT, SUPPLY_INTERRUPTION, etc). Returns all timeslots across all days with availability status and detailed restriction information. Use when rescheduling existing upcoming order.

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.

Check the current customer's returnable bottle/crate situation (NOT eco-bags). Returns all available returnable types (with cargoId, name, description, hintText, unitPrice, maxCount), what has already been credited for the user's latest delivered order, AND how many correction calls remain (corrections_used / corrections_remaining). If corrections_remaining == 0, do NOT call credit_customer_returnables — escalate to a human agent instead. Also returns order_too_old (true if the order was delivered more than 72 hours ago). If order_too_old is true, do NOT call credit_customer_returnables — escalate to a human agent instead. Use this before credit_customer_returnables. For eco-bags use get_user_reusable_bags_info.

Provide customers with ways to reach human support. Returns phone, email, WhatsApp contact details, operational hours, and is_currently_open indicating whether support is open right now.

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 lange 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). ALWAYS use for user queries about their 'usual order' or item buying patterns.

Scrape URL content to markdown. Supports actions (click, wait, scroll) for dynamic pages. Defaults to user's region homepage if no URL. Use for homepage/FAQ/terms/blog/career pages. For job listings use https://career.rohlik.group/group/jobs. Set include_images=true for image URLs (use  in markdown). Cached unless actions used; use force_refresh to bypass.

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 membership details, and available credits/vouchers.

Check customer's reusable bag count (how many they have at their address). Use for bag count issues (e.g. 'courier didn't scan my bags'). Returns bag tracking counts and deposit info. For deposit refund/money back requests, use cc workflow prompt tool with returnable bags workflow.

List all active scheduled tasks for the current user. Use when the user asks about their reminders, scheduled notifications, or wants to see what recurring alerts they have set up. Also call this before creating a new task to check if a similar one already exists.

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.

Removes items from a confirmed upcoming delivery order (NOT from the shopping cart). Batch remove or reduce quantities of multiple items from an upcoming order (before picking starts). DESTRUCTIVE - requires two-step confirmation flow: 1. INQUIRY → call with customer_confirmed=false → returns all item details and terms for review 2. CONFIRMED → call with customer_confirmed=true → executes removals sequentially with progress updates NEVER set customer_confirmed=true without prior explicit user confirmation. Fetch order details first to get order_field_id values. Set updated_amount to 0 to remove completely, or to a lower number to reduce quantity. Items are processed one at a time; individual failures do not stop the batch.

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.

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 Kartoffeln', 'Rezepte mit Schweinefleisch', 'was kann ich aus meiner letzten Bestellung kochen', 'ich habe 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`.

Process warranty claims for missing, damaged, or poor quality items. Credits customer account automatically. Each item needs inventoryId, claimedPieces, and reason. Reasons: missing_item, bad_quality, damaged_item, grocery_substitution, bad_expiration_date, bad_weight, pests, other. A required English `commentary` describing the issue is attached to the order for warehouse staff.