idefix entegrasyonu:
ürün, stok ve sipariş tek panelde.

idefix entegrasyonu nedir ve hangi satıcının işine yarar?

idefix, 1996'da çevrim içi kitapçı olarak yola çıkan ve bugün akıllı telefondan küçük ev aletlerine, kozmetikten anne-bebek ürünlerine uzanan geniş bir yelpazede dışarıdan satıcılarla çalışan bir pazaryeridir. Satıcı işleri Merchant Center adlı panelden yürür; aynı işlemlerin çoğu idefix'in satıcı API'siyle de yapılabilir. Entegrasyon bu ikinci yolu kullanır: stok, fiyat ve sipariş verisi yazılımla idefix arasında otomatik taşınır.

Yalnız idefix'te ve az sayıda ürünle satıyorsanız satıcı paneli çoğu zaman yeterlidir. Entegrasyonun asıl karşılığı, aynı stoğu birden fazla yerde sattığınızda ortaya çıkar. Aşağıdaki işaretlerden ikisi sizde varsa stok ve sipariş akışını tek merkeze almanın zamanı gelmiştir.

Elle yönetimin yetmediğini gösteren işaretler

• Aynı ürünü Trendyol mağazanızda ya da kendi sitenizde de satıyor, son adetlerde iki kanaldan birden sipariş alıyorsunuz.
• Maliyet ya da kampanya değişikliğinde idefix fiyatlarını ayrıca güncellemeyi unuttuğunuz oluyor.
• Siparişlerin bir kısmını tedarik edemedi olarak kapatmak zorunda kalıyorsunuz.
• Fatura, takip numarası ve statü bildirimini her siparişe elle girmek gününüzün önemli bir kısmını alıyor.

idefix'te satıcı olmak: başvuru, KEP adresi ve sözleşme

idefix'in satıcı sayfasına göre mağaza açmak ücretsizdir; kayıt olma ve ürün listeleme için ücret alınmaz. Başvurabilmek için anonim, limited, şahıs ya da başka türde bir şirketinizin olması veya vergi mükellefi olmanız gerekir. Başvuru formunda şirket bilgileri, iletişim bilgileri ve KEP adresi istenir. Değerlendirme tamamlandığında satıcı sözleşmesi KEP adresinize gönderilir; sözleşmeyi onayladığınızda panele erişim bilgileriniz iletilir ve ürün girmeye başlayabilirsiniz.

Başvuru tipi kurulumu değiştirir mi?

Başvuru tipi entegrasyon açısından fark etmez: hesabınız açıldıktan sonra her satıcı API bilgilerini aynı ekrandan oluşturur. idefix'in satıcı çağrı merkezi (0850) 266 0606 numarasında her gün 09.00–21.00 arasında hizmet veriyor; entegrasyon erişim sorunlarında ise size iletilen destek e-postası kullanılır.

idefix API bilgileri nasıl oluşturulur, bağlantı nasıl kurulur?

idefix API entegrasyonunda kimlik doğrulama iki bilgiyle yapılır: API Key ve API Secret. Bu ikiliyi idefix sizin için üretir ve yalnız mağazanın kayıtlı e-posta adresine yollar; yazılım bu bilgilerden bir erişim anahtarı türetip mağazanız adına yaptığı her isteğe ekler. Yox İş Ortağım'a bağlarken izleyeceğiniz sıra şöyledir:

1. idefix satıcı panelinde Hesap Bilgilerim menüsünden Entegrasyon Bilgileri sayfasına geçin.
2. Yeni API Oluştur düğmesine basın; API Key ve API Secret kayıtlı e-posta adresinize gelir, satıcı ID bilginiz de bu sayfadadır.
3. Bu bilgileri Yox İş Ortağım'daki idefix bağlantı ekranına girin; mevcut ilanlarınız panele gelir.
4. İlanlar barkod ya da stok koduyla ürün kartlarınıza eşleştirilir; siz onaylamadan hiçbir ilan değişmez.
5. Onayladığınız ürünlerde stok, fiyat ve sipariş akışı diğer kanallarla birlikte başlar.

idefix API'sinin sınırları: neyi yapabilir, neyi yapamaz?

Bir idefix entegrasyon programından ne bekleyebileceğinizi idefix'in kendi servis kuralları belirler. Geliştirici dokümanındaki şu sınırları kurulumdan önce bilin:

