Исходный код вики Заказы_SMC
Последние авторы
author | version | line-number | content |
---|---|---|---|
1 | |(% style="border-color:white; width:64px" %)[[image:attach:oder_icon.png]]|(% style="border-color:white; width:1378px" %)**Заказ** — это оформленный на сайте или в мобильном приложении запрос клиента на покупку товара или услуги. В отличие от чека, который фиксирует факт оплаты и перечень товаров, заказ содержит более широкий набор данных: информацию о клиенте, статусе выполнения и доставки, а также историю изменений. Заказы, также как и чеки, используются в построении пользовательских сегментов для последующей коммуникации с клиентами и служат основой для анализа покупательского поведения и формирования отчётов. | ||
2 | |||
3 | (% class="box infomessage" %) | ||
4 | ((( | ||
5 | * Блок **Заказы** — это отдельно подключаемая функциональность, которая не предоставляется по умолчанию. Для подключения функциональности обратитесь к специалистам Loymax. | ||
6 | * Видимость заказов в разных разделах Системы регулируется фича-флагом. Если фича-флаг активирован, становятся доступными соответствующие вкладки и функциональные возможности. | ||
7 | ))) | ||
8 | |||
9 | === Структура заказа === | ||
10 | |||
11 | |(% style="border-color:white; width:715px" %)Помимо стандартных данных, характерных для сущности чеков, заказы имеют следующие атрибуты:|(% style="border-color:white; text-align:center; width:727px" %)**Пример структуры заказа в запросе API для создания/изменения заказа** | ||
12 | |(% style="border-color:white; width:715px" %)((( | ||
13 | 1. **Статусы **— для каждого заказа доступно три типа статусов: | ||
14 | 1*. Общий: включает общие этапы жизненного цикла заказа. Например: принят, согласован, исполняется, завершён. | ||
15 | 1*. Статус доставки: включает этапы, связанные с доставкой заказа. Например: на пункте сборки, отгружен, на пункте выдачи заказа, выдан. | ||
16 | 1*. Статус оплаты: включает этапы, связанные с оплатой заказа. Например: выставлен счёт, ожидается оплата, оплачено. | ||
17 | 1. **Блок доставки** | ||
18 | 1*. Тип доставки: курьер, самовывоз, пункт выдачи заказа; | ||
19 | 1*. Провайдер: транспортная компания, осуществляющая доставку заказа; | ||
20 | 1*. Адрес: страна, город, улица; | ||
21 | 1*. Дата и время; | ||
22 | 1*. Комментарий клиента. | ||
23 | 1. **Блок оплаты** | ||
24 | 1*. Тип оплаты: карта, наличные, наложенный платёж; | ||
25 | 1*. Провайдер оплаты: может быть несколько разных провайдеров оплаты | ||
26 | 1*. Финансовая разбивка: | ||
27 | 1**. Общая сумма заказа; | ||
28 | 1**. Оплата наличными; | ||
29 | 1**. Оплата бонусами; | ||
30 | 1**. Стоимость доставки; | ||
31 | 1**. Скидка. | ||
32 | 1. **История статусов **— при каждом изменении статуса сохраняется: | ||
33 | 1*. Тип статуса (общий, доставка, оплата); | ||
34 | 1*. Дата; | ||
35 | 1*. Дополнительные данные: например, ожидаемая дата выдачи. | ||
36 | |||
37 | Все указанные атрибуты заказа могут быть использованы для коммуникации с клиентами через массовые рассылки и маркетинговые кампании. | ||
38 | )))|(% style="border-color:white; width:727px" %)((( | ||
39 | {{code language="xml"}} | ||
40 | { | ||
41 | "data": { | ||
42 | "attributes": { | ||
43 | "external_id": "1050", | ||
44 | "client_external_id": "724", | ||
45 | "date": "2020-07-03 17:30:22", | ||
46 | "number": "1218/112", | ||
47 | "items_cnt": 1, | ||
48 | "items_sum": 200.3, | ||
49 | "status_code": "new", <!--Общий статус.--> | ||
50 | "unit": "", | ||
51 | "actions": "", | ||
52 | "delivery": { | ||
53 | "status_code": "delivered", <!--Статус доставки.--> | ||
54 | "type": "", | ||
55 | "provider": "", | ||
56 | "country": "", | ||
57 | "city": "", | ||
58 | "address": "", | ||
59 | "date": "", | ||
60 | "time": "", | ||
61 | "note": "" | ||
62 | }, | ||
63 | "payment": { | ||
64 | "status_code": "paid", <!--Статус оплаты.--> | ||
65 | "type": "", | ||
66 | "provider": "", | ||
67 | "total": 200.3, | ||
68 | "cash": 190, | ||
69 | "bonuses": 15, | ||
70 | "delivery": 20, | ||
71 | "discount": 24.87 | ||
72 | }, | ||
73 | "items": [ | ||
74 | { | ||
75 | "external_id": "577", | ||
76 | "product_external_id": "789", | ||
77 | "cnt": 1, | ||
78 | "sum": 120, | ||
79 | "price": 120, | ||
80 | "quantity": 0, | ||
81 | "discount": 0, | ||
82 | "bonus_to_card": 0, | ||
83 | "bonus_from_card": 0, | ||
84 | "cash_sum": 0 | ||
85 | } | ||
86 | ], | ||
87 | "role": "BUSINESS_PARTNER", <!--Атрибут Role.--> | ||
88 | } | ||
89 | } | ||
90 | } | ||
91 | {{/code}} | ||
92 | ))) | ||
93 | |||
94 | Инструкции по работе с функциональностью заказов, читайте в соответсвующих разделах: | ||
95 | |||
96 | (% class="table-bordered" %) | ||
97 | |(% style="width:423px" %)((( | ||
98 | (% class="lead" %) | ||
99 | [[Статусы заказов>>doc:Sandbox.Order_statuses.WebHome]] | ||
100 | )))|(% style="width:1019px" %)((( | ||
101 | Просмотр и создание статусов для заказов доступно в разделе **Настройки > Статусы заказов**. | ||
102 | |||
103 | Для заказов предумотрено три типа статусов: | ||
104 | |||
105 | * Общий | ||
106 | * Статус доставки | ||
107 | * Статус оплаты | ||
108 | ))) | ||
109 | |(% style="width:423px" %)((( | ||
110 | (% class="lead" %) | ||
111 | [[Поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] | ||
112 | )))|(% style="width:1019px" %)((( | ||
113 | Раздел настройки полей позволяет управлять набором полей для заказов и строк заказов. Также доступна возможность [[управления представлениями>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.Views_management.WebHome]]: для заказов и строк заказов можно менять набор полей или их последовательность в профиле клиента. | ||
114 | ))) | ||
115 | |(% style="width:423px" %)((( | ||
116 | (% class="lead" %) | ||
117 | [[Триггеры >>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome]]для заказов | ||
118 | )))|(% style="width:1019px" %)((( | ||
119 | Для функциональности заказов доступны следующие триггеры: | ||
120 | |||
121 | * [[Дней с заказа>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41443D43543944143743043A430437430"]] | ||
122 | * [[Заказан продукт>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41743043A43043743043D43F44043E43444343A442"]] | ||
123 | * [[Заказан продукт из категории>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41743043A43043743043D43F44043E43444343A44243843743A43044243543343E440438438"]] | ||
124 | * [[Изменился статус заказа>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41843743C43543D43843B44144F44144243044244344143743043A430437430"]] | ||
125 | * [[Наступление даты для заказа>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41D43044144244343F43B43543D43843543443044244B43443B44F43743043A430437430"]] | ||
126 | * [[Сделан заказ>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H42143443543B43043D43743043A430437"]] | ||
127 | ))) | ||
128 | |(% style="width:423px" %)((( | ||
129 | (% class="lead" %) | ||
130 | [[Профиль клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41F44043E44443843B44C43A43B43843543D442430"]] | ||
131 | )))|(% style="width:1019px" %)((( | ||
132 | * При подключенной функциональности заказов в профиле клиента отображается отдельная вкладка для [[заказов>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41743043A43043744B"]], где выводится подробная информация о всех заказах клиента, включая информацию об оплате (есть ли чек или заказ ещё не оплачен), доставке, количестве и стоимости продуктов в заказе. | ||
133 | * Во вкладке [[Активность>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41043A44243843243D43E44144244C"]] профиля клиента также отображается информация о заказах клиента. | ||
134 | * Для заказов, статусы которых учитываются в статистике и построении отчётов, в профиле клиента доступны следущие [[метрики>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.Metrics.WebHome]]: | ||
135 | ** Количество заказов, | ||
136 | ** Сделал заказов на сумму, | ||
137 | ** Средний заказ, | ||
138 | ** Среднее количество товаров в заказе. | ||
139 | ))) | ||
140 | |(% style="width:423px" %)((( | ||
141 | (% class="lead" %) | ||
142 | [[Построитель сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]] | ||
143 | )))|(% style="width:1019px" %)((( | ||
144 | Построитель сегментов включает следующие фильтры для заказов: | ||
145 | |||
146 | * **Клиент** | ||
147 | ** Количество заказов, | ||
148 | ** Количество атрибутированных заказов, | ||
149 | ** Дата первого/последнего заказа, | ||
150 | ** Дней с первого/последнего заказа, | ||
151 | ** Средняя сумма заказа, | ||
152 | ** Среднее количество товаров в заказе, | ||
153 | ** Сделал заказов на сумму, | ||
154 | ** Стоимость последнего заказа, | ||
155 | ** Медианная сумма заказа, | ||
156 | ** Средняя цена товара в заказе, | ||
157 | * **Заказ** | ||
158 | * **Состав заказа** | ||
159 | * **Товар в заказе** | ||
160 | * **Категория товара в заказе** | ||
161 | * **Взаимодействие** | ||
162 | ))) | ||
163 | |(% style="width:423px" %)((( | ||
164 | (% class="lead" %) | ||
165 | [[Макросы в шаблонизаторе>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome||anchor="H42143844144243543C43D44B43543F43544043543C43543D43D44B435"]] | ||
166 | )))|(% style="width:1019px" %)((( | ||
167 | Для кастомизации текста сообщений в [[массовых рассылках>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]] и [[кампаниях>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]] для функциональности заказов доступна поддержка следующих макросов в шаблонизаторе: | ||
168 | |||
169 | * Количество заказов клиента | ||
170 | * Общая сумма всех заказов клиента | ||
171 | * Дата первого/последнего заказа клиента | ||
172 | * Номер первого/последнего заказа клиента | ||
173 | * Значение атрибута в первом/последнем заказе клиента | ||
174 | * Содержимое первого/последнего заказа | ||
175 | ))) | ||
176 | |(% style="width:423px" %)((( | ||
177 | (% class="lead" %) | ||
178 | Методы API для работы с заказами | ||
179 | )))|(% style="width:1019px" %)п10 | ||
180 | |(% style="width:423px" %)((( | ||
181 | (% class="lead" %) | ||
182 | Аналитика и отчёты | ||
183 | )))|(% style="width:1019px" %)((( | ||
184 | Добавить во всех отчетах (включая дашборд), которые раньше были по чекам переключатель: Чеки/Заказы. | ||
185 | |||
186 | Дорабатываем все отчеты (включая дашборд), в которых есть чеки так, чтобы они научились работать в 2 режимах: по чекам (как раньше) и по заказам (новый режим). В зависимости от значения переключателя из предыдущего пункта считаем отчет по чекам, либо по заказам. Важно: заказы в отчет должны попадать не все, а только те, которые находятся в учитываемых статусах (например, Завершен, Выкуплен). То, в каких статусах заказы попадают в статистику, а в каких не попадают, должно задаваться в настройках. | ||
187 | |||
188 | |||
189 | |||
190 | * (% style="font-size: 11pt; font-variant: normal; white-space: pre-wrap; font-family: Arial, sans-serif; color: rgb(0, 0, 0); font-weight: 400; font-style: normal; text-decoration: none" %)В Smart реализован тумблер "чеки / заказы" во всех отчётах (воронка, атрибуция, ссылки) | ||
191 | * (% style="font-size: 11pt; font-variant: normal; white-space: pre-wrap; font-family: Arial, sans-serif; color: rgb(0, 0, 0); font-weight: 400; font-style: normal; text-decoration: none" %)Можно выбрать, что отображать: данные по чекам или по заказам | ||
192 | * (% style="font-size: 11pt; font-variant: normal; white-space: pre-wrap; font-family: Arial, sans-serif; color: rgb(0, 0, 0); font-weight: 400; font-style: normal; text-decoration: none" %)В отчётах учитываются только заказы в статусах, отмеченных как "участвуют в аналитике" | ||
193 | * (% style="font-size: 11pt; font-variant: normal; white-space: pre-wrap; font-family: Arial, sans-serif; color: rgb(0, 0, 0); font-weight: 400; font-style: normal; text-decoration: none" %)Это задаётся в настройках: какие статусы включаются в расчёты | ||
194 | ))) | ||
195 | |(% style="width:423px" %)((( | ||
196 | (% class="lead" %) | ||
197 | Атрибуция | ||
198 | )))|(% style="width:1019px" %)п9 | ||
199 | |(% style="width:423px" %)((( | ||
200 | (% class="lead" %) | ||
201 | Экспорт в файл | ||
202 | )))|(% style="width:1019px" %)((( | ||
203 | На контекстные меню зелёной кнопки "Экспорт в файл" добавить управление видимостью: экспорт чеков (+ строк чеков) / заказов (+строк заказов) должны быть видны в зависимости от значения фича-флага. | ||
204 | |||
205 | Во всех местах, где есть зеленые кнопки выгрузки "Экспорт в файл" (в частности в списках клиентов) добавить возможность выгрузки заказов и строк заказов. | ||
206 | ))) | ||
207 | |||
208 | (% class="root-extension__layer-composer" %) | ||
209 | ((( | ||
210 | |||
211 | ))) |