Колонки Excel в списке товаров|услуг
Колонки в файле Excel «зашифрованы» в краткие англоязычные сокращения умышленно, во избежание многочисленных проблем.
Например, если бы мы назвали колонку “Название Категории в вашей учетной системе”, то (1) В узкой колонке Excel вы увидите лишь первые буквы из названия и не поймете ее значения; (2) Любая ошибка или опечатка или сокращение в наименовании - приведет к тому что содержимое колонки не будет считываться.
К примеру, здесь 5 ошибок, попробуйте их обнаружить: «Наименнование категории уч.системы». Поэтому колонка имеет название «crmCtuName».
развернуть
Поля JSON развернуть
Этот же набор полей используется в API - JSON, с незначительными дополнениями, описанными в инструкциях:
api и
api-json
Нажмите многоточие чтобы развернуть описание колонки
d_firmShortName - краткое название вашей фирмы в Маркете, справочное значение
d_firmID - идентификатор фирмы в маркете, соответсвует странице tu.market/firm/d_firmID Поле обязательно для указания.
d_ctuName - название “Категории Маркета”, справочное значение. Также, используется при переносе Предложения в другую “Категорию маркета” через файл Excel, в нем указывается спецкоманда _изменить_категорию_
d_ctuID - идентификатор “Категории Маркета”, к которой относится, и в которой публикуется этот товар|услуга - в вашем прайсе по адресу tu.market/firm/d_firmID/offers?ctu=d_ctuID а также в общем списке tu.market/category/d_ctuID
Категория маркета - определяет допустимый набор Единиц измерения, Характеристик, и других общих параметров для всех Предложений внутри нее.
При изменении d_ctuID в файле Excel - нужно дополнительно указать спец команду _изменить_категорию_ (в поле d_ctuName), и поле d_crmCtuName д.б. пустым.
При пустом значении - имеет значение следующее поле - d_crmCtuName.
При создании нового товара|услуги обязательно указание одного из полей - d_ctuID или d_crmCtuName
d_crmCtuID - идентификатор Категории “из вашей учетной системы”. В Excel используется только при передаче файла Excel по API. Поле используется в структурированных файлах и запросах (xml, json, автообновлении “по ссылке”)
d_crmCtuName - Названия категории “из вашей учетной системы” поле для указания (вашему товару|услуге). Используется при отсутствии идентификатора d_ctuID. При указании значения в d_crmCtuName - оно должно быть сопоставлено в “Категории маркета” (ссылка на инструкцию - внизу).
При обновлении данных - можно Перенести Предложение в другую “Категорию маркета”:
- Характеристики и Ед.измерения товара|услуги - будут перенесены автоматически, если они предусмотрены в новой Категории маркета. Иначе, они будут перенесены в Описание.
Перенос товара|услуги в другую Категорию маркета производится при условиях:
- Предложение уже существует в Маркете - указан его идентификатор (d_idTU или d_crmID),
- Указан идентификатор новой Категории (либо d_ctuID, либо d_crmCtuName) - только один (другое поле отсутствует или пустое),
- Указанный идентификатор уже есть в вашем Прайсе Маркета (см. Лист файла “Список категорий” - поле d_ctuID, и сопоставленное ему значение в соседнем поле d_crmCtuName),
- И указана спецкоманда _изменить_категорию_ - в поле d_ctuName (во избежание ошибок копирования/вставки).
d_idTU - идентификатор товара|услуги в маркете и, соответствует странице tu.market/product/d_idTU Этот идентификатор вы можете увидеть наведя на ссылку товара|услуги или открывая страницу, или общим списком - выгрузив из Маркета файл Excel.
При отсутствии этого идентификатора - имеют значение следующее поле - d_crmID, а при его отсутствии и загрузке из Excel - d_nameTU.
Для создания нового предложения из файла Excel - в этом поле должна быть указана спецкоманда: _создать_предложение_
d_crmID - артикул, идентификатор товара|услуги в вашем учете. Обязателен при использовании API. До 50 символов, не допускаются пробелы. При отсутствии d_idTU выступает идентификатором вашего Предложения при обновлении данных.
В таблице Excel может содержать начальный спецсимвол * (звездочка), указывайте его, если Excel делает автопреобразование вашего идентификатора в даты и другие форматы:этот начальный спецсимвол игнорируется при загрузке из Excel. В маркете не может быть двух предложений вашей организации с одинаковым d_crmID (при их наличии в файле - обновление этих экземпляров будет проигнорировано, с предупреждением в Отчете).
Для указания артикулов из вашего учета, в ранее созданных товарах|услугах в tu.market (если они были созданы без указания артикулов) - см.ниже раздел «Пояснения по отдельным вопросам».
d_nameTU - название товара|услуги, от 5 до 128 символов. Поле обязательное при создании предложения, команда очистки этого поля - игнорируется. При загрузке текста большей длины - он обрезается до 128 символов, с предупреждением в Отчете. Карточки товаров с неинформативными для покупателя Названиями - будут вскоре отмечены Жалобой или заблокированы модератором, уделите им внимание, это одно из важных полей для ваших успешных продаж.
При отсутствии идентификаторов (d_idTU или d_crmID) и загрузке из Excel - оно является идентификатором для обновления вашего Предложения в Прайсе, в этом случае:
- вы не сможете создать предложения с одинаковыми Названиями
- вы не сможете обновлять из Файла предложения с одинаковыми названиями (это можно делать только указав идентификатор)
d_annotationShort - краткая аанотация вашего предложения. Ограничение от 5 до 256 символов. Показывается в миниатюрах товаров|услуг по кнопке Детали. Значимо для отображения вашего товара|услуги в результатах поиска в tu.market и гугл/яндекс.. Ознакомьтесь с рекомендациями по заполнению этого поля в интерфейсе Маркетплейса (откройте это поле для редактирования в карточке любого вашего товара|услуги)
d_annotation - большая аннотация, с поддержкой html-форматирования (“художественный” текст: выделения, таблицы, колонки, изображения и т.д.) При использовании html-редактирования - следите за его корректностью, во избежание блокировки вашего товара|услуги по причине сломанного отображения в карточке. Будьте внимательны при копировании-вставке больших текстов: при вставке в ячейку, Excel молча обрезает текст до 29 тыс.знаков.
d_priceBase - базовая цена в рублях, только цифры, и запятая (или точка) для разделителя копеек. При других значениях - игнорируется. Поле обязательное. Ноль и отрицательное число - не допускается. Минимальное значение: 0,01. Указание копеек при их отсутствии - не обязательно.
При необходимости указания плавающей цены - указывайте в этом поле “нижнюю” цену и используйте префикс “от” в поле d_prefPrice.
d_price2 - цена “со скидкой”, если она есть. Требования идентичны полю d_priceBase. Значение не может быть больше чем d_priceBase. Выводится красным, с перечеркнутой ценой из поля d_priceBase, также покупателю автоматически рассчитывается и показывается размер скидки.
Поле всегда обновляется по значению, указанному в нем самом, или d_priceBase:
- Если при обновлении данных в этом поле нет значения, но указано новое значени для d_priceBase - скидка обнулится, поле примет значение из d_priceBase.
- Аналогично - если значение некорректное: больше чем d_priceBase, или значение d_price указано, а d_priceBase нет.
- При обновлении цены с сохранением скидки - всегда указывайте актуальные данные в обоих полях, иначе d_price2 примет значение d_priceBase.
d_prefPrice - используйте поле, если указываете “нижнюю” цену в предложении. Допустимое значение: “от”, оно подставляется перед ценой.
d_si - единица измерения для этого товара|услуги. Если она совпадает с предусмотренной в Маркете для этой Категории - будет указана в нем сразу. Если не предусмотрена - в Отчете будет предупреждение, мы рассмотрим возможность ее использования, она появится в вашем Предложении чуть позже.. Набор текущих единиц измерения для Категории маркета вы можете увидеть в поле d_siCtuList или на листе файла "Категории…", в поле d_siList
d_priceDesc - примечание к цене. От 4 до 128 символов. Укажите, усли требуется. Можно использовать это Примечание в сочетании с доп.ценой и доп.единицей измерения, пример: https://tu.market/product/8511
d_dopPrice - альтернативная цена. Требования аналогично полю d_priceBase
d_dopSi - альтернативная единица измерения. Поля альтернативной цены и единицы измерения предназначены для показа покупателю, например “за курс”, “за коробку” при указании основной цены “за сеанс”, “за шт.”, или наоборот. Поле выводится в соответствии со значением следующего поля (d_dopSiUse) - До или После “Примечания цены”.
d_dopSiUse - где показывать покупателю Альтернативную цену и единицу измерения, если вы их используете - укажите их положение: “До” или “После” примечания к цене. Если нужно скрыть - укажите “Нет”. Пример использования доп.единицы измерения в сочетании с “Примечанием цены” как его дополнения: https://tu.market/product/8511
d_quantity - количество “в наличии”. Положительное число или пусто (приравнивается к 0). При количестве 1 - это предложение показывается “в наличии”. При 0 - покупатель видит “на заказ” и “через сколько дней” из следующего поля (d_wait).
- Для товара - укажите в поле d_quantity остаток “на складе”. Чуть позже это поле будет учитываться в Продажах через Маркет, остаток передаваться в вашу учетную систему.
- Для услуг длительного выполнения - укажите 0 и количество дней выполнения в поле d_wait. Аналогично - если эта услуга “занята” (по записи, расписана вперед): укажите 0 и в поле d_wait - через сколько дней “свободно”. Чуть позже для услуг эти поля (d_quantity и d_wait) будут использоваться из вашего интерактивного расписания “на услугу / на специалиста / на объект”, и учитываться в продажах через Маркет. Укажите для услуги 1, если она может быть оказана “сейчас/сегодня”.
d_wait - количество “дней ожидания” Положительное число или пусто. (при пустом значении приравнивается к 30 - месяц). Имеет значение при “количестве товара|услуги” 0 (в поле d_quantity). Подробнее описано в в предыдущем поле (d_quantity).
d_available - справочное поле в файле Excel (при выгрузке ваших предложений из Маркета). В нем показано то, что видит Покупатель, на основе информации предыдущих полей (d_quantity и d_wait) этого товара|услуги
d_status - статус Публиковать или Заблокировать, или Удалить. Принимаются только эти значения.
- Отмеченный к удалению товар|услугу - можно восстановить в течение месяца. После этого карточка предложения удалится безвозвратно.
- Блокировка - как и удаление, приводит к скрытию предложения от покупателей, но само предложение не будет удалено из вашего прайса. Используйте блокировку, если прекратили продажу этого товара|услуги, но можете возобновить позже.
- Не используйте блокировку для регулирования “остатков товара” или “записи на услугу” - для этого предназначены описанные выше поля Количество и Ожидание (d_quantity и d_wait) - иначе ваше предложение будет скрыто, гугл/яндекс их увидит не ранее 2х недель после разблокировки.
Дополнительные служебные статусы:
- Жалоба - предложения со статусом Жалоба снимаются с публикации до вашей реакции. Отреагируйте на нее: устраните причину жалобы и измените статус на один из: Публиковать, Заблокировать, Удалить.
- Временное разрешение - неподтвержденные данные по вашему товару|услуге (обычно цена, наличие), проверьте их и измените статус на необходимый. Предложения с этим статусом, если вы его не измените, будут сняты с публикации в течение недели.
d_ordInCTU - важность в категории (порядковый номер) товара|услуги внутри Категории. Расставьте их по порядку, в котором они будут показываться в вашем Прайсе, Витрине, Похожих предложениях. Также, нумерация определяет, какие ваши товары|услуги из этой Категории будут опубликованы или скрыты на лимитных Тарифах. При выгрузке в Excel, для удобства рядом с этой колонкой вы также видите колонку d_ordCTU - порядковый номер Категории в списке категорий.
d_impCharacts - характеристики товара|услуги в вашей учетной системе (цвет, размер, объём, материал, вес, возраст, пол, и т. д.), от 10 до 2048 символов. Маркет постарается их автоматически адаптировать в свою систему сразу или чуть позже, если вы оформите их по нижеуказанным правилам. До этого момента, они также помогают покупателю найти это Предложение и выводятся в карточке. Это поле можно также заполнять в интерфейсе Маркетплейса.
Формат оформления:
|Параметр#значениеА;значениеБ@ед.измерения
Разделители:
- | (прямая черта) - разделитель Параметров
- # (решетка) - начало Значений (разделитель между ними и Параметром)
- ; (точка с запятой) - перечисление Значений. Можно указать диапазон непрерывных цифр в виде: |от..до..|
- @ (собачка) - начало ед.измерения (разделитель между ней и Значениями)
Пример:
- Цвет #черный;зеленый |Размер #38;39;44;45 |Размер #от 38 до 45 |Вместимость #от 3 до 8 @человек |Длина #4,3 @м3
Единица измерения - не обязательна.
d_impNamePhoto или
d_impLinkPhoto - названия фото или ссылки фото. Укажите в одном из этих полей для своего товара|услуги фотографии, которые нужно прикрепить к нему, в нужной последовательности через | (вертикальную черту). Если к товару нужно прикрепить фото с вашего компьютера/смартфона - укажите их названия в первом поле (d_impNamePhoto). Если нужно прикрепить фото из интернета - укажите ссылки на фото во втором поле (d_impLinkPhoto). При заполнении сразу обоих полей - будет обработано только второе (ссылки - d_impLinkPhoto).
Размеры этих полей - от 5 до 2048 символов.
Ваши фото должны быть в одном из допустимых форматов: PNG, JPG, JPEG.
- d_impLinkPhoto (ссылки на картинки): Маркет загрузит указанные для товара|услуги картинки из интернета и прикрепит к нему, в той же последовательности как они расположены в поле.
- d_impNamePhoto (названия файлов) - после загрузки Excel-файла вам откроется диалоговое окно компьютера/смартфона (стандартный Проводник), в нем вы укажете нужные файлы (если их общий размер менее 50 мб). Приготовьте папку с этими файлами заранее. Если этих файлов много или их размер больше - приготовьте архив с этими файлами (подробнее здесь). В открывшемся диалоговом окне выберите этот архив. Ваш архив может быть с вложенной структурой подпапок, но имейте ввиду - если внутри них будут совпадающие имена - Маркет возьмет только один из этих файлов, и привяжет его к указанным товарам|услугам. Чтобы избежать совпадающих имен - перед созданием архива скопируйте эти файлы в одну папку компьютера/смартфона - он предупредит вас, если попадется такое совпадение; или добавляйте в архив файлы из своих подпапок - “в архив без папок”.
Примечания:
Если файл уже загружался (есть в “Галерее Организации”) - загрузка файла будет проигнорирована, но фото к товару привяжется из Галереи.
К товару|услуге привязываются только то количество фото, которое предусмотрено вашим тарифным планом, если он исчерпан - привязка будет проигнорирована, с предупреждением в Отчете.
Вы можете поменять все имеющиеся фото, ранее прикрепленные к товару|услуге - для этого укажите в поле d_photoList спецкоманду _очистить_поле_ и Маркет уберет все имеющиеся фото у этого предложения, привяжет новые если они указаны в d_impLinkPhoto или d_impNamePhoto.
d_charactList и
d_photoList - справочные поля в файле Excel (при выгрузке ваших предложений из Маркета). В них показан список Характеристик и Фотографий для товара|услуги, которые указаны для него в Маркете (для фильтрации, показа Покупателям). Для поля d_photoList предусмотрена спецкоманда “очистить” для замены галереи (подробнее ниже в d_impNamePhoto).
d_url
- ссылка на страницу товара.
Можно использовать только ссылки на сайт, указанный в контактах фирмы.
Дополнительные справочные поля в файле Excel, при выгрузке ваших предложений из Маркета: развернуть
d_ordCTU - порядковый номер Категории вашего Прайса (в которой публикуется этот товар|услуга);
d_wtTU_txt - итоговый статус товара|услуги в Маркете (публикуется или нет, с учетом вашего Тарифа всех возможных ограничений);
d_vCommOnEdit и d_vCommOnPubl - комментарии, рекомендации по редактированию и публикуемости этого товара|услуги;
d_siCtuList - список единиц измерения, предусмотренный для Категории в данный момент
Для удобства поля в выгружаемом файле раскрашены: развернуть
- Красным с Фоном - обязательные поля, без которых загрузка файла в маркет будет отменена.
- Красным - поля, обязательные при создании нового товара|услуги
- Оранжевым - поля “логические”, участвующие в определении логики (обновлять или создавать Предложение), или в сборке итоговой информации для покупателя (например, поля Количество и Ожидание)
- Зеленым - обычные поля которые вы можете редактировать, как и указанные выше.
- Серым - поля “справочные”, для информации. Их редактирование бессмысленно. В отдельных случаях в них можно указывать спецкоманду (эти случаи и команды указаны в описании этих колонок).
