Открыть главное меню

4mycar: различия между версиями

(Содержимое страницы заменено на «*'''4MyCar''' *'''Отзывы и комментарии на 4mycar'''»)
 
(не показаны 3 промежуточные версии 2 участников)
Строка 1: Строка 1:
Инструкция для размещения своих и партнерских прайс-листов на www.4mycar.ru. Выполните следующие действия для выполнения процедуры:
+
*[[4mycar_settings|'''4MyCar''']]
 
+
*[[4mycar:ratings|'''Отзывы и комментарии на 4mycar''']]
== Создание склада для загрузки предложений на 4mycar ==
 
 
 
[[Изображение:Карточка_магазина.jpg|thumb|left|700px|Меню "4MyCar" -> "Карточка магазина"]] Заполните карточку магазина.<br clear="both" />
 
[[Изображение:Карточка магазина форма.jpg|thumb|left|700px|Карточка поставщика с фиксированными ценами]] Появится окно заполнения параметров. В данном окне необходимо указать название организации, сайт, координаты (включая координаты GPS, через интерактивную карту Google), условия поставки и оплаты товара и контактные данные. После заполнения карточки нажмите "Сохранить".<br> Для того, чтобы увидеть, как выглядит заполненная карточка магазина на 4mycar.ru необходимо осуществлять переход в карточку из Панели управления, для избежания списывания лишних HIT-ов<br clear="both" />
 
 
 
[[Изображение:Документы.jpg|thumb|left|700px|Загрузка документов]] После сохранения карточки магазина необходимо перейти на страницу Панель управления -> "4MyCar" -> "Документы". В форме необходимо выбрать тип организации и загрузить требуемые документы для модерации.<br clear="both" />
 
 
 
 
 
== Заливка прайс-листов  ==
 
На странице "Поставщики" выберите прайс-листы, которые должны отображаться на сервисе 4mycar.
 
[[Изображение:Прайс 4мс.png|thumb|left|700px|Загрузка файла]] Для этого необходимо переместить переключатель для генерации прайса. <br clear="both" />
 
[[Изображение:Условия 4мс.png|thumb|left|700px|Условия работы]] После, необходимо перейти в настройки конкретного прайса, на вкладку “На 4mycar”, и заполнить условия работы на сервисе, состояние товаров, ценовой профиль, маршрут, расписание генерации. При следующем обновлении поставщика, виртуальный склад автоматически обновится и позиции с него будут находиться при поиске на www.4mycar.ru  <br clear="both" />
 
 
 
 
 
 
 
== Управление прайс-листами с помощью API ==
 
 
 
Для управления прайсами 4mycar можно воспользоваться следующими api-операциями. Хост для выполнения операций id0000.public.api.abcp.ru, где id0000 - ваш id сайта. Имя API-администратора и md5-хэш пароля запросите в техподдержке.
 
 
 
===== Получение списка поставщиков =====
 
'''Операция: cp/distributors'''<br />
 
'''Метод: GET'''
 
 
 
Возвращает список всех поставщиков, подключенных в ПУ/Поставщики.
 
 
 
'''Параметры запроса'''
 
{| class="wikitable"
 
!Параметр
 
!Описание
 
|-
 
!userlogin
 
|Имя API-администратора
 
|-
 
!userpsw
 
|md5-хэш пароля API-администратора
 
|-
 
!distributors4mc
 
|Необходимо передавать значение "1"
 
|}
 
 
 
'''Пример запроса'''
 
http://id0000.public.api.abcp.ru/cp/distributors?userlogin=username&userpsw=md5pass&distributors4mc=1
 
 
 
Метод возвращает массив объектов вида:
 
{| class="wikitable"
 
!Параметр
 
!Описание
 
|-
 
!id
 
|id поставщика
 
|-
 
!name
 
|Название поставщика
 
|-
 
!currencyDesignation
 
|Валюта поставщика
 
|-
 
!isEnabled
 
|Статус поставщика (0 - выключен, 1 - включен)
 
|-
 
!updateTime
 
|Дата последнего обновления
 
|-
 
!positionsNumber
 
|Позиций в наличии
 
|-
 
!Другие переменные
 
|Не используются в 4mycar
 
|-
 
|}
 
 
 
<span id="cp_crosses"></span>
 
 
 
===== Изменение статуса поставщика =====
 
'''Операция: cp/distributor/status'''<br />
 
'''Метод: POST'''
 
 
 
'''Параметры запроса'''
 
