Amazon Marketplace Connection

See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Amazon Marketplace connector.

Amazon Marketplace is an e-commerce platform and online marketplace where third-party sellers can offer their products to a global customer base through Amazon’s website.

This topic describes how to authenticate to Amazon Marketplace and configure any necessary connection properties in the Amazon Marketplace connection connector.

Connection Configuration #

Each connection property available in the Amazon Marketplace connector is explained below.

Connection Name #

The name of the connection to be created should be provided. This is the name that will display on the list of available connections.

Schema #

The type of schema to use.

The available schemas are Marketplace and SellingPartner.

AWS Region #

The hosting region for your Amazon Web Services.

Available values are: OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPORE, SYDNEY, TOKYO, CENTRAL, BEIJING, NINGXIA, FRANKFURT, IRELAND, LONDON, MILAN, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST, and GOVCLOUDWEST.

AWS AccessKey Id #

The AWS AccessKey Id that you received when you registered for Amazon MWS.

Marketplace #

The Marketplace region that you are registered to sell in.

Available regions are: United States, Canada, Mexico, Brazil, Spain, United Kingdom, France, Belgium, Netherlands, Germany, Italy, Sweden, Poland, Egypt, Turkey, Saudi Arabia, United Arab Emirates, India, China, Singapore, Japan, and Australia.

MWS Auth Token #

The authorization token that you received when you registered for Amazon MWS.

Seller Id #

The Seller ID that you received when you registered for Amazon MWS.

AWS Role ARN #

The Amazon Resource Name of the role to use when authenticating.

When authenticating outside of AWS, it is common to use a Role for authentication instead of your direct AWS account credentials.

Entering the AWS Role ARN will cause the Amazon Marketplace connector to perform a role based authentication instead of using the AWS Access Key and AWS Secret Key directly.

The AWS Access Key and AWS Secret Key must still be specified to perform this authentication.

You cannot use the credentials of an AWS root user when setting Role ARN. The AWS Access Key and AWS Secret Key must be those of an IAM user.

App Id #

Application Id for Selling Partner app you created.

AWS Session Token #

AWS Session Token for Selling Partner app you created.

AWS Session Token can be obtained from Assume Role request to AWS.

AWS Access Key Id and AWS Secret Key should also be provided when setting AWS Session Token.

AWS Access Key #

Your AWS access key.

AWS Secret Key #

Your AWS secret key.

Selling Partner #

Specifies the type of Selling Partner, which can be Seller or Vendor.

Include Restricted Data #

Determinies if Restricted Data Tokens (RDT) should be used to retrieve Personally Identifiable Information (PII).

Client ID #

The client Id assigned when you register your application with an OAuth authorization server.

Client Secret #

The client secret assigned when you register your application with an OAuth authorization server.

Refresh Token #

The OAuth refresh token for the corresponding OAuth access token.

Credentials Location #

The location of the settings file where temporary credentials are saved.

Temporary credentials are short lived and typically expire after an hour.

At that point, a different SecurityToken must be specified to continue connecting.

Temporary credentials only work once, so in the case of multi-threaded or multi-process applications, the credentials must be centrally located and shared to avoid problems.

When Schema is set to Marketplace, this property does nothing.

Use Sandbox #

A boolean determining if the connection should be made to the Selling Partner sandbox account.

Note: To use Sandbox account, set Schema to ‘SellingPartner’.

Include Reports #

Set this connection property to true to expose already created reports as views, this property is avaible for both schemes (Marketplace and SellingPartner).

Report Types #

Set this connection property to one or more comma-separated report types to filter reports.

This property decides which report types to expose as views when Include Reports = True and Schema = Marketplace.

Procedure Pooling #

Whether or not to get feed results after an execution of a stored procedure.

Set this to False if you do not want to wait to get the results of a stored procedure.

Use Simple Names #

Boolean determining if simple names should be used for tables and columns.

Amazon Marketplace tables and columns can use special characters in names that are normally not allowed in standard databases. Use Simple Names makes the it easier to connect with traditional database tools.

Setting Use Simple Names to true will simplify the names of tables and columns returned. It will enforce a naming scheme such that only alphanumeric characters and the underscore are valid for the displayed table and column names. Any non-alphanumeric characters will be converted to an underscore.

Enable SSL #

Option for creating the connection with SSL enabled.

Upload Keystore File #

Option to upload keystore file.

Add Configuration: Additional properties can be added using this option as key-value pairs.

After entering all the details, click on the TEST button.

If the connection service identification and authentication details are provided correctly, a success message stating “connection available” is generated.

Click on the CREATE button to save the changes.

If the details are incorrect or the server is down, you will get a message “Connection unavailable”.