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

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

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

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

Поля ответа:

Array
(
    [E] => Array // Код статуса
        (
            [id] => E // Код статуса
            [name] => Ожидает обработки // Мнемоническое название статуса
            [final] => N // Флаг Y|N , Y - статус является финальным
        )

    [N] => Array
        (
            [id] => N
            [name] => Ожидает обработки
            [final] => N
        )
)



Получение списка заказов
Запрос: https://v01.ru/api/devinsight/orders/

Запрос возвращает заказы пользователя списком. Сортировка - от последнего к первому

Поля запроса:

    [format] => p // Формат ответа p - с позициями в заказе, пустое - без позиций
    [skip] => 0 // С какого заказа выводить в ответ заказы
    [limit] => 100 // Лимит выдачи заказов , максимальный = 100

Поля ответа:

Array
(
    [0] => Array
        (
            [number] => 4827595 // ID заказа
            [status] => Отменен // Мнемонический код статуса
            [statusId] => C // Код статуса
            [statusCode] => C // Код статуса
            [positionsQuantity] => 1 // Количество объектов в заказе (т.е. 2шт 1 позиции = 2)
            [sum] => 122.27
            [date] => 2022-07-28 17:43:47
            [comment] =>
            [positions] => Array
                (
                    [0] => Array
                        (
                            [id] => 9282194
                            [brand] => ELRING
                            [number] => 394030
                            [numberFix] => 394030
                            [code] => 428223742
                            [supplierCode] => 1046349
                            [itemKey] => 394030
                            [description] => ELRING [394030] прокладка сливной пробки  Mitsubishi Volvo S40V40 98-04
                            [price] => 122.27
                            [quantity] => 1
                            [comment] =>
                            [status] => Отменен // Мнемонический код статуса строки
                            [statusId] => C // Код статуса строки
                            [statusCode] => C // Код статуса
                        )

                )

        )
)



Получение информации о заказе
Запрос: https://v01.ru/api/devinsight/order/

Поля запроса:

	'format' => 'p', // Формат ответа p - с позициями в заказе, пустое - без позиций
	'number' => 4785417,

Поля ответа аналогичны запросу orders, но возвращается один элемент массива заказов - искомый заказ



Получение списка заказов
Запрос: https://v01.ru/api/devinsight/orders/list/

Поля запроса:

    'orders' => array(4785417) // список номеров заказов для получения информации

Поля ответа

Поля ответа аналогичны запросу orders, но возвращаются только запрошенные заказы



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

Поля запроса:

	'orders' => array(4785417) // Массив номеров заказов

Поля ответа

Array
(
    [4785417] => Array
        (
            [id] => P // Статус заказа
            [name] => Загружен в 1С // Мнемонический код статуса
            [final] => N // (Y = финальный статус)
        )

)



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

Поля запроса:

    'baskets' => array(9203911)

Поля ответа

Array
(
    [9203911] => Array // ИД строки, по которой возвращается информация
        (
            [id] => S // Код статуса
            [name] => Сборка / упаковка // Код статуса
            [statusCode] => S // Код статуса
            [final] => // Y, если статус является финальным
        )

)



Получение истории изменения статусов строки
Запрос: https://v01.ru/api/devinsight/orders/statusHistory/

Поля запроса:

	'positionId' => 9203911 // ИД строки

Поля ответа

Array
(
    [0] => Array // порядковый номер записи
        (
            [statusCode] => R // статус строки
            [status] => Принят в работу // мнемонический статус строки
            [datetime] => 20.07.2022 13:53 // дата изменения
            [managerId] => 1 // кто произвел изменение (1 - система v01.ru)
            [managerName] => v01.ru // кто произвел изменение комментарий
        )

    [1] => Array
        (
            [statusCode] => G
            [status] => Отправлен заказ поставщику
            [datetime] => 20.07.2022 15:04
            [managerId] => 1
            [managerName] => v01.ru
        )

    [2] => Array
        (
            [statusCode] => A
            [status] => Зарезервировано поставщиком
            [datetime] => 20.07.2022 16:01
            [managerId] => 1
            [managerName] => v01.ru
        )

    [3] => Array
        (
            [statusCode] => T
            [status] => В пути от поставщика
            [datetime] => 21.07.2022 08:51
            [managerId] => 1
            [managerName] => v01.ru
        )

    [4] => Array
        (
            [statusCode] => I
            [status] => Приемка товара на склад (I)
            [datetime] => 21.07.2022 13:03
            [managerId] => 1
            [managerName] => v01.ru
        )

    [5] => Array
        (
            [statusCode] => S
            [status] => Сборка / упаковка
            [datetime] => 21.07.2022 13:49
            [managerId] => 1
            [managerName] => v01.ru
        )

)