List vendor products (v2)

POST /PIM/Vendor/Products/v2 — PIM API · Vendor Products

Uses the same filtering and pagination rules as List vendor products; differences:

  • SelectedColumns can be an array (["merchantSku", "title"]) or an object ({"merchantSku": true, "title": false}); only those set to true in the object are selected.
  • The product's Sku, Barcode, Option, and Model fields are filled with the vendor's own codes (merchantSku, merchantBarcode, merchantOptionCode, merchantModel).
  • Only the selected columns are returned in the response; if baseUnitOfMeasure is not sent, it is added with the value ADT.

Parametreler

  • isPre (query, boolean): true: vendor candidate product tables; false: PIM main products (admin only).
  • includeParents (query, boolean): If true, values from parent records of SKUs (model/option) are also included in the columns.
  • Tenant (header, string): Company code for users accessing multiple companies via Basic Auth. Not required if using Bearer token.

İstek gövdesi

  • Page (integer): Page number (starting from 1).
  • PageSize (integer): Number of products per page (maximum 1000).
  • SortedColumn (object): Sorting; default sorting is used if not sent.
    • SortedColumn.Type (string): Sort direction (asc or desc).
    • SortedColumn.Column (string): Column name to sort by.
  • FilteredColumns (object[]): Filters; all applied together (AND).
    • FilteredColumns.Type (integer): Match type: 0 exact match, 1 contains.
    • FilteredColumns.Value (any, zorunlu): Value to search for (text, number, or boolean).
    • FilteredColumns.Column (string, zorunlu): Column name to filter (e.g. isApproved, hasExternalBarcode, merchantSku).
  • SelectedColumns (oneOf, zorunlu): Columns to return; array or column → true/false object.

Yanıtlar

  • 200: Paged product list.
  • 400: Request body is not valid JSON or field types are incompatible.
  • 401: Authentication failed (missing header, incorrect Basic credentials, or invalid token). Body is empty.
  • 500: Unexpected server-side error.

200 yanıt alanları

  • Products (object[]): Products on this page.
    • Products.Id (integer): Product ID.
    • Products.Sku (string): SKU code.
    • Products.Type (integer): Product type (1 Model, 2 Option, 3 SKU, 4 Single, 5 Bundle).
    • Products.Model (string): Model code.
    • Products.Option (string): Option code.
    • Products.Barcode (string): Barcode.
    • Products.Columns (object[]): Values of the selected columns.
      • Products.Columns.Value (string): Value (as text).
      • Products.Columns.Column (string): Column name.
      • Products.Columns.Culture (string): Language of the value.
    • Products.CreatedOn (string): Creation time (yyyy-MM-dd HH:mm:ss).
    • Products.CreateDate (string<date-time>): Not used; returns a fixed default value. Use the CreatedOn field.
    • Products.ModifiedOn (string): Last update time (yyyy-MM-dd HH:mm:ss).
    • Products.LastBarcode (string): Most recently added barcode to the product.
  • TotalPage (integer): Total number of pages; only filled in Page: 1 request.
  • TotalProduct (integer): Total products matching the filter; only filled in Page: 1 request.