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

firmID
тип: int
Идентификатор фирмы в Маркете. Соответсвует странице tu.market/firm/firmID. Поле ОБЯЗАТЕЛЬНО для указания
strFromKA
тип: string
Произвольный текст с вашей дополнительной информацией. Будет сохранен в отчете об операции. Используется только в json запросах. При загрузке .json файлов используется значение, которое передается в запросе с прикрепленным файлом
testMode
тип: bool
Режим проверки. Если установлено значение true, данные не будут изменены. Используется только в json запросах. При загрузке .json файлов используется значение, которое передается в запросе с прикрепленным файлом
isPartialImport
тип: bool
Режим частичной выгрузки данных. Если установлено значение false, считается, что база товаров импортируется полностью, поэтому товары, которые уже есть на маркете, но отсутствуют в данных импорта, снимаются с публикации. При значении true с такими товарами ничего не произойдет. Значение по умолчанию: true.
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

Пустые поля обрабатываются по следующим правилам:

Если поле опущено - оно игнорируется
Если поле имеет значение null - оно игнорируется
Если значением поля является пустая строка - поле очищается

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

См. в «Инструкции для 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

Инструкции API развернуть