IdeaSoft Altın API
IdeaSoft, Türkiye'de yaygın kullanılan köklü e-ticaret altyapılarından biridir.
IdeaSoft, Türkiye'de yaygın kullanılan köklü e-ticaret altyapılarından biridir. Hasfiyat, IdeaSoft entegrasyonuyla altın ürün fiyatlarınızı canlı kura bağlar; tampon ve volatilite eşikleriyle gereksiz güncellemeleri önler ve fiyatları otomatik aktarır. IdeaSoft mağazanızda altın fiyat yönetimini otomatikleştirerek zamandan tasarruf sağlarsınız.
IdeaSoft 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
IdeaSoft mağazasında canlı kura göre otomatik fiyat Alış / satış marjı ve emtia bazlı ayar Tampon ve volatilite eşiği ile kontrollü yazma Köklü altyapıyla uyumlu otomasyon Kilitli, güvenli tek panel entegrasyonu
IdeaSoft mağazanıza bağlanma
IdeaSoft, mağazanızın kendi alan adı altında bir yönetim API'si sunar. Hasfiyat, uygulama kimliği ve gizli anahtarınızla mağazanızdan bir erişim jetonu alır ve sonraki tüm isteklerde bu jetonu kullanır.
Uç nokta mağazaya özel olduğu için bağlantı bilgilerine mağaza adresinizi de girmeniz gerekir. Bilgiler şifreli saklanır ve yalnızca istek üretilirken çözülür.
Jetonun süresi ve otomatik yenileme
Alınan jeton belirli bir süre geçerlidir. Hasfiyat süreyi izler ve dolmadan yeni jeton alır; böylece uzun süren senkronların ortasında yetki hatası oluşmaz.
Yenileme başarısız olursa işlem başlatılmaz ve panelde açık bir hata gösterilir. Sessiz başarısızlık, fiyat entegrasyonlarında en tehlikeli hata sınıfıdır ve bilinçli olarak engellenmiştir.
Altın ürünlerini kura bağlamak
Her ürüne bir emtia ve gramaj atarsınız. Örneğin 5 gram 22 ayar bir künye, 22 ayar kuru her değiştiğinde yeniden fiyatlanır.
Hesap sırası ham maliyet, yüzde kâr, sabit işçilik ve güvenlik marjı şeklindedir; sonuç yukarı yuvarlanır. İşçiliği ayrı tutmak, gramajı küçük ama emeği yüksek ürünlerde kârın korunmasını sağlar.
Gereksiz güncellemeyi önlemek
Altın kuru gün boyunca sürekli oynar. Her oynamada mağazanıza yazmak, hem sunucunuzu hem de kotanızı gereksiz meşgul eder.
Tampon eşiği, fiyat farkı belirlediğiniz sınırı aşmadıkça gönderimi durdurur. Böylece yalnızca anlamlı değişimlerde yazma yapılır.
Ani yükselişe karşı kalkan
Kur sert yükseldiğinde mağazanızın önbelleği eski fiyatı kısa süre daha gösterebilir. Bu aralık zarar riskidir.
Volatilite kalkanı eşik aşıldığında ürünü geçici olarak satışa kapatır ve fiyat yansıdıktan sonra açar.
Kurulum kontrol listesi
Mağaza adresi, uygulama kimliği ve gizli anahtar girilir; bağlantı doğrulanır. Ardından ürünler listelenir ve eşleme yapılır.
Emtia–gramaj tanımı ve tampon eşiği ayarlandığında entegrasyon hazırdır. Eşlenmemiş ürünler kapsam dışında kalır.
IdeaSoft mağazasında altın kategorisini kurgulamak
Ürünlerin ağırlık bilgisinin yapısal bir alanda tutulması, otomatik fiyatlamanın ön koşuludur. Ağırlığı yalnızca açıklama metninde geçen ürünler eşlenemez.
Eşleme sırasında her ürüne emtia ve gramaj atadığınızda, bu bilgi Hasfiyat tarafında saklanır; mağaza tarafındaki alanları değiştirmeniz gerekmez.
Performans ve sunucu yükü
Fiyat güncellemesi mağaza sunucunuza istek üretir. Tampon eşiği sayesinde bu istekler yalnızca anlamlı kur değişimlerinde oluşur.
Eşiği düşük tutmak güncelliği artırır ama yükü de artırır; yüksek tutmak tersini yapar. Çoğu kuyumcu için orta bir değer, güncellik ile yük arasında iyi bir denge kurar.
Tampon eşiğini nasıl seçmelisiniz?
Tampon eşiği, fiyat farkı hangi seviyeyi aştığında güncelleme yapılacağını belirler. Düşük bir eşik güncelliği artırır ama istek sayısını da yükseltir; yüksek bir eşik tam tersini yapar.
Pratikte çoğu kuyumcu için orta bir değer iyi sonuç verir: kur gün içinde birkaç kez anlamlı biçimde hareket eder ve o hareketlerde güncelleme tetiklenir, aradaki küçük dalgalanmalar ise yok sayılır. Eşiği emtia bazında farklı tanımlayabilirsiniz.
Bir hesaplama örneği
12 gramlık 22 ayar bir bilezik ve 4.100 TL gram fiyatı ile ham maliyet 49.200 TL olur. Yüzde 5 kâr 2.460 TL, sabit işçilik 2.000 TL, yüzde 0,5 güvenlik marjı yaklaşık 268 TL ekler; listeleme 53.928 TL seviyesinde açılır.
Gram fiyatı 4.120 TL'ye çıktığında fark yüzde yarımın altında kalırsa ve eşiğiniz bunun üzerindeyse gönderim yapılmaz. Kur 4.180 TL'ye ulaştığında eşik aşılır ve fiyat yeniden hesaplanarak gönderilir.
Sık sorulan sorular
IdeaSoft'ta altın fiyatları otomatik güncellenir mi?
Evet, Hasfiyat IdeaSoft ürünlerinizi canlı altın kuruna bağlar ve otomatik günceller.
IdeaSoft altyapısıyla uyumlu mu?
Evet, köklü IdeaSoft altyapısıyla uyumlu çalışır.
Ne kadar zaman kazandırır?
Manuel fiyat güncelleme ortadan kalktığı için altın fiyat yönetimi tamamen otomatikleşir.
IdeaSoft için hangi bilgiler gerekli?
Mağaza adresiniz, uygulama kimliği ve gizli anahtarınız.
Jeton süresi dolduğunda ne oluyor?
Süre izlenir ve jeton dolmadan otomatik yenilenir; yenilenemezse işlem başlatılmaz.
İşçilik ücretini fiyata katabilir miyim?
Evet. Sabit ekleme alanı işçilik için ayrılmıştır ve yüzde kârdan bağımsız çalışır.
Ideasoft'un yerleşik saatlik altın feed'i neden yetersiz kalıyor?
Ideasoft'un yerleşik feed'i genellikle saatlik güncellendiği için altın gibi dakika dakika oynayan bir piyasada fiyatınız gerçek değerin gerisinde kalabilir. Hasfiyat altın API'si ise saniye-altı gecikmeyle çalışır ve WebSocket ile fiyatı anında iletir, böylece geç kalan fiyattan zarar etme riskini ortadan kaldırır. Ayrıca çoklu kaynak failover ile veri kesintilerinde bile fiyat akışı sürer.
Ideasoft'ta ürün fiyatını canlı gram altına nasıl endekslerim?
Hasfiyat altın API'sini Ideasoft mağazanıza bağlayarak fiyatları canlı gram altına endeksleyebilirsiniz. API güncel gram/has altın değerini gönderir, siz üzerine işçilik ve kârınızı ekleyerek satış fiyatını otomatik oluşturursunuz. Böylece piyasa oynadıkça Ideasoft'taki fiyat elle güncelleme gerektirmeden değişir.
Ideasoft için altın fiyat API entegrasyonu nasıl kurulur?
Kurulumda Hasfiyat API anahtarınızı Authorization header'ıyla gönderip istek atarsınız ve Ideasoft tarafında gelen gram altın değerine marjınızı ekleyen bir hesaplama kurarsınız. WebSocket dinleyicisi veya zamanlanmış görevle fiyatı güncel tutar, alış-satış fiyatını ayrı gösterebilirsiniz. Böylece yerleşik saatlik feed yerine gerçek zamanlı bir akışa geçersiniz.
Ideasoft'ta saatlik güncelleme yerine saniye-altı güncelleme alabilir miyim?
Evet, Hasfiyat WebSocket (Socket.IO) bağlantısı sayesinde Ideasoft mağazanıza fiyatları saniye-altı gecikmeyle iletebilirsiniz. Yerleşik saatlik feed'in aksine fiyat her değiştiğinde push edilir ve mağazanız anlık güncel kalır. Bu, hızlı hareket eden altın piyasasında fiyat farkından doğan zararı engeller.
Ideasoft'ta ayar bazlı altın ürünleri nasıl fiyatlandırılır?
Hasfiyat API'si 995, 916, 750 ve 585 gibi ayar bazlı değerleri ayrı sembollerle sunar, böylece 22, 18 ve 14 ayar ürünleri doğru fiyatlarsınız. Ideasoft'ta her ürün varyasyonunu ilgili ayar sembolüne bağlar, gramaj ve işçilikle çarparak satış fiyatını otomatik oluşturursunuz. Bu yöntem farklı ayardaki takıların tek üründe doğru listelenmesini sağlar.
Ideasoft'ta altın alış ve satış fiyatı ayrı gösterilebilir mi?
Evet, Hasfiyat API'si alış (buy) ve satış (sell) fiyatını ayrı alanlarda döndürür, bu yüzden Ideasoft ürünlerinde ikisini de gösterebilirsiniz. Altın alım-satımı yapan mağazalar için bu ayrım müşteriye şeffaf bilgi sunar. İki fiyatı ayrı etiketlerde veya tabloda kolayca listeleyebilirsiniz.
Ideasoft mağazamda kâr marjı ve işçilik nasıl eklenir?
API ham gram altın değerini verir; işçilik, milyem ve kâr marjınızı Ideasoft tarafında bu değerin üzerine ekleyerek satış fiyatınızı oluşturursunuz. Formülü ürün grubuna göre değiştirebilir, bilezikte yüksek işçilik, külçede düşük marj uygulayabilirsiniz. Piyasa oynasa bile marjınız sabit kaldığından kârlılığınız korunur.
Ideasoft altın API'de kaç veri kaynağı var ve biri düşerse ne olur?
Hasfiyat 14 veri kaynağını izler ve çoklu-kaynak failover ile biri düştüğünde otomatik olarak diğerinden fiyat almaya devam eder. Bu sayede Ideasoft mağazanıza akan fiyat kesintisiz kalır ve donmuş fiyatla satış riski ortadan kalkar. Kaynak geçişi arka planda saniyeler içinde gerçekleşir.
Ideasoft'ta USD, EUR ve GBP döviz fiyatlarını da çekebilir miyim?
Evet, Hasfiyat API'si USD, EUR ve GBP çapraz pariteleriyle serbest piyasa alış-satış kurlarını sunar. Ideasoft mağazanızda döviz ürünlerini veya bilgilendirmeleri bu verilerle güncel tutabilirsiniz. Altın ve döviz tek API'den geldiği için ikisini de tek entegrasyonla yönetirsiniz.
Ideasoft altın fiyat entegrasyonu ücreti nedir?
Hasfiyat altın API'si abonelik esaslı sunulur ve ücret çektiğiniz sembol sayısına, güncelleme yöntemine ve istek hacmine göre belirlenir. Ideasoft mağazanızın ihtiyacına uygun paketi seçip büyüdükçe sembol veya kaynak ekleyebilirsiniz. Güncel paket detayları için Hasfiyat üzerinden teklif alabilirsiniz.
Ideasoft'ta çeyrek altın gibi sarrafiye sembolleri destekleniyor mu?
Evet, Hasfiyat API'si çeyrek, yarım, tam, ata, cumhuriyet ve reşat gibi sarrafiye sembollerini ayrı ayrı sunar. Ideasoft'ta her sarrafiye ürününü ilgili sembole bağlayarak güncel fiyatla listeleyebilirsiniz. Böylece gram ürünlerle sarrafiye ürünleri aynı mağazada doğru fiyatlanır.
Ideasoft'ta kripto veya BIST fiyatı çekebilir miyim?
Hayır, Hasfiyat API'si kripto para ve BIST verilerini kapsamaz; odağı altın, döviz ve sarrafiyedir. Ideasoft mağazanız için gram/has altın, sarrafiye sembolleri ve USD/EUR/GBP kurlarını çekebilirsiniz. Kuyum ve döviz odaklı e-ticaret için gerekli tüm semboller mevcuttur.
Ideasoft özel matrah e-fatura ile altın satışı nasıl faturalanır?
Hasfiyat, altın ve sarrafiye satışlarında özel matrah esasına göre toplu e-fatura kesimini destekleyen bir entegrasyona sahiptir. Ideasoft siparişlerinizdeki altın kalemlerini bu boru hattına aktararak faturaları özel matrah kurallarına uygun ve toplu oluşturabilirsiniz. Böylece altın bedeli ile işçiliğin ayrıştığı faturalar mevzuata uygun kesilir.
IdeaSoft fiyatlarınızı otomatikleştirin
Altın ürünlerinizi canlı kura bağlayın, fiyatlar kendiliğinden güncellensin.