# Купер

> Источник: https://wiki.virtualpos.ru/hc/online/regkuper  
> Обновлено: 2026-11-07

Интеграция VirtualPos с сервисом доставки Купер (бывший СберМаркет): VirtualPos выгружает в Купер каталог, цены и остатки, а заказы покупателей приходят в VirtualPos как заказы покупателей.

## Общее описание

Обмен идёт через API в обе стороны. Каталог, цены и остатки VirtualPos отправляет в Купер сам, по расписанию. О новых заказах и их изменениях Купер сообщает облаку VirtualPos, а VirtualPos в ответ уведомляет Купер, когда вы меняете статус заказа.

1. **Подключение** — Служба поддержки включает модуль, вносит ключи доступа Купера и связывает магазины Купера с точками продаж.
1. **Каталог** — Вы создаёте группу товаров для Купера и сообщаете её службе поддержки. Раз в сутки группа, её подгруппы и товары выгружаются в Купер.
1. **Цены и остатки** — Цены берутся из прайс-листа, назначенного точке продаж для Купера, остатки — со склада точки продаж.
1. **Заказы** — Заказ из Купера появляется в разделе «Заказы покупателей». Вы собираете его и меняете статус — Купер получает уведомление.

> **Примечание:**
> У интеграции нет своего раздела в панели управления: подключение, ключи и привязку магазинов настраивает служба поддержки VirtualPos. Ваша часть работы — группа товаров, цены, остатки и обработка заказов.

## Подключение

Обратитесь в службу поддержки VirtualPos. Для подключения понадобятся:

- **Ключи доступа** — Client ID и Client secret из личного кабинета партнёра Купера, идентификатор торговой сети
- **Группа для выгрузки** — Название группы товаров VirtualPos, которая станет каталогом в Купере, — см. [Группа для выгрузки](https://wiki.virtualpos.ru/hc/online/regkuper#группа_для_выгрузки)
- **Точки продаж** — Какие магазины участвуют в продажах через Купер
- **Прайс-листы** — Для каждой точки продаж — прайс-лист с ценами для Купера

Поддержка сообщит адрес и токен, которые нужно указать в кабинете Купера для передачи заказов в VirtualPos.

В Купере товары, магазины и категории получают те же идентификаторы, что и в VirtualPos: ид товара, ид точки продаж и ид группы товаров. Ид точки продаж виден в её [карточке](https://wiki.virtualpos.ru/hc/company/warehouses#карточка_точки_продаж).

## Каталог

### Группа для выгрузки

Группу, из которой товары попадают в Купер, в панели управления выбрать нельзя: её указывает служба поддержки в настройках интеграции. От вас нужно подготовить группу и назвать её.

1. Откройте **Товары и цены → Группы товаров** и создайте отдельную группу для Купера — например, «Купер». См. [Создание группы](https://wiki.virtualpos.ru/hc/items/groups#создание_группы).
1. Внутри неё создайте подгруппы — они станут категориями каталога: «Молочные продукты», «Напитки» и так далее.
1. Добавьте товары в подгруппы. См. [Товары в группах](https://wiki.virtualpos.ru/hc/items/groups#товары_в_группах).
1. Сообщите службе поддержки название созданной группы. Поддержка укажет её как группу для выгрузки.

Дальше каталогом вы управляете сами: добавили товар в подгруппу — он появится в Купере со следующей суточной выгрузкой, убрали — перестанет выгружаться. Чтобы назначить для выгрузки другую группу, снова обратитесь в службу поддержки.

> **Важно:**
> **Товары кладите в подгруппы.** Сама группа для выгрузки категорией не становится, и товары, которые лежат прямо в ней, а не в подгруппе, в Купер не попадают.

### Какие товары выгружаются

В Купер выгружаются товары из подгрупп группы для выгрузки — на любом уровне вложенности. Подгруппы становятся категориями каталога.

Товар попадает в выгрузку, если:

- он включён и является обычным товаром;
- он состоит в одной из подгрупп группы для выгрузки;
- у него не отключён показ в интернет-витрине.

- **Название**, **описание** — Из карточки товара
- **Фотографии** — Изображения товара
- **Категории** — Группы товара внутри группы для выгрузки
- **Производитель** — Производитель из карточки товара
- **Единица продажи** — Весовой товар продаётся за килограмм, остальные — поштучно
- **Количество в упаковке** — Из карточки товара

Группа, у которой отключён показ в интернет-витрине, передаётся в Купер как неактивная категория. Как устроены группы и как добавить в них товары — в статье [Группы товаров](https://wiki.virtualpos.ru/hc/items/groups).

Штрихкоды в каталог не передаются. Дополнительные сведения, которых нет в карточке товара VirtualPos, — бренд, состав, пищевая ценность, условия хранения — при необходимости вносит служба поддержки.

## Цены

Цена товара берётся из прайс-листа, который назначен точке продаж при подключении к Куперу. Это может быть отдельный прайс-лист, не совпадающий с тем, по которому работает касса магазина.

- **Цена** — Цена продажи из прайс-листа Купера для этой точки
- **Ставка НДС** — Из карточки товара: 0, 10 или 20 %. Остальные значения передаются как «без НДС»
- **Акционная цена** — Не передаётся

> **Важно:**
> **Товар без цены в прайс-листе Купера не получит цену.** Проверьте, что все товары группы для выгрузки есть в прайс-листе, назначенном точке продаж для Купера, — см. [Прайс-листы](https://wiki.virtualpos.ru/hc/prices/pricelists).

## Остатки

По каждой точке продаж, связанной с магазином Купера, передаётся свободный остаток товара: количество на складе за вычетом резерва. Отрицательный остаток передаётся как ноль.

Остатки выгружаются через очередь: система готовит задания по товарам и точкам продаж и отправляет их пачками. Поэтому изменение остатка в VirtualPos попадает в Купер не мгновенно, а при очередном обмене.

## Расписание обмена

- **Суточная выгрузка в Купер** — Раз в сутки выгружает категории, товары и цены
- **Подготовка остатков для Купер** — Готовит остатки к выгрузке
- **Обмен с Купер** — Отправляет подготовленные остатки
- **Удаление устаревших данных в Купер** — Очищает выполненные задания обмена

Изменения названий, описаний, состава групп и цен попадут в Купер со следующей суточной выгрузкой. Если нужно срочно обновить каталог, цены или остатки, обратитесь в службу поддержки — выгрузку можно запустить вручную.

## Заказы

Когда покупатель оформляет заказ, Купер передаёт его в VirtualPos, и в разделе [Заказы покупателей](https://wiki.virtualpos.ru/hc/sales/orders) появляется новый заказ.

- **Источник** — «СберМаркет»
- **Статус** — Новый
- **Точка выдачи** — Точка продаж, связанная с магазином Купера, в котором оформлен заказ
- **Прайс-лист** — Прайс-лист Купера для этой точки
- **Способ получения** — Самовывоз или доставка — как выбрал покупатель
- **Адрес доставки**, **комментарий** — Из заказа Купера
- **Клиент** — Не заполняется: Купер не передаёт покупателя в справочник клиентов
- **Товары** — Количество, цена, сумма и скидка по каждой позиции — как в заказе Купера

Характеристика (серия) товара в строке подбирается автоматически — из остатка, которого хватает на заказанное количество. Повторное сообщение о том же заказе второй заказ не создаёт.

### События Купера

Дальше Купер сообщает о том, что происходит с заказом, и VirtualPos обновляет его сам:

| Событие в Купере | Что происходит в VirtualPos |
| --- | --- |
| Заказ оплачен | У заказа ставится признак «Оплачен» |
| Заказ передан в доставку | Статус Отправлен |
| Заказ доставлен | Статус Завершён |
| Заказ отменён покупателем | Статус Отменён |
| Заказ изменён | В комментарий заказа добавляется «Изменен способ оплаты: …» или «Изменено время доставки: с … до …» |
| Сборка окончена, курьер назначен, курьер прибыл, курьер получил заказ | Статус заказа не меняется |

Заказ в финальном статусе — «Завершён» или «Отменён» — события Купера больше не меняют.

### Ваши действия

Соберите заказ и смените его статус на странице заказа. Купер получит уведомление:

- **Статус «Готов к выдаче»** — Готов к выдаче: Купер получает уведомление, что заказ собран и готов к передаче курьеру или покупателю.
- **Статус «Отправлен»** — Отправлен: Купер получает уведомление, что заказ в доставке.
- **Статус «Отменён»** — Отменён: Купер получает уведомление, что заказ отменён продавцом.

Уведомление отправляется только при смене статуса вручную или с кассы. Изменения, которые пришли из самого Купера, обратно не отправляются.

Как работать с заказом — резерв, сборка, выдача — описано в статье [Заказы покупателей](https://wiki.virtualpos.ru/hc/sales/orders).

## Частые вопросы

| Ситуация | Причина | Что делать |
| --- | --- | --- |
| Товара нет в каталоге Купера | Товар выключен, не входит в группу для выгрузки или у него отключён показ в интернет-витрине | Проверьте карточку товара и его группы; изменения уйдут со следующей суточной выгрузкой |
| У товара в Купере нет цены | Товара нет в прайс-листе, назначенном точке продаж для Купера | Добавьте цену в этот прайс-лист |
| В Купере остаток меньше, чем на складе | Часть товара зарезервирована под заказы | Проверьте резерв в [товарных запасах](https://wiki.virtualpos.ru/hc/stock/onhand) |
| В Купере остаток ноль, а на складе минус | Отрицательный остаток передаётся как ноль | Оприходуйте товар |
| Остаток или цена в Купере не обновились | Данные уходят по расписанию | Дождитесь следующего обмена или обратитесь в службу поддержки |
| Заказ из Купера не появился | Магазин Купера не связан с точкой продаж, в заказе есть товар, которого нет в VirtualPos, или указан неверный токен | Обратитесь в службу поддержки |
| Купер не узнал о смене статуса | Уведомление не дошло | Обратитесь в службу поддержки: ошибка записывается в журнал |
| Заказ отменён в Купере, а в VirtualPos он уже «Завершён» | Заказ в финальном статусе не меняется | Разберите ситуацию вручную: товар уже списан или выдан |

## Связанные разделы

- [Заказы покупателей](https://wiki.virtualpos.ru/hc/sales/orders) — Обработка заказов из Купера
- [Группы товаров](https://wiki.virtualpos.ru/hc/items/groups) — Группа для выгрузки и категории каталога
- [Прайс-листы](https://wiki.virtualpos.ru/hc/prices/pricelists) — Цены для Купера
- [Товарные запасы](https://wiki.virtualpos.ru/hc/stock/onhand) — Остатки и резерв
- [Точки продаж и склады](https://wiki.virtualpos.ru/hc/company/warehouses) — Ид точки продаж
- [Яндекс Маркет](https://wiki.virtualpos.ru/hc/online/yandexmarket) — Интеграция с Яндекс Маркетом
- [Яндекс Еда](https://wiki.virtualpos.ru/hc/online/yandexeda) — Продажа товаров через Яндекс Еду
- [Озон](https://wiki.virtualpos.ru/hc/online/ozon) — Интеграция с маркетплейсом Озон