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

# Salesforce Commerce Cloud

> The Salesforce Commerce Cloud Connector allows you to seamlessly translate your product catalog and content directly from within Salesforce, eliminating manual exports and enabling faster global launches. Read below for configuration information. 

## **Prerequisites**

* Access to **Salesforce Account Manager** ([account.demandware.com](https://account.demandware.com/)) with permissions to create and manage API clients.
* Access to **Business Manager** for your Commerce Cloud instance (for cartridge registration and code deployment, if applicable).
* Your **organization ID** and **instance short code** (e.g. from your SFCC project or Account Manager).
* For cartridge installation: **Node.js** and **npm**, and (if using the upload CLI) a cartridge archive and optional `dw.json` configuration.

***

## **1. Enable SCAPI and API credentials**

The connector uses **SCAPI (Salesforce Commerce API)** with OAuth 2.0. You need to create an API client in Account Manager, assign the **Salesforce Commerce API** role, and configure it for your organization and instance(s). Use your SFCC/Account Manager documentation for the exact steps.

***

## **2. Enable product write and catalog read**

For the connector to read and update product data (including translating products in bunches), your API client must have **product write** and **catalog read** permissions enabled in Account Manager. Configure the required OAuth scopes according to your SFCC documentation.

***

## **3. Configure the connector**

You need to provide the following details so Lilt can set up the connector configuration on the Lilt side. All of these are required for connector setup.

* `sfcc_data_url` — SCAPI Data API base URL (e.g. `https://shortcode.api.commercecloud.salesforce.com`).
* `sfcc_auth_url` — OAuth token URL (e.g. `https://account.demandware.com/dwsso/oauth2/access_token` or the SLAS/Account Manager URL in use).
* `sfcc_client_id` — API client ID from Account Manager.
* `sfcc_client_secret` — API client password (client secret).
* `sfcc_organization_id` — Organization ID.
* `sfcc_bm_user_id` / `sfcc_bm_user_password` — Business Manager user credentials (used when using BM user grant instead of client credentials).

***

## **4. Install cartridge from archive**

To deploy the connector cartridge to your SFCC instance, use the **Salesforce Commerce Cloud CLI** (`sfcc-ci`). Install it if needed (`npm install -g sfcc-ci`), then run:

```
sfcc-ci code:deploy $(ZIP_FILE) --activate
```

Replace `$(ZIP_FILE)` with the path to your cartridge zip (e.g. `./connector-cartridge.zip`). The `--activate` flag activates the deployed code version. Ensure your environment is configured for your instance (e.g. via `dw.json` or environment variables as required by `sfcc-ci`).

***

## **5. How to use the connector**

To start working with the connector, in the **right vertical navbar** in SFCC go to **Lilt** and open the **Orders** page.

<img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC1.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=7c43575519be5433209f49cbaaf6dc3b" alt="SFCC1" width="2048" height="1208" data-path="images/SFCC1.webp" />

If it is your first time, you will be prompted to enter your **Lilt Plugin API** token. Enter it and click **Save**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lilt-db26f913/images/SFCC2.webp" alt="SFCC2" />

After the token is saved, you will be redirected to the Orders page, where you can create your first order or see the list of already submitted orders.

<img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC3.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=e3f3a758d69a950a2982d63b432772e3" alt="SFCC3" width="2048" height="1208" data-path="images/SFCC3.webp" />

### **Creating a new order**

To create a new order, choose **Translate** or **Create your first translation order**.

**Choose the flow:**

* **Instant** — Translation runs instantly without human involvement.
* **Verified** — The order is created on the Lilt platform and requires linguists to translate or verify it, depending on your workflow.

In the new order form, choose **source and target languages**, enter an **order name**, and select **products or catalogs** you want to translate. Then click **Submit for translations**.

<img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC4.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=084ad0f2ef560aa77ad609e750b3126d" alt="SFCC4" width="1718" height="1363" data-path="images/SFCC4.webp" />

After you submit, the order is sent to the Lilt platform.

<img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC5.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=063576e80f4c37829685162687d15aba" alt="SFCC5" width="1718" height="1363" data-path="images/SFCC5.webp" />

### **When the job is done**

When the job is done, you can **Preview** or **Deliver** it.

<img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC6.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=ded3219f93ae9816421dc09048883384" alt="SFCC6" width="1718" height="1363" data-path="images/SFCC6.webp" />

* **Preview** — Opens a modal with available files and languages. Open one of the files to see content **side by side**: source content on the left, target content on the right.

  <img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC7.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=97aa2af0deb2dabef95d95855f689c38" alt="SFCC7" title="SFCC7" style={{ width:"91%" }} width="1718" height="1363" data-path="images/SFCC7.webp" />
* **Deliver** — If everything looks good, click **Deliver**. This starts the process of writing translations to your files.

  <img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC8.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=105436f281459e95151faeb1c03d3287" alt="SFCC8" title="SFCC8" style={{ width:"90%" }} width="1718" height="1363" data-path="images/SFCC8.webp" />

Once delivery is complete, the order status changes to **Complete**.

<img src="https://mintcdn.com/lilt-db26f913/tc6khkHy5o9evTab/images/SFCC9.webp?fit=max&auto=format&n=tc6khkHy5o9evTab&q=85&s=90a5343199d671b6ec17058a9fdbf69a" alt="SFCC9" title="SFCC9" style={{ width:"89%" }} width="1718" height="1363" data-path="images/SFCC9.webp" />

***

## **6. References**

* [Use the API Clients API | Account Manager](https://developer.salesforce.com/docs/commerce/account-manager/guide/api-clients.html) – Create and manage API clients.
* [Authorization Scopes Catalog | SCAPI](https://developer.salesforce.com/docs/commerce/commerce-api/guide/auth-z-scope-catalog.html) – OAuth scopes for SCAPI (e.g. `sfcc.products`, `sfcc.products.rw`, `sfcc.catalogs`).
* [Authorization for SCAPI Admin APIs](https://developer.salesforce.com/docs/commerce/commerce-api/guide/authorization-for-admin-apis.html) – Admin API authentication.
* [Cartridges | B2C Commerce](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-cartridges.html) – Cartridge overview and structure.
* [Upload and Configure Cartridges (Trailhead)](https://trailhead.salesforce.com/content/learn/modules/b2c-cartridges/b2c-cartridges-upload-configure) – Upload and configure cartridges.