Koçtaş Pazaryeri entegrasyonu:
ürün, stok ve sipariş tek panelde.

Koçtaş entegrasyonu nedir, Mirakl altyapısı satıcı için neyi değiştirir?

Koçtaş entegrasyonu, Koçtaş Pazaryeri'ndeki ilanlarınızın stok, fiyat ve sipariş bilgisini panele tek tek girmek yerine API bağlantısıyla güncel tutmaktır. Koçtaş, satıcılarına satış yönetimi için Koçtaş Satış Ortağım Paneli'ni ve Mirakl platformunu sunuyor; panele koctas.mirakl.net adresinden giriliyor ve Koçtaş, kendi bağlantısını kurmak isteyen satıcılarla API dokümanlarını paylaştığını belirtiyor. Mirakl, pazaryeri işleten şirketlere satıcı tarafını hazır veren bir yazılım; bu yüzden Koçtaş'taki iş akışı, kendi panelini yazmış pazaryerlerinden biraz farklı işliyor.

Ürün kaydı, teklif ve sipariş: Mirakl'da üç ayrı akış

• Ürün (katalog) kaydı: başlık, açıklama, görsel ve kategori özellikleri. Kategori seçimi komisyon oranını da belirlediği için bu kayıt yalnız içerik değil, maliyet kararıdır.
• Teklif (offer): sizin fiyatınız ve stok adediniz. Mirakl'ın satıcı API'sinde stok ve fiyat için ayrı içe aktarma uçları var; genel dokümanda stok dosyası için önerilen sıklık 5 dakikada bir, üst sınır dakikada birdir.
• Sipariş: müşteri satın aldığında oluşur; kabul, takip numarası ve gönderim onayı adımlarından geçer.

Pratik sonucu şudur: ürün kataloğa kabul edilmeden teklif tek başına bir işe yaramaz; kabul edildikten sonra ise günlük işin neredeyse tamamı teklif ve sipariş üzerinden yürür. Aşağıdaki tablo, Mirakl'ın genel satıcı API dokümanına göre bir siparişin geçtiği adımları özetliyor.

Koçtaş'ta satıcı olma şartları: belgeler, şirket türü ve başvuru süresi

Koçtaş Pazaryeri'nde satış yapabilmek için önce satış ortağı başvurunuzun onaylanması gerekir ve Koçtaş, başvurulara 30 gün içinde dönüş yapıldığını belirtiyor. Entegrasyon bu onaydan sonra gelir; onaylanmamış bir mağazayı hiçbir yazılım Koçtaş'a bağlayamaz. Koçtaş'ın resmî sayfalarında yazan koşulları tek tabloda topladık:

Şahıs firmasıyla başvurmadan önce teyit alın

Sayfa şirket türü için anonim ve limitedi örnek veriyor, belge listesinde ise şahıs firmaları için oda kayıt belgesinden söz ediyor. Bu iki ifade birlikte okunduğunda şahıs firmalarının kabulü net değil; başvuruyu hazırlamadan önce Koçtaş satıcı desteğine sormanız zaman kazandırır. Başvuru öncesinde şunları da hazırlayın:

• Ticari unvanın vergi levhası, imza sirküleri ve formda harfi harfine aynı yazılması
• Aktif bir KEP adresi
• Mağazalarda da satış istiyorsanız formdaki mağaza seçeneği
• Ürün gruplarınızın Ek 9 yasak ürünler listesinde olmadığının kontrolü

Koçtaş komisyon oranları 2026: KDV dahil oranlar ve kategori örnekleri

Koçtaş komisyonu KDV dahil satış fiyatı üzerinden ve KDV dahil oran olarak keser; yani tablodaki oranın üzerine ayrıca KDV eklenmez. Oranlar, satıcı sayfasından bağlantı verilen Elektronik Ticaret Pazaryeri Sözleşmesi Ek 7'de alt kategori düzeyinde yayımlanıyor. Ekim 2026'da bu tabloda en düşük oran %7,5 (oyun konsolları), en yüksek oran %23 (kablo kanalı, klemens, kablo düzenleyiciler). Yapı market ve ev-bahçe satıcılarının en sık açtığı ürün grupları için tablodan seçtiğimiz oranlar:

Kiosk primi ve yanlış kategori kuralı

Ek 7'de iki kural daha var. Müşteri internetten seçtiği ürünü Koçtaş mağazasındaki kasada öderse satıcı, satış bedeli üzerinden %3 kiosk primini komisyona ek olarak öder; Koçtaş bu tutarı alacağınızdan mahsup edebilir. Yanlış kategoride açılan ürün için düzeltme istenir, düzeltilmezse komisyon olması gereken kategorinin oranıyla hesaplanır. Aynı ürün iki yerde geçebiliyor: tavan vantilatörü Aydınlatma ve Elektrik altında %15, Isıtma ve Soğutma altında %13.

