Различия

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

--- external:tsd [2021/09/30 15:29] – Алексей Коробов
+++ external:tsd [2023/01/18 12:41] (текущий) – удалено Алексей Коробов
@@ Строка 1: / Строка 1: @@
-====== Интеграция Store House 5 и ТСД ======
-**Внимание!** На "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 после сохранения и выгрузки документа
-**Стоимость:**  13000 рублей за каждое устройство. Лицензия привязывается к конкретному устройству.
-**Скачать:**
-[[https://int.carbis.ru/download/Carbis%20TSD%20SH5%20(HoReCa).pdf|Презентация решения]]
-[[https://yadi.sk/d/1sDG8hh99oT1-Q|Актуальный дистрибутив]]
-----
-===== Перед использованием =====
-  - Установлен **StoreHouse_5**  и **Web API**
-  - Установлен **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: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}}