Akinon Release Notes (05/12/2025) are now live! Click here to learn what's new.
LogoLogo
API Reference
  • Home
  • Quick Start
  • Tutorials
  • Technical Guides
  • Release Notes
  • Glossary
  • Launch Your Akinon in Just 6 Steps
    • 1. Start Your Journey with ACC
    • 2. Set Up Language & Locale
    • 3. Define Store Currencies
    • 4. Format Phone Numbers
    • 5. Integrate Omnitron & Integrator
    • 6. Set Up Project Zero
  • Launch Your Marketplace with Seller Center
Powered by GitBook

© 2025 Akinon. All rights reserved.

On this page
  • 1. Create a Seller Center in ACC
  • 2. Complete Seller Center Configurations
  • Mandatory Configurations
  • Optional Configurations
  • 3. Create Sellers in Seller Center
  • 4. Manage Offers & Products in Seller Center
  • 5. Manage Orders & Packages in Seller Center

Was this helpful?

Launch Your Marketplace with Seller Center

Previous6. Set Up Project Zero

Last updated 7 days ago

Was this helpful?

The Seller Center allows Akinon customers to build and manage marketplaces through a single platform. Designed as an add-on, it works in conjunction with Omnitron to provide seamless integration and functionality.

This guide walks you through the steps to connect your Omnitron with the Seller Center, enabling you to set up and configure your marketplace within the ACC.

This guide will help you:

  • Create a Seller Center in ACC

  • Complete essential configurations

  • Create and manage Sellers

  • Manage offers and products as both Seller and Marketplace Owner

  • Manage orders and packages as a Seller

Below are the steps to get started and successfully complete the setup process.

1. Create a Seller Center in ACC

To get started:

  • Log in to your ACC Dashboard and navigate to the Projects page.

  • Select the project where you want to create the Seller Center.

  • Click + NEW SERVICE and select Seller Center from the list.

After selection, you’ll see a list of environment settings required to configure the application under the "Configure Seller Center Application Values" section. Here’s what each setting means:

Settings
Description

OMNITRON_CATALOG_ID

This dynamic setting represents the Omnitron Catalog ID used in the Seller Center. It is required when sellers create collections or retrieve category nodes during the offer creation process. The Catalog ID can be obtained from the relevant Omnitron.

OMNITRON_CHANNEL_ID

This setting defines the Omnitron Channel ID used in the Seller Center to access Commerce-related services. The value corresponds to the Sales Channel ID in Omnitron and can be retrieved from the appropriate Omnitron.

OMNITRON_FAILED_CANCELLATION_REASON_ID

This setting refers to the Cancellation Reason ID from Omnitron, used when a package delivery fails and the seller initiates a cancellation request for a refund. These IDs can be created and retrieved via Omnitron > Settings > Reasons for Cancellation / Return.

OMNITRON_ALLOWED_CANCELLATION_REASON_IDS

This setting includes the list of Cancellation Reason IDs from Omnitron that sellers are permitted to use when rejecting an order item in the Seller Center. These IDs can be created and managed through Omnitron > Settings > Reasons for Cancellation / Return.

OMNITRON_REJECTED_CANCELLATION_REASON_ID

This setting defines the default rejection reason used when a seller rejects an order item without providing any of the IDs listed in OMNITRON_ALLOWED_CANCELLATION_REASON_IDS. Cancellation reasons can be configured via Omnitron > Settings > Reasons for Cancellation / Return.

COMMERCE_STORE_PAGE_DATA_WIDGET_ID

This setting represents the Widget Type ID used on the Store Management page in the Seller Center. Sellers use this widget to design their storefront homepages on the marketplace. Widget Types can be created in Omnitron. For more details, see:

COMMERCE_PRODUCT_RECOMMENDATION_WIDGET_ID

This setting indicates the Widget Type ID for the Product Collection widget, used on the Store Management page in the Seller Center. Widget Types can be created in Omnitron. For more details, refer to:

Click SAVE AND CONTINUE to install the Seller Center BE and FE applications into your selected project.

2. Complete Seller Center Configurations

