Документация для разработчиков
Документация для разработчиков Документация по D7 Документация по REST Пользовательская документация
Темная тема

Add

int
CSaleDiscount::Add(
	array arFields
);

Метод добавляет новую скидку на сумму заказа с параметрами из массива arFields. Статический метод.

Параметры вызова

Параметр Описание
arFields Ассоциативный массив параметров скидки, ключами в котором являются названия параметров скидки, а значениями - значения параметров.

Допустимые ключи:
  • LID - идентификатор сайта;
  • NAME - название;
  • ACTIVE_FROM - дата и время начала действия в формате сайта (если не указано, то действует с момента создания);
  • ACTIVE_TO - дата и время окончания действия в формате сайта (если не указано, то ограничения по времени не имеет);
  • ACTIVE - флаг активности;
  • PRIORITY - приоритет применимости (чем выше, тем раньше применится);
  • SORT - сортировка в рамках одного значения приоритета (чем меньше, тем раньше применится в рамках одного приоритета);
  • LAST_DISCOUNT - флаг "Прекратить применение скидок". Если правило применилось и флаг стоит, все последующие скидки не будут использованы (независимо от того, совпадают их условия или нет);
  • LAST_LEVEL_DISCOUNT - флаг "Прекратить уровень". Аналогичен предыдущему, но отменяет только последующие правила с таким же приоритетом;
  • XML_ID - внешний код;
  • CONDITIONS - массив, описывающий дополнительные условия правила;
  • ACTIONS - массив, описывающий действия правила;
  • USER_GROUPS - массив групп пользователей, на которых распространяется правило (не может быть пустым);
  • CURRENCY - с версии 14.0 принудительно содержит валюту сайта;
  • PRICE_FROM - общая стоимость заказа, начиная с которой предоставляется эта скидка. Устаревшее поле с 14.0, значение жестко переопределяются при добавлении;
  • PRICE_TO - общая стоимость заказа, до достижения которой предоставляется эта скидка. Устаревшее поле с 14.0, значение жестко переопределяются при добавлении;
  • DISCOUNT_VALUE - величина скидки. Устаревшее поле с 14.0, значение жестко переопределяются при добавлении;
  • DISCOUNT_TYPE - тип величины скидки (P - величина задана в процентах, V - величина задана в абсолютной сумме). Устаревшее поле с 14.0, значение жестко переопределяются при добавлении;

    • Блок купонов:
  • COUPON_ADD - создать купоны одного типа при добавлении правила или нет (Y/N);
  • COUPON_COUNT - число создаваемых купонов;
  • COUPON - массив, описывающий купон:
    • TYPE - тип купона (Y - купон на одну позицию заказа, O - купон на один заказ, N - многоразовый купон);
    • ACTIVE_FROM - дата и время начала активности купона в формате сайта либо null;
    • ACTIVE_TO - дата и время окончания активности купона в формате сайта либо null;
    • MAX_USE - максимальное число использования купона (для многоразовых) либо 0.

Возвращаемые значения

Возвращается код добавленной скидки или false в случае ошибки.

Примеры

Создание правила корзины, которое применяет скидку 10% при сумме товаров в корзине от 5000 рублей: 

\Bitrix\Main\Loader::includeModule('sale');

global $APPLICATION;

$fields = [
	'LID' => 's1',
	'NAME' => 'Скидка 10% при заказе от 5000',
	'ACTIVE' => 'Y',
	'SORT' => 100,
	'PRIORITY' => 1,
	'LAST_DISCOUNT' => 'N',
	'LAST_LEVEL_DISCOUNT' => 'N',
	'USER_GROUPS' => [2],
	'CURRENCY' => 'RUB',
	'CONDITIONS' => [
		'CLASS_ID' => 'CondGroup',
		'DATA' => [
			'All' => 'AND',
			'True' => 'True',
		],
		'CHILDREN' => [
			[
				'CLASS_ID' => 'CondBsktAmtGroup',
				'DATA' => [
					'logic' => 'EqGr',
					'Value' => 5000,
					'All' => 'AND',
				],
				'CHILDREN' => [],
			],
		],
	],
	'ACTIONS' => [
		'CLASS_ID' => 'CondGroup',
		'DATA' => [
			'All' => 'AND',
		],
		'CHILDREN' => [
			[
				'CLASS_ID' => 'ActSaleBsktGrp',
				'DATA' => [
					'Type' => 'Discount',
					'Value' => 10,
					'Unit' => 'Perc',
					'Max' => 0,
					'All' => 'AND',
					'True' => 'True',
				],
				'CHILDREN' => [],
			],
		],
	],
];

$discountId = CSaleDiscount::Add($fields);

if (!$discountId)
{
	$exception = $APPLICATION->GetException();
	echo $exception ? $exception->GetString() : 'Не удалось создать правило корзины';
}

В поле CONDITIONS передается дерево условий применения правила. В примере корневой узел CondGroup объединяет условия по AND, а дочерний узел CondBsktAmtGroup проверяет сумму товаров в корзине.

Значение logic => EqGr означает «больше или равно», Value => 5000 — минимальную сумму корзины.

В поле ACTIONS передается дерево действий правила. В примере корневой узел CondGroup содержит действие ActSaleBsktGrp, которое применяет скидку к корзине.

