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.

Connecting Adobe Commerce (formerly Magento) to Vortex IQ gives the AI OS access to your order stream, product catalogue, customer records, and fulfilment data. Adobe Commerce is the platform of choice for mid-market and enterprise merchants with complex B2B, multi-website, or custom checkout requirements — and Vortex IQ surfaces the KPI cards that matter for that operating context, including B2B-specific metrics that simpler analytics tools miss entirely.

​
What data Vortex IQ reads from Adobe Commerce

Vortex IQ connects to the Adobe Commerce REST API and ingests the following data:
  • Order totals across all websites and store views configured in Adobe Commerce
  • Order state and status (new, processing, complete, closed, cancelled, holded)
  • Payment method and gateway per order
  • Shipping amounts, methods, and carrier assignments
  • Discount codes and discount amounts
  • Refunds (credit memos) and return status
  • Tax amounts and tax class per line item
  • Guest vs customer account orders
  • Product variants and configurable product options with current stock quantities
  • Product status (enabled, disabled)
  • Product type (simple, configurable, bundle, downloadable)
  • SKU, category, and attribute sets
  • Out-of-stock state per variant
  • Company accounts and account status
  • B2B revenue share vs B2C revenue
  • B2B average order value delta vs B2C AOV
  • Account-level silence signals (companies that have stopped ordering)
  • Customer records with email state
  • Order frequency and geography
  • Guest vs account-registered breakdown
  • Repeat purchase rate and churn signals
Adobe Commerce uses credential-based authentication. You will need an Admin API integration token generated in the Adobe Commerce Admin panel. Vortex IQ shows step-by-step instructions for generating the token inline in the connector drawer.

​
How to connect

1

Open Connected Sources

In your Vortex IQ workspace, go to Settings → Connected Sources. You need Admin role in the workspace to connect sources.
2

Find the Adobe Commerce card

Locate the Adobe Commerce connector card and click + Connect. The connector drawer opens with a credential form.
3

Generate an integration token in Adobe Commerce

In your Adobe Commerce Admin, go to System → Extensions → Integrations → Add New Integration. Set the integration name, then under API grant read access to: Orders, Products, Inventory, Customers, and Store. Save the integration and copy the Access Token.
4

Enter your store URL and access token

Enter your Adobe Commerce Base URL (for example, https://store.yoursite.com) and the Access Token in the Vortex IQ connector form.
5

Verify and connect

Click Verify and Connect. Vortex IQ makes a test API call to validate the token and base URL. On success, the card flips to Connected.
6

Wait for the first data pull

Adobe Commerce KPI cards appear in Nerve Centre within 5 to 15 minutes. Full historical order backfill takes 1 to 4 hours.
Grant the integration read-only access to all required resources. Vortex IQ does not require write access to any Adobe Commerce resource. For multi-website setups, the access token covers all websites within the same Adobe Commerce installation.

​
Available KPI cards

Vortex IQ populates Nerve Centre with Adobe Commerce KPI cards across the following categories.

Revenue and growth

Total Revenue — Gross revenue across all websites and store views for the period, compared to the prior period. Alerts on a drop greater than 15% vs prior 30 days.Revenue Over Time — Daily revenue trend sparkline.Average Order Value — Revenue ÷ Order Count, with trend.Revenue by Day of Week — Identifies highest-revenue days for scheduling.Discount % of Revenue — Discount value as a share of gross revenue.Daily Order Trends — Daily order volume with period comparison.

B2B-specific cards

B2B Revenue Share — B2B company-account revenue as a percentage of total Adobe Commerce revenue.B2B AOV Delta — Difference between B2B average order value and B2C AOV. Indicates customer mix changes.B2B Account Silence — Company accounts that have not placed an order within a configurable look-back window. An early churn signal for wholesale accounts.

Orders and fulfilment

Order Count — Total orders placed in the period.Orders Over Time — Daily order volume sparkline.Order State Breakdown — Distribution of orders across Adobe Commerce order states.Unfulfilled Orders — Orders awaiting processing or shipment.Fulfilment Rate — Share of orders fulfilled within the expected window.Fulfilment Over Time — Fulfilment rate trend.Cancellation Rate — Cancelled orders as a share of total.

Customers

Customer Count — Total active customers.New Customers — First-time buyers in the period.Repeat Rate — Share of customers who bought more than once.Guest vs Account — Breakdown of guest checkout vs registered account orders.Churn Risk — Customers showing lapse signals.Customer Segments — Breakdown by RFM-style segment.

Refunds and returns

Refund Rate — Credit memos as a share of orders in the period.Refund Value — Total value of credit memos issued.Refunds Over Time — Daily refund trend.Return Status — Breakdown of return requests by state.Refund Spike Alert — Fires when refund rate rises sharply.

Alerts and anomalies

Revenue Drop Alert — Revenue falls more than 15% vs prior period.OOS Spike Alert — Out-of-stock count rises sharply.Fulfilment Delay Alert — Fulfilment rate drops below threshold.Cart Abandon Spike Alert — Cart abandonment rate rises sharply.Refund Spike Alert — Refund rate rises above threshold.

​
Cross-channel cards

When you connect ad platforms or other data sources alongside Adobe Commerce, Vortex IQ unlocks additional cross-channel cards:
CardWhat it shows
Active Ads on Out-of-Stock SKUsAd spend on OOS variants — pause candidates
Revenue at Risk from active incidentsLive revenue impact when a monitoring incident is open
Catalogue Drift vs AmazonAdobe Commerce SKUs active on Amazon but OOS on the main store
Email Revenue ShareEmail-attributed revenue as a share of Adobe Commerce total

​
Troubleshooting

Check that the integration token was generated with the correct resource permissions (Orders, Products, Inventory, Customers, Store — all read-only). Also verify that the Base URL does not have a trailing slash and matches the admin-panel domain exactly. If authentication still fails after re-checking both, regenerate the integration token in Adobe Commerce Admin and try again.
B2B-specific cards (B2B Revenue Share, B2B AOV Delta, B2B Account Silence) require Adobe Commerce B2B edition and at least one active company account. If your installation is the standard Adobe Commerce edition without the B2B module, these cards will remain empty.
Adobe Commerce reports typically use the order created date in the configured locale timezone. Vortex IQ uses UTC. Boundary-day differences are expected, particularly for stores in UTC-offset timezones. For 30-day windows these differences average out. Also check whether your Adobe Commerce report is showing net revenue (post-credit memo) rather than gross — Vortex IQ Total Revenue is gross of credit memos.
The Vortex IQ Adobe Commerce connector reads all websites within a single Adobe Commerce installation using the Admin API. Ensure the integration token has access to Global scope (not restricted to a specific website). For separate Adobe Commerce installations, each requires its own connector connection.