# Ürün Kataloğu

Senkronize ürünleri görüntüleme ve arama
Kaynak: https://selwise.com/docs/product-feeds/catalog

Beslemenin senkronize ettiği ürünleri **Selwise'in gördüğü hâliyle** listeler. Öneri, arama ve ürün zenginleştirme yüzeylerinin tamamı bu tablodaki veriyi kullanır — bu yüzden "widget'ta fiyat yanlış görünüyor" ya da "ürün aramada çıkmıyor" gibi bir sorunun ilk bakılacak yeri burasıdır.

## Panelde nerede

Sol menüde **Katalog → Ürün Listesi** (Catalog → Products); besleme ekranındaki **Content** (İçerik) sekmesi de aynı sayfadır. Satır, kenar çubuğunda bir kanal seçili olmadan gri durur ("Select a channel first").

Liste **organizasyonunuzun tüm feed'lerinin** ürünlerini gösterir, yalnızca seçili kanalınkileri değil; **Channel** sütunu her ürünü hangi kanalın feed'inin getirdiğini söyler. Paylaşılan bir katalog, sahibinin altında bir kez görünür. Ürünleri görmek `admin` rolünün yetkisidir (`feed:view_products`); `marketing` rolünde liste yüklenmez (`403`).

## Ne işe yarar

Katalog senkronizasyonu tek yönlüdür: besleme dosyanız kaynaktır, bu tablo sonuçtur. Sayfa hiçbir şeyi düzenlemez — burada gördüğünüz bir değeri değiştirmek için beslemenizi düzeltip yeniden senkronize etmeniz gerekir (bkz. [Alan Eşleştirme](/docs/product-feeds/field-mapping)).

Sayfanın değeri tam olarak bu okunurluğundadır: beslemenizdeki bir alanın Selwise tarafında hangi değere dönüştüğünü doğrulamanın tek yeri.

## Filtreler

| Filtre | Ne yapar |
|---|---|
| Arama ("Search by name, SKU, or description...") | Ürün adı, ürün kodu, SKU ve açıklama içinde, büyük/küçük harf ayırmadan arar |
| Durum (**All Status** / **In Stock** / **Out of Stock**) | **In Stock** hem stok bayrağı hem **adet 0'dan büyük** olan ürünleri getirir; **Out of Stock** stok bayrağı kapalı **ya da** adedi 0 veya altı olanları |

Filtreler adres çubuğuna yazılır (`?search=...&inStock=true&page=2`), yani bir sonucu bağlantı olarak paylaşabilirsiniz. Filtre değiştirdiğinizde sayfalama 1'e döner. Sayfa başına 20 ürün listelenir; sıralama en son güncellenen ürünü üstte tutar. Altta "Showing 1 to 20 of N results" ve önceki/sonraki düğmeleri vardır.

> **Durum etiketi ile filtre aynı kuralı kullanmaz**
>
> Tablodaki **In Stock** / **Out of Stock** etiketi yalnızca stok bayrağını okur. **In Stock** filtresi ise ek olarak adedin 0'dan büyük olmasını ister; yalnızca `availability` gönderen ve adet taşımayan bir feed'de bayrağı açık olan ürünler filtrede çıkmayabilir.

## Kolonlar

| Kolon | Nereden gelir |
|---|---|
| **Product** | Görsel ve başlık — beslemedeki `title` ve `imageUrl` |
| **Channel** | Ürünü getiren feed'in kanalı |
| **SKU** | `sku` alanı; öneri ve zenginleştirme eşleştirmesinde kullanılan kod |
| **Price** | `price`, varsa üstü çizili `originalPrice` ile; para biriminde |
| **Stock** | `inStock` ve — beslemede varsa — adet |
| **Actions** | **Details** düğmesi ve satırı açan **Show mapped fields** (Eşlenen alanları göster) oku |

**Show mapped fields** satırı genişletir: **Catalogue fields** (ürün kodu `itemCode`, sepet kodu, ürün grubu `groupCode`, marka, kategoriler, ürün tipi, kategori hiyerarşisi, para birimi, indirim oranı, puan, değerlendirme sayısı, ek görsel sayısı, stok adedi, ürün adresi) ve **Custom feed fields** — beslemenin Selwise'in tanımadığı, ama yakaladığı alanlar. Her özel alanın yanındaki kopyala simgesi `${attr.<ad>}` yer tutucusunu panoya alır; bunu bir [ürün zenginleştirme](/docs/product-enrichment/product-attributes) bloğunda kullanırsınız. Ürünün hiç özel alanı yoksa "This feed carries no extra fields for this product." yazar.

**Details** düğmesi ürünün tamamını yandan açılan panelde gösterir (**Product Details**): **Live Preview**, **About this product** (açıklama), indirim rozeti, stok, **Last Sync**, **Source Channel**, **Visit Product Page** bağlantısı ve **Developer JSON** bölümünde ham kaydın kendisi.

> **Geliştirici JSON, eşleştirme hatalarının en kısa yolu**
>
> Beslemenizde doğru göründüğü hâlde bir alan widget'ta boş geliyorsa, o ürünün **Developer JSON** çıktısına bakın. Alan orada da boşsa sorun eşleştirmede, doluysa sorun widget yapılandırmasındadır.

## Ürün kodu, her şeyin anahtarı

Bu tablodaki ürün kodu (`itemCode`; besleme tarafında `id` eşleşmesi) ve `sku`, platformdaki diğer her şeyin ürünle kurduğu bağdır:

- **Sipariş takibi** — gönderdiğiniz sipariş satırlarındaki kod bu kodlarla eşleşmezse ciro ürüne atfedilemez.
- **Ürün zenginleştirme** — kural kodları burada bulunmazsa blok hiç render edilmez.
- **Veri aktarımı** — doğrulama adımının bildirdiği eşleşme oranı, aktarılan siparişlerin kodlarının bu tabloyla ne kadar örtüştüğüdür.

Kodlarınız iki tarafta farklı yazılıyorsa (biri `SKU-1`, diğeri `sku_1`) hiçbir yüzey çalışmaz ama hiçbiri hata da vermez. Bir ürün kodunu buradan arayıp bulamıyorsanız, diğer taraf o kodu görmüyor demektir.

## Neden boş

| Belirti | Neden |
|---|---|
| "No products found" ve filtreler dolu | Filtreleriniz eşleşmiyor — **Clear Filters** (Filtreleri Temizle) ile deneyin |
| Filtresiz de boş | Besleme hiç senkronize olmadı ya da başarısız oldu; **Manage Feeds** (Feed'leri Yönet) ile durumu kontrol edin |
| Satır gri, sayfaya girilemiyor | Bu ekran kanal seçimi gerektirir; üstteki kanal seçicisinden bir kanal seçin |
| Sayfa `403` | Rolünüz ürün listesini görmeye yetkili değil (`marketing`) |
| Ürünler var ama fiyatlar eski | Senkronizasyon aralığı kadar gecikme normaldir (bkz. [Zamanlama](/docs/product-feeds/scheduling)) |

## İlgili sayfalar

- [Besleme Kurulumu](/docs/product-feeds/setup) — beslemeyi bağlama ve ilk senkronizasyon
- [Alan Eşleştirme](/docs/product-feeds/field-mapping) — bu kolonların hangi besleme alanından geldiğini belirleme
- [Besleme Sorunları](/docs/product-feeds/troubleshooting) — katalog gelmiyor, eksik geliyor, yanlış geliyor
- [Varyant Gruplama](/docs/product-feeds/variant-grouping) — ürün grubu anahtarı ve sepete ekleme kodu