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