Tanım
Pazaryeri Eksik Ürün Anahtarı Okuma, pazaryerlerinde satılan ürünlerin Narius sisteminde boş olan pazaryeri anahtar bilgisinin otomatik olarak doldurulmasını sağlayan bir görevdir.
Bu görev, ürün kartlarında bulunan ürün kodu ve barkod bilgilerini kullanarak pazaryeri API'leri üzerinden ürün anahtarlarını sorgular ve sistemdeki kayıtları günceller.
Bu görev sayesinde, manuel olarak girilmesi gereken pazaryeri anahtarları otomatik olarak sistemde tanımlanır ve stok, fiyat gibi bilgilerin pazaryerlerine doğru bir şekilde aktarılması sağlanır.
Temel Kavramlar
Pazaryeri Anahtarı
Pazaryeri platformlarında her ürünü benzersiz şekilde tanımlayan kod bilgisidir. Bu anahtar sayesinde sistem, hangi ürünün hangi pazaryeri ürünü ile eşleştiğini bilir ve gerekli güncellemeleri yapabilir.
Ana Ürün Anahtarı
Pazaryerinde kayıtlı olan ana ürüne ait benzersiz tanımlayıcı koddur. Varyantları olmayan ürünler için yalnızca bu anahtar kullanılır.
Varyant Ürün Anahtarı
Aynı ürünün farklı özelliklerine (renk, beden, model vb.) sahip varyantlarını tanımlayan benzersiz koddur. Bir ürünün birden fazla varyantı olabilir ve her varyantın kendine ait anahtarı vardır.
E-Ticaret Ürün Anahtarları
Ürün Kartları sayfası E-Ticaret Ürün Anahtarları sekmesinde bulunan ve her pazaryeri için ayrı ayrı tanımlanabilen ürün anahtarı kayıtlarının tutulduğu listedir.
Ürün Kodu
Sistemde ürün kartına tanımlanan ve ürünü temsil eden kod bilgisidir.
Barkod
Ürüne ait barkod numarasıdır.
Teknosa ve MediaMarkt pazaryerleri aramalarında ürün kodunun yanı sıra barkod bilgisi de kullanılmaktadır.
Ön Koşullar
Bu görevin başarıyla çalışabilmesi için aşağıdaki koşulların sağlanması gerekmektedir:
Firma Pazar Yeri Kaydının Aktif Olması: İlgili pazaryeri entegrasyonunun sistemde tanımlı ve aktif durumda olması gerekir.
Desteklenen Pazaryerlerinden Biri Olması: Görev yalnızca Hepsiburada, Shopify, Teknosa ve MediaMarkt pazaryerleri için çalışmaktadır. Diğer pazaryerleri için bu görev çalışmaz.
Ürün Kartının Aktif Olması: Pazaryeri anahtarı okunacak ürün kartlarının sistemde aktif durumda olması gerekir. Pasif ürünler işleme alınmaz.
E-Ticaret Kullanımına Açık Olması: Ürün kartının e-ticaret kullanımı için işaretlenmiş olması gerekir.
Ürün Kodunun Dolu Olması: Ürün kartında ürün kodu alanının doldurulmuş olması zorunludur. Bu kod, pazaryerinde ürün araması yapılırken kullanılır.
E-Ticaret Ürün Anahtarları Listesinde Kayıt Bulunması: Ürün Kartları sayfasında bulunan "E-Ticaret Ürün Anahtarları" listesinde ilgili pazaryerine ait kayıt bulunmalı ve bu kayıttaki pazaryeri anahtarı alanı boş olmalıdır. Bu kayıt olmayan ürünler işleme alınmaz.
Desteklenen Pazaryerleri ve Anahtar Formatları
Bu görev oluşturulup aktif edildiğinde, desteklenen pazaryerlerinin tamamı için otomatik olarak çalışır. Her pazaryeri için ayrı bir görev tanımlanmasına gerek yoktur.
Hepsiburada
- Anahtar Formatı: HB ile başlayan pazaryerine özel kod
- Örnek: HB00001234567
Shopify
- Anahtar Formatı (Varyantlı Ürünler):
{Ana ürün anahtarı}<>{Varyant ürün anahtarı} - Anahtar Formatı (Varyantsız Ürünler):
{Ana ürün anahtarı} - Örnek Varyantlı: 123456789<>987654321
- Örnek Varyantsız: 123456789
Teknosa ve MediaMarkt
- Anahtar Formatı (Varyantlı Ürünler):
{Ana ürün anahtarı}::{Varyant ürün anahtarı} - Anahtar Formatı (Varyantsız Ürünler):
{Ana ürün anahtarı} - Örnek Varyantlı: 123456789::987654321
- Örnek Varyantsız: 123456789
İşlem Adımları
Görev otomatik olarak çalıştığında aşağıdaki adımları takip eder:
Pazaryeri Kayıtlarının Kontrolü: Sistemde tanımlı, aktif durumda olan ve desteklenen pazaryerleri (Hepsiburada, Shopify, Teknosa, MediaMarkt) listelenir.
Ön Koşulların Kontrolü: Eğer hiçbir uygun pazaryeri kaydı bulunamazsa, görev sonlandırılır ve bilgilendirme notu eklenir.
Her Pazaryeri İçin İşlem: Her bir pazaryeri için aşağıdaki adımlar uygulanır:
- Pazaryerine ait ürün kartları ve eksik anahtarlar listelenir
- Pazaryeri kimlik bilgileri (API anahtarları vb.) ayarlanır
- Her ürün için işlem başlatılır
Ürün Bilgilerinin Hazırlanması: İşlenecek her ürün için:
- Ürün kartındaki kod bilgisi okunur
- Ürüne ait barkod bilgisi okunur
Pazaryeri API Sorgusu: Ürün kodu ve barkod kullanılarak pazaryeri API'sine sorgu gönderilir ve ürüne ait anahtar bilgileri istenir.
Yanıtın Değerlendirilmesi:
- API'den başarılı yanıt gelirse, pazaryerine göre uygun formatta anahtar oluşturulur
- Oluşturulan anahtar, sistemdeki ürün kaydına kaydedilir
Bildirim Gönderimi: Eğer pazaryerinden boş anahtar değerleri gelirse veya hata oluşursa, tanımlı e-posta adreslerine bildirim gönderilir. (Ürünün pazaryerinde bulunanaması veya farklı bir sebepten dolayı boş anahtar bilgisi dönebilir)
Görevin Tamamlanması: Tüm pazaryerleri ve ürünler işlendikten sonra görev tamamlanır ve sonuç raporlanır.
Dikkat Edilmesi Gereken Hususlar
Pazaryeri Kimlik Bilgilerinin Doğruluğu: Pazaryeri API anahtarları ve diğer kimlik bilgilerinin doğru ve güncel olması kritik önem taşır. Yanlış veya süresi dolmuş kimlik bilgileri nedeniyle işlem başarısız olabilir.
Ürün Kodu ve Barkod Eşleşmesi: Sistemde tanımlı ürün kodu ve barkod bilgilerinin pazaryerindeki kayıtlarla tam olarak eşleşmesi gerekir. Aksi takdirde ürün bulunamaz ve anahtar okunamaz.
Varyantlı Ürünler: Varyantlı ürünlerde hem ana ürün anahtarı hem de varyant anahtarı otomatik olarak okunur ve uygun formatta kaydedilir.
E-posta Bildirimleri: Bildirim e-postaları günde en fazla 5 defa (09:00, 11:00, 13:00, 15:00, 17:00) gönderilir. Bu sayede sürekli e-posta bombardımanı önlenir.
İşlem Süresi: Çok sayıda ürün için anahtar okuma işlemi zaman alabilir. Görevin ilerleme durumu "Zamanlanmış Görevler" sayfasından takip edilebilir.
Anahtar Alanı Boş Olmalı: Görev yalnızca pazaryeri anahtarı boş olan kayıtları işleme alır. Daha önce doldurulmuş anahtarlar güncellenmez.
Pazaryeri Ürün Anahtarı Aktif'lik Durumu: Pazaryeri ürün anahtar satırında bulunan Aktif alanının durumu işlem sonrasında değiştirilmez.
Hata Durumları ve Çözümleri
Pazaryeri Kimlik Bilgileri Ayarlanamadı
Neden: Pazaryerine ait API anahtarları veya diğer kimlik bilgileri eksik veya hatalı olabilir.
Çözüm:
- E-Ticaret API Anahtarı sayfasından ilgili pazaryerinin kimlik bilgilerini kontrol edin
- API anahtarlarının güncel ve doğru olduğundan emin olun
- Gerekirse pazaryeri platformundan yeni API anahtarları oluşturun
Pazaryeri API'sinden Başarısız Yanıt
Neden: Pazaryeri API'si geçici olarak erişilemez durumda olabilir, istek limiti aşılmış olabilir veya ürün pazaryerinde bulunamıyor olabilir.
Çözüm:
- Pazaryeri platformunun erişilebilir olduğunu kontrol edin
- Ürün kodunun ve barkodun pazaryerinde kayıtlı olduğundan emin olun
- Görev bir sonraki çalışmasında otomatik olarak tekrar deneyecektir
Pazaryerinden Boş Anahtar Değerleri Alındı
Neden: Ürün pazaryerinde bulundu ancak anahtar bilgileri döndürülmedi. Bu durum genellikle pazaryeri API'sinde bir problem olduğunu gösterir.
Çözüm:
- E-posta bildirimi otomatik olarak gönderilir
- Pazaryeri platformunda ürünü manuel olarak kontrol edin
- Gerekirse pazaryeri destek ekibi ile iletişime geçin
- Ürün anahtarını manuel olarak sisteme girebilirsiniz
Ürün Bulunamadı
Neden: Sistemdeki ürün kodu veya barkod, pazaryerindeki kayıtlarla eşleşmiyor olabilir.
Çözüm:
- Ürün kartındaki kod ve barkod bilgilerinin doğruluğunu kontrol edin
- Pazaryerinde ürünün yayında olduğunu doğrulayın
- Ürün kodunu veya barkodu pazaryerideki değerlerle eşleşecek şekilde güncelleyin
E-Ticaret Ürün Anahtarları Kaydı Yok
Neden: Ürün kartında ilgili pazaryerine ait E-Ticaret Ürün Anahtarları listesinde kayıt oluşturulmamış.
Çözüm:
- Ürün Kartları sayfasından ilgili ürünü açın
- "E-Ticaret Ürün Anahtarları" listesine ilgili pazaryeri için yeni kayıt ekleyin
- Pazaryeri anahtarı alanını boş bırakın
- Görev bir sonraki çalışmasında bu ürünü işleme alacaktır
Ön Koşullar Sağlanmıyor
Neden: Ürün kartı aktif değil, e-ticaret kullanımına kapalı veya ürün kodu eksik olabilir.
Çözüm:
- Ürün kartının aktif olduğundan emin olun
- Ürün kartında "E-Ticaret Kullanımı" seçeneğinin işaretli olduğunu kontrol edin
- Ürün kodu alanının doldurulmuş olduğunu doğrulayın
E-Posta Bildirimleri
Hata durumunda E-Ticaret API Anahtarları sayfasındaki Bildirim sekmesinde tanımlı 3 e-posta adresine görev tamamlandıktan sonra e-posta ile bildirim gönderilir. Başarılı olarak çalışan görevler için bildirim gönderilmez. En az bir e-posta adresinin doldurulması tavsiye edilir. Bildirimler günde 5 belirli saatte gönderilir:
- 09:00 - Sabah bildirimi
- 11:00 - Öğleden önce bildirimi
- 13:00 - Öğle bildirimi
- 15:00 - Öğleden sonra bildirimi
- 17:00 - Akşam bildirimi
Bu mekanizma sayesinde aynı sorun için sürekli e-posta gönderilmesi önlenir ve kullanıcılar günün belirli saatlerinde toplu bildirim alır.
Sıkça Sorulacak Sorular
S: Bu görev ne sıklıkla çalışmalıdır?
C: Görevin çalışma sıklığı, ürün ekleme hızınıza ve pazaryeri entegrasyon ihtiyaçlarınıza bağlıdır. Genellikle günde 1-2 kez çalıştırılması yeterlidir. Yoğun ürün eklendiği dönemlerde daha sık çalıştırılabilir.
S: Hangi pazaryerleri destekleniyor?
C: Şu anda Hepsiburada, Shopify, Teknosa ve MediaMarkt pazaryerleri desteklenmektedir. Diğer pazaryerleri için bu görev çalışmaz.
S: Her pazaryeri için ayrı görev tanımlamam gerekir mi?
C: Hayır, tek bir görev tanımlamanız yeterlidir. Görev aktif edildiğinde desteklenen tüm pazaryerleri için otomatik olarak çalışır.
S: Görev çalıştığında tüm ürünleri mi kontrol eder?
C: Hayır, görev sadece ön koşulları sağlayan ve pazaryeri anahtarı boş olan ürünleri işleme alır. Daha önce anahtarı doldurulmuş ürünler tekrar işlenmez.
S: Pazaryeri anahtarını manuel olarak girebilir miyim?
C: Evet, ürün kartında "E-Ticaret Ürün Anahtarları" listesinden manuel olarak girebilirsiniz. Manuel girilen anahtarlar bu görev tarafından değiştirilmez.
S: Varyantlı ürünlerde nasıl çalışır?
C: Varyantlı ürünlerde hem ana ürün anahtarı hem de varyant anahtarı otomatik olarak okunur ve pazaryerine göre uygun formatta (örneğin Shopify için <>, Teknosa ve MediaMarkt için :: ayracı ile) kaydedilir.
S: Görev başarısız olursa ne olur?
C: Hata durumunda ilgili bilgilendirme e-postaları tanımlı adreslere gönderilir. Görev bir sonraki çalışmasında işlemi tekrar deneyecektir.
S: API limitleri aşılırsa ne olur?
C: Bazı pazaryerleri API istek limitlerine sahiptir. Bu limitlere yaklaşıldığında işlemler yavaşlayabilir veya geçici olarak başarısız olabilir. Görev bir sonraki çalışmasında kaldığı yerden devam edecektir.
S: Neden bazı ürünler işlenmiyor?
C: Ürünlerin işlenebilmesi için tüm ön koşulların sağlanması gerekir. En yaygın sebepler: ürün kartının pasif olması, e-ticaret kullanımının kapalı olması, ürün kodunun eksik olması veya E-Ticaret Ürün Anahtarları listesinde kayıt bulunmamasıdır.
S: Barkod bilgisi zorunlu mu?
C: Barkod bilgisi arama işleminde yardımcı bir bilgidir ancak zorunlu değildir. Sistem öncelikle ürün kodu ile arama yapar, barkod bilgisi ek bir doğrulama katmanı sağlar.
S: E-posta bildirimleri gelmiyorsa ne yapmalıyım?
C: E-Ticaret API Anahtarı sayfasının Bildirim sekmesinde e-posta adreslerinin doğru girildiğinden emin olun. Ayrıca spam klasörünüzü kontrol edin ve görevin gerçekten çalıştığından emin olun.