Koçtaş pazaryeri, ev yapı market ve dekorasyon kategorisinde satış yapan işletmeler için Türkiye'nin en dikkat çeken kanallarından biri. Ancak birçok satıcının kafası daha ilk adımda karışıyor: "Ürünlerimi Koçtaş'a nasıl bağlayacağım? Panelden tek tek mi gireceğim, kendi yazılımımla API üzerinden mi konuşacağım, yoksa bir entegratöre mi başvuracağım?" Bu sorunun cevabı, aslında Koçtaş'ın çalıştığı altyapıyı anlamakla başlıyor. Koçtaş pazaryeri, dünyada yüzlerce büyük perakendecinin kullandığı Mirakl pazaryeri platformu üzerinde çalışıyor ve satıcılara kendi Satış Ortağım Paneli ile hem manuel yönetim hem de gelişmiş API entegrasyonu imkanı sunuyor.
Bu yazı, Koçtaş entegrasyonunu "başvuru rehberi" seviyesinde değil, gerçek operasyon derinliğinde ele alıyor. Panel mi API mi entegratör mü sorusunun hangi işletmeye hangi cevabı verdiğini, ürün listeleme ve öznitelik eşlemenin nasıl işlediğini, stok ve fiyat senkronizasyonunun hangi alanlar üzerinden döndüğünü, siparişten kargoya uzanan akışı, birden fazla pazaryeri ile kendi web sitenizi tek stok havuzunda buluşturmayı ve en sık karşılaşılan entegrasyon hatalarını tek tek açıklıyoruz. Amacımız, Koçtaş'a bağlanmadan önce doğru kararı vermenizi ve bağlandıktan sonra da satış kaybettirmeyen sağlam bir kurgu oturtmanızı sağlamak.
Koçtaş Neden Mirakl Altyapısında Çalışıyor ve Bu Sizi Nasıl Etkiler?
Koçtaş pazaryerini diğer bazı yerel pazaryerlerinden ayıran en temel teknik gerçek, altyapısının Mirakl olması. Mirakl, dünya genelinde büyük perakende zincirlerinin kendi pazaryerlerini kurmak için tercih ettiği kurumsal bir platform. Bunun satıcı için pratikte iki büyük anlamı var. Birincisi, entegrasyon mantığı standarttır: Mirakl'ın kavramları, veri modeli ve API yapısı diğer Mirakl tabanlı pazaryerleriyle büyük ölçüde ortaktır. Yani Koçtaş için kurulan bir entegrasyon mimarisi, başka bir Mirakl pazaryerine uyarlanırken sıfırdan başlanmaz. İkincisi, Mirakl'ın veri kalitesi ve onay standartları yüksektir; ürün bilgileriniz belirli kurallara ve zorunlu özniteliklere uymadan yayına girmez.
Bu yapı, "hızlıca birkaç ürün atıp satışa başlayayım" diyen satıcıyı ilk başta zorlayabilir. Ancak orta ve uzun vadede lehinize çalışır. Çünkü doğru kurgulanmış bir Mirakl entegrasyonu, ürün aktarımını, stok senkronizasyonunu ve sipariş yönetimini büyük ölçüde otomatikleştirir; manuel iş yükünü ciddi biçimde azaltır. Entegrasyonun kalbinde iki temel bileşen vardır: satıcı olarak sizin işlem yaptığınız Satış Ortağım Paneli ve sistemler arası konuşmayı sağlayan Mirakl Satıcı API'leri. Panel insanın gözüyle çalışır, API ise makinenin diliyle. Doğru entegrasyon stratejisi, bu ikisinden hangisini ne kadar kullanacağınıza karar vermekle başlar.

