assign_screen_layout_template
ChatGPTAssign a template to one authorized machine in the operator's private fleet. Can overwrite its current assignment and automatically queue the template's existing released version for that kiosk. Does not publish the draft. Replacing a different assignment requires replaceExistingAssignment.
create_category_screen_layout_template
ChatGPTCreate a new private, unpublished, unassigned category layout template when the user requests creation of a new template. Does not update a current layout. Inspection, preview, or a request for proposed changes does not authorize creation.
create_screen_layout_template
ChatGPTCreate a private unassigned draft with any supported kiosk layout using validated typed edits; retries reuse the user-scoped operation ID.
discover_screen_layout_catalog
ChatGPTFind catalog products, bundles and recipes visible to a machine by name, brand, tag or ID (query with entity products), or page through its catalog IDs, names, tags, brands and page definitions by sequence cursor.
edit_screen_layout_template
ChatGPTApply targeted, validated edits to a draft without dropping untouched content. dryRun returns the diff and catalogCheck without saving; saving requires the reviewed draftUpdatedAt.
generate_screen_layout_category_images
ChatGPTGenerate unbranded kiosk category artwork, upload it to screen-builder media, and return content hashes.
get_abandonment_analysis
ChatGPTGet reasons why customer sessions ended without a purchase, ranked by frequency.
get_ads_analytics
ChatGPTGet ad impressions, completion, exposure, creative/machine/placement breakdowns, trends, heatmap, and playback errors.
get_alarm_events
ChatGPTGet individual alarm events for machines in a date range. Shows when alarms were raised and cleared.
get_alarm_summary
ChatGPTGet alarm counts grouped by alarm type and machine for a date range.
get_cash_summary
ChatGPTGet cash summary, accounting counters, current denomination inventory since reset, and daily/hourly cash-flow history.
get_checkout_sessions
ChatGPTList individual checkout/payment sessions with payment type, status, amount, and purchased items.
get_customer_profile
ChatGPTGet aggregated shopper demographics: identified vs anonymous sessions, age-range distribution, spend buckets, purchase frequency, payment method by age, busiest hours by age and cross-machine shopper rate. Counts only, never individual shoppers.
get_dispense_reliability
ChatGPTGet dispense failure rates and duration percentiles (p50, p95, p99). Shows mechanical dispensing issues.
get_failure_rate_per_1k
ChatGPTGet failure rate normalized per 1000 transactions. Compares reliability across machines with different volumes.
get_financial_summary
ChatGPTGet current financial snapshot: live accounting totals (general, daily, partial counters) and current coin tube quantities.
get_fiscal_reporting
ChatGPTGet read-only ADE fiscal reporting history, in-flight state, schedule, and pending fiscal-eligible transactions.
get_fleet_action_plan
ChatGPTRead-only fleet triage: rank all machines by operational urgency with recommended manual follow-up. Does not create tickets, dispatch visits, restart machines, change prices, or mark stockouts as refilled.
get_inactive_machines
ChatGPTFind machines that have not recorded any sales activity within a configurable number of days.
get_lost_sales_estimate
ChatGPTEstimate revenue lost due to product stockouts based on sales velocity before the stockout.
get_machine_benchmarks
ChatGPTCompare selected machines against fleet averages. Shows percentile rankings and performance bands.
get_machine_diagnosis
ChatGPTRead-only root-cause analysis for selected machines. Combines sales, alarms, stockouts, and anomalies; does not restart machines, change prices, or modify stockout state.
get_machine_info
ChatGPTGet machine info for machine IDs or a customer/shop query. If machineIds is empty, query is used. If both are empty, all accessible machines are returned.
get_machine_last_activity
ChatGPTGet the timestamp of the last sale for each machine. Useful for spotting dormant machines.
get_machine_management_report
ChatGPTEvaluate how well each machine was managed over a period: stockout frequency and duration, lost sales, reactive vs preventive refills, operator visit cadence, and a verdict with reasons. Use to answer whether a machine was properly refilled and managed.
get_machine_overview
ChatGPTGet a health snapshot for one or more machines combining sales totals, alarm counts, active stockouts, and recent anomalies into a single overview.
get_machine_registrations
ChatGPTCount newly registered machines per month over the entire authorized selection, including inactive machines. Omit dateRange for all recorded history. Answers quante nuove macchine sono state registrate per mese without counting a truncated machine list.
get_merchandising_insights
ChatGPTGet product mix analysis: top sellers, slow movers, dead stock, and assortment recommendations.
get_module_mtbf
ChatGPTGet Mean Time Between Failures per alarm/module type. Key reliability metric for hardware.
get_module_mttr
ChatGPTGet Mean Time To Repair per alarm/module type. Measures how quickly issues are resolved.
get_money_ledger
ChatGPTGet the chronological money ledger for one machine: coins and notes in, change and refunds out, credit inserted and forfeited, operator test dispenses and accounting resets, each with its product and motor.
get_operator_sessions
ChatGPTList operator service visits: how the operator got in, how long they stayed, pages opened, what they changed (config, stock, mapping, hardware, money, integrations, fingerprints), errors or timeouts, and how the visit ended.
get_payment_reliability
ChatGPTGet payment failure rates and device availability metrics. Shows which payment methods are unreliable.
get_product_demand_funnel
ChatGPTGet product-level demand funnel: BROWSE → ADD_TO_CART → DISPENSE. Shows conversion per product.
get_refill_completeness
ChatGPTMeasure how thoroughly operators refilled machines during service visits.
get_restock_priorities
ChatGPTRead-only ranking of active stockouts by age and estimated lost sales. Helps plan restocking routes but does not mark stockouts as refilled or modify inventory.
get_revenue_opportunities
ChatGPTQuantify recoverable revenue from stockouts, declining trends, and inactive machines.
get_sales_anomalies
ChatGPTDetect unusual sales patterns using statistical analysis (z-score). Finds spikes, dips, and no-sales periods.
get_sales_geography
ChatGPTAggregate sales by geographic region: country, state, county, or town. Compare performance across locations.
get_sales_over_time
ChatGPTGet sales time-series data per machine for a date range. Shows daily or weekly revenue trends.
get_sales_over_time_grouped
ChatGPTGet sales time-series grouped by category, payment method, or product. Useful for trend comparisons across dimensions.
get_sales_summary
ChatGPTGet sales totals and per-machine sales for a date range. Amounts are in the stored units (typically cents).
get_sales_time_patterns
ChatGPTGet machine-local sales by hour, weekday, and weekday/hour heatmap. Revenue is included only for callers with a monetary sales role.
get_sales_transactions
ChatGPTGet raw sales transaction records for one or more machines in a date range.
get_screen_layout_deployment_status
ChatGPTCompare desired versions with kiosk-reported applied versions; sent is not applied.
get_screen_layout_image
ChatGPTRead existing screen-builder image pixels by SHA-256 hash to inspect reference artwork before generating or assigning images. Does not change drafts or deploy.
get_screen_layout_template
ChatGPTInspect one screen layout template or a machine's current template, including draft payload (or one page with pageId), assignments, and concurrency timestamp.
get_search_terms
ChatGPTGet shopper search intents with typed/scanned source, no-result searches, selected products and search-to-product conversion.
get_service_visit_history
ChatGPTGet service visit logs showing when operators visited machines and what operations they performed.
get_session_detail
ChatGPTGet one session's complete timeline: browse/suggestions, cart/search, language/accessibility, checkout/refunds, payment, dispense diagnostics, receipts, camera recording and coin-unlock presses.
get_session_flow_steps
ChatGPTGet how long customers spend in each phase of the purchase flow per day (browse, cart, age verification, payment, dispensing) with average, p75 and p99 durations.
get_session_funnel
ChatGPTGet customer conversion funnel: BROWSE → ADD_TO_CART → CHECKOUT → PAYMENT → DISPENSE with dropout rates.
get_session_insights
ChatGPTComprehensive session analysis combining funnel, abandonment, duration distribution, and age gate metrics.
get_session_outcomes
ChatGPTBreak sessions down by outcome and classified failure reason, stage/screen, payment, language and age, including cart/refund totals and per-machine conversion and timeout rates.
get_stock_levels
ChatGPTGet current per-motor stock levels: quantity, capacity, low-stock threshold, empty and low motors, and last sale/refill/stockout timestamps.
get_stockout_events
ChatGPTGet active and historical product stockout events. Shows which products ran out and for how long.
get_stockout_hidden_demand
ChatGPTEstimate unmet demand from out-of-stock products based on browsing patterns during stockouts.
get_substitution_matrix
ChatGPTFind product substitution patterns: what customers buy when their first choice is out of stock.
get_system_vitals
ChatGPTGet hardware health time-series: CPU, memory, disk, temperature, swap, network latency, and connectivity metrics.
get_top_products
ChatGPTGet the top-selling products by quantity or revenue for the selected machines and date range. Use category for food categories such as snacks, beverages, or coffee; use productType only for catalog types such as product, bundle, recipe, or service.
get_tube_quantities_history
ChatGPTGet coin tube level history over a date range. Shows how coin quantities changed over time for change-giving analysis.
get_unavailable_demand
ChatGPTGet demand for products that were out of stock, outside their sale time window or low, including reason/source, repeat frustration and recent attempts.
get_usage_insights
ChatGPTGet usage patterns: peak hours, peak days, payment method mix, and utilization metrics per machine.
get_voucher_events
ChatGPTGet voucher issue and redemption lifecycle events linked to user and checkout sessions.
list_screen_layout_templates
ChatGPTList accessible screen layout templates, optionally filtering to the template assigned to one machine.
list_screen_layout_versions
ChatGPTList immutable published versions and the current release.
list_sessions
ChatGPTRead stored session diagnostics for authorized machines: outcomes, drop-off stages, payment method, cart use, refunds and error flags. Filter by date and outcome; limit is optional. Session IDs allow timeline inspection. Shopper identities and cross-session user references are never returned. This tool cannot issue refunds or change sessions.
preview_screen_layout_template
ChatGPTValidate a draft and summarize it per page, with the diff against the released layout and catalogCheck (catalog IDs the assigned machines lack); includeHtml adds an HTML schematic. Exact rendering requires the console or kiosk.
publish_screen_layout_template
ChatGPTPublish a reviewed draft and queue replacement of kiosk layouts on its assigned machines within the signed-in operator's authorized private fleet. Requires explicit deployment approval and the reviewed draft timestamp. Queued or sent does not mean applied.
query_machine_logs
ChatGPTQuery structured machine logs with facets and cursor pagination, legacy text logs, or both for one accessible machine.
resolve_machines
ChatGPTResolve vending telemetry operator language such as machine name, shop name, or shop address to telemetry-safe machine identifiers. Do not use for calendar, email, support-ticket, consumer shopping, marketing, restart, price-change, mark-refilled, or other write-action requests.
rollback_screen_layout_template
ChatGPTRestore an immutable published version and queue replacement of kiosk layouts only on assigned machines within the signed-in operator's authorized private fleet. Requires explicit deployment approval; accepts no arbitrary destinations. Queued or sent does not mean applied.
trace_machine_logs
ChatGPTReconstruct one structured machine-log trace as matching entries and calculated spans.
update_current_screen_layout
ChatGPTExplicitly replace the draft of the template currently assigned to one machine; shared templates require confirmation.
update_screen_layout_template
ChatGPTExplicitly replace the draft of one named screen layout template; shared templates require confirmation.
upload_screen_layout_image
ChatGPTUpload attached or generated image bytes and return the screen-builder media hash.