Исходный код вики Заказы_SMC

Последние авторы
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 Все указанные атрибуты заказа могут быть использованы для коммуникации с клиентами через [[массовые рассылки>>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]] и маркетинговые [[кампании>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]].
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 ** Статус,
164 ** Номер,
165 ** Количество продуктов,
166 ** Стоимость продуктов,
167 ** Торговый объект,
168 ** Акции,
169 ** Карта,
170 ** Статус доставки,
171 ** Тип доставки,
172 ** Провайдер доставки,
173 ** Страна доставки,
174 ** Город доставки,
175 ** Адрес доставки,
176 ** Дата доставки,
177 ** Вермя доставки,
178 ** Комментарий к доставке,
179 ** Статус оплаты,
180 ** Тип оплаты,
181 ** Оплачено всего,
182 ** Оплачено деньгами,
183 ** Оплачено бонусами,
184 ** Стоимость доставки,
185 ** Размер скидки.
186 * **Состав заказа**
187 ** Средняя цена товара,
188 ** Идентификатор,
189 ** Количество,
190 ** Стоимость,
191 ** Цена,
192 ** Вес единицы,
193 ** Скидка,
194 ** Добавлено бонусов,
195 ** Списано бонусов,
196 ** Сумма наличных.
197 * **Взаимодействие**
198 ** Заказыва по email- рассылке,
199 ** Заказывал по SMS-рассылке,
200 ** Заказывал по push-рассылке,
201 ** Заказывал по кампании.
202 )))
203 |(% style="width:423px" %)(((
204 (% class="lead" %)
205 [[Макросы в шаблонизаторе>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome||anchor="H42143844144243543C43D44B43543F43544043543C43543D43D44B435"]]
206 )))|(% style="width:1019px" %)(((
207 Для кастомизации текста сообщений в [[массовых рассылках>>doc:Main.Using.Smart_Communications.Mass_mailings.Template_builder.WebHome]] и [[кампаниях>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]] для функциональности заказов доступна поддержка следующих макросов в шаблонизаторе:
208
209 * Количество заказов клиента
210 * Общая сумма всех заказов клиента
211 * Дата первого/последнего заказа клиента
212 * Номер первого/последнего заказа клиента
213 * Значение атрибута в первом/последнем заказе клиента
214 * Содержимое первого/последнего заказа
215 )))
216 |(% style="width:423px" %)(((
217 (% class="lead" %)
218 [[Методы API для работы с заказами>>doc:Sandbox.Eorder.WebHome]]
219 )))|(% style="width:1019px" %)(((
220 Для работы с заказами доступны следующие методы API:
221
222 * [[GET /eorder>>doc:Sandbox.Eorder.WebHome||anchor="H41F43E43B44344743844244C44143F43844143E43A43743043A43043743E432"]] — получить список заказов;
223 * [[GET /eorder/:external_id >>doc:Sandbox.Eorder.WebHome||anchor="H41F43E43B44344743844244C43743043A430437"]]— получить заказ по идентификатору заказа в мастер-системе;
224 * [[GET /customer/:external_id/eorder>>doc:Sandbox.Eorder.WebHome||anchor="H41F43E43B44344743844244C44143F43844143E43A43743043A43043743E43243A43B43843543D442430"]] — получить список заказов клиента по идентификатору клиента в мастер-системе;
225 * [[POST /eorder/:external_id>>doc:Sandbox.Eorder.WebHome||anchor="H42143E43743443044244C2F43843743C43543D43844244C43743043A430437"]] — создать/изменить заказ;
226 * [[POST /eorder/:external_id/status>>doc:Sandbox.Eorder.WebHome||anchor="H41E43143D43E43243844244C44144243044244344143743043A430437430"]] — обновить статус заказа;
227 * [[DELETE /eorder/:external_id>>doc:Sandbox.Eorder.WebHome||anchor="H42343443043B43844244C43743043A430437"]] — удалить заказ.
228 )))
229 |(% style="width:423px" %)(((
230 (% class="lead" %)
231 Аналитика и отчёты
232 )))|(% style="width:1019px" %)(((
233 Во всех отчётах [[массовых рассылок>>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]], а также сводные отчёты из раздела **Аналитика **доступна возможность переключаться между чеками и заказми (при условии, что подключены обе функциональности).
234
235 (% class="box infomessage" %)
236 (((
237 В отчётах учитываются только заказы в статусах, которые при создании/редактировании были отмечены флагом **Учёт в аналитике**. Создание статусов заказов доступно в разделе [[Настройки ~> Статусы заказов>>doc:Sandbox.Order_statuses.WebHome]].
238 )))
239 )))
240 |(% style="width:423px" %)(((
241 (% class="lead" %)
242 [[Атрибуция >>doc:Main.Using.Smart_Communications.Receipt_attribution.WebHome]]
243 )))|(% style="width:1019px" %)По аналогии с функциональностью чеков, доступна возможность атрибуции заказов для [[массовых рассылок >>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]]и [[кампаний>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]]. **Атрибуция заказов** — это правила, позволяющие связать заказы с отправленными коммуникациями клиенту.
244 |(% style="width:423px" %)(((
245 (% class="lead" %)
246 [[Экспорт в файл>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome||anchor="02"]]
247 )))|(% style="width:1019px" %)(((
248 В списках клиентов в [[Построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]], а также в сводных отчётах раздела **Аналитика** доступна возможность выгружать в файл информацию по заказам и строкам заказов.
249 )))
250
251 (% class="root-extension__layer-composer" %)
252 (((
253
254 )))
Создано 20/05/2025 13:05
Отредактировано 27/05/2025 07:15