📘

Buy with Prime API is now available for early access

Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.

Sign Up

If you use a Salesforce B2C Commerce storefront with the Salesforce OMS, you need to update the Order Management B2C Service permission set.

Permissions to add to the Order Management B2C Service permission set

When you Configure the Salesforce OMS and Provision a B2C Commerce Connection, you create an Order Management B2C Service permission set. To allow the Salesforce Platform Integration User to handle Buy with Prime orders, fulfillment, and related operations, the Order Management B2C Service permission set requires edit access to the following objects and fields:

Add edit access to the fields on the Orders object

Edit access is required to automatically update fields when synchronizing orders between Salesforce B2C Commerce and the Salesforce OMS. Otherwise, errors can occur in order tracking, payment processing, and order management, and cause data synchronization to fail.

In the Order Management B2C Service permission set, do the following to add edit access to fields on the Orders object:

1. In your Salesforce organization, under Setup, click Users.
2. Click Permission Sets.
3. Click the Order Management B2C Service permission set, and then click Object Settings.
4. Click the Orders object, and then click Edit.
5. Under Field Permissions, next to each of the following fields, select the Edit Access checkbox.
   • Amazon_bwp_oms__amazonBwpOrderID__c
   • Amazon_bwp_oms__amzPayChargePermissionId__c
   • OrderManagementReferenceIdentifier
6. Click Save.

Add edit access to a field on the Order Projects object and update account assignments

Edit access is required to automatically update fields when synchronizing orders between Salesforce B2C Commerce and the Salesforce OMS. Otherwise, errors can occur in order item tracking and cause inconsistent data.

If you don't already have an object open from the Order Management B2C Service permission set, do the following:

1. In your Salesforce organization, under Setup, click Users.
2. Click Permission Sets.
3. Click the Order Management B2C Service permission set, and then click Object Settings.
4. Click the Order Products object, and then click Edit.

If you have the Orders object open from the Order Management B2C Service permission set, do the following:

• On the Orders menu, click Order Products.

Do the following to add edit access to a field on the Order Products object and to update account assignments:

1. Under Field Permissions, next to the Amazon_bwp_oms__amazonBwpOrderLineID__c field, select the Edit Access checkbox.
2. Click Save.
3. On the Order Products menu, click Accounts.
4. Under Account: Record Type Assignments, next to Business Account and next to Person Account, select the Assigned Record Types checkbox.

Verify the configuration of the Order Management B2C Service permission set

Verify your configuration of the Order Management B2C Service permission set by doing the following:

1. On your storefront, create an order containing a product that is eligible for Buy with Prime.
2. Open the Business Manager tool for Salesforce Commerce Cloud.
3. On the Merchant Tools menu, click Ordering, and then click Orders.
4. Search for the order identifier that you created.
5. In the order, confirm that the status for Order Management is Accepted.
6. Open your Salesforce OMS, and confirm that the order is present.
7. In the order details, verify that each field from the Permissions to add to the Order Management B2C Service permission set contains the correct value synchronized from Salesforce B2C Commerce.

Troubleshoot permissions errors

If a permissions error occurs when creating orders using Salesforce B2C Commerce, add the permissions shown in the error to the Order Management B2C Service permission set.

For example, if a user attempts to create an order and lacks edit access to a required field, the user might see an error message similar to the following:

INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY: Unable to create Order – missing edit access on ‘Amazon_bwp_oms__amazonBwpOrderID__c’ field.

To address the error, in the Order Management B2C Service permission set, add edit access to the Amazon_bwp_oms__amazonBwpOrderID__c field.

Related topics

Steps for Installing the Salesforce OMS Package for Buy with Prime