Различия

Показаны различия между двумя версиями страницы.

--- hc:online:regkuper [26.09.2026 14:03] – создано - внешнее изменение
+++ hc:online:regkuper [07.11.2026 14:34] (текущий) – внешнее изменение
@@ Строка 1: / Строка 1: @@
-====== Подключение к Купер (бывший СберМаркет) ======
+~~ICON:local_mall~~
+{{indexmenu_n>20}}
- VirtualPos интегрирован с маркетплейсом Купер. Для настройки обратитесь в службу поддержки.
+====== Купер ======
+Интеграция VirtualPos с сервисом доставки Купер (бывший СберМаркет): VirtualPos выгружает в Купер каталог, цены и остатки, а заказы покупателей приходят в VirtualPos как заказы покупателей.
+===== Общее описание =====
+Обмен идёт через API в обе стороны. Каталог, цены и остатки VirtualPos отправляет в Купер сам, по расписанию. О новых заказах и их изменениях Купер сообщает облаку VirtualPos, а VirtualPos в ответ уведомляет Купер, когда вы меняете статус заказа.
+<WRAP steps>
+  - **Подключение** Служба поддержки включает модуль, вносит ключи доступа Купера и связывает магазины Купера с точками продаж.
+  - **Каталог** Вы создаёте группу товаров для Купера и сообщаете её службе поддержки. Раз в сутки группа, её подгруппы и товары выгружаются в Купер.
+  - **Цены и остатки** Цены берутся из прайс-листа, назначенного точке продаж для Купера, остатки — со склада точки продаж.
+  - **Заказы** Заказ из Купера появляется в разделе «Заказы покупателей». Вы собираете его и меняете статус — Купер получает уведомление.
+</WRAP>
+<WRAP info>
+У интеграции нет своего раздела в панели управления: подключение, ключи и привязку магазинов настраивает служба поддержки VirtualPos. Ваша часть работы — группа товаров, цены, остатки и обработка заказов.
+</WRAP>
+===== Подключение =====
+Обратитесь в службу поддержки VirtualPos. Для подключения понадобятся:
+<WRAP props>
+| **Ключи доступа** | Client ID и Client secret из личного кабинета партнёра Купера, идентификатор торговой сети |
+| **Группа для выгрузки** | Название группы товаров VirtualPos, которая станет каталогом в Купере, — см. [[#группа_для_выгрузки|Группа для выгрузки]] |
+| **Точки продаж** | Какие магазины участвуют в продажах через Купер |
+| **Прайс-листы** | Для каждой точки продаж — прайс-лист с ценами для Купера |
+</WRAP>
+Поддержка сообщит адрес и токен, которые нужно указать в кабинете Купера для передачи заказов в VirtualPos.
+В Купере товары, магазины и категории получают те же идентификаторы, что и в VirtualPos: ид товара, ид точки продаж и ид группы товаров. Ид точки продаж виден в её [[hc:company:warehouses#карточка_точки_продаж|карточке]].
+===== Каталог =====
+==== Группа для выгрузки ====
+Группу, из которой товары попадают в Купер, в панели управления выбрать нельзя: её указывает служба поддержки в настройках интеграции. От вас нужно подготовить группу и назвать её.
+<WRAP procedure>
+  - Откройте **Товары и цены → Группы товаров** и создайте отдельную группу для Купера — например, «Купер». См. [[hc:items:groups#создание_группы|Создание группы]].
+  - Внутри неё создайте подгруппы — они станут категориями каталога: «Молочные продукты», «Напитки» и так далее.
+  - Добавьте товары в подгруппы. См. [[hc:items:groups#товары_в_группах|Товары в группах]].
+  - Сообщите службе поддержки название созданной группы. Поддержка укажет её как группу для выгрузки.
+</WRAP>
+Дальше каталогом вы управляете сами: добавили товар в подгруппу — он появится в Купере со следующей суточной выгрузкой, убрали — перестанет выгружаться. Чтобы назначить для выгрузки другую группу, снова обратитесь в службу поддержки.
+<WRAP important>
+**Товары кладите в подгруппы.** Сама группа для выгрузки категорией не становится, и товары, которые лежат прямо в ней, а не в подгруппе, в Купер не попадают.
+</WRAP>
+==== Какие товары выгружаются ====
+В Купер выгружаются товары из подгрупп группы для выгрузки — на любом уровне вложенности. Подгруппы становятся категориями каталога.
+Товар попадает в выгрузку, если:
+  * он включён и является обычным товаром;
+  * он состоит в одной из подгрупп группы для выгрузки;
+  * у него не отключён показ в интернет-витрине.
+<WRAP props>
+| **Название**, **описание** | Из карточки товара |
+| **Фотографии** | Изображения товара |
+| **Категории** | Группы товара внутри группы для выгрузки |
+| **Производитель** | Производитель из карточки товара |
+| **Единица продажи** | Весовой товар продаётся за килограмм, остальные — поштучно |
+| **Количество в упаковке** | Из карточки товара |
+</WRAP>
+Группа, у которой отключён показ в интернет-витрине, передаётся в Купер как неактивная категория. Как устроены группы и как добавить в них товары — в статье [[hc:items:groups|Группы товаров]].
+Штрихкоды в каталог не передаются. Дополнительные сведения, которых нет в карточке товара VirtualPos, — бренд, состав, пищевая ценность, условия хранения — при необходимости вносит служба поддержки.
+===== Цены =====
+Цена товара берётся из прайс-листа, который назначен точке продаж при подключении к Куперу. Это может быть отдельный прайс-лист, не совпадающий с тем, по которому работает касса магазина.
+<WRAP props>
+| **Цена** | Цена продажи из прайс-листа Купера для этой точки |
+| **Ставка НДС** | Из карточки товара: 0, 10 или 20 %. Остальные значения передаются как «без НДС» |
+| **Акционная цена** | Не передаётся |
+</WRAP>
+<WRAP important>
+**Товар без цены в прайс-листе Купера не получит цену.** Проверьте, что все товары группы для выгрузки есть в прайс-листе, назначенном точке продаж для Купера, — см. [[hc:prices:pricelists|Прайс-листы]].
+</WRAP>
+===== Остатки =====
+По каждой точке продаж, связанной с магазином Купера, передаётся свободный остаток товара: количество на складе за вычетом резерва. Отрицательный остаток передаётся как ноль.
+Остатки выгружаются через очередь: система готовит задания по товарам и точкам продаж и отправляет их пачками. Поэтому изменение остатка в VirtualPos попадает в Купер не мгновенно, а при очередном обмене.
+===== Расписание обмена =====
+<WRAP props>
+| **Суточная выгрузка в Купер** | Раз в сутки выгружает категории, товары и цены |
+| **Подготовка остатков для Купер** | Готовит остатки к выгрузке |
+| **Обмен с Купер** | Отправляет подготовленные остатки |
+| **Удаление устаревших данных в Купер** | Очищает выполненные задания обмена |
+</WRAP>
+Изменения названий, описаний, состава групп и цен попадут в Купер со следующей суточной выгрузкой. Если нужно срочно обновить каталог, цены или остатки, обратитесь в службу поддержки — выгрузку можно запустить вручную.
+===== Заказы =====
+Когда покупатель оформляет заказ, Купер передаёт его в VirtualPos, и в разделе [[hc:sales:orders|Заказы покупателей]] появляется новый заказ.
+<WRAP props>
+| **Источник** | «СберМаркет» |
+| **Статус** | <wrap status warning>Новый</wrap> |
+| **Точка выдачи** | Точка продаж, связанная с магазином Купера, в котором оформлен заказ |
+| **Прайс-лист** | Прайс-лист Купера для этой точки |
+| **Способ получения** | Самовывоз или доставка — как выбрал покупатель |
+| **Адрес доставки**, **комментарий** | Из заказа Купера |
+| **Клиент** | Не заполняется: Купер не передаёт покупателя в справочник клиентов |
+| **Товары** | Количество, цена, сумма и скидка по каждой позиции — как в заказе Купера |
+</WRAP>
+Характеристика (серия) товара в строке подбирается автоматически — из остатка, которого хватает на заказанное количество. Повторное сообщение о том же заказе второй заказ не создаёт.
+==== События Купера ====
+Дальше Купер сообщает о том, что происходит с заказом, и VirtualPos обновляет его сам:
+^ Событие в Купере ^ Что происходит в VirtualPos ^
+| Заказ оплачен | У заказа ставится признак «Оплачен» |
+| Заказ передан в доставку | Статус <wrap status info>Отправлен</wrap> |
+| Заказ доставлен | Статус <wrap status success>Завершён</wrap> |
+| Заказ отменён покупателем | Статус <wrap status>Отменён</wrap> |
+| Заказ изменён | В комментарий заказа добавляется «Изменен способ оплаты: …» или «Изменено время доставки: с … до …» |
+| Сборка окончена, курьер назначен, курьер прибыл, курьер получил заказ | Статус заказа не меняется |
+Заказ в финальном статусе — «Завершён» или «Отменён» — события Купера больше не меняют.
+==== Ваши действия ====
+Соберите заказ и смените его статус на странице заказа. Купер получит уведомление:
+<WRAP actions>
+| **Статус «Готов к выдаче»** | <wrap status info>Готов к выдаче</wrap> |
+| Купер получает уведомление, что заказ собран и готов к передаче курьеру или покупателю. ||
+| **Статус «Отправлен»** | <wrap status info>Отправлен</wrap> |
+| Купер получает уведомление, что заказ в доставке. ||
+| **Статус «Отменён»** | <wrap status>Отменён</wrap> |
+| Купер получает уведомление, что заказ отменён продавцом. ||
+</WRAP>
+Уведомление отправляется только при смене статуса вручную или с кассы. Изменения, которые пришли из самого Купера, обратно не отправляются.
+Как работать с заказом — резерв, сборка, выдача — описано в статье [[hc:sales:orders|Заказы покупателей]].
+===== Частые вопросы =====
+^ Ситуация ^ Причина ^ Что делать ^
+| Товара нет в каталоге Купера | Товар выключен, не входит в группу для выгрузки или у него отключён показ в интернет-витрине | Проверьте карточку товара и его группы; изменения уйдут со следующей суточной выгрузкой |
+| У товара в Купере нет цены | Товара нет в прайс-листе, назначенном точке продаж для Купера | Добавьте цену в этот прайс-лист |
+| В Купере остаток меньше, чем на складе | Часть товара зарезервирована под заказы | Проверьте резерв в [[hc:stock:onhand|товарных запасах]] |
+| В Купере остаток ноль, а на складе минус | Отрицательный остаток передаётся как ноль | Оприходуйте товар |
+| Остаток или цена в Купере не обновились | Данные уходят по расписанию | Дождитесь следующего обмена или обратитесь в службу поддержки |
+| Заказ из Купера не появился | Магазин Купера не связан с точкой продаж, в заказе есть товар, которого нет в VirtualPos, или указан неверный токен | Обратитесь в службу поддержки |
+| Купер не узнал о смене статуса | Уведомление не дошло | Обратитесь в службу поддержки: ошибка записывается в журнал |
+| Заказ отменён в Купере, а в VirtualPos он уже «Завершён» | Заказ в финальном статусе не меняется | Разберите ситуацию вручную: товар уже списан или выдан |
+===== Связанные разделы =====
+<WRAP related>
+  * [[hc:sales:orders|Заказы покупателей]] Обработка заказов из Купера
+  * [[hc:items:groups|Группы товаров]] Группа для выгрузки и категории каталога
+  * [[hc:prices:pricelists|Прайс-листы]] Цены для Купера
+  * [[hc:stock:onhand|Товарные запасы]] Остатки и резерв
+  * [[hc:company:warehouses|Точки продаж и склады]] Ид точки продаж
+  * [[hc:online:yandexmarket|Яндекс Маркет]] Интеграция с Яндекс Маркетом
+  * [[hc:online:yandexeda|Яндекс Еда]] Продажа товаров через Яндекс Еду
+  * [[hc:online:ozon|Озон]] Интеграция с маркетплейсом Озон
+</WRAP>
---------
-[[hc:start| << Вернуться к содержанию]]