Destek Makaleleri

Detaylı Yönergeler

ikas x HepsiBurada Entegrasyonu

HepsiBurada entegrasyonunun temel amacı HerpsiBurada ve ikas hesabı olan kullanıcıların ikas’taki panelleri üzerinden, yani tek panelden, ürünlerinin sipariş, fiyat ve stok bilgilerini takip edebilmesini ve yönetebilmesini sağlayabilmektir.

Genel Bilgiler

HepsiBurada entegrasyonunun temel amacı HerpsiBurada ve ikas hesabı olan kullanıcıların ikas’taki panelleri üzerinden, yani tek panelden, ürünlerinin sipariş, fiyat ve stok bilgilerini takip edebilmesini ve yönetebilmesini sağlayabilmektir.
HepsiBurada’ya ürün gönderirken maksimum 20.000 stok sınırımız var. 20.000’den fazla stok gönderilmeye çalışıldığı takdirde, hata mesajı alınır.
ikas’ta bulunan HepsiBurada uygulaması entegrasyonunun ana başlıkları Ayarlar, Ürünler, Siparişler ve Lisans olarak görünür.
HepsiBurada entegrasyonunu her kullanıcı kullanabilir. Start ve Grow paketlerde bu entegrasyonun 16.788 TL bir ücreti bulunmaktadır. Scale ve üzeri paketlerde ise paketinizin içerisinde entegrasyon ücretsiz olarak kullanımınıza sunulur.
ikas ile Hepsiburada entegrasyonunu yapmak için ilk olarak Hepsiburada tarafında üyelik oluşturmanız gerekiyor. ikas panelinde Uygulama Mağazası > Pazaryeri bölümünden HepsiBurada uygulamasına ulaşabilirsiniz ve kurulumunu gerçekleştirebilirsiniz.
HepsiBurada’da kullanılacak olan fiyat listesinde dinamik fiyat listesi kullanılamaz.

ikas’tan HepsiBurada’ya ürün gönderemiyoruz. HepsiBurada’dan ikas’a ürün çekebiliriz.

ikas'ta HepsiBurada Uygulaması nasıl kurulur, ikas Hepsiburada entegrasyon nasıl yapılır?

Kullanıcı hepsiburada entegrasyonu ile ilgili soru sorduğu zaman, ilgili kırılımı kullanıcıya iletmeliyiz “Hepsiburada entegrasyonu için ikas paneli > uygulamalar > uygulama mağazası > pazaryerleri > hepsiburada > uygulamayı kur bölümüne tıklanmalı”

HepsiBurada'a ürün gönderirken maksimum 20.000 stok sınırımız var. 20.000’den fazla stok gönderilmeye çalışıldığı takdirde, hata mesajı alınır.
Dinamik fiyat listesi kullanılamaz

Ardından açılan pencerede

Hangi paketlerde hepsiburada entegrasyonu kullanılabilir veya hepsiburada entegrasyonu ücretli mi? sorularına = Tüm ikas paketlerinde Hepsiburada entegrasyonu istenmesi halinde kullanılabilir. Entegrasyon, Start ve Grow pakette ücretli (KDV dahil 16.788 TL), Scale ve üstü paketlerde ise hediye olarak kullanılmaktadır.
HepsiBurada Entegrasyonu için HB paneline gidilip Webhook Entegratör bilgilerinin eklenmesi gerekiyor. Webhook Entegratör bilgilerinin eklenmesi için hepsiburada panelinin Canlı Yardım kısmından Entegrasyon seçerek bilgileri ekleyeceğimiz alana ulaşılır. Destek talebinin içine aşağıdaki bilgiler yazılmalıdır.
Ürünleri hepsiburada ve ikas’ta ürünleri eşleştirmek için = Hepsiburada ve ikas’ta ürünleri ayrı ayrı oluşturmalı ve aynı ürünlerde aynı barkodlar bulunmalı.
Eğer ürünlerin barkodları eşleşmiyor ise ürünleri manuel eşleştirmeniz gerekir.

