Для магазинов доступен функционал автоматической загрузки каталога одежды.
Чтобы начать пользоваться данным функционалом необходимо:
Пройти верификацию аккаунта как магазин
как пройти верификацию магазина.
Предоставить на support@belt-app.com ссылку на доступ к каталогу.
Функция работы с автозагрузкой каталога через сервис, а так же расширенная аналитика процесса автозагрузки будут представлены позже.
Автозагрузка работает в режиме добавления элементов одежды и в режиме замещения данных для каждого элемента одежды.
Если в аккаунте уже имеются какие-либо элементы одежды, то элементы одежды, полученные путем автозагрузки, будут добавляться к существующим элементам одежды.
Если в процессе автозагрузки будет выявлен элемент одежды, который уже имеется в аккаунте, то все данные этого элемента одежды будут замещены теми данными, которые предоставлены из каталога автозагрузки (только в случае если для элемента одежды был указан Артикул).
Например, если для элемента одежды были вручную (через сервис) загружены фото и добавлено описание, то в случае, если данный элемент одежды будет встречен в каталоге в процессе автозагрузки, фото и описание будут замещены тем, что представлено в каталоге автозагрузки (только в случае если для элемента одежды был указан Артикул).
Если в каталоге окажутся изображения, ссылки на которые уже ранее присутствовали в автозагрузке, то изображения обновлены не будут!
Чтобы произошло обновление изображения необходимо чтобы у него изменилась ссылка (например могут быть добавлены дополнительные GET-параметры), в противном случае изображение будет считаться идентичным ранее загруженному и будет пропущено при автозагрузке (с сохранением уже загруженного изображения).
Дополнительные режимы автозагрузки будут представлены позже.
Запросы на получение данных каталога и фото осуществляются со следующих IP адресов:
Чтобы исключить возможность ограничений со стороны хостинга/провайдера/WAF магазина - необходимо добавить данные адреса в исключение правил блокировки массовых запросов.
Каталог одежды может быть предоставлен в нескольких форматах. Однако вне зависимости от формата самого каталога, доступ по ссылке должен удовлетворять следующим требованиям:
Каталог должен быть размещен в сети Интернет и доступен по протоколу HTTP по прямой ссылке, обязательно с использованием шифрования HTTPS.
Пример ссылки: https://mystore.com/autoload/catalog.json
Если доступ к каталогу осуществляется с помощью Basic access authentication - сообщите об этом на support@belt-app.com.
Каталог должен представлять собой единый файл в одном из следующих форматов:
И иметь кодировку UTF-8.
Если каталог разбит на несколько файлов - сообщите об этом на support@belt-app.com
При запросе данных по ссылке ожидание ответа от сервера составляет 10 секунд.
Если запрос длится более 10 секунд - происходит сброс попытки соединения.
Максимальный размер файла каталога составляет 150 MB (150 мегабайт).
Если файл каталога большего размера - сообщите об этом на support@belt-app.com
При запросе данных по ссылке ответ должен содержать заголовок Content-Type (HTTP Header) равный:
При запросе данных по ссылке HTTP-статус ответа должен быть равен коду 200.
Любой другой код ответа (например 301) будет считаться недействительным, и произойдет сброс попытки соединения.
Каталог может быть предоставлен в сжатом виде в формате файла GZIP. В таком случае файл архива должен соответствовать следующим требованиям:
Фото должны быть размещены в сети Интернет и доступны по протоколу HTTP по прямой ссылке, обязательно с использованием шифрования HTTPS.
Пример ссылки: https://a.lmcdn.ru/img600x866/R/T/RTLACZ401201_21882429_1_v1_2x.jpg
Если доступ к фото осуществляется с помощью Basic access authentication - сообщите об этом на support@belt-app.com.
Фото должны быть в одном из следующих форматов:
Максимальный размер файла фото составляет 15 MB (15 мегабайт).
При запросе фото по ссылке ожидание ответа от сервера составляет 10 секунд.
Если запрос длится более 10 секунд - происходит сброс попытки соединения.
При запросе фото по ссылке HTTP-статус ответ должен быть равен коду 200.
Любой другой код ответа (например 301) будет считаться недействительным и произойдет сброс попытки соединения.
Вне зависимости от оригинального разрешения происходит обрезка фото до разрешения 1080х1920 (9:16).
Если разрешение фото меньше или больше по любой из сторон, то происходит обрезка до установки соотношения сторон 9:16.
Каталог может быть представлен в одном из следующих форматов:
Собственный формат BELT.
JSON:
{
"items": [
{
"materials": [
{
"material": "fa7e4679-73cf-4894-8eab-8c1d1b796795",
"percent": 70
},
{
"material": "f80a4a2f-1481-4638-829f-055ac032e27c",
"percent": 20
},
{
"material": "17cf7bd6-aaeb-456e-b5d2-01c627386625",
"percent": 5
},
{
"material": "b37cdf5e-0633-4fc4-b682-e8dc2111092d",
"percent": 5
}
],
"colors": [
{
"color": "4",
"sort": 0
},
{
"color": "1",
"sort": 1
}
],
"categories": [
{
"category": "125481f9-8d58-4e05-808d-0c9d68f09959"
},
{
"category": "a1b146c3-2c9e-4010-917a-148dc7b4a33b"
}
],
"fabrics": [
{
"fabric": "30c997b7-b4e3-4e7f-bfff-42f63d37d35f"
},
{
"fabric": "5159aa0e-f17c-4a8c-9594-4cb9bfe47b9e"
}
],
"name": {
"rus": "Брюки",
"eng": "Trousers"
},
"description": {
"rus": "Лучшие брюки на свете!",
"eng": "The best trousers ever!"
},
"catalog": false,
"stores": [
{
"store": "230fedd6-ce97-4346-bf61-0038b793c188",
"autoloadID": "2341234123",
"vendorCode": "mp002xw0bwu0",
"productURL": "https://www.lamoda.ru/p/mp002xw0bwu0/clothes-loverepublic-bryuki/"
}
],
"images": [
{
"image": "https://media.belt-app.com/2022/03/16/02/10/db285590-04c2-416d-a621-70278c7904e0.png",
"sort": 0
},
{
"image": "https://media.belt-app.com/2022/03/16/02/10/58655b40-8550-45b3-ab96-2beb708d02a4.png",
"sort": 1
},
{
"image": "https://media.belt-app.com/2022/03/16/02/10/f3f0e36b-7ddb-4531-96ea-4f2325035eb8.png",
"sort": 2
}
],
"genderClothes": "1"
}
]
}
XML:
<root>
<items>
<materials>
<material>
fa7e4679-73cf-4894-8eab-8c1d1b796795
</material>
<percent>
60
</percent>
</materials>
<materials>
<material>
f80a4a2f-1481-4638-829f-055ac032e27c
</material>
<percent>
30
</percent>
</materials>
<materials>
<material>
17cf7bd6-aaeb-456e-b5d2-01c627386625
</material>
<percent>
5
</percent>
</materials>
<materials>
<material>
b37cdf5e-0633-4fc4-b682-e8dc2111092d
</material>
<percent>
5
</percent>
</materials>
<colors>
<color>
4
</color>
<sort>
0
</sort>
</colors>
<colors>
<color>
1
</color>
<sort>
1
</sort>
</colors>
<fabrics>
<fabric>
30c997b7-b4e3-4e7f-bfff-42f63d37d35f
</fabric>
</fabrics>
<fabrics>
<fabric>
5159aa0e-f17c-4a8c-9594-4cb9bfe47b9e
</fabric>
</fabrics>
<categories>
<category>
125481f9-8d58-4e05-808d-0c9d68f0995
</category>
</categories>
<categories>
<category>
a1b146c3-2c9e-4010-917a-148dc7b4a33b
</category>
</categories>
<name>
<rus>
Брюки
</rus>
<eng>
Trousers
</eng>
</name>
<catalog>
false
</catalog>
<stores>
<store>
230fedd6-ce97-4346-bf61-0038b793c188
</store>
<autoloadID>
4134252345234
</autoloadID>
<vendorCode>
mp002xw0bwu111sds122
</vendorCode>
<productURL>
https://www.lamoda.ru/p/mp002xw0bwu0/clothes-loverepublic-bryuki/
</productURL>
</stores>
<images>
<image>
https://media.belt-app.com/2022/03/16/02/10/db285590-04c2-416d-a621-70278c7904e0.png
</image>
<sort>
0
</sort>
</images>
<images>
<image>
https://media.belt-app.com/2022/03/16/02/10/58655b40-8550-45b3-ab96-2beb708d02a4.png
</image>
<sort>
1
</sort>
</images>
<images>
<image>
https://media.belt-app.com/2022/03/16/02/10/f3f0e36b-7ddb-4531-96ea-4f2325035eb8.png
</image>
<sort>
2
</sort>
</images>
<genderClothes>
1
</genderClothes>
</items>
</root>
Все необходимые актуальные ключи (ID и UUID), которые могут быть использованы в каталоге можно найти по ссылке https://api.belt-app.com/app/wardrobe/autoload-keys/ (является файлом JSON, доступным к загрузке). Ключи и наименования являются актуальными для каждого запроса.
Обратите внимание, что список доступных категорий в системе (для поля categories) организован в виде дерева, где каждый элемент может быть использован в каталоге.
Например, можно указать элемент одежды в категории "Джинсы" ("uuid": "4185e9e7-6de6-4c58-bece-3e0a0a0d5e3d"), а можно указать более точную категорию "Узкие джинсы" (uuid": "f95b7116-80dc-49ea-8aca-5d6de692f0a6"), которая является дочерней категорией категории "Джинсы".
Если вы не обнаружите необходимых категорий/брендов/материалов/тканей/цветов и других данных - сообщите об этом на support@belt-app.com
Если каталог уже использует систему автозагрузки какой-то сторонней системы, например маркетплейсов, таких как Яндекс.Маркет, Wildberies и т.д., то возможна автозагрузка каталога в одном из таких форматов.
Автозагрузка доступна в следующих сторонних форматах:
<yml_catalog date="2024-06-21 11:55">
<shop>
<name>Интернет-магазин</name>
<company>clothing</company>
<url>https://clothing.ru</url>
<platform>Bazium</platform>
<currencies>
<currency id="RUB" rate="1"/>
</currencies>
<categories>
<category id="7" parentId="8">Прочее</category>
<category id="8">Все товары</category>
</categories>
<offers>
<offer id="2664295" available="true">
<url>https://Bazium.ru/kapyushon-bolshoy-latte</url>
<price>1590</price>
<oldprice>3590</oldprice>
<currencyId>RUB</currencyId>
<categoryId>8</categoryId>
<picture>https://clothing.ru/images/photo.jpeg</picture>
<delivery>true</delivery>
<name>Капюшон большой латте</name>
<description>Модный женский капюшон-манишка</description>
</offer>
</offers>
</shop>
</yml_catalog>
Если каталог имеет другой сторонний формат (например другого маркетплейса, отсутствующего в списке доступных форматов) - сообщите об этом на support@belt-app.com
Если каталог уже используется для автозагрузки в собственные внутренние системы магазина в собственном формате.