Настройка модуля Обычные формы

Оглавление

Шаг 1. Открыть настройки модуля
Шаг 2. Заполнить справочник API-пар
Шаг 3. Указать объекты учета
Шаг 4. Настроить маппинг складов 1С и автосалонов Авто.ру Бизнес
Шаг 5. Определить цель интеграции
Шаг 6. Настроить прокси-сервер
Шаг 7. Определить документы и справочники участвующие в обмене
Шаг 8. Первичная выгрузка данных
Шаг 9. Определить дату начала регистрации документов к обмену

Шаг 1. Открыть настройки модуля

1. В режиме Предприятия переключите интерфейс на Интеграция с Авто.ру Бизнес.

2. В разделе Интеграция выберите Настройка модуля интеграции. Откроется основное окно настроек модуля.

   Скриншот — Окно настроек модуля

   

   Примечание

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

Шаг 2. Заполнить справочник API-пар

Установите API-доступы к Авто.ру Бизнес:

1. В поле Основная API-пара для работы с Авто.ру Бизнес нажмите .

   Выберите тип аккаунта:

   • Рабочий — аккаунт с боевыми данными;
   • Песочница — тестовая среда разработки.

2. Введите Логин и Пароль.

3. Нажмите Записать → Закрыть.

   Скриншот — API-пары Авто.ру Бизнес

   

4. Нажмите Сохранить.

Шаг 3. Указать объекты учета

Укажите объекты 1С, которые определяют автомобиль и автосалон. Это нужно для настройки маппинга складов 1С и автосалонов Авто.ру Бизнес, а также для определения данных автомобилей, которые будут синхронизироваться.

1. Выберите Объект учета, справочник, определяющий Автомобиль.

   Как правило, это справочник «Автомобиль».

2. Выберите Объект учета, справочник, определяющий Автосалон.

   Как правило это:

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

3. Нажмите Сохранить.

Шаг 4. Настроить маппинг складов 1С и автосалонов Авто.ру Бизнес

1. Нажмите Добавить. Откроется выбор автосалонов Авто.ру Бизнес.

2. Нажмите Заполнить из Авто.ру Бизнес. Откроется окно Форма выбора из списка.

3. В окне Форма выбора из списка отметьте автосалоны, которые должны участвовать в интеграции.

   Скриншот — Форма выбора из списка

   

4. Нажмите Выбор.

   Скриншот — Вид окна после выбора автосалона

   

5. Дважды нажмите на автосалон, чтобы добавить его в маппинг автосалонов. В окне Настройка модуля интеграции автоматически из Авто.ру Бизнес заполнятся название, идентификатор и тип стока (новый или б/у) добавленного салона.

   Скриншот — Настройки модуля интеграции

   

6. В поле Автосалон ДМС выберите один или несколько элементов, определеющих объект учета Автосалон.

7. Нажмите Сохранить.

Шаг 5. Определить цель интеграции

Определите цель интеграции. Выбранная цель влияет на списки полей с информацией об автомобилях, которые будут настраиваться в следующих шагах.

1. Выберите цель интеграции:

   Склад

   Автопостинг

   Умные тактики

   Автоматическая синхронизация склада 1С и автосалона Авто.ру Бизнес.

   Основные этапы синхронизации:

   1. Прием на склад

      При проведении документа приема в 1С в автосалоне Авто.ру Бизнес будет создана карточка авто. Объем данных в карточке авто зависит от настроенного шаблона на следующих этапах.

   2. Обновление данных в авто

      В процессе продажи автомобиля вы можете настроить обновление карточки авто в Авто.ру Бизнес при проведении некоторых документов в 1С.

      Например, при проведении документа корректировки цены продажи в 1С будет передана обновленная цена в Авто.ру Бизнес.

   3. Перемещение автомобиля на другой склад

      При проведении документа перемещения в 1С, карточка автомобиля будет присвоена новому автосалону с настроенным объемом данных.

   4. Продажа (или иное списание)

      При проведении документа реализации в 1С автомобиль в Авто.ру Бизнес будет снят с актуального склада. Вы можете настроить, какие данные передавать из 1С.

      Например, фактическая цена продажи, отметка о продаже автомобиля по программе «Trade in».

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

   Например, обязательно передавать описание автомобилей, фотографий, цен продажи. В результате создания карточки автомобиля в Авто.ру Бизнес происходит автоматическая передача данных на классифайды (Авто.ру, Авито, Дром) для начала публикации объявлений.

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

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

2. Нажмите Сохранить.

Шаг 6. Настроить прокси-сервер

Для работы модуля требуется доступ к сети Интернет. Если доступ в Интернет осуществляется через прокси-сервер, выполните настройки:

1. В правом верхнем углу основного окна настройки нажмите .

   Если доступ в Интернет отсутствует, рядом с кнопкой Настройки прокси появится надпись Соединение с сервером отсутствует.

2. Выберите вариант подключения прокси-сервера:

   • Не использовать прокси-сервер

     Значение по умолчанию.

   • Использовать системные настройки прокси-сервера

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

     • Использовать другие настройки прокси-сервера

       1. Заполните поля:

          • Адрес
          • Порт сервера
          • Имя пользователя
          • Пароль

       2. Включите опцию Использовать аутентификацию ОС. В этом случае для работы с прокси-сервером будет использована учетная запись пользователя операционной системы.

