Настройка обмена товара на 1С-Битрикс
Обмен товара — сценарий, отличающийся от возврата: покупатель не хочет деньги, он хочет другой товар (другой размер, цвет, модель). В 1С-Битрикс нет отдельного модуля «Обмен» — это комбинация возврата исходного товара и создания нового заказа, обычно с зачётом стоимости. Настройка требует кастомной логики поверх модуля sale.
Бизнес-логика обмена
Две схемы обмена, которые нужно поддерживать:
Схема 1: Обмен 1-к-1 — товар одинаковой стоимости. Создаётся возврат на исходный товар, создаётся новый заказ на замену. Доплата/возврат разницы = 0.
Схема 2: Обмен с доплатой/возвратом разницы — товар другой стоимости. Если новый дороже — покупатель доплачивает. Если дешевле — возвращаем разницу.
Структура данных обмена
Для хранения связи «исходный возврат → новый заказ» создаём Highload-блок или таблицу:
class ExchangeTable extends \Bitrix\Main\ORM\Data\DataManager
{
public static function getTableName(): string { return 'local_sale_exchange'; }
public static function getMap(): array
{
return [
new \Bitrix\Main\ORM\Fields\IntegerField('ID', ['primary' => true, 'autocomplete' => true]),
new \Bitrix\Main\ORM\Fields\IntegerField('ORIGINAL_ORDER_ID'),
new \Bitrix\Main\ORM\Fields\IntegerField('RETURN_ID'), // ID заявки на возврат
new \Bitrix\Main\ORM\Fields\IntegerField('NEW_ORDER_ID'), // ID нового заказа
new \Bitrix\Main\ORM\Fields\IntegerField('ORIGINAL_BASKET_ID'), // позиция в исходном заказе
new \Bitrix\Main\ORM\Fields\IntegerField('NEW_PRODUCT_ID'), // новый товар
new \Bitrix\Main\ORM\Fields\FloatField('ORIGINAL_PRICE'),
new \Bitrix\Main\ORM\Fields\FloatField('NEW_PRICE'),
new \Bitrix\Main\ORM\Fields\FloatField('DIFF_AMOUNT'), // сумма доплаты (+) или возврата (-)
new \Bitrix\Main\ORM\Fields\StringField('STATUS'), // pending, paid, completed
new \Bitrix\Main\ORM\Fields\DatetimeField('CREATED_AT'),
];
}
}
Создание обмена
namespace Local\Returns;
class ExchangeManager
{
public function initiateExchange(array $params): array
{
// $params:
// - original_order_id: int
// - original_basket_id: int (позиция, которую меняем)
// - new_product_id: int (на что меняем)
// - new_product_props: [] (размер, цвет и т.д.)
\Bitrix\Main\Loader::includeModule('sale');
\Bitrix\Main\Loader::includeModule('catalog');
$order = \Bitrix\Sale\Order::load($params['original_order_id']);
if (!$order || $order->getUserId() !== $this->currentUserId) {
throw new \RuntimeException('Order not found');
}
// Получаем исходную позицию
$originalItem = null;
foreach ($order->getBasket() as $item) {
if ($item->getId() === (int)$params['original_basket_id']) {
$originalItem = $item;
break;
}
}
if (!$originalItem) {
throw new \RuntimeException('Basket item not found');
}
$originalPrice = $originalItem->getFinalPrice();
// Цена нового товара
$newPrice = $this->getProductPrice($params['new_product_id']);
$diffAmount = $newPrice - $originalPrice;
// Создаём заявку на возврат исходного товара
$returnManager = new ReturnManager();
$returnId = $returnManager->createReturn(
$params['original_order_id'],
[['basket_id' => $params['original_basket_id'], 'quantity' => 1, 'reason' => 'exchange']],
'EXCHANGE'
);
// Создаём новый заказ на замену
$newOrderId = $this->createExchangeOrder(
$order->getUserId(),
$params['new_product_id'],
$params['new_product_props'] ?? [],
$diffAmount,
$order
);
// Сохраняем связь
$exchangeId = ExchangeTable::add([
'ORIGINAL_ORDER_ID' => $params['original_order_id'],
'RETURN_ID' => $returnId,
'NEW_ORDER_ID' => $newOrderId,
'ORIGINAL_BASKET_ID'=> $params['original_basket_id'],
'NEW_PRODUCT_ID' => $params['new_product_id'],
'ORIGINAL_PRICE' => $originalPrice,
'NEW_PRICE' => $newPrice,
'DIFF_AMOUNT' => $diffAmount,
'STATUS' => $diffAmount > 0 ? 'pending_payment' : 'pending_ship',
'CREATED_AT' => new \Bitrix\Main\Type\DateTime(),
])->getId();
return [
'exchange_id' => $exchangeId,
'return_id' => $returnId,
'new_order_id' => $newOrderId,
'diff_amount' => $diffAmount,
'needs_payment'=> $diffAmount > 0,
];
}
private function createExchangeOrder(
int $userId,
int $productId,
array $props,
float $diffAmount,
\Bitrix\Sale\Order $originalOrder
): int {
$order = \Bitrix\Sale\Order::create(SITE_ID, $userId);
$order->setPersonTypeId($originalOrder->getPersonTypeId());
// Копируем адрес доставки из исходного заказа
$propertyCollection = $order->getPropertyCollection();
foreach ($originalOrder->getPropertyCollection() as $prop) {
$newProp = $propertyCollection->getItemByOrderPropertyId($prop->getPropertyId());
if ($newProp) {
$newProp->setValue($prop->getValue());
}
}
$basket = \Bitrix\Sale\Basket::create(SITE_ID);
$item = $basket->createItem('catalog', $productId);
$item->setField('QUANTITY', 1);
if ($props) {
$item->setField('PROPS', $props);
}
$order->setBasket($basket);
// Если доплата — используем купон на скидку = originalPrice
if ($diffAmount < 0) {
// Возвращаем разницу — создаём скидку на сумму (originalPrice - newPrice)
$order->getDiscount()->setData([
'COUPON_DISCOUNT' => abs($diffAmount),
]);
}
// Копируем доставку
$shipmentCollection = $order->getShipmentCollection();
$shipment = $shipmentCollection->createItem();
$shipment->setField('DELIVERY_ID', $this->getDefaultDeliveryId());
$result = $order->save();
if (!$result->isSuccess()) {
throw new \RuntimeException('Exchange order failed: ' . implode('; ', $result->getErrorMessages()));
}
return $order->getId();
}
}
Синхронизация статусов обмена
При завершении возврата (получен старый товар) и оплате нового заказа — помечаем обмен завершённым:
\Bitrix\Main\EventManager::getInstance()->addEventHandler(
'sale',
'OnSaleOrderReturnStatusChange',
function (\Bitrix\Main\Event $event) {
if ($event->getParameter('NEW_STATUS_ID') !== 'RECEIVED') return;
$returnId = $event->getParameter('RETURN_ID');
$exchange = ExchangeTable::getList([
'filter' => ['RETURN_ID' => $returnId],
'limit' => 1,
])->fetch();
if (!$exchange) return;
// Проверяем, оплачен ли новый заказ
$newOrder = \Bitrix\Sale\Order::load($exchange['NEW_ORDER_ID']);
if ($newOrder && $newOrder->isPaid()) {
ExchangeTable::update($exchange['ID'], ['STATUS' => 'completed']);
} else {
ExchangeTable::update($exchange['ID'], ['STATUS' => 'awaiting_payment']);
}
}
);
Уведомление покупателю об обмене
class ExchangeNotifications
{
public static function sendExchangeCreated(int $exchangeId): void
{
$exchange = ExchangeTable::getById($exchangeId)->fetch();
$diffAmount = (float)$exchange['DIFF_AMOUNT'];
if ($diffAmount > 0) {
$message = "Обмен создан. Для завершения необходимо доплатить {$diffAmount} руб. "
. "Ссылка на оплату: https://example.com/order/{$exchange['NEW_ORDER_ID']}/pay/";
} elseif ($diffAmount < 0) {
$message = "Обмен одобрен. После получения товара вернём "
. abs($diffAmount) . " руб. на вашу карту.";
} else {
$message = "Обмен одобрен. Новый заказ #{$exchange['NEW_ORDER_ID']} будет отправлен "
. "после получения возвращаемого товара.";
}
\CEvent::Send('EXCHANGE_CREATED', SITE_ID, [
'ORDER_ID' => $exchange['ORIGINAL_ORDER_ID'],
'NEW_ORDER_ID'=> $exchange['NEW_ORDER_ID'],
'MESSAGE' => $message,
]);
}
}
Состав работ
- Таблица
local_sale_exchangeдля хранения связи возврат ↔ новый заказ - Класс
ExchangeManager: создание возврата + нового заказа в одной транзакции - Форма обмена в личном кабинете: выбор нового товара/размера
- Обработка доплаты при обмене на более дорогой товар
- Обработчик событий: автоматический статус обмена при получении товара
- Email-уведомления: создание обмена, получение товара, завершение
Сроки: базовая логика обмена 1-к-1 — 2–3 недели. Обмен с доплатой и полной автоматизацией — 4–6 недель.