ikas’ entegrasyonu ile Hepsiburada’ya ürün açma özelliği bulunmamaktadır. Kullanıcının ürünün hem ikas’ta hem hepsiburada’da yüklü olması gerekir.
Hangi paktelerde hepsiburada entegrasyonu kullanılabilir sorusuna = Tüm ikas paktlerinde Hepsiburada entegrasyonu mevcuttur. Entegrasyo, Start ve Grow pakette ücretli (KDV dahil 16.788 TL), Scale ve üstü paketlerde ise hediye olarak kullanılmaktadır.
Hepsiburada entegrasyonunu kurduktan sonra, Scale paket ve üzerinde hediye edilse de 14 günlük demo süresi bitmeden lisans kısmından mutlaka kart bilgisi girilerek aktif edilmesi gerekir.
Hepsiburada Entegrasyonu için HB paneline gidilip Webhook Entegratör bilgilerinin eklenmesi gerekiyor. Webhook Entegratör bilgilerinin eklenmesi için hepsiburada panelinin Canlı Yardım kısmından Entegrasyon seçerek bilgileri ekleyeceğimiz alana ulaşılır. Destek talebinin içine aşağıdaki bilgiler yazılmalıdır.
İşlem yapılan ortam bilgisi kısmında > Live(PROD) seçilmeli, konu kısmına ikas_dev yetkilendirme yazılıyor.
Mesaj kısmına aşağıdaki metin yapıştırılıyor: Merhaba, Canlı ortam için ikas_dev entegrasyon firmasının hesabına mağazamızın yetkisini verip aşağıdaki endpointlere gerekli.
Webhook tanımlarını yapabilir misiniz? Webhook Basic Auth: User: ikas_user Şifre: 9H6k-ENf+y5Z^!_Ns3w! hepsiburada.ikasapps.com/api/webhook/hb/orders hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/intransit hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/deliver hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/undeliver hepsiburada.ikasapps.com/api/webhook/hb/lineitems/{lineitemid}/cancel hepsiburada.ikasapps.com/api/webhook/hb/packages hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/unpack hepsiburada.ikasapps.com/api/webhook/hb/{0}/orders/{1}/shippingaddress
Sonrasında HB panelinde Entegratör bölümünden ikas_dev ekleniyor. İlk başta pasif olarak gözükür, yukarı Webhook onaylandıktan sonra burası aktif oluyor.

Webhook ekleyip, aktif hale geldikten sonra yer alan servis anahtarı da ikas paneline giriliyor.

- Hepsiburada’ya manuel yüklenen ürünler ikas’a sorunsuz aktarılabilir. Hepsiburada’ya ürün katalogtan yüklendiyse excel olarak Hepsiburadadn dışarı aktarıp formatta değişiklikyapmadan uygulama içerisinden içeri aktarabiliriz ve ardından eşleştirebiliriz. (Ürünler ikas panelinde ürün olarak oluşmyacaktır. Manuel yüklenmesi gerekir)
- ikas’tan Hepsiburada’ya ürün aktarımı sağlanamaz. Öneri olarak ikas’taki ürünlerinin exceli alabilir ve Hepsiburada’nın toplu ürün yükleme dosyasına uyarlayarak o taraftan yükleyebilir.
- ikas, Hepsiburada’dan anlık olarak sorgulama yapar.
ikas HepsiBurada Uygulaması > Lisans
- Start ve Grow pakette ücretli (KDV dahil 16.788 TL), Scale ve üstü paketlerde ise hediye olarak kullanılmaktadır. Scale paket ve üzerinde hediye edilse de 14 günlük demo süresi bitince lisans kısmından mutlaka kart bilgisi girilerek aktif edilmesi gerekir. Ayrıca kullanıcının start veya grow paketi olsa bile, yani bu entegrasyonları satın almamış veya hediye edilmemiş olsa bile, demo hesabı açabilir. Demo hesabı üzerinden HepsiBurada’dan ürünlerini toplu olarak ikas’a çekebilir. Genelde aktif bir HepsiBurada mağazası olup ikas tarafında hiç ürünü olmayan kullanıcılar için bu yöntem inanılmaz bir ürün yükleme iş yükünü üzerlerinden alabilir. HepsiBurada’dan çekilen tüm ürünler görsel, fiyat, stok, açıklama ve kategorileri gibi bilgiler ile birlikte ikas’a çekilir. Kullanıcının demo süresi bittiğinde HepsiBurada’dan çekilen ürünlerine bir şey olmaz, çekilen ürünler aynı şekilde kullanılmaya devam edilebilir, sadece entegrasyon bitmiş olur.

Hepsiburada entegrasyonunu ikas panelinde nasıl kurabilirim? = Hepsiburada entegrasyonunu kurmak için ikas paneline giriş yaparak Satış Kanalları bölümüne gitmeli ve ilgili satış kanalını seçmelisiniz. Ardından Uygulamalar > Uygulama Mağazası > Pazaryerleri > Hepsiburada adımlarını takip ederek Uygulamayı Kur butonuna tıklamanız gerekir.

