4mycar settings

Инструкция для размещения своих и партнерских прайс-листов на www.4mycar.ru. Выполните следующие действия для выполнения процедуры:

Создание склада для загрузки предложений на 4mycar

Меню "4MyCar" -> "Карточка магазина"

Заполните карточку магазина.

Карточка поставщика с фиксированными ценами

Появится окно заполнения параметров. В данном окне необходимо указать название организации, сайт, координаты (включая координаты GPS, через интерактивную карту Google), условия поставки и оплаты товара и контактные данные. После заполнения карточки нажмите "Сохранить".
Для того, чтобы увидеть, как выглядит заполненная карточка магазина на 4mycar.ru необходимо осуществлять переход в карточку из Панели управления, для избежания списывания лишних HIT-ов

Загрузка документов

После сохранения карточки магазина необходимо перейти на страницу Панель управления -> "4MyCar" -> "Документы". В форме необходимо выбрать тип организации и загрузить требуемые документы для модерации. После проверки доступ к сервису будет включен и прайсы можно будет загрузить

Заливка прайс-листов

На странице "Поставщики" выберите прайс-листы, которые должны отображаться на сервисе 4mycar.

Загрузка файла

Для этого необходимо переместить переключатель для генерации прайса.

Условия работы

После, необходимо перейти в настройки конкретного прайса, на вкладку “На 4mycar”, и заполнить условия работы на сервисе, состояние товаров, ценовой профиль, маршрут, расписание генерации. При обновлении поставщика, виртуальный склад автоматически обновится и позиции с него будут находиться при поиске на www.4mycar.ru Если прайс должен отображаться только на 4mycar и не должен отображаться на вашем сайте - необходимо в блоке "Сайт", в настройках всего прайса, нажать "Отключить от сайта".

Управление прайс-листами с помощью API

Для управления прайсами 4mycar можно воспользоваться следующими api-операциями. Хост для выполнения операций id0000.public.api.abcp.ru, где id0000 - ваш id сайта. Имя API-администратора и md5-хэш пароля запросите в техподдержке.

Получение списка поставщиков

Операция: cp/distributors
Метод: GET

Возвращает список всех поставщиков, подключенных в ПУ/Поставщики.

Параметры запроса

Параметр	Описание
userlogin	Имя API-администратора
userpsw	md5-хэш пароля API-администратора
distributors4mc	Необходимо передавать значение "1"

Пример запроса

http://id0000.public.api.abcp.ru/cp/distributors?userlogin=username&userpsw=md5pass&distributors4mc=1

Метод возвращает массив объектов вида:

Параметр	Описание
id	id поставщика
name	Название поставщика
currencyDesignation	Валюта поставщика
isEnabled	Статус поставщика (0 - выключен, 1 - включен)
updateTime	Дата последнего обновления
positionsNumber	Позиций в наличии
Другие переменные	Не используются в 4mycar

Изменение статуса поставщика

Операция: cp/distributor/status
Метод: POST

Параметры запроса

Параметр	Описание
userlogin	Имя API-администратора
userpsw	md5-хэш пароля API-администратора
distributorId	Id поставщика
status	1 - Вкл. \ 0 - Выкл.

Пример запроса

http://id0000.public.api.abcp.ru/cp/distributor/status?userlogin=username&userpsw=md5pass&status=1

Метод возвращает объект вида:

Параметр	Описание
status	Статус выполнения операции. В случае успешного выполнения возвращает 1.
errorMessage	Сообщение об ошибке(если она есть).

Загрузка прайс-листа поставщика

Операция: cp/distributor/pricelistUpdate
Метод: POST
В ПУ, в разделе "Поставщики"/"Обн."/"Конфигурация прайс-листа" предварительно настраивается конфигурация загружаемого прайс-листа. Специальных требований к прайс-листу нет, есть только обычные: наличие колонок с ценой, брендом, каталожным номером, описанием, наличием. На вкладке "Загрузка прайс-листа" может быть выбран любой способ загрузки.
Параметры запроса

Параметр	Описание
userlogin	Имя API-администратора
userpsw	md5-хэш пароля API-администратора
distributorId	Id поставщика
uploadFile	файл прайс-листа переданный в multipart/form-data

Внимание!!! Для этой операции необходимо использовать медиа-тип multipart/form-data.

Пример запроса

curl -i -X POST -H "Content-Type: multipart/form-data" -F "userlogin=username" -F "userpsw=md5pass" -F "distributorId=369645" -F "uploadFile=@/home/user/pricelist.xlsx" http://id0000.public.api.abcp.ru/cp/distributor/pricelistUpdate

Примеры скриптов для выполнения операции

• Windows - СКАЧАТЬ После скачивания необходимо распаковать zip архив в любую папку. Открыть файл windows/upload.vbs для редактирования в Блокноте и указать в самом верху свои логин и пароль API администратора, а также хост для обращения к API. Сохраните и закройте его. После этого, откройте файл start_full.bat или start_inc.bat для редактирования в Блокноте. Вторым аргументом необходимо указать id поставщика для обновления, а третьим аргументом - путь к файлу прайс-листа. Путь к файлу может быть полным, например: "C:\Users\Admin\my_price.xls". Или относительным, например: ".\my_price.xls", если прайс-лист лежит в той же папке где и скрипт загрузки. Сохраните и закройте файл. Теперь вы можете запустить файл start_full.bat или start_inc.bat двойным кликом, чтобы прайс-лист был загружен.
• Linux - СКАЧАТЬ После скачивания необходимо распаковать zip архив в любую папку. Отредактируйте файл posix/update_price.sh указав в блоке Config свои логин и пароль API администратора, а также хост для обращения к API. Для запуска используйте консоль:

sh /home/user/update_price.sh 369645 '/home/user/my_price.csv'

где первый аргумент: 369645 - id поставщика, второй аргумент - путь к файлу прайс-листа.

Необходимо наличие установленной библиотеки curl.

Проект на GitHub

Метод возвращает объект вида:

Параметр	Описание
status	Статус выполнения операции. В случае успешного выполнения возвращает 1.
message	Сообщение о результатах работы.

Выделение кнопки "Купить" зеленым цветом

Зеленая кнопка "Купить"

На 4mycar.ru некоторые предложения привлекают к себе больше внимания, поскольку напротив них стоит зеленая кнопка "Купить".

Вы также можете разместить зеленую кнопку напротив ваших предложений. Данная кнопка появляется, если:

• На вашем сайте стоит информер 4mycar - для размещения информера на сайте перейдите в раздел ПУ Главная/4MyCar/Информер, скопируйте код и разместите через html-редактор инфоблока в подвал сайта. Инфоблоки расположены в разделе Главная/Внешний вид и контент/Инфоблоки, фильтрация в поле "Содержит" по слову "подвал";
• Рейтинг вашего магазина должен быть больше 3.9 - расчет рейтинга производится по 10 последним оценкам (среднеарифметическое). Т.е. складываются последние 10 оценок, и полученная сумма делится на 10.

Кнопка станет зеленой примерно через сутки после размещения кода информера.

Предупреждение о низком рейтинге

Чем ниже рейтинг, тем меньше шансы попасть в первые строки выдачи по умолчанию.
Рекомендуем мотивировать клиентов оставлять оценки и отзывы о вашем магазине, поскольку со временем, в целях улучшения качества сервиса 4mycar.ru, нижний порог рейтинга будет расти.