Teklif Oluştur

Yeni bir teklif (offer) kaydı oluşturur. Dijital ürünler için aynı request'te kod listesi de gönderebilirsiniz.

POST/v1/offersscope:OffersWrite

Request body

{
  "variantId": "01H8L9M1...",
  "price": 100.00,
  "discountedPrice": 95.00,
  "quantity": 250,
  "lowStockThreshold": 10,
  "isActive": true,
  "allowBackorder": false,
  "backorderLimit": null,
  "codes": ["AAAA-BBBB-CCCC", "DDDD-EEEE-FFFF"]
}

Alanlar

Alan	Tip	Zorunlu	Açıklama
`variantId`	string	evet	Katalog variant ID'si
`price`	decimal	evet	Asıl fiyat, >= 0
`discountedPrice`	decimal	opsiyonel	İndirimli fiyat, >= 0
`quantity`	int	evet	Mevcut stok, >= 0
`lowStockThreshold`	int	opsiyonel	Düşük stok uyarı eşiği
`isActive`	bool	evet	Hemen yayında olsun mu
`allowBackorder`	bool	evet	Stok bitince ön sipariş alınsın mı
`backorderLimit`	int	koşullu	`allowBackorder=true` ise zorunlu, > 0
`codes`	string[]	opsiyonel	Dijital ürün kodları (varyant türüne bağlı)

Yanıt

201 Created

Location: /v1/offers/01H8M2K6X7P9...

Body

{
  "id": "01H8M2K6X7P9...",
  "sellerId": "01H8K...",
  "variantId": "01H8L9M1...",
  "productName": "Steam 100 TL Cüzdan Kodu",
  "sku": "STEAM-WALLET-100",
  "price": 100.00,
  "discountedPrice": 95.00,
  "quantity": 250,
  "isActive": true,
  "allowBackorder": false,
  "createdAt": "2026-05-13T12:34:56.789Z",
  "updatedAt": null
}

Hata kodları

Code	Anlam
`400`	Validasyon hatası — bkz. `errors`
`403`	`OffersWrite` scope eksik
`409`	Bu variant için zaten teklif var
`422`	Domain validation (örn. dijital ürün için kod gerekli)

Idempotency önerilir

Network timeout sonrası double-creation'ı önlemek için Idempotency-Key header'ı ekleyin.