Интеграция при помощи модуля 1С

Интеграция 1С с getalon*– это программное решение, которое позволяет автоматизировать выгрузку данных из учетной системы на платформу getalon* при минимальном участием сотрудников компании.

Что из себя представляет программное решение

Программное решение представляет из себя расширение конфигурации 1С (далее по тексту “модуль”), позволяющее внедрить необходимые изменения, без внесения изменений в типовую конфигурацию. Одно из преимуществ внесения изменений через расширение – это сохранение автоматического обновления типовой конфигурации.

Для каких конфигураций подходит модуль

Модуль протестирован и работает на следующих конфигурациях:
  • 1С:Управление торговлей, для версий 11.5.15.* и 11.5.16.*
  • 1С:Комплексная автоматизация, для версий 2.5.15.* и 2.5.16.*
  • 1С:ERP Управление предприятием, для версий 2.5.15.* и 2.5.16.*

Какие возможности реализует модуль

Модуль разработан и работает поверх getalon* REST API и потому имеет аналогичные возможности, кроме удаления сущностей:

Операции со складами

  • добавление
  • обновление
Операции с номенклатурой (товарами)
  • добавление
  • обновление
Операции с остатками товаров на складах
  • добавление
  • обновление
Прочие операции
  • проверка работоспособности сервера getalon*
  • получение статуса операций

Как получить модуль

Актуальная версия модуля доступна для скачивания по этой ссылке.

Инструкция по установке модуля

Чтобы установить модуль в вашу систему – следуйте описанным ниже шагам. В случае возникновения проблем обращайтесь на электронную почту, по адресу info@getalon.ru

Оглавление

  1. Установка расширения
  2. Общие настройки
  3. Заполнение списка номенклатуры для выгрузки
  4. Настройка выгрузки остатков и цен
  5. Первоначальная ручная выгрузка остатков и цен
  6. Автоматическая выгрузка остатков и цен по расписанию
  7. Механизмы анализа результатов работы модуля обмена
    1. Статусы выгрузки объектов
    2. Журнал HTTP запросов
    3. Журнал операций выгрузки данных
    4. Журнал регистрации (События выгрузки)

Установка расширения

1. Зайдите в меню "НСИ и Администрирование" > "Печатные формы, отчеты и обработки":


2. Откройте форму управления расширениями:


3. В открывшейся форме нажмите "Добавить из файла…" и на предупреждение безопасности ответьте "Продолжить":


4. Выберите скачанный файл с расширением, и нажмите "Открыть":


5. Дождитесь установки расширения:

6. После установки снимите флаг "Безопасный режим" и перезапустите программу, чтобы расширение применилось:


7. После перезапуска 1С снова откройте список расширений и убедитесь, что напротив добавленного расширения отображается зеленый кружок, это значит, что расширение подключилось успешно, и можно переходить к работе с ним:


Если вместо зеленого кружка вы видите красный – значит при подключении расширения возникла ошибка. Пожалуйста, обратитесь по адресу info@getalon.ru.

- Перейти к оглавлению -

Общие настройки

1. Зайдите в раздел меню "Getalon" > "Общие настройки":



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

а) заполнятся все основные методы API, адрес сервера и время ожидания по умолчанию;

Актуальный адрес сервера https://api.getalon.ru


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

Управлять заданием (включать/выключать, изменять расписание выполнения) можно в стандартном интерфейсе в разделе "НСИ и администрирование" > "Обслуживание" > "Регламентные и фоновые задания".





3. В форме Общих настроек задайте ключ API полученный от getalon*, нажмите "Проверить подключение" и удостоверьтесь что проверка пройдена успешна, и с ключом нет проблем. Нажмите "Записать и закрыть":

Если при проверке подключения выводится сообщение об ошибке, то убедитесь, что указываете корректный ключ. В ином случае, пожалуйста, обратитесь на почту info@getalon.ru.

- Перейти к оглавлению -

Заполнение списка номенклатуры для выгрузки

1. Зайдите в меню "Getalon" > "Идентификаторы номенклатуры", в открывшейся форме заполните список номенклатуры, которая будет выгружаться на маркетплейс. Возможно ручное добавление командой «Создать» или групповое добавление номенклатуры в список с фильтром по Группе или по Сегменту номенклатуры командами подменю "Дополнить номенклатуру":


2. После заполнения списка выгрузите номенклатуру на маркетплейс командой "Выгрузить номенклатуру (не выгруженную ранее)":


3. После получения информации об успешной передаче данных в обработку, дождитесь информации об их успешной загрузке, обновляя её командой "Обновить статусы выгруженных данных":


