The B2C Commerce Integration provider manages the integration of order records between B2C Commerce and Order Management. It's important that you read through and understand all of the available settings to plan your configuration.
For general information on configuring a provider, see Providers.
The B2C Commerce Integration provider is always configured at the company level.
The tasks that transfer information between Order Management and B2C Commerce run on set schedules. These schedules are not user-configurable.
B2C Commerce Integration Provider Controls
In addition to provider settings, the Demandware provider includes the following controls. They are intended for use by Support for testing the integration of B2C Commerce with Order Management.
- Send Integration Date: Sends to B2C Commerce the integration date stamped on the most recently processed order. This setting is only for testing purposes; a job sends this information automatically every 10 minutes.
- Integration Cleanup: Requests that B2C Commerce send any orders not sent via the legacy connector but that have not been marked for the new integration to send. Run this cleanup whenever the integration is enabled, including after it's been disabled or rolled back to the legacy connector. It does not run automatically.
-
Test Connection/Test All Connections: Tests the B2C Commerce
instance connections listed in the Connection Manager. A green check icon appears next to
working connections, while a red exclamation icon appears next to connections that fail
the test. To open a tooltip containing detailed test results for a connection, hover over
its icon.Note: The button label is "Test All Connections" when there is more than one connection.
- Add: Adds a connection to a B2C Commerce storefront instance. This button doesn't appear after production mode is activated.
-
Activate Production Mode: Activates production mode, which locks
in the production B2C Commerce connection. It permanently removes the
Add button and deletes all connections except for the one that is
configured to accept orders. The Activate Production Mode button is then permanently
replaced with the date when production mode was activated, labeled "Production
Active."Note: When production mode is activated, you can't return to test mode. In addition, the URL of the production connection can no longer be edited.
-
Send Configuration: (On the Edit Connection page for each
individual connection) Forces the configuration information to be sent from Order
Management to B2C Commerce. This button is only for testing purposes; the configuration
call is made automatically when any of the following integration settings are made or changed:
- Connection Manager settings
- Private Key
- Public Key
B2C Commerce Integration Provider Settings
The following table describes the functionality of each configurable setting. Hovering over the
help icon (
) next to certain fields in the user
interface opens a tool tip.
| Provider setting label | Data description | Setting values |
|---|---|---|
| Connection Manager | Configures individual connections with B2C Commerce storefronts. | Shows the URL of each connection and identifies the connection currently set to accept orders. If the Test All Connections button has been clicked, a red or green icon appears here. Hover over this icon to see the test results for this connection. Hover over the Settings icon for a connection to see details of that connection, or click the Edit link to open the Edit Connection page. The following table describes the connection settings. |
| Private Key | Used to encrypt order data from B2C Commerce. | Masked text |
| Public Key | Used to decrypt order data from B2C Commerce. | Text |
| (Integration) Order Integration State | Enables the integration with B2C Commerce. | Select one:
|
| Order Create Processing Threads | Configures the number of threads that the integration with B2C Commerce uses to process orders. Don't modify this setting directly. | Enter text |
| (Integration) Product Option Attribute Enabled | If unchecked, product options in orders from B2C Commerce appear in Order Management as individual line items. Checking this box causes them to appear as item-level attributes. Contact Support if you wish to use this feature. | Checkbox |
| (OAuth) OAuth Certificate Thumbprint | Not used. | N/A |
| (OAuth) OAuth Create Base URL | Not used. | N/A |
| (OAuth) OAuth Verify Base URL | Not used. | N/A |
Connection Details
Select a connection in the Connection Manager to open the connection details:
| Connection setting label | Data description | Setting type |
|---|---|---|
| Digital Base URL | The URL of the B2C Commerce storefront instance associated with the connection. When production mode is activated, you can no longer edit this field. | String |
| Packet Max Size | The maximum number of orders to include in a single packet. A packet is sent when it contains this number of orders. | Integer (number of order records) |
| Packet Max Wait | A packet is sent after this time elapses even if it doesn't contain the maximum number of orders. | Integer (number of milliseconds) |
| Push Read Timeout | Timeout period when pushing order packets to Order Management. | Integer (number of milliseconds) |
| Queue Max Size | The maximum number of orders that can be enqueued. Any further orders aren't enqueued until some are sent. | Integer (number of order records) |
| (Integration) Product Option Attribute Enabled | If unchecked, product options in orders from B2C Commerce appear in Order Management as individual line items. Checking this box causes them to appear as item-level attributes. Contact Support if you wish to use this feature. | Checkbox |
| State | (Only available for the connection that is enabled to accept orders) Enables the connection to B2C Commerce. | Select one:
|
| Accept Orders | Identifies the connection that is enabled to accept orders. Only one connection can be enabled at a time. | Read-only checkbox |