Интеграция 1С и Авито
Важная информация
1. Модуль интеграции 1С и Авито работает с редакциями 1С:
- 1С:Управление торговлей версии 11.4 или 11.5
- 1C:Комплексная автоматизация версии 2.4 или 2.5
- 1С:ERP версии 2.4 или 2.5
- 1С:Управление нашей фирмой, редакция 3.0
- 1С:Розница, редакция 3.0
Для версий 11.4/2.4 и 11.5/2.5 – разные установочные файлы. Обратите внимание на соответствие версии при скачивании файла с модулем.
2. В Авито работа с модулями доступна для пользователей с тарифом и “Расширенным”/”Максимальным” пакетом услуг.
3. Для работы в 1С с заказами Авито Доставки у пользователя должна быть подключена “Доставка для бизнеса”.
Возможности модуля
Работа с объявлениями
- Загрузка объявлений из ЛК в 1С с возможностью перезаполнения
- Создание и выгрузка XML-файла объявлений из базы 1С в ЛК
- Сопоставление объявлений Avito с номенклатурой 1С по наименованию (с возможностью сопоставления нескольких позиций номенклатуры для одного объявления)
- Выгрузка фотографий с помощью «Яндекс Диск»
- Возможность контроля минимальных остатков по номенклатурам при выгрузке
Работа с НСИ
- Загрузка категорий товаров
- Сопоставление параметров объявления с дополнительными параметрами номенклатур ы
- Загрузка параметров объявления в дополнительные реквизиты номенклатуры
Управление остатками
- Выгрузка остатков на сайт Авито
- Проверка корректности заполнения объявлений перед выгрузкой остатков с описанием ошибок
- Работа с остатками:
- Свободный остаток (остаток со склада 1С)
- Добавляемый остаток (добавляем или отнимаем от выгружаемого)
- Ручной остаток (фиксированный остаток, в обход первых двух, пока заполнен)
- Выгружаемый остаток (остаток, который будет выгружен на Авито)
Управление заказами
- Выбор типа доставки (ПВЗ, DBS, rDBS, cDBS, Courier)
- Управление статусами заказов в зависимости от выбранного типа доставки
- Дополнительные действия при типах доставки rDBS и cDBS:
- Подтверждение отправки заказа
- Подтверждение доставки заказа
- Передача сроков и стоимости доставки курьером продавца
- Дополнительные действия при типе доставки DBS:
- Передача трек-номера
- Исправление трек-номера
- Передача стоимости до ставки партнёрами продавца
- Дополнительные действия при типе доставки Courier:
- Получение доступных временных интервалов приезда курьера
- Выбор временного интервала приезда курьера
- Подтверждение возврата с выбором отделения Почты
- Прикрепление контрольно-идентификационного знака (КиЗ)
- Сопоставление заказа клиента с заказом Авито
Мессенджер
- Получение (в том числе системных) и отправка сообщений пользователям:
- через промежутки времени
- по кнопке
- Возможность перехода в объявление из чата с пользователем
- Добавление пользователя в черный список
- Скрытие системных сообщений
- Удаление исходящих сообщений
Установка расширения
Установку релиза 1.0.6.0 и выше необходимо производить через конфигуратор. Для этого после открытия конфигуратора необходим о:
-
Убедиться, что все пользователи вышли из базы. Зайти в пункт «Администрирование» – «Активные пользователи» и убедиться, что в списке активных пользователей указан только один пользователь, находящийся в приложении «Конфигуратор»:


-
Зайти в пункт меню «Конфигурация» – «Расширения конфигурации»:

-
Щелкнуть правой кнопкой мыши по расширению с именем ИС_AVITO и в выпавшем меню выбрать пункт «Конфигурация» – «Загрузить конфигурацию» из файла:

-
Выбрать в окне поиска полученный файл с расширением и нажать «Открыть»:
-
В всплывающем окне нажать «Да»:

-
Обновить конфигурацию расширения, нажав в всплывающем окне нажать «Да»:

7. Выключить параметры «Безопасный режим» и «Защита от опасных действий».

Начало работы с модулем Авито
После установки расширения «Авито» в панели разделов появиться новый раздел «Avito», его состав имеет следующий вид:

Чтобы начать работу в модуле необходимо создать «Профиль Avito» для этого необходимо перейти в раздел «Настройки» -> «Профили».

Далее в открывшемся окне необходимо нажать кнопку «Создать»
F
Далее в открывшемся окне необходимо заполнить поля «Наименование профиля», а также поля «Client id» и «Client secret»

