Prerequisites

This topic describes how to set up your local development environment so that you can install the Adobe Sales Channel reference app on an Adobe Commerce 2.4.5+ instance.

To install the reference app, you must:

Have an Adobe Developer account with System Administrator or Developer Role permissions. Getting started with Adobe Developer Console describes how to enroll in the Adobe developer program.
Be familiar with Adobe I/O Runtime and Adobe IO Events.
Install the aio CLI
Have access to an Adobe Commerce 2.4.5+ on cloud infrastructure or to an on-premises instance.
(Recommended) Install Adobe Commerce Admin UI SDK, which enables you to attach the App Builder application to the Adobe Commerce Admin.
Install nodeJS 16.13+ as your JavaScript runtime.

In addition to these software requirements, you must have access to the Commerce environment from an external network. You must also have the ability to add API integrations.

Adobe Commerce configuration and setup

Before you begin the process of installing the Adobe Sales Channel reference app, you must configure I/O Events for Adobe Commerce and add custom attributes to the Admin.

Configure I/O Events for Adobe Commerce

Follow the instructions in Configure Adobe Commerce to enable communication with Adobe I/O and create an event provider. Specifically, follow these procedures:

Do not perform the Subscribe and register events procedure. The Amazon Sales Channel app installation instructions describe the process for this app.

Create custom attributes

To subscribe to catalog update events from Adobe Commerce, you must create the following custom attributes in Stores > Attributes > Product > Add New Attribute:

Default label	Attribute Code	Scope	Notes
ASIN	`asin`	Global
Amazon Condition	`amazon_condition`	Global	Condition of the listing item. The Amazon docs list the possible values.

Amazon SP API

Amazon Sales Channel uses Amazon SP API to communicate with Amazon Seller Central.

To properly configure Amazon SP API, you must have:

Admin access to Amazon Seller Central
Permissions to add Developer Applications

You must perform configuration tasks for Amazon Web Services and Amazon Seller Central.

Amazon Web Services

Create an IAM policy per Amazon SPI Guide.

Amazon Seller Central

The app type of Amazon Sales Channel is Private Seller. Specify this integration type when you configure your instance. See Determine app type for more information.

Register yourself as a private developer.
Registering your Application.
Self authorize your application to generate access keys.

When you create an account from the App Builder application UI, you will need the following set of Amazon credentials:

Field	Where to get
Client ID	In Developer Central
Client secret	In Developer Central
Client refresh token	In Developer Central > Authorize
AWS access key	In AWS > IAM > User with access to IAM role
AWS secret access key	In AWS > IAM > User with access to IAM role
AWS Role ARN	Create AWS IAM role
Target marketplace	ASC Marketplace IDs
Unique Seller ID	Amazon Seller Central > Account Info > Merchant Token