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

Version 1.2 by Никита Романенко on 2025/08/20 11:40

Введение

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

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

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

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

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

Данные о продажах передаются ежедневно в виде вложенного файла. Файл должен быть в формате .xls, .xlsx или .csv. В одном письме допускается только один файл.

После загрузки данных приходит ответ: либо подтверждение приёма, либо список ошибок.

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

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

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

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

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

Этап акцептования Субдилера и присвоение уникального 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;

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

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

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

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

Таблица 1.

Порядок столбцаНазвание столбцаТехнические требованияОписание
1Бренд

Обязательно. Текст. Возможные варианты:

-        Luzar;

-        Trialli:

-        StartVolt;

-        Airline;

-        CarvilleRacing;

Возможно написание название брендов в любом регистре и с пробелами, буквы латинские.

Бренд, к которому относится выбранный товар.

 

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

Признак возврата. Если поставлено 1, то это означает, что данная строка соответствует возвращенным товарам.

Если поле пустое или поставлен «0» - это не возврат товара.

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

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

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

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

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

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

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

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

Tags:
Created by Никита Романенко on 2025/08/20 11:40