idefix kataloğuna ürün göndermek: hızlı ekleme ve yeni ürün oluşturma

idefix'te bir ürünün mağazanıza girme yolu, o ürünün idefix kataloğunda zaten bulunup bulunmadığına göre ikiye ayrılır. Bu ayrımın anahtarı global barkoddur: varyantlarınızın her birinde doğru ve tekil bir barkod yoksa iki yol da tıkanır, stok yanlış ürüne yazılır.

Katalogda olan ürün: hızlı ürün ekleme

Katalogda kayıtlı, global barkodlu ürünlerde eşleştirme (mapping) gerekmez. Barkod, ürün adı, stok kodu, fiyat ve stok adedi gönderilince idefix ürünü katalogdaki kayıtla eşler; eşleşmeyi panelden ya da API'den onaylar veya reddedersiniz. Katalogda karşılığı olmayan barkodların yeni ürün olarak oluşturulması gerekir.

Katalogda olmayan ürün: marka, kategori ve zorunlu özellikler

Yeni ürün açarken önce idefix'in marka listesi, kategori ağacı ve kategori özellik listesi alınır. Kategoride zorunlu işaretli bir özellik eksikse ürün idefix'te oluşmaz. Ana ürün kodu, açıklama, KDV oranı ve görseller de zorunlu alanlar arasındadır. Yox İş Ortağım'da ürün kartınız idefix kategorisine ve özelliklerine eşleştirilir; beden, renk gibi varyantlar tek karttan yönetilir.

İki ayrıntıya dikkat edin. Dokümandaki örnekte KDV için 0, 1, 8, 18 gibi oranlar geçiyor; oysa 10 Temmuz 2023'ten beri yürürlükteki oranlar istisnalar dışında %1, %10 ve %20'dir. Ayrıca menşe ülke, üretici, ithalatçı, CE işareti ve parti/lot/SKT gibi ürün denetim alanları tanımlıdır; denetime tabi kategorilerde bu belgeleri baştan hazır tutun.

idefix stok ve fiyat senkronu: barkod, teslim süresi ve hata kodları

idefix'te stok ve fiyat barkod üzerinden güncellenir ve her gönderim bir toplu işlem kimliği (batchRequestId) üretir. İşlemin sonucu ayrı bir sorguyla okunur: created (talep alındı), completed (tamamlandı) ya da decline (hata). Hata durumunda idefix bir sebep kodu döndürür; dokümandaki örnekte fiyatı olmayan bir kayıt NO_PRICE sebebiyle reddediliyor. Yani bir güncellemenin gönderilmiş olması idefix'e yansıdığı anlamına gelmez; sonucun mutlaka okunması gerekir.

Stok ve fiyatla birlikte gönderilen alanlar

• Tavsiye edilen satış fiyatı (comparePrice): kullanılmayacaksa 0 gönderilmelidir.
• Kargoya verilme süresi (deliveryDuration): Mesafeli Sözleşmeler Yönetmeliği'ne göre mal teslim süresi her hâlde 30 günü geçemez; idefix'e yazdığınız süre gerçek hazırlık sürenizi yansıtmalı.
• Gönderim tipi (deliveryType): normal (regular) ya da aynı gün kargo (same_day_shipping).
• Azami satın alma adedi: tek siparişte alınabilecek en yüksek adet; son adetlerde toplu alımı sınırlar.
• Bölgesel satış (isZoneSale): ürünün bölgesel satışa tabi olup olmadığı.

Tek stok kartı ve kanal bazında fiyat kuralı

Yox İş Ortağım'da idefix ilanı, diğer kanallardaki ilanlarla aynı ürün kartına bağlanır. Ürün Hepsiburada'da ya da başka bir kanalda satıldığında stok aynı ürün kartından düşer ve değişiklik idefix mağazanıza da gönderilir; son adet iki kez satılmaz. Fiyat kurallarınız kanal bazında uygulanır. Stok ya da fiyat yansımadıysa önce işlem sonucundaki hata mesajına, sonra Merchant Center'daki Envanterim ekranına bakın.

idefix sipariş statüleri, kargo profilleri ve fatura yükleme

