Корзина
Ресурсы
Ссылка | Тип запроса | Описание |
---|---|---|
/v1/basket | GET | Список товаров в корзине |
/v1/basket | POST | Оформление заказа в корзине |
/v1/basket | PATCH | Добавление, удаление, изменение числа товаров в корзине |
/v1/basket | DELETE | Удаление всех данных из корзины заказа |
/v1/basket/info | GET | Стоимость корзины и число уникальных товаров |
GET /v1/basket
Список товаров в корзине
Входные параметры
Отсутствуют
Ответ сервера
Возвращается объект items
или объект errors
Объект items
имеет струкруту
Параметр | Тип | Описание |
---|---|---|
p_code | Строка | Код подставщика. По-умолчанию, "VNY6" |
mog | Строка | Артикул номенклатуры в базе Восхода |
oem_brand | Строка | Бренд производителя |
oem_brand | Строка | Артикул производителя |
name | Строка | Название номенклатуры |
count | Целое | Количества товара в корзине |
shipment | Целое | Кратность покупки |
unit_code | Целое | Код единицы измерения |
unit | Целое | Единица измерения |
price | Вещественное | Стоимость товара с учетом количества |
available | Логическое | Наличие товара |
Запрос JSON
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/basket.json
Ответ JSON
{ "response": { "items": [ { "p_code":"VNY6", "mog":"117322и", "oem_brand":"IMS", "oem_num":"02092330", "name":"Пистон Renault Logan, Sandero, Nissan Almera крепления брызговика", "count":40, "shipment":10, "unit_code":796, "unit":"шт", "price":0.0, "available":false }, { "p_code":"VNY6", "mog":"105589и", "oem_brand":"MASUMA", "oem_num":"KE024", "name":"Пистон KE-024", "count":60, "shipment":10, "unit_code":796, "unit":"шт", "price":16.0, "available":true }, { "p_code":"VNY6", "mog":"65945и", "oem_brand":"HYUNDAI/KIA", "oem_num":"8916022000", "name":"Пистон Hyundai/Kia", "count":3, "shipment":1, "unit_code":796, "unit":"шт", "price":104.0, "available":true },{ "p_code":"VNY6", "mog":"42406a", "oem_brand":"Autostandart", "oem_num":"", "name":"Стенд Autostandart 4х-сторонняя вращающаяся в комплекте крючки ценники", "count":9, "shipment":1, "unit_code":796, "unit":"шт", "price":0.0, "available":false },{ "p_code":"VNY6", "mog":"17915a", "oem_brand":"Китай", "oem_num":"2323265СР", "name":"Carpoint Брелок Буква P хром 2323265СР", "count":1, "shipment":1, "unit_code":796, "unit":"шт", "price":140.0, "available":true } ] } }
Запрос XML
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/basket.xml
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <items> <item> <p_code>VNY6</p_code> <mog>117322и</mog> <oem_brand>IMS</oem_brand> <oem_num>02092330</oem_num> <name>Пистон Renault Logan, Sandero, Nissan Almera крепления брызговика</name> <count>40</count> <shipment>10</shipment> <unit_code>796</unit_code> <unit>шт</unit> <price>0.0</price> <available>false</available> </item> <item> <p_code>VNY6</p_code> <mog>105589и</mog> <oem_brand>MASUMA</oem_brand> <oem_num>KE024</oem_num> <name>Пистон KE-024</name> <count>60</count> <shipment>10</shipment> <unit_code>796</unit_code> <unit>шт</unit> <price>16.0</price> <available>true</available> </item> <item> <p_code>VNY6</p_code> <mog>65945и</mog> <oem_brand>HYUNDAI/KIA</oem_brand> <oem_num>8916022000</oem_num> <name>Пистон Hyundai/Kia</name> <count>3</count> <shipment>1</shipment> <unit_code>796</unit_code> <unit>шт</unit> <price>104.0</price> <available>true</available> </item> <item> <p_code>VNY6</p_code> <mog>42406a</mog> <oem_brand>Autostandart</oem_brand> <oem_num></oem_num> <name>Стенд Autostandart 4х-сторонняя вращающаяся в комплекте крючки ценники</name> <count>9</count> <shipment>1</shipment> <unit_code>796</unit_code> <unit>шт</unit> <price>0.0</price> <available>false</available> </item> <item> <p_code>VNY6</p_code> <mog>17915a</mog> <oem_brand>Китай</oem_brand> <oem_num>2323265СР</oem_num> <name>Carpoint Брелок Буква P хром 2323265СР</name> <count>1</count> <shipment>1</shipment> <unit_code>796</unit_code> <unit>шт</unit> <price>140.0</price> <available>true</available> </item> </items> </response>
POST /v1/basket
Оформление заказа в корзине
Входные параметры
Передается объект order
с параметрами
Параметр | Тип | Описание |
---|---|---|
delivery_type | Целое |
Тип доставки: 0 — самовывоз. Параметр "delivery_address" может быть пустым. 1 — доставка по указанному в параметре "delivery_address" адресу. |
delivery_address | Строка | Адрес доставки |
comment | Строка | Коментарий к заказу |
Выходные параметры
Возвращается объект order
или объект errors
Параметр | Тип | Описание |
---|---|---|
uid | Строка | Идентификатор заказа. Используется для получения информации о заказе. |
amount | Вещественное | Сумма заказа |
delivery_type | Целое |
Тип доставки: 0 — самовывоз. 1 — доставка по указанному в параметре "delivery_address" адресу. |
delivery_address | Строка | Адрес доставки |
comment | Строка | Коментарий к заказу |
Запрос JSON
POST
curl -X POST \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
-d '{"order":{"comment":"Доставить к 16.00", "delivery_type":"1", "delivery_address":"ул. Электростальская 47а"}}' \
https://api.v-avto.ru/v1/basket.json
Ответ JSON
{ "response": { "order": { "uid":"3", "amount":1920.0, "delivery_type":1, "delivery_address":"ул. Электростальская 47а", "comment":"Доставить к 16.00" } } }
Запрос XML
POST
curl -X POST \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
-d '<order comment="Доставить к 16.00" delivery_type="1" delivery_address="ул. Электростальская 47а"/>' \
https://api.v-avto.ru/v1/basket.xml
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <order> <uid>4</uid> <amount>1920.0</amount> <delivery_type>1</delivery_type> <delivery_address>ул. Электростальская 47а</delivery_address> <comment>Доставить к 16.00</comment> </order> </response>
PATCH /v1/basket
Добавление, удаление, изменение числа товаров в корзине
Входные параметры
Передается объект items
с массивом параметров
Параметр | Тип | Описание |
---|---|---|
p_code | Строка | Код поставщика. По-умолчанию, "VNY6" |
oem_num | Строка | Артикул производителя |
oem_brand | Строка | Бренд производителя |
mog | Строка | Артикул номенклатуры в базе Восхода |
count | Целое |
Количество товара в корзине. 0 или меньше — товар удаляется, больше нуля — в корзину добавляется указанное число товаров. |
iu | Логическое |
Инкрементальное обновление. По-умолчанию: false По-умолчанию, происходит полное обновление количество товара переданное в параметре count но,
если параметр iu имеет значние true то, происходит добавление количества товара в корзине на
величину count к уже имеющемуся.
|
Входные параметры
Передается объект items
с массивом параметров
Параметр | Тип | Описание |
---|---|---|
mog | Строка | Артикул номенклатуры в базе Восхода |
count | Целое |
Количество товара в корзине. 0 или меньше — товар удаляется, больше нуля — в корзину добавляется указанное число товаров. |
iu | Логическое |
Инкрементальное обновление. По-умолчанию: false По-умолчанию, происходит полное обновление количество товара переданное в параметре count но,
если параметр iu имеет значние true то, происходит добавление количества товара в корзине на
величину count к уже имеющемуся.
|
Ответ сервера
Возвращается объект items
с массивом параметров или объект errors
Параметр | Тип | Описание |
---|---|---|
p_code | Строка | Код поставщика. По-умолчанию, "VNY6" |
oem_num | Строка | Артикул производителя |
oem_brand | Строка | Бренд производителя |
mog | Строка | Артикул номенклатуры в базе Восхода |
count | Целое | Количество товара в корзине |
code | Целое | Код операции над товаром |
msg | Строка | Описание операции над товаром |
Коды code
операций над товаром
Код | Описание |
---|---|
0 | Товар добавлен или его количество обновлено |
1 | Вы не авторизованы |
2 | Ошибка добавления товара |
3 | Товар не найден в системе. Либо он удален, либо его не существовало ранее |
4 | Товар удален из корзины |
Запрос JSON
PATCH
curl -X PATCH \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
-d '{"items": [{"p_code":"VNY6", "oem_num":"KE024", "oem_brand":"MASUMA", "mog":"105589и", "count":"12", "iu": "true"}, {"p_code":"VNY6", "oem_num":"KE124", "oem_brand":"MASUMA", "mog":"105876и", "count":"1"}] }' \
https://api.v-avto.ru/v1/basket.json
Запрос JSON (упрощенный)
PATCH
curl -X PATCH \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
-d '{"items": [{"mog":"105589и", "count":"12", "iu": "true"}, {"mog":"105876и", "count":"1"}] }' \
https://api.v-avto.ru/v1/basket.json
Ответ JSON
{ "response": { "items":[ { "p_code":"VNY6", "mog":"105589и", "oem_brand":"MASUMA", "oem_num":"KE024", "count":20, "code":0, "msg":"Количество товара обновлено" }, { "p_code":"VNY6", "mog":"105876и", "oem_brand":"MASUMA", "oem_num":"KE124", "count":0, "code":3, "msg":"Товар не найден" } ] } }
Запрос XML
PATCH
curl -X PATCH \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
-d '<items><item p_code="VNY6" oem_num="KE024" oem_brand="MASUMA" mog="105589и" count="12" iu="true"/><item p_code="VNY6" oem_num="KE124" oem_brand="MASUMA" mog="105876и" count="1"/></items>' \
https://api.v-avto.ru/v1/basket.xml
Запрос XML (упрощенный)
PATCH
curl -X PATCH \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
-d '<items><item mog="105589и" count="12" iu="true"/><item mog="105876и" count="1"/></items>' \
https://api.v-avto.ru/v1/basket.xml
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <items> <item> <p_code>VNY6</p_code> <mog>105589и</mog> <oem_brand>MASUMA</oem_brand> <oem_num>KE024</oem_num> <count>20</count> <code>0</code> <msg>Количество товара обновлено</msg> </item> <item> <p_code>VNY6</p_code> <mog>105876и</mog> <oem_brand>MASUMA</oem_brand> <oem_num>KE124</oem_num> <count>0</count> <code>3</code> <msg>Товар не найден</msg> </item> </items> </response>
DELETE /v1/basket
Удаление всех данных из корзины заказа
Входные параметры
Отсутствуют
Ответ сервера
Возвращается объект status
или объект errors
Запрос JSON
DELETE
curl -X DELETE \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/basket.json
Ответ JSON
{ "response":{ "status":"Ok" } }
Запрос XML
DELETE
curl -X DELETE \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/basket.xml
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <status>Ok</status> </response>
GET /v1/basket/info
Стоимости корзины и число уникальных товаров
Входные параметры
Отсутствуют
Ответ сервера
Возвращается объект basket
или объект errors
Параметр | Тип | Описание |
---|---|---|
total_price | Вещественное | Сумма товаров в корзине |
count | Целое | Число уникальных товаров |
Запрос JSON
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/basket/info.json
Ответ JSON
{ "response": { "basket": { "total_price": 1533.70, "count": 7 } } }
Запрос XML
GET
curl \
-H "X-Voshod-API-KEY: 393-QBjhK44xUrbgduYHdANoLWdZx8eiPKCUQDvxU2v6MdiPnadQzLUBpYBHWKkg7gGYj9VcMyYif55Qd3g5" \
https://api.v-avto.ru/v1/basket/info.xml
Ответ XML
<?xml version="1.0" encoding="UTF-8"?> <response> <basket> <total_price>1533.70</total_price> <count>7</count> </basket> </response>