price_changePricelistAdjustment. Корректировка розничных цен

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

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

Поля документа

Поля строки

{
  "success": 1,
  "type": "PriceAdjustmentLines",
  "priceadjustment": {
    "id": 66,
    "external_id": "ADJ-2026-09",
    "pricelist_id": 1,
    "status": "draft",
    "date_applied": null,
    "html_template_id": null,
    "comment": "Сентябрьская индексация",
    "created_date": "2026-09-01 10:00:00",
    "created_by": 6,
    "last_update_date": "2026-09-01 10:05:00",
    "last_update_by": 6,
    "items": [
      {
        "item": {
          "item_id": 462,
          "item_ext_id": "SKU-462",
          "price_new": "620.00",
          "price_old": "590.00",
          "line_id": 1,
          "created_date": "2026-09-01 10:00:00",
          "last_update_date": "2026-09-01 10:05:00"
        }
      }
    ]
  }
}

В примере опущены гибкие поля attribute1…attribute15. Тот же ответ при format=xml (сокращённо):

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>PriceAdjustmentLines</type>
  <priceadjustment>
    <id>66</id>
    <pricelist_id>1</pricelist_id>
    <status>draft</status>
    <!-- остальные поля документа -->
    <items>
      <item>
        <item_id>462</item_id>
        <price_new>620.00</price_new>
        <price_old>590.00</price_old>
        <!-- остальные поля строки -->
      </item>
    </items>
  </priceadjustment>
</root>

GET https://[компания].myvirtualpos.ru/api/priceAdjustment/update?apikey=MySecret&external_id=ADJ-2026-09&pricelist_id=1&create_if_not_exist=1

Документ ищется по id, а если он не указан — по external_id. Если документ не найден, а передан create_if_not_exist=1, создаётся новый черновик.

Ответ: {«success»:1,«id»:«68»,«isnew»:«1»} (id при создании приходит строкой, при изменении — числом; isnew — «1» для созданного документа).

GET https://[компания].myvirtualpos.ru/api/priceAdjustment/updateItem?apikey=MySecret&external_id=ADJ-2026-09&item_id=52&price=112

Если строки для товара в документе нет, она создаётся. При изменении строки прежнее значение новой цены записывается в price_old.

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

POST https://[компания].myvirtualpos.ru/api/priceAdjustment/batchUpdate?apikey=MySecret
batch=<root>…</root>

Параметр batch — XML. Документ создаётся черновиком, если не найден, и наполняется строками:

<root>
  <adjustment_external_id>ADJ-2026-09</adjustment_external_id>
  <pricelist_external_id>PL-RETAIL</pricelist_external_id>
  <items>
    <item>
      <ext_item_code>SKU-52</ext_item_code>
      <price>112</price>
    </item>
  </items>
</root>

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

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