Last modified by Никита Романенко on 2025/08/22 12:43
Show last authors
1 **Введение**
2
3 Программа представляет собой структуру стимулирования продаж на уровне субдилеров, автомагазинов и СТО. Она позволяет участникам получать бонусные баллы за закупки продукции брендов Luzar, Trialli, Startvolt, Airline и CarvilleRacing.
4
5 В программе могут участвовать юридические лица и ИП, имеющие автомагазины или СТО. Не допускаются интернет-магазины и маркетплейсы.
6
7 Сейчас в программе принимают участие около 14-16 тыс. участников.
8
9 Регистрация производится через портал bonus.carville.ru. После подачи заявки УК Карвиль проводит проверку (ИНН, ОКВЭД, наличие физического магазина). Процесс акцептования занимает до 3 рабочих дней.
10
11 Дистрибьюторы получают уведомления о новых субдилерах по электронной почте и обязаны ежедневно передавать информацию о продажах УК Карвиль. Основной адрес для работы: bonus@carville.ru (передача данных). В случае неработоспособности сервиса Дистрибьютор может сообщить в службу поддержки сервиса - helpdesk@carville.ru (поддержка).
12
13 Для расчета величины бонусов для участников программы «Карвиль-бонус» необходима информация об объеме закупленных товаров.
14
15 Данные о продажах передаются ежедневно в виде вложенного файла. Файл должен быть в формате .xls, .xlsx или .csv. В одном письме допускается только один файл.
16
17 После загрузки данных приходит ответ: либо подтверждение приёма, либо список ошибок.
18
19 **"Типы бонусов субдилеров"**
20
21 Пуск -> Справочники -> Типы бонусов субдилеров
22
23 (% style="width:549px" %)
24 |(% style="width:236px" %)**Поле**|(% style="width:310px" %)**Значение**
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" %)Проставляется типам бонусов для которых используется
38
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
65 После окончания действия бонуса, на сайте не будет отображаться процент начисления, начисления происходить не будет.
66
67
68 Выделение серым цветом обозначает бонусы для аккредитованных субдилеров
69
70 Выделение белым цветом обозначает бонусы для обычных пользователей
71
72 Выделение голубым цветом обозначает бонусы для аффилированных( коэффициент 0,5 - процент начисления) начисляются при выполнении плана (см. вкладка "Планы")
73
74 ===== **Модуль "Субдилеры и бонусы "** =====
75
76 ===== [[image:1755690456792-152.png||height="414" width="1196"]] =====
77
78 ====== **"Статистика"** ======
79
80 **"Статистика закупок по дистрибьюторам в разрезе дат и субдилеров"**
81
82 Дерево с субдилерами не используется
83
84 [[image:1755690598766-629.png||height="626" width="1186"]]
85
86 ====== **"Дистрибьюторы"** ======
87
88 (% style="width:403px" %)
89 |(% style="width:49px" %)**Поле**|(% style="width:116px" %) |(% style="width:116px" %)**Значение**
90 |(% style="width:49px" %)Код|(% style="width:116px" %) |(% style="width:116px" %)ID дистр.
91 |(% style="width:49px" %)Наименование|(% style="width:116px" %) |(% style="width:116px" %)
92 |(% style="width:49px" %)ИНН|(% style="width:116px" %) |(% style="width:116px" %)
93 |(% style="width:49px" %)Способ обмена|(% style="width:116px" %) |(% style="width:116px" %)по почте или по api
94 |(% colspan="1" rowspan="3" style="width:49px" %)Юр. Лицо|(% style="width:116px" %)Наименование|(% style="width:116px" %)
95 |(% style="width:116px" %)ИНН|(% style="width:116px" %)
96 |(% style="width:116px" %)Код|(% style="width:116px" %)
97 |(% colspan="1" style="width:49px" %)Запрос на обработку|(% style="width:116px" %) |(% style="width:116px" %)Запуск обмена вручную
98 |(% colspan="1" style="width:49px" %)Обработано|(% style="width:116px" %) |(% style="width:116px" %)Когда произошел
99 |(% colspan="1" style="width:49px" %)Пользователь|(% style="width:116px" %) |(% style="width:116px" %)Кто запустил
100
101 [[image:1755690666293-615.png||height="1146" width="1924"]]
102
103 ====== **"Планы"** ======
104
105 Планы по начислению проставляются вручную, либо из карточки субдилера, либо в интерфейсе вкладки "Планы". На вкладке по ПКМ можно импортировать значения из файла(скрин пример файла снизу).
106
107 [[image:telegram-cloud-photo-size-2-5274052890270496868-x.jpg||height="137" width="453"]]
108
109 Планы по начислению относятся только к аффилированным участникам
110
111 По ПКМ на субдилера открывается карточка субдилера
112
113 [[image:1755691505715-334.png||height="1322" width="1668"]]
114
115 ====== **"Карточка субдилера"** ======
116
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
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 2 типа бонусов 1. подарки 2. бонус **через дистр.**
172
173 2. прилетает как новая, при согласовании = "заявка на выдачу", это только **через дистр.**
174
175 Затем Пётр ставить "проведен взаим. расчет", отправляется уведомление и в книгах взаиморасчетах встает сумма и должна появиться в Книги -> Взаиморасчеты
176
177 [[image:1755692534053-292.png||height="970" width="2428"]]
178
179 Термины, определения, сокращения
180
181 Акцептование – процесс проверки Субдилера для допуска к участию в программе «Карвиль-Бонус».
182
183 Субдилер – претендент или участник программы «Карвиль-Бонус».
184
185 ОКВЭД – общий классификатор видов экономической деятельности.
186
187 Физический магазин – место с физическим адресом с возможностью покупки там товаров брендов Карвиль.
188
189
190 Этап акцептования Субдилера и присвоение уникального ID
191
192 Участие в программе возможно при поступлении заявки от Субдилера самостоятельно через портал «Карвиль-Бонус» расположенного по адресу [[https:~~/~~/bonus.carville.ru>>url:https://bonus.carvile.ru]]. В течении 3 рабочих дней Карвиль проверяет и подтверждает или отклоняет заявку на участие.
193
194 Карвиль проверяет Субдилера на соответствие критериям:
195
196 - проверка по ИНН – действующая организация с ОКВЭД позволяющем участвовать в реализации товаров Карвиль;
197
198 - Субдилер имеет физический магазин, находящийся фактическому по адресу, указанному при регистрации;
199
200 - при необходимости, может быть запрошена дополнительная информация от Дистрибьютора, указанного при регистрации Субдилером, для подтверждения закупок;
201
202 - Карвиль может связаться с Субдилером по указанным при регистрации контактным данным для уточнения информации.
203
204 При регистрации проводится проверка по ИНН, телефону и адресу электронной почты с запретом на повторную регистрацию в программе. Если участие Субдилера в программе ранее было приостановлено, то повторная регистрация или возобновление участия возможно только через службу поддержки Карвиль после обращения Субдилера по адресу [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]]. Сообщение о возобновлении участия Субдилера в программе «Карвиль-бонус» Дистрибьюторам такое же, как о новом участнике программы.
205
206 При допуске Субдилера к участию в программе Карвиль оповещает указанных Субдилером Дистрибьюторов по электронной почте о новом участнике программы с указанием ИНН. Письмо формируется 1 раз в день и может содержать информацию о нескольких участниках. В электронное письмо прикладывается во вложенном файле формата .csv с заголовком “ИНН” и перечнем ИНН новых участников программы.
207
208 Со следующего рабочего дня Дистрибьютор обязуется присылать информацию о товарах, реализованных новому участнику программы.
209
210 Карвиль может присвоить или приостановить статус участника в программе «Карвиль-Бонус» по своему усмотрению с обязательным оповещением Субдилера по электронной почте.
211
212 Исключение участников из программы производится в “ручном” режиме - дистрибьютор оповещается письмом без вложения об исключении участника. В этом случае информация по нему более не нужна.
213
214
215 Требования к передаче информации
216
217 Для получения информации по программе почта должна быть с согласованных с УК Карвиль почтовых адресов Дистрибьютора. На время разработки и тестирования системы «Карвиль-Бонус» Дистрибьютор сообщает о своем желании участвовать в программе на почтовый адрес [[bonus@carville.ru>>path:mailto:bonus@carville.ru]] и указывает электронный адрес с которого будет приходить информация о закупках Субдилеров. В ответ Карвиль отправляет подтверждение регистрации нового почтового адреса для приема информации.
218
219 Обмен информации ведется через почтовый адрес и по API.
220
221 **Обмен через API**
222
223 Документация по апи лежит здесь:
224
225 [[https:~~/~~/bonus.carville.ru/api-clients/doc/>>url:https://bonus.carville.ru/api-clients/doc/]]
226
227 [[https:~~/~~/bonus.carville.ru/api/doc/>>url:https://bonus.carville.ru/api/doc/]]
228
229 От клиента на сайт закупки попадают методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api-clients-test/purchases/>>url:https://bonus.carville.ru/api-clients-test/purchases/]]
230
231 Передаются с сайта в Айрус закупки методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api/purchases/export>>url:https://bonus.carville.ru/api/purchases/export]]
232
233 Обратно на сайт инфа едет методом GET, дергается ручка [[https:~~/~~/bonus.carville.ru/api/purchases/import>>url:https://carville-bonus.kz/api/purchases/import]]
234
235 **Обмен по почте:**
236
237 Тема и текст в теле письма значения не имеют. Просматриваются только вложения в письмо.
238
239 В отправленном письме должен быть приложен только один файл. Отправленный файл должен быть в форматах .xls, .xlsx или .csv. При этом Дистрибьютор должен выбрать один формат передачи данных и следовать ему. При замене формата передачи данных, Дистрибьютор должен сообщить об этом на почту [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]] не менее чем за 1 рабочий день до смены формата.
240
241 После отправки письма должен прийти ответ с подтверждением, что все данные приняты или ответом с перечнем ошибок, если данные приняты не были.
242
243 Требования к вложенным файлам
244
245 Требования к файлам .xls и .xlsx:
246
247 - название файла должно быть «ГГГГММДД_ИНН», где ГГГГ – год, ММ – месяц, ДД – день, за который присланы данные;
248
249 - формат ячеек “Общий”;
250
251 - не должно быть объединенных или скрытых ячеек;
252
253 - в книге excel должен быть только один лист;
254
255 - на листе не должно быть формул или иных значений, кроме требуемых;
256
257 - должен соблюдаться порядок столбцов;
258
259 Требования к файлам формата .csv:
260
261 - Название - ГГГГММДД_ИНН.csv, где ИНН - ваш ИНН;
262
263 - первая строка – заголовки;
264
265 - порядок столбцов должен быть сохранен;
266
267 - кодировка ANSI;
268
269 - перевод строки стандартный (перевод строки + возврат каретки);
270
271 - разделитель полей “;” точка с запятой.
272
273 - разделитель дробной части чисел точка.
274
275 [[image:1755865898145-184.png||height="271" width="318"]]
276
277 [[image:1755865929388-276.png||height="142" width="741"]]
278
279 Обработка файлов в старом формате происходит с файлов, которые прилетают на почту bonus@carvilleshop.ru
280 Старые файлы имеют формат Экселя, в котором есть поля: Бренд, Артикул, Количество, ИНН, Дата.
281 При обработке берется строчка и считается согласно цене RRP по каждому товару, далее уже товар с ценой попадает в "Закупки" у каждого участника
282
283 В файле должны содержаться следующие столбцы, указанные в таблице 1. Порядок следования столбцов обязателен.
284
285
286 Таблица 1.
287
288 |Порядок столбца|Название столбца|Технические требования|Описание
289 |1|Бренд|(((
290 Обязательно. Текст. Возможные варианты:
291
292 - Luzar;
293
294 - Trialli:
295
296 - StartVolt;
297
298 - Airline;
299
300 - CarvilleRacing;
301
302 Возможно написание название брендов в любом регистре и с пробелами, буквы латинские.
303 )))|(((
304 Бренд, к которому относится выбранный товар.
305
306
307 )))
308 |2|Артикул|Обязательно. Текст, не более 60 символов. Специальные символы (в т.ч. пробел) не учитываются.|Артикул товара, например, LG 0101. Регистр и спецсимволы значения не имеют.
309 |3|Количество |Обязательно. Целое число.|количество проданного товара за сутки.
310 |4|ИНН/ID|Текст. Обязательно*|ИНН клиента слэш ID в вашей базе данных для однозначного определения клиента. Если ИНН нет, то “/XXX” - где XXX id.
311 |6|ДАТА|Формат Даты - ГГГГММДД|20230131 - год, месяц день за которые подаются продажи.
312
313 ~* - обязательно заполнение хотя бы одного из этих полей.
314
315
316 Возможна привязка поданных товаров к внутренним документам, для удобства ведения статистики, в этом случае должны быть добавлены 2 дополнительных столбца:
317
318 Таблица 1, продолжение
319
320 |Порядок столбца|Название столбца|Технические требования|Описание
321 |8|Номер документа|Не обязательно. Текст.|Номер документа, например, счет фактуры.
322 |9|ID документа|Не обязательно. Текст.|Уникальный идентификатор документа в вашей базе данных.
323
324 Внесение изменений
325
326 В случае изменения требований к содержанию передаваемых файлов УК Карвиль предупреждает за неделю до изменений.
327
328 В случае, если будет прислан файл с тем же названием, что был прислан ранее, то все данные из присланного ранее файла заменятся на новые. В ответном письме, в случае корректного содержания письма, будет указано, что внесены новые данные или данные были перезаписаны.
329
330 Обновление сведений в бонусной программе производится 1 раз в сутки.

Applications

Navigation