İdeaSoft entegrasyonu:
siteniz ve pazaryerleri aynı stokta.

İdeaSoft entegrasyonu nedir, hangi satıcının işine yarar?

İdeaSoft entegrasyonu, sitenizi merkezi bir panele bağlayarak satış hangi kanaldan gelirse gelsin stoğun her yerde aynı anda düşmesini sağlar. Yox İş Ortağım'da İdeaSoft, 80 satış kanalı içindeki e-ticaret altyapılarından biridir: sitedeki ürünler panele aktarılır, aynı ürün kartlarından pazaryeri ilanı açılır ve site siparişleri pazaryeri siparişleriyle aynı listeye düşer. Bütün kanal, kargo ve muhasebe bağlantılarını entegrasyon sayfamızda görebilirsiniz.

Elle takibin yetmediği nokta

Tek bir sitede satarken stok sayısını İdeaSoft panelinden yönetmek yeterlidir. Aşağıdaki durumlardan ikisi sizde varsa elle güncelleme artık hata üretmeye başlar:

• Aynı ürünü hem sitenizde hem de en az iki pazaryerinde satıyorsunuz.
• Gün sonunda stok sayılarını kanal kanal karşılaştırıp düzeltiyorsunuz.
• Site fiyatını değiştirdiğinizde pazaryeri fiyatlarını ayrıca güncellemeniz gerekiyor.
• Siparişleri İdeaSoft panelinden ve her pazaryerinin satıcı panelinden ayrı ayrı topluyorsunuz.

Bağlantıdan önce: İdeaSoft paketinizde API erişimi var mı?

Dışarıdan bir yazılımın İdeaSoft sitenize bağlanabilmesi için mağaza paketinizde API erişiminin tanımlı olması gerekir; İdeaSoft'un API kullanımı yardım sayfası, API sisteminin pakete eklenmesi gerektiğini açıkça belirtiyor. İdeaSoft'un e-ticaret paketleri sayfasındaki karşılaştırma tablosu Ekim 2026'da şöyle görünüyor:

Tablodaki opsiyonel ifadesi, API erişiminin pakete ayrıca eklenen bir hak olduğunu gösteriyor; ek ücret sayfada yazmıyor. Booster'da tek API hakkı bulunduğu için bu hakkı başka bir yazılım (ör. bir muhasebe bağlantısı) kullanıyorsa yeni bağlantı için yer kalıp kalmadığını önceden öğrenin. İdeaSoft bu konuda 0216 326 04 77 numaralı hattı ve [email protected] adresini gösteriyor.

İdeaSoft entegrasyonu kurulumu: API uygulaması adım adım

İdeaSoft entegrasyonu kurulumu, İdeaSoft panelinde bir API uygulaması oluşturup üretilen Client ID ve Client Secret bilgilerini Yox İş Ortağım'a girmekle başlar; mağaza şifreniz hiçbir aşamada istenmez. İdeaSoft yardım sayfası ve API dokümanına göre sıra şöyledir:

1. 1 ID'li yönetici hesabıyla İdeaSoft paneline girin ve Entegrasyonlar > API bölümünü açın.
2. API Ekle düğmesiyle yeni bir uygulama oluşturun; adını sonradan tanıyacağınız biçimde yazın, örneğin Yox İş Ortağım.
3. Yönlendirme adresi alanını doldurun. İdeaSoft bu adresin bağlantı kurulan yazılımdan alınmasını istiyor; kurulumu birlikte yapıyorsak bu alanı görüşme sırasında beraber dolduruyoruz.
4. Kaydedin. Client ID ve Client Secret sistem tarafından otomatik üretilir.
5. Uygulamanın sağındaki İzin Yönetimi alanından izin seviyesini seçin.
6. Client ID ve Client Secret bilgilerini Yox İş Ortağım'daki İdeaSoft bağlantı alanına girin; ardından ürün aktarımına geçin.

Okuma mı, Okuma/Yazma mı?

İzin Yönetimi'nde iki seçenek vardır: Okuma ve Okuma/Yazma. Okuma izni ürünleri ve siparişleri görmeye yeter ama siteye hiçbir şey yazdırmaz. Pazaryerinde satılan ürünün İdeaSoft sitenizde de düşmesi bir yazma işlemi olduğu için çift yönlü stok senkronu Okuma/Yazma izni gerektirir.

Client Secret nasıl saklanmalı?

İdeaSoft dokümanı Client ID'yi açık bilgi, Client Secret'ı ise gizli tutulması gereken bilgi olarak tanımlıyor. Secret değerini e-postayla ya da mesajla kimseye iletmeyin, bağlantı alanına kendiniz yapıştırın. Değerin başkasının eline geçtiğini düşünüyorsanız yeni bir API uygulaması oluşturup bilgileri güncelleyin, eski uygulamanın kapatılması için İdeaSoft destekle görüşün.

İdeaSoft API yetkilendirmesi: token süreleri ve hata kodları

