Main.Руководство Карвиль-Бонус - Руководство Карвиль-Бонус

Page of - last modified by Никита Романенко on 2025/09/11 06:05

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

Никита Романенко

2025/09/11 06:05

Table of Contents

Введение

Программа представляет собой структуру стимулирования продаж на уровне субдилеров, автомагазинов и СТО. Она позволяет участникам получать бонусные баллы за закупки продукции брендов Luzar, Trialli, Startvolt, Airline и CarvilleRacing.

В программе могут участвовать юридические лица и ИП, имеющие автомагазины или СТО. Не допускаются интернет-магазины и маркетплейсы.

Сейчас в программе принимают участие около 14 тыс. активных участников.

Регистрация производится через портал bonus.carville.ru. После подачи заявки УК Карвиль проводит проверку (ИНН, наличие физического магазина). Процесс акцептования занимает до 3 рабочих дней.

Дистрибьюторы получают уведомления о новых субдилерах по электронной почте и обязаны ежедневно передавать информацию о продажах УК Карвиль. Основной адрес для работы: bonus@carville.ru (передача данных). В случае неработоспособности сервиса Дистрибьютор может сообщить в службу поддержки сервиса - helpdesk@carville.ru (поддержка).

Для расчета величины бонусов для участников программы «Карвиль-бонус» необходима информация об объеме закупленных товаров.(см. "Обмен по почте")

КБ заявки и промо-коды.drawio

"Типы бонусов субдилеров"

Пуск -> Справочники -> Типы бонусов субдилеров

Поле	Значение
ID	id субдилера
Наименование	Название типа бонуса
Цель(руб)	Сумма, после которой происходит начисление
Цель(шт)
Бонус	Процент начисления
Товары	Категории товаров
Период
Статус
Период С	Период действия бонуса
Период ПО	Период действия бонуса
Производитель
Для аккредитованных	Проставляется типам бонусов для которых используется
Аффилирован	Проставляется типам бонусов для которых используется

Для редактирования информации - ПКМ по бонусу -> Настройка бонуса

Здесь можно изменить:

1. Наименование

2. Период действия бонуса "от" и "до"

3. Цель в руб. и шт. после которой будет начисляться бонус

4. Товары, за которые будет начисляться бонус

5. Производитель (не используется)

6. Бонус(% начисления)

7. Статус

7.1 На согласовании(бонус создан, но не согласован Петром Н.)

7.2 Согласован (утвержден), будет активен в рамках установленного периода

7.3 Завершен ( = приостановить действие бонуса)

После окончания действия бонуса, на сайте не будет отображаться процент начисления, начисления происходить не будет.

Выделение серым цветом обозначает бонусы для аккредитованных субдилеров

Выделение белым цветом обозначает бонусы для обычных пользователей

Выделение голубым цветом обозначает бонусы для аффилированных( коэффициент 0,5 - процент начисления) начисляются при выполнении плана (см. вкладка "Планы")

Модуль "Субдилеры и бонусы"

"Статистика"

"Статистика закупок по дистрибьюторам в разрезе дат и субдилеров"

Чек-бокс "Включить дерево с субдилерами" не используется

"Дистрибьюторы"

Поле	Значение
Код	ID дистр.
Наименование
ИНН
Способ обмена	по почте или по api
Юр. Лицо	Наименование
ИНН
Код
Запрос на обработку	Запуск обмена вручную
Обработано	Когда произошел
Пользователь	Кто запустил

"Планы"

Планы по начислению проставляются вручную, либо из карточки субдилера, либо в интерфейсе вкладки "Планы". На вкладке по ПКМ можно импортировать значения из файла(скрин пример файла снизу).

Планы по начислению относятся только к аффилированным участникам

По ПКМ на субдилера открывается карточка субдилера

"Карточка субдилера"

"Анкета"

Здесь содержится основная информация по субдилеру.

Все поля редактируемые

Поле "Дистрибьютор" не используется

Поле "Статус":

"На согласовании"(пройдена рег-ция, профиль не редактировался)

Инфо от РП - Региональный представитель после встречи заполняет данные(мобильное приложение "Встречи"), данные прилетают в Айрус.

"Адреса"

Не используется

"Дистрибьюторы"

Привязанные дистрибьюторы, выбранные в профиле на сайте

Чек-бокс "Основной" не используется

"Закупки"

Только здесь хранятся все закупки отдельно по субдилеру, передаются с сайта

"Статистика"

Статистика по закупкам

"Бонусы"

Бонусы применённые к субдилеру

