Уважаемые пользователи приложения, если у Вас на любом этапе по настройке приложения возникли сложности, пожалуйста, обращайтесь в службу нашей технической поддержки.
Создать обращение можно одним из способов:
- Создать тикет в службу поддержки (Ссылка)
- Отправить письмо в службу поддержки (адрес support@unitxml.ru)
- Вступить в группу в Телеграм и задать вопрос (Ссылка)
¶ Описание и возможности
Выгрузка в Авито (далее по тексту UnitXML) - это приложение для сервиса МойСклад, основной задачей которого является выгрузка товаров из МоегоСклада в XML файл, предназначенный для загрузки на Авито. XML файл, формируемый приложением UnitXML, полностью соответствует требованиям Авито, выдвигаемым к XML документу для массовой загрузки. Мы постарались продумать и учесть все нюансы и тонкости данного процесса.
UnitXML — гибкое приложение, с возможностью настройки выгрузки по шаблонам. Для каждой категории товаров на вашем складе можно создать собственный шаблон для выгрузки с настраиваемыми полями.
¶ Взаимодействие МойСклад - UnitXML - Авито
Сервис Авито выдвигает достаточно жесткие требования к автозагрузке товаров, посредством XML документа, поэтому необходимо ответственно отнестись к данному аспекту, иначе товары не будут загружены.
Ниже представлено изображение, на котором схематически описана схема взаимодействия между сервисами.
Рассмотрим данную схему подробнее.
Приложение UnitXML получает сведения о товарах на Вашем складе, описание, изображение, затем загружает изображения на файловый сервер UnitXML в автоматическом режиме, то есть Вам не нужно свои изображения отдельно загружить на какой-нибудь хостинг картинок, мы об этом уже позаботились. Из полученных данных о товарах приложение UnitXML формирует правильный XML файл, в котором содержится информация о товарах и ссылки на изображения. После формирования XML документа, Вам доступна постоянная ссылка на XML документ, по данной ссылке будет находиться обновленный XML файл, обновляться он будет в зависимости от расписания которое Вы сами настроите в приложении. Данную ссылку Вам необходимо ввести в личном кабинете Авито, далее Авито будет обращаться к нашему сервису, а сервис в свою очередь будем отдавать информацию о Ваших товарах, ценах и т.д.
Может быть для кого-то написано не очень понятно и сложно, но поверьте, весь этот сложный процесс настраивается очень легко и быстро.
¶ Кейс по базовой настройке интеграции МойСклад и Авито представлен на видео
¶ Настройка МойСклад
Перед настройкой приложения UnitXML необходимо произвести первоначальную настройку склада в сервисе МойСклад
¶ Настройка кастомного поля для интеграции
Для того, чтобы приложение UnitXML понимало какой товар необходимо выгружать на Авито, мы создадим в карточке товара кастомное поле, назовем его "Авито", на самом деле не принципиально как его называть, просто так удобнее для понимания. Логика работы данного поля будет такая: Тот товар, в карточке которого отмечено данное поле, будет попадать в выгрузку, соответственно если данное поле не отмечено в карточке товара, то данный товар в выгрузку попадать не будет.
В интерфейсе МойСклад, в разделе Товары и услуги, нажмите на шестеренку
Откроется поле с настройками. В разделе Дополнительные настройки создаем дополнительное поле
В настройка дополнительного поля необходимо указать следующие данные:
Сохраняем настройки и переходим в карточку любого товара, чтобы проверить что наше кастомное поле появилось
Отлично! Поле появилось.
Таким образом можно создавать дополнительные поля в сервисе МойСклад, после создания эти поля будут доступны для вставки в шаблоны для выгрузки на Авито, далее в инструкции мы рассмотрим данный процесс подробнее.
На этом первоначальная настройка МойСклад окончена.
¶ Настройка приложения
В данном разделе рассмотрим установку и первоначальную настройку приложения для выгрузки на Авито
¶ Установка приложения
Приложение устанавливается стандартным способом, без каких-либо особенностей.
Перейдите в маркетплейс МоегоСклада, и установите приложение Выгрузка в Авито
После установки откройте приложение из раздела Приложения, либо кликните Открыть
¶ Основной интерфейс приложения
На картинке выше представлен основной интерфейс приложения, разделенный на блоки:
- Основное меню (Навигация)
- Обновление
- Выгрузка
- Ссылка на XML файл
- Статус выгрузки
- Настройки интеграции
Рассмотрим каждый блок подробнее.
¶ Блок Основное меню (навигация)
Навигация по приложению, содержит ссылки на основные разделы
- Главная
- Шаблоны
- Группы товаров
- Склады
- XML файлы
- Авито
¶ Блок Обновление
Содержит информацию о текущем статусе выгрузки / обновления XML файла
- Блок Последнее обновление XML - дата и время последнего обновления/выгрузки XML файла
- Блок Следующее обновление XML - дата и время следующего обновления/выгрузки XML файла
- Блок Статус последнего обновления - статус последнего обновления, возможные варианты:
-- В процессе - задание по выгрузке выполняется в данный момент (выгрузка занимает от 1 до 20 минут, в зависимости от количества товаров на складе)
-- Успех - последняя выгрузка выполнена успешно
-- Ошибка - последняя выгрузка завершилась с ошибкой
Для того чтобы узнать причину либо код ошибки во время последней выгрузки, необходимо в разделе Статус выгрузки (самый нижний блок со списком) навести мышкой на Ошибка, отобразится ошибка, пример на картинке выше отобразилась ошибка "Не получилось достать данные из МойСклад"
Коды всех возможных ошибок, а также описание, доступны в разделе Возможные ошибки во время выгрузки
¶ Блок Выгрузка
Данный блок содержит информацию о том, какое количество товаров, категорий и складов выгружается на данный момент.
- Блок Количество товаров - количество товаров которые на данный момент выгружены в XML файл
- Блок Количество категорий - количество категорий связанных с шаблонами
- Блок Количество складов - количество выбранных складов для выгрузки в XML
¶ Блок Ссылка на файлы XML
Данный блок содержит ссылку на обновляемый XML файл с Вашими товарами, а также ссылку на журнал последней выгрузки, в данном журнале регистрируются ошибки, которые могут возникнуть во время выгрузки. Наприер. у товара отсутствует картинка, а для данной категории авито картинка является обязательной, поэтому данный товар не попадет в выгрузку, о чем будет сделана запись в журнале. Таким образом Вы оперативно узнаете, почему тот или иной товар не попали в выгрузку.
Также можно скачать свой XML файл с товарами или XML файл с остатками.
¶ Блок Статус выгрузки
В данном блоке отображается список с датой и статусом последних 10 обновлений/выгрузок XML файла, а также в случае возникновения ошибки, в данном блоке отобразится код или наименование ошибки
¶ Блок Настройка интеграции
Содержит базовые настройки интеграции МойСклад и Авито
-
Блок Поле отвечающее за интеграцию - дополнительно) поле, созданное в МойСклад, по данному полю, приложение определяет какой товар надо выгружать, а какой нет, то есть, если в карточке товара отмечено галочкой данное поле, то данный товар попадет в выгрузку.
Если оставить Поле отвечающее за интеграцию пустым, то есть, не выбирать ничего из списка, то в выгрузку попадут абсолютно все товары с выбранных складов или из каталога, в зависимости от настроек.
Кнопка Обновить данные - после нажатия на данную кнопку, произойдет обновление данных в приложении о дополнительных полях, категориях, ценах продаж из МоегоСклада. Каждый раз, когда Вы добавляете в МойСклад дополнительное поле, или новый тип цен, то необходимо нажать на данную кнопку. чтобы приложение выполнило обновление этих данных в своей базе. -
Блок с выбором Источника данных - В данном блоке доступен для выбора один из двух вариантов источников данных:
-- Каталог товаров
-- Склады
При выборе опции Выгружать товары из каталога - в качестве источника данных о товарах будет использоваться Ваш каталог в МойСклад, то есть, вся информация о товарах, будет подгружаться из него. Обратите внимание, при выборе данной опции, будет не доступен функционал работы с остатками, резервом и товаром в ожидании. Преимущество выгрузки товаров из каталога - это то, что его не надо предварительно приходовать на складе.
При выборе опции Выгружать товары со складов - в качестве источника данных будут использоваться склады, которые Вы выберите.
-
Блок Склады - данный блок содержит информацию о Ваших складах, а также настройку выгрузки товаров исходя из остатков. Отметьте те склады, товары с которых должны попадать в выгрузку.
-- Проверять остатки на складах - если включена данная опция, то приложение будет проверять остаток товара на складах, и если остаток будет равен 0, то данный товар не будет попадать в выгрузку
-- Вычитать из остатков резерв - если включена данная опция, то приложение будет вычитать из остатков товара зарезервированный товар, и если при этом будет положительный остаток, то товар попадет в выгрузку
-- Вычитать из остатков товары в ожидании - если включена данная опция, то приложение будет вычитать из остатков товара на всех выбранных складах товар в ожидании, и если при этом будет положительный остаток, то товар попадет в выгрузку -
Блок Периодичность
В данном блоке настраивается расписание выгрузки. Выгрузка/обновление файла, происходит один раз в сутки, в заданное Вами время. Время выгрузки можно менять не чаще 3 раз за 24 часа, в расчет берутся не календарные сутки, а именно 24 часа.
Также в данном блоке доступна опция Выгрузить сейчас, если нажать на данную кнопку, то произойдет попытка постановки в текущую очередь задания на обновление Вашего файла, и если на данный момент в системе не будут заняты все ресурсы, то Ваша выгрузка выполнится, о чем Вы получите уведомление в всплывающем окне. -
Выгрузка комплектов
Приложение поддерживает выгрузку комплектов из МойСклад на авито. Если включена опция Проверять остатки на складах, то приложение будет проверять остатки каждого компонента комплекта, если остаток любого компонента из комплекта меньше или равен нулю, то данный комплект выгружен не будет, таким образом можно контролировать выгрузку только тех комплектов, комплектующие к которым есть в наличии. Информация об этом будет отражена в журнале выгрузки. Если опция Проверять остатки на складах* не включена, то комплекты будут попадать в выгрузку вне зависимости от наличия комплектующих комплекта на складе.
Для того, чтобы комплект корректно выгрузился, необходимо в карточке товара каждого компонента сделать активным поле для интеграции (отметить флажок Авито), если по каким то причинам, например много комплектов и в них много комплектующих, вы не хотите в каждой карточке товара комплектующих устанавливать флажок, то необходимо включить опцию Игнорировать поле интеграции в комплектующих. -
Выгрузка модификаций Приложение поддерживает выгрузку модификаций товаров как отдельные товары, по умолчанию выгружаются все модификации товара. Если Вам необходимо изменить данное поведение, то есть, например выгружать модификации не у всех товаров, то создайте дополнительное поле:
-- Тип: Флажок
-- Название: Игнорировать модификации
Обратите внимание, тип и название поля должны быть строго как указано выше, в противном случае работать не будет
После создания поля, отметьте его в карточке товара, модификации которого НЕ должны выгружаться.
После этого в выгрузку удет попадать только головной товар.
Если Вы таким образом отключили выгрузку модификаций, и при этом включена опция Проверять остатки на складе, то приложение все равно будет смотреть остатки по всем модификациям, и если у какой-нибудь модификации есть положительный остаток, то головной товар попадет в выгрузку.
Остаток модификаций на складе суммируется.
Таким образом в приложении реализована гибкая настройка выгрузки модификаций.
¶ Настройка интеграции
¶ Настройка шаблонов для выгрузки
- На главной странице, в блоке Настройка интеграции выберите склады, товары с которых должны попадать в выгрузку, проверку остатков, поле для интеграции и время выгрузки (расписание), подробно о значении каждого блока написано в разделе Блок Настройка интеграции. Сохраните настройки.
- Перейдите в раздел Шаблоны (в основном меню)
Каждое поле в шаблоне, соответствует своему полю в документации по автозагрузке Авито. Каждое поле в документации Авито, помимо названия на русском, еще имеет тег на английском. Для того, чтобы посмотреть какому тегу из документации соответствует то или иное поле, необходимо навести на поле в шаблоне и во всплывающей подсказке отобразиться его тег. Пример на изображении ниже.
На данном этапе необходимо создать шаблон для выгрузки товаров из определенной категории МойСклад в определенную категорию Авито. Шаблонов можно создавать не ограниченное количество. Для удобства обычно создают один шаблон для одной категории товаров МойСклад.
В качестве примера, давайте представим что Вы продаете посуду и в МойСклад у Вас есть категория товаров "Посуда". Следовательно товары из данной категории нужно выгрузить на авито в соответствующий раздел, для этого сделайте следующее:
- Создайте шаблон
- Дайте название шаблону
- Выберите категорию на Авито (В нашем примере категория Для дома и дачи)
- Выберите подкатегорию на Авито (В нашем случае Посуда и товары для кухни)
- Поля отмеченные звездочкой являются обязательными для заполнения
- Из выпадающих списков можно выбирать значения которые будут подставляться из МойСклад, это как основные поля, например ЦЕНА, ОПИСАНИЕ и т.д, так и кастомные поля, которые Вы можете заранее создать в МойСклад. (Подробнее про создание кастомных полей тут). Также в выпадающих списках предусмотренны стандартные значения полей с Авито, например: НОВОЕ или ТОВАР ПРИОБРЕТЕН НА ПРОДАЖУ и т.д. В зависимости от выбранной категории Авито, список полей, а также обязательность их заполнения меняется, в соответствии с требованиями Авито. Например в некоторых категориях Авито не требует обязательное наличие изображения у товара, а в некоторых без изображения товар не пройдет проверку и не будет опубликован. (Примечание: Если Вы создали дополнительное поле, в шаблоне выбрали его для подстановки, например в ОПИСАНИЕ, но в карточке товара данное поле не заполнено, то данный товар в выгрузку не попадет, так как поле ОПИСАНИЕ является обязательным. Также данное примечание актуально для всех обязательных полей, картинки и т.д. )
- Сохраните шаблон
¶ Назначение полей идентификации в шаблоне
В шаблоне имеются два поля, которые отвечают за идентификацию и уникальность объявления
Поле №1: Идентификатор объявления (Id)
Данное поле отвечает за идентификацию объявления на стороне Авито именно в автозагрузке.
У каждого объявления должен быть уникальный идентификатор, это позволяет обновлять объявления при следующих выгрузках.
ВНИМАНИЕ! Не заполняйте данное поле без особой на то необходимости, оставьте его пустым, приложения автоматически заполнит его уникальным значением, чтобы избежать дублирования идентификаторов и создания дублей объявлений.
Поле №2: Номер объявления на Авито (AvitoId)
Данное поле предназначено для связи ранее созданного в ручном режиме объявления на авито и объявления из автозагрузки.
Если вы создали ранее на авито объявления в ручную, то у него есть Номер, данный Номер имеет тип Целое число и выглядит следующим образом, пример: 245654846546.
Для связи данного объявления и товара в МойСклад, выполните следующие действия:
- Создайте дополнительное поле в МойСклад, тип Строка, название Номер на Авито (может быть произвольным)
- В каждой карточке товара, которую необходимо связать с объявлением, ранее созданным на авито в ручном режиме, в доп поле Номер на Авито укажите Номер объявления с Авито.
- В настройках интеграции, в приложении, нажмите Обновить данные
- В шаблонах. в поле Номер объявления на Авито, из выпадающего списка выберите Номер на Авито.
- Сохраните шаблоны
- Нажмите Выгрузить сейчас.
ВНИМАНИЕ! Не вставляете в данное поле никаких значений, кроме Номера объявления с авито, и то. только в том случае. если Вам необходимо связать созданное ранее объявление (в ручном режиме) и товар в МойСклад.
¶ Передача остатков товара на Авито
Для того, чтобы поддерживать актуальными остатки товара на Авито, была реализована возможность передачи остатков согласно документации Авито через дополнительный XML файл (Ссылка на документацию Авито), а также через интерфейс API Авито.
¶ Способ №1. Передача остатков через отдельный XML файл.
Для работы данного функционала, в шаблонах добавлено поле Остаток.
По умолчанию данное поле заполнено значением {[!Остаток на складе!]|*}.
Данное значение является Логическим. и означает, что в выгрузке будут передан Остаток на складе (если он больше нуля, суммируется остаток со всех выбранных складов) ИЛИ значение что количество данного товара пополняется
Список всех допустимых значений:
- [!Остаток на складе!] (Или любое доп поле, содержащее актуальную информацию по остаткам товара)
- * (Звездочка) - Означает что товар постоянно пополняется
В приложении. при клике на иконку откроется список товаров, которые на данный момент попали в выгрузку
Как показано на скриншоте ниже, на данной странице будет 2 ссылки
- Ссылка на XML файл, содержащий информацию о товарах
- Ссылка на xml файл, содержащий информацию об остатках товаров
Ссылку на xml файл, содержащий информацию об остатках товаров, необходимо разместить в личном кабинете Авито, в раздел Управление остатками, о том как правильно разместить ссылку в ЛК Авито, смотрите в инструкции
¶ Способ №2. Передача остатков через интерфейс API Авито.
Данный способ передает актуальный остаток товара при изменении остатка в МойСклад.
То есть, если Вы меняете остаток какого-то товара в МойСклад, то на авито передается информация об этом сразу, в автоматическом режиме. Это позволяет поддерживать на авито остатки атуальными.
Для настройки данного способа. Вам потребуются ключи для интеграции, которые необходимо получить в личном кабинете Авито по ссылке https://www.avito.ru/professionals/api
Внимание!
Данный способ передачи остатков находится в стадии beta тестирования.
В связи с этим, на данный момент есть ряд ограничений по использованию данного способа передачи остатков. Ознакомьтесь с временными ограничениями использования.
Временные ограничения использования способа передачи остатков по API:
- Данный способ будет правильно работать только с включенной опцией "Использовать ускоренную проверку передачи остатков"
Остаток будет формироваться на основе выбранного фильтра:- Доступно
- Остаток за вычетом резерва
- Физический остаток
Настройте данные фильтры на главной странице приложения
- Уже должно быть настроена передача остатков на Авито с помощью отдельного XML файла
Инструкция по настройке https://wiki.unitxml.ru/avito/start#передача-остатков-товара-на-авито - Если вам необходимо передавать нулевое значение остатка для товаров, то не используйте данный способ, используйте пока доступный ранее способ передачи остатков через отдельный XML файл
- Если у вас, в шаблонах, в поле Идентификатор объявления, стоит не стандартное значение, то пока, не используйте данный способ, используйте доступный ранее способ передачи остатков через отдельный XML файл
Это может быть при следующих ситуациях:- В качестве Идентификатора объявления Вы используете Артикул товара или другое поле (Код, номер и т.д.)
- У вас настроено "Дублирование объявлений".
Для настройки данного способа передачи остатков, перейдите в раздел Авито, главного меню приложения
Заполните данные из вашего аккаунта Авито, а именно ClientID и ClientSecret
Из выпадающего списка, выберите XML, который предназначен для выгрузки на двнный аккаунт Авито.
Нажмите Сохранить.
Приложение проверит ключи для интеграции, если проверка пройдет успешно. то данные сохраняться и можно будет продолжить настройку, если возникнут ошибки, при проверке ключей, то появится сообщение. Проверьте ключи еще раз и попробуйте снова.
Далее необходимо включить опцию Передавать остатки по API.
¶ Выгрузка остатков при разделении на несколько XML файлов выгрузки
Представим такую ситуацию, что у вас 2 склада в двух разных регионах, Склад А и Склад Б.
Вы выполнили настройку, по разделению выгрузки на несколько XML файлов по складам, согласно инструкции
Стоит задача: в каждый XML файл с остатками, выгружать информацию об остатках только с выбранных склада, а не общий остаток по всем складам.
Для этого необходимо в шаблоне, в поле Остаток, выбрать значение из выпалающего списка
Если у вас в выпадающем списке, в разделе Поля файлов, отсутствует Остаток, то на главной странице приложения нажмите Обновить данные.
¶ Настройка групп товаров
После того, как Вы настроили шаблон или несколько шаблонов, их необходимо связать с категориями в МойСклад, то есть, "сказать" приложению, по какому шаблону нужно выгружать товары из той или иной категории.
Перейдите в раздел Группы товаров (в основном меню)
- Выберите из выпадающего списка слева категорию из МойСклад (В нашем случае "Посуда") (Примечание: Если в МойСклад у Вас есть категория например Посуда/Посуда для дачи и товары именно из нее должны попадить в выгрузку, создайте отдельный шаблон для данной категории и свяжите его именно с категорией Посуда/Посуда для дачи.)
- Выберите из выпадающего списка справа шаблон для выгрузки данной категории
- Сохраните изменения
Вы можете создавать не ограниченное количество связей групп товаров и шаблонов для выгрузки.
На этом настройка интеграции приложения закончена, все выбранные товары будут выгружены в XML файл стандарта Авито в заданное Вами время.
¶ Настройки на стороне Авито
После того как Вы настроили интеграцию с МойСклад, необходимо дождаться первой выгрузки, либо провести ее принудительно путем нажатия кнопки Выгрузить сейчас. Если выгрузка прошла успешно и не возникло никаких ошибок, то Вам необходимо:
- Скопировать ссылку на XML файл
- Проверить файл с выгрузкой на наличие ошибок
Для этого, перейдите по ссылке Проверка файла
Выберите пункт "По ссылке" и вставьте скопированную ссылку на XML файл в поле.
Дождитесь окончания проверки, если возникли ошибки во время проверки, по каждому товару будет сформирован отчет, исправьте возникшие ошибки, выполните выгрузку в приложении повторно, затем снова проверьте xml файл на наличие ошибок.
Если самостоятельно исправить ошибки не получается, обратитесь в нашу службу технической поддержки за консультацией.
Следующим шагом, необходимо выполнить настройки в Личном кабинете авито.
Перейдите в раздел Автозагрузка
Вставьте ссылку на XML файл из приложения и настройте расписание, по которому Авито будет читать информацию из файла выгрузки и публиковать объявления
По всем вопросам относительно настроек внутри сервиса Авито, пожалуйста, обращайтесь в поддержку Авито или к Вашему менеджеру.
¶ Дополнительные возможности
¶ Вывод дополнительных полей из МойСклад в шаблон
В данном разделе описан процесс, как вывести значения лополнительных полей из МойСклад в шаблон для выгрузки.
Это является удобным дополнением в случае когда необходимо выводить значение из доп поля для каждого товара. Например Бренд. Описание, размер и т.д.
Ниже будет приведен пример, как вывести дополнительное или свое описание из доп.поля МойСклад в шаблон для выгрузки.
¶ Описание товара из дополнительного поля
Представим ситуацию, что у Вас есть некий товар, у товара есть описание (стандартное поле в МойСклад), но в данное поле Вы записываете описание для внутреннего использования, или для интеграции с интернет магазином, а для Авито вы хотите чтоб с товаром выгружалось другое, отличное от основного описание. Такая возможность есть в приложении UnitXml.
Основной план действий:
- Создаем дополнительное поле в МойСклад
- Обновляем список дополнительных полей в приложении UnitXML
- В настройках шаблона, из выпадающего списка выбираем вновь созданное дополнительное поле
¶ ВАРИАНТ №1
- Создаем дополнительное поле в МойСклад
Подробная инструкция по созданию дополнительных полей есть в МойСклад, а также в начале данной инструкции, на примере создания дополнительного поля для интеграции.
Для примера создадим дополнительное поле Описание для авито
После того как поле создано в МойСклад, необходимо в приложении обновить данные (Список полей обновится в том числе)
Перейдите на главную страницу, нажмите Обновить данные
Теперь наше дополнительное поле доступно для выбора в настройках шаблонов
Нажмите на раскрывающийся список, и кликните по нужному полю, значение подставится в поле автоматически
¶ ВАРИАНТ №2
В первом варианте мы создали дополнительное поле Описание с типом строка, таким же образом можно создавать доп.поля с другим типом, например тип Справочник.
- Создать справочник в МойСклад
- Создать доп.поле в МойСклад, тип Справочник
- В приложении нажать Обновить данные
- В шаблоне, из выпадающего списка выбрать доп поле со справочником
Создать новый справочник в МойСклад (если у вас уже есть справочник, значения которого вы хотели бы использовать, то справочник создавать не нужно, пропустите этот шаг)
В нашем примере мы будем создавать справочник книг
Заполним значения полей справочника нужными данными
Таким образом у нас получился справочник с перечнем книг и описанием к каждой книге.
Переходим в Товары и услуги и создадим доп поле
Название произвольное, Тип Справочник, и выберем необходимый справочник, в нашем примере это справочник Книги
Переходим в карточку товара и выбираем значение из справочника, соответствующее товару. (Например если справочник с Брендами, то выбираем нужный бренд и т.д.)
В нашем примере справочник с названиями и описаниями книг
Переходим в приложение, обязательно нажимаем Обновить данные
Открываем шаблоны, и в выпадающем списке появились два новых пункта
- Справочник Книги
- Справочник Книги.Описание
Если мы выберем Справочник Книги, то в данное поле будет подставлено значение Наименование из справочника, в нашем примере Книга №1 или Книга №2
Если мы выберем значение Справочник Книги.Описание, то в данное поле будет подставлено Описание для значения справочника
Таким образом можно создавать неограниченное количество кастомных (Дополнительных) полей.
¶ Несколько XML файлов
Изначально все товары выгружаются в один единый XML файл, но бывают такие ситуации, когда необходимо разделить товары/категории товаров на несколько частей. Представим такую ситуацию, у Вас на Авито несколько аккаунтов и на разных аккаунтах свой товар и свой регион, это как пример, существует много ситуаций при которых выгрузка всех товаров в единый XML накладывает определенные ограничения, именно для того, чтобы исправить данную ситуацию и был создан механизм разделения на несколько файлов XML.
Условие:
- На данном этапе уже должна быть выполнена базовая настройка приложения согласно инструкции
¶ Разделить выгрузку на несколько XML файлов можно двумя способами:
- Разделение по номенклатуре товара. Товары будут выгружаться в разные XML файлы, для разных аккаунтов авито, в не зависимости от того, на каком складе они находятся, остатки по активным складам будут суммироваться, если в настройках, в качестве источника данных выбран Выгружать товары со складов.
- Разделение по складам. Товары с каждого склада, будут выгружаться в отделный XML файл. Остатки при этом тоже будут разделены по складам. Данный способ работает только при включенной опции Проверять остатки на складах.
Вариант №1. Разделение по номенклатуре товара
Проверьте, чтобы в настройках были выбраны все необходимые Вам склады:
Основной план действий:
- Создать в приложении два XML файла и заполнить их свойства
- В карточке товаров выбрать в какой XML файл выгружать товар
Создаем в приложении, в разделе XML файлы, еще два XML файла
Изначально в приложении уже есть один Основной файл. в который выгружаются все товары.
Создадим дополнительно два XML файла с выгрузкой
Название XML файла
- Не должно содержать пробелов и спецсимволов
- Только латинские буквы
Выбор складов
- Необходимо снять отметки со складов, так как данный выбор, в этом способе разделения, не нужен.
Цена
- Из выпадающего списка, выберите цену, которая будет использоваться для данного XML файла с выгрузкой. (Данное поле не обязательно для заполнения, если его не заполнить, то цена для товаров будет взята из настройки шаблонов)
Описание
- Из выпадающего списка, выберите доп поле, которое содержит описание товаров для данного XML файла с выгрузкой. (Данное поле не обязательно для заполнения, если его не заполнить, то описание для товаров будет взято из настройки шаблонов)
Телефон
- Введите номер телефона, который будет использоваться для данного XML файла. (Данное поле не обязательно для заполнения, если его не заполнить, то телефон будет взят из настройки шаблонов)
Адрес
- Введите адрес, который будет использоваться для данного XML файла. (Данное поле не обязательно для заполнения, если его не заполнить, то адрес будет взят из настройки шаблонов)
Вы можете создавать самостоятельно дополнительные поля, которые затем можно использовать в выгрузке.
Аналогичным способом создадим еще один файл для второго аккаунта
Сохраните изменения.
Переходим в карточку товара и отмечаем тот XML в который данный товар должен выгрузится. Также можно выделить несколько XML.
Обратите внимание, флаг Авито, должен быть отмечен во всех товарах, не зависимо в какой из XML файлов данный товар выгружается.
После очередной выгрузки, на главной странице, вместо ссылки на один единый XML файл, Вам будут доступны ссылки на все, созданные ранее XML файлы, и каждый из них будет содержать информацию о товарах, в которых он (XML файл) выбран. Самый первый в списке XML файл будет содержать информацию о всех товарах, которые выбраны для выгрузки, не важно в какой из файлов.
Вариант №2. Разделение по складам
Проверьте, чтобы в настройках были выбраны все необходимые Вам склады, а также была активированна опция Проверять остатки на складах:
Создаем в приложении, в разделе XML файлы, еще два XML файла
Изначально в приложении уже есть один Основной файл. в который выгружаются все товары.
Создадим дополнительно два XML файла с выгрузкой
Название XML файла
- Не должно содержать пробелов и спецсимволов
- Только латинские буквы
Выбор складов
- Необходимо выбрать склад или склады, товары с которых будут выгружаться в данный XML файл
Цена
- Из выпадающего списка, выберите цену, которая будет использоваться для данного XML файла с выгрузкой. (Данное поле не обязательно для заполнения, если его не заполнить, то цена для товаров будет взята из настройки шаблонов)
Описание
- Из выпадающего списка, выберите доп поле, которое содержит описание товаров для данного XML файла с выгрузкой. (Данное поле не обязательно для заполнения, если его не заполнить, то описание для товаров будет взято из настройки шаблонов)
Телефон
- Введите номер телефона, который будет использоваться для данного XML файла. (Данное поле не обязательно для заполнения, если его не заполнить, то телефон будет взят из настройки шаблонов)
Адрес
- Введите адрес, который будет использоваться для данного XML файла. (Данное поле не обязательно для заполнения, если его не заполнить, то адрес будет взят из настройки шаблонов)
Вы можете создавать самостоятельно дополнительные поля, которые затем можно использовать в выгрузке.
Аналогичным способом создадим еще один файл для второго аккаунта
Сохраните изменения.
При данном разделении на несколько XML файлов, для правильной передачи остатков на авито, необходимо в шаблонах выбрать поле файла Остаток
Таким образом, ссылка для обновления остатков для каждого аккаунта, будет содержать актуальную информацию.
После очередной выгрузки, на главной странице, вместо ссылки на один единый XML файл, Вам будут доступны ссылки на все, созданные ранее XML файлы, и каждый из них будет содержать информацию о товарах, которые в наличии на выбранных складах. Самый первый в списке XML файл будет содержать информацию о всех товарах, которые выбраны для выгрузки, не важно в какой из файлов.
¶ Как указать контактную информацию для каждого XML файла
При разделении выгрузки на несколько XML файлов, как правило возникает необходимость указать свои контакты (телефон, адрес) для каждого файла. Приведу пример: Допустим есть два аккаунта на авито, которые ведут торговлю в двух разных регионах. соответственно при выгрузке для каждого региона должны быть указаны свои контакты (телефон, адрес).
Перейдите в XML файлы из главного меню. В настройках каждого файла заполните поля Телефон и Адрес.
Вернитесь к настройкам шаблонов, и в полях Телефон и Полный адрес объекта, из выпадающих списков выберите соответствующие значения.
Таким образом, для каждого XML файла выгрузки на авито, будет подставлено свое значение из настроек файла.
¶ Как указать цену для каждого XML файла
Если Вам необходимо для каждого из созданых XML файлов указать свою цену, например у Вас два аккаунта Авито для разных регионов, и цена на товар должна быть разной, в зависимости от региона, то Вам необходимо по инструкции выше создать два файла XML. и произвести дополнительные настройки указанны ниже.
¶ Создание цены в МойСклад
Для создания новой цены перейдите в МойСклад в раздел товары
Создайте новые цены для всех своих файлов XML, в нашем примере создадим две новые цены
Перейдите в карточку товара и присвойте значения новым полям с ценой, а также не забудьте присвоить значение полю с ценой для основного файла, в нашем примере это Цена продажи (Напоминаем, что в независимости от того сколько XML файлов Вы создадите, все равно будет создаваться один общий XML файл, который будет содержать данные о всех товарах, Вы можете его не использовать для загрузки на Авито, но он все равно будет создан и доступен в интерфейсе приложения. Более подробно про создание нескольких XML файлов можно почитать тут)
Далее необходимо перейти в Шаблоны, в выпадающем списке появится новая переменная, ЦЕНА ДЛЯ ФАЙЛА, вставьте эту переменную в каждый шаблон в поле с ценой
Не забудьте сохранить шаблоны.
На этом настройка цен для каждого XML файла закончена.
¶ Как сделать описание для товара для каждого XML файла
Если Вам необходимо для каждого из созданых XML файлов указать свое описание для товара, например у Вас два аккаунта Авито, и описание должно быть разным, то Вам необходимо по инструкции выше создать два файла XML. и произвести дополнительные настройки указанные ниже.
Ниже в инструкции мы предполагаем что у Вас уже предварительно настроена выгрузка в два файла. В примере по настройке нескольких файлов мы использовали имена MSK и SPB.
Создайте в карточке товаров в МойСклад два дополнительных поля (именно два, так как у нас в примере разделение на два xml файла выгрузки)
В нашем примере мы назовем новые поля для описания так:
- Описание для МСК
- Описание для СПБ
Тип поля - Текст
В каждой карточке товара заполните данные поля нужным вам текстом
После добавления доп полей в МойСклад, не забудьте нажать Обновить данные в приложении.
Следующим шагом необходимо в настройках XML файлов, выбрать созданные поля в выпадающем списке в поле Описание.
Данную настройку необходимо выполнить для всех созданных файлов.
Далее необходимо перейти в Шаблоны, в выпадающем списке появится новая переменная, ОПИСАНИЕ ДЛЯ ФАЙЛА, вставьте эту переменную в каждый шаблон в поле с описанием
На этом настройка завершена, нажмите Выгрузить сейчас на главной странице приложения, для того, чтобы обновить данные в файлах выгрузки.
¶ Фото магазина
В приложении есть возможность добавить фото магазина к каждому товару. Для этого необходимо выполнить:
- Создайте новый товар на складе
- Назовите товар фото_магазина
Обратите внимание, название товара должно быть именно таким как указанно выше, в противном случае работать не будет - Загрузите изображения вашего магазина в данный товар
Теперь, при каждой выгрузке, помимо изображений самого товара, в конец списка будут добавлены изображение вашего магазина, которые будут браться из карточки товара фото_магазина
¶ Настройка выгрузки изображений товаров
С помощью приложения можно гибко настроить выгрузку изображений из МойСклад на Авито.
Если не производить никаких настроек, то приложение выгружает все катринки из каждой карточки товара из МойСклад, но бывает такая необходимость выгружать изображения не из МойСклад, а например с собственного сайта.
Пример: У Вас на сайте загружены изображения в хорошем качестве, и Вы хотели бы чтобы именно они попали на Авито. Мы реализовали данную возможность, теперь в качестве источника изображений можно указывать ссылки (на примере выше, например ссылки на свой сайт).
Настройка:
- Создать дополнительное поле
- В каждой карточке товара указать список ссылок на изображения
¶ Создать дополнительное поле в товарах
Создаем дополнительное поле в товарах:
- Тип поля: Строка или Текст
- Название поля: Список ссылок на изображения авито
ВНИМАНИЕ! Тип поля и название поля должны полностью соответствовать указанному выше шаблону, включая регистр, в противном случае функционал работать не будет
¶ В каждой карточке товара указываем список ссылок на изображения
Переходим в карточку товара, и в данное поле вставляем список ссылок на изображения, разделенный запятыми.
Обращаем Ваше внимание, что если присутствует поле, которое мы создали на предыдущем шаге (Список ссылок на изображения авито), то изображения из карточки товара выгружаться не будут. Нельзя одновременно выгружать изображения из карточки товара и из дополнительного поля по ссылкам. Пожалуйста, учтите это при настроке выгрузки изображений по ссылкам.
¶ Настройка порядка выгрузки изображений
Если не производить никаких настроек, то приложение выгружает все катринки из каждой карточки товара из МойСклад или все картинки из дополнительно поля по ссылкам, но бывает такая необходимость выгружать не все изображения, а только определенные. (Например только второе изображение, или второе и третье)
Для настройки данного функционала, необходимо в товарах создать дополнительное поле:
- Тип поля: Строка
- Название поля: Изображения для авито
ВНИМАНИЕ! Тип поля и название поля должны полностью соответствовать указанному выше шаблону, включая регистр, в противном случае функционал работать не будет
После того как Вы создали поле, в каждой карточке товара необходимо выбрать какое изображение Вы хотите выгружать на Авито (Можно в МойСклад массово заполнить данное поле)
Для определения изображения необходимо использовать его порядковый номер, например у товара есть 3 изображения, соответственно номера у них будут 1,2,3
Мы разработали несколько примеров заполнения данного поля:
- Если в поле ввести цифру 1 - то в выгрузку попадет только первое изображение из карточки товара
- Если в поле ввести цифры 1-3 - то в выгрузку попадут только с первого по третье изображение из карточки товара
- Если в поле ввести 2-* - то в выгрузку попадут изображения со второго и до последнего из карточки товара
¶ Несколько цен
Бывает такая ситуация, когда необходимо указать несколько цен на товар, например:
В карточке товара есть Цена продажи и Цена по акции, задача состоит в том, чтобы если указана Цена по акции, то именно она попадала в выгрузку, а если не указана, то попадала Цена продажи или любая другая которую Вы укажите.
Реализуется это следующим образом:
Для примера у нас будет две цены 1. Цена продажи, 2. Цена по акции
Переходим в нужный шаблон, и в поле Цена вставляем строку по такому шаблону
{[!Цена по акции!] | [!Цена продажи!]}
ВНИМАНИЕ! Вам будет необходимо выбрать из списка свои цены, данные цены указаны для примера.
¶ Расчет цены комплекта
При выгрузке комплектов, в приложении реализован функционал расчета цены комплекта.
Как это работает. Приложение при выгрузке проверяет цену у всех комплектующих входящих в состав комплекта, затем суммирует полученные цены, таким образом упрощается работа с комплектами по актуализации цены на комплект.
Перейдем к настройке:
-
На главной странице приложения необходимо активировать опцию Рассчитывать цену комплекта
-
Из выпадающего списка выбрать нужную вам цену для комплектующих (данная цена будет суммироваться при расчете цены комплекта)
Также предусмотренна дополнительная возможность, отключать расчет стоимости комплекта, если в карточке комплекта цена указана.
Для этого необходимо активировать опцию Не рассчитывать, если цена заполнена
Пример:
Если заполнена Цена продажи, то в Цену комплекта проставится Цена продажи
-
Сохранить настройки
-
Переходим в нужный шаблон и в поле Цена, из выпадающего списка выбираем Цена комплекта
-
Для обновления данных в 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.
Для этого нажмите кнопку Выгрузить сейчас на главной странице приложения.
¶ Выгрузка товара не зависимо от остатка
В данном разделе разберем следующий кейс:
У Вас включена опция проверки остатков в приложении и приложение выгружает только те товары, которые есть в наличии, но Вам необходимо какието позиции выгружать не зависимо от остатка на складе. Для этих целей в приложении предусмотрен функционал.
Для его настройки необходимо сделать следующее:
- В карточке товара создать доп поле с типом Флаг и названием Выгружать всегда (Данное поле должно называться именно так, в противном случае работать не будет)
- В нужных товарах отметить данное поле
На этом настройка завершена, отмеченные товары будут попадать в выгрузку не зависимо от остатка.
¶ Интеграция с Авито
¶ Мессенджер
¶ Интеграция диалогов с Авито
Ведение переписки с клиентами с авито из приложения.
Данный функционал позволяет полноценно вести диалоги с клиентами с авито напрямую из приложения.
Поддерживается несколько аккаунтов.
Настройка и активация мессенджера в приложении:
- Необходимо перейти в приложени в раздел Авито
- Добавьте аккаунт или аккаунты Авито, заполнив необходимые поля для авторизации приложения на портале Авито:
- ClientId
- ClientSecret
Получить данные ключи для авторизации можно в личном кабинете Авито (Ссылка на раздел с ключами для доступа по API)
- После сохранения, в главном меню появится новая вкладка "Мессенджер". В данном разделе будут доступны диалоги с авито.
Приложение поддерживает подключение нескольких аккаунтов авито.
На данном этапе настройка закончена и Вы можете общаться с клиентами из приложения Интеграция МойСклад и Авито. Сообщения будут приниматься и отправляться в режиме реального времени.
¶ Заказы Авито
Данный функционал, позволяет в автоматически создавать заказ в МойСклад, в момент когда заказ создается на авито клиентом.
(Автоматическое создание закзов в стадии тестирования, в скором времени будет доступено к использованию. Следите за обновлениями в нашей группе в ТГ.)
¶ Ускоренная проверка остатков
МойСклад выпустил обновление, которое затронуло проверку остатков по API. Мы реализовали данную проверку и в нашем приложении. Главная особенность данного функцинала состоит в том, что проверка наличия и остатков товара происходит быстрее примерно на 30-40%. Пока МойСклад производит окончательную отладку данных механизмов, мы вынесли его в своем приложении в блок "Экспериментально".
Для клиентов с большим количеством товара, более 1000 шт. данный функционал будет полезен тем, что время выгрузки товаров из МойСклад в XML файл будет занимать более короткий промежуток времени.
¶ Проверка XML файла на наличие ошибок
После выполнения настроек на стороне МойСклад и выгрузки, необходимо проверить XML файл на наличие ошибок, сделать это можно с помощью специального сервиса Авито.
Ссылка на сервис проверки XML файла на наличие ошибок https://autoload.avito.ru/format/xmlcheck/
- Перейдите по ссылке, в открывшемся окне вставьте ссылку из приложения, и нажмите "Проверить"
- Дождитесь окончания проверки.
¶ Работа с ошибками в 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 файле для автозагрузки Авито. В случае возникновения других ошибок, можно по данному методу самостоятельно выявлять и устранять эти ошибки. Если у Вас не получается самостоятельно разобраться с возникшими ошибками, то Вы можете обратиться в нашу службу поддержки.