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

Методы для работы с корзиной и заказом

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

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

Запрос: https://v01.ru/api/devinsight/basket/add/

Добавление товара в корзину может происходить по уникальному коду или сочетанию бренд-артикул-код-поставщика

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

	'positions' => array( - массив с позициями для добавления в корзину
		0 => array(
			"code" => 11290543, // id товара , т.е. поле code из проценки
			"quantity" => 1, // Количество товара
		),
		1 => array(
			"brand" => "KYB", // бренд
			"number" => '334420', // артикул
			"supplierCode" => 2571434, // код поставщика
			"quantity" => 1, // Количество товара
		),
		2 => array(
			"brand" => "BOSCH",
			"number" => '1457433160', // несуществующий артикул
			"supplierCode" => 12962,
			"quantity" => 1,
		),
	),

Параметры ответа

Array
(
    [positions] => Array // Массив со статусами добавления в корзину каждой позиции
        (
            [0] => Array
                (
                    [brand] =>
                    [number] =>
                    [numberFix] =>
                    [code] => 11290543 // параметры из запроса
                    [supplierCode] =>
                    [description] =>
                    [quantity] => 1 // параметры из запроса
                    [comment] =>
                    [status] => 0 // Статус 0 = ошибка. 1 - успех
                    [errorMessage] => Деталь с таким кодом не найдена в базе // Т.е. деталь, которую мы добавляли по коду не смогла добавиться в корзину, т.к. код некорректен
                )

            [1] => Array
                (
                    [brand] => KYB // параметры из запроса
                    [number] => 334420 // параметры из запроса
                    [numberFix] => 334420 // параметры из запроса
                    [code] => 148100402 // параметры из запроса
                    [supplierCode] => 2415076 // параметры из запроса
                    [description] =>
                    [quantity] => 1 // параметры из запроса
                    [comment] =>
                    [status] => 1 // добавление успешно выполнено
                    [errorMessage] =>
                )

        )

    [status] => 0 // общий статус запроса. 0 - с ошибками (то есть есть хотя бы одна ошибка при добавлении), 1 - полностью успешно
)


    

Очистка корзины
Запрос: https://v01.ru/api/devinsight/basket/clear/

Кроме логина и пароля параметры не передаются

Возвращается статус выполнения и информация о корзине

Array
(
    [status] => 0 // Не выполнилось, т.к. корзина уже была пуста
    [errorMessage] => Корзина пуста
)

    


Получение списка товаров в корзине

Запрос: https://v01.ru/api/devinsight/basket/content/

Array
( // Возвращается объект, содержащий узлы
    [0] => Array
        (
            [brand] => KYB // Бренд
            [number] => 334420 // Артикул неочищенный
            [numberFix] => 334420 // Артикул очищенный
            [code] => 148100402 // Уникальный код детали
            [supplierCode] => 2415076 // Код поставщика
            [itemKey] => 334420 // Артикул (для совместимости)
            [description] => KYB [334420] Амортизатор // Описание детали
            [price] => 6522.85 // Цена, по которой артикул добавлен в корзину
            [quantity] => 1 // Количество
            [comment] =>  // Комментарий о детали
            [status] => 1 // Статус детали в корзине (1 - можно заказывать, 0 - неактуален)
            [errorMessage] =>  // Сообщение о проблеме с товаром, если есть
        )

)

    

Получение списка способов оплаты
Запрос: https://v01.ru/api/devinsight/basket/paymentMethods/

Ответ:

Array
( // Массив с доступными видами оплаты
    [0] => Array
        (
            [id] => 6 // ID вида оплаты
            [name] => Оплата в соответствии с условиями договора // Название вида оплаты
        )

)

    

Получение списка способов доставки
Запрос: ttps://v01.ru/api/devinsight/basket/shipmentMethods

Ответ:

Array
(
    [0] => Array
        (
            [id] => 2 // Данный метод используется, чтобы сделать заказ именно на самовывоз
            [name] => Самовывоз со склада в Москве
        )

    [1] => Array
        (
            [id] => 23 // Доставка собственной службой доставки
            [name] => Доставка курьером
        )

    [2] => Array
        (
            [id] => 1 // Тот способ, который задан Вашим договором
            [name] => Доставка в соответствии с Вашими условиями договора
        )

)

    

Получение списка офисов самовывоза
Операция: https://v01.ru/api/devinsight/basket/shipmentOffices/

Ответ

Array
(
    [0] => Array
        (
            [id] => 13146 // ID склада
            [name] => Румянцево // Название склада
        )

)

    

Получение списка адресов доставки
Запрос: https://v01.ru/api/devinsight/basket/shipmentAddresses/

