Введение

DocsInbox — сервис для электронного документооборота. Умеет выгружать номенклатуру и документы, читать и создавать накладные в StoreHouse 4 через WhiteServer (через OLE API SH). Имеет Веб-интерфейс, который также позволяет работать с документами.

Подробнее о возможностях DocsInbox читайте на сайте http://docsinbox.ru/.

Интеграция DocsInbox с системой StoreHouse 4 осуществляется через WhiteServer, расположенным в DataCentre компании UCS.

Для корректной работы интеграции с WSA1 рекомендуем использовать SH5 API версии 1.8. Интеграцию с WSA2 ожидайте от DocsInbox.

Схема взаимосвязи модулей

Схема взаимосвязи модулей отображена ниже:

Дистрибутив

WSAgent доступен по следующей ссылке: ftp://ftp.ucs.ru/WS/WSAgent/versions/.

Утилиты для лицензирования и регистрации кассовых серверов на стороне WS доступны по ссылке: ftp://ftp.ucs.ru/WS/WSAgent/tools/

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

Для работы данной схемы необходимо наличие следующих лицензий на l.ucs.ru:

  1. Мастер лицензия « Интерфейс White Server» на работу WSA в этом ресторане;;
  2. Мастер лицензия на доступ агрегатора, в данном случае агрегатором выступает внешняя система DocsInbox (R-Keeper модуль Интерфейс к DocsInBox RK7 ПО)

Если мастер лицензий нет, то ее необходимо запросить как любое другое ПО через создание Заявки на ПО. После подтверждения заявки проверить в карточке объекта и сгенерировать новую лицензию.
Запрос лицензии происходит в Конфигураторе на вкладке Лицензирование, подробнее в разделе Настройка. Информация запишется в файл WSA.dat, после чего в l.ucs.ru появится лицензия WSClient.

Если мастер лицензии есть, но они просрочены или истекает срок действия, то необходимо выполнить заявку на «Продление ПО».  Далее необходимо перегенерировать лицензию.

После продления лицензии:

  • Повторно запросите лицензию на агента в Конфигураторе на вкладке Лицензирование.
  • Перезапустите в Windows службы:
    • WhiteServerAgent Service
    • WhiteServerAgentMonitor Service.  

Настройка

Настройка WSAgent

Примечание

После обновления агента, конфигуратор импортирует настройки из старого формата wsa.ini в новый wsa.config (закодированный).

  1. Скачайте последнюю версию WSAgent с FTP: ftp://WS/WSAgent/versions/1.0.5.19/wsa.rar. 

  2. Папку с с агентом добавьте в исключения антивирусной программы, иначе возможно блокировка агента, из-за чего не будут работать все запросы. Кроме того, не будет работать автоматическое обновление и перезапуск агента. То есть инженерам нужно будет вручную мониторить и обновлять агенты.

  3. Запустите WhiteServerAgentConf.exe и авторизуйтесь под дилерским ID.

  4. На вкладке Общее выберите одну из систем, с которой будет осуществлена связь.
    В нашем случае это SH4. При использовании прокси-сервера, пропишите параметры прокси.

  5. На вкладке SH4 пропишите параметры соединения с сервером StoreHouse. Проверьте связь, нажав на кнопку Check connection.
  6. На вкладке Лицензирование выберите объект и запросите лицензию. На l.ucs.ru должна предварительно быть получена мастер-лицензия для объекта и активирована.
  7. На вкладке White Server пропишите путь к White Server, по умолчанию — http://ws.ucs.ru/WSServerLP. Проверьте соединение кнопкой, нажав на кнопку Check connection.
  8. На вкладке Служба конфигуратор позволяет установить WhiteServerAgent как службу.

Примечание

Если служба была уже установлена ранее, то необходимо после всех настроек выше нажать кнопку Применить настройки и перезагрузить службу.

В ресторанах, в которых WSAgent подключается к WS через фаейрвол с проверкой по IP адресу, нужно будет сделать изменения в настройках:

  • Изменить IP адрес дополнительного сервера ws-p02.ucs.ru — 185.110.56.30
  • Изменить IP адрес основного сервера ws.ucs.ru — 185.110.56.24.

Настройка на стороне ресторана

Разрешите исходящее соединение на адреса (ws-p02.ucs.ru — 185.110.56.30 и ws.ucs.ru — 185.110.56.24)

Для выполнения API-процедур на стороне складского сервера необходимо добавить все файлы из Sh4Ole.rar (ftp://WS/WSAgent/tools/Sh4Ole.rar) в папку с WSA и зарегистрировать SH4ole.dll в консоли под администратором regsvr32 Sh4Ole.dll. Помните, что WSagent требует дополнительной лицензии для склада в момент выполнения запросов DocsInbox, так как считается дополнительным местом.

В sh4 должна быть разрешена и настроена связь через TCP/IP и указан порт по которому работает соединение с базой.

Включение TCP/IP протокола в свойствах сервера SH4.