Уважаемые пользователи приложения, если у Вас на любом этапе по настройке приложения возникли сложности, пожалуйста, обращайтесь в службу нашей технической поддержки.
Создать обращение можно одним из способов:
- Создать тикет в службу поддержки (Ссылка)
- Отправить письмо в службу поддержки (адрес 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 файла
- Блок Статус последнего обновления - статус последнего обновления, возможные варианты:
-- InWork - задание по выгрузке выполняется в данный момент (выгрузка занимает от 1 до 20 минут, в зависимости от количества товаров на складе)
-- Success - последняя выгрузка выполнена успешно
-- Error - последняя выгрузка завершилась с ошибкой
Для того чтобы узнать причину либо код ошибки во время последней выгрузки, необходимо в разделе Статус выгрузки (самый нижний блок со списком) навести мышкой на Ошибка, отобразится ошибка, пример на картинке выше отобразилась ошибка "Не получилось достать данные из МойСклад"
Коды всех возможных ошибок, а также описание, доступны в разделе Возможные ошибки во время выгрузки
¶ Блок Выгрузка
Данный блок содержит информацию о том, какое количество товаров, категорий и складов выгружается на данный момент.
- Блок Количество товаров - количество товаров которые на данный момент выгружены в XML файл
- Блок Количество категорий - количество категорий связанных с шаблонами
- Блок Количество складов - количество выбранных складов для выгрузки в XML
¶ Блок Ссылка на XML файл
Данный блок содержит ссылку на обновляемый XML файл с Вашими товарами, а также ссылку на журнал последней выгрузки, в данном журнале регистрируются ошибки, которые могут возникнуть во время выгрузки. Наприер. у товара отсутствует картинка, а для данной категории авито картинка является обязательной, поэтому данный товар не попадет в выгрузку, о чем будет сделана запись в журнале. Таким образом Вы оперативно узнаете, почему тот или иной товар не попали в выгрузку.
¶ Блок Статус выгрузки
В данном блоке отображается список с датой и статусом последних 10 обновлений/выгрузок XML файла, а также в случае возникновения ошибки, в данном блоке отобразится код или наименование ошибки
¶ Блок Настройка интеграции
Содержит базовые настройки интеграции МойСклад и UnitXML
-
Блок Поле отвечающее за интеграцию - кастомное (дополнительное) поле, созданное в МойСклад, по данному полю, приложение UnitXML определяет какой товар надо выгружать, а какой нет, то есть, если в карточке товара отмечено галочкой данное поле, то данный товар попадет в выгрузку.
Если оставить Поле отвечающее за интеграцию пустым, то есть, не выбирать ничего из списка, то в выгрузку попадут абсолютно все товары с выбранных складов или из каталога, в зависимости от настроек..
Кнопка Обновить данные - после нажатия на данную кнопку, произойдет обновление данных в приложении о кастомных полях, категориях, ценах продаж из МоегоСклада. Каждый раз, когда Вы добавляете в МойСклад кастомное поле, или новый тип цен, то необходимо нажать на данную кнопку. чтоб UnitXML обновил эти данные в своей базе. -
Блок с выбором Источника данных - В данном блоке доступен для выбора один из двух вариантов источников данных:
-- Каталог товаров
-- Склады
При выборе опции Выгружать товары из каталога - в качестве источника данных о товарах будет использоваться Ваш каталог в МойСклад, то есть, вся информация о товарах, будет подгружаться из него. Обратите внимание, при выборе данной опции, будет не доступен функционал работы с остатками, резервом и товаром в ожидании. Преимущество выгрузки товаров из каталога - это то, что его не надо предварительно приходовать на складе.
При выборе опции Выгружать товары со складов - в качестве источника данных будут использоваться склады, которые Вы выберите.
-
Блок Склады - данный блок содержит информацию о Ваших складах, а также настройку выгрузки товаров исходя из остатков. Отметьте те склады, товары с которых должны попадать в выгрузку.
-- Проверять остатки на складах - если включена данная опция, то приложение будет проверять остаток товара на складах, и если остаток будет равен 0, то данный товар не будет попадать в выгрузку
-- Вычитать из остатков резерв - если включена данная опция, то приложение будет вычитать из остатков товара зарезервированный товар, и если при этом будет положительный остаток, то товар попадет в выгрузку
-- Вычитать из остатков товары в ожидании - если включена данная опция, то приложение будет вычитать из остатков товара на всех выбранных складах товар в ожидании, и если при этом будет положительный остаток, то товар попадет в выгрузку -
Блок Периодичность
В данном блоке настраивается расписание выгрузки. Выгрузка/обновление файла, происходит один раз в сутки, в заданное Вами время. Время выгрузки можно менять не чаще 3 раз за 24 часа, в расчет берутся не календарные сутки, а именно 24 часа.
Также в данном блоке доступна опция Выгрузить сейчас, если нажать на данную кнопку, то произойдет попытка постановки в текущую очередь задания на обновление Вашего файла, и если на данный момент в системе не будут заняты все ресурсы, то Ваша выгрузка выполнится, о чем Вы получите уведомление в всплывающем окне. -
Выгрузка комплектов
Приложение поддерживает выгрузку комплектов из МойСклад на авито. Если включена опция Проверять остатки на складах, то приложение будет проверять остатки каждого компонента комплекта, если остаток любого компонента из комплекта меньше или равен нулю, то данный комплект выгружен не будет, таким образом можно контролировать выгрузку только тех комплектов, комплектующие к которым есть в наличии. Информация об этом будет отражена в журнале выгрузки. Если опция Проверять остатки на складах* не включена, то комплекты будут попадать в выгрузку вне зависимости от наличия комплектующих комплекта на складе.
Для того, чтобы комплект корректно выгрузился, необходимо в карточке товара каждого компонента сделать активным поле для интеграции (отметить флажок Авито), если по каким то причинам, например много комплектов и в них много комплектующих, вы не хотите в каждой карточке товара комплектующих устанавливать флажок, то необходимо включить опцию Игнорировать поле интеграции в комплектующих. -
Выгрузка модификаций Приложение поддерживает выгрузку модификаций товаров как отдельные товары, по умолчанию выгружаются все модификации товара. Если Вам необходимо изменить данное поведение, то есть, например выгружать модификации не у всех товаров, то создайте дополнительное поле:
-- Тип: Флажок
-- Название: Игнорировать модификации
Обратите внимание, тип и название поля должны быть строго как указано выше, в противном случае работать не будет
После создания поля, отметьте его в карточке товара, модификации которого НЕ должны выгружаться.
После этого в выгрузку удет попадать только головной товар.
Если Вы таким образом отключили выгрузку модификаций, и при этом включена опция Проверять остатки на складе, то приложение все равно будет смотреть остатки по всем модификациям, и если у какой-нибудь модификации есть положительный остаток, то головной товар попадет в выгрузку.
Остаток модификаций на складе суммируется.
Таким образом в приложении реализована гибкая настройка выгрузки модификаций.
¶ Настройка интеграции
¶ Настройка шаблонов для выгрузки
- На главной странице, в блоке Настройка интеграции выберите склады, товары с которых должны попадать в выгрузку, проверку остатков, поле для интеграции и время выгрузки (расписание), подробно о значении каждого блока написано в разделе Блок Настройка интеграции. Сохраните настройки.
- Перейдите в раздел Шаблоны (в основном меню)
На данном этапе необходимо создать шаблон для выгрузки товаров из определенной категории МойСклад в определенную категорию Авито. Шаблонов можно создавать не ограниченное количество. Для удобства обычно создают один шаблон для одной категории товаров МойСклад.
В качестве примера, давайте представим что Вы продаете посуду и в МойСклад у Вас есть категория товаров "Посуда". Следовательно товары из данной категории нужно выгрузить на авито в соответствующий раздел, для этого сделайте следующее:
- Создайте шаблон
- Дайте название шаблону
- Выберите категорию на Авито (В нашем примере категория Для дома и дачи)
- Выберите подкатегорию на Авито (В нашем случае Посуда и товары для кухни)
- Поля отмеченные звездочкой являются обязательными для заполнения
- Из выпадающих списков можно выбирать значения которые будут подставляться из МойСклад, это как основные поля, например ЦЕНА, ОПИСАНИЕ и т.д, так и кастомные поля, которые Вы можете заранее создать в МойСклад. (Подробнее про создание кастомных полей тут). Также в выпадающих списках предусмотренны стандартные значения полей с Авито, например: НОВОЕ или ТОВАР ПРИОБРЕТЕН НА ПРОДАЖУ и т.д. В зависимости от выбранной категории Авито, список полей, а также обязательность их заполнения меняется, в соответствии с требованиями Авито. Например в некоторых категориях Авито не требует обязательное наличие изображения у товара, а в некоторых без изображения товар не пройдет проверку и не будет опубликован. (Примечание: Если Вы создали дополнительное поле, в шаблоне выбрали его для подстановки, например в ОПИСАНИЕ, но в карточке товара данное поле не заполнено, то данный товар в выгрузку не попадет, так как поле ОПИСАНИЕ является обязательным. Также данное примечание актуально для всех обязательных полей, картинки и т.д. )
- Сохраните шаблон
¶ Назначение полей идентификации в шаблоне
В шаблоне имеются два поля, которые отвечают за идентификацию и уникальность объявления
Поле №1: Идентификатор объявления (Id)
Данное поле отвечает за идентификацию объявления на стороне Авито именно в автозагрузке.
У каждого объявления должен быть уникальный идентификатор, это позволяет обновлять объявления при следующих выгрузках.
ВНИМАНИЕ! Не заполняйте данное поле без особой на то необходимости, оставьте его пустым, приложения автоматически заполнит его уникальным значением, чтобы избежать дублирования идентификаторов и создания дублей объявлений.
Поле №2: Номер объявления на Авито (AvitoId)
Данное поле предназначено для связи ранее созданного в ручном режиме объявления на авито и объявления из автозагрузки.
Если вы создали ранее на авито объявления в ручную, то у него есть Номер, данный Номер имеет тип Целое число и выглядит следующим образом, пример: 245654846546.
Для связи данного объявления и товара в МойСклад, выполните следующие действия:
- Создайте дополнительное поле в МойСклад, тип Строка, название Номер на Авито (может быть произвольным)
- В каждой карточке товара, которую необходимо связать с объявлением, ранее созданным на авито в ручном режиме, в доп поле Номер на Авито укажите Номер объявления с Авито.
- В настройках интеграции, в приложении, нажмите Обновить данные
- В шаблонах. в поле Номер объявления на Авито, из выпадающего списка выберите Номер на Авито.
- Сохраните шаблоны
- Нажмите Выгрузить сейчас.
ВНИМАНИЕ! Не вставляете в данное поле никаких значений, кроме Номера объявления с авито, и то. только в том случае. если Вам необходимо связать созданное ранее объявление (в ручном режиме) и товар в МойСклад.
¶ Передача остатков товара на Авито
Для того, чтобы поддерживать актуальными остатки товара на Авито, была реализована возможность передачи остатков согласно документации Авито через дополнительный XML файл (Ссылка на документацию Авито)
Для работы данного функционала, в шаблонах добавлено поле Остаток.
По умолчанию данное поле заполнено значением {[!Остаток на складе!]|*}.
Данное значение является Логическим. и означает, что в выгрузке будут передан Остаток на складе (если он больше нуля) ИЛИ значение что количество данного товара пополняется
Список всех допустимых значений:
- [!Остаток на складе!] (Или любое доп поле, содержащее актуальную информацию по остаткам товара)
- * (Звездочка) - Означает что товар постоянно пополняется
В приложении. при клике на иконку откроется список товаров, которые на данный момент попали в выгрузку
Как показано на скриншоте ниже, на данной странице будет 2 ссылки
- Ссылка на XML файл, содержащий информацию о товарах
- Ссылка на xml файл, содержащий информацию об остатках товаров
Ссылку на xml файл, содержащий информацию об остатках товаров, необходимо разместить в личном кабинете Авито, о том как правильно разместить ссылку в ЛК Авито, смотрите в инструкции
¶ Настройка категорий
После того, как Вы настроили шаблон или несколько шаблонов, их необходимо связать с категориями в МойСклад, то есть, "сказать" приложению, по какому шаблону нужно выгружать товары из той или иной категории.
Перейдите в раздел Категории (в основном меню)
- Выберите из выпадающего списка слева категорию из МойСклад (В нашем случае "Посуда") (Примечание: Если в МойСклад у Вас есть категория например Посуда/Посуда для дачи и товары именно из нее должны попадить в выгрузку, создайте отдельный шаблон для данной категории и свяжите его именно с категорией Посуда/Посуда для дачи.)
- Выберите из выпадающего списка справа шаблон для выгрузки данной категории
- Сохраните изменения
Вы можете создавать не ограниченное количество связей категорий и шаблонов для выгрузки.
На этом настройка интеграции приложения закончена, все выбранные товары будут выгружены в XML файл стандарта Авито в заданное Вами время.
¶ Настройки на стороне Авито
После того как Вы настроили интеграцию с МойСклад, необходимо дождаться первой выгрузки, либо провести ее принудительно путем нажатия кнопки Выгрузить сейчас. Если выгрузка прошла успешно и не возникло никаких ошибок, то Вам необходимо скопировать ссылку на XML файл
и разместить ее в разделе Автозагрузка на Авито, а также настроить расписание.
По всем вопросам относительно настроек внутри сервиса Авито, пожалуйста, обращайтесь в поддержку Авито или к Вашему менеджеру.
¶ Дополнительные возможности
¶ Вывод дополнительных полей из МойСклад в шаблон
В данном разделе описан процесс, как вывести значения лополнительных полей из МойСклад в шаблон для выгрузки.
Это является удобным дополнением в случае когда необходимо выводить значение из доп поля для каждого товара. Например Бренд. Описание, размер и т.д.
Ниже будет приведен пример, как вывести дополнительное или свое описание из доп.поля МойСклад в шаблон для выгрузки.
¶ Описание товара из дополнительного поля
Представим ситуацию, что у Вас есть некий товар, у товара есть описание (стандартное поле в МойСклад), но в данное поле Вы записываете описание для внутреннего использования, или для интеграции с интернет магазином, а для Авито вы хотите чтоб с товаром выгружалось другое, отличное от основного описание. Такая возможность есть в приложении UnitXml.
Основной план действий:
- Создаем кастомное поле в МойСклад
- Обновляем список кастомных полей в приложении UnitXML
- В настройках шаблона, из выпадающего списка выбираем вновь созданное кастомное поле
¶ ВАРИАНТ №1
- Создаем кастомное поле в МойСклад
Подробная инструкция по созданию дополнительных полей есть в МойСклад, а также в начале данной инструкции, на примере создания дополнительного поля для интеграции.
Для примера создадим дополнительное поле Описание для авито
После того как поле создано в МойСклад, необходимо в приложении обновить данные (Список полей обновится в том числе)
Перейдите на главную страницу, нажмите Обновить данные
Теперь наше дополнительное поле доступно для выбора в настройках шаблонов
Нажмите на раскрывающийся список, и кликните по нужному полю, значение подставится в поле автоматически
¶ ВАРИАНТ №2
В первом варианте мы создали доп.поле Описание с типом строка, таким же образом можно создавать доп.поля с другим типом, например тип Справочник.
- Создать справочник в МойСклад
- Создать доп.поле в МойСклад, тип Справочник
- В приложении нажать Обновить данные
- В шаблоне, из выпадающего списка выбрать доп поле со справочником
Создать новый справочник в МойСклад (если у вас уже есть справочник, значения которого вы хотели бы использовать, то справочник создавать не нужно, пропустите этот шаг)
В нашем примере мы будем создавать справочник книг
Заполним значения полей справочника нужными данными
Таким образом у нас получился справочник с перечнем книг и описанием к каждой книге.
Переходим в Товары и услуги и создадим доп поле
Название произвольное, Тип Справочник, и выберем необходимый справочник, в нашем примере это справочник Книги
Переходим в карточку товара и выбираем значение из справочника, соответствующее товару. (Например если справочник с Брендами, то выбираем нужный бренд и т.д.)
В нашем примере справочник с названиями и описаниями книг
Переходим в приложение, обязательно нажимаем Обновить данные
Открываем шаблоны, и в выпадающем списке появились два новых пункта
- Справочник Книги
- Справочник Книги.Описание
Если мы выберем Справочник Книги, то в данное поле будет подставлено значение Наименование из справочника, в нашем примере Книга №1 или Книга №2
Если мы выберем значение Справочник Книги.Описание, то в данное поле будет подставлено Описание для значения справочника
Таким образом можно создавать неограниченное количество кастомных (Дополнительных) полей.
¶ Несколько XML файлов
Изначально все товары выгружаются в один единый XML файл, но бывают такие ситуации, когда необходимо разделить товары/категории товаров на несколько частей. Представим такую ситуацию, у Вас на Авито несколько аккаунтов и на разных аккаунтах свой товар и свой регион, это как пример, существует много ситуаций при которых выгрузка всех товаров в единый XML накладывает определенные ограничения, именно для того, чтобы исправить данную ситуацию и был создан механизм разделения на несколько файлов XML.
В приложении реализовано два основных варианта разделения товаров на разные XML файлы для выгрузки:
- Разделение по номенклатуре товаров
При данном варианте разделения товаров по нескольким XML файлам, не учитывается склад, на котором есть в наличии товар, отмеченный для выгрузки в конкретный XML файл, приложение просто проверит что товар есть на складе, и выгрузит его в нужный XML файл - Разделение по складам
В данном случае, можно выгружать товары только с отдельно взятых складов, каждый склад будет выгружен в отдельный XML файл. Этот вариант выгрузки будет удобен, если у вас несколько аккаунтов авито в разных регионах (как пример), и в каждом регионе свой склад.
Рассмотрим первый вариант разделения товаров на несколько файлов XML для выгрузки по номенклатуре
¶ (Настройка выгрузки для нескольких аккаунтов Авито из МойСклад Вариант №1)
Условие:
- На данном этапе уже должна быть выполнена базовая настройка приложения согласно инструкции
Основной план действий:
- Создать кастомное (Дополнительное) поле в карточке товаров (МойСклад)
- В карточке товара выбрать в какой XML файл выгружать данный товар
Создаем кастомное поле как описано в данном разделе
Имя поля Обязательно:
- должно начинаться с XML_ (обратите внимание на нижнее подчеркивание)
- Формат XML_ВашеНазвание (Пример: XML_One)
- Не должно содержать пробелов и спецсимволов
- Только латинские буквы (Названия на русском работать не будет)
Тип поля Обязательно:
- Флажок
Описание:
- Произвольное, на работу приложения не влияет
На примере выше создали два файла XML.
Переходим в карточку товара и отмечаем тот XML в который данный товар должен выгрузится. Также можно выделить несколько XML.
После очередной выгрузки, на главной странице, всесто ссылки на один единый XML файл, Вам будут доступны ссылки на все, созданные ранее XML файлы, и каждый из них будет содержать информацию о товарах, в которых он (XML файл) выбран. Самый первый в списке XML файл будет содержать информацию о всех товарах, которые выбраны для выгрузки, не важно в какой из файлов.
Рассмотрим второй вариант разделения товаров на несколько файлов XML для выгрузки по складам
Условие:
- На данном этапе уже должна быть выполнена базовая настройка приложения согласно инструкции
Основной план действий:
- Создать кастомное (Дополнительное) поле в настройках склада (МойСклад)
- В настройках склада выбрать в какой XML файл выгружать товары с данного склада
Для наглядного примера у нас есть два склада, склад в Москве, и склад в Твери, необходимо, чтобы товары с каждого отдельно взятого склада попадали в отдельные XML файлы для выгрузки
Создаем дополнительное поле в настройках складов
Исходя из того, что у нас два склада, нам необходимо создать два дополнительных поля:
Имя поля Обязательно:
- должно начинаться с XML_ (обратите внимание на нижнее подчеркивание)
- Формат XML_ВашеНазвание (Пример: XML_SkladMSK)
- Не должно содержать пробелов и спецсимволов
- Только латинские буквы
Тип поля Обязательно:
- Флажок
Описание:
- Произвольное, на работу приложения не влияет
В нашем примере поля будут называться:
- XML_SkladMSK
- XML_SkladTVER
Далее необходимо зайти в настройки каждого склада, и выбрать в какой именно файл выгружать товары с данного склада
Не забываем сохранять изменения для применения настроек
Далее необходимо перейти на главную страницу приложения, и запустить выгрузку.
После завершения процесса выгрузки, будут доступны три ссылки на XML файлы.
- XML_SkladTVER - в данном XML файле будет информация о товарах, которые есть на складе Склад Тверь
- XML_SkladMSK - в данном XML файле будет информация о товарах, которые есть на складе Склад Москва
- Третья ссылка будет содержать информацию о всех товарах.
Обратите внимание, если вы ранее настроили разделение на несколько XML файлов Способом №1, то разделение выгрузки по складам одновременно работать не будет, так как Способ №1 будет иметь приоритет. Разделение необходимо настраивать только одним из доступных способов, так как они взаимоисключающие.
¶ Как указать контактную информацию для каждого XML файла
При разделении выгрузки на несколько XML файлов, как правило возникает необходимость указать свои контакты (телефон, адрес) для каждого файла. Приведу пример: Допустим есть два аккаунта на авито, которые ведут торговлю в двух разных регионах. соответственно при выгрузке для каждого региона должны быть указаны свои контакты (телефон, адрес), именно для этих целей в приложении реализован данный функционал.
¶ План действий:
- Создать справочник в МойСклад
- В настройках шаблона выбрать необходимые поля
Берем в расчет что Вы уже создали два кастомных поля как это описано в пункте выше, для разделения выгрузки на два файла (В нашем примере это XML_One и XML_Two) ПРИМЕЧАНИЕ! Не зависимо от того сколько XML файлов Вы создаете, всегда в списке файлов будет присутствовать XML файл, который содержит все товары.
Далее по тексту такой файл будем называть Основной файл.
Далее необходимо создать справочник.
В МойСклад переходим в Настройки => Добавить справочник
При создании справочника, поле Наименование необходимо заполнить как на изображении ниже, а именно UnitXML_Поля ВНИМАНИЕ! Если справочник будет назван по другому, данный функционал работать не будет
После создания справочника, создаем в нем нужные поля.
Поля должны создаваться по шаблону:
<Название XML файла>_<Название поля>
Например у нас есть два XML файла (из примера выше) + один Основной XML, который содержит все товары:
- XML_One
- XML_Two
Для того чтобы создать поля с контактной информацией для файла XML_One, создаем поля в справочнике и именем:
-
XML_One_Телефон (В описание поля пишем номер телефона)
-
XML_One_Адрес (В описание поля пишем Адрес)
-
XML_One_Регион (В описание поля пишем Регион)
По аналогичной схеме создаем поля в справочнике и для второго файла (Второй файл в нашем примере имеет имя XML_Two)
-
XML_Two_Телефон (В описание поля пишем номер телефона)
-
XML_Two_Адрес (В описание поля пишем Адрес)
-
XML_Two_Регион (В описание поля пишем Регион)
По аналогичной схеме создаем поля в справочнике и для Основного файла XML, о котором говорилось выше, тот который по умолчанию содержит информацию по всем товарам (По умолчанию в справочнике имя для данного файла необходимо использовать XML_main)
-
XML_main_Телефон (В описание поля пишем номер телефона)
-
XML_main_Адрес (В описание поля пишем Адрес)
-
XML_main_Регион (В описание поля пишем Регион)
ВНИМАНИЕ! Все поля справочника должны называться строго по приведенному выше шаблону, а именно: ИМЯ XML файла НИЖНЕЕ ПОДЧЕРКИВАНИЕ НАЗВАНИЕ ПОЛЯ (Пример XML_One_Телефон и т.д.)
Для нашего примера, когда у нас есть Один основной (создается по умолчанию) и два дополнительных XML файла, справочник должен выглядеть как на изображении ниже
После создания всех необходимых полей в справочнике, необходимо обновить данные в приложении, для этого перейдите на главную страницу приложения и нажмите Обновить данные
После обновления данных, все поля справочника будут доступны в настройках шаблонов.
Перейдите в настройки шаблонов и заполните поля в шаблоне (Телефон, Адрес, Зоны показа) данными из справочника
Не забудьте сохранить шаблон после редактирования.
На главной странице приложения нажмите Выгрузить сейчас, дождитесь окончания процесса выгрузки, проверьте в XML файлах заполнение полей с контактной информацией. Если все сделано правильно, то в каждом отдельном XML файле контакты будут указаны свои (из справочника)
¶ Как указать цену для каждого XML файла
Если Вам необходимо для каждого из созданых XML файлов указать свою цену, например у Вас два аккаунта Авито для разных регионов, и цена на товар должна быть разной, в зависимости от региона, то Вам необходимо по инструкции выше создать два файла XML. и произвести дополнительные настройки указанны ниже.
План действий:
- Создать новую цену в МойСклад
- Добавить новое поле в справочник UnitXML_Поля (Как создать нужный справочник и в нем создать необходимые поля, написано тут)
Ниже в инструкции мы предполагаем что у Вас уже предварительно настроена выгрузка в два файла. В примере по настройке нескольких файлов мы использовали имена для файлов XML_One и XML_Two
¶ Создание цены в МойСклад
Для создания новой цены перейдите в МойСклад в раздел товары
Создайте новые цены для всех своих файлов XML, в нашем примере создадим две новые цены
Перейдите в карточку товара и присвойте значения новым полям с ценой, а также не забудьте присвоить значение полю с ценой для основного файла, в нашем примере это Цена продажи (Напоминаем, что в независимости от того сколько XML файлов Вы создадите, все равно будет создаваться один общий XML файл, который будет содержать данные о всех товарах, Вы можете его не использовать для загрузки на Авито, но он все равно будет создан и доступен в интерфейсе приложения. Более подробно про создание нескольких XML файлов можно почитать тут)
Далее необходимо перейти к настройке справочников
В справочнике необходимо создать, в нашем примере, 3 поля (для 3-х файлов)
Наименование поля необходимо заполнить по шаблону XML_<Название файла>_Название поля цены
Описание - в данное поле необходимо вставить название цены, созданной на прошлом шаге (см.пример ниже)
Поле №1: (Это поле для файла XML_One)
- Наименование: XML_One_Название поля цены
- Описание: Цена для файла XML_One
Поле №2: (Это поле для файла XML_Two)
- Наименование: XML_Two_Название поля цены
- Описание: Цена для файла XML_Two
Поле №3: (Это поле для основного файла)
- Наименование: XML_main_Название поля цены
- Описание: Цена продажи
В итоге справочник должен сожержать такие поля
Сохраняем справочник и переходим в приложение. На главной странице нажать Обновить данные
Перейти в Шаблоны, в выпадающем списке появится новая переменная, ЦЕНА ДЛЯ ФАЙЛА, вставьте эту переменную в каждый шаблон в поле с ценой
Не забудьте сохранить шаблоны.
На этом настройка цен для каждого XML файла закончена.
¶ Как сделать описание для товара для каждого XML файла
Если Вам необходимо для каждого из созданых XML файлов указать свое описание для товара, например у Вас два аккаунта Авито, и описание должно быть разным, то Вам необходимо по инструкции выше создать два файла XML. и произвести дополнительные настройки указанные ниже.
План действий:
- Создать дополнительные поля в МойСклад
- Добавить новые поля в справочник UnitXML_Поля (Как создать нужный справочник и в нем создать необходимые поля, написано тут)
Ниже в инструкции мы предполагаем что у Вас уже предварительно настроена выгрузка в два файла. В примере по настройке нескольких файлов мы использовали имена для файлов XML_One и XML_Two
Создайте в карточке товаров в МойСклад два дополнительных поля (именно два, так как у нас в примере разделение на два xml файла выгрузки)
В нашем примере мы назовем новые поля для описания так:
- Описание для XML_One
- Описание для XML_Two
Тип поля - Текст
В каждой карточке товара заполните данные поля нужным вам текстом
Следующим шагом необходимо добавить новые поля в справочник UnitXML_Поля:
- Название поля: XML_One_Название поля Описания
В строку Описание, для данного поля справочника, необходимо указать название поля в карточке товара, которое содержит описание для файла XML_One, в нашем примере оно называется Описание для XML_One
- Название поля: XML_Two_Название поля Описания
В строку Описание, для данного поля справочника, необходимо указать название поля в карточке товара, которое содержит описание для файла XML_One, в нашем примере оно называется Описание для XML_Two
Переходим к настройке шаблонов.
После выполнения всех предыдущих шагов, в шаблоне, в выпадающем списке появится новое значение ОПИСАНИЕ ДЛЯ ФАЙЛА
Выбрав данное значение, в 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.
Для этого нажмите кнопку Выгрузить сейчас на главной странице приложения.
¶ Экспериментальные функции
В данном разделе будут описаны экспериментальные функции
¶ Ускоренная проверка остатков
МойСклад выпустил обновление, которое затронуло проверку остатков по API. Мы реализовали данную проверку и в нашем приложении. Главная особенность данного функцинала состоит в том, что проверка наличия и остатков товара происходит быстрее примерно на 30-40%. Пока МойСклад производит окончательную отладку данных механизмов, мы вынесли его в своем приложении в блок "Экспериментально".
Для клиентов с большим количеством товара, более 1000 шт. данный функционал будет полезен тем, что время выгрузки товаров из МойСклад в XML файл будет занимать более короткий промежуток времени.
