ООО Восход

Корзина

Ресурсы

Ссылка Тип запроса Описание
/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 с массивом параметров или объект 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

  {
    "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

  <?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>