Fiyat Stok Güncelle

Bu metod, bir ürünün stok ve fiyat gibi belirli alanlarını güncellemek için kullanılmaktadır. "Dikkat Edilmesi Gereken Kurallar" alanındaki uyarılara dikkat edilmesi gerekmektedir. Genel olarak, güncellenmesi gereken alanlar dışındaki alanların gönderilmesine gerek yoktur. Aynı durum varyantlar için de geçerlidir; yalnızca güncellenmesi gereken varyant gönderilmelidir.

• İşlem sonunda sistem tarafından üretilen bir tracking_id değeri alınmaktadır. Bu ID'yi GetProductsTrackingResult'ta kullanarak işlem sonucunu ürün bazında takip edebilirsiniz.

Endpoint Bilgileri

• URL: `https://integration-api.pttavm.com/api/v1/products/stock-prices
• HTTP Metodu: POST
• header : Api-Key zorunlu
• header : access-token zorunlu
• header : Content-Type: application/json

Dikkat Edilmesi Gereken Kurallar

• Boş ürün listesi gönderilemez.
• Tek bir istekte 1000'den fazla ürün gönderilemez.
• Aynı istek 5 dakika içinde tekrar gönderilemez.
• Barkodsuz ürünler işleme alınmayacaktır. Aynı barkodun bir talep içinde birden fazla kez gönderilmediğinden emin olmalısınız (aynı barkoda sahip birden fazla kayıt gönderilirse, sonuncusu dikkate alınacaktır).
• Barkod 250 karakteri geçmemelidir.
• Ürünler için belirtilen alanlardan en az birinin güncellenmesi zorunludur: stok, fiyat, kdv oranı veya aktivite durumu.
• KDV 0, 1, 10 veya 20 değerlerini alabilir. Sağlanmazsa, ürün güncellemeleri sırasında fiyat hesaplamalarında önceki KDV oranı kullanılır.
• KDV hariç veya KDV dahil fiyat bilgisi gönderilecekse değer 1'den büyük olmalıdır. Hem KDV hariç hem de KDV dahil fiyat bilgisi birlikte gönderilecekse KDV hariç fiyat öncelikli olacaktır.
• İndirim 70'i geçmemelidir. Negatif bir değer gönderilirse, 0 olarak ayarlanır. Gönderilmezse (isteğe bağlıdır), 0 olarak kabul edilir. Ancak, sağlanırsa, değeri 0 olarak kaydedilir, KDV hariç fiyat aşağıdaki formül kullanılarak ayarlanır.
  VATExcludedPrice = VATExcludedPrice * (1 - (Discount / 100))
• Stok değeri 0 ile 9999 arasında olmalıdır. Bu aralığın dışındaysa sınırlandırılacaktır (sıfır altında bir değer gönderilirse 0, üstündeyse 9999 olarak kabul edilir.)
• Bir ürünün varyantları varsa ve bir güncelleme gerekiyorsa, varyantları örnek talepte gösterildiği gibi göndermelisiniz. Varyantların toplam stoğu ana ürünün stoğu olarak ayarlanacaktır. Varyantlar için güncelleme gerekmiyorsa, bunları göndermeye gerek yoktur. Hiçbir varyant gönderilmezse, ürünün hiçbir varyantı silinmeyecektir!
• Ürün başına maksimum 100 varyant gönderilebilir.
• Toplam varyant stoku 9999'u geçmemelidir.
• Ürün ve varyant kombinasyonunun toplamı en az 1 olmalıdır.
• Ürün aktivasyon durumu, girilen değere göre güncellenecektir; gönderilmediği takdirde güncelleme yapılmayacaktır.
• Kilitli ürünler güncellenemezken, kilidi açılmış ürünler güncellenebilir. Kilitleme nedeniyle güncellenemeyen tüm ürünler için bir uyarı mesajı sağlanacaktır.
• İsteklerinizde gibi null değerler gönderirken, "i" etiketleriyle XML etiket yapısını kullanmanız gerekir. Aksi takdirde, şu hata mesajını alırsınız: An error occurred when verifying security for the message.

Örnek Servis İsteği

curl http://integrator-core-api-test.rancher.pttavm.com/api/v1/products/stock-prices \
  --request POST \
  --header 'Api-Key: ' \
  --header 'Access-Token: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "items": [
    {
      "barcode": null,
      "active": null,
      "quantity": null,
      "priceWithoutVAT": null,
      "priceWithVAT": null,
      "vatRate": null,
      "discount": 1,
      "variants": [
        {
          "quantity": null,
          "price": null,
          "attributes": [
            {
              "definition": null,
              "value": null
            }
          ]
        }
      ],
      "isCargoFromSupplier": null
    }
  ]
}'

Örnek Servis Cevabı

{
  "countOfProductsToBeProcessed": 1,
  "trackingId": null,
  "success": true,
  "message": null
}

Servis Cevap Parametreleri