# Ürün yönetimi

Ürünler, kenar çubuğunda **Katalog** → **Ürünler** altında yer alır. Liste, aktif işletmenin API üzerinden sunduğu her şeyi gösterir; tek bir ürünü düzenlediğiniz yer ise ürün sayfasıdır. Bu ekranlardaki her şey aktif işletmeyle sınırlıdır: seçili bir işletme yoksa sayfada **Önce bir işletme seçin.** mesajı görünür.

## Ürün listesi

Ürünler sayfası, kataloğunuzu şu sütunlara sahip bir tabloda listeler: bir görsel küçük resmi (ürünün görseli yoksa gri bir yer tutucu kare), **Ad**, **SKU** (boşken `-` gösterir), **Durum** (bir durum etiketi) ve **Fiyat** (sağa hizalı). Ürün sayfasını açmak için bir satıra tıklayın (Ctrl/Cmd tuşuyla tıklamak yeni bir sekmede açar).

- **Arama** kutusu, siz yazdıkça listeyi filtreler (kısa bir gecikmeyle sunucu tarafında eşleştirilir).
- **Durum** filtre düğmesi listeyi **Taslak**, **Aktif** veya **Arşivlendi** ürünlerle daraltır; birlikte görmek için birden fazlasını işaretleyin.
- **Sıralama** için **Ad**, **SKU**, **Durum** veya **Fiyat** sütun başlıklarına tıklayın.
- **Sayfa başına satır** 25 (varsayılan), 50 veya 100 ürün gösterir. **Önceki** / **Sonraki** düğmelerini veya bir sayfa numarasını kullanın; alt bilgi toplam sayıyı gösterir.
- **Görünüm** sütunları gösterir veya gizler. Bkz. [Listelerle çalışma](/tr/docs/getting-started/index#listelerle-alma).

Hiç ürününüz yokken liste, başlamanız için **Yeni ürün** ve **CSV içe aktar** düğmeleriyle birlikte boş bir durum ("Henüz ürün yok") gösterir.

### Ürün durumları

| Durum | Anlamı |
| --- | --- |
| Taslak | Ürün mevcuttur ancak yayımlanmamıştır. Yeni ürünler burada başlar. |
| Aktif | Ürün yayındadır ve mağaza API'si üzerinden sunulur. |
| Arşivlendi | Ürün kullanımdan kaldırılmıştır ancak referans için saklanır. |

### Toplu işlemler

Toplu işlemleri açmak için ürünleri satır onay kutularıyla (veya başlıktaki tümünü seç onay kutusuyla) seçin:

- **Durumu ayarla**, bir **Yeni durum** (Taslak, Aktif veya Arşivlendi) sorar ve seçili her ürüne uygulamadan önce onayınızı ister.
- **Sil**, bir onay iletişim kutusundan sonra seçili tüm ürünleri kaldırır. Bu işlem yıkıcıdır.

### CSV içe ve dışa aktarma

- **CSV dışa aktar**, kataloğunuzu `products.csv` olarak indirir. Dışa aktarma başarısız olursa satır içinde "Dışa aktarma başarısız oldu." mesajı görünür.
- **CSV içe aktar**, **Ürünleri içe aktar** iletişim kutusunu açar. Başlık satırı içeren bir `.csv` dosyası seçin ve **İçe aktar** düğmesine tıklayın. İçe aktarma upsert mantığıyla çalışır: sonuç, kaç satırın **oluşturuldu**, **güncellendi** ve **başarısız** olduğunu, her hata için satır bazında bir hata mesajıyla ("Satır {n}: ...") bildirir. Dosya içe aktarılırken bir yükleme çubuğu görünür. Her satır başarılı olduğunda iletişim kutusu sonuçla ("136 oluşturuldu, 0 güncellendi.") kendiliğinden kapanır ve liste yenilenir; başarısız satırlar varsa kutu hatalarıyla açık kalır ve kapattığınızda liste yenilenir. Her içe aktarmadan sonra dosya temizlenir; ikinci kez içe aktarmak için dosyayı yeniden seçin.

Dosyanın sütunları `id`, `capability`, `name`, `slug`, `sku`, `barcode`, `status`, `price_amount`, `compare_at_amount`, `currency`, `description` ve `categories` şeklindedir. `capability` değeri `standard` (Ürün) veya `made_to_measure` (Ölçüye göre) olur; iki tutar da alt birimdedir (19,90 için `1990`). Geçerli bir dosya elde etmenin en kolay yolu önce dışa aktarıp o dosyayı düzenlemektir.

**CSV içe aktar**, başka bir platformun ürün dışa aktarımını olduğu gibi de okur; böylece dosyayı önce düzenlemeden bir mağazayı Borkol'a taşıyabilirsiniz:

- **Shopify** (Products → Export → CSV): her handle için seçenekleri ve varyantlarıyla bir ürün, fiyatlar, karşılaştırma fiyatları, SKU'lar, barkodlar, ağırlıklar, etiketler, SEO başlığı ve açıklaması ile kategori yolu olarak Shopify ürün kategorisi.
- **WooCommerce** (Ürünler → Dışa aktar): varyasyonlarıyla basit ve değişken ürünler, normal ve indirimli fiyat, kategoriler ve etiketler.
- **Diğer her tablo** (Lightspeed, Magento, bir tedarikçi listesi, bir feed dışa aktarımı): `Title`, `Name`, `Productnaam` veya `Ürün adı` gibi bir ürün adı sütunu olmalıdır; fiyat, SKU, barkod, açıklama, kategori, etiket ve görsel sütunları İngilizce, Felemenkçe ve Türkçe adlarından tanınır. Ayırıcı olarak virgül, noktalı virgül ve sekme kullanılabilir.

Dosyadaki hiçbir veri kaybolmaz. Kendi Borkol alanı olmayan sütunlar (marka, maliyet fiyatı, pazar başına fiyatlar, metafield'lar, stok) özgün adlarıyla ürünle birlikte saklanır. Mağazanızda gösterilmezler ve [Pazarlama](/tr/docs/marketing/index) bunları gerçek ürünleriniz hakkında senaryo yazmak için kullanır. Dosyadaki görsel URL'leri arka planda [medya kitaplığına](/tr/docs/products/media) indirilir ve özgün sıralarıyla, alt metinleriyle birlikte ürüne eklenir; ürünün zaten bir ana görseli yoksa ilki ana görsel olur. İndirme sırasında köşedeki bir bildirim bir çubukla birlikte **Görseller indiriliyor: 12 / 946** gösterir; başka bir sayfaya geçtiğinizde veya yeniden yüklediğinizde kalır ve kaç görselin eklendiğini, kaçının indirilemediğini söyleyerek biter. İndirilemeyen bir görsel atlanır; yeniden içe aktardığınızda erişilebilir hâle geldiyse eklenir. Bir Shopify dışa aktarımındaki varyant görselleri (`Variant Image` sütunu) de kendi varyantına bağlanır: bu genellikle ürün görsellerinden biridir, değilse galerinin sonuna eklenir. Mağazanız, müşteri varyantı seçtiğinde bu görseli gösterebilir. Aynı dışa aktarımı yeniden içe aktarmak, yinelenen ürün eklemek yerine bu ürünleri günceller. Metaobject'lere işaret eden Shopify metafield'ları (örneğin yorum öğeleri) dışa aktarımda içeriklerini değil yalnızca handle'larını taşır.

## Ürün oluşturma

1. Ürünler sayfasında **Yeni ürün** düğmesine tıklayın.
2. Ekran **Ne satıyorsunuz?** diye sorar ve "Bu seçim ürünün hangi bölümlere sahip olacağını belirler. Daha sonra değiştirilemez." açıklamasını gösterir. Kartlardan birini seçin:

   | Kart | Anlamı |
   | --- | --- |
   | Ürün | Olduğu gibi satılır: tek fiyat veya kendi SKU ve fiyatı olan beden, renk gibi seçenekler. Her zaman sunulur. |
   | Ölçüye göre | Fiyat ölçülere ve seçenek tercihlerine göre belirlenir (örn. genişlik x yükseklik tablosu), siparişe göre üretilir. Yalnızca işletmeniz için Yapılandırıcı modülü etkin olduğu sürece sunulur. Bkz. [Varyantlar ve yapılandırıcı](/tr/docs/products/variants-and-configurator#yaplandrc). |

3. Başlık artık "Ürün olarak satılıyor" (veya "Ölçüye göre olarak satılıyor") gösterir; kartlara dönmek için **Değiştir** düğmesine tıklayın. **Bilgiler** bölümünü doldurun: **Ad** zorunludur (aksi halde "Ürüne bir ad verin."), **Açıklama** isteğe bağlıdır.
4. Başlıktaki **Kaydet** düğmesine tıklayın. Ürün taslak olarak oluşturulur ve diğer tüm bölümlerin kullanılabilir olduğu ürün sayfasına yönlendirilirsiniz.

Ürün oluştururken artık slug yazmazsınız: mağaza adresi addan türetilir (ikinci bir "T-shirt" `t-shirt-2` olur). Adresi daha sonra [Arama ve sosyal medya](#arama-ve-sosyal-medya) altında değiştirin. İlk ekranda seçtiğiniz şey kalıcıdır; aynı şeyi diğer yolla satmak için yeni bir ürün oluşturun.

## Ürün sayfası

Ürün sayfası tek bir düzenleyicidir: bir başlık, bir bölüm sütunu ve sağda bir kenar çubuğu (küçük ekranlarda bölümlerin altında).

### Başlık ve Kaydet

Başlık; geri okunu, ürün adını, durum etiketini, bir **Kaydet** düğmesini ve bir **Diğer işlemler** menüsünü ("⋯" düğmesi) gösterir.

- **Tüm sayfa için tek Kaydet.** İstediğiniz kadar bölümü düzenleyin; başlık **Kaydedilmemiş değişiklikler** gösterir ve **Kaydet** değiştirdiğiniz her bölümü sırayla kaydeder. Kaydetme sürerken düğmede **Kaydediliyor…** yazar; ardından başlık **Kaydedildi** gösterir.
- **Başarısız bir kaydetme düzenlemelerinizi korur.** Başlık "Kaydedilemedi. Değişiklikleriniz duruyor." gösterir ve sayfa başarısız olan bölüme kayar, daraltılmışsa açar ve hatayı alanın altında gösterir. Hatadan önce kaydedilen bölümler kayıtlı kalır.
- **Kaydedilmemiş değişikliklerle ayrılmak önce sorar.** Geri oku (veya tarayıcınızın geri düğmesi) bir **Kaydedilmemiş değişiklikler** iletişim kutusu açar; **Değişiklikleri at** kaydetmeden ayrılır.
- **Sil**, **Diğer işlemler** menüsündedir. **Ürünü sil** iletişim kutusu '"{name}" silinsin mi? Bu işlem geri alınamaz.' diye sorar ve sizi ürün listesine döndürür.

Bazı bölümler, başlıktaki **Kaydet** yerine değişiklikleri anında kaydeden kendi düzenleyicileridir: **Görseller**, **Seçenekler ve varyantlar** ve yapılandırıcı kartları. Her biri kendi kaydını doğrular.

Ürünün satış biçimi işletmeniz için kapalıysa, başlığın altındaki bir uyarı şeridi bunu bildirir, örneğin "Ölçüye göre kapalı; bu ürün satın alınamaz." Ürün düzenlenebilir kalır; modül yeniden etkinleştirilene kadar satın alınamaz.

Ürün silinmişse sayfa, **Ürünlere dön** bağlantısıyla birlikte "Bu ürün mevcut değil (silinmiş olabilir)." mesajını gösterir.

### Bölümler

Hangi bölümleri göreceğiniz, ürünün ne olduğuna ve işletmenizin hangi modüllere sahip olduğuna bağlıdır:

| Bölüm | Ne zaman görünür | İçeriği |
| --- | --- | --- |
| Bilgiler | Her zaman | **Ad** ve **Açıklama**. |
| Görseller | Her zaman | Medya kitaplığından seçilen ürün görselleri. Bkz. [Medya](/tr/docs/products/media). |
| Fiyatlandırma | Her zaman | **Fiyat** (Ölçüye göre ürünlerde **Temel fiyat**), **Karşılaştırma fiyatı**, **Birim** ve **Para birimi**. |
| Stok ve kargo | Her zaman | **SKU**, **Barkod (EAN/GTIN)**, **Stoğu takip et**, **Kargo gerektirir** ve **İade edilebilir** anahtarları, **Ağırlık (gram)** ve **Stok miktarı**. |
| Seçenekler ve varyantlar | Yalnızca Ürün | Seçenekler ve oluşturulan varyantlar. Bkz. [Varyantlar ve yapılandırıcı](/tr/docs/products/variants-and-configurator). |
| Toplu fiyatlandırma | Yalnızca Ürün, başta daraltılmış | Müşteri grubu ve adet başına fiyatlar. Bkz. [Toplu fiyatlandırma](#toplu-fiyatlandrma). |
| Boyutlar, Fiyat kuralları, Seçenek grupları | Ölçüye göre, Yapılandırıcı modülüyle | Yapılandırıcı. Bkz. [Varyantlar ve yapılandırıcı](/tr/docs/products/variants-and-configurator#yaplandrc). |
| Teklif | Satış modülüyle | Ürünün nasıl satın alınabileceği. Bkz. [Teklif](#teklif). |
| Arama ve sosyal medya | Her zaman, başta daraltılmış | Meta başlık ve açıklama, adres, Google önizlemesi ve sosyal medya görseli. Bkz. [Arama ve sosyal medya](#arama-ve-sosyal-medya). |

Kenar çubuğunda **Durum**, **Etiketler**, **Kategoriler**, **KDV sınıfı** (yalnızca Web mağazası modülüyle) ve **Teslim süresi** bulunur.

### Ürün alanları

| Alan | Bölüm | Açıklama |
| --- | --- | --- |
| Ad | Bilgiler | Zorunlu. |
| Açıklama | Bilgiler | İsteğe bağlı serbest metin. |
| Fiyat | Fiyatlandırma | Ana birimde tutar; ondalık için nokta veya virgül kullanılır (`19.99` veya `19,99`); başka bir giriş "12,90 gibi bir tutar girin." mesajını gösterir. Varyantlı bir üründe, her varyantın geçersiz kılabileceği varsayılan fiyattır. |
| Temel fiyat | Fiyatlandırma | Yalnızca Ölçüye göre ürünlerde, **Fiyat** yerine: ürünün boyutu yoksa başlangıç fiyatıdır. Seçenek tercihleri bunun üzerine eklenir; bir boyut tablosu oluşturulduğunda tablo fiyatı onun yerini alır. |
| Karşılaştırma fiyatı | Fiyatlandırma | İsteğe bağlı. "Üstü çizili gösterilen eski fiyat. Fiyattan yüksek olmalıdır." |
| Birim | Fiyatlandırma | Bir miktarın ne anlama geldiği: **Adet** (varsayılan), **Kilogram**, **Gram**, **Litre**, **Metre**, **Metrekare (m²)**, **Metreküp (m³)** veya **Saat**. Bkz. [Birimler ve ondalık miktarlar](#birimler-ve-ondalk-miktarlar). |
| Para birimi | Fiyatlandırma | **EUR**, **USD** veya **GBP**. Halihazırda başka bir para birimine sahip bir ürün, onu ek bir seçenek olarak korur. |
| SKU | Stok ve kargo | İsteğe bağlı stok kodu. |
| Barkod (EAN/GTIN) | Stok ve kargo | İsteğe bağlı. |
| Stoğu takip et | Stok ve kargo | Bu ürünün satışlarının stoktan düşülüp düşülmeyeceği. Kapalıysa ürün, bir stok kaydı olsa bile sınırsız satılır. |
| Kargo gerektirir | Stok ve kargo | Ürünün kargoyla gönderilip gönderilmediği. Açıksa **Ağırlık (gram)** görünür. |
| İade edilebilir | Stok ve kargo | Ürünün iade edilip edilemeyeceği. |
| Ağırlık (gram) | Stok ve kargo | Tam sayı olarak gram. |
| Stok miktarı | Stok ve kargo | Yalnızca Stok modülüyle, **Stoğu takip et** açıkken ve varyantı olmayan bir üründe (varyantların kendi stoğu vardır). Yer tutucu: "Boş = takip edilmiyor". 0 veya üzeri, en fazla 3 ondalık basamakla; aksi halde "Stok 0 veya üzeri olmalı ve en fazla 3 ondalık basamak içermelidir." |
| Durum | Kenar çubuğu | **Taslak**, **Aktif** veya **Arşivlendi**. |
| Etiketler | Kenar çubuğu | Serbest etiketler. Bir etiket yazın ve Enter'a (veya virgüle) basın; kaldırmak için etiketin üzerindeki çarpıya tıklayın. |
| Kategoriler | Kenar çubuğu | Her kategori kendi adıyla ve altında üst yoluyla görünür (tam yol üzerine gelince). **Kategori ekle** bir seçici açar: bir kategorinin yanındaki okla seviye seviye gezin veya tüm seviyelerde aramak için yazın; eklemek ya da kaldırmak için bir kategoriye tıklayın. Kategorideki çarpı da onu kaldırır. Hiç kategori yokken kart "Henüz hiçbir kategoride değil." gösterir. Kategori ağacını [Kategoriler](/tr/docs/products/categories) altında yönetin. |
| KDV sınıfı | Kenar çubuğu | **Varsayılan KDV sınıfı** veya "Ad (oran%)" biçiminde gösterilen vergi sınıflarınızdan biri. Yalnızca Web mağazası modülüyle. Vergi sınıfları [Ayarlar → Vergiler](/tr/docs/workspace/settings#vergiler) altında yönetilir. |
| Teslim süresi (gün) | Kenar çubuğu | 0 ile 365 arasında tam sayı gün. "Siparişin gönderilmesi için gereken gün sayısı. Boş = hemen gönderilir." |

Ürün fiyatlanamadığı sürece (fiyat yoksa veya fiyat kuralı olmayan boyutlar varsa) **Durum** alanını **Aktif** yapmak reddedilir. **Durum** kartı bu durumda "Yayınlanmadı: {reason}" gösterir ve ürün eski durumunu korur.

### Birimler ve ondalık miktarlar

**Birim**, ürünün miktarlarının her yerde nasıl sayılacağını belirler: sepetlerde, siparişlerde, tekliflerde ve stokta. **Adet** birimli bir ürün tam sayılarla satılır; diğer her birim en fazla 3 ondalık basamak kabul eder, böylece bir müşteri 0,75 kg satın alabilir ve bir teklif 64,5 m² içerebilir. Satır toplamı, birim fiyat çarpı miktarın kuruşa yuvarlanmış halidir. Paneldeki miktar alanları hem ondalık virgülü hem de noktayı kabul eder (`0,75` veya `0.75`).

### Toplu fiyatlandırma

**Toplu fiyatlandırma** bölümü (yalnızca Ürün), "Müşteri grubu başına sabit fiyatlar ve miktar indirimleri." belirler. Her satırda şunlar bulunur:

| Alan | Açıklama |
| --- | --- |
| Grup | **Herkes** veya kişi gruplarınızdan biri ([Kişiler](/tr/docs/customers/index#kii-gruplar) altında yönetilir). |
| Varyant | **Tüm varyantlar** veya belirli bir aktif varyant. Bu sütun yalnızca ürünün aktif varyantları olduğunda görünür. Pasife aldığınız bir varyant, onu hâlâ kullanan bir satırda "(pasif)" işaretiyle görünür kalır. |
| Min. adet | Bu fiyatın geçerli olmaya başladığı minimum adet. 1 veya daha büyük bir tam sayı olmalıdır. |
| Fiyat | O grup ve adet için geçerli fiyat. |

Satır eklemek için **Fiyat ekle** düğmesini, satır kaldırmak için çöp kutusu simgesini kullanın, ardından başlıktaki **Kaydet** ile kaydedin. Kaydetme, grup fiyatlarının tamamını tek seferde değiştirir. Herkes için adet 1 olan bir satır kaydedemezsiniz: "Herkes için adet 1'de belirlenen fiyat temel fiyattır, bunu ürünün kendisinden ayarlayın." Hiç satır yokken bölüm "Henüz grup fiyatı yok. Ürünün temel fiyatı herkes için geçerlidir." mesajını gösterir.

### Teklif

Satış modülü etkinken **Teklif** bölümü ürünün **Satın alınabilirlik** ayarını belirler: **Yalnızca doğrudan ödeme** (varsayılan), **Yalnızca teklif** veya **Doğrudan ödeme ve teklif**. Teklif seçenekleri yalnızca [Satış → Ayarlar → Teklifler](/tr/docs/sales/settings#teklif-talepleri) altında teklif talepleri açıkken devreye girer; o zamana kadar bölüm "Teklif talepleri Satış → Ayarlar → Teklifler altında kapalı; siz etkinleştirene kadar bu ürün doğrudan ödemeyle satılır." mesajını gösterir. Satış modülü yoksa bölüm görünmez ve her ürün doğrudan ödemeyle satılır.

### Arama ve sosyal medya

**Arama ve sosyal medya** bölümü (başta daraltılmış), ürünün arama sonuçlarında ve paylaşıldığında nasıl görüneceğini belirler:

| Alan | Açıklama |
| --- | --- |
| Meta başlık | Arama motorlarının gösterdiği başlık. Boşsa ürün adı kullanılır. Bir sayaç uzunluğu 60 karaktere göre gösterir. |
| Meta açıklama | Başlığın altındaki metin parçası. Boşsa açıklamanın başı kullanılır. Bir sayaç uzunluğu 160 karaktere göre gösterir. |
| URL adı | Ürünün mağaza adresi (`/products/{handle}`). "Adresi değiştirdiğinizde ziyaretçiler eski adresten yenisine yönlendirilir." |
| Google önizlemesi | Arama sonucunun canlı önizlemesi: adres, başlık ve açıklama, Google'ın keseceği yerden kesilmiş olarak. |
| Sosyal medya görseli | Ürün paylaşıldığında gösterilen görsel: **Ana görsel** (varsayılan) veya ürünün görsellerinden biri. "Ürün paylaşıldığında gösterilir. Başka bir görsel seçmek için Medya bölümüne görsel ekleyin." |

**URL adı** alanını değiştirip kaydettiğinizde eski adres çalışmaya devam eder: yönlendirme sorgusunu kullanan bir mağaza, ziyaretçileri yeni adrese gönderir. Aynısı bir kategorinin slug'ı için de geçerlidir. Bir mağazanın bunu nasıl kullandığını görmek için [SEO API referansına](/tr/api/catalog/seo) bakın.

### Ürün önizleme

Sağ altta kayan **Ürün önizleme** düğmesi, mağaza tarzı bir panel açar: görsel karuseli (veya "Görsel yok"), ad, hesaplanan fiyat, bir adet seçici ve satır toplamını gösteren bir **Sepete ekle** düğmesi. Ölçüye göre bir üründe canlı yapılandırıcıyı çizer ve siz girişleri değiştirdikçe kalem bazında dökümü olan bir sunucu fiyat teklifi getirir.

Önizleme, satıcı olarak sizin için yalnızca görüntüleme amaçlıdır: **Sepete ekle** düğmesi hiçbir şey yapmaz ve gerçek mağazada sunucu, fiyatları her zaman sepet aşamasında yeniden hesaplar. Mağazanızın ürünleri nasıl tükettiğini görmek için [API referansına](/tr/api/getting-started/authentication) bakın.