Stok ve fiyat senkronu

Hangi servisi kullanmalıyım?

Ürünü nasıl tanıdığınıza göre servis seçin. Ürün servisleri aktif Ürün Paketi gerektirir; paket yoksa 70018 döner.

Ürün kodu, ERP'nizdeki stok kodudur ve bir ürün kaynağı içinde tekildir. Hesabınızdaki ürün kaynaklarını ve kimliklerini GetProductSources ile alın.

Örnek: stok ve fiyatı ürün koduyla güncellemek

Varyantlı bir ürünün iki bedeninin stoğunu ve fiyatını tek çağrıda güncelleyen istek:

{
  "ApiCode": "API_CODE",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.90,
  "MarketPrice": 449.90,
  "Variants": [
    { "Code": "TSHIRT-RED-M", "Quantity": 15, "Price": 349.90 },
    { "Code": "TSHIRT-RED-L", "Quantity": 0, "Price": 359.90 }
  ]
}

Bilmeniz gereken kurallar

1. Kullandığınız tüm fiyatları her seferinde gönderin. Fiyat servisleri Price, MarketPrice ve Price2–Price5 alanlarının hepsini yazar; göndermediğiniz fiyat 0 olur. Aynı kural varyant fiyatları için de geçerlidir.
2. Varyantlı ürünlerde SetProductQuantityFromVariants: true gönderin. Bu alan olmadan yalnızca varyant stoklarını gönderirseniz ürünün kendi stoğu 0 olur. true olduğunda ürün stoğu varyantların toplamından hesaplanır.
3. Gönderdiğiniz miktar yeni satılabilir stoktur. StockMount o ana kadar düştüğü satış adetlerini sıfırlar. Stoğu 1'in altına inen ürün satışa kapanır.
4. Değerleri siz kontrol edin. API sıfır veya negatif fiyatı, negatif stoğu ya da satış fiyatından düşük piyasa fiyatını reddetmez. Bu tür değerler pazaryerine gönderilirken hata verir.
5. Stok servislerinde CurrencyId göndermeyin. Bazı stok servisleri bu alanı okuyup ürünün para birimini değiştirir.
6. UpdateProductQuantityByBarcode ek fiyatları da yazar. Bu servis Price2–Price5 alanlarını istekteki değerle değiştirir. Bu fiyatları kullanıyorsanız mevcut değerlerini de gönderin.

Pazaryerine ne zaman yansır?

Servis yanıtı, değerin StockMount'taki ürüne yazıldığını gösterir. Stok veya fiyat gerçekten değiştiyse ürünün aktif ilanları için güncelleme kuyruğa alınır ve pazaryerleri arka plandaki işlerle güncellenir. Aynı ürün için bekleyen bir güncelleme varsa yenisi eklenmez; en son değer gönderilir.

Yanıtı kontrol etmek

• Başarıda Result: true döner; Response içinde ürünün ProductId değeri ve güncellenen varyantlar bulunur.
• Ürün bulunamazsa Result: false, ErrorCode: "70005" ve ErrorMessage: "ProductNotFound" döner.
• Variants içinde eşleşmeyen öğeler hata vermeden atlanır. Hangi varyantların güncellendiğini yanıttaki listeden kontrol edin.

Öneriler

• Yalnızca değişen ürünleri gönderin. Tüm kataloğu düzenli aralıklarla baştan göndermek pazaryeri kuyruklarını gereksiz yere doldurur.
• Her çağrı tek bir ürünü günceller. Toplu güncellemelerde istekleri sırayla veya az sayıda paralel olarak gönderin ve her yanıtın Result alanını kontrol edin.
• Yeni bir entegrasyonu canlıya almadan önce birkaç test ürünüyle deneyin ve sonucu panelde ve pazaryerinde kontrol edin.