📘

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

Data mappings define how data moves between Buy with Prime and the Salesforce order management system (OMS). To ensure that the Salesforce OMS receives inbound object data correctly, map your Buy with Prime data to your Salesforce objects.

Prerequisites

You must complete the System Connections configuration. For details, see Configure your Amazon sales channel with the API credentials for your account.

Understand data mapping

Salesforce objects are database tables in Salesforce that store specific types of data. In the context of the Salesforce OMS package for Buy with Prime, you map your Buy with Prime data to Salesforce objects. The Salesforce OMS package provides default selected Salesforce objects that map to common Buy with Prime objects, which you can configure based on your implementation.

You must complete all required data mappings before you activate your integration to ensure proper data flow between systems. When you edit a data mapping, the Salesforce OMS package displays any required Salesforce fields that need valid values assigned to them before you can activate the data mapping.

(Optional) Configure the default selected Salesforce object for your data mapping

To configure the default selected Salesforce object to use for your data mapping, do the following:

1. In your Salesforce organization, open an Amazon sales channel.
2. Choose the Data Mappings tab.
3. Next to a Salesforce object of your choice, in the Actions column, choose the menu, and then choose Edit Mapping.
4. If the data mapping is active, deactivate the data mapping.
5. Choose the button next to the Activate button, and then choose Edit Mapping Properties.
6. Choose the appropriate Salesforce object for your data mapping, and then choose the corresponding Buy with Prime object to map to.
7. Choose Save to confirm your changes.

Map fields between Buy with Prime and the Salesforce OMS

To map fields between Buy with Prime and the Salesforce OMS, do the following:

1. In your Salesforce organization, open an Amazon sales channel.
2. Choose the Data Mappings tab.
3. Next to a Salesforce object of your choice, in the Actions column, choose the menu, and then choose Edit Mapping.
4. If the data mapping is active, deactivate the data mapping.
5. Under Field Mappings, map the Salesforce fields to values provided by Buy with Prime fields when Buy with Prime sends data to Salesforce.
6. To add a new field mapping, under Field Mappings, choose the Add Mapping button.
7. For any new field mappings that you add, choose a Salesforce field and a Buy with Prime value.

Map Buy with Prime values to Salesforce picklist fields

To map Buy with Prime values to match the predefined options in Salesforce picklist fields when Buy with Prime sends data to Salesforce, do the following:

1. Under Picklist Value Mappings, choose the Edit Picklist Value Mapping button.
2. Map any picklist values for the fields from both systems, then choose Done.

(Optional) Map static values to Salesforce fields

To assign fixed, predefined values to specific Salesforce fields when Buy with Prime sends data to Salesforce, do the following:

1. Under Static Value Assignments, choose the Add Assignment button.
2. Choose a Salesforce field to use for the new assignment.
3. Enter a value to assign to the Salesforce field.

Activate the data mapping

To activate the data mapping, do the following:

1. In your Salesforce organization, open an Amazon sales channel.
2. Choose the Data Mappings tab.
3. Next to a Salesforce object of your choice, in the Actions column, choose the menu, and then choose Edit Mapping.
4. Choose Activate, and then choose Activate again.
5. Go back to the Data Mappings tab.
6. For each remaining Salesforce object, repeat the steps to activate the data mapping.

If you use custom objects, review and update the data mappings to address your setup and integration requirements.

Next steps

After you complete configuring data mappings between Buy with Prime and the Salesforce OMS, grant the appropriate field-level permissions for any custom fields you create. For details, see Create Your Salesforce Connected App for Buy with Prime.

Related topics

Configure the Salesforce OMS Package for Buy with Prime