Значение Type => Discount задает действие скидки, Value => 10 — размер скидки, Unit => Perc — процентный тип значения.

Ключи CLASS_ID, DATA и CHILDREN обязательны для узлов дерева условий и действий. В CHILDREN передается массив дочерних условий или действий; если дочерних узлов нет, передается пустой массив.



Была ли эта страница полезна?

Пользовательские комментарии

Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
1
dapweb 11.04.2020 20:25:08

Создание скидки на один или несколько товаров.

Код
\Bitrix\Main\Loader::includeModule('sale');

$DISCOUNT_VALUE = 40;//процент скидки
$arItemIds = [1, 2, 3];//Массив с ID элементов товаров

$arDiscountFields = [
   "LID" => SITE_ID,
   "SITE_ID" => SITE_ID,
   "NAME"=> "Скидка ".$DISCOUNT_VALUE."%",
   "DISCOUNT_VALUE" => $DISCOUNT_VALUE,
   "DISCOUNT_TYPE" => "P",
   "LAST_LEVEL_DISCOUNT" => "Y",
   "LAST_DISCOUNT" => "Y",
   "ACTIVE" => "Y",
   "CURRENCY" => "EUR",
   "USER_GROUPS" => [2],
   'ACTIONS' => [
      "CLASS_ID" => "CondGroup",
      "DATA" => [
         "All" => "AND"
      ],
      "CHILDREN" => [
         [
            "CLASS_ID" => "ActSaleBsktGrp",
            "DATA" => [
               "Type" => "Discount",
               "Value" => $DISCOUNT_VALUE,
               "Unit" => "Perc",
               "Max" => 0,
               "All" => "OR",
               "True" => "True",
            ],
            "CHILDREN" => [
               [
                  "CLASS_ID" => "ActSaleSubGrp",
                  "DATA" => [
                     "All" => "AND",
                     "True" => "True",
                  ],
                  "CHILDREN" => [
                     [
                        "CLASS_ID" => "CondIBElement",
                        "DATA" => [
                           "logic" => "Equal",
                           "value" => $arItemIds,
                        ]
                     ]
                  ]
               ]
            ]
         ]
      ]
   ],
   "CONDITIONS" =>  [
      'CLASS_ID' => 'CondGroup',
      'DATA' => [
         'All' => 'AND',
         'True' => 'True',
      ],
      'CHILDREN' => [
         [
            "CLASS_ID" => "CondBsktProductGroup",
            "DATA" => [
               "Found" => "Found",
               "All" => "OR",
            ],
            "CHILDREN" => [
               [
                  "CLASS_ID" => "CondIBElement",
                  "DATA" => [
                     "logic" => "Equal",
                     "value" => $arItemIds,
                  ]
               ]
            ]
         ],
      ],  
   ]
];
$iDiscountNumber = \CSaleDiscount::Add($arDiscountFields);
if(IntVal($iDiscountNumber) > 0)
   \Bitrix\Sale\Internals\DiscountGroupTable::updateByDiscount($DISCOUNT_ID, [2], "Y", true);//Обновить параметры для группы пользователей с ID = 2, только тогда скидка появляется в списке скидок в админке

******
Комментарий от разработчика: не вполне корректный пример, группы надо сразу передавать.
0
Дима Парфенов 31.12.2019 10:45:35
В моем случае стояла задача -> 1 товар = 1 правило для корзины
Цитата

   //Собираем массив для CSaleDiscount:Add
$Conditions = array (
 'CLASS_ID' => 'CondGroup',
 'DATA' =>
 array (
   'All' => 'AND',
   'True' => 'True',
 ),
 'CHILDREN' =>
 array (
 ),
);

   $arSD = [
       "LID" => "s1",
       "NAME" => $code . "_skidka",
       "LAST_DISCOUNT" => "N",
       "MODIFIED_BY" => $USER->GetID(), // элемент изменен текущим пользователем
       "ACTIVE" => "Y",
       'ACTIONS' => [
           'CLASS_ID' => 'CondGroup',
           'DATA' => ['All' => 'AND'],
           'CHILDREN' => [
               [
                   'CLASS_ID' => 'ActSaleBsktGrp',
                   'DATA' => [
                       'Type' => 'Closeout', // фиксированная цена
                       'Value' => $newprice, // сама цена
                       'Unit' => 'CurEach', // для каждого товара
                       'Max' => 1,
                       'All' => 'AND',
                       'True' => 'True'
                   ],
                   'CHILDREN' => [
                       [
                           'CLASS_ID' => 'CondIBElement', // это я взял из документации по методу CCatalogDiscount::Add
                           'DATA' => [
                               'logic' => 'Equal', // только равно
                               'value' => [$PRODUCT_ID]  // коду продукта
                           ]
                       ]
                   ]
               ]
           ]
       ],
       "CONDITIONS"=>$Conditions,
       "USER_GROUPS" => array(2), // группы пользователей, можно просмотреть в настройки -> пользователи -> группы
       "CURRENCY" => "RUB"
   ];
   if ($newprice > 0) {
       addDiscount($arSD);
   }
function addDiscount($arFields)
{
   if ($ID = CSaleDiscount::Add($arFields))
       echo "new ID disctount {$ID}";
   else
       echo "error {$ID}";

}
© «Битрикс», 2001-2026, «1С-Битрикс», 2026
Наверх