Ayarlar

E-Ticaret API Anahtarları - Ayarlar Sekmesi

Otomatik Sipariş Onayla

Gelen siparişlerin otomatik olarak onaylanmasını sağlayan veri alanıdır. "Onaylama" ifadesi; e-ticaret platformlarına gelen müşteri siparişlerinin faturalama öncesinde faturalamaya hazır hale getirilmesi için yapılması gereken adımlara verilen isimdir. Çoğu pazar yerinde siparişler müşteri ödemeyi yaptığı andan itibaren onaylı kabul edilmesine rağmen bazı pazar yerlerinde paketlenmesi gerekir. Narius'da bu gibi faturalama öncese paketleme veya paket parçalama gibi ön işlemlerin bütününe Onaylama adı verilir ve "Yeni Siparişler" listesinde görüntülenir.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Çalışma Zamanı: Zamanlanmış görev Pazaryeri_Otomatik_Siparis_Onayla ile

Önemli Hususlar:

• Aktif edildiğinde aşağıdaki kontroller yapılır:
  • Sipariş durumu "Yeni Sipariş" listesinde bulunan siparişlerin onaylanması sürecini otomatikleştirir.
  • "E-Ticaret Otomatik Onaylama Öncesnde Stok Kontrolü Yap" aktif ise stok kontrolü yapılır
  • Paket bölünmesi (pazaryeri_paket_parcala) kontrolü yapılır
  • Kargo şirketi uyumu kontrol edilir
• Stok kontrolü aktif ise yetersiz stok durumunda sipariş onaylanmaz
• Onaylama işlemi pazar yeri API'si üzerinden gerçekleştirilir

Otomatik Fatura Oluştur

Onaylanan siparişler için otomatik olarak satış faturası veya alınan sipariş oluşturulmasını sağlayan veri alanıdır. Bu özellik, satış sürecini hızlandırır ve manuel işlem yükünü azaltır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Çalışma Zamanı: Zamanlanmış görev Pazaryeri_Otomatik_Fatura_Olustur ile

Oluşturulan Fiş Tipi: Satış Faturası (Fis_Tipleri.Satis = 451)

Önemli Hususlar:

• Aktif edildiğinde "Otomatik Fatura/Sipariş E-Ticaret Deposu" alanı zorunlu hale gelir
• "Otomatik Sipariş Oluştur:" ile aynı anda aktif olamaz
• "Otomatik Fatura Oluşturma Öncesinde Stok Kontrolü Yap" ayarındaki değer bağlı olarak satış e-ticaret faturası\alınan sipariş oluşturulması öncesinde stok kontrolü yapılır
• Satış Faturası oluşturulması istendğinde stış faturasının "Fatura Tipi" alanının değerini belirlemek için kullanılır. Bu alan faturanın GİB (Gelir İdaresi Başkanlığına) gönderlmesinde önem taşır. E-Ticaret siparişi veren müşteri bilgilerine bağlı olarak bu fatura tipi otomatik faturalam aşamasında "E-ARŞİV FATURASI"na dönüştürülür.
• Genel sekmesindeki "Finans Adı" alanında tanımlı cari fatura carisi olarak kullanılır

İlişkili Ayarlar:

• Otomatik Fatura/Sipariş E-Ticaret Deposu
• Otomatik Fatura Oluşturma Öncesinde Stok Kontrolü Yap:
• Fatura Tipi:
• Finans Adı:
• Otomatik Fatura Finans Hareket Oluştur:
• Finans Fişinde Pazaryeri Carisini Kullan:

Otomatik Onaylama Öncesinde Stok Kontrolü Yap

Sipariş onaylanmadan önce ürün stoklarının yeterliliğini kontrol edilip edilmeyeceğini belirleyen alandır. Bu kontrol, stok yetersizliği nedeniyle karşılanamayacak siparişlerin onaylanmasını engeller.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Kontrol Yöntemi:

Her sipariş kalemi için:

• Ürün kartı stoğu hesaplanır
• Karma ürün, konfig ürün veya muadil ürünler için kendine özgü hesaplama yöntemi kullanılır
• Sipariş miktarı ile karşılaştırılır
• Yetersiz stok varsa → Sipariş onaylanmaz

Önemli Hususlar:

• Aktif edildiğinde yalnızca stoğu yeterli olan siparişler onaylanır
• Siparişteki tüm kalemler için stok kontrolü yapılır
• Tek bir kalemde bile yetersizlik varsa tüm sipariş onaylanmaz
• Stok miktarlarının hesaplanmasında Depo tanımında "E-Ticaret Deposu" alanı işaretli olan depolar dikkate alınır

Fatura Oluşturma Öncesinde Stok Kontrolü Yap

Otomatik fatura oluşturulmadan önce ürün stoklarının yeterliliğini kontrol eden veri alanıdır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Kontrol Yöntemi:

Her fatura kalemi için:

• Depo stoğu hesaplanır
• Sipariş miktarı ile karşılaştırılır
• Yetersiz stok varsa → Fatura oluşturulmaz

Önemli Hususlar:

• Negatif stok yapısı kullanmayan işletmeler için kritik öneme sahiptir
• Stok yetersizliği durumunda fatura oluşturulmaz
• "Otomatik Fatura Oluştur:" aktif ise çalışır
• Stok miktarlarının hesaplanmasında Depo tanımında "E-Ticaret Deposu" alanı işaretli olan depolar dikkate alınır

Otomatik Sipariş Oluştur

Satış faturası yerine "Alınan Sipariş" fişi oluşturulmasını sağlayan veri alanıdır. Bu seçenek, stokta olmayan ürünler için tedarik sürecini başlatmak amacıyla kullanılır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Oluşturulan Fiş Tipi: Alınan Sipariş (Fis_Tipleri.Alınan_Sipariş = 351)

Kullanım Senaryoları:

• Sipariş üzerine tedarik yapılan ürünler
• Drop shipping modeli
• Stok tutulmayan ürün grupları
• Üretim sonrası sevkiyat yapılan ürünler

Önemli Hususlar:

• "Otomatik Fatura Oluştur:" ile aynı anda aktif olamaz
• "Otomatik Fatura/Sipariş E-Ticaret Deposu" alanındaki depo kullanılır

Kargolanmış Siparişler İçin Otomatik Fatura/Sipariş Oluştur

Kargoya verilmiş ancak sistemde faturası oluşturulmamış siparişler için otomatik fiş oluşturulmasını sağlayan veri alanıdır. Narius sisteminde "Kargolanmış Siparişler" menüsünde görünen siparişlerdir

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Kullanım Senaryoları:

• Manuel onay ve faturalama süreçlerinde atlanan siparişlerin yakalanması
• Sistemde eksik kalan fatura kayıtlarının tamamlanması

Önemli Hususlar:

• Normal sipariş akışına ek olarak çalışır
• Zaten faturası oluşturulmuş siparişler tekrar işlenmez
• "Otomatik Fatura Oluştur" veya "Otomatik Sipariş Oluştur" ayarlarından biri aktif olmalıdır

Pazaryeri Fiyat Güncelle

Sistemdeki fiyat değişikliklerinin pazar yerine gönderilip\gönderilmeyeceğini belirleyen veri alanıdır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Çalışma Zamanı: Zamanlanmış görev Pazaryeri_Urun_Fiyat_Guncelle ile

Güncelleme Süreci:

1. "Ürün Fiyat Listesi" alanında belirtilen fiyat listesinden güncel fiyatlar alınır
2. "Fiyat Çarpan" alanındaki değer uygulanır (varsa)
3. Her paket pazaryeri_istek_araligi süre sonra gönderilir
4. Güncelleme sonuçları "Pazar Yeri Stok & Fiyat Gönderim Durumu" menüsünden izlenebilir

Önemli Hususlar:

• "Ürün Fiyat Listesi" alanı doldurulmuş olmalıdır
• "Korumalı Fiyat Güncellemesi" alanı aktif ise en az / en fazla fiyat kontrolleri yapılır
• Sadece fiyatı değişmiş olarak işaretlenmiş olan ürünler güncellenir. (Ürün kartı sayfasında e-ticaret sekmesindeki listeden kontrol edilebilir)
• Başarısız güncellemeler "Fiyat Güncelleme Deneme Sayısı" ile takip edilir (max 3 deneme)

İlişkili Ayarlar:

• Ürün Fiyat Listesi
• Toplu Güncelleme Adeti (tüm pazar yerleri için geçerli değildir)
• Korumalı Fiyat Güncellemesi
• Fiyat Çarpan

Pazaryeri Stok Güncelle

Sistem stok miktarlarının otomatik olarak pazar yerine gönderilip gönderilmeyeceğini belirleyen veri alanıdır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır

Çalışma Zamanı: Zamanlanmış görevler

Güncelleme Süreci:

1. Her ürün için güncel stok miktarı hesaplanır
2. Ürünler "Toplu Güncelleme Adeti" kadar paketlere bölünür
3. Her paket "İstek Aralığı (Saniye)" süre sonra gönderilir
4. Güncelleme sonuçları "Pazar Yeri Stok & Fiyat Gönderim Durumu" menüsünden izlenebilir

Seçim Kriterleri:

• Her pazar yeri için ayrı ayrı olmak üzere ürünlere ait pazar yeri anahtarları girilmiş ve doğru bir değere sahip olmalıdır
• Pazar yeri anahtarına ait satır aktif olmalıdır
• Miktarı değişmiş olmalıdır
• "Stok Miktarı Güncelleme Deneme Sayısı" 3'den küçük olmalıdır. Hata sebebiyle güncelleme yapılamayan ürünler için üçüncü denemeden sonra stok güncelleme yapılmaz
• Ürün kartı aktif olmalıdır
• Ürün kartı tanımına bulunan "E-Ticaret Kullanım" alanı Evet şeklinde işareti olmalıdır
• Pazar yeri tanımı aktif olmalıdır
• Ürün kartı tanımında "Stok Takibi Var" alanı işaretli olmalıdır
• Sistemde tanımlı en az bir adet "Aktif" ve "E-Ticaret Deposu" alanları Evet değerine sahip depo bulunmalıdır

E-Ticaret Fatura Gönderim Şekli

Oluşturulan faturanın pazar yerine nasıl ulaştırılacağını belirleyen veri alanıdır.

Varsayılan Değer: E-Posta (false)

Alabileceği Değerler:

• E-Posta (false): Fatura müşteri e-posta adresine gönderilir
• Pazar Yeri Link (true): Ulaşılabilir durumdaki fatura web adresi pazar yeri entegrasyonu kullanılarak paazar yerine "Zamanlanmış Görevler" kullanılarak iletilir. "E-Ticaret Faturaları" sayfasından fatura adresi iletim durumu gözlenebilir.

Önemli Hususlar:

• Bazı platformlar (Trendyol, Hepsiburada) link ile fatura paylaşımını zorunlu kılar
• Pazar Yeri Link (true): seçeneği platform API desteği gerektirir

Fiyat Çarpan

Bazı pazar yerlerinde müşteriye gösterilen "Üzeri Çizili Fiyat" billgisinin otomatik hesaplanmasında kullanılır. Tüm pazar yerleri bu özelliği kullanmamaktadır.

Varsayılan Değer: Boş (null)

Alabileceği Değerler: Ondalık sayı (Decimal 18,4)

Kullanım Örnekleri:

• 1.00: Baz fiyat (referans pazar yeri)
• 1.15: %15 fiyat artışı
• 0.95: %5 fiyat indirimi
• 1.20: %20 fiyat artışı
• 0.85: %15 fiyat indirimi

Hesaplama Yöntemi:

Pazar Yeri Fiyatı = Baz Fiyat × Fiyat Çarpan

Çalışma Prensibi:

