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

idefix entegrasyonu: API bilgisinden fatura yüklemeye kadar adım adım

idefix entegrasyonu, idefix mağazanızdaki stok, fiyat ve siparişleri idefix'in resmî satıcı API'si üzerinden bir yazılıma bağlayıp Merchant Center ekranlarında tek tek güncelleme yapma ihtiyacını azaltmaktır. Aşağıda API bilgilerinin nereden alındığını, ürünlerin idefix kataloğuna nasıl girdiğini, stok ve fiyat gönderiminde hangi alanların önemli olduğunu ve sipariş-kargo-fatura akışını idefix'in geliştirici dokümanına dayanarak anlatıyoruz. Komisyon, ödeme takvimi gibi sözleşmeye bağlı konularda satıcı panelinizdeki güncel bilgiyi esas alın.

idefix entegrasyonu hangi satıcıya gerekir?

idefix, 1996'da çevrim içi kitapçı olarak başladı; 2023'te pazaryerine dönüşerek elektronikten yapı markete, pet ürünlerinden süpermarkete uzanan pek çok kategoride satıcılarla çalışmaya başladı. Bu kategorilerde satanların çoğu aynı ürünü başka kanallarda da listeliyor ve her satıştan sonra diğer mağazalardaki stoğu düşürmek ayrı bir iş hâline geliyor.

Birkaç ürünü ve günde birkaç siparişi idefix panelinden yönetmek başta yeterlidir. Aşağıdaki durumlardan ikisi sizde varsa bir idefix entegrasyon programı kullanmayı düşünmenin zamanı gelmiştir:

• Aynı ürünü idefix'in yanında kendi sitenizde ya da başka bir pazaryerinde de satıyorsunuz; örneğin Trendyol'da da mağazanız varsa her satışta iki kanalın stoğu birlikte düşmeli.
• Fiyatı kanal bazında farklı tutuyorsunuz ve her zam döneminde fiyatları elle tek tek düzeltiyorsunuz.
• Günde birkaç siparişten fazlasını hazırlıyor, kargo kodunu ve faturayı her siparişe ayrı ayrı giriyorsunuz.
• Stokta kalmayan ürün yüzünden tedarik edemediğiniz sipariş sayısı artıyor.

idefix API bilgileri nasıl alınır?

idefix API entegrasyonu için iki bilgi gerekir: API Key ve API Secret. idefix'in geliştirici dokümanına göre bu bilgiler satıcı panelinden oluşturulur ve mağazanıza kayıtlı e-posta adresine gönderilir. Adımlar şöyle:

1. idefix satıcı panelinize giriş yapın.
2. Hesap Bilgilerim menüsünden Entegrasyon Bilgileri sayfasını açın.
3. Yeni API Oluştur düğmesine tıklayın. API Key ve API Secret bilgileri kayıtlı e-posta adresinize gelir.
4. Gelen bilgileri eticaretcim panelindeki idefix bağlantı ekranına girin.
5. Bağlantı doğrulandıktan sonra mevcut ilanlarınız panele okunur ve barkod ya da stok koduyla eşleştirilir.

idefix'te API Key, API Secret ve Satıcı ID bilgileri test (stage) ve canlı ortam için ayrıdır. Test ortamına erişim IP yetkilendirmesi ister, canlı ortamda böyle bir şart yoktur; satıcı olarak kullanacağınız bilgiler canlı ortama aittir. Eşleştirme bittiğinde hiçbir ilanınız kendiliğinden değişmez: hangi ürünlerin stok ve fiyatının panelden yönetileceğine siz onay verirsiniz.

idefix ürün yükleme: ürünler kataloğa nasıl girer?

idefix, ürün yüklemek için iki yol tanımlıyor. Hangisinin kullanılacağını ürünün idefix kataloğunda bulunup bulunmadığı belirler. Bu yüzden en önemli hazırlık, her varyantta doğru ve tekil bir barkod olmasıdır.

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

Global barkodu olan ve idefix kataloğunda zaten bulunan ürünler, eşleştirme (mapping) gerekmeden hızlı ürün ekleme ile mağazanıza alınır. Ürün sayfasının içeriği katalogdan gelir; sizin göndereceğiniz asıl bilgi fiyat ve stoktur.

Katalogda olmayan ürünler: ürün oluşturma

Katalogda olmayan bir ürün için önce idefix'in marka, kategori ve kategori özellik listeleri alınır, ürün bu değerlerle oluşturulur ve durumu sorgulanarak takip edilir. idefix gönderdiğiniz ürünü sistemdeki bir ürünle eşleştirirse eşleşmeyi onaylamanızı ya da reddetmenizi bekler. Onayı ürünü gönderdikten sonraki 24 saat içinde verirseniz ürün ilk gönderdiğiniz satış bilgileriyle açılır; 24 saat geçtiyse envantere stok ve fiyat bekleyen ürün olarak eklenir.

idefix stok entegrasyonu: hangi alanlar gönderilir?

idefix stok entegrasyonu barkod üzerinden çalışır: stok ve fiyat, ürünün barkoduna gönderilir. idefix'in stok ve fiyat gönderim servisindeki alanlar, kanal ayarlarını yaparken nelere dikkat etmeniz gerektiğini de gösteriyor:

