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

Оглавление

Шаг 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−7, при проведении настроенных документов из 1С начнут отправляться API-запросы к Авто.ру Бизнес. Новые поступления автомобилей в 1С будут корректно отрабатываться в Авто.ру Бизнес на всех этапах автомобиля на складе — создание, обновление, перемещение и выбытие.

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

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

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

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


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

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

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

   Примечание

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

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