Комсомольск-на-Амуре


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

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

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

Пример JSON


{
    "firmID": "16763",
    "testMode": true,
    "isPartialImport": false,
    "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"
            ],
            "url": "https://company.com/products/123"
        }
    ]
}
          
Перед загрузкой проверьте ваш 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. isPartialImport
    тип: bool
    Режим частичной выгрузки данных. Если установлено значение false, считается, что база товаров импортируется полностью, поэтому товары, которые уже есть на маркете, но отсутствуют в данных импорта, снимаются с публикации. При значении true с такими товарами ничего не произойдет. Значение по умолчанию определяется настройкой "Товары, которых нет при импорте:" на странице импорта.
  5. 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 - ссылки)
url string ссылка на страницу товара. Можно использовать только ссылки на сайт, указанный в контактах фирмы.

Указание пустых значений 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, поэтому часть функций сайта будут недоступны или будут работать некорректно.