Version 9.1 by Никита Романенко on 2025/08/20 12:49
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 Белый для обычных пользователей
24
25 Голубой для аффилированных( коэффициент 0,5 - процент начисления) начисляются при выполнении плана (см. вкладка "Планы")
26
27 **Вкладка "Субдилеры и бонусы "**
28
29 [[image:1755690456792-152.png||height="414" width="1196"]]
30
31 **"Статистика закупок"**
32
33 Дерево с субдилерами не используется
34
35
36 [[image:1755690598766-629.png||height="626" width="1186"]]
37
38 **"Дистрибьюторы"**
39
40 (% style="width:403px" %)
41 |(% style="width:49px" %)Код|(% style="width:116px" %) |(% style="width:116px" %)ID дистр.
42 |(% style="width:49px" %)Наименование|(% style="width:116px" %) |(% style="width:116px" %)
43 |(% style="width:49px" %)ИНН|(% style="width:116px" %) |(% style="width:116px" %)
44 |(% style="width:49px" %)Способ обмена|(% style="width:116px" %) |(% style="width:116px" %)по почте или по api
45 |(% colspan="1" rowspan="3" style="width:49px" %)Юр. Лицо|(% style="width:116px" %)Наименование|(% style="width:116px" %)
46 |(% style="width:116px" %)ИНН|(% style="width:116px" %)
47 |(% style="width:116px" %)Код|(% style="width:116px" %)
48 |(% colspan="1" style="width:49px" %)Запрос на обработку|(% style="width:116px" %) |(% style="width:116px" %)Запуск обмена вручную
49 |(% colspan="1" style="width:49px" %)Обработано|(% style="width:116px" %) |(% style="width:116px" %)Когда произошел
50 |(% colspan="1" style="width:49px" %)Пользователь|(% style="width:116px" %) |(% style="width:116px" %)Кто запустил
51
52 [[image:1755690666293-615.png||height="1146" width="1924"]]
53
54 **"Планы"**
55
56 Планы по начислению проставляются вручную, либо из карточки субдилера, либо в интерфейсе вкладки "Планы". На вкладке по ПКМ можно импортировать значения.
57
58 [[image:telegram-cloud-photo-size-2-5274052890270496868-x.jpg||height="137" width="453"]]
59
60 Планы по начислению относятся только к аффилированным участникам
61
62 [[image:1755691505715-334.png||height="1322" width="1668"]]
63
64 **"Заявки"**
65
66 Белый новые или отмененные
67
68 Синие согласованные
69
70 Красные заявки <= баланс
71
72 2 типа бонусов 1. подарки 2. бонус **через дистр.**
73
74 2. прилетает как новая, при согласовании = "заявка на выдачу", это только **через дистр.**
75
76 Затем Пётр ставить "проведен взаим. расчет", отправляется уведомление и в книгах взаиморасчетах встает сумма и должна появиться в Книги -> Взаиморасчеты
77
78 [[image:1755692534053-292.png||height="970" width="2428"]]
79
80 Термины, определения, сокращения
81
82 Акцептование – процесс проверки Субдилера для допуска к участию в программе «Карвиль-Бонус».
83
84 Субдилер – претендент или участник программы «Карвиль-Бонус».
85
86 ОКВЭД – общий классификатор видов экономической деятельности.
87
88 Физический магазин – место с физическим адресом с возможностью покупки там товаров брендов Карвиль.
89
90
91 Этап акцептования Субдилера и присвоение уникального ID
92
93 Участие в программе возможно при поступлении заявки от Субдилера самостоятельно через портал «Карвиль-Бонус» расположенного по адресу [[https:~~/~~/bonus.carville.ru>>url:https://bonus.carvile.ru]]. В течении 3 рабочих дней Карвиль проверяет и подтверждает или отклоняет заявку на участие.
94
95 Карвиль проверяет Субдилера на соответствие критериям:
96
97 - проверка по ИНН – действующая организация с ОКВЭД позволяющем участвовать в реализации товаров Карвиль;
98
99 - Субдилер имеет физический магазин, находящийся фактическому по адресу, указанному при регистрации;
100
101 - при необходимости, может быть запрошена дополнительная информация от Дистрибьютора, указанного при регистрации Субдилером, для подтверждения закупок;
102
103 - Карвиль может связаться с Субдилером по указанным при регистрации контактным данным для уточнения информации.
104
105 При регистрации проводится проверка по ИНН, телефону и адресу электронной почты с запретом на повторную регистрацию в программе. Если участие Субдилера в программе ранее было приостановлено, то повторная регистрация или возобновление участия возможно только через службу поддержки Карвиль после обращения Субдилера по адресу [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]]. Сообщение о возобновлении участия Субдилера в программе «Карвиль-бонус» Дистрибьюторам такое же, как о новом участнике программы.
106
107 При допуске Субдилера к участию в программе Карвиль оповещает указанных Субдилером Дистрибьюторов по электронной почте о новом участнике программы с указанием ИНН. Письмо формируется 1 раз в день и может содержать информацию о нескольких участниках. В электронное письмо прикладывается во вложенном файле формата .csv с заголовком “ИНН” и перечнем ИНН новых участников программы.
108
109 Со следующего рабочего дня Дистрибьютор обязуется присылать информацию о товарах, реализованных новому участнику программы.
110
111 Карвиль может присвоить или приостановить статус участника в программе «Карвиль-Бонус» по своему усмотрению с обязательным оповещением Субдилера по электронной почте.
112
113 Исключение участников из программы производится в “ручном” режиме - дистрибьютор оповещается письмом без вложения об исключении участника. В этом случае информация по нему более не нужна.
114
115
116 Требования к передаче информации
117
118 Для получения информации по программе почта должна быть с согласованных с УК Карвиль почтовых адресов Дистрибьютора. На время разработки и тестирования системы «Карвиль-Бонус» Дистрибьютор сообщает о своем желании участвовать в программе на почтовый адрес [[bonus@carville.ru>>path:mailto:bonus@carville.ru]] и указывает электронный адрес с которого будет приходить информация о закупках Субдилеров. В ответ Карвиль отправляет подтверждение регистрации нового почтового адреса для приема информации.
119
120 Обмен информации ведется через почтовый адрес и по API.
121
122 **Обмен через API**
123
124 Документация по апи лежит здесь:
125
126 [[https:~~/~~/bonus.carville.ru/api-clients/doc/>>url:https://bonus.carville.ru/api-clients/doc/]]
127
128 [[https:~~/~~/bonus.carville.ru/api/doc/>>url:https://bonus.carville.ru/api/doc/]]
129
130 От клиента на сайт закупки попадают методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api-clients-test/purchases/>>url:https://bonus.carville.ru/api-clients-test/purchases/]]
131
132 Передаются с сайта в Айрус закупки методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api/purchases/export>>url:https://bonus.carville.ru/api/purchases/export]]
133
134 Обратно на сайт инфа едет методом GET, дергается ручка [[https:~~/~~/bonus.carville.ru/api/purchases/import>>url:https://carville-bonus.kz/api/purchases/import]]
135
136 **Обмен по почте:**
137
138 Тема и текст в теле письма значения не имеют. Просматриваются только вложения в письмо.
139
140 В отправленном письме должен быть приложен только один файл. Отправленный файл должен быть в форматах .xls, .xlsx или .csv. При этом Дистрибьютор должен выбрать один формат передачи данных и следовать ему. При замене формата передачи данных, Дистрибьютор должен сообщить об этом на почту [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]] не менее чем за 1 рабочий день до смены формата.
141
142 После отправки письма должен прийти ответ с подтверждением, что все данные приняты или ответом с перечнем ошибок, если данные приняты не были.
143
144 Требования к вложенным файлам
145
146 Требования к файлам .xls и .xlsx:
147
148 - название файла должно быть «ГГГГММДД_ИНН», где ГГГГ – год, ММ – месяц, ДД – день, за который присланы данные;
149
150 - формат ячеек “Общий”;
151
152 - не должно быть объединенных или скрытых ячеек;
153
154 - в книге excel должен быть только один лист;
155
156 - на листе не должно быть формул или иных значений, кроме требуемых;
157
158 - должен соблюдаться порядок столбцов;
159
160 Требования к файлам формата .csv:
161
162 - Название - ГГГГММДД_ИНН.csv, где ИНН - ваш ИНН;
163
164 - первая строка – заголовки;
165
166 - порядок столбцов должен быть сохранен;
167
168 - кодировка ANSI;
169
170 - перевод строки стандартный (перевод строки + возврат каретки);
171
172 - разделитель полей “;” точка с запятой.
173
174 - разделитель дробной части чисел точка.
175
176 В файле должны содержаться следующие столбцы, указанные в таблице 1. Порядок следования столбцов обязателен.
177
178
179 Таблица 1.
180
181 |Порядок столбца|Название столбца|Технические требования|Описание
182 |1|Бренд|(((
183 Обязательно. Текст. Возможные варианты:
184
185 - Luzar;
186
187 - Trialli:
188
189 - StartVolt;
190
191 - Airline;
192
193 - CarvilleRacing;
194
195 Возможно написание название брендов в любом регистре и с пробелами, буквы латинские.
196 )))|(((
197 Бренд, к которому относится выбранный товар.
198
199
200 )))
201 |2|Артикул|Обязательно. Текст, не более 60 символов. Специальные символы (в т.ч. пробел) не учитываются.|Артикул товара, например, LG 0101. Регистр и спецсимволы значения не имеют.
202 |3|Количество |Обязательно. Целое число.|количество проданного товара за сутки.
203 |4|ИНН/ID|Текст. Обязательно*|ИНН клиента слэш ID в вашей базе данных для однозначного определения клиента. Если ИНН нет, то “/XXX” - где XXX id.
204 |5|Групповой ID|Текст. Обязательно*|Если в вашей базе есть группирующий признак для клиентов с разными юр лицами, но по сути являющимися одной организацией, указываем id из базы данных.
205 |6|ДАТА|Формат Даты - ГГГГММДД|20230131 - год, месяц день за которые подаются продажи.
206 |7|Возврат|Не обязательно. 0 или 1|(((
207 Признак возврата. Если поставлено 1, то это означает, что данная строка соответствует возвращенным товарам.
208
209 Если поле пустое или поставлен «0» - это не возврат товара.
210 )))
211
212 ~* - обязательно заполнение хотя бы одного из этих полей.
213
214
215 Возможна привязка поданных товаров к внутренним документам, для удобства ведения статистики, в этом случае должны быть добавлены 2 дополнительных столбца:
216
217 Таблица 1, продолжение
218
219 |Порядок столбца|Название столбца|Технические требования|Описание
220 |8|Номер документа|Не обязательно. Текст.|Номер документа, например, счет фактуры.
221 |9|ID документа|Не обязательно. Текст.|Уникальный идентификатор документа в вашей базе данных.
222
223 Внесение изменений
224
225 В случае изменения требований к содержанию передаваемых файлов УК Карвиль предупреждает за 3 рабочих дня до изменений.
226
227 В случае, если будет прислан файл с тем же названием, что был прислан ранее, то все данные из присланного ранее файла заменятся на новые. В ответном письме, в случае корректного содержания письма, будет указано, что внесены новые данные или данные были перезаписаны.
228
229 Обновление сведений в бонусной программе производится 1 раз в сутки.