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

Примеры использования 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":""}]

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"}]}]}

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"}]}]