Прайсы — Веб-сервисы

Список веб-сервисов

В панели администратора в меню Прайсы → Веб-сервисы отображается список подключенных веб-сервисов. 

Фото 1. Список веб-сервисов
Подключение веб-сервисов иллюстрация №2

Подключение веб-сервиса

На примере подключение API parts-soft.ru

ШАГ 1. По клику на кнопку Подключить в списке веб-сервисов появится окно выбора поставщика. 

ШАГ 2. Выберите нужного в списке Доступные веб-сервисы и нажмите на кнопку Запросить подключение.

Фото 2. Запросить подключение
Подключение веб-сервисов иллюстрация №3

ШАГ 3. На открывшейся странице в блоке Данные для подключения укажите нужные параметры: ключ API доступа, логин и пароль, полученные у вашего поставщика.

Набор параметров может отличаться в зависимости от подключаемого веб-сервиса.

Нажмите на кнопку Подключить.

Фото 3. Данные для подключения
Подключение веб-сервисов иллюстрация №4

При подключении веб-сервиса обязательно проверяйте, что у Вас открыт доступ к сервису со стороны поставщика. Доступ к личному кабинету на сайте поставщика не является доступом к веб-сервису. Для некоторых сервисов (например, Emex и Berg) необходимо запрашивать дополнительный доступ. Если доступ не будет получен, то у Вас не будет работать проценка.

Настройки веб-сервиса

Для редактирования настроек нажмите на ссылку Настройки в списке веб-сервисов. Описание параметров представлено в таблицах ниже.

Настройки фильтрации становятся доступными по нажатию на кнопку Включить фильтр. Для отключения их нажмите кнопку Выключить фильтр. Фильтрация выдачи действует на уровне получения данных с веб-сервиса, без предварительной обработки.

Фото 4. Базовые настройки веб-сервиса
Подключения веб-сервисов (обновление) иллюстрация №7

Таблица 1. Базовые настройки веб-сервиса

Название настройки

Описание

1

 Название веб-сервиса

Устанавливается при подключении автоматически.

2

Интегрировать корзину

Подключает автоматическое размещение заказа.

3

Сохранять кроссы

Активирует автоматическое пополнение базы кроссов (меню Служебные → Продукция → Прямые кроссы). Обратите внимание, что это замедляет поиск.

4

Проверка кросс номеров

Включает отображение в результатах поисковой выдачи только тех кроссы, которые удовлетворяют условию проверки (5).

5

Источники проверки кросс номеров

Из выпадающего списка выбирается один из вариантов проверки кросс-номеров (4):

  • Свои кроссы + api.parts-soft.ru + TecDoc — в поисковую выдачу попадут только те кроссы, которые есть в вашей базе кроссов + базе кроссов api.parts-soft.ru + TecDoc;
  • api.parts-soft.ru + TecDoc — в поисковой выдаче будут присутствовать только те кроссы, которые есть в базе кроссов api.parts-soft.ru + TecDoc;
  • TecDoc — попадут только те кроссы, которые есть в базе кроссов TecDoc.

    Возможность доступна только при наличии:

    1. подписки на сервис TecDoc;
    2. активации получения кроссов TecDoc в личном кабинете Parts-Soft.
     

    Обратите внимание, в базе кроссов TecDoc могут отсутствовать некоторые бренды или не входить в список брендов вашего тарифа.

6

Размещать заказ по одной позиции

Разбивает один заказ поставщику из N позиций на N заказов. При этом каждый будет отправлен по отдельности. Например, при 20 позициях получится 20 заказов поставщику. Будет полезна при работе с некоторыми поставщиками, которые переводят в отказ весь заказ, если не могут поставить одну из позиций.

7

Блокировать кроссы

Блокирует любые кроссы. От веб-сервиса будет возвращаться только запрошенный номер.

8

Искать по форматированному номеру

Подключает функционал подмены номеров.

9

Подсклады в режиме "Белый список"

Отключает показ всех новых подскладов. Отображаться будут только те, которые были активированы ранее.

10 Идентификация форматированных номеров только по номеру

Полученный номер от поставщика будет сравниваться с имеющимися в загруженных подменах только по номеру.

11 Переопределять номера и бренды

Позволяет заменить номер + бренд на имеющиеся в загруженных подменах

12

Игнорировать параметр возврата

