Skip to main content

Salesforce B2B Commerce Cloud

Salesforce B2B Commerce Cloud is a comprehensive e-commerce platform designed for business-to-business transactions, enabling companies to create personalized buying experiences, manage complex pricing structures, and streamline B2B sales processes.

Salesforce B2B Commerce Cloud icon

Power end-to-end data operations for your Salesforce B2B Commerce Cloud API with Nexla. Our bi-directional Salesforce B2B Commerce Cloud connector is purpose-built for Salesforce B2B Commerce Cloud, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Salesforce B2B Commerce Cloud or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Salesforce B2B Commerce Cloud workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Before creating a Salesforce B2B Commerce Cloud credential, you need to obtain your OAuth2 Client ID and Client Secret from your Salesforce account. Salesforce B2B Commerce Cloud uses OAuth2 3-legged authentication, which requires user authorization to access your Salesforce account.

To obtain your Salesforce OAuth2 credentials, follow these steps:

  1. Sign in to your Salesforce account using your administrator credentials.

  2. Navigate to Setup in your Salesforce account by clicking the gear icon in the top right corner and selecting Setup.

  3. In the Setup menu, use the Quick Find box to search for App Manager or navigate to Platform Tools > Apps > App Manager.

  4. Click New Connected App to create a new connected app for API access.

  5. Configure your connected app settings:

    • Enter a name for the connected app (e.g., "Nexla Integration")
    • Enter a contact email address
    • Enable Enable OAuth Settings
    • Enter a callback URL (e.g., https://dataops.nexla.io/cors/https://login.salesforce.com/services/oauth2/callback)
    • Select the OAuth scopes you need (e.g., Full access (full), Perform requests on your behalf at any time (refresh_token, offline_access))

  6. Click Save to create the connected app.

  7. After saving, you will be redirected to the connected app details page. Your Consumer Key (Client ID) will be displayed. Copy the Consumer Key.

  8. Click Click to reveal next to the Consumer Secret to reveal your Consumer Secret (Client Secret). Copy the Consumer Secret immediately, as it may not be accessible again after you navigate away from the page.

  9. Store both credentials securely, as you will need them to configure your Nexla credential. The Consumer Key and Consumer Secret are sensitive information and should be kept confidential.

The Consumer Key (Client ID) and Consumer Secret are used to authenticate with the Salesforce OAuth2 authorization endpoint. The OAuth2 flow requires user authorization to obtain an access token, which is then sent in the Authorization header with the Bearer prefix for all subsequent API requests to the Salesforce B2B Commerce Cloud API. The access token is automatically obtained and refreshed by Nexla as needed. If your credentials are compromised, you should immediately revoke them in your Salesforce account settings and generate new ones. For detailed information about Salesforce OAuth2 authentication, API access, and available endpoints, refer to the Salesforce API documentation.

Authenticate​

Create a credential in Nexla​

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Salesforce B2B Commerce Cloud

SalesforceB2BCCCred.png

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  2. Salesforce B2B Commerce Cloud uses OAuth2 3-legged authentication for all API requests. Click the Authorize button to begin the OAuth2 authorization flow. You will be redirected to the Salesforce authorization page where you will need to sign in and grant permissions to Nexla to access your Salesforce account.

  3. After granting permissions, you will be redirected back to Nexla, and the authorization will be completed automatically. The access token and refresh token will be stored securely in your credential.

    Your Salesforce OAuth2 credentials can be found in your Salesforce account under Setup > App Manager > Your Connected App. The Consumer Key (Client ID) and Consumer Secret are used to authenticate with the Salesforce OAuth2 authorization endpoint to obtain an access token. The access token is then automatically sent in the Authorization: Bearer {token} header for all subsequent API requests to the Salesforce B2B Commerce Cloud API.

    The access token is automatically obtained and refreshed by Nexla as needed. If your credentials are compromised, you should immediately revoke them in your Salesforce account settings and generate new ones. The Consumer Key and Consumer Secret provide access to your Salesforce account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

    For detailed information about Salesforce OAuth2 authentication, API access, and available endpoints, see the Salesforce API documentation.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Salesforce B2B Commerce Cloud connector tile, then select the credential that will be used to connect to your Salesforce B2B Commerce Cloud account, and click Next; or, create a new Salesforce B2B Commerce Cloud credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Salesforce B2B Commerce Cloud endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Get Detailed Category Information

This endpoint template retrieves all information about all categories, including nested related attributes, from your Salesforce B2B Commerce Cloud account. Use this template when you need to retrieve comprehensive category information for your e-commerce catalog.

  • This endpoint automatically retrieves all categories from your Salesforce B2B Commerce Cloud account. The endpoint uses offset-based pagination to handle large datasets efficiently, returning up to 500 records per page by default.

This endpoint returns all information about all categories, including nested related attributes, from your Salesforce B2B Commerce Cloud account. The endpoint uses offset-based pagination with offset and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the offset parameter.

For detailed information about categories, API response structures, pagination, and ways to fetch filtered lists, see the Salesforce B2B Commerce Cloud Category REST API documentation.

Get Detailed Product Information

This endpoint template retrieves all information about all products, including related attributes, from your Salesforce B2B Commerce Cloud account. Use this template when you need to retrieve comprehensive product information for your e-commerce catalog.

  • This endpoint automatically retrieves all products from your Salesforce B2B Commerce Cloud account, including blocked products. The endpoint uses offset-based pagination to handle large datasets efficiently, returning up to 500 records per page by default.

This endpoint returns all information about all products, including related attributes, from your Salesforce B2B Commerce Cloud account. The endpoint uses offset-based pagination with offset and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the offset parameter.

For detailed information about products, API response structures, pagination, and ways to fetch filtered lists, see the Salesforce B2B Commerce Cloud Product REST API documentation.

Get Basic Category Information

This endpoint template retrieves some basic information about all categories from your Salesforce B2B Commerce Cloud account. Use this template when you need to retrieve basic category information without all nested attributes.

  • This endpoint automatically retrieves basic category information from your Salesforce B2B Commerce Cloud account. The endpoint uses next URL-based pagination to handle large datasets efficiently.

This endpoint returns some basic information about all categories from your Salesforce B2B Commerce Cloud account, including category IDs, names, and owner IDs. The endpoint uses next URL-based pagination with nextRecordsUrl to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by following the next records URL returned in the API response.

For detailed information about SOQL queries, API response structures, and ways to fetch filtered lists, see the Salesforce SOQL documentation.

Get Basic Product Information

This endpoint template retrieves some basic information about all products from your Salesforce B2B Commerce Cloud account. Use this template when you need to retrieve basic product information without all related attributes.

  • This endpoint automatically retrieves basic product information from your Salesforce B2B Commerce Cloud account. The endpoint uses next URL-based pagination to handle large datasets efficiently.

This endpoint returns some basic information about all products from your Salesforce B2B Commerce Cloud account, including product IDs, names, SKUs, product types, product statuses, and other basic fields. The endpoint uses next URL-based pagination with nextRecordsUrl to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by following the next records URL returned in the API response.

For detailed information about SOQL queries, API response structures, and ways to fetch filtered lists, see the Salesforce SOQL documentation.

Execute SOQL Query

This endpoint template allows you to fetch resources by specifying a SOQL (Salesforce Object Query Language) query. Use this template when you need to retrieve data using custom SOQL queries to filter and select specific fields.

  • Enter the SOQL query string in the Query String field. This should be a valid SOQL query (e.g., SELECT Id, Name FROM Account WHERE CreatedDate > 2024-01-01T00:00:00Z). The query string determines which records will be retrieved and which fields will be included in the response.

This endpoint executes a SOQL query to fetch resources from your Salesforce B2B Commerce Cloud account. The endpoint uses next URL-based pagination with nextRecordsUrl to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by following the next records URL returned in the API response.

For detailed information about SOQL queries, query syntax, available objects, and ways to construct queries, see the Salesforce SOQL documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

Salesforce B2B Commerce Cloud data sources can also be manually configured to ingest data from any valid Salesforce B2B Commerce Cloud API endpoint, including endpoints not covered by the pre-built templates or endpoints that require chained API calls or custom query parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Salesforce B2B Commerce Cloud API typically uses the GET method. The endpoint URL should include your instance URL (e.g., https://your-instance.salesforce.com/services/apexrest/ccrz/cccategory/v8/fetch). For the Response Data Path, use $.records[*] for SOQL query results, $.categoryList[*] for the category list, $.productList[*] for the product list, or $ for single-record endpoints, depending on the endpoint. Salesforce B2B Commerce Cloud API uses next URL-based pagination (via $.nextRecordsUrl) for some endpoints, and offset-based pagination (offset/limit parameters) for others; select the pagination type that matches your endpoint.

Once all of the relevant settings have been configured, click the Next button to proceed with the rest of the data flow configuration, or click the Save button to save the new Salesforce B2B Commerce Cloud data source for later use.