Подождите, идёт загрузка...
Поиск по:

Документация по веб-сервисам API сайта v01.ru

Консультации по API

Консультация доступна только для авторизованных клиентов МПартс. Пожалуйста, авторизуйтесь для получения консультации по Вашему вопросу.

Общие положения

Уважаемые партнеры!

Для автоматизации работы Ваших 1С / сайтов / других систем с нашим сервисом, мы реализовали API.

Адрес для обращения к API: http://v01.ru/api/devinsight/

Наше API схоже по функциям и виду запросов и ответов с API распространенной платформы abcp.ru , 
но при этом мы НЕ связаны технически с этой платформой. Это сделано для того, чтобы готовые модули, 
которые умеют работать с abcp, могли работать и с нашим сервисом без изменений. 
Достаточно часто нам задают вопрос, являемся ли мы ABCP. Нет, мы являемся отдельной компанией и реализовали свое API полностью аналогично ABCP.

Это значит, что с нашим апи можно работать, используя документацию ABCP.
В идеале Вам нужно обращаться к нам с помощью Вашего модуля для работы с ABCP

Обращаем Ваше внимание, что иногда модули для abcp имеют ссылку вида: http://сайт.public.api.abcp.ru . 
К сожалению, если Вы введете v01 и получите http://v01.public.api.abcp.ru , то это не будет работать.
Правильная ссылка на наше апи: http://v01.ru/api/devinsight/ 

API реализовано в соответствии со спецификацией API сервиса abcp.ru с определенными изменениями, связанными со спецификой работы системы онлайн-заказа v01.ru
Полная документация по API abcp.ru доступна по адресу: http://docs.abcp.ru/wiki/API:Docs
Ниже будут даны комментарии по каждому методу API abcp: используется ли он, если используется, то с какими изменениями.

Пример запроса: http://v01.ru/api/devinsight/search/brands/?userlogin=username&userpsw=md5pass&number=01089
Где username - логин на сайте v01, userpw - md5-хеш от пароля указанного аккаунта.
Доступ к сервису появляется после активации Вашей учетной записи. Для начала работы, авторизуйтесь в личном кабинете. Как только авторизация будет успешной, Вы можете начать пользоваться API

Основные возможности данного API:

- Поиск и проценка артикулов
- Поиск и проценка кроссов
- Автоматизированное создание заказа
- Работа с историей заказа и статусами

Обращаем Ваше вннимание!
Сайт v01.ru не является сайтом, использующим платформу ABCP. 
В случае, если Вы используете модуль для интеграции с ABCP, указывайте в качестве адреса для запросов http://v01.ru/api/devinsight/

Описания методов

Поиск брендов по номеру
Операция: search/brands
Статус: используется
Изменения: нет, соответствует abcp
Детальное описание: читать

Поиск детали по номеру и бренду Операция: search/articles Статус: используется Изменения: availability - поле передает точное значение наличия. -1, -2, -3 итд не передаются Детальное описание: читать
Пакетный запрос без учета аналогов Операция: search/batch Статус: используется Изменения: нет, соответствует abcp Детальное описание: читать По данному методу существует ограничение: 50 артикулов за один запрос
История поиска Операция: search/history Статус: не используется
Подсказки по поиску Операция: search/tips Статус: не используется
Поиск сопутствующих товаров Операция: advices/ Статус: не используется
механизм "с этим товаром покупают" по нескольким товарам. Операция: advices/batch Статус: не используется
Получение списка корзин Операция: basket/multibasket Статус: не используется. В рамках нашей системы существует только один товар
Добавление товаров в корзину Операция: basket/add Статус: используется Детальное описание: читать Изменения: - Параметр basketId не используется. То есть его можно передать, но он не будет учтен. Желательно передать пустым
Очистка корзины Операция: basket/clear Статус: используется Детальное описание: читать Изменения: - Параметр basketId не используется. То есть его можно передать, но он не будет учтен. Желательно передать пустым
Получение списка товаров в корзине Операция: basket/content Статус: используется Детальное описание: читать Изменения: - Параметр basketId не используется. То есть его можно передать, но он не будет учтен. Желательно передать пустым
Получение списка способов оплаты Операция: basket/paymentMethods Статус: используется Детальное описание: читать Изменения: нет
Получение списка способов доставки Операция: basket/shipmentMethods Статус: используется Детальное описание: читать Изменения: нет
Получение списка офисов самовывоза Операция: basket/shipmentOffices Статус: используется Детальное описание: читать Изменения: нет
Получение списка адресов доставки Операция: basket/shipmentAddresses Статус: используется Детальное описание: читать Изменения: нет
Получение списка дат отгрузки Операция: basket/shipmentDates Статус: используется Детальное описание: читать Изменения: нет
Отправка корзины в заказ Операция: basket/order Статус: используется Детальное описание: читать Изменения: нет
Моментальный заказ Операция: orders/instant Статус: используется Детальное описание: читать Изменения: нет
Получение позиций заказов со статусами Операция: orders/list Статус: используется Детальное описание: читать Изменения: нет
Получение списка заказов Операция: orders/ Статус: используется Детальное описание: читать Изменения: нет
Получение списка измененных товаров в корзине Операция: basket/actualizeList Статус: используется Метод: GET Детальное описание: Параметры запроса
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
Поля ответа Метод возвращает набор узлов вида:
Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки.
itemKey Код позиции. Необходим для добавления товара в корзину.
Внимание! Не является уникальным идентификатором! Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
description Описание детали.
price Цена за штуку
quantity Заказываемое количество
comment Комментарий к позиции.
status Статус позиции в корзине. Принимает значение 0 - при ошибке или 1, если все успешно.
errorMessage Текст сообщения об ошибке