Поле «Наименование профиля» служит рабочем наименованием элемента справочника и может быть заполнено любым значением, главным его предназначением является идентификация профиля в системе, в него необходимо заполнять значение, которое будет понятно вам при работе с модулем. Особенно его значимость определяется в случае работы с нескольких профилей.
Поля «Client id» и «Client secret» необходимо заполнить в соответствии со значениями в вашем личном кабинете авито, они предназначены для работы с API Avito. Для их заполнения необходим воспользоваться следующей ссылкой https://www.avito.ru/professionals/api, либо перейдя на главную страницу сайта Авито https://avito.ru нажать на название вашего магазина (если вместо него отображается надпись «Вход и регистрация» то предварительно на до пройти авторизацию)

Далее, в левом меню перейти в раздел «Для профессионалов», на вкладу «Интеграция», там и будут располагаться необходимые к заполнению поля (пункт 3).

Поле «Номер профиля» также можно найти в личном кабинете.
Дополнительно данную информацию можно найти, нажав на знак «?» справа от полей:
После заполнения данных необходимо нажать на ссылку «Тест подключения», если все сделано верно, то будет выведено сообщение об успешной проверке. Форма примет следующий вид:

в ином случае будет выведено сообщение об ошибке, в этом случае необходим повторить вышеуказанные шаги.
Также на данной вкладки можно включить режим отладки. Данный функционал может помочь при выявлении ошибок при запросах к API Avito.

После включения данного режима в специальный регистр, находящийся в разделе «Сервис» - «Данные отладки» будут производится записи всех запросов к API Avito по данному личному кабинету, содержащие все необходимые данные для технической поддержки:
Пример содержимого регистра «Данные отладки»:

Далее можно перейти к вкладке «Настройки выгрузки объявлений»:

Данный раздел представляет из себя настройки для выгрузки создаваемого feed с объявлениями. Первым делом вам необходимо выбрать «Вид выгрузки», выбор представлен двумя значениям «FILE» и «FTP».
Вид выгрузки «FILE» означает формирование файла с объявлениями и сохранением его на жестком диске компьютера. При выборе данного варианта необходимо заполнить поле «Каталог на диске» в разделе «FILE» и указать в него путь сохранения файла выгрузки.
Вид выгрузки «FTP» означает формирование файла с объявлениями и сохранением его на FTP сервере. При выборе данного варианта необходимо заполнить поля разделе «FTP» в соответствии с вашими настройками FTP сервера.

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

В данной вкладке:
- Вид цены – цена, подставляемая в цену объявлении при формировании объявления;
- Основное контактное лицо – менеджер, подставляемый по умолчанию в объявление;
- Основной телефон – Телефон в объявлении по умолчанию
- Основная категория – категория объявления по умолчанию (выбранная категория будет подставляться автоматически при работе с обработкой «Работа с объявлением»);
- Основной адрес – адрес в объявлении по умолчанию
- Дополнение к описанию – описание, содержащее общую информацию, подставляемое после основного описания;
- Реквизит соответствия описания – выбор между реквизитом номенклатуры и дополнительным реквизитом (для обеспечения ввода 1024+ символов);
- Значение доп. рек. Описание для AVITO – имя допол нительного реквизита с описанием;
- Имя дополнительного реквизита с ссылками на изображения – имя реквизита с хранящимися ссылками на изображение (HTTP, Яндекс диск);
- Округлять 1,5 как 1 - способ округления цен объявлений;
Заполнение описания может происходить как из описания в карточке номенклатуры, так и из значения дополнительного реквизита:

Если есть необходимость заполнять описание из дополнительного реквизита (реквизит номенклатуры имеет ограничение в 1024 символа), тогда необходимо выбрать настройку «Дополнительный реквизит номенклатуры».
Если выбрано описание из дополнительного реквизита, тогда необходимо в поле «Значение доп. рек. Описание для AVITO» указать имя (для разработчика!) данного реквизита. Найти его можно в описании доп. реквизита:

Следует заметить, что максимальное ограничение в описании объявления составляет 7500 символов.
Настройки данного раздела не обязательно выполнять сразу, к ним можно будет вернутся в любое время. Эта информация необходима для заполнения объявлений, к моменту создания и выгрузки она должна быть заполнена.
Далее можно перейти к вкладке «Настройки выгрузки остатков».