idefix'te her sipariş, satıcı bazında oluşturulan bir sevkiyat (shipment) olarak gelir. Ana sipariş numarası (orderNumber) birden çok satıcının ürününü kapsayabilir; sevkiyat kimliği ise yalnız sizin paketinizi temsil eder. Statülerin bir kısmını idefix günceller, bir kısmını sizin bildirmeniz gerekir:

Yox İş Ortağım'da idefix siparişleri diğer kanallarla aynı listeye düşer; hazırlanıyor, kargoda ve teslim edildi aşamaları tek ekranda izlenir. Pratik bir kural: picking statüsünü ürünü rafta gördükten sonra bildirin. Bu statüyle müşterinin iptal yolu kapanır; elinizde olmayan bir ürün için kapatırsanız sipariş tedarik edemedi bildirimiyle sonuçlanır.

Platform öder ve satıcı öder kargo profilleri

idefix kargo firmalarını profiller hâlinde tanımlar: bir profil platform anlaşmalı ya da satıcı anlaşmalı olabilir ve seçili profil her siparişte cargoProfileId alanıyla gelir. Kendi sözleşmenizle gönderdiğinizde takip numarası ve takip adresi bildirilir, sipariş kendiliğinden kargoda statüsüne geçer; takip adresi siparişteki profille uyuşmazsa idefix hata verir ve önce gönderi seçeneği değiştirilir. Yox İş Ortağım'da kargo entegrasyonunuz varsa etiket basıldığında takip numarası idefix siparişine işlenir; örnek olarak Yurtiçi Kargo entegrasyonu sayfasına bakabilirsiniz.

Faturayı idefix'e iletmenin üç yolu

idefix faturayı üç yoldan kabul ediyor: entegrasyonla e-Arşiv ya da e-Fatura bağlantısı göndermek, Merchant Center'da Siparişlerim ekranındaki Fatura Yükle düğmesi ve sevkiyattaki maskeli müşteri e-posta adresine PDF ya da bağlantı yollamak. Kurumsal siparişte şirket unvanı, vergi numarası ve vergi dairesi fatura adresinden okunur. Yox İş Ortağım'da belge bağlı muhasebe programınızdan kesilir ve fatura bilgisi idefix siparişine iletilir; bu bağlantı Profesyonel paketle başlar. GİB portalını kullanıyorsanız GİB e-Arşiv Portal entegrasyonu sayfasına bakın.

idefix'te iade, iptal ve tedarik edememe süreçleri

Tüketici, Mesafeli Sözleşmeler Yönetmeliği'ne göre malı teslim aldığı günden itibaren 14 gün içinde gerekçe göstermeden cayma hakkını kullanabilir; bedelin iadesi için öngörülen süre de cayma bildiriminden itibaren 14 gündür. idefix'te iade talepleri ayrı bir listede toplanır; her kayıtta iade sebebi, iade kargosu ve otomatik onay tarihi yer alır.

• İade onayı: deponuza ulaşan iade ürününü kontrol edip kalem bazında onaylarsınız.
• İade ret talebi: ürün kullanılmış ya da eksik geldiyse tanımlı ret sebeplerinden birini seçip açıklama ve görsel eklersiniz; ret doğrudan değil, talep olarak iletilir.
• Tedarik edememe: sevkiyat stok tükendi, kusurlu ürün, hatalı fiyat ya da entegrasyon hatası gibi tanımlı sebeplerle kapatılır; sevkiyatta kalan ürünler için aynı sipariş numarasında yeni sevkiyat açılır.
• Sevkiyat bölme: eski kayıt split statüsünde kalır, yeni sevkiyat numaraları aynı siparişe eklenir.
• İşçilik bedeli: bazı kategorilerde kalem bazında bildirilir; teslim edildi statüsünden sonra değiştirilemez.

Tedarik edememe sebepleri arasında entegrasyon hatasının ayrı bir seçenek olarak bulunması, yanlış stok ya da fiyat aktarımının idefix tarafından ayrıca izlendiğini gösteriyor. Bu yüzden stok senkronunu düzenli denetlemek, tedarik edemedi bildirimlerini azaltmanın en kısa yoludur.

idefix komisyonu, stopaj ve hakediş: sipariş başına ne kesilir?

idefix'in komisyon oranları kategoriye göre değişir ve satıcı sözleşmesiyle belirlenir; Ekim 2026 itibarıyla herkese açık resmî bir kategori tablosu yok, güncel oranı satıcı panelinizden kontrol edin. idefix'in sipariş verisi ise kesintileri kalem kalem gösterir: her ürün satırında komisyon tutarı (commissionAmount) ve satıcı hakediş tutarı (earningAmount) ayrı döner.