Подвертдить измененные товары в корзине Операция: basket/actualizeAdd Статус: используется Метод: POST Детальное описание: Подветрдить измененные товары, которые будут обновлены и снова добавлены в корзину Параметры запроса
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
positions Необязательный параметр - набор измененных товаров, которые нужно подтвердить в формате code.
Если не указывать, то будут подтверждены все измененные товары
Параметры POST
userlogin=username&userpsw=md5pass&positions[0]=82421861&positions[1]=74749441&positions[2]=81313548
Поля ответа Метод возвращает набор узлов вида:
Поле Описание
status Статус подтверждения
errorMessage Сообщение об ошибке при статусе = 0

Удалить измененные товары в корзине Операция: basket/actualizeDelete Статус: используется Метод: POST Детальное описание: Удалить измененные товары Параметры запроса
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
positions Необязательный параметр - набор измененных товаров, которые нужно удалить в формате code.
Если не указывать, то будут удалены все измененные товары
Параметры POST
userlogin=username&userpsw=md5pass&positions[0]=82421861&positions[1]=74749441&positions[2]=81313548
Поля ответа Метод возвращает набор узлов вида:
Поле Описание
status Статус удаления
errorMessage Сообщение об ошибке при статусе = 0

Пример использования API

1. Поиск бренда детали

Осуществляем поиск брендов по артикулу при помощи метода search/brands. Если бренд известен заранее - этот шаг можно пропустить.

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

http://v01.ru/api/devinsight/search/brands/?userlogin=username&userpsw=md5password&number=531027330&useOnlineStocks=1

Ответ:

[{"brand":"INA","number":null,"numberFix":"","description":"","availability":true},{"brand":"OPEL","number":null,"numberFix":"","description":"","availability":false},{"brand":"INTERBRAKES","number":"531027330","numberFix":"531027330","description":"","availability":false},{"brand":"LUK","number":"531027330","numberFix":"531027330","description":"","availability":false},{"brand":"FAG","number":"531027330","numberFix":"531027330","description":"","availability":false},{"brand":"SCHAEFFLER","number":"531027330","numberFix":"531027330","description":"","availability":false}]

2. Поиск детали по артикулу и бренду

При помощи метода search/articles находим доступные предложения у поставщиков.

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

http://v01.ru/api/devinsight/search/articles/?userlogin=username&userpsw=md5password&number=531027330&brand=INA&useOnlineStocks=1

Ответ:

[{"brand":"INA","number":"531027330","numberFix":"531027330","description":"","availability":"4.00","packing":"1.00","deliveryPeriod":70,"deliveryPeriodMax":70,"deadlineReplace":"","distributorCode":"ШАТЕ-М ПЛЮС (ООО) (12943 Н)","supplierCode":"12943","supplierColor":"","supplierDescription":"12943 Н","itemKey":"531027330","price":1634.89,"weight":"0.00","volume":"","deliveryProbability":"","lastUpdateTime":"2017-09-24 13:35:10","additionalPrice":"","noReturn":false,"distributorId":"12943","grp":"","code":"12308462","nonliquid":""},{"brand":"INA","number":"531027330","numberFix":"531027330","description":"","availability":"1.00","packing":"1.00","deliveryPeriod":24,"deliveryPeriodMax":24,"deadlineReplace":"","distributorCode":"АВТО-СПУТНИК РЕГИОН (ООО) ОП (Автоспутник)","supplierCode":"12950","supplierColor":"","supplierDescription":"Автоспутник","itemKey":"531027330","price":1253.16,"weight":"0.00","volume":"","deliveryProbability":"","lastUpdateTime":"2017-11-24 11:34:04","additionalPrice":"","noReturn":true,"distributorId":"12950","grp":"","code":"12549733","nonliquid":""}]
* При помощи метода search/batch можно проверить наличие сразу нескольких деталей, при условии, что вы знаете уже знаете их артикул и бренд.

