account_treeItemGroup. Номенклатурные группы

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

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

Если указаны оба параметра, группа должна подходить под оба условия. Без параметров возвращаются все группы одним ответом; постраничной выдачи нет.

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

{
  "success": 1,
  "type": "item_group",
  "count": 2,
  "item_groups": [
    {
      "item_group": {
        "id": 1274,
        "external_id": "GRP-1",
        "name": "Косметика",
        "parent_id": null,
        "parent_ext_id": null,
        "not_show_in_shop": 0,
        "index_tree": "1274:",
        "created_date": "2026-09-26 10:27:21",
        "last_update_date": "2026-09-26 10:27:21"
      }
    },
    {
      "item_group": {
        "id": 1275,
        "external_id": "GRP-2",
        "name": "Шампуни",
        "parent_id": 1274,
        "parent_ext_id": "GRP-1",
        "not_show_in_shop": 1,
        "index_tree": "1274:1275:",
        "created_date": "2026-09-26 10:27:21",
        "last_update_date": "2026-09-26 10:27:21"
      }
    }
  ]
}

Тот же ответ при format=xml (сокращённо):

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>item_group</type>
  <count>2</count>
  <item_groups>
    <item_group>
      <id>1274</id>
      <external_id>GRP-1</external_id>
      <name>Косметика</name>
      <parent_id/>
      <!-- остальные поля группы -->
    </item_group>
  </item_groups>
</root>

POST https://[компания].myvirtualpos.ru/api/itemGroup/update?apikey=MySecret&external_id=GRP-2&create_if_not_exist=1
name=Шампуни&parent_ext_id=GRP-1

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

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

GET https://[компания].myvirtualpos.ru/api/itemGroup/delete?apikey=MySecret&external_id=GRP-2

Ответ: {«success»:1,«id»:1275}.

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

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