Инструкция "Интеграция с Управлением Торговлей 11.3" (и версии выше)

Версия 1.22.0 от 15.02.2021

Содержание

Общее описание

Модуль интеграции (далее Модуль) позволяет передавать из типового решения “1С: Управление Торговлей 11.3” (далее УТ 11.3) в прикладное решение “Grotem.Express” документы “Поручения экспедитору” и “Заказы клиента”, и получать из прикладного решения результаты выполнения этих “Поручений экспедитору” (документы отгрузки и оплаты).

Модуль используется совместно с типовой подсистемой доставки, реализованной в УТ 11.3. Обмен ориентируется на документы “Поручение экспедитору”, и связанные с ней документы “Заказ клиента”.

Настройка осуществляется в режиме “мастера” - последовательных действий, которые контролируют заполнение необходимых данных.

Настройка также не требует выполнения каких-либо действий в Конфигураторе и может выполняться пользователями с минимальной квалификацией.

Модуль позволяет настроить регламентное задание и указать расписание, по которому будет выполняться обмен с сервером Grotem.Express.

Ограничения использования

1. Модуль в типовом варианте не работает для баз данных УТ11.3, использующих РИБ (распределенные информационные базы).

Условия, при которых "Заказы клиентов" будут выгружены в мобильное приложение:

1. "Заказ клиента"" должен быть проведен.

2. Статус "Заказа клиента" в соответствии с настройкой заказов покупателей в НСИ и Администрировании:

   1. Режим исполнения заказов = "Заказ как счет" - статус Заказа не проверяется, все Заказы выгружаются.

   2. Режим исполнения заказов = "Заказ только со склада" - выгружаются Заказы в статусе "К отгрузке".

   3. Режим исполнения заказов = "Заказ со склада и под заказ" - выгружаются Заказы в статусе "К выполнению".

3. На основании "Заказа клиента" должен быть проведенный документ "Поручение экспедитору".

   1. В "Поручении экспедитору"" должен быть заполнен реквизит "Ответственный" - пользователь МП, для которого выгружается заказ.

4. На основании "Заказа клиента"" не должно быть создано не помеченных на удаление документов вида "Реализация товаров и услуг".

5. При выгрузке "Заказа клиента" выгружаются и связанные справочники: "Партнеры", "Номенклатура".

6. Пользователи из поля "Ответственный" документа "Поручение экспедитору" автоматически попадает в список пользователей для выгрузки.

Особенности выгрузки заказа из УТ:

1. Если в документе "Заказ клиента" в табличной части содержится несколько строк с одинаковой номенклатурой, то при первом обмене строки будут "объединены" - на сервере GROTEM (а также в мобильном и веб-приложении) в заказе будет одна строка с данной номенклатурой, количество будет соответствовать сумме строк.

2. Редактирование "Заказа клиента" необходимо завершить до отправки заказов на сервер (до выполнения обмена). Добавление позиции, замена одной позиции на другую и прочие изменения могут привести к ошибке обмена.

Установка

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

Актуальное приложение имеет версии вида 1.10.х.х, номер версии можно проверить в настройках "о приложении".

Для включения Модуля в интерфейс типовой конфигурации УТ 11.3 требуется выполнить следующие действия.

• Разместить файл *.epf на диске, куда у вас имеется доступ

• Запустить УТ 11.3 в режиме “Предприятия”. Для входа используйте пользователя с полными правами.

• Перейти в раздел “НСИ и администрирование” - “Печатные формы, отчеты и обработки” - “Дополнительные отчеты и обработки” и подключить внешнюю обработку, указав файл из п.1 (меню “Создать” - выбрать файл)

• Нажмите кнопку "Создать"

• в окне с предупреждением о безопасности - нажмите "Продолжить"

• выберите скачанный файл Модуля

• На вкладке “Команды” в открывшемся элементе “Дополнительная обработка” - выбрать пункт “Размещение” и указать раздел командного интерфейса, в котором будет размещена ссылка открытия Модуля.

• Нажать кнопку “Записать и закрыть”.

• Зайти в раздел командного интерфейса, который был указан в размещении (п.4), найти подраздел «Сервис» и выбрать пункт «Дополнительные обработки».

• В появившемся окне нажать гиперссылку «Настроить список» и отметить флажком пункт «Панель управления Grotem.Express», затем нажать кнопку «ОК».

• теперь, когда обработка добавлена в список - нажать кнопку "Выполнить".

