AIOD Discounts & Free Gift

Create the discount in the Shopify store for real, in TEST MODE, so it can be tried on the live storefront before it is opened to shoppers. shopify_discount_draft is the alternative that creates nothing in Shopify. Test mode is not a dry run. The discount is genuinely created in Shopify and Shopify evaluates it at checkout, but an email condition is injected so it matches only the store's test address, returned as `testModeEmail`. Real shoppers are unaffected by it. It stays that way until a person opens it in the app's editor and switches it to active — no tool in this server can make that switch, activate a discount, or delete one. `targetDiscountId` overwrites: passing one replaces that discount's stored rule in Shopify and re-creates it in test mode, so a discount that was active stops applying for real shoppers. An edit that would leave the rule unchanged is rejected instead. Takes the same sparse configuration as shopify_discount_draft and runs the same validation and cart simulation. If either fails, nothing is created or changed and `issues` names the paths at fault. Paths the template does not allow are dropped and listed in `ignoredPaths`. Covers the automatic discounts this app manages for the store. Discount codes and automatic discounts created directly in the Shopify admin, or by another app, are not included, and nothing here reads orders, products, or customers.

shopify_discount_publish

Read the schema for authoring a discount: the promotion templates, condition operators and action shapes a discount is validated against before it can be saved or created. The configuration passed to shopify_discount_draft and shopify_discount_publish uses these shapes. They are specific to this server — not Shopify's native discount API shapes — and are validated strictly, so a configuration that does not match them is rejected rather than coerced. Sections: 'contracts_1'/'contracts_2' list the promotion templates and each one's editable-path allowlist — tiered discount, buy X get Y, buy X at a fixed bundle price, volume bundle, free gift with purchase, combined multi-discount (product, shipping and gift rewards under one offer), specific product or collection, and a custom rule builder. 'conditions' covers the condition operators and field syntax: cart subtotal and quantity, products, variants and collections, customer tags and segments, market and location, purchase type, and active dates. 'actions_and_rules' covers the reward side: percentage and fixed-amount discounts, free and discounted gifts, shipping rewards, and tier ladders. 'schema' gives how the engine evaluates a rule and the overall structure, and 'examples_1'/'examples_2' give worked configurations. 'contracts_1' is the default section. 'core' describes how a sparse patch is merged onto a saved configuration: what an omitted path keeps, which paths are dropped for a template, and which fields are system-derived. Every section also returns `templates`: the complete list of valid `template` ids, which is the one value a configuration is rejected for outright rather than corrected. Static reference text: it reads no store data and returns no discounts.

shopify_discount_config_schema

Report what one discount earned over a date range: `orderCount`, `influencedRevenue`, `totalDiscountValue` (the margin given away), `averageOrderValue`, `currencyCode`, and a `revenueOverTime` series. Covers one discount id per call. Aggregates only: no orders, line items, or customer records. Store-wide figures are out of scope too — total sales, sessions, and discounts this app does not manage are not included. A new or recently edited discount showing zero orders is expected; attribution lags checkout briefly, and the response `note` says so when the count is zero.

shopify_discount_performance

Build a discount and return a prefilled editor link for the merchant to review and save — a BOGO or buy X get Y, a free gift with purchase, tiered or volume quantity breaks, a fixed bundle price, free shipping over a spend threshold, a percentage or fixed amount off a product or collection, or a scheduled seasonal sale. The same call proposes changes to an existing discount when `targetDiscountId` is set — raising a threshold, extending an end date, swapping the gift, re-shaping a tier ladder. The draft is stored in the app, not in Shopify. No Shopify discount exists and no shopper can receive one until the merchant opens the returned `url` and saves it there. shopify_discount_publish creates a Shopify discount. The merged rule is validated and cart-simulated before it is stored. A rejection comes back as `issues` naming the exact paths at fault, and nothing is stored. Paths the template does not allow are dropped and listed in `ignoredPaths`; an edit with nothing editable left is rejected.

shopify_discount_draft

List the discounts and promotions running on this Shopify store — percentage and fixed-amount off, BOGO and buy X get Y, free gift with purchase, tiered and volume quantity breaks, wholesale and bulk pricing, product bundles and fixed combo prices, free shipping and spend thresholds, upsells, and scheduled seasonal sales. Returns one row per discount: `id`, `title`, `status` (active, draft, test mode), `discountType`, `template`, and an `editUrl` deep link into the Shopify admin. It resolves a discount named in words — "my summer BOGO", "the free gift offer", "the 10% off tees", "the Black Friday sale" — to the `id` every other tool here is keyed by. It gives setup and status only: shopify_discount_performance has the revenue figures and shopify_discount_get has the full rule. Covers the automatic discounts this app manages for the store. Discount codes and automatic discounts created directly in the Shopify admin, or by another app, are not included, and nothing here reads orders, products, or customers.

shopify_discount_find

Read how one discount is set up: which products, variants or collections it applies to, the cart subtotal or item quantity it requires, the customer tags, segments, markets and locations it is limited to, the purchase type, its start and end dates, and what it actually gives — a percentage or fixed amount off, a free gift, free or discounted shipping, or a tier ladder. Also returns how it combines with other Shopify discounts. The conditions it returns are the ones a cart has to satisfy for the discount to apply at checkout. shopify_discount_draft and shopify_discount_publish merge their sparse patch onto this saved configuration. Takes an `id` from shopify_discount_find. Returns configuration only — no revenue, orders, or customer data.

shopify_discount_get

Search the product documentation for running discounts on this store, or read one page of it in full. This covers the setup and behaviour questions around a promotion: installing and enabling the app in the theme, plans and pricing, how discounts stack and combine with Shopify discount codes and other automatic discounts, behaviour in the cart, at checkout and in Shopify POS, scheduling a sale, the storefront widgets (progress bar, gift drawer, bundle and upsell widgets, strike-through and sale pricing on product and collection pages), and troubleshooting a discount that is not showing or not applying on the storefront. Configuration field shapes are not here — they come from shopify_discount_config_schema — and the store's own discounts come from shopify_discount_find. This tool reads no store data. `query` searches and returns ranked page paths with excerpts; `page` (from those results, with optional `section`) reads the full text.

shopify_discount_docs_search