Благовещенск
Аэропорт, Белогорье, Верхнеблаговещенское...


Описание формата JSON

Данный формат используется как для JSON запросов к API, так и для .json файла, в соответствии с разделом «Варианты импорта» TU.Market API.
Набор полей для файла Excel идентичен, с указанными исключениями, ссылка внизу.

Об отправке JSON запросов и Авторизации смотрите в документации API.

Пример JSON

{
 "firmID": "16763",
 "testMode": true,
 "offers": [
   {
     "ctuID": "473",
     "crmCtuID": "10",
     "crmCtuName": "Мебель",
     "crmID": "t0002",
     "idTU": "17110",
     "nameTU": "Офисный стул",
     "annotationShort": "Офисный стул, цвет серый",
     "annotation": "Офисный стул, цвет серый",
     "prefPrice": "от",
     "priceBase": "500",
     "price2": "400",
     "si": "шт",
     "priceDesc": "примечание к цене",
     "dopSiUse": "после примечания",
     "dopPrice": "50",
     "dopSi": "шт",
     "quantity": "1",
     "wait": "0",
     "status": "(-) заблокировать [КА]",
     "ordInCTU": "11",
     "characteristics": [
        {
          "name": "Высота",
          "unit": "m",
          "values": [
              "1"
              ] 
         }
     ],
     "namePhoto": [
          "photo1.jpg",
          "photo2.png"
     ],
     "linkPhoto": [
          "https://company.com/photo1.jpg",
          "https://company.com/photo2.png"
     ]
   }
 ]
}
Перед загрузкой проверьте ваш json на корректность структуры и данных с помощью парсера (своего, или любого бесплатного онлайн, например https://jsonformatter.org/json-parser)

Описание полей JSON

  1. firmID
    тип: int
    Идентификатор фирмы в Маркете. Соответсвует странице tu.market/firm/firmID. Поле ОБЯЗАТЕЛЬНО для указания
  2. strFromKA
    тип: string
    Произвольный текст с вашей дополнительной информацией. Будет сохранен в отчете об операции. Используется только в json запросах. При загрузке .json файлов используется значение, которое передается в запросе с прикрепленным файлом
  3. testMode
    тип: bool
    Режим проверки. Если установлено значение true, данные не будут изменены. Используется только в json запросах. При загрузке .json файлов используется значение, которое передается в запросе с прикрепленным файлом
  4. offers
    Список товаров
Секция offers:
Поле Тип Значение
ctuID int идентификатор “Категории Маркета”
crmCtuID string идентификатор Категории в учетной программе организации
crmCtuName string Названия категории товара|услуги в учетной программе организации, если не указано crmCtuID
idTU int идентификатор товара|услуги в Маркете
crmID string артикул, уникальный идентификатор товара|услуги в учетной программе организации. ОБЯЗАТЕЛЕН.
nameTU string название товара|услуги
annotationShort string краткая аннотация
annotation string большая аннотация
priceBase float базовая цена
  • при priceBase =0 и неуказанном quantity (Количество) — status (Статус) автоматически изменится на “Заблокировано”. При очередном обновлении, если Цена для товара будет указана — Статус изменится на “Публиковать”. При других условиях — значение Цена=0 будет проигнорирована с фиксацией ошибки в Отчете.
price2 float цена “со скидкой”
prefPrice string префикс цены
si string единица измерения 
priceDesc string примечание к цене
dopPrice float альтернативная цена
dopSi string альтернативная единица измерения
dopSiUse string где показывать покупателю Альтернативную цену и ее Единицу измерения
quantity int количество “в наличии”
wait int количество “дней ожидания”
status string Статус. Значения: Публиковать или Заблокировать, или Удалить
ordInCTU int важность в категории (пп.№)
сharacteristics массив объектов характеристики товара|услуги в вашей учетной системе. Поля характеристик:
  • Name; тип: string; Название характеристики
  • Unit; тип: string; Единица измерения характеристики. Необязательный параметр.
  • Values; тип: массив; Список возможных значений характеристики.
Если значение одно, список содержит одно значение.
Если нужно указать диапазон чисел, указывается одно значение в виде строки формата “от X до Y”
namePhoto
или
linkPhoto
массив строк имена файлов фото
или
ссылки на фото
При заполнении сразу обоих полей - будет обработано только второе (linkPhoto - ссылки)

Указание пустых значений JSON

Пустые поля обрабатываются по следующим правилам:
  1. Если поле опущено - оно игнорируется
  2. Если поле имеет значение null - оно игнорируется
  3. Если значением поля является пустая строка - поле очищается

Детальное описание значений и ограничений полей

См. в «Инструкции для Excel» - раздел список колонок

Обязательные поля

Указание crmID обязательно

Обновление предложения происходит после его идентификации по crmID:
  • Обновляются значения переданных полей, если они не противоречат ограничениям (ссылка на описание полей и ограничений выше)
  • Обновление (смена) Категории происходит при наличии сопоставленной категории маркета
  • price2 допускается только вместе с priceBase, иначе скидка аннулируется
Создание предложения
  • Происходит при отсутствии crmID в Прайсе организации,
  • Минимальный набор полей для создания: crmID, nameTU, priceBase, и категория заданная в любом из 3 полей (по важности): ctuID, crmCtuID, или crmCtuName
Для успешного создания новых товаров|услуг или изменения категории у существующих - следует заранее выполнить Сопоставление категорий (подробнее).

Excel (XLSX)

Отличия при использовании Excel в API, в сравнении с json и ручной загрузкой файла Excel:
  • Названия всех колонок отличаются наличие префикса d_, как указано в списке колонок (ссылка выше)
  • Для колонки Характеристики и Фото:
    • Разделители массива (отличаются): применяются указанные в описании колонки (ссылка выше)
    • Названия колонок (отличаются), называются: d_impCharacts, d_impNamePhoto, d_impLinkPhoto
  • Колонка d_firmID обязательна для каждой строки товара|услуги в файле
  • Используется только одна спецкоманда: _очистить_поле_
  • Тестирование файла Excel возможно при принудительной загрузке в интерфейсе, включением переключателя «только отчет» (см.).
    "testMode": true - для Excel в API не используется

Если вы ведете учет в Excel - инструкция для Excel

Продолжая использовать наш сайт, вы даете согласие на обработку файлов cookie, которые обеспечивают правильную работу сайта...

Подробнее

Временно не доступно: функционал дорабатывается

Наличие и Цену - пожалуйста, уточните у Продавца

False

У Вашего браузера отключены Cookies, поэтому часть функций сайта будут недоступны или будут работать некорректно.