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

НазначениеЗапрос на обновление данных о сотруднике или на добавление данных о новом сотруднике
Поддерживаемая версия агентаv2
PluggetSystemTypeRKRef
Формат запроса

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

Запрос

{
  "taskType": "SetEmployee",
  "params": {
    "Employee": {
    // Employee
    }
    "sync": {
      "objectId": 0,
      "timeout": 0
    }
  }
}
JSON
ПараметрТипОбязательныйОписаниеЗначение по умолчанию
taskTypestring+Тип задачи (SetEmployee)
Employeeobject+

Изменяемые или добавляемые данные о сотруднике 


sync

Синхронный вызов метода (либо синхронный, либо асинхронный. Для этого изменить на "async") 
|-timeoutint-Время ожидания ответа от агента в секундах120 секунд
|-objectIdint+Код ресторана в системе лицензирования
Формат ответа

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

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

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

{
 "responseCommon": {
   "taskGuid": "string",
   "taskType": "SetEmployee",
   "objectId": number
 },
 "taskResponse": {}
}
JSON

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

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

{
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "SetEmployee",
    "objectId": number
  },
  "error": {
    "wsError": {
      "code": "string",
      "desc": "string"
    },
    "agentError": {
      "code": "string",
      "desc": "string"
    }
  }
}
JSON
ПараметрТипОписание
responseCommonobjectИнформация по задаче
  • taskGuid
guidУникальный код этой задачи используется при получении задачи через очередь
  • taskType
stringТип задачи
  • objectId
intКод ресторана в системе лицензирования
errorobjectКонтейнер ошибок, см Описание ошибок


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


ПРИМЕРЫ СТРУКТУРЫ ЗАПРОСОВ
{
  "taskType": "SetEmployee",
  "params": {
    "sync": {
      "objectId": 199996011,
      "timeout": 120
    },
    "Employee": {
      "id": 1000006,
      "name": "Кассир тест",
      "altName": "Kassir test",
      "eMail": "test@testmail.ru",
      "groups": [0,4],
      "restaurantRoles": [
        {
          "restaurantId": 6011,
          "roleId": 100004,
          "name": "Кассиры"
        }
        ],
        "defaultRestaurantId": 3,
        "qrSberTips": "Тест три21"
    }
  }
}


{
  "taskResponse": {},
  "responseCommon": {
    "taskGuid": "b0a63423-93e5-40df-a44e-077a41bb0a01",
    "taskType": "SetEmployee",
    "objectId": 199996011,
    "agentGuid": "c415aa96-8952-4689-8fcb-c6c969e25aad"
  }
}


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