# 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.\
  ![](https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2Fh7kPjia0MJz5ofkrnPBL%2Fimage.png?alt=media\&token=aa433379-bed3-4c30-bc96-60bda96e9468)

## <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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F0Ny8CnrgK1svPASGLXUk%2Fimage.png?alt=media&#x26;token=00535109-4ec4-4c52-8ffd-078615616889" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2Fs9viDbxZtswBvTOmOWup%2Fimage.png?alt=media&#x26;token=8be89d04-4563-4931-b6f4-40bc415d234d" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FfqePmTh7xF88jzYWhcIO%2Fimage.png?alt=media&#x26;token=746ab0b2-0cff-4dfd-8f5b-e1e7a0f77b2a" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FAyMOruP0IodLgQmykmwq%2Fimage.png?alt=media&#x26;token=753425a6-eef7-4754-b2be-01932a043300" alt=""><figcaption></figcaption></figure>
* After completing the relevant fields, click the **Save** button.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FfFil6s3xpx7hIgDJyyE0%2Fimage.png?alt=media&#x26;token=c09c5e6c-5a53-4e1f-94be-a0892340d115" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FAyDZEk1nFtS66eBs4jtO%2Fimage.png?alt=media&#x26;token=ebc485b1-1a37-4a68-9719-73f854dd3fa5" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FDs1UEysFUI9K6ljxHKIu%2Fimage.png?alt=media&#x26;token=1cc40344-e03f-4be1-8f68-0edab173206f" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FmZscryQ6uJXa4LHcPoHQ%2Fimage.png?alt=media&#x26;token=cd388b47-cd43-4f23-913b-e36b59e74fbe" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FxbT4g79fQplM7oF8BYdY%2Fimage.png?alt=media&#x26;token=558269e1-0f9f-41cb-8589-77e54ddcd5e3" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FRKFBpv6yaxmAUyPz6OTT%2Fimage.png?alt=media&#x26;token=6757c837-5f9a-422a-ab8a-38fe4c8f0ec7" 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="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FIMbda22xpMQxPi97mykm%2Fimage.png?alt=media&#x26;token=4c6da26c-83c5-4d42-8a1c-e22652e5b3f5" alt=""><figcaption></figcaption></figure>
