# How to Manage Address Mapping in Omnitron?

This tutorial provides step-by-step instructions for managing Address Mapping 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 Address Mapping Page​</mark> <a href="#step-2-navigate-to-address-mapping-page" id="step-2-navigate-to-address-mapping-page"></a>

* Follow the **Sales Channels>Sales Channel Settings** sidebar and click the **Address Mapping** page.<br>

  <figure><img src="/files/74Sg5HlgYwnHvw6zjpmh" alt=""><figcaption></figcaption></figure>
* During the initial configuration of the Omnitron project, the address mapping section is automatically set up, incorporating default Turkish data retrieved from the Post Telegraph Corporation.
* On the Address Mapping page, a wizard panel dedicated to the country, city, district, and neighborhood is provided. The existing mappings are listed at the bottom of the page.
* The listed mappings correspond to various integration types for the respective country, city, district, and neighborhood.

## <mark style="color:red;">Step 3: Upload Address Mapping with .CSV File​</mark> <a href="#step-3-upload-address-mapping-with-csv-file" id="step-3-upload-address-mapping-with-csv-file"></a>

* Before starting the address mapping update process, a template can be downloaded by clicking on the **.CSV download** button next to "Drop Files Here or Click to Upload." Following the template download, the updated order information can be entered into the CSV file.<br>

  <figure><img src="/files/z1tMYmDTIb9JLu13BVGn" alt=""><figcaption></figcaption></figure>
* The fields to be updated include:
  * **country\_name:** The country name should be entered.
  * **country\_code:** The relevant country code value should be added to the file.
  * **city\_name** : The city value to be added to the address mapping should be added to the file.
  * **township\_name** : The country name should be entered.
  * **district\_name** : The relevant district name value should be added to the file.
  * **Zipcode**: The zipcode value can be added.
* After preparing the file, take the action **Drop Files Here or Click to Upload**, and the bulk process will begin. Once the process is completed, the page will display the newly added mapping.<br>

  <figure><img src="/files/U6GZu4bSHAk3TlwZWi94" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 4: Navigate to Country Detail Page​</mark> <a href="#step-4-navigate-to-country-detail-page" id="step-4-navigate-to-country-detail-page"></a>

* Clicking on a specific entry in the current country list allows users to view details about the existing mapping, including the integration type used for its creation.
* The listed mappings correspond to various integration types specific to the respective country, city, district, and neighborhood.
* By clicking the **+ Add Mapping** button, a form is opened, and the following fields should be filled in:
  * **Code**: Enter the country code (e.g., TR, etc.).
  * **Integration** **Type**: Select the integration type to be used for mapping.<br>

    <figure><img src="/files/OGAZUAVxDYmZcLcW3vxk" alt=""><figcaption></figcaption></figure>
* After completing the relevant fields, click the **Save** button.<br>

  <figure><img src="/files/SfZeCTHmWDidzNK9KPoD" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 5: Navigate to City Detail Page​</mark> <a href="#step-5-navigate-to-city-detail-page" id="step-5-navigate-to-city-detail-page"></a>

* Users can view existing mappings by clicking on the city in the wizard panel.
* City names can be filtered based on the country.
* The mappings listed in this section correspond to various integration types specific to the respective country, city, district, and neighborhood.<br>

  <figure><img src="/files/ffbSlSf4BkdgX70WSK3s" alt=""><figcaption></figcaption></figure>
* When a particular entry in the current city list is clicked, detailed information about the existing mapping, including the integration type used for its creation, becomes visible.
* Clicking the **+ Add Mapping** button opens a form where the following fields need to be filled:
  * **Code**: Enter the city code.
  * **Integration Type**: Select the integration type to be used for mapping.
* Once the relevant fields are completed, click the **Save** button.<br>

  <figure><img src="/files/sdfQtV1J9aoXBbacsA86" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 6: Navigate to District Detail Page​</mark> <a href="#step-6-navigate-to-district-detail-page" id="step-6-navigate-to-district-detail-page"></a>

* Users can view existing mappings by clicking on the district in the wizard panel.
* The city and district names can be filtered according to the country.
* The mappings listed in this section correspond to a variety of integration types for the respective country, city, district, and neighborhood.<br>

  <figure><img src="/files/iq7HYVTxFiM5i4JB6tyf" alt=""><figcaption></figcaption></figure>
* When a particular entry in the current district list is clicked, detailed information about the existing mapping, including the integration type used for its creation, becomes visible.
* Clicking the **+ Add Mapping** button opens a form where the following fields need to be filled:
  * **Code**: Enter the district code.
  * **Integration Type**: Select the integration type for mapping.
* Once the relevant fields are completed, click the **Save** button.<br>

  <figure><img src="/files/LSxojXQBm2ZfRx6q7dnL" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 7: Navigate to Neighborhood Detail Page​</mark> <a href="#step-7-navigate-to-neighborhood-detail-page" id="step-7-navigate-to-neighborhood-detail-page"></a>

* Users can view existing mappings by clicking on the neighborhood in the wizard panel.
* The city, district, neighborhood names can be filtered according to the country.
* The mappings listed in this section correspond to a variety of integration types for the respective country, city, district, and neighborhood.<br>

  <figure><img src="/files/NKImFUUpoTEdwMT1DPXk" alt=""><figcaption></figcaption></figure>
* When a specific entry in the current neighborhood list is clicked, details about the existing mapping, including the integration type used for its creation, can be viewed.
* Clicking the **+ Add Mapping** button opens a form to fill in the following fields:
  * **Code**: Enter the neighborhood code.
  * **Integration Type**: Select the integration type for mapping.
* Once the relevant fields are completed, click the **Save** button.<br>

  <figure><img src="/files/COjFKeERvuXHWZvs2Tw5" alt=""><figcaption></figcaption></figure>


---

# 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-address-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.