Первоначальная настройка

Настройка адреса подключения

Первый шаг в настройке Модуля - установка параметров подключения к мобильному серверу Grotem.Express. Для подключения потребуются следующие данные:

• URL-адрес, по которому доступно мобильное решение “Grotem.Express”

• пароль администратора мобильного решения (задается при создании решения и указывается в “Паспорте Клиента”).

Запустите УТ 11.3 в режиме “Предприятия” (если еще не запущена) и перейдите в подсистему, которая была выбрана в п.4 раздела “Установка” в качестве места размещения Модуля.

Запустите Модуль. Так как первоначальные настройки не заданы - откроется первый шаг мастера заполнения.

В окне требуется заполнить:

• адрес сервера - адрес или имя сервера, на котором запущен "Grotem.Mobile"

• порт сервера - порт, на котором отвечает "Grotem.Mobile" (если не указан или равен 0, то используется порт в зависимости от протокола: 80 для http, 443 для https)

• защищенное соединение - использовать http или https

• URI решения - путь, по которому опубликовано мобильное решение "Grotem.Express"

• логин администратора решения - по умолчанию admin

• пароль от мобильного решения - пароль, заданный для мобильного решения при его публикации

После ввода параметров нужно нажать кнопку “Проверить связь”. В случае успеха - будет выдано соответствующее сообщение. Если связь установить не удалось - в информационное окно будет выдана техническая информация о проблемах.

В случае - необходимости - изменить параметры для выгрузки:

• “Вид цены” - по этому виду будут установлены цены для номенклатуры в мобильном приложении

• “Вид адреса партнера” - какой из адресов будет указываться для партнеров в мобильном приложении.

Параметры “Использовать типовой план обмена” и “Использовать внешние правила регистрации” изменять не нужно, если используется типовая конфигурация УТ 11.3. По умолчанию они включены.

Если при первоначальной настройке необходимо зарегистрировать изменения справочников к выгрузке, то необходимо установить флаг «Регистрировать изменения объектов».

Инициализация настроек

После успешной проверки связи требуется выполнить инициализацию Модуля, нажав на соответствующую кнопку “Инициализировать”.

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

Выполнение инициализации сопровождается выводом на экран сообщений о текущем шаге.

Перечень выполняемых действий:

• проверка заполнения настроек

• проверка защиты от опасных действий пользователя

• включение функциональной опции “Синхронизация данных” (из раздела “НСИ и администрирование” - "Настройка интеграции" - "Синхронизация данных" - флаг “Синхронизация данных”)

• проверка связи

• инициализация хранилища значений для настроек обмена

• регистрация узла плана обмена “Полный”

• загрузка правил регистрации для созданного узла

• получение первоначальной информации из решения Grotem.Express (значения перечислений, списка пользователей, служебных справочников) и сопоставление полученных данных с данными УТ 11.3

• первоначальная регистрация изменений для обмена

В случае возникновения ошибки будет выдано соответствующее диагностическое сообщение. Причины ошибки нужно выяснять исходя из текста ошибки и шага, на котором эта ошибка возникла.

При успешной инициализации в верхней панели Модуля появятся дополнительные функции, а статус инициализации будет выведен в графе "Результат".

Настройка регламентного задания

Чтобы Модуль выполнял обмен автоматически, требуется настроить регламентное задание.

Перейти в раздел “НСИ и администрирование” - “Печатные формы, отчеты и обработки” - “Дополнительные отчеты и обработки”.

В списке внешних обработок найти “Обмен данными с Grotem.Express” и открыть ее.

На вкладке “Команды” в табличной части напротив пункта “Обмен данными с Grotem.Express” - установить флаг “Выполнять команду по расписанию” (иконка в виде часов).

При установке флага откроется типовое окно по настройке расписания.

Обратите внимание, что у пользователя, от имени которого в системе выполняются регламентные задания, должна быть отключена опция "Защита от опасных действий". Опция выключается в Конфигураторе.

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

Использование Модуля не требует никаких специальных действий от пользователя, если настроено регламентное задание.

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

Настройка новых пользователей

При обработке “Заказов клиента” и “Поручений экспедитору” Модуль анализирует, на какого пользователя назначено “Поручение” и, если пользователь отсутствует в мобильном решении, добавляет его в список:

• имя пользователя создается путем транслитерации его представления

• цифровой пароль генерируется случайным образом