Данный раздел предназначен для настройки выгрузки остатков и содержит всего два параметра. Первый «Общий добавляемый остаток». Данный параметр добавляет или отнимает указанное число от выгружаемого остатка в зависимости от знака числа. Данная механика может потребоваться если необходимо скрыть или же наоборот добавить некоторое количество остатка товара для выгрузки на Avito.
Второй «Список складов для выгрузки». Представляет из себя список значений складов, с которых необходимо будет выгружать остаток на Avito. В случае выбора больше одно склада остаток по выбранным складам будет суммироваться.
Перейдем во вкладку «Настройки загрузки заказов»:

В данной вкладке можно настроить данные для заполнения заказа, отделение почты для возвратов.
Далее можно перейти к вкладке «Настройка регламентных заданий».

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

Данное расписание настраивается в зависимости от ваших потребности, но ввиду специфики работы сервиса автозагрузки не рекомендуется устанавливать расписание автоматической выгрузки объявлений и получения статусов чаще чем один раз в час.
Чтобы завершить создание профиля необходимо нажать на кнопку «Записать и закрыть» после чего данный профиль отобразиться в списке профилей:

После этого настройка профиля считается завершенной. Если вы работаете в нескольких профилях, то можно повторить вышеуказанные действия для необходимого количества профилей.
Загрузка категорий
Для дальнейшей работы модуля необходимо произвести загрузку дополнительных справочников необходимых для создания объявлений, для этого предназначены обработки «Загрузка категорий» и «Загрузка справочников» раздела «Настройки»:

В форме обработки «Загрузка категорий Avito» можно выбрать необходимые категории и нажать кнопку «Загрузить»:

Категории объявлений, созданные в базе по завершении загрузки, будут помечены зеленым цветом.
Далее можно переходить к настройке сопоставления параметров номенклатуры.
Сопоставление параметров номенклатуры
Для сопоставления параметров номенклатуры и объявлений необходимо в разделе «Настройки» перейти к пункту меню «Сопоставление параметров номенклатуры». Данная процедура необходима для обеспечения связи между параметрами заполняемы в объявлениях Авито и полями, заполняемыми в платформе 1С, тем самым определяя источники информации для заполнения данных параметров.

Открывшаяся форма будет выглядеть следующим образом

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

Зона 2. Предназначена для выбора источника информации (объект конфигурации) и его конкретного поля, в дальнейшем именно из этого поля информация будет попадать в параметр. Также, здесь можно посмотреть дополнительную информацию о обязательности полей

Зона 3. Представляет собой объединение выбранных значений в Зоне 1 и Зоне 2 с возможностью последующего добавления в регистр
Зона 4. Представляет из себя регистр ранее добавленных правил сопоставления информации. По нему можно посмотреть какие правила имеются в системе, а также удалять данные правила.
Далее рассмотрим простой, пошаговый пример по которому станет понятно, как пользоваться данной обработкой. Предположим, что у нас в базе имеются позиции номенклатуры, которые мы в дальнейшем хотим разместить на Авито. Для того чтобы вручную не заполнять параметры объявления нам необходимо обеспечить их связь при помощи обработки по сопоставлению параметров номенклатуры. Допустим мы хотим, чтобы название нашего будущего объявления формировалось из наименования позиции номенклатуры, соответствующей данному объявлению, для этого нам понадобиться следующее:
В Зоне 1 выбрать «Категорию Авито» соответствующей позиции номенклатуры, планируемой к выгрузке (1).
Далее в списке параметров выбрать необходимый к заполнению параметр, в нашем случае это «Brand» (2).
В Зоне 2 выбрать источник «Раздел 1С» - «Номенклатура», так как мы планируем брать название объявления из поля наименования карточки номенклатуры (3).
Затем в загрузившемся списке «Поля 1С» нам необходимо найти и выбрать поле «Производитель» (4).
После данных действий в Зоне 3 появится сформированная « формула», описывающая правило приемник – источник, если все выбрано верно, то нажимаем кнопку «Добавить» (5).
Результатам наших действий будет добавленная новая строка в Зоне 4 (6).
По аналогии вышеуказанных действий можно обеспечить связь для любого параметра любой категории любым полем относящемуся к номенклатуре, на этом настройка считается законченной.

При загрузке объявлений на Авито важно соблюдение соответствий значений параметров объявлений значениям, которые может принять Авито. Например, для параметра Condition, для большинства категорий можно указать только два значения «Новое» и «Б/у» (именно в таком написании), любые другие значения данного параметра не будут приняты Авито. Если параметр обязателен и не соответствует ожидаемому значению, то объявление не будет загружено. Если параметр не обязателен – объявление загрузится, но значение параметра будет очищено.