After the installation is complete and the necessary configurations are made in ACC, all relevant data—such as the Catalog, Category Tree, Sales Channel, Attributes, Attribute Values, Attribute Sets, Order Cancellation Reasons, Cities, Townships, Districts, and more—will be automatically transferred from Omnitron to the Seller Center.

The Seller Center has two main user roles: Marketplace Owners (MPOs) and Sellers. By default, Omnitron Super Users are assigned the role of MPO in the Seller Center. Therefore, once the installation is complete, you can log in to the Seller Center using the Omnitron Super User credentials for the installed project as an MPO.

To ensure the Seller Center functions correctly, there are both mandatory and optional configurations that need to be completed. These configurations must be created and managed by MPOs, and will be explained in detail in the following sections.

Mandatory Configurations

Attribute Set & Category Mapping

To allow Sellers to create offers for specific categories, Attribute Sets must be mapped to Categories. This mapping ensures that Sellers are aware of the required attribute configurations for each category. As mentioned earlier, Attribute Set and Category Tree data are retrieved from Omnitron.

To perform the mapping:

1

Go to Settings in the Seller Center.

2

Open the Attribute Set & Category Mapping page.

3

You will see the category tree displayed in a hierarchical format. Each leaf category will have a dropdown menu.

4

These dropdowns contain the Attribute Sets created in Omnitron.

5

Select the most appropriate Attribute Set for each category and click SAVE.

Once the Attribute Set & Category Mapping is complete, the attributes defined within the mapped Attribute Sets will be activated and appear as filters in the application.

Delivery Settings

This configuration allows Sellers to choose from different shipping options as defined by the MPOs depending on various scenarios.

To configure delivery settings:

1

Select the most appropriate Attribute Set for each category and click SAVE.

2

Navigate to Settings in the Seller Center.

3

Open the Delivery Settings page.

4

Click on the + Add New Delivery Setting button.

5

Fill in the required fields and save.

All created delivery settings will be visible to every Seller.

If you intend to include a contracted shipping company as a Delivery Setting, the relevant Cargo Extension Application must be linked to the project in ACC.

A default callback delivery setting—displayed as "Other - Other"—is automatically created when the Seller Center is set up.

Offer Reject Reasons

This configuration allows MPOs to select reasons for rejecting Seller-created offers. These reasons will be visible on the corresponding marketplace product pages.

To create Offer Reject Reasons:

1

Go to Settings in the Seller Center.

2

Open the Offer Reject Reasons page.

3

Click on the + Add New Offer Rejection Reason button.

4

Complete the necessary fields and save.

Optional Configurations

Mail Configurations

The Seller Center sends email notifications to users (both Sellers and MPOs) on specific occasions—such as when a new order is received, a password reset is requested, or Seller documents are updated. MPOs can customize the brand name, sender email address, and Contact Us URL for these emails.

To configure email settings:

1

Navigate to Settings in the Seller Center.

2

Open the Dynamic Settings page.

3

Configure the following dynamic settings based on your brand’s needs:

Parameter
Description
Default Value

EMAIL_BRAND_TEXT

Sender name to appear in outgoing emails.

Akinon

DEFAULT_FROM_EMAIL

Email address from which emails will be sent.

noreply@akinon.com

EMAIL_CONTACT_URL

URL that opens when the “Contact Us” link in the email is clicked.

akinon.com

Seller Performance Metrics

Seller performance in the application can be evaluated based on specific metrics, helping to maintain high marketplace standards. The following metrics are available:

Metric
Description

Seller Cancel Rate

Percentage of orders canceled by the seller. Lower rates indicate higher reliability.

Customer Cancel Rate

Percentage of orders canceled by customers. High rates may point to product/service issues.

Shipment in Target Duration

Percentage of orders delivered within the expected delivery window. Timely deliveries enhance customer satisfaction.

Seller-Related Delivery Problems

Percentage of delivery issues caused by the seller. Lower rates indicate fewer problems.

To configure performance metrics and assign weights:

1

Go to Finance in the Seller Center.

2

Open the Seller Performance Metrics page.

3

Adjust the weight and related values for each metric as needed.

BuyBox Weight Configurations

BuyBox is a feature commonly found on eCommerce platforms that allows customers to add a product directly to their cart and make a purchase. It typically highlights the offer from the seller providing the best combination of price, shipping options, and customer service.

