ETicaretSoft entegrasyonu: paket kontrolünden pazaryerinde ilk satışa
ETicaretSoft entegrasyonu, ATS Yazılım A.Ş.'nin e-ticaret altyapısı ETicaretSoft ile kurulmuş sitenizi Yox İş Ortağım'a bağlayarak site ürünlerini pazaryerlerine aynı kartlardan açmanızı, stoğu site ile pazaryerleri arasında çift yönlü güncel tutmanızı ve bütün siparişleri tek listede yönetmenizi sağlar. Bu bağlantının ilk şartı teknik değil, ticaridir: ETicaretSoft'un paket karşılaştırmasında hazır web servisler yalnız Full pakette işaretlidir. Aşağıda Ekim 2026 itibarıyla ETicaretSoft'un resmî sayfalarından ve geliştirici dokümanından doğruladığımız paket farklarını, web servis uçlarını, düzeltilmesi gereken ürün alanlarını, örnek fiyat hesabını ve paket seçimini bulacaksınız.
ETicaretSoft entegrasyonu nedir ve hangi satıcının işine yarar?
ETicaretSoft, Nilüfer/Bursa'daki ATS Yazılım A.Ş.'nin tescilli markası olan hazır e-ticaret yazılımıdır; şirket kendi sitesinde 1998'den beri hizmet verdiğini belirtir. Altyapı Lite, Pro, Max ve Full adlı dört paketle satılır. Dört pakette de son kullanıcıya satış (B2C) altyapısı bulunur, bayilere satış (B2B) altyapısı ise Pro paketle başlar. ETicaretSoft entegrasyonu bu sitenin ürün, stok ve sipariş verisini web servis üzerinden Yox İş Ortağım'a taşır; site, pazaryerleriyle aynı stok kartını paylaşan satış kanallarından biri hâline gelir.
ETicaretSoft'un kendisi de pazaryerleri, tedarikçi XML'i, ticari yazılımlar ve kargo firmaları için modüller sunar. Ek modüller sayfasında pazaryeri ve ticari yazılım modüllerinin fiyatı yazmaz, “fiyat sorunuz” notuyla geçer. Dolayısıyla karar verirken asıl soru bir bağlantının var olup olmadığı değil, stoğu hangi sistemin yöneteceğidir.
Ayrı bir pazaryeri paneli hangi durumda mantıklı olur?
- Sitenizin yanında üç ya da daha fazla kanalda satıyorsanız ve her kanalın stoğunu ayrı ekrandan düzeltmek zaman alıyorsa
- ETicaretSoft'un paket sayfasında listelenmeyen Etsy, Allegro, Ozon gibi yurt dışı kanallara da açılmak istiyorsanız
- Site ve pazaryeri siparişlerinin etiketini, faturasını ve iadesini tek listeden yürütmek istiyorsanız
- Pazaryeri hakedişlerini sipariş bazında kontrol edip zarar eden siparişleri görmek istiyorsanız
Bağlanabileceğiniz 80 satış kanalının (48'i kullanıma hazır), 57 kargo ve lojistik firmasının ve 51 muhasebe, e-Fatura ve ERP programının tam listesi Yox İş Ortağım entegrasyonlar sayfasında yer alıyor.
ETicaretSoft paketlerinde entegrasyonla ilgili satırlar (Ekim 2026)
ETicaretSoft'un paket karşılaştırma sayfası her özelliği Var, Yok ya da Opsiyonel olarak işaretler; Opsiyonel işaretli satırlar ek modüller sayfasına yönlendirir. Pazaryeri bağlantısını doğrudan etkileyen satırları aşağıda topladık. Hangi pakette olduğunuz, bağlantının nasıl kurulacağını belirler.
| Paket karşılaştırma satırı | Lite | Pro | Max | Full |
|---|---|---|---|---|
| B2B (bayi) altyapısı | Yok | Var | Var | Var |
| Ürün kodu ve varyantlı barkod yönetimi | Yok | Var | Var | Var |
| Geliştirici Konsolu ve hazır web servisler | Yok | Yok | Yok | Var |
| Dış yazılım entegrasyonları | Yok | Yok | Yok | Var |
| Tedarikçi XML entegrasyonları | Yok | Opsiyonel | Opsiyonel | Opsiyonel |
| Bayiler için özel oranlı XML oluşturma | Yok | Yok | Var | Var |
| Pazaryeri API modülleri (N11, Hepsiburada, Trendyol, ÇiçekSepeti vb.) | Opsiyonel | Opsiyonel | Opsiyonel | Opsiyonel |
| Ticari yazılım modülleri (Logo, Mikro, Netsis, Paraşüt vb.) | Opsiyonel | Opsiyonel | Opsiyonel | Opsiyonel (Sysmond dahil) |
| Kargo API modülleri (Aras, MNG, Yurtiçi, UPS vb.) | Opsiyonel | Opsiyonel | Opsiyonel | Opsiyonel |
| Online fatura yazdırma | Yok | Var | Var | Var |
Bu tablodan çıkan üç pratik sonuç
- Hazır web servisler ve Geliştirici Konsolu yalnız Full pakette işaretli. Lite, Pro ya da Max kullanıyorsanız web servis erişiminin sitenizde açılıp açılamayacağını ve koşulunu ETicaretSoft'a sorun.
- Ürün kodu ve varyantlı barkod yönetimi Lite pakette Yok görünüyor. Pazaryerlerinde beden ve renk seçenekleri genellikle ayrı barkodla listelendiği için seçenek barkodu tutamayan bir sitede eşleştirmenin önemli kısmı elle yapılır.
- Pazaryeri, ticari yazılım ve kargo modülleri bütün paketlerde opsiyonel. Bunlardan birini zaten kullanıyorsanız aynı işi iki sisteme yaptırmamak için hangisini kapatacağınızı baştan planlayın.
ETicaretSoft web servisleri nasıl çalışır: uçlar, parola ve dönüş kodları
ETicaretSoft'un Geliştirici Konsolu'nda yayımlanan doküman (Web Servisler v2.0.3), dış yazılımların sitenize sitenin kendi alan adı altındaki /xml/crm/ dizininden bağlandığını gösterir. Kimlik doğrulama tek bir uygulama parolasıyla yapılır: POST isteklerinde parola alanında, GET isteklerinde ise adresteki pass parametresinde gönderilir. Bu parola yönetim panelinin Admin menüsünde, Ayarlar altındaki Uygulama Ayarları ekranında tanımlıdır ve panele giriş şifrenizle aynı şey değildir.
| Servis dosyası | Yöntem | Dokümana göre işlevi |
|---|---|---|
| urunler.php | GET | Sitedeki ürünleri alanlarıyla birlikte listeler |
| stoklar.php | GET | Ürünlerin stok ve fiyat bilgisini toplu verir |
| urun_yukle.php | POST | Ürün ekler; update_tip alanıyla tam ya da basit güncelleme seçilir |
| siparisler.php | GET | Siparişleri tarih aralığı, tek gün, durum kodu ve gelen/arşiv ayrımıyla süzer |
| siparis_guncelle.php | POST | Sipariş durumunu, takip numarasını, takip linkini ve arşiv bilgisini günceller |
| siparis_yukle.php | POST | Siteye yeni sipariş kaydı oluşturur |
| cari_yukle.php | POST | Müşteri (cari) kaydı ekler; e-posta adresi kayıtlıysa günceller |
Dönüş kodlarını doğru okumak
Servisler başarılı işlemde 1, hatada ER ile başlayan bir kod döndürür. ETicaretSoft destek ekibiyle konuşurken işinize yarayacak kodlar:
- ER-99: Uygulama parolası hatalı. Bütün servislerde aynı anlamı taşır; parolayı ETicaretSoft'ta değiştirdiyseniz bağlantı ekranındaki parolayı da yenileyin.
- ER-08: Ana ürün resmi yok. Görselsiz ürünler ürün yükleme servisinde bu kodla geri döner.
- ER-01, ER-02 ve ER-03 ürün yüklemede ana kategori, kategori ve alt kategorinin eklenemediğini; ER-04 markanın eklenemediğini gösterir.
- ER-01 ve ER-02 sipariş ve cari servislerinde başka anlamlara gelir; kodu her zaman hangi servisten döndüğüyle birlikte okuyun.
ETicaretSoft entegrasyonu adım adım nasıl kurulur?
Kurulum sitenizin adresi ve uygulama parolasıyla yapılır; ETicaretSoft yönetim paneli şifrenizi kimseyle paylaşmanız gerekmez. Önerdiğimiz sıra:
- ETicaretSoft'a sitenizde hazır web servislerin açık olup olmadığını ve paketinizin buna uygun olup olmadığını sorun.
- Yönetim panelindeki Uygulama Ayarları ekranından uygulama parolasını alın ya da yeni bir parola belirleyin.
- Yox İş Ortağım'a başvurun; ön görüşmede kanal listenizi ve paket ihtiyacınızı birlikte netleştirelim.
- Paneldeki ETicaretSoft bağlantı ekranına site adresinizi ve uygulama parolasını girin.
- Ürünleriniz panele okunur; barkod ya da stok koduyla mevcut pazaryeri ilanlarınız için eşleşme önerileri çıkar.
- Eşleşmeyen ürünleri elle bağlayın, açacağınız kanalların kategori ve özellikleriyle eşleştirin.
- Listeyi onayladığınızda stok ve fiyat senkronu başlar; siz onaylamadan hiçbir ilan değişmez.
Kurulumu isterseniz sizinle birlikte yapıyoruz. 15 dakikalık demo görüşmesi için iletişim sayfasından bize ulaşabilirsiniz.
Bağlantıdan sonraki ilk gün nelere bakmalı?
- Sitedeki stok ile paneldeki stok aynı mı? Birkaç ürünü örnek alıp iki tarafta karşılaştırın.
- Senkron sağlığı ekranında pazaryerinin reddettiği ilan ve ret sebebi görünüyor mu?
- Stok çakışmaları listesinde kanallar arasında tutmayan miktar var mı?
- Siteden gelen ilk sipariş, pazaryeri siparişleriyle aynı listeye Yeni aşamasında düştü mü?
ETicaretSoft ürün alanlarını pazaryerine hazırlamak: kod, barkod, seçenek ve birim
Eşleştirmenin kalitesini ETicaretSoft'taki ürün kayıtlarının düzeni belirler. Web servis dokümanında zorunlu işaretli alanlar arasında ürün kodu var, barkod yok; yani sitenizde barkodu boş ürünler bulunabilir. Pazaryerine açmadan önce şu alanları gözden geçirin:
| ETicaretSoft alanı | Dokümandaki karşılığı | Pazaryerine açmadan önce kontrol |
|---|---|---|
| urun_kod | Ürün kodu, zorunlu | Her üründe tekil olmalı; aynı kod iki üründe varsa eşleşme karışır |
| barkod | Ana ürün barkodu, isteğe bağlı | Pazaryeri ilanındaki barkodla birebir aynı olmalı |
| secenek_barkodN ve secenek_stokN | Seçeneğe özel barkod ve stok | Her beden ya da renk için ayrı barkod ve gerçek stok girilmeli |
| stok_birim | Adet, Paket, Kg, Top, Metre, Koli, Düzine, Litre, M2 | Kanalda hangi birimle satacağınızla uyumlu olmalı |
| termin | Teslim süresi, varsayılan 3 iş günü | Pazaryerinde taahhüt edeceğiniz kargoya veriş süresiyle çelişmemeli |
| doviz | TL, USD, EURO, GBP | Döviz fiyatlı ürünlerin kanalda nasıl fiyatlanacağına karar verilmeli |
Seçenekli ürünler: iki başlık, numaralı seçenek satırları
Web servisinde iki seçenek başlığı alanı bulunur; dokümandaki başlık değerleri Renk, Beden, Seçenek, Ölçü, Ebat, Hafıza ve Numara'dır. Her seçenek satırı kendi değerini, alt seçeneğini, barkodunu ve stoğunu taşır ve ürün formunda bu satırlar 1'den 10'a kadar numaralanır. On satırdan fazla kombinasyonu olan ürünlerin web servisle nasıl taşındığını ETicaretSoft'a sorun. Beden ve renk birlikte kullanılıyorsa her kombinasyonun barkodu ayrı olmalı; yalnız ana üründe barkodu bulunan ürünler kendiliğinden eşleşmez.
Koli, düzine ve metreyle satılan ürünler
Sitede koli ya da düzine birimiyle tutulan bir ürünü pazaryerinde adet olarak satarsanız stok miktarı birim farkı yüzünden yanlış görünür. Bu ürünlerde stoğu tek birimde tutup kanalda paket olarak satmak daha güvenli olur: Yox İş Ortağım'da 5'li ya da 10'lu paketler tek stok biriminden düşer, setler bileşenlerin stoğundan eksilir.
ETicaretSoft fiyatlarından pazaryeri fiyatı nasıl türetilir? Örnek hesap
ETicaretSoft dokümanına göre bütün fiyat alanları KDV hariç tutulur ve KDV oranı kdv_oran alanında ayrıca saklanır. fiyat_kdvsiz üye girişi yapmayan ziyaretçinin, fiyat1_kdvsiz üye müşterinin fiyatıdır; fiyat2_kdvsiz ile fiyat5_kdvsiz arası bayi grubu 1–4 fiyatlarıdır, eskifiyat ise ürünün önceki fiyatını tutar.
Yox İş Ortağım'da her kanal için yüzde ya da tutar olarak fiyat farkı tanımlarsınız. Aşağıdaki tablo, yüzde farkın KDV dahil satış fiyatına nasıl yansıdığını gösteren örnek bir hesaptır; komisyon ve kargo payı içermez.
| Kalem | Hesap | Tutar (örnek) |
|---|---|---|
| Sitedeki KDV hariç fiyat (fiyat_kdvsiz) | Başlangıç değeri | 1.000,00 TL |
| KDV (%20) | 1.000 × 0,20 | 200,00 TL |
| Sitede görünen KDV dahil fiyat | 1.000 + 200 | 1.200,00 TL |
| Pazaryeri için tanımlanan fark (örnek %15) | 1.200 × 0,15 | 180,00 TL |
| Pazaryerinde görünen fiyat | 1.200 + 180 | 1.380,00 TL |
Yüzde fark KDV'den önce ya da sonra uygulansa da sonuç değişmez: 1.150 TL'ye %20 KDV eklendiğinde de 1.380 TL bulunur. Tutar olarak tanımlanan farkta ise farkın KDV dahil mi hariç mi girildiğine dikkat edin.
Taban fiyat olarak hangi ETicaretSoft alanı seçilmeli?
Pazaryeri fiyatını herkese açık site fiyatından türetmek en anlaşılır yoldur; üye fiyatı çoğu sitede bir indirim kurgusudur ve bayi grubu fiyatları pazaryerine taban yapılmamalıdır. Fark oranını belirlerken kanalın komisyonunu ve kargo payını hesaba katın: komisyon hesaplama aracıyla satış sonrası net tutarı, KDV hesaplama aracıyla KDV dahil ve hariç tutarları kontrol edebilirsiniz.
ETicaretSoft siparişleri, kargo ve fatura tek listede nasıl yönetilir?
ETicaretSoft kendi tarafında siparişi dört durum koduyla izler: 1 İnceleniyor, 2 Onaylandı/hazırlanıyor, 3 Kargoya teslim edildi, 4 teslimat bilgileri yetersiz olduğu için iptal. Sipariş listesi gelen ve arşivlenen siparişleri ayrı süzer. Yox İş Ortağım'da ise site siparişleri pazaryeri siparişleriyle aynı listede Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim aşamalarından geçer.
| İş | ETicaretSoft ve her pazaryeri ayrı yönetildiğinde | Yox İş Ortağım ile |
|---|---|---|
| Stok | Site satışından sonra her pazaryeri ayrıca güncellenir | Satış nereden gelirse gelsin tek stok kartından bütün kanallarda düşer |
| Fiyat | Site ve her pazaryeri fiyatı ayrı ayrı girilir | Site ve pazaryerleri için ayrı fiyat kuralı, kanal başına yüzde ya da tutar farkı |
| Sipariş | ETicaretSoft paneli ve her satıcı paneli ayrı açılır | Tek liste; otomatik onay ve geciken sipariş uyarısı |
| Etiket ve fatura | Her sistemde ayrı ekrandan hazırlanır | Toplu fatura ve etiket aynı akıştan |
| Pazaryeri hakedişi | Ekstreler elle karşılaştırılır | Sipariş bazında net kâr, fazla komisyon ve ödenmeyen hakediş kontrolü |
Site siparişinin kargosu: ETicaretSoft modülü mü, Yox İş Ortağım mı?
ETicaretSoft; Aramex, Aras, DHL, MNG, Sürat, UPS ve Yurtiçi için kargo API modüllerini opsiyonel olarak sunar. Yox İş Ortağım'da ise kendi kargo sözleşmenizle bağlanır, barkodlu etiketi panelden basar, takip numarasını pazaryeri siparişine iletirsiniz. Site siparişlerinin etiketini iki sistemden birden basmayın; aynı sipariş için iki gönderi kaydı oluşabilir. Site ve pazaryeri gönderilerini Yurtiçi Kargo bağlantısı gibi tek bir sözleşmeden çıkarmak takibi sadeleştirir.
Online fatura yazdırma ile e-Arşiv faturası farklı işlerdir
ETicaretSoft paket sayfasında Pro paketle başlayan bir Online Fatura Yazdırma modülü vardır; sayfa bunu siparişin faturasını site tasarımına uygun biçimde yazdırmak olarak anlatır, e-Fatura ya da e-Arşiv olarak tanımlamaz. Siparişlere e-Arşiv ya da e-Fatura kesmek istiyorsanız Yox İş Ortağım'a bir e-Fatura programı bağlanır; örneğin Nilvera entegrasyonuyla fatura doğrudan siparişten oluşturulur. e-Fatura program bağlantısı Profesyonel paketle başlar.
ETicaretSoft entegrasyonu için hangi Yox İş Ortağım paketi gerekir?
Yox İş Ortağım'da ETicaretSoft siteniz bir satış kanalı hakkı kullanır. Başlangıç paketindeki tek kanal Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ve idefix arasından seçildiği için ETicaretSoft Başlangıç paketinde yer almaz; Büyüme paketinden itibaren seçilir. Fiyatlar aylıktır, yıllık ödemede %20 indirim uygulanır.
| Paket | Aylık fiyat | ETicaretSoft | Kanal hakkı | Ürün / aylık sipariş | Kargo / e-Fatura |
|---|---|---|---|---|---|
| Başlangıç | ₺499 | Seçilemez | 1 (yedi yurt içi pazaryerinden biri) | 500 / 100 | Kargo entegrasyonu yok, takip no elle / yok |
| Büyüme | ₺999 | Seçilebilir | 80 kanaldan herhangi 3'ü | 5.000 / 500 | 1 firma / yok |
| Profesyonel | ₺1.999 | 28 kanallık listeye bağlı, ön görüşmede kontrol edilir | 5 | 10.000 / 2.000 | 2 firma / 1 program |
| Kurumsal | ₺3.999 | Seçilebilir | Sınırsız | 25.000 / 5.000 | 5 firma / 3 program |
| Enterprise | ₺7.999 | Seçilebilir | Sınırsız | Sınırsız | Sınırsız |
Site artı iki pazaryeri için Büyüme paketinin kanal hakkı yeterlidir. Site ve pazaryeri siparişlerine otomatik e-Arşiv ya da e-Fatura da kesilsin istiyorsanız Profesyonel ya da Kurumsal pakete bakın; Profesyonel'in beş kanalı 28 kanallık listeden seçildiği için ETicaretSoft'un durumunu ön görüşmede birlikte kontrol ederiz. Bütün limitler paket karşılaştırmasında yer alıyor; 3 günlük ücretsiz denemede kendi ürünlerinizin eşleşme sonucunu görebilirsiniz.
ETicaretSoft bağlantısında stok çakışmalarını önlemek: kontrol listesi ve sık hatalar
Bir ETicaretSoft sitesinde stok birden fazla kaynaktan yazılabilir. Aynı stoğu iki sistem güncellediğinde miktarlar birbirini ezer; bu yüzden bağlantıdan önce her ürün için stoğun tek kaynağını belirleyin.
ETicaretSoft'ta stoğu değiştirebilen modüller
- Pazaryeri API modülleri: Bir pazaryerini, örneğin Trendyol ya da n11 mağazanızı Yox İş Ortağım'a bağlıyorsanız o kanal için ETicaretSoft modülündeki stok ve fiyat gönderimini kapatın.
- Tedarikçi XML entegrasyonu: XML'den gelen ürünlerde stok ve fiyatın tedarikçiden mi, panelden mi geleceğine karar verin.
- Ticari yazılım bağlantısı (Logo, Mikro, Netsis vb.): ETicaretSoft'a göre bu bağlantıda onaylanan siparişte stok iki sistemden aynı anda düşer; muhasebe programı da site stoğunu yazıyorsa ana kaynağı belirleyin.
- Barkodlu hızlı satış (kasiyer modülü): Mağaza satışları site stoğunu düşürür; bu modülü kullanıyorsanız mağaza stoğunun kanallara nasıl yansıyacağını ön görüşmede konuşalım.
Canlıya geçmeden önce son kontrol
- Web servis erişimi açık, uygulama parolası alınmış ve güvenli bir yerde saklanıyor
- Bütün ürünlerde ürün kodu tekil, seçenekli ürünlerde her seçeneğin barkodu dolu
- Sitedeki stok fiili sayımla aynı; eksi ya da unutulmuş stok kalmamış
- Döviz fiyatlı ve koli ya da düzine birimli ürünler ayrıca işaretlenmiş
- Pazaryeri fiyat farkı komisyon ve kargo payı eklenerek belirlenmiş
- Site siparişlerinin etiketini ve faturasını hangi sistemin keseceği netleşmiş
Son kontrol: 13 Ekim 2026