3. Добавление в корзину

Добавить в корзину товар можно при помощи метода basket/add. Есть два способа указать информацию о добавляемой детали:

  • по связке бренд + артикул + код поставщика (brand - number - supplierCode)
  • по коду детали на сайте (code)

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

   userlogin=username&userpsw=md5pass&positions[0][number]=P1ZA052M&positions[0][brand]=Parts-Mall&positions[0][supplierCode]=12953&positions[0][quantity]=1&positions[1][number]=1457433160&positions[1][brand]=BOSCH&positions[1][supplierCode]=12962&positions[1][quantity]=4&positions[1][comment]=срочно!!! 
или
userlogin=username&userpsw=md5pass&positions[0][code]=11290543&positions[0][quantity]=1

Ответ:

{"positions":[{"brand":"DODA","number":"1040120004","numberFix":"1040120004","code":"11290543","supplierCode":"12918","description":"","quantity":2,"comment":null,"status":1,"errorMessage":""},{"brand":"Parts-Mall","number":"P1ZA052M","numberFix":"p1za052m","code":"12687269","supplierCode":"12953","description":"","quantity":"2","comment":null,"status":1,"errorMessage":""},{"brand":"BOSCH","number":"1457433160","numberFix":"1457433160","code":"12932461","supplierCode":"12962","description":"","quantity":"2","comment":null,"status":1,"errorMessage":""}],"status":1}

4. Оформление заказа

После добавления товаров в корзину можно оформить заказ. Туда попадут все товары, которые есть у вас в корзине. Для заполнения полей способ оплаты (paymentMethod), способ доставки (shipmentMethod), адрес доставки (shipmentAddress), адрес самовывоза (shipmentOffice) нужно предварительно воспользоваться соотвествующими методами: basket/paymentMethod, basket/shipmentMethod, basket/shipmentAddress, basket/shipmentOffice. Если вы не являетесь законтрактованным пользователем и у вас нет адресов доставки - параметр shipmentAddress необязателен.

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

userlogin=username&userpsw=md5pass&paymentMethod=6&shipmentMethod=1&shipmentAddress=0

Ответ:

{"status":true,"errorMessage":"","orders":[{"number":2147,"status":"Готово к выгрузке","statusId":"E","statusCode":"E","positionsQuantity":2,"sum":617.14,"date":"2018-01-15 16:26:13","comment":"","positions":[{"brand":"PMC","number":"p1za052m","numberFix":"P1ZA052M","code":"12687269","supplierCode":"12953","itemKey":"p1za052m","description":"","price":12.39,"quantity":2,"comment":null,"status":"Готово к выгрузке","statusId":"E","statusCode":"E"},{"brand":"Bosch","number":"1457433160","numberFix":"1457433160","code":"12932461","supplierCode":"12962","itemKey":"1457433160","description":"","price":296.18,"quantity":2,"comment":null,"status":"Готово к выгрузке","statusId":"E","statusCode":"E"}]}]}
* Если воспользоваться методом orders/instant, то можно объединить шаг добавления товара в корзину и создания заказа. Для этого передайте в метож информацию о деталях, которые хотите добавить, и на них будет автоматически создан заказ. При этом товары которые уже есть в корзине в заказ не попадут.

5. Статус заказа

Информацию о заказе и его статусе можно получить при помощи метода orders/list, куда необходимо передать массив с номерами заказов. Номера закзаов можно предварительно узнать из метода orders/

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

http://v01.ru/api/devinsight/orders/list/?userlogin=username&userpsw=md5pass&orders[0]=2113&orders[1]=2114

Ответ:

[{"number":"2113","status":"Оплачен, формируется к отправке","statusId":"P","statusCode":"P","positionsQuantity":1,"sum":561.68,"date":"2017-12-29 14:05:14","comment":"","positions":[{"brand":"KROSS","number":"km5201622","numberFix":"KM5201622","code":"11318788","supplierCode":"12898","itemKey":"km5201622","description":"","price":561.68,"quantity":1,"comment":null,"status":"Отменен","statusId":"C","statusCode":"C"}]},{"number":"2114","status":"Оплачен, формируется к отправке","statusId":"P","statusCode":"P","positionsQuantity":1,"sum":561.68,"date":"2017-12-29 14:10:44","comment":"","positions":[{"brand":"KROSS","number":"km5201622","numberFix":"KM5201622","code":"11318788","supplierCode":"12898","itemKey":"km5201622","description":"","price":561.68,"quantity":1,"comment":null,"status":"Отменен","statusId":"C","statusCode":"C"}]}]