Örnek hesap: 1.200 TL'lik bir satışta kesintiler

Aşağıdaki tabloda komisyon oranı %15 yalnız varsayımdır, idefix'in bir oranı değildir; kargo tutarı da örnektir. Ürün %20 KDV'li ve KDV dahil 1.200 TL'ye satılıyor.

Bu tutar kâr değildir: ürün maliyeti ve ödeyeceğiniz KDV farkı düşülünce net kâr ortaya çıkar; hesabı kendi oranınızla komisyon hesaplama aracında tekrarlayabilirsiniz. Stopaj, 9284 sayılı Cumhurbaşkanı Kararı ve 330 Seri No'lu Gelir Vergisi Genel Tebliği uyarınca 1 Ocak 2025'ten beri KDV hariç tutar üzerinden %1 kesilir ve yıllık gelir ya da kurumlar vergisinden mahsup edilir.

Hakediş ne zaman ödenir?

idefix'in ödeme vadesi herkese açık bir sayfada yayımlanmıyor; sözleşmeniz ve panelinizdeki tarih esastır. Hakedişe geçişin işareti, sevkiyatın shipment_approved statüsüne gelmesidir. Yox İş Ortağım'da idefix siparişlerinde kesilen komisyon ve kargo bedeli sipariş bazında net kârla birlikte görünür; fazla kesinti ve ödenmeyen hakediş ayrı listelenir.

idefix entegrasyonu Yox İş Ortağım'da hangi pakette, elle yönetimden farkı ne?

Yox İş Ortağım, Yox Yazılım ve Teknoloji San. ve Tic. Ltd. Şti.'nin pazaryeri entegrasyonu panelidir; 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ile 51 muhasebe, e-Fatura ve ERP programı tanımlıdır. idefix, Başlangıç paketinde tek kanal olarak seçilebilen yedi yurt içi pazaryerinden biridir.

Yıllık ödemede %20 indirim uygulanır. Limitlerin tamamını Yox İş Ortağım paketleri bölümünde karşılaştırabilirsiniz.

Elle yönetim ile entegrasyon arasındaki fark

idefix entegrasyonu öncesi kontrol listesi ve sık yapılan hatalar

Kurulumun süresini çoğu zaman yazılım değil, verinizin düzeni belirler. Bağlantıyı açmadan önce şu listeyi tamamlayın:

• KEP adresiniz ve onaylanmış satıcı sözleşmeniz hazır, satıcı panelinize erişebiliyorsunuz.
• Canlı mağazanın API Key ve API Secret bilgileri kayıtlı e-postanıza ulaştı; test ortamı bilgileriyle karışmıyor.
• Her varyantın kendine ait tekil bir barkodu var; aynı barkod iki ürün kartında kullanılmıyor.
• Kargo profiliniz (platform anlaşmalı ya da kendi sözleşmeniz) belli ve kargoya verilme süreniz gerçekçi.
• Komisyon oranınızı panelden not ettiniz ve idefix fiyatınızı bu orana göre hesapladınız.

En sık karşılaşılan hatalar

• Test bilgilerini canlı mağazaya girmek: bağlantı VENDOR_TOKEN_NOT_EXIST yetki hatası verir.
• Eşleşme onayını 24 saatten sonraya bırakmak: ürün stok ve fiyat bekleyen kayıt olarak açılır.
• picking statüsünü ürünü görmeden bildirmek: iptal yolu kapanır, ardından tedarik edememe kaydı düşer.
• Kendi kargonuzla gönderirken siparişteki profille uyuşmayan takip adresi bildirmek.
• Desi ve koli bilgisini gerçeğinden büyük girmek; koli ölçüsünü desi hesaplama aracıyla doğrulayın.

Kurulumu tek başınıza yapmak zorunda değilsiniz: Yox İş Ortağım'ı 3 gün ücretsiz deneyebilir, kısa bir ön görüşmeden sonra kurulumu ekibimizle birlikte yapabilirsiniz. Yox İş Ortağım'a başvurun, sorularınız için iletişim sayfamızdan yazın; diğer kanallar entegrasyon ana sayfasında.