"Заявки"

Здесь отображаются заявки на списание бонусов

Заявка прилетает двумя способами: через кассового партнера и через карвильшоп

1. Через кассового партнера

1.1.На сайте, пользователем выбирается дистрибьютор(не все дистрибьюторы(14) доступны к выбору, нужно подписать согласие стать кассовым партнером)

1.2.Прилетает заявка со статусом "Бонус через дистрибьютора"

Первый этап согласования сотрудниками Нестеренко М.А или Гладышевым П.А.:

- Согласуется заявка, статус с "Новая" на "Заявка на выдачу"

Второй этап согласования Нечипоренко П.А :

- Изменяется статус с "Заявка на выдачу" на "Проведен взаиморасчет"

- Заявки суммируются, сумма попадает в "Книги" -> "Взаиморасчеты" (по каждому дистриб. отдельно)

Далее, информация передаётся на сайт с ночным обменом, либо можно запустить обмен вручную по одной заявке - ПКМ -> отправить инф. на портал -> При следующем обмене/Немедленно

Генерируется промокод на карвильшопе (уточнить этот момент)

Субдилеру приходит оповещение на почту о готовности промокода и возможности применить на карвильшопе(Нужна отдельная регистрация для применения промокода)

"Загрузки"

"Доп. ИНН"

"Инфо от РП"

"Встречи"

Здесь указываются встречи с региональными представителями

"Комментарии"

"План"

"Заявки"

Обозначения цветом:

Белый цвет - Новые заявки или отмененные

Синий цвет - Согласованные заявки

Красный цвет - заявки с балансом меньше либо равно 10к

Существуют 2 типа бонусов:

- Подарки

- Бонус через дистрибьютора

Термины, определения, сокращения

Акцептование – процесс проверки Субдилера для допуска к участию в программе «Карвиль-Бонус».

Субдилер – претендент или участник программы «Карвиль-Бонус».

ОКВЭД – общий классификатор видов экономической деятельности.

Аффилированный участник - субдилер имеющий план, после которого начисляются бонусы.

Физический магазин – место с физическим адресом с возможностью покупки там товаров брендов Карвиль.

Этап акцептования Субдилера и присвоение уникального ID

Участие в программе возможно при поступлении заявки от Субдилера самостоятельно через портал «Карвиль-Бонус» расположенного по адресу https://bonus.carville.ru. В течении 3 рабочих дней Карвиль проверяет и подтверждает или отклоняет заявку на участие.

Карвиль проверяет Субдилера на соответствие критериям:

- проверка по ИНН – действующая организация с ОКВЭД позволяющем участвовать в реализации товаров Карвиль;

- Субдилер имеет физический магазин, находящийся фактическому по адресу, указанному при регистрации;

- при необходимости, может быть запрошена дополнительная информация от Дистрибьютора, указанного при регистрации Субдилером, для подтверждения закупок;

- Карвиль может связаться с Субдилером по указанным при регистрации контактным данным для уточнения информации.

При регистрации проводится проверка по ИНН, телефону и адресу электронной почты с запретом на повторную регистрацию в программе. Если участие Субдилера в программе ранее было приостановлено, то повторная регистрация или возобновление участия возможно только через службу поддержки Карвиль после обращения Субдилера по адресу helpdesk@carville.ru. Сообщение о возобновлении участия Субдилера в программе «Карвиль-бонус» Дистрибьюторам такое же, как о новом участнике программы.

При допуске Субдилера к участию в программе Карвиль оповещает указанных Субдилером Дистрибьюторов по электронной почте о новом участнике программы с указанием ИНН. Письмо формируется 1 раз в день и может содержать информацию о нескольких участниках. В электронное письмо прикладывается во вложенном файле формата .csv с заголовком “ИНН” и перечнем ИНН новых участников программы.

Со следующего рабочего дня Дистрибьютор обязуется присылать информацию о товарах, реализованных новому участнику программы.

Карвиль может присвоить или приостановить статус участника в программе «Карвиль-Бонус» по своему усмотрению с обязательным оповещением Субдилера по электронной почте.

Исключение участников из программы производится в “ручном” режиме - дистрибьютор оповещается письмом без вложения об исключении участника. В этом случае информация по нему более не нужна.

Требования к передаче информации

Для получения информации по программе почта должна быть с согласованных с УК Карвиль почтовых адресов Дистрибьютора. На время разработки и тестирования системы «Карвиль-Бонус» Дистрибьютор сообщает о своем желании участвовать в программе на почтовый адрес bonus@carville.ru и указывает электронный адрес с которого будет приходить информация о закупках Субдилеров. В ответ Карвиль отправляет подтверждение регистрации нового почтового адреса для приема информации.

