> For the complete documentation index, see [llms.txt](https://docs.useoly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.useoly.com/urun-icerigi/imports/create-import.md).

# Import bağlantısı oluşturma

Yedi adımlı sihirbazda kaynak, bağlantı, veri yapısı, kurallar ve son kontrol.

**İçeri Aktarma → Yeni Bağlantı** yedi adımlı bir sihirbaz açar. Üstteki adım göstergesi tamamlanan adıma dönmenizi sağlar; ileri adımlar gerekli koşullar tamamlanana kadar seçilemez. **Geri** girdiğiniz bilgileri aynı oturumda korur.

![REST, CSV ve Excel seçeneklerinin bulunduğu Kaynak Tipi adımı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-9eb5675ad8cfb1ec9299e29eb2068199f5713f7f%2Fcreate-import-source.png?alt=media)

*Kaynak türü sonraki bağlantı alanlarını belirler; daha sonra türü değiştirirseniz dosyadan türetilen önizleme ve öneriler temizlenir.*

## 1. Kaynak Tipi

* **Bağlantı Adı** zorunludur ve listede görünür. CSV/Excel'de boş bırakırsanız geçerli dosya adı başlangıç adı olarak kullanılabilir.
* **Açıklama** isteğe bağlıdır; kaynağın sahibi, kapsamı veya kullanım amacını yazmak ileride doğru bağlantıyı seçmeyi kolaylaştırır.
* **REST API**, **CSV Dosya** veya **Excel Dosya** seçeneklerinden yalnız birini seçin.

Kaynağı “gelecekte kullanabilirim” düşüncesiyle seçmeyin. Sihirbaz yalnız seçilen kaynağın gerçekten desteklediği bağlantı ve önizleme davranışını kaydeder.

## 2. Bağlantı

### CSV ve Excel dosyası

Dosyayı sürükleyin veya yükleme alanını seçin. Seçilen dosyanın adı ve boyutu görünür; kaldırıp başka dosya seçebilirsiniz.

![Örnek CSV yüklendikten sonra görünen dosya ayarları](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-a21069b3b78bc05e6aa313c5ed279b135b797cab%2Fupload-file.png?alt=media)

*Ayırıcı, kodlama ve başlık satırı kaynak kolonlarının doğru okunmasını belirler.*

* **Ayırıcı** CSV sütunlarını bölen karakterdir. Oly virgül, noktalı virgül, sekme ve dik çizgiyi algılamaya çalışır; önizleme tek sütun görünüyorsa doğru ayırıcıyı elle seçin.
* **Kodlama** karakterlerin nasıl okunacağını belirler. Türkçe harfler bozuksa UTF-8 yerine dosyanın gerçek kodlamasını seçin; Türkçe ve Windows kodlamaları sunulur.
* **İlk satır başlık** açıksa ilk satır veri değil alan adı kabul edilir. Kapalı dosyada alanları sütun konumuna göre tanımlamanız gerekir.
* Excel çalışma kitabında birden fazla sayfa varsa import edilecek sayfayı seçin. Formüller yerine kaydedilmiş hücre değerlerinin güncel olduğundan emin olun.

![CSV'nin ilk satırlarının veri yapısı için hazırlanmış önizlemesi](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-a21069b3b78bc05e6aa313c5ed279b135b797cab%2Ffile-preview.png?alt=media)

*Önizleme, gerçek çalışmayı başlatmadan kolonların ve örnek değerlerin okunup okunmadığını gösterir.*

Desteklenmeyen uzantı, eski `.xls`, bozuk çalışma kitabı, yanlış dosya imzası veya 50 MB sınırı yükleme sırasında reddedilir. `.xls` dosyasını `.xlsx` olarak yeniden kaydetmek yalnız uzantıyı değiştirmek değildir; dosyayı Excel uygulamasından yeni biçimde kaydedin.

### REST bağlantısı

![REST bağlantısında adres, yöntem, kimlik doğrulama ve sayfalama ayarları](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-3fb01606111b03957e5fb28975170c605b885caf%2Frest-connection-settings.png?alt=media)

*Gizli değerleri açıklamaya veya dokümanlara kopyalamayın; yalnız bağlantının güvenli alanlarına girin.*

* **Endpoint URL** zorunludur ve ürün listesini döndüren adresi belirtir.
* **Method**, kaynağın beklediği GET veya POST çağrısıdır.
* Kimlik doğrulama **Yok**, **Basic**, **Bearer** veya **API Key** olabilir. Seçiminize göre kullanıcı adı/parola, token ya da anahtar ve başlık adı alanları açılır.
* **Pagination** açıksa sayfa parametresi, limit parametresi, sayfa boyutu ve toplam kayıt yolu kaynağa göre ayarlanır. Yanlış değer aynı sayfayı tekrar okumaya veya kayıt atlamaya yol açabilir.
* Özel başlık ve sorgu parametresi satırları anahtar/değer olarak eklenir; boş satırları kaldırın.
* **Bağlantıyı Test Et** kaydetmeden önce erişimi ve örnek yanıtı kontrol eder. Başarıda yanıt süresi ve bulunan kayıt sayısı; hatada erişim durumu ve güvenli hata özeti görünür.

Test başarısızsa adresi, kimlik doğrulamayı ve ağ erişimini düzeltmeden ilerlemeyin. Kaynak gizli değerleri test sonucuna veya screenshot'a kopyalamayın.

## 3. Veri Yapısı

![Düz Liste seçilmiş örnek CSV'nin yol ve SKU kontrolleri](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-d755822492a1b55b91437cfc47227813f4956d0b%2Fdata-structure.png?alt=media)

*Sol önizlemedeki bir alana tıklamak yol yazmayı kolaylaştırır; sağdaki alanlar Oly'nin ürün ve varyant sınırını nasıl kuracağını belirler.*

* **İç İçe**, her ürün kaydının içinde bir varyant listesi olduğunda kullanılır. Ürünler yolu, ürün SKU yolu, varyantlar yolu ve varyant SKU yolu ayrı tanımlanır.
* **Düz Liste**, her satır bir ürün/varyant olduğunda kullanılır. Aynı ana ürüne ait satırlar **Gruplama Anahtarı** ile bir araya gelir.
* **Ürünler Yolu**, asıl ürün dizisinin yanıt içindeki yeridir. Dosya veya yanıt doğrudan listeyse boş bırakılabilir.
* **SKU Yolu** zorunludur; ürünün benzersiz ana stok kodunu gösterir.
* **Gruplama Anahtarı**, düz listedeki satırların hangi ana ürün altında toplanacağını belirler. Yanlış alan farklı ürünleri birleştirebilir.
* **Basit** SKU doğrudan bir alandan gelir. **Kural Tabanlı**, koşullara göre birden fazla kaynak alanı ve yedek davranışı kullanır; kurallar sırayla değerlendirilir.

Alt bilgi tespit edilen ürün sayısını gösterir. Beklediğinizden çok az veya çoksa ürün yolu, başlık, grup anahtarı ve ayırıcıyı yeniden kontrol edin.

## 4–5. Eşlemeler

**Alan Eşleme** kaynak kolonlarını ürün alanlarına, ürün/varyant seviyesine ve yazma davranışına bağlar. **Kategori Eşleme** hangi Oly kategorisinin ve dolayısıyla ürün tipinin kullanılacağını belirler. Yoğun kontroller ve seçenek çözümleme [Alan, görsel ve kategori eşleme](/urun-icerigi/imports/field-and-category-mapping.md) sayfasında açıklanır.

## 6. Import Kuralları

![SKU çakışması, dil ve otomatik onay kontrollerinin bulunduğu Import Kuralları adımı](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-99ff2333fcf52a0f0a2f1f53e3b558823d4844b5%2Fimport-options.png?alt=media)

*Varsayılan davranış mevcut SKU'yu güncellemek, tek dil kullanmak ve otomatik onayı kapalı tutmaktır.*

### SKU Çakışması

* **Güncelle (birleştir)** aynı ana SKU bulunursa eşlenmiş alanları yazma modu ve boş hücre kuralına göre günceller. Kaynağın yetkili sistem olduğundan emin olun.
* **Atla** mevcut SKU'ya dokunmaz; çalışma sonucu kaydın atlandığını gösterir.

### Dil Ayarları

* **Varsayılan Dil**, dil eki olmayan çevrilebilir değerlerin hangi dile yazılacağını belirler.
* **Tek Dil**, bütün çevrilebilir kaynak alanlarını varsayılan dilde yorumlar.
* **Çok Alanlı**, `name_tr`, `name_en` gibi dil sonekli ayrı kolonları kullanır. Dil kodu olmayan veya çalışma alanında etkin olmayan sonek eşlenmez.

### Zamanlama ve delta

**Zamanlama** yalnız REST kaynağında görünür ve bağlantıyı saatlik, 6/12 saatlik, günlük veya haftalık aralıkla otomatik çalıştırır. Saat dilimi çalışmanın hangi yerel zamana göre planlanacağını belirler. CSV/Excel bağlantısı kullanıcı tarafından yeniden çalıştırılır.

**Delta Senkronizasyon** yalnız REST kaynağında görünür ve yalnız değişen kayıtları ister. Açıldığında kaynaktaki zaman alanını ve tarih biçimini girin. Yanlış alan yolu veya biçim değişikliklerin atlanmasına ya da tekrar işlenmesine yol açar. İlk kurulumda tam çalışmayla taban oluşturmak daha güvenlidir.

### Otomatik onay ve import

**Otomatik Onayla**, engelleyici hatası olmayan kayıtları kullanıcı incelemesi olmadan **Aktarıma Hazır** durumuna geçirir. Kapalı olması güvenli varsayılandır. Açtığınızda ek uyarı görünür.

**Otomatik Import Et** yalnız otomatik onay açıkken görünür; uygun kayıtları Staging'de bekletmeden kataloğa aktarır. Kaynak, eşlemeler ve SKU çakışma davranışı uzun süredir doğrulanmadıkça açmayın.

## 7. Gözden Geçir & Kaydet

![Dosya, veri yapısı, eşleme ve kuralların özetlendiği son adım](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-a7f3720b7ac5f442ecc9ca83f35defd8f79091cc%2Fimport-review-start.png?alt=media)

*Düzenle bağlantısı ilgili adıma döner; özet kaydedilecek davranışı son kez karşılaştırmak içindir.*

Ad, kaynak, dosya/bağlantı, veri yapısı, alan eşlemeleri, kategori kuralları ve import seçeneklerini kontrol edin. Kaynak alanı henüz eşlenmediyse özet bunu `0` olarak gösterir; zorunlu hedefleri tamamlamadan çalıştırmak sorunlu Staging kayıtları üretebilir.

* REST kaynağında **Kaydet** bağlantıyı oluşturur; çalışmayı ayrıca başlatırsınız.
* CSV/Excel'de **Yükle ve Çalıştır** bağlantıyı oluşturur ve ilk çalışmayı başlatır. Başarıda çalışma detayına yönlendirilirsiniz.
* Kayıt başarısızsa aynı düğmeye arka arkaya basmayın; görünen hata mesajını düzeltin ve bağlantı listesinde bir kayıt oluşup oluşmadığını kontrol edin.

## Yetki ve güvenlik

Bağlantı oluşturma ve değiştirme Admin, Manager veya Editor yetkisi ister. Viewer'ın doğrudan URL ile sihirbazı görebilmesi kaydetme yetkisi olduğu anlamına gelmez.

Parola, token veya anahtarları bağlantının ilgili gizli alanı dışında açıklamaya, alan eşlemesine veya ekran görüntüsüne yazmayın.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.useoly.com/urun-icerigi/imports/create-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.