Настройка обмена товара на 1С-Битрикс: логика, код и автоматизация

Настройка обмена товара на 1С-Битрикс

Представьте: клиент купил дорогую кофеварку за $720–1k, но через неделю понял, что ему нужна модель с капучинатором. Возвращать деньги? Он хочет доплатить $140–200 и получить другую. В Битрикс нет готового механизма обмена — это комбинация возврата и нового заказа. Мы встраиваем логику поверх модуля sale, используя Highload-блоки и кастомные обработчики. На одном проекте с каталогом электроники на 15 000 SKU автоматизация сократила время обработки заявок на 70% — менеджеры перестали вручную связывать возвраты. Среднее время обмена снизилось с 3 дней до 2 часов. Ниже — проверенная архитектура, которую мы внедряем на проектах разного масштаба.

Какие типичные проблемы возникают при обмене?

Без готового решения разработчики сталкиваются с тремя узкими местами:

• Потеря связи между возвратом и новым заказом: менеджеры вручную сверяют номера, что приводит к ошибкам в 15% случаев.
• Ошибки в расчёте доплаты: если не учитывать скидки исходного заказа, клиент переплачивает до 25% стоимости.
• Ручные статусы: забывают перевести заказ в «обмен завершён», когда товар получен — 30% заявок зависают на неделю.

Мы решаем это единой таблицей local_sale_exchange, классом ExchangeManager и автоматическими обновлениями через события.

Почему стоит автоматизировать обмен?

Ручной обмен — это риск ошибок и потеря лояльности. Клиент ждёт прозрачности: видит статус замены и сумму доплаты в личном кабинете. Автоматизация исключает человеческий фактор. Например, на одном проекте после внедрения количество повторных обращений в поддержку снизилось на 40%. Окупаемость решения — 2–3 месяца за счёт экономии времени менеджеров (в среднем 45 минут на одну заявку).

Бизнес-логика обмена

Две схемы обмена, которые нужно поддерживать:

• Схема 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'), ]; } } 

Как ExchangeManager создаёт обмен

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, ]); } } 

Типичные ошибки и их решение

Что входит в работу

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

Базовая логика обмена 1-к-1 — 2–3 недели. Обмен с доплатой и полной автоматизацией — 4–6 недель. Сроки зависят от сложности интеграции с вашей 1С и платёжными шлюзами. Оценим проект на первой встрече.

Если вы столкнулись с ручным обменом — закажите консультацию. Хотите такую же автоматизацию? Свяжитесь с нами — обсудим ваш сценарий и подготовим коммерческое предложение с гарантией результата. Опыт команды — более 10 проектов по обмену товаров на Битрикс.

Масштабируемость и практические примеры

На проектах с высокой нагрузкой (10+ обменов в день) система работает стабильно благодаря использованию транзакций и очередей. При попытке одновременного обмена двумя клиентами система гарантирует консистентность данных через блокировки на уровне базы. Примеры успешных внедрений: маркетплейс электроники с 15 000 SKU, интернет-магазин косметики (5 000 товаров), специализированный магазин мебели. Во всех случаях после внедрения среднее время обработки заявки сократилось с 3-5 дней до 2-4 часов, a количество ошибок упало на 98%. Система интегрируется с любыми платежными системами и конвертирует операции в 1С автоматически.