In the Seller Center, the BuyBox calculation is influenced by several factors, including the Seller Rating, Offer Pricing, and whether the seller is marked as Premium or not. MPOs can configure the weight of each factor accordingly.

To configure BuyBox weight settings:

1

Navigate to Settings.

2

Open the Dynamic Settings page.

3

Set the following parameters according to their descriptions:

Parameter
Description
Notes

PP_GRADE_WEIGHT

Weight of the Seller Rating in the BuyBox calculation.

Accepts a decimal value between 0 and 1

PP_PRICE_WEIGHT

Weight of the Seller’s Offer Price in the BuyBox calculation.

Accepts a decimal value between 0 and 1

PP_DATASOURCE_PREMIUM_POINT

The point value awarded to a seller marked as Premium in the BuyBox calculation.

PP_GRADE_VERSION

The version identifier for the BuyBox calculation logic.

Must be incremented by 1 whenever any related setting changes

PP_UPPER_LIMIT_RATIO

Maximum percentage limit for the price range of an upcoming offer compared to other marketplace offers for the same product.

PP_LOWER_LIMIT_RATIO

Minimum percentage limit for the price range of an upcoming offer compared to other marketplace offers for the same product.

Order Rejection Deductions

This configuration allows MPOs to define deduction rules for sellers when an order item is rejected. Deductions are applied to the seller’s commission earnings based on the selected rejection reason during the cancellation or return process.

To configure:

1

Navigate to Settings.

2

Open the Order Rejection Deductions page.

3

For each listed Cancellation / Return Reason, enter the deduction details that will be applied during seller reconciliation if that reason is selected.

Image Dimension Ranges

This configuration ensures that sellers upload product images within acceptable resolution limits, helping maintain visual consistency and quality across the platform.

To configure:

1

Navigate to Settings.

2

Open the Dynamic Settings page.

3

Set the following parameters based on the desired resolution guidelines (in pixels, defined by width x height):

Parameter
Description

MAX_IMAGE_DIMENSIONS

The maximum image resolution allowed for uploads to the Seller Center.

MIN_IMAGE_DIMENSIONS

The minimum image resolution allowed for uploads to the Seller Center.

3. Create Sellers in Seller Center

After completing the mandatory and optional configurations, you can proceed to add Sellers to the platform.

To create a new Seller:

1

Navigate to Finance.

2

Open the Seller Management page.

3

Click the + Add New Seller button.

4

Fill in the required information.

A password creation email will be sent to the address provided in the Seller Email Address field to allow the Seller to complete their account setup.

4. Manage Offers & Products in Seller Center

In the Seller Center, Sellers can create offers—containing price, stock, and attribute information according to the related category—using three different methods:

  • One by one

  • In bulk

  • From the Marketplace Catalog menu

In addition, MPOs have the ability to manage Seller-created offers. They can:

  • Approve offers

  • Reject offers

  • Resolve offers

You can find more information about offer and product management at the following links:

5. Manage Orders & Packages in Seller Center

In the Seller Center, if a Seller’s Auto Pack setting is enabled (True), the system automatically creates a package when an order is picked up.

For detailed information on managing orders and packages, refer to the following resources:

Integration APIs are also available for order and package operations:

Zero App Compatibility Note

If a project in ACC is linked to the Seller Center, the Product List and Product Detail pages in the associated Zero application must correctly display products and offers. It is essential to ensure that the item being added to the cart is a valid offer, not just a product.

For a step-by-step tutorial, please visit:

For detailed guidance, refer to:

Additional information about shipping rules and calculations is available at:

For more details, visit:

For detailed information on Seller Management, refer to:

For Sellers:

For MPOs:

Additionally, offer and product management can be handled via integration:

How to manage attribute set and category mapping
How to manage delivery settings in Seller Center
Shipping Rules Calculator
How to manage offer reject reasons in Seller Center
Seller Management Tutorial
How to Add Product Offers Using Bulk Actions
How to Use Offer Actions
Seller Center Products API
How to Manage Orders in Seller Center
How to Manage Packages in Seller Center
Orders API
Packages API
How to manage widget schema in Omnitron
How to manage widget schema in Omnitron