1. En az bir pazar yerinde fiyat_carpan=1.00 (baz fiyat) tanımlanmalıdır
2. Diğer pazar yerleri için çarpan değerleri girilir
3. Pazaryeri Ürün Analiz ekranında "Çarpanlı Kar Oranı Uygula" butonu ile hesaplama yapılır
4. Baz pazar yerindeki kar oranı belirlenir
5. Diğer pazar yerlerinin fiyatları otomatik hesaplanır

Kullanım Alanları:

• Pazaryeri Ürün Analiz sayfası
• Pazaryeri Ürün Analiz Yurtdışı sayfası
• Toplu fiyat güncelleme işlemleri

Önemli Hususlar:

• Boş bırakılması durumunda çarpan hesaplaması yapılmaz
• Baz pazar yeri (çarpan=1) olmadan sistem çalışmaz
• Çarpan değeri platform komisyon oranlarına göre ayarlanabilir

Toplu Güncelleme Adeti

Fiyat ve stok güncellemelerinde tek seferde kaç ürüne ait bilginin gönderileceğini belirleyen veri alanıdır. Bu değer, API performansını ve hız limitlerini yönetmek için kritik öneme sahiptir.

Varsayılan Değer: 0

Alabileceği Değerler: Pozitif tam sayı (Integer)

Platform Bazlı Öneriler:

Çalışma Mekanizması:

Tüm Ürünler = 5000 ürün Toplu Güncelleme Adeti = 500

Sonuç:

• 10 paket oluşturulur (5000 / 500 = 10)
• Her pakette 500 ürün bulunur
• Paketler sırayla gönderilir
• Her paket arasında "İstek Aralığı (Saniye)" kadar beklenir

Önemli Hususlar:

• Yanlış değer API rate limit hatalarına sebep olabilir
• Çok yüksek değerler timeout hatası oluşturabilir
• Çok düşük değerler işlem süresini uzatır
• Platform dokümantasyonu kontrol edilmelidir
• Not: HepsiBurada, Çiçek Sepeti, Trendyol, N11, Teknosa, Pazarama (Yurt Dışı - Walmart, Kaufland) ve Amazon haricindeki pazar yerleri için 1 giriniz

Korumalı Fiyat Güncellemesi

Fiyat güncellemelerinde minimum ve maksimum fiyat kontrolü yapılmasını sağlayan veri alanıdır. Bu özellik, yanlışlıkla aşırı düşük veya yüksek fiyat gönderimini engeller.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Kontrol Yöntemi:

Aktif edildiğinde:

1. Gönderilecek fiyat bu aralık dışındaysa güncelleme yapılmaz
2. Hata kaydı oluşturulur

FTP Kullan

Yeni oluşturulan ürünlerin pazar yerlerine gönderilmesi esnasında ürün fotoğraflarının FTP sunucuya kaydedilip / kaydedilmeyeceğinin belirlendiği ayarlama alanıdır. FTP sunucusu ile ilgili ayarlar "Firma Varsayılan" sayfasındaki ilgili alanlara girilmiş olmalıdır.

Pazaryeri İstek Aralığı

API çağrıları arasında beklenecek süreyi saniye cinsinden belirleyen veri alanıdır. Bu ayar, platform rate limit politikalarına uyum sağlamak için kullanılır.

Varsayılan Değer: Boş (null)

Alabileceği Değerler: Pozitif tam sayı (saniye cinsinden)

Kullanım Örnekleri:

• 1 saniye: Hızlı güncelleme, düşük rate limit riski
• 2 saniye: Orta hızda güncelleme
• 5 saniye: Güvenli güncelleme, yüksek güvenlik
• 10 saniye: Çok yavaş ama garantili

Önemli Hususlar:

• Boş bırakılması durumunda bekleme yapılmaz
• Rate limit hatası alan platformlar için 2-5 saniye önerilir
• Çok yüksek değerler güncelleme süresini uzatır
• Platform API dokümantasyonundaki limit bilgilerine göre ayarlanmalıdır
• Toplu güncelleme paketleri arasında uygulanır

