В панели администратора в меню Прайсы → Веб-сервисы отображается список подключенных веб-сервисов.
Список веб-сервисов
1. Скопировать пример письма для открытия доступа к веб-сервису. Письмо нужно отправить вашему менеджеру после того, как зарегистрируетесь на сайте поставщика
2. Подключить новый веб-сервис
3. Создать прайс-лист, привязанный к веб-сервису
4. Перейти к настройкам веб-сервиса.
5. Настроить склады веб-сервиса
6. Настроить соответствие между статусами поставщика и статусами заказов в системе
7. Протестировать подключение веб-сервиса
8. Добавить подмены номеров, если поставщик работает только с форматированными номерами.
9. Перейти в карточку привязанного прайс-листа, чтобы изменить его настройки. Например, на странице редактирования опций прайс-листа в блоке Связать с веб-сервисом можно проверить, что выбран нужный веб-сервис и сменить его в случае ошибки.
10. Удалить веб-сервис
Рассмотрим на примере подключение API parts-soft.ru
ШАГ 1. По клику на кнопку Подключить в списке веб-сервисов появится окно выбора поставщика.
ШАГ 2. Выберите нужного в списке Доступные веб-сервисы и нажмите на кнопку Запросить подключение.
Запросить подключение
ШАГ 3. На открывшейся странице в блоке Данные для подключения укажите нужные параметры: ключ API доступа, логин и пароль, полученные у вашего поставщика.
Набор параметров может отличаться в зависимости от подключаемого веб-сервиса.
Нажмите на кнопку Подключить.
Данные для подключения
При подключении веб-сервиса обязательно проверяйте, что у Вас открыт доступ к сервису со стороны поставщика. Доступ к личному кабинету на сайте поставщика не является доступом к веб-сервису. Для некоторых сервисов (например, Emex и Berg) необходимо запрашивать дополнительный доступ. Если доступ не будет получен, то у Вас не будет работать проценка.
Для редактирования настроек нажмите на ссылку Настройки в списке веб-сервисов. Описание параметров представлено в таблицах ниже.
Базовые настройки веб-сервиса
Название настройки |
Описание |
---|---|
Название веб-сервиса |
Устанавливается при подключении автоматически. |
Интегрировать корзину |
Подключает автоматическое размещение заказа. |
Сохранять кроссы |
Активирует автоматическое пополнение базы кроссов (меню Служебные → Продукция → Прямые кроссы). Обратите внимание, что это замедляет поиск. |
Проверка кросс номеров |
Включает отображение в результатах поисковой выдачи только тех кроссы, которые удовлетворяют условию проверки, указанному в поле Источники проверки кросс номеров. |
Источники проверки кросс номеров |
Выбирается один из вариантов проверки кросс-номеров:
|
Отключить авто отслеживание статусов |
Принудительно отключает синхронизацию статусов заказов в системе со статусами поставщика, поступаемыми с веб-сервиса. Это поможет, когда включено автоматическое размещение заказов (см. опцию Интегрировать корзину), но при настроенном соответствии статусов вместо системного устанавливается статус поставщика. |
Размещать заказ по одной позиции |
Разбивает один заказ поставщику из N позиций на N заказов. При этом каждый будет отправлен по отдельности. Например, при 20 позициях получится 20 заказов поставщику. Будет полезна при работе с некоторыми поставщиками, которые переводят в отказ весь заказ, если не могут поставить одну из позиций. |
Блокировать кроссы |
Блокирует любые кроссы. От веб-сервиса будет возвращаться только запрошенный номер. |
Искать по форматированному номеру |
Подключает функционал подмены номеров. |
Подсклады в режиме "Белый список" |
Отключает показ всех новых подскладов. Отображаться будут только те, которые были активированы ранее. |
Идентификация форматированных номеров только по номеру |
Полученный номер от поставщика будет сравниваться с имеющимися в загруженных подменах только по номеру. |
Переопределять номера и бренды |
Позволяет заменить номер + бренд на имеющиеся в загруженных подменах |
Игнорировать параметр возврата |
Позволяет не учитывать параметры возврата, которые приходят от самого веб-сервиса. Приоритетность параметров возврата:
|
Игнорировать опцию ЦС |
Будет игнорироваться включенная в опциях прайс-листа галочка Отметить как центральный склад (из блока Настройка поисковой выдачи). При проценке в админпанели и через сайт для подскладов веб-сервиса не будет отображаться надпись "ЦС" (кроме тех, у которых в настройках включена галочка Отметить как центральный склад). |
Игнорировать опцию Дистрибьютор |
Будет игнорироваться включенная в опциях прайс-листа галочка Отметить как официального дистрибьютора (из блока Настройка поисковой выдачи) . При проценке в админпанели и через сайт для всех подскладов веб-сервиса не будет отображаться надпись "ОД" (кроме тех, у которых в настройках включена галочка Отметить как официального дистрибьютора). |
Игнорировать срок от поставщика по АПИ |
Позволяет не учитывать сроки доставки от поставщиков, которые передаются через веб-сервисы. Будет полезна в тех случаях, когда они некорректны. Например, сформированы без учета выходных или праздничных дней. |
Не подключать при выборе бренда |
Некоторые веб-сервисы загрязняют этап выбора производителя при поиске, поскольку передают несуществующие по искомому номеру бренды (например, так делает Автопитер). Данные о каких-то брендах могут выпасть из поиска, если они есть только у веб-сервиса, для которого выполнена настройка. |
Параметры подключения
№ |
Название настройки |
Описание |
---|---|---|
1 |
Логин |
Логин на сайте поставщика или ключ api доступа. |
2 |
Логин 2 |
Здесь вы можете указать номер договора или отдельный логин ( не от личного кабинета на сайте поставщика), если это требуется для подключения веб-сервиса. |
3 |
Пароль |
Пароль. Он может быть отдельный или для входа в личный кабинет на сайте поставщика. |
4 |
Префикс поставщика |
Введите буквенное обозначение для складов веб-сервиса, которое будет добавлено в их названия помимо числового кода. Для префикса можно использовать только латинские буквы. Например, если указать здесь ATER, то склад 4567 получит название ATER4567. Префикс должен быть задан при первоначальной настройке веб-сервиса — ДО первой проценки. Если префикс задать уже после проценки, то он не будет добавлен.
|
5 |
Таймаут соединения |
Максимальное время, в течении которого система ожидает ответа от веб-сервиса, далее соединение сбрасывается. |
6 |
URL |
Поле обязательное для заполнения. Адрес сайта поставщика. Указывается без слеша в конце. Например, https://ваш-поставщик.ru
|
7 | URL Сервиса заказа | |
8 | URL Сервиса движения |
Дополнительные настройки
№ |
Название настройки |
Описание |
---|---|---|
1 |
Адрес доставки |
Поля оформления заказа. Количество может отличаться для разных веб-сервисов. Кроме поля Адрес доставки могут быть:
Обязательно указывать при настройке веб сервисов Армтек и Берг.
|
2 |
Комментарий |
|
3 |
Приоритетные бренды |
Используйте, когда веб-сервис не применяет настроенное объединение брендов. Более подробно в инструкции. |
4 |
Копировать данные из веб-сервиса |
Используется при настройке функционала создания копий веб-сервисов. |
Настройки фильтрации становятся доступными по нажатию на кнопку Включить фильтр. Для отключения их нажмите кнопку Выключить фильтр. Фильтрация выдачи действует на уровне получения данных с веб-сервиса, без предварительной обработки.
Настройки фильтров
№ |
Название настройки |
Описание |
---|---|---|
1 |
Критерий |
Доступные значения:
|
2 |
Количество на критерий |
Укажите количество позиций в группе Номер +Бренд, которые будут сравниваться между собой при фильтрации. |
3 |
Мин.статистика |
При фильтрации из выдачи будут исключаться позиции с тех подскладов, по которым надежность меньше указанной в данном поле. |
4 | Срок доставки не более |
При фильтрации из выдачи будут исключаться позиции, у которых максимальный срок доставки больше указанного в данном поле. |
5 |
Убрать позиции с неизвестным количеством |
Если опция включена, из отфильтрованной выдачи будут исключены все позиции, по которым поставщик не передал количество. |
6 |
Убрать не возвратные позиции |
Если опция включена, из отфильтрованной выдачи будут исключаться позиции с тех складов, у которых в настройках включена галочка Без возврата. |
7 |
Отклонение цены |
Доступны значения:
|
8 | % Процент отклонения |
При использовании вышеуказанных настроек в группе одинаковых позиций (одинаковые oem и бренд) выделяется позиция с минимальной/максимальной/медианной ценой, и относительно нее рассматривается отклонение на заданный процент. |
10 | Центральный склад (ЦС) |
Данная настройка работает в режиме "или-или" с фильтром Официальный дистрибьютор |
11 | Официальный дистрибьютор (ОД) |
Данная настройка работает в режиме "или-или" с фильтром Центральный склад |
Чтобы данные с веб-сервиса появились в поиске, его нужно привязать к прайс-листу.
ШАГ 1. В списке подключенных веб-сервисов в столбце Связанный прайс-лист нажмите на ссылку Не активен... Такая ссылка отображается для тех веб-сервисов, у которых нет привязанных прайс-листов.
ШАГ 2. Создайте прайс-лист для онлайн-проценки, указав:
После этого не забудьте активировать прайс-лист, включив галочку Активен на странице со списком его опций.
Новый прайс-лист
ШАГ 3. Список веб-сервисов обновится. У веб-сервиса, для которого была выполнена настройка, в столбце Связанный прайс-лист будет указано название привязанного прайс-листа.
Привязанный прайс-лист
Привязанный к веб-сервису прайс-лист настраивается аналогично загруженному из файла. Нужные параметры можно задать: в карточке прайс-листа и на странице с его опциями.
Для быстрого перехода к карточке нажмите на названии прайс-листа в столбце Связанный прайс-лист (см. на фото выше).
Поставщик может передавать через веб-сервис идентификаторы своих складов. Наша система позволяет:
Для просмотра складов на странице со списком подключенных веб-сервисов нажмите ссылку Поставщики в нужной строке.
Откроется список внутренних поставщиков веб-сервиса, которые уже попадали через проценку в вашу систему. В стобце Название отображается название склада у поставщика, в столбце Замена — название в системе (см. подробное описание параметра Название в системе в таблице "Параметры поставщика веб-сервиса" ).
Если в настройках веб-сервиса включена опция Подсклады в режиме Белый список, все новые склады в списке не будут показываться. Отображаться будут только ранее активированные склады.
Список поставщиков веб-сервиса
1. Фильтрация и поиск записей в списке
2. Редактировать настройки склада
3.Включить / отключить склад. Если склад отключен, то позиции с него не будут попадать в выдачу при проценке.
4. Добавить новый склад. По нажатию кнопку Создать откроется страница настройки его параметров. Заполните нужные поля известной информацией и нажмите Сохранить.
5. Включить отфильтрованные склады. По умолчанию, когда фильтры не применены, активируются все склады.
6. Отключить отфильтрованные склады. По умолчанию, когда фильтры не применены, отключает все склады.
Для веб-сервиса Adeo, если в его настройках включена опция Синхронизировать информацию о поставщике, будет присутствовать кнопка Обновить информацию о поставщике. По умолчанию данная кнопка не активна.
Чтобы перейти к настройкам поставщика, в списке складов нажмите на кнопку редактирования в нужной строке.
Для применения изменений необходимо нажать на кнопку Сохранить внизу страницы настроек поставщика.
Параметры поставщика веб-сервиса
№ | Параметр | Описание |
---|---|---|
1 |
Название у поставщика |
Название склада у поставщика |
2 |
Название в выдаче |
Внутреннее название (в системе). Значение автоматически генерируется как префикс поставщика + порядковый идентификатор (поле Префикс поставщика на странице настроек веб-сервис). |
3 |
Комментарий |
Вы можете указывать комментарий для каждого склада отдельно, и он будет выводится в поиске под названием склада. |
4 |
Отключить |
Исключает позиции со склада из проценки (тоже самое, что ползунок Включить/Выключить в списке поставщиков веб-сервиса). |
5 |
Не фильтровать |
Позиции со склада всегда будут игнорироваться фильтрами, настроенными для региона и/или веб-сервиса, и попадать в результаты проценки. |
6 |
Отметить как официального дистрибьютора |
В результатах проценки выводится надпись “ОД” рядом с названием склада. Она обозначет, что данный склад является официальным дистрибьютором. |
7 |
Бренды дистрибьютора |
Если склад является ОД по определенным брендам, укажите нужные бренды, разделяя их знаком черты |. |
8 |
Отметить как центральный склад |
В поиске выводится надпись “ЦС” рядом с названием склада. |
9 | Возврат без проблем |
В результатах проценки, в корзине и на странице истории заказов в клиентской части выводится зеленая иконка с подписью «Возврат без удержаний». |
10 | Комментарий к возврату без проблем |
Данный комментарий выводится при наведении на иконку «Возврат без удержаний». |
11 |
Без возвратов |
Начиная с движка V2 системы, вы можете настроить параметры возврата отдельно по подскладам поставщика. Приоритетность параметров возврата:
В результатах проценки, в корзине и на странице истории заказов в клиентской части будет выводиться красная иконка с подписью "Возврат позиции невозможен". |
12 |
Возврат с удержанием |
В результатах проценки, в корзине и на странице истории заказов в клиентской части выводится красно-зеленая иконка «Возврат позиции возможен только с удержанием». |
13 |
Комментарий к удержанию |
Данный комментарий выводится при наведении на иконку «Возврат позиции возможен только с удержанием». |
14 |
Тип маршрута |
В результатах проценки будет отображаться иконка, обозначающая тип доставки: авиа (иконка “самолет”), авто (“грузовик”), поезд, складское помещение. |
15 |
Комментарий к типу доставки |
|
16 |
Доп. дней доставки |
Ряд поставщиков указывает некорректный срок доставки для своих складов. Количество дополнительных дней доставки. Это количество будет автоматически суммироваться со сроком, заявленным веб-сервисом. |
17 | Надежность |
Процент отказов по складу (надежность), полученный от самого веб-сервиса, будет подменяться на указанный в данном поле. |
18 |
Ограничения брендов |
Тип ограничения может быть только один. Варианты:
|
19 |
Бренды |
Перечень брендов (по одному в строку), которые проверяем в поле (18) . |
В системе Parts-Soft можно настроить соответствия между статусами поставщика и статусами заказов. Это поможет в ситуации, когда у поставщика есть транзитный склад. Благодаря настройке, клиент сможет узнать, что заказанная деталь пришла на такой склад.
Для настройки соответствия статусов:
ШАГ 1. В списке веб-сервисов нажмите на ссылку Статусы в нужной строке.
ШАГ 2. На открывшейся странице вы увидите таблицу со списком статусов, которые система получала от поставщика (столбец ID статуса поставщика), а также их соответствие статусам в нашей системе (столбец Внутренний статус).
Соответствие статусов
Если соответствия нет, то столбец Внутренний статус будет пустым. В столбце ID статуса поставщика отображается название статуса или ID статуса поставщика в виде цифры, если мы пока не знаем его расшифровки.
Если у вас вместо названий статусов отображаются только цифры, запросите их значения у поставщика. Затем передайте данную информацию нам, чтобы мы добавили расшифровку статусов.
ШАГ 3. Используйте кнопку редактирования, чтобы задать желаемые соответствия для выбранных статусов. Например, при статусе “Закуплено” у поставщика можно указать не “Размещено”, а какой-то другой внутренний статус.
ШАГ 4. Вы перейдете к форме настройки пар статусов. Укажите в списке Внутренний статус нужный статус из имеющихся в системе.
При необходимости в поле Внутренний комментарий добавьте текст, который будет отображаться в таблице со списком статусов (в поле Комменарий).
ШАГ 5. Сохраните изменения.
Настройка соответствия статусов
При следующей проверке статусов система будет проставлять статус по вашему правилу.
После настройки веб-сервиса можно проверить подключение. Для этого в списке веб-сервисов в его строке нажмите на ссылку Тест.
На открывшейся странице для тестирования проценки:
Тестирование веб-сервиса
1. Введите запрос Номер+Бренд. При тестировании в режиме выбора брендов Бренд можно не указывать.
2. Выберите из выпадающего списка направление тестирования:
GET /api/v1/search/get_offers_by_oem_and_make_name?api_key=Ключ&make_name=Бренд&oem=Номер
. Кроссы будут исключаться из выдачи.GET /api/v1/search/get_brands_by_oem?api_key=Ключ&oem=Номер
для получения списка брендов по номеру.3. При необходимости включите опцию Расшифровать запросы\ответы (3), чтобы к результатам поисковой выдачи добавлялась детализация по отправленному HTTP-запросу (блок REQUEST) и HTTP-ответу (блок RESPONSE). Вы сможете узнать, какой запрос с какими параметрами был отправлен и какой ответ (с заголовками) был получен.
4. Нажмите кнопку Найти, чтобы получить ответ от веб-сервиса.
5. Просмотрите ответ от веб-сервиса, т.е информацию о найденных предложениях либо о проблемах с подключением
По некоторым веб-сервисам (обычно это склады производителей или поставщики по спецтехнике) проценка возможна только по артикулу, отформатированному аналогично номеру в их базе. Например, если номер XXXYYYZZZ в базу введен как XXX-YYY-ZZZ, то его искать нужно именно в таком виде. При попытке искать его как XXXYYYZZZ результатов не будет.
Простые покупатели не будет искать запчасти по форматированным номерам. Для решения описанной проблемы в системе Parts-Soft есть функционал, который позволяет подменять такие номера.
Чтобы активировать подмену номеров для клиентов, в настройках веб-сервиса включите галочку Искать по форматированному номеру.
Далее в списке веб-сервисов нажмите на ссылку Подмена номеров в нужной строке. Вы перейдете на страницу со списком подмен.
До настройки подмен список будет пустым.
Список подмен номеров
1. Отфильтровать записи в списке по полям: Марка, Номер, Название пакета и Группа товара.
2. Добавить единичную подмену.
3. Загрузить подмены пакетно из файла Excel.
4. Удалить отфильтрованные подмены.
При нажатии на кнопку Добавить в списке подмен откроется страница настройки подмены. Заполните обязательные поля:
Также можно указать название детали и группу товара. После заполнения полей формы необходимо нажать кнопку Сохранить.
Добавление одной подмены
Запись появится в списке подмен. Ее можно отредактировать либо удалить.
ШАГ 1. Подготовьте файл в формате CSV (разделитель “;”) со списком всех необходимых номеров. Поля аналогичны тем, что указываются при добавлении одной подмены (см. пример на фото ниже):
Файл со списком номеров подмены
ШАГ 2. При нажатии на кнопку Загрузить пакетно в списке подмен откроется окно загрузки файла.
Укажите путь к подготовленному файлу. Введите название пакета загрузки и нажмите кнопку Загрузить.
ШАГ 3. Задача добавится в очередь. Пакет загрузится в течении нескольких минут. После загрузки все записи из файла будут добавлены в список подмен.
Окно пакетной загрузки подменных номеров