Интеграция при помощи модуля 1С
Интеграция 1С с getalon*– это программное решение, которое позволяет автоматизировать выгрузку данных из учетной системы на платформу getalon* при минимальном участием сотрудников компании.
Что из себя представляет программное решение
Для каких конфигураций подходит модуль
- 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С снова откройте список расширений и убедитесь, что напротив добавленного расширения отображается зеленый кружок, это значит, что расширение подключилось успешно, и можно переходить к работе с ним:
Если вместо зеленого кружка вы видите красный – значит при подключении расширения возникла ошибка. Пожалуйста, обратитесь по адресу 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" > "Журнал регистрации (События выгрузки)".
Данная команда открывает стандартный Журнал регистрации, но с уже установленными отборами по времени "Сегодня" и по событиям генерируемым модулем обмена. Позволяет проанализировать детальные записи о выполняемых модулем операциях.
