====== Интеграция 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 после сохранения и выгрузки документа **Стоимость:** 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}}