# How to Manage Marketplace Mapping in Omnitron?

This tutorial provides step-by-step instructions for managing Marketplace Mapping operations in Omnitron.

## <mark style="color:red;">Step 1: Access to Omnitron​</mark> <a href="#step-1-access-to-omnitron" id="step-1-access-to-omnitron"></a>

* Get access to the **Omnitron** panel.
* Enter your *Username* and *Password*, and then click the **Sign In** button.\
  ![](https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F1vHxDfgVEkGGgp6rJNgZ%2Fimage.png?alt=media\&token=fe888f40-f38b-4ace-82e8-67fdb6870fd4)

## <mark style="color:red;">Step 2: Navigate to Marketplace Mapping Menu​</mark> <a href="#step-2-navigate-to-marketplace-mapping-menu" id="step-2-navigate-to-marketplace-mapping-menu"></a>

* Follow the **Sales Channels** sidebar and click on the **Sales Channel Settings** menu.
* Click on the **Marketplace Mapping** cardbox to reach the **Marketplace Mapping** menu.

{% hint style="info" %}
**Marketplace Mapping** cardbox appears only when the selected sales channel type is **not** web. In other words, for *Marketplace-type* of sales channels (*Unified* included), this cardboard appears.
{% endhint %}

<figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F0sOsGZTBGcjhZWDkcHdq%2Fimage.png?alt=media&#x26;token=e89c3dcd-e04e-4731-ae20-634838a0a11b" alt=""><figcaption></figcaption></figure>

* On the **Marketplace Mapping** menu,
  * Omnitron Attribute Values and Marketplace Attribute Values can be mapped on the **Mapper** page,
  * Defined Marketplace Mappings can be controlled product by product on the **Mapping Control** page,
  * Marketplace Attributes and Marketplace Attribute Values can be seen on **Marketplace Attributes** and **Marketplace Attribute Values** pages.<br>

    <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F2jhAefy9WiXhW9uApmSu%2Fimage.png?alt=media&#x26;token=cceb9acc-72ee-4418-83fe-39bb0327f1d3" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 3: View/Filter Marketplace Attributes​</mark> <a href="#step-3-viewfilter-marketplace-attributes" id="step-3-viewfilter-marketplace-attributes"></a>

* Clicking on the **Marketplace Attributes** cardbox on the **Marketplace Mapping** menu, the **Marketplace Attributes** page can be seen.
* Users can;
  * view the *Name* of the Marketplace Attributes,
  * filter Marketplace Attributes with respect to *Attribute Name and/ or Attribute Set* values on the **Marketplace Attributes** page.<br>

    <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FxER4FYl0DpO0ZDmkhHVh%2Fimage.png?alt=media&#x26;token=575cb6cf-4508-4b51-aca5-39105de10f25" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
In addition to *Name,* after being filtered with *Attribute Set, Remote ID, Is Required, Is Variant, Is Custom, Is Meta, Attribute Set Name, Updated Date* columns can be seen, too.
{% endhint %}

<figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2Fdqq0BUffm1ZNSOVqjK49%2Fimage.png?alt=media&#x26;token=2c6f92f5-cdfb-47e5-a8b4-ebadd7c81245" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 4: View/Filter Marketplace Attribute Values​</mark> <a href="#step-4-viewfilter-marketplace-attribute-values" id="step-4-viewfilter-marketplace-attribute-values"></a>

* Clicking on the **Marketplace Attribute Values** cardbox on the **Marketplace Mapping** menu, the **Marketplace Attribute Values** page can be seen.
* Users can;
  * view the *Primary Key (PK), Attribute, Attribute Value’s Label, Attribute Value, Updated Date* of the Marketplace Attribute Values.
    * **Primary Key:** ID of the relevant attribute value, has to be unique.
    * **Attribute*****:*** Attribute that the relevant attribute value depends on.
    * **Attribute Value’s Label:** Label of the attribute value. For example, there can be an attribute value with a label of “White” and a value of “0001”. In other words the *Name* of the attribute value.
    * **Attribute Value:** Attribute Value identifier, has to be unique.
  * filter Marketplace Attribute Values with respect to *Attribute Label, Attribute, and/ or Attribute Set* values on the **Marketplace Attribute Values** page.<br>

    <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F7oIF0B03UX41FugnTDdT%2Fimage.png?alt=media&#x26;token=753f7d07-22ae-430e-a17d-bd5800c48d4f" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 5: View/Filter Mapping Rules on Mapper Page​</mark> <a href="#step-5-viewfilter-mapping-rules-on-mapper-page" id="step-5-viewfilter-mapping-rules-on-mapper-page"></a>

* Clicking on the **Mapper** cardbox on the **Marketplace Mapping** menu, the **Mapper** page can be seen. Users have the option to view, filter, add/edit Mapping Rules for related marketplace.
  * *A Mapping Rule can be described as the mapping between an Omnitron Attribute and a Marketplace Attribute.*
