ClubIS передаёт в StoreHouse 5 справочник прайса и продажи через модуль Конвертор. Обмен идёт по сети: конвертор обращается к Web API StoreHouse 5, отдельные файлы выгрузки не создаются.
Для StoreHouse 4 используется выгрузка в файлы DBF — см. StoreHouse 4.
¶ Что потребуется
- Установленный StoreHouse 5 и служба Web API. Установка API описана в справке r_keeper.
- Модуль Конвертор ClubIS на компьютере, с которого есть доступ к серверу Web API.
- Учётная запись StoreHouse (пользователь и пароль) для обращения к API.
¶ Настройки в ClubIS
¶ Уникальный id клуба
В Администратор → Параметры → Общие, блок Информация о клубе, задайте Уникальный id клуба.
Идентификатор участвует в выгрузке: по нему ClubIS различает позиции разных площадок, если несколько клубов отправляют данные в одну базу StoreHouse 5. У каждой такой площадки номер должен быть своим. После первой успешной выгрузки значение лучше не менять — иначе StoreHouse 5 воспримет позиции как новые.
¶ Как выгрузить
- Откройте модуль Конвертор.
- Выберите Экспорт и правило StoreHouse 5.
- Заполните параметры подключения (см. ниже).
- Укажите период продаж и отметьте группы прайса, которые нужно передать.
- Запустите выгрузку.
¶ Параметры подключения
| Поле | Что указать |
|---|---|
| Сервер | Адрес Web API в формате http://хост:порт, например http://192.168.1.10:9799. Порт задаётся при установке Web API; хост — компьютер, на котором установлен StoreHouse 5. |
| Пользователь и Пароль | Учётная запись StoreHouse 5. |
| Facility URL | Не заполняйте — поле к StoreHouse не относится. |
Перед выгрузкой можно нажать Тест, чтобы проверить связь с сервером.
Опция Сделать GUID родителей для корневых групп всех клубов единым и равным {NULL} нужна, если в одну базу StoreHouse 5 выгружают несколько клубов и корневые группы прайса не принимаются. Включите её и повторите выгрузку. Если группы в StoreHouse 5 уже созданы по-старому, сначала проверьте результат на копии базы StoreHouse.
¶ Что передаётся
Выгрузка идёт по выбранным группам прайса и периоду:
- места реализации — корневые группы прайса;
- корреспонденты — юридические лица этих групп;
- товарные группы — дерево выбранных разделов прайса;
- категории товаров — типы позиций прайса;
- товары — только позиции, по которым в выбранные даты были продажи;
- спецификации продаж — количество и сумма продаж по дням.
В StoreHouse 5 продажи приходят как внешние заявки с признаком «импортирована». Повторная выгрузка тех же продаж за тот же день даёт ответ, что заявка уже импортирована, — это нормально.
Остатки на складе StoreHouse 5 меняет уже сама программа StoreHouse, исходя из этих заявок. Если параллельно ведёте складской учёт в ClubIS, это отдельная настройка: позиции должны быть включены в складской учёт, а в Администратор → Параметры → Склад — включено автоматическое создание списаний.
¶ Подготовка прайса
- Выгружайте только те группы, которые должны попасть в StoreHouse 5 (бар, кухня, рецепция и т. п.).
- Позиции без продаж за выбранный период в товары не попадают.
- Поле Доп. код в группах и позициях прайса используется для поиска и для выгрузок во внешние программы. Для StoreHouse 4 оно связывает номенклатуру явно; в StoreHouse 5 ClubIS сам формирует идентификаторы по номерам в ClubIS и уникальному id клуба.
- Один и тот же товар с разными ценами лучше оформлять одной позицией прайса и разными ценами, а не несколькими копиями с одним кодом.
¶ Если выгрузка не проходит
| Ситуация | Что проверить |
|---|---|
| Нет связи с сервером | Адрес и порт Web API, доступ по сети, логин и пароль StoreHouse 5. |
| Ошибка при передаче товарных групп | Включите опцию про {NULL} для корневых групп и повторите на копии базы StoreHouse 5. Можно выгрузить группы по одной, начиная с корневой без вложенных. |
| Выгрузка одной папки проходит, с подпапками — нет | Сначала выгрузите корневую группу без вложенных. Если не помогло — обратитесь в поддержку ClubIS и приложите лог конвертора. |
| Продажи в ClubIS есть, в StoreHouse 5 актов реализации нет | В StoreHouse 5 ищите внешние заявки с признаком импорта, а не акты списания. Если заявка принята, дальнейшая обработка — на стороне StoreHouse. |
| Сообщение, что заявка уже импортирована | Эти продажи за выбранный день уже переданы. |
Логи конвертора — в каталоге логов ClubIS, файлы clubis-converter… (см. Где хранятся логи программы ClubIS). Для разбора ошибки включите уровень Отладка в настройках логирования того пользователя, под которым запускается конвертор, повторите выгрузку и приложите свежий лог.
Документация API StoreHouse 5: docs.rkeeper.ru/sh5.
¶ См. также
- Прочие интеграции — раздел, к которому относится эта инструкция
- StoreHouse 4 — выгрузка в файлы DBF
- Конвертор — модуль выгрузки
- Прайс — группы, позиции и дополнительный код
- Складской учёт — склад ClubIS и автоматические списания
- Администратор → Параметры → Общие — уникальный id клуба