Интеграция Store House 5 и ТСД [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Интеграция Store House 5 и ТСД ======
<color /#FFff00>
**Разработка ПО прекращена.
Решение с аналогичной функциональностью: https://docs.rkeeper.ru/sh5/terminal-sbora-dannyh-tsd-17530881.html**

</color>







**Внимание!** На "windows 7 домашняя" модуль связки SH5-ТСД не работает (причина - ограничения rest api cleverence, используемого при работе)

Описание: **Сервер обмена данными с ТСД** (далее **SODL**) позволяет осуществить двухсторонний обмен между программными продуктами **StoreHouse_5** (программа складского учета от UCS) и **Mobile SMARTS Магазин 15** (программное обеспечение от Cleverence для мобильных устройств со встроенным сканером штрихкодов).

Mobile SMARTS позволяет провести инвентаризацию (создание //сличительной ведомости//) или сбор штрихкодов (создание //приходной// и //расходной накладных//, //внутреннего перемещения// и //комплектации//) с помощью ТСД (терминала сбора данных). **SODL** помогает перенести товары из StoreHouse5 в память ТСД для последующего сбора штрихкодов, а также переносит созданный документ обратно в StoreHouse5.

StoreHouse5 <-> **SODL** <-> Mobile SMARTS <-> ТСД

Функционал программы:

  * Загрузка выбранных товарных групп в память ТСД.
  * Просмотр и удаление документов в памяти ТСД.
  * Экспорт документов из ТСД в StoreHouse.
  * Генерация штрихкодов для всех товаров StoreHouse.

Ограничения:

  * [[https://www.cleverence.ru/RTL15/#hw|Поддерживаемые устройства]]
  * Операционная система - Win 7  или выше. На редакции "Win 7 Домашняя" работать не будет
  * Текущая версия программы поддерживает создание в StoreHouse5 следующих типов документов: //сличительная ведомость, приходная накладная, расходная накладная, внутреннее перемещение, комплектация*//

*для документов с вводом цен цену необходимо указывать в самом SH5 после сохранения и выгрузки документа

**Стоимость:**  16000 рублей за каждое устройство. Лицензия привязывается к конкретному устройству.

**Скачать:**
[[https://int.carbis.ru/download/old/Carbis%20TSD%20SH5%20(HoReCa).pdf|Презентация решения]]
[[https://disk.yandex.ru/d/XskRw-9fubesYQ|Актуальный дистрибутив]]

----

===== Перед использованием =====

  - Установлен **StoreHouse_5**  и **SH Web API**. **ВАЖНО!** SHWebAPI рекомендуется версии 1.08. С версией 1.12 есть проблемы при большом количестве документов
  - Установлен **Mobile SMARTS: Магазин 15**  с интеграцией через **REST API**  и приобретена лицензия "Минимум" - [[#установка_mobile_smarts|инструкция]]
  - Прописаны [[#настройка_sodl|настройки в файле params.ini]]
  - Убедиться в наличии LicSystem.dll и params.ini рядом (в одной папке) с SODL.exe

==== Установка Mobile SMARTS ====

=== На ПК ===

  - Загрузить [[https://www.cleverence.ru/RTL15/#about|Магазин 15]]
  - {{:external:ms_1.jpg?350|ms_1.jpg}}
  - {{:external:ms_2.jpg?350|ms_2.jpg}}
  - Выбрать "Интеграция через REST API"
  - {{:external:ms_3.jpg?350|ms_3.jpg}}
  - Выбрать уровень лицензии "Магазин 15. Минимум"
  - {{:external:ms_4.jpg?350|ms_4.jpg}}
  - Выбрать Беспроводной способ обмена
  - {{:external:ms_5.jpg?350|ms_5.jpg}}
  - Дождаться окончания загрузки платформы с сайта и установить Mobile SMARTS
  - {{:external:ms_11.png?350}}
  - {{:external:ms_12.png?350}}
  - {{:external:ms_13.png?350}}
  - Не распаковывать демонстрационные данные
  - {{:external:ms_6.jpg?300|ms_6.jpg}}
  - Прервать, если ТСД на базе Android
  - {{:external:ms_7.jpg?350|ms_7.jpg}}

=== На терминале ===

  * Установить [[https://play.google.com/store/apps/details?id=com.cleverence.android.MobileSMARTS.v3.Retail&roistat_visit=696213|Магазин 15 из Play Market]]
  * Подключиться к базе:

Через QR код

{{  :external:ms_qr_2.jpg  |ms_qr_2.jpg}}

Вручную

{{  :external:ms_manual2.jpg  |ms_manual2.jpg}}

Или

{{  :external:ms_manual.jpg  |ms_manual.jpg}}

Для ускорения процесса сбора штрихкодов через камеру, можно попробовать различные настройки

{{  :external:ms_settings2.jpg?230  |ms_settings2.jpg}}

==== Настройка SODL ====

Настройки файла **params.ini**  (также доступны в разделе Настройки самой программы)

^Секция^Параметр^Описание^По умолчанию|
|**STOREHOUSE** |ip|IP адрес сервера Web API|localhost|
| ::: |port|Порт сервера Web API|1330|
| ::: |username|Имя пользователя StoreHouse5|Admin|
| ::: |password|Пароль пользователя StoreHouse5| |
| ::: |groups|Синхронизируемые товарные группы (коды групп через запятую)|0|
| ::: |ignoreGroups|Игнорируемые товарные группы|0|
| ::: |deviceName1|Название терминала 1| |
| ::: |device1|Код терминала 1| |
| ::: |…|||
| ::: |deviceNameN|Название терминала N| |
| ::: |deviceN|Код терминала N| |
|**CLEVERENCE** |ip|IP адрес сервера данных Mobile SMARTS|localhost|
| ::: |port|Порт сервера данных Mobile SMARTS|9000|
| ::: |bdPath|Путь до базы данных Mobile SMARTS|C:\ProgramData\Cleverence\Базы Mobile SMARTS\Магазин 15, Минимум|
| ::: |passRKCode|1 - передавать в Mobile SMARTS код RK (при наличии). 0 - не передавать|0|
|**LOG** |LogLevel|Уровень логирования|2|
| ::: |OldLogs|Максимальный возраст .log файлов в днях. Старые файлы подлежат удалению.|7|
| ::: |LogMem|Логирование занимаемой памяти|1|

  * Чтобы иметь возможность автоматически добавлять в базу Storehouse неизвестные штрихкоды, отсканированные в ходе сбора штрихкодов, нужно в настройках задать путь до папки с базой данных Mobile SMARTS:

{{  :external:sodl_7.jpg?500  |sodl_7.jpg}}{{  :external:sodl_8.jpg?500  |sodl_8.jpg}}{{  :external:2020-07-17_15-52-11.png?500  }}

==== Лицензирование ====

Для работы требуется лицензия на модуль выгрузки производства "Карбис" и лицензия на софт "Магазин 15 Минимум".

Лицензию на модуль выгрузки можно применить, открыв окно лицензирования следующей последовательностью:

SODL → Настройки → вкладка Лицензирование → Управление лицензией

Далее приведено применение лицензии на софт "Магазин 15 Минимум":

{{  :external:ms_8.jpg?500  |ms_8.jpg}}{{  :external:ms_9.jpg?350  |ms_9.jpg}}{{  :external:ms_10.jpg?350  |ms_10.jpg}}{{  :external:ms_11.jpg?350  |ms_11.jpg}}

**Для получения лицензии на использование Mobile SMARTS Магазин 15 необходимо прислать __Код терминала__ **

{{  :external:sodl_9.jpg  |sodl_9.jpg}}

После получения лицензии на устройство, требуется внести id пролицензированных терминалов в [[external:old:tsd:tsd#настройки|настройках]] .

При замене оборудования или изменении уникальных строковых идентификаторов в результате поломки Вы имеете право на замену уникальных идентификаторов и выдачу нового файла защиты лицензии только при условии, что будут выполнены оба пункта: 1) обмен производился на оборудование той же модели, либо это был ремонт; 2) Вы предоставили Клеверенс официальное письмо из Сервисного центра, удостоверяющее факт замены оборудования или ремонта (с указанием серийных номеров старого и нового оборудования), заверенное печатью и подписью от лица организации, произведшей замену.

===== Использование =====

==== Окно программы ====

{{  :external:sodl1.png?600  }}

==== Синхронизация справочников ====

{{  :external:sodl_4.png  }}

После нажатия на кнопку "Синхронизация справочников" актуальная база товаров, собранная из товарных групп, указанных в файле настроек, будет загружена на сервер данных Mobile SMARTS (ТСД). При этом, если часть товаров уже была загружена в Mobile SMARTS ранее, после начала операции будут загружены только недостающие товары. Товары Mobile SMARTS, каким-либо образом отличающиеся от товаров StoreHouse5 (товар изменён в Mobile SMARTS или удалён из StoreHouse), будут перезаписаны/удалены.

Далее производится **[[#процесс_сбора_штрихкодов_или_инвентаризации|сбор штрихкодов]]**  или **[[#процесс_сбора_штрихкодов_или_инвентаризации|инвентаризация]]**  с помощью ТСД.

==== Загрузка документов из ТСД ====

{{  :external:sodl_5.png  }}

После проведения сбора штрихкодов или инвентаризации документы загружаются в программу нажатием на "Загрузка документов из ТСД". Сперва пользователю будут показаны документы, некорректно сохраненные через ТСД или включающие в себя товары, которые не были синхронизированы (см. [[#синхронизация_справочников|Синхронизация справочников]]), и предложение удалить их. Далее в секции "Список документов в памяти ТСД" будут отображены документы, которые можно загрузить в StoreHouse5 или удалить из Mobile SMARTS (ТСД).

{{  :external:sodl2.png?600  }}

Загрузка документа в StoreHouse5 состоит из следующих этапов:

  * Выбор документа, который необходимо загрузить
  * Выбор типа документа
  * Выбор контрагентов
  * Установка параметров (дата документа, постановка в начало даты и активация)

==== Удаление документа ====

В конце процесса загрузки документа в StoreHouse5 или непосредственно выбрав документ, его можно удалить. Документ удаляется из сервера обмена данными с ТСД и базы данных Mobile SMARTS.

==== Настройки ====

{{  :external:sodl_6.png  }}

В настройках SH (StoreHouse5) находятся кнопки: Управление торговыми группами.

{{  :external:2020-07-17_15-12-54.png?300  }}

После нажатия кнопки откроется настройка торговых групп

Добавляемые: нужно указать коды торговых групп, товары из которых нужно загружать в ТСД. Если в добавляемую торговую группу входит группа, которую не нужно выгружать на терминал, используем вкладку Игнорируемые: требуется указать коды торговых группы, например папка Удаленные

{{  :external:2020-07-17_15-13-16.png?300  }}

Управление терминалами

{{  :external:2020-07-17_15-33-42.png?300  }}

В данном разделе указывается id терминалов пролицензированных в cleverence. Если id терминала не указан, документы собранные на данном терминале выгружаться в SH не будут.

{{  :external:2020-07-17_15-41-55.png?400  }}

Генерации штрихкодов. После нажатия на кнопку "Генерация штрихкодов" будут сгенерированы EAN13 штрихкоды и установлены как внутренние для каждой единицы измерения товара, у которой не установлено ни одного штрихкода. Это действие затрагивает все товары базы StoreHouse5.

{{  :external:2020-07-17_15-08-43.png?300  }}

Выбор валюты для накладных. Кнопка "Обновить" нужна для загрузки списка валют. Если список валют не пустой, кнопку нажимать не нужно. {{  :external:sodl_20.png?300  }}

В настройках ТСД, есть возможность передавать код товара r_keeper. Для включения настройки, перейте в раздел настройки ТСД, установить флаг в поле "Передавать в ТСД код RK"

{{  :external:2020-07-17_15-51-34.png?300  }}

Данная настройка используется на предприятиях работающих с весовым товаром на кассе r_keeper. Произвели фасовку, нанесли штрихкод весового товара на упаковку, при инвентаризации ТСД сканируется данный штрихкод, терминал автоматически распознает вес указанный в штрихкоде.

=== Внимание, код товара r_keeper должен быть не более 5 знаков. ===

===== Процесс Сбора штрихкодов или Инвентаризации =====

  - Нажать кнопку "Сбор штрихкодов" или "Инвентаризация" в зависимости от задачи.
  - Отсканировать/ввести штрихкод или выбрать товар из списка (для этого нужно ввести 0 или в правом верхнем углу нажать 3 точки), (выбрать единицу измерения) ввести количество товара и нажать галочку в правом верхнем углу.
  - Для учета остальных товаров повторить пункт 2.
  - Для завершения процесса нажать в левом верхнем углу <- и далее "Завершить".

{{  :external:ms_inv.jpg  |ms_inv.jpg}}