3. Нажмите Сохранить.

Шаг 7. Определить документы и справочники, участвующие в обмене

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

Документы и справочники разбиты на семь типов, которые отвечают за операции над автомобилями в Авто.ру Бизнес:

Шаг 7.1. Добавить документ или справочник

Добавление документа на примере Документы приёма автомобиля на склад в организацию.

1. Нажмите .

2. В списке выберите документ, который отвечает за поступление автомобилей на баланс в 1С.

   Если за поступление отвечает не один документ, укажите их все.

   Пример выбранного документа

   

3. Нажмите Сохранить.

Шаг 7.2. Настроить отбор

1. Нажмите .

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

3. Установите тип сравнения для каждого выбранного реквизита.

   Пример заполненного отбора

   

4. Нажмите Записать.

5. Нажмите Сохранить.

Шаг 7.3. Настроить шаблон передаваемых данных

1. Нажмите .

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

   Цветом в шаблоне выделены обязательные для заполнения атрибуты:

   • Серый — заполняются модулем автоматически и не могут быть отредактированы.
   • Красный — требуется обязательная ручная настройка. Без их заполнения не получится завершить настройку модуля.
   • Белый — рекомендованы к настройке. Их заполнение позволит минимизировать ручную работу на стороне Авто.ру Бизнес.

   Примечание

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

3. Выберите режим заполнения для настраиваемого атрибута:

   • Словарное значение

     Позволяет выбрать в поле Значение словарное значение атрибута.

   • Реквизит объекта

     Позволяет выбрать реквизит, содержащий значение, которое будет передаваться в атрибут.

   • Результат формулы

     Позволяет указать существующую функцию или выражение на языке 1С, которая определит значение атрибута.

4. Нажмите Сохранить.

Шаг 8. Первичная выгрузка данных

После выполнения предыдущих шагов при проведении настроенных документов из 1С начнут отправляться API-запросы к Авто.ру Бизнес. Новые поступления автомобилей в 1С будут корректно отрабатываться в Авто.ру Бизнес по всему циклу жизни автомобиля на складе (создание, обновление, перемещение и выбытие).

Автомобили, которые находились на балансе в 1С до момента подключения интеграции, отсутствуют в Авто.ру Бизнес. Из-за этого API-запросы на их обновление, перемещение и выбытие не будут выполняться, ошибки будут фиксироваться в логах, а документы копиться в очереди к обмену.

Чтобы выгрузить остатки автомобилей из 1С в автосалоны Авто.ру Бизнес:

1. Получите автомобили, которые сейчас находятся на остатках склада 1С.
2. Получите всю цепочку проведенных документов по каждому автомобилю.
3. Зарегистрируйте каждый документ к обмену.
4. Дождитесь выполнения регламентного задания (стандартно один раз в пять минут) или запустите его вручную.

	&НаСервере
	Процедура ЗарегистрироватьОстатки() 
	  
	  Склады = "{{Основной склад 1}}";
	  
	  Запрос = Новый Запрос;
	  Запрос.Текст = "{{АВТОМОБИЛИ С ОТБОРОМ ПО &СКЛАДЫ}}";
	  Запрос.УстановитьПараметр("СКЛАДЫ", Склады)
	  
	  РезультатЗапроса = Запрос.Выполнить();
	  
	  Если Не РезультатЗапроса.Пустой() Тогда
		ВыборкаАвтомобили = РезультатЗапроса.Выбрать();
		Пока ВыборкаАвтомобили.Следующий() Цикл
		  
		  Автомобиль = ВыборкаАвтомобили.Автомобиль;
		  
		  ЗарегистрироватьДокументыАвтомобиля(Автомобиль);
			
		КонецЦикла;
		
	  КонецЕсли;
	  
	КонецПроцедуры         


	&НаСервере
	Процедура ЗарегистрироватьДокументыАвтомобиля(Автомобиль)
	  
	  Запрос = Новый Запрос;
	  Запрос.Текст = "{{ДОКУМЕНТЫ ПО &АВТОМОБИЛЮ}}";
	  Запрос.УстановитьПараметр("АВТОМОБИЛЮ", Автомобиль);
	  
	  РезультатЗапроса = Запрос.Выполнить();
	  
	  Если Не РезультатЗапроса.Пустой() Тогда
		ВыборкаДокументы = РезультатЗапроса.Выбрать();
		
		Пока ВыборкаДокументы.Следующий() Цикл
		  
		  Документ = ВыборкаДокументы.Документ;
		  
		  сме_СлужебныеФункции.ПроверитьЗарегистрироватьОбъектДляВыгрузки(Документ);
			
		КонецЦикла;
		
	  КонецЕсли;
	  
	КонецПроцедуры

Шаг 9. Определить дату начала регистрации документов к обмену

1. Укажите дату, раньше которой не будут регистрироваться документы к обмену.

   Примечание

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

2. Нажмите Сохранить.