НазначениеЗапрос отчета «Ведомость остатков»
Тип запросаАсинхронный
Поддерживаемая версия агента, shv1(sh4, sh5), v2(sh5)


В sh5 группировки значительно отличаются.

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

{
   "taskType":"ShRepBillOfBalance",
   "params":{
      "async":{
         "objectId": number,
         "timeout": number
      },
      "reportParams":{
         "reportDate":{
            "date": "YYYY-MM-DD"
         },
         "goodsGroup":{
            "rid": number,
            "withNestedGroups": number
         },
         "category":{
            "mainRid": number,
            "bookeepingRid": number
         },
         "classify":{
            "itemRid": number
         },
         "store":{
            "rid": number,
            "groupRid": number
         },
         "currency":{
            "rid": number
         },
         "constraints":{
            "groupFor": "string",
            "onlyWithMovementForStore": number
         },
         "remnants":{
            "condition": "string",
            "value": "string"
         }
      }
   }
}


ПараметрТипОбязательныйОписание
taskTypestring+Тип задачи
async

Асинхронный метод
timeoutint-Время ожидания ответа от агента в секундах, по умолчанию 120 секунд
objectIdint+Код ресторана в системе лицензирования
reportParams


reportDate
+
datestring+Дата, за которую будет создана накладная
goodsGroup


ridint
rid товарной группы
withNestedGroupsint
включить в отчет данные по вложенным группам (0 - нет, 1 - да)
category


mainRidint_or_null
rid основной категории
bookeepingRidint_or_null
rid бухгалтерской категории
classify


itemRidint_or_null
rid значения товарного классификатора
store


ridint_or_null
rid склада. Если присутствует этот атрибут, то атрибута STORE.group_rid не должно быть
groupRidint_or_null
rid группы складов. Если присутствует этот атрибут, то атрибута STORE.rid не должно быть
store
+
ridint+rid валюты
constraints


groupForenum
По какому значению группировать отчет. Атрибут может принимать значения: - None - не группировать (используется, если атрибут отсутствует); - ForStores - группировать по складам; - ForGoodGroups - группировать группам товаров;
onlyWithMovementForStoreint_or_null
выводить только товары, по которым есть операции по складу/складам (0 - нет, 1 - да)
remnants

Условие на наличие/отсутствие остатков
conditionenum
Условие, может принимать значения: - Less - меньше; - NotMore - не более; - Equal - равно; - NotLess - не менее; - More - больше; - NotEqual - не равно;
valueenum
Атрибут может принимать значения: - Zero - нуля; - MinimumStock - мин. товарного запаса; - MaximumStock - макс. товарного запаса; Если REMNANTS.condition не заполнен, то значение атрибута REMNANTS.value игнорируется.

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

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

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

// Успешный ответ
{
   "taskResponse":{
      "groups":[
         {
            "name": "string",
            "id": number
         }
      ],
      "lines":[
         {
            "rid": number,
            "goodName": "string",
            "attributeText": "string",
            "attributeNumber": "string",
            "mUnitsRid": number,
            "mUnitsName": "string",
            "quantity": number,
            "sumWithoutTax": number,
            "sumNds": number,
            "sumNsp": number,
            "minReserve": number,
            "maxReserve": number,
            "groupId": "int_or_null"
         }
      ]
   },
   "responseCommon":{
      "taskGuid": "string",
      "taskType": "ShRepBillOfBalance",
      "objectId": number
   }
}
   
// Ответ с ошибкой
{
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "ShRepBillOfBalance",
    "objectId": number
  },
  "error": {
    "wsError": {
      "code": "string",
      "desc": "string"
    },
    "agentError": {
      "code": "string",
      "desc": "string"
    }
  }
}