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

Описание формата 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

  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 базовая цена
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, которые обеспечивают правильную работу сайта...

Подробнее

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

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