Создание фида каталога по шаблону
Фид для интеграции можно создать с помощью экспорта каталога по шаблону. Для этого небходимо создать профиль экспорта:
- Перейдите на страницу "Настройки"
- Перейдите на вкладку "Экспорт"
- Нажмите на кнопку "+"
- Укажите название профиля экспорта, выберите профиль ценообразования, по которому будет подготовлен фид, и выберите формат "Каталог по шаблону"
- Нажмите "Сохранить"
После сохранения профиля экспорта станет доступна настройка шаблона интеграции.
Редактирование существующего профиля:
- Нажмите напротив этого профиля на значок карандашика.
- Отредактируйте название или добавьте/удалите профиль ценообразования.
- Нажмите кнопку "Сохранить".
Удаление существующего профиля:
- Нажмите напротив этого профиля на значок корзинки.
- Подтвердите удаление.
Настройка шаблона интеграции:
- Перейдите на вкладку "Настройка шаблона".
- Выберите тип выгрузки параметров.
- Выберите тип валидации (при необходимости).
- Выберите шаблон (нажамите кнопку "Шаблоны") или напишите свой.
- Нажмите кнопку "Сохранить".
Для написания шаблона мы используем язык Scriban. Scriban - это быстрый, мощный, безопасный и легкий язык сценариев. Подробнее с языком можно ознакимиться здесь. Проверить корректность работы шаблона можно нажав на кнопку "Тест". После этого появится окно "Результаты", в котором, при корректнонаписаном шаблоне, появится результат (как будет выглядеть фид).
Пример модели данных:
{
"Categories": [
{
"Id": 5548,
"SingularName": null,
"Name": "Сад и дача",
"ParentId": null
},
{
"Id": 5549,
"SingularName": null,
"Name": "Отдых/досуг на даче",
"ParentId": 5548
},
{
"Id": 5550,
"SingularName": null,
"Name": "Бассейны",
"ParentId": 5549
},
{
"Id": 2312,
"SingularName": "Надувной бассейн",
"Name": "Надувные бассейны",
"ParentId": 5550
},
{
"Id": 5006,
"SingularName": "Каркасный бассейн",
"Name": "Каркасные бассейны",
"ParentId": 5550
},
{
"Id": 5254,
"SingularName": null,
"Name": "Спорт и отдых",
"ParentId": null
},
{
"Id": 5255,
"SingularName": null,
"Name": "Велосипеды, аксессуары, запчасти",
"ParentId": 5254
},
{
"Id": 56,
"SingularName": "Велосипед",
"Name": "Велосипеды",
"ParentId": 5255
},
{
"Id": 83,
"SingularName": "Батут",
"Name": "Батуты",
"ParentId": 5549
},
{
"Id": 5741,
"SingularName": null,
"Name": "Надувная мебель",
"ParentId": 5254
},
{
"Id": 1964,
"SingularName": "Надувное кресло",
"Name": "Надувные кресла",
"ParentId": 5741
},
{
"Id": 1914,
"SingularName": "Надувной диван-кровать",
"Name": "Надувные диваны",
"ParentId": 5741
},
{
"Id": 5334,
"SingularName": "Надувной матрас",
"Name": "Надувные матрасы для улицы",
"ParentId": 5741
},
{
"Id": 1893,
"SingularName": "Надувная кровать",
"Name": "Надувные кровати",
"ParentId": 5741
},
{
"Id": 1895,
"SingularName": null,
"Name": "Насосы для надувных изделий",
"ParentId": 5741
},
{
"Id": 5972,
"SingularName": "Электрический насос",
"Name": "Электрические насосы для надувных изделий",
"ParentId": 1895
},
{
"Id": 1894,
"SingularName": "Надувной матрас",
"Name": "Надувные матрасы для дома",
"ParentId": 5741
},
{
"Id": 1963,
"SingularName": "Надувная подушка",
"Name": "Надувные подушки",
"ParentId": 5741
},
{
"Id": 5347,
"SingularName": null,
"Name": "Пляжный отдых",
"ParentId": 5254
},
{
"Id": 3131,
"SingularName": "Надувной плот",
"Name": "Надувные плотики",
"ParentId": 5347
},
{
"Id": 202,
"SingularName": null,
"Name": "Садовая мебель",
"ParentId": 5549
},
{
"Id": 103,
"SingularName": "Садовые качели",
"Name": "Садовые качели",
"ParentId": 5549
},
{
"Id": 5558,
"SingularName": null,
"Name": "Мангалы, грили, барбекю",
"ParentId": 5549
},
{
"Id": 3204,
"SingularName": "Садовое барбекю",
"Name": "Садовые барбекю",
"ParentId": 5558
},
{
"Id": 5326,
"SingularName": null,
"Name": "Туризм и рыбалка",
"ParentId": 5254
},
{
"Id": 196,
"SingularName": "Палатка",
"Name": "Палатки",
"ParentId": 5326
},
{
"Id": 422,
"SingularName": "Гамак",
"Name": "Гамаки",
"ParentId": 5549
},
{
"Id": 3130,
"SingularName": "Надувной жилет",
"Name": "Надувные жилеты",
"ParentId": 5347
},
{
"Id": 3760,
"SingularName": "Надувные водные ходунки",
"Name": "Надувные водные ходунки",
"ParentId": 5347
},
{
"Id": 3129,
"SingularName": "Надувные нарукавники",
"Name": "Надувные нарукавники",
"ParentId": 5347
},
{
"Id": 3132,
"SingularName": "Надувной мяч",
"Name": "Надувные мячи",
"ParentId": 5347
},
{
"Id": 3761,
"SingularName": "Круг для плавания",
"Name": "Круги для плавания",
"ParentId": 5347
},
{
"Id": 404,
"SingularName": "Туристический коврик",
"Name": "Туристические коврики",
"ParentId": 5326
},
{
"Id": 5551,
"SingularName": null,
"Name": "Аксессуары для бассейнов",
"ParentId": 5549
},
{
"Id": 3782,
"SingularName": "Ручка телескопическая",
"Name": "Ручки телескопические",
"ParentId": 5551
},
{
"Id": 3783,
"SingularName": "Сачок для чистки",
"Name": "Сачки для чистки бассейнов",
"ParentId": 5551
},
{
"Id": 3821,
"SingularName": "Песок для фильтра бассейна",
"Name": "Пески для фильтров бассейнов",
"ParentId": 5551
},
{
"Id": 3852,
"SingularName": "Подстилка-подложка для бассейнов",
"Name": "Подстилки-подложки для бассейнов",
"ParentId": 5551
},
{
"Id": 3780,
"SingularName": "Ремкомплект для надувных изделий",
"Name": "Ремкомплекты для надувных изделий",
"ParentId": 5551
},
{
"Id": 5553,
"SingularName": null,
"Name": "Аксессуары для батутов",
"ParentId": 5549
},
{
"Id": 2819,
"SingularName": "Защитная сетка для батута",
"Name": "Защитные сетки для батутов",
"ParentId": 5553
},
{
"Id": 2580,
"SingularName": "Чехол для батута",
"Name": "Чехлы для батутов",
"ParentId": 5553
},
{
"Id": 5500,
"SingularName": null,
"Name": "Детские товары",
"ParentId": null
},
{
"Id": 5737,
"SingularName": null,
"Name": "Активные игры",
"ParentId": 5500
},
{
"Id": 3882,
"SingularName": "Игровой центр детский",
"Name": "Игровые центры детские",
"ParentId": 5737
},
{
"Id": 5341,
"SingularName": null,
"Name": "Термоемкости",
"ParentId": 5326
},
{
"Id": 3393,
"SingularName": "Термосумка",
"Name": "Термосумки",
"ParentId": 5341
},
{
"Id": 1803,
"SingularName": "Аккумулятор холода",
"Name": "Аккумуляторы холода",
"ParentId": 5341
},
{
"Id": 5342,
"SingularName": "Сумка-холодильник",
"Name": "Сумки-холодильники",
"ParentId": 5341
}
],
"Products": [
{
"ModelId": 21942,
"Model": "Easy Set 183x51",
"Category": "Надувные бассейны",
"CategoryId": 2312,
"Vendor": "Intex",
"VendorId": 526,
"Article": "54402/28101",
"Color": "",
"BarCodes": [
"6941057400006"
],
"OzonSku": 765430756,
"OzonFboSku": 1000123456,
"OzonFbsSku": 1000123457,
"OzonProductId": 440761234,
"OzonOfferId": "NV-TK1234",
"WbImtId": 189510123,
"WbNmId": 209690123,
"WbSku": "4640001123456",
"WbVendorCode": "HB-CE000A",
"ExternalId": "8e6558a5-c330-11e4-80c0-3085a918de0b",
"Description": "Конструкция: надувной, Назначение: детский, Объём: 886 л, Форма: круглый",
"Pictures": [
"https://catalogapp.b-cdn.net/local/images/12/72/89/09/55f7d8a5-df3f-4997-9937-a02a036db361.jpg",
"https://catalogapp.b-cdn.net/local/images/03/50/17/16/7d2519d9-8851-40f0-86c2-342f7c80c554.jpg",
"https://catalogapp.b-cdn.net/local/images/04/03/83/53/a9c7ff05-81f6-4a06-b4b9-f873d9cf99ba.jpg"
],
"Parameters": [
{
"Name": "Производитель",
"Value": "Intex"
},
{
"Name": "Конструкция",
"Value": "надувной"
},
{
"Name": "Джакузи",
"Value": "Нет"
},
{
"Name": "Форма",
"Value": "круглый"
},
{
"Name": "Объём",
"Value": "886.00",
"Unit": "л"
},
{
"Name": "Длина",
"Value": "183.00",
"Unit": "см"
},
{
"Name": "Высота",
"Value": "51.00",
"Unit": "см"
},
{
"Name": "Распылитель (фонтан)",
"Value": "нет"
},
{
"Name": "Генератор пузырьков",
"Value": "Нет"
},
{
"Name": "Скиммер (устройство сбора мусора)",
"Value": "нет"
},
{
"Name": "Подстилка",
"Value": "Нет"
},
{
"Name": "Тент-чехол",
"Value": "Нет"
},
{
"Name": "Ширина",
"Value": "183.00",
"Unit": "см"
},
{
"Name": "Изготовитель",
"Value": "Intex Dervelopment Co Ltd 9/F., Dah Sing Financial Centre,108 Glouceste Road, Wanchai, China."
},
{
"Name": "Импортер",
"Value": "АзияИнвест ЧТПУП, 220073, Минск, ул. Ольшевского, оф. 604А, Сандэйз точка бай ЧТПУП 220073, г. Минск, ул. Ольшевского, 22, комната 604 ><*\"'/\\&$?"
},
{
"Name": "Прозрачные стенки",
"Value": "Нет"
},
{
"Name": "Комплект для чистки бассейна",
"Value": "Нет"
},
{
"Name": "Сетка для волейбола",
"Value": "Нет"
},
{
"Name": "Возраст детей",
"Value": "3+"
},
{
"Name": "Время установки",
"Value": "0.17",
"Unit": "ч"
},
{
"Name": "Цвет",
"Value": "синий"
},
{
"Name": "Вес",
"Value": "183"
},
{
"Name": "Фильтр-насос",
"Value": "нет"
},
{
"Name": "Назначение",
"Value": "детский"
},
{
"Name": "Дополнительные опции",
"Value": "сетка для волейбола"
}
]
},
{
"ModelId": 22067,
"Model": "Детский 140x11 с фонтаном",
"Category": "Надувные бассейны",
"CategoryId": 2312,
"Vendor": "Intex",
"VendorId": 526,
"Article": "57126",
"Color": "",
"BarCodes": [
"6941057403120"
],
"ExternalId": "9d9f5b7e-0ed5-11e7-8edf-00155d640707",
"Description": "Конструкция: надувной, Назначение: детский, Объём: 115 л, Форма: прямоугольный",
"Pictures": [
"https://catalogapp.b-cdn.net/local/images/11/17/99/91/77f8dd64-9c8b-4eae-9d7a-76a22025d720.jpg",
"https://catalogapp.b-cdn.net/local/images/04/03/82/91/21409749-182e-4c88-8c27-483c8b3a39e3.jpg",
"https://catalogapp.b-cdn.net/local/images/10/43/57/57/daf9c19a-bc38-4e71-a1ea-3876cdb399d5.jpg"
],
"Parameters": [
{
"Name": "Производитель",
"Value": "Intex"
},
{
"Name": "Конструкция",
"Value": "надувной"
},
{
"Name": "Джакузи",
"Value": "Нет"
},
{
"Name": "Форма",
"Value": "прямоугольный"
},
{
"Name": "Объём",
"Value": "115.00",
"Unit": "л"
},
{
"Name": "Длина",
"Value": "140.00",
"Unit": "см"
},
{
"Name": "Высота",
"Value": "11.00",
"Unit": "см"
},
{
"Name": "Распылитель (фонтан)",
"Value": "да"
},
{
"Name": "Генератор пузырьков",
"Value": "Нет"
},
{
"Name": "Скиммер (устройство сбора мусора)",
"Value": "нет"
},
{
"Name": "Подстилка",
"Value": "Нет"
},
{
"Name": "Тент-чехол",
"Value": "Нет"
},
{
"Name": "Ширина",
"Value": "140.00",
"Unit": "см"
},
{
"Name": "Сливной клапан",
"Value": "Нет"
},
{
"Name": "Прозрачные стенки",
"Value": "Да"
},
{
"Name": "Комплект для чистки бассейна",
"Value": "Нет"
},
{
"Name": "Сетка для волейбола",
"Value": "Нет"
},
{
"Name": "Цвет",
"Value": "голубой"
},
{
"Name": "Возраст детей",
"Value": "1+"
},
{
"Name": "Фильтр-насос",
"Value": "нет"
},
{
"Name": "Назначение",
"Value": "детский"
},
{
"Name": "Дополнительные опции",
"Value": "распылитель (фонтан)"
}
]
},
{
"ModelId": 231199,
"Model": "26710NP 366x76",
"Category": "Каркасные бассейны",
"CategoryId": 5006,
"Vendor": "Intex",
"VendorId": 526,
"Article": "",
"Color": "",
"BarCodes": [
""
],
"ExternalId": "5084182b-f0d7-48ec-a25e-ba8813d2c337",
"Description": "Конструкция: каркасный, Назначение: семейный, Объём: 6503 л, Форма: круглый",
"Pictures": [
"https://catalogapp.b-cdn.net/local/images/07/30/16/67/47d005a1-0d7b-4939-813b-181873fc0190.jpg",
"https://catalogapp.b-cdn.net/local/images/11/23/01/66/ef3819aa-96b7-4eff-baff-c4f7c471169c.jpg",
"https://catalogapp.b-cdn.net/local/images/04/03/82/22/21afd167-0d75-4d5b-9fc4-478ac197163b.jpg"
],
"Parameters": [
{
"Name": "Прозрачные стенки",
"Value": "Нет"
},
{
"Name": "Комплект для чистки бассейна",
"Value": "Нет"
},
{
"Name": "Возраст детей",
"Value": "6+"
},
{
"Name": "Цвет",
"Value": "серый"
},
{
"Name": "Производитель",
"Value": "Intex"
},
{
"Name": "Конструкция",
"Value": "каркасный"
},
{
"Name": "Джакузи",
"Value": "Нет"
},
{
"Name": "Форма",
"Value": "круглый"
},
{
"Name": "Объём",
"Value": "6503.00",
"Unit": "л"
},
{
"Name": "Длина",
"Value": "366.00",
"Unit": "см"
},
{
"Name": "Высота",
"Value": "76.00",
"Unit": "см"
},
{
"Name": "Сливной клапан",
"Value": "Да"
},
{
"Name": "Распылитель (фонтан)",
"Value": "нет"
},
{
"Name": "Генератор пузырьков",
"Value": "Нет"
},
{
"Name": "Скиммер (устройство сбора мусора)",
"Value": "нет"
},
{
"Name": "Подстилка",
"Value": "Нет"
},
{
"Name": "Тент-чехол",
"Value": "Нет"
},
{
"Name": "Ширина",
"Value": "366.00",
"Unit": "см"
},
{
"Name": "Время установки",
"Value": "30.00",
"Unit": "мин"
},
{
"Name": "Фильтр-насос",
"Value": "нет"
},
{
"Name": "Сетка для волейбола",
"Value": "Нет"
},
{
"Name": "Дополнительные опции",
"Value": "сливной клапан"
},
{
"Name": "Назначение",
"Value": "семейный"
}
]
},
{
"ModelId": 248344,
"Model": "Надувной 168x38",
"Category": "Надувные бассейны",
"CategoryId": 2312,
"Vendor": "Intex",
"VendorId": 526,
"Article": "58449",
"Color": "",
"BarCodes": [
"6941057454498"
],
"ExternalId": "0a973d6b-9cf0-4ca8-b2e6-0074541fd850",
"Description": "Картридж\n HP CLJ 653A Yellow (CF322A)\nбув спеціально розроблений для найточнішої сумісності з Вашим пристроєм і максимально відповідає високим стандартам. Він дозволяє використовувати весь потенціал Вашого лазерного принтера, забезпечуючи отримання відбитків професійної якості, а також максимальну продуктивність Вашої оргтехніки. Картридж\n HP CLJ 653A Yellow (CF322A)\nнадасть Вам виключно високу якість друку, рівномірне покриття носія і насичені кольори друку. Фахівці компанії розробили цей сумісний картридж у відповідності зі світовими стандартами якості та надійності - це кращий за своїми характеристиками картридж. Упаковка картриджа відрізняється не тільки оригінальним дизайном, але і надійністю і зручністю. Він має ресурс друку - 16500 стор при 5%-ному заповненні аркуша формату А4.°С®<>\"'&•™",
"Pictures": [
"https://catalogapp.b-cdn.net/local/images/11/23/06/82/8a94bddd-2009-4b05-8b88-0e418ae5f7ef.jpg",
"https://catalogapp.b-cdn.net/local/images/01/32/34/53/6c6132e1-a0a8-4956-8a54-fa0251e35773.jpg",
"https://catalogapp.b-cdn.net/local/images/11/18/02/17/2f389eae-95a9-4779-99ad-bc8fb371b43e.jpg",
"https://catalogapp.b-cdn.net/local/images/11/18/02/17/ec1f69dc-37c4-49f4-9280-9e90d4925b6e.jpg"
],
"Parameters": [
{
"Name": "Производитель",
"Value": "Intex Dervelopment Co Ltd 9/F., Dah Sing Financial Centre,108 Glouceste Road, Wanchai, China."
},
{
"Name": "Конструкция",
"Value": "надувной"
},
{
"Name": "Форма",
"Value": "круглый"
},
{
"Name": "Объём",
"Value": "481.00",
"Unit": "л"
},
{
"Name": "Джакузи",
"Value": "Нет"
},
{
"Name": "Длина",
"Value": "168.00",
"Unit": "см"
},
{
"Name": "Высота",
"Value": "41.00",
"Unit": "см"
},
{
"Name": "Распылитель (фонтан)",
"Value": "нет"
},
{
"Name": "Генератор пузырьков",
"Value": "Нет"
},
{
"Name": "Скиммер (устройство сбора мусора)",
"Value": "нет"
},
{
"Name": "Подстилка",
"Value": "Нет"
},
{
"Name": "Тент-чехол",
"Value": "Нет"
},
{
"Name": "Прозрачные стенки",
"Value": "Нет"
},
{
"Name": "Комплект для чистки бассейна",
"Value": "Нет"
},
{
"Name": "Сетка для волейбола",
"Value": "Нет"
},
{
"Name": "Сливной клапан",
"Value": "Нет"
},
{
"Name": "Возраст детей",
"Value": "3+"
},
{
"Name": "Цвет",
"Value": "разноцветный"
},
{
"Name": "Горка",
"Value": "Нет"
},
{
"Name": "Вес",
"Value": "3"
},
{
"Name": "Фильтр-насос",
"Value": "нет"
},
{
"Name": "Назначение",
"Value": "детский"
},
{
"Name": "Дополнительные опции",
"Value": "сливной клапан"
}
]
},
{
"ModelId": 612923,
"Model": "Fast Set 10' x 30\"/305х76см",
"Category": "Надувные бассейны",
"CategoryId": 2312,
"Vendor": "Bestway",
"VendorId": 525,
"Article": "57266",
"Color": "",
"BarCodes": [
"6942138949933"
],
"ExternalId": "6f25f580-0af8-4470-82b5-7cd11f12537c",
"Description": "Конструкция: надувной, Назначение: семейный, Объём: 3638 л, Форма: круглый",
"Pictures": [
"https://catalogapp.b-cdn.net/local/images/04/85/35/62/553709fa-5605-40a3-9b69-4c71b02600d8.jpg",
"https://catalogapp.b-cdn.net/local/images/04/85/35/62/71789081-f5ed-4f3a-8d10-916b718717ea.jpg",
"https://catalogapp.b-cdn.net/local/images/04/03/81/62/b136633b-f70b-408f-80c7-2c812e766377.jpg",
"https://catalogapp.b-cdn.net/local/images/04/03/81/62/a5e8665f-2d12-4dbc-a9b0-94c720913d82.jpg"
],
"Parameters": [
{
"Name": "Конструкция",
"Value": "надувной"
},
{
"Name": "Джакузи",
"Value": "Нет"
},
{
"Name": "Форма",
"Value": "круглый"
},
{
"Name": "Объём",
"Value": "3638.00",
"Unit": "л"
},
{
"Name": "Длина",
"Value": "305.00",
"Unit": "см"
},
{
"Name": "Высота",
"Value": "76.00",
"Unit": "см"
},
{
"Name": "Распылитель (фонтан)",
"Value": "нет"
},
{
"Name": "Генератор пузырьков",
"Value": "Нет"
},
{
"Name": "Скиммер (устройство сбора мусора)",
"Value": "нет"
},
{
"Name": "Подстилка",
"Value": "Нет"
},
{
"Name": "Тент-чехол",
"Value": "Нет"
},
{
"Name": "Ширина",
"Value": "305.00",
"Unit": "см"
},
{
"Name": "Сливной клапан",
"Value": "Да"
},
{
"Name": "Прозрачные стенки",
"Value": "Нет"
},
{
"Name": "Комплект для чистки бассейна",
"Value": "Нет"
},
{
"Name": "Сетка для волейбола",
"Value": "Нет"
},
{
"Name": "Тип фильтр-насоса",
"Value": "картриджный"
},
{
"Name": "Цвет",
"Value": "синий"
},
{
"Name": "Фильтр-насос",
"Value": "нет"
},
{
"Name": "Возраст детей",
"Value": "3+"
},
{
"Name": "Назначение",
"Value": "семейный"
}
]
}
]
}
Добавление условий в шаблон
Условия помогают в выборе товаров, соответствующих определенным критериям. Для добавления условий удобно пользоваться функциями. Функции небходимо определить до шаблона и вызвать внутри шаблона. Условий может быть несколько (при этом они должны называться по разному), несколько условий можно скомбинировать в одно, a также добавлять свои условия. Проверить корректность условий можно здесь.
Для выполнения экспорта:
- Перейдите на страницу "Задачи".
- Перейдите на вкладку "Экспорт".
- Выберите необходимый профиль экспорта.
- Нажмите кнопку "Запустить".
Статус задачи, а также историю последних выполненых экспортов можно посмотреть в списке "Последние экспорты". Результатом выполнения задачи является файл в формате .xml, который можно скачать нажав напротив нужного экспорта "Скачать". В настройках шаблона можно посмотеть ссылку на этот файл.