CCatalogProduct - это класс старого ядра 1С-Битрикс, через который читаются и пишутся складские и физические параметры товара: остаток, вес, габариты, ставка НДС, единица измерения. Путаница вокруг него у новичков стандартная: они пытаются через этот же класс поменять цену и не понимают, почему ничего не происходит. Цена в модуле каталога живёт в отдельной таблице и управляется другим классом, а CCatalogProduct отвечает только за то, что физически лежит на складе и сколько это весит.
Что делает класс CCatalogProduct в модуле «Торговый каталог»
Когда включаешь модуль «Торговый каталог» и превращаешь обычный инфоблок в каталог товаров, у каждого элемента появляется вторая часть данных, которая не хранится в стандартных полях и свойствах инфоблока. Она лежит в отдельной таблице каталога и привязана к элементу по его ID. Именно эту часть и обслуживает CCatalogProduct: остаток на складе, зарезервированное количество, вес, габариты для расчёта доставки, ставку НДС и единицу измерения.
Это разделение объясняет частый вопрос «почему я записал значение в свойство инфоблока, а на витрине остаток не поменялся». Остаток не свойство, у него нет PROPERTY_CODE, он не попадёт в выборку CIBlockElement::GetList через PROPERTY_ фильтры. Читать и писать его нужно именно через CCatalogProduct или через его аналог в D7.
CCatalogProduct::GetByID: как прочитать остаток, вес и параметры товара
Метод возвращает данные каталога по одному элементу в виде обычного массива, не объекта CDBResult, поэтому проверка на пустой результат делается просто через if:
<?php
$arProduct = CCatalogProduct::GetByID(123);
if ($arProduct) {
echo $arProduct["QUANTITY"];
echo $arProduct["QUANTITY_RESERVED"];
echo $arProduct["WEIGHT"];
echo $arProduct["VAT_ID"];
}
?>
Важный момент, который постоянно путают при расчёте «сколько товара реально можно продать»: когда резервирование включено, Битрикс при резерве уменьшает QUANTITY и на ту же величину увеличивает QUANTITY_RESERVED. Значит, QUANTITY уже и есть доступный остаток. Если вычесть из него QUANTITY_RESERVED ещё раз, резерв учтётся дважды, и магазин покажет недоступным товар, который на самом деле есть.
CCatalogProduct::Add и Update: как записать параметры товара
Add создаёт запись каталога для элемента, у которого её раньше не было (например, только что созданный товар), Update меняет уже существующую. В обоих случаях первым делом нужен ID элемента инфоблока, каталожная запись существует именно в привязке к нему.
<?php
$arFields = array(
"QUANTITY" => 25,
"WEIGHT" => 450,
"WIDTH" => 100,
"LENGTH" => 150,
"HEIGHT" => 50,
"VAT_ID" => 2,
"VAT_INCLUDED" => "Y",
"CAN_BUY_ZERO" => "N",
);
CCatalogProduct::Update(123, $arFields);
?>
Основные поля, с которыми реально приходится работать:
| Поле | Что означает | Пример |
|---|---|---|
| QUANTITY | остаток на складе, штук | 25 |
| QUANTITY_RESERVED | зарезервировано в незакрытых заказах | 3 |
| CAN_BUY_ZERO | разрешить покупку при нулевом остатке | N |
| WEIGHT | вес в граммах, нужен для расчёта доставки | 450 |
| WIDTH, LENGTH, HEIGHT | габариты в мм, тоже для расчёта доставки | 100, 150, 50 |
| VAT_ID | ссылка на ставку НДС из настроек каталога | 2 |
| VAT_INCLUDED | включён ли НДС в цену товара | Y |
| MEASURE | числовой ID единицы измерения из справочника каталога | ID из справочника |
| PURCHASING_PRICE | закупочная цена, для расчёта маржи | 500 |
Вес и габариты не декоративные поля. Именно они уходят в расчёт стоимости и способов доставки, если магазин интегрирован со СДЭК или другой службой, и без них калькулятор доставки на витрине либо ошибается, либо не может посчитать стоимость вообще.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Почему CCatalogProduct не трогает цену: разница с CPrice и CCatalogGroup
Цена товара физически не хранится в той же записи, что остаток и вес. Она лежит в отдельной таблице цен и управляется классом CPrice, привязка идёт по ID элемента и по ID группы цен (CATALOG_GROUP_ID). Группы цен, они же типы цен, розничная, оптовая, дилерская, заводятся в настройках каталога и читаются через CCatalogGroup::GetList. У одного товара может быть сразу несколько цен, каждая своей группы, и это нормальная схема, а не ошибка конфигурации.
Отсюда и самая частая ошибка новичков: они правят QUANTITY через CCatalogProduct, видят, что остаток поменялся, и по аналогии пытаются поменять PRICE тем же способом, но такого поля в этом классе нет. Цену нужно читать и писать через CPrice, а не через CCatalogProduct.
В D7 у обеих сущностей есть отдельные ORM-таблицы, и читать через них часто удобнее, потому что getList сразу отдаёт нужную выборку без ручного построения фильтра. Записывать товарные параметры и цены документация советует через модели Bitrix\Catalog\Model\Product и Bitrix\Catalog\Model\Price, а не прямой записью в таблицы: она может обойти проверки, события и пересчёт доступности. Пример чтения:
<?php
use Bitrix\Catalog\ProductTable;
use Bitrix\Catalog\PriceTable;
$product = ProductTable::getList([
'select' => ['ID', 'QUANTITY', 'WEIGHT', 'VAT_ID', 'MEASURE'],
'filter' => ['=ID' => 123],
])->fetch();
$prices = PriceTable::getList([
'select' => ['ID', 'PRODUCT_ID', 'CATALOG_GROUP_ID', 'PRICE', 'CURRENCY'],
'filter' => ['=PRODUCT_ID' => 123],
])->fetchAll();
?>
| Что хранит | Старое ядро | D7 аналог |
|---|---|---|
| Остаток, вес, НДС, габариты товара | CCatalogProduct | Bitrix\Catalog\ProductTable |
| Цена товара по типам цен | CPrice | Bitrix\Catalog\PriceTable |
| Список типов (групп) цен | CCatalogGroup | Bitrix\Catalog\GroupTable |
Остатки по складам: CCatalogProduct против учёта по складам
Если в магазине один общий склад, QUANTITY в CCatalogProduct и есть тот самый остаток, который видит покупатель. Но как только включается учёт по нескольким складам, общий остаток товара становится суммой остатков по отдельным складам, а сама разбивка по складам хранится отдельно и читается через Bitrix\Catalog\StoreProductTable, где для каждой пары «товар плюс склад» есть своё количество. Практическое следствие: если магазин ведёт несколько точек выдачи или отдельный склад под маркетплейсы, менять только общий QUANTITY напрямую опасно, потому что он рискует разойтись с суммой остатков по складам после следующей синхронизации.
Типичные ошибки при работе с CCatalogProduct
- Путают ID в CCatalogProduct::Add с каким-то отдельным идентификатором каталожной записи. Это всегда ID элемента инфоблока, второго ID здесь нет
- Вычитают QUANTITY_RESERVED из QUANTITY, хотя при включённом резервировании резерв уже списан из QUANTITY, и получают на витрине заниженный остаток, из-за которого товар в наличии выглядит недоступным
- Не сбрасывают кэш компонента каталога после ручного обновления полей через код, из-за чего изменившиеся цифры не появляются на сайте до истечения времени жизни кэша
- Пишут в те же поля из своего кода параллельно с обменом данными из 1С. Файлы от учётной системы обрабатываются через точку входа /bitrix/admin/1c_exchange.php, и при следующей синхронизации остаток или цена, изменённые вручную, будут просто перезаписаны данными из 1С
Последний пункт на практике встречается чаще остальных: если у магазина настроен обмен CommerceML, любые ручные правки остатков в коде живут только до следующей выгрузки из учётной системы, и логику нужно встраивать либо в саму 1С, либо в обработчик после импорта, а не поверх штатного обмена.
Если задача не разовая правка, а регулярная синхронизация остатков и цен между сайтом и внешней системой, которая должна переживать обновления и не ломаться на каждом новом товаре, такие вещи разумнее делать как отдельную доработку, а не через правки в коде на глаз. Я беру такие задачи как доработку и поддержку 1С-Битрикс и оцениваю их по часам, отдельно от разработки нового функционала.
Возможности модуля каталога и формат обмена CommerceML в 1С-Битрикс со временем меняются, поэтому перед внедрением я сверяюсь с актуальной документацией вендора.
Частые вопросы
Почему после CCatalogProduct::Update цена товара не поменялась
Потому что цены продажи в этом классе не хранятся, в товарной записи есть только закупочная цена PURCHASING_PRICE. Цены по типам лежат в таблице цен и меняются через CPrice (или через Bitrix\Catalog\Model\Price в D7), с привязкой к конкретной группе цен. CCatalogProduct отвечает за остаток, вес, габариты, НДС, единицу измерения и закупочную цену.
Как узнать, сколько товара реально доступно для покупки
Берётся значение QUANTITY из CCatalogProduct::GetByID. Когда резервирование включено, Битрикс при резерве уже уменьшает QUANTITY и переносит это количество в QUANTITY_RESERVED, поэтому QUANTITY и есть доступный для продажи остаток. Вычитать QUANTITY_RESERVED ещё раз не нужно, иначе резерв учтётся дважды.
Можно ли писать в остатки напрямую, если магазин синхронизируется с 1С
Можно, но нужно понимать, что при следующей выгрузке из 1С через CommerceML эти значения будут перезаписаны данными из учётной системы. Ручные правки в коде подходят для разовых случаев, а для постоянной логики нужно либо менять данные на стороне 1С, либо вешать обработку на событие после завершения импорта.
В чём разница между CCatalogProduct и Bitrix\Catalog\ProductTable
Это одна и та же сущность каталога, только доступ к ней даётся через два разных API. CCatalogProduct - класс старого ядра с методами Add, Update и GetByID: GetByID возвращает простой массив (или false, если записи нет), а Add и Update возвращают true или false. ProductTable - его аналог в D7 ORM с методом getList, гибким select и filter и явным fetch или fetchAll для получения результата.