Stok & Fiyat API
ERP veya depo sisteminizdeki stok miktarlarını ve liste/satış fiyatlarını bağlı tüm pazaryerlerine yüksek hızlı toplu partiler (bulk batches) halinde iletin.
Asenkron Toplu Güncelleme (Batch) Akışı
Pazaryerleri toplu stok ve fiyat güncellemelerini kendi kuyruklarında işlediği için Armonika bu uçlarda HTTP 202 Accepted ve bir batch_id döndürür:
- 1. Paket Gönderimi (Maks 500 Kalem): Tek tek her varyant için istek atmak yerine değişen varyantları 500'lü diziler halinde POST /v1/inventory/bulk veya POST /v1/prices/bulk ucuna gönderin.
- 2. Sonuç Yoklama (Batch Polling): GET /v1/batches/{batch_id} ucuyla status alanının completed olmasını izleyin ve olası satır bazlı pazaryeri retlerini failures dizisinden okuyun.
/v1/inventory/bulkToplu Stok Güncelleme
SKU veya barkod bazında tek istekte en fazla 500 varyantın stok miktarını günceller ve bağlı satış kanallarına asenkron parti (batch) olarak dağıtır. Yanıtta dönen batch_id ile işlem sonucu takip edilir.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| Idempotency-Key | Header | string (uuid) | Opsiyonel | Ağ zaman aşımında aynı toplu stok paketinin iki kez kuyruğa alınmasını önleyen opsiyonel tekillik anahtarı. |
| channels | Body (JSON) | string[] | Opsiyonel | Hedef kanallar (boş bırakılırsa mağazadaki tüm aktif kanallara gönderilir). |
| items | Body (JSON) | Array<{ barcode?: string; sku?: string; quantity: number }> | Zorunlu | 1–500 adet stok satırı. Her satırda barcode veya sku zorunludur; quantity >= 0 tamsayı olmalıdır. |
Olası Hata Kodları
| HTTP | Hata Kodu | Açıklama & Çözüm |
|---|---|---|
| 422 | BATCH_LIMIT_EXCEEDED | Tek istekte 500'den fazla kalem gönderildi veya negatif stok değeri iletildi. |
/v1/inventory/bulk/v1/prices/bulkToplu Liste / Satış Fiyatı Güncelleme
Varyantların liste fiyatını (list_price / üstü çizili fiyat) ve indirimli satış fiyatını (sale_price) tek istekte topluca günceller. sale_price hiçbir zaman list_price değerinden büyük olamaz.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| channels | Body (JSON) | string[] | Opsiyonel | Opsiyonel hedef kanal listesi (örn. ['trendyol', 'hepsiburada']).Kanal bazlı farklı fiyat politikalarında kullanılır. |
| items | Body (JSON) | Array<{ barcode?: string; sku?: string; list_price: number; sale_price: number; currency?: string }> | Zorunlu | 1–500 adet fiyat güncelleme kalemi. |
Olası Hata Kodları
| HTTP | Hata Kodu | Açıklama & Çözüm |
|---|---|---|
| 422 | INVALID_PRICE_RELATION | sale_price değeri list_price değerinden büyük gönderildi. |
/v1/prices/bulk/v1/batches/{batch_id}Toplu İşlem (Batch) Sonucunu Sorgula
/v1/inventory/bulk veya /v1/prices/bulk çağrılarından dönen batch_id ile işlemin tamamlanma durumunu ve pazaryeri tarafından reddedilen satırların hata nedenlerini döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| batch_id | Path | string | Zorunlu | Toplu işlem kimliği (örn. bat_01JCPB2M4N6P8Q0R2S4T). |
/v1/batches/{batch_id}
