Per-integration API version plus days-until-EOL. Salesforce deprecates two OCAPI versions a year, this card surfaces replatform-readiness signals before they bite.
At a glance
A live table of every Salesforce Commerce Cloud (SFCC, formerly Demandware) integration Vortex IQ talks to, the API surface it runs on (OCAPI or SCAPI), the version string in use, and how many days remain until Salesforce ends support for that version. SFCC integrations do not degrade gracefully at end-of-life, they break hard, so this card is an early-warning surface, not a vanity metric.
Calculation
Calculated automatically from your Salesforce Commerce Cloud data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.Worked example
An enterprise retailer running a single SFCC B2C realm with four storefront sites, a headless PWA Kit sub-brand, and three back-office integrations. The snapshot is taken on 12 Mar 26 against Salesforce’s published deprecation calendar.
Three things to notice:
- Two storefront integrations are inside the 60-day alert window. Both RefArch-US and RefArch-UK run OCAPI v21.x with 49 days of runway. That fires the
<60day alert. Because they power live storefronts, an EOL here is a revenue-down event, not a back-office inconvenience. These are the top of the migration backlog. - The 3PL inventory sync is already past EOL (-31 days). A negative number means the version is technically retired. It may still be limping along on a grace period, but it is on borrowed time and can stop without further warning. This is the single most urgent row even though it is “just” an inventory job, because stale stock data drives oversells.
- The headless sub-brand on SCAPI has no scheduled EOL. SCAPI is the modern long-term surface, so it does not sit on the OCAPI version treadmill. This row is your reference point for what “good” looks like and the destination for the OCAPI migrations above.
- The OMS and Marketing Cloud connectors have comfortable runway (217 and 373 days). They are not alerting, but they belong on a planning Gantt chart now so the next deprecation does not become another fire drill. Pair this card with Integrations on EOL’d / EOL-Soon Versions for the rolled-up count.
Sibling cards merchants should reference together
Reconciling against Salesforce Commerce Cloud
Where to look in Business Manager: SFCC’s admin tool is Business Manager, accessed at a per-realm URL likehttps://<realm>.business.demandware.net. The version a cartridge or integration actually calls is not surfaced in a single Business Manager report, it lives in two places: Administration, Site Development, Open Commerce API Settings (the OCAPI client permission JSON, which pins the API version in the request path) and the Account Manager API client configuration for SCAPI consumers.
To verify a row in this card:
- OCAPI version: open Administration, Site Development, Open Commerce API Settings and read the
versionfield in the Shop / Data API client config. The version string in the URL path (e.g./s/-/dw/shop/v21_x/...) is the authoritative source. - SCAPI consumers: SCAPI versioning is handled through Account Manager API clients and the SCAPI shopper/admin endpoints; there is no single Business Manager screen that lists every consumer, so this card’s rollup is genuinely additive over what Business Manager shows.
- Deprecation dates: Salesforce publishes the OCAPI deprecation schedule in the B2C Commerce release notes and Help portal. Cross-check the EOL date in this card against the current published schedule.
Known limitations / merchant FAQs
What exactly happens when an OCAPI version reaches end-of-life? Calls against that version stop being served. It is a hard cutoff, not a slow degradation. Any integration pinned to that version, a storefront, an OMS export, an inventory sync, simply starts failing. This is why the card frames everything as days-of-runway and alerts at 60 days, the lead time you realistically need to test and ship a version bump. Why is SCAPI shown without an EOL date? SCAPI (Salesforce Commerce API) is Salesforce’s modern, long-term API surface and is not on the same fixed version-deprecation treadmill as OCAPI. Individual SCAPI endpoints can still change, but the platform-level “two deprecations a year” cadence that makes OCAPI risky does not apply the same way. A row on SCAPI is generally the healthy end state. The card shows a negative days-until-EOL. Is that integration broken? A negative number means the version is already past its published EOL. In practice Salesforce sometimes serves a short grace period, so it may still be limping along, but it is unsupported and can stop at any time. Treat any negative row as the highest-priority migration item regardless of what it powers. How does Vortex IQ know the EOL dates? The card computes runway against Salesforce’s published OCAPI deprecation schedule, which Salesforce maintains in the B2C Commerce release notes and Help portal. We do not invent dates. If Salesforce moves a date, the card reflects the latest published value on its next refresh. We run many integrations. Why do some not appear as separate rows? The card reports one row per distinct API consumer Vortex IQ can observe against your realm. Integrations that share a single API client config can collapse into one row. If you expect an integration to appear and it does not, check whether it shares a client with another consumer, or whether it talks to SFCC through a middleware layer that masks its version. Is this real-time? Yes. The card reflects the version currently configured on each integration, with the runway recomputed against today’s date. There is no period window to choose, it is always “as of now”. That is why the time window is shown asRT.
Should I migrate everything to SCAPI immediately?
Not blindly. Prioritise by runway and blast radius: anything inside the 60-day alert window, anything storefront-facing, and anything already negative goes first. Long-runway back-office jobs can be scheduled into a normal release cadence. Use OCAPI vs SCAPI Usage Mix to plan the overall programme.