НазначениеПолучение списка товаров и групп товаров
Тип запросаАсинхронный/синхронный
Поддерживаемая версия агента, SHv1(sh4, sh5), v2(sh5)
PluggetSystemTypeStoreHouse


В SH5 не возвращаются штрихкоды (не реализовано в SH5).

Формат запроса


{
   "taskType":"ShGetGoodGroups",
   "params":{
    "async": {
      "objectId": number,
       "timeout": number
    },
    "sync": {
      "objectId": number,
       "timeout": number
    },
    "alcOnly": boolean,
    "groups":[
         {
            "rid": number,
            "withGoods": boolean
         }
      ]
   }
}
CODE

Параметр

Тип

Обязательный

Описание

taskTypestring+Тип задачи
async

Асинхронный вызов метода (либо синхронный, либо асинхронный)
sync

Синхронный вызов метода (либо синхронный, либо асинхронный)
|- timeoutint-Время ожидания ответа от агента в секундах, по умолчанию 120 секунд.
|- objectIdint+Код ресторана в системе лицензирования.
alcOnlyboolean-

Если true, то возвращает в группах только алкогольные товары. С версии агента 2.8.5.9.

groups
-Если конкретные группы не перечислены, возвращается ВЕСЬ список групп БЕЗ товаров.
|-   ridint
rid группы

|-   withGoods

boolean
Должны ли возвращаться товары из указанной группы.

Формат ответа


{ 
   "responseCommon":{ 
      "taskGuid": "guid",
      "taskType": "ShGetGoodGroups",
      "objectId": number
   },
   "error":{ 
      "wsError":{ 
         "code": "string",
         "desc": "string"
      }
   }
}
CODE

Параметр

Тип

Описание

taskGuidguidУникальный код этой задачи используется при получении задачи через очередь
taskTypestring enumТип задачи
objectIdintКод ресторана в системе лицензирования
error
Контейнер ошибок, см. Описание ошибок

Формат асинхронного ответа

// Успешный ответ
{
   "taskResponse":{
      "items":[
         {
            "goodItems":[
               {
                  "mUnits":[
                     {
                        "rid":"number",
                        "name":"string",
                        "isBase":"number",
                        "barCodes":[
                           {
                              "val":"string"
                           }
                        ]
                     }
                  ],
                  "rid":"number",
                  "name":"string"
               }
            ],
            "rid":"number",
            "name":"string",
            "parent":"number"
         }
      ]
   },
   "responseCommon":{
      "taskGuid":"string",
      "taskType":"ShGetGoodGroups",
      "objectId":"number"
   }
}
   
// Ответ с ошибкой
{
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "ShGetGoodGroups",
    "objectId": number
  },
  "error": {
    "wsError": {
      "code": "string",
      "desc": "string"
    },
    "agentError": {
      "code": "string",
      "desc": "string"
    }
  }
}
CODE

Параметр

Тип параметра

Обязательный

Описание

itemsarray

   ridint
rid группы товаров
   namestring
Название группы товаров
   parentint
rid группы предыдущего уровня
   goodItemsarray

         ridint
rid товара
         namestring
Название товара
         mUnitsarray

            ridint
rid единицы измерения
            namestring
Название единицы измерения
            isBaseint
Является ли единица измерения базовой для товара (если 1, то является)
            barCodesarray
В SH5 не возвращается
               valstring
Штрихкод для товара в этой единице измерения
errorstring enum
Контейнер ошибок, см. Описание ошибок