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

Документация по веб-сервисам 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/
Статус: используется
Детальное описание: читать
Изменения: нет



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