Управление пользователями производится в разделе Модуля “Настройки обмена” - “Настройки выгрузки” - "Пользователи”. Здесь можно добавить нового пользователя, установить логин пользователя или изменить пароли (в том числе и для существующих пользователей).

Ручное выполнение обмена

Если по какой-либо причине требуется выполнить обмен вручную - можно воспользоваться кнопкой “Выполнить обмен данными”. После выполнения обменов (как вручную, так и при автоматических фоновых) обновляются статусы обмена и дата их выполнения.

Регистрация изменений

В разделе “Регистрация изменений” находятся операции, которые позволяют вручную управлять списком объектов, которые будут выгружены в мобильное решение при следующем обмене.

Описание операций:

• "Зарегистрировать изменения" - выполняется принудительная регистрация к обмену всех объектов, подпадающих под правила выгрузки (ВНИМАНИЕ после этой операции выгрузка может занять продолжительное время)

• "Удалить регистрацию изменений" - очистка списка зарегистрированных к выгрузке объектов.

• "Регистрация изменений для обмена" - открывает типовую обработку регистрации к обмену с установленным фильтром по выгрузке в мобильное решение.

• "Получить зарегистрированные объекты" - не используется (планируется получения статуса обмена)

Экспертный режим

Флаг “Экспертный режим” открывает доступ ко всем настройкам Модуля и позволяет адаптировать поведение Модуля в особенных случаях, когда клиента не устраивают типовые настройки.

Раздел в разработке...

Возврат к исходному состоянию

Если на этапе инициализации произошли ошибки или необходимость в Модуле отпала - можно удалить Модуль из системы. После удаления можно начать процедуру установки с начала.

ВНИМАНИЕ Функция доступна только в "Экспертном режиме".

Для выполнения операции откройте Модель из интерфейса программы и перейдите в меню “Сервис” - “Удалить данные” (доступно в экспертном режиме). Все созданные служебные объекты помечаются на удаление. После выполнения процедуры можно выполнить типовую процедуру “Удаление помеченных объектов”.

Внедрение в нетиповую конфигурацию

Раздел в разработке...

1. Добавить план обмена <ИмяПланаОбмена>

2. ОбщийМодуль.ОбменДаннымиПереопределяемый -> Процедура ПолучитьПланыОбмена() -> Добавить: ПланыОбменаПодсистемы.Добавить(Метаданные.ПланыОбмена.<ИмяПланаОбмена>);

3. Добавить общий модуль <ИмяОбщегоМодуля>.

4. Добавить подписку на событие перед записью справочников с обработчиком в общем модуле <ИмяОбщегоМодуля>: Если Не ОбщегоНазначенияПовтИсп.РазделениеВключено() Тогда ОбменДаннымиСобытия.МеханизмРегистрацииОбъектовПередЗаписью(<ИмяПланаОбмена>, Источник, Отказ); КонецЕсли;

5. Добавить подписку на событие перед записью документов с обработчиком в общем модуле <ИмяОбщегоМодуля>: Если Не ОбщегоНазначенияПовтИсп.РазделениеВключено() Тогда ОбменДаннымиСобытия.МеханизмРегистрацииОбъектовПередЗаписьюДокумента(<ИмяПланаОбмена>, Источник, Отказ, РежимЗаписи, РежимПроведения); КонецЕсли;

6. Запустить обработку "Обновление вспомогательных данных"

7. В правилах регистрации поменять имя плана обмена на <ИмяПланаОбмена>. Можно отключить использование внешних правил регистрации, тогда фитрацию данных при регистрации объектов необходимо будет реализовать в обработчиках подписок на события.

Обновление модуля интеграции

Для обновления версии требуется выполнить следующие шаги:

• скачать актуальную версию с сайта https://grotem.atlassian.net/wiki/pages/viewpage.action?pageId=33072157

• заменить текущую обработку на скачанную с сайта

  • зайти в раздел "НСИ и администрирование" - “Печатные формы, отчеты и обработки” - “Дополнительные отчеты и обработки”

  • выбрать в списке текущий загруженный модуль "Панель управления Grotem Express"

  • нажать кнопку "Загрузить из файла..."

    

  • выбрать скачанный файл обработки

В результате в "1С: Предприятие" будет загружен актуальный модуль интеграции. Никаких дополнительных действий после загрузки выполнять не требуется.

Видеоинструкции

Установка и настройка

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

Версии документа и внесенные изменения

"ПолучитьНалогообложениеНДС")