# 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.\
  ![](/files/FQgto2ESMuyyETj02bTx)

## <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="/files/iFSdyKZoi1PLU0edrQ6m" 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="/files/YGIaqIvASfR6WS7X59Zj" 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="/files/PvGiBXlBqiwvIX5b3W75" 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="/files/3v45FoCkPnKAxZUH1sTx" 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="/files/4RoPjzSBkiu8r6YLRBM2" 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="/files/Nfkycs4rJZjZFii6YhAr" 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="/files/qvvDeKidztVQ3v8qjgGm" 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="/files/iCPFfWA2PPXsBo6A4M3X" 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="/files/DBVwjCdepO19G9Ww4OZ4" 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="/files/rT32IlaJ2LXqsEkLKZeS" alt=""><figcaption></figcaption></figure>

**Custom:​**

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

<figure><img src="/files/eAufAvJtcCELPNiwuPJw" 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="/files/YfN7ujAf25HqbAJCznBa" 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="/files/akwGf1Vhv0Zgu04BQw9v" 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="/files/9GbsGqMqwqPYS8FeWNGH" alt=""><figcaption></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akinon.com/tutorials/omnitron/sales-channels/sales-channel-settings/how-to-manage-marketplace-mapping-in-omnitron.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.