Позволяет не учитывать параметры возврата, которые приходят от самого веб-сервиса. 
На данный момент эта галочка доступна для веб-сервисов ForumAutoWs, NextAutoPro и для веб-сервисов на платформе Abcp.

Приоритетность параметров возврата:

  •  Параметр, установленный для конкретного склада веб-сервиса, затирает все, что пришло от самого веб-сервиса.
  •  Параметр из прайс-листов применяется строго в том случае, если ранее не был установлен ни один из параметров возврата (см. описание в разделе о настройках складов).

13

Игнорировать опцию ЦС

Будет игнорироваться включенная в опциях прайс-листа галочка Отметить как центральный склад (из блока Настройка поисковой выдачи​​​​​). 

При проценке в админпанели и через сайт для подскладов веб-сервиса не будет отображаться надпись "ЦС" (кроме тех, у которых в настройках включена галочка Отметить как центральный склад).

14

Игнорировать опцию Дистрибьютор

Будет игнорироваться включенная в опциях прайс-листа галочка Отметить как официального дистрибьютора ​​​​​(из блока Настройка поисковой выдачи

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

15

Игнорировать срок от поставщика по АПИ

Позволяет не учитывать сроки доставки от поставщиков, которые передаются через веб-сервисы. Будет полезна в тех случаях, когда они некорректны. Например, сформированы без учета выходных или праздничных дней. 

16

Не подключать при выборе бренда

Некоторые веб-сервисы загрязняют этап выбора производителя при поиске, поскольку передают несуществующие по искомому номеру бренды (например, так делает Автопитер). 
При включении галочки веб-сервис не будет генерировать "мусор".

Данные о каких-то брендах могут выпасть из поиска, если они есть только у веб-сервиса, для которого выполнена настройка.

Фото 5. Параметры подключения
Подключения веб-сервисов (обновление) иллюстрация №8

Таблица 2. Параметры подключения 

Название настройки

Описание

1

Логин

Логин на сайте поставщика или ключ api доступа.

2

Логин 2

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

3

Пароль

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

4

Префикс поставщика

Введите буквенное обозначение для складов веб-сервиса, которое будет добавлено в их названия помимо числового кода. Для префикса можно использовать только латинские буквы. Например, если указать здесь ATER, то склад 4567 получит название ATER4567.

 
Префикс должен быть задан при первоначальной настройке веб-сервиса — ДО первой проценки. Если префикс задать уже после проценки, то он не будет добавлен.

5

Таймаут соединения

Максимальное время, в течении которого система ожидает ответа от веб-сервиса, далее соединение сбрасывается.

6

URL

Поле обязательное для заполнения. Адрес сайта поставщика.

Указывается без слеша в конце. Например, https://ваш-поставщик.ru
7 URL Сервиса заказа  
8 URL Сервиса движения  

Фото 6. Дополнительные настройки
Подключения веб-сервисов (обновление) иллюстрация №9

Таблица 3. Дополнительные настройки 

Название настройки

Описание

1

Адрес доставки

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

  • Метод доставки
  • Офис самовывоза
  • Типы оплат
  • Дата отгрузки
  • Отравлять в заказ
  • и др.
Обязательно указывать при настройке веб сервисов Армтек и Берг.

2

Комментарий

 

3

Приоритетные бренды

Используйте, когда веб-сервис не применяет настроенное объединение брендов. Более подробно в инструкции.

4

Копировать данные из веб-сервиса

Используется при настройке функционала создания копий веб-сервисов.

Фото 7. Настройки фильтров
Подключения веб-сервисов (обновление) иллюстрация №10 

Таблица 4. Настройки фильтров

Название настройки

Описание

1

Критерий

 Доступные значения:

  • по цене,
  • по сроку,
  • по статистике (отношение количества выданных позиций к количеству, ушедших в отказ),
  • лучшие по цене, сроку,
  • лучшие по цене, сроку, статистике;

2

Количество на критерий

 

3

Мин.статистика

 
4 Срок доставки не более

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

5

Отклонение цены

Доступны значения:

  • нет
  • от минимума
  • от максимума
  • от медианы.

6

% Процент отклонения

При использовании вышеуказанных настроек в группе одинаковых позиций (одинаковые oem и бренд) выделяется позиция с минимальной/максимальной/медианной ценой, и относительно нее рассматривается отклонение на заданный процент. 
ПРИМЕР. Укажем отклонение цены от минимума на 20%. В группе C110 DOLZ есть 6 позиций с ценами 100, 110, 120, 130, 140, 150, 151. В таком случае в результате фильтрации останутся позиции с ценами от 100 до 120 включительно.

7

Убрать позиции с неизвестным количеством

 

Привязка веб-сервиса к прайс-листу

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

ШАГ 1. В списке подключенных веб-сервисов в столбце Связанный прайс-лист нажмите на ссылку Не активен... Такая ссылка отображается для тех веб-сервисов, у которых нет привязанных прайс-листов. 

ШАГ 2. В разделе админпанели Прайсы  → Создать создайте прайс-лист для онлайн-проценки.

Фото 8. Новый прайс-лист
Подключение веб-сервисов иллюстрация №10

ШАГ 3. Список веб-сервисов обновится. У веб-сервиса, для которого была выполнена настройка, в столбце Связанный прайс-лист будет указано название привязанного прайс-листа. 

Фото 9. Привязанный прайс-лист
Прайсы — Веб-сервисы иллюстрация №9

Склады веб-сервиса

Поставщик может передавать через веб-сервис идентификаторы своих складов. Наша система позволяет:

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

Для просмотра складов на странице со списком подключенных веб-сервисов нажмите ссылку Поставщики в нужной строке.


Список поставщиков веб-сервиса

Откроется список внутренних поставщиков веб-сервиса, которые уже попадали через проценку в вашу систему. В стобце Название отображается название склада у поставщика, в столбце Замена — название в системе (см. подробное описание параметра Название в системе в таблице 5 ). 

Если в настройках веб-сервиса включена опция Подсклады в режиме Белый список, все новые склады в списке не будут показываться. Отображаться будут только ранее активированные склады.

Здесь вы можете: 

  • отредактировать настройки склада;
  • исключить склад из проценки. Для этого требуется нажать в его строке на ползунок активации;
  • добавить новый склад. По нажатию кнопку Создать откроется страница настройки его параметров. Заполните нужные поля известной информацией и нажмите Сохранить.

Кнопка Обновить информацию о поставщике доступна только для веб-сервиса Adeo. По нажатию на нее запустится процесс синхронизации информации о складах. По умолчанию она не активна. Чтобы она отображалась, в настройках веб-сервиса нужно включить галочку Синхронизировать информацию о поставщике.

Фото 10. Список поставщиков веб-сервиса
Склады веб-сервиса иллюстрация №1


Настройки поставщиков веб-сервиса

Чтобы перейти к настройкам поставщика, в списке складов нажмите на кнопку редактирования в нужной строке. 

Для применения изменений необходимо нажать на кнопку Сохранить внизу страницы настроек поставщика.

Фото 11. Параметры поставщика веб-сервиса
Прайсы —  Веб-сервисы иллюстрация №11

Прайсы —  Веб-сервисы иллюстрация №12

Прайсы —  Веб-сервисы иллюстрация №13

Таблица 5. Параметры поставщика веб-сервиса.
Параметр Описание

1

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

Название склада у поставщика

2

Название в выдаче

Внутреннее название (в системе). Значение автоматически генерируется как префикс поставщика + порядковый идентификатор (поле Префикс поставщика на странице настроек веб-сервис).

3

Комментарий

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

4

Отключить

Исключает позиции со склада из проценки (тоже самое, что ползунок Включить/Выключить в списке поставщиков веб-сервиса).

5

Не фильтровать

Позиции со склада всегда будут игнорироваться фильтрами, настроенными для региона и/или веб-сервиса, и попадать в результаты проценки.

6

Отметить как официального дистрибьютора

В результатах проценки выводится надпись “ОД” рядом с названием склада. Она обозначет, что данный склад является официальным дистрибьютором.

7

Бренды дистрибьютора

Если склад является ОД по определенным брендам,  укажите нужные бренды, разделяя их знаком черты |.

8

Отметить как центральный склад

В поиске выводится надпись “ЦС” рядом с названием склада.

9 Возврат без проблем

 В результатах проценки, в корзине и на странице истории заказов в клиентской части выводится зеленая иконка с подписью «Возврат без удержаний».

10 Комментарий к возврату без проблем

Данный комментарий выводится при наведении на иконку «Возврат без удержаний».

11

Без возвратов

Начиная с движка V2 системы, вы можете настроить параметры возврата отдельно по подскладам поставщика.

Приоритетность параметров возврата:

  • Параметр, установленный для конкретного подсклада веб-сервиса, затирает все, что пришло от самого веб-сервиса.
  • Параметр из прайс-листов применяется строго в том случае, если ранее не был установлен ни один из параметров возврата.

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

12

Возврат с удержанием

В результатах проценки, в корзине и на странице истории заказов в клиентской части выводится красно-зеленая иконка «Возврат позиции возможен только с удержанием».

13

Комментарий к удержанию

Данный комментарий выводится при наведении на иконку «Возврат позиции возможен только с удержанием».

14

Тип маршрута

В результатах проценки будет отображаться иконка, обозначающая тип доставки: авиа (иконка “самолет”), авто (“грузовик”), поезд, складское помещение. 

15

Комментарий к типу доставки

 

16

Доп. дней доставки

Ряд поставщиков указывает некорректный срок доставки для своих складов.
К примеру, и для склада в Рязани, и для склада во Владивостоке может стоять срок доставки в Москву 4 дня.
Система Parts-Soft дает возможность скорректировать время доставки для каждого склада вручную.

Количество дополнительных дней доставки. Это количество будет автоматически суммироваться со сроком, заявленным веб-сервисом.

17 Надежность

Процент отказов по складу (надежность), полученный от самого веб-сервиса, будет подменяться на указанный в данном поле.  

18

Ограничения брендов

Тип ограничения может быть только один. Варианты:

  • Не проверяем – ограничение брендов отключено;
  • Разрешенные – белый список брендов (указывается в поле 19);
  • Запрещенные – черный список брендов (указывается в поле 19).

19

Бренды

Перечень брендов (по одному в строку), которые проверяем в поле (18) .

Управление соответствием статусов

В системе Parts-Soft можно настроить соответствия между статусами поставщика и статусами заказов. Это поможет в ситуации, когда у поставщика есть транзитный склад. Благодаря настройке, клиент сможет узнать, что заказанная деталь пришла на такой склад.

Для настройки соответствия статусов:

ШАГ 1. В списке веб-сервисов нажмите на ссылку Статусы в нужной строке. 

ШАГ 2. На открывшейся странице вы увидите таблицу со списком статусов, которые система получала от поставщика (столбец ID статуса поставщика), а также их соответствие статусам в нашей системе (столбец Внутренний статус).

Фото 12. Соответствие статусов
Управление соответствием статусов иллюстрация №2

Статусы в списке появляются по мере поступления позиций с этими статусами от поставщика, поэтому в первое время список может быть пуст или не полон.

Если соответствия нет, то столбец Внутренний статус будет пустым. В столбце ID статуса поставщика отображается название статуса или ID статуса поставщика в виде цифры, если мы пока не знаем его расшифровки.

Если у вас вместо названий статусов отображаются только цифры, запросите их значения у поставщика. Затем передайте данную информацию нам, чтобы мы добавили расшифровку статусов.

ШАГ 3. Используйте кнопку редактирования, чтобы задать желаемые соответствия для выбранных статусов. Например, при статусе “Закуплено” у поставщика можно указать не “Размещено”, а какой-то другой внутренний статус.

ШАГ 4. Вы перейдете к форме настройки пар статусов. Укажите в списке Внутренний статус нужный статус из имеющихся в системе. 

При необходимости в поле Внутренний комментарий добавьте текст, который будет отображаться в таблице со списком статусов (в поле Комменарий).

ШАГ 5. Сохраните изменения.

Фото 13. Настройка соответствия статусов
Управление соответствием статусов иллюстрация №3

При следующей проверке статусов система будет проставлять статус по вашему правилу.

Тестирование веб-сервиса

После настройки веб-сервиса можно проверить подключение. Для этого в списке веб-сервисов в его строке нажмите на ссылку Тест. 

На открывшейся странице для тестирования проценки:

Фото 14. Тестирование веб-сервиса
Подключение веб-сервисов иллюстрация №8

  •  Введите запрос Номер+Бренд (1). При тестировании в режиме выбора брендов Бренд можно не указывать. 
  • Выберите из выпадающего списка направление тестирования (2)
    • Проверка подключения. Получение от веб-сервиса ключа запроса и найденных предложений. Подходит для веб-сервисов, которые выполняют запрос сразу (за один этап).
    • Проверка выдачи (без кроссов). Для поиска предложений по номеру и бренду будет отправлен HTTP-запрос GET /api/v1/search/get_offers_by_oem_and_make_name?api_key=Ключ&make_name=Бренд&oem=Номер. Кроссы будут исключаться из выдачи.
    • Проверка выдачи (с кроссами). Будет отправлен такой же HTTP-запрос, как и при тестировании в предыдущем режиме.  В результате его выполнения вы получите список предложений с кроссами. 
    •  Проверка выбора брендов. Будет отправлен HTTP-запрос GET /api/v1/search/get_brands_by_oem?api_key=Ключ&oem=Номер для получения списка брендов по номеру.
  • При необходимости включите опцию Расшифровать запросы\ответы (3), чтобы к результатам поисковой выдачи добавлялась детализация по отправленному HTTP-запросу (блок REQUEST) и HTTP-ответу (блок RESPONSE). Вы сможете узнать, какой запрос с какими параметрами был отправлен и какой ответ (с заголовками) был получен.
  • Нажмите кнопку Найти (4), чтобы получить ответ от веб-сервиса.
  • Просмотрите ответ от веб-сервиса (5), т.е информацию о найденных предложениях либо о проблемах с подключением

Подмена номеров

По некоторым веб-сервисам (обычно это склады производителей или поставщики по спецтехнике) проценка возможна только по артикулу, отформатированному аналогично номеру в их базе. Например, если номер XXXYYYZZZ в базу введен как XXX-YYY-ZZZ, то его искать нужно именно в таком виде. При попытке искать его как XXXYYYZZZ результатов не будет.

Простые покупатели не будет искать запчасти по форматированным номерам. Для решения описанной проблемы в системе Parts-Soft есть функционал, который позволяет подменять такие номера.

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

Далее в списке веб-сервисов нажмите на ссылку Подмена номеров в нужной строке. Вы перейдете на страницу со списком подмен.

До настройки подмен список будет пустым.

Фото 15. Список подмен номеров
Подмена номеров иллюстрация №6

  • Отфильтровать записи в списке (1) по полям: Марка, Номер, Название пакета и Группа товара.
  •  Добавить единичную подмену (2).
  • Загрузить подмены пакетно из файла Excel (3).
  • Удалить отфильтрованные подмены (4).
    Если список не отфильтровать, то при нажатии кнопки Удалить выбранные будут удалены все записи из него.

Добавление единичной подмены

При нажатии на кнопку Добавить в списке подмен откроется страница настройки подмены. Заполните обязательные поля:

  • Бренд – бренд детали;
  • Номер детали (очищенный) – номер без специальных символов (например, без тире, дефиса "-", слеша “/” и других);
  • Номер детали с форматированием – номер, который подменяем. Указываем так, как он записан в базе поставщика. 

Также можно указать название детали и группу товара. После заполнения полей формы необходимо нажать кнопку Сохранить.

Фото 16. Добавление одной подмены
Подмена номеров иллюстрация №3

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


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

ШАГ 1. Подготовьте файл в формате CSV (разделитель “;”) со списком всех необходимых номеров. Поля аналогичны тем, что указываются при добавлении одной подмены (см. пример на фото 16):

  • Бренд – обязательное поле, бренд детали;
  • Номер детали (очищенный) – обязательное поле, номер без специальных символов (например, без тире, дефиса "-", слеша “/” и других);
  • Номер детали с форматированием – обязательное поле, подменяемый номер;
  • Название детали;
  • Группа товара.

Фото 17. Файл со списком номеров подмены
Подмена номеров иллюстрация №4

ШАГ 2. При нажатии на кнопку Загрузить пакетно в списке подмен откроется окно загрузки файла. 

Укажите путь к подготовленному файлу. Введите название пакета загрузки и нажмите кнопку Загрузить.

ШАГ 3. Задача добавится в очередь. Пакет загрузится в течении нескольких минут. После загрузки все записи из файла будут добавлены в список подмен.

Фото 18. Окно пакетной загрузки подменных номеров
Подмена номеров иллюстрация №5

По данной функции возникают могут возникнуть следующие вопросы: