# Launch Your Marketplace with Seller Center

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.**

## <mark style="color:red;">1. Create a Seller Center in ACC</mark> <a href="#id-31mg8tcio8pa" id="id-31mg8tcio8pa"></a>

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.

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FiiLU01Ld7rBeXAVH3u3K%2F0.png?alt=media\&token=0377d020-2d04-4bc2-8d58-c0264d1660bd)

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:

<table><thead><tr><th width="247.9609375">Settings</th><th>Description</th></tr></thead><tbody><tr><td>OMNITRON_CATALOG_ID</td><td>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.</td></tr><tr><td>OMNITRON_CHANNEL_ID</td><td>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.</td></tr><tr><td>OMNITRON_FAILED_CANCELLATION_REASON_ID</td><td>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 <strong>Omnitron > Settings > Reasons for Cancellation / Return.</strong></td></tr><tr><td>OMNITRON_ALLOWED_CANCELLATION_REASON_IDS</td><td>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 <strong>Omnitron > Settings > Reasons for Cancellation / Return.</strong></td></tr><tr><td>OMNITRON_REJECTED_CANCELLATION_REASON_ID</td><td>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 <strong>Omnitron > Settings > Reasons for Cancellation / Return.</strong></td></tr><tr><td>COMMERCE_STORE_PAGE_DATA_WIDGET_ID</td><td><p>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:</p><p><a href="https://docs.akinon.com/tutorials/omnitron/sales-channels/content-management/how-to-manage-widget-schema-in-omnitron">How to manage widget schema in Omnitron</a></p></td></tr><tr><td>COMMERCE_PRODUCT_RECOMMENDATION_WIDGET_ID</td><td><p>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:</p><p><a href="https://docs.akinon.com/tutorials/omnitron/sales-channels/content-management/how-to-manage-widget-schema-in-omnitron">How to manage widget schema in Omnitron</a></p></td></tr></tbody></table>

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

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2F4w08yWuElHaSoZiZsTGs%2F1.png?alt=media\&token=104b2794-af67-49a3-bd6a-ce2424e2adba)

## <mark style="color:red;">2. Complete Seller Center Configurations</mark> <a href="#x3mjfi1fpq8z" id="x3mjfi1fpq8z"></a>

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.

### <mark style="color:red;">Mandatory Configurations</mark> <a href="#id-5ngxkz70as7" id="id-5ngxkz70as7"></a>

#### **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:

{% stepper %}
{% step %}
Go to **Settings** in the Seller Center.
{% endstep %}

{% step %}
Open the **Attribute Set & Category Mapping** page.
{% endstep %}

{% step %}
You will see the category tree displayed in a hierarchical format. Each leaf category will have a dropdown menu.
{% endstep %}

{% step %}
These dropdowns contain the Attribute Sets created in Omnitron.
{% endstep %}

{% step %}
Select the most appropriate Attribute Set for each category and click **SAVE**.
{% endstep %}
{% endstepper %}

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FmQEHgOIzFgNXnxhKKLVv%2F2.png?alt=media&#x26;token=5b5f3086-4482-44b9-8e99-75c2c54d35fa" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
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.
{% endhint %}

{% hint style="success" %}
For a step-by-step tutorial, please visit: [How to manage attribute set and category mapping](https://docs.akinon.com/tutorials/seller-center/marketplace-owner/settings/how-to-manage-attribute-set-and-category-mapping)
{% endhint %}

#### **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:

{% stepper %}
{% step %}
Select the most appropriate Attribute Set for each category and click **SAVE**.
{% endstep %}

{% step %}
Navigate to **Settings** in the Seller Center.
{% endstep %}

{% step %}
Open the **Delivery Settings** page.
{% endstep %}

{% step %}
Click on the **+ Add New Delivery Setting** button.
{% endstep %}

{% step %}
Fill in the required fields and save.
{% endstep %}
{% endstepper %}

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FhXwVzQDLyMpb2oLmZ1Td%2F3.png?alt=media\&token=f56c1061-ff5e-43e2-9428-92ade7131a64)

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FQFnUxur5vdlokR29b4IY%2F4.png?alt=media&#x26;token=e8d3d316-f741-4b0d-a733-2eef1fbc8440" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
All created delivery settings will be visible to every Seller.
{% endhint %}

{% hint style="warning" %}
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.
{% endhint %}

{% hint style="warning" %}
A default callback delivery setting—displayed as "Other - Other"—is automatically created when the Seller Center is set up.
{% endhint %}

