Обработка заказов в Интернет-магазине
Модуль заказов в Manzana Loyalty Online позволяет автоматизировать процесс обработки заказов Интернет-магазинов и применять механики программ лояльности для поощрения покупателей.
C помощью модуля можно просматривать информацию о заказах: статус заказа, состав, сумму, размер скидки, примененные купоны, количество использованных и начисленных бонусов.
Детальный процесс приведён в описании интеграции по ссылке https://docs.manzanagroup.ru/xwiki/bin/view/loyalty/api/web/cash_register/order_functionality_request/.

Рис. Процесс обработки заказов из Интернет-магазина
Стандартная процедура заказа состоит из нескольких этапов:
1. В интернет-магазине покупатель добавляет товары в корзину и переходит на страницу чек-аута. В этот момент в Manzana Loyalty Online отправляется запрос на формирование корзины заказа (софт заказ). После обработки запроса на страницу чек-аута возвращается информация о доступных к применению скидках; количестве баллов, доступных к списанию для оплаты заказа; количестве баллов к начислению после оплаты заказа.
2. Когда покупатель нажимает на странице чек-аута кнопку "Оформить заказ", в Manzana Loyalty Online отправляется запрос на создание заказа (фискальный заказ). Номер заказа генерируется внешней системой. На основании запроса заказ записывается в базу данных. Если покупатель использовал баллы для оплаты заказа, они холдируются (использовать их для оплаты последующих заказов нельзя). Если использовался купон, он гасится.
В интерфейсе Manzana Loyalty Online в карточке контакта (вкладка «Покупки» -> раздел «Заказы») появляется запись заказа со статусом «Создан» и состоянием «Открыт».

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

Рис. Карточка заказа.
Поля вкладки «Позиции заказа»
| Поле | Описание |
| Заказ | Номер заказа |
| Номер позиции | Ссылка на позицию заказа |
| Товар | Ссылка на товар заказа |
| Артикул товара | Используется как внешний идентификатор при запросах заказа. Уникальное значение в рамках связи товар - партнёр. |
| Цена | Цена за единицу товара по прайсу |
| Количество товара | Количество товара в позиции |
| Сумма | Сумма товара в позиции заказа |
| Сумма со скидкой | Сумма товара в позиции заказа после применения скидки |
| Скидка | Размер применившейся скидки в процентах |
| Оплачено баллами | Часть суммы позиции, которая была оплачена баллами |
| Списано баллов | Сумма баллов, списанная на этапе создания заказа |
| Списано статусных баллов | Сумма статусных баллов, списанная на этапе создания заказа |
| Начислено баллов | Сумма баллов для начисления на этапе создания заказа |
| Начислено статусных баллов | Сумма статусных баллов для начисления на этапе создания заказа |
| Оплаченное количество | Количество оплаченного товара в позиции |
| Начислено баллов (факт.) | Окончательное значение баллов, начисленных за позицию заказа |
| Начислено статусных баллов (факт.) | Окончательное значение статусных баллов, начисленных за заказ |
| Списано баллов (факт.) | Окончательное значение списанных баллов после оплаты заказа |
| Списано статусных баллов (факт.) | Окончательное значение списанных статусных баллов после оплаты заказа |
3. После оформления заказа, но до оплаты, покупатель может заменить или удалить товары в заказе до его получения. Или может оказаться, если нужного товара нет на остатках склада – тогда замену инициирует продавец, а не покупатель. В этих случаях в Manzana Loyalty Online отправляется запрос на изменение заказа. При замене товара значения скидок пересматриваются в зависимости от признака пересчитываемости в правилах начисления, корректируется размер баллов для начисления и списания.
На этапе сборки заказа из-за отсутствия товаров в одном магазине, он может быть изменен на другой. В таком случае в запросе на изменение заказа (Update) указывается новый магазин в параметре <BusinessUnit>...</BusinessUnit>. Он же записывается в базу данных в поле «orgunit_id». При смене магазина меняется и POS. Новое значение подтягивается в поле БД «pos_id».
Если на заказ применялись непересчитываемые правила, то скидки и бонусы по этим правилам будут сохраняться. По пересчитываемым же правилам – будут меняться согласно текущим механикам, действующим в обновленном магазине. Если примененные правила не работают в данном магазине, поощрения по ним начислены не будут.
4. В модуле есть возможность отменить заказ или часть заказа, если по нему не было зафиксировано ни одной оплаты. При регистрации запроса отмены заказа холдированные для его оплаты баллы возвращаются на баланс покупателя, а использованные купоны восстанавливаются. Баллы для начисления за заказ отменяются.
5. Следующий этап - оплата заказа покупателем (доставка заказа). Заказ можно оплатить полностью или частично. При регистрации запроса оплаты заказа в Manzana Loyalty Online происходит списание холдированных баллов для оплаты заказа.
Статус заказа в интерфейсе Manzana Loyalty Online меняется на «Частично оплачен» (если была выкуплена часть заказа), или «Оплачен» (если был выкуплен весь заказ).
Каждая оплата (фискальный чек) отображается во вкладке «Оплаты заказа» карточки заказа. Начисляемые за заказ баллы поступают на баланс покупателя.

Рис. Вкладка «Оплаты заказа» в карточке заказа.
6. На этапе оплаты покупатель может отказаться от части заказа. В таких случаях в Manzana Loyalty Online отправляется запрос отказа от позиции. Холдированные для оплаты баллы возвращаются на баланс покупателя, а баллы для начисления за невыкупленную часть заказа отменяются.
7. Выполнение заказа (подтверждение оплаты и доставки заказа покупателю) фиксируется отправлением в Manzana Loyalty запроса закрытия заказа. При выполнении запроса, состояние заказа в интерфейсе Manzana Loyalty Online меняется с «Открыт» на «Закрыт».
8. Возврат заказа можно оформить до или после его закрытия. Возвращать можно только оплаченный заказ (или его оплаченную часть). При регистрации запроса возврата корректируется количество баллов начисления и списания за заказ.
Ограничения
При регистрации запросов заказов не предусмотрен таймаут для процессинга запросов.
Отмена (роллбэк) предусмотрена только для операции создания заказа. Для остальных операций, в текущей версии, отмена не предусмотрена.
Для заказов не предусмотрена функциональность выпуска моментальных купонов.
Коррекции баллов начисления и списания при возврате товаров оплаченной части заказа происходят пропорциональным образом.
При регистрации запросов оплаты заказов и отказа от части заказа нельзя допускать объединения позиций, если при создании заказа товары находились в разных позициях.
Для заказов недоступна функциональность обмена баллов на скидку.