База знаний EMS-платформы PlatParts Руководство по настройке EMS-платформы PlatParts

RAROS

На этой странице 11

RAROS — поставщик с REST API на raros.ru. В PlatParts выбирается тип «RAROS (raros.ru)»: по настройкам идёт онлайн-проценка (поиск брендов и остатков). Прямой заказ через API в публичной документации не описан.

Где находится

Настройки продаж → Поставщики

Создайте поставщика или откройте существующего, в «Тип технического интерфейса» выберите RAROS (raros.ru), заполните «Настройки технического интерфейса», сохраните карточку.

Что подготовить

  • логин и пароль от личного кабинета raros.ru;
  • учёт лимитов API (запросов в минуту, час и сутки — при превышении API отвечает ошибкой).

Поля настроек

Логин и пароль

Учётные данные от raros.ru. Передаются в каждом запросе к API. При неверных данных проценка вернёт ошибку авторизации.

Показывать аналоги

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

Показывать замены

Включите, если нужны позиции с типом «замена».

Минимальный рейтинг поставщика

Скрывает позиции с рейтингом поставщика ниже указанного числа. 0 — не фильтровать. Рейтинг приходит из API вместе с каждой позицией и также может подставляться в «вероятность поставки» в проценке.

Вероятность поставки, % и цвет склада

Стандартные поля карточки склада PlatParts. Используются, если API не вернул рейтинг поставщика по конкретной строке.

Как работает проценка

  1. По артикулу запрашивается список производителей.
  2. Для выбранного бренда запрашиваются цены и наличие.
  3. Сроки из API приходят в днях и конвертируются в часы для отображения в проценке (плюс дополнительная задержка склада из общих настроек).

Что проверить после настройки

  1. Проценка по тестовому артикулу возвращает бренды RAROS.
  2. По выбранному бренду приходят позиции с ценой, количеством и сроком.
  3. Переключатели «аналоги» и «замены» меняют состав выдачи.

Если не работает

  1. Проверьте логин и пароль на raros.ru.
  2. Убедитесь, что не исчерпан лимит запросов к API.
  3. Увеличьте таймаут в карточке склада при медленных ответах.
  4. Смотрите логи адаптера — в ответе есть supplier_errors с текстом ошибки.
Документация API

Официальное описание методов: raros-api.pdf