Ürün Adı Uzunluğu

Pazar yerine gönderilen ürün adının maksimum karakter sayısını belirleyen veri alanıdır. Her platformun farklı karakter limiti olabilir.

Varsayılan Değer: Boş (null)

Alabileceği Değerler: 1 ve üzeri pozitif tam sayı (minimum 1)

Platform Bazlı Örnekler:

• Trendyol: 100 karakter
• Hepsiburada: 150 karakter
• Amazon: 200 karakter
• N11: 100 karakter

Çalışma Mekanizması:

Örnek:
Ürün Adı = "Samsung Galaxy S24 Ultra 256GB 5G Akıllı Telefon Phantom Black Garantili"
urun_adi_uzunlugu = 50

Gönderilen Ad = "Samsung Galaxy S24 Ultra 256GB 5G Akıllı Telef"

Önemli Hususlar:

• Ürün adı belirlenen uzunluğa göre kesilerek gönderilir
• Boş bırakılması durumunda kesme yapılmaz
• Platform gereksinimleri dikkate alınarak ayarlanmalıdır

Temlik Notu

E-Ticaret faturlarının GİB'e gönderilmesi esnasında otomatik olarak eklenecek temlik veya özel not bilgisini içeren veri alanıdır.

Varsayılan Değer: Boş

Alabileceği Değerler: Metin (maksimum 500 karakter)

E-Fatura Profile ID

Oluşturulacak e-faturaların GIB (Gelir İdaresi Başkanlığı) fatura tipini belirleyen veri alanıdır.

Varsayılan Değer: Boş (null)

Önemli Hususlar:

• Türkiye için zorunludur
• Otomatik fatura oluşturulurken "Fatura Tipi" alanına yazılır
• Yanlış profile ID seçimi e-fatura gönderim hatasına sebep olabilir.
• GIB entegrasyonu bu değere göre çalışır

Sevkiyat Tarihi İşle

İşaretlenmesi durumunda sipariş için oluşturulacak fişin "Sevkiyat Tarihi" alanı fişin kayıt tarihi ile otomatik olarak doldurulur

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Pazaryeri İndirimini Faturaya Yansıt

Pazar yerinin yaptığı indirimlerin fatura satırlarına iskonto olarak yansıtılmasını sağlayan veri alanıdır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Hesaplama Yöntemi:

Aktif ise:
Satır Toplam İndirim = Pazaryeri İndirim Tutarı + Mağaza İndirim Tutarı

Pasif ise:
Satır Toplam İndirim = Mağaza İndirim Tutarı

İskonto Oranı = (Satır Toplam İndirim / Birim Fiyat) × 100

Örnek Hesaplama:

Ürün Birim Fiyatı: 1000 TL
Pazar Yeri İndirimi: 100 TL (kampanya)
Mağaza İndirimi: 50 TL

pazaryeri_indirimini_faturaya_yansit = true:
- Toplam İndirim: 150 TL
- Net Fiyat: 850 TL
- KDV Matrahı: 850 TL

pazaryeri_indirimini_faturaya_yansit = false:
- Toplam İndirim: 50 TL
- Net Fiyat: 950 TL
- KDV Matrahı: 950 TL

Önemli Hususlar:

• Mağaza indirimi her zaman faturaya yansır
• Sadece pazar yeri indirimi bu ayar ile kontrol edilir
• Ürün satırındaki İskonto 1 alanına yazılır

Otomatik Fatura Finans Hareket Oluştur

Otomatik oluşturulan faturalar için "Finans Fişlerinin"de otomatik oluşturulmasını sağlayan veri alanıdır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Çalışma Mekanizması:

Aktif ise:

1. Satış faturası\siparişi oluşturulur. Stok fişindeki bulunan "Cari İşle" alanı "Evet" olarak işaretlenir.
2. Aynı anda finans fişi oluşturulur
3. Cari hesaba borç kaydı düşülür

Pasif ise:

1. Sadece satış faturası\siparişi oluşturulur
2. Finans hareketi manuel olarak yapılmalıdır

