Что умеет решение
Модуль «Ркипер (r_keeper) — отправка заказов» обеспечивает передачу заказов интернет-магазина в систему rKeeper через UCS Delivery API и встроенную службу доставки. Функционал включает расчёт стоимости доставки и проверку зоны обслуживания по адресу. Решение предназначено для сайтов доставки еды на платформе «1С-Битрикс: Управление сайтом», интегрированных с рестораном в rKeeper.
Передача заказов реализована с двумя настраиваемыми этапами. На этапе «при оформлении» заказ формируется в rKeeper до сохранения данных на сайте; если rKeeper отказывает в приёме, процесс оформления блокируется, а клиенту отображается причина отказа. На этапе «после оплаты» заказ передаётся в ресторан только после подтверждения оплаты.
Отмена заказа в магазине автоматически инициирует отмену соответствующего заказа в rKeeper с возможностью указания настраиваемой причины отказа. Связь между «заказом сайта» и «заказом rKeeper» хранится в отдельной таблице модуля, что исключает повторные отправки и позволяет выполнять отмену по установленной связи.
Состав корзины передаётся в виде блюд rKeeper по их GUID. Торговые предложения, выступающие в роли модификаторов, передаются как модификаторы блюд. Название позиции корзины всегда соответствует названию товара, а не конкретного торгового предложения.
В систему передаются: имя, телефон и e-mail гостя, комментарий к заказу, количество персон, время доставки (указываются дата и время; при отсутствии выбора устанавливается режим «как можно скорее»), а также адрес доставки.
Адрес определяется через подсказки UCS (город, улица, дом, индекс, координаты) и передаётся с детализацией: квартира, этаж, подъезд, домофон. Ресторан для доставки автоматически выбирается по координатам адреса. Платёжные методы сайта сопоставляются с типами оплаты rKeeper (наличные, карта, онлайн) на основе идентификаторов платёжных систем. Службы самовывоза настраиваются отдельно; такие заказы передаются в rKeeper как самовывоз без указания адреса.
Служба доставки «Доставка rKeeper (UCS)» рассчитывает стоимость через UCS Delivery API на основе адреса и состава корзины. Цена отображается покупателю сразу при оформлении заказа, до нажатия кнопки «Оформить заказ». Проверка зоны доставки выполняется до сохранения заказа: адрес распознаётся через подсказки UCS, по координатам определяется обслуживающий ресторан. Оформление блокируется, если адрес находится вне зоны доставки или сумма заказа ниже минимальной, с отображением понятного сообщения. Заказы без адреса, например самовывоз, не проходят проверку зоны. Недоступность API не блокирует оформление заказа. На сайте открывается окно выбора адреса с автоподсказками и опцией «доставка ко времени»; выбранные значения сохраняются в свойствах заказа.
Оплаченный заказ, который не удалось передать в rKeeper, помечается в административной панели как проблемный с указанием причины. Администратор получает уведомление со ссылкой на заказ, а покупатель — письмо и всплывающее окно на сайте после возврата из платёжной системы. Ведётся файловый журнал с автоматической ротацией; последние записи доступны на странице настроек.
Настройка подключения включает ввод client_id, client_secret и ID ресторана. При необходимости адреса API можно переопределять. В разделе заказов настраивается стадия отправки, проверка зоны доставки, условия и причины отмены, а также e-mail для уведомлений об ошибках. Требуется соответствие свойств заказа (имя, телефон, e-mail, город, адрес, квартира, этаж, подъезд, домофон, дата и время доставки) кодам вашего сайта, а также указание ID служб самовывоза и платёжных систем. Также можно включить ведение журнала.
Для работы модуля необходимы установленные компоненты «Информационные блоки» (iblock) и «Интернет-магазин» (sale). Требуется учётная запись UCS Delivery API с правами на приём заказов ресторана. Каталог блюд rKeeper формируется отдельным решением «rKeeper: выгрузка меню»; данные модули функционируют независимо друг от друга.
При необходимости General iT поможет внедрить «Ркипер(r_keeper) - отправка заказов», настроить модуль и проверить его работу вместе с текущей конфигурацией сайта.