Örnek hesap: Koçtaş'ta bahçe mobilyası satışında hakediş ve net kâr

Koçtaş'ta kârı belirleyen kalemler komisyon, kargo, %1 stopaj ve KDV farkıdır; bunları tek tabloda görmek fiyat kararını kolaylaştırır. Aşağıdaki hesapta oran gerçek: bahçe takımları Ek 7'de %20 komisyonla listeleniyor. Satış fiyatı, ürün maliyeti ve kargo tutarı ise yalnızca örnek; kargo rakamı Koçtaş'ın bir tarifesi değildir. Ürünün KDV oranı %20 kabul edildi.

Stopaj yıllık vergiden mahsup edilebildiği için vergi öncesi kâr 1.125 TL, KDV hariç satışa göre marj %22,5 olur. Aynı sipariş mağaza kasasında ödenirse 180 TL kiosk primi eklenir ve hakediş 4.120 TL'ye iner. Kendi ürünleriniz için hesabı komisyon hesaplama aracıyla, maliyet ve kargo dahil sonucu kâr hesaplama aracıyla tekrarlayabilirsiniz.

Stopaj ve KDV'yi hesapta doğru yere koymak

9284 sayılı Cumhurbaşkanı Kararı ile 1 Ocak 2025'ten bu yana elektronik ticaret aracı hizmet sağlayıcılarının satıcılara yaptığı ödemelerden %1 vergi kesintisi yapılıyor. Gelir Vergisi Genel Tebliği (Seri No: 330), matraha KDV'nin girmediğini ve kesintinin gelir ya da kurumlar vergisinden mahsup edilebileceğini açıklıyor; stopajı maliyet gibi fiyata eklemek fiyatı gereksiz yükseltir. Komisyon faturasındaki KDV ise indirilebilir; atlanırsa kâr olduğundan düşük görünür.

Koçtaş kargo kuralları: 30 desi sınırı, anlaşmalı firmalar ve kendi kargonuz

Koçtaş'ta hangi kargo firmasının kullanılacağını ürünün desisi belirler: Koçtaş, 30 desi ve altı gönderiler ile 30 desi üstü gönderiler için ayrı firmalarla anlaşmalı çalıştığını belirtiyor. Bahçe mobilyası, banyo dolabı ya da kombi satan bir işletmede kargo maliyeti bu yüzden baştan farklı hesaplanır.

Desi hatası neden maliyet hatasına dönüşür?

Ürünün ölçüleri eksik ya da kutusuz hâliyle girildiğinde, 30 desinin hemen üstündeki bir koli yanlış firma grubuna düşebilir ve kargo kesintisi beklediğinizden farklı çıkar. Ölçüyü ambalajlı koli üzerinden alın ve desiyi desi hesaplama aracıyla kontrol edin; set halinde satılan bahçe takımlarında her koli için ayrı ölçü tutun.

Kendi kargo sözleşmenizle Yox İş Ortağım'dan gönderim

Yox İş Ortağım'da kendi kargo sözleşmenizi bağladığınızda etiketi panelden basarsınız ve takip numarası Koçtaş siparişine işlenir; alıcı kargosunu kanal üzerinden izler. Koçtaş'ın küçük gönderilerde andığı firmalardan Yurtiçi Kargo entegrasyonu buna bir örnek. Kargo bağlantısı Büyüme paketinde 1, Profesyonel'de 2, Kurumsal'da 5 firmaya kadar açılır; Başlangıç paketinde takip numarası elle girilir.

Yox İş Ortağım ile Koçtaş entegrasyonu adım adım nasıl kurulur?

Yox İş Ortağım'da Koçtaş entegrasyonu, Satış Ortağım Paneli'nden aldığınız API anahtarının panele girilmesiyle başlar; mağaza şifrenizi paylaşmazsınız ve siz onaylamadan Koçtaş'taki hiçbir ilan değişmez. Kurulumu isterseniz ön görüşmeden sonra sizinle birlikte yapıyoruz.

1. Koçtaş Satış Ortağım Paneli'nde hesabınıza ait API anahtarını alın; anahtarı göremiyorsanız Koçtaş satıcı desteğinden isteyin.
2. Yox İş Ortağım'da Koçtaş Pazaryeri kanalını seçin ve anahtarı girin.
3. Mevcut Koçtaş ilanlarınız panele gelir ve ürün kartlarınızla barkod ya da stok koduyla eşleştirilir.
4. Eşleşmeyen ilanları kontrol edin; toplu bir değişiklikten önce neyin değişeceği size gösterilir.
5. Koçtaş'ta olmayan ürünleriniz için ürün kartını Koçtaş kategorisine ve özelliklerine eşleştirin; varyantlar tek karttan yönetilir.
6. Kanal bazında fiyat kuralınızı tanımlayın; stok, fiyat ve sipariş senkronu bundan sonra diğer kanallarla birlikte işler.
7. İlk Koçtaş siparişinde takip numarasının ve sipariş aşamalarının panele doğru yansıdığını birlikte kontrol edin.

