Gotovo

Search Gotovo restaurants by name in Ukrainian or Latin (e.g. 'Квадрат', 'юров паб', 'Yurov pub'). Use when the user names a specific place.

find_restaurants

Get Gotovo restaurant details: address, hours, order types, contacts. Use restaurant_id from find/search tools.

get_restaurant

Fetch authoritative Gotovo menu: categories[] (unique category names) and flat dishes[] each with category. When the user asks by category («горілка», «піца», «супи», «десерти», alcohol, etc.), filter dishes by dish.category (and use categories[] to see what exists) — do NOT search for the category word only in name/description (e.g. Nemiroff is under category Горілка). If a dish has variations, those ARE the orderable options — never quote plain dish.price. Prefer query with restaurant name (UA or Latin). If ambiguous, call again with restaurant_id. Use likes/dislikes/score for reviews; never invent dishes or prices.

get_restaurant_menu

Validate selected dishes and calculate totals on Gotovo Rails. Does NOT create an order or charge money. If a dish has variations, those variations are the only orderable items — never use plain dish.price. Every items[] entry MUST include variation_id (number or null). weight_flag dishes (no variations): price is for reference weight; line total = (price/weight)*quantity; quantity is in measure units (g/kg/…), not portions, and must be >= min_order. Example weight dish: {dish_id:77, variation_id:null, quantity:300}. Example variation: {dish_id:2554, variation_id:1254, quantity:1}. Never automatically select the first or cheapest variation. Different variations of the same dish must be separate items. Returns checkout_url for Gotovo checkout with prefilled items. After a valid preview, tell the user to tap the Order button in the widget (or open checkout_url).

create_order_preview

Find Gotovo restaurants near a location. Use for prompts like 'де поїсти поруч', 'піца біля мене', 'ресторани в центрі Вінниці'. Provide either coordinates or location_name. Optional query filters by dish/restaurant keyword (e.g. піца).

search_local_restaurants

Find Gotovo restaurants along a driving route (e.g. Київ → Львів). range_km is max meters off the road / 1000 (lateral), NOT trip length. If the user says «строго по дорозі», «прямо на трасі», «без зʼїзду», «без відхилення» — ALWAYS pass range_km: 0.2. Tight corridor → 1; normal roadside stops → 1–5; default 10. When presenting results: say distance_to_route_m as «X м від маршруту»; distance_along_route_km is progress from start («на ~286 км»), never call it deviation.

search_route_restaurants