# catalog.product.sku.list URL: https://chugunov.pro/api-bitrix24/catalog/product/sku/catalog-product-sku-list/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Получить список головных товаров Scope: `catalog` Кто может выполнять метод: администратор ## Описание Метод возвращает список головных товаров по фильтру. ## Параметры - `select` `array` — необязательный. Массив со списком полей, которые необходимо выбрать (смотрите поля объекта [catalog_product_sku](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_sku)). Обязательные поля: `id`, `iblockId` - `filter` `object` — необязательный. Объект для фильтрации выбранных головных товаров в формате `{"field_1": "value_1", ... "field_N": "value_N"}`. Возможные значения для `field` соответствуют полям объекта [catalog_product_sku](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_sku). Обязательные поля: `iblockId`. Ключу можно задать дополнительный префикс, уточняющий поведение фильтра. Возможные значения префикса: - `>=` — больше либо равно - `>` — больше - `<=` — меньше либо равно - `<` — меньше - `%` — LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно. Поиск ищет подстроку в любой позиции строки - `=%` — LIKE, поиск по подстроке. Символ `%` нужно передавать в значении. Примеры: - `"мол%"` — ищет значения, начинающиеся с «мол» - `"%мол"` — ищет значения, заканчивающиеся на «мол» - `"%мол%"` — ищет значения, где «мол» может быть в любой позиции - `%=` — LIKE (аналогично `=%`) - `!%` — NOT LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно. Поиск идет с обеих сторон - `!=%` — NOT LIKE, поиск по подстроке. Символ `%` нужно передавать в значении. Примеры: - `"мол%"` — ищет значения, не начинающиеся с «мол» - `"%мол"` — ищет значения, не заканчивающиеся на «мол» - `"%мол%"` — ищет значения, где подстроки «мол» нет в любой позиции - `!%=` — NOT LIKE (аналогично `!=%`) - `=` — равно, точное совпадение (используется по умолчанию). Для поиска IN можно передавать несколько значений массивом - `!=` — не равно - `!` — не равно. Для поиска NOT IN можно передавать несколько значений массивом - `order` `object` — необязательный. Объект для сортировки выбранных головных товаров в формате `{"field_1": "order_1", ... "field_N": "order_N"}`. Возможные значения для `field` соответствуют полям объекта [catalog_product_sku](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_sku). Возможные значения для `order`: - `asc` — в порядке возрастания - `desc` — в порядке убывания - `start` `integer` — необязательный. Параметр используется для управления постраничной навигацией. Размер страницы результатов всегда статичный — 50 записей. Чтобы выбрать вторую страницу результатов, передайте значение `50`. Чтобы выбрать третью страницу результатов — значение `100` и так далее. Формула расчета значения параметра `start`: `start = (N-1) * 50`, где `N` — номер нужной страницы ## Ответ HTTP-статус: 200 ```json { "result": { "units": [ { "active": "Y", "available": "N", "bundle": "N", "canBuyZero": "N", "code": "product_sku", "createdBy": 1, "dateActiveFrom": "2024-05-28T10:00:00+03:00", "dateActiveTo": "2024-05-29T10:00:00+03:00", "dateCreate": "2024-05-27T10:00:00+03:00", "detailPicture": { "id": "6546", "url": "\/rest\/catalog.product.download?fields%5BfieldName%5D=detailPicture\u0026fields%5BfileId%5D=6546\u0026fields%5BproductId%5D=1289", "urlMachine": "\/rest\/catalog.product.download?fields%5BfieldName%5D=detailPicture\u0026fields%5BfileId%5D=6546\u0026fields%5BproductId%5D=1289" }, "detailText": null, "detailTextType": "text", "height": null, "iblockId": 23, "iblockSectionId": 47, "id": 1289, "length": null, "measure": null, "modifiedBy": 1, "name": "Головной товар", "previewPicture": { "id": "6545", "url": "\/rest\/catalog.product.download?fields%5BfieldName%5D=previewPicture\u0026fields%5BfileId%5D=6545\u0026fields%5BproductId%5D=1289", "urlMachine": "\/rest\/catalog.product.download?fields%5BfieldName%5D=previewPicture\u0026fields%5BfileId%5D=6545\u0026fields%5BproductId%5D=1289" }, "previewText": null, "previewTextType": "text", "property258": { "value": "test", "valueId": "9877" }, "property259": [ { "value": "test1", "valueId": "9878" }, { "value": "test2", "valueId": "9879" } ], "purchasingCurrency": null, "purchasingPrice": null, "quantity": null, "sort": 100, "subscribe": "Y", "timestampX": "2024-06-17T14:30:33+03:00", "type": 6, "vatId": null, "vatIncluded": "N", "weight": null, "width": null, "xmlId": "1289" } ] }, "total": 1, "time": { "start": 1718631434.15105, "finish": 1718631434.921837, "duration": 0.7707870006561279, "processing": 0.3575417995452881, "date_start": "2024-06-17T16:37:14+03:00", "date_finish": "2024-06-17T16:37:14+03:00" } } ``` ### Возвращаемые данные - `result` `object`. Корневой элемент ответа - `units` `catalog_product_sku[]`. Массив объектов с информацией о выбранных головных товарах - `total` `integer`. Общее количество найденных записей - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error":200040300010, "error_description":"Access denied" } ``` - `200040300010` — Недостаточно прав для чтения торгового каталога - `0` — Не указаны поля `id`, `iblockId` в полях выбора - `0` — Не указано поле `iblockId` в фильтре - `0` — Другие ошибки (например, фатальные ошибки) ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"select":["id","iblockId","name","active","available","bundle","canBuyZero","code","createdBy","dateActiveFrom","dateActiveTo","dateCreate","detailPicture","detailText","detailTextType","height","iblockSectionId","length","measure","modifiedBy","previewPicture","previewText","previewTextType","purchasingCurrency","purchasingPrice","quantity","sort","subscribe","timestampX","type","vatId","vatIncluded","weight","width","xmlId","property258","property259"],"filter":{"iblockId":23,">id":10,"vatId":[1,2]},"order":{"id":"desc"}}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.product.sku.list ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"select":["id","iblockId","name","active","available","bundle","canBuyZero","code","createdBy","dateActiveFrom","dateActiveTo","dateCreate","detailPicture","detailText","detailTextType","height","iblockSectionId","length","measure","modifiedBy","previewPicture","previewText","previewTextType","purchasingCurrency","purchasingPrice","quantity","sort","subscribe","timestampX","type","vatId","vatIncluded","weight","width","xmlId","property258","property259"],"filter":{"iblockId":23,">id":10,"vatId":[1,2]},"order":{"id":"desc"},"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/catalog.product.sku.list ``` ### JS (TS) ```ts // This snippet is an ES module: top-level await requires type="module" or a bundler. // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide). import { Text } from '@bitrix24/b24jssdk' import type { B24Frame, ISODate } from '@bitrix24/b24jssdk' declare const $b24: B24Frame type SkuItem = { id: number iblockId: number iblockSectionId: number | null name: string active: string available: string bundle: string canBuyZero: string code: string createdBy: number dateActiveFrom: ISODate | null dateActiveTo: ISODate | null dateCreate: ISODate | null detailPicture: { id: string; url: string; urlMachine: string } | null detailText: string | null detailTextType: string height: number | null length: number | null measure: number | null modifiedBy: number previewPicture: { id: string; url: string; urlMachine: string } | null previewText: string | null previewTextType: string purchasingCurrency: string | null purchasingPrice: string | null quantity: number | null sort: number subscribe: string timestampX: ISODate | null type: number vatId: number | null vatIncluded: string weight: number | null width: number | null xmlId: string property258: { value: string; valueId: string } | null property259: Array<{ value: string; valueId: string }> } // Shape of the payload returned in result (match the "response handling" section of the page) type SkuListResult = { units: SkuItem[] } try { // catalog.product.sku.list returns a single page (max 50 records). For the whole result set // use a list helper: $b24.actions.v2.callList.make() returns every record as one // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator). // NOTE: the list helpers do not accept `order` (it is excluded from their params, so // passing it is a TS error) — keep this call.make + `start` variant when sort matters. const response = await $b24.actions.v2.call.make({ method: 'catalog.product.sku.list', params: { select: [ 'id', 'iblockId', 'name', 'active', 'available', 'bundle', 'canBuyZero', 'code', 'createdBy', 'dateActiveFrom', 'dateActiveTo', 'dateCreate', 'detailPicture', 'detailText', 'detailTextType', 'height', 'iblockSectionId', 'length', 'measure', 'modifiedBy', 'previewPicture', 'previewText', 'previewTextType', 'purchasingCurrency', 'purchasingPrice', 'quantity', 'sort', 'subscribe', 'timestampX', 'type', 'vatId', 'vatIncluded', 'weight', 'width', 'xmlId', 'property258', 'property259', ], filter: { iblockId: 23, '>id': 10, vatId: [1, 2], }, order: { id: 'desc', }, start: 0, }, requestId: Text.getUuidRfc4122() }) // The payload is available only on a successful response if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { const result = response.getData()!.result console.info('SKUs on this page:', result.units.length, result.units) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException try: bitrix_response = client.catalog.product.sku.list( select=[ "id", "iblockId", "name", "active", "available", "bundle", "canBuyZero", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "height", "iblockSectionId", "length", "measure", "modifiedBy", "previewPicture", "previewText", "previewTextType", "purchasingCurrency", "purchasingPrice", "quantity", "sort", "subscribe", "timestampX", "type", "vatId", "vatIncluded", "weight", "width", "xmlId", "property258", "property259", ], filter={ "iblockId": 23, ">id": 10, "vatId": [ 1, 2, ], }, order={ "id": "desc", }, start=0, ).response result = bitrix_response.result print(result) except BitrixAPIError as error: print( "Ошибка Bitrix API", f"error: {error.error}", f"error_description: {error.error_description}", sep="\n", ) except BitrixSDKException as error: print(f"Ошибка Bitrix SDK: {error.message}") except Exception as error: print(f"Непредвиденная ошибка: {error}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'catalog.product.sku.list', [ 'select' => [ 'id', 'iblockId', 'name', 'active', 'available', 'bundle', 'canBuyZero', 'code', 'createdBy', 'dateActiveFrom', 'dateActiveTo', 'dateCreate', 'detailPicture', 'detailText', 'detailTextType', 'height', 'iblockSectionId', 'length', 'measure', 'modifiedBy', 'previewPicture', 'previewText', 'previewTextType', 'purchasingCurrency', 'purchasingPrice', 'quantity', 'sort', 'subscribe', 'timestampX', 'type', 'vatId', 'vatIncluded', 'weight', 'width', 'xmlId', 'property258', 'property259', ], 'filter' => [ 'iblockId' => 23, '>id' => 10, 'vatId' => [1, 2], ], 'order' => [ 'id' => 'desc', ], ] ); $result = $response ->getResponseData() ->getResult(); echo 'Success: ' . print_r($result, true); } catch (Throwable $e) { error_log($e->getMessage()); echo 'Error fetching product SKUs: ' . $e->getMessage(); } ``` ### BX24.js ```js BX24.callMethod( "catalog.product.sku.list", { "select": [ "id", "iblockId", "name", "active", "available", "bundle", "canBuyZero", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "height", "iblockSectionId", "length", "measure", "modifiedBy", "previewPicture", "previewText", "previewTextType", "purchasingCurrency", "purchasingPrice", "quantity", "sort", "subscribe", "timestampX", "type", "vatId", "vatIncluded", "weight", "width", "xmlId", "property258", "property259", ], "filter": { "iblockId": 23, ">id": 10, "vatId": [1, 2], }, "order": { "id": "desc", } }, function(result) { if (result.error()) { console.error(result.error()); } else { console.info(result.data()); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'catalog.product.sku.list', [ 'select' => [ "id", "iblockId", "name", "active", "available", "bundle", "canBuyZero", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "height", "iblockSectionId", "length", "measure", "modifiedBy", "previewPicture", "previewText", "previewTextType", "purchasingCurrency", "purchasingPrice", "quantity", "sort", "subscribe", "timestampX", "type", "vatId", "vatIncluded", "weight", "width", "xmlId", "property258", "property259", ], 'filter' => [ "iblockId" => 23, ">id" => 10, "vatId" => [1, 2], ], 'order' => [ "id" => "desc", ] ] ); echo '
';
print_r($result);
echo '
'; ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "catalog.product.sku.list", b24.Params{ "select": []string{"id", "iblockId", "name", "active", "available", "bundle", "canBuyZero", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "height", "iblockSectionId", "length", "measure", "modifiedBy", "previewPicture", "previewText", "previewTextType", "purchasingCurrency", "purchasingPrice", "quantity", "sort", "subscribe", "timestampX", "type", "vatId", "vatIncluded", "weight", "width", "xmlId", "property258", "property259"}, "filter": b24.Params{ "iblockId": 23, ">id": 10, "vatId": []int{1, 2}, }, "order": b24.Params{ "id": "desc", }, }, b24.WithIdempotent()) if err != nil { return fmt.Errorf("catalog.product.sku.list: %w", err) } // Метод заворачивает ответ в объект с ключом "units". raw, ok := b24.Unwrap(res.Result, "units") if !ok { return fmt.Errorf("в ответе нет ключа units") } var items []struct { Active string `json:"active"` Available string `json:"available"` Bundle string `json:"bundle"` CanBuyZero string `json:"canBuyZero"` Code string `json:"code"` CreatedBy int `json:"createdBy"` } if err := json.Unmarshal(raw, &items); err != nil { return fmt.Errorf("разбор ответа: %w", err) } for _, it := range items { fmt.Println(it.Active) } ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/catalog/product/sku/catalog-product-sku-list.html