Paneli 3 gün ücretsiz deneyebilir, karar vermeden önce mevcut ilanlarınızın nasıl eşleştiğini görebilirsiniz. Deneme ve ön görüşme için Yox İş Ortağım'a başvurun.

Koçtaş'ı diğer pazaryerleriyle birlikte yönetmek: elle mi, tek panelden mi?

Çoğu işletme Koçtaş'ı, Trendyol entegrasyonu ya da Hepsiburada entegrasyonu ile kurduğu mağazalara ek kanal olarak açar. Yük o noktada başlar: aynı son ürün iki kanalda birden satılabilir ve her panelin sipariş ve hakediş dökümü ayrı okunur.

Hangi satıcı için entegrasyon gerekli, hangisi için erken?

Yalnız Koçtaş'ta, az sayıda ürün ve günde birkaç siparişle satış yapıyorsanız Satış Ortağım Paneli tek başına yeterli olabilir. Aynı stoğu iki ya da daha fazla kanalda satıyorsanız elle güncelleme hata payını büyütür; tükenen bir ürünün bir kanalda satışta kalması iptal olarak geri döner.

Koçtaş entegrasyonu hangi Yox İş Ortağım paketinde, ne kadar?

Koçtaş Pazaryeri, tek kanallı Başlangıç paketinde yer almaz; Büyüme paketinden itibaren seçilebilir. Yox İş Ortağım'da 80 satış kanalı (48'i kullanıma hazır), 57 kargo ve lojistik firması ile 51 muhasebe, e-Fatura ve ERP programı tanımlı. Koçtaş'ın pakete göre durumu:

Yıllık ödemede %20 indirim uygulanır. Paketler ürün ve sipariş limitiyle de ayrılır: Büyüme'de 5.000 ürün ve ayda 500 sipariş, Profesyonel'de 10.000 ürün ve 2.000 sipariş, Kurumsal'da 25.000 ürün ve 5.000 sipariş. Koçtaş'ın yanında iki kanal daha bağlayacaksanız Büyüme yeterli olabilir; dördüncü kanal ya da e-Fatura gerekiyorsa Profesyonel ve üstüne bakın. Limitlerin tamamı paket karşılaştırmasında, diğer kanallar entegrasyonlar sayfasında.

Koçtaş'ta canlıya geçmeden önce kontrol listesi ve sık yapılan hatalar

Koçtaş'ta ilk haftaların sorunlarının çoğu bağlantıdan değil, katalog ve kural hatalarından çıkar. Senkronu açmadan önce iki konuya ayrıca bakmanızı öneririz: satışı yasak ürünler ve kategori-komisyon uyumu.

Yasak ürün listesinde yapı market satıcısını ilgilendirenler

Pazaryeri Sözleşmesi Ek 9, satışı yasak ürünleri sayıyor ve listenin Satıcı Portalı üzerinden güncel tutulacağını belirtiyor. Ev, yapı ve bahçe kataloglarında en çok karşılaşılabilecek kalemler: gübre, tehlikeli kimyasallar, petrol ve benzin, yanıcı ve patlayıcı maddeler, telsiz ve telekomünikasyon cihazları, maymuncuk ve kilit açıcılar, emniyet kemeri adaptörü, radar dedektörleri ve promosyon ürünleri.

Senkronu açmadan önce kontrol edin

• Her ürün, komisyonu doğru hesaplanacak alt kategoride mi açıldı?
• Barkod ve stok kodları diğer kanallardaki ilanlarla birebir aynı mı?
• 30 desiye yakın ürünlerde ambalajlı ölçü girildi mi?
• Koçtaş fiyatınız %3 kiosk primi ihtimaliyle birlikte kâr bırakıyor mu?
• Kendi kargonuzla gönderiyorsanız takip numarası ilk siparişte Koçtaş'a ulaştı mı?
• Stoğu tükenmek üzere olan ürünler için kabul adımında kimin karar vereceği belli mi?

En sık gördüğümüz üç hata: komisyonun üzerine bir de KDV eklemek, hacimli ürünleri tek ortalama desiyle hesaplamak ve stoğu olmayan siparişi kabul edip sonradan iptal etmek. Bu kontrolleri ön görüşmede kendi kataloğunuz üzerinde birlikte yapabiliriz; sorularınız için bize ulaşın.