Обработка заказов в Интернет-магазине

Редактировал(а) Татьяна Брыкова 2025/01/30 09:29

Модуль заказов в Manzana Loyalty Online позволяет автоматизировать процесс обработки заказов Интернет-магазинов и применять механики программ лояльности для поощрения покупателей.

C помощью модуля можно просматривать информацию о заказах: статус заказа, состав, сумму, размер скидки, примененные купоны, количество использованных и начисленных бонусов.

Детальный процесс приведён в описании интеграции по ссылке https://docs.manzanagroup.ru/xwiki/bin/view/loyalty/api/web/cash_register/order_functionality_request/.

1737382044033-947.png

Рис. Процесс обработки заказов из Интернет-магазина

Стандартная процедура заказа состоит из нескольких этапов:

1. В интернет-магазине покупатель добавляет товары в корзину и переходит на страницу чек-аута. В этот момент в Manzana Loyalty Online отправляется запрос на формирование корзины заказа (софт заказ). После обработки запроса на страницу чек-аута возвращается информация о доступных к применению скидках; количестве баллов, доступных к списанию для оплаты заказа; количестве баллов к начислению после оплаты заказа.

2. Когда покупатель нажимает на странице чек-аута кнопку "Оформить заказ", в Manzana Loyalty Online отправляется запрос на создание заказа (фискальный заказ). Номер заказа генерируется внешней системой. На основании запроса заказ записывается в базу данных. Если покупатель использовал баллы для оплаты заказа, они холдируются (использовать их для оплаты последующих заказов нельзя). Если использовался купон, он гасится.

В интерфейсе Manzana Loyalty Online в карточке контакта (вкладка «Покупки» -> раздел «Заказы») появляется запись заказа со статусом «Создан» и состоянием «Открыт».

1711361444553-166.png

Рис. Запись созданного заказа в карточке контакта.

В разделе также можно ознакомиться с общей информацией по заказу.

Поля в разделе «Заказы» Карточки контакта.

ПолеОписание
Номер заказаСсылка на заказ
Дата заказаДата заказа, переданная в запросе внешней системой
Дата процессингаДата обработки запроса в Manzana Loyalty
КартаСсылка на запись карты, к которой относится заказ
Состояние заказа

Возможные значения:

· Открыт

· Закрыт

Статус заказа

Возможные значения:

  • Создан
  • Частично оплачен
  • Оплачен
  • Доставлен
ПартнерСсылка на партнёра, к которому относится данный заказ
МагазинСсылка на магазин, к которому относится данный заказ
POSСсылка на POS-терминал, к которому относится данный заказ
СуммаОбщая сумма заказа
Сумма со скидкойСумма заказа после применения скидки
СкидкаРазмер применившейся скидки в процентах
Оплачено балламиЧасть суммы чека (в руб.), которая была оплачена баллами
Списано балловСумма баллов, списанная на этапе создания заказа
Списано статусных балловСумма статусных баллов, списанная на этапе создания заказа
Начислено балловСумма баллов для начисления на этапе создания заказа
Начислено статусных балловСумма статусных баллов для начисления на этапе создания заказа
Оплачено денежным счетомСумма денежных средств, списанных для оплаты заказа
Начислено баллов (факт.)Окончательное значение баллов, начисленных за заказ
Начислено статусных баллов (факт.)Окончательное значение статусных баллов, начисленных за заказ
Списано баллов (факт.)Окончательное значение списанных баллов после оплаты заказа
Списано статусных баллов (факт.)Окончательное значение списанных статусных баллов после оплаты заказа

Подробно ознакомиться с составом заказа можно в карточке заказа.

1711361503202-284.png

Рис.  Карточка заказа.

Поля вкладки «Позиции заказа»

