Программа «Интернет Партнер» — Справочный центр

Для того чтобы воспользоваться функционалом «Интернет Партнер», перейдите в «Личный кабинет» (1) - «Интернет Партнер» (2).

В личном кабинете в разделе «Интернет Партнер» расположены прайс-лист и каталог товаров Русклимат, подготовленные для загрузки в Ваш интернет-магазин. Для удобства работы все документы доступны в нескольких форматах.

Эти инструменты избавят Вас от долгого труда по добавлению и обновлению товаров в Вашем интернет-каталоге, поиску изображений каждого товара, инструкций, описаний и т.п.

Файлы каталога созданы на основе каталога сайта b2b.rusklimat.com и предоставляются в форматах: CSV, XLSX, XML, YML.

Файлы каталога содержат следующую информацию:

наименование товара, НС-код, бренд, категория, характеристики, изображения, видео, рекомендованная розничная цена, сопутствующие товары, эксклюзив (да/нет), аналоги/замена, статья, чертежи, сертификаты, промоматериалы, инструкции/руководства, штрихкод, артикул.

Обращаем внимание:

Если в одном поле больше одного наименования, то используется разделитель «;» или «,»;
В выгруженном каталоге строки разбиты построчно по тегам, а не сжаты в одну строку (формат CSV);
В формате каталога YML структура функциональных и отличительных особенностей товара вынесена в PARAM.

Раздел «Скачать каталог» (1) содержит файлы полного ассортимента товаров каталога сайта b2b.rusklimat.com. Для того чтобы скачать каталог, нажмите на соответствующую ссылку необходимого формата (2). Документ будет сохранен на Вашем устройстве.

На странице «Интернет Партнер» доступна загрузка каталога с выбранными категориями.

Для просмотра и выбора подкатегорий для выгрузки файлов каталога воспользуйтесь кнопками «+» (1) чтобы развернуть раздел, «-» (2) чтобы свернуть раздел.

Выбрав необходимые категории, нажмите на кнопку «Сформировать файл» (1).
Для того чтобы не устанавливать необходимые категории каждый раз, когда Вам потребуется формирование файла, Вы можете сохранить выбранные настройки категорий для выгрузки (2).

Подтвердите действие, нажав на кнопку «Да» (1). Процесс формирования файла может занять некоторое время (как правило, 5-10 минут). Если необходимо отменить действие, нажмите кнопку «Нет» (2).

После того, как файл начнёт формироваться, появится информационное окно «Файл формируется». Вы можете его свернуть (1) или закрыть (2) и продолжить работать с В2В-порталом. В любом случае Ваши файлы будут сформированы.

В случае сворачивания информационного окна оно будет отображаться в свернутом виде на всех страницах сайта. Как только файлы сформируются, в информационном окне появится соответствующая информация (1).

В случае закрытия информационного окна файлы продолжат формироваться, но сообщения об окончании операции Вы не увидите. Сформированные файлы будут выведены на странице «Интернет Партнер» в соответствующем блоке (1) по окончанию операции (необходимо обновить страницу).

Готовые файлы скачайте или в информационном окне, развернув его и нажав на ссылку интересующего формата (1), или в разделе «Интернет Партнер» в соответствующем блоке, обновив страницу (2).

В прайс-листе отображается товарный каталог сайта с НС-кодами, артикулами, наименованиями товарных групп и номенклатурных позиций: в виде иерархии в XLSX-файле и в форме таблицы в CSV-файле. Для удобства в прайс-листе указана Ваша персональная цена, РРЦ, РИЦ, а также остатки на доступных Вам складах.

Для того чтобы скачать прайс-лист, перейдите к блоку «Скачать прайс-лист» и нажмите кнопку «Сформировать файл» (1).

Подтвердите действие, нажав кнопку «Да» (1). Процесс формирования файла может занять некоторое время (как правило, 5-10 минут).
Если необходимо отменить действие, нажмите кнопку «Нет» (2).

После того, как файл начнёт формироваться, появится информационное окно «Файл формируется». Вы можете его свернуть (1) или закрыть (2) и продолжить работать с В2В-порталом. В любом случае Ваши файлы будут сформированы.

Если свернуть модальное окно, оно будет отображаться на всех страницах сайта. После завершения операции в нем появится информация о том, что файлы сформированы. Разверните окно (1) и скачайте файлы (2).

Если закрыть окно, сформированные файлы можно будет скачать после завершения операции, обновив страницу (уведомления не будет). Для скачивания нажмите на соответствующую ссылку (1).

Также Вам доступна автоматическая ежедневная выгрузка остатков по складам с отправкой на Ваш e-mail или FTP-сервер. Для настройки автоматической выгрузки обратитесь к своему персональному менеджеру.

