> ## 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.

# Shopline on Vortex IQ

> Monitor store performance, find catalogue and operational problems, and safely apply approved changes to Shopline.

Monitor store performance, find catalogue and operational problems, and safely apply approved changes to Shopline.

[Connect or manage this source](https://app.vortexiq.ai/workbench/settings/sources) · [View setup guide](/integrations/shopline) · [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=shopline)

<CardGroup cols={5}>
  <Card title="54">
    performance signals
  </Card>

  <Card title="8">
    automated checks
  </Card>

  <Card title="1">
    prepared fixes
  </Card>

  <Card title="Ready to build yours">
    workflows
  </Card>

  <Card title="7">
    API operations
  </Card>
</CardGroup>

<Tabs>
  <Tab title="Overview">
    ### What you can achieve

    Capabilities are grouped around merchant outcomes, not API terminology.

    <CardGroup cols={2}>
      <Card title="Protect revenue">
        Find failures, leaks and risks before they cost sales.
      </Card>

      <Card title="Run operations">
        Monitor orders, fulfilment, delivery and settlement.
      </Card>

      <Card title="Grow revenue">
        Improve discovery, conversion, campaigns and repeat purchase.
      </Card>

      <Card title="Customer experience">
        Find storefront, speed, accessibility and journey problems.
      </Card>

      <Card title="Catalogue quality">
        Identify missing, inconsistent or outdated product data.
      </Card>
    </CardGroup>

    ### From connection to verified outcome

    The controlled sequence every capability follows. Nothing changes a connected system without the approval step.

    <Steps>
      <Step title="Connect">
        Authorise the source. Scopes are shown before access is granted.
      </Step>

      <Step title="Monitor">
        Watch the signals against your own baselines, not universal defaults.
      </Step>

      <Step title="Detect">
        Run checks and gather evidence specific to your store.
      </Step>

      <Step title="Recommend">
        Explain what happened, why it matters and the proposed action.
      </Step>

      <Step title="Approve">
        You review scope, risk and reversibility before anything changes.
      </Step>

      <Step title="Execute">
        Apply through governed connector operations.
      </Step>

      <Step title="Verify">
        Confirm the intended result and keep the receipt.
      </Step>
    </Steps>

    No changes are made without the configured approval policy. Read-only operations do not modify the connected system; schedules, access scopes, API usage and data handling remain governed by Vortex IQ controls.
  </Tab>

  <Tab title="Monitor (54)">
    ### Monitor performance

    54 performance signals. Open an outcome to see its signals and how each one alerts. Read-only operations do not modify the connected system.

    <AccordionGroup>
      <Accordion title="Run operations (16 signals)">
        | Signal                         | Alert behaviour    | What it tracks                                                                                                                                |
        | ------------------------------ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
        | **AOV by Country**             | Watch only         | AOV by Country.                                                                                                                               |
        | **Auth Token Health**          | Merchant rule      | Shopline JWTs are long-lived (Phillipstoys' is good until 2027-07) but silent expiry breaks order downloads. Surface before merchants notice. |
        | **Average Order Value**        | Alert band 0 / -5  | Description pending editorial review; the signal is live.                                                                                     |
        | **Avg Time to Fulfil (hrs)**   | Merchant rule      | From paid timestamp to fulfilled , surfaces 3PL/warehouse drag before SLAs break.                                                             |
        | **Fulfillment Rate**           | Alert band 95 / 90 | Orders fully fulfilled / total orders. \<90% means the merchant is breaking shipping promises.                                                |
        | **Fulfillment Rate Over Time** | Watch only         | Description pending editorial review; the signal is live.                                                                                     |
        | **Fulfillment Status Mix**     | Watch only         | Fulfillment Status Mix, shown by share.                                                                                                       |
        | **Inventory Distribution**     | Watch only         | Inventory Distribution, compared across items.                                                                                                |
        | **New Customers**              | Watch only         | Description pending editorial review; the signal is live.                                                                                     |
        | **OOS Spike Alert**            | Alert band 0 / 5   | Anomalous OOS spike , usually a misconfigured sync, hold, or sudden demand event. Pair with the cross-channel ad-spend card.                  |
        | **Orders by Country**          | Watch only         | Orders by Country.                                                                                                                            |
        | **Top Cities by Orders**       | Watch only         | Top Cities by Orders.                                                                                                                         |
        | **Top Customers by Spend**     | Watch only         | Top Customers by Spend.                                                                                                                       |
        | **Total Orders**               | Alert band 0 / -10 | Description pending editorial review; the signal is live.                                                                                     |
        | **Unfulfilled Orders**         | Alert band 10 / 50 | Paid orders with fulfillment\_status != fulfilled. The number ops should clear by EOD.                                                        |
        | **Unique Customers**           | Watch only         | Description pending editorial review; the signal is live.                                                                                     |
      </Accordion>

      <Accordion title="Grow revenue (16 signals)">
        | Signal                            | Alert behaviour    | What it tracks                                                                                                                                            |
        | --------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
        | **Coupon Usage Rate**             | Alert band 20 / 40 | Share of orders where the customer entered a coupon code, from order.promotion\_items\[].coupon\_code - distinct from Discount % of Revenue's dollar-weig |
        | **Customer Spend Segments**       | Watch only         | Customers grouped by lifetime spend bucket. Underpins lookalike + VIP campaigns.                                                                          |
        | **Orders Over Time**              | Alert band 0 / -10 | Description pending editorial review; the signal is live.                                                                                                 |
        | **Products Missing Description**  | Alert band 5 / 20  | Products with empty body\_html. Free conversion lift on the table.                                                                                        |
        | **Repeat Customer Rate**          | Alert band 25 / 10 | Customers with >1 order in 90D. A retention barometer , DTC dies when this drops.                                                                         |
        | **Revenue Drop Alert**            | Alert band 0 / -5  | Trips when last-24h revenue lags the prior-7-day baseline by >25%. The canary for a broken checkout / app / pixel.                                        |
        | **Revenue Over Time**             | Alert band 0 / -5  | Description pending editorial review; the signal is live.                                                                                                 |
        | **Revenue by Channel**            | Watch only         | Storefront vs social-commerce vs POS. Single-channel today; gains depth when multi-channel Pattern A lands.                                               |
        | **Shipping Cost as % of Revenue** | Alert band 5 / 15  | Description pending editorial review; the signal is live.                                                                                                 |
        | **Slow-Moving Products**          | Watch only         | Bottom decile by revenue. Candidates for sunset / clearance / repositioning.                                                                              |
        | **Top Products by Revenue**       | Watch only         | Top Products by Revenue.                                                                                                                                  |
        | **Total Discount Used**           | Watch only         | Description pending editorial review; the signal is live.                                                                                                 |
        | **Total Revenue**                 | Alert band 0 / -5  | Headline gross revenue. The single number the founder checks at 9am Monday.                                                                               |
        | **Total Shipping Revenue**        | Watch only         | Description pending editorial review; the signal is live.                                                                                                 |
        | **Total Tax Collected**           | Watch only         | Description pending editorial review; the signal is live.                                                                                                 |
        | **Zero/Negative Stock Variants**  | Alert band 0 / 5   | OOS variants. Pair with the cross-channel ad-spend card to find the real revenue blockers.                                                                |
      </Accordion>

      <Accordion title="Protect revenue (15 signals)">
        | Signal                                 | Alert behaviour    | What it tracks                                                                                                        |
        | -------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------- |
        | **Active Ads on Out-of-Stock SKUs**    | Merchant rule      | Spend burning on SKUs that can't convert. The single highest-ROI 'pause' recommendation in the AIOS.                  |
        | **Cancellation Rate**                  | Alert band 1 / 3   | Description pending editorial review; the signal is live.                                                             |
        | **Catalogue Drift vs Amazon**          | Merchant rule      | SKUs that diverge between Shopline and Amazon. Brand-trust killer + de-listing risk under MAP policies.               |
        | **Days-of-Cover by SKU**               | Merchant rule      | On-hand / 30D velocity per SKU. Surfaces stockout risk before it bites.                                               |
        | **Discount % of Revenue**              | Alert band 20 / 40 | Discount leakage as a share of revenue. Persistent >25% means the business depends on promos.                         |
        | **Email-Attributed Revenue Share**     | Alert band 15 / 8  | Share of Shopline revenue driven by lifecycle email. \<15% in mature brands = retention spend underperforming.        |
        | **Low-Stock SKUs (\<10 units)**        | Alert band 0 / 5   | Description pending editorial review; the signal is live.                                                             |
        | **Marketplace Revenue Share (Amazon)** | Merchant rule      | DTC vs marketplace revenue split. >70% Amazon = platform-dependency risk; \<10% = under-utilising marketplace reach.  |
        | **Products Missing SEO Meta**          | Alert band 10 / 30 | Products with an empty SEO title or SEO description. Organic-traffic leak distinct from Products Missing Description. |
        | **Refund Rate**                        | Alert band 2 / 5   | Refunded orders / total orders. Persistent >5% signals product quality or expectation mismatch.                       |
        | **Refund Value**                       | Watch only         | Description pending editorial review; the signal is live.                                                             |
        | **Refund-Rate Spike Alert**            | Alert band 2 / 5   | Refund-rate anomaly. Catches batch-quality issues, broken sizing, or coupon misuse before the support inbox does.     |
        | **Refunds Over Time**                  | Watch only         | Description pending editorial review; the signal is live.                                                             |
        | **Revenue at Risk (live incident)**    | Merchant rule      | Live \$/min loss while a monitoring incident is open , the COO's hot-button number during outages.                    |
        | **Shopline Health Score**              | Alert band 95 / 80 | Composite of refund rate × fulfillment rate × OOS count × 30D revenue trend × auth-token health.                      |
      </Accordion>

      <Accordion title="Customer experience (4 signals)">
        | Signal                     | Alert behaviour | What it tracks                                                        |
        | -------------------------- | --------------- | --------------------------------------------------------------------- |
        | **Avg Time-to-Paid (hrs)** | Merchant rule   | Created → paid latency , flags broken authorise-only flows + COD lag. |
        | **Financial Status Mix**   | Watch only      | Financial Status Mix, compared across items.                          |
        | **Partially-Paid Orders**  | Merchant rule   | Description pending editorial review; the signal is live.             |
        | **Payment Methods**        | Watch only      | Payment Methods, shown by share.                                      |
      </Accordion>

      <Accordion title="Catalogue quality (3 signals)">
        | Signal                 | Alert behaviour    | What it tracks                                                                  |
        | ---------------------- | ------------------ | ------------------------------------------------------------------------------- |
        | **Product Status Mix** | Watch only         | Product Status Mix, shown by share.                                             |
        | **Products by Vendor** | Watch only         | Products by Vendor.                                                             |
        | **SKU Coverage**       | Alert band 80 / 50 | Variants with a populated SKU. Below 95% breaks marketplace + 3PL integrations. |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Audit (8)">
    ### Audit risks and opportunities

    A fix status appears only where the action, inputs, approval, verification and recovery controls are mapped. Candidate remediations are never executable. Open a check for the detail.

    <AccordionGroup>
      <Accordion title="Fulfillment rate below 90%">
        **Severity** critical · **Outcome** Protect revenue · **Fix status** Candidate remediation

        When more than 1 order in 10 is failing to reach fulfilment, customers have paid for goods that are not shipping on time; refunds, chargebacks and support load follow quickly.

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `ECOM-FULFIL-001`
      </Accordion>

      <Accordion title="Cancellation rate above 10% over 30d">
        **Severity** high · **Outcome** Protect revenue · **Fix status** Report only

        More than 1 in 10 orders is being cancelled. Unlike a return, a cancellation often means the customer changed their mind or hit a problem before the order even shipped, checkout friction, a payment failure, an unexpectedly long delivery estimate, which usually points to a fixable step in the order f

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `ECOM-CANCEL-001`
      </Accordion>

      <Accordion title="Refund rate above 5% over 30d">
        **Severity** high · **Outcome** Protect revenue · **Fix status** Candidate remediation

        More than 1 in 20 orders is being refunded. Beyond the direct revenue loss, this rate also carries payment-cost consequences, processors and payment gateways watch refund and dispute rates, and a sustained high rate can affect processing terms independent of the lost sale itself.

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `ECOM-REFUND-001`
      </Accordion>

      <Accordion title="Discount > 20% of revenue (margin erosion)">
        **Severity** medium · **Outcome** Grow revenue · **Fix status** Report only

        Discounting above roughly 20 percent of revenue erodes margin quickly, often without lifting volume enough to pay for itself, and trains customers to wait for codes.

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `ECOM-DISCOUNT-001`
      </Accordion>

      <Accordion title="Products with zero or negative stock">
        **Severity** medium · **Outcome** Grow revenue · **Fix status** Candidate remediation

        Every product at zero or negative stock is a page a customer can still find, still add to cart in some storefront setups, and still be disappointed by. Zero-stock listings that stay live also keep spending any ad budget or SEO ranking pointed at them, driving traffic to a product nobody can actually

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `ECOM-INVENTORY-001`
      </Accordion>

      <Accordion title="Repeat-customer rate below 20%">
        **Severity** medium · **Outcome** Grow revenue · **Fix status** Candidate remediation

        Fewer than 1 in 5 customers comes back for a second order. Acquiring a first-time customer is almost always the most expensive part of earning their business, so a repeat rate this low means the store is paying that acquisition cost repeatedly instead of earning a second (cheaper) sale from customer

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `ECOM-CUSTOMER-001`
      </Accordion>

      <Accordion title="Products missing SEO title">
        **Severity** low · **Outcome** Grow revenue · **Fix status** Prepared fix

        Products without SEO titles compete in search under their bare product names; pages that could rank for buying keywords stay invisible.

        A prepared, approval-gated fix exists: the proposed change, affected records, risk, reversibility and verification are shown before execution.

        Reference: `ECOM-CATALOGUE-002`
      </Accordion>

      <Accordion title="Products missing description">
        **Severity** low · **Outcome** Grow revenue · **Fix status** Candidate remediation

        A product with no description gives a shopper nothing to evaluate beyond a photo and a price. It also gives search engines almost nothing to index, so these products are simultaneously converting worse for visitors who do find them and ranking worse in organic search for anyone who has not.

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `ECOM-CATALOGUE-001`
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Automate">
    ### Automate approved work

    Vortex IQ is integrated with **7 read** and **0 write** operations across openapicustomerjsons, openapiinventoryleveljsons, openapiorders, openapiorderjsons, openapiproducts, openapiproductjsons on Shopline. Combine them with anything from the **over 13,000 operations across more than 200 connectors** to automate the work in your own words.

    Changes follow your configured approval policy: the target, proposed change, affected records, risk, reversibility and verification plan are shown before execution.

    [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=shopline)

    #### Ready to build your first Shopline workflow

    Pick a trigger, add the operations above as steps, and every step that changes data pauses for your approval. Monitoring and audits are live now and can start any workflow you build.

    <Accordion title="Browse the operations you can build with">
      | Resource                   | Read operations | Write operations |
      | -------------------------- | --------------- | ---------------- |
      | openapicustomerjsons       | 1               | 0                |
      | openapiinventoryleveljsons | 1               | 0                |
      | openapiorders              | 1               | 0                |
      | openapiorderjsons          | 1               | 0                |
      | openapiproducts            | 1               | 0                |
      | openapiproductjsons        | 1               | 0                |
      | openapirefundjsons         | 1               | 0                |

      Signed-in users see the full catalogue in the workflow builder, filtered to the sources they have connected.
    </Accordion>
  </Tab>
</Tabs>