ПолеОписание
ЗаказНомер заказа
Номер позицииСсылка на позицию заказа
ТоварСсылка на товар заказа
Артикул товараИспользуется как внешний идентификатор при запросах заказа. Уникальное значение в рамках связи товар - партнёр.
ЦенаЦена за единицу товара по прайсу
Количество товараКоличество товара в позиции
СуммаСумма товара в позиции заказа
Сумма со скидкойСумма товара в позиции заказа после применения скидки
СкидкаРазмер применившейся скидки в процентах
Оплачено балламиЧасть суммы позиции, которая была оплачена баллами
Списано балловСумма баллов, списанная на этапе создания заказа
Списано статусных балловСумма статусных баллов, списанная на этапе создания заказа
Начислено балловСумма баллов для начисления на этапе создания заказа
Начислено статусных балловСумма статусных баллов для начисления на этапе создания заказа
Оплаченное количествоКоличество оплаченного товара в позиции
Начислено баллов (факт.)Окончательное значение баллов, начисленных за позицию заказа
Начислено статусных баллов (факт.)Окончательное значение статусных баллов, начисленных за заказ
Списано баллов (факт.)Окончательное значение списанных баллов после оплаты заказа
Списано статусных баллов (факт.)Окончательное значение списанных статусных баллов после оплаты заказа

3. После оформления заказа, но до оплаты, покупатель может заменить или удалить товары в заказе до его получения. Или может оказаться, если нужного товара нет на остатках склада – тогда замену инициирует продавец, а не покупатель. В этих случаях в Manzana Loyalty Online отправляется запрос на изменение заказа. При замене товара значения скидок пересматриваются в зависимости от признака пересчитываемости в правилах начисления,  корректируется размер баллов для начисления и списания.

На этапе сборки заказа из-за отсутствия товаров в одном магазине, он может быть изменен на другой. В таком случае в запросе на изменение заказа (Update) указывается новый магазин в  параметре <BusinessUnit>...</BusinessUnit>. Он же записывается в базу данных в поле «orgunit_id». При смене магазина меняется и POS. Новое значение подтягивается в поле БД  «pos_id».

Если на заказ применялись непересчитываемые правила, то скидки и бонусы по этим правилам будут сохраняться. По пересчитываемым же правилам –  будут меняться согласно текущим механикам, действующим в обновленном магазине. Если примененные правила не работают в данном магазине, поощрения  по ним начислены не будут.

4. В модуле есть возможность отменить заказ или часть заказа, если по нему не было зафиксировано ни одной оплаты. При регистрации запроса отмены заказа холдированные для его оплаты баллы возвращаются на баланс покупателя, а использованные купоны восстанавливаются. Баллы для начисления за заказ отменяются.

5. Следующий этап - оплата заказа покупателем (доставка заказа). Заказ можно оплатить полностью или частично. При регистрации запроса оплаты заказа в Manzana Loyalty Online происходит списание холдированных баллов для оплаты заказа.

Статус заказа в интерфейсе Manzana Loyalty Online меняется на «Частично оплачен» (если была выкуплена часть заказа), или «Оплачен» (если был выкуплен весь заказ).

Каждая оплата (фискальный чек) отображается во вкладке «Оплаты заказа» карточки заказа. Начисляемые за заказ баллы поступают на баланс покупателя.

1711361576699-288.png

Рис.  Вкладка «Оплаты заказа» в карточке заказа.

6. На этапе оплаты покупатель может отказаться от части заказа. В таких случаях в Manzana Loyalty Online отправляется запрос отказа от позиции. Холдированные для оплаты баллы возвращаются на баланс покупателя, а баллы для начисления за невыкупленную часть заказа отменяются.

7. Выполнение заказа (подтверждение оплаты и доставки заказа покупателю) фиксируется отправлением в Manzana Loyalty запроса закрытия заказа. При выполнении запроса, состояние заказа в интерфейсе Manzana Loyalty Online меняется с «Открыт» на «Закрыт».

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

Ограничения

При регистрации запросов заказов не предусмотрен таймаут для процессинга запросов.

Отмена (роллбэк) предусмотрена только для операции создания заказа. Для остальных операций, в текущей версии, отмена не предусмотрена.

Для заказов не предусмотрена функциональность выпуска моментальных купонов.

Коррекции баллов начисления и списания при возврате товаров оплаченной части заказа происходят пропорциональным образом.

При регистрации запросов оплаты заказов и отказа от части заказа нельзя допускать объединения позиций, если при создании заказа товары находились в разных позициях.

Для заказов недоступна функциональность обмена баллов на скидку.