Сервис предоставляет возможность получить онлайн каталог товаров, содержащий индивидуальные цены, остатки и все дополнительные характеристики.
Все запросы в REST API должны содержать JWT-токен авторизации в заголовке Authorization.

Получение JWT-токена доступно в ручном и автоматическом режимах.

Токен выдается на сутки, в 00:00 он станет невалидным и необходимо получить новый токен.
Например, если токен был получен сегодня в 13:00, то завтра после 00:00 данный токен станет невалидным.

Перейдите на страницу «Руководство по API» и нажмите на кнопку «Показать JWT токен» (1).

После нажатия на кнопку ниже на странице появится Ваш JWT-токен (1).

Для того чтобы скопировать токен в буфер обмена, кликните левой кнопкой мыши по иконке (2).

В автоматическом режиме получение JWT-токена возможно через метод авторизации на сайте.

POST https://b2b.rusklimat.com/api/v1/auth/JWT/
Обязательно установите заголовок в запросе User-Agent: catalog-ip

Тело запроса

Тело запроса:

{
    "login": "9651111111", // логин для входа на б2б-портал
    "password": "123456" // пароль для входа на б2б-портал
}

где:

login - Ваш логин для входа на сайт (логин вводить без 8)
password - Ваш пароль для входа на сайт

Тело ответа:

Ответ

{
    "code": 200,
    "data": {
        "jwtToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2NzkwOTc2MDAsImd1aWQiOiI5YmZlOWMxMC1.UoPQ_zFGNFGsHVQ46u_M2rM2I18RnQpI"
    }
}

Код 401 "Invalid user\/password" - проверьте корректность ввода своего логина и пароля в теле запроса.

Код 401 "Use only POST" - для получения токена необходимо использовать метод POST.

Код 403 "Forbidden" - укажите в заголовке запроса User-Agent: catalog-ip

Адрес сервиса: https://internet-partner.rusklimat.com

Онлайн документация: https://internet-partner.rusklimat.com/swagger/index.html

Идентификатор Вам потребуется для дальнейших запросов (получение категорий товаров, получение свойств товаров, получение товаров каталога).

GET https://internet-partner.rusklimat.com/api/v1/InternetPartner/{partnerId}/requestKey/
В заголовке Authorization укажите JWT-токен.
Вместо {partnerId} укажите ваш partnerId.

Для того чтобы узнать свой partnerId, перейдите на страницу «Руководство по API», в блоке «Получение данных каталога» (1) будет указан ваш partnerId (2).

Тело ответа:

Тело ответа

{
    "requestKey": 1679057010,
    "expire": 1679057061
}

где:

requestKey - идентификатор запроса, который нужно использовать на втором этапе
expire - метка времени, указывает окончание срока жизни идентификатора

GET https://internet-partner.rusklimat.com/api/v1/InternetPartner/categories/{requestKey}
В заголовке Authorization укажите JWT-токен.
Вместо {requestKey} укажите Ваш requestKey.
requestKey необходимо получить в запросе, описанном в разделе «Получение идентификатора».

Тело ответа:

Тело ответа

{
    "totalCount": 241,
    "data": [
        {
            "id": "f7a25385-f2ad-411b-9410-bd9c6fa386ce",
            "name": "Смесительные узлы и насосные станции",
            "parent": "f8e4738b-217b-4a82-8b5a-e1874d28ab79"
        },
        ......
    ]
}

где:

id - уникальный идентификатор категории
name - наименование категории
parent - уникальный идентификатор категории-родителя, для корневой категории данное поле будет равно null

GET https://internet-partner.rusklimat.com/api/v1/InternetPartner/properties/{requestKey}
В заголовке Authorization укажите JWT-токен.
requestKey необходимо получить в запросе, описанном в разделе «Получение идентификатора».

Тело ответа:

Тело ответа

{
    "totalCount": 1389,
    "data": [
        {
            "id": "319e5ef4-baaa-11e5-b14a-ac162d7b6f40",
            "name": "Высота внешнего блока",
            "sort": 12
        },
        ......
    ]
}

где:

id - уникальный идентификатор свойства
name - наименование свойства
sort - сортировка свойства в общем списке свойств

POST https://internet-partner.rusklimat.com /api/v1/InternetPartner//products/{requestKey}/?pageSize=500&page=1
В заголовке Authorization укажите JWT-токен.
requestKey - необходимо получить в запросе, описанном в разделе «Получение идентификатора».

Version - версия метода, на текущий момент поддерживаются версии 1 и 2:

v1 - стандартная выдача информации о товаре, спроектированная изначально
v2 - дополнительно в свойствах товара выводятся единицы измерения

Доступна постраничная навигация, get-параметры запроса:

pageSize - количество товаров на одной странице, максимальное значение 1000, по умолчанию 1000
page - номер страницы, по умолчанию 1

Тело запроса:

Тело запроса

{
    "columns": [
        "name",
        "nsCode",
        "price",
        "clientPrice"
    ],
    "filter": {
        "categoryIds": [
            "f7a25385-f2ad-411b-9410-bd9c6fa386ce",
            "194602b6-2e40-4b6e-996c-89774e5b9fc1",
            "d2257a3e-4298-4e9b-8db7-5b6bfe62c76d"
        ]
    },
    "sort": {
        "nsCode": "asc"
    }
}

где:

columns - массив полей товаров, которые необходимо выводить в ответе, если не указан, будут выведены все поля
filter - фильтрация товаров в ответе, доступны поля:
categoryIds - массив id категорий, товары которых нужно получить, в ответе также будут товары, которые находятся в подкатегориях
sort - поле для указания сортировки товаров в формате "кода поля": "порядок сортировки asc|desc"

Тело ответа:

Тело ответа v1

{
    "totalCount": 18971,
    "pageSize": 500,
    "page": 2,
    "data": [
        {
            "id": "3abaeda3-7eb3-11da-aaff-00304883a34f",
            "nsCode": "НС-0028148",
            "categoryId": "f7a25385-f2ad-411b-9410-bd9c6fa386ce",
            "vendorCode": "2000/3-W VIM",
            "brand": "SHUFT",
            "name": "Установка приточная компактная моноблочная CAU 2000/3-W VIM",
            "properties": [
                {"23431d4b-52f4-11ea-9da0-ac162d7b6f40": "Полупромышленное оборудование"},
                {"23431d4b-52f4-11ea-9da0-ac162d7b6f99": "Ступенчатая"},
                ......
            ],
            "pictures": [
                "https://rkcdn.ru/products/23431d4b-52f4-11ea-9da0-ac162d7b6f40/src.png",
                ......
            ],
            "video": [
                "https://www.youtube.com/embed/xI0tHHjfg4Q",
                ......
            ],
            "relatedProducts": [
                "1c084dd7-4f83-45f5-a92f-334ff306d5a0",
                "27ff9d4a-e2aa-4820-8044-9e1d3cbcdd2d",
                ......
            ],
            "analog": [
                "27343389-5479-44d2-b811-445facb5812a",
                "b634c729-1c3d-43ca-a83f-3913d922448f",
                ......
            ],
            "description": "<h3>Описание</h3><p>Рукосушка Electrolux ENDA-2500 представляет собой автоматическую сушилку для рук</p>"
            "drawing": [
                "https://rkcdn.ru/products/23431d4b-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                ......
            ],
            "certificates": [
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f42/src.pdf",
                ......
            ],
            "promoMaterials": [
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                ......
            ],
            "instructions": [
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                ......
            ],
            "barcode": [
                "7312971100010",
                ......
            ],
            "price": 83016.00,
            "internetPrice": 83010.00,
            "clientPrice": 55620.72,
            "exclusive": true,
            "remains": {
                "total": 250,
                "warehouses": {
                    "ФРЦ Киржач": 100,
                    "РРЦ Сочи": 123,
                    "омск склад": "ожидается поставка",
                    ......
                }
            }
        },
        ......
    ]
}

Тело ответа v2

