ПРЕДВАРИТЕЛЬНАЯ НАСТРОЙКА (АДМИНИСТРАТИВНАЯ ЧАСТЬ)
Данный раздел описывает базовые действия по включению и первичной конфигурации модуля Pooling в 1С. Предполагается, что расширение/подсистема API.LS-Group Pooling v2.0 уже установлено в конфигурацию и доступно в разделе «НСИ и администрирование» (или аналогичном, в зависимости от конфигурации 1С).
Включение интеграции с внешними системами
Зайдите в НСИ и администрирование → Предприятие (либо «Общая настройка», в зависимости от конфигурации).
Установите флажок «Используется интеграция с внешними системами», чтобы активировать возможность использования сервиса.
После этого в интерфейсе появится подсистема «Pooling» (с иконкой или названием «Пулинг»).
Назначение ролей для работы с Пулингом
Для корректного разграничения прав в 1С предусмотрены две основные роли:
- Администратор интеграции с внешними системами (или аналогичная роль). Имеет права на полные настройки, загрузку справочников, сопоставление данных, настройку регламентных заданий и т.д.
- Пользователь интеграции с внешними системами. Имеет доступ к созданию и отправке бронирований, обновлению статусов, печати документов, но без возможности менять общесистемные настройки.
Настраивайте эти роли в разделе НСИ и администрирование → Пользователи и права.
Настройка регламентного (фонового) задания (Автообмен)
Чтобы 1С автоматически обновляла статусы бронирований и получала новые данные из Пулинга, необходимо:
Перейти в НСИ и администрирование → Обслуживание → Регламентные операции (или «Фоновые задания»).
Регламентные операции (или «Фоновые задания»).
Создать новое задание (кнопка «Создать» или «Еще» → «Добавить регламентное задание»).
Выбрать объект или обработку, которая отвечает за обновление данных из Pooling (обычно указывается как «Обновление статусов бронирований Pooling» или схожее название).
Настроить расписание (дни, время, периодичность). Например, обновлять каждые 15 минут
Активировать задание (установить флажок «Включено»).
Создание дополнительных реквизитов для контрагентов/партнеров
В зависимости от того, как Вы ведете учет в 1С (через справочник «Контрагенты» или «Партнеры»), необходимо завести дополнительные реквизиты для хранения идентификаторов и типов, которые приходят из Пулинга. Например, «ИД Пулинг» (строка), «Тип контрагента Пулинг» (перечисление или строка) и т.п.
Пример (для справочника «Контрагенты»):
Откройте НСИ и администрирование → Общие настройки → Дополнительные реквизиты и сведения.
Общие настройки → Дополнительные реквизиты и сведения.
Найдите или разверните блок «Контрагенты» (или «Партнеры», если учет ведете через партнеров).
Нажмите «Добавить» для добавления нового доп.реквизита:
Наименование: «Идентификатор (внешний источник)»
Тип значения: «Строка»
Идентификатор для формул: САА_ИдентификаторВнешнийИсточник .
При необходимости, создайте второй реквизит «Тип контрагента (внешний источник)», чтобы в дальнейшем при сопоставлении различать перевозчика, грузоотправителя, торговую сеть и т.д.
Наименование: «Идентификатор (внешний источник)»
Тип значения: «Тип контрагента»
Идентификатор для формул: «САА_ТипыКонтрагентов».
Если требуется хранить привязки складов доставки к тому же объекту (когда один контрагент в 1С имеет несколько адресов), можно добавить еще один доп.реквизит «Склад доставки»
Наименование: «Склад доставки»
Тип значения: «Склад доставки»
Идентификатор для формул: «СкладДоставки_Pooling».
Сохраните внесенные изменения.
Подключение и настройка «Внешнего источника» Пулинг
Перейдите в подсистему Pooling → Внешние источники данных
откройте предопределенный элемент Сервис «Pooling».
В форме настройки на вкладке «Настройка обмена» заполните:
Адрес ресурса (URL) и порт (обычно 443). Эти данные выдаются вашим провайдером сервиса Pooling.
Токен — уникальный ключ для аутентификации, также выдается при подключении к сервису.
Имя пользователя и пароль — если используются (иногда достаточно одного токена). Установите флажок «Отображать реквизиты в связанных объектах» (при необходимости).
На вкладке «Загрузка данных» вы сможете:
- Настроить отборы перед загрузкой справочников (например, тип контрагентов = «Торговая сеть»).
- Запустить «Получение данных» по выбранному справочнику (варианты грузоподъемности, статусы бронирования, типы бронирования и т.д.).
- Включить «Обновлять данные», если необходимо повторно запросить обновленную информацию из Pooling.
подробное описание загрузки находится разделе ЗАГРУЗКА И СОПОСТАВЛЕНИЕ ДАННЫХ ИЗ ПУЛИНГА
Поля внешних источников (сопоставление объектов 1С и Пулинг)
Для гибкого сопоставления объектных данных (документов, справочников) между 1С и Pooling используется регистр «Поля внешних источников».
Здесь задаются:
Какое поле или реквизит в 1С соответствует идентификатору в Пулинге.
Правила сравнения (по строке, коду, доп.реквизиту и т.д.).
Общие поля для всей системы либо отдельные настройки для разных типов объектов (например, документ «Бронирование», справочник «Контрагенты», справочник «Типы грузов» и т. п.).
Шаги настройки:
Перейти в подсистеме Pooling → Поля внешних источников.
Для нужного объекта базы (например, документ «Бронирование») задать способ сравнения:
Параметры.Идентификатор = Объект текущей базы.Идентификатор бронирования и т.п.
Для типовых справочников (варианты грузоподъемности, тип кузова, статусы бронирований) сопоставление обычно идет по полю «Код».
Для контрагентов/партнеров чаще всего сопоставление идет по доп.реквизиту «Идентификатор»(строка).
Если система доработана и для каждого типа контрагента (перевозчик, торговая сеть и т.д.) есть отдельные условия, в полях внешних источников можно прописать соответствующие фильтры.
ЗАГРУЗКА И СОПОСТАВЛЕНИЕ ДАННЫХ ИЗ ПУЛИНГА
Загрузка вспомогательных справочников
Перед тем как подгружать большое количество контрагентов или складов, рекомендуется загрузить «вспомогательные» справочники из Pooling:
- Варианты грузоподъемности
- Статусы бронирования
- Типы бронирования
- Типы грузов
- Типы доставки
- Типы заказов клиента
- Типы кузова транспортных средств
- Типы паллет
- Типы складов
- Регионы доставки
Для каждого из этих справочников:
Откройте форму Сервис «Pooling»( Внешний источник данных).
По кнопке «Получение данных» выберите нужный тип (например, «Типы кузова транспортных средств»).
Нажмите «Выполнить загрузку/обновление типов кузова транспортных средств».
Эти справочники загружаются без ручного сопоставления — система сама сохраняет их во внутренние регистры/справочники, входящие в поставку Pooling.
Загрузка и сопоставление контрагентов
При загрузке контрагентов (перевозчиков, торговых сетей, грузоотправителей) необходимо выполнить ручное сопоставление, чтобы система 1С точно знала, какой контрагент 1С соответствует тому или иному идентификатору в Pooling:
В форме Сервис «Pooling» ( Внешний источник данных) на вкладке Загрузка данных в поле Партнеры — Тип контрагента можно указать, например, «Торговая сеть».
Нажать «Получение данных — Контрагенты».
Откроется окно сопоставления. Если ИНН заполнен в 1С и Пулинг одинаково, часть контрагентов сопоставятся автоматически.
Остальные нужно вручную указать (двойным кликом или выбором соответствующего контрагента 1С).
Нажмите «Записать и закрыть», тогда в 1С сохранятся связанные идентификаторы.
Для уменьшения объёма загрузки можно использовать отборы по типу контрагента: «Торговая сеть», «Перевозчик», «Грузоотправитель» и т.д. Если один и тот же ID Пулинга должен соответствовать нескольким контрагентам 1С, это также допускается — в форме сопоставления можно скопировать строку и указать другого контрагента 1С.
Загрузка и сопоставление складов доставки
Склады доставки бывают очень многочисленны (например, у федеральных сетей). Чтобы не тащить весь список:
В форме Сервис «Pooling» ( Внешний источник данных) на вкладке Загрузка данных в поле Склады доставки выберите нужного Контрагента (главного владельца складов).
При необходимости укажите отбор «Тип склада» и «Регион доставки», чтобы подгружать только нужные склады.
Нажать «Получение данных – Склады доставки».
Загруженные склады при первом получении считаются «неактивными» (подсвечены серым).
Привязка («активация») к конкретному контрагенту или партнеру 1С делается вручную.
Таким образом вы задаете, какой склад Пулинга соответствует конкретному адресу в 1С
