E-Ticaret API Anahtarları - Genel Sekmesi
Firma
Pazar yeri entegrasyonunun hangi firmaya ait olduğunu belirleyen veri alanıdır. Narius çok kiracılı (multi-tenant) bir yapıya sahip olduğundan, her pazar yeri entegrasyonu belirli bir firmaya aittir ve bu firma bazında izole edilmiş şekilde çalışır.
Varsayılan Değer: Oturum açan kullanıcının bağlı olduğu firma
Önemli Hususlar:
- Bu alan otomatik olarak doldurulur ve değiştirilemez
- Çoklu firma yapısında, firma bazlı ayırım sağlamak için kullanılır
- Her firma kendi pazar yeri entegrasyonlarını bağımsız olarak yönetir
Pazar Yeri Adı
Pazar yeri entegrasyonuna verilecek özel tanımlayıcı isimdir. Aynı platformda (örneğin Trendyol) birden fazla mağaza entegrasyonu olması durumunda ayırt edici isimler kullanılır.
Varsayılan Değer: Boş
Alabileceği Değerler: Metin (maksimum 200 karakter)
Kullanım Örnekleri:
- "Trendyol TR Ana Mağaza"
- "Amazon DE Premium Store"
- "Hepsiburada Outlet"
- "N11 Toptan Satış"
Önemli Hususlar:
- Bu alan zorunludur
- Pazar yerlerine Narius'da verilen addır
- Raporlarda ve sipariş takibinde bu isim kullanılır
Pazar Yeri Türü
Entegre edilecek e-ticaret platformunun seçildiği veri alanıdır. Bu seçim, sistemin hangi API protokolünü kullanacağını ve hangi özel ayarların aktif olacağını belirler.
Varsayılan Değer: Boş (zorunlu alan)
Alabileceği Değerler:
- Yerli Platformlar: Trendyol, Hepsiburada, N11, GittiGidiyor, ÇiçekSepeti, PttAVM, Morhipo, Pazarama, TurkcellPasaj, VodafoneMall, Teknosa, Koçtaş, İdefix
- Uluslararası Platformlar: Amazon, AmazonFBA, Ebay, Walmart, Kaufland, Newegg, Exporgin, Shopify
- Özel Platformlar: IdeaSoft, TSoft, NeytekNop
Önemli Hususlar:
- Zorunlu alandır, boş bırakılamaz
- Seçilen platforma göre ilgili API sekmesi (Trendyol, Amazon, vb.) formda görünür hale gelir
- Platform değişikliği yapılması durumunda tüm API bilgileri yeniden girilmelidir
- Her platformun kendine özgü entegrasyon gereksinimleri vardır
Ürün Satış Fiyat Listesi
Pazaryerine gönderilecek ürün fiyatlarının hangi fiyat listesinden alınacağını belirleyen veri alanıdır. Sistemde birden fazla fiyat listesi tanımlı olabilir ve her pazar yeri için farklı bir liste seçilebilir.
Varsayılan Değer: Boş
Alabileceği Değerler: Sistem tanımlı satış fiyat listeleri
Kullanım Örnekleri:
- "İnternet Satış Fiyatları"
- "Pazar Yeri Özel Fiyat"
- "B2C Perakende"
Önemli Hususlar:
- Bu alan zorunlu değildir ancak otomatik fiyat güncelleme kullanılacaksa gereklidir
- Fiyat güncelleme işlemlerinde bu liste referans alınır
- Liste döviz birimi ile pazar yeri döviz birimi uyumlu olmalıdır
- Fiyat Çarpan değeri ile birlikte kullanılarak farklı pazar yerleri için dinamik fiyatlandırma yapılabilir
Finans Adı
Otomatik oluşturulacak satış faturalarında kullanılacak cari kartını belirleyen veri alanıdır. Her pazar yeri için ayrı cari tanımlamak, muhasebe takibini kolaylaştırır.
Varsayılan Değer: Boş
Alabileceği Değerler: Sistem tanımlı finans (cari) kartları
Kullanım Örnekleri:
- "Trendyol TR Cari"
- "Amazon Marketplace"
- "Hepsiburada Hesap"
Önemli Hususlar:
E-Ticaret Finans Fiiinde Pazar Yeri Carisini Kullanayarı ile birlikte çalışır- Boş bırakılması durumunda siparişteki müşteriye ait bilgiler cari olarak kullanılır
Vade Gün
Otomatik oluşturulan faturalarda vade gün sayısını belirleyen veri alanıdır. Bu değer, fatura tarihine eklenerek vade tarihi hesaplanır.
Varsayılan Değer: 0
Alabileceği Değerler: Sayısal (0 ve pozitif değerler)
Kullanım Örnekleri:
- 0: Peşin ödeme
- 15: 15 gün vadeli
- 30: 30 gün vadeli
- 45: 45 gün vadeli
- 60: 60 gün vadeli
Hesaplama Yöntemi:
Vade Tarihi = Fatura Tarihi + Vade Gün
Önemli Hususlar:
- Otomatik fatura oluşturma sürecinde bu değer kullanılır
- Pazar yerlerinin ödeme vadelerine göre ayarlanmalıdır
- Cari hesap hareketlerinde vade takibi için kullanılır
Aktif
Pazar yeri entegrasyonunun aktif veya pasif durumunu kontrol eden veri alanıdır. Pasif yapılan entegrasyonlar için hiçbir otomatik işlem gerçekleştirilmez.
Varsayılan Değer: Hayır (false)
Alabileceği Değerler: Evet / Hayır
Önemli Hususlar:
- Pasif yapıldığında şu işlemler durur:
- Sipariş çekme işlemleri
- Stok güncelleme işlemleri
- Otomatik sipariş onaylama
- Otomatik fatura oluşturma
- Zamanlanmış görevler bu pazar yerini dikkate almaz
- Aktif hale getirmeden önce tüm ayarların doğruluğu kontrol edilmelidir
- Geçici olarak entegrasyonu durdurmak için kullanılabilir
Döviz
Pazar yerinde kullanılacak para birimini belirleyen veri alanıdır. Fiyat hesaplamaları ve döviz çevrimi işlemleri için kullanılır.
Varsayılan Değer: TL
Alabileceği Değerler: TL, USD, EUR, GBP
Önemli Hususlar:
- Zorunlu alandır, boş bırakılamaz
- Fiyat listesi döviz birimi ile eşleşmelidir
- Döviz çevrimi işlemlerinde güncel kurlar kullanılır
Mağaza Adı
Pazar yeri platformunda kullanılan mağaza adını saklayan veri alanıdır. Bu isim genellikle pazar yeri panelinden alınır.
Varsayılan Değer: Boş
Alabileceği Değerler: Metin (maksimum 200 karakter)
Kullanım Örnekleri:
- "MyStoreTR"
- "PremiumShopDE"
- "TeknoMagazam"
Önemli Hususlar:
- Bu alan zorunlu değildir
- Bazı platformlarda API çağrılarında kullanılır
- Raporlama ve çoklu mağaza yönetimi için referans sağlar
- Platform panelinde görünen isim ile aynı olmalıdır