{| class="wikitable"
 
!Параметр
 
!Описание
 
|-
 
!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
 
 
 
Метод возвращает объект вида:
 
{| class="wikitable"
 
!Параметр
 
!Описание
 
|-
 
!status
 
|Статус выполнения операции. В случае успешного выполнения возвращает 1.
 
|-
 
!errorMessage
 
|Сообщение об ошибке(если она есть).
 
|}
 
 
 
<span id="cp_distributor_pricelistUpdate"></span>
 
<span id="price_list_update"></span>
 
 
 
===== Загрузка прайс-листа поставщика =====
 
'''Операция: cp/distributor/pricelistUpdate'''<br />
 
'''Метод: POST'''<br />
 
В ПУ, в разделе "Поставщики"/"Обн."/"Конфигурация прайс-листа" предварительно [[ImportConfig|настраивается конфигурация]] загружаемого прайс-листа. Специальных требований к прайс-листу нет, есть только обычные: наличие колонок с ценой, брендом, каталожным номером, описанием, наличием. На вкладке "Загрузка прайс-листа" может быть выбран любой способ загрузки. <br />
 
'''Параметры запроса'''
 
{| class="wikitable"
 
!Параметр
 
!Описание
 
|-
 
!userlogin
 
|Имя API-администратора
 
|-
 
!userpsw
 
|md5-хэш пароля API-администратора
 
|-
 
!distributorId
 
|Id поставщика
 
|-
 
!uploadFile
 
|файл прайс-листа переданный в multipart/form-data
 
|-
 
|}
 
'''''Внимание!!!''''' Для этой операции необходимо использовать медиа-тип multipart/form-data.<br />
 
 
 
 
 
'''Пример запроса'''
 
<pre>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</pre>
 
 
 
'''Примеры скриптов для выполнения операции'''
 
 
 
* Windows - [https://github.com/NodaSoftLtd/ABCP-PriceListUpdate-Helper/archive/master.zip СКАЧАТЬ] После скачивания необходимо распаковать 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 - [https://github.com/NodaSoftLtd/ABCP-PriceListUpdate-Helper/archive/master.zip СКАЧАТЬ] После скачивания необходимо распаковать zip архив в любую папку. Отредактируйте файл posix/update_price.sh указав в блоке Config свои логин и пароль API администратора, а также хост для обращения к API. Для запуска используйте консоль:
 
 
 
sh /home/user/update_price.sh 369645 '/home/user/my_price.csv'
 
 
 
где первый аргумент: 369645 - id поставщика, второй аргумент - путь к файлу прайс-листа.
 
 
 
 
'''Необходимо наличие установленной библиотеки curl.'''
 
 
 
[https://github.com/NodaSoftLtd/ABCP-PriceListUpdate-Helper Проект на GitHub]
 
 
 
Метод возвращает объект вида:
 
{| class="wikitable"
 
!Параметр
 
!Описание
 
|-
 
!status
 
|Статус выполнения операции. В случае успешного выполнения возвращает 1.
 
|-
 
!message
 
|Сообщение о результатах работы.
 
|}
 
 
 
 
 
<br clear="both" />
 
 
 
== Выделение кнопки "Купить" зеленым цветом ==
 
 
 
[[Файл:Выдача4мк.jpg|thumb|left|700px|Зеленая кнопка "Купить"]] На 4mycar.ru некоторые предложения привлекают к себе больше внимания, поскольку напротив них стоит зеленая кнопка "Купить".<br>
 
Вы также можете разместить зеленую кнопку напротив ваших предложений. Данная кнопка появляется, если:
 
* '''На вашем сайте стоит информер 4mycar''' - для размещения информера на сайте перейдите в раздел ПУ Главная/4MyCar/Информер, скопируйте код и разместите через html-редактор инфоблока в подвал сайта. Инфоблоки расположены в разделе Главная/Внешний вид и контент/Инфоблоки, фильтрация в поле "Содержит" по слову "подвал";
 
* '''Рейтинг вашего магазина должен быть больше 3.9''' - расчет рейтинга производится по 10 последним оценкам (среднеарифметическое). Т.е. складываются последние 10 оценок, и полученная сумма делится на 10.
 
Кнопка станет зеленой примерно через сутки после размещения кода информера.<br clear="both" />
 
 
 
== Предупреждение о низком рейтинге ==
 
Чем ниже рейтинг, тем меньше шансы попасть в первые строки выдачи по умолчанию. <br>
 
Рекомендуем мотивировать клиентов оставлять оценки и отзывы о вашем магазине, поскольку со временем, в целях улучшения качества сервиса 4mycar.ru, нижний порог рейтинга будет расти.
 

Текущая версия на 16:59, 28 июля 2020