Wiki source code of Руководство Карвиль-Бонус
Version 36.1 by Никита Романенко on 2025/09/11 06:05
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 раз в сутки. |