Объявление. с 31.10.2024г. изменились условия тарифов и стоимость использования приложения.
Подробнее о стоимости и возможностях тарифов можно поочитать на нашем сайте unitxml.ru
Уважаемые пользователи приложения, если у Вас на любом этапе по настройке приложения возникли сложности, пожалуйста, обращайтесь в службу нашей технической поддержки.
Создать обращение можно одним из способов:
- Создать тикет в службу поддержки (Ссылка)
- Отправить письмо в службу поддержки (адрес support@unitxml.ru)
- Вступить в группу в Телеграм и задать вопрос (Ссылка)
- Запись на получение консультации по настройке (Ссылка)
¶ Описание и возможности
¶ Описание
Интеграция с Авито (далее по тексту UnitXML) - это приложение для сервиса МойСклад, основными задачами которого являются:
- Автозагрузка объявлений из МойСклад на Авито
- Актуализация цен и остатков на Авито
- Автоматизация получения заказов из Авито в МойСклад
UnitXML (Интеграция с Авито) — гибкое приложение, с возможностью настройки выгрузки по шаблонам. Для каждой категории товаров на вашем складе можно создать собственный шаблон для выгрузки с настраиваемыми полями.
Интеграция МойСклад с Авито поддерживает быстрое обновление цен и остатков товара на Авито по API, предоставляет возможность получать заказы с Авито и автоматически создавать их в МойСклад.
¶ Установка приложения
Приложение устанавливается стандартным способом, без каких-либо особенностей.
Перейдите в маркетплейс МоегоСклада Интеграция с Авито
Выберите подходящий для ваших задач тариф (Более подробно о возможностях тарифов на нашем сайте)
Или нажмите Попробовать бесплатно, чтобы активировать тестовый период. На время тестового периода, вам будет активирован тариф Расширенный.
Любой тариф можно оплатить на год со скидкой 20%.
¶ Варианты интеграции
Приложение Интеграция с Авито поддерживает два основных варианта интеграции:
¶ 1. Полная настройка автозагрузки
Пример настройки и работы автозагрузки
При таком варианте интеграции, приложение формирует XML фид с объявлениями, на основе ваших товаров из МойСклад, в данный фид попадает полная информация о товаре:
- Наименование
- Изображения
- Описание
- Цена
При таком варианте интеграции, вам достаточно настроить ее один раз, затем все товары, включая новые, которые будут созданы в МойСклад, автоматически будут выгружены на Авито, и при изменении данных товаров в МойСклад, например Описания товара, данные изменения по расписанию будут применены на Авито.
При необходимости можно настроить связь между ранее созданными объявлениями на Авито в ручном режиме и товарами в МойСклад.
Данный способ интеграции немного более сложен на этапе настройки, но он обеспечивает единое место, где вносятся изменения (МойСклад), а также, не будет необходимости создавать объявления на Авито вручную, если у вас в МойСклад появится новый товар, приложение создаст его автоматически. Инструкция по настройке данного варианта интеграции
Данный способ интеграции поддерживает передачу остатков товара (количество шт.) двумя способами:
- Передача остатка через отдельный XML фид
Остаток на Авито будет обновлен при следующей синхронизации по расписанию (подробнее про передачу остатка через XML файл) - Обновление остатка на Авито, при изменении остатка в МойСклад по API
Остаток на Авито будет обновлен в течении ~10 минут (подробнее о передаче изменения остатка по API)
Данный способ интеграции поддерживает обновление цен на Авито двумя способами:
- Через XML фид автозагрузки
Обновление цены на Авито произойдет при следующей синхронизации по расписанию - Обновление цены на Авито, при изменении цены в МойСклад по API
Цена на Авито будет обновлена в течении ~10 минут (Примечание: Данный вариант обновления цены доступен только на тарифе "Расширенный")
При данном способе интеграции будет поддерживаться работа с заказами с Авито, то есть, заказ автоматически создастся в МойСклад, при создании нового заказа на Авито. (Смотрите настройку Заказов и условия использования)
¶ 2. Обновление только цен и остатков
Пример настройки и работы данного варианта интеграции
Обратите внимание, данный вариант интеграции доступен только на тарифе РАСШИРЕННЫЙ. Подробнее с тарифами можно ознакомиться на нашем сайте.
Данный вариант интеграции МойСклад и Авито подойдет тем пользователям, у которых на Авито уже созданы объявления, и необходимо обновлять только цену и остаток с МойСклад.
Этот способ интенрации более прост в настройке, но имеет ряд отличий от первого способа с полной настройкой автозагрузки.
К основным отличиям можно отнести:
- Обновляться на Авио из МойСклад будут только цена и остаток на складе
- При создании нового товара в МойСклад, вам придется объявление создавать на Авито вручную.
- При изменении товара в МойСклад, например описания, наименования, изображения, эти изменения не применятся к объявлению автоматически, вам необходимо будет на Авито вручную добавлять изменения.
При данном способе интеграции будет поддерживаться работа с заказами с Авито, то есть, заказ автоматически создастся в МойСклад, при создании нового заказа на Авито. (Смотрите настройку Заказов и условия использования)
Если вам подходит данный вариант интеграции, то ознакомьтесь с разделом по настройке выгрузки только цен и остатков
¶ Полная настройка автозагрузки
В данном разделе описан процесс полной настройки автозагрузки объявлений из МозСклад в Авито.
При данном способе интеграции, после выполнения всех настроек, приложение создаст XML фид, который будет содержать всю информацию о товаре, Наименование, Описание, Цена, Изображение и категорию на Авито, в которую необходимо разместить или обновить товар.
Условно разделим всю настройку на несколько этапов:
1. Настройка на стороне МойСклад
2. Настройка приложения Интеграция с Авито
3. Настройка автозагрузки на стороне Авито
4. Настройка передачи остатков товара на Авито из МойСклад
¶ 1. Настройка на стороне МойСклад
1.1 Создание дополнительного поля
На данном этапе необходимо создать в МойСклад дополнительное поле, которое будет использоваться приложением как метка, нужно ли выгружать данный товар на Авито или нет.
- Перейдите в МойСклад в раздел Товары -> Товары и услуги
- Нажмите шестеренку в верхней панели инструментов
- В разделе Дополнительные поля, нажмите +Поле
- Название для поля Авито, тип Флажок
- Сохранить
1.2 Выбор товаров для выгрузки
На данном этапе необходимо выбрать товары, которые должны выгружаться на Авито.
Переходим в Товары -> Товары и услуги, открываем карточку товара, и отмечаем дополнительное поле, которое было создано на предыдушем шаге, у тех товаров, которые должны выгружаться.
Примечание. Данное действие можно сделать массово. Для этого в панели инструментов выбрать Изменить -> Массовое редактирование
¶ 2. Настройка приложения Интеграция с Авито
В данном разделе описаны базовые настройки приложения.
¶ 2.1 Основные настройки
На данном этапе необходимо выполнить ряд базовых настроек приложения:
- Выбрать из списка поле для интеграции, созданное в п.п. 1.1
- Выбрать источник данных о товарах
- Настройить проверку остатков
- Настроить расписание
2.1.1 Выбор поля для интеграции
В приложении, на главной странице необходимо выбрать поле для интеграции, по нему приложение будет ориентироваться, нужно ли выгружать товар или нет. Ранее в инструкции, в п.п.1.1 мы создали дополнительное поле, с названием Авито. Выберем его в выпадающем списке.
2.1.2 Выбор источника данных о товарах
В качестве источника данных о товарах может быть два варианта:
- Каталог
- Склады
В чем различия?
Если в качестве источника данных о товарах выбран каталог, то вам будет недоступен функционал по работе с остатками, а именно, проверка остатка, работа с резервом и ожиданием товара. В выгрузку будут попадать все товары, в которых отмечено поле Авито, остаток проверяться не будет, также, не потребуется делать оприходование товара на складе.
Если в качестве источника данных о товарах выбран склад, то вам будет доступен функционал по работе с остатками, а именно, проверка остатка, работа с резервом и ожиданием товара. Например, если будет включена опция проверки остатков, то в выгрузку попадет товар, у которого в карточке отмечено поле Авито, и остаток на складе больше 0. Для того, чтобы работал данный функционал, товар должен быть оприходован на складе (Товара в наличии может не быть, но по нему должно было пройти хотябы одно оприходование).
2.1.3 Выбор складов, товары с которых должны выгружаться
В настройках XML файла необходимо выбрать склад, или склады, товары с которых должны попадать в выгрузку. В нашем примере XML фид один (main по умолчанию) и склад один, выберем его.
2.1.4 Настройка расписания
Приложение производит выгрузку товаров из МойСклад в XML фид для Авито по расписанию.
В блоке Периодичность выгрузки доступны различные варианты интервалов.
Выберите нужную частоту выгрузки.
На разных тарифах доступна разная частота выгрузки, подробнее в разделе Тарифы
¶ 2.2 Настройка шаблонов для выгрузки
Следующим этапом настройки необходимо создать шаблоны для выгрузки.
В шаблонах настраивается мапинг данных из карточки товара в объявление, то есть, необходимо указать, какое поле из карточки товара будет соответствовать данным в объявлениях.
В шаблоне также можно использовать значения из дополнительных полей из карточки товара МойСклад.
На примере разберем настройку шаблона для категории Авито Одежда, обувь, аксессуары -> Мужская обувь -> Кроссовки
В разделе Шаблоны, создаем новый шаблон, назовем его Мужская обувь (Название может быть произвольным), выберем соответствующие категории из выпадающео списка
ПРИМЕЧАНИЕ: В шаблоне есть два поля для идентификации, это поле ID и AvitoId, ознакомьтесь с описанием назначения данных полей перед их заполнением.
Каждое поле в шаблоне имеет название и тег
Актуальные правила заполнения полей, и допустимые значения необходимо смотреть в документации Авито по Автозагрузке
Заполним шаблон для нашей категории Одежда, обувь, аксессуары -> Мужская обувь -> Кроссовки
Обратимся к документации Авито для категории Одежда, обувь, аксессуары -> Мужская обувь -> Кроссовки
В документации есть перечень обязательных полей, которые должны быть заполнены, например:
Заполним в шаблоне поля, согласно требованиям Авито.
В полях шаблона доступны выпадающие списки, в выпадающих списках можно выбрать различные данные из карточки товара, например для поля Наименование
Выберем из выпадающего списка Наименование. Таким образом, для каждого объявления в качестве заголовка объявления на Авито, будет подставлено наименование товара из МойСклад.
Можно выбрать и другое поле, а также, можно использовать значение из доп.полей из карточки товара, если вам необходимо, чтобы заголовок объявления на Авито отличался от наименования товара в МойСклад.
Последовательно необходимо заполнить все поля, которые являются обязательными для данной категории Авито согласно документации документации.
Все поля в шаблоне доступны для редактирования, можно копировать значения из документации и вставлять в соответствующее поле.
¶ 2.3 Связь групп товаров в МойСклад с шаблонами
На данном этапе настройки необходимо связать группы товаров в МойСклад с шаблонами для выгрузки.
В нашем примере мы имеем следующую структуру групп в МойСклад:
Нам необходимо группу Одежда->Мужские кроссовки привязать к созданному ранее шаблону, чтобы товары из этой группы выгружались по этому шаблону.
Обращаем ваше внимание, привязывать нужно именно конечную группу, в нашем случае Мужские кроссовки, если мы привяжем к шаблону группу Одежда, то из подгрупп Брюки, Майки, Мужские кроссовки, товар не выгрузится, делать связь шаблона нужно именно с конечной группой, в нашем примере Одежда->Мужские кроссовки
Переходим в раздел Группы товаров
- В левой колонке выбираем конечную группу (работает поиск)
- В правой колонке выбираем шаблон (работает поиск)
Переходимо на главную страницу в приложении, я нажимаем Выгрузить сейчас, чтобы инициировать процесс выгрузки товаров из МойСклад в XML файл.
Необходимо подождать окончания процесса выгрузки, в зависимости от количества товаров, процесс может занимать разное время, первая выгрузка всегда длится дольше.
Посл окончания выгрузки, мы видим, что в XML фид выгрузился один товар из категории Мужские кроссовки
Если кликнуть на иконку глаз, то откроется список товаров, которые на данный момент выгружены в XML фид.
Также мы видим, что сгенерировалась ссылка на XML фид, ссылка статичная и никогда не меняется.
На этом базовая настройка на стороне МойСклад закончена.
В данной базовой настройке мы хотели показать и рассказать об основном принципе работы приложения, резюмируем:
- Товар создается в МойСклад
- Выбираются склады
- Настраиваются шаблоны для выгрузки
- Шаблоны связываются с группами товаров в МойСклад
- Настраивается расписание
В приложении есть возможность выводить в выгрузку значения из дополнительных полей, на нашем примере нам могло понадобиться доп поле Размер, так как у каждого товара он свой.
Как использовать значения из доп полей в выгрузке, смотрите в разделе Дополнительные возможности - Вывод доп полей в шаблон для выгрузки
¶ 2.4 Проверка XML файла выгрузки на наличие ошибок
После выполнения настроек на стороне МойСклад и выгрузки, необходимо проверить XML файл на наличие ошибок, сделать это можно с помощью специального сервиса Авито.
Ссылка на сервис проверки XML файла на наличие ошибок https://autoload.avito.ru/format/xmlcheck/
- Перейдите по ссылке, в открывшемся окне вставьте ссылку из приложения, и нажмите "Проверить"
- Дождитесь окончания проверки.
¶ 2.5 Работа с ошибками в XML файле
После проверки XML файла на наличие ошибок, с помощью сервиса Авито, или после непосредственной выгрузки на авито, могут быть ошибки. В данном разделе разберем кейс по выявлению и устранению некоторых ошибок.
Для примера смодулируем ситуацию, Вы проверили файл XML на наличие ошибок, и проверка показала, что ошибки присутствуют:
Ниже будет приведен список ошибок (Пример):
В тексте ошибки, в данном случае, говорится о том, что поле Тип телефона (GoodsType) заполнено не верно.
Переходим в приложение, открываем список товаров в выгрузке, и находим данный товар.
Найти данный товар можно по идентификатору, на изображении видно, что у каждого объявления есть свой идентификатор.
-
Копируем идентификатор
-
Находим в списке нужный товар по данному идентификатору. Поиск на странице можно выполнить штатным средством поиска вашего браузера, нажать сочетание клавишей CTRL+F и в открывшееся поле вставить скопированный, на предыдущем шаге, идентификатор
-
Товар нашелся, нас интересует с помощью какого шаблона он был выгружен.
Как видно на скриншоте, товар выгружен с помощью шаблона "Смартфоны samsung"
Переходим в приложение, в настройки шаблонов и находим нужный нам шаблон (Смартфоны samsung)
Напомню, ошибка, в нашем примере, была по полю Вид товара (GoodsType).
Находим данное поле и видим, что там мы при настройке установили значение "Телефоны"
Почему же тогда появляется ошибка, ведь поле заполнено?
Чтобы узнить причину, обратимся к документации Авито по автозагрузке https://www.avito.ru/autoload/documentation/templates
В документации следует найти раздел, который описывает поля для нашей категории, в нашем примере - это категория Телефоны
Ищем описание поля GoodsType, чтобы посмотреть, какие значения оно может принимать
Видим, что среди допустимых значений, нет значения Телефоны, есть значение Мобильные телефоны.
4. Переходим обратно в приложение, открываем шаблон Смартфоны samsung и правим поле GoodsType, впишем туда правильное значение из списка допустимых, для нашего примера - это Мобильные телефоны
- Теперь необходимо произвести выгрузку, чтобы данные обновились в XML файле.
- После окончания выгрузки, необходимо снова проверить XML файл с выгрузкой на наличие ошибок https://autoload.avito.ru/format/xmlcheck/
В данном кейсе мы разобрали одну ошибку, с неверным параметром GoodsType, в данном примере мы постарались отобразить наглядно методологию поиска и устранения ошибок в XML файле для автозагрузки Авито. В случае возникновения других ошибок, можно по данному методу самостоятельно выявлять и устранять эти ошибки. Если у Вас не получается самостоятельно разобраться с возникшими ошибками, то Вы можете обратиться в нашу службу поддержки.
¶ 3. Настройка интеграции на стороне Авито
После того, как вы выполнили проверку XML файла на наличие ошибок, и устранили все ошибки (если они были), можно выполнить интеграцию на стороне Авито.
Необходимо скопировать ссылку на XML файл
Следующим шагом, необходимо перейти в личный кабинет Авито.
Перейдите в раздел Автозагрузка
Вставьте ссылку на XML файл из приложения и настройте расписание, по которому Авито будет читать информацию из файла выгрузки и публиковать объявления
По всем вопросам относительно настроек внутри сервиса Авито, пожалуйста, обращайтесь в поддержку Авито или к Вашему менеджеру.
Из опыта наших пользователей:
- Количество объявлений за период: Все объявления
- Дни: Все дни
- Периоды: Все периоды
После того, как вы настроите расписание и сохраните настройки, будет запущен процесс автозагрузки.
Дождитесь окончания процесса автозагрузки, и вам будет доступен отчет, о том, сколько объявлений было загруено и если были какие-то ошибки в процессе автозагрузки, то они также будут достурны в отчете.
Уважаемые пользователи приложения, если у Вас на любом этапе по настройке приложения возникли сложности, пожалуйста, обращайтесь в службу нашей технической поддержки.
¶ Обновление только цен и остатков
В данном разделе описан процесс настройки функционала по обновления из МойСклад на Авито только цен и остатков товара. Подробнее о возможностях данного варианта можно почитать в описании данного метода
Обратите внимание, при настроке интеграции данным методом, получение заказов из Авито в МойСклад корректно работать не будет. Если вы хотите использовать функционал получения заказов из Авито Авито в МойСклад, то настройте интеграцию по способу №1 (Полная настройка Автозагрузки). Также, обращаем ваше внимание, если у вас используются комплекты, то данный способ не будет передавать их остстки на авито по API (временное ограничение, в скором времени будет доступно)
Разделим настройку на несколько этапов:
- Подключение аккаунта Авито в приложении (если ранее он не был подключен)
- Настройка карточки товаров, создание доп поля
- Включение опций в настройках аккаунта
Первым этапом необходимо выполнить подключение аккаунта Авито в приложении (Если он ранее не был подключен), так как обновление цен и остатков будет происходить с помощью интеграции через API.
Далее необходимо создать дополнительные поля в карточке товара.
Нам необходимо создать два дополнительных поля:
- Название: Авито, Тип: Флажок
- Название: Номер объявления, Тип: Строка
Как создавать доп поля можно прочитать в инструкции по созданию дополнительных полей
На следующем шаге нам необходимо сопоставить Товар в МойСклад и Обявление на Авито
Откройте объявление на Авито, укаждого объявления на Авито есть номер, скопируйте его.
Откройте карточку данного товара в МойСклад
Отметьте поле Авито - это будет означать, что приложение будет отслеживать изменение цены и остатка в данном товаре
Вставьте скопированный с Авито номер объявления - таким образом, вы свяжете данный товар в МойСклад, с объявлением на Авито.
Если вам необходимо связать один товар в МойСклад, с несколькими объявлениями на Авито, для обновления цен и остатков, то вставьте в данное поле номера объявлений с Авито через запятую. Таким обраом, приложение обновить во всех объявлениях, номера которых указаны в поле, цену и остаток, при изменении цены или остатка в данном товаре в МойСклад.
Следующий этап это выполнить настройки непосредственно в приложении Интеграция с Авито.
Необходимо выбрать поле для интеграции, это то поле, по которому приложение будет ориентироваться, нужно ли обновлять информацию по данному товару или нет. Мы его создали ранее, в нашем примере назвали Авито.
Откройте приложение Интеграция с Авито
- Нжмите "Обновить данные"
- Из выпадающего списка выберите поле Авито
- Сохраните изменения, нажмите "Сохранить"
В нашем примере, мы настроим обновление на Авито цены и остатка по товарам.
Можно обновлять только остаток или только цену, в зависимости от ваших задач.
- Откройте приложение Интеграция с Авито. Перейдите в раздел Авито в главном меню.
- Отметьте опцию "Передавать изменение цены по API"
- Из выпадающего списка выберите цену, которая должна отображаться на Авито. (Вы всегда можете создать новую цену в карточке товара, например Цена для Авито, как создать новую цену, написано в данном разделе
- Из выпадающего списка выберите доп поле, в котором вписан номер объявления в карточке товара. В нашем примере мы создавали и заполняли поле Номер объявления на Авито, выберем его.
- Отметьте опцию "Передавать изменение остатков по API" (Если вы не хотите обновлять на Авито остаток, то пропустите данный пункт
- Нажмите "Сохранить"
Далее нужно выбрать склады, остаток товаров по которым должен передаваться на Авито., а также настроить фильтры для работы с остатком.
Если вы не хотите обновлять на Авито остаток, то пропустите данный этап
- Пеерейдите в раздел XML файлы
- Кликните на XML файл, в нашем примере он один (по умолчанию main), выберем его
- Ниже списка с XML файлами доступен выбор складов, выберем нужные склады (Внимание, если вы выбрали несколько складов. то остаок с данных складов будет суммироваться и отправляться на Авито)
- Сохраните изменения.
Заключительны этап - это настройка фильтров, по которым будет происходить обработка остатка товаров.
Если вы не хотите обновлять на Авито остаток, то пропустите данный этап
- Перейдите на главную страницу приложения
- Выберите Выгружать товары со складов
- Обязательно отметьте опцию "Использовать ускоренную проверку остатков"
- Выберите один из пунктов обработки остатков (Мы рекомендуем выбрать Вычитать из остатков резерв) Каждый пункт имеет описание, ознакомьтесь с ним, и выберите подходящий для ва способ
- Сохраните изменения, нажмите "Сохранить"
На этом базовая настройка обновления цены и остатка из МойСклад на Авито закончена.
Теперь, при изменении цены или остака в МойСклад, данные изменения применятся на Авито в течении 5-10 минут. Например, вы изменили цену на товар в МойСклад, цена обновиться на Авито автоматически.
Тоже самое и по поводу остатка, как только будет изменен остаток товара в МойСклад, в течении до 10 мину остаток поменяется на Авито.
¶ Дополнительные возможности
¶ Заказы Авито
Функционал по работе с заказами доступен в тарифе "РАСШИРЕННЫЙ"
ВНИМАНИЕ! Для того, чтобы работал данный функционал, есть несколько условий: 1. Ваш аккаунт на авито должен иметь статус Компания (ИП или ООО) 2. Для Вашего аккаунта Авито должна быть подключена Авито доставка для Бизнеса. 3. У вас должна быть выполнена полная настройка автозагрузки. При настройке варианта Обновление только цен и остатков заказы будут создаваться пустые, без товаров. В скором времени данные ограничения будут сняты.
ПРИМЕЧАНИЕ: На данном этапе у вас уже должна быть выполнена базовая настройка интеграции, включая выбор скадов и настройка фильтров, которая описана в соответствующем разделе по базовой настройке интеграции.
Данный функционал, позволяет автоматически создавать заказ в МойСклад, в момент когда заказ создается на авито покупателем.
Настройка интеграции заказов делится на несколько этапов:
Этап №1: Добавление аккаунта авито в приложение
Для того, чтобы добавить аккаунт Авито в приложение, перейдите в раздел Авито в приложении
1.1. В блоке Аккаунты Авито, нажмите добавить
1.2. Введите данные для доступа к аккаунту Авито по API. Эти данный можно получить в вашем личном кабинете Авито, в разделе Интеграции https://www.avito.ru/professionals/api
1.3. Выберите XML файл для данного аккаунта (по умолчанию доступен один XML файл main)
1.4. Сохраните настройки
Этап №2: Настройка опций
Активируйте опцию Получать заказы с Авито в МойСклад
2.1. Выберите Юр.лицо из списка доступных, или создайте новое Юр.лицо в МойСклад
2.2 Выберите канал продаж из списка доступных, или создайте новый в МойСклад
2.3. Настройте опции для работы с контрагентами с Авито.
Если будет отмечена опция Создавать контрагентов, то приложение при поступлении заказа из Авито, создаст нового контрагента с данными пользователя с Авито. Также, для удобства, необходимо добавить префикс для контрагентов с Авито, например Клиенты с Авито.
Если не будет отмечена опция Создавать контрагентов, то вам необходимо будет выбрать из списка одного из ваших контрагентов, чтобы заказы в МойСклад поступали от его имени. На практике часто встречается случай, когда создается один клиент в МойСклад, и на него записываются все заказы. Называют пользователя по разному: Виртуальный покупатель Авито, Клиент Авито и т.д. Выберите из списка или создайте нового.
Этап №3: Настройка соответствия статусов на Авито и в МойСклад
Далее необходимо настроить соответствие статусов заказа на Авито, статусам заказов в МойСклад
В колонке слева расположены все статусы Авито, им необходимо выбрать в колонке справа соответствия статусов в МойСклад
Для каждого статуса Авито, должен соответствовать статус в МойСклад, два раза использовать один и тот же статус нельзя. Если у вас не хвататет статусов, то их можно создать в МойСклад, в разделе:
Продажи -> Заказы покупателей.
Откройте любой заказ, разверните список статусов, и нажмите "Настроить"
Добавьте нужные статусы.
Обращаем Ваше внимание, приложение автоматически обновляет статусы заказов из Авито в МойСклад. При изменении статуса на Авито, статус обновится в МойСклад.
Этап №4: Настройка дополнительных опций
На данном этапе необходимо настроить дополнительные опции.
4.1. Вставлять в заказ комплектующие комплекта - При поступлении заказа с Авито на товар, который является в МойСклад комплектом, при ВКЛЮЧЕННОЙ опции, в заказ будут вставлены все комплектующие данного комплекта. При ВЫКЛЮЧЕННОЙ опции, в заказ подставится комплект
4.2. Резервировать позиции заказа - При поступлении заказа с Авито на товар, который в заказе, будет установлен резерв на складе
4.3. Вычитать из цены заказа комиссию Авито - Если выбрана данная опция, то в заказ будет вставлена цена на товар за вычетом комиссии Авито
4.4. Вычитать из цены звказа скидки Авито - Если выбрана данная опция, то в заказ будет вставлена цена на товар за вычетом скидки Авито
Этап №5: Заключительный этап, сохранение настроек и запуск интеграции
В самом низу блока с настройками нажмите Сохранить
Далее нажмите Запустить Интеграцию заказов
¶ Работа с заказами
После сохранения настроек и запуска интеграции заказов, в главном меню появится иконка Заказы Авито
Схема взаимодействия Авито - Интеграция - МойСклад выглядит следующим образом:
- Поступает новый заказ от покупателя на Авито
- Приложение получает заказ с Авито
- Приложение создает Новый заказ покупателя в МойСклад (В едином центре заказов)
Все заказы с Авито доступны в приложении и в МойСклад, в разделе Заказы покупателей
Рассмотрим подробнее раздел с заказами в приложении.
В приложении доступны все заказы с Авито в виде списка, который можно отсортировать по дате поступления заказа
Описание колонок:
- Номер - Номер заказа с Авито
- Дата создания - Дата создания заказа на Авито
- Магазин - Название магазина продавца (Название профиля Авито)
- Покупатель - Ссылка на профиль покупателя
- Статус - Текущий статус заказа
- Сумма - Сумма заказа
После получения заказа приложением, он создается в МойСклад, в центре управления заказами (ЦУЗ).
Продажи -> Заказы покупателей
Заказ в ЦУЗ создается с номером заказа с Авито, например:
На авито поступил новый заказ, Авито присвоило ему номер 700000001, приложение получило данный заказ, и он будет создан в ЦУЗ с этим номером 700000001. Таким образом, это делает работу с заказами более прозрачной, что уменьшит количество ошибок при обработке заказов.
Если кликнуть на любой заказ в приложении, в списке заказов, то откроется карточка заказа:
Карточка заказа в приложении разделена на несколько блоков:
Номер заказа дата поступления - В данном блоке присутствует информация о номере заказа и дате поступления заказа. Если кликнуть по номеру заказа, то вы перейдете к управлению данным заказом в МойСклад в центр управления заказами.
Общая информация - В данном блоке расположена общая информация по заказу:
- AvitoID - это идентификатор заказа на Авито
- Статус - Текущий статус заказа
- Магазин - Название магазина продавца (Название профиля Авито)
- Покупатель - Ссылка на профиль покупателя на Авито
- Чат - ссылка на Авито, на чат с покупателем
- Дата создания - Дата создания заказа на Авито
- Дата обновления - Дата автоматического обновления информации по заказу
Доставка - В данном блоке расположена информация по доставке, а именно:
- Способ доставки
- Трекномер
- Тип доставки
- Информация о покупателе (Если она заполнена покупателем на Авито)
- Комментарий к заказу (Если покупатель оставил комментарий при заказе)
Товары - В данном блоке расположена информация о составе заказа, товар(-ы) списком.
В списке имеются активные ссылки, одна ведет на товар в МойСклад, другая на объявление по данному товару на Авито.
Журнал - В данном блоке расположена информаци по обработке заказа:
- Дата и время поступления заказа
- Дата и время создания заказа в МойСклад
- Дата и время обновления информации по заказу.
¶ Чаты Авито
¶ Интеграция чатов с Авито
Ведение переписки с клиентами с авито из приложения.
Данный функционал позволяет полноценно вести переписку с клиентами с авито напрямую из приложения, а также, если у вас настроены заказы с Авито в МойСклад, то можно прямо из заказа в МойСклад писать покупателю и получать от него сообщения.
Поддерживается несколько аккаунтов.
Настройка и активация мессенджера в приложении:
- Необходимо перейти в приложени в раздел Авито
- Добавьте аккаунт или аккаунты Авито, заполнив необходимые поля для авторизации приложения на портале Авито:
- ClientId
- ClientSecret
Получить данные ключи для авторизации можно в личном кабинете Авито (Ссылка на раздел с ключами для доступа по API)
- После сохранения, в главном меню появится новая вкладка "Мессенджер". В данном разделе будут доступны диалоги с авито.
Приложение поддерживает подключение нескольких аккаунтов авито.
На данном этапе настройка закончена и Вы можете общаться с клиентами из приложения Интеграция МойСклад и Авито. Сообщения будут приниматься и отправляться в режиме реального времени.
¶ Выгрузка изображений по ссылкам
С помощью приложения можно гибко настроить выгрузку изображений из МойСклад на Авито.
Если не производить никаких настроек, то приложение выгружает все катринки из каждой карточки товара из МойСклад, но бывает такая необходимость выгружать изображения не из МойСклад, а например с собственного сайта или с Яндекс Диска.
Пример: У Вас на сайте загружены изображения в хорошем качестве, и Вы хотели бы чтобы именно они попали на Авито. Мы реализовали данную возможность, теперь в качестве источника изображений можно указывать ссылки (на примере выше, например ссылки на свой сайт).
Настройка:
- Создать дополнительное поле
- В каждой карточке товара указать список ссылок на изображения
Создаем дополнительное поле в товарах (Как создать дополнительное поле?):
- Тип поля: Текст
- Название поля: Ссылки на изображения для товара
В каждой карточке товара в МойСклад указываем список ссылок на изображения
Переходим в карточку товара, и в данное поле вставляем список ссылок на изображения, разделенный запятыми или переносом строки.
Далее необходимо внести изменения в существующий шаблон для выгрузки, для этого:
- Переходим в приложение Интеграция с Авито, нажимаем "Обновить данные" (Обязательно)
- Переходим в раздел Шаблоны, выбраем нужный шаблон
- В самом низу шаблона кликаем по "Шестеренке", откроется дополнительный блок
- В поле "Ссылки на изображения", выбираем из выпадающего списка доп.поле, которое в карточке товара содержит ссылки, мы его создали на предыдущем шаге.
- Сохраните шаблон
На этом настройка закончена, теперь изображения будут загружаться на Авито по ссылкам, которые размещены в карточке товаров в доп поле "Список ссылок на изображения авито"
¶ Изображения по ссылкам для модификаций товаров
В МойСклад нет возможности для создания дополнительных полей в модификацииях товаров, поэтому возникает такая ситуация, что если вы загружаете на Авито изображения по ссылкам, то все модификации головного товара получают одинаковые изображения, так как у модификаций нет своих доп полей, в которые можно было бы вставить ссылки на изображения для данной модификации.
Мы решили данный вопрос путем добавления своего виджета в модификации, в который можно вставить ссылки на изображения в каждой модификации, и именно они будут выгружаться а не изобраражения по ссылкам из головного товара.
Для настройки выгрузки изображений модификаций по ссылкам необходимо выполнить несколько дополнительных настроек:
- Перейдите в модификации м заполните поле в модификациях ссылками на изображения.
Ссылки могут быть разделены запятой или переносом строки
-
В инструкции по выгрузке изображений по ссылкам, мы создали доп поле для ссылок и назвали его Ссылки на изображения для товара, в данном примере будем использовать его.
-
Отредактируйте шаблон (или шаблоны). В поле Ссылки на изображения вставьте следующую конструкцию (Выберите поля из выпадающего списка):
{[$Ссылки на изображения$]|[$Ссылки на изображения для товара$]}
- Сохраните шаблон
Данная конструкция означает, что если у товара нет модификаций, то будут выгружены изображения по ссылкам из доп поля Список ссылок на изображения Авито, если у товара есть модификации, то изображения будут выгружены из доп поля в каждой модификации Ссылки на изображения.
¶ Порядок выгрузки изображений
Если не производить никаких настроек, то приложение выгружает все катринки из каждой карточки товара из МойСклад или все картинки из дополнительно поля по ссылкам, но бывает такая необходимость выгружать не все изображения, а только определенные. (Например только второе изображение, или второе и третье)
В приложении предусмотренно два варианта реализации данного кейса:
Вариант №1
Для настройки данного функционала, необходимо в товарах создать дополнительное поле:
- Тип поля: Строка
- Название поля: Изображения для авито
ВНИМАНИЕ! Тип поля и название поля должны полностью соответствовать указанному выше шаблону, включая регистр, в противном случае функционал работать не будет
После того как Вы создали поле, в каждой карточке товара необходимо выбрать какое изображение Вы хотите выгружать на Авито (Можно в МойСклад массово заполнить данное поле)
Для определения изображения необходимо использовать его порядковый номер, например у товара есть 3 изображения, соответственно номера у них будут 1,2,3
Мы разработали несколько примеров заполнения данного поля:
- Если в поле ввести цифру 1 - то в выгрузку попадет только первое изображение из карточки товара
- Если в поле ввести цифры 1-3 - то в выгрузку попадут только с первого по третье изображение из карточки товара
- Если в поле ввести 2-* - то в выгрузку попадут изображения со второго и до последнего из карточки товара
- Также можно перечислять изображения через запятую, например 1,3,7,9
ВНИМАНИЕ! Комбинировать способы порядка изображений нельзя, работать не будет
Пример (Так работать не будет) 1-3,5,7 или 1,2,3-*
Вариант №2
Если у вас есть потребность, сортировать изображения для некоторых групп по разному, то можно сортировку прописать в шаблоне, по которому выгружается товар из группы.
В шаблоне предусмотренно поле Изображения для авито
В него можно вписать правила для сортировки и выгрузки изображений, как в Варианте №1.
Эти правила будут действовать на группу или группы товаров, которые выгружаются по данному шаблону. В таком случае не нужно в карточке товара создавать дополнительное поле.
¶ Фото магазина
В приложении есть возможность добавить фото магазина к каждому товару. Для этого необходимо выполнить:
- Создайте новый товар на складе
- Назовите товар фото_магазина
Обратите внимание, название товара должно быть именно таким как указанно выше, в противном случае работать не будет - Загрузите изображения вашего магазина в данный товар
Теперь, при каждой выгрузке, помимо изображений самого товара, в конец списка будут добавлены изображение вашего магазина, которые будут браться из карточки товара фото_магазина
¶ Ссылка на объявление в карточке товара в МойСклад
В приложении реализован функционал, с помощью которого можно получить ссылку на объявление с Авито в карточку товара в МойСклад.
Примечание Данный функционал доступен только на тарифе РАСШИРЕННЫЙ. Подробное описание тарифов тут https://unitxml.ru
- Необходимо создать дополнительное поле в карточке товара в МойСклад.
Тип: Текст, название: Ссылка на Авито - Подключить аккаунт Авито в приложении (если еще не подключен)
- В настройках аккаунта Авито выбрать созданное поле, как показано на изображении и Сохранить настройки
Ссылки на объявления Авито обновляются один раз в сутки, с 00-00 до 00-20 по МСК.
¶ Логические выражения
В приложении есть возможность использовать логические выражения в полях шаблонов для выгрузки.
Рассмотрим наглядный пример, на примере нескольких цен.
Бывает такая ситуация, когда необходимо указать несколько цен на товар, например:
В карточке товара есть Цена продажи и Цена по акции, задача состоит в том, чтобы если указана Цена по акции, то именно она попадала в выгрузку, а если не указана, то попадала Цена продажи или любая другая которую Вы укажите.
Реализуется это следующим образом:
Для примера у нас будет две цены
- Цена продажи
- Цена по акции
Переходим в нужный шаблон, и в поле Цена вставляем строку по такому шаблону
{[!Цена по акции!] | [!Цена продажи!]}
ВНИМАНИЕ! Вам будет необходимо выбрать из списка свои цены, данные цены указаны для примера.
Таким же способом можно поступать и с доп полями, проверять, если заполнено Доп.поле 1, то подставить его значение, если не заполнено, то значение из Доп.поля 2
{[$Доп.поле 1$] | [$Доп.поле 2$]}
¶ Расчет цены комплекта
При выгрузке комплектов, в приложении реализован функционал расчета цены комплекта.
Как это работает. Приложение при выгрузке проверяет цену у всех комплектующих входящих в состав комплекта, затем суммирует полученные цены, таким образом упрощается работа с комплектами по актуализации цены на комплект.
Перейдем к настройке:
-
На главной странице приложения необходимо активировать опцию Рассчитывать цену комплекта
-
Из выпадающего списка выбрать нужную вам цену для комплектующих (данная цена будет суммироваться при расчете цены комплекта)
Также предусмотренна дополнительная возможность, отключать расчет стоимости комплекта, если в карточке комплекта цена указана.
Для этого необходимо активировать опцию Не рассчитывать, если цена заполнена
Пример:
Если заполнена Цена продажи, то в Цену комплекта проставится Цена продажи
-
Сохранить настройки
-
Переходим в нужный шаблон и в поле Цена, из выпадающего списка выбираем Цена комплекта
-
Для обновления данных в XML файле выгрузки, необходимо на главной странице приложения нажать Выгрузить сейчас и дождаться окончания выгрузки.
Таким образом Цена на комплект, будет обновляться автоматически исходя из цен на комплектующие данного комплекта.
Для примера:
Комплект из двух комплектующих
В выгрузку попала цена за комплект, то есть Цена Бампер (Передний) + Цена Бампер (Задний)
Примечание
Если у Вас в группе товаров помимо комплектов есть и просто товары для выгрузки, то в поле цена необходимо указать логическое значение.
Пример:
{[!Цена комплекта!]|[!Цена продажи!]}
Вместо Цена продажи, впишите название своей цены из карточки товара, по которой должен продаваться товар.
¶ Операторы сравнения
В приложении реализована возможность использования операторов сравнения:
- "<"- Больше
- ">" - Меньше
- "==" - Равно
Это может быть полезно в решении разных задач. Рассмотрим на примере одну из них.
Задача:
Необходимо сообщить пользователям об остатке товара на складе, но не конкретное значение, а значения "Много", "Мало".
В зависимости от остатка на складе, выводить в поле Описание, значения, например, "Остаток товара на складе: Много"
Для реализации данного примера, потребуется в поле Остаток внести следующую запись
Остаток товара на складе: {[!Остаток на складе!]>5?Много:Мало}
Разберем подробнее данную строку.
Если остаток товара на складе БОЛЬШЕ 5 шт., то подставится значение Много, если меньше 5шт., то подставится значение Мало.
Таким образом, первая часть выражения - это сравниваемое значение, затем оператор сравнения ">", затем значение, с которым сравнить, и далее два варианта, которые будут использоваться в зависимости от результата сравнения.
¶ Математические операции в шаблонах
Данный функционал доступен только в тарифе "Расширенный"
В приложении доступно использование математических операций в шаблонах.
Это может быть полезно, когла вам необходимо для Авито передать свю цену, на основании существующей цены в МойСклад.
Пример:
У вас есть цена в МойСклад, называется она "Цена розница".
Вы хотите на Авито передавать, например - Цена розница + 20% (Процент от цены)
Или Цена розница + 50 (Статичное значение)
Для матаематических операций доступны следующие операторы:
- + (Сложение)
- - (Вычитание)
- * (Умножение)
- \ (Деление)
Настройка:
- Необходимо включить возможность использования математических операторов в шаблонах
- Отредактировать поле Цена в шаблонах.
Для того, чтобы к цене прибавить статичное значение, например 50, необходимо в поле Цена ввести следующую запись:
В нашем примере цена в МойСклад называется Цена розница, у вас, соответственно будет другое название цены
(m*[!Цена розница!]+50*m)
Для того, чтобы к цене прибавить процент от цены, например 20%, необходимо в поле Цена ввести следующую запись:
В нашем примере цена в МойСклад называется Цена розница, у вас, соответственно будет другое название цены
(m*[!Цена розница!]*120/100*m)
- Перейти на Главную страницу приложения, и нажать Выгрузить сейчас для обновления данных в XML файле
Таким образом можно быстро менять цены на Авито
¶ Словари (Замена значений в выгрузке)
Данный функционал доступен только в тарифе "Расширенный"
Словари - с помощью данного функционала возможно заменять значения в выгрузке.
Разберем на примере работу со словарями.
Для примера возьмем категорию товаров Мужская одежда - Кофты и футболки.
Допустим у вас есть товар Майка 1, и у данного товара есть модификции по размеру.
В качестве характеристики модификаций используются размеры в формате S, L, XS, XL, XXL и т.д.
Авито, для категории Мужская одежда - Кофты и футболки требует указания размера в формате 40 (XXS), 42 (XS), 46 (S) и т.д. Соответственно, если вы, при настройке шаблонов в поле размер подставите характеристику модификации, то авито выдаст ошибку по таким объявлениям и объявления опубликованы не будут.
Есть два решения данной проблемы:
- Переделать все модификации товаров в МойСклад, и привести их к виду, который требуется для Авито.
- Использовать функционал Словари, для замены значений в выгрузке.
Если простыми словами, нам необходимо создать пару Ключ - Значение, то есть, на нашем примере, нам необходимо сказать приложению, когда ты найдешь XS в поле Размер, замени его на значение 42 (XS).
Настройка:
- Переходим в раздел Словари, в главном меню приложения
Нажимаем Добавить, для создания нового словаря.
Название может быть произвольным, в нашем примере назовем его Размеры для Авито.
2. Далее создаем пары Ключ - Значение.
- Ключ - это что нужно заменить
- Значение - на что нужно заменить
В нашем примере, 42 будет заменено на 42 (XS), 46 на 46 (S)
Заполните все значения, которые вы используете в модификациях (все размеры)
- Настройка шаблонов.
В шаблоне, в поле Размер (в нашем примере) необходимо использовать характеристику модификации товара Размер, но обернуть ее в специальные теги, которые позволят использовать механизм замены значений из словарей.
Для нашего примера поле Размер будет выглядеть следующим образом:
Для поля Размер, мы будем использовать характеристику модификации Размер, и подменять ее значение из словаря
Разберем подробнее синтаксис для использования словарей, который написан в поле (для нашего примера):
- Сохранить шаблон
- На главной странице нажать Выгрузить сейчас, для того, чтобы данные обновились в XML файле выгрузки.
На том настройка закончена, в выгрузку, в поле Размер, попадут замененные значения из словара Размеры для Авито.
¶ Связать товар с объявлением
В приложении есть возможность связать ранее созданное объявление на Авито в ручном режиме с товаром в МойСклад.
ПРИМЕЧАНИЕ: Данный способ вам подойдет, если вы настраиваете полную интеграцию с Автозагрузкой
Для связи объявления и товара в МойСклад, выполните следующие действия:
- Создайте дополнительное поле в МойСклад, тип Строка, название Номер на Авито (может быть произвольным)
- В каждой карточке товара, которую необходимо связать с объявлением, ранее созданным на авито в ручном режиме, в доп поле Номер на Авито укажите Номер объявления с Авито.
- В настройках интеграции, в приложении, нажмите Обновить данные
- В шаблонах. в поле Номер объявления на Авито, из выпадающего списка выберите Номер на Авито.
- Сохраните шаблоны
- Нажмите Выгрузить сейчас.
ВНИМАНИЕ! Не вставляете в данное поле никаких значений, кроме Номера объявления с авито, и то. только в том случае. если Вам необходимо связать созданное ранее объявление (в ручном режиме) и товар в МойСклад.
¶ Дублирование объявлений
ВНИМАНИЕ! Данная настройка затронет работу с Идентификаторами объявлений, неправильная настройка может привести к тому, что текущие объявления уйдут в архив, либо создадутся лишние дубли. Перед тем как приступить к настройке, внимательно изучите данную инструкцию. Если у Вас останутся вопросы, или Вы не уверены что самостоятельно сможете выполнить данную настройку, пожалуйста, обратитесь в нашу службу технической поддержки, мы окажем консультацию и поможем с настройкой.
В некоторых ситуациях возникает необходимость дублирования объявления. Например, Вы ведете бизнес в разных регионах, и Вам необходимо указать свой адрес и телефон для каждого региона.
Для примера, разберем такой кейс:
Товар: Фара для Honda CR-v
Регионы продаж, адреса и телефоны: Москва, пр.Ленина 1 (84950000000), Санкт-Петербург, ул. Пушкина 22 (88120000000), Тюмень, ул. Кирова 35 (834520000000)
Реализация:
- Создать шаблон (или отредактировать существующий)
- Заполнить поля в шаблоне Идентификатор объявления, Полный адрес объекта, Контактный телефон особым образом
- Включить опцию разрешающую дублирование объявлений
- Произвести выгрузку
Переходим на вкладку Шаблоны и заполняем соответствующие поля:
Поле Полный адрес объекта необходимо заполнить, в нашем примере, следующим образом:
[*Москва, пр.Ленина 1 ||| Санкт-Петербург, ул. Пушкина 22 ||| Тюмень, ул. Кирова 35*]
Поле Контактный телефон необходимо заполнить, в нашем примере, следующим образом:
[*84950000000 ||| 88120000000 ||| 834520000000*]
То есть, мы указали все нужные адреса и телефоны в полях в квадратных скобках и через разделитель в виде |||
Следующий шаг - это заполнение поля Идентификатор объявления
Данное поле необходимо заполнить по томуже примеру что и предыдущие два, за тем лишь исключением, что вам самостоятельно нужно придумать префикс для идентификаторов объявлений в каждом из регионов.
Например, в нашем случае, мы определим следующие префиксы для каждого региона:
- Для Москвы - MSK
- Для Санкт-Петербурга - SPB
- Для Тюмени - TMN
Префиксы могут быть произвольными, мы выбрали данные префиксы в нашем примере для наглядности.
Теперь впишем их в поле Идентификатор объявления:
[!ID!][* ||| SPB ||| TMN*] - Префикс MSK пропущен в данной строке не случайно.
ВНИМАНИЕ! Обратите внимание, что в начале строки, мы вписали переменную [!ID!] - это является обязательным условием. Если у Вас поле Идентификатор объявления в шаблоне было уже заполнено каким-либо значением. например Вы использовали Артикул в качестве идентификатора, то вместо [!ID!] Вам необходимо вписать Артикул, итоговая строка получится такой:
[!Артикул!][* ||| SPB ||| TMN*]
Следующий шаг - это включение опции разрешающей дублирование объявлений.
Для этого необходимо в интерфейсе приложения включить данную опцию и сохранить изменения.
Настройка завершена. Теперь необходимо выполнить принудительную выгрузку товаров из МС в XML.
Для этого нажмите кнопку Выгрузить сейчас на главной странице приложения.
¶ Остатки
В приложении Интеграция с Авито предусмотрено несколько способов передачи остатка (количество шт.) товара из МозСклад на Авито.
¶ Передача через XML фид
В данном разделе рассмотрим настройку передачи остатка товара (количество шт.) через отдельный XML фид.
Данный способ передачи остатка вам подойдет, если у вас настроена Полная автозагрузка товаров из МойСклад на Авито через XML фид.
На данном этапе у вас уже должна быть выполнена минимум базовая настройка интеграции, включая выбор скадов и настройка фильтров, которая описана в соответствующем разделе по базовой настройке интеграции.
- Перейдите в раздел Шаблоны в приложении
- Выберите шаблон
- В поле Остаток, из выпадающего списка выберите стандартное значение (если оно еще не выбрано)
- Проделайте данное действие со всеми вашими шаблонами (если их несколько)
- Сохраните изменения в шаблоне
- Перейдите в раздел XML файлы, выберите нужный XML файл (если их несколько), в нашем примере он один, выберем его. Будет доступно две ссылки:
- Ссылка на XML файл с товарами
- Ссылка на XML файл с остатками
Скопируйте ссылку на XML файл с остатками
-
Перейдите в ваш личный кабинет Авито, в раздел Управление остатками
-
Выберите Автоматисеский, и вставьте в поле скопированную из приложения, на предыдущем шаге, ссылку
- Нжмите Загрузить остатки
На этом настройка передачи остатков через отдельный XML фид закончена.
XML фид с остатками будет обновляться в приложении при каждой выгрузке по расписанию
ПРИМЕЧАНИЕ: Ссылки на файл с товарами и на файл с остатками неизменны, то есть, они не меняются после каждой выгрузки, их достаточно один раз прописать на Авито.
¶ Передача через API
В данном разделе рассмотрим передачу изменения остатка товара из МойСклад на Авито.
ПРИМЕЧАНИЕ: Данная настройка передачи изменения остатка подходит если у вас настроена полная автозагрузка. Если вам не настраивали процесс полной автозагрузки, и хотите обновлять на Авито только цену и остаток, то вам необходимо выполнить инструкции из соответствующего раздела.
ПРИМЕЧАНИЕ: Данный способ срабатывает именно при изменении остатка товара на складе, например при Оприходовании товара или при проведении продажи, то есть при всех событиях, когда меняется остаток. Если вам изначально необходимо загрузить текущие остатки товаров на Авито, то вы можете воспользоваться способом передачи через отдельный XML файд. После этого, можно уже подключать и настраивать данный способ обновления остатков через API.
На данном этапе у вас уже должна быть выполнена минимум базовая настройка интеграции, включая выбор скадов и настройка фильтров, которая описана в соответствующем разделе по базовой настройке интеграции.
Обратите внимание, для обновления остатков, у вас должна быть включена Ускоренная проверка остатков
Также, необходимо подключить аккаунт Авито по инструкции, если он еще не подключен.
Последним этапом, необходимо активировать опцию Передавать изменение остатков по API
Сохраните изменения, нажмите Сохранить
На этом настройка передачи изменения остатков из МойСклад в Авито закончена. Теперь при изменении остатка товара в МойСклад, остаток изменится на Авито. (5-15 минут)
¶ Справочная информация
¶ Как подключить аккаунт Авито в приложении
В приложении, в зависимости от тарифа, можно подключать от 1 до 50 аккаунтов Авитов зависимости от вашего тарифа в приложении.
Подключение аккаунта Авито через API необходимо, если вы зотите использовать таки функции как:
- Мессенджер
- Получать заказы с Авито в МойСклад
- Обновлять остатки и цены на авито, при изменении их в МойСклад.
Для подключения аккаунта Авито, перейдите в раздел Авито в главном меню приложения
- Перейдите в раздел Авито
- Нажмите Добавить, чтобы добавить новый аккаунт
- Кликните по иконке вопрос, вас перенаправит в личный кабинет Авито, на страницу получения ключей
- Скопируйте с Авито и вставьте в поле ClientId
- Скопируйте с Авито и вставьте в поле ClientSecret
- Выберите XML файл, который хотите связать с данным аккаунтом (По умолчанию он один, main)
¶ Доп.поля в карточке товара МойСклад
В МойСклад доступен функционал использования дополнительных полей в карточке товара.
Дополнительные поля отличаются по типу, в МойСклад существуют следующие типы дополнительных полей в карточке товара:
- Строка (Данный тип поля позволяет хранить строковое значение до 250 символов)
- Число целое (Данный тип поля позволяет хранить целое число)
- Дата (Данный тип поля позволяет хранить дату)
- Справочник (Данный тип поля позволяет использовать справочник, который у вас есть в МойСклад)
- Файл (Данный тип поля позволяет хранить файл)
- Число дробное (Данный тип поля позволяет хранить дробное число)
- Флажок (Данный тип поля хранит значение флажка, два положения, отмечен и отметка снята)
- Текст (Данный тип поля позволяет хранить строковое значение не ограниченное по числу символов)
- Ссылка (Данный тип поля позволяет хранить ссылку)
В зависимости от ваших задач, можно создать до 100 дополнительных полей (ограничение МойСклад)
Для создания дополнительного поля, необходимо перейти в главном меню МойСклад в раздел Товары->Товары и услуги и нажать на шестеренку в панели инструментов
Справа откроется панель с настройками, в самом низу данной панели необходимо нажать +Поле
- Выбрать тип поля
- Написать наименование для поля
- Написать комментарий, комментарий не обязателен, он может пригодиться если у вас много полей, чтобы понимать для чего данное поле предназначено
Также, можно указать, является ли данное доп поле обязательным для заполнения в карточке товара.
После добавления доп полей, не забудьте нажать Сохранить.
¶ Создание цены в МойСклад
Для создания новой цены перейдите в МойСклад в раздел товары
Создайте новые цены для всех своих файлов XML, в нашем примере создадим две новые цены
Перейдите в карточку товара и присвойте значения новым полям с ценой, а также не забудьте присвоить значение полю с ценой для основного файла, в нашем примере это Цена продажи (Напоминаем, что в независимости от того сколько XML файлов Вы создадите, все равно будет создаваться один общий XML файл, который будет содержать данные о всех товарах, Вы можете его не использовать для загрузки на Авито, но он все равно будет создан и доступен в интерфейсе приложения. Более подробно про создание нескольких XML файлов можно почитать тут)
Далее необходимо перейти в Шаблоны, в выпадающем списке появится новая переменная, ЦЕНА ДЛЯ ФАЙЛА, вставьте эту переменную в каждый шаблон в поле с ценой
Не забудьте сохранить шаблоны.
На этом настройка цен для каждого XML файла закончена.
¶ Поля идентификации в шаблоне
В шаблоне имеются два поля, которые отвечают за идентификацию и уникальность объявления
Поле №1: Идентификатор объявления (Id)
Данное поле отвечает за идентификацию объявления на стороне Авито именно в автозагрузке.
У каждого объявления должен быть уникальный идентификатор, это позволяет обновлять объявления при следующих выгрузках.
ВНИМАНИЕ! Не заполняйте данное поле без особой на то необходимости, оставьте его пустым, приложения автоматически заполнит его уникальным значением, чтобы избежать дублирования идентификаторов и создания дублей объявлений.
Поле №2: Номер объявления на Авито (AvitoId)
Данное поле предназначено для связи ранее созданного в ручном режиме объявления на авито и объявления из автозагрузки.
Если вы создали ранее на авито объявления в ручную, то у него есть Номер, данный Номер имеет тип Целое число и выглядит следующим образом, пример: 245654846546.
¶ Рецепты
В данном разделе описаны некоторые дополнительные возможности, которые можно реализовать с помощью приложения, данные рецепты основаны на пользовательским опыте и не являются 100% рабочим решением для всех.
Обращаем Ваше внимание, данные рецепты основаны на пользовательским опыте и не являются 100% рабочим решением для всех. Все зависит от вашей текущей конфигурации приложения и параметров выгрузки. Перед применение рецептов из данного раздела, проконсультируйтесь с тех.поддержкой приложения.
¶ Сменить идентификаторы у объявлений
Обращаем Ваше внимание, если у вас настроено дублирование объявлений, или в качестве идентификатора используется не страндартное значение, то рекомендуем сначала проконсультироваться с нашей тех поддержкой, так как данный способ напрямую вам не подойдет. Необходимо будет внести коррективы, которые будут соответствовать вашему кейсу.
Бывает такая необходимость, сменить идентификатор у одного объявления или сразу у всех объявлений.
Такая необходимость может возникнуть, когда, например, вы выполнили настройку интеграции, прошла синхронизация с Авито, а затем Вы, в личном кабинете Авито удалили вручную объявления. После этого Авито потребует сменить идентификатор у объявления, или объявлений, которые были удалены.
Сделать это можно с помощью создания дополнительного поля и внесения в него части нового идентификатора.
К примеру, у нас есть товар, с такой ошибкой в отчете по автозагрузке в Авито:
При такой ошибке, исправить ситуацию можно следующим образом:
- Создать дополнительное поле в МойСклад, Тип строка, Название (Пример): Префикс для нового идентификатора Авито
- Перейти в карточку товара, для которого необходимо сменить идентификатор. Если идентификатор необходимо сменить у всех объявлений, то в МойСклад, можно через Массовое изменение внести изменение в данное поле. В нашем примере мы будем рассматривать на примере одного товара.
- Необходимо заполнить созданное доп поле каким нибудь префиксом, в нашем примере, мы будем использовать в качестве префикса значение - new
- После того, как вы проставите префикс new для каждого товара, которому необходимо сменить идентификатор, необходимо перейти в приложение и нажать Обновить данные, чтобы приложение перечитало информацию о созданном новом дополнительном поле.
- Далее переходим в Шаблоны, и в каждом шаблоне, поле Идентификатор объявления приводим к такому виду:
То есть, из выпадающих списков, сначала необходимо выбрать ID затем созданное ранее дополнительное поле.
- Сохраните настройки шаблона.
- Повторите пункт 5 для всех шаблонов, которые используются для выгрузки товаров, которым необходимо сменить идентификатор.
- В приложении, на главной странице, нажмите Выгрузить сейчас для того, чтобы приложение обновило данные в файле выгрузки.
Таким образом, приложение, в качестве идентификатора, будет по-прежнему использовать идентификатор товара из МойСклад и префикс, который вы впишете в дополнительное поле, для Авито это будет новый идентификатор.
После выгрузки, идентификатор из нашего примера будет с префиксом new:
¶ Сменить идентификаторы у объявлений для отдельного XML файла
Представим ситуацию, у вас есть два аккаунта Авито, соответственно 2 XML файла выгрузки (Аккаунт1 и Аккаунт2), на Аккаунт1, по какой-то причине, заблокировало объявление, а на Аккаунт2 оно продолжает работать. На первом аккаунте, для того, чтобы активировалось приложение, необходимо сменить идентификатор, при этом на втором аккаунте он должен оставаться неизменным.
- Создаем доп поле в карточке товара
- Тип Строка
- Наименование (для примера) Префикс идентификатора для аккаунта 1
- В карточке нужного товара заполните данное поле любым значением, для примера (значение может быть любым, состоящим из букв и цифр, кторме спецсимволов) NewPrefixAccount1
- В приложении, в разделе XML файлы, создайте доп поле, назовем его (для примера) Префикс.
Вставим в данное поле переменную, которая содержит название созданного в карточке товара доп поля и переменную содержащую идентификатор
Должна получиться строка (Обратите внимание, пробелов по краям нет, также, нет пробелов между элементами ID и Доп полем.):
[!ID!][$Префикс идентификатора для аккаунта 1$]
- Далее необходимо отредактировать шаблоны.
В нужных шаблонах, в поле Идентификатор объявления, вставьте переменную созданного доп поля в разделе XML файлы
Логика данного способы следующая:
- Приложение проверит, заполнено ли поле Префикс для XML файла, если заполнено, то проверит значение, в нашем примере, в качествезначения, мы указали переменные, переменную ID, которая содержит идентификатор товара, и переменную доп поля из карточки товара, приложение объединит эти два значения, и получится новый идентификатор.
- Если поле префикс для XML файла не заполнено, то приложение подставит стандартный идентификатор для объявления.
Пример выгрузки для Аккаунта №1 (там, где должен смениться идентификатор)
Пример выгрузки для Аккаунта №2 (там, где идентификатор должен остаться стандартный без изменений)
¶ Отключить Авито доставку для некоторых товаров
Если есть необходимость отключить Авито доставку для некоторых товаров, то это можно сделать использую дополнительное поле в МойСклад, и логическое выражение.
- В МойСклад необходимо создать дополнительное поле, тип Строка, Название Авито достака
- Далее необходимо в данное поле в карточках товаров вписать значение Выключена, для тех товаров для которых Авито доставка должна быть отключена
- Необходимо перейти в приложение, и нажать Обновить данные
- Перейти в раздел Шаблоны, и в шаблонах, в поле Доставка, изменить значение. Например у Вас было значение, с возможными способами доставки: ПВЗ,Курьер,Постамат. Необходимо привести запись в данном поле к такому виду:
{[$Авито доставка$]|ПВЗ,Курьер,Постамат}
Эта запись будет означать, что если отмечено в карточке товара заполнено данное поле, то подставится его значение, если не заполнено, то подставится ПВЗ,Курьер,Постамат (это пример, у вас будут свои способы доставки)
¶ Общий текст для дополнительного описания товаров
Рассмотрим такую ситуацию, что необходимо в каждом объявлении, после описания товара, вставить общее описание для всех тоапров, это может быть информация о вашем магазине или информация о действующих акциях, или любая другая полезная информация, которую необходимо разместить в конце описания в каждом объявлении.
Реализовать это можно через поля в XML файлах, рассмотрим пример:
- Перейти в приложение, в раздел XML файлы
- Добавить новое поле. назовем его для примера Общее описание
- Заполните данное поле текстом, который вы хотите добавить к объявлениям
- Перейдите в приложении на Главную, нажмите Обновить данные. Дождитесь обновления
- В шаблоне теперь доступна новая переменная, в нашем случае это Общее описание. Можно ее использовать в поле Описание, как в примере:
- Сохраните шаблон
- В приложении, на Главной, нажмите Выгрузить сейчас
- Данные из поля Общее описание после окончания выгрузки, появятся в каждом объявлении
¶ Изображения товаров для нескольких аккаунтов Авито
Рассмотрим такую ситуацию, у вас есть несколько аккаунтов авито (магазинов), в приложении настроена выгрузка в несколько XML файлов, и вам необходимо для каждого аккаунта авито выгружать свои изображения. В данном примере будет рассмотрена ситуация, при которой изображения находятся не внури МоегоСклада, а на внешнем ресурсе, например на вашем сайте или на ЯндексДиске.
У нас имеется в примере 2 аккаунта авито, соответственно 2 XML файла.
Приступим к настройке:
- Создать в товарах два дополнительных поля
- Тип: Текст
- Наименование для первого доп поля: Список ссылок на изображения для Аккаунта_1
- Наименование для второго доп поля: Список ссылок на изображения для Аккаунта_2
- Заполните в каждой карточке товара, созданные доп поля ссылками на изображения, ссылки перечислить через зпятую
-
Пеходим в приложение, и обновим информацию о доп полях.
На главной странице приложения, необходимо нажать Обновить данные -
Создать доп поле в приложении, в разделе XML файлы
Назовем доп поле Изображения
- Перейдем в приложении в Шаблоны
В любом поле, из выпадающего списка выберем созданное на шаге 1 дополнительное поле, нам это нужно, чтобы получить переменную. Скопируем ее.
ВНИМАНИЕ! не сохраняйте шаблон, нам нужны были только переменные.
Переменные, в нашем примере, будут иметь следующее значение
[$Список ссылок на изображения для Аккаунта_1$][$Список ссылок на изображения для Аккаунта_2$]
- Переходим снова в приложение, в раздел XML файлы, и в поле Изображения, в каждом XML файле вставляем соответствующее значение
Сохраним изменения
- На главной странице приложения, необходимо нажать Обновить данные
- В каждом шаблоне, в поле Список ссылок на изображения авито, необходимо выбрать (в нашем случае)
[%Изображения%]
- Заключительный шаг, это перейти в приложение, и нажать Выгрузить сейчас, чтобы обновить информацию в XML файле. Таким образом. у нас для каждого XML файла, будут подставлены свои ссылки на изображения
Для Аккаунта 1
Для Аккаунта 2
¶ Описание товара для разных аккаунтов Авито
При ситуации, когда у вас несколько аккаунтов Авито (несколько XML файлов для выгрузки), может быть необходимость сделать разное описание товара для каждого аккаунта.
Реализовать данную задачу можно в несколько шагов.
Для примера. у нас два аккаунта Авито: Аккаунт1 и Аккаунт2, соответственно два XML файла.
- Создаем в карточке товара два дополнитеоьных поля
- Тип: Текст
- Наименование (для примера) Текст описания для Аккаунта1 и Текст описания для Аккаунта2
- Далее в каждой карточке товара необходимо заполнить данные поля нужным вам текстом
- Далее необходимо перейти в приложение, и на главной странице нажать Обновить данные, чтобы приложение обновило данные о новых доп полях
- Следующим шагом необходимо перейти в приложении в раздел XML файлы
В поле Описание, для каждого XML файла, выберем нужное поле с описанием
- Следующий шаг, в швблонах в поле Описание выбрать
[%ОПИСАНИЕ ДЛЯ ФАЙЛА%]
- После внесения изменений в шаблоны, необходимо обновить данные в выгрузке, для этого, на главной странице приложения нажмите Выгрузить сейчас
¶ Короткое видео для товаров
Авито поддерживает загрузку коротких видеороликов для объявлений, которые добавляются в качестве первого фото в карточке товара.
Поддержка коротких видео доступна не для всех категорий Авито.
Посмотреть, доступно ли это для вашей категории, можно в документации авито по автозагрузке. Выберите свою категорию, и в списке полей должно быть поле VideoFileUrl
Вот пример:
Если для вашей категории доступна загрузка коротких видео, то необходимо выполнить следующие действия:
- Подготовить видеролик / видеоролики.
- Выложить видео на хостинге или на Яндекс Диск
- Скопировать прямые ссылки на видео.
В документации подробнее описано какой формат видео и ссылок поддерживается. Ссылка на документацию - Создать в МойСклад дополнительное поле: тип Строка, название: Ссылка на короткое видео
- В карточках товаров в МойСклад, заполнить созданное доп поле, Вставить ссылку на видео для данного товара. (Для каждого товара необходимо заполнить данное поле.)
- Перейти в приложение. На главной странице нажать Выгрузить сейчас
- В приложении перейти в шаблоны. В поле VideoFileUrl, из выподающего списка (Под красной стрелкой) выбрать созданное на шаге №4 доп поле (В нашем примере доп поле будет называться Ссылка на короткое видео) Если у вас несколько шаблонов, необходимо это сделать в каждом. Не забывайте сохранять шаблоны после изменений.
- В приложении, на главной странице нажать Выгрузить сейчас, чтобы данные обновились в XML файле.
На этом настройка закончена. Видео должны появиться на авито после следующей синхронизации по расписанию.
¶ Выгрузка товара не зависимо от остатка
В данном разделе разберем следующий кейс:
У Вас включена опция проверки остатков в приложении и приложение выгружает только те товары, которые есть в наличии, но Вам необходимо какието позиции выгружать не зависимо от остатка на складе. Для этих целей в приложении предусмотрен функционал.
Для его настройки необходимо сделать следующее:
- В карточке товара создать доп поле с типом Флаг и названием Выгружать всегда (Данное поле должно называться именно так, в противном случае работать не будет)
- В нужных товарах отметить данное поле
На этом настройка завершена, отмеченные товары будут попадать в выгрузку не зависимо от остатка.