Ürün yönetimi

1. Ürün kaynağını seçin

StockMount'ta her ürün bir ürün kaynağına bağlıdır ve ürün kodu kaynak içinde tekildir. API ile ürün ekleyip güncelleyebileceğiniz kaynakları GetProductSources listeler; diğer çağrılarda bu listedeki ProductSourceId değerini kullanın. XML, pazaryeri veya Excel kaynakları bu listede yer almaz.

Kategoriler serbest metindir. Category alanında kaynakta olmayan bir ad gönderirseniz kategori kendiliğinden oluşur. Mevcut adları GetProductCategories ile görebilirsiniz. Para birimi kimliklerini GetCurrencies verir.

2. Ürün ekleyin

AddProduct için zorunlu alanlar: ProductSourceId, Code, Name, Category, CurrencyId ve sıfırdan büyük Price. Varyantları, görselleri ve özellikleri aynı çağrıda gönderebilirsiniz.

Varyant eksenlerini ürün üzerinde VariantName1–VariantName6 ile, her varyantın değerlerini VariantValue1–VariantValue6 ile tanımlayın. Varyant Code alanı sonraki güncellemelerde eşleştirme anahtarıdır; her varyant için dolu ve benzersiz gönderin.

{
  "ApiCode": "API_CODE",
  "ProductSourceId": 1234,
  "Code": "TSHIRT-001",
  "Name": "Basic Pamuklu Tişört",
  "Category": "Tişört",
  "Price": 249.90,
  "CurrencyId": 4,
  "TaxRate": 20,
  "Brand": "Örnek Marka",
  "VariantName1": "Renk",
  "VariantName2": "Beden",
  "Images": [
    { "Url": "https://cdn.example.com/tshirt-001-1.jpg" }
  ],
  "Variants": [
    { "Code": "TSHIRT-001-BLK-M", "Barcode": "8690000000024", "Quantity": 10, "Price": 249.90, "VariantValue1": "Siyah", "VariantValue2": "M" },
    { "Code": "TSHIRT-001-BLK-L", "Barcode": "8690000000031", "Quantity": 20, "Price": 249.90, "VariantValue1": "Siyah", "VariantValue2": "L" }
  ],
  "Specs": [
    { "Name": "Materyal", "Value": "Pamuk" }
  ]
}

Aynı çağrıyla “yoksa ekle, varsa güncelle” yapmak için UpdateProductByCode: true gönderin. Kod kaynakta varsa ürün UpdateProduct kurallarıyla güncellenir.

Görsel, varyant ve özellik kayıtları ürün kaydedildikten sonra yapılır; bunlardaki sorunlar yanıta her zaman yansımaz. Eklemeden sonra ürünü GetProduct ile okuyup kontrol etmenizi öneririz.

3. Ürünü güncelleyin

UpdateProduct kısmi güncelleme değildir: ürünü gönderdiğiniz değerlerle baştan yazar. Gönderilmeyen isteğe bağlı alanlar (barkod, marka, açıklama vb.) temizlenir, panelde yönetilen satış adedi ve SEO alanları gibi değerler sıfırlanır. Görseller, Price2–Price5 ve ürün kodu bu çağrıyla değişmez.

Varyantlar Code ile eşleştirilir: eşleşenler güncellenir, yeni kodlar eklenir, listede olmayan mevcut varyantlar pasife alınır.

Yalnızca bir alanı değiştirmek istiyorsanız daha dar servisleri kullanın:

• Stok ve fiyat: Stok ve fiyat senkronu
• Ad: UpdateProductNameByCode veya UpdateProductName
• Görseller: UpdateProductImagesByCode veya UpdateProductImages
• Ürün kodu: SetProductCode

4. Görseller

• Bir ürüne en fazla 12 görsel eklenir; sıra dizideki sıradır.
• Mümkünse herkese açık bir https adresi (Url) gönderin. Base64 gönderirseniz görsel StockMount sunucusuna yüklenir; istek büyür ve yavaşlar.
• Görsel güncelleme servisleri listenin tamamını değiştirir: istekte olmayan görseller silinir.
• API görsel biçimini kontrol etmez. Bazı pazaryerleri .webp veya https olmayan adresleri reddeder; bu hatalar ürün pazaryerine gönderilirken panelde görünür.

5. Ürünü satıştan kaldırın

API ile ürün silinemez; DeleteProduct 1 Temmuz 2025'te kaldırıldı ve HTTP 410 döner. Ürünü satıştan kaldırmak için StopProduct kullanın ya da stoğunu 0 yapın. Durdurulan ürünü yeniden açmak için UpdateProduct ile sıfırdan büyük stok gönderin.

6. Ürünleri okuyun

• GetProduct: tek ürün, görseller, varyantlar ve özelliklerle. Varyant ve özellikler yalnızca ProductId ile sorguda döner.
• GetProducts: filtreli ve sayfalı liste; sayfa başına en fazla 100 ürün.
• GetProductSummary: kaynaktaki tüm ürünlerin kimliği, kodu, adı, barkodu ve durumu tek yanıtta. Kendi ürünlerinizi StockMount ProductId değerleriyle eşleştirmek için uygundur.

Pazaryeri kontrolleri

Ürün servisleri pazaryerine özel kuralları (zorunlu marka, barkod biçimi, KDV oranı, katalog onayı, görsel biçimi) kontrol etmez. Bu kontroller ürün pazaryerine gönderilirken yapılır ve sonuçları StockMount panelinde görünür. Kurallar pazaryerine göre değişir.