{% hint style="success" %}
For detailed guidance, refer to: [How to manage delivery settings in Seller Center](https://docs.akinon.com/tutorials/seller-center/marketplace-owner/settings/how-to-manage-delivery-settings-in-seller-center)
{% endhint %}

{% hint style="success" %}
Additional information about shipping rules and calculations is available at: [Shipping Rules Calculator](https://docs.akinon.com/technical-guides/commerce/shipping-rules-calculator)
{% endhint %}

#### **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:

{% stepper %}
{% step %}
Go to **Settings** in the Seller Center.
{% endstep %}

{% step %}
Open the **Offer Reject Reasons** page.
{% endstep %}

{% step %}
Click on the **+ Add New Offer Rejection Reason** button.
{% endstep %}

{% step %}
Complete the necessary fields and save.
{% endstep %}
{% endstepper %}

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2Fu9uF4R41PlLHylfilIxo%2F5.png?alt=media&#x26;token=270e3eee-8071-43d4-bbdd-5e5817bfad05" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
For more details, visit: [How to manage offer reject reasons in Seller Center](https://docs.akinon.com/tutorials/seller-center/marketplace-owner/settings/how-to-manage-offer-reject-reasons-in-seller-center)
{% endhint %}

### <mark style="color:red;">Optional Configurations</mark> <a href="#m6dyu6vjq2n6" id="m6dyu6vjq2n6"></a>

#### **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:

{% stepper %}
{% step %}
Navigate to **Settings** in the Seller Center.
{% endstep %}

{% step %}
Open the **Dynamic Settings** page.
{% endstep %}

{% step %}
Configure the following dynamic settings based on your brand’s needs:

<table><thead><tr><th width="228.3828125">Parameter</th><th width="299.0625">Description</th><th>Default Value</th></tr></thead><tbody><tr><td><strong>EMAIL_BRAND_TEXT</strong></td><td>Sender name to appear in outgoing emails.</td><td>Akinon</td></tr><tr><td><strong>DEFAULT_FROM_EMAIL</strong></td><td>Email address from which emails will be sent.</td><td>noreply@akinon.com</td></tr><tr><td><strong>EMAIL_CONTACT_URL</strong></td><td>URL that opens when the “Contact Us” link in the email is clicked.</td><td>akinon.com</td></tr></tbody></table>

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2F2dTlNCbzhdPskNc2gM33%2F6.png?alt=media&#x26;token=0dbff6de-ba32-49eb-bdb3-87ea5ee50d15" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### **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:

<table><thead><tr><th width="282.03125">Metric</th><th>Description</th></tr></thead><tbody><tr><td><strong>Seller Cancel Rate</strong></td><td>Percentage of orders canceled by the seller. Lower rates indicate higher reliability.</td></tr><tr><td><strong>Customer Cancel Rate</strong></td><td>Percentage of orders canceled by customers. High rates may point to product/service issues.</td></tr><tr><td><strong>Shipment in Target Duration</strong></td><td>Percentage of orders delivered within the expected delivery window. Timely deliveries enhance customer satisfaction.</td></tr><tr><td><strong>Seller-Related Delivery Problems</strong></td><td>Percentage of delivery issues caused by the seller. Lower rates indicate fewer problems.</td></tr></tbody></table>

To configure performance metrics and assign weights:

{% stepper %}
{% step %}
Go to **Finance** in the Seller Center.
{% endstep %}

{% step %}
Open the **Seller Performance Metrics** page.
{% endstep %}

{% step %}
Adjust the weight and related values for each metric as needed.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FGzacD8Kuere5HEhQ71fS%2F7.png?alt=media&#x26;token=9cff6135-e7bd-455c-81dc-e05568ecfbaf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FLEIwDLlY7c031yjli7KB%2Fimage.png?alt=media&#x26;token=36d49131-d189-44a0-98e8-eca59771efda" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### **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:

{% stepper %}
{% step %}
Navigate to **Settings**.
{% endstep %}

{% step %}
Open the **Dynamic Settings** page.
{% endstep %}

{% step %}
Set the following parameters according to their descriptions:

<table><thead><tr><th width="231.69140625">Parameter</th><th width="258.76953125">Description</th><th>Notes</th></tr></thead><tbody><tr><td><strong>PP_GRADE_WEIGHT</strong></td><td>Weight of the Seller Rating in the BuyBox calculation.</td><td>Accepts a decimal value between 0 and 1</td></tr><tr><td><strong>PP_PRICE_WEIGHT</strong></td><td>Weight of the Seller’s Offer Price in the BuyBox calculation.</td><td>Accepts a decimal value between 0 and 1</td></tr><tr><td><strong>PP_DATASOURCE_PREMIUM_POINT</strong></td><td>The point value awarded to a seller marked as Premium in the BuyBox calculation.</td><td></td></tr><tr><td><strong>PP_GRADE_VERSION</strong></td><td>The version identifier for the BuyBox calculation logic.</td><td>Must be incremented by 1 whenever any related setting changes</td></tr><tr><td><strong>PP_UPPER_LIMIT_RATIO</strong></td><td>Maximum percentage limit for the price range of an upcoming offer compared to other marketplace offers for the same product.</td><td></td></tr><tr><td><strong>PP_LOWER_LIMIT_RATIO</strong></td><td>Minimum percentage limit for the price range of an upcoming offer compared to other marketplace offers for the same product.</td><td></td></tr></tbody></table>

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FtgmTMpyAFBN80OwUzZK1%2F9.png?alt=media\&token=690ebf8a-5aba-492d-9162-863226c68294)
{% endstep %}
{% endstepper %}

#### **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:

{% stepper %}
{% step %}
Navigate to **Settings**.
{% endstep %}

{% step %}
Open the **Order Rejection Deductions** page.
{% endstep %}

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

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FWYN9U8xCi2bx7rXWX2vq%2F10.png?alt=media\&token=b90b6e63-20b2-4ceb-8177-eb95cd10cbb5)

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2F1tFpmxIYeJxVFsQjXiyR%2F11.png?alt=media\&token=d4c79c16-d15c-4bc0-b2f1-c9fdb710d20d)
{% endstep %}
{% endstepper %}

