ТЗ: Интеграция MAXMA с CS‑Cart
Цель
• Сделать базовое подключение MAXMA, чтобы покупатели видели свои бонусы и скидки, а заказы корректно передавались в MAXMA.
Что должно получиться в итоге
• Новый покупатель на сайте появляется в базе MAXMA.
• В корзине видно: какие скидки применились, сколько бонусов можно потратить и сколько начислят.
• При оформлении заказ попадает в MAXMA, а при подтверждении/отмене/возврате статусы синхронизируются.
• В личном кабинете видны текущие бонусы и история операций.
Что нужно настроить
• Ключ доступа MAXMA (API: api-test.maxma.com (тест), api.maxma.com (боевой).
• Домен магазина
• Статусы заказов, при которых считаем заказ подтверждённым или отменённым.
Клиенты (регистрация)
• Когда на сайте создаётся новый покупатель, его данные отправляются в MAXMA.
• Идентификаторы: номер телефона в формате +7XXXXXXXXXX и внутренний ID сайта.
• Если такой телефон уже есть в MAXMA, обновляем карточку: добавляем внешний ID и недостающие поля (имя, email).
• Отправка делается в фоне, чтобы страницы не тормозили.
Корзина и оформление заказа
• При изменении корзины, вводе промокода или сумме списания бонусов делаем пересчёт и показываем результат покупателю.
• На этапе оформления передаём заказ в MAXMA. Если менеджер поменял состав – передаём снова.
• При переходе заказа в “подтверждён” отправляем сигнал подтверждения. При отмене – сигнал отмены. При возврате – сигнал возврата позиций.
• Если покупатель не авторизован, расчёт делаем без персональных бонусов (как гость).
Личный кабинет
• Показывать текущий баланс бонусов.
• Показывать историю начислений и списаний.
Во избежании перегруза сайта:
• Все операции, которые не нужно выполнять мгновенно (например, создание/обновление клиента), складывать в очередь в файлы.
• Сделать админ‑кнопку “Обработать очередь сейчас” и возможность запуска по cron каждые 1–2 минуты.
• Для запросов, которые идут с корзины, использовать короткие ожидания и выполнять их асинхронно.
Ошибки и время ожидания
• Если сервер MAXMA недоступен, сайт продолжает работать: показываем корзину без бонусов и пишем ошибку в лог.
• Настроить короткие ожидания сети (порядка 2–3 секунд), чтобы страницы не зависали.
• Текстовые ошибки, связанные с промокодом или бонусами, показывать понятным языком (например, “Недостаточно бонусов”).
Критерии приёмки
• Создал покупателя на сайте – он виден в MAXMA.
• В корзине корректно отображаются скидки, доступные бонусы, списание и прогноз начисления.
• Заказ создаётся в MAXMA и меняет состояние при подтверждении/отмене/возврате на сайте.
• В личном кабинете виден баланс и история бонусов.
Документация Maxma:
1. Наш Api:
2. Документация для web-разработчика:
3. Загрузка номенклатуры