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

Last modified by Никита Романенко on 2025/08/25 13:35

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
18.1	145	"Статистика"
17.1	146
18.1	147	Статистика по закупкам
17.1	148
18.1	149	"Бонусы"
17.1	150
18.1	151	Бонусы применённые к субдилеру
	152
	153	"Заявки"
	154
	155
17.1	156	"Загрузки"
	157
	158	"Доп. ИНН"
	159
	160	"Инфо от РП"
	161
	162	"Встречи"
	163
	164	"Комментарии"
	165
	166	"План"
	167
11.1	168	====== "Заявки" ======
9.1	169
	170	Белый новые или отмененные
	171
	172	Синие согласованные
	173
	174	Красные заявки <= баланс
	175
	176	2 типа бонусов 1. подарки 2. бонус через дистр.
	177
	178	2. прилетает как новая, при согласовании = "заявка на выдачу", это только через дистр.
	179
	180	Затем Пётр ставить "проведен взаим. расчет", отправляется уведомление и в книгах взаиморасчетах встает сумма и должна появиться в Книги -> Взаиморасчеты
	181
	182	[[image:1755692534053-292.png\|\|height="970" width="2428"]]
	183
1.1	184	Термины, определения, сокращения
	185
	186	Акцептование – процесс проверки Субдилера для допуска к участию в программе «Карвиль-Бонус».
	187
	188	Субдилер – претендент или участник программы «Карвиль-Бонус».
	189
	190	ОКВЭД – общий классификатор видов экономической деятельности.
	191
	192	Физический магазин – место с физическим адресом с возможностью покупки там товаров брендов Карвиль.
	193
	194
	195	Этап акцептования Субдилера и присвоение уникального ID
	196
	197	Участие в программе возможно при поступлении заявки от Субдилера самостоятельно через портал «Карвиль-Бонус» расположенного по адресу [[https:~~/~~/bonus.carville.ru>>url:https://bonus.carvile.ru]]. В течении 3 рабочих дней Карвиль проверяет и подтверждает или отклоняет заявку на участие.
	198
	199	Карвиль проверяет Субдилера на соответствие критериям:
	200
	201	- проверка по ИНН – действующая организация с ОКВЭД позволяющем участвовать в реализации товаров Карвиль;
	202
	203	- Субдилер имеет физический магазин, находящийся фактическому по адресу, указанному при регистрации;
	204
	205	- при необходимости, может быть запрошена дополнительная информация от Дистрибьютора, указанного при регистрации Субдилером, для подтверждения закупок;
	206
	207	- Карвиль может связаться с Субдилером по указанным при регистрации контактным данным для уточнения информации.
	208
	209	При регистрации проводится проверка по ИНН, телефону и адресу электронной почты с запретом на повторную регистрацию в программе. Если участие Субдилера в программе ранее было приостановлено, то повторная регистрация или возобновление участия возможно только через службу поддержки Карвиль после обращения Субдилера по адресу [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]]. Сообщение о возобновлении участия Субдилера в программе «Карвиль-бонус» Дистрибьюторам такое же, как о новом участнике программы.
	210
	211	При допуске Субдилера к участию в программе Карвиль оповещает указанных Субдилером Дистрибьюторов по электронной почте о новом участнике программы с указанием ИНН. Письмо формируется 1 раз в день и может содержать информацию о нескольких участниках. В электронное письмо прикладывается во вложенном файле формата .csv с заголовком “ИНН” и перечнем ИНН новых участников программы.
	212
	213	Со следующего рабочего дня Дистрибьютор обязуется присылать информацию о товарах, реализованных новому участнику программы.
	214
	215	Карвиль может присвоить или приостановить статус участника в программе «Карвиль-Бонус» по своему усмотрению с обязательным оповещением Субдилера по электронной почте.
	216
	217	Исключение участников из программы производится в “ручном” режиме - дистрибьютор оповещается письмом без вложения об исключении участника. В этом случае информация по нему более не нужна.
	218
	219
	220	Требования к передаче информации
	221
	222	Для получения информации по программе почта должна быть с согласованных с УК Карвиль почтовых адресов Дистрибьютора. На время разработки и тестирования системы «Карвиль-Бонус» Дистрибьютор сообщает о своем желании участвовать в программе на почтовый адрес [[bonus@carville.ru>>path:mailto:bonus@carville.ru]] и указывает электронный адрес с которого будет приходить информация о закупках Субдилеров. В ответ Карвиль отправляет подтверждение регистрации нового почтового адреса для приема информации.
	223
	224	Обмен информации ведется через почтовый адрес и по API.
	225
	226	Обмен через API
	227
	228	Документация по апи лежит здесь:
	229
	230	[[https:~~/~~/bonus.carville.ru/api-clients/doc/>>url:https://bonus.carville.ru/api-clients/doc/]]
	231
	232	[[https:~~/~~/bonus.carville.ru/api/doc/>>url:https://bonus.carville.ru/api/doc/]]
	233
	234	От клиента на сайт закупки попадают методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api-clients-test/purchases/>>url:https://bonus.carville.ru/api-clients-test/purchases/]]
	235
	236	Передаются с сайта в Айрус закупки методом POST, ручкой [[https:~~/~~/bonus.carville.ru/api/purchases/export>>url:https://bonus.carville.ru/api/purchases/export]]
	237
	238	Обратно на сайт инфа едет методом GET, дергается ручка [[https:~~/~~/bonus.carville.ru/api/purchases/import>>url:https://carville-bonus.kz/api/purchases/import]]
	239
	240	Обмен по почте:
	241
	242	Тема и текст в теле письма значения не имеют. Просматриваются только вложения в письмо.
	243
	244	В отправленном письме должен быть приложен только один файл. Отправленный файл должен быть в форматах .xls, .xlsx или .csv. При этом Дистрибьютор должен выбрать один формат передачи данных и следовать ему. При замене формата передачи данных, Дистрибьютор должен сообщить об этом на почту [[helpdesk@carville.ru>>path:mailto:helpdesk@carville.ru]] не менее чем за 1 рабочий день до смены формата.
	245
	246	После отправки письма должен прийти ответ с подтверждением, что все данные приняты или ответом с перечнем ошибок, если данные приняты не были.
	247
	248	Требования к вложенным файлам
	249
	250	Требования к файлам .xls и .xlsx:
	251
	252	- название файла должно быть «ГГГГММДД_ИНН», где ГГГГ – год, ММ – месяц, ДД – день, за который присланы данные;
	253
	254	- формат ячеек “Общий”;
	255
	256	- не должно быть объединенных или скрытых ячеек;
	257
	258	- в книге excel должен быть только один лист;
	259
	260	- на листе не должно быть формул или иных значений, кроме требуемых;
	261
	262	- должен соблюдаться порядок столбцов;
	263
	264	Требования к файлам формата .csv:
	265
	266	- Название - ГГГГММДД_ИНН.csv, где ИНН - ваш ИНН;
	267
	268	- первая строка – заголовки;
	269
	270	- порядок столбцов должен быть сохранен;
	271
	272	- кодировка ANSI;
	273
	274	- перевод строки стандартный (перевод строки + возврат каретки);
	275
	276	- разделитель полей “;” точка с запятой.
	277
	278	- разделитель дробной части чисел точка.
	279
17.1	280	[[image:1755865898145-184.png\|\|height="271" width="318"]]
	281
	282	[[image:1755865929388-276.png\|\|height="142" width="741"]]
	283
18.1	284	Обработка файлов в старом формате происходит с файлов, которые прилетают на почту bonus@carvilleshop.ru
	285	Старые файлы имеют формат Экселя, в котором есть поля: Бренд, Артикул, Количество, ИНН, Дата.
17.1	286	При обработке берется строчка и считается согласно цене RRP по каждому товару, далее уже товар с ценой попадает в "Закупки" у каждого участника
	287
1.1	288	В файле должны содержаться следующие столбцы, указанные в таблице 1. Порядок следования столбцов обязателен.
	289
	290
	291	Таблица 1.
	292
	293	\|Порядок столбца\|Название столбца\|Технические требования\|Описание
	294	\|1\|Бренд\|(((
	295	Обязательно. Текст. Возможные варианты:
	296
	297	- Luzar;
	298
	299	- Trialli:
	300
	301	- StartVolt;
	302
	303	- Airline;
	304
	305	- CarvilleRacing;
	306
	307	Возможно написание название брендов в любом регистре и с пробелами, буквы латинские.
	308	)))\|(((
	309	Бренд, к которому относится выбранный товар.
	310
	311
	312	)))
	313	\|2\|Артикул\|Обязательно. Текст, не более 60 символов. Специальные символы (в т.ч. пробел) не учитываются.\|Артикул товара, например, LG 0101. Регистр и спецсимволы значения не имеют.
	314	\|3\|Количество \|Обязательно. Целое число.\|количество проданного товара за сутки.
	315	\|4\|ИНН/ID\|Текст. Обязательно*\|ИНН клиента слэш ID в вашей базе данных для однозначного определения клиента. Если ИНН нет, то “/XXX” - где XXX id.
	316	\|6\|ДАТА\|Формат Даты - ГГГГММДД\|20230131 - год, месяц день за которые подаются продажи.
	317
	318	~* - обязательно заполнение хотя бы одного из этих полей.
	319
	320
	321	Возможна привязка поданных товаров к внутренним документам, для удобства ведения статистики, в этом случае должны быть добавлены 2 дополнительных столбца:
	322
	323	Таблица 1, продолжение
	324
	325	\|Порядок столбца\|Название столбца\|Технические требования\|Описание
	326	\|8\|Номер документа\|Не обязательно. Текст.\|Номер документа, например, счет фактуры.
	327	\|9\|ID документа\|Не обязательно. Текст.\|Уникальный идентификатор документа в вашей базе данных.
	328
	329	Внесение изменений
	330
17.1	331	В случае изменения требований к содержанию передаваемых файлов УК Карвиль предупреждает за неделю до изменений.
1.1	332
	333	В случае, если будет прислан файл с тем же названием, что был прислан ранее, то все данные из присланного ранее файла заменятся на новые. В ответном письме, в случае корректного содержания письма, будет указано, что внесены новые данные или данные были перезаписаны.
	334
	335	Обновление сведений в бонусной программе производится 1 раз в сутки.