* Users can;
  * view the *Mapping Rule Name, Creation Date, Update Start Date* of Mapping Rules,
  * filter Mapping Rules with respect to *Rule Set Name, Target Attribute, Target Attribute Set, Creation Date and Updated Date*
    * *Target = Marketplace, Source = Omnitron*
  * add a New Mapping Rule,
  * edit an existing Mapping Rule,
  * delete one / multiple Mapping Rule(s) on the **Mapper** page.<br>

    <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F1rUtaaRblDQP7UjyPwzg%2Fimage.png?alt=media&#x26;token=27166b37-d62f-43f7-8a7f-66ebcf505804" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 6: Add/Edit Mapping Rule​</mark> <a href="#step-6-addedit-mapping-rule" id="step-6-addedit-mapping-rule"></a>

* Clicking on **+ Add New Attribute Mapping Rule** button or clicking on the **Edit** icon on listed Mapping Rules, users can reach the **Add/Edit Attribute Mapping Rule** form.
* Users can;
  * name the *Mapping Rule*,
  * select the *Target Attribute*,
  * select the relevant *Mapping Method,*
  * select a default value for mapping in case an error occurs for the mapping rule.
* Target Attributes (Marketplace Attributes) can be filtered by clicking on the *“Show only required target attributes”* checkbox.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F2HDaIi0HQTBbnPsbS2Xt%2Fimage.png?alt=media&#x26;token=63b2922b-a30e-45fa-a65c-5c0e15086ba5" alt=""><figcaption></figcaption></figure>

There are four different types of *Mapping Methods* available in **Marketplace Mapping Rule Form**:

**Standard:​**

In which an Omnitron Attribute & Attribute Values are mapped directly with the Marketplace Attribute & Attribute Values.

{% hint style="info" %}
In *Standard* *Mapping Method*, if both the Source (Omnitron) and Target (Marketplace) Attributes’ data types are “*dropdown”*, an auto-mapping is performed with respect to the attribute values. Auto-mapped attribute values can be distinguished from the corresponding green checkbox icon.
{% endhint %}

This feature can be used only for **Adding a New Mapping Rule**.

<figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FJzDPX8Ksk0duAV7IJPPO%2Fimage.png?alt=media&#x26;token=105dfbaf-9b4f-4e45-a4de-66407890edb6" alt=""><figcaption></figcaption></figure>

**Fixed Value:​**

In which a fixed attribute value can be given to selected Marketplace Attribute for all Marketplace Products.

<figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FB1XJCM1KQnspP1vnRsJc%2Fimage.png?alt=media&#x26;token=ac5a5ad7-be66-4d31-a266-88a51cd8f097" alt=""><figcaption></figcaption></figure>

**Merge Fields:​**

In which multiple fixed values and / or Omnitron attributes can be concatenated and are mapped with the selected Marketplace Attribute.

<figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FxTNV4s6xRmLkmKkFgyoH%2Fimage.png?alt=media&#x26;token=142bc4e5-677f-410e-bbec-c23df7fd93ad" alt=""><figcaption></figcaption></figure>

**Custom:​**

In which a JSON Type of configuration can be given for the mapping of Marketplace Attribute.

<figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FmiZQ8YYW0hXsxoQlR1v6%2Fimage.png?alt=media&#x26;token=47fcadc2-4a50-4409-94b6-442667202178" alt=""><figcaption></figcaption></figure>

* After the relevant *Mapping Method* and mapping configuration are filled out, by clicking on the **Save** button, a Mapping Rule can be created/edited.
* By clicking on the **Clear the Rule** button, relevant Mapping Rule can be cleared. In other words, the mapping rule still exists, but without any configuration.

## <mark style="color:red;">Step 7: Delete Mapping Rule​</mark> <a href="#step-7-delete-mapping-rule" id="step-7-delete-mapping-rule"></a>

* On the **Mapper** page, by selecting the listed Mapping Rules, the “Delete Selected Mapping Rule(s)” option and clicking on the **Apply** button, users can delete existing Mapping Rule(s).<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FBAca164WRdBaoU1n1lXD%2Fimage.png?alt=media&#x26;token=19715748-e8be-4fad-abc3-f0acecd29647" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 8: Control Marketplace Mapping​</mark> <a href="#step-8-control-marketplace-mapping" id="step-8-control-marketplace-mapping"></a>

* Clicking on the **Mapping Control** cardbox on the **Marketplace Mapping** menu, the **Mapping Control** page can be seen.
* Users can;
  * view the products that are in the Marketplace Catalog with respect to their all attributes, SKU, Base Code, Category, etc information,
  * filter the Marketplace-Catalog products with respect to all-product-attributes,
  * preview & Download the Marketplace Attributes and Marketplace Attribute Values for filtered products on the **Mapping Control** page.<br>

    <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FcEMgfyvwak5o7yBQzr6l%2Fimage.png?alt=media&#x26;token=55067930-b9f5-467a-b649-e5493824c86f" alt=""><figcaption></figcaption></figure>
* After filtering the Marketplace-Catalog Products, clicking on the **Show Mapping Result** button opens the Mapping Control pop-up, in which the Marketplace Attributes and Marketplace Attributes can be seen and downloaded by the user.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FpZVk3jG1VFNJBjMqrAsO%2Fimage.png?alt=media&#x26;token=cf928512-59e1-47ee-aad1-dfaea8992bad" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This menu is only available for sales-channel-type of Marketplaces.
{% endhint %}
