Tanım
Bu özellik, pazaryerlerinden gelen siparişlerdeki ürünlerin Narius sisteminde tanımlı ürünlerle eşleşmesini sağlamak için kullanılan Pazaryeri Ürün Anahtarları tablosunu otomatik olarak doldurmaya yarar.
Pazaryeri Ürün Anahtarı Nedir?
Pazaryerlerinden sipariş okunurken, sipariş ile gelen ürünlerin Narius sistemindeki ürün kartlarıyla eşleşmesi gerekmektedir. Bu eşleştirme için her ürünün, satıldığı her pazaryeri için bir Pazaryeri Anahtarı değerine ihtiyacı vardır. Bu anahtar değer, Ürün Kartı sayfasındaki Pazaryeri Ürün Anahtarları sekmesinde yer alan tabloda saklanır.
Özelliğin Amacı
Pazaryeri Ürün Anahtarları tablosundaki veriler el ile veya excel dosyalarını içe aktarılarak doldurulabilmektedir. Ancak şu dört pazaryeri için bu bilgi otomatik olarak pazaryerinden okunabilir:
- Hepsiburada
- Shopify
- Teknosa
- MediaMarkt
Bu zamanlanmış görev, yukarıdaki pazaryerlerinde tanımlı olan ancak Narius sisteminde Pazaryeri Anahtarı eksik olan ürünleri tespit eder. Ardından ürünün Narius'taki bilgilerini (kodu, barkodu) kullanarak pazaryerinden ilgili ürünü bulur ve pazaryeri anahtar bilgisini otomatik olarak tabloya kaydeder.
Ön Koşullar
Bu özelliğin çalışabilmesi için aşağıdaki koşulların sağlanması gerekmektedir:
Pazaryeri Tanımlamaları
- İlgili pazaryeri (Hepsiburada, Shopify, Teknosa veya MediaMarkt) için E-Ticaret API Anahtarları sayfasında tanımlı ve aktif kayıt bulunmalıdır
- Pazaryeri bağlantı bilgileri (API erişim bilgileri) eksiksiz girilmiş olmalıdır (E-Ticaret API Anahtarları)
Ürün Kartı Gereksinimleri
- Ürün kartı aktif durumda olmalıdır
- Ürün kartında E-Ticaret Kullanım seçeneği işaretli olmalıdır
- Ürün kodu dolu olmalıdır
- Teknosa ve MediaMarkt pazaryerleri için: Ürün barkodu mutlaka dolu olmalıdır (Teknosa ve MediaMarkt üzerinde ürün araması barkod ile yapılır)
- Hepsiburada ve Shopify için: Ürün kodu yeterlidir (bu pazaryerlerinde ürün araması ürün kodu ile yapılır)
Pazaryeri Ürün Anahtarı Durumu
İlgili pazaryeri için "Ürün Kartları" sayfasında bulunan "E-Ticaret Ürün Anahtarları" sekmesinde yer alan listede
- Bir satır bulunmalıdır
- Bu satırın Pazaryeri Anahtarı alanı boş olmalıdır
İşlem Adımları
Zamanlanmış Görevin Çalışma Mantığı
- Görev, belirlenen zaman aralıklarıyla otomatik olarak çalışır
- Her çalıştığında sistemde tanımlı aktif pazaryerlerini kontrol eder
- Sadece Hepsiburada, Shopify, Teknosa ve MediaMarkt pazaryerleri işleme alınır
Her Pazaryeri İçin İşlem Akışı
- Seçilen pazaryerine ait aktif ve e-ticaret kullanımı açık olan ürünler listelenir
- Bu ürünlerden Pazaryeri Anahtarı boş olanlar tespit edilir
- Her ürün için sırayla aşağıdaki adımlar gerçekleştirilir:
- Ürünün Narius'taki kodu (Teknosa ve MediaMarkt için barkodu) kullanılarak pazaryerinde arama yapılır
- Pazaryerinde ürün bulunursa, pazaryerine özgü anahtar bilgileri alınır
- Bu bilgiler belirlenen formata göre düzenlenir
- Pazaryeri Ürün Anahtarları tablosundaki ilgili kayıt güncellenir
İlerleme Takibi
Zamanlanmış Görevler sayfasından ilerleme durumu takip edilebilir.
Dikkat Edilmesi Gereken Hususlar
Pazaryerine Göre Anahtar Formatları
Her pazaryerinin kendine özgü bir anahtar formatı vardır. Sistem bu formatları otomatik olarak uygular:
Shopify Formatı
Shopify'da ürünler hem bir ürün anahtarına (product id) hem de varyant anahtarına (variant id) sahiptir. Bu bilgiler şu şekilde saklanır:
- Eğer hem ürün anahtarı hem varyant anahtarı varsa:
urun_key<>varyant_key - Eğer sadece ürün anahtarı varsa:
urun_key
Örnek: 7234567890123<>42345678901234
Hepsiburada Formatı
Hepsiburada'da ürünler için öncelik varyant anahtarına (HepsiburadaSKU) verilir:
- Eğer varyant anahtarı varsa:
varyant_keykullanılır - Eğer varyant anahtarı yoksa:
urun_keykullanılır
Örnek: HBV00004Q1JJ
Teknosa Formatı
Teknosa'da ürünler hem EAN (barkod) hem de teklif ID'si (offer id) ile tanımlanır:
- Eğer hem ürün anahtarı hem varyant anahtarı varsa:
urun_key::varyant_key - Eğer sadece ürün anahtarı varsa:
urun_key
Örnek: 8690000123456::987654321
Not: Teknosa'da arama yapılırken mutlaka ürünün barkod bilgisi kullanılır. Bu nedenle Narius'ta ürün kartında barkod bilgisinin doğru ve eksiksiz olması kritik öneme sahiptir.
MediaMarkt Formatı
MediaMarkt, Teknosa ile aynı yapıyı kullanır. Ürünler hem EAN (barkod) hem de teklif ID'si (offer id) ile tanımlanır:
- Eğer hem ürün anahtarı hem varyant anahtarı varsa:
urun_key::varyant_key - Eğer sadece ürün anahtarı varsa:
urun_key
Örnek: 8690000123456::987654321
Not: MediaMarkt'ta arama yapılırken mutlaka ürünün barkod bilgisi kullanılır. Bu nedenle Narius'ta ürün kartında barkod bilgisinin doğru ve eksiksiz olması kritik öneme sahiptir.
Ürün Bilgilerinin Doğruluğu
- Ürün kodlarının ve barkodların pazaryerindeki bilgilerle birebir uyumlu olması önemlidir
- Yanlış veya eksik ürün kodu/barkodu, pazaryerinde ürün bulunamama hatasına neden olur
- Özellikle Teknosa ve MediaMarkt için barkod bilgisinin mutlaka dolu ve doğru olması gerekmektedir
El İle Müdahale
- Bu görev sadece boş Pazaryeri Anahtarı alanlarını doldurur
- Eğer bir ürün için Pazaryeri Anahtarı daha önce girilmişse, görev bu kaydı değiştirmez
- Yanlış girilmiş bir Pazaryeri Anahtarı varsa, önce manuel olarak silinmeli, ardından görev tekrar çalıştırılmalıdır
Hata Durumları ve Çözümleri
Pazaryeri Tanımlı Değil
Hata: Bu zamanlanmış görev sadece Shopify, Hepsiburada, Teknosa ve Mediamarkt pazaryerleri için çalışmaktadır"
Çözüm:
- İlgili pazaryerinin (Hepsiburada, Shopify, Teknosa veya MediaMarkt) sistemde tanımlı olduğundan emin olun
- Pazaryeri tanımının aktif durumda olduğunu kontrol edin. Bu pazaryerlerinde satış yapmıyorsanız zamanlanmış görevi pasif'e alın veya slin
Pazaryeri Bağlantı Bilgileri Eksik
Hata: "Pazar yeri için giriş bilgileri tanımlanmamış"
Çözüm:
- "E-Ticaret API Anahtarları" sayfasından API erişim bilgilerinin (kullanıcı adı, şifre, token vb.) eksiksiz girildiğinden emin olun
- Bilgilerin güncel ve geçerli olduğunu doğrulayın
Ürün Pazaryerinde Bulunamadı
Hata: "...ürün kodu birden fazla ürünü işaret ediyor" veya "...ürün koduna ait kayıt bulunamadı"
Çözüm:
- Narius'taki ürün kodunun pazaryerindeki ürün kodu ile birebir aynı olduğundan emin olun
- Teknosa ve MediaMarkt için: Ürün kartındaki barkod bilgisinin doğru girildiğini kontrol edin
- Pazaryerinde gerçekten böyle bir ürünün listelenmiş olduğunu teyit edin
- Ürün pazaryerinde birden fazla kez listelenmiş olabilir, bu durumda ürün kodunun tekil olması sağlanmalıdır
API'den Boş Değer Geldi
Hata: "Pazar yeri API uygulamasından ...ürün sorgusu için boş anahtar değerleri alındı"
Çözüm:
- Pazaryerinde ilgili ürünün tam olarak yayınlandığından emin olun
- Ürünün pazaryerinde "taslak" veya "yayından kaldırılmış" durumda olmadığını kontrol edin
- Pazaryeri API'sinin geçici bir sorun yaşıyor olabilir, bir süre sonra tekrar deneyebilirsiniz
İşlem Başarısız
Çözüm:
- Görev bilgi notlarını kontrol ederek detaylı hata mesajını inceleyin
- Pazaryeri API servisinin erişilebilir olduğundan emin olun
- İnternet bağlantısını kontrol edin
Sıkça Sorulacak Sorular
Hangi pazaryerleri destekleniyor?
Bu özellik şu anda sadece dört pazaryeri için çalışmaktadır:
- Hepsiburada
- Shopify
- Teknosa
- MediaMarkt
Diğer pazaryerleri için Pazaryeri Anahtarı bilgilerinin el ile veya farklı yöntemlerle girilmesi gerekmektedir.
Neden bazı ürünler için anahtar okunamıyor?
Bunun birkaç nedeni olabilir:
- Ürün kodu (veya Teknosa ve MediaMarkt için barkod) pazaryerindeki bilgi ile uyuşmuyor olabilir
- Ürün pazaryerinde yayınlanmamış veya pasif durumda olabilir
- Pazaryeri API'si geçici olarak erişilemez durumda olabilir
- Ürünün e-ticaret kullanımı kapalı veya ürün kartı pasif olabilir
- Teknosa ve MediaMarkt için: Barkod bilgisi eksik veya hatalı olabilir
Görev ne sıklıkla çalışmalı?
Görevin çalışma sıklığı, yeni ürün ekleme hızınıza bağlıdır:
- Çok sayıda yeni ürün ekliyorsanız: Günde birkaç kez (örneğin her 4-6 saatte bir)
- Normal kullanımda: Günde bir kez
- Az sayıda ürün ekliyorsanız: Haftada birkaç kez
Not: Görev sadece Pazaryeri Anahtarı boş olan ürünleri işlediği için sık çalıştırmanın bir sakıncası yoktur.
Manuel doldurmaya gerek var mı?
Hayır, bu dört pazaryeri için manuel olarak Pazaryeri Anahtarı girmenize gerek yoktur. Görev otomatik olarak dolduracaktır. Ancak:
- Görev henüz çalışmadıysa veya hata aldıysa manuel girebilirsiniz
- Acil bir sipariş işlemi yapmanız gerekiyorsa beklemeden manuel girebilirsiniz
- Görevin desteklemediği diğer pazaryerleri için manuel giriş zorunludur
Yanlış girilmiş bir anahtarı nasıl düzeltirim?
Eğer bir Pazaryeri Anahtarı yanlış girilmişse:
- Ürün Kartı > Pazaryeri Ürün Anahtarları sekmesinden ilgili kaydı açın
- Pazaryeri Anahtarı alanını silin (boş bırakın)
- Kaydı kaydedin
- Zamanlanmış görevi tekrar çalıştırın veya otomatik çalışmasını bekleyin
- Görev boş alanı doğru bilgi ile dolduracaktır
Görev başarıyla çalıştı mı nasıl anlarım?
Görevin başarılı çalışıp çalışmadığını kontrol etmek için:
- Zamanlanmış Görevler sayfasından son çalışma sonucunu inceleyebilirsiniz
- Eğer hata oluştuysa, görev sonucu notlarında detaylı hata açıklamaları yer alacaktır
Sipariş işlerken "ürün eşleşmedi" hatası alıyorum, ne yapmalıyım?
Eğer pazaryerinden sipariş okunurken ürün eşleşmiyor hatası alıyorsanız:
- İlgili ürünün Pazaryeri Ürün Anahtarları tablosunda Pazaryeri Anahtarı bilgisinin dolu olduğunu kontrol edin
- Eğer boşsa, bu görevin çalışmasını bekleyin veya manuel olarak doldurun
- Eğer doluysa ancak yine de eşleşmiyorsa, anahtarın doğru girildiğinden emin olun
- Pazaryeri formatının doğru olduğundan emin olun (Shopify için <>, Teknosa ve MediaMarkt için ::)