Hide last authors
Никита Романенко 1.1 1 **Введение**
2
3 Программа представляет собой структуру стимулирования продаж на уровне субдилеров, автомагазинов и СТО. Она позволяет участникам получать бонусные баллы за закупки продукции брендов Luzar, Trialli, Startvolt, Airline и CarvilleRacing.
4
5 В программе могут участвовать юридические лица и ИП, имеющие автомагазины или СТО. Не допускаются интернет-магазины и маркетплейсы.
6
Никита Романенко 24.1 7 Сейчас в программе принимают участие около 14 тыс. активных участников.
Никита Романенко 1.1 8
Никита Романенко 30.1 9 Регистрация производится через портал bonus.carville.ru. После подачи заявки УК Карвиль проводит проверку (ИНН, наличие физического магазина). Процесс акцептования занимает до 3 рабочих дней.
Никита Романенко 1.1 10
11 Дистрибьюторы получают уведомления о новых субдилерах по электронной почте и обязаны ежедневно передавать информацию о продажах УК Карвиль. Основной адрес для работы: bonus@carville.ru (передача данных). В случае неработоспособности сервиса Дистрибьютор может сообщить в службу поддержки сервиса - helpdesk@carville.ru (поддержка).
12
Никита Романенко 30.1 13 Для расчета величины бонусов для участников программы «Карвиль-бонус» необходима информация об объеме закупленных товаров.(см. "Обмен по почте")
Никита Романенко 1.1 14
Никита Романенко 33.1 15 [[image:КБ заявки и промо-коды (2).jpg]]
16
Никита Романенко 9.1 17 **"Типы бонусов субдилеров"**
Никита Романенко 1.1 18
Никита Романенко 11.1 19 Пуск -> Справочники -> Типы бонусов субдилеров
20
Никита Романенко 24.1 21 [[image:1756383012843-724.png||height="325" width="456"]]
22
Никита Романенко 10.1 23 (% style="width:549px" %)
Никита Романенко 17.1 24 |(% style="width:236px" %)**Поле**|(% style="width:310px" %)**Значение**
Никита Романенко 10.1 25 |(% style="width:236px" %)ID|(% style="width:310px" %)id субдилера
26 |(% style="width:236px" %)Наименование|(% style="width:310px" %)Название типа бонуса
27 |(% style="width:236px" %)Цель(руб)|(% style="width:310px" %)Сумма, после которой происходит начисление
28 |(% style="width:236px" %)Цель(шт)|(% style="width:310px" %)
29 |(% style="width:236px" %)Бонус|(% style="width:310px" %)Процент начисления
30 |(% style="width:236px" %)Товары|(% style="width:310px" %)Категории товаров
31 |(% style="width:236px" %)Период|(% style="width:310px" %)
32 |(% style="width:236px" %)Статус|(% style="width:310px" %)
33 |(% style="width:236px" %)Период С|(% style="width:310px" %)Период действия бонуса
34 |(% style="width:236px" %)Период ПО|(% style="width:310px" %)Период действия бонуса
35 |(% style="width:236px" %)Производитель|(% style="width:310px" %)
36 |(% style="width:236px" %)Для аккредитованных|(% style="width:310px" %)Проставляется типам бонусов для которых используется
37 |(% style="width:236px" %)Аффилирован|(% style="width:310px" %)Проставляется типам бонусов для которых используется
Никита Романенко 9.1 38
Никита Романенко 17.1 39 Для редактирования информации - ПКМ по бонусу -> Настройка бонуса
40
41 [[image:1755862772844-438.png||height="393" width="509"]]
42
43 Здесь можно изменить:
44
45 ~1. Наименование
46
47 2. Период действия бонуса "от" и "до"
48
49 3. Цель в руб. и шт. после которой будет начисляться бонус
50
51 4. Товары, за которые будет начисляться бонус
52
53 5. Производитель (не используется)
54
55 6. Бонус~(% начисления)
56
57 7. Статус
58
59 7.1 На согласовании(бонус создан, но не согласован Петром Н.)
60
61 7.2 Согласован (утвержден), будет активен в рамках установленного периода
62
63 7.3 Завершен ( = приостановить действие бонуса)
64
Никита Романенко 10.1 65 После окончания действия бонуса, на сайте не будет отображаться процент начисления, начисления происходить не будет.
Никита Романенко 9.1 66
67
Никита Романенко 10.1 68 Выделение серым цветом обозначает бонусы для аккредитованных субдилеров
69
70 Выделение белым цветом обозначает бонусы для обычных пользователей
71
72 Выделение голубым цветом обозначает бонусы для аффилированных( коэффициент 0,5 - процент начисления) начисляются при выполнении плана (см. вкладка "Планы")
73
Никита Романенко 24.1 74 ===== **Модуль "Субдилеры и бонусы"** =====
Никита Романенко 9.1 75
76
Никита Романенко 28.1 77 ===== =====
78
Никита Романенко 17.1 79 ====== **"Статистика"** ======
Никита Романенко 9.1 80
Никита Романенко 17.1 81 **"Статистика закупок по дистрибьюторам в разрезе дат и субдилеров"**
82
Никита Романенко 24.1 83 Чек-бокс "Включить дерево с субдилерами" не используется
Никита Романенко 9.1 84
85 [[image:1755690598766-629.png||height="626" width="1186"]]
86
Никита Романенко 11.1 87 ====== **"Дистрибьюторы"** ======
Никита Романенко 9.1 88
Никита Романенко 24.1 89 [[image:1756383474708-865.png||height="636" width="1437"]]
90
Никита Романенко 9.1 91 (% style="width:403px" %)
Никита Романенко 17.1 92 |(% style="width:49px" %)**Поле**|(% style="width:116px" %) |(% style="width:116px" %)**Значение**
Никита Романенко 9.1 93 |(% style="width:49px" %)Код|(% style="width:116px" %) |(% style="width:116px" %)ID дистр.
94 |(% style="width:49px" %)Наименование|(% style="width:116px" %) |(% style="width:116px" %)
95 |(% style="width:49px" %)ИНН|(% style="width:116px" %) |(% style="width:116px" %)
96 |(% style="width:49px" %)Способ обмена|(% style="width:116px" %) |(% style="width:116px" %)по почте или по api
97 |(% colspan="1" rowspan="3" style="width:49px" %)Юр. Лицо|(% style="width:116px" %)Наименование|(% style="width:116px" %)
98 |(% style="width:116px" %)ИНН|(% style="width:116px" %)
99 |(% style="width:116px" %)Код|(% style="width:116px" %)
100 |(% colspan="1" style="width:49px" %)Запрос на обработку|(% style="width:116px" %) |(% style="width:116px" %)Запуск обмена вручную
101 |(% colspan="1" style="width:49px" %)Обработано|(% style="width:116px" %) |(% style="width:116px" %)Когда произошел
102 |(% colspan="1" style="width:49px" %)Пользователь|(% style="width:116px" %) |(% style="width:116px" %)Кто запустил
103
Никита Романенко 11.1 104 ====== **"Планы"** ======
Никита Романенко 9.1 105
Никита Романенко 17.1 106 Планы по начислению проставляются вручную, либо из карточки субдилера, либо в интерфейсе вкладки "Планы". На вкладке по ПКМ можно импортировать значения из файла(скрин пример файла снизу).
Никита Романенко 9.1 107
108 [[image:telegram-cloud-photo-size-2-5274052890270496868-x.jpg||height="137" width="453"]]
109
110 Планы по начислению относятся только к аффилированным участникам
111
Никита Романенко 17.1 112 По ПКМ на субдилера открывается карточка субдилера
113
Никита Романенко 28.1 114 [[image:1756385706613-206.png||height="698" width="1071"]]
Никита Романенко 9.1 115
Никита Романенко 28.1 116
Никита Романенко 17.1 117 ====== **"Карточка субдилера"** ======
118
119 **"Анкета"**
120
121 Здесь содержится основная информация по субдилеру.
122
123 Все поля редактируемые
124
125 Поле "**Дистрибьютор**" не используется
126
127 Поле "**Статус**":
128
129 "**На согласовании**"(пройдена рег-ция, профиль не редактировался)
130
131 Инфо от РП - Региональный представитель после встречи заполняет данные(мобильное приложение "Встречи"), данные прилетают в Айрус.
132
133 **"Адреса"**
134
135 Не используется
136
137 **"Дистрибьюторы"**
138
139 Привязанные дистрибьюторы, выбранные в профиле на сайте
140
141 Чек-бокс "Основной" не используется
142
143 **"Закупки"**
144
145 Только здесь хранятся все закупки отдельно по субдилеру, передаются с сайта
146
Никита Романенко 18.1 147 **"Статистика"**
Никита Романенко 17.1 148
Никита Романенко 18.1 149 Статистика по закупкам
Никита Романенко 17.1 150
Никита Романенко 18.1 151 **"Бонусы"**
Никита Романенко 17.1 152
Никита Романенко 18.1 153 Бонусы применённые к субдилеру
154
155 **"Заявки"**
156
Никита Романенко 21.1 157 Здесь отображаются заявки на списание бонусов
Никита Романенко 18.1 158
Никита Романенко 21.1 159 Заявка прилетает двумя способами: через кассового партнера и через карвильшоп
Никита Романенко 17.1 160
Никита Романенко 21.1 161 ~1. Через кассового партнера
Никита Романенко 17.1 162
Никита Романенко 24.1 163 1.1.На сайте, пользователем выбирается дистрибьютор(не все дистрибьюторы(14) доступны к выбору, нужно подписать согласие стать кассовым партнером)
Никита Романенко 17.1 164
Никита Романенко 21.1 165 1.2.Прилетает заявка со статусом "Бонус через дистрибьютора"
Никита Романенко 17.1 166
Никита Романенко 21.1 167 Первый этап согласования сотрудниками Нестеренко М.А или Гладышевым П.А.:
Никита Романенко 17.1 168
Никита Романенко 21.1 169 - Согласуется заявка, статус с "Новая" на "Заявка на выдачу"
170
171 Второй этап согласования Нечипоренко П.А :
172
173 - Изменяется статус с "Заявка на выдачу" на "Проведен взаиморасчет"
174
175 - Заявки суммируются, сумма попадает в "Книги" -> "Взаиморасчеты" (по каждому дистриб. отдельно)
176
177 [[image:1756215472965-313.png||height="569" width="935"]]
178
179
Никита Романенко 24.1 180 Далее, информация передаётся на сайт с ночным обменом, либо можно запустить обмен вручную по одной заявке - **ПКМ **-> **отправить** **инф. на портал** -> **При следующем обмене/Немедленно**
Никита Романенко 21.1 181
182 [[image:1756214621596-993.png||height="369" width="548"]]
183
184 Генерируется промокод на карвильшопе (уточнить этот момент)
185
Никита Романенко 24.1 186 Субдилеру приходит оповещение на почту о готовности промокода и возможности применить на карвильшопе(Нужна отдельная регистрация для применения промокода)
Никита Романенко 21.1 187
188
189 **"Загрузки"**
190
191 **"Доп. ИНН"**
192
193 **"Инфо от РП"**
194
195 **"Встречи"**
196
197 Здесь указываются встречи с региональными представителями
198
199 **"Комментарии"**
200
Никита Романенко 24.1 201 **"План"**
Никита Романенко 21.1 202
Никита Романенко 17.1 203
Никита Романенко 11.1 204 ====== **"Заявки"** ======
Никита Романенко 9.1 205
Никита Романенко 28.1 206 Обозначения цветом:
Никита Романенко 9.1 207
Никита Романенко 28.1 208 Белый цвет - Новые заявки или отмененные
Никита Романенко 9.1 209
Никита Романенко 28.1 210 Синий цвет - Согласованные заявки
Никита Романенко 9.1 211
Никита Романенко 28.1 212 Красный цвет - заявки с балансом меньше либо равно 10к
Никита Романенко 9.1 213
Никита Романенко 28.1 214 Существуют 2 типа бонусов:
Никита Романенко 9.1 215
Никита Романенко 28.1 216 - Подарки
Никита Романенко 9.1 217
Никита Романенко 28.1 218 - Бонус через дистрибьютора
Никита Романенко 9.1 219
Никита Романенко 24.1 220
Никита Романенко 28.1 221 [[image:1756385794210-748.png||height="848" width="1276"]]
Никита Романенко 24.1 222
Никита Романенко 28.1 223
Никита Романенко 1.1 224 Термины, определения, сокращения
225
226 Акцептование – процесс проверки Субдилера для допуска к участию в программе «Карвиль-Бонус».
227
228 Субдилер – претендент или участник программы «Карвиль-Бонус».
229
230 ОКВЭД – общий классификатор видов экономической деятельности.
231
Никита Романенко 24.1 232 Аффилированный участник - субдилер имеющий план, после которого начисляются бонусы.
233
Никита Романенко 1.1 234 Физический магазин – место с физическим адресом с возможностью покупки там товаров брендов Карвиль.
235
236
Никита Романенко 24.1 237 **Этап акцептования Субдилера и присвоение уникального ID**
Никита Романенко 1.1 238
239 Участие в программе возможно при поступлении заявки от Субдилера самостоятельно через портал «Карвиль-Бонус» расположенного по адресу [[https:~~/~~/bonus.carville.ru>>url:https://bonus.carvile.ru]]. В течении 3 рабочих дней Карвиль проверяет и подтверждает или отклоняет заявку на участие.
240
241 Карвиль проверяет Субдилера на соответствие критериям:
242
243 - проверка по ИНН – действующая организация с ОКВЭД позволяющем участвовать в реализации товаров Карвиль;
244
245 - Субдилер имеет физический магазин, находящийся фактическому по адресу, указанному при регистрации;
246
247 - при необходимости, может быть запрошена дополнительная информация от Дистрибьютора, указанного при регистрации Субдилером, для подтверждения закупок;
248
249 - Карвиль может связаться с Субдилером по указанным при регистрации контактным данным для уточнения информации.
250
251 При регистрации проводится проверка по ИНН, телефону и адресу электронной почты с запретом на повторную регистрацию в программе. Если участие Субдилера в программе ранее было приостановлено, то повторная регистрация или возобновление участия возможно только через службу поддержки Карвиль после обращения Субдилера по адресу [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]]. Сообщение о возобновлении участия Субдилера в программе «Карвиль-бонус» Дистрибьюторам такое же, как о новом участнике программы.
252
253 При допуске Субдилера к участию в программе Карвиль оповещает указанных Субдилером Дистрибьюторов по электронной почте о новом участнике программы с указанием ИНН. Письмо формируется 1 раз в день и может содержать информацию о нескольких участниках. В электронное письмо прикладывается во вложенном файле формата .csv с заголовком “ИНН” и перечнем ИНН новых участников программы.
254
255 Со следующего рабочего дня Дистрибьютор обязуется присылать информацию о товарах, реализованных новому участнику программы.
256
257 Карвиль может присвоить или приостановить статус участника в программе «Карвиль-Бонус» по своему усмотрению с обязательным оповещением Субдилера по электронной почте.
258
259 Исключение участников из программы производится в “ручном” режиме - дистрибьютор оповещается письмом без вложения об исключении участника. В этом случае информация по нему более не нужна.
260
261
262 Требования к передаче информации
263
264 Для получения информации по программе почта должна быть с согласованных с УК Карвиль почтовых адресов Дистрибьютора. На время разработки и тестирования системы «Карвиль-Бонус» Дистрибьютор сообщает о своем желании участвовать в программе на почтовый адрес [[bonus@carville.ru>>path:mailto:bonus@carville.ru]] и указывает электронный адрес с которого будет приходить информация о закупках Субдилеров. В ответ Карвиль отправляет подтверждение регистрации нового почтового адреса для приема информации.
265
266 Обмен информации ведется через почтовый адрес и по API.
267
268 **Обмен через API**
269
270 Документация по апи лежит здесь:
271
272 [[https:~~/~~/bonus.carville.ru/api-clients/doc/>>url:https://bonus.carville.ru/api-clients/doc/]]
273
274 [[https:~~/~~/bonus.carville.ru/api/doc/>>url:https://bonus.carville.ru/api/doc/]]
275
276 От клиента на сайт закупки попадают методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api-clients-test/purchases/>>url:https://bonus.carville.ru/api-clients-test/purchases/]]
277
278 Передаются с сайта в Айрус закупки методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api/purchases/export>>url:https://bonus.carville.ru/api/purchases/export]]
279
280 Обратно на сайт инфа едет методом GET, дергается ручка [[https:~~/~~/bonus.carville.ru/api/purchases/import>>url:https://carville-bonus.kz/api/purchases/import]]
281
282 **Обмен по почте:**
283
284 Тема и текст в теле письма значения не имеют. Просматриваются только вложения в письмо.
285
286 В отправленном письме должен быть приложен только один файл. Отправленный файл должен быть в форматах .xls, .xlsx или .csv. При этом Дистрибьютор должен выбрать один формат передачи данных и следовать ему. При замене формата передачи данных, Дистрибьютор должен сообщить об этом на почту [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]] не менее чем за 1 рабочий день до смены формата.
287
288 После отправки письма должен прийти ответ с подтверждением, что все данные приняты или ответом с перечнем ошибок, если данные приняты не были.
289
290 Требования к вложенным файлам
291
292 Требования к файлам .xls и .xlsx:
293
294 - название файла должно быть «ГГГГММДД_ИНН», где ГГГГ – год, ММ – месяц, ДД – день, за который присланы данные;
295
296 - формат ячеек “Общий”;
297
298 - не должно быть объединенных или скрытых ячеек;
299
300 - в книге excel должен быть только один лист;
301
302 - на листе не должно быть формул или иных значений, кроме требуемых;
303
304 - должен соблюдаться порядок столбцов;
305
306 Требования к файлам формата .csv:
307
308 - Название - ГГГГММДД_ИНН.csv, где ИНН - ваш ИНН;
309
310 - первая строка – заголовки;
311
312 - порядок столбцов должен быть сохранен;
313
314 - кодировка ANSI;
315
316 - перевод строки стандартный (перевод строки + возврат каретки);
317
318 - разделитель полей “;” точка с запятой.
319
320 - разделитель дробной части чисел точка.
321
Никита Романенко 17.1 322 [[image:1755865898145-184.png||height="271" width="318"]]
323
324 [[image:1755865929388-276.png||height="142" width="741"]]
325
Никита Романенко 18.1 326 Обработка файлов в старом формате происходит с файлов, которые прилетают на почту bonus@carvilleshop.ru
327 Старые файлы имеют формат Экселя, в котором есть поля: Бренд, Артикул, Количество, ИНН, Дата.
Никита Романенко 17.1 328 При обработке берется строчка и считается согласно цене RRP по каждому товару, далее уже товар с ценой попадает в "Закупки" у каждого участника
329
Никита Романенко 1.1 330 В файле должны содержаться следующие столбцы, указанные в таблице 1. Порядок следования столбцов обязателен.
331
332
333 Таблица 1.
334
335 |Порядок столбца|Название столбца|Технические требования|Описание
336 |1|Бренд|(((
337 Обязательно. Текст. Возможные варианты:
338
339 - Luzar;
340
341 - Trialli:
342
343 - StartVolt;
344
345 - Airline;
346
347 - CarvilleRacing;
348
349 Возможно написание название брендов в любом регистре и с пробелами, буквы латинские.
350 )))|(((
351 Бренд, к которому относится выбранный товар.
352
353
354 )))
355 |2|Артикул|Обязательно. Текст, не более 60 символов. Специальные символы (в т.ч. пробел) не учитываются.|Артикул товара, например, LG 0101. Регистр и спецсимволы значения не имеют.
356 |3|Количество |Обязательно. Целое число.|количество проданного товара за сутки.
357 |4|ИНН/ID|Текст. Обязательно*|ИНН клиента слэш ID в вашей базе данных для однозначного определения клиента. Если ИНН нет, то “/XXX” - где XXX id.
358 |6|ДАТА|Формат Даты - ГГГГММДД|20230131 - год, месяц день за которые подаются продажи.
359
360 ~* - обязательно заполнение хотя бы одного из этих полей.
361
362
363 Возможна привязка поданных товаров к внутренним документам, для удобства ведения статистики, в этом случае должны быть добавлены 2 дополнительных столбца:
364
365 Таблица 1, продолжение
366
367 |Порядок столбца|Название столбца|Технические требования|Описание
368 |8|Номер документа|Не обязательно. Текст.|Номер документа, например, счет фактуры.
369 |9|ID документа|Не обязательно. Текст.|Уникальный идентификатор документа в вашей базе данных.
370
371 Внесение изменений
372
Никита Романенко 17.1 373 В случае изменения требований к содержанию передаваемых файлов УК Карвиль предупреждает за неделю до изменений.
Никита Романенко 1.1 374
375 В случае, если будет прислан файл с тем же названием, что был прислан ранее, то все данные из присланного ранее файла заменятся на новые. В ответном письме, в случае корректного содержания письма, будет указано, что внесены новые данные или данные были перезаписаны.
376
377 Обновление сведений в бонусной программе производится 1 раз в сутки.