Проблема
Пиццерия принимала заказы на сайте на CS-Cart, а кухня и касса работали в r_keeper Delivery. Задача: написать коннектор и выгружать по регламенту заказы, покупателей, товары с остатками и ценами и категории.
Контекст
Интеграция шла на боевом объекте ресторана, вместе с дилером r_keeper и персоналом пиццерии. Каждый тестовый заказ приходилось согласовывать, чтобы кухня его случайно не приготовила. Меню на сайте и в кассе развивались отдельно и расходились примерно на треть.
Моя роль
Был исполнителем задачи: писал коннектор, согласовывал протокол с дилером r_keeper, настраивал модуль на боевом сайте и сопровождал запуск: разбирал неотправленные заказы, правил сопоставление меню, объяснял сотрудникам пиццерии, как добавлять новые блюда.
Техническое решение
- Авторизация по OAuth (Client ID / Secret) в API r_keeper Delivery, привязка к заведению и витринам магазина.
- Заказы с сайта создаются в r_keeper: полный адрес с координатами и городом отдельным полем, телефон как ключ клиента, скидка — общей суммой на заказ с id скидки из кассы.
- Статусы приходят обратно по вебхуку с заголовком
X-Webhook-Token, а cron раз в 5 минут перепроверяет их для подстраховки. - Меню синхронизируется раз в 30 минут. Есть режим «только цены и остатки» — без создания новых товаров.
- Сопоставление товаров по нечёткому сравнению названий: порог схожести настраивается, учитываются кавычки, регистр и характеристики вроде «33 см». Есть отчёт сравнения, где совпадение можно принять или отклонить вручную.
- Тестовый режим: заказ не уходит в кассу, только логируется. Подробное логирование, предпросмотр синхронизации без изменений.
- На странице заказа — плашка «Заказ отправлен в r_keeper, номер …» и кнопка повторной отправки. Если заказ не ушёл, это видно в письме.
Архитектура
- CS-Cartзаказ на сайте
- Сопоставлениетовар сайта ↔ блюдо кассы
- r_keeper APIOAuth, создание заказа
- Вебхук + cronстатусы обратно на сайт
Реализация
Самые интересные проблемы всплыли на боевом объекте:
- Адрес. r_keeper проверяет адреса через DaData, и заказ на «бульвар Ленина, 22, Симферополь» определялся как Украина. Решилось передачей координат и города отдельным полем.
- Скидки. Сначала скидка раскладывалась по каждому блюду, и касса не пропускала такой заказ на кухню. Переделал на одну скидку на весь заказ с id скидки из r_keeper.
- Названия. «Пицца 4 вкуса 50 см» сопоставлялась с «33 см», соусы с нулевой ценой в кассе перетирали цену на сайте. Добавил ручное подтверждение совпадений и режим обновления только цен и остатков.
Результат
Заказы с сайта уходят на кассу и кухню автоматически, статусы возвращаются на сайт, цены и остатки обновляются по расписанию. После правки скидок дилер r_keeper подтвердил: «Все работает».