Подождите, идёт загрузка...
Поиск по:
Регистрация Войти
Документация по веб-сервисам API сайта v01.ru

Документация по веб-сервисам 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"}]}]