Tedarikçi ürünlerini listele

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

Tedarikçi ürünlerini filtreleyip sayfalı olarak döner. Hangi alanların döneceği SelectedColumns, süzme FilteredColumns ile belirlenir.

• isPre=true: tedarikçinin gönderdiği aday ürünler (onay öncesi ve onaylı tedarikçi kayıtları). Tedarikçi ve ERP kullanıcıları bu değeri kullanır.
• isPre=false (varsayılan): PIM'deki ana ürünler. Yalnızca yönetici yetkili kullanıcılar çağırabilir; diğer kullanıcılar 500 alır.
• PageSize en fazla 1000 olabilir; Page 1'den başlar.
• TotalPage ve TotalProduct yalnızca Page: 1 isteğinde doldurulur.

Sık kullanılan sütunlar: merchantSku, merchantBarcode, vendorCode, supplierId, isApproved, isRejected, externalBarcode, externalCode, listPrice, salePrice, stock, assetid ve PIM nitelik anahtarları. Onaylanmış ama ERP barkodu bağlanmamış ürünleri bulmak için isApproved = true ve hasExternalBarcode = false süzgeci kullanılır.

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 (string[], zorunlu): Yanıtta Columns içinde dönecek sütun adları.

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: invalid page, pagesize exceeded. max: 1000 veya yetkisiz isPre=false çağrısı.

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.