KUPA-350%100 pamuk, regular fit.
", "DispatchPeriod": 2, "Volume": 1, "VariantName1": "Renk", "VariantName2": "Beden", "Images": [ { "Url": "https://cdn.example.com/tshirt-001-1.jpg" }, { "Url": "https://cdn.example.com/tshirt-001-2.jpg" } ], "Variants": [ { "Code": "TSHIRT-001-BLK-M", "Barcode": "8690000000024", "Quantity": 10, "Price": 249.9, "VariantValue1": "Siyah", "VariantValue2": "M" }, { "Code": "TSHIRT-001-BLK-L", "Barcode": "8690000000031", "Quantity": 20, "Price": 249.9, "VariantValue1": "Siyah", "VariantValue2": "L" } ], "Specs": [ { "Name": "Materyal", "Value": "Pamuk" } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "Response": { "type": "integer", "description": "Yeni ürünün `ProductId` değeri. 70004 durumunda aynı kodlu mevcut ürünün kimliğidir." } } } } } ] }, "example": { "Result": true, "Response": 987654 } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProduct": { "post": { "operationId": "UpdateProduct", "tags": [ "Ürünler" ], "summary": "Ürünü güncelle", "description": "**Ürünü güncelle** — Mevcut bir ürünün bilgilerini, varyantlarını ve özelliklerini gönderdiğiniz değerlerle baştan yazar. Görselleri ve ürün kodunu değiştirmez.\n\nBu çağrı kısmi güncelleme değildir; ürünün tamamını yeniden yazar. Zorunlu alanlar ve 00003 mesajları `AddProduct` ile aynıdır (`ProductSourceId`, `CurrencyId`, `Price` > 0, `Code`, `Name`, `Category`). Gönderilmeyen isteğe bağlı alanlar temizlenir: `Barcode`, `Brand`, `Model`, `Subtitle`, `Code2`, `Mpn`, `SellerNote` ve `VariantName1`–`VariantName6` boşalır; `TaxRate`, `MarketPrice`, `Volume`, `Width`, `Length`, `Height`, `Weight` 0 olur; `DispatchPeriod` -1 olur; `Description` boşalır (`UpdateProductDescription: false` göndermediğiniz sürece). Önce `GetProduct` ile ürünü okuyup tüm alanları geri gönderin.\n\nYalnızca StockMount panelinde yönetilen bazı değerler de her güncellemede sıfırlanır: satış adedi (`SoldCount`), minimum satış fiyatı, ürün sayfası adresi, meta/SEO alanları, fatura adı ve garanti bilgisi. Güncellenen varyantların satış adedi de 0 olur.\n\nDeğişmeyenler: görseller (`Images` ve varyant görsel alanları yok sayılır; görseller için `UpdateProductImages`), `Price2`–`Price5` ve ürün kodu (`SetProductCode`).\n\nÜrün `ProductId` ile bulunur ve `Code` ürünün kaynaktaki mevcut kodu olmalıdır. Kod kaynakta hiç yoksa 70005 (`Message`: `There is no product with the given ProductId`), kod başka bir üründeyse `Result: false` ile 70004 (`Message`: `Product code does not exist`) döner. `UpdateProductByCode: true` gönderirseniz `ProductId` gerekmez; ürün `ProductSourceId` + `Code` ile bulunur, bulunamazsa 70005 döner. Bu iki hatada metin `ErrorMessage` değil `Message` alanındadır.\n\nDurum stoktan yeniden hesaplanır: `Quantity` 1'den küçükse 3 (durdurulmuş / stok yok), değilse 2 (değişti). Böylece `StopProduct` ile durdurulmuş bir ürün, stoğu 0'dan büyük gönderildiğinde yeniden aktif olur.\n\n`Variants` gönderirseniz varyantlar `Code` ile eşleştirilir: eşleşenler güncellenir, yeni kodlar görselsiz eklenir, listede olmayan mevcut varyantlar pasife alınır. Pasif varyantlar silinmez ve `GetProduct` yanıtında görünmeye devam eder. `Variants` boş veya gönderilmemişse varyantlara dokunulmaz. `Specs` gönderirseniz özellik listesinin tamamı değiştirilir; göndermezseniz mevcut özellikler kalır.\n\nBaşarılı güncellemede `Response` ürünün `ProductId` değeridir ve ürün, listelendiği aktif mağazalar için senkronizasyon kuyruğuna alınır. Bu çağrı 70013 (değişiklik yok) döndürmez; değerler aynı olsa da kayıt yeniden yazılır. Kategori otomatik oluşturma, uzunluk sınırları ve HTML temizliği `AddProduct` ile aynıdır.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProduct", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` ile aldığınız oturum kodu." }, "ProductId": { "type": "integer", "description": "Güncellenecek ürünün kimliği. `UpdateProductByCode` `true` değilse zorunludur; 1'den küçükse 00003 döner (`ErrorMessage`: `ProductId is missing`)." }, "ProductSourceId": { "type": "integer", "description": "Ürünün bulunduğu StockMount tipindeki kaynak (`GetProductSources`). Hesabınızda yoksa 70002, StockMount tipinde değilse 70003 döner." }, "Code": { "type": "string", "description": "Ürünün kaynaktaki mevcut kodu. Ürünü doğrulamak için kullanılır; kodu bu çağrıyla değiştiremezsiniz (`SetProductCode`). En fazla 50 karakter." }, "Name": { "type": "string", "description": "Ürün adı. En fazla 400 karakter." }, "Category": { "type": "string", "description": "Kategori adı (kimlik değil). Kaynakta yoksa otomatik oluşturulur. Mevcut adlar için `GetProductCategories`." }, "Price": { "type": "number", "description": "Satış fiyatı. 0'dan büyük olmalıdır; değilse 00003 (`Price is missing`) döner. 2 ondalık basamak saklanır." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği (`GetCurrencies`; ör. 4 = TRY, 2 = USD, 3 = EUR). 1'den küçükse 00003 döner. API kimliğin varlığını doğrulamaz; geçerli bir kimlik gönderin." }, "Quantity": { "type": "integer", "description": "Stok miktarı. Gönderilmezse 0. API negatif değeri reddetmez. Varyantlı üründe toplam stoğu kendiniz gönderin; varyant stoklarından hesaplanmaz. Durum bu değere göre yeniden hesaplanır (1'den küçükse 3, değilse 2)." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı; genellikle `Price` değerinden yüksektir ve indirimi göstermek için kullanılır. Gönderilmezse 0. `UpdateProduct` içinde gönderilmezse 0 olur." }, "TaxRate": { "type": "number", "description": "KDV oranı, yüzde olarak (ör. `20`). API izinli değer listesi uygulamaz. Gönderilmezse 0 kaydedilir. `UpdateProduct` içinde gönderilmezse 0 olur." }, "Barcode": { "type": "string", "description": "Ürün barkodu. En fazla 30 karakter. Biçim veya özel karakter kontrolü yapılmaz. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Brand": { "type": "string", "description": "Marka. En fazla 30 karakter. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Model": { "type": "string", "description": "Model. En fazla 30 karakter. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Code2": { "type": "string", "description": "İkinci ürün kodu. En fazla 50 karakter. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Mpn": { "type": "string", "description": "Üretici parça numarası (MPN). En fazla 50 karakter. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Subtitle": { "type": "string", "description": "Alt başlık. En fazla 400 karakter. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Description": { "type": "string", "description": "Ürün açıklaması; HTML olabilir. Güvenli olmayan HTML (ör. script) temizlenir. Gönderilmezse boş kaydedilir. `UpdateProductDescription` `false` ise mevcut açıklama korunur." }, "UpdateProductDescription": { "type": "boolean", "description": "`false` gönderirseniz açıklama değiştirilmez. Varsayılan `true`." }, "DispatchPeriod": { "type": "integer", "description": "Kargoya teslim (hazırlık) süresi, gün. Gönderilmezse -1 (tanımsız). `UpdateProduct` içinde gönderilmezse -1 olur." }, "Volume": { "type": "number", "description": "Hacim / desi. Gönderilmezse 0. `UpdateProduct` içinde gönderilmezse 0 olur." }, "Width": { "type": "number", "description": "Genişlik. Gönderilmezse 0. `UpdateProduct` içinde gönderilmezse 0 olur." }, "Length": { "type": "number", "description": "Uzunluk. Gönderilmezse 0. `UpdateProduct` içinde gönderilmezse 0 olur." }, "Height": { "type": "number", "description": "Yükseklik. Gönderilmezse 0. `UpdateProduct` içinde gönderilmezse 0 olur." }, "Weight": { "type": "number", "description": "Ağırlık. Gönderilmezse 0. `UpdateProduct` içinde gönderilmezse 0 olur." }, "SellerNote": { "type": "string", "description": "Satıcı notu. En fazla 150 karakter. `UpdateProduct` içinde gönderilmezse temizlenir." }, "VariantName1": { "type": "string", "description": "1. varyant özelliğinin adı (ör. `Renk`). En fazla 30 karakter. Herhangi bir varyantta `VariantValue1` doluysa zorunludur; yoksa 00003 (`VariantName1 is missing`) döner. `UpdateProduct` içinde gönderilmezse temizlenir." }, "VariantName2": { "type": "string", "description": "2. varyant özelliğinin adı (ör. `Beden`). En fazla 30 karakter. Herhangi bir varyantta `VariantValue2` doluysa zorunludur; yoksa 00003 (`VariantName2 is missing`) döner. `UpdateProduct` içinde gönderilmezse temizlenir." }, "VariantName3": { "type": "string", "description": "3. varyant özelliğinin adı (ör. `Beden`). En fazla 30 karakter. Herhangi bir varyantta `VariantValue3` doluysa zorunludur; yoksa 00003 (`VariantName3 is missing`) döner. `UpdateProduct` içinde gönderilmezse temizlenir." }, "VariantName4": { "type": "string", "description": "4. varyant özelliğinin adı (ör. `Beden`). En fazla 30 karakter. Herhangi bir varyantta `VariantValue4` doluysa zorunludur; yoksa 00003 (`VariantName4 is missing`) döner. `UpdateProduct` içinde gönderilmezse temizlenir." }, "VariantName5": { "type": "string", "description": "5. varyant özelliğinin adı (ör. `Beden`). En fazla 30 karakter. Herhangi bir varyantta `VariantValue5` doluysa zorunludur; yoksa 00003 (`VariantName5 is missing`) döner. `UpdateProduct` içinde gönderilmezse temizlenir." }, "VariantName6": { "type": "string", "description": "6. varyant özelliğinin adı (ör. `Beden`). En fazla 30 karakter. Herhangi bir varyantta `VariantValue6` doluysa zorunludur; yoksa 00003 (`VariantName6 is missing`) döner. `UpdateProduct` içinde gönderilmezse temizlenir." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu. Güncellemelerde varyant bu kodla eşleştirilir; dolu ve ürün içinde benzersiz gönderin. En fazla 50 karakter." }, "Barcode": { "type": "string", "description": "Varyant barkodu. Baştaki ve sondaki boşluklar kırpılır. En fazla 30 karakter." }, "Quantity": { "type": "integer", "description": "Varyant stoğu. Negatif değerler 0 olarak kaydedilir." }, "Price": { "type": "number", "description": "Varyant fiyatı. Gönderilmezse 0 kaydedilir." }, "VariantValue1": { "type": "string", "description": "1. varyant özelliğinin değeri (ör. `Siyah`). En fazla 100 karakter." }, "VariantValue2": { "type": "string", "description": "2. varyant özelliğinin değeri (ör. `M`). En fazla 100 karakter." }, "VariantValue3": { "type": "string", "description": "3. varyant özelliğinin değeri (ör. `M`). En fazla 100 karakter." }, "VariantValue4": { "type": "string", "description": "4. varyant özelliğinin değeri (ör. `M`). En fazla 100 karakter." }, "VariantValue5": { "type": "string", "description": "5. varyant özelliğinin değeri (ör. `M`). En fazla 100 karakter." }, "VariantValue6": { "type": "string", "description": "6. varyant özelliğinin değeri (ör. `M`). En fazla 100 karakter." }, "Code2": { "type": "string", "description": "İkinci varyant kodu. En fazla 50 karakter. Boşsa varyantın dizideki sırası (`0`, `1`, `2`…) yazılır." }, "Mpn": { "type": "string", "description": "Varyantın üretici parça numarası. En fazla 50 karakter." } } }, "description": "Varyant listesi. Gönderirseniz varyantlar `Code` ile eşleştirilir: eşleşenler güncellenir, yenileri görselsiz eklenir, listede olmayan mevcut varyantlar pasife alınır. Boş veya gönderilmemişse varyantlara dokunulmaz. Görsel alanları (`ImageUrl`, `ImageBase64`) yok sayılır." }, "Specs": { "type": "array", "items": { "type": "object", "properties": { "Name": { "type": "string", "description": "Özellik adı (ör. `Materyal`). En fazla 50 karakter." }, "Value": { "type": "string", "description": "Özellik değeri (ör. `Pamuk`). En fazla 100 karakter." } } }, "description": "Ürün özellikleri. Gönderirseniz mevcut özellik listesinin tamamı bununla değiştirilir; gönderilmezse mevcut özellikler kalır." }, "UpdateProductByCode": { "type": "boolean", "description": "`true` ise `ProductId` gerekmez; ürün `ProductSourceId` + `Code` ile bulunur. Bulunamazsa 70005 döner. Varsayılan `false`." } }, "required": [ "ApiCode", "ProductSourceId", "Code", "Name", "Category", "Price", "CurrencyId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 987654, "ProductSourceId": 1234, "Code": "TSHIRT-001", "Name": "Basic Pamuklu Tişört", "Category": "Tişört", "Price": 229.9, "MarketPrice": 299.9, "CurrencyId": 4, "TaxRate": 20, "Quantity": 25, "Barcode": "8690000000017", "Brand": "Örnek Marka", "Model": "BSC-01", "Description": "%100 pamuk, regular fit.
", "DispatchPeriod": 2, "Volume": 1, "VariantName1": "Renk", "VariantName2": "Beden", "Variants": [ { "Code": "TSHIRT-001-BLK-M", "Barcode": "8690000000024", "Quantity": 5, "Price": 229.9, "VariantValue1": "Siyah", "VariantValue2": "M" }, { "Code": "TSHIRT-001-BLK-L", "Barcode": "8690000000031", "Quantity": 20, "Price": 229.9, "VariantValue1": "Siyah", "VariantValue2": "L" } ], "Specs": [ { "Name": "Materyal", "Value": "Pamuk" } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "Response": { "type": "integer", "description": "Güncellenen ürünün `ProductId` değeri." } } } } } ] }, "example": { "Result": true, "Response": 987654 } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/DeleteProduct": { "post": { "operationId": "DeleteProduct", "tags": [ "Ürünler" ], "summary": "Ürün sil (kaldırıldı)", "description": "**Ürün sil (kaldırıldı)** — Bu uç nokta 1 Temmuz 2025'te kaldırıldı ve her çağrıda HTTP 410 döndürür.\n\nİstek gövdesi geçerli bir JSON olduğu sürece, `ApiCode` ve paket kontrolü yapılmadan HTTP 410 (Gone) döner. Gövde boş veya bozuksa önce ASP.NET 400 hatası alırsınız. Yanıt gövdesinde `ErrorCode` yoktur ve mesaj yalnızca Türkçedir.\n\nAPI ile ürün silmek artık mümkün değildir. Ürünü satıştan kaldırmak için `StopProduct` kullanın veya `UpdateProduct` ile `Quantity: 0` gönderin.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nhttps://outsample.stockmount.com/tr/api/Product/DeleteProduct", "deprecated": true, "responses": { "410": { "description": "Kaldırıldı" } } } }, "/api/Product/StopProduct": { "post": { "operationId": "StopProduct", "tags": [ "Ürünler" ], "summary": "Ürünü durdur", "description": "**Ürünü durdur** — Ürünün durumunu 3 (durduruldu) yapar. Ürün silinmez ve stoğu değişmez.\n\nYalnızca `ProductId` okunur; diğer alanlar yok sayılır. Kaynak tipi kontrol edilmez, hesabınızdaki herhangi bir ürünü durdurabilirsiniz. Durum 3, stoğu 0 olan ürünlerin de durumudur.\n\nÜrünü yeniden aktif etmek için `UpdateProduct` ile `Quantity` değerini 0'dan büyük gönderin; durum 2 olur.\n\nÜrün bulunamazsa veya hesabınıza ait değilse 99999 döner ve `ErrorMessage` boştur. Başarılı yanıtta `Response` yoktur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/StopProduct", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` ile aldığınız oturum kodu." }, "ProductId": { "type": "integer", "description": "Durdurulacak ürünün kimliği. 1'den küçükse 00003 döner (`ErrorMessage`: `ProductId`)." } }, "required": [ "ApiCode", "ProductId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 987654 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "nullable": true } } } ] }, "example": { "Result": true } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/GetProduct": { "post": { "operationId": "GetProduct", "tags": [ "Ürünler" ], "summary": "Ürün getir", "description": "**Ürün getir** — Tek bir ürünü görselleri, varyantları ve özellikleriyle döndürür. Ürünü `ProductId` veya `ProductSourceId` + `Code` ile bulursunuz.\n\n`ProductId` 0'dan büyükse ürün yalnızca bu kimlikle, hesabınızın tüm kaynaklarında aranır; `Code` yok sayılır. `ProductId` yoksa `Code` ve `ProductSourceId` birlikte gerekir. İkisi de yoksa 00003 (`ErrorMessage`: `ProductId`), `Code` var ama kaynak yoksa 00003 (`ErrorMessage`: `ProductSourceId`) döner. Ürün bulunamazsa 70005 (`Product was not found!`) döner. Durdurulmuş ürünler (durum 3) de döner; kaldırılmış `DeleteProduct` ile silinmiş ürünler dönmez.\n\nVaryantlar ve özellikler yalnızca `ProductId` ile sorguda yüklenir. `Code` ile sorguda `Variants` boş dizi gelir ve `Specs` yanıtta hiç yer almaz.\n\n`Variants`, `UpdateProduct` ile pasife alınmış varyantları da içerir ve varyant durumu döndürülmez; varyantlar oluşturulma sırasıyla gelir.\n\nBazı alanlar okunmadığı için her zaman sabit değerle döner: `Weight`, `StoreId`, `Price2`–`Price5` 0; `UpdateProductByCode` ve `SetProductQuantityFromVariants` `false`; `UpdateProductDescription` `true`; varyantlarda `CurrencyId`, `MinSalePrice` ve `Price2`–`Price5` 0. `VariantName5`, `VariantName6`, `VariantValue5`, `VariantValue6` ve `Mpn` döndürülmez. Değeri `null` olan alanlar yanıtta hiç yer almaz.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/GetProduct", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` ile aldığınız oturum kodu." }, "ProductId": { "type": "integer", "description": "Ürün kimliği. Gönderirseniz diğer alanlar yok sayılır." }, "Code": { "type": "string", "description": "Ürün kodu. `ProductId` yoksa kullanılır; birebir eşleşir." }, "ProductSourceId": { "type": "integer", "description": "`Code` ile sorguda zorunlu: kodun aranacağı kaynak." } }, "required": [ "ApiCode" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 987654 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Ürün kimliği." }, "ProductSourceId": { "type": "integer", "description": "Ürünün kaynağı." }, "Code": { "type": "string", "description": "Ürün kodu." }, "Code2": { "type": "string", "description": "İkinci ürün kodu." }, "Name": { "type": "string", "description": "Ürün adı." }, "Subtitle": { "type": "string", "description": "Alt başlık." }, "Description": { "type": "string", "description": "Açıklama (HTML, temizlenmiş)." }, "Barcode": { "type": "string", "description": "Barkod. Ürün için entegrasyon tarafında ikinci bir barkod tanımlıysa o döner." }, "Brand": { "type": "string", "description": "Marka." }, "Model": { "type": "string", "description": "Model." }, "Category": { "type": "string", "description": "Kategori adı." }, "Price": { "type": "number", "description": "Satış fiyatı." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı; yoksa 0." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği." }, "TaxRate": { "type": "number", "description": "KDV oranı; yoksa 0." }, "Quantity": { "type": "integer", "description": "Stok miktarı." }, "SoldCount": { "type": "integer", "description": "Satış adedi." }, "Status": { "type": "integer", "description": "Ürün durumu.\n\n- `0`: Değişmedi\n- `1`: Yeni (API ile eklenen ürünlerin ilk durumu)\n- `2`: Değişti (`UpdateProduct` sonrası, stok 0'dan büyükse)\n- `3`: Durduruldu / stok yok (`StopProduct` veya stok 1'den küçük)\n- `4`: Yeniden eklendi" }, "Volume": { "type": "number", "description": "Hacim / desi (ikinci değer tanımlıysa o)." }, "Width": { "type": "number", "description": "Genişlik." }, "Length": { "type": "number", "description": "Uzunluk." }, "Height": { "type": "number", "description": "Yükseklik." }, "Weight": { "type": "number", "description": "Her zaman 0 (saklanan değer döndürülmez)." }, "Url": { "type": "string", "description": "Ürün sayfası adresi; yoksa boş." }, "CreationTime": { "type": "string", "description": "Oluşturulma zamanı, saat dilimi eki olmadan (ör. `2025-11-05T10:22:31.497`)." }, "VariantName1": { "type": "string", "description": "1. varyant özelliğinin adı (`VariantName2`–`VariantName4` de döner; 5 ve 6 dönmez)." }, "DispatchPeriod": { "type": "integer", "description": "Kargoya teslim süresi (gün); -1 tanımsız." }, "SellerNote": { "type": "string", "description": "Satıcı notu." }, "Images": { "type": "array", "items": { "type": "object", "properties": { "Order": { "type": "integer", "description": "0'dan başlayan sıra." }, "Url": { "type": "string", "description": "Görsel adresi." } } }, "description": "Görseller, en fazla 12." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." }, "Code": { "type": "string", "description": "Varyant kodu." }, "Barcode": { "type": "string", "description": "Varyant barkodu." }, "Price": { "type": "number", "description": "Varyant fiyatı." }, "Quantity": { "type": "integer", "description": "Varyant stoğu." }, "ImageUrl": { "type": "string", "description": "Varyant görseli adresi." }, "VariantValue1": { "type": "string", "description": "1. varyant özelliğinin değeri." }, "VariantValue2": { "type": "string", "description": "2. varyant özelliğinin değeri." }, "VariantValue3": { "type": "string", "description": "3. varyant özelliğinin değeri." }, "VariantValue4": { "type": "string", "description": "4. varyant özelliğinin değeri." }, "CurrencyId": { "type": "integer", "description": "Her zaman 0 (okunmaz)." }, "MinSalePrice": { "type": "number", "description": "Her zaman 0 (okunmaz)." }, "Price2": { "type": "number", "description": "Her zaman 0 (`Price3`, `Price4`, `Price5` de öyle)." } } }, "description": "Varyantlar. Yalnızca `ProductId` ile sorguda dolar; pasif varyantlar da dahildir." }, "Specs": { "type": "array", "items": { "type": "object", "properties": { "Name": { "type": "string", "description": "Özellik adı." }, "Value": { "type": "string", "description": "Özellik değeri." } } }, "description": "Özellikler. Yalnızca `ProductId` ile sorguda döner." }, "StoreId": { "type": "integer", "description": "Her zaman 0 (yalnızca istek alanı)." }, "Price2": { "type": "number", "description": "Her zaman 0 (`Price3`, `Price4`, `Price5` de öyle)." }, "UpdateProductByCode": { "type": "boolean", "description": "Her zaman `false` (yalnızca istek alanı)." }, "SetProductQuantityFromVariants": { "type": "boolean", "description": "Her zaman `false` (yalnızca istek alanı)." }, "UpdateProductDescription": { "type": "boolean", "description": "Her zaman `true` (yalnızca istek alanı)." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 987654, "ProductSourceId": 1234, "Description": "%100 pamuk, regular fit.
", "Code": "TSHIRT-001", "Code2": "", "Barcode": "8690000000017", "Name": "Basic Pamuklu Tişört", "Subtitle": "", "Price": 249.9, "Quantity": 30, "Brand": "Örnek Marka", "TaxRate": 20.0, "Model": "BSC-01", "Category": "Tişört", "CurrencyId": 4, "Images": [ { "Order": 0, "Url": "https://cdn.example.com/tshirt-001-1.jpg" }, { "Order": 1, "Url": "https://cdn.example.com/tshirt-001-2.jpg" } ], "MarketPrice": 299.9, "Status": 1, "Volume": 1.0, "Height": 0.0, "Length": 0.0, "Width": 0.0, "VariantName1": "Renk", "VariantName2": "Beden", "Variants": [ { "ProductVariantId": 5550001, "Code": "TSHIRT-001-BLK-M", "Price": 249.9, "Price2": 0.0, "Price3": 0.0, "Price4": 0.0, "Price5": 0.0, "Quantity": 10, "Barcode": "8690000000024", "CurrencyId": 0, "ImageUrl": "", "VariantValue1": "Siyah", "VariantValue2": "M", "VariantValue3": "", "VariantValue4": "", "MinSalePrice": 0.0 } ], "Specs": [ { "Name": "Materyal", "Value": "Pamuk" } ], "Url": "", "StoreId": 0, "Weight": 0.0, "CreationTime": "2025-11-05T10:22:31.497", "UpdateProductByCode": false, "SetProductQuantityFromVariants": false, "DispatchPeriod": 2, "Price2": 0.0, "Price3": 0.0, "Price4": 0.0, "Price5": 0.0, "UpdateProductDescription": true, "SoldCount": 0, "SellerNote": "" } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/GetProducts": { "post": { "operationId": "GetProducts", "tags": [ "Ürünler" ], "summary": "Ürünleri listele", "description": "**Ürünleri listele** — Bir kaynaktaki ürünleri filtreleyip sıralı ve sayfalı olarak döndürür.\n\n`PageIndex` 1'den başlar; 1'den küçük değerler 1 sayılır. `RowsByPage` gönderilmezse veya 0 ise 100'dür; en fazla 100'dür (daha büyük değerler 100'e, negatif değerler 1'e çekilir). Toplam sayfa sayısını `FilteredProductCount` ve `RowsByPage` ile hesaplayın.\n\n`OrderBy` şu değerlerden biri olmalıdır (büyük/küçük harf duyarsız): `Name`, `ProductId`, `Category`, `Price`, `Quantity`, `Status`, `CurrencyId`. Geçersiz değer hata vermez, `ProductId` kullanılır. `OrderDirection` `ASC` veya `DESC` olur; geçersizse `ASC`.\n\nSayısal filtrelerde 0, metin filtrelerinde boş değer filtreyi kapatır; bu yüzden `QuantityFrom`/`QuantityTo` ile stoğu 0 olan ürünleri süzemezsiniz. `ProductCode` ve `ProductCategory` birebir eşleşir. `Keywords` ürün adında (ve varsa pazaryerine özel adında) arar; boşluklar joker gibi davranır: `kırmızı tişört`, adında önce `kırmızı` sonra `tişört` geçen ürünleri bulur.\n\n`CreationTimeFrom` ve `CreationTimeTo` yalnızca yılı 2010'dan büyükse uygulanır. Değeri `2025-01-31T00:00:00` biçiminde, saat dilimi eki olmadan gönderin; veritabanında saklanan oluşturma zamanıyla olduğu gibi karşılaştırılır. Yanıttaki `CreationTime` de saat dilimi eki olmadan döner.\n\n`TotalProductCount` filtrelerden bağımsız olarak kaynaktaki toplam ürün sayısıdır; `FilteredProductCount` filtrelere uyan ürün sayısıdır. Kaldırılmış `DeleteProduct` ile silinmiş ürünler sayılmaz ve listelenmez; durdurulmuş ürünler (durum 3) listelenir. `ProductSourceId` herhangi bir kaynağınız olabilir; kaynak tipi kontrol edilmez.\n\nListe öğesi, `GetProduct` yanıtından daha az alan içerir; varyant, görsel listesi ve açıklama yoktur. `Image` ilk görselin adresidir. `Currency` para biriminin kodudur; kod `NON` ise `TRY` döner. `Barcode` ürünün kendi barkodudur (`GetProduct` ise entegrasyon barkodunu öncelikli döndürür).\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/GetProducts", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` ile aldığınız oturum kodu." }, "ProductSourceId": { "type": "integer", "description": "Listelenecek kaynak. 1'den küçükse 00003 döner (`ErrorMessage`: `ProductSourceId`)." }, "ProductId": { "type": "integer", "description": "Tek bir ürün kimliğiyle süzer. 0 = filtre yok." }, "ProductCode": { "type": "string", "description": "Ürün kodu, birebir eşleşme. En fazla 50 karakter." }, "Keywords": { "type": "string", "description": "Ürün adında arama; boşluklar joker gibi davranır." }, "ProductCategory": { "type": "string", "description": "Kategori adı, birebir eşleşme." }, "PriceFrom": { "type": "number", "description": "En düşük fiyat (dahil). 0 = filtre yok." }, "PriceTo": { "type": "number", "description": "En yüksek fiyat (dahil). 0 = filtre yok." }, "QuantityFrom": { "type": "integer", "description": "En düşük stok (dahil). 0 = filtre yok." }, "QuantityTo": { "type": "integer", "description": "En yüksek stok (dahil). 0 = filtre yok." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği. 0 = filtre yok." }, "ProductStatus": { "type": "integer", "description": "Ürün durumu filtresi. Varsayılan -1 (tümü).\n\n- `-1`: Tümü (varsayılan)\n- `0`: Değişmedi\n- `1`: Yeni\n- `2`: Değişti\n- `3`: Durduruldu / stok yok\n- `4`: Yeniden eklendi\n- `99`: 3 dışındaki tümü (durdurulmamış ürünler)" }, "CreationTimeFrom": { "type": "string", "description": "Bu zamandan sonra oluşturulanlar (dahil). `yyyy-MM-ddTHH:mm:ss`, saat dilimi eki olmadan. Yılı 2010 veya öncesiyse yok sayılır." }, "CreationTimeTo": { "type": "string", "description": "Bu zamandan önce oluşturulanlar (dahil). Biçim ve kural `CreationTimeFrom` ile aynı." }, "PageIndex": { "type": "integer", "description": "Sayfa numarası, 1'den başlar. Varsayılan 1." }, "RowsByPage": { "type": "integer", "description": "Sayfa boyutu. Varsayılan 100, en fazla 100." }, "OrderBy": { "type": "string", "description": "Sıralama alanı. Varsayılan `ProductId`.\n\n- `Name`: Ürün adı\n- `ProductId`: Ürün kimliği (varsayılan)\n- `Category`: Kategori adı\n- `Price`: Fiyat\n- `Quantity`: Stok\n- `Status`: Durum\n- `CurrencyId`: Para birimi" }, "OrderDirection": { "type": "string", "description": "Sıralama yönü. Varsayılan `ASC`.\n\n- `ASC`: Artan (varsayılan)\n- `DESC`: Azalan" } }, "required": [ "ApiCode", "ProductSourceId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductSourceId": 1234, "Keywords": "tişört", "ProductStatus": 99, "CreationTimeFrom": "2025-10-01T00:00:00", "PageIndex": 1, "RowsByPage": 50, "OrderBy": "Name", "OrderDirection": "ASC" } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "TotalProductCount": { "type": "integer", "description": "Kaynaktaki toplam ürün sayısı (filtrelerden bağımsız)." }, "FilteredProductCount": { "type": "integer", "description": "Filtrelere uyan ürün sayısı." }, "Products": { "type": "array", "items": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Ürün kimliği." }, "ProductSourceId": { "type": "integer", "description": "Kaynak kimliği." }, "Category": { "type": "string", "description": "Kategori adı." }, "Code": { "type": "string", "description": "Ürün kodu." }, "Code2": { "type": "string", "description": "İkinci ürün kodu; yoksa boş." }, "Name": { "type": "string", "description": "Ürün adı." }, "TaxRate": { "type": "number", "description": "KDV oranı; yoksa 0." }, "Quantity": { "type": "integer", "description": "Stok miktarı." }, "SoldCount": { "type": "integer", "description": "Satış adedi." }, "Price": { "type": "number", "description": "Satış fiyatı." }, "Subtitle": { "type": "string", "description": "Alt başlık." }, "Volume": { "type": "number", "description": "Hacim / desi (ikinci değer tanımlıysa o)." }, "Brand": { "type": "string", "description": "Marka." }, "Barcode": { "type": "string", "description": "Ürünün kendi barkodu." }, "Status": { "type": "integer", "description": "Ürün durumu.\n\n- `0`: Değişmedi\n- `1`: Yeni (API ile eklenen ürünlerin ilk durumu)\n- `2`: Değişti (`UpdateProduct` sonrası, stok 0'dan büyükse)\n- `3`: Durduruldu / stok yok (`StopProduct` veya stok 1'den küçük)\n- `4`: Yeniden eklendi" }, "CreationTime": { "type": "string", "description": "Oluşturulma zamanı, saat dilimi eki olmadan." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı; yoksa 0." }, "Image": { "type": "string", "description": "İlk görselin adresi; yoksa boş." }, "Currency": { "type": "string", "description": "Para birimi kodu (ör. `TRY`, `USD`); `NON` ise `TRY` döner." }, "SellerNote": { "type": "string", "description": "Satıcı notu; yoksa boş." } } }, "description": "Bu sayfadaki ürünler." } } } } } ] }, "example": { "Result": true, "Response": { "TotalProductCount": 152, "FilteredProductCount": 1, "Products": [ { "ProductId": 987654, "ProductSourceId": 1234, "Category": "Tişört", "Code": "TSHIRT-001", "Code2": "", "Name": "Basic Pamuklu Tişört", "TaxRate": 20.0, "Quantity": 30, "SoldCount": 4, "Price": 249.9, "Subtitle": "", "Volume": 1.0, "Brand": "Örnek Marka", "Barcode": "8690000000017", "Status": 1, "CreationTime": "2025-11-05T10:22:31.497", "CurrencyId": 4, "MarketPrice": 299.9, "Image": "https://cdn.example.com/tshirt-001-1.jpg", "Currency": "TRY", "SellerNote": "" } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/GetProductSummary": { "post": { "operationId": "GetProductSummary", "tags": [ "Ürünler" ], "summary": "Ürün özetini getir", "description": "**Ürün özetini getir** — Bir kaynaktaki tüm ürünlerin kimliğini, kodunu, adını, barkodunu ve durumunu tek yanıtta döndürür.\n\nSayfalama ve filtre yoktur; kaynaktaki tüm ürünler tek yanıtta gelir ve sıra garanti edilmez. Yalnızca `ProductSourceId` okunur; `GetProducts` filtre ve sayfalama alanları bu çağrıda yok sayılır.\n\n`TotalProductCount` ve `FilteredProductCount` her zaman aynıdır ve dönen ürün sayısını verir. Kaldırılmış `DeleteProduct` ile silinmiş ürünler dönmez; durdurulmuş ürünler (durum 3) döner. Bu çağrı, kendi sisteminizdeki ürünleri StockMount `ProductId` değerleriyle eşleştirmek için uygundur.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/GetProductSummary", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` ile aldığınız oturum kodu." }, "ProductSourceId": { "type": "integer", "description": "Kaynak kimliği. 1'den küçükse 00003 döner (`ErrorMessage`: `ProductSourceId`)." } }, "required": [ "ApiCode", "ProductSourceId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductSourceId": 1234 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "TotalProductCount": { "type": "integer", "description": "Dönen ürün sayısı." }, "FilteredProductCount": { "type": "integer", "description": "`TotalProductCount` ile aynı." }, "Products": { "type": "array", "items": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Ürün kimliği." }, "ProductSourceId": { "type": "integer", "description": "Kaynak kimliği." }, "Code": { "type": "string", "description": "Ürün kodu." }, "Name": { "type": "string", "description": "Ürün adı." }, "Barcode": { "type": "string", "description": "Barkod; yoksa boş metin." }, "Status": { "type": "integer", "description": "Ürün durumu.\n\n- `0`: Değişmedi\n- `1`: Yeni (API ile eklenen ürünlerin ilk durumu)\n- `2`: Değişti (`UpdateProduct` sonrası, stok 0'dan büyükse)\n- `3`: Durduruldu / stok yok (`StopProduct` veya stok 1'den küçük)\n- `4`: Yeniden eklendi" } } }, "description": "Kaynaktaki tüm ürünler." } } } } } ] }, "example": { "Result": true, "Response": { "TotalProductCount": 2, "FilteredProductCount": 2, "Products": [ { "ProductId": 987654, "ProductSourceId": 1234, "Code": "TSHIRT-001", "Name": "Basic Pamuklu Tişört", "Barcode": "8690000000017", "Status": 2 }, { "ProductId": 987655, "ProductSourceId": 1234, "Code": "PANT-002", "Name": "Chino Pantolon", "Barcode": "8690000000048", "Status": 3 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/SetProductCode": { "post": { "operationId": "SetProductCode", "tags": [ "Ürünler" ], "summary": "Ürün kodunu değiştir", "description": "**Ürün kodunu değiştir** — Mevcut bir ürünün `Code` değerini değiştirir.\n\nYalnızca StockMount tipindeki kaynaklardaki ürünlerde çalışır. Yeni kod aynı kaynakta başka bir üründe kullanılıyorsa değişiklik yapılmaz.\n\n`Code` en fazla 50 karakterdir; daha uzunsa 70009 döner (`ErrorMessage`: `'Code' length must be at most 50 character.`).\n\nÜrün bulunamazsa, hesabınıza ait değilse, kaynağı StockMount tipinde değilse veya kod başka bir üründe kullanılıyorsa 99999 döner ve `ErrorMessage` boştur. Başarılı yanıtta `Response` yoktur.\n\nKod değiştikten sonra `UpdateProduct`, `GetProduct` ve kodla çalışan diğer çağrılarda yeni kodu kullanın.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/SetProductCode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` ile aldığınız oturum kodu." }, "ProductId": { "type": "integer", "description": "Kodu değişecek ürünün kimliği. 1'den küçükse 00003 döner (`ErrorMessage`: `ProductId`)." }, "Code": { "type": "string", "description": "Yeni ürün kodu. En fazla 50 karakter. Boşsa 00003 döner (`ErrorMessage`: `Code`)." } }, "required": [ "ApiCode", "ProductId", "Code" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 987654, "Code": "TSHIRT-001-V2" } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "nullable": true } } } ] }, "example": { "Result": true } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductPrice": { "post": { "operationId": "UpdateProductPrice", "tags": [ "Ürünler" ], "summary": "Ürün fiyatını güncelle (ProductId ile)", "description": "**Ürün fiyatını güncelle (ProductId ile)** — `ProductId` ile bulunan ürünün ve isteğe bağlı olarak varyantlarının fiyatlarını günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün yalnızca `ProductId` ile bulunur. Ürün kodu ile güncellemek için `ByCode` uç noktasını kullanın.\n\n`Price`, `MarketPrice` ve `Price2`–`Price5` her çağrıda istekteki değerle değiştirilir; göndermediğiniz alan `0` olur. Kullandığınız tüm fiyatları her seferinde gönderin.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa varyant `Code` ile ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın `Price` ve `Price2`–`Price5` değerleri istekteki değerle değiştirilir (gönderilmeyen `0` olur). Listede olmayan varyantlara dokunulmaz. Varyant düzeyinde `CurrencyId` okunmaz; ürün düzeyindeki `CurrencyId` kullanılır.\n\nBu uç nokta fiyatları doğrulamaz: `0`, negatif değer veya `Price` değerinden düşük bir `MarketPrice` kabul edilir. Bu tür sorunlar bu çağrıda değil, pazaryeri senkronizasyonu sırasında hata olarak ortaya çıkar.\n\nBu uç nokta stoğu ve adı değiştirmez; `Quantity` ve `Name` yok sayılır.\n\nFiyat önce StockMount'taki ürüne yazılır. Fiyatlardan biri gerçekten değiştiyse, ürünün pazaryerlerindeki aktif ilanları için fiyat güncellemesi kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir. Aynı tür bekleyen bir güncelleme varsa yenisi eklenmez.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductPrice", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "ProductId": { "type": "integer", "description": "StockMount ürün kimliği. Ürün hesabınıza ait olmalıdır. Bu uç noktada `Code` yok sayılır." }, "Price": { "type": "number", "description": "Ürünün satış fiyatı. 2 ondalık basamakla saklanır. Gönderilmezse `0` yazılır." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Ürünün ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Ürünün ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Ürünün ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Ürünün ek fiyatı 5. Gönderilmezse `0` yazılır." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği (`GetCurrencies`). 0'dan büyükse ürünün ve güncellenen varyantların para birimi bu değere çevrilir. Gönderilmezse veya `0` ise para birimi değişmez." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "Price": { "type": "number", "description": "Varyantın satış fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Varyantın ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Varyantın ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Varyantın ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Varyantın ek fiyatı 5. Gönderilmezse `0` yazılır." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "ProductId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 184522, "Price": 349.9, "MarketPrice": 449.9, "Price2": 329.9, "Price3": 0, "Price4": 0, "Price5": 0, "Variants": [ { "ProductVariantId": 9120344, "Price": 349.9, "Price2": 329.9 }, { "Code": "TSHIRT-RED-L", "Price": 359.9, "Price2": 339.9 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductPriceByCode": { "post": { "operationId": "UpdateProductPriceByCode", "tags": [ "Ürünler" ], "summary": "Ürün fiyatını güncelle (ürün kodu ile)", "description": "**Ürün fiyatını güncelle (ürün kodu ile)** — `Code` ve `ProductSourceId` ile bulunan ürünün ve isteğe bağlı olarak varyantlarının fiyatlarını günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün `Code` + `ProductSourceId` ile bulunur; gönderdiğiniz `ProductId` yok sayılır. `Code` boşsa dönen `ErrorMessage` alanında `ProductId` yazar; bu, kodun eksik olduğu anlamına gelir.\n\n`Price`, `MarketPrice` ve `Price2`–`Price5` her çağrıda istekteki değerle değiştirilir; göndermediğiniz alan `0` olur. Kullandığınız tüm fiyatları her seferinde gönderin.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa varyant `Code` ile ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın `Price` ve `Price2`–`Price5` değerleri istekteki değerle değiştirilir (gönderilmeyen `0` olur). Listede olmayan varyantlara dokunulmaz. Varyant düzeyinde `CurrencyId` okunmaz; ürün düzeyindeki `CurrencyId` kullanılır.\n\nBu uç nokta fiyatları doğrulamaz: `0`, negatif değer veya `Price` değerinden düşük bir `MarketPrice` kabul edilir. Bu tür sorunlar bu çağrıda değil, pazaryeri senkronizasyonu sırasında hata olarak ortaya çıkar.\n\nBu uç nokta stoğu ve adı değiştirmez; `Quantity` ve `Name` yok sayılır.\n\nFiyat önce StockMount'taki ürüne yazılır. Fiyatlardan biri gerçekten değiştiyse, ürünün pazaryerlerindeki aktif ilanları için fiyat güncellemesi kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir. Aynı tür bekleyen bir güncelleme varsa yenisi eklenmez.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductPriceByCode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "Code": { "type": "string", "description": "Ürün kodu (stok kodu), en fazla 50 karakter. Ürün, `Code` ve `ProductSourceId` birlikte kullanılarak bulunur. Bu uç noktada `ProductId` yok sayılır." }, "ProductSourceId": { "type": "integer", "description": "Ürünün bağlı olduğu ürün kaynağının kimliği (`GetProductSources`). `Code` bu kaynak içinde aranır." }, "Price": { "type": "number", "description": "Ürünün satış fiyatı. 2 ondalık basamakla saklanır. Gönderilmezse `0` yazılır." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Ürünün ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Ürünün ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Ürünün ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Ürünün ek fiyatı 5. Gönderilmezse `0` yazılır." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği (`GetCurrencies`). 0'dan büyükse ürünün ve güncellenen varyantların para birimi bu değere çevrilir. Gönderilmezse veya `0` ise para birimi değişmez." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "Price": { "type": "number", "description": "Varyantın satış fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Varyantın ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Varyantın ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Varyantın ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Varyantın ek fiyatı 5. Gönderilmezse `0` yazılır." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "Code", "ProductSourceId" ] }, "example": { "ApiCode": "{{apiCode}}", "Code": "TSHIRT-RED", "ProductSourceId": 3051, "Price": 349.9, "MarketPrice": 449.9, "Price2": 329.9, "Price3": 0, "Price4": 0, "Price5": 0, "Variants": [ { "ProductVariantId": 9120344, "Price": 349.9, "Price2": 329.9 }, { "Code": "TSHIRT-RED-L", "Price": 359.9, "Price2": 339.9 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductQuantity": { "post": { "operationId": "UpdateProductQuantity", "tags": [ "Ürünler" ], "summary": "Ürün stoğunu güncelle (ProductId ile)", "description": "**Ürün stoğunu güncelle (ProductId ile)** — `ProductId` ile bulunan ürünün ve isteğe bağlı olarak varyantlarının stok miktarını günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün yalnızca `ProductId` ile bulunur. Ürün kodu ile güncellemek için `ByCode` uç noktasını kullanın.\n\nGönderdiğiniz miktar ürünün satılabilir stoğunun yerine geçer; StockMount'un o ana kadar saydığı satılan adet sıfırlanır. Yeni ürün stoğu 1'den küçükse ürünün `Status` değeri `3`, aksi halde `2` olur.\n\nÜrün düzeyindeki `Quantity` her çağrıda yazılır. `Quantity` göndermeden yalnızca varyant stoklarını gönderirseniz ve `SetProductQuantityFromVariants` alanını `true` yapmazsanız ürün stoğu `0` olur. Varyantlı ürünlerde `SetProductQuantityFromVariants: true` göndermeniz önerilir.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa varyant `Code` ile ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın stoğu `Quantity` ile değiştirilir (gönderilmezse `0`). Listede olmayan varyantlara dokunulmaz.\n\nMiktarlar doğrulanmaz; negatif değerler reddedilmez.\n\nBu uç nokta fiyatları değiştirmez; fiyat alanları yok sayılır. Tek istisna `CurrencyId`: 0'dan büyük gönderirseniz ürünün para birimi de değişir. Bu alanı göndermeyin.\n\nStok önce StockMount'taki ürüne yazılır. Stok değiştiyse, ürünün pazaryerlerindeki aktif ilanları için stok güncellemesi kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir. Aynı tür bekleyen bir güncelleme varsa yenisi eklenmez.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductQuantity", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "ProductId": { "type": "integer", "description": "StockMount ürün kimliği. Ürün hesabınıza ait olmalıdır. Bu uç noktada `Code` yok sayılır." }, "Quantity": { "type": "integer", "description": "Ürünün yeni stok miktarı. Gönderilmezse `0` yazılır. `SetProductQuantityFromVariants` `true` ise ve `Variants` en az bir öğe içeriyorsa yok sayılır. Negatif değer reddedilmez." }, "SetProductQuantityFromVariants": { "type": "boolean", "description": "`true` ise ürün stoğu aktif varyantların toplamı olarak hesaplanır: listede gönderdiğiniz varyantlar için yeni miktar, diğer varyantlar için mevcut satılabilir stok kullanılır. `Variants` boşsa etkisizdir. Varsayılan `false`." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "Quantity": { "type": "integer", "description": "Varyantın yeni stok miktarı. Gönderilmezse `0` yazılır. Negatif değer reddedilmez." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "ProductId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 184522, "SetProductQuantityFromVariants": true, "Variants": [ { "ProductVariantId": 9120344, "Quantity": 15 }, { "Code": "TSHIRT-RED-L", "Quantity": 0 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductQuantityByCode": { "post": { "operationId": "UpdateProductQuantityByCode", "tags": [ "Ürünler" ], "summary": "Ürün stoğunu güncelle (ürün kodu ile)", "description": "**Ürün stoğunu güncelle (ürün kodu ile)** — `Code` ve `ProductSourceId` ile bulunan ürünün ve isteğe bağlı olarak varyantlarının stok miktarını günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün `Code` + `ProductSourceId` ile bulunur; gönderdiğiniz `ProductId` yok sayılır. `Code` boşsa dönen `ErrorMessage` alanında `ProductId` yazar; bu, kodun eksik olduğu anlamına gelir.\n\nGönderdiğiniz miktar ürünün satılabilir stoğunun yerine geçer; StockMount'un o ana kadar saydığı satılan adet sıfırlanır. Yeni ürün stoğu 1'den küçükse ürünün `Status` değeri `3`, aksi halde `2` olur.\n\nÜrün düzeyindeki `Quantity` her çağrıda yazılır. `Quantity` göndermeden yalnızca varyant stoklarını gönderirseniz ve `SetProductQuantityFromVariants` alanını `true` yapmazsanız ürün stoğu `0` olur. Varyantlı ürünlerde `SetProductQuantityFromVariants: true` göndermeniz önerilir.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa varyant `Code` ile ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın stoğu `Quantity` ile değiştirilir (gönderilmezse `0`). Listede olmayan varyantlara dokunulmaz.\n\nMiktarlar doğrulanmaz; negatif değerler reddedilmez.\n\nBu uç nokta fiyatları değiştirmez; fiyat alanları yok sayılır. Tek istisna `CurrencyId`: 0'dan büyük gönderirseniz ürünün para birimi de değişir. Bu alanı göndermeyin.\n\nStok önce StockMount'taki ürüne yazılır. Stok değiştiyse, ürünün pazaryerlerindeki aktif ilanları için stok güncellemesi kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir. Aynı tür bekleyen bir güncelleme varsa yenisi eklenmez.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductQuantityByCode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "Code": { "type": "string", "description": "Ürün kodu (stok kodu), en fazla 50 karakter. Ürün, `Code` ve `ProductSourceId` birlikte kullanılarak bulunur. Bu uç noktada `ProductId` yok sayılır." }, "ProductSourceId": { "type": "integer", "description": "Ürünün bağlı olduğu ürün kaynağının kimliği (`GetProductSources`). `Code` bu kaynak içinde aranır." }, "Quantity": { "type": "integer", "description": "Ürünün yeni stok miktarı. Gönderilmezse `0` yazılır. `SetProductQuantityFromVariants` `true` ise ve `Variants` en az bir öğe içeriyorsa yok sayılır. Negatif değer reddedilmez." }, "SetProductQuantityFromVariants": { "type": "boolean", "description": "`true` ise ürün stoğu aktif varyantların toplamı olarak hesaplanır: listede gönderdiğiniz varyantlar için yeni miktar, diğer varyantlar için mevcut satılabilir stok kullanılır. `Variants` boşsa etkisizdir. Varsayılan `false`." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "Quantity": { "type": "integer", "description": "Varyantın yeni stok miktarı. Gönderilmezse `0` yazılır. Negatif değer reddedilmez." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "Code", "ProductSourceId" ] }, "example": { "ApiCode": "{{apiCode}}", "Code": "TSHIRT-RED", "ProductSourceId": 3051, "SetProductQuantityFromVariants": true, "Variants": [ { "ProductVariantId": 9120344, "Quantity": 15 }, { "Code": "TSHIRT-RED-L", "Quantity": 0 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductQuantityByBarcode": { "post": { "operationId": "UpdateProductQuantityByBarcode", "tags": [ "Ürünler" ], "summary": "Varyant stoğunu barkodla güncelle", "description": "**Varyant stoğunu barkodla güncelle** — `Code` ve `ProductSourceId` ile bulunan ürünün stoğunu ve varyantlarını barkodla eşleştirerek varyant stoklarını günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün barkodla değil, `Code` + `ProductSourceId` ile bulunur; `ProductId` yok sayılır. Kök düzeydeki `Barcode` alanı kullanılmaz. Barkod yalnızca `Variants` içindeki varyantları eşleştirmek için kullanılır.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa `Barcode` ile bu ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın stoğu `Quantity` ile değiştirilir (gönderilmezse `0`). Listede olmayan varyantlara dokunulmaz.\n\nGönderdiğiniz miktar ürünün satılabilir stoğunun yerine geçer; StockMount'un o ana kadar saydığı satılan adet sıfırlanır. Yeni ürün stoğu 1'den küçükse ürünün `Status` değeri `3`, aksi halde `2` olur.\n\nÜrün düzeyindeki `Quantity` her çağrıda yazılır. `Quantity` göndermeden yalnızca varyant stoklarını gönderirseniz ve `SetProductQuantityFromVariants` alanını `true` yapmazsanız ürün stoğu `0` olur. Varyantlı ürünlerde `SetProductQuantityFromVariants: true` göndermeniz önerilir.\n\nDikkat: Bu uç nokta, stok güncellemesi olmasına rağmen ürünün `Price2`–`Price5` alanlarını istekteki değerle değiştirir; göndermezseniz bu fiyatlar `0` olur. Bu fiyatları kullanıyorsanız mevcut değerlerini her çağrıda gönderin. `Price` ve `MarketPrice` değişmez.\n\n`CurrencyId` bu uç noktada yok sayılır; ürünün para birimi değişmez.\n\nMiktarlar doğrulanmaz; negatif değerler reddedilmez.\n\nBaşarılı her çağrıdan sonra, ürünün pazaryerlerindeki aktif ilanları için stok güncellemesi kuyruğa alınır (aynı tür bekleyen güncelleme yoksa). Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductQuantityByBarcode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "Code": { "type": "string", "description": "Ürün kodu (stok kodu), en fazla 50 karakter. Ürün, `Code` ve `ProductSourceId` birlikte kullanılarak bulunur. Bu uç noktada `ProductId` yok sayılır." }, "ProductSourceId": { "type": "integer", "description": "Ürünün bağlı olduğu ürün kaynağının kimliği (`GetProductSources`). `Code` bu kaynak içinde aranır." }, "Quantity": { "type": "integer", "description": "Ürünün yeni stok miktarı. Gönderilmezse `0` yazılır. `SetProductQuantityFromVariants` `true` ise ve `Variants` en az bir öğe içeriyorsa yok sayılır. Negatif değer reddedilmez." }, "SetProductQuantityFromVariants": { "type": "boolean", "description": "`true` ise ürün stoğu varyantların toplamı olarak hesaplanır: listede gönderdiğiniz aktif varyantlar için yeni miktar, diğer tüm varyantlar (pasifler dahil) için mevcut satılabilir stok kullanılır. `Variants` boşsa etkisizdir. Varsayılan `false`." }, "Price2": { "type": "number", "description": "Ürünün ek fiyatı 2. Bu uç nokta stok güncellese de bu alanı ürüne yazar; gönderilmezse `0` olur. Mevcut değeri gönderin." }, "Price3": { "type": "number", "description": "Ürünün ek fiyatı 3. Bu uç nokta stok güncellese de bu alanı ürüne yazar; gönderilmezse `0` olur. Mevcut değeri gönderin." }, "Price4": { "type": "number", "description": "Ürünün ek fiyatı 4. Bu uç nokta stok güncellese de bu alanı ürüne yazar; gönderilmezse `0` olur. Mevcut değeri gönderin." }, "Price5": { "type": "number", "description": "Ürünün ek fiyatı 5. Bu uç nokta stok güncellese de bu alanı ürüne yazar; gönderilmezse `0` olur. Mevcut değeri gönderin." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Barcode` ile bulunur." }, "Barcode": { "type": "string", "description": "Varyant barkodu. `ProductVariantId` yoksa varyant bu barkodla, yalnızca bu ürünün varyantları içinde aranır. Baştaki ve sondaki boşluklar silinir." }, "Quantity": { "type": "integer", "description": "Varyantın yeni stok miktarı. Gönderilmezse `0` yazılır. Negatif değer reddedilmez." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "Code", "ProductSourceId" ] }, "example": { "ApiCode": "{{apiCode}}", "Code": "TSHIRT-RED", "ProductSourceId": 3051, "SetProductQuantityFromVariants": true, "Price2": 329.9, "Price3": 0, "Price4": 0, "Price5": 0, "Variants": [ { "Barcode": "8690000000017", "Quantity": 15 }, { "Barcode": "8690000000024", "Quantity": 0 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductQuantityAndPrice": { "post": { "operationId": "UpdateProductQuantityAndPrice", "tags": [ "Ürünler" ], "summary": "Ürün stoğunu ve fiyatını güncelle (ProductId ile)", "description": "**Ürün stoğunu ve fiyatını güncelle (ProductId ile)** — `ProductId` ile bulunan ürünün ve isteğe bağlı olarak varyantlarının stok ve fiyatlarını tek çağrıda günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün yalnızca `ProductId` ile bulunur. Ürün kodu ile güncellemek için `ByCode` uç noktasını kullanın.\n\nGönderdiğiniz miktar ürünün satılabilir stoğunun yerine geçer; StockMount'un o ana kadar saydığı satılan adet sıfırlanır. Yeni ürün stoğu 1'den küçükse ürünün `Status` değeri `3`, aksi halde `2` olur.\n\nÜrün düzeyindeki `Quantity` her çağrıda yazılır. `Quantity` göndermeden yalnızca varyant stoklarını gönderirseniz ve `SetProductQuantityFromVariants` alanını `true` yapmazsanız ürün stoğu `0` olur. Varyantlı ürünlerde `SetProductQuantityFromVariants: true` göndermeniz önerilir.\n\n`Price`, `MarketPrice` ve `Price2`–`Price5` her çağrıda istekteki değerle değiştirilir; göndermediğiniz alan `0` olur. Kullandığınız tüm fiyatları her seferinde gönderin.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa varyant `Code` ile ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın stoğu `Quantity`, fiyatları `Price` ve `Price2`–`Price5` ile değiştirilir; gönderilmeyen alan `0` olur. Listede olmayan varyantlara dokunulmaz. Varyant düzeyinde `CurrencyId` okunmaz.\n\nBu uç nokta fiyatları doğrulamaz: `0`, negatif değer veya `Price` değerinden düşük bir `MarketPrice` kabul edilir. Bu tür sorunlar bu çağrıda değil, pazaryeri senkronizasyonu sırasında hata olarak ortaya çıkar.\n\nMiktarlar doğrulanmaz; negatif değerler reddedilmez.\n\nDeğerler önce StockMount'taki ürüne yazılır. Stok veya fiyat gerçekten değiştiyse, ürünün pazaryerlerindeki aktif ilanları için ilgili güncelleme (stok, fiyat veya ikisi) kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductQuantityAndPrice", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "ProductId": { "type": "integer", "description": "StockMount ürün kimliği. Ürün hesabınıza ait olmalıdır. Bu uç noktada `Code` yok sayılır." }, "Quantity": { "type": "integer", "description": "Ürünün yeni stok miktarı. Gönderilmezse `0` yazılır. `SetProductQuantityFromVariants` `true` ise ve `Variants` en az bir öğe içeriyorsa yok sayılır. Negatif değer reddedilmez." }, "SetProductQuantityFromVariants": { "type": "boolean", "description": "`true` ise ürün stoğu aktif varyantların toplamı olarak hesaplanır: listede gönderdiğiniz varyantlar için yeni miktar, diğer varyantlar için mevcut satılabilir stok kullanılır. `Variants` boşsa etkisizdir. Varsayılan `false`." }, "Price": { "type": "number", "description": "Ürünün satış fiyatı. 2 ondalık basamakla saklanır. Gönderilmezse `0` yazılır." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Ürünün ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Ürünün ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Ürünün ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Ürünün ek fiyatı 5. Gönderilmezse `0` yazılır." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği (`GetCurrencies`). 0'dan büyükse ürünün ve güncellenen varyantların para birimi bu değere çevrilir. Gönderilmezse veya `0` ise para birimi değişmez." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "Quantity": { "type": "integer", "description": "Varyantın yeni stok miktarı. Gönderilmezse `0` yazılır. Negatif değer reddedilmez." }, "Price": { "type": "number", "description": "Varyantın satış fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Varyantın ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Varyantın ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Varyantın ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Varyantın ek fiyatı 5. Gönderilmezse `0` yazılır." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "ProductId" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 184522, "SetProductQuantityFromVariants": true, "Price": 349.9, "MarketPrice": 449.9, "Price2": 329.9, "Price3": 0, "Price4": 0, "Price5": 0, "Variants": [ { "ProductVariantId": 9120344, "Quantity": 15, "Price": 349.9, "Price2": 329.9 }, { "Code": "TSHIRT-RED-L", "Quantity": 0, "Price": 359.9, "Price2": 339.9 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductQuantityAndPriceByCode": { "post": { "operationId": "UpdateProductQuantityAndPriceByCode", "tags": [ "Ürünler" ], "summary": "Ürün stoğunu ve fiyatını güncelle (ürün kodu ile)", "description": "**Ürün stoğunu ve fiyatını güncelle (ürün kodu ile)** — `Code` ve `ProductSourceId` ile bulunan ürünün ve isteğe bağlı olarak varyantlarının stok ve fiyatlarını tek çağrıda günceller.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz. Bir ürünün birden fazla varyantını `Variants` ile aynı çağrıda güncelleyebilirsiniz.\n\nÜrün `Code` + `ProductSourceId` ile bulunur; gönderdiğiniz `ProductId` yok sayılır. `Code` boşsa dönen `ErrorMessage` alanında `ProductId` yazar; bu, kodun eksik olduğu anlamına gelir.\n\nGönderdiğiniz miktar ürünün satılabilir stoğunun yerine geçer; StockMount'un o ana kadar saydığı satılan adet sıfırlanır. Yeni ürün stoğu 1'den küçükse ürünün `Status` değeri `3`, aksi halde `2` olur.\n\nÜrün düzeyindeki `Quantity` her çağrıda yazılır. `Quantity` göndermeden yalnızca varyant stoklarını gönderirseniz ve `SetProductQuantityFromVariants` alanını `true` yapmazsanız ürün stoğu `0` olur. Varyantlı ürünlerde `SetProductQuantityFromVariants: true` göndermeniz önerilir.\n\n`Price`, `MarketPrice` ve `Price2`–`Price5` her çağrıda istekteki değerle değiştirilir; göndermediğiniz alan `0` olur. Kullandığınız tüm fiyatları her seferinde gönderin.\n\n`Variants` içindeki her öğe `ProductVariantId` ile, bu yoksa varyant `Code` ile ürünün varyantlarıyla eşleştirilir. Eşleşen varyantın stoğu `Quantity`, fiyatları `Price` ve `Price2`–`Price5` ile değiştirilir; gönderilmeyen alan `0` olur. Listede olmayan varyantlara dokunulmaz. Varyant düzeyinde `CurrencyId` okunmaz.\n\nBu uç nokta fiyatları doğrulamaz: `0`, negatif değer veya `Price` değerinden düşük bir `MarketPrice` kabul edilir. Bu tür sorunlar bu çağrıda değil, pazaryeri senkronizasyonu sırasında hata olarak ortaya çıkar.\n\nMiktarlar doğrulanmaz; negatif değerler reddedilmez.\n\nDeğerler önce StockMount'taki ürüne yazılır. Stok veya fiyat gerçekten değiştiyse, ürünün pazaryerlerindeki aktif ilanları için ilgili güncelleme (stok, fiyat veya ikisi) kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductQuantityAndPriceByCode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "Code": { "type": "string", "description": "Ürün kodu (stok kodu), en fazla 50 karakter. Ürün, `Code` ve `ProductSourceId` birlikte kullanılarak bulunur. Bu uç noktada `ProductId` yok sayılır." }, "ProductSourceId": { "type": "integer", "description": "Ürünün bağlı olduğu ürün kaynağının kimliği (`GetProductSources`). `Code` bu kaynak içinde aranır." }, "Quantity": { "type": "integer", "description": "Ürünün yeni stok miktarı. Gönderilmezse `0` yazılır. `SetProductQuantityFromVariants` `true` ise ve `Variants` en az bir öğe içeriyorsa yok sayılır. Negatif değer reddedilmez." }, "SetProductQuantityFromVariants": { "type": "boolean", "description": "`true` ise ürün stoğu aktif varyantların toplamı olarak hesaplanır: listede gönderdiğiniz varyantlar için yeni miktar, diğer varyantlar için mevcut satılabilir stok kullanılır. `Variants` boşsa etkisizdir. Varsayılan `false`." }, "Price": { "type": "number", "description": "Ürünün satış fiyatı. 2 ondalık basamakla saklanır. Gönderilmezse `0` yazılır." }, "MarketPrice": { "type": "number", "description": "Piyasa (liste) fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Ürünün ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Ürünün ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Ürünün ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Ürünün ek fiyatı 5. Gönderilmezse `0` yazılır." }, "CurrencyId": { "type": "integer", "description": "Para birimi kimliği (`GetCurrencies`). 0'dan büyükse ürünün ve güncellenen varyantların para birimi bu değere çevrilir. Gönderilmezse veya `0` ise para birimi değişmez." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "Quantity": { "type": "integer", "description": "Varyantın yeni stok miktarı. Gönderilmezse `0` yazılır. Negatif değer reddedilmez." }, "Price": { "type": "number", "description": "Varyantın satış fiyatı. Gönderilmezse `0` yazılır." }, "Price2": { "type": "number", "description": "Varyantın ek fiyatı 2. Gönderilmezse `0` yazılır." }, "Price3": { "type": "number", "description": "Varyantın ek fiyatı 3. Gönderilmezse `0` yazılır." }, "Price4": { "type": "number", "description": "Varyantın ek fiyatı 4. Gönderilmezse `0` yazılır." }, "Price5": { "type": "number", "description": "Varyantın ek fiyatı 5. Gönderilmezse `0` yazılır." } } }, "description": "Güncellenecek varyantlar. Yalnızca listedeki varyantlar değişir; eşleşmeyen öğeler hata vermeden atlanır." } }, "required": [ "ApiCode", "Code", "ProductSourceId" ] }, "example": { "ApiCode": "{{apiCode}}", "Code": "TSHIRT-RED", "ProductSourceId": 3051, "SetProductQuantityFromVariants": true, "Price": 349.9, "MarketPrice": 449.9, "Price2": 329.9, "Price3": 0, "Price4": 0, "Price5": 0, "Variants": [ { "ProductVariantId": 9120344, "Quantity": 15, "Price": 349.9, "Price2": 329.9 }, { "Code": "TSHIRT-RED-L", "Quantity": 0, "Price": 359.9, "Price2": 339.9 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [ { "Code": "TSHIRT-RED-M", "ProductVariantId": 9120344 }, { "Code": "TSHIRT-RED-L", "ProductVariantId": 9120345 } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductName": { "post": { "operationId": "UpdateProductName", "tags": [ "Ürünler" ], "summary": "Ürün adını güncelle (ProductId ile)", "description": "**Ürün adını güncelle (ProductId ile)** — `ProductId` ile bulunan ürünün adını değiştirir.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz.\n\nÜrün yalnızca `ProductId` ile bulunur. Ürün kodu ile güncellemek için `ByCode` uç noktasını kullanın.\n\nYalnızca ürünün ana adı (`Name`) değişir. Stok, fiyat ve varyantlar değişmez; diğer alanlar yok sayılır. Tek istisna `CurrencyId`: 0'dan büyük gönderirseniz ürünün para birimi de değişir. Bu alanı göndermeyin.\n\nAd gerçekten değiştiyse, ürünün pazaryerlerindeki aktif ilanları için ürün güncellemesi kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductName", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "ProductId": { "type": "integer", "description": "StockMount ürün kimliği. Ürün hesabınıza ait olmalıdır. Bu uç noktada `Code` yok sayılır." }, "Name": { "type": "string", "description": "Ürünün yeni adı. Boş olamaz. 400 karakterden uzun değerler kesilir." } }, "required": [ "ApiCode", "ProductId", "Name" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 184522, "Name": "Pamuklu Basic T-Shirt Kırmızı" } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductNameByCode": { "post": { "operationId": "UpdateProductNameByCode", "tags": [ "Ürünler" ], "summary": "Ürün adını güncelle (ürün kodu ile)", "description": "**Ürün adını güncelle (ürün kodu ile)** — `Code` ve `ProductSourceId` ile bulunan ürünün adını değiştirir.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz.\n\nÜrün `Code` + `ProductSourceId` ile bulunur; gönderdiğiniz `ProductId` yok sayılır. `Code` boşsa dönen `ErrorMessage` alanında `ProductId` yazar; bu, kodun eksik olduğu anlamına gelir.\n\nYalnızca ürünün ana adı (`Name`) değişir. Stok, fiyat ve varyantlar değişmez; diğer alanlar yok sayılır. Tek istisna `CurrencyId`: 0'dan büyük gönderirseniz ürünün para birimi de değişir. Bu alanı göndermeyin.\n\nAd gerçekten değiştiyse, ürünün pazaryerlerindeki aktif ilanları için ürün güncellemesi kuyruğa alınır. Pazaryerleri bu çağrı sırasında değil, arka plandaki işlerle güncellenir.\n\nÜrün bulunamazsa veya hesabınıza ait değilse yanıt `Result: false`, `ErrorCode: \"70005\"` ve `ErrorMessage: \"ProductNotFound\"` olur. Veritabanı hatalarında `ErrorCode` `99999` olur.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductNameByCode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "Code": { "type": "string", "description": "Ürün kodu (stok kodu), en fazla 50 karakter. Ürün, `Code` ve `ProductSourceId` birlikte kullanılarak bulunur. Bu uç noktada `ProductId` yok sayılır." }, "ProductSourceId": { "type": "integer", "description": "Ürünün bağlı olduğu ürün kaynağının kimliği (`GetProductSources`). `Code` bu kaynak içinde aranır." }, "Name": { "type": "string", "description": "Ürünün yeni adı. Boş olamaz. 400 karakterden uzun değerler kesilir." } }, "required": [ "ApiCode", "Code", "ProductSourceId", "Name" ] }, "example": { "ApiCode": "{{apiCode}}", "Code": "TSHIRT-RED", "ProductSourceId": 3051, "Name": "Pamuklu Basic T-Shirt Kırmızı" } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "ProductId": { "type": "integer", "description": "Güncellenen ürünün kimliği." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Varyant kodu." }, "ProductVariantId": { "type": "integer", "description": "Varyant kimliği." } } }, "description": "Bu çağrıda güncellenen varyantlar. Varyant göndermediyseniz boş dizi döner." } } } } } ] }, "example": { "Result": true, "Response": { "ProductId": 184522, "Variants": [] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductImages": { "post": { "operationId": "UpdateProductImages", "tags": [ "Ürünler" ], "summary": "Ürün görsellerini güncelle", "description": "**Ürün görsellerini güncelle** — Ürünün görsel listesini (en fazla 12) ve isteğe bağlı olarak varyant görsellerini tamamen değiştirir.\n\nÜrün `ProductId` ile; `ProductId` 1'den küçükse `Code` + `ProductSourceId` ile bulunur. `UpdateProductImages` ve `UpdateProductImagesByCode` aynı kodu çalıştırır ve aynı alanları kabul eder; aralarında davranış farkı yoktur.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz.\n\nGörsel listesi tamamen değiştirilir: istekte olmayan mevcut görseller silinir, yeni görseller eklenir ve ürünün 1–12 numaralı görsel alanları istekteki sıraya göre yeniden yazılır. Kullanılmayan alanlar boşaltılır.\n\nİlk öğeden sonraki bir öğede ne `Url` ne `Base64` varsa çağrı `99999` ile başarısız olur.\n\nBase64 görseller StockMount görsel sunucusuna yüklenir ve kayıtlı adres `http://` ile başlar. Yükleme başarısız olursa görsel boş adresle kaydedilir ve hata dönmez.\n\nBu çağrı görsel biçimini veya protokolü kontrol etmez. Bazı pazaryerleri ilan gönderiminde `http(s)` dışındaki adresleri veya `.webp` görselleri reddeder (`70016`, `70015`); bu hatalar bu çağrıda değil, pazaryeri gönderiminde görünür.\n\nVaryant görsellerinin kaydedilip kaydedilmediği yanıta yansımaz: varyant görseli kaydedilemese de `Result: true` dönebilir.\n\nBu çağrı pazaryeri güncellemesi kuyruğa almaz. Görseller \"elle düzenlendi\" olarak işaretlenir; böylece ürün kaynağından (XML/feed) yapılan sonraki aktarımlar bu görselleri ezmez.\n\nUygulama bu uç nokta için ayrıca bir istek boyutu sınırı uygulamaz. Base64 görseller isteği büyütür; mümkünse `Url` kullanın.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductImages", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "ProductId": { "type": "integer", "description": "StockMount ürün kimliği. 1'den küçükse ürün `Code` + `ProductSourceId` ile bulunur." }, "Code": { "type": "string", "description": "Ürün kodu. `ProductId` gönderilmediğinde zorunludur." }, "ProductSourceId": { "type": "integer", "description": "Ürün kaynağının kimliği (`GetProductSources`). `Code` ile arama yapıldığında zorunludur." }, "Images": { "type": "array", "items": { "type": "object", "properties": { "Url": { "type": "string", "description": "Görselin adresi, en fazla 512 karakter. `//` ile başlıyorsa başına `http:` eklenir. Biçim ve protokol bu çağrıda kontrol edilmez." }, "Base64": { "type": "string", "description": "`Url` yoksa kullanılır. `data:` öneki olmadan, ham Base64 görsel verisi. PNG ve JPEG tanınır; diğerleri `.png` uzantısıyla kaydedilir." } } }, "description": "Ürünün yeni görsel listesi. En az bir öğe gerekir ve ilk öğede `Url` veya `Base64` dolu olmalıdır. En fazla 12 görsel kullanılır; fazlası yok sayılır. Sıra, dizideki sıradır; ilk görsel ana görseldir. Öğelerdeki `Order` alanı okunmaz." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "ImageUrl": { "type": "string", "description": "Varyantın görsel adresi, en fazla 512 karakter. `&` veya `<` gibi XML'e özel karakterler içeriyorsa varyant görseli kaydedilmez ve hata dönmez." }, "ImageBase64": { "type": "string", "description": "`ImageUrl` yoksa kullanılır. `data:` öneki olmadan, ham Base64 görsel verisi." } } }, "description": "İsteğe bağlı varyant görselleri. Listede olup görseli boş olan varyantın görseli silinir. Listede olmayan varyantlara dokunulmaz." } }, "required": [ "ApiCode", "Images" ] }, "example": { "ApiCode": "{{apiCode}}", "ProductId": 184522, "Images": [ { "Url": "https://cdn.example.com/p/184522-1.jpg" }, { "Url": "https://cdn.example.com/p/184522-2.jpg" } ], "Variants": [ { "Code": "TSHIRT-RED-M", "ImageUrl": "https://cdn.example.com/p/184522-red-m.jpg" } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "Response": { "type": "integer", "description": "`Response` doğrudan güncellenen ürünün kimliğidir (sayı)." } } } } } ] }, "example": { "Result": true, "Response": 184522 } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Product/UpdateProductImagesByCode": { "post": { "operationId": "UpdateProductImagesByCode", "tags": [ "Ürünler" ], "summary": "Ürün görsellerini güncelle (ürün kodu ile)", "description": "**Ürün görsellerini güncelle (ürün kodu ile)** — Ürünün görsel listesini (en fazla 12) ve isteğe bağlı olarak varyant görsellerini tamamen değiştirir; `UpdateProductImages` ile aynı şekilde çalışır.\n\nÜrün `ProductId` ile; `ProductId` 1'den küçükse `Code` + `ProductSourceId` ile bulunur. `UpdateProductImages` ve `UpdateProductImagesByCode` aynı kodu çalıştırır ve aynı alanları kabul eder; aralarında davranış farkı yoktur.\n\nHer çağrı tek bir ürünü günceller; birden fazla ürünü aynı çağrıda gönderemezsiniz.\n\nGörsel listesi tamamen değiştirilir: istekte olmayan mevcut görseller silinir, yeni görseller eklenir ve ürünün 1–12 numaralı görsel alanları istekteki sıraya göre yeniden yazılır. Kullanılmayan alanlar boşaltılır.\n\nİlk öğeden sonraki bir öğede ne `Url` ne `Base64` varsa çağrı `99999` ile başarısız olur.\n\nBase64 görseller StockMount görsel sunucusuna yüklenir ve kayıtlı adres `http://` ile başlar. Yükleme başarısız olursa görsel boş adresle kaydedilir ve hata dönmez.\n\nBu çağrı görsel biçimini veya protokolü kontrol etmez. Bazı pazaryerleri ilan gönderiminde `http(s)` dışındaki adresleri veya `.webp` görselleri reddeder (`70016`, `70015`); bu hatalar bu çağrıda değil, pazaryeri gönderiminde görünür.\n\nVaryant görsellerinin kaydedilip kaydedilmediği yanıta yansımaz: varyant görseli kaydedilemese de `Result: true` dönebilir.\n\nBu çağrı pazaryeri güncellemesi kuyruğa almaz. Görseller \"elle düzenlendi\" olarak işaretlenir; böylece ürün kaynağından (XML/feed) yapılan sonraki aktarımlar bu görselleri ezmez.\n\nUygulama bu uç nokta için ayrıca bir istek boyutu sınırı uygulamaz. Base64 görseller isteği büyütür; mümkünse `Url` kullanın.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nAktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.\n\nhttps://outsample.stockmount.com/tr/api/Product/UpdateProductImagesByCode", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`User/DoLogin` ile aldığınız API anahtarı." }, "ProductId": { "type": "integer", "description": "StockMount ürün kimliği. 1'den küçükse ürün `Code` + `ProductSourceId` ile bulunur." }, "Code": { "type": "string", "description": "Ürün kodu. `ProductId` gönderilmediğinde zorunludur." }, "ProductSourceId": { "type": "integer", "description": "Ürün kaynağının kimliği (`GetProductSources`). `Code` ile arama yapıldığında zorunludur." }, "Images": { "type": "array", "items": { "type": "object", "properties": { "Url": { "type": "string", "description": "Görselin adresi, en fazla 512 karakter. `//` ile başlıyorsa başına `http:` eklenir. Biçim ve protokol bu çağrıda kontrol edilmez." }, "Base64": { "type": "string", "description": "`Url` yoksa kullanılır. `data:` öneki olmadan, ham Base64 görsel verisi. PNG ve JPEG tanınır; diğerleri `.png` uzantısıyla kaydedilir." } } }, "description": "Ürünün yeni görsel listesi. En az bir öğe gerekir ve ilk öğede `Url` veya `Base64` dolu olmalıdır. En fazla 12 görsel kullanılır; fazlası yok sayılır. Sıra, dizideki sıradır; ilk görsel ana görseldir. Öğelerdeki `Order` alanı okunmaz." }, "Variants": { "type": "array", "items": { "type": "object", "properties": { "ProductVariantId": { "type": "integer", "description": "Varyant kimliği. Gönderilmezse veya `0` ise varyant `Code` ile bulunur." }, "Code": { "type": "string", "description": "Varyant kodu. `ProductVariantId` yoksa eşleştirme için kullanılır." }, "ImageUrl": { "type": "string", "description": "Varyantın görsel adresi, en fazla 512 karakter. `&` veya `<` gibi XML'e özel karakterler içeriyorsa varyant görseli kaydedilmez ve hata dönmez." }, "ImageBase64": { "type": "string", "description": "`ImageUrl` yoksa kullanılır. `data:` öneki olmadan, ham Base64 görsel verisi." } } }, "description": "İsteğe bağlı varyant görselleri. Listede olup görseli boş olan varyantın görseli silinir. Listede olmayan varyantlara dokunulmaz." } }, "required": [ "ApiCode", "Images" ] }, "example": { "ApiCode": "{{apiCode}}", "Code": "TSHIRT-RED", "ProductSourceId": 3051, "Images": [ { "Url": "https://cdn.example.com/p/184522-1.jpg" }, { "Base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==" } ], "Variants": [ { "ProductVariantId": 9120344, "ImageUrl": "https://cdn.example.com/p/184522-red-m.jpg" } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "Response": { "type": "integer", "description": "`Response` doğrudan güncellenen ürünün kimliğidir (sayı)." } } } } } ] }, "example": { "Result": true, "Response": 184522 } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/General/GetCurrencies": { "post": { "operationId": "GetCurrencies", "tags": [ "Genel ve listeler" ], "summary": "Para birimlerini listele", "description": "**Para birimlerini listele** — Sistemde aktif olan para birimlerini kimlik, kod ve adlarıyla döndürür.\n\nListe hesaba göre değişmez. Sayfalama yoktur ve sıralama garanti edilmez.\n\nYalnızca aktif para birimleri döner. İç kullanım için ayrılmış \"bilinmeyen\" kaydı (`CurrencyId` 1) listede yer almaz.\n\nPara birimi kimliği (`CurrencyId`) isteyen alanlarda bu listedeki değerleri kullanın. Kodda sabit tanımlı kimliklerden bazıları: 2 = ABD doları, 3 = Euro, 4 = Türk lirası.\n\nİstek gövdesinde yalnızca `ApiCode` okunur.\n\nhttps://outsample.stockmount.com/tr/api/General/GetCurrencies", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." } }, "required": [ "ApiCode" ] }, "example": { "ApiCode": "{{apiCode}}" } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "array", "items": { "type": "object", "properties": { "CurrencyId": { "type": "integer", "description": "Para birimi kimliği." }, "Code": { "type": "string", "description": "Para birimi kodu." }, "Name": { "type": "string", "description": "Para biriminin adı." } } } } } } ] }, "example": { "Result": true, "Response": [ { "CurrencyId": 2, "Code": "USD", "Name": "Amerikan Doları" }, { "CurrencyId": 3, "Code": "EUR", "Name": "Euro" }, { "CurrencyId": 4, "Code": "TRY", "Name": "Türk Lirası" } ] } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/GetStores": { "post": { "operationId": "GetStores", "tags": [ "Genel ve listeler" ], "summary": "Mağazaları listele", "description": "**Mağazaları listele** — Hesabınıza bağlı pazaryeri ve e-ticaret mağazalarını `StoreId` değerleriyle döndürür.\n\n`StoreId`, diğer uç noktalarda mağazayı belirtmek için kullandığınız kimliktir. `IntegrationId` mağazanın bağlı olduğu pazaryerini veya platformu gösterir.\n\nYalnızca panelde aktif görünen mağazalar listelenir. `IntegrationId` gönderirseniz yalnızca o entegrasyonun mağazaları döner. Bilinmeyen bir `IntegrationId` hata vermez, boş liste döner.\n\nSayfalama yoktur; tüm mağazalar tek yanıtta gelir. Sıralama garanti edilmez. `StoreName` boş olabilir.\n\nModeldeki `StoreId` istek alanı yok sayılır. `Integration/GetStore` aynı işi yapan eski bir takma addır; yeni entegrasyonlarda `GetStores` kullanın.\n\nhttps://outsample.stockmount.com/tr/api/Integration/GetStores", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "IntegrationId": { "type": "integer", "description": "İsteğe bağlı. Yalnızca bu entegrasyonun mağazalarını döndürür. Gönderilmezse veya 0 ise tüm mağazalar döner." } }, "required": [ "ApiCode" ] }, "example": { "ApiCode": "{{apiCode}}", "IntegrationId": 14 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "array", "items": { "type": "object", "properties": { "StoreId": { "type": "integer", "description": "Mağaza kimliği." }, "StoreName": { "type": "string", "description": "Mağazanın paneldeki adı. Boş olabilir." }, "IntegrationId": { "type": "integer", "description": "Mağazanın bağlı olduğu entegrasyonun kimliği." }, "IntegrationName": { "type": "string", "description": "Entegrasyonun adı (ör. `Trendyol`)." } } } } } } ] }, "example": { "Result": true, "Response": [ { "StoreId": 1234, "StoreName": "Örnek Mağaza", "IntegrationId": 14, "IntegrationName": "Trendyol" }, { "StoreId": 1240, "StoreName": "Örnek Mağaza Outlet", "IntegrationId": 14, "IntegrationName": "Trendyol" } ] } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/GetIntegrationShipmentCompanies": { "post": { "operationId": "GetIntegrationShipmentCompanies", "tags": [ "Genel ve listeler" ], "summary": "Kargo firmalarını listele", "description": "**Kargo firmalarını listele** — Pazaryerlerinin kabul ettiği kargo firmalarını ve kodlarını döndürür.\n\nKargo bilgisi gönderirken (`SetOrderShipmentInformation`) `ShipmentCompany` alanına bu listedeki `Code` değerini yazın.\n\n`IntegrationId` gönderirseniz yalnızca o entegrasyonun firmaları döner. Gönderilmezse veya 0 ise tüm entegrasyonların firmaları döner; bu liste uzundur.\n\nListe, entegrasyonun genel firmalarını ve yalnızca sizin mağazalarınız için tanımlı firmaları içerir. `Name` alanına göre sıralıdır. Sayfalama yoktur.\n\nhttps://outsample.stockmount.com/tr/api/Integration/GetIntegrationShipmentCompanies", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "IntegrationId": { "type": "integer", "description": "İsteğe bağlı. Kargo firmaları listelenecek entegrasyonun kimliği (`GetStores` yanıtındaki `IntegrationId`). Gönderilmezse veya 0 ise tümü döner." } }, "required": [ "ApiCode" ] }, "example": { "ApiCode": "{{apiCode}}", "IntegrationId": 2 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "array", "items": { "type": "object", "properties": { "IntegrationShipmentId": { "type": "integer", "description": "Kargo firması kaydının StockMount kimliği." }, "IntegrationId": { "type": "integer", "description": "Firmanın ait olduğu entegrasyonun kimliği." }, "Code": { "type": "string", "description": "Pazaryerindeki kargo firması kodu. `SetOrderShipmentInformation` çağrısında `ShipmentCompany` olarak gönderin." }, "Name": { "type": "string", "description": "Kargo firmasının adı." }, "ShortName": { "type": "string", "description": "Kısa ad. Boş olabilir." } } } } } } ] }, "example": { "Result": true, "Response": [ { "IntegrationShipmentId": 57, "IntegrationId": 2, "Code": "345", "Name": "Aras Kargo", "ShortName": "Aras" }, { "IntegrationShipmentId": 61, "IntegrationId": 2, "Code": "349", "Name": "Yurtiçi Kargo", "ShortName": "Yurtiçi" } ] } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/GetIntegrationOrderListingStatus": { "post": { "operationId": "GetIntegrationOrderListingStatus", "tags": [ "Genel ve listeler" ], "summary": "Sipariş durum kodlarını listele", "description": "**Sipariş durum kodlarını listele** — Entegrasyonların ve mağazaların kullandığı sipariş durumu kodlarını açıklamalarıyla döndürür.\n\nSonuç gruplar halinde gelir. Her grupta `IntegrationId`, `StoreId` ve `ListingStatuses` listesi bulunur. Entegrasyonun genel listesinde `StoreId` 0'dır; mağazaya özel listede mağazanın kimliğidir.\n\n`StoreId` gönderirseniz yalnızca o mağazanın durumları döner ve `IntegrationId` yok sayılır. Durumları sabit olan pazaryerlerinde pazaryerinin listesi, kendi durumlarını tanımlayan e-ticaret sitelerinde mağazanın kendi listesi gelir.\n\nYalnızca `IntegrationId` gönderirseniz o entegrasyonun durumları döner. İkisini de göndermezseniz kullandığınız tüm entegrasyonların ve mağazaların durumları döner. Genel gruplar önce, mağaza grupları sonra gelir. Bir entegrasyonun genel grubu, aynı entegrasyonun mağazaya özel durumlarını da tekrar içerebilir.\n\n`Code`, sipariş satırlarında görünen durum değeridir (ör. `GetOrderDetailStatus` yanıtındaki `OrderStatus`). `Description` her zaman Türkçedir. `Erp` değeri 1 ise bu durumdaki siparişler ERP/muhasebe aktarımına uygundur.\n\nHesabınıza ait olmayan bir `StoreId` `10001` döndürür. Bilinmeyen bir `IntegrationId` hata vermez, boş liste döner. Sayfalama yoktur.\n\nhttps://outsample.stockmount.com/tr/api/Integration/GetIntegrationOrderListingStatus", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "IntegrationId": { "type": "integer", "description": "İsteğe bağlı. Yalnızca bu entegrasyonun durumlarını döndürür. `StoreId` doluysa yok sayılır." }, "StoreId": { "type": "integer", "description": "İsteğe bağlı. Yalnızca bu mağazanın durumlarını döndürür (`GetStores` yanıtındaki `StoreId`)." } }, "required": [ "ApiCode" ] }, "example": { "ApiCode": "{{apiCode}}", "StoreId": 1234 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "array", "items": { "type": "object", "properties": { "IntegrationId": { "type": "integer", "description": "Entegrasyon kimliği." }, "StoreId": { "type": "integer", "description": "Mağaza kimliği. Entegrasyonun genel listesinde 0'dır." }, "ListingStatuses": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "description": "Durum kodu." }, "Description": { "type": "string", "description": "Durumun Türkçe açıklaması." }, "Erp": { "type": "integer", "description": "1: bu durumdaki siparişler ERP/muhasebe aktarımına uygundur. 0: uygun değildir.\n\n- `0`: ERP aktarımı yok\n- `1`: ERP aktarımına uygun" } } }, "description": "Bu gruptaki durumlar." } } } } } } ] }, "example": { "Result": true, "Response": [ { "IntegrationId": 14, "StoreId": 1234, "ListingStatuses": [ { "Code": "Created", "Description": "Yeni Sipariş", "Erp": 1 }, { "Code": "Shipped", "Description": "Kargoya Verildi", "Erp": 1 }, { "Code": "Cancelled", "Description": "İptal Edildi", "Erp": 0 } ] } ] } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/GetOrderDetailStatus": { "post": { "operationId": "GetOrderDetailStatus", "tags": [ "Genel ve listeler" ], "summary": "Sipariş satırı durumlarını sorgula", "description": "**Sipariş satırı durumlarını sorgula** — Verdiğiniz sipariş satırlarının güncel durum kodlarını döndürür.\n\n`OrderDetails` listesindeki her öğeden yalnızca `OrderDetailId` okunur; diğer alanlar yok sayılır.\n\nYalnızca sizin mağazalarınıza ait satırlar döner. Bulunamayan veya başka hesaba ait kimlikler hata vermeden atlanır. Yanıt sırası garanti edilmez.\n\nKodda liste uzunluğu için bir sınır yoktur. `OrderStatus` değerlerinin anlamı için `GetIntegrationOrderListingStatus` kullanın. Durum kaydı olmayan satırda `OrderStatus` boş gelir.\n\nhttps://outsample.stockmount.com/tr/api/Integration/GetOrderDetailStatus", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "OrderDetails": { "type": "array", "items": { "type": "object", "properties": { "OrderDetailId": { "type": "integer", "description": "Sipariş satırı kimliği (sipariş yanıtlarındaki `OrderDetailId`)." } }, "required": [ "OrderDetailId" ] }, "description": "Durumu sorgulanacak sipariş satırları. En az bir öğe gerekir." } }, "required": [ "ApiCode", "OrderDetails" ] }, "example": { "ApiCode": "{{apiCode}}", "OrderDetails": [ { "OrderDetailId": 9876543 }, { "OrderDetailId": 9876544 } ] } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "array", "items": { "type": "object", "properties": { "OrderId": { "type": "integer", "description": "Siparişin StockMount kimliği." }, "OrderDetailId": { "type": "integer", "description": "Sipariş satırı kimliği." }, "StoreId": { "type": "integer", "description": "Satırın ait olduğu mağazanın kimliği." }, "OrderStatus": { "type": "string", "description": "Satırın güncel durum kodu. Boş olabilir." } } } } } } ] }, "example": { "Result": true, "Response": [ { "OrderId": 4567890, "OrderDetailId": 9876543, "StoreId": 1234, "OrderStatus": "Shipped" }, { "OrderId": 4567890, "OrderDetailId": 9876544, "StoreId": 1234, "OrderStatus": "Created" } ] } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/GetUserMessages": { "post": { "operationId": "GetUserMessages", "tags": [ "Mesajlar" ], "summary": "Mesajları listele", "description": "**Mesajları listele** — Bir mağazanın pazaryerinden alınan mesajlarını tipe göre, en yeniden eskiye 20'şer kayıt halinde döndürür.\n\nMesajlar pazaryerinden StockMount'a aktarılmış kayıtlardır. Kodda mesaj aktarımı yalnızca N11 (`IntegrationId` 2) ve GittiGidiyor (1) mağazaları için vardır; diğer mağazalarda liste boş gelir.\n\nHer çağrı en fazla 20 mesaj döndürür, `Time` alanına göre en yeniden eskiye. Sayfa boyutu değiştirilemez.\n\nSayfalama kimlikle yapılır. Daha eski mesajlar için `SmallestIntegrationMessageId` alanına elinizdeki en küçük `UserMessageId` değerini gönderin; bu kimlikten küçük mesajlar gelir. Yeni mesajları almak için `BiggestIntegrationMessageId` alanına bildiğiniz en büyük `UserMessageId` değerini gönderin; bu kimlikten büyük mesajlar gelir. İki alan birlikte kullanılabilir.\n\nDikkat: Yalnızca `BiggestIntegrationMessageId` gönderdiğinizde 20'den fazla yeni mesaj varsa en yeni 20 mesaj gelir, aradakiler gelmez. Bu durumda `BiggestIntegrationMessageId` değerini koruyup `SmallestIntegrationMessageId` olarak son gelen en küçük kimliği göndererek geriye doğru devam edin.\n\n`MessageCount`, filtreye uyan toplam mesaj sayısıdır. Başka hesaba ait bir `StoreId` hata vermez, boş liste döner.\n\n`Integration/GetUserMessage` aynı işi yapan bir takma addır.\n\nhttps://outsample.stockmount.com/tr/api/Integration/GetUserMessages", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "StoreId": { "type": "integer", "description": "Mesajları listelenecek mağazanın kimliği (`GetStores`)." }, "MessageTypeId": { "type": "integer", "description": "Mesaj tipi.\n\n- `1`: Gelen\n- `2`: Gönderilen\n- `3`: Silinmiş gelen\n- `4`: Silinmiş gönderilen" }, "SmallestIntegrationMessageId": { "type": "integer", "description": "İsteğe bağlı. Yalnızca `UserMessageId` değeri bundan küçük (daha eski) mesajları döndürür." }, "BiggestIntegrationMessageId": { "type": "integer", "description": "İsteğe bağlı. Yalnızca `UserMessageId` değeri bundan büyük (daha yeni) mesajları döndürür." } }, "required": [ "ApiCode", "StoreId", "MessageTypeId" ] }, "example": { "ApiCode": "{{apiCode}}", "StoreId": 1234, "MessageTypeId": 1, "SmallestIntegrationMessageId": 88120 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "MessageCount": { "type": "integer", "description": "Filtreye uyan toplam mesaj sayısı (dönen mesaj sayısı değil)." }, "Messages": { "type": "array", "items": { "type": "object", "properties": { "UserMessageId": { "type": "integer", "description": "Mesajın StockMount kimliği. Sayfalama ve `SetMessageRead` için kullanılır." }, "Code": { "type": "string", "description": "Mesajın pazaryerindeki kodu. N11 sorularında soru kimliğidir; yanıtlarken `UserMessageCode` olarak gönderin." }, "Subject": { "type": "string", "description": "Mesaj konusu." }, "From": { "type": "string", "description": "Gönderen (gelen mesajlarda alıcının pazaryeri kullanıcı adı)." }, "To": { "type": "string", "description": "Alıcı." }, "MessageTypeId": { "type": "integer", "description": "Mesaj tipi.\n\n- `1`: Gelen\n- `2`: Gönderilen\n- `3`: Silinmiş gelen\n- `4`: Silinmiş gönderilen" }, "Avatar": { "type": "string", "description": "Alıcının görseli. Çoğunlukla boştur." }, "Body": { "type": "string", "description": "Mesaj metni." }, "Time": { "type": "string", "description": "Mesaj zamanı, UTC olarak ISO 8601 biçiminde (ör. `2026-11-05T08:42:10Z`)." }, "Unread": { "type": "boolean", "description": "`true`: mesaj okunmadı." }, "Surname": { "type": "string", "description": "Alıcının soyadı. Boş olabilir." }, "Name": { "type": "string", "description": "Alıcının adı. Ad ve soyad kayıtlı değilse mesajdaki tam ad gelir." } } }, "description": "Mesajlar, en yeniden eskiye." } } } } } ] }, "example": { "Result": true, "Response": { "MessageCount": 57, "Messages": [ { "UserMessageId": 88119, "Code": "301245678", "Subject": "Ürün sorusu", "From": "alici_123", "To": "ornekmagaza", "MessageTypeId": 1, "Avatar": "", "Body": "Bu ürün stokta var mı?", "Time": "2026-11-05T08:42:10Z", "Unread": true, "Surname": "", "Name": "Mehmet K." } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/GetAllUserMessage": { "post": { "operationId": "GetAllUserMessage", "tags": [ "Mesajlar" ], "summary": "Bir alıcıyla yazışmayı getir", "description": "**Bir alıcıyla yazışmayı getir** — Bir mağazada belirli bir alıcıdan gelen ve ona gönderilen mesajları tek listede döndürür.\n\nİki sorgu birleştirilir: `From` alanı `User` ile eşleşen gelen mesajlar (tip 1) ve `To` alanı `User` ile eşleşen gönderilen mesajlar (tip 2). Silinmiş mesajlar dahil değildir.\n\nHer sorgudan en fazla 20 mesaj alınır; yanıt en fazla 40 mesaj içerir ve en yeniden eskiye sıralıdır. Sayfalama yoktur. `MessageCount` iki sorgunun toplam kayıt sayılarının toplamıdır.\n\n`User` eşleşmesi tam eşitlik değil, tam metin aramasıdır; benzer kullanıcı adları da eşleşebilir. `MessageTypeId`, `BiggestIntegrationMessageId` ve `SmallestIntegrationMessageId` bu uç noktada yok sayılır.\n\nMesajlar yalnızca N11 ve GittiGidiyor mağazaları için aktarılır. Başka hesaba ait bir `StoreId` boş liste döndürür.\n\nhttps://outsample.stockmount.com/tr/api/Integration/GetAllUserMessage", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "StoreId": { "type": "integer", "description": "Mağaza kimliği (`GetStores`)." }, "User": { "type": "string", "description": "Alıcının pazaryeri kullanıcı adı (mesajlardaki `From`/`To` değeri)." } }, "required": [ "ApiCode", "StoreId", "User" ] }, "example": { "ApiCode": "{{apiCode}}", "StoreId": 1234, "User": "alici_123" } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "type": "object", "properties": { "MessageCount": { "type": "integer", "description": "Filtreye uyan toplam mesaj sayısı (dönen mesaj sayısı değil)." }, "Messages": { "type": "array", "items": { "type": "object", "properties": { "UserMessageId": { "type": "integer", "description": "Mesajın StockMount kimliği. Sayfalama ve `SetMessageRead` için kullanılır." }, "Code": { "type": "string", "description": "Mesajın pazaryerindeki kodu. N11 sorularında soru kimliğidir; yanıtlarken `UserMessageCode` olarak gönderin." }, "Subject": { "type": "string", "description": "Mesaj konusu." }, "From": { "type": "string", "description": "Gönderen (gelen mesajlarda alıcının pazaryeri kullanıcı adı)." }, "To": { "type": "string", "description": "Alıcı." }, "MessageTypeId": { "type": "integer", "description": "Mesaj tipi.\n\n- `1`: Gelen\n- `2`: Gönderilen\n- `3`: Silinmiş gelen\n- `4`: Silinmiş gönderilen" }, "Avatar": { "type": "string", "description": "Alıcının görseli. Çoğunlukla boştur." }, "Body": { "type": "string", "description": "Mesaj metni." }, "Time": { "type": "string", "description": "Mesaj zamanı, UTC olarak ISO 8601 biçiminde (ör. `2026-11-05T08:42:10Z`)." }, "Unread": { "type": "boolean", "description": "`true`: mesaj okunmadı." }, "Surname": { "type": "string", "description": "Alıcının soyadı. Boş olabilir." }, "Name": { "type": "string", "description": "Alıcının adı. Ad ve soyad kayıtlı değilse mesajdaki tam ad gelir." } } }, "description": "Mesajlar, en yeniden eskiye." } } } } } ] }, "example": { "Result": true, "Response": { "MessageCount": 2, "Messages": [ { "UserMessageId": 88131, "Code": "301245678_ANSWER_14", "Subject": "Ürün sorusu", "From": "ornekmagaza", "To": "alici_123", "MessageTypeId": 2, "Avatar": "", "Body": "Merhaba, ürün stoktadır.", "Time": "2026-11-05T09:10:14Z", "Unread": false, "Surname": "", "Name": "Mehmet K." }, { "UserMessageId": 88119, "Code": "301245678", "Subject": "Ürün sorusu", "From": "alici_123", "To": "ornekmagaza", "MessageTypeId": 1, "Avatar": "", "Body": "Bu ürün stokta var mı?", "Time": "2026-11-05T08:42:10Z", "Unread": true, "Surname": "", "Name": "Mehmet K." } ] } } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/SetMessageRead": { "post": { "operationId": "SetMessageRead", "tags": [ "Mesajlar" ], "summary": "Mesajı okundu işaretle", "description": "**Mesajı okundu işaretle** — Bir mesajı StockMount'ta okundu olarak işaretler.\n\nDesteklenen entegrasyon N11'dir (`IntegrationId` 2). Mesaj yalnızca StockMount'ta okundu olarak işaretlenir; N11'e bir istek gönderilmez.\n\n`IntegrationId` için 1 (GittiGidiyor) ve 2 (N11) dışındaki değerler `99999` döndürür ve `ErrorMessage` boş gelir.\n\nİşaretlenecek mesajı `UserMessageId` ile belirtin. Mesaj bulunamasa da yanıt başarılıdır (`Result: true`); sonucu doğrulamak için `GetUserMessages` yanıtındaki `Unread` alanına bakın.\n\nBaşarılı yanıtta `Response` alanı gelmez.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nhttps://outsample.stockmount.com/tr/api/Integration/SetMessageRead", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "StoreId": { "type": "integer", "description": "Mesajın ait olduğu mağazanın kimliği." }, "IntegrationId": { "type": "integer", "description": "Mağazanın entegrasyon kimliği. N11 için 2." }, "UserMessageId": { "type": "integer", "description": "Okundu işaretlenecek mesajın `UserMessageId` değeri. Doğrulanmaz; gönderilmezse hiçbir mesaj değişmez ama yanıt yine başarılıdır." } }, "required": [ "ApiCode", "StoreId", "IntegrationId" ] }, "example": { "ApiCode": "{{apiCode}}", "StoreId": 1234, "IntegrationId": 2, "UserMessageId": 88119 } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "nullable": true } } } ] }, "example": { "Result": true } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } }, "/api/Integration/SendUserMessage": { "post": { "operationId": "SendUserMessage", "tags": [ "Mesajlar" ], "summary": "Mesajı yanıtla", "description": "**Mesajı yanıtla** — Pazaryerindeki bir alıcı sorusunu yanıtlar ve yanıtı StockMount'a gönderilen mesaj olarak kaydeder.\n\nDesteklenen entegrasyon N11'dir (`IntegrationId` 2). Yalnızca var olan bir ürün sorusu yanıtlanabilir; yeni bir yazışma başlatılamaz. Yanıtlanacak sorunun `Code` değerini `UserMessageCode` alanında gönderin; bu değer sayısal olmalıdır.\n\nGönderimden sonra yanıt, gönderilen mesaj (tip 2) olarak kaydedilir ve kodu `{soruKodu}_ANSWER_{n}` biçimini alır. Yanıtlanan soru kapatılır.\n\n`SetMessageRead` `true` ise `UserMessageId` ile belirtilen soru ayrıca okundu olarak işaretlenir.\n\n`Subject` ve `From` alanlarını da gönderin. Bu alanlar eksikse yanıt N11'e iletilebilir ama StockMount'a kaydedilemez ve `99999` döner; bu durumda isteği tekrarlamadan önce N11'de yanıtı kontrol edin.\n\nBaşarılı yanıt, N11'in yanıtı kabul ettiğini garanti etmez: N11 isteği başlatılır ancak N11'in sonucu beklenmez. N11 tarafındaki hatalar bu uç noktaya yansımaz.\n\n`IntegrationId` için 1 ve 2 dışındaki değerler `99999` döndürür ve `ErrorMessage` boş gelir. Başarılı yanıtta `Response` alanı gelmez.\n\n⚠ Bu servis hesabınızdaki gerçek verileri değiştirir.\n\nhttps://outsample.stockmount.com/tr/api/Integration/SendUserMessage", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ApiCode": { "type": "string", "description": "`DoLogin` yanıtından aldığınız oturum kodu." }, "StoreId": { "type": "integer", "description": "Sorunun ait olduğu mağazanın kimliği." }, "IntegrationId": { "type": "integer", "description": "Mağazanın entegrasyon kimliği. N11 için 2." }, "UserMessageCode": { "type": "string", "description": "Yanıtlanacak sorunun `Code` değeri (N11 soru kimliği, sayısal). N11 için zorunludur." }, "Message": { "type": "string", "description": "Yanıt metni." }, "To": { "type": "string", "description": "Alıcının kullanıcı adı (sorudaki `From` değeri). Kayıtta alıcı olarak saklanır." }, "From": { "type": "string", "description": "Gönderen olarak kaydedilecek değer (ör. mağaza adınız). Gönderilmezse kayıt başarısız olur." }, "Subject": { "type": "string", "description": "Kaydedilecek konu (ör. sorunun `Subject` değeri). Gönderilmezse kayıt başarısız olur." }, "SetMessageRead": { "type": "boolean", "description": "İsteğe bağlı. `true` ise soru ayrıca okundu işaretlenir. Varsayılan `false`." }, "UserMessageId": { "type": "integer", "description": "Yanıtlanan sorunun `UserMessageId` değeri. `SetMessageRead` `true` ise kullanılır." } }, "required": [ "ApiCode", "StoreId", "IntegrationId", "UserMessageCode", "Message", "To" ] }, "example": { "ApiCode": "{{apiCode}}", "StoreId": 1234, "IntegrationId": 2, "UserMessageCode": "301245678", "UserMessageId": 88119, "To": "alici_123", "From": "ornekmagaza", "Subject": "Ürün sorusu", "Message": "Merhaba, ürün stoktadır.", "SetMessageRead": true } } } }, "responses": { "200": { "description": "İş hataları da HTTP 200 ile döner; Result alanını kontrol edin.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ResultInfo" }, { "type": "object", "properties": { "Response": { "nullable": true } } } ] }, "example": { "Result": true } } } }, "400": { "description": "Gövde geçerli bir JSON değil (ProblemDetails)." } } } } }, "components": { "schemas": { "ResultInfo": { "type": "object", "properties": { "Result": { "type": "boolean" }, "Message": { "type": "string", "nullable": true }, "ErrorMessage": { "type": "string", "nullable": true }, "ErrorCode": { "type": "string", "nullable": true }, "Response": { "nullable": true } } } } } }