#### **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:

{% stepper %}
{% step %}
Navigate to **Settings**.
{% endstep %}

{% step %}
Open the **Dynamic Settings** page.
{% endstep %}

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

<table><thead><tr><th width="246.60546875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>MAX_IMAGE_DIMENSIONS</strong></td><td>The maximum image resolution allowed for uploads to the Seller Center.</td></tr><tr><td><strong>MIN_IMAGE_DIMENSIONS</strong></td><td>The minimum image resolution allowed for uploads to the Seller Center.</td></tr></tbody></table>

![](https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FItJxy0pqwpwQ69CAIfrV%2F12.png?alt=media\&token=62f47c92-b489-4032-9052-f9cb7f0e94a0)
{% endstep %}
{% endstepper %}

## <mark style="color:red;">3. Create Sellers in Seller Center</mark> <a href="#id-3hlph9zbt1nz" id="id-3hlph9zbt1nz"></a>

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

To create a new Seller:

{% stepper %}
{% step %}
Navigate to **Finance**.
{% endstep %}

{% step %}
Open the **Seller Management** page.
{% endstep %}

{% step %}
Click the **+ Add New Seller** button.
{% endstep %}

{% step %}
Fill in the required information.
{% endstep %}
{% endstepper %}

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.

{% hint style="success" %}
For detailed information on Seller Management, refer to: [Seller Management Tutorial](https://docs.akinon.com/tutorials/seller-center/marketplace-owner/finance/seller-management)
{% endhint %}

## <mark style="color:red;">4. Manage Offers & Products in Seller Center</mark> <a href="#v0fhhnhzd86q" id="v0fhhnhzd86q"></a>

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

{% hint style="success" %}
You can find more information about offer and product management at the following links:

* For Sellers: [How to Add Product Offers Using Bulk Actions](https://docs.akinon.com/tutorials/seller-center/seller/products/how-to-add-product-offers-using-bulk-actions-in-seller-center)
* For MPOs:[ How to Use Offer Actions](https://docs.akinon.com/tutorials/seller-center/marketplace-owner/products/how-to-use-offer-actions-in-seller-center)
  {% endhint %}

{% hint style="success" %}
Additionally, offer and product management can be handled via integration: [Seller Center Products API](https://apidocs.akinon.com/seller-center/products)
{% endhint %}

## <mark style="color:red;">5. Manage Orders & Packages in Seller Center</mark> <a href="#elgc6bsndjtj" id="elgc6bsndjtj"></a>

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.

{% hint style="success" %}
For detailed information on managing orders and packages, refer to the following resources:

* [How to Manage Orders in Seller Center](https://docs.akinon.com/tutorials/seller-center/seller/orders/how-to-manage-orders-in-seller-center)
* [How to Manage Packages in Seller Center](https://docs.akinon.com/tutorials/seller-center/seller/orders/how-to-manage-packages-in-seller-center)
  {% endhint %}

{% hint style="success" %}
Integration APIs are also available for order and package operations:

* [Orders API](https://apidocs.akinon.com/seller-center/orders)
* [Packages API](https://apidocs.akinon.com/seller-center/packages)
  {% endhint %}

{% hint style="danger" %}

### Zero App Compatibility Note <a href="#id-5cey2hxsjw8b" id="id-5cey2hxsjw8b"></a>

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.
{% endhint %}