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

Методы для работы с проценкой

По умолчанию подразумевается, что в каждом запросе передаются поля userlogin и userpsw

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

Запрос: https://v01.ru/api/devinsight/search/brands/

Параметры запроса

    

        

        

            
Параметр
            
Описание
        
        

            
number
            
Артикул товара
        
        
    
    Поля ответа

    Метод возвращает набор узлов вида:
    

        

        

            
Поле
            
Описание
        
        

            
brand
            
Имя производителя.
        
        

            
number
            
Номер детали (код производителя).
        
        

            
numberFix
            
"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
        
        

            
description
            
Описание детали.
        
        

            
availability
            
Доступность детали
        
        
    

    

Поиск деталей по номеру и бренду

Запрос: https://v01.ru/api/devinsight/search/articles/

Параметры запроса

    

        

        

            
Параметр
            
Описание
        
        

            
number
            
Артикул товара
        
        

            
brand
            
Бренд товара
        
        

            
withOutAnalogs
            
Если значение = 1, то не возвращать проценку по кроссам, только по исходному артикулу
        
        
    
    Поля ответа

    Метод возвращает набор узлов вида:
    

        

        

            
Поле
            
Описание
        
        

            
brand
            
Имя производителя.
        
        

            
number
            
Номер детали (код производителя).
        
        

            
original_article
            
Номер детали (код производителя).
        
        

            
numberFix
            
"Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
        
        

            
description
            
Описание детали
        
        

            
availability
            
Количество товара наличии у данного поставщика
        
        

            
packing
            
Количество единиц в упаковке
        
        

            
deliveryPeriod
            
Время доставки до адреса выбранного контрагента в часах
        
        

            
deliveryPeriodMax
            
Время доставки до адреса выбранного контрагента в часах
        
        

            
deadlineReplace
            
Пустое поле (поле добавлено для совместимости с протоколом ABCP)
        
        

            
distributorCode
            
Мнемонический код поставщика (string)
        
        

            
supplierCode
            
Цифровой код поставщика (int)
        
        

            
supplierColor
            
Пустое поле (поле добавлено для совместимости с протоколом ABCP)
        
        

            
supplierDescription
            
Описание поставщика (string)
        
        

            
supplierVerified
            
Поставщик гарантирует проверку товара на контрафакт (Y - да , N - нет информации)
        

        

            
itemKey
            
Артикул позиции
        
        

            
price
            
Цена за штуку
        
        

            
weight
            
Вес позиции в граммах
        
        

            
volume
            
Объем позиции
        
        

            
deliveryProbability
            
Вероятность поставки. Дробное число от 0 до 100
        
        

            
lastUpdateTime
            
Время последнего обновления прайса поставщика (datetime)
        
        

            
additionalPrice
            
Пустое поле (поле добавлено для совместимости с протоколом ABCP)
        
        

            
noReturn
            
Флаг запрета возврата у данного поставщика. 1 = возврата НЕТ
        
        

            
distributorId
            
ID поставщика
        
        

            
grp
            
Пустое поле (поле добавлено для совместимости с протоколом ABCP)
        
        

            
code
            
Уникальный код детали (int)
        
        

            
nonliquid
            
Пустое поле (поле добавлено для совместимости с протоколом ABCP)
        
        

            
supplier_order_sent
            
Время отправки заказа поставщику (datetime)
        
        
    

availability - поле передает точное значение наличия. -1, -2, -3 итд не передаются

Пример объекта из ответа

    (
        [brand] => KYB
        [number] => 334420
        [original_article] => 334420
        [numberFix] => 334420
        [description] => Амортизатор
        [availability] => 1
        [packing] => 1
        [deliveryPeriod] => 97
        [deliveryPeriodMax] => 97
        [deadlineReplace] =>
        [distributorCode] => 2415076 Н
        [supplierCode] => 2415076
        [supplierColor] =>
        [supplierDescription] => 2415076 Н
        [supplierVerified] => N
        [itemKey] => 334420
        [price] => 6761.5
        [weight] => 0.00
        [volume] =>
        [deliveryProbability] => 50.91
        [lastUpdateTime] => 2022-08-01 14:31:00
        [additionalPrice] =>
        [noReturn] => 1
        [distributorId] => 2415076
        [grp] =>
        [code] => 148100402
        [nonliquid] =>
        [supplier_order_sent] => 2022-08-02 08:45:00
    )

    

Пакетный запрос без учета аналогов

Запрос: https://v01.ru/api/devinsight/search/batch/

    

        

        

            
Параметр
            
Описание
        
        

            
search
            
В параметре передается массив, где каждый элемент имеет свойства
        
        

            
brand
            
Бренд товара
        
        

            
number
            
Артикул товара
        
        
    


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

'search' => array(
    0 => array('number' => "2630035503", "brand" => "MOBIS"),
    1 => array('number' => "1005510", "brand" => "ASHIKA"),
    2 => array('number' => "OF0502", "brand" => "AVANTECH"),
)

Поля ответа аналогичны методу search/article
По данному методу существует ограничение: 50 артикулов за один запрос