Nuira

Klaviyo flows and email campaigns for the current period: revenue, sends, open rate and click rate per flow and campaign. Use when asked about email or SMS performance, or which flow earns the most. Optional `from` and `to` (inclusive YYYY-MM-DD, both or neither, never after today) read another span instead of the default period — a named month, a week, two dates the operator gave.

get_email_performance

How the figures Nuira holds about this business have changed over time: each value, when it took effect, when it was superseded, where it came from, and the document and snippet it was read from. Use when asked what a figure used to be, when it changed, or why Nuira believes it.

get_fact_history

Typical margin and ROAS ranges for the commerce vertical this store's catalogue looks like. These are INDUSTRY REFERENCE values for comparison — they are NOT this brand's own figures and must never be reported as such. Use only to say whether one of the brand's own numbers is normal for its category. Returns available=false when the catalogue cannot be classified.

get_vertical_benchmarks

Stock levels per SKU, banded by how long the stock lasts at the current sales rate: out of stock, critical (under a week), at risk (one to two weeks) and healthy. Includes the SKUs closest to running out, with days of cover and units left. Use for any question about stock, restocking, or what will run out. The untracked count is SKUs whose stock Shopify does not track — they are in no band and are not a problem, they are simply uncounted.

get_inventory_health

Gross margin and margin-after-spend month by month, so a figure can be placed against its own history. Use when asked whether a margin is normal, when it changed, or how it compares with earlier periods.

get_margin_trend

Headline figures for the current period: revenue, ad spend, contribution and blended ROAS, each with the change against the previous period, plus new and returning customers, order count, sessions and conversion rate. Use this first for any question about overall performance, and for how many customers are new or returning. Optional `from` and `to` (inclusive YYYY-MM-DD, both or neither, never after today) read another span instead of the default period — a named month, a week, two dates the operator gave.

get_summary

Revenue, units and margin grouped by product category for the current period. Use when asked which category or product type drives the business. IMPORTANT: when suppressed is true, too few products carry a category for any split to be trustworthy — say the store's categories are mostly unset and give no breakdown, rather than reporting the rows. Optional `from` and `to` (inclusive YYYY-MM-DD, both or neither, never after today) read another span instead of the default period — a named month, a week, two dates the operator gave.

get_product_categories

Headline catalogue figures for the current period: product revenue, units sold, average order value, gross margin and how many SKUs are out of stock, each with the change against the previous period. Use first for any question about how the catalogue as a whole is doing. Gross margin comes back null when supplier costs are missing for some of the sales — say the margin is unknown rather than reporting it as zero. Optional `from` and `to` (inclusive YYYY-MM-DD, both or neither, never after today) read another span instead of the default period — a named month, a week, two dates the operator gave.

get_product_performance

The ranked recommendations currently open for this project, with expected value and confidence. Use when asked what to do, or what the biggest opportunity is.

list_recommendations

Revenue per hour of the local day, over the last 7 days. Use when the question is about time of day — which hours sell, when a spike happened within a day, when to schedule something. REVENUE ONLY: ad spend arrives as a date with no hour attached, so there is no hourly spend, margin or ROAS to report. If asked for those by hour, say the data does not exist at that resolution rather than dividing a daily figure across the day. Hours are the project's own local hours, and a day on which the clocks change has 23 or 24 buckets rather than 24.

get_revenue_by_hour

Shopify's own Total sales breakdown for the current period: gross sales, discounts, returns, net sales, shipping and taxes — the same lines, with the same definitions, as the merchant's Shopify admin. Use this whenever the question is about revenue in the merchant's own terms, or when they say our number disagrees with Shopify. IMPORTANT: `netSales` is Shopify's revenue figure and EXCLUDES tax and shipping; `orderTotal` is the order-total basis the rest of Nuira still reports and INCLUDES both, which is why the two differ — say so rather than picking one silently. Returns count in the period the refund was issued, not the period of the order it reverses. When complete is false, some orders in the range predate these figures and every line understates: say that instead of quoting the totals as final. Optional `from` and `to` (inclusive YYYY-MM-DD, both or neither, never after today) read another span instead of the default period — a named month, a week, two dates the operator gave.

get_sales_breakdown

The ten products that earned the most in the current period, with revenue, units, cost (what those units cost), grossProfit (revenue minus that cost), margin and the change against the previous period. Each row also carries revenueShare — its fraction of these ten products' revenue — and rankedRevenue is their combined total, so a breakdown by product needs no arithmetic of your own. Use when asked which products sell best, which are growing or slowing, which are most profitable, or for a breakdown of revenue by product. A null cost, grossProfit or margin means costs are missing for that product, not that it earns nothing — never treat a null as zero and never fill one in by subtracting. If truncated is true some orders had more line items than Shopify returns at once, so the split is partial — say so. Optional `from` and `to` (inclusive YYYY-MM-DD, both or neither, never after today) read another span instead of the default period — a named month, a week, two dates the operator gave.

get_top_products