Sotrano panelindeki API Kaynak sayfası, bir tedarikçinin pazaryeri mağazasındaki ürün kataloğunu API üzerinden panelinize zamanlanmış görevlerle aktarmanızı sağlar. Görevde hangi kaynak hesabından okunacağını, ürünlerin nasıl işleneceğini (çalıştırma modu), barkod ve stok kodu öneklerini, kategori eşlemesini ve çalışma zamanını belirlersiniz. Bu rehber API Kaynak sayfasını, görev formunun tüm bölümlerini ve kategori eşlemesini anlatır.
Bu rehberde neler var?
- API Kaynak sayfası nedir?
- Yeni API içe aktarım görevi oluşturma
- Çalıştırma modları
- Kategori eşleme
- Görevi çalıştırma, düzenleme ve silme
- Dikkat etmeniz gerekenler
- Sık sorulan sorular
API Kaynak sayfası nedir?
Sol menüde İçe / Dışa Aktarım altındaki API menüsünden API Kaynak'ı açarsınız. Sayfada her içe aktarım görevi bir kart olarak listelenir:
- Görev adı, Aktif rozeti ve son çalışmanın durumu (örneğin completed).
- Kaynak pazaryeri ve hesap adı ile zamanlama ("Her 1440 dakikada bir tam senkronizasyon" gibi).
- Son içe aktarım zamanı.
- Kategoriler, Şimdi Çalıştır, Düzenle ve Sil düğmeleri. Görev etkinse ve stok senkronizasyonu açıksa kartta Stok Şimdi Çalıştır düğmesi de görünür.
Sağ üstteki Yeni İçe Aktarım Görevi düğmesi yeni görev başlatır.
Görevler, Kaynak Hesapları sayfasında tanımladığınız hesaplardan ürün okur.
Yeni API içe aktarım görevi oluşturma
Önce Kaynak Hesapları sayfasında tedarikçinin hesabını eklemiş olmalısınız. Sonra API Kaynak sayfasında Yeni İçe Aktarım Görevi'ne tıklayın.
Temel bilgiler
- Görev Adı: Görevi tanıyacağınız ad.
- Kaynak Hesabı: Ürünlerin okunacağı hesap (Hesap seçin listesi). Listede Trendyol, Hepsiburada, N11 ve Pazarama kaynak hesaplarınız görünür.
- Bağlı Tedarikçi (opsiyonel): Seçerseniz içe aktarılan ürünler bu tedarikçiye atanır.
- Varsayılan Kategori (opsiyonel): Kategorisi belirlenemeyen ürünler için kullanılır.
- Görsel Kullanımı: Uzak (kaynak URL'i kullan) ya da Yerel (indir ve sakla).
- Aktif: Görevin etkin olup olmadığı.
Barkod / Stok Kodu Öneki
Boş bırakılırsa yerel barkod ve stok kodu, kaynaktaki orijinal değerle aynı olur. Önekler farklı görevlerin ürün kodlarının çakışmasını önlemek için kullanılır:
- Barkod Öneki ve Stok Kodu Öneki: Barkodun ve stok kodunun başına eklenir.
- Model Kodu Öneki: Barkod ve stok kodundan farklı olarak çakışmayı önlemek için değil, ürünün hangi tedarikçiden geldiğini ayırt etmek için kullanılır. Yalnızca yeni oluşturulan modellere uygulanır, mevcut modellerin kodu değişmez.
- Barkodu Stok Kodu Olarak Kullan: Bazı satıcılar stok kodunu benzersiz girmez. Bu kutuyu işaretlerseniz kaynaktaki stok kodu yok sayılır ve barkod hem yerel stok koduna hem de tedarikçi stok koduna kaynak olur. Barkodu olmayan satırlarda eski davranış (önce stok kodu, yoksa barkod) geçerlidir. Zaten içe aktarılmış bir görevde sonradan açılırsa mevcut varyantları geriye dönük eşleştirmez.
Çalıştırma modları
Çalıştırma Modu bölümü, Tam Senkronizasyon'un daha önce içe aktarılmış bir ürüne ne yapacağını belirler. Fiyat ve stok bu ayardan bağımsız olarak her zaman güncellenir; yeni bir ürün ya da varyant her modda tam olarak oluşturulur.
- Tam Güncelleme (Üzerine Yaz): Kaynaktaki güncel değerler ürün üzerinde yapılmış elle değişiklikleri (isim, açıklama, kategori, marka, görsel, eşleme) geri yazar. Sayfa bu konuda "Dikkat" uyarısı verir.
- Sadece Yeni Ürün Ekle: Daha önce içe aktarılmış bir ürünün isim, açıklama, kategori ve marka bilgisi bir daha değiştirilmez. Yalnızca kaynakta yeni görülen ürünler ve zaten var olan bir ürüne eklenen yeni varyantlar işlenir.
- Sadece Özellik Eşleme Güncelle ve Görsel Güncelle: Bu iki seçenek yalnızca "Sadece Yeni Ürün Ekle" ile birlikte anlamlıdır. Mevcut bir ürünün eşlemesini ya da görsellerini isim ve açıklamasına dokunmadan tazelemek için işaretlenir.
- Tavsiye Edilen Satış Fiyatını Aktar: Yalnızca Tahsisli Katalog kaynağı için anlamlıdır. İşaretliyse yeni eklenen bir ürünün satış fiyatı tedarikçinin önerdiği değerle bir kez doldurulur; sonradan hiçbir çalıştırma bu değeri değiştirmez. İşaretli değilse satış fiyatı boş bırakılır ve fiyatı siz belirlersiniz.
Ölçüler
Ölçüleri Güncelle kutusu çalıştırma modundan bağımsızdır. Sayfaya göre hiçbir kaynak ağırlık, en, boy ve yükseklik verisi göndermez; bu yüzden hiçbir modda bu alanların üzerine yazılmaz. Kapalıyken (varsayılan) içe aktarılmış bir varyantın ağırlık, en, boy ve yükseklik alanları dokunulmadan korunur. Açıksa görev her çalıştırmada bu dört alanı boşaltır.
Test ürün limiti
Test Ürün Limiti (opsiyonel): Yalnızca Tam Senkronizasyon çalıştırıldığında uygulanır ve bir çalıştırmada oluşturulacak ürün sayısını sınırlar. Boş bırakılırsa sınır yoktur. İlk denemelerde küçük bir değer girmek işe yarar. Sadece Stok Senkronizasyonu ve Kategorileri Tara her zaman kaynağın tüm kataloğunu tarar.
Zamanlama
- Tam Senkronizasyon Zamanlaması: Zamanlama Türü olarak Günde bir kez (saat) ya da Her X dakikada bir seçersiniz. Değer alanına saat (HH:MM) ya da dakika yazarsınız (varsayılan 03:00).
- Sadece Stok Senkronizasyonu (opsiyonel): Ayrı bir stok-only zamanlaması etkinleştir kutusunu işaretlerseniz stoğu tam senkronizasyondan ayrı ve daha sık güncelleyebilirsiniz.
Formu tamamlayınca Kaydet'e tıklayın.
Kategori eşleme
Görev kartındaki Kategoriler düğmesi Kategori Eşleme sayfasını açar. Sayfa, kaynaktaki kategorileri numaralarıyla listeler. Kategorileri Tara düğmesi kategorileri kaynaktan günceller; tarama durumu bir rozetle ("Tamamlandı") görünür. Tablonun sütunları Kaynak Kategori, Ürün Sayısı, Mevcut Kategoriyle Eşle, Yeni Kategori Olarak Ekle ve Senkronize Edilecek'tir. Tümünü Etkinleştir ve Tümünü Devre Dışı Bırak düğmeleri toplu işlem yapar; değişiklikleri kaydedin. Kategori eşlemesi isteğe bağlıdır: önceden eşlemezseniz çalıştırma beslemedeki eksik kategorileri Sotrano'da kendisi oluşturur.
Görevi çalıştırma, düzenleme ve silme
- Şimdi Çalıştır: Zamanı beklemeden içe aktarımı hemen başlatır.
- Stok Şimdi Çalıştır: Yalnızca stoğu hemen günceller. Görev etkinse ve ayrı bir stok zamanlaması açıksa kartta görünür.
- Düzenle: Görevin ayarlarını aynı formda açar.
- Sil: Görevi siler.
Dikkat etmeniz gerekenler
- Tam Güncelleme elle yaptığınız değişiklikleri ezer: Ürünlerde isim, açıklama, kategori, marka, görsel ya da eşlemeyi elle düzenlediyseniz Sadece Yeni Ürün Ekle modunu tercih edin.
- İlk denemede Test Ürün Limiti kullanın: Önce küçük bir ürün sayısıyla çalıştırın, sonucu kontrol edin, sonra limiti kaldırın.
- Önek kullanın: Birden fazla kaynağınız varsa ürün kodlarının çakışmaması için her göreve farklı bir Barkod Öneki ya da Stok Kodu Öneki verin.
- Kategori eşlemesi isteğe bağlıdır: Kategorilerin mevcut kategorilerinizle eşleşmesini istiyorsanız ilk çalıştırmadan önce Kategoriler sayfasında eşleyin. Eşlemezseniz çalıştırma kaynaktaki eksik kategorileri kendisi oluşturur.
Sık sorulan sorular
Tam Güncelleme ile Sadece Yeni Ürün Ekle arasındaki fark nedir?
Tam Güncelleme her çalıştırmada kaynaktaki isim, açıklama, kategori, marka, görsel ve eşlemeyi ürüne geri yazar. Sadece Yeni Ürün Ekle daha önce aktarılmış ürünlerin bu bilgilerine dokunmaz; yalnızca yeni ürünleri ve mevcut ürünlere eklenen yeni varyantları işler. Fiyat ve stok her iki modda da güncellenir.
Kaynak Hesabı listesi boş geliyor.
Önce Kaynak Hesapları sayfasında tedarikçinin hesabını ekleyin.
Test Ürün Limiti ne işe yarar?
Bir tam senkronizasyonda en fazla kaç ürün oluşturulacağını sınırlar; deneme çalıştırmaları için kullanılır. Boş bırakırsanız sınır yoktur.
İlgili rehberler
- XML İçe Aktarım Rehberi: Tedarikçinin XML beslemesinden ürün almak için.
- API Kaynak Hesapları Rehberi: Tedarikçi hesabını eklemek için.
- Excel Toplu Güncelleme Rehberi: Ürünleri Excel dosyasıyla güncellemek için.
- XML Export Rehberi: Kendi kataloğunuzu XML olarak paylaşmak için.
- API ile Ürün Aktarma: Hesap ekleme ve ilk çalıştırmayı kısa adımlarla görmek için.
Sonuç
API Kaynak ile tedarikçinin pazaryeri kataloğunu panelinize otomatik alırsınız: kaynak hesabını seçin, çalıştırma modunu ve öneklerini belirleyin, kategorileri eşleyin ve zamanlamayı seçin. İlk denemede Test Ürün Limiti kullanmayı unutmayın. Takıldığınız bir adım olursa Sotrano destek ekibiyle iletişime geçebilirsiniz.
Henüz yorum yok