Ответ:

Array
(
    [0] => Array
        (
            [id] => self-8fc1cda0-e3e6-11e8-aac4-0050568fd59f // ID адреса доставки (string)
            [name] => Москва, поселение Сосенское, д. Николо-Хованское, технопарк «Индиго» // Название адреса доставки
        )

)

    


Отправка корзины в заказ
Запрос: https://v01.ru/api/devinsight/basket/order/

Данный метод оформляет заказ на уже добавленные ранее методом basket/add товары. Обращаем внимание, что при этом не происходит проверки на актуальность цены товара. Для этого используйте метод basket/actualizeList

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

	'paymentMethod'   => 6, // Способ оплаты из методы получения списков способов оплаты
	'shipmentMethod'  => 2, // Способ доставки
	'shipmentAddress' => 'self-17032', // Адрес доставки, полученный из списка адресов доставки
	'shipmentOffice'  => 0, // Склад для заказа самовывозом
	'comment' => "Через API", // Комментарий для заказа

Поля ответа

Array
(
    [status] => 0 // Общий статус выполнения запроса. 0 - есть ошибки или комментарии, 1 - все ок без комментариев
    [errorMessage] => Array // массив сообщений об ошибках
        (
            [0] => Array // Сообщение по товару
                (
                    [brand] => KYB
                    [number] => 334420
                    [numberFix] => 334420
                    [code] => 148100402
                    [status] => 1 // Товар все равно добавился
                    [errorMessage] =>  Цена на товар повысилась на 397.74 руб. Актуальная цена: 6920.59 руб // Информация о товаре
                )

        )

    [orders] => Array // массив сформированных заказов
        (
            [4842029] => Array // ID заказа
                (
                    [number] => 4842029 // ID заказа
                    [status] => Ожидает обработки // Статус мнемонический
                    [statusId] => N // Код статуса (получение всех кодов - см. запрос system/statuses)
                    [statusCode] => N // Код статуса
                    [positionsQuantity] => 1 // Общее количество позиций в заказе
                    [sum] => 6522.85
                    [date] => 2022-08-01 16:56:08 // Дата формирования
                    [comment] =>
                    [positions] => Array
                        (
                            [0] => Array
                                (
                                    [id] => 9308287
                                    [brand] => KYB
                                    [number] => 334420
                                    [numberFix] => 334420
                                    [code] => 148100402
                                    [supplierCode] => 2415076
                                    [itemKey] => 334420
                                    [description] => KYB [334420] Амортизатор
                                    [price] => 6522.85
                                    [quantity] => 1
                                    [comment] =>
                                    [status] => Ожидает обработки
                                    [statusId] => E // Статус позиции
                                    [statusCode] => E
                                )

                        )

                )

        )

)

    

Моментальный заказ (формирование корзины и отправка ее в заказ с проверкой по цене)
Запрос: https://v01.ru/api/devinsight/orders/instant

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

    [paymentMethod] => 6 // ID метода платежа
    [shipmentMethod] => 23 // ID метода доставки
    [shipmentAddress] => 7 // ID адреса доставки
    [shipmentOffice] => 0
    [positions] => Array // Набор позиций для заказа
        (
            [0] => Array
                (
                    [number] => 334420
                    [brand] => KYB
                    [supplierCode] => 1091343
                    [quantity] => 1
                    [comment] => testApi
                    [price] => 8000 // Необязательное поле. Если не указано, то заказ будет создан по цене поставщика. Если указан, то будет выполняться проверка на корректность цена. Если цена, которую Вы ожидаете не соответствует цене поставщика, то заказ не будет оформлен и вернется ошибка
                )

        )

Параметры ответа:

Array
(
    [status] => 1 // Статус запроса, 0 - выполнен с ошибками, 1 - выполнен успешно
    [errorMessage] =>
    [orders] => Array
        (
            [0] => Array
                (
                    [number] => 4842068
                    [status] => Ожидает обработки
                    [statusId] => N
                    [statusCode] => N
                    [positionsQuantity] => 1
                    [sum] => 8000
                    [date] => 2022-08-01 17:00:02
                    [comment] =>
                    [positions] => Array
                        (
                            [0] => Array
                                (
                                    [brand] => KYB
                                    [number] => 334420
                                    [numberFix] => 334420
                                    [code] => 518392521
                                    [supplierCode] => 1091343
                                    [description] => Амортизатор
                                    [quantity] => 1
                                    [comment] => testApi
                                    [status] => 1
                                    [errorMessage] =>
                                    [price] => 8000
                                )

                        )

                )

        )

)

    

    Получение списка измененных товаров в корзине
    Запрос: https://v01.ru/api/devinsight/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