Önemli Hususlar:

• "Finans Fişinde Pazaryeri Carisini Kullan" ayarı ile birlikte çalışır

Ülke

Pazar yerinin hangi ülkede faaliyet gösterdiğini belirleyen veri alanıdır. Bu bilgi, vergi hesaplamaları, döviz çevrimi ve fatura profili için kullanılır.

Varsayılan Değer: Türkiye

Alabileceği Değerler: Sistem tanımlı ülke listesinden seçim

Zorunluluk: Evet (Required)

Kullanım Örnekleri:

• Türkiye → TL, TICARIFATURA
• Almanya → EUR, IHRACAT
• ABD → USD, IHRACAT

Önemli Hususlar:

• KDV hesaplamalarını etkiler
• Döviz birimi ile uyumlu olmalıdır
• "Fatura Tipi" seçiminde dikkate alınır
• Türkiye için "Fatura Tipi" zorunludur

Satış KDV

"Pazaryeri Ürün Analizi - Yurt Dışı" sayfasında kullanılır.

Anahtar Üretim Yöntemi

Pazar yeri ürün anahtarlarının otomatik olarak doldurulmasında ürün anahtar formatını belirleyen veri alanıdır.

Varsayılan Değer: Boş (null)

Alabileceği Değerler:

• T Kodu: Ürün kodu olduğu gibi (örn: ABC123)
• Küçük Harf ile T Kodu: Küçük harfe çevrilmiş (örn: abc123)
• Büyük Harf ile T Kodu: Büyük harfe çevrilmiş (örn: ABC123)
• Barkod: Ürün barkodu kullanılır

Kullanım Örnekleri:

Finans Fişinde Pazaryeri Carisini Kullan

Finans fişlerinin oluşturulması esnasında, siparişteki müşteri carisi yerine pazar yeri carisinin kullanılmasını sağlayan veri alanıdır.

Varsayılan Değer: Hayır (false)

Alabileceği Değerler: Evet / Hayır (Boolean)

Çalışma Mekanizması:

Aktif ise:

• Finans fişi carisi= "E-Ticaret API Anahtarları" tanımındaki "Finans Adı"

Pasif ise:

• Finans fişi carisi = Sipariş müşteri carisi

Kullanım Senaryoları:

• Pazar yeri bazlı ciro takibi
• Pazar yeri ödemelerinin konsolidasyon hesabında toplanması
• Müşteri bazlı değil, platform bazlı muhasebe takibi

Önemli Hususlar:

• "Otomatik Fatura Oluştur" veya "Otomatik Sipariş Oluştur" alanlarından biri aktif olmalıdır
• "E-Ticaret API Anahtarları" tanımındaki "Finans adı" alanı doldurulmuş olmalıdır
• Müşteri bazlı takip yapılmak isteniyorsa pasif bırakılmalıdır

Paket Parçala

Bakınız: Paket Parçalama

Rezerve Ürün Stok Transfer Fişi

Rezerve edilen ürünlerin hangi stok transfer fişine ekleneceğini belirleyen veri alanıdır.

Bu özellik, Amazon benzeri pazar yerlerinde siparişin alındığı ama kredi kartı ödemelerinin kontrolünde gecikmelerin yaşandığı durumlarda fazla satışı engellemek için kullanılır.

Varsayılan Değer: Boş (null)

Alabileceği Değerler: Stok Transfer Fişi listesinden seçim

Çalışma Mekanizması:

Sipariş onaylandığında; pazar yerlerinde farklı siparişlerde bulunan rezerve ürünler Narius sisteminde tek bir stok fişine kaydedilir.

Önemli Hususlar:

• Transfer fişi iptal edilmemiş, stoğa işle alanı işaretli ve onay sürecinde olmayan geçerli bir fiş olmalıdır

Pazaryerine Ürün Öner

Pazaryerinde ürün önerme özelliğinin kullanılıp kullanımayacağının belirlendiği veri alanıdır.

Pazaryerine Toplu Ürün Önerme Gönderme