İdeaSoft Admin API, OAuth2 standardının authorization_code akışını kullanır: yönetici uygulamaya bir kez izin verir, yazılım bu izinle 24 saat geçerli bir erişim anahtarı ve 2 ay geçerli bir yenileme anahtarı alır. Bağlantının neden kesildiğini anlamak için aşağıdaki kurallar işinize yarar:

Bağlantı neden birden kesilir?

En sık üç sebep görülür: API uygulamasının İdeaSoft panelinden silinmesi, izin seviyesinin Okuma'ya düşürülmesi ve yenileme anahtarının 2 ay boyunca hiç kullanılmaması. İzin seviyesini değiştirmeden önce bağlantının hangi işlemleri yaptığını düşünün; yazma izni kaldırıldığında stok siteye yazılamaz. Bağlantı hatası görürseniz ekran görüntüsüyle bize yazın, birlikte bakalım.

İdeaSoft'un pazaryeri uygulamaları ile merkezi panel birlikte kullanılır mı?

Kullanılabilir, ancak aynı pazaryeri mağazasının stok ve fiyatını iki sistem aynı anda yönetmemelidir; her pazaryeri için tek bir yönetici sistem seçmeniz gerekir. İdeaSoft'un Trendyol, Hepsiburada ve n11 uygulamaları paneldeki Uygulamalar alanından kurulur; Master paket sayfası da Trendyol, Hepsiburada, N11, Amazon ve TEMU bağlantısını iki yönlü olarak tanımlıyor.

İdeaSoft yardım sayfalarına göre bu uygulamalar pazaryerine göre farklı çalışır. Hepsiburada uygulamasında stok otomatik eşitlenir ama fiyat değişikliği Fiyat ve Stok Güncelle işlemiyle elle gönderilir. Trendyol'da otomatik stok senkronu ayarlardan açılır. n11 sayfası ise daha önce aktarılan ürünler için Fiyat-Stok Güncelle adımını anlatıyor. Trendyol ve Hepsiburada siparişlerinin uygulamaların kendi ekranında listelendiği yazıyor; aynı ekrana taşıma güncellemesi duyurulmuş, güncel durumu panelinizden kontrol edin.

Geçişte çift gönderimi önlemek

• Merkezi panele taşıdığınız pazaryerinde İdeaSoft uygulamasının otomatik stok senkronunu kapatın.
• Kapatmadan önce mevcut ilanların panele gelmesini ve barkodla eşleşmesini bekleyin; bu aşamada hiçbir ilan değişmez.
• Bir pazaryerini aynı gün içinde bütünüyle taşıyın; yarısı İdeaSoft'ta, yarısı panelde kalan katalog en sık çakışma sebebidir.
• Taşımadan sonra bir test siparişiyle stoğun iki tarafta da düştüğünü doğrulayın.

İdeaSoft ürünlerini pazaryerine hazırlamak: barkod, marka ve kategori

Pazaryerine gidecek bir İdeaSoft ürününde benzersiz barkod, dolu marka alanı ve açıklama bulunmalı, ürün de pazaryerinin en alt kategorisiyle eşleştirilmelidir. Bu kurallar Yox İş Ortağım'a özel değildir; İdeaSoft'un kendi pazaryeri yardım sayfaları da aynı alanları istiyor. Bağlantıdan önce şu kontrolleri yapın:

• Barkodlarda yalnız harf ve rakam kullanın; İdeaSoft'un Hepsiburada sayfası boşluk ve özel karakter içeren barkodun reddedildiğini yazıyor.
• Stok kodlarını büyük harfle girin; Hepsiburada stok kodlarını büyük harfle işler, küçük harfli kodda fiyat ve stok güncellemesi tutmaz.
• Marka alanını boş bırakmayın; Trendyol ve n11 markasız ürünü kabul etmez.
• Açıklaması boş ürünler Hepsiburada'ya aktarılamaz.
• Her ürünü pazaryerinin en alt kategorisiyle eşleştirin ve kategorinin zorunlu özelliklerini doldurun.

Varyantlı ürünlerde barkod düzeni

Beden ve renk seçenekli ürünlerde ana ürünün ve her varyantın barkodu farklı olmalıdır. İdeaSoft'a göre varyant eklendiğinde stok kodu değişir ama barkod değişmez; yeni varyantların barkodunu tek tek ya da Excel ile sizin girmeniz gerekir. Yox İş Ortağım'da ürünler panele geldikten sonra pazaryeri kategorileriyle eşleştirirsiniz ve siz onaylamadan hiçbir ürün değişmez. Kanal bazındaki kurallar için Trendyol ve Hepsiburada entegrasyonu sayfalarına da göz atın.

İdeaSoft ve pazaryerleri için ayrı fiyat kuralı nasıl kurulur?

Sitenizde ve pazaryerlerinde aynı fiyatı kullanmak zorunda değilsiniz: Yox İş Ortağım'da site ve her pazaryeri için ayrı fiyat kuralı tanımlayıp pazaryeri komisyonunu satış fiyatına yansıtabilir, sitenizde daha avantajlı kalabilirsiniz. Kural yüzde ya da tutar olarak kurulur ve temel fiyat değiştiğinde kanal fiyatı aynı kuralla yeniden hesaplanır. Aşağıdaki rakamlar yalnız örnektir:

