SetGlobalTradeItemNumbers

Последнее изменение статьи: 19.06.2026 09:38

Назначение	Установка GTIN для блюд
Тип запроса	асинхронный/синхронный
Поддерживаемая версия агента	V2.8.1.10
PluggetSystemType	RKRef

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

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

{
  "taskType": "SetGlobalTradeItemNumbers",
  "params": {
    "sync": {
      "objectId": number,
       "timeout": number
    },
    "items": [
        {
            "id": "string",
            "code": "string",
            "objectId": number
        }
      ]
    }
}

JSON

Параметр	Тип	Обязательный	Описание	Значение по умолчанию
taskType	string	+	Тип задачи (SetGlobalTradeItemNumbers)
sync			Синхронный вызов метода (либо синхронный, либо асинхронный. Для этого изменить на "async")
objectId	int	да	Код ресторана в системе лицензирования	120 секунд
timeout	int	-	Время ожидания ответа в секундах
Items	array	да	Массив блюд, для которых ставится код
id	string	да	Идентификатор блюда
code	string	да	Новый код (коды с разделителем `;`)
objectId	number	нет	Код ресторана, для которого назначается GTIN. Если не указан - то GTIN записывается как глобальный
objectId	number	нет	Код ресторана, для которого назначается GTIN. Если не указан - то GTIN записывается как глобальный

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

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

Успешный ответ

{
  "taskResponse": {},
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "SetGlobalTradeItemNumbers",
    "objectId": number,
    "agentGuid": "string"
  }
}

JSON

Ответ с ошибкой

{
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "SetGlobalTradeItemNumbers",
    "objectId": number
  },
  "error": {
    "wsError": {
      "code": "string",
      "desc": "string"
    },
    "agentError": {
      "code": "string",
      "desc": "string"
    }
  }
}

JSON

Параметр Тип Описание

responseCommon object Информация по задаче

taskGuid

guid

Уникальный код этой задачи используется при получении задачи через очередь

taskType

string

Тип задачи

objectId

int

Код ресторана в системе лицензирования

taskResponse object Содержимое блока можно посмотреть здесь: Employee

error object Контейнер ошибок, см Описание ошибок

wsError		Ошибка от сервера
agentError		Ошибка от агента

ПРИМЕРЫ СТРУКТУРЫ ЗАПРОСОВ

Примеры структуры запросов

{
  "taskType": "SetGlobalTradeItemNumbers",
  "params": {
      "sync": {
        "objectId": 199990246,
         "timeout": 120
      },
      "items": [
        {
             "id": "1000016",
             "code": "00000000077777"
        },
        {
            "id": "1000016",
            "code": "78787878;11111111111",
            "objectId": 199990246
        },
        {
            "id": "1000085",
            "code": "44444495;11111122222"
        },
        {
            "id": "1000085",
            "code": "1999902461111",
            "objectId": 199990246
        }
      ]
  }
}

{
  "taskResponse": {},
  "responseCommon": {
    "taskGuid": "547b9e83-031e-41e7-aaca-ca6de19e5f2f",
    "taskType": "SetGlobalTradeItemNumbers",
    "objectId": 199990232,
    "agentGuid": "62225260-c097-4c75-abef-106c7207f9ff"
  }
}

{
  "responseCommon": {
    "taskGuid": "ea40ade9-9542-4051-b823-491b7ff30854",
    "taskType": "SetGlobalTradeItemNumbers",
    "objectId": 199990232,
    "agentGuid": "62225260-c097-4c75-abef-106c7207f9ff"
  },
  "error": {
    "agentError": {
      "code": "WsaOrderError",
      "desc": "WsaParseError: Неизвестный код ресторана 199999998"
    }
  }
}

{
  "responseCommon": {
    "taskGuid": "46f146fd-bb2c-41a8-b4aa-6587007bd0b4",
    "taskType": "SetGlobalTradeItemNumbers",
    "objectId": 331760005
  },
  "error": {
    "wsError": {
      "code": "Timeout",
      "desc": "Agent is offline or has been unresponsive"
    }
  }
}