PrestaShop Altın API
PrestaShop, Avrupa'da yaygın, açık kaynak bir e-ticaret platformudur.
PrestaShop, Avrupa'da yaygın, açık kaynak bir e-ticaret platformudur. Hasfiyat, PrestaShop entegrasyonuyla altın ürün fiyatlarınızı canlı kura bağlar; tampon ve volatilite eşikleriyle fiyatları güvenle otomatik günceller. PrestaShop mağazanızda altın ürünlerinizi gram altına endeksleyerek fiyatları kurla uyumlu ve otomatik tutarsınız.
PrestaShop entegrasyonu hangi avantajları sunar?
Otomatik Güncelleme
Altın ürün fiyatları canlı kura göre otomatik senkronize edilir.
Tampon & Volatilite
Fiyat yalnızca anlamlı değişimde güncellenir; API limitleri korunur.
Marj Kontrolü
Emtia bazlı alış/satış marjıyla kârınızı koruyun.
Kilitli Yazma
Yalnızca eşlediğiniz ürünlerde güvenli, kontrollü güncelleme.
Öne çıkan özellikler
PrestaShop mağazasında canlı kura göre otomatik fiyat Gram altına endeksli fiyatlandırma Tampon ve volatilite eşiği koruması Açık kaynak altyapıyla uyumlu entegrasyon Kilitli, güvenli tek panel yönetimi
PrestaShop web servisi ile entegrasyon
PrestaShop, mağaza yönetimini kendi web servisi üzerinden sunar. Kimlik doğrulama, web servisi anahtarınızın kullanıcı adı yerine geçtiği, parolanın boş bırakıldığı Basic yöntemiyle yapılır.
Hasfiyat bu kurala uygun istek üretir. Anahtarın PrestaShop yönetiminden üretilmesi ve ürün kaynağına okuma-yazma yetkisi verilmesi yeterlidir.
Listeleme JSON, yazma XML
PrestaShop web servisinde ürün listesi JSON biçiminde istenebilirken, ürün güncellemesi XML gövdesiyle yapılır. Bu ikili yapı, entegrasyon yazarken en sık hata alınan noktadır.
Hasfiyat listeyi JSON olarak okur, güncellemede ise ürünün mevcut XML tanımını alıp yalnızca fiyat alanını değiştirerek geri gönderir. Diğer alanlar olduğu gibi korunur.
Neden mevcut tanım alınıp geri gönderiliyor?
PrestaShop'ta ürün güncellemesi kısmi değil bütünsel çalışır: gönderdiğiniz XML, ürünün yeni hâlidir. Eksik gönderilen alanlar silinebilir.
Bu yüzden Hasfiyat önce ürünün güncel tanımını okur, yalnızca fiyat düğümünü değiştirir ve tamamını geri yazar. Bu yaklaşım, açıklama veya kategori gibi alanların yanlışlıkla boşalmasını yapısal olarak imkânsız kılar.
Gram altına endeksli fiyat
Her ürüne emtia ve gramaj tanımlarsınız. Kur değiştiğinde ham maliyet yeniden hesaplanır; yüzde kâr, sabit işçilik ve güvenlik marjı sırayla eklenir.
Sonuç yukarı yuvarlanır, böylece hiçbir ürün hesaplanan tutarın altında yayına girmez.
Ani yükselişe karşı kalkan
Eşik aşıldığında ürün geçici olarak satışa kapatılır ve yeni fiyat yansıdıktan sonra açılır.
Önbellek kullanan PrestaShop kurulumlarında bu koruma, güncelleme ile görüntülenen fiyat arasındaki gecikmeyi güvenli hâle getirir.
Kurulum
PrestaShop yönetiminden web servisi anahtarı üretip ürün kaynağına yetki verirsiniz. Anahtarı ve mağaza adresinizi Hasfiyat'a girip bağlantıyı doğrularsınız.
Ardından eşleme, gramaj tanımı ve tampon eşiği ayarlanır.
PrestaShop web servisi anahtarını doğru yapılandırmak
Anahtar üretirken yalnızca ürün kaynağına okuma ve yazma izni vermek yeterlidir. Sipariş, müşteri veya ayar kaynaklarına erişim gerekmez.
Dar yetkili bir anahtar, olası bir sızıntının etkisini fiyat alanıyla sınırlar. Anahtarı istediğiniz an PrestaShop tarafından pasifleştirebilirsiniz.
Kombinasyonlu ürünler
PrestaShop'ta kombinasyonlar farklı gramajları temsil edebilir. Her kombinasyona kendi ağırlığını tanımladığınızda fiyat ayrı hesaplanır.
Kombinasyon kullanılmayan basit ürünlerde ise fiyat doğrudan ürün üzerinde güncellenir. İki yapı da desteklenir.
Bütünsel güncellemenin riski ve alınan önlem
PrestaShop'ta ürün güncellemesi kısmi değil bütünseldir: gönderdiğiniz tanım ürünün yeni hâli olur. Eksik gönderilen alanlar boşalabilir. Bu, entegrasyon yazarken en çok veri kaybına yol açan davranıştır.
Hasfiyat bu riski yapısal olarak ortadan kaldırır: ürünün güncel tanımı önce okunur, yalnızca fiyat alanı değiştirilir ve tamamı geri yazılır. Açıklama, kategori, resim bağlantıları ve diğer tüm alanlar olduğu gibi korunur.
Kombinasyonlu ürünlerde gramaj tanımı
PrestaShop'ta kombinasyonlar farklı gramajları temsil edebilir. Her kombinasyona kendi ağırlığını tanımladığınızda fiyat ayrı ayrı hesaplanır ve doğru sonuç üretir.
Kombinasyon kullanılmayan basit ürünlerde fiyat doğrudan ürün üzerinde güncellenir. Her iki yapı da desteklenir; eşleme sırasında hangi kaydın güncelleneceği otomatik olarak belirlenir.
Sık sorulan sorular
PrestaShop'ta altın fiyatları otomatik güncellenir mi?
Evet, Hasfiyat PrestaShop ürünlerinizi canlı altın kuruna bağlar ve otomatik günceller.
Ürünleri gram altına endeksleyebilir miyim?
Evet, ürünlerinizi gram altına endeksleyip kura göre otomatik fiyatlandırma kurarsınız.
PrestaShop ile uyumlu mu?
Evet, açık kaynak PrestaShop altyapısıyla uyumlu çalışır.
PrestaShop için hangi bilgiler gerekli?
Mağaza adresiniz ve ürün kaynağına yetkili bir web servisi anahtarı.
Güncelleme sırasında ürün açıklamam silinir mi?
Hayır. Ürünün mevcut tanımı okunup yalnızca fiyat alanı değiştirilerek geri yazılır.
Anahtara hangi yetkileri vermeliyim?
Ürün kaynağına okuma ve yazma yetkisi yeterlidir.
PrestaShop'ta ürün fiyatını canlı gram altına nasıl endekslerim?
Hasfiyat altın API'sini PrestaShop mağazanıza bağlayarak ürün fiyatlarınızı canlı gram altın kuruna endeksleyebilirsiniz. API, güncel gram/has altın değerini REST veya WebSocket üzerinden gönderir; siz de üzerine işçilik ve kâr marjınızı ekleyerek fiyatı otomatik hesaplatırsınız. Böylece piyasa oynadıkça mağazadaki fiyat elle güncelleme gerektirmeden değişir.
PrestaShop için altın fiyat modülü veya eklentisi var mı?
Evet, Hasfiyat altın API'si PrestaShop mağazalarına entegre edilebilir ve gram altın, sarrafiye ve döviz kurlarını mağazanıza besler. Entegrasyon REST API çağrısı veya WebSocket bağlantısıyla kurulur; teknik ekibiniz mevcut PrestaShop temanıza dokunmadan fiyat alanlarını API'ye bağlayabilir. Kurulum sonrası fiyatlar arka planda otomatik akmaya başlar.
PrestaShop altın API kurulumu nasıl yapılır?
Kurulum için Hasfiyat'tan aldığınız API anahtarını Authorization header'ında göndererek istek atmanız yeterlidir. PrestaShop tarafında ürün fiyatını hesaplayan bir fonksiyon yazıp gelen gram altın değerine işçilik ve kârınızı ekler, ardından bunu zamanlanmış görevle veya WebSocket dinleyicisiyle sürekli güncel tutarsınız. Alış ve satış fiyatı API'den ayrı geldiği için mağazanızda ikisini de gösterebilirsiniz.
PrestaShop'ta her ayar için ayrı fiyat nasıl gösterilir?
Hasfiyat API'si 995, 916, 750 ve 585 gibi ayar bazlı değerleri ayrı sembollerle sunar, böylece PrestaShop kombinasyonlarını (varyasyon) her ayara göre farklı fiyatlandırabilirsiniz. Her ürün varyasyonunu ilgili ayar sembolüne bağlar, üzerine gramajı ve işçiliği çarparak fiyatı otomatik oluşturursunuz. Bu sayede 22 ayar bilezik ile 14 ayar takı aynı üründe doğru fiyatla listelenir.
PrestaShop mağazamda altın fiyatları kaç saniyede güncelleniyor?
Hasfiyat API'si milisaniye ve saniye-altı gecikmeyle çalıştığı için PrestaShop mağazanız fiyatları neredeyse anlık alabilir. WebSocket (Socket.IO) bağlantısı kurarsanız fiyat her değiştiğinde push edilir ve elle yenileme gerekmez. Sadece REST kullanmayı tercih ederseniz istediğiniz aralıkta çekim yaparak güncelleme sıklığını kendiniz belirlersiniz.
PrestaShop'ta işçilik ekleyerek gram altın üzerine kâr koyabilir miyim?
Evet, API size ham gram altın değerini verir; işçilik, milyem ve kâr marjınızı bu değerin üzerine PrestaShop tarafında ekleyerek satış fiyatınızı oluşturursunuz. Formülü ürün grubuna göre farklılaştırabilir, örneğin bilezikte daha yüksek işçilik, külçede daha düşük marj uygulayabilirsiniz. Piyasa değişse bile marjınız sabit kaldığı için kârlılığınız korunur.
PrestaShop'ta altın alış ve satış fiyatını ayrı ayrı gösterebilir miyim?
Evet, Hasfiyat API'si alış (buy) ve satış (sell) fiyatını ayrı alanlar halinde döndürür, bu yüzden PrestaShop'ta ikisini de aynı üründe gösterebilirsiniz. Sarraflar ve altın alım yapan mağazalar için bu ayrım, müşteriye hem bozdurma hem satın alma değerini şeffaf sunmayı sağlar. İki fiyatı istediğiniz gibi ayrı etiketlerde veya tabloda listeleyebilirsiniz.
PrestaShop çoklu para birimiyle USD ve EUR altın fiyatlarını destekliyor mu?
Hasfiyat API'si USD, EUR ve GBP çapraz pariteleriyle birlikte gram altın ve ons XAU değerlerini sunar, dolayısıyla PrestaShop'un çoklu para birimi özelliğiyle uyumludur. Müşterinin seçtiği para birimine göre altın fiyatını ilgili kurdan hesaplatabilirsiniz. Böylece yurt dışına satış yapan mağazalar da doğru döviz karşılığını gösterir.
Fiyat kaynağı düşerse PrestaShop mağazam eski fiyatta mı kalır?
Hayır, Hasfiyat 14 farklı veri kaynağını izler ve çoklu-kaynak failover ile biri düştüğünde otomatik olarak bir diğerinden fiyat almaya devam eder. Bu sayede PrestaShop mağazanıza akan fiyat kesintisiz kalır ve donmuş ya da yanlış fiyatla satış riski ortadan kalkar. Kaynak geçişi arka planda saniyeler içinde gerçekleşir.
PrestaShop'ta kripto veya BIST fiyatı çekebilir miyim?
Hayır, Hasfiyat API'si yalnızca altın, döviz ve sarrafiye verilerine odaklanır; kripto para ve BIST hisse fiyatları kapsam dışıdır. PrestaShop mağazanız için gram/has altın, çeyrek-yarım-tam gibi sarrafiye ve USD/EUR/GBP kurlarını çekebilirsiniz. Kuyum ve döviz odaklı e-ticaret için ihtiyacınız olan tüm semboller mevcuttur.
WebSocket ile PrestaShop'ta anlık fiyat güncellemesi mümkün mü?
Evet, Hasfiyat Socket.IO tabanlı WebSocket bağlantısı sunar ve fiyat her değiştiğinde PrestaShop tarafına anında push eder. Bu yöntemle sürekli sorgu atmadan, saniye-altı gecikmeyle güncel fiyatı yakalarsınız. Yoğun oynayan piyasalarda mağazanın gerçek zamanlı doğru fiyatla kalmasını sağlar.
PrestaShop özel matrah e-fatura entegrasyonu altın satışında nasıl çalışır?
Hasfiyat, altın ve sarrafiye satışlarında özel matrah esasına göre toplu e-fatura kesimini destekleyen bir entegrasyona sahiptir. PrestaShop siparişlerinizdeki altın kalemlerini bu boru hattına aktararak faturaları özel matrah kurallarına uygun ve toplu şekilde oluşturabilirsiniz. Böylece işçilik ve altın bedelinin ayrıştığı faturalar mevzuata uygun kesilir.
PrestaShop altın API fiyatlandırması nasıl?
Hasfiyat altın API'si abonelik esaslı sunulur ve fiyatlandırma çektiğiniz sembol sayısına, güncelleme yöntemine (REST/WebSocket) ve istek hacmine göre belirlenir. PrestaShop mağazanızın ihtiyacına uygun paketi seçebilir, gerektikçe sembol veya kaynak ekleyebilirsiniz. Güncel paket detayları için Hasfiyat üzerinden teklif alabilirsiniz.
PrestaShop fiyatlarınızı otomatikleştirin
Altın ürünlerinizi canlı kura bağlayın, fiyatlar kendiliğinden güncellensin.