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

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

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

Если поле опущено - оно игнорируется
Если поле имеет значение 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 развернуть