Yüzde mi, sabit tutar mı?

Pazaryeri komisyonu satış tutarı üzerinden yüzdeyle kesildiği için yüzde kural, fiyat yükseldikçe payı da büyüttüğünden daha güvenlidir. Kargo gibi siparişe göre sabit kalan kesintiler için tutar farkı daha doğru sonuç verir. Komisyon oranları kategoriye göre değişir; güncel oranı satıcı panelinizden kontrol edin ve farkı komisyon hesaplama aracıyla sınayın. Net sonucu görmek için kâr hesaplama aracı da işinize yarar.

İdeaSoft siparişleri, kargo ve fatura aynı listede

Bağlantıdan sonra İdeaSoft sitenize düşen siparişler pazaryeri siparişleriyle aynı listede görünür ve kargo ile fatura işlemleri aynı akıştan yürür. İdeaSoft'un kendi Trendyol ve Hepsiburada uygulamalarında siparişlerin uygulamanın ayrı ekranında listelendiği düşünülürse, birden fazla kanalda satan mağaza için bu fark gün içindeki ekran sayısını doğrudan azaltır.

• Site siparişi ile pazaryeri siparişini aynı listede, aynı durumlarla izlersiniz.
• Kargo gönderimini kendi kargo anlaşmanızla bağlanan firma üzerinden yaparsınız.
• Faturayı bağlı e-Arşiv ya da e-Fatura programı üzerinden aynı akışta kesersiniz.

Kargo ve e-Fatura bağlantısı hangi pakette?

Yox İş Ortağım'da 57 kargo ve lojistik firması ile 51 muhasebe, e-Fatura ve ERP programı tanımlıdır; bağlanabilecek sayı pakete göre değişir. Büyüme paketinde 1 kargo firması, Profesyonel'de 2 kargo firması ve 1 e-Fatura programı, Kurumsal'da 5 kargo firması ve 3 program bağlanır. Örneğin gönderilerinizi Yurtiçi Kargo ile, faturalarınızı Paraşüt ile yönetiyorsanız ikisini de aynı panele bağlayabilirsiniz; e-Fatura için Profesyonel ve üzeri paket gerekir.

Yox İş Ortağım'da İdeaSoft entegrasyonu hangi pakette?

İdeaSoft, Yox İş Ortağım'ın Başlangıç paketinde yer almaz; Büyüme paketinden itibaren seçilebilen kanallardandır ve bağlandığında paketinizdeki kanal haklarından birini kullanır. Paket karşılaştırması şöyle:

Örnek: İdeaSoft siteniz, Trendyol ve Hepsiburada toplam 3 kanal eder ve Büyüme paketine sığar; dördüncü bir kanal eklemek isterseniz Kurumsal pakete bakmanız gerekir. Panelde birden fazla kişi çalışacaksa kullanıcı sayısına da bakın: Büyüme'de 2, Profesyonel'de 3, Kurumsal'da 10 kullanıcı tanımlanır. Yıllık ödemede %20 indirim uygulanır ve bütün paketler 3 gün ücretsiz denenebilir. Ayrıntılı limitleri paket karşılaştırmasında bulabilirsiniz.

İdeaSoft entegrasyonunda sık yapılan hatalar ve ilk hafta kontrol listesi

İdeaSoft bağlantısında sorunların çoğu bağlantının kendisinden değil, eksik izin, tekrarlanan barkod ya da aynı kanalın iki sistemden yönetilmesinden kaynaklanır. Kurulumdan önce ve sonra aşağıdaki iki listeyi kullanın.

Sık yapılan hatalar

• API uygulamasına yalnız Okuma izni vermek; stok siteye yazılamaz.
• Aynı barkodu birden fazla varyantta kullanmak; ürünler eşleşmez.
• İdeaSoft'un pazaryeri uygulamasını açık bırakıp aynı mağazayı merkezi panele de bağlamak.
• Booster paketteki tek API hakkını başka bir yazılıma verip yeni bağlantıyı denemek.
• Client Secret'ı mesajla paylaşmak ya da yanlış kopyalamak; bağlantı yetki hatası verir.

İlk hafta kontrol listesi

• Eşleşmeyen ürünleri, özellikle varyantlıları tek tek gözden geçirin.
• Site ve pazaryerinde farklı görünen stok sayılarını düzeltin.
• Fiyat kuralının uygulandığı birkaç ürünü pazaryeri vitrininde kontrol edin.
• Her kanaldan gelen ilk siparişin aynı listeye düştüğünü ve kargo ile faturanın tamamlandığını doğrulayın.
• İdeaSoft panelindeki API uygulamasının izin seviyesinin hâlâ Okuma/Yazma olduğunu kontrol edin.

Hazırsanız Yox İş Ortağım'a başvurun; ön görüşmede İdeaSoft paketinizi birlikte kontrol eder, isterseniz kurulumu sizinle beraber yaparız.