Интеграция ROSSKO и CloudPayments для OpenCart

Задача

Продажа автозапчастей упирается в одну особенность: ассортимент дистрибьютора несопоставим с тем, что физически лежит на витрине магазина. У ROSSKO — сотни тысяч позиций по разным брендам, и держать их все в каталоге OpenCart вручную невозможно. Задача сводилась к тому, чтобы магазин на OpenCart мог продавать не только собственные остатки, но и весь ассортимент дистрибьютора, подтягивая данные из API ROSSKO в момент, когда покупатель ищет конкретную деталь.

Вторая половина задачи — оплата. Магазину нужен был эквайринг CloudPayments, чтобы принимать карты прямо на сайте, без перенаправления покупателя на сторонние страницы. Плюс два принципиально разных сценария поиска: по номеру производителя, когда клиент точно знает, какая деталь ему нужна, и через OEM-каталог, когда номера на руках нет и запчасть подбирается по самому автомобилю.

Что реализовали

В основе решения — модуль для OpenCart, который связывает витрину с API поставщика. Он отвечает за поиск товаров у ROSSKO, разбор ответа API, создание карточек и передачу оплаты в CloudPayments. Ниже — ключевые части модуля.

• API ROSSKO — поиск товаров по номеру производителя, получение настроек доставки и оплаты
• CloudPayments — эквайринг для оплаты заказов
• OEM-каталог — подбор запчастей по автомобилю
• Автоматическое создание карточек — товары из API ROSSKO создаются в OpenCart
• Корзина — сохранение товаров при повторном заходе

Как работает

Логика построена вокруг номера детали. Любой запрос — набранный вручную или полученный из OEM-каталога — превращается в поиск по конкретному артикулу, и модуль всегда сначала смотрит в собственный каталог OpenCart, а уже потом обращается к дистрибьютору. Это экономит вызовы API и отдаёт покупателю в первую очередь то, что есть в наличии у самого магазина.

Товары в наличии

Покупатель вводит номер производителя (например, 15600-25010). Система ищет товар в магазине. Если нашла — показывает. Если нет — запрашивает список товаров из API ROSSKO. Покупатель выбирает товар из ROSSKO → система создает карточку в OpenCart → оформление заказа. Карточка собирается на лету из данных API: наименование, бренд, артикул, цена и доступность подставляются в стандартную сущность товара OpenCart, поэтому такая позиция дальше живёт по обычным правилам платформы — попадает в корзину, участвует в оформлении и оплате наравне с остальными.

Товары под заказ

Покупатель не знает номер запчасти. Заходит в OEM-каталог. Выбирает марку, модель, год автомобиля. Находит нужную запчасть (например, фильтр 15600-25010). Система ищет этот номер сначала в магазине, потом в API ROSSKO. Показывает оба варианта. Покупатель выбирает → оформление заказа. Разделение на «в наличии» и «под заказ» здесь не формальность: одна и та же деталь может лежать на складе магазина и одновременно предлагаться дистрибьютором с другой ценой и сроком, и покупатель сам решает, что ему важнее — забрать сразу или дождаться поставки.

Оплата вынесена на CloudPayments. Эквайринг подключён так, чтобы покупатель проходил платёж без ухода с сайта, а заказ в OpenCart переводился в оплаченный по факту успешной транзакции. Настройки доставки и оплаты при этом частично тянутся из API ROSSKO — модуль получает их вместе с данными о товарах, а не задаёт вслепую. Корзина сохраняет выбранные позиции между заходами, что важно для автозапчастей: подбор детали редко заканчивается за один визит, и покупатель нередко возвращается сверить номер или уточнить совместимость.

Результат

• Интеграция ROSSKO API с OpenCart
• Эквайринг CloudPayments
• OEM-каталог для подбора запчастей
• Автоматическое создание карточек товаров из API
• Поиск по номеру производителя