> ## Documentation Index
> Fetch the complete documentation index at: https://docs.global-e.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Requirements

## SFCC Compatibility Mode

Global-e cartridges **require** SFCC Digital Compatibility Mode **17.7 or newer**.

Current cartridges rely on CommonJS features available only from 17.7 onward:

* `wildcard` imports — `require('*/...')`
* `module.superModule` for cartridge extension

Upgrade **all** environments (sandbox, development, staging, and production) to Compatibility Mode 17.7 before installing or upgrading Global-e cartridges.

### Older compatibility modes

If your instance runs a compatibility mode **older than 17.7** (including versions between 15.5 and 17.6), contact **Global-e Merchant Support**. Global-e may provide additional materials for legacy integration modes.

<h2 id="account-manager--ocapi-data-api-new-integrations">
  Account Manager / OCAPI Data API (new integrations)
</h2>

New Global-e SFCC integrations must provision a **dedicated** Account Manager API client and grant it **Data** OCAPI permissions so Global-e can keep SFCC configuration aligned (including starting configuration sync such as **GlobaleSettings**, and reading Global-e custom objects, related site preference groups, and product information).

Do not reuse a Shop / headless OCAPI client for this purpose. Setup steps, the required resource JSON, and what to share with Global-e are in [Configuration → Data API](/configuration-sfcc#data-api-mandatory-for-new-integrations). The repository template is `metadata/ocapi-settings/wapi_data_config.json`.

## Development tooling

When building or uploading cartridges from the repository (not required for BM-only configuration):

| Tool | Requirement |
| - | - |
| Node.js | 18.20.0 or newer (see repository `package.json` `engines`) |
| [`b2c` CLI](https://salesforcecommercecloud.github.io/b2c-developer-tooling/) | Used for cartridge upload, cartridge path management, and related tooling — see [Installation](/installation-sfcc) |

Cartridge upload and metadata import steps are described in [Installation](/installation-sfcc).
