Tedarikçi ürünlerini listele (v2)

POST /PIM/Vendor/Products/v2 — PIM API · Tedarikçi Ürünleri

Tedarikçi ürünlerini listele ile aynı süzme ve sayfalama kurallarını kullanır; farkları:

  • SelectedColumns dizi (["merchantSku", "title"]) veya nesne ({"merchantSku": true, "title": false}) olabilir; nesnede yalnızca true olanlar seçilir.
  • Ürünün Sku, Barcode, Option ve Model alanları tedarikçinin kendi kodlarıyla (merchantSku, merchantBarcode, merchantOptionCode, merchantModel) doldurulur.
  • Yanıtta yalnızca seçilen sütunlar döner; baseUnitOfMeasure gönderilmemişse ADT değeriyle eklenir.

Parametreler

  • isPre (query, boolean): true: tedarikçi aday ürün tabloları; false: PIM ana ürünleri (yalnız yönetici).
  • includeParents (query, boolean): true ise SKU'ların üst kayıtlarındaki (model/option) değerler de sütunlara dahil edilir.
  • Tenant (header, string): Basic Auth ile birden fazla firmaya erişen kullanıcılarda firma kodu. Bearer token kullanılıyorsa gerekmez.

İstek gövdesi

  • Page (integer): Sayfa numarası (1'den başlar).
  • PageSize (integer): Sayfa başına ürün sayısı (en fazla 1000).
  • SortedColumn (object): Sıralama; gönderilmezse varsayılan sıralama kullanılır.
    • SortedColumn.Type (string): Sıralama yönü (asc veya desc).
    • SortedColumn.Column (string): Sıralanacak sütun adı.
  • FilteredColumns (object[]): Süzgeçler; hepsi birlikte (VE) uygulanır.
    • FilteredColumns.Type (integer): Eşleşme tipi: 0 tam eşleşme, 1 içerir.
    • FilteredColumns.Value (any, zorunlu): Aranan değer (metin, sayı veya mantıksal).
    • FilteredColumns.Column (string, zorunlu): Süzülecek sütun adı (ör. isApproved, hasExternalBarcode, merchantSku).
  • SelectedColumns (oneOf, zorunlu): Dönecek sütunlar; dizi veya sütun → true/false nesnesi.

Yanıtlar

  • 200: Sayfalı ürün listesi.
  • 400: İstek gövdesi geçerli JSON değil veya alan tipleri uyumsuz.
  • 401: Kimlik doğrulanamadı (başlık yok, Basic bilgileri hatalı veya token geçersiz). Gövde boştur.
  • 500: Sunucu tarafında beklenmeyen hata.

200 yanıt alanları

  • Products (object[]): Bu sayfadaki ürünler.
    • Products.Id (integer): Ürün kimliği.
    • Products.Sku (string): SKU kodu.
    • Products.Type (integer): Ürün tipi (1 Model, 2 Option, 3 SKU, 4 Tekil, 5 Bundle).
    • Products.Model (string): Model kodu.
    • Products.Option (string): Option kodu.
    • Products.Barcode (string): Barkod.
    • Products.Columns (object[]): Seçilen sütunların değerleri.
      • Products.Columns.Value (string): Değer (metin olarak).
      • Products.Columns.Column (string): Sütun adı.
      • Products.Columns.Culture (string): Değerin dili.
    • Products.CreatedOn (string): Oluşturulma zamanı (yyyy-MM-dd HH:mm:ss).
    • Products.CreateDate (string<date-time>): Kullanılmıyor; sabit varsayılan değer döner. CreatedOn alanını kullanın.
    • Products.ModifiedOn (string): Son güncellenme zamanı (yyyy-MM-dd HH:mm:ss).
    • Products.LastBarcode (string): Ürüne en son eklenen barkod.
  • TotalPage (integer): Toplam sayfa sayısı; yalnızca Page: 1 isteğinde dolar.
  • TotalProduct (integer): Süzgece uyan toplam ürün; yalnızca Page: 1 isteğinde dolar.