Корзина
Ресурсы
| Ссылка | Тип запроса | Описание |
|---|---|---|
| /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>