sellPricelist. Цены на товары

Методы для работы с прайс-листами: получение цен прайс-листа, создание и изменение прайс-листов, установка цен товарам по одному и пачкой, назначение прайс-листа точке продаж и получение прайс-листов точки.

GET https://[компания].myvirtualpos.ru/api/pricelist?apikey=MySecret&id=1&item_id=52

Прайс-лист ищется по id, затем по external_id, затем по name.

Дополнительные поля (fields). Через двоеточие можно перечислить любые поля вида item_<поле товара>, например item_name, item_article, item_external_id, item_type, item_volume, item_vat_percent, item_manufacturer_id, а также:

Если указано неизвестное поле, метод вернёт ошибку со списком допустимых полей.

Поля строки прайс-листа

{
  "success": 1,
  "type": "pricelistLines",
  "pricelist_id": 1,
  "count": 1,
  "pricelines": [
    {
      "priceline": {
        "item_id": 52,
        "price": "929.00",
        "item_name": "Шампунь для волос",
        "item_ean13": "4627087168773"
      }
    }
  ]
}

Тот же ответ при format=xml:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>pricelistLines</type>
  <pricelist_id>1</pricelist_id>
  <count>1</count>
  <pricelines>
    <priceline>
      <item_id>52</item_id>
      <price>929.00</price>
    </priceline>
  </pricelines>
</root>

POST https://[компания].myvirtualpos.ru/api/pricelist/update?apikey=MySecret&external_id=PL-RETAIL&create_if_not_exist=1
name=Розничный&description=Основные цены

Прайс-лист ищется по id, а если он не указан — по external_id. Метод меняет заголовок прайс-листа, но не цены. Изменяются только переданные параметры.

{"success":1,"id":"11","isnew":"1"}

GET https://[компания].myvirtualpos.ru/api/pricelist/updateItem?apikey=MySecret&external_id=PL-RETAIL&item_id=52&price=150.5

Если товара в прайс-листе ещё нет, строка создаётся, иначе цена меняется.

{"success":1,"line_id":"77028","isnew":"1","price_before":null}

POST https://[компания].myvirtualpos.ru/api/pricelist/batchUpdate?apikey=MySecret
batch=<pricelist><external_id>PL-RETAIL</external_id><items>...</items></pricelist>

Параметр batch — XML. Корневой элемент содержит прайс-лист и его строки:

<pricelist>
  <external_id>PL-RETAIL</external_id>
  <items>
    <item>
      <external_id>SKU-52</external_id>
      <price>200.50</price>
    </item>
    <item>
      <id>53</id>
      <price>7</price>
    </item>
  </items>
</pricelist>

Все строки сохраняются в одной транзакции: если хотя бы один товар не найден или цена не сохранена, не сохраняется ничего. Успешный ответ: {«success»:1,«info»:«Saved price data»}.

GET https://[компания].myvirtualpos.ru/api/pricelist/assign?apikey=MySecret&external_id=PL-RETAIL&warehouse_id=6

Прайс-лист становится основным для точки продаж, прежний основной прайс-лист переводится в архив. Параметр main не влияет на результат: прайс-лист всегда назначается основным. Ответ: {«success»:1,«warehouse_id»:6,«price_id»:11}.

GET https://[компания].myvirtualpos.ru/api/pricelist/listForWarehouse?apikey=MySecret&warehouse_id=6

{
  "success": 1,
  "warehouse_id": 6,
  "warehouse_external_id": "WH-6",
  "default_pricelist_id": 1,
  "default_pricelist_external_id": "PL-RETAIL",
  "pricelist_ids": "1,2",
  "pricelist_external_ids": "PL-RETAIL,PL-WHOLESALE"
}

Ошибка авторизации и общие ошибки описаны в статье Общие сведения. Ошибки приходят с кодом HTTP 200 и success равным 0: