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