Loymax, 2025

Изменения документа Заказы

От версии < 8.1 >

отредактировано Вера Ретьева
на 23/05/2025 08:46

К версии < 41.1 >

отредактировано Вера Ретьева
на 03/06/2025 10:19

Изменить комментарий: К данной версии нет комментариев

Необработанный
Обработанный

Комментарий

Свойства страницы (2 изменено, 0 добавлено, 0 удалено)
Вложения (0 изменено, 1 добавлено, 0 удалено)
- oder_icon.png

Подробности

Свойства страницы

Название

@@ -1,1 +1,1 @@
--Заказы_SMC
++Заказы

Содержимое

@@ -1,7 +1,5 @@
--(% class="root-extension__layer-composer" %)
--(((
--[[image:https://docs.loymax.net/xwiki/bin/get/Sandbox/Orders/?sheet=CKEditor.ResourceDispatcher&outputSyntax=plain&language=ru&type=attach&typed=true&reference=Orders.png||height="38" width="35"]]**Заказ** — это оформленный на сайте или в мобильном приложении запрос клиента на покупку товара или услуги. В отличие от чека, который фиксирует факт оплаты и перечень товаров, заказ содержит более широкий набор данных: информацию о клиенте, применённых скидках, статусе выполнения, а также историю изменений. Заказы, также как и чеки, используются в построении пользовательских сегментов для последующей коммуникации с клиентами и служат основой для анализа покупательского поведения и формирования отчётов.
--)))
++(% class="lead" %)
++**Заказ** — это оформленный на сайте или в мобильном приложении запрос клиента на покупку товара или услуги.
  (% class="box infomessage" %)
  (((
@@ -9,27 +9,119 @@
  * Видимость заказов в разных разделах Системы регулируется фича-флагом. Если фича-флаг активирован, становятся доступными соответствующие вкладки и функциональные возможности.
  )))
++В отличие от[[ чека>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H42743543A438"]], который фиксирует факт оплаты и перечень товаров, [[заказ>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41743043A43043744B"]] содержит более широкий набор данных: информацию о клиенте, статусах выполнения, оплаты и доставки, а также историю изменений. Заказы, также как и чеки, используются в построении сегментов для последующей [[коммуникации>>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]] с клиентами и служат основой для анализа покупательского поведения и формирования [[отчётов>>doc:Main.Using.Smart_Communications.Mass_mailings.Mailing_report.WebHome]].
--Инструкции по работе с функциональностью заказов, читайте в соответсвующих разделах:
++=== Структура заказа ===
++|(% style="border-color:white; width:715px" %)Помимо стандартных данных, характерных для сущности чеков, заказы имеют следующие атрибуты:|(% style="border-color:white; text-align:center; width:727px" %)
++|(% style="border-color:white; width:715px" %)(((
++1.  **Статусы **— для каждого заказа доступно три типа статусов:
++1*. **Общий**: включает общие этапы жизненного цикла заказа. Например: принят, согласован, исполняется, завершён.
++1*. **Статус доставки**: включает этапы, связанные с доставкой заказа. Например: собирается, отгружен, на пункте выдачи заказа, выдан.
++1*. **Статус оплаты**: включает этапы, связанные с оплатой заказа. Например: выставлен счёт, ожидается оплата, оплачено.
++1. **Блок доставки**
++1*. Тип доставки: курьер, самовывоз, пункт выдачи заказа;
++1*. Провайдер: транспортная компания, осуществляющая доставку заказа;
++1*. Адрес: страна, город, улица;
++1*. Дата и время;
++1*. Комментарий клиента.
++1. **Блок оплаты**
++1*. Тип оплаты: карта, наличные, наложенный платёж;
++1*. Провайдер оплаты: может быть несколько разных провайдеров оплаты;
++1*. Финансовая разбивка:
++1**. Общая сумма заказа;
++1**. Оплата наличными;
++1**. Оплата бонусами;
++1**. Стоимость доставки;
++1**. Скидка.
++1. **История статусов **— при каждом изменении статуса сохраняется:
++1*. Тип статуса (общий, доставка, оплата);
++1*. Дата;
++1*. Дополнительные данные: например, ожидаемая дата выдачи.
++
++Все указанные атрибуты заказа могут быть использованы для коммуникации с клиентами через [[массовые рассылки>>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]] и маркетинговые [[кампании>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]].
++)))|(% style="border-color:white; width:727px" %)(((
++
++)))
++
++{{showhide showmessage="Показать пример структуры заказа в запросе REST API" hidemessage="Скрыть пример структуры заказа"}}
++(((
++{{code language="xml"}}
++{
++    "data": {
++         "attributes": {
++              "external_id": "1050",
++              "client_external_id": "724",
++              "date": "2020-07-03 17:30:22",
++              "number": "1218/112",
++              "items_cnt": 1,
++              "items_sum": 200.3,
++              "status_code": "new", <!--Общий статус.-->
++              "unit": "",
++              "actions": "",
++              "delivery": {
++                   "status_code": "delivered", <!--Статус доставки.-->
++                   "type": "",
++                   "provider": "",
++                   "country": "",
++                   "city": "",
++                   "address": "",
++                   "date": "",
++                   "time": "",
++                   "note": ""
++              },
++              "payment": {
++                   "status_code": "paid", <!--Статус оплаты.-->
++                   "type": "",
++                   "provider": "",
++                   "total": 200.3,
++                   "cash": 190,
++                   "bonuses": 15,
++                   "delivery": 20,
++                   "discount": 24.87
++              },
++              "items": [
++                   {
++                        "external_id": "577",
++                        "product_external_id": "789",
++                        "cnt": 1,
++                        "sum": 120,
++                        "price": 120,
++                        "quantity": 0,
++                        "discount": 0,
++                        "bonus_to_card": 0,
++                        "bonus_from_card": 0,
++                        "cash_sum": 0
++                   }
++              ],
++              "role": "BUSINESS_PARTNER", <!--Атрибут роли.-->
++         }
++    }
++}
++{{/code}}
++)))
++{{/showhide}}
++
++==== Инструкции по работе с функциональностью заказов, читайте в соответствующих разделах: ====
++
  (% class="table-bordered" %)
  |(% style="width:423px" %)(((
  (% class="lead" %)
  [[Статусы заказов>>doc:Sandbox.Order_statuses.WebHome]]
  )))|(% style="width:1019px" %)(((
--Создание статусов для заказов доступно в разделе **Настройки > Статусы заказов**, где также отображается список всех созданных статусов. Для заказов предумотрено три типа статусов:
++Просмотр и создание статусов для заказов доступно в разделе **Настройки > Статусы заказов**.
++Для заказов предумотрено три типа статусов:
++
  * Общий
--* Статус доставки,
--* Статус оплаты.
++* Статус доставки
++* Статус оплаты
  )))
  |(% style="width:423px" %)(((
  (% class="lead" %)
--Поля
++[[Поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]]
  )))|(% style="width:1019px" %)(((
--п.19 В редакторе полей добавить управление видимостью: вкладки управления полями в заказах / чеках должны быть видны в зависимости от значения фича-флага.
--
--
++Раздел настройки полей позволяет управлять набором полей для заказов и строк заказов. Также доступна возможность [[управления отображением полей>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.Views_management.WebHome]]: для заказов и строк заказов можно менять набор полей или их последовательность в профиле клиента.
  )))
  |(% style="width:423px" %)(((
  (% class="lead" %)
@@ -48,7 +48,7 @@
  (% class="lead" %)
  [[Профиль клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41F44043E44443843B44C43A43B43843543D442430"]]
  )))|(% style="width:1019px" %)(((
--* При подключенной функциональности заказов (фича-флаг для заказов должен быть включен) в профиле клиента отображается отдельная вкладка для [[заказов>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41743043A43043744B"]], где выводится подробная информация о всех заказах клиента, включая информацию об оплате (есть ли чек или заказ ещё не оплачен), доставке, количестве и стоимости продуктов в заказе.
++* При подключенной функциональности заказов в профиле клиента отображается отдельная вкладка для [[заказов>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41743043A43043744B"]], где выводится подробная информация о всех заказах клиента, включая информацию об оплате, доставке, количестве и стоимости продуктов в заказе.
  * Во вкладке [[Активность>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41043A44243843243D43E44144244C"]] профиля клиента также отображается информация о заказах клиента.
  * Для заказов, статусы которых учитываются в статистике и построении отчётов, в профиле клиента доступны следущие [[метрики>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.Metrics.WebHome]]:
  ** Количество заказов,
@@ -58,11 +58,57 @@
  )))
  |(% style="width:423px" %)(((
  (% class="lead" %)
--Построитель сегментов
++[[Построитель сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]]
  )))|(% style="width:1019px" %)(((
--В построителе сегментов добавить управление видимостью: фильтры по заказам / чекам должны быть видны в зависимости от значения фича-флага.
++Для сегментации клиентов с использованием данных о заказах, в Построителе сегментов доступны следующие фильтры:
--
++* **Клиент**
++** Количество заказов,
++** Количество атрибутированных заказов,
++** Дата первого/последнего заказа,
++** Дней с первого/последнего заказа,
++** Средняя сумма заказа,
++** Среднее количество товаров в заказе,
++** Сделал заказов на сумму,
++** Стоимость последнего заказа,
++** Медианная сумма заказа,
++** Средняя цена товара в заказе,
++* **Заказ**
++** Последний статус заказа/доставки/оплаты,
++** Идентификатор,
++** Дата,
++** Статус,
++** Номер,
++** Количество/стоимость продуктов,
++** Торговый объект,
++** Акции,
++** Карта,
++** Статус/тип доставки,
++** Провайдер доставки,
++** Страна/город/адрес доставки,
++** Дата/время доставки,
++** Комментарий к доставке,
++** Статус/тип оплаты,
++** Оплачено всего,
++** Оплачено деньгами/бонусами,
++** Стоимость доставки,
++** Размер скидки.
++* **Состав заказа**
++** Средняя цена товара,
++** Идентификатор,
++** Количество,
++** Стоимость,
++** Цена,
++** Вес единицы,
++** Скидка,
++** Добавлено бонусов,
++** Списано бонусов,
++** Сумма наличных.
++* **Взаимодействие**
++** Заказыва по email- рассылке,
++** Заказывал по SMS-рассылке,
++** Заказывал по push-рассылке,
++** Заказывал по кампании.
  )))
  |(% style="width:423px" %)(((
  (% class="lead" %)
@@ -79,24 +79,39 @@
  )))
  |(% style="width:423px" %)(((
  (% class="lead" %)
--Методы API для работы с заказами
--)))|(% style="width:1019px" %)п10
++[[Методы API для работы с заказами>>doc:Sandbox.Eorder.WebHome]]
++)))|(% style="width:1019px" %)(((
++Для работы с заказами доступны следующие методы API:
++
++* [[GET /eorder>>doc:Sandbox.Eorder.WebHome||anchor="H41F43E43B44344743844244C44143F43844143E43A43743043A43043743E432"]] — получить список заказов;
++* [[GET /eorder/:external_id >>doc:Sandbox.Eorder.WebHome||anchor="H41F43E43B44344743844244C43743043A430437"]]— получить заказ по внешнему идентификатору;
++* [[GET /customer/:external_id/eorder>>doc:Sandbox.Eorder.WebHome||anchor="H41F43E43B44344743844244C44143F43844143E43A43743043A43043743E43243A43B43843543D442430"]] — получить список заказов клиента по внешнему идентификатору клиента;
++* [[POST /eorder/:external_id>>doc:Sandbox.Eorder.WebHome||anchor="H42143E43743443044244C2F43843743C43543D43844244C43743043A430437"]] — создать/изменить заказ;
++* [[POST /eorder/:external_id/status>>doc:Sandbox.Eorder.WebHome||anchor="H41E43143D43E43243844244C44144243044244344143743043A430437430"]] — обновить статус заказа;
++* [[DELETE /eorder/:external_id>>doc:Sandbox.Eorder.WebHome||anchor="H42343443043B43844244C43743043A430437"]] — удалить заказ;
++* [[POST /eorder>>doc:Sandbox.Eorder.WebHome||anchor="H42043543343844144244043044643844F43743043A430437430"]] — зарегистрировать заказ;
++* [[POST /eorder/:external_id/toorder>>doc:Sandbox.Eorder.WebHome||anchor="H41F44043843244F43743044244C43743043A43043743A44743543A443"]] — привязать заказ к чеку.
++)))
  |(% style="width:423px" %)(((
  (% class="lead" %)
--Аналитика и отчёт
++Аналитика и отчёты
  )))|(% style="width:1019px" %)(((
--Добавить во всех отчетах (включая дашборд), которые раньше были по чекам переключатель: Чеки/Заказы.
++Во всех отчётах [[массовых рассылок>>doc:Main.Using.Smart_Communications.Mass_mailings.Mailing_report.WebHome]], [[кампаний>>doc:Main.Using.Smart_Communications.Campaign_list.Campaign_report.WebHome]], включая [[дашборд>>doc:Main.Using.Smart_Communications.Review.WebHome]], а также сводные отчёты из раздела **Аналитика **доступна возможность переключаться между чеками и заказами (при условии, что подключены обе функциональности).
--Дорабатываем все отчеты (включая дашборд), в которых есть чеки так, чтобы они научились работать в 2 режимах: по чекам (как раньше) и по заказам (новый режим). В зависимости от значения переключателя из предыдущего пункта считаем отчет по чекам, либо по заказам. Важно: заказы в отчет должны попадать не все, а только те, которые находятся в учитываемых статусах (например, Завершен, Выкуплен). То, в каких статусах заказы попадают в статистику, а в каких не попадают, должно задаваться в настройках.
++(% class="box infomessage" %)
++(((
++В отчётах учитываются только заказы в статусах, которые при создании/редактировании были отмечены флагом **Учёт в аналитике**. Создание статусов заказов доступно в разделе [[Настройки ~> Статусы заказов>>doc:Sandbox.Order_statuses.WebHome]].
  )))
++)))
  |(% style="width:423px" %)(((
  (% class="lead" %)
--Атрибуция
--)))|(% style="width:1019px" %)п9
--|(% style="width:423px" %)Экспорт в фай|(% style="width:1019px" %)(((
--На контекстные меню зелёной кнопки "Экспорт в файл" добавить управление видимостью: экспорт чеков (+ строк чеков) / заказов (+строк заказов) должны быть видны в зависимости от значения фича-флага.
--
--Во всех местах, где есть зеленые кнопки выгрузки "Экспорт в файл" (в частности в списках клиентов) добавить возможность выгрузки заказов и строк заказов.
++[[Атрибуция >>doc:Main.Using.Smart_Communications.Receipt_attribution.WebHome]]
++)))|(% style="width:1019px" %)По аналогии с функциональностью чеков, доступна возможность атрибуции заказов для [[массовых рассылок >>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]]и [[кампаний>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]]. **Атрибуция заказов** — это правила, позволяющие связать заказы с отправленными коммуникациями клиенту.
++|(% style="width:423px" %)(((
++(% class="lead" %)
++[[Экспорт в файл>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome||anchor="02"]]
++)))|(% style="width:1019px" %)(((
++В списках клиентов в [[Построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]], а также в сводных отчётах раздела **Аналитика** доступна возможность выгружать в файл информацию по заказам и строкам заказов.
  )))
  (% class="root-extension__layer-composer" %)

oder_icon.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.vretyeva

Размер

...	...	@@ -1,0 +1,1 @@
	1	+1.8 KB

Содержимое

Создано 20/05/2025 13:05
Отредактировано 19/06/2025 09:49

Новости
Обновления
Облако тегов
Словарь
Наш блог
YouTube и Rutube
Telegram

Навигация

Изменения документа Заказы

Комментарий

Подробности