Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt

Use this file to discover all available pages before exploring further.

Ask Viq handles plain-English questions across every business function in your ecommerce operation. The examples below show the literal question to type into the chat input, the Profile to select from the dropdown, and the shape of the answer Ask Viq returns — including which Nerve Centre cards and Vortex Mind reports back each response. None of the answers below are invented; every claim in a real Ask Viq response carries a citation you can click into.
Select your commerce-sources Profile before asking these questions. A commerce-sources Profile typically contains your commerce platform connector (Shopify, BigCommerce, or Adobe Commerce), Stripe, GA4, and Klaviyo — the four sources that together explain most revenue and product questions.
Which SKUs drove the most refunds last week?Ask Viq reads the refund rate card on your commerce connector, breaks it down by SKU for the last 7 days, and ranks the results by refund volume and refund revenue. The answer surfaces a table showing each SKU, its refund count, its refund value, and its refund rate as a percentage of orders — all cited to the refund_rate card on the active connector.If a Vortex Mind report has run during the period that flagged a quality-control or fulfilment issue behind the spike, Ask Viq cites that finding in the narrative and links through to the full report so you can see the evidence. A SKU-level refund spike almost always has one of three causes — a quality issue on a specific batch, a courier failure on a specific route, or a product description that does not match what arrived — and Ask Viq names which pattern fits the data.
What is my margin by product after landed costs?Ask Viq reads the SKU-level margin card from your commerce connector, layers in the landed-cost trace (wholesale cost, freight, duty, inbound handling), and computes realised margin per product for the period you specify. The answer opens with a headline gross margin figure, then ranks the top contributors to any compression quarter over quarter.For each SKU where margin has moved more than your configured threshold, Ask Viq surfaces the specific cause: a freight surcharge that started on a particular date, a supplier wholesale increase, or a discount-promotion calendar that continued to run on a SKU whose cost had already risen. The landed-cost trace is cited to the cost fields in your commerce platform or ERP connector, so you can verify the breakpoint date and the size of the move.
Set cost-of-goods on every SKU in your commerce platform. If cost is not set, Ask Viq falls back to retail price and flags the missing-cost SKUs in a data-quality footnote. Accurate landed cost data is what makes the margin answer actionable rather than directional.

Tips for asking effectively

A high-value Ask Viq question carries three pieces of information: the metric or entity you are asking about, the time window the data is from, and an optional comparator (versus last month, by region, ranked by performance). Combine the three and the question shape maps directly onto how Ask Viq’s substrate is organised.

Patterns that work

Diagnostic questions (“why did X move?”), time-windowed reads (“what was X last 7 days?”), comparative questions (“which of my campaigns has the highest ROAS?”), dashboard reads (“give me my current KPI summary”), and drill-downs on a prior answer (“now break that down by region”).

Patterns to avoid

Vague open-ended questions with no metric or time window, future projection requests (“what will my revenue be next quarter?”), opinion-asking questions (“should I cancel Klaviyo?”), and questions requiring a source not in the active Profile — Ask Viq will name the missing connector in its reply.