Hepsiburada entegrasyonu hangi paketlerde kullanılabilir? = Hepsiburada entegrasyonu tüm ikas paketlerinde kullanılabilir. Start ve Grow paketlerinde ücretli olarak sunulmaktadır (KDV dahil 16.788 TL). Scale ve üstü paketlerde ise ücretsiz olarak kullanılmaktadır.

Hepsiburada panelinde Webhook Entegratör bilgilerini nasıl eklerim? = Webhook bilgilerini eklemek için Hepsiburada paneline giriş yapmalı ve Canlı Yardım bölümünden Entegrasyon konusunu seçmelisiniz. Açılan destek talebine aşağıdaki bilgileri eklemeniz gerekir: İşlem Yapılan Ortam olarak Live (PROD) seçilmeli, konu olarak ikas_dev yetkilendirme yazılmalıdır. Mesaj kısmına aşağıdaki metin yapıştırılmalıdır:

Merhaba,Canlı ortam için ikas_dev entegrasyon firmasının hesabına mağazamızın yetkisini verip aşağıdaki endpointlere gerekli Webhook tanımlarını yapabilir misiniz?

Webhook Basic Auth:Kullanıcı Adı: ikas_userŞifre: 9H6k-ENf+y5Z^!_Ns3w!

Endpointler:hepsiburada.ikasapps.com/api/webhook/hb/ordershepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/intransithepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/deliverhepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/undeliverhepsiburada.ikasapps.com/api/webhook/hb/lineitems/{lineitemid}/cancelhepsiburada.ikasapps.com/api/webhook/hb/packageshepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/unpackhepsiburada.ikasapps.com/api/webhook/hb/{0}/orders/{1}/shippingaddress Açılan destek talebine aşağıdaki bilgileri eklemeniz gerekir: İşlem Yapılan Ortam olarak Live (PROD) seçilmeli, konu olarak ikas_dev yetkilendirme yazılmalıdır. Mesaj kısmına, canlı ortam için ikas_dev entegrasyon firmasının hesabına mağaza yetkisi verilmesi ve belirli endpointlere gerekli Webhook tanımlarının yapılmasını talep eden metin eklenmelidir. Webhook Basic Auth bilgileri olarak kullanıcı adı "ikas_user" ve şifre "9H6k-ENf+y5Z^!_Ns3w!" kullanılmalıdır. Belirtilen endpointler Hepsiburada’nın ilgili API adreslerine yönelik olarak belirtilmelidir. Yeni eklenmesi gereken endpoint: hepsiburada.ikasapps.com/api/webhook/hb/{0}/orders/{1}/shippingaddress Açılan destek talebine aşağıdaki bilgileri eklemeniz gerekir: İşlem Yapılan Ortam olarak Live (PROD) seçilmeli, konu olarak ikas_dev yetkilendirme yazılmalıdır. Mesaj kısmına, canlı ortam için ikas_dev entegrasyon firmasının hesabına mağaza yetkisi verilmesi ve belirli endpointlere gerekli Webhook tanımlarının yapılmasını talep eden metin eklenmelidir. Webhook Basic Auth bilgileri olarak kullanıcı adı "ikas_user" ve şifre "9H6k-ENf+y5Z^!_Ns3w!" kullanılmalıdır. Belirtilen endpointler Hepsiburada’nın ilgili API adreslerine yönelik olarak belirtilmelidir.

Webhook onaylandıktan sonra entegrasyon nasıl aktif hale gelir? = Hepsiburada panelinde Webhook tanımları onaylandıktan sonra Entegratör bölümüne giderek ikas_dev entegratörünü eklemeniz gerekir. İlk etapta pasif olarak görünen entegrasyon, Webhook tanımları onaylandığında aktif hale gelecektir.

Hepsiburada’dan ikas’a ürün aktarımı nasıl yapılır? = Hepsiburada’ya ürünler manuel olarak yüklendiyse, ikas paneline sorunsuz aktarılabilir. Ürünler Hepsiburada kataloğuna yüklendiyse, ürünleri Excel formatında dışa aktarabilir, formatta herhangi bir değişiklik yapmadan ikas paneline içe aktarabilir. Katalog ürünler, ikas’ın içerisindeki hepsiburada uygulamasında görünmeyeceğinden eşleşemeyecektir. Eşleşmeyen ürünerin stok ve fiyat bilgisi ika tarafından güncellenemez.

