Различия

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

--- external:tsd [2020/09/16 11:30] – ↷ Страница перемещена из external:tsd в external:tsd:tsd Алексей Коробов
+++ external:tsd [2023/01/18 12:40] – ↷ Операцией перемещения обновлены ссылки Алексей Коробов
@@ Строка 1: / Строка 1: @@
+====== Интеграция Store House 5 и ТСД ======
+**Разработка ПО прекращена.
+Решение с аналогичной функциональностью: https://docs.rkeeper.ru/sh5/terminal-sbora-dannyh-tsd-17530881.html**
+**Внимание!** На "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 после сохранения и выгрузки документа
+**Стоимость:**  15450 рублей за каждое устройство. Лицензия привязывается к конкретному устройству.
+**Скачать:**
+[[https://int.carbis.ru/download/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}}