{
    "totalCount": 18971,
    "pageSize": 500,
    "page": 2,
    "data": [
        {
            "id": "3abaeda3-7eb3-11da-aaff-00304883a34f",
            "nsCode": "НС-0028148",
            "categoryId": "f7a25385-f2ad-411b-9410-bd9c6fa386ce",
            "vendorCode": "2000/3-W VIM",
            "brand": "SHUFT",
            "name": "Установка приточная компактная моноблочная CAU 2000/3-W VIM",
            "properties": {
                "23431d4b-52f4-11ea-9da0-ac162d7b6f40": {
                    "value": "0.043",
                    "unit": "cd835135-3ec5-4eeb-bb1f-f8a576a2d1fb"
                },
                "23431d4b-52f4-11ea-9da0-ac162d7b6f99": {
                    "value": "5.4",
                    "unit": "c4526b04-adb4-11e3-931a-ac162d7b6f40"
                },
                ......
            },
            "pictures": [
                "https://rkcdn.ru/products/23431d4b-52f4-11ea-9da0-ac162d7b6f40/src.png",
                ......
            ],
            "video": [
                "https://www.youtube.com/embed/xI0tHHjfg4Q",
                ......
            ],
            "relatedProducts": [
                "https://b2b.rusklimat.com/catalog/product/trubka_energoflex_super_protect_k_18_9_2/",
                "https://b2b.rusklimat.com/catalog/product/komplekt_montazhnyy_1_unipak_pasta_25_g_lyen_13_g_sip25f13/",
                ......
            ],
            "analog": [
                "https://b2b.rusklimat.com/catalog/product/sushilka_dlya_ruk_ballu_bahd_1800/",
                "https://b2b.rusklimat.com/catalog/product/cushilka_dlya_ruk_electrolux_ehda_w_2500_belaya/",
                ......
            ],
            "description": "Описание
Рукосушка Electrolux ENDA-2500 представляет собой автоматическую сушилку для рук
 Конструкция",
            "drawing": [
                "https://rkcdn.ru/products/23431d4b-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                ......
            ],
            "certificates": [
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f42/src.pdf",
                ......
            ],
            "promoMaterials": [
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                ......
            ],
            "instructions": [
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                "https://rkcdn.ru/products/1111111-52f4-11ea-1111-ac162d7b6f40/src.pdf",
                ......
            ],
            "barcode": [
                "7312971100010",
                ......
            ],
            "price": 83016.00,
            "internetPrice": 83010.00,
            "clientPrice": 55620.72,
            "exclusive": true,
            "remains": {
                "total": 250,
                "warehouses": {
                    "ФРЦ Киржач": 100,
                    "РРЦ Сочи": 123,
                    ......
                }
            }
        },
        ......
    ]
}

totalCount - общее число товаров
pageSize - размер страницы в выдаче товаров
page - номер страницы выдачи товаров
data - массив с данными товаров
id - уникальный идентификатор товара
nsСode - НС код товара
categoryId - уникальный идентификатор категории, к которой привязан товар
vendorCode - артикул товара
brand - бренд товара
name - наименование товара
properties - массив свойств товара, элементы в формате "уникальный идентификатор свойства": "значение свойства"
для версии метода v1 - "уникальный идентификатор свойства": "значение свойства"
для версии метода v2 - "уникальный идентификатор свойства": {"value": "значение свойства", "unit": "идентификатор единицы измерения(информацию по единицам измерения можно получить в другом методе - /api/v1/InternetPartner/units, см. Получение единиц измерения)"}
pictures - массив ссылок на изображение товаров
video - массив ссылок на видео товаров
relatedProducts - массив уникальных идентификаторов сопутствующих товаров, может содержать 0 элементов
analog - массив уникальных идентификаторов аналогичных товаров, может содержать 0 элементов
description - описание товаров в формате html
drawing - массив ссылок на pdf файлы с чертежами, может содержать 0 элементов
certificates - массив ссылок на pdf файлы с сертификатами, может содержать 0 элементов
promoMaterials - массив ссылок на pdf файлы с промо материалами, может содержать 0 элементов
instructions - массив ссылок на pdf файлы с инструкциями, может содержать 0 элементов
barcode - массив штрихкодов
price - цена РРЦ
internetPrice - цена РИЦ
clientPrice - индивидуальная цена партнёра, в случае, когда цена не установлена, будет отдан 0
exclusive - признак эксклюзивности
remains - остаток товара на складе
total - сумма остатков по всем складам
warehouses - детализация остатков по складам в формате "название склада": "остаток на складе"

GET https://internet-partner.rusklimat.com/api/v1/InternetPartner/units
В заголовке Authorization укажите JWT-токен.

Тело ответа:

Тело ответа

{
    "totalCount": 152,
        "data": [
            {
                "id": "89d219a9-d722-41c6-80c3-9b3957998bca",
                "name": "л.с.",
                "nameFull": "лошадиная сила",
                "code": "251",
                "intAbbr": ""
            },
            {
                "id": "cd0c9dfd-978a-4387-82c5-278309830f7e",
                "name": "км",
                "nameFull": "Километр",
                "code": "008",
                "intAbbr": "KMT"
            },
            ......
        ]
}

где:

id - уникальный идентификатор единицы измерения
name - наименование единицы измерения
nameFull - полное наименование единицы измерения
code - код единицы измерения
intAbbr - международное сокращение

Программа "Интернет Партнер"

Каталог

Полный каталог

Каталог с выбором категорий

Прайс-листы

REST API каталога ИП

Получение JWT-токена

Получение токена в ручном режиме

Получение токена в автоматическом режиме

Возможные ошибки при получении JWT-токена

Получение данных каталога

Получение идентификатора

Получение категорий товаров

Получение свойств товаров

Получение товаров каталога

Описание

Конструкция

Получение единиц измерения