Расширенный API магазина
Этот модуль входит в нашу Подписку.
Оформите подписку — и пользуйтесь всеми модулями без ограничений.
Модуль расширяет стандартный API CS-Cart и даёт внешним клиентам единый способ работать с каталогом, корзиной, заказами, бонусами, пунктами получения и настройками витрины.
Для чего нужен
- чтобы подключить к магазину мобильное приложение, веб-кабинет или другой внешний клиент;
- чтобы отдавать внешним сервисам актуальные данные каталога и покупателя из одного источника;
- чтобы применять настройки витрины, складской доступности, бонусов и оплат на стороне магазина;
- чтобы публиковать пользовательские подборки товаров через тот же API.
Основные возможности
- передаёт товары, категории, бренды, баннеры, товарные блоки и промоакции;
- поддерживает профиль покупателя, избранное, историю заказов и подборки товаров;
- работает с корзиной, скидками, оплатой, доставкой и оформлением заказа;
- учитывает бонусные баллы в расчётах корзины и заказа;
- передаёт магазины, склады, пункты самовывоза и офисы СДЭК;
- может блокировать оформление при недоступности товара в выбранном городе;
- позволяет пометить способы оплаты и контент, которые должны быть видны в приложении;
- поддерживает оплату картой и через СБП через Paygine, если модуль оплаты подключён.
Как работает
Администратор задаёт ID блока баннеров, характеристику бренда, главную категорию и фильтр по складам, а при необходимости отдельно включает проверку наличия для приложения и для сайта. В карточках способов оплаты можно пометить варианты, которые должны отображаться в приложении, а совместимый модуль избранного и подборок включает публикацию списков через API.
Внешний клиент подключается к API магазина с нужными правами, запрашивает каталог и данные покупателя, добавляет товары в корзину, пересчитывает её и оформляет заказ. Если включены бонусы, склады, пункты получения, Paygine или подборки, модуль передаёт и эти данные в пределах настроек и доступных интеграций.
Где находится в админке
Основные настройки находятся в Администрирование → Модули → Управление модулями → Расширенный API магазина.
Связанные поля также появляются в настройках баннеров, способов оплаты, складской доступности и совместимых модулей подборок.
Остались вопросы по работе модуля?
Напишите нам.
https://t.me/makeshop_chat_bot
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Владельцам
- Покупателям
- English
- Русский
- 4.20.X
- 4.19.X
- 4.18.X
Инструкция к модулю Расширенный API магазина
Модуль передаёт каталожные данные, корзину, заказы, бонусы, склады, пункты получения, баннеры, оплату и подборки во внешний клиент через API CS-Cart. Ниже собраны основные настройки и проверки, которые нужны после установки или обновления.
Что делает модуль
- передаёт товары, категории, бренды, баннеры, товарные блоки и промоакции;
- поддерживает профиль покупателя, избранное, историю заказов и подборки товаров;
- работает с корзиной, скидками, оплатой, доставкой и оформлением заказа;
- учитывает бонусные баллы в расчётах корзины и заказа;
- передаёт магазины, склады, пункты самовывоза и офисы СДЭК;
- может блокировать оформление при недоступности товара в выбранном городе;
- позволяет отметить способы оплаты и контент, которые должны быть видны в приложении;
- поддерживает оплату картой и через СБП через Paygine, если модуль оплаты подключён.
Где находится модуль
- Администрирование → Модули → Управление модулями → Расширенный API магазина — основные настройки модуля.
- Администрирование → Баннеры — поля, связанные с передачей баннеров во внешний клиент.
- Администрирование → Способы оплаты — поле Отображать в приложении.
- Администрирование → Модули → Управление модулями → Совместимый модуль подборок — если используется публикация подборок.
Как проверить работу
- Откройте карточку модуля и задайте ID блока баннеров, ID характеристики бренда, ID главной категории и ID фильтра по складам.
- При необходимости включите блокировку оформления заказа в приложении и отдельно на сайте, если товар недоступен в выбранном городе.
- Откройте способы оплаты и отметьте те, которые должны отображаться в приложении.
- Проверьте, что включены связанные модули: бонусы, склады, пункты получения, Paygine, расширенные списки желаний и подборки.
- Сохраните настройки и очистите кеш CS-Cart после обновления.
- Откройте приложение или внешний кабинет и запросите категории, товары и бренды.
- Проверьте, что корзина считает скидки, бонусы и доставку так же, как в магазине.
- Выберите город, склад или пункт получения и убедитесь, что недоступный товар блокирует оформление только при включённой настройке.
- Создайте тестовый заказ и проверьте, что в админке сохраняются состав, доставка, оплата, бонусы и витрина.
- Если используется Paygine, проверьте оплату картой или СБП и возврат в магазин после завершения платежа.
- Если используются подборки, создайте черновик, добавьте товар, опубликуйте подборку и откройте публичную ссылку без авторизации.
Если данные не приходят, сначала проверьте права API-пользователя, включение модуля на нужной витрине и состояние связанных интеграций.
История изменений
v1.3.1 от 24.08.2026
[*] Обновлены код, шаблоны и интеграционные файлы модуля.
[*] Обновлены описание, инструкция, changelog и логотип модуля.
v1.3.0 от 2026-08-13
[+] Добавлено:.
[*] Модуль переименован в «Расширенный API магазина» и ориентирован на веб-кабинеты, мобильные приложения и внешние сервисы.
[*] API подборок включён в универсальную поставку и активируется при наличии совместимого модуля списков желаний.
[*] Хранилища бонусных баллов корзины и диагностических событий перенесены в безопасные миграции.
[*] Усилена проверка владельца заказа, витрины и данных платёжных операций в API.
[*] Каталог, бренды и складская доступность теперь учитывают текущий язык и витрину без клиентских значений по умолчанию.
[*] Диагностическое журналирование отключено по умолчанию, хранится меньше времени и не включает персональные данные.
[*] Метаданные подборок устанавливаются только при наличии совместимого модуля и не меняют назначение существующих личных списков.
v1.2.2 от 2026-08-11
[!] Исправлено:.
[+] Исправлено добавление нового товара в подборку через API при сохранении проверки дублей внутри конкретной подборки.
v1.2.1 от 2026-08-11
[+] Добавлено:.
[+] Добавлен API подборок пользователя на базе Cart-Power Extended Wishlist.
[+] Добавлены черновики, публикация, снятие с публикации и ручной порядок товаров.
[+] Добавлено гостевое чтение опубликованных подборок.
[*] Существующие ключи и публичные ссылки подборок сохраняются при обновлении.
v1.2.0 от 2026-06-03
[*] Обновлены служебные разделы карточки модуля в панели администратора.
[*] Повышена совместимость модуля с актуальными стандартами установки и обновления.
[*] Улучшена работа корзины и оформления заказа при проверке наличия товаров в выбранном городе.
[*] Повышена устойчивость работы корзины при неполных данных о товарах.
[*] Повышена устойчивость работы корзины и расчёта доставки.
[*] Улучшена работа мобильного приложения с городами, складами, остатками и ценами.
[+] Улучшено добавление товаров в корзину с учётом выбранного города.
[*] Улучшена обработка оформления заказа и оплаты в мобильном приложении.
[+] Добавлена возможность управлять проверкой наличия товаров при оформлении заказа на сайте и в мобильном приложении.
[*] Улучшены предупреждения для покупателей при наличии в корзине недоступных товаров.
[*] Улучшено отображение предупреждений при заполнении обязательных полей на странице оформления заказа.
[-] Удалены устаревшие markdown-файлы документации из пакета модуля.
v1.1.3 от 2026-04-16
[+] Добавлено:.
[+] Добавлены новые переменные из ms_fractional_stock и ms_packaging.
[+] Добавлены данные о способах связи в API создания заказа.
[+] Добавлена сортировка в API каталога товаров.
[+] Добавлен чекбокс «Отображать в приложении».
[+] Добавлен хук при получении товаров по ID.
[+] Добавлена передача ПВЗ в заказ при его создании.
[+] Добавлен API для получения пунктов выдачи СДЭК.
[+] Добавлены ID, название и стоимость способа доставки в API заказов.
[+] Добавлена вкладка «Мобильное приложение» для баннера.
[+] Добавлено поле каталога категории.
[+] Добавлен параметр device в API баннеров.
[+] Добавлена оплата картой и СБП через Paygine в API создания заказа.
[+] Добавлена настройка «ID метода оплаты Paygine».
[+] Добавлен функционал «Бонусные баллы».
[+] Добавлена поддержка складов и пунктов получения для мобильного приложения.
[*] Список способов оплаты теперь зависит от выбранного способа доставки.
[*] Изменён тип поля на странице создания и редактирования баннера.
[*] Изменена иконка модуля.
[*] Проведён рефакторинг кода.
[*] Повышена устойчивость работы модуля при разных настройках магазина.
[!] Исправлено:.
[!] Исправлены некорректные значения в API товаров и товарах для корзины.
[!] Исправлена передача email-уведомлений при оформлении заказа через API.
[!] Исправлена передача единицы измерения в API корзины и категориях товаров.
[!] Исправлен счётчик товаров в списке всех товаров категории.
[!] Исправлена передача количества товара 0 в API товара.
[!] Исправлены некорректные статусы заказов.
[!] Исправлено попадание выключенного баннера в API баннеров.
[!] Исправлена ошибка при создании заказа.
[!] Исправлена ошибка при повторении заказа.
[!] Исправлена оплата через СБП.
[*] Улучшена проверка доступности товаров в выбранном городе при работе с корзиной и оформлении заказа.
[-] Удалена настройка «ID метода оплаты Paygine».
v1.1.1 от 2024-07-15
[+] Добавлено:.
[+] Добавлены настройки модуля.
[+] Добавлен функционал профиля, заказов, избранного.
[*] Проведены работы после code review.
v1.1.0 от 2024-07-09
[+] Добавлено:.
[+] Добавлены сущности MsBanners, MsBlocks, MsBrands, MsCategories, MsProducts.
[*] Выполнен переход с контроллера на API-дополнение.
v1.0.0 от 2024-06-05
[+] Добавлено:.
[+] Первое издание.
Обозначения:
[+] Добавлено
[-] Удалено
[*] Изменено
[!] Исправлена ошибка
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.