Обмен информации ведется через почтовый адрес и по API.

Обмен через API

Документация по апи лежит здесь:

https://bonus.carville.ru/api-clients/doc/

https://bonus.carville.ru/api/doc/

От клиента на сайт закупки попадают методом POST, ручкой https://bonus.carville.ru/api-clients-test/purchases/

Передаются с сайта в Айрус закупки методом POST, ручкой https://bonus.carville.ru/api/purchases/export

Обратно на сайт инфа едет методом GET, дергается ручка https://bonus.carville.ru/api/purchases/import

Обмен по почте:

Тема и текст в теле письма значения не имеют. Просматриваются только вложения в письмо.

В отправленном письме должен быть приложен только один файл. Отправленный файл должен быть в форматах .xls, .xlsx или .csv. При этом Дистрибьютор должен выбрать один формат передачи данных и следовать ему. При замене формата передачи данных, Дистрибьютор должен сообщить об этом на почту helpdesk@carville.ru не менее чем за 1 рабочий день до смены формата.

После отправки письма должен прийти ответ с подтверждением, что все данные приняты или ответом с перечнем ошибок, если данные приняты не были.

Требования к вложенным файлам

Требования к файлам .xls и .xlsx:

- название файла должно быть «ГГГГММДД_ИНН», где ГГГГ – год, ММ – месяц, ДД – день, за который присланы данные;

- формат ячеек “Общий”;

- не должно быть объединенных или скрытых ячеек;

- в книге excel должен быть только один лист;

- на листе не должно быть формул или иных значений, кроме требуемых;

- должен соблюдаться порядок столбцов;

Требования к файлам формата .csv:

- Название - ГГГГММДД_ИНН.csv, где ИНН - ваш ИНН;

- первая строка – заголовки;

- порядок столбцов должен быть сохранен;

- кодировка ANSI;

- перевод строки стандартный (перевод строки + возврат каретки);

- разделитель полей “;” точка с запятой.

- разделитель дробной части чисел точка.

Обработка файлов в старом формате происходит с файлов, которые прилетают на почту bonus@carvilleshop.ru
Старые файлы имеют формат Экселя, в котором есть поля: Бренд, Артикул, Количество, ИНН, Дата.
При обработке берется строчка и считается согласно цене RRP по каждому товару, далее уже товар с ценой попадает в "Закупки" у каждого участника

В файле должны содержаться следующие столбцы, указанные в таблице 1. Порядок следования столбцов обязателен.

Таблица 1.

Порядок столбца	Название столбца	Технические требования	Описание
1	Бренд	Обязательно. Текст. Возможные варианты: - Luzar; - Trialli: - StartVolt; - Airline; - CarvilleRacing; Возможно написание название брендов в любом регистре и с пробелами, буквы латинские.	Бренд, к которому относится выбранный товар.
2	Артикул	Обязательно. Текст, не более 60 символов. Специальные символы (в т.ч. пробел) не учитываются.	Артикул товара, например, LG 0101. Регистр и спецсимволы значения не имеют.
3	Количество	Обязательно. Целое число.	количество проданного товара за сутки.
4	ИНН/ID	Текст. Обязательно*	ИНН клиента слэш ID в вашей базе данных для однозначного определения клиента. Если ИНН нет, то “/XXX” - где XXX id.
6	ДАТА	Формат Даты - ГГГГММДД	20230131 - год, месяц день за которые подаются продажи.

* - обязательно заполнение хотя бы одного из этих полей.

Возможна привязка поданных товаров к внутренним документам, для удобства ведения статистики, в этом случае должны быть добавлены 2 дополнительных столбца:

Таблица 1, продолжение

Порядок столбца	Название столбца	Технические требования	Описание
8	Номер документа	Не обязательно. Текст.	Номер документа, например, счет фактуры.
9	ID документа	Не обязательно. Текст.	Уникальный идентификатор документа в вашей базе данных.

Внесение изменений

В случае изменения требований к содержанию передаваемых файлов УК Карвиль предупреждает за неделю до изменений.

В случае, если будет прислан файл с тем же названием, что был прислан ранее, то все данные из присланного ранее файла заменятся на новые. В ответном письме, в случае корректного содержания письма, будет указано, что внесены новые данные или данные были перезаписаны.

Обновление сведений в бонусной программе производится 1 раз в сутки.