Купер
Интеграция VirtualPos с сервисом доставки Купер (бывший СберМаркет): VirtualPos выгружает в Купер каталог, цены и остатки, а заказы покупателей приходят в VirtualPos как заказы покупателей.
Общее описание
Обмен идёт через API в обе стороны. Каталог, цены и остатки VirtualPos отправляет в Купер сам, по расписанию. О новых заказах и их изменениях Купер сообщает облаку VirtualPos, а VirtualPos в ответ уведомляет Купер, когда вы меняете статус заказа.
- Подключение Служба поддержки включает модуль, вносит ключи доступа Купера и связывает магазины Купера с точками продаж.
- Каталог Вы создаёте группу товаров для Купера и сообщаете её службе поддержки. Раз в сутки группа, её подгруппы и товары выгружаются в Купер.
- Цены и остатки Цены берутся из прайс-листа, назначенного точке продаж для Купера, остатки — со склада точки продаж.
- Заказы Заказ из Купера появляется в разделе «Заказы покупателей». Вы собираете его и меняете статус — Купер получает уведомление.
У интеграции нет своего раздела в панели управления: подключение, ключи и привязку магазинов настраивает служба поддержки VirtualPos. Ваша часть работы — группа товаров, цены, остатки и обработка заказов.
Подключение
Обратитесь в службу поддержки VirtualPos. Для подключения понадобятся:
| Ключи доступа | Client ID и Client secret из личного кабинета партнёра Купера, идентификатор торговой сети |
| Группа для выгрузки | Название группы товаров VirtualPos, которая станет каталогом в Купере, — см. Группа для выгрузки |
| Точки продаж | Какие магазины участвуют в продажах через Купер |
| Прайс-листы | Для каждой точки продаж — прайс-лист с ценами для Купера |
Поддержка сообщит адрес и токен, которые нужно указать в кабинете Купера для передачи заказов в VirtualPos.
В Купере товары, магазины и категории получают те же идентификаторы, что и в VirtualPos: ид товара, ид точки продаж и ид группы товаров. Ид точки продаж виден в её карточке.
Каталог
Группа для выгрузки
Группу, из которой товары попадают в Купер, в панели управления выбрать нельзя: её указывает служба поддержки в настройках интеграции. От вас нужно подготовить группу и назвать её.
- Откройте Товары и цены → Группы товаров и создайте отдельную группу для Купера — например, «Купер». См. Создание группы.
- Внутри неё создайте подгруппы — они станут категориями каталога: «Молочные продукты», «Напитки» и так далее.
- Добавьте товары в подгруппы. См. Товары в группах.
- Сообщите службе поддержки название созданной группы. Поддержка укажет её как группу для выгрузки.
Дальше каталогом вы управляете сами: добавили товар в подгруппу — он появится в Купере со следующей суточной выгрузкой, убрали — перестанет выгружаться. Чтобы назначить для выгрузки другую группу, снова обратитесь в службу поддержки.
Товары кладите в подгруппы. Сама группа для выгрузки категорией не становится, и товары, которые лежат прямо в ней, а не в подгруппе, в Купер не попадают.
Какие товары выгружаются
В Купер выгружаются товары из подгрупп группы для выгрузки — на любом уровне вложенности. Подгруппы становятся категориями каталога.
Товар попадает в выгрузку, если:
- он включён и является обычным товаром;
- он состоит в одной из подгрупп группы для выгрузки;
- у него не отключён показ в интернет-витрине.
| Название, описание | Из карточки товара |
| Фотографии | Изображения товара |
| Категории | Группы товара внутри группы для выгрузки |
| Производитель | Производитель из карточки товара |
| Единица продажи | Весовой товар продаётся за килограмм, остальные — поштучно |
| Количество в упаковке | Из карточки товара |
Группа, у которой отключён показ в интернет-витрине, передаётся в Купер как неактивная категория. Как устроены группы и как добавить в них товары — в статье Группы товаров.
Штрихкоды в каталог не передаются. Дополнительные сведения, которых нет в карточке товара VirtualPos, — бренд, состав, пищевая ценность, условия хранения — при необходимости вносит служба поддержки.
Цены
Цена товара берётся из прайс-листа, который назначен точке продаж при подключении к Куперу. Это может быть отдельный прайс-лист, не совпадающий с тем, по которому работает касса магазина.
| Цена | Цена продажи из прайс-листа Купера для этой точки |
| Ставка НДС | Из карточки товара: 0, 10 или 20 %. Остальные значения передаются как «без НДС» |
| Акционная цена | Не передаётся |
Товар без цены в прайс-листе Купера не получит цену. Проверьте, что все товары группы для выгрузки есть в прайс-листе, назначенном точке продаж для Купера, — см. Прайс-листы.
Остатки
По каждой точке продаж, связанной с магазином Купера, передаётся свободный остаток товара: количество на складе за вычетом резерва. Отрицательный остаток передаётся как ноль.
Остатки выгружаются через очередь: система готовит задания по товарам и точкам продаж и отправляет их пачками. Поэтому изменение остатка в VirtualPos попадает в Купер не мгновенно, а при очередном обмене.
Расписание обмена
| Суточная выгрузка в Купер | Раз в сутки выгружает категории, товары и цены |
| Подготовка остатков для Купер | Готовит остатки к выгрузке |
| Обмен с Купер | Отправляет подготовленные остатки |
| Удаление устаревших данных в Купер | Очищает выполненные задания обмена |
Изменения названий, описаний, состава групп и цен попадут в Купер со следующей суточной выгрузкой. Если нужно срочно обновить каталог, цены или остатки, обратитесь в службу поддержки — выгрузку можно запустить вручную.
Заказы
Когда покупатель оформляет заказ, Купер передаёт его в VirtualPos, и в разделе Заказы покупателей появляется новый заказ.
| Источник | «СберМаркет» |
| Статус | Новый |
| Точка выдачи | Точка продаж, связанная с магазином Купера, в котором оформлен заказ |
| Прайс-лист | Прайс-лист Купера для этой точки |
| Способ получения | Самовывоз или доставка — как выбрал покупатель |
| Адрес доставки, комментарий | Из заказа Купера |
| Клиент | Не заполняется: Купер не передаёт покупателя в справочник клиентов |
| Товары | Количество, цена, сумма и скидка по каждой позиции — как в заказе Купера |
Характеристика (серия) товара в строке подбирается автоматически — из остатка, которого хватает на заказанное количество. Повторное сообщение о том же заказе второй заказ не создаёт.
События Купера
Дальше Купер сообщает о том, что происходит с заказом, и VirtualPos обновляет его сам:
| Событие в Купере | Что происходит в VirtualPos |
|---|---|
| Заказ оплачен | У заказа ставится признак «Оплачен» |
| Заказ передан в доставку | Статус Отправлен |
| Заказ доставлен | Статус Завершён |
| Заказ отменён покупателем | Статус Отменён |
| Заказ изменён | В комментарий заказа добавляется «Изменен способ оплаты: …» или «Изменено время доставки: с … до …» |
| Сборка окончена, курьер назначен, курьер прибыл, курьер получил заказ | Статус заказа не меняется |
Заказ в финальном статусе — «Завершён» или «Отменён» — события Купера больше не меняют.
Ваши действия
Соберите заказ и смените его статус на странице заказа. Купер получит уведомление:
| Статус «Готов к выдаче» | Готов к выдаче |
| Купер получает уведомление, что заказ собран и готов к передаче курьеру или покупателю. | |
| Статус «Отправлен» | Отправлен |
| Купер получает уведомление, что заказ в доставке. | |
| Статус «Отменён» | Отменён |
| Купер получает уведомление, что заказ отменён продавцом. | |
Уведомление отправляется только при смене статуса вручную или с кассы. Изменения, которые пришли из самого Купера, обратно не отправляются.
Как работать с заказом — резерв, сборка, выдача — описано в статье Заказы покупателей.
Частые вопросы
| Ситуация | Причина | Что делать |
|---|---|---|
| Товара нет в каталоге Купера | Товар выключен, не входит в группу для выгрузки или у него отключён показ в интернет-витрине | Проверьте карточку товара и его группы; изменения уйдут со следующей суточной выгрузкой |
| У товара в Купере нет цены | Товара нет в прайс-листе, назначенном точке продаж для Купера | Добавьте цену в этот прайс-лист |
| В Купере остаток меньше, чем на складе | Часть товара зарезервирована под заказы | Проверьте резерв в товарных запасах |
| В Купере остаток ноль, а на складе минус | Отрицательный остаток передаётся как ноль | Оприходуйте товар |
| Остаток или цена в Купере не обновились | Данные уходят по расписанию | Дождитесь следующего обмена или обратитесь в службу поддержки |
| Заказ из Купера не появился | Магазин Купера не связан с точкой продаж, в заказе есть товар, которого нет в VirtualPos, или указан неверный токен | Обратитесь в службу поддержки |
| Купер не узнал о смене статуса | Уведомление не дошло | Обратитесь в службу поддержки: ошибка записывается в журнал |
| Заказ отменён в Купере, а в VirtualPos он уже «Завершён» | Заказ в финальном статусе не меняется | Разберите ситуацию вручную: товар уже списан или выдан |