ikas’tan Hepsiburada’ya ürün aktarımı yapabilir miyim? = Hayır, ikas’tan Hepsiburada’ya doğrudan ürün aktarımı yapılamaz. Bunun yerine ikas’taki ürünlerinizi Excel olarak dışa aktarabilir ve Hepsiburada’nın toplu ürün yükleme dosyasına uygun hale getirerek ürünlerinizi Hepsiburada paneline yükleyebilirsiniz.

Hepsiburada’daki ürünlerimin barcodları farklı ise ikas ile nasıl eşleştirme yapabilirim? = Hepsiburada’daki ürünlerinizin barkodları ikas panelindekilerle eşleşmiyorsa, manuel olarak ürün eşleştirmesi yapmanız gerekir. Ürünlerinizi Hepsiburada’dan Excel formatında dışa aktararak barkodları kontrol edebilir ve ikas paneline uygun hale getirebilirsiniz. Ya da ürünlerin barkodlarını aynı hale getirilebilir.

Hepsiburada’daki ürün fiyatlarını ikas panelinden güncelleyebilir miyim? =Evet, ikasta kulalnılan varsyıaln veya farklı fiyat list.

Hepsiburada entegrasyonu için ürünlerimi hangi formatta dışa aktarmalıyım? = Hepsiburada’dan ürünlerinizi dışa aktarırken Excel formatında dışa aktarmanız gerekir. Aktarma işleminden sonra ikas excel formatına uygun hale getirilerek içeri yüklenmelidir. ikas’a ürünlerinizi .csv ve .xlsx formatlarında yükleyebilrsiniz.

Hepsiburada entegrasyonunun sağlıklı çalışması için nelere dikkat etmeliyim? = Hepsiburada entegrasyonunun sağlıklı çalışması için ürünlerin doğru barkodlara sahip olduğundan, Hepsiburada ve ikas panellerindeki ürün bilgilerinin eksiksiz olduğundan ve Webhook ayarlarının doğru yapılandırıldığından emin olmalısınız. Entegrasyonu kurduktan sonra test ederek işleyişini kontrol etmeniz önerilir.

Webhook nedir ve neden eklenir? = Webhook, iki sistem arasında veri aktarımı sağlayan bir bildirim mekanizmasıdır. Hepsiburada entegrasyonunda sipariş ve gönderi bilgilerinin ikas paneline otomatik olarak iletilmesini sağlar. Bu işlem, manuel veri girişini azaltır ve sipariş yönetimini kolaylaştırır.

Ayarları kaydet sırasında, “Hepsiburada bilgilerinizi kontrol edip tekrar deneyiniz!” hata mesajı alınıyorsa = (Potansiyel cevaplar)
1-Hepsiburada Mağaza ID bilgisi hatalı olabilir. Hepsiburada panelinizde bulunan Entegrasyon sayfasındaki Entegratör bilgileri kısmındaki Mağaza ID'yi kopyalayıp bu ekrandaki Hepsiburada Mağaza ID kısmına yapıştırarak kaydet işlemini tekrar deneyebilirsiniz.

2-Hepsiburada panelinizde bulunan Entegrasyon sayfasındaki Entegratör bilgileri kısmında ikas_dev Entegratör kullanıcı adı eklenmemiş olabilir. Hepsiburada panelinizde Entegratörlerim kısmından ikas_dev'i ekleyip aktif duruma geçtikten sonra kaydet işlemini tekrar deneyebilirsiniz.

3-Hepsiburada Servis Anahtarı bilgisi hatalı olabilir. Hepsiburada panelinizde bulunan Entegrasyon sayfasındaki Entegratör bilgileri kısmında Servis Anahtarıbilgisini kopyalayıp bu ekrandaki Hepsiburada Servis Anahtarı kısmına yapıştırarak kaydet işlemini tekrar deneyebilirsiniz.

4-Hepsiburada panelinizde gerekli Webhook tanımları yapılmamış olabilir. Gerekli Webhook tanımlarını yaptırmak için; -Hepsiburada panelinizde, Yardım Merkezi ekranındaki Talepler kısmındaki API Entegrasyon başlığı altındaki API Entegratör Yetkilendirme İşlemleri bölümüne tıklayın.

Açılan ekranda kişisel bilgilerinizin istendiği bir form çıkacak. Bu formdaki ad, soyad, e-posta ve telefon bilgilerinizi girin.

Alt Neden Seçiniz kısmında, Yetkilendirme İşlemleri seçeneğini seçtikten sonra, Konu kısmına ikas_dev yetkilendirme yazınız. En son olarak mesaj kısmına aşağıdaki metnin tamamını yapıştırın;

Merhaba,

Canlı ortam için ikas_dev entegrasyon firmasının hesabına mağazamızın yetkisini verip aşağıdaki endpointlere gerekli Webhook tanımlarını yapabilir misiniz?

Webhook Basic Auth:

User: ikas_user

Şifre: 9H6k-ENf+y5Z^!_Ns3w!

hepsiburada.ikasapps.com/api/webhook/hb/orders

hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/intransit

hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/deliver

hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/undeliver

hepsiburada.ikasapps.com/api/webhook/hb/lineitems/{lineitemid}/cancel

hepsiburada.ikasapps.com/api/webhook/hb/packages

hepsiburada.ikasapps.com/api/webhook/hb/packages/{packagenumber}/unpack

hepsiburada.ikasapps.com/api/webhook/hb/{0}/orders/{1}/shippingaddress

Çok teşekkürler.

Formu gönderdikten sonra, Hepsiburada tarafından size Webhook tanımlarınızın yapıldığına dair olumlu mail döndükten sonra, kaydet işlemini tekrar deneyebilirsiniz.

Bir Hepsiburada mağazam ile entegrasyonum var. İkinci bir Hepsiburada mağazam daha var. ikas’tan ürünleri ikinci Hepsiburada mağazama göndermek istiyorum. Eğer mümkün olursa entegrasyonun sağladığı karşılıklı stok fiyat bilgisinin çalışmasını istiyorum. Ancak bu esnada birinci Hepsiburada mağazam ile entegrasyon sona ermesin de istiyorum. Yapılabilir mi?

Hayır yapılamaz. Bir ikas mağazasına ikinci bir Hepsiburada entegrasyonunu yapamamaktayız. Bu işlemin yapılması gerektiği durumlardaysa, aracı bir entegratör firma bu konuda sizlere destek verebilir.
ikas’ta veya Hepsiburada’da ürün görsellerimi değiştirdiğimde karşı platformda da görsellerim değişir mi?

Hayır. ikas Hepsiburada entegrasyonunun müdahale ettiği alanlar arasında ürün görselleri yok. ikas’tan kaynaklı Hepsiburada’da bulunan herhangi bir üründe görsel değişikliği olmayacaktır. ikas ve hepsiburada arasındaki entegrasyonda dinamik akış olan veriler şunlardır: Fiyatlar - Stoklar - Hepsiburada kargo barkodları ve kargo statüleri - Eğer ikas üzerinden fatura sistemi kullanılıyorsa fatura bilgileri - Satışa açıklık durumu
Ürünüm Hepsiburada uygulamasında güncelleme almıyor. Ürünün satış kanalı açık, ikas ve Hepsiburada’da barkod numaraları aynı diğer ürünlerinin hepsi güncelleniyor ama bu üründe güncelleme olmuyor neden olabilir?

Fiyat listesine ürün için fiyat girilmemesinden dolayı bu sorun kaynaklanıyor olabilir. Sorunun teşhisi için ikas panelinizden Uygulamalar > Uygulamalarım > Hepsiburada > ürünler yolunu izleyerek ilgili ürünü bulduktan sonra fiyat güncellemesi geçmişi alanına tıkladığınızda açılan geçmiş bölümünden kontrol edebilirsiniz.

HepsiBurada’dan ürünleri, ikas'ta bulunan ürünler ile çakışmasını engelleyerek nasıl çekebiliriz? ikas tarafına ürünler geldikten sonra otomatik olarak satışa geçer mi?

ikas HepsiBurada uygulaması içerisinden Ürünler > İşlemler > Ürünleri HepsiBurada’dan İçe Aktar > HepsiBurada’daki ürünlerimi ikas’ta yeni ürün olarak oluşturmak ve ikas’taki barkodları aynı olan ürünleri otomatik eşleştirmek istiyorum. Bu sayede aynı barkodlu ürünlerin tekrardan ikas’ta oluşmasını engelleyebilirsiniz. (3. seçenek) ile çekebiliriz. Bu işlemi yaptıktan sonra HepsiBurada’dan gelen ürünler E-Ticaret sitesinde satışa kapalı olarak gelecektir. Ürünler sayfasından satışa açılması gerekir. Satışa açma işleminde isterse teker teker, toplu işlemlerle satış kanalı açılabilir ya da "Dışa Aktar" seçeneği ile dosya üzerinden güncelleyebilmek mümkündür.

Hepsiburada