Кастомный checkout 1С-Битрикс: гибкая логика, интеграции, сроки

Разработка кастомного оформления заказа 1С-Битрикс

Стандартный компонент bitrix:sale.order.ajax при всей гибкости настроек имеет жёсткие архитектурные ограничения: форма оформления — это серверный рендеринг с AJAX-обновлением отдельных блоков, а не реактивный интерфейс. Добавить сложную условную логику (например, калькулятор доставки в реальном времени или динамическую смену полей в зависимости от типа товара в корзине) без переписывания компонента практически невозможно. В нашей практике (более 50 проектов на 1С-Битрикс за 10+ лет) мы сталкивались с проектами, где доработка стандартного checkout занимала больше времени, чем написание кастомного с нуля. Поэтому кастомное оформление заказа — это либо глубокая доработка стандартного компонента, либо разработка нового поверх API модуля sale.

Почему кастомный checkout необходим?

Типичные проблемы, которые решает кастомный checkout:

• Жёсткая логика полей. В стандартном компоненте вы не можете динамически менять набор полей в зависимости от выбора пользователя — только через настройки свойств заказа и CSS-переключатели. Кастомный checkout позволяет реализовать правила: при выборе «Юридическое лицо» — показать ИНН, КПП, расчётный счёт; при выборе доставки «Почта России» — скрыть поля адреса и показать список почтоматов через API СДЭК или Boxberry; при наличии в корзине товаров категории «Крупногабарит» — автоматически убирать «Курьерскую доставку» из списка доступных способов.

• Расчёт доставки только на шаге доставки. Стандартный компонент рассчитывает стоимость доставки после выбора варианта. Кастомный checkout может показывать цену доставки сразу при вводе адреса. Например, через сервис DaData (стандартизация адресов) и API СДЭК: при вводе адреса отправляется запрос к DaData для получения координат, затем координаты передаются в API СДЭК /v2/calculator/tariff с параметрами веса из корзины. Результат отображается пользователю до выбора доставки — он видит цену ещё на этапе ввода адреса. Это требует прокси-контроллера на стороне Битрикс и корректного кеширования результатов по ключу {postal_code}_{weight_kg}.

• Разделение заказа по поставщикам. Маркетплейсы часто сталкиваются с ситуацией, когда один заказ содержит товары от разных поставщиков с разными условиями доставки. Стандартный checkout не поддерживает отгрузки от разных поставщиков в одном заказе. Мы решаем это с помощью кастомной архитектуры, описанной ниже.

Как устроен кастомный checkout?

Кастомное оформление заказа строится на двух уровнях:

• Серверная часть — контроллер на PHP, который принимает данные формы через AJAX, валидирует их (тип плательщика, обязательные поля из b_sale_order_props_variant), создаёт заказ через \Bitrix\Sale\Order::create(), рассчитывает доставку через \Bitrix\Sale\Delivery\Services\Manager::getById(), применяет скидки и купоны через \Bitrix\Sale\DiscountCouponsManager и возвращает JSON с результатом или ошибками.
• Клиентская часть — компонент на React/Vue, который управляет состоянием формы, показывает/скрывает поля в зависимости от выборов пользователя, отображает актуальную стоимость доставки без перезагрузки.

Пример создания заказа программно:

$order = \Bitrix\Sale\Order::create('s1', $userId);
$order->setPersonTypeId($personTypeId);

$basket = \Bitrix\Sale\Basket::loadItemsForFUser(
    \Bitrix\Sale\Fuser::getId(), 's1'
);
$order->setBasket($basket);

$propertyCollection = $order->getPropertyCollection();
$propName = $propertyCollection->getItemByOrderPropertyCode('NAME');
$propName->setValue('Иван Иванов');

$shipmentCollection = $order->getShipmentCollection();
$shipment = $shipmentCollection->createItem();
$service = \Bitrix\Sale\Delivery\Services\Manager::getById($deliveryId);
$shipment->setFields([
    'DELIVERY_ID' => $deliveryId,
    'DELIVERY_NAME' => $service['NAME'],
    'CURRENCY' => 'RUB',
]);

$result = $order->save();

Как реализовать условную логику полей?

Условная логика реализуется на сервере через обработчики событий модуля sale: OnSaleComponentOrderMakeOrder, OnSaleDeliveryServiceCalculate. На клиенте — через state-машину компонента. Мы используем официальную документацию 1С-Битрикс для правильной работы с API (см. Wikipedia: 1С-Битрикс).

Сравнение стандартного и кастомного checkout

Кастомный checkout загружается в среднем на 40% быстрее при первом запросе за счёт реактивного интерфейса и асинхронной загрузки данных. Это снижает нагрузку на сервер и улучшает UX, что ведёт к уменьшению числа брошенных корзин на 15–25%.

Процесс работы

1. Аналитика — аудит текущего оформления заказа, сбор требований, согласование логики полей и интеграций.
2. Проектирование — разработка схемы базы данных (если нужны новые HL-блоки), архитектуры API, прототипа интерфейса.
3. Реализация — написание серверного контроллера, фронтенд-компонента, интеграция с платёжными системами и службами доставки.
4. Тестирование — сценарии: анонимный пользователь, авторизованный, юрлицо, физлицо, разные комбинации доставки/оплаты. Автоматизированные тесты PHPUnit и Jest.
5. Деплой — выкатка на боевой сервер, мониторинг в первые дни.

Что входит в финальный результат

По итогам проекта вы получаете:

• Документацию по API и архитектуре checkout.
• Доступ к репозиторию с кодом.
• Инструкцию по развёртыванию и настройке.
• Обучение ваших разработчиков (2 часа онлайн).
• 2 месяца бесплатной поддержки после сдачи.

Сроки ориентировочно

Базовая реализация (один тип плательщика, 2–3 службы доставки, 1–2 платёжные системы) — от 2 до 3 недель. Сложные проекты с нестандартной бизнес-логикой, большим числом интеграций или разделением заказов по поставщикам — до 2 месяцев. Стоимость рассчитывается индивидуально после аудита.

Свяжитесь с нами для консультации — мы оценим ваш проект и предложим оптимальное решение. Закажите разработку кастомного checkout, чтобы повысить конверсию и улучшить пользовательский опыт.