Изменения документа Заказы
<
>
отредактировано Вера Ретьева
на 23/05/2025 12:54
на 23/05/2025 12:54
отредактировано Вера Ретьева
на 03/06/2025 10:19
на 03/06/2025 10:19
Изменить комментарий:
К данной версии нет комментариев
Комментарий
-
Свойства страницы (2 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Название
-
... ... @@ -1,1 +1,1 @@ 1 -Заказы _SMC1 +Заказы - Содержимое
-
... ... @@ -1,10 +1,6 @@ 1 -|(% style="border-color:white; width:64px" %)[[image:attach:oder_icon.png]]|(% style="border-color:white; width:1378px" %)**Заказ** — это оформленный на сайте или в мобильном приложении запрос клиента на покупку товара или услуги. В отличие от чека, который фиксирует факт оплаты и перечень товаров, заказ содержит более широкий набор данных: информацию о клиенте, статусе выполнения и доставки, а также историю изменений. Заказы, также как и чеки, используются в построении пользовательских сегментов для последующей коммуникации с клиентами и служат основой для анализа покупательского поведения и формирования отчётов. 1 +(% class="lead" %) 2 +**Заказ** — это оформленный на сайте или в мобильном приложении запрос клиента на покупку товара или услуги. 2 2 3 -(% class="root-extension__layer-composer" %) 4 -((( 5 - 6 -))) 7 - 8 8 (% class="box infomessage" %) 9 9 ((( 10 10 * Блок **Заказы** — это отдельно подключаемая функциональность, которая не предоставляется по умолчанию. Для подключения функциональности обратитесь к специалистам Loymax. ... ... @@ -11,14 +11,16 @@ 11 11 * Видимость заказов в разных разделах Системы регулируется фича-флагом. Если фича-флаг активирован, становятся доступными соответствующие вкладки и функциональные возможности. 12 12 ))) 13 13 10 +В отличие от[[ чека>>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]]. 11 + 14 14 === Структура заказа === 15 15 16 -|(% style="border-color:white; width:715px" %)Помимо стандартных данных, характерных для сущности чеков, заказы имеют следующие атрибуты:|(% style="border-color:white; text-align:center; width:727px" %) **Примерструктуры заказа в запросе API для создания/изменения заказа**14 +|(% style="border-color:white; width:715px" %)Помимо стандартных данных, характерных для сущности чеков, заказы имеют следующие атрибуты:|(% style="border-color:white; text-align:center; width:727px" %) 17 17 |(% style="border-color:white; width:715px" %)((( 18 -1. **Статусы **— для каждого заказа доступно три типа статусов: 19 -1*. Общий: включает общие этапы жизненного цикла заказа. Например: принят, согласован, исполняется, завершён. 20 -1*. Статус доставки: включает этапы, связанные с доставкой заказа. Например: на пунктесборки, отгружен, на пункте выдачи заказа, выдан.21 -1*. Статус оплаты: включает этапы, связанные с оплатой заказа. Например: выставлен счёт, ожидается оплата, оплачено. 16 +1. **Статусы **— для каждого заказа доступно три типа статусов: 17 +1*. **Общий**: включает общие этапы жизненного цикла заказа. Например: принят, согласован, исполняется, завершён. 18 +1*. **Статус доставки**: включает этапы, связанные с доставкой заказа. Например: собирается, отгружен, на пункте выдачи заказа, выдан. 19 +1*. **Статус оплаты**: включает этапы, связанные с оплатой заказа. Например: выставлен счёт, ожидается оплата, оплачено. 22 22 1. **Блок доставки** 23 23 1*. Тип доставки: курьер, самовывоз, пункт выдачи заказа; 24 24 1*. Провайдер: транспортная компания, осуществляющая доставку заказа; ... ... @@ -27,7 +27,7 @@ 27 27 1*. Комментарий клиента. 28 28 1. **Блок оплаты** 29 29 1*. Тип оплаты: карта, наличные, наложенный платёж; 30 -1*. Провайдер оплаты: может быть несколько разных провайдеров оплаты 28 +1*. Провайдер оплаты: может быть несколько разных провайдеров оплаты; 31 31 1*. Финансовая разбивка: 32 32 1**. Общая сумма заказа; 33 33 1**. Оплата наличными; ... ... @@ -37,10 +37,15 @@ 37 37 1. **История статусов **— при каждом изменении статуса сохраняется: 38 38 1*. Тип статуса (общий, доставка, оплата); 39 39 1*. Дата; 40 -1*. Дополнительные данные: например, ожидаемая дата выдачи ).38 +1*. Дополнительные данные: например, ожидаемая дата выдачи. 41 41 42 -Все указанные атрибуты заказа могут быть использованы для коммуникации с клиентами через массовые рассылки и маркетинговые кампании. 40 +Все указанные атрибуты заказа могут быть использованы для коммуникации с клиентами через [[массовые рассылки>>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]] и маркетинговые [[кампании>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]]. 43 43 )))|(% style="border-color:white; width:727px" %)((( 42 + 43 +))) 44 + 45 +{{showhide showmessage="Показать пример структуры заказа в запросе REST API" hidemessage="Скрыть пример структуры заказа"}} 46 +((( 44 44 {{code language="xml"}} 45 45 { 46 46 "data": { ... ... @@ -89,14 +89,15 @@ 89 89 "cash_sum": 0 90 90 } 91 91 ], 92 - "role": "BUSINESS_PARTNER", <!--Атрибут Role.-->95 + "role": "BUSINESS_PARTNER", <!--Атрибут роли.--> 93 93 } 94 94 } 95 95 } 96 96 {{/code}} 97 97 ))) 101 +{{/showhide}} 98 98 99 -Инструкции по работе с функциональностью заказов, читайте в соответсвующих разделах: 103 +==== Инструкции по работе с функциональностью заказов, читайте в соответствующих разделах: ==== 100 100 101 101 (% class="table-bordered" %) 102 102 |(% style="width:423px" %)((( ... ... @@ -113,11 +113,9 @@ 113 113 ))) 114 114 |(% style="width:423px" %)((( 115 115 (% class="lead" %) 116 -Поля 120 +[[Поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] 117 117 )))|(% style="width:1019px" %)((( 118 -В редакторе полей добавить управление видимостью: вкладки управления полями в заказах / чеках должны быть видны в зависимости от значения фича-флага. 119 - 120 - 122 +Раздел настройки полей позволяет управлять набором полей для заказов и строк заказов. Также доступна возможность [[управления отображением полей>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.Views_management.WebHome]]: для заказов и строк заказов можно менять набор полей или их последовательность в профиле клиента. 121 121 ))) 122 122 |(% style="width:423px" %)((( 123 123 (% class="lead" %) ... ... @@ -136,7 +136,7 @@ 136 136 (% class="lead" %) 137 137 [[Профиль клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41F44043E44443843B44C43A43B43843543D442430"]] 138 138 )))|(% style="width:1019px" %)((( 139 -* При подключенной функциональности заказов (фича-флаг для заказовдолжен быть включен) впрофиле клиента отображается отдельная вкладка для [[заказов>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41743043A43043744B"]], где выводится подробная информация о всех заказах клиента, включая информацию об оплате(есть ли чек или заказ ещё не оплачен), доставке, количестве и стоимости продуктов в заказе.141 +* При подключенной функциональности заказов в профиле клиента отображается отдельная вкладка для [[заказов>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41743043A43043744B"]], где выводится подробная информация о всех заказах клиента, включая информацию об оплате, доставке, количестве и стоимости продуктов в заказе. 140 140 * Во вкладке [[Активность>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="H41043A44243843243D43E44144244C"]] профиля клиента также отображается информация о заказах клиента. 141 141 * Для заказов, статусы которых учитываются в статистике и построении отчётов, в профиле клиента доступны следущие [[метрики>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.Metrics.WebHome]]: 142 142 ** Количество заказов, ... ... @@ -146,11 +146,57 @@ 146 146 ))) 147 147 |(% style="width:423px" %)((( 148 148 (% class="lead" %) 149 -Построитель сегментов 151 +[[Построитель сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]] 150 150 )))|(% style="width:1019px" %)((( 151 - В построителесегментов добавитьуправлениевидимостью:фильтрыпо заказам/чекам должны бытьвидныв зависимости от значенияфича-флага.153 +Для сегментации клиентов с использованием данных о заказах, в Построителе сегментов доступны следующие фильтры: 152 152 153 - 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 +** Заказывал по кампании. 154 154 ))) 155 155 |(% style="width:423px" %)((( 156 156 (% class="lead" %) ... ... @@ -167,27 +167,39 @@ 167 167 ))) 168 168 |(% style="width:423px" %)((( 169 169 (% class="lead" %) 170 -Методы API для работы с заказами 171 -)))|(% style="width:1019px" %)п10 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 +* [[POST /eorder>>doc:Sandbox.Eorder.WebHome||anchor="H42043543343844144244043044643844F43743043A430437430"]] — зарегистрировать заказ; 229 +* [[POST /eorder/:external_id/toorder>>doc:Sandbox.Eorder.WebHome||anchor="H41F44043843244F43743044244C43743043A43043743A44743543A443"]] — привязать заказ к чеку. 230 +))) 172 172 |(% style="width:423px" %)((( 173 173 (% class="lead" %) 174 -Аналитика и отчёт 233 +Аналитика и отчёты 175 175 )))|(% style="width:1019px" %)((( 176 - Добавитьво всех отчетах(включая дашборд), которые раньшебылипочекам переключатель:Чеки/Заказы.235 +Во всех отчётах [[массовых рассылок>>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]], а также сводные отчёты из раздела **Аналитика **доступна возможность переключаться между чеками и заказами (при условии, что подключены обе функциональности). 177 177 178 -Дорабатываем все отчеты (включая дашборд), в которых есть чеки так, чтобы они научились работать в 2 режимах: по чекам (как раньше) и по заказам (новый режим). В зависимости от значения переключателя из предыдущего пункта считаем отчет по чекам, либо по заказам. Важно: заказы в отчет должны попадать не все, а только те, которые находятся в учитываемых статусах (например, Завершен, Выкуплен). То, в каких статусах заказы попадают в статистику, а в каких не попадают, должно задаваться в настройках. 237 +(% class="box infomessage" %) 238 +((( 239 +В отчётах учитываются только заказы в статусах, которые при создании/редактировании были отмечены флагом **Учёт в аналитике**. Создание статусов заказов доступно в разделе [[Настройки ~> Статусы заказов>>doc:Sandbox.Order_statuses.WebHome]]. 179 179 ))) 241 +))) 180 180 |(% style="width:423px" %)((( 181 181 (% class="lead" %) 182 -Атрибуция 183 -)))|(% style="width:1019px" %)п 9244 +[[Атрибуция >>doc:Main.Using.Smart_Communications.Receipt_attribution.WebHome]] 245 +)))|(% style="width:1019px" %)По аналогии с функциональностью чеков, доступна возможность атрибуции заказов для [[массовых рассылок >>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]]и [[кампаний>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]]. **Атрибуция заказов** — это правила, позволяющие связать заказы с отправленными коммуникациями клиенту. 184 184 |(% style="width:423px" %)((( 185 185 (% class="lead" %) 186 -Экспорт в файл 248 +[[Экспорт в файл>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome||anchor="02"]] 187 187 )))|(% style="width:1019px" %)((( 188 -На контекстные меню зелёной кнопки "Экспорт в файл" добавить управление видимостью: экспорт чеков (+ строк чеков) / заказов (+строк заказов) должны быть видны в зависимости от значения фича-флага. 189 - 190 -Во всех местах, где есть зеленые кнопки выгрузки "Экспорт в файл" (в частности в списках клиентов) добавить возможность выгрузки заказов и строк заказов. 250 +В списках клиентов в [[Построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]], а также в сводных отчётах раздела **Аналитика** доступна возможность выгружать в файл информацию по заказам и строкам заказов. 191 191 ))) 192 192 193 193 (% class="root-extension__layer-composer" %)