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

# OnBuy on Vortex IQ

> Monitor OnBuy listings, account health and orders, and catch suppressions and sync problems before they cost sales.

Monitor OnBuy listings, account health and orders, and catch suppressions and sync problems before they cost sales.

[Connect or manage this source](https://app.vortexiq.ai/workbench/settings/sources) · [How connecting works](/integrations/connector-catalogue) · [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=onbuy)

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

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

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

  <Card title="0">
    proven 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="Catalogue quality">
        Identify missing, inconsistent or outdated product data.
      </Card>

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

      <Card title="Control risk and change">
        Keep tracking, access and change under governed control.
      </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 (46)">
    ### Monitor performance

    46 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 (15 signals)">
        | Signal                         | Alert behaviour    | What it tracks                                                                                                                                         |
        | ------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
        | **AOV by UK Region**           | Watch only         | AOV by UK Region.                                                                                                                                      |
        | **Avg Discount vs RRP**        | Merchant rule      | Description pending editorial review; the signal is live.                                                                                              |
        | **Avg Time to Dispatch (hrs)** | Merchant rule      | Description pending editorial review; the signal is live.                                                                                              |
        | **Courier Mix**                | Watch only         | Courier Mix, shown by share.                                                                                                                           |
        | **Dispatch SLA Compliance**    | Merchant rule      | % of orders dispatched before dispatch\_due\_by. OnBuy penalises stale account standing.                                                               |
        | **Dispatch Time by Region**    | Merchant rule      | Dispatch Time by Region.                                                                                                                               |
        | **Late Dispatch Count (30d)**  | Merchant rule      | Orders dispatched after dispatch\_due\_by - hits seller rating.                                                                                        |
        | **Late Dispatch Queue**        | Merchant rule      | Alerts for Late Dispatch Queue.                                                                                                                        |
        | **Marketplace Fees Paid**      | Watch only         | Marketplace Fees Paid as exposed by the OnBuy integration. The metric is computed from the latest available data and refreshed on the standard data re |
        | **OnBuy Health Score**         | Alert band 95 / 85 | Composite - listing-active-pct x order-fulfil-rate x SLA-compliance x inverse stale-listings.                                                          |
        | **Orders by Status**           | Merchant rule      | Orders by Status.                                                                                                                                      |
        | **Orders by UK Region**        | Watch only         | Description pending editorial review; the signal is live.                                                                                              |
        | **Pending Dispatch**           | Alert band 10 / 50 | Description pending editorial review; the signal is live.                                                                                              |
        | **Price Distribution**         | Watch only         | Description pending editorial review; the signal is live.                                                                                              |
        | **Zero-Stock Active Listings** | Alert band 0 / 5   | Active listings with stock\_level=0 - show on browse but can't fulfil.                                                                                 |
      </Accordion>

      <Accordion title="Catalogue quality (11 signals)">
        | Signal                              | Alert behaviour   | What it tracks                                                           |
        | ----------------------------------- | ----------------- | ------------------------------------------------------------------------ |
        | **Active Listings**                 | Merchant rule     | Description pending editorial review; the signal is live.                |
        | **Category Coverage**               | Merchant rule     | % of relevant OnBuy categories the merchant has at least one listing in. |
        | **Inactive Listings**               | Alert band 5 / 50 | Description pending editorial review; the signal is live.                |
        | **Listings Discounted >20%**        | Watch only        | Description pending editorial review; the signal is live.                |
        | **Listings Missing RRP**            | Alert band 5 / 50 | Without RRP, OnBuy can't show 'Save X%' badges that drive click-through. |
        | **Listings Suspension Burst (24h)** | Alert band 5 / 50 | Alerts for Listings Suspension Burst (24h).                              |
        | **Listings by Age**                 | Watch only        | Description pending editorial review; the signal is live.                |
        | **Listings per Brand**              | Watch only        | Listings per Brand, compared across items.                               |
        | **Sales Velocity by Category**      | Watch only        | Sales Velocity by Category.                                              |
        | **Total Listings**                  | Watch only        | Description pending editorial review; the signal is live.                |
        | **Uncategorised Listings**          | Alert band 5 / 50 | Listings missing category\_id - invisible to category-based browse.      |
      </Accordion>

      <Accordion title="Grow revenue (10 signals)">
        | Signal                            | Alert behaviour    | What it tracks                                                                         |
        | --------------------------------- | ------------------ | -------------------------------------------------------------------------------------- |
        | **Average Order Value**           | Alert band 0 / -5  | Description pending editorial review; the signal is live.                              |
        | **OnBuy Commission % of Revenue** | Alert band 12 / 18 | Per-category commission tracking - flags categories where OnBuy fees outpace margin.   |
        | **Orders**                        | Watch only         | Description pending editorial review; the signal is live.                              |
        | **Revenue Drop Alert**            | Alert band 0 / -5  | Alerts for Revenue Drop Alert.                                                         |
        | **Revenue Over Time**             | Alert band 0 / -5  | Description pending editorial review; the signal is live.                              |
        | **Suspended Listings**            | Alert band 5 / 50  | Listings OnBuy has hidden from search until issues are fixed - direct revenue blocker. |
        | **Top Brands by Revenue**         | Watch only         | Top Brands by Revenue.                                                                 |
        | **Top Categories by Revenue**     | Watch only         | Top Categories by Revenue.                                                             |
        | **Top Listings by Revenue**       | Watch only         | Top Listings by Revenue.                                                               |
        | **Total Revenue**                 | Alert band 0 / -5  | Description pending editorial review; the signal is live.                              |
      </Accordion>

      <Accordion title="Protect revenue (9 signals)">
        | Signal                                       | Alert behaviour   | What it tracks                                                                                            |
        | -------------------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------- |
        | **Amazon UK Top SKUs Missing on OnBuy**      | Merchant rule     | Velocity-proven SKUs that aren't even listed on OnBuy - the cheapest revenue lift available.              |
        | **Cancellation Rate**                        | Merchant rule     | Description pending editorial review; the signal is live.                                                 |
        | **Catalogue Drift vs Amazon UK**             | Alert band 5 / 50 | Same SKU listed at materially different prices on OnBuy vs Amazon UK - MAP/brand-consistency risk.        |
        | **Net Revenue (after commission + refunds)** | Alert band 0 / -5 | Description pending editorial review; the signal is live.                                                 |
        | **OnBuy Orders via ShipBob (SLA)**           | Merchant rule     | OnBuy SLA compliance specifically for orders fulfilled by ShipBob - isolates 3PL performance per channel. |
        | **OnBuy Share of UK Revenue**                | Watch only        | OnBuy Share of UK Revenue, shown by share.                                                                |
        | **OnBuy vs DTC Price Gap**                   | Merchant rule     | OnBuy vs DTC Price Gap, compared across items.                                                            |
        | **Revenue at Risk (live)**                   | Merchant rule     | Sum of (suspended\_listings x velocity x ASP) + (mis-categorised listings x velocity loss) - recoverable. |
        | **Stale Listings (>180d no update)**         | Merchant rule     | Listings with no metadata refresh in 6 months - risk OnBuy de-prioritising in search.                     |
      </Accordion>

      <Accordion title="Control risk and change (1 signals)">
        | Signal                | Alert behaviour | What it tracks                                                                                            |
        | --------------------- | --------------- | --------------------------------------------------------------------------------------------------------- |
        | **Auth Token Health** | Merchant rule   | OnBuy tokens expire after 1h; if refresh fails the dashboard goes blind. Surface before merchants notice. |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Audit (6)">
    ### 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="Listing buy-box win rate below 30% (Amazon-specific; non-applicable elsewhere)">
        **Severity** high · **Outcome** Grow revenue · **Fix status** Candidate remediation

        Losing the Buy Box means losing the sale even when the listing wins the search; price, delivery promise and account health drive the algorithm.

        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: `MARKETPLACE-LISTING-002`
      </Accordion>

      <Accordion title="Listings missing required attributes (varies per marketplace)">
        **Severity** high · **Outcome** Grow revenue · **Fix status** Candidate remediation

        A listing missing a required attribute is commonly suppressed, down-ranked in marketplace search, or blocked from certain placements entirely, so it can be losing sales without showing any error the seller would notice on the listing 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: `MARKETPLACE-LISTING-001`
      </Accordion>

      <Accordion title="Seller feedback score dropped > 3pp in 30 days">
        **Severity** high · **Outcome** Grow revenue · **Fix status** Report only

        Seller feedback score is one of the strongest signals marketplace search ranking and buy-box eligibility use, so a drop this size can cost visibility on every listing, not just the ones that triggered the negative feedback.

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

        Reference: `MARKETPLACE-FEEDBACK-001`
      </Accordion>

      <Accordion title="Marketplace fee % drifted > 2pp vs last quarter">
        **Severity** medium · **Outcome** Grow revenue · **Fix status** Report only

        The share of revenue this marketplace takes as fees has shifted by more than 2 percentage points from last quarter. On thin-margin products, a shift this size can move a listing from profitable to break-even without anything on the store side changing at all.

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

        Reference: `MARKETPLACE-FEE-001`
      </Accordion>

      <Accordion title="Payout overdue > 7 days vs marketplace's typical schedule">
        **Severity** medium · **Outcome** Run operations · **Fix status** Report only

        A payout is running more than 7 days behind this marketplace's usual schedule. That is cash the store has already earned sitting outside its bank account, which matters directly to cash flow regardless of how the underlying sales are performing.

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

        Reference: `MARKETPLACE-PAYOUT-001`
      </Accordion>

      <Accordion title="Return rate spiked > 50% vs 90-day average">
        **Severity** medium · **Outcome** Grow revenue · **Fix status** Report only

        Returns on this marketplace jumped more than 50% above the recent average. Beyond the direct cost of the returned goods and return shipping, a spike this size often also damages the seller-performance metrics the marketplace uses for search ranking and account health.

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

        Reference: `MARKETPLACE-RETURN-001`
      </Accordion>
    </AccordionGroup>

    #### Build your own automated fixes

    Turn any finding into an automated fix with a Vortex IQ workflow: **over 13,000 read and write operations across more than 200 connectors** are available as building blocks, with approval, verification and rollback on every change.
  </Tab>

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

    Vortex IQ is integrated with **6 read** and **1 write** operations across listings, orders, authrequesttokens, brands, categorys on OnBuy. 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=onbuy)

    #### Ready to build your first OnBuy 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 |
      | ----------------- | --------------- | ---------------- |
      | listings          | 2               | 0                |
      | orders            | 2               | 0                |
      | authrequesttokens | 0               | 1                |
      | brands            | 1               | 0                |
      | categorys         | 1               | 0                |

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