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

Applications

Navigation