eticaretcim'de idefix fiyatını, ana fiyatınıza yüzde ya da tutar farkı ekleyerek belirleyebilirsiniz. Örneğin ana fiyatı 500 TL olan bir ürüne idefix için %5 fark tanımlarsanız idefix'e 525 TL gider; ana fiyatı değiştirdiğinizde idefix fiyatı da aynı kuralla güncellenir. Bu kuralların nasıl çalıştığını stok ve fiyat senkronizasyonu sayfasında ayrıntılı anlattık.

Gönderdiğiniz stok ya da fiyat idefix'e yansımadıysa ilk bakılacak yer, güncelleme durumu sorgusunun döndürdüğü hata mesajıdır. Panelin senkron sağlığı ekranında reddedilen ilanları ve red sebebini görebilirsiniz. Birden fazla kanalda aynı stoğu satıyorsanız aşırı satışı önlemek için 9 madde rehberimize de göz atın.

idefix sipariş entegrasyonu: kargo ve fatura akışı

idefix sipariş entegrasyonunda her sipariş bir sevkiyat (shipment) olarak gelir ve siz ilerledikçe statüsü güncellenir. Geliştirici dokümanındaki akış kabaca şöyledir:

1. Sipariş sevkiyat listesine düşer ve eticaretcim'in tek sipariş listesinde Yeni olarak görünür.
2. Hazırlamaya başladığınızda statü picking yapılır. idefix bu statüyü, müşterinin siparişi sitede iptal etmesini istemediğiniz aşama için tanımlıyor.
3. Fatura kesilip fatura numarası oluşunca statü invoiced olarak bildirilir.
4. Kendi kargo anlaşmanızla gönderiyorsanız takip numarası ve takip adresi bildirilir; statü kendiliğinden kargoda (shipment_in_cargo) olur.
5. Ürünü tedarik edemiyorsanız sevkiyat, idefix'in tanımlı sebeplerinden biriyle tedarik edilemedi (unsupplied) olarak bildirilir.

Kendi kargo anlaşmanızla göndermek

idefix'te her siparişin seçili bir kargo profili vardır; platformun ve satıcının kargo profilleri ayrı listelenir. Kendi sözleşmenizle gönderdiğinizde bildirdiğiniz takip adresi bu profille uyumlu olmalıdır. Uyuşmazsa idefix hata döner ve önce gönderi bilgisinin doğru kargo firmasıyla değiştirilmesi gerekir. eticaretcim'de kargo entegrasyonu ile birincil kargo firmanızı seçip etiketi basabilir, takip numarasını pazaryerine iletebilirsiniz.

Faturayı idefix'e yüklemek

idefix faturayı üç yolla kabul ediyor: entegrasyonla fatura linki göndererek, Merchant Center'da Siparişlerim bölümündeki Fatura Yükle düğmesiyle ya da siparişteki maskeli e-posta adresine PDF veya link göndererek. Kurumsal siparişlerde şirket unvanı, vergi numarası ve vergi dairesi fatura adresi alanında gelir. Profesyonel ve üstü paketlerde e-Fatura ve e-Arşiv entegrasyonu siparişe otomatik fatura keser ve kanal desteklediğinde belgeyi pazaryerine iletir.

idefix entegrasyonunda sık yapılan hatalar

Kurulumdan sonra yaşanan sorunların çoğu yazılımdan değil, eksik hazırlıktan çıkar. Bağlantıyı kurmadan önce şu listeyi kontrol edin:

• Aynı barkodu birden fazla varyantta kullanmak: stok yanlış ürüne yazılır, idefix'teki eşleşme karışır.
• comparePrice alanını boş bırakmak: tavsiye edilen fiyatı kullanmıyorsanız bu alana 0 gönderilmelidir.
• Kargoya verme süresini olduğundan kısa tanımlamak: geciken siparişler hem müşteriyi hem mağazanızın performansını etkiler.
• Faturayı kesip invoiced statüsünü bildirmemek: sipariş idefix tarafında faturalanmamış görünmeye devam eder.
• Eşleşme onayını 24 saatten sonraya bırakmak: ürün stok ve fiyat bekleyen olarak açılır, bu bilgileri yeniden göndermeniz gerekir.
• Test ortamı bilgilerini canlı mağazada denemek: iki ortamın API bilgileri farklıdır.

Panelde kritik stok uyarısını ve geciken sipariş uyarısını açarsanız bu hatalardan ikisini, sipariş kaybına dönüşmeden yakalarsınız.

idefix entegrasyonu için hangi paket yeterli?

Yalnız idefix'te satıyorsanız ya da idefix'i ilk kanalınız olarak bağlayacaksanız Başlangıç paketi (aylık ₺499) yeterli olabilir: idefix, bu pakette tek kanal olarak seçilebilen yurt içi pazaryerlerinden biri. Pakette 500 ürün ve ayda 100 sipariş limiti var; kargo takip numarası elle girilir. idefix'i iki kanalla daha birlikte kullanacaksanız Büyüme paketi (₺999) 3 kanal, 5.000 ürün, toplu işlemler ve bir kargo firması entegrasyonu sunar.

Siparişe otomatik e-Arşiv faturası ve ürün ya da kanal bazında kâr raporu istiyorsanız Profesyonel paket (₺1.999) gerekir. Bütün paketleri ve limitleri entegrasyon fiyatları ve paketler sayfasında karşılaştırabilirsiniz; yıllık ödemede %20 indirim uygulanır.

idefix'in kestiği komisyonu ve kargo bedelini sipariş bazında kontrol etmek isterseniz hakediş ve komisyon kontrolü özelliği fazla kesintileri, ödenmeyen hakedişleri ve zarar eden siparişleri ayrı listeler.