Wiki source code of Руководство Карвиль-Бонус

Last modified by Никита Романенко on 2025/08/22 12:43

1.1	1	Введение
	2
	3	Программа представляет собой структуру стимулирования продаж на уровне субдилеров, автомагазинов и СТО. Она позволяет участникам получать бонусные баллы за закупки продукции брендов Luzar, Trialli, Startvolt, Airline и CarvilleRacing.
	4
	5	В программе могут участвовать юридические лица и ИП, имеющие автомагазины или СТО. Не допускаются интернет-магазины и маркетплейсы.
	6
9.1	7	Сейчас в программе принимают участие около 14-16 тыс. участников.
1.1	8
	9	Регистрация производится через портал bonus.carville.ru. После подачи заявки УК Карвиль проводит проверку (ИНН, ОКВЭД, наличие физического магазина). Процесс акцептования занимает до 3 рабочих дней.
	10
	11	Дистрибьюторы получают уведомления о новых субдилерах по электронной почте и обязаны ежедневно передавать информацию о продажах УК Карвиль. Основной адрес для работы: bonus@carville.ru (передача данных). В случае неработоспособности сервиса Дистрибьютор может сообщить в службу поддержки сервиса - helpdesk@carville.ru (поддержка).
	12
	13	Для расчета величины бонусов для участников программы «Карвиль-бонус» необходима информация об объеме закупленных товаров.
	14
	15	Данные о продажах передаются ежедневно в виде вложенного файла. Файл должен быть в формате .xls, .xlsx или .csv. В одном письме допускается только один файл.
	16
	17	После загрузки данных приходит ответ: либо подтверждение приёма, либо список ошибок.
	18
9.1	19	"Типы бонусов субдилеров"
1.1	20
11.1	21	Пуск -> Справочники -> Типы бонусов субдилеров
	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
17.1	74	===== Модуль "Субдилеры и бонусы " =====
9.1	75
11.1	76	===== [[image:1755690456792-152.png\|\|height="414" width="1196"]] =====
9.1	77
17.1	78	====== "Статистика" ======
9.1	79
17.1	80	"Статистика закупок по дистрибьюторам в разрезе дат и субдилеров"
	81
9.1	82	Дерево с субдилерами не используется
	83
	84	[[image:1755690598766-629.png\|\|height="626" width="1186"]]
	85
11.1	86	====== "Дистрибьюторы" ======
9.1	87
	88	(% style="width:403px" %)
17.1	89	\|(% style="width:49px" %)Поле\|(% style="width:116px" %) \|(% style="width:116px" %)Значение
9.1	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
11.1	103	====== "Планы" ======
9.1	104
17.1	105	Планы по начислению проставляются вручную, либо из карточки субдилера, либо в интерфейсе вкладки "Планы". На вкладке по ПКМ можно импортировать значения из файла(скрин пример файла снизу).
9.1	106
	107	[[image:telegram-cloud-photo-size-2-5274052890270496868-x.jpg\|\|height="137" width="453"]]
	108
	109	Планы по начислению относятся только к аффилированным участникам
	110
17.1	111	По ПКМ на субдилера открывается карточка субдилера
	112
9.1	113	[[image:1755691505715-334.png\|\|height="1322" width="1668"]]
	114
17.1	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
11.1	163	====== "Заявки" ======
9.1	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
1.1	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
17.1	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
1.1	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
17.1	326	В случае изменения требований к содержанию передаваемых файлов УК Карвиль предупреждает за неделю до изменений.
1.1	327
	328	В случае, если будет прислан файл с тем же названием, что был прислан ранее, то все данные из присланного ранее файла заменятся на новые. В ответном письме, в случае корректного содержания письма, будет указано, что внесены новые данные или данные были перезаписаны.
	329
	330	Обновление сведений в бонусной программе производится 1 раз в сутки.

Wiki source code of Руководство Карвиль-Бонус

Applications

Navigation