inventory_2Item. Номенклатура

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

GET https://[компания].myvirtualpos.ru/api/item?apikey=MySecret&limit=500&from_id=0&pricelist=1&images=1

Товары сортируются по возрастанию ид.

Пустые значения в JSON приходят как null, в XML — как пустой элемент.

Дополнительные поля, если они запрошены:

{
  "success": 1,
  "type": "item",
  "flexfields": { "attribute1": "Цвет" },
  "last_id": 8,
  "total": 2,
  "count": 2,
  "items": [
    {
      "item": {
        "id": 8,
        "external_id": "SKU-22222",
        "name": "Шампунь для волос",
        "description": "Увлажняющий шампунь",
        "article": "SH-1000",
        "enabled": 1,
        "sales_weight": 0,
        "volume": "1000.0000",
        "manufacturer_id": 1,
        "type": "G",
        "weight_good_flag": "N",
        "measurement_type": "PIECE",
        "not_show_in_shop": 0,
        "html_template_id": null,
        "group_ids": "1,2",
        "group_ext_ids": "GRP-1,GRP-2",
        "barcodes": "4607092441788,9785864153055",
        "vat_percent": 20,
        "created_date": "2026-07-11 17:34:58",
        "last_update_date": "2026-07-11 17:36:36",
        "attribute1": "Красный"
      }
    }
  ]
}

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

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>item</type>
  <flexfields><attribute1>Цвет</attribute1></flexfields>
  <last_id>8</last_id>
  <total>2</total>
  <count>2</count>
  <items>
    <item>
      <id>8</id>
      <external_id>SKU-22222</external_id>
      <name>Шампунь для волос</name>
      <!-- остальные поля товара -->
    </item>
  </items>
</root>

POST https://[компания].myvirtualpos.ru/api/item/update?apikey=MySecret&external_id=SKU-22222&create_if_not_exist=1
name=Шампунь&type=G&vat_percent=20&barcodes=4607092441788,9785864153055

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

{"success":1,"id":"38331","isnew":"1","barcode_errors":"","barcode_conflicts":""}

POST https://[компания].myvirtualpos.ru/api/item/updateAll?apikey=MySecret&create_if_not_exist=1
data=[{"external_id":"SKU-1","name":"Товар 1","article":"A1"},{"id":"1941","description":"Описание"}]

Параметр data — JSON-массив товаров. В каждом элементе укажите id или external_id и поля, которые нужно изменить, — те же, что и в методе update. Все товары обрабатываются независимо: ошибка в одном не отменяет остальные. Параметр create_if_not_exist (только GET) действует на все товары запроса.

{
  "success": 1,
  "success_count": 2,
  "fails_count": 2,
  "problem_ids": [ { "problem_item": { "id": "999999", "0": "Record not found" } } ],
  "problem_external_ids": [ { "problem_item": { "id": "NOPE", "info": "Record not found" } } ]
}

В problem_ids текст ошибки приходит под ключом 0, а не info. Чтобы сверять результаты по всем ошибкам, ориентируйтесь на fails_count.

POST https://[компания].myvirtualpos.ru/api/item/importImages?apikey=MySecret
items=[{"id":1940,"urls":["https://example.com/a.jpg","https://example.com/b.jpg"]}]&rewrite_all=1

Ответ: {«success»:1}. При ошибке — success равный 0 и текст в поле info.

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

Если по условиям ничего не найдено, метод получения возвращает успешный ответ с count равным 0 и пустым списком items.