Entegrasyon sürecinde karşınıza çıkabilecek sorunlarla ilgili bazı soruların cevabını aşağıda bulabilirsiniz.
Varyant ekleme kısmında bir ürünün bir varyantında birden fazla özellik olabilmektedir. Örneğin; bir giyim ürününün yalnızca sarı renginin hem XL bedeni hem L bedeninin bulunması gibi bir durum söz konusu olduğunda bunu nasıl yapacağız?
{ Renk: kırmızı, Beden: XL, Price:.. ... } şeklinde olacak
Ürün gönderim süreçlerinde bir ürün için çok fazla istek yapılmakta bu da günlük 1000-2000 stok güncellemesi yapan müşterilerde çok fazla network yükü oluşturmaktadır. Bu konu ile ilgili bir çalışmanız mevcut mudur?
Henüz böyle bir özellik sistemimizde mevcut değil. Yeni versiyonda toplu işlem için değişiklik yapmak planlarımız arasındadır.
Sistem içerisinde varyantlı bir ürünün price ve stock bilgilerini güncelleyebilmek için hangi end-point kullanılmalıdır?
https://sandbox-api.allesgo.com/v1.0/product/set-variants/store/:storeId?access_token adresinden istediğiniz ürünün varyantında değişiklik yaparak kullanabilirsiniz.
Canlı ortama test amaçlı mağaza açtım ve ürün gönderimi yaptım. Açtığım bu mağaza üzerinde bir veya iki test siparişi oluşturma imkânınız var mı?
Test ortamında sipariş oluşturabiliriz ama canlı ortamda sipariş oluşturulamamaktadır. Kendi test ürününüze sipariş verebilirsiniz ancak daha sonra faturalandırmamak için siparişi iptal etmemiz gerekecektir.
Sipariş veren müşterinin bilgilerine erişme imkânımız var mı?
Müşteri bilgisine erişmek için servis üzerinden siparişi onaylamanız gerekmektedir.
Sipariş ve ürün için vergi oranını öğrenmek adına herhangi bir parametre mevcut mudur?
Siparişi onayladıktan sonra fatura bilgileri de dönecektir. Oradan vergi oranını kontrol edebilirsiniz.
Ürünleriniz kategori bazlı mı KDV'lendiriliyor?
Evet kategori bazlı KDV'lendiriliyor. Dokümanda da vat alanıyla görüntülenmektedir.
Varyant alanına bir unique veri yazıyorum. Yazdığım bu unique değeri bana siparişte dönmüyor. Bu sebeple stok düşürmek zor oluyor çözüm öneriniz nedir?
Code alanını siparişe ekledik. Ama code alanı varyant eklerken zorunlu değildir. O yüzden varyant ekleme sonucunda dönen varyant ID bilgisini tutarsanız daha mantıklı olacaktır.
Ürün fiyatını güncelledim ama sitede gözükmeme sebebi nedir?
Sitede ürün detayı ve fiyatların yansıması yarım saati bulabilmektedir.
Kargo takip numarası, kargo takip kodu ve kargo takip linkini siparişte kargolanan bilgilerde görüntüleyemedik. Bu bilgiler sipariş datanızdan gelmekte midir? Eğer geliyorsa hangi sipariş numarasında görüntüleyebiliriz?
Sipariş bilgilerinin alınması için kullandığımız bu end-point'den https://sandbox-api.allesgo.com/v1.0/order/store/:storeId?status=4&start_date=1675198800&end_date=1677531600&{{access_token}} istek attığınızda görüntüleyebilirsiniz.
Kuruş hanesi olan fiyatı nasıl göndermeliyim?
Fiyatlar kuruş bazlı olduğundan ürün fiyatı gönderirken 100 ile çarpmanız gerekmektedir.Örneğin: price alanında 10 lira göndermek için 1000 yazmanız gerekmektedir.
Ürün Değer-Özellik Verileri'ni sitenizdeki örneğe göre yapıyorum fakat hata alıyorum.Yardımcı olabilir misiniz?
Değer özellik olarak allesgo değer özelliklerini kullanmanız lazım. Property ve options alanının ID olması gerekmektedir.Bir kategoriye ait değer özellikleri https://developers.allesgo.com/docs/v1.0/category/category#993b7830432daf7cb772c66f9850d04dd851e6fe servisinden alabilirsiniz
Dokümanda incelediğim üzere sipariş iptal-kabul end-pointinde order_numbers parametresinin açıklaması 'Sipariş ID'lere göre belirlersiniz' şeklindedir. Fakat siparişleri çektiğimiz end-point içerisinde ve dokümanda sipariş ID’leri bulunmamaktadır. Bu problemi nasıl çözeceğim?
Sipariş bilgilerinin alınması end-pointinden order number'ı alabilirsiniz ve sipariş iptal-kabul end-pointinden body de şu şekilde { 'order_numbers':['4034-160'],'reason':'deneme} gönderirseniz response success dönecektir.
Order'ı order ID ile nasıl sorgulayabiliriz?
orderCode parametresi ile yapabilirsiniz
Barkodlaştıracağımız değer olarak önem arz eden kargo takip barkodu nedir?
Shipping_discount_code
Ana kategorilerileri listelemek istediğimizde hata alıyoruz nasıl yapmamız doğru olacaktır?
Kategori özellikleri, ana kategorilere göre değil en alt kategoriye göre yapılmaktadır.Bu doğrultuda sorgu yapılması gerekmektedir.
Kendi kargo anlaşması yaptığımız firmalar ile sizi beslememiz gerektiğinde siparişi kargolandı durumuna biz mi geçiriyoruz? Kargonun “tamamlandı” durumuna geçmesi aşamasını ise siz otomatik mi gerçekleştiriyorsunuz?
Kargolandı durumuna siz geçiriyorsunuz. Tamamlandı seçeneğine sistem otomatik geçiyor kargolandı durumundan sonra bir şey yapmaya gerek kalmıyor.
Sistemde varyantlı ürün oluşturma işlemini nasıl gerçekleştireceğim?
Belirlemiş olduğunuz ürünün ID'sine varyant oluşturmak için https://sandbox-api.allesgo.com/v1.0/product/set-variants/store/:storeId?{{access_token}} adresine body e bu şekilde ekleyerek post atarsanız işlem gerçekleşecektir.{'product_id': '63e0b536173e281cb8b83bb6','variants': [ { 'Renk': 'Kırmızı', 'Beden': '37', 'price': '2500','stock_count': '25','code': 'test'}
Allesgo entegrasyonumuzu sunuculara yükledik tüm müşterilere açacağız fakat entegrasyon sürecinde müşterilerimize sunduğumuz rapor var.Bu rapor da kullanılmak üzere şu bilgiye ihtiyacım var ürünlerin onay süreci nasıl işlemekte? Gönderilen ürün hemen yayınlanıyor mu bir onay süreci var mı?
Herhangi bir onay süreci yok direkt onaylanıyor.
Ürünlerin KDV oranları için Allesgo ürün api ucundan vergi oranları için bir parametreye ihtiyacımız var.Ayrıca sipariş ucundan da bizim tarafımızdan siparişlerin faturalandırılması için alıcı isim, adres, il ve ilçe bilgilerine ihtiyacımız var.Bu bilgileri nasıl öğrenebiliriz?
Sipariş onaylama servisi ile siparişi onayladıktan sonra isim,adres,il ve ilçe bilgilerine erişilebilmektedir.
Sipariş onaylanma süreci nasıl gerçekleşmektedir? Hangi durumda sipariş onaylandı yapılmalı? Yeni Sipariş var ise mağaza bunu onaylamalı mı?
Alıcı tarafından ilk sipariş verildiği an sisteme düşen siparişin durumu yeni sipariştir.Tedarikçi bu siparişi gönderecek ise siparişin durumunu onaylandıya alır.Ürünü kargoladıktan sonra kargolandı aşamasına alır.Bu şekilde süreci devam eder.Tedarikçi ürünü tedarik edemeyecekse yani siparişi gönderemeyecekse yeni sipariş durumunda ki siparişi reddeder.
Modelleri çekmeye çalıştığımda boş geliyor.Fakat ürün ekleme için model ID zorunlu olarak ifade edilmiş.Ne yapmam gerekmektedir?
Model ID 'yi string bir değer girmeniz yeterli olacaktır.
Product_code uniq mi?
Product_code bizimle ilgili değil dolayısıyla bizim için uniq olması gerekmemektedir. Ama ürün ID'si mevcut .ID'si üzerinden işlem yapabilirsiniz.
Varyant fiyatı ürün güncelleme içinde yapılabilir mi?
Hayır yapılamaz.
Invoices kurumsal fatura bilgisi oluşuyor mu?
Evet oluşuyor.
Discount amount KDV dahil mi ?
Evet KDV dahil fiyatı
Kargo şablonu kaydederken suitable_cities kısmında Allesgo daki illerin ID'lerini mi yollamam gerekiyor? Yoksa herhangi bir string ifade kabul ediyor musunuz ?
Büyük harflerle herhangi bir string değeri yazarsanız olur.Hiç belirtmediğiniz takdirde tüm Türkiye'ye gönderime açmış olursunuz.
Aynı anda 2-3 kişi çalışıp token ürettiğimizde eskisi iptal mi oluyor.Expire süresi ne kadar?
Expire süresi 6 saat.Aynı IP üzerinden bir token üretiliyor o yüzden aynı IP üzerinde çalışıyorsanız aldığınız token ı birbirinizle paylaşmanız daha sağlıklı olacaktır.Çünkü biriniz token ürettiğinde diğeri iptal olacaktır.
Ürünü aynı bilgilerle gönderince ürünü mükerrer açıyor. Bu beklediğiniz bir durum mudur ? Ürünü unique olarak belirleyen değeriniz nedir ?
Evet beklediğimiz bir durum, siz mükerrer göndermek istiyorsanız gönderebilirsiniz. Product_id üzerinden biz ayırt ediyoruz.
Birden fazla siparişin geldiği ve içerisinde birden fazla paketin bulunduğu durumu test etmeye ihtiyacım var bu şekilde test siparişi mevcut mu ?
Bu şeklide sipariş mevcut örnek “code”:”4005”
Ürün listeleme end-point'ini kullanarak sipariş içerisindeki ürünleri test için listelemeye ihtiyacım var nasıl yapmalıyım?
Paketlerin içerisindeki product_id ile ürünleri listeleme işlemini yapabilirsiniz.
Ürüne varyasyon ekledikten sonra fiyat ve stok da güncelleme yaptığımda üründeki varyasyonlar siliniyor.Varyasyonlar silinmeden stok ve fiyat güncellemesini nasıl yapacağım?
Varyantları tekrar set etmeniz gerekmektedir. Ürün update ini sadece güncellemek istediğiniz alana gönderirseniz yeterli olacaktır.Ürün değiştirdiğinizde varyantlarda da değişiklik yapılabileceğini öngördüğümüz için varyantları tekrar set etmenizi beklemekteyiz.
Yeni kargo şeması oluşturma kısmında body içerisinde suitable_cities’i nasıl göndermeliyim?
'suitable_cities':['Bursa','Ankara'], şeklinde gönderebilirsiniz.
Dokümanınızda mağazaya ait ürünleri listeleyebilen method bulunuyor ancak tekli ürün de listeleyebileceğimiz bir method var mı?
Ürünleri filtreleme kısmında parametre olarak ids eklenip ürünün product_id bilgisi yazılarak istek atıldığında direkt istenilen ürün gelmektedir.
Ürünün stoğunu sıfırladığımızda, ek olarak varyasyonlarında stoğunu sıfır olarak güncellememiz gerekir mi ? Yoksa sadece ana ürünün stoğunu sıfırlamamız yeterli midir?
Yeterlidir.
Aynı ürünün farklı varyasyonları için 2 farklı ürün oluşturuyorum bir ürünün altındaki varyasyon ayrı kategori ve özellikler, diğer ürüne farklı kategori ve özellikler, ürün bilgileri aynı sadece category id değiştirmeye çalışıyorum ama sucess dönmesine rağmen değişmiyor?Category_id değiştirilmesine izin verilmiyor mu ?
Ürün ekledikten sonra güncelleme işleminde category_id değiştirimesine izin verilmiyor..
Mağazamızın birinde ürünlerin tekrar ettiği bilgisi geldi.Kontrol ettiğimde mükerrer ürünlerde mağaza ürün kodları aynı olmasına rağmen tekrar ürün oluşmuş görünüyor. ?
Sistemimizde mağaza ürün kodu tekil değildir. Mağazalar aynı kodla istedikleri kadar ürün ekleyebilirler. Bu konuda herhangi bir ksııtlamamız yoktur. Ürün API üzerinden eklendikten sonra size allesgo tarafından unique bir ID bilgisi döner. Bu id ile ürün eşleştirme yapmanız beklenmektedir. Mağaza ürün kodu allesgo tarafında eşleştirme için kullanılmamakta.