4. После того как выгруженная номенклатура будет обработана сервером – статус выгрузки должен смениться на "Выгружен". В случае ошибок выгрузки нужно попробовать повторно выгрузить ошибочные позиции все той же командой "Выгрузить номенклатуру (не выгруженную ранее)":

При сохранении ошибок выгрузки – обратитесь на info@getalon.ru.

- Перейти к оглавлению -

Настройка выгрузки остатков и цен

1) Зайдите в меню "Getalon" > "Настройки выгрузки остатков и цен", создайте новый элемент настройки командой "Создать":

а) задайте Наименование (например, город размещения складов);

б) укажите Вид цен по которому будут выгружаться цены номенклатуры;

в) добавьте в список складов все склады, остатки по которым планируется передавать в маркетплейс;

г) запишите настройку командой "Записать".


2. Перед выгрузкой остатков и цен необходимо выгрузить сами элементы складов. Для этого предназначена команда "Выгрузить склады":


3. После выгрузки, по аналогии с номенклатурой, нужно дождаться успешной обработки выгруженных складов сервером маркетплейса. Для получения информации пользуемся командой "Обновить статусы выгруженных данных":


В случае ошибок выгрузки повторно выгрузите ошибочные позиции все той же командой "Выгрузить склады". При сохранении ошибок выгрузки – обратитесь на почту info@getalon.ru.

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

- Перейти к оглавлению -

Первоначальная ручная выгрузка остатков и цен

1. Зайдите в меню "Getalon" > "Идентификаторы номенклатура-склад". В открывшейся форме заполните поле "Настройка выгрузки остатков и цен" той настройкой, по складам и виду цен которой нужно выгрузить остатки и цены номенклатуры. Выполните выгрузку командой "Выгрузить остатки и цены".

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

2. Дождитесь успешной обработки, запрашивая актуальное состояние обработки командой "Обновить статусы выгруженных данных":


При возникновении ошибок выгрузки – обратитесь на почту info@getalon.ru.

- Перейти к оглавлению -

Автоматическая выгрузка остатков и цен по расписанию

Настройка автоматической выгрузки выполняется в карточке Настроек выгрузки остатков и цен.

1. Откройте ранее созданную настройку выгрузки остатков и цен. В нижней части установите флаг включения выполнения выгрузки по расписанию, и командой "Настроить расписание" укажите требуемую периодичность обмена:


2. Запишите настройку командой "Записать". В результате в базе будет создано новое регламентное задание "(гт) Выгрузка остатков и цен на Getalon: <Наименование настройки выгрузки>" для выгрузки данных именно по выбранной настройке.

Управлять заданием (включать/выключать, изменять расписание выполнения) можно в стандартном интерфейсе в разделе "НСИ и администрирование" > "Обслуживание" > "Регламентные и фоновые задания":


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

- Перейти к оглавлению -

Механизмы анализа результатов работы модуля обмена

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

Статусы выгрузки объектов

Пункт меню "Getalon" > "Статусы выгрузки объектов". В данной форме можно проанализировать текущее состояние выгрузки всех настроенных объектов. Для удобства список сгруппирован по Виду объекта выгрузки и по Статусу последней выгрузки.

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

При необходимости командой «Показать историю состояний» можно переключиться на общий список с полной историей изменений состояния выгрузки всех объектов.


- Перейти к оглавлению -

Журнал HTTP запросов

Пункт меню "Getalon" > "Журнал HTTP запросов". В данный журнал производится запись абсолютно всех выполняемых модулем обмена HTTP запросов к серверу маркетплейса – и ручных, и автоматических.

Журналирование ведется, если в общих настройках включена опция "Логировать HTTP запросы".

Журнал позволяет отследить сам факт выполнения запросов, время их выполнения, и полную информацию о заголовках и теле запроса, а также заголовках и теле ответа на него. Выводится код ответа сервера, и замеряется время исполнения запроса.


- Перейти к оглавлению -

Журнал операций выгрузки данных

Пункт меню "Getalon" > "Журнал операций выгрузки данных". В журнале хранится информация обо всех переданных на сервер маркетплейса операциях выгрузки данных.

Через ИдентификаторЗапроса данные журнала могут быть связаны с Журналом HTTP запросов, для более целостной картины по выгрузке.


- Перейти к оглавлению -

Журнал регистрации (События выгрузки)

Пункт меню "Getalon" > "Журнал регистрации (События выгрузки)".

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



- Перейти к оглавлению -