Koçtaş entegrasyonunu doğru kurmak, yalnızca "ürünleri yükledim" demek değildir. Kategori doğru mu eşlendi, zorunlu öznitelikler eksiksiz mi, stok kanallar arasında çakışıyor mu, sipariş geldiğinde kaç dakikada kabul ediliyor, kargo takip numarası sisteme zamanında düşüyor mu; işte entegrasyonun gerçek başarısı bu detaylarda saklıdır. Alis Dijital olarak pazaryeri yönetimi tarafında en çok gördüğümüz sorun, satıcıların altyapıyı anlamadan hızlıca bağlanıp sonra "neden ürünlerim onaylanmıyor, neden stok kayması oluyor" diye takılmasıdır. Bu yazının geri kalanı, tam olarak bu tuzaklardan kaçınmanız için yazıldı.
Mirakl Standardı Neden Satıcının Lehinedir?
Mirakl'ın standart bir platform olması, satıcı için birkaç somut avantaj yaratır. Öncelikle, entegrasyon bilgisi taşınabilir hale gelir. Bir Mirakl pazaryerinde ürün, teklif, sipariş kavramlarını öğrenen bir ekip, aynı mantığı başka bir Mirakl pazaryerine büyük ölçüde aktarabilir. İkincisi, entegratör ekosistemi geniştir; Mirakl dünya çapında yaygın olduğu için birçok yazılım firması Mirakl tabanlı pazaryerlerine hazır bağlantı sunar. Üçüncüsü, veri kalitesi standartları sayesinde katalog zamanla temiz kalır; kötü veri, onay aşamasında elenir ve mağazanız düzensiz ürünlerle dolmaz. Bu, kısa vadede zahmet gibi görünse de uzun vadede müşteri güvenini ve arama görünürlüğünü artırır.
Bir başka önemli nokta, Mirakl'ın satıcı performansını sürekli ölçmesidir. Sipariş kabul hızınız, zamanında kargolama oranınız, iptal ve iade oranlarınız gibi metrikler bir satıcı puanına dönüşür. Bu puan, ürünlerinizin görünürlüğünü ve müşteri gözündeki güvenilirliğini etkiler. Yani entegrasyonunuzun teknik kalitesi, doğrudan satış hacminize yansır. Yavaş senkronlayan, siparişi geç kabul eden, kargoyu geç bildiren bir kurgu; sadece operasyonel bir sıkıntı değil, görünürlük kaybı ve dolayısıyla ciro kaybı demektir. Bu yüzden entegrasyonu bir "teknik detay" değil, bir "satış motoru" olarak görmek gerekir.
Yapı Market Kategorisinin Kendine Özgü Zorlukları
Koçtaş'ın ana kategorisi olan yapı market, bahçe, dekorasyon ve ev geliştirme ürünleri, entegrasyon açısından bazı özel zorluklar taşır. Ürünler genellikle hacimli, ağır ve çeşitli varyantlıdır; aynı ürünün farklı renk, ebat, güç veya montaj tipinde onlarca varyantı olabilir. Bu, hem öznitelik yönetimini hem de kargo/desi hesabını karmaşıklaştırır. Ayrıca bu kategorideki müşteri, teknik özelliklere çok dikkat eder; bir matkabın tork değerini, bir boyanın metrekare verimini, bir bataryanın montaj tipini yanlış girmek doğrudan iade doğurur. Dolayısıyla Koçtaş entegrasyonunda öznitelik doğruluğu, diğer birçok pazaryerine göre daha kritiktir. Bu gerçeği baştan kabul etmek, entegrasyonu hangi yöntemle kuracağınıza dair kararınızı da olgunlaştırır.
Panel mi, API mi, Entegratör mü? Üç Yolun Özeti
Koçtaş'a ürün, stok ve sipariş bağlamanın üç temel yolu var ve bunların hangisinin size uygun olduğu; ürün sayınıza, günlük sipariş adedinize, teknik ekibinizin varlığına ve zaten kullandığınız yazılımlara bağlı. Bu üç yolu birbirinin alternatifi gibi düşünmek yerine, bir merdivenin basamakları gibi görmek daha doğru. Küçük başlarsınız, büyüdükçe üst basamağa geçersiniz.
Birinci yol, doğrudan Satış Ortağım Paneli üzerinden manuel yönetimdir. Onay aldıktan sonra panele girer, ürünlerinizi tek tek veya toplu Excel dosyasıyla eklersiniz. Kod bilgisi gerekmez, hiçbir üçüncü taraf yazılım ödemezsiniz. İkinci yol, kendi sisteminizi Koçtaş'ın Mirakl API'lerine doğrudan bağlamaktır. Bu, kendi ERP'sini veya özel yazılımını Koçtaş'la konuşturmak isteyen, teknik ekibi olan işletmeler içindir. Üçüncü yol ise bir entegratör iş ortağı kullanmaktır. Entegratör, sizinle Koçtaş arasında duran hazır bir köprüdür; ürün, stok, fiyat ve sipariş akışını tek bir panelden yönetmenizi sağlar ve çoğu zaman diğer pazaryerlerini de aynı ekrana taşır.
| Kriter | Satış Ortağım Paneli (Manuel) | Doğrudan API | Entegratör |
|---|---|---|---|
| Kime uygun | Az ürünlü, yeni başlayan, düşük sipariş hacmi | Teknik ekibi olan, kendi ERP/yazılımını bağlamak isteyen | Orta ve büyük hacim, çoklu pazaryeri satıcısı |
| Teknik bilgi | Gerekmez | Yüksek (yazılımcı şart) | Gerekmez, entegratör halleder |
| Kurulum süresi | Anında (onay sonrası) | Haftalar (geliştirme) | Günler (hazır bağlantı) |
| Maliyet | Ücretsiz | Geliştirme ve bakım maliyeti | Aylık/paket abonelik |
| Otomasyon seviyesi | Düşük (elle güncelleme) | Tam kontrol, esnek | Yüksek, hazır kurallar |
| Çoklu pazaryeri | Yok, her kanal ayrı | Kendiniz kurarsınız | Genellikle dahil |
| Ölçeklenme | Zor, elle iş büyür | Çok yüksek | Yüksek |
Bu tabloya bakıp "bana en gelişmişi lazım" diye doğrudan API'ye atlamak sık yapılan bir hatadır. Eğer 30 ürününüz ve günde birkaç siparişiniz varsa panel fazlasıyla yeterlidir; API geliştirmeye harcanan bütçe bu aşamada boşa gider. Tersine, 2.000 ürünle ve günlük yüzlerce siparişle paneli manuel çevirmeye çalışmak da operasyonel bir kabusa dönüşür. Doğru karar, bugünkü ölçeğinizi değil, önümüzdeki 6-12 ayda ulaşmayı hedeflediğiniz ölçeği düşünerek verilir. Bu kararın işletmenize özel netleşmesi için e-ticaret danışmanlığı tarafında sık sık ürün sayısı, sipariş hacmi ve ekip yapısını birlikte masaya yatırıyoruz.
Üç Senaryo Üzerinden Karar Vermek
Soyut kalmamak için üç tipik satıcı profilini ele alalım. Birinci profil, elinde 40-50 ürün olan, kendi atölyesinde üretim yapan veya sınırlı bir ürün grubunu bayilikle satan küçük işletme. Bu profil için Satış Ortağım Paneli ve toplu Excel yükleme fazlasıyla yeterlidir. Günlük sipariş sayısı elle yönetilebilir düzeyde olduğu için ne API'ye ne de entegratör aboneliğine ihtiyaç vardır. Bu aşamada odak, katalog kalitesini yüksek tutmak ve satıcı puanını sağlam başlatmaktır.
İkinci profil, birkaç yüz ürünlü, hem Koçtaş'ta hem Trendyol'da hem de kendi web sitesinde satış yapan büyümekte olan işletme. Bu profil için doğru yol neredeyse her zaman bir entegratördür. Çünkü çoklu kanalda stoğu elle koordine etmek imkansıza yakındır; tek bir merkezi panelden tüm kanalları yönetmek hem zaman kazandırır hem de aşırı satış riskini ortadan kaldırır. Entegratör aboneliği, bu aşamada kazandırdığı zaman ve önlediği kayıp göz önüne alındığında kendini fazlasıyla amorti eder.
Üçüncü profil, binlerce ürünlü, kendi ERP sistemini kullanan, IT ekibi olan büyük işletme. Bu profil için doğrudan API entegrasyonu mantıklı olabilir, çünkü mevcut ERP'yi Koçtaş'la konuşturmak, hazır entegratörün sunduğundan daha esnek ve özelleştirilmiş bir kontrol sağlar. Ancak bu profil bile çoğu zaman hibrit çalışır: kritik ve özel akışları API ile yürütürken, standart işlemler için entegratör altyapısından yararlanabilir. Önemli olan dogmatik davranmamak; her işletmenin cevabı kendi gerçeğinde saklıdır.
Doğru entegrasyon yolu, en gelişmiş olan değil, işletmenizin bugünkü ve yakın gelecekteki ölçeğine en uygun olandır. Fazla mühendislik de, yetersiz otomasyon da maliyettir.
Satış Ortağım Paneli'ni Yakından Tanımak
Başvurunuz onaylandıktan sonra tüm operasyonel süreçlerinizi Koçtaş'ın Mirakl altyapısı üzerinde çalışan Satış Ortağım Paneli'nden yönetirsiniz. Bu panel, mağazanızın kontrol merkezidir. Ürün eklemek, mevcut ürünlere teklif oluşturmak, stok ve fiyat güncellemek, gelen siparişleri kabul etmek, kargo bilgisi girmek, iade ve iptalleri yönetmek, faturalarınızı ve hakediş raporlarınızı görmek buradan yapılır. Panel ayrıca komisyon oranlarını, performans metriklerini ve satıcı puanınızı gösterir.
Panelin manuel gücü toplu Excel yükleme özelliğinde saklıdır. Ürünlerinizi tek tek elle girmek yerine, Koçtaş'ın sağladığı şablona uygun bir Excel hazırlayıp toplu yükleyebilirsiniz. Bu, panel kullanan satıcıların en çok işine yarayan özelliktir; 50-100 ürünlük bir katalog bile makul sürede ayağa kalkar. Ancak Excel yönteminin de bir tavanı vardır. Her stok değişikliğinde, her fiyat güncellemesinde yeni bir dosya hazırlayıp yüklemek zorunda kalırsınız. Ürün sayısı ve güncelleme sıklığı arttıkça bu yöntem yorucu ve hata riskli hale gelir. Panelin sunduğu en değerli şey, entegrasyona geçmeden önce sistemi bizzat görmenizdir: Kategori ağacını, zorunlu öznitelik alanlarını, teklif yapısını ve sipariş ekranlarını kendi gözünüzle deneyimlemek, ilerideki entegrasyon kararlarınızı çok daha bilinçli almanızı sağlar.
Panelde Görebileceğiniz Temel Bölümler
- Katalog / Ürünler: Ürün ekleme, mevcut Koçtaş kataloğundaki ürünlere teklif bağlama, öznitelik doldurma.
- Teklifler (Offer): Fiyat, stok, hazırlama süresi, kargo sınıfı gibi satıcıya özel bilgilerin yönetildiği alan.
- Siparişler: Gelen siparişleri kabul etme, hazırlama, kargolama ve teslim durumunu takip etme.
- Mesajlar: Müşteri ve platform ile iletişim.
- Faturalar ve Hakediş: Komisyon kesintileri, ödeme dönemleri ve raporlar.
- Ayarlar: Mağaza bilgileri, kargo tercihleri ve entegrasyon için gereken API anahtarı.
Excel ile Toplu Yönetimin Sınırları
Excel yöntemi panel kullanan satıcının en güçlü aracı olsa da, sınırlarını bilmek gerekir. Excel dosyası, o an dosyaya yazdığınız değerlerin anlık bir fotoğrafıdır. Yüklediğiniz andan itibaren stok ve fiyatlar gerçek hayatta değişmeye devam eder, ama Koçtaş bunu bilmez; siz yeni bir dosya yükleyene kadar eski değerler yayında kalır. Bu durum, tek kanalda ve düşük hacimde sorun yaratmaz. Ancak aynı ürünü başka bir yerde de (kendi siteniz veya başka pazaryeri) satıyorsanız, iki güncelleme arasında geçen sürede stok kayması yaşama riskiniz her zaman vardır.
Excel yönteminin ikinci sınırı, hata payıdır. Elle hazırlanan bir dosyada yanlış sütuna yazılan bir değer, ondalık ayracı karışması, kopyala-yapıştır sırasında kayan bir satır gibi hatalar sık görülür ve bunlar toplu yüklendiğinde toplu hataya dönüşür. Bir fiyat sütununu yanlışlıkla kaydırıp yüzlerce ürünü yanlış fiyata düşürmek, panelde çalışan satıcıların yaşadığı klasik kazalardan biridir. Bu yüzden Excel yöntemini kullanırken küçük partiler halinde yüklemek ve her yüklemeden sonra birkaç ürünü panelde gözle kontrol etmek iyi bir alışkanlıktır.
Panelde belirli bir süre çalışmanın en büyük faydası, entegrasyona geçmeden önce sistemin mantığını içselleştirmenizdir. Kategori ağacının nasıl kurulduğunu, hangi kategorinin hangi öznitelikleri istediğini, teklif ekranının nasıl davrandığını ve sipariş akışının adımlarını bizzat gördüğünüzde, ilerideki API veya entegratör kararlarınızı çok daha bilinçli alırsınız. Panel, deyim yerindeyse Koçtaş operasyonunun okuludur; oradan mezun olmadan otomasyona geçmek, henüz tanımadığınız bir sistemi kör bir şekilde otomatikleştirmek anlamına gelir.
Mirakl Mantığının Kalbi: "Ürün" ile "Teklif" Ayrımı
Koçtaş entegrasyonunda en çok kafa karıştıran ve en çok hataya yol açan kavram budur, bu yüzden diğer her şeyden önce oturması gerekir. Mirakl altyapısında iki farklı katman vardır: Ürün (Product) ve Teklif (Offer). Bu ayrımı anlamayan satıcı, "ürünümü yükledim ama satışa çıkmadı" tuzağına düşer.
Ürün, katalog bilgisidir. Ürünün adı, markası, açıklaması, kategorisi, görselleri, teknik özellikleri ve barkodu gibi, o ürünü ürün yapan bilgileri içerir. Bu bilgiler herkese açık, ortak katalog verisidir. Teklif ise sizin o ürünü hangi fiyata, kaç adet stokla, ne kadar hazırlama süresiyle ve hangi kargo koşuluyla sattığınızı belirten, satıcıya özel envanter bilgisidir. Basitçe söylemek gerekirse: ürün "bu nedir" sorusunu, teklif "sen bunu nasıl satıyorsun" sorusunu yanıtlar.
Pratikte bu şu anlama gelir. Eğer sattığınız ürün zaten Koçtaş kataloğunda mevcutsa, sıfırdan ürün oluşturmanıza gerek yoktur; var olan ürüne bir teklif bağlarsınız. Bu en hızlı satışa çıkma yoludur, çünkü ürün bilgisi ve görselleri hazırdır, siz sadece fiyat ve stok girersiniz. Eğer ürününüz katalogda yoksa, önce ürün oluşturur (tüm zorunlu öznitelikleri doldurarak), onay sürecini geçer, ardından o yeni ürüne teklifinizi bağlarsınız. Ürün onay sürecinden geçmeden teklif yayına giremez; işte "yükledim ama görünmüyor" şikayetlerinin büyük kısmı bu onay aşamasında beklemekten kaynaklanır.
| Boyut | Ürün (Product) | Teklif (Offer) |
|---|---|---|
| Ne anlatır | Ürünün kendisi, kimliği | Sizin satış koşulunuz |
| Örnek alanlar | Ad, marka, açıklama, kategori, görsel, öznitelik, barkod | Fiyat, stok, hazırlama süresi, kargo sınıfı, durum (yeni) |
| Kim sahibi | Ortak katalog (platform onaylı) | Satıcıya özel |
| Onay gerekir mi | Evet, yeni üründe onay şart | Genelde anında, ürün onaylıysa yayında |
| Ne sıklıkla değişir | Nadiren (içerik güncellemesi) | Sık (fiyat, stok her gün) |
| Kritik hata riski | Kategori/öznitelik eksikliği | Stok kayması, yanlış fiyat |
Bu ayrımı entegrasyon açısından şöyle özetleyebiliriz: ürün verisini bir kere doğru kurarsınız ve nadiren dokunursunuz; teklif verisini ise gün içinde defalarca senkronlarsınız. İyi bir entegrasyon mimarisi bu iki katmanı ayrı ele alır. Ürün aktarımı ağır, dikkatli ve onaya tabi bir süreçtir; teklif senkronizasyonu ise hızlı, sık ve otomatik olmalıdır. Panelde de, API'de de, entegratörde de aynı mantık geçerlidir.
Var Olan Ürüne Bağlanmak mı, Yeni Ürün Açmak mı?
Ürün-teklif ayrımının pratik sonucu, satışa çıkma hızınızı belirleyen kritik bir karar doğurur: sattığınız ürün Koçtaş kataloğunda zaten var mı? Eğer varsa, işiniz kolaydır. Var olan ürüne barkod veya ürün kimliği üzerinden bir teklif bağlarsınız, fiyat ve stok girersiniz, dakikalar içinde satışa çıkarsınız. Bu senaryoda katalog içeriği (görsel, açıklama, öznitelik) hazır olduğu için onay beklemezsiniz. Standart, markalı, yaygın ürünler satıyorsanız çoğu ürününüz bu yolla hızlıca yayına girer.
Eğer ürününüz katalogda yoksa, örneğin kendi ürettiğiniz özel bir ürün veya Koçtaş'ta ilk kez listelenen bir kalem ise, önce ürünü sıfırdan oluşturmanız gerekir. Bu, tüm zorunlu öznitelikleri doldurmak, kaliteli görseller yüklemek, doğru kategoriye yerleştirmek ve platform onayını beklemek demektir. Bu süreç daha uzundur ve dikkatli veri girişi ister. İşte bu yüzden entegrasyon planlaması yaparken kataloğunuzu ikiye ayırmak faydalıdır: hızlı yayına girecek "mevcut ürünler" ve daha özenli hazırlık gerektiren "yeni ürünler". Bu ayrım, hem beklentinizi doğru yönetir hem de kaynaklarınızı doğru yere ayırmanızı sağlar.
Varyantlı Ürünlerde Teklif Mantığı
Yapı market kategorisinde varyantlar (renk, ebat, güç, montaj tipi) çok yaygındır ve entegrasyonda özel dikkat ister. Genel kural şudur: her satılabilir varyant, kendi benzersiz kimliğiyle (barkod veya stok kodu) ayrı bir teklif olarak yönetilir. Yani bir boyanın beyaz, gri ve antrasit tonları üç ayrı teklif; bir matkabın 12 voltluk ve 18 voltluk modelleri iki ayrı teklif olarak sisteme girer. Stok ve fiyat her varyant için bağımsız takip edilir. Varyantları tek bir "ürün" gibi düşünüp stoğu ortak yönetmek, en sık yaşanan stok kaymalarından birine yol açar. Doğru kurgu, her varyantın kendi stoğunu kendi kaynağından beslemesidir.
Doğrudan API Entegrasyonu: Kimin İçin, Nasıl Kurulur?
Doğrudan API entegrasyonu, kendi yazılımını (ERP, muhasebe, stok yönetimi veya özel geliştirilmiş bir sistem) Koçtaş'ın Mirakl altyapısıyla aracısız konuşturmak isteyen işletmeler içindir. Mirakl Satıcı API'leri, faaliyetinizin dört ana bölümünü otomatikleştirmenize izin verir: mağaza bilgileri, katalog (ürünler ve teklifler), sipariş yönetimi ve kargo bilgileri, hesap bilgileri. Yani teoride operasyonun tamamını koda dökebilirsiniz.
API entegrasyonunun ilk adımı, Satış Ortağım Paneli'nden API anahtarınızı almaktır. Koçtaş'ın Mirakl adresine giriş yaptıktan sonra sağ üst köşedeki profil menüsünden kişisel ayarlara gider, API anahtarı sekmesinden yeni bir anahtar oluşturur ve bu anahtarı sisteminize tanımlarsınız. Bu anahtar, sisteminizin Koçtaş adına işlem yapabilmesini sağlayan kimlik bilgisidir; bu yüzden bir şifre gibi korunmalı, asla kod içine gömülü veya paylaşılan bir yerde tutulmamalıdır.
Mirakl API'lerinin güzelliği, esneklik seviyesini kendinizin belirlemesidir. Operasyonun tamamını otomatikleştirmek zorunda değilsiniz. Örneğin teklifleri ve siparişleri API ile otomatik yönetip, ürünleri hâlâ Excel dosyasıyla manuel yükleyebilirsiniz. Bu kademeli yaklaşım, teknik ekibin yükünü hafifletir ve en kritik akışları (stok, sipariş) önce otomatikleştirmenizi sağlar. Mirakl'ın sipariş tarafındaki temel akışı şu şekilde işler: siparişleri listelersiniz, gelen siparişi kabul veya reddedersiniz, kargo takip bilgisini girersiniz ve son olarak sevkiyatı onaylarsınız. İade ve iptaller de aynı yapı içinde ayrı işlemler olarak yürür. Bu akış, panelde de API'de de aynı mantıkla çalışır; API sadece bu adımları insan eli değmeden yürütür.
API Yolunu Seçmeden Önce Sorulacak Sorular
- Bu entegrasyonu geliştirecek ve bakımını sürdürecek bir teknik ekibim var mı?
- Mevcut ERP veya stok sistemim Koçtaş'ın veri modeline uygun veri üretebiliyor mu?
- Hata durumunda (başarısız istek, zaman aşımı, veri reddi) uyarı ve tekrar deneme mekanizması kuracak mıyım?
- Sadece Koçtaş mı, yoksa birden fazla pazaryeri mi bağlayacağım? Çoklu kanalda entegratör daha mantıklı olabilir.
- API bakım maliyeti, entegratör abonelik maliyetinden gerçekten düşük mü?
Bu sorulara net "evet" diyemiyorsanız, doğrudan API yerine entegratör yolunun daha az riskli olduğunu söylemek gerekir. Kendi API entegrasyonu güçlüdür ama sahiplenilmesi gereken bir yazılım varlığıdır; bakımsız kalırsa stok kaymasından satış kaybına kadar giden sorunlar doğurur.
API'nin Dört Ana Çalışma Alanı
Mirakl Satıcı API'lerini kavramsal olarak dört başlık altında toplamak, ne kadar iş yükünü otomatikleştireceğinizi planlamanızı kolaylaştırır. İlki mağaza bilgileridir; mağazanızın ayarları, kargo koşulları ve genel yapılandırması buradan yönetilir. İkincisi katalogdur; ürün oluşturma, güncelleme ve teklif yönetimi bu alanda döner. Üçüncüsü sipariş ve kargo yönetimidir; siparişleri çekmek, kabul veya reddetmek, takip bilgisi girmek ve sevkiyatı onaylamak bu grupta yer alır. Dördüncüsü hesap bilgileridir; hakediş, komisyon ve raporlama verileri buradan alınır.
Bu dört alanı aynı anda otomatikleştirmek zorunda değilsiniz. Pratikte en akılcı yaklaşım, en çok tekrar eden ve en kritik akışları önce otomatikleştirmektir. Çoğu satıcı için bu, önce stok ve sipariş, sonra fiyat, en son ürün oluşturma sırasıdır. Çünkü stok ve sipariş gün içinde en çok değişen, en çok risk taşıyan alanlardır; ürün oluşturma ise nadiren yapılan, dikkatli ama az sıklıklı bir iştir. Bu kademeli yaklaşım, geliştirme yükünü dağıtır ve en yüksek değeri en erken elde etmenizi sağlar.
API Kurulumunda Gözden Kaçan İnce Noktalar
Doğrudan API entegrasyonuna girişen ekiplerin sıkça atladığı birkaç konu vardır. Birincisi, hata yönetimi ve tekrar deneme mantığıdır. Bir istek başarısız olduğunda (ağ hatası, zaman aşımı, geçici sunucu hatası) sisteminiz bunu fark edip belirli aralıklarla yeniden denemeli, sürekli başarısız oluyorsa uyarı üretmelidir. İkincisi, veri doğrulamadır; Koçtaş'a göndermeden önce verinizin platformun beklediği formata uyduğunu kontrol etmek, toplu reddi önler. Üçüncüsü, API anahtarının güvenli saklanması ve düzenli izlenmesidir; anahtar geçersiz kaldığında sistem sessizce güncellemeyi durdurabilir, bu yüzden bağlantı sağlığını sürekli kontrol eden bir mekanizma şarttır.
Dördüncü ve belki en önemli nokta, senkronizasyon zamanlamasıdır. Verileri çok sık göndermek gereksiz yük yaratırken, çok seyrek göndermek stok kaymasına yol açar. Doğru kurgu, stok ve fiyat gibi kritik alanlar için sık, ürün içeriği gibi statik alanlar için seyrek senkron yapan katmanlı bir yapıdır. Bu ince ayarlar, API entegrasyonunu "çalışan" ile "sağlıklı çalışan" arasındaki farkı belirler ve genellikle deneyim gerektirir. Bu deneyim eksikliği, birçok işletmenin kendi API'sini kurup sonra bakımda zorlanmasının başlıca sebebidir.
Entegratör İş Ortakları: Ne İşe Yarar, Nasıl Seçilir?
Entegratör, sizinle Koçtaş arasında duran hazır bir yazılım köprüsüdür. Koçtaş, çok sayıda entegratörle resmi iş ortaklığı yürütür; sektörde sık karşılaşılan isimler arasında BirFatura, Entegra, Ticimax, Sentos, Dopigo, Prapazar, Yengeç, BizimHesap, Platin360 ve benzeri çözümler bulunur. Bu firmalar Koçtaş'ın API'sini sizin adınıza kullanır; siz sadece onların panelinden ürün, stok, fiyat ve sipariş yönetimi yaparsınız. Koçtaş'ın kendisi de API dokümanlarını paylaşarak isteyen satıcının kendi entegrasyonunu kurmasına da olanak tanır, ama çoğu satıcı için pratik yol entegratördür.
Entegratörün en büyük değeri, tek panelden çoklu kanal yönetimidir. Aynı ekrandan Koçtaş'ı, Trendyol'u, Hepsiburada'yı ve kendi web sitenizi yönetebilir; stoğu tek havuzdan besleyebilirsiniz. Böylece bir kanalda satış olunca stok diğer tüm kanallarda otomatik düşer. Ayrıca çoğu entegratör fatura entegrasyonu, muhasebe bağlantısı, kargo etiketi ve raporlama gibi ek modüller sunar. Ancak "entegratör seçtim, iş bitti" demek yanlış olur; entegratörler arasında yetenek, güvenilirlik ve destek kalitesi bakımından ciddi farklar vardır. Yanlış entegratör seçimi, stok senkron gecikmesi ve satış kaybı olarak size geri döner.
| Seçim Kriteri | Neden Önemli | Nasıl Kontrol Edilir |
|---|---|---|
| Koçtaş resmi iş ortaklığı | Resmi ortak, API değişikliklerine hızlı uyum sağlar | Koçtaş entegrasyon listesinde adı geçiyor mu |
| Stok senkron sıklığı | Gecikme, aşırı satış ve iptal demektir | Kaç dakikada bir stok güncelliyor |
| Çoklu pazaryeri desteği | Tek panelden tüm kanalları yönetmek | Hangi pazaryerlerini destekliyor |
| Kendi site (ikas/Shopify) bağlantısı | Web siteniz de aynı stok havuzunda olmalı | E-ticaret altyapınızı destekliyor mu |
| Fatura ve muhasebe modülü | Sipariş sonrası otomatik fatura kesme | e-Fatura/e-Arşiv entegrasyonu var mı |
| Öznitelik eşleme yeteneği | Kategori onayını hızlandırır | Toplu öznitelik doldurma sunuyor mu |
| Destek ve SLA | Sorun anında hızlı çözüm | Destek kanalı, yanıt süresi, referanslar |
Entegratör seçerken en sık yapılan hata, sadece aylık ücrete bakmaktır. Oysa asıl maliyet, kötü senkronizasyon yüzünden kaybedilen satışlar ve iptal ceza puanlarıdır. Ucuz ama yavaş senkronlayan bir entegratör, birkaç aşırı satış iptaliyle size aylık ücretinin kat kat fazlasını kaybettirebilir. Doğru entegratörü seçmek, işletmenizin ürün yapısına ve kanal sayısına bağlı bir karardır; bu kararı verirken bağımsız bir gözle değerlendirme almak, sonradan kanal değiştirmenin maliyetinden çok daha ucuza gelir.
Entegratör Değiştirmenin Görünmez Maliyeti
Yanlış entegratör seçiminin en sinsi tarafı, ondan kurtulmanın da maliyetli olmasıdır. Bir entegratöre geçtiğinizde ürün eşlemeleriniz, kategori haritalarınız, sipariş akışlarınız ve fatura kurgunuz o sistemin içine gömülür. Başka bir entegratöre geçmek, bu kurulumun büyük kısmını yeniden yapmak anlamına gelir. Bu yüzden ilk seçimi doğru yapmak, "nasılsa değiştiririm" rahatlığından çok daha önemlidir. Değerlendirme aşamasında mutlaka bir deneme süreci isteyin, birkaç gerçek ürünle test edin ve senkron hızını kendi gözünüzle ölçün. Referans satıcılarla konuşmak, pazarlama sayfalarındaki vaatlerden çok daha gerçekçi bir tablo verir.
Entegratörde Dikkat Edilmesi Gereken Kırmızı Bayraklar
- Stok senkron sıklığını net söylemeyen: "Anlık" diyor ama arka planda saatte bir güncelliyorsa, çoklu kanalda risklisiniz.
- Kendi e-ticaret altyapınızı desteklemeyen: Web sitenizi stok havuzu yapamıyorsanız kurgu eksik kalır.
- Destek kanalı zayıf olan: Sorun anında ulaşamadığınız bir entegratör, satış kaybı demektir.
- Öznitelik eşlemeyi elle bırakan: Toplu öznitelik yönetimi sunmuyorsa büyük katalogda boğulursunuz.
- Fatura ve muhasebe modülü olmayan: Sipariş sonrası faturayı elle kesmek zorunda kalırsınız.
Bu kırmızı bayrakları erkenden görmek, aylar sonra yaşanacak baş ağrılarından kurtarır. Entegratör seçimi, tıpkı bir iş ortağı seçmek gibidir; ucuz ama zayıf bir ortakla yürümek, biraz daha pahalı ama güvenilir bir ortakla yürümekten çoğu zaman daha pahalıya patlar. Bu değerlendirmeyi tek başınıza yapmak zorunda değilsiniz; pazaryeri operasyonunu bilen bir uzmanla birlikte kısa listenizi oluşturmak, deneme yanılmanın maliyetini ciddi biçimde düşürür.
Ürün Listeleme Akışı: Adım Adım
Koçtaş'ta bir ürünü sıfırdan satışa çıkarmak, yöntemden (panel, API, entegratör) bağımsız olarak aynı mantıksal adımları izler. Aradaki fark, bu adımları elle mi yoksa otomatik mi yaptığınızdır. Aşağıdaki akış, bir ürünün mağazanıza girmesinden yayına çıkmasına kadar geçen yolu gösterir.
| Adım | Ne Yapılır | Kritik Nokta |
|---|---|---|
| 1. Katalog kontrolü | Ürün Koçtaş kataloğunda var mı diye bakılır | Varsa sadece teklif bağlanır, çok hızlıdır |
| 2. Kategori seçimi | Ürün doğru kategori ağacına yerleştirilir | Yanlış kategori komisyonu ve öznitelikleri değiştirir |
| 3. Öznitelik doldurma | Zorunlu ve opsiyonel özellikler girilir | Zorunlu alan eksikse ürün onaydan geçmez |
| 4. Görsel ve içerik | Görseller, açıklama, teknik özellikler eklenir | Kalitesiz görsel dönüşümü düşürür |
| 5. Ürün onayı | Platform ürün verisini denetler | Onay beklerken teklif yayına çıkmaz |
| 6. Teklif oluşturma | Fiyat, stok, hazırlama süresi, kargo girilir | Stok ve fiyat doğruluğu satışın temelidir |
| 7. Yayına alma | Ürün ve teklif eşleşince ürün satışa çıkar | İlk 48 saat performansı algoritmayı etkiler |
Bu akıştaki en kritik dönüm noktası üçüncü ve beşinci adımlardır: öznitelik doldurma ve ürün onayı. Katalogda zaten var olan ürünlere teklif bağladığınızda bu adımları büyük ölçüde atlarsınız ve dakikalar içinde satışa çıkarsınız. Ancak katalogda olmayan, kendi özel ürününüzü eklerken zorunlu özniteliklerdeki en ufak eksiklik bile ürünü onay kuyruğunda bekletir. İşte entegratörlerin ve iyi kurgulanmış API akışlarının fark yarattığı yer burasıdır: toplu öznitelik doldurma ve şablon yönetimi ile onay sürecini önemli ölçüde hızlandırırlar. Ürün görselleri özellikle yapı market ve dekorasyon kategorisinde dönüşümü doğrudan etkiler; bu konuda e-ticaret ürün görseli optimizasyonu yazımızdaki ilkeleri Koçtaş listelemelerinize uygulamanızı öneririz.
İlk 48 Saatin Önemi
Bir ürün yayına girdiğinde, ilk performansı platform algoritması tarafından yakından izlenir. İlk günlerde aldığı görüntülenme, tıklanma ve satış oranı, ürünün ilerideki görünürlüğünü etkiler. Bu yüzden bir ürünü yayına almadan önce fiyatının rekabetçi, görselinin kaliteli ve stoğunun yeterli olduğundan emin olmak, yayına girdikten sonra düzeltmeye çalışmaktan çok daha etkilidir. Yarım yamalak hazırlanmış, sonra düzeltilecek bir ürün, ilk izlenimini kötü bırakır ve bu ilk izlenimi geri kazanmak zordur. Entegrasyon planlamasında ürünleri "hazır olunca yayınla" disiplini, "önce yayınla sonra düzelt" alışkanlığından her zaman daha kârlıdır.
Toplu Listeleme ile Tekil Listeleme Arasındaki Denge
Katalog büyüklüğü arttıkça toplu listeleme kaçınılmaz hale gelir; yüzlerce ürünü tek tek elle girmek ne mümkün ne de mantıklıdır. Ancak toplu listelemenin de bir riski vardır: bir şablon hatası, tüm partiyi birden hatalı hale getirir. Bu yüzden büyük katalogları partiler halinde, her partiden sonra sonucu kontrol ederek yüklemek en sağlıklı yöntemdir. Özellikle ilk kez toplu yükleme yaparken, önce küçük bir test partisiyle sürecin doğru işlediğini teyit etmek, binlerce ürünü birden hatalı yükleyip sonra düzeltmeye çalışmaktan çok daha akıllıcadır. Deneyimli bir entegrasyon ekibi, bu partili yaklaşımı standart olarak uygular.
Kategori ve Öznitelik Eşlemenin Derinliği
Kategori ve öznitelik eşleme, Koçtaş entegrasyonunun en teknik ve en çok göz ardı edilen kısmıdır. Mirakl altyapısında her kategori kendi zorunlu ve opsiyonel öznitelik setini taşır. Bir "elektrikli el aleti" kategorisi voltaj, güç, batarya tipi gibi öznitelikler isterken, bir "banyo bataryası" kategorisi montaj tipi, malzeme, renk gibi tamamen farklı alanlar ister. Ürününüzü yanlış kategoriye koyarsanız, sadece yanlış komisyon oranıyla değil, tamamen alakasız zorunlu alanlarla karşılaşırsınız ve ürün onaydan geçemez.
Öznitelik eşleme iki yönlü bir iştir. Bir yandan kendi ürün verinizdeki alanları (örneğin sizin sisteminizde "renk" olarak tuttuğunuz alan) Koçtaş'ın beklediği öznitelik alanına haritalarsınız. Diğer yandan da değerleri eşlersiniz: sizin sisteminizde "antrasit" yazan renk, Koçtaş'ın kabul ettiği değer listesinde "antrasit gri" olarak geçiyorsa, bu değeri doğru karşılığa çevirmeniz gerekir. Modern entegratörler ve Mirakl'ın kendi altyapısı, bu eşlemeyi hızlandırmak için otomatik öneri sistemleri kullanır; ürün açıklamalarından ve kategori benzerliklerinden yola çıkarak muhtemel eşlemeleri önerir. Ancak bu öneriler her zaman doğru değildir; özellikle ilk kurulumda öznitelik eşlemelerini elle gözden geçirmek, sonradan yaşanacak toplu onay retlerini önler.
Öznitelik Eşlemede Sık Yapılan Hatalar
- Zorunlu alanı boş bırakmak: En sık onay reddi sebebi. Zorunlu öznitelik eksikse ürün asla yayına girmez.
- Serbest metin yerine liste değeri gerektiren alana yanlış değer yazmak: "Kırmızı" yerine "kırmzı" gibi bir yazım hatası bile eşlemeyi bozar.
- Ölçü birimi karışıklığı: Santimetre ile milimetreyi, gram ile kilogramı karıştırmak ürün bilgisini bozar.
- Yanlış kategori seçimi: Ürünü daha "görünür" sandığı bir kategoriye zorlamak, hem komisyonu hem öznitelik setini yanlışlar.
- Marka onayı atlamak: Bazı markalar platform tarafında ayrı onay gerektirir; onaysız markayla ürün açılamaz.
Öznitelik eşleme sıkıcı görünse de, katalog kalitenizin temelidir. İyi eşlenmiş bir katalog, ürünlerinizin doğru filtrelerde görünmesini, arama sonuçlarında çıkmasını ve müşteride güven oluşturmasını sağlar. Kötü eşlenmiş bir katalog ise ürünleri görünmez kılar ve onay kuyruğunda tıkar. Bu yüzden entegrasyonun bu kısmına harcanan özen, doğrudan satışa yansır.
Öznitelikler Sadece Onay İçin Değil, Görünürlük İçin de Önemli
Birçok satıcı öznitelikleri yalnızca "onaydan geçmek için doldurulması gereken zorunlu alanlar" olarak görür. Oysa öznitelikler, ürününüzün müşteri tarafından bulunabilirliğini doğrudan belirler. Bir müşteri Koçtaş'ta arama yaparken veya filtre kullanırken, tam olarak bu öznitelikler üzerinden sonuçları daraltır. Örneğin "18 volt" ve "şarjlı" filtrelerini işaretleyen bir müşteri, sadece bu özniteliklere doğru değer girilmiş ürünleri görür. Öznitelikleri eksik veya yanlış girdiğiniz ürün, o filtreye takılmaz ve satın alma niyeti yüksek bir müşteriye hiç görünmez. Yani öznitelik doldurmak, sadece bir bürokratik adım değil, doğrudan bir görünürlük ve dönüşüm yatırımıdır.
Bu perspektif, öznitelik eşlemeyi baştan savma yapmanın gizli maliyetini gösterir. Zorunlu alanları geçiştirip opsiyonel alanları boş bırakan bir satıcı, ürününü onaydan geçirmiş ama görünürlükten mahrum bırakmış olur. Deneyimli entegrasyon yaklaşımı, sadece zorunlu değil, satışa katkı sağlayan tüm öznitelikleri mümkün olduğunca eksiksiz doldurmayı hedefler. Bu, özellikle rekabetin yüksek olduğu kategorilerde küçük ama belirleyici bir fark yaratır.
Marka Onayı ve Kategori Kısıtları
Öznitelik eşlemenin yanında sık atlanan bir konu marka onayıdır. Bazı markalar platform tarafında ayrı bir onay veya yetkilendirme gerektirebilir; yetkiniz olmayan bir markayla ürün açmaya çalışmak reddedilir. Benzer şekilde bazı kategoriler ek belge veya sertifika ister. Bu kısıtları entegrasyona başlamadan önce netleştirmek, sonradan yaşanacak toplu retleri önler. Satacağınız markaların ve kategorilerin gereksinimlerini baştan çıkarmak, planlamanın önemli bir parçasıdır ve genellikle deneyimli bir gözle daha hızlı tespit edilir.
Stok ve Fiyat Senkronizasyonu: Hangi Alanlar, Ne Sıklıkla?
Entegrasyonun günlük hayatta en çok çalışan ve en çok risk taşıyan kısmı stok ve fiyat senkronizasyonudur. Ürün verisini bir kere kurarsınız ama stok ve fiyat her gün, hatta bazen dakika dakika değişir. Bu senkronizasyonun sağlığı, işletmenizin hem satışını hem de itibarını doğrudan belirler. Geç güncellenen stok, elinizde olmayan ürünü satmanıza (aşırı satış) ve ardından iptal etmek zorunda kalmanıza yol açar; iptaller ise satıcı puanınızı düşürür ve görünürlüğünüzü azaltır.
Senkronizasyonun kalbinde teklif katmanı vardır. Teklif güncellerken tipik olarak şu alanlar döner: fiyat, stok adedi, hazırlama/sevk süresi, kargo veya lojistik sınıfı, ürün durumu (yeni/yenilenmiş) ve varsa indirimli fiyat. Bu alanların her birinin doğru ve güncel olması gerekir. Aşağıdaki tablo, tipik senkronizasyon alanlarını, kaynağını ve kritiklik seviyesini gösterir.
| Alan | Kaynak | Önerilen Sıklık | Kritiklik |
|---|---|---|---|
| Stok adedi | ERP / stok sistemi / kendi site | Mümkün olan en sık (dakikalar) | Çok yüksek |
| Satış fiyatı | Fiyatlandırma sistemi | Günlük veya değişimde anlık | Çok yüksek |
| İndirimli fiyat | Kampanya yönetimi | Kampanya başında/sonunda | Yüksek |
| Hazırlama süresi | Operasyon planı | Değiştikçe | Orta |
| Kargo/lojistik sınıfı | Ürün ağırlık/desi bilgisi | Ürün kurulumunda, nadiren | Orta |
| Ürün durumu | Katalog | Nadiren | Düşük |
Bu tablodaki en kritik iki satır stok ve fiyattır ve ikisinin de "gerçeğin tek kaynağı" (single source of truth) bir yerden beslenmesi gerekir. Eğer stoğunuzu hem kendi web sitenizde, hem Koçtaş panelinde, hem başka bir pazaryerinde ayrı ayrı elle güncelliyorsanız, er ya da geç bir yerde kayma olur. Doğru kurgu, tüm kanalların tek bir merkezi stok havuzundan beslenmesidir. Bir satış nerede olursa olsun, o havuzdan düşülür ve tüm kanallar aynı gerçek stoğu görür. Entegratörlerin ve iyi kurulmuş API mimarilerinin asıl değeri tam olarak budur.
Stok Kayması Nasıl Oluşur ve Neden Bu Kadar Pahalıdır?
Stok kayması, entegrasyonun en pahalı sessiz hatasıdır. Şöyle gelişir: elinizde bir adet ürün kaldı, aynı anda hem Koçtaş'ta hem kendi sitenizde satışta. Bir müşteri Koçtaş'tan, başka bir müşteri sitenizden neredeyse aynı anda sipariş verdi. Eğer stok anlık senkronlanmıyorsa, iki kanal da o son ürünü sattı sanır. Sonuçta bir siparişi iptal etmek zorunda kalırsınız. Bu iptal, sadece o satışı kaybetmek değildir; müşteri memnuniyetsizliği, satıcı puanı düşüşü ve platform gözünde güvenilirlik kaybı demektir. Puan düştükçe görünürlüğünüz azalır, görünürlük azaldıkça satışınız düşer. Yani tek bir stok kayması, zincirleme bir kayıp başlatabilir.
Bu riski ortadan kaldırmanın tek gerçek yolu, senkron sıklığını mümkün olan en yüksek seviyeye çıkarmak ve güvenli stok tamponu kullanmaktır. Manuel yöntemde bu neredeyse imkansızdır, çünkü elle güncelleme her zaman gecikmelidir. Otomatik entegrasyonda ise sistem, bir satış olduğu anda stoğu tüm kanallardan düşer. Çoklu kanalda satış yapan hiçbir işletmenin bu otomasyondan kaçınma lüksü yoktur; kaçındığı takdirde bedelini iptallerle ve puan düşüşüyle öder.
Push mu, Pull mu? Senkron Yönü Neden Önemli?
Senkronizasyonun teknik tarafında iki temel yaklaşım vardır. Birincisinde sisteminiz değişiklikleri Koçtaş'a "iter" (push); yani bir stok değiştiğinde hemen bildirir. İkincisinde sistem belirli aralıklarla Koçtaş'tan bilgi "çeker" (pull) veya tersine, güncel verileri toplu gönderir. İyi bir entegrasyon, kritik değişiklikleri anında iterken, doğrulama amaçlı düzenli çekme de yapar; böylece iki taraf arasındaki tutarsızlıklar erken yakalanır. Bu detay teknik görünse de sonucu doğrudan hissedersiniz: iyi kurgulanmış bir senkron, siz fark etmeden çalışır ve sizi telaştan kurtarır; kötü kurgulanmış bir senkron ise sürekli elle müdahale gerektirir ve güven vermez.
Güvenli Stok, Fiyat Yuvarlama ve Kanal Bazlı Fiyatlandırma
Basit bir stok senkronizasyonundan daha olgun bir kurguya geçtiğinizde, birkaç ileri seviye kural devreye girer. Bunları bilmek, aşırı satış ve fiyat kazalarını önlemenin anahtarıdır.
Güvenli stok (buffer): Elinizdeki gerçek stoğun tamamını pazaryerine açmak risklidir. Diyelim elinizde 10 adet var; bunun 8'ini Koçtaş'a açar, 2'sini tampon olarak tutarsınız. Böylece birden fazla kanaldan aynı anda gelen siparişlerde stok eksiye düşmez ve aşırı satış yaşanmaz. Güvenli stok kuralı, çoklu kanal satışının olmazsa olmazıdır.
Fiyat yuvarlama kuralları: Farklı kanallarda fiyatlarınızın belirli bir mantıkla bitmesini isteyebilirsiniz (örneğin her zaman ,90 veya ,99 ile). Otomatik senkronizasyonda fiyat yuvarlama kuralı tanımlayarak, kanaldan kanala aktarılan fiyatların tutarlı görünmesini sağlarsınız.
Kanal bazlı fiyatlandırma: Her pazaryerinin komisyon oranı ve kargo yapısı farklı olduğu için, aynı ürünü her kanalda birebir aynı fiyata satmak kârlılık açısından mantıklı olmayabilir. Koçtaş'taki komisyon ve kargo maliyetiniz, Trendyol'dakinden farklı olabilir. Kanal bazlı fiyatlandırma, her kanal için ayrı bir fiyat mantığı kurmanızı sağlar; böylece hiçbir kanalda zarar etmezsiniz. Bu noktada kârlılık hesabı kritik hale gelir: komisyon, kargo, entegrasyon maliyeti ve ürün maliyetini bir arada görmeden konulan fiyat, ciro getirir ama kâr getirmeyebilir.
Bu üç kuralı birlikte düşünmek gerekir, çünkü aralarında etkileşim vardır. Örneğin agresif bir güvenli stok tamponu, satış kaybı riskini artırırken aşırı satış riskini azaltır; doğru denge, ürünün satış hızına ve stok yenileme sürenize bağlıdır. Hızlı satan ve hızlı tedarik edebildiğiniz bir üründe tampon dar tutulabilir; yavaş tedarik edilen kritik bir üründe tampon geniş olmalıdır. Benzer şekilde kanal bazlı fiyatlandırma ile fiyat yuvarlama kuralları birlikte çalışır; her kanal için hesaplanan net fiyat, tutarlı bir görünüm için yuvarlama kuralından geçer. Bu ince ayarların hepsi, olgun bir entegrasyonun işaretidir ve genellikle deneyimle oturur.
Siparişten Teslimata: Sipariş ve Kargo Akışı
Ürünleriniz yayına girdikten sonra iş, sipariş yönetimine döner. Koçtaş'ta sipariş akışı, Mirakl'ın standart sipariş yaşam döngüsünü izler ve bu döngüyü doğru yönetmek satıcı puanınızın belkemiğidir. Akış, siparişin size düşmesiyle başlar ve teslimatla kapanır; her aşamada belirli bir aksiyon beklenir.
| Aşama | Satıcının Görevi | Gecikmenin Bedeli |
|---|---|---|
| 1. Sipariş düşer | Siparişi görür ve stoğu teyit eder | Bildirimi kaçırmak süre kaybı |
| 2. Kabul / Ret | Siparişi kabul veya (stok yoksa) reddeder | Zamanında kabul edilmezse otomatik iptal riski |
| 3. Hazırlama | Ürünü paketler, faturayı hazırlar | Hazırlama süresi aşımı puan düşürür |
| 4. Kargolama | Kargoya verir, takip numarasını sisteme girer | Takip numarası girilmezse müşteri mağdur olur |
| 5. Sevk onayı | Sevkiyatı sistemde onaylar | Onaysız sipariş kapanmaz |
| 6. Teslim | Kargo teslim eder, süreç kapanır | Teslim sorunları iade/itiraz doğurur |
Bu akıştaki en kritik iki aşama, siparişin zamanında kabul edilmesi ve kargo takip numarasının sisteme zamanında girilmesidir. Mirakl API'sinde bu adımlar ayrı işlemlerle yürür: siparişi kabul veya reddetme, kargo takip bilgisini güncelleme ve sevkiyatı doğrulama. Panelde bu adımları elle yaparsınız; API veya entegratörde ise sisteminiz kargo firmasından gelen takip numarasını otomatik olarak Koçtaş'a yazar. İşte otomasyonun en somut faydası burada görülür: yüzlerce siparişin takip numarasını elle girmek hem yavaş hem hataya açıktır, oysa otomatik akışta bu adım saniyeler içinde ve hatasız tamamlanır.
Sipariş Bildirimlerini Kaçırmamak
Sipariş akışının en başındaki görünmez risk, bildirimi kaçırmaktır. Bir sipariş düştüğünde bunu zamanında görmezseniz, kabul süresi işlemeye başlar ve fark etmeden geç kalabilirsiniz. Panelde çalışan satıcılar, panele düzenli girmeyi veya bildirimleri açık tutmayı ihmal ettiklerinde bu tuzağa düşer. Otomatik entegrasyonda ise siparişler sisteminize anında akar; kabul, hazırlama ve kargolama süreci gecikmesiz başlar. Özellikle yoğun kampanya dönemlerinde, günde onlarca siparişin her birini elle takip etmek imkansıza yaklaşır. Bu dönemlerde otomasyonun değeri en somut haliyle hissedilir; sistem, siz uyurken bile siparişleri sıraya alır ve akışı canlı tutar.
Bazı entegratörler ve iyi kurulmuş API akışları, uygun siparişleri belirli kurallara göre otomatik kabul edebilir. Örneğin stoğu yeterli olan ve fiyatı doğru olan bir sipariş, insan onayı beklemeden kabul edilip hazırlama aşamasına geçebilir. Bu, kabul süresini sıfıra yaklaştırır ve satıcı puanınızı korur. Ancak otomatik kabulü kurarken stok kontrolünün sağlam olması şarttır; aksi halde elinizde olmayan bir ürünü otomatik kabul edip sonra iptal etmek zorunda kalabilirsiniz. Bu da, otomasyonun ancak sağlam bir stok senkronizasyonu üzerine kurulduğunda güvenli olduğunu bir kez daha gösterir.
Koçtaş, ürün ağırlığına bağlı olarak çeşitli anlaşmalı kargo firmalarıyla (MNG, Sendeo, Yurtiçi ve benzeri) çalışma imkanı sunar. Yapı market ürünlerinin önemli bir kısmı hacimli ve ağır olduğu için, doğru kargo sınıfını ve desi bilgisini ürün kurulumunda doğru girmek kârlılık açısından hayatidir. Yanlış desi bilgisi, kargo maliyetinizi olduğundan düşük göstererek her satışta gizli bir zarar yaratabilir.
Desi ve Kargo Sınıfı: Yapı Markette Kârın Belirleyicisi
Kargo maliyeti, yapı market kategorisinde çoğu zaman komisyondan bile daha belirleyici bir kalemdir. Bir ürünün kargo ücreti, gerçek ağırlığı ile hacimsel ağırlığından (desi) hangisi büyükse ona göre hesaplanır. Hafif ama hacimli bir ürün, örneğin büyük bir plastik saklama kutusu, ağırlığından çok daha yüksek bir desiyle kargolanır. Bu ürünü sisteme yanlış desiyle girerseniz, her satışta beklediğinizden fazla kargo ödersiniz ve bu farkı çoğu zaman aylar sonra kargo faturasını incelerken fark edersiniz. O noktaya kadar her satışta sessizce zarar etmiş olursunuz.
Bu yüzden ürün kurulumunda desi ve kargo sınıfı bilgisini gerçek ölçümlere dayandırmak, entegrasyonun görünmeyen ama kritik bir adımıdır. Özellikle aynı ürünün farklı ebatlardaki varyantları farklı desilere sahip olabilir; hepsini aynı sınıfa koymak yanlıştır. Deneyimli bir kurgu, her ürünün gerçek desisini ölçer, doğru kargo sınıfına atar ve bu bilgiyi fiyatlandırmaya yansıtır. Aksi halde ciro büyürken kargo maliyeti kârı sessizce eritir.
Paketleme ve Hasar Riski
Yapı market ürünlerinin bir başka özelliği, taşımada hasar riskinin yüksek olmasıdır. Cam, seramik, mobilya parçaları veya hassas elektronik aletler, kötü paketlendiğinde kırık veya hasarlı ulaşır ve bu doğrudan iadeye dönüşür. İade, sadece o satışın kaybı değil, hem ileri hem geri kargo maliyeti, hem de satıcı puanına olumsuz etki demektir. Bu yüzden entegrasyonun operasyonel tarafında paketleme standardı belirlemek, teknik senkronizasyon kadar önemlidir. İyi bir pazaryeri operasyonu, yalnızca yazılımı değil, depo ve paketleme süreçlerini de kapsar; ikisi birlikte çalışmadığında en iyi entegrasyon bile sonuç vermez.
Fatura, İade ve İptal Süreçlerinin Yönetimi
Sipariş akışının görünmeyen ama en az kargo kadar önemli tarafı fatura ve iade yönetimidir. Her satış için yasal olarak fatura kesmeniz gerekir ve bu faturanın müşteriye ulaşması beklenir. Entegratörlerin çoğu, e-Fatura ve e-Arşiv altyapısıyla bağlantılıdır; sipariş kabul edildiğinde otomatik olarak fatura keser ve ilgili sisteme işler. Bu, hem yasal uyumu hem de operasyonel hızı sağlar. Panelde çalışıyorsanız faturayı kendi muhasebe sisteminizde kesip yükler veya sürece manuel dahil edersiniz.
İade ve iptal süreçleri de Mirakl yapısında ayrı işlemler olarak tanımlıdır. Müşteri iade talebi oluşturduğunda, ürünü teslim aldıktan sonra iadeyi onaylar ve gerekli tutarı iade edersiniz. İptaller, siparişin durumuna göre kısmi veya tam olabilir. Bu süreçlerin doğru yönetilmesi, hem müşteri memnuniyeti hem de satıcı puanınız için kritiktir. Otomatik entegrasyonda iade ve iptal durumları stok havuzuna geri yansır; yani iade edilen ürün, uygunsa tekrar stoğa eklenir. Manuel yönetimde bu adımı atlamak, elinizde olan ürünü "yok" göstermek gibi ters bir stok hatasına yol açabilir.
Hakediş ve Ödeme Döngüsünü Anlamak
Pazaryeri satışında paranın size ulaşması, satışın gerçekleştiği anla aynı değildir. Platform, satış bedelinden komisyonunu ve varsa diğer kesintilerini düşer, ardından belirli bir ödeme döngüsünde kalan tutarı hesabınıza aktarır. Bu döngüyü ve kesinti kalemlerini net anlamak, nakit akışınızı sağlıklı yönetmenin ön koşuludur. Satış Ortağım Paneli, hakediş raporlarınızı ve komisyon kesintilerinizi gösterir; bu raporları düzenli takip etmek, hem muhasebe uyumu hem de gerçek kârlılığınızı görmek için şarttır. Entegratörlerin çoğu bu hakediş verisini de sisteme çekerek muhasebenizle eşleştirir, böylece her satışın gerçek net getirisini tek ekranda görebilirsiniz.
Bu noktada dikkat edilmesi gereken bir ayrıntı, iade ve iptallerin hakedişe yansımasıdır. İade edilen bir siparişin komisyonu ve bedeli geri döner; bu düzeltmelerin muhasebenizde doğru işlenmesi gerekir. Otomatik entegrasyon bu düzeltmeleri sistematik yaparken, manuel takipte kolayca gözden kaçar ve ay sonunda rakamların tutmamasına yol açar. Sağlıklı bir entegrasyon, sadece ürün ve sipariş akışını değil, finansal mutabakatı da kapsar.
Çoklu Pazaryeri Yönetimi: Koçtaş Tek Başına Değil
Gerçek şu ki, çok az satıcı yalnızca Koçtaş'ta satış yapar. Çoğu işletme aynı anda Trendyol, Hepsiburada, Amazon ve kendi web sitesinde de vardır. Bu çoklu kanal gerçeği, entegrasyon kararınızı doğrudan etkiler. Her kanalı ayrı ayrı, farklı panellerden yönetmek yorucu olmasının ötesinde tehlikelidir; çünkü stok kanallar arasında koordine edilmezse aşırı satış kaçınılmazdır.
Çoklu pazaryeri yönetiminin doğru kurgusu, tüm kanalların tek bir merkezden beslenmesidir. Bu merkez bir entegratör paneli olabilir, kendi kurduğunuz bir orta katman (middleware) olabilir veya e-ticaret altyapınızın kendisi olabilir. Önemli olan, stoğun tek havuzdan yönetilmesi ve her kanala aynı gerçeğin yansıtılmasıdır. Koçtaş gibi Mirakl tabanlı bir pazaryeri bu kurguya gayet uyumludur; standart API yapısı sayesinde merkezi sisteme kolayca bağlanır.
Çoklu kanalın bir başka boyutu, her kanalın farklı kurallara ve müşteri beklentisine sahip olmasıdır. Koçtaş'ın kategori yapısı, öznitelik gereksinimleri ve komisyon mantığı, Trendyol veya Hepsiburada'dan farklıdır. Tek bir merkezi sistemden yönetmek, bu farklılıkları ortadan kaldırmaz ama tek ekranda görünür kılar; her kanalın kuralına uygun veriyi tek yerden hazırlayıp ilgili kanala doğru formatta gönderirsiniz. Bu, hem tutarlılık sağlar hem de yeni bir kanal eklerken sıfırdan başlamamanızı sağlar. Koçtaş'ı zaten kurulu bir çoklu kanal sistemine eklemek, sistem yoksa sıfırdan kurmaktan çok daha kolaydır; bu yüzden çoklu kanal düşünen işletmelerin altyapıyı baştan doğru kurması, sonradan tek tek eklemekten daha akıllıcadır.




