Работа с заказами в битрикс D7

Для реализации возможностей интернет-магазина в системе битрикс используется модуль sale. С помощью данного модуля становятся доступными возможности работы с корзиной, оформления заказов, работа с покупателями, а также другой необходимый функционал. Для бизнеса, в большинстве случаев, стандартных компонентов оформления заказов иногда бывает достаточно. Однако это не исключает возможность реализации своего функционала для работы с заказами на уровне API. В данном посту мы рассмотрим простые примеры использования API битрикса ядра D7.

Перед использованием API для работы с заказами следует подключить модуль «sale»:

\Bitrix\Main\Loader::includeModule('sale');
use Bitrix\Sale\Order,
    Bitrix\Sale\Basket,
    Bitrix\Sale\Delivery,
    Bitrix\Sale\PaySystem;

Получение полей заказа

Зная ID заказа, мы можем получить поля заказа, а также внести какие-либо изменения в них.

$order = \Bitrix\Sale\Order::load($orderId); // объект заказа
$order->getFields(); // получение полей заказа
$order->getField("DELIVERY_ID"); // ID службы доставки
$order->setField('PAYED', 'N'); // изменить любой параметр
$order->save(); // и сохраняем

Используя ID заказа мы инициализировали объект заказа, посредством метода load(), и присвоили переменной $order. Для получения полей заказа, мы выполнили метод getFields(). После этого нам становятся доступны поля для работы с ними. Так в примере через метод getField() мы получили значение DELIVERY_ID. Передавая таким образом символьный код этому методу мы можем получать значение этих полей в заказе. Далее используя метод setField() мы присвоили полю PAYED значение «N». Чтобы изменения записались в системе, следует так же выполнить метод save(). Использовать этот метод нужно лишь в том случае, когда мы вносим изменения в текущий заказ, и вызывается он в последнюю очередь. Таблица с описанием полей заказа опубликована в конце статьи.

Получать значение некоторых полей можно посредством специальных методов, которые так же удобно использовать в коде:

$order->getId(); // ID заказа
$order->getSiteId(); // ID сайта
$order->getDateInsert(); // объект Bitrix\Main\Type\DateTime
$order->getPersonTypeId(); // ID типа покупателя
$order->getUserId(); // ID пользователя

$order->getPrice(); // Сумма заказа
$order->getDiscountPrice(); // Размер скидки
$order->getDeliveryPrice(); // Стоимость доставки
$order->getSumPaid(); // Оплаченная сумма
$order->getCurrency(); // Валюта заказа

$order->isPaid(); // true, если оплачен
$order->isAllowDelivery(); // true, если разрешена доставка
$order->isShipped(); // true, если отправлен
$order->isCanceled(); // true, если отменен

Создание заказа в битрикс D7

Для создания заказа нам следует выполнить цепочку последовательных действий: создать корзину, создать заказ и связать корзину с заказом, создать запись отгрузки, создать оплату.

 
// товары для добавления в корзину
$arItems = array(
	array(
		'PRODUCT_ID' => 150,
		'NAME' => 'Наименование товара', 
		'PRICE' => 25000,
		'CURRENCY' => 'KZT',
		'QUANTITY' => 1
	)
);

// создаём корзину, и добавляем в неё товары
$basket = \Bitrix\Sale\Basket::create(SITE_ID);
foreach ($arItems as $i => $arItem) {
	$basketItem = $basket->createItem("catalog", $arItem['PRODUCT_ID']);
	$basketItem->setFields($arItem);
}

// создаем заказ, связываем корзину с заказом (перерасчет происходит автоматически)
$order = \Bitrix\Sale\Order::create(SITE_ID, $userId);
$order->setPersonTypeId($personTypeId);
$order->setBasket($basket);

// создаём отгрузку заказа
$shipmentCollection = $order->getShipmentCollection();
$shipment = $shipmentCollection->createItem(
	\Bitrix\Sale\Delivery\Services\Manager::getObjectById(1)
);
$shipmentItemCollection = $shipment->getShipmentItemCollection();

foreach ($basket as $basketItem) {
	$item = $shipmentItemCollection->createItem($basketItem);
	$item->setQuantity($basketItem->getQuantity());
}

// создаём оплату заказа
$paymentCollection = $order->getPaymentCollection();
$payment = $paymentCollection->createItem(
	\Bitrix\Sale\PaySystem\Manager::getObjectById(1)
);
$payment->setField("SUM", $order->getPrice());
$payment->setField("CURRENCY", $order->getCurrency());

// сохраняем все параметры заказа
$result = $order->save();
if ($result->isSuccess()) {
	echo 'Заказ успешно создан!';
} else {
	echo $result->getError();
}

Аналогично как и в предыдущем примере все изменения заказа сохраняются посредством метода save(). В примере выше добавляется только один товар, однако на практике можно добавлять их целое множество, посредством массива $arItems.

Обновление заказа в битрикс D7

В самом первом примере мы уже рассматривали возможность обновления полей заказа. Там, посредством использования метода setField() мы задавали значения поля заказа. При работе с заказом так же бывает требуется обновить другие данные заказа, которые обновляются немного иначе. Допустим нам требуется разрешить отгрузку заказа, для этого мы может выполнить такую операцию:

// получаем объект заказа
$order = \Bitrix\Sale\Order::load($orderId);

// добавляем комментарий от покупателя
$order->setField('USER_DESCRIPTION', 'Доставить до дому');

// получаем объекты отгрузки
$shipmentCollection = $order->getShipmentCollection();

foreach ($shipmentCollection as $shipment) {
	if (!$shipment->isSystem()) {
		$shipment->allowDelivery(); // разрешаем отгрузку
	}
}

// сoхраняем изменения заказа
$result = $order->save();
if ($result->isSuccess()) {
	echo 'Изменения сохранены успешно!';
} else {
	echo $result->getError();
}

В данном примере мы добавили к заказу комментарий от покупателя — поле USER_DESCRIPTION, а также разрешили отгрузку товаров. По умолчанию для каждого заказа существует системная отгрузка, она создаётся при создании заказа. В цикле так прописано условие, которое исключает системную отгрузку, которую затрагивать нет необходимости.

Поля заказа в битрикс D7

*Стоит обратить внимание на то, что поля актуальны на момент написания данной статьи.