Fiyat

Ürün veya varyant fiyatını tekli ya da bulk olarak senkronize edin.

Endpointler

GET/prices/{product}Fiyat oku

PATCH/prices/{product}Fiyat güncelle

PATCH/prices/bulkToplu fiyat güncelle

Pricing API ne işe yarar?

ERP, muhasebe veya fiyat yönetim sisteminizdeki ürün fiyatlarını BYNovax mağazasına senkronize etmek için kullanılır.

Tek ürün fiyatını okuyabilir, güncelleyebilir veya bulk endpoint ile birçok ürün fiyatını birlikte gönderebilirsiniz.

Endpointler ve scope'lar

Endpoint	Scope
GET /prices/{product}	pricing:read
PATCH /prices/{product}	pricing:write
PATCH /prices/bulk	pricing:write

Fiyat alanları

Alan	Açıklama
price	Aktif satış fiyatı
compare_at_price	Varsa karşılaştırma / eski fiyat
currency	Para birimi; örneğin TRY

Tek ürün fiyat güncelleme

PATCH /prices/{product} write işlemidir. JSON body içerisine yeni fiyat değerlerini gönderin ve Idempotency-Key kullanın.

Fiyat değerlerini JSON string yerine number olarak göndermeniz gerekir.

Varyantlı ürün davranışı

Ürünün varyantları bağımsız fiyat taşıyorsa ürün seviyesindeki pricing endpointi yerine /products/{product}/variants/{variant}/price kullanılmalıdır.

Ürün seviyesinde yazma girişimi bu durumda 409 conflict ile reddedilebilir.

Bulk fiyat senkronizasyonu

Bir fiyat listesi veya toplu kampanya güncellemesi yapıyorsanız pricing/bulk endpointini tercih edin.

Bulk request item sayısını 500 veya altında tutun ve her mantıksal bulk operasyon için benzersiz Idempotency-Key kullanın.

Örnek entegrasyon akışı

ERP fiyatı değişti
        ↓
BYNovax product / variant eşlemesi bulundu
        ↓
price + compare_at_price + currency hazırlandı
        ↓
PATCH /prices/{product}
veya variant price endpointi
        ↓
Başarılı response kaydedildi

Sık hatalar

Durum	Kontrol
403	pricing:write scope var mı?
404	Product doğru tenant'a ait mi?
409	Ürün varyant bazlı fiyat mı kullanıyor?
422	Fiyat alanlarının tipi/değeri doğru mu?

Çalıştığını nasıl doğrularım?

PATCH başarılı dönüyor.
GET /prices/{product} güncel fiyatı gösteriyor.
Varyantlı ürünlerde doğru variant endpointi kullanılıyor.
ERP son başarılı fiyat senkronizasyonunu kaydediyor.

Pricing authoritative state modeli

Pricing endpointleri fiyat write authority'sidir. Product lifecycle veya bulk product lifecycle update üzerinden price, compare_at_price veya currency değiştirmeyin.

Product-level ve variant-level pricing ayrımını ERP eşleme katmanında açık biçimde saklayın.

Bulk pricing entegrasyon kuralları

Mevcut contractta bulk request item sayısını 500 veya altında tutun.
Her logical bulk price operasyonu için benzersiz Idempotency-Key kullanın.
Varyantın bağımsız fiyatı varsa variant pricing endpointini kullanın.
currency, price ve compare_at_price alanlarını pricing contractı üzerinden yönetin.
HTTP 200 tek başına batch içindeki her item'ın başarıyla işlendiği anlamına gelmeyebilir; response contractını değerlendirin.
ERP son başarılı fiyat state ve timestamp bilgisini saklamalıdır.

Pricing reconciliation

ERP price list değişti
        ↓
product_id / variant_id bulundu
        ↓
PATCH prices veya prices/bulk
        ↓
Response doğrulandı
        ↓
Gerekirse GET /prices/{product}
        ↓
ERP pricing checkpoint güncellendi