GetOrderState

Назначение	Получить статус по заказу
PluggetSystemType	RKMid

ФОРМАТ ЗАПРОСА

ФОРМАТ ЗАПРОСА

Запрос

{
  "taskType": "GetOrderState",
  "params": {
    "sync": {
      "objectId": number,
       "timeout": number
    },
    "orderGuid": "string",
    "taskGuid": "string"
  }
}

CODE

Параметр	Тип	Обязательный	Описание	Значение по умолчанию
taskType	string	+	Тип задачи (GetOrderList)
sync			Синхронный вызов метода (либо синхронный, либо асинхронный. Для этого изменить на "async")
timeout	int	-	Время ожидания ответа от агента в секундах	120 секунд
orderGuid	guid	-	guid заказа, состояние которого нужно получить (либо orderGuid, либо taskGuid)
taskGuid	guid	-	guid задачи WhiteServer на создание заказа (либо orderGuid, либо taskGuid)

ФОРМАТ ОТВЕТА

ФОРМАТ ОТВЕТА

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

{
  "taskResponse": {
     "order": {
        "orderGuid": "string",
        "status": {
           "value": "string",
           "isBillPrinted": false
        },
        "substate": "string",  
        "rejectingReason": {
            "code": "string",
            "message": "string"
        }
  },
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "GetOrderState",
    "objectId": 0
  }
}

CODE

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

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

CODE

Параметр

Тип

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

Описание

taskGuid

uuid

+

Идентификатор запроса

order

- taskGuid

guid

taskGuid задачи WhiteServer на создание заказа

- orderGuid

guid

Guid заказа в r_k

status

– value

string

Статус заказа

*Агент V1 отличия:
Unknown — заказ не найден
Created — новый заказ
Accepted — заказ принят
Canceled — отменен по внешней команде во время ожидания подтверждения заказа от кассира

– isBillPrinted

bool

Флаг, показывающий, распечатан ли пречек заказа

substate

string

Расширенный статус заказа

- rejectingReason.code

Код отмены

- rejectingReason.message

string

Причина отмены заказа

error

string enum

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

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

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

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

{
  "taskType": "GetOrderState",
  "params": {
    "sync": {
      "objectId": 199990232,
      "timeout": 120
    },
    "orderGuid": "0e1d2eac-43f6-461a-9e5d-8da0f346e9a5",
    "payments": []
  }
}

{
  "taskResponse": {
    "order": {
      "originalOrderId": "676366851225",
      "orderGuid": "0e1d2eac-43f6-461a-9e5d-8da0f346e9a5",
      "midServerPiblicId": "SKAUTOSERV123",
      "status": {
        "value": "Created",
        "isBillPrinted": false,
        "isAutoAccepted": true
      },
      "substate": "None",
      "products": [
        {
          "id": 1024545,
          "name": "Велкопоповитский Козел",
          "price": 300,
          "quantity": 1,
          "ingredients": [],
          "kdsState": "None",
          "discountIds": []
        }
      ],
      "price": {
        "total": 300,
        "sumToPay": 300
      },
      "totalPieces": 0,
      "createdAt": "2026-05-22T10:37:24",
      "readyTime": "2026-05-22T00:00:00",
      "comment": "string",
      "personsQuantity": 1,
      "waiterId": 9001,
      "waiter": "Система",
      "tableName": "WSA2",
      "tableCode": 6,
      "extraTableCodes": [],
      "appliedPayments": [],
      "discountIds": [],
      "aggregatorId": "392110001",
      "queuePosition": "A89",
      "restaurantGuid": "fc1bbb36-4d7f-4ef9-80c2-33b78adbdb6a",
      "categoryGuid": "1e113335-9f76-4cdf-a860-96adb5d33e77"
    }
  },
  "responseCommon": {
    "taskGuid": "cfdf01a1-d880-4cc9-aabb-de229b70665d",
    "taskType": "GetOrderState",
    "objectId": 199990232,
    "agentGuid": "62225260-c097-4c75-abef-106c7207f9ff"
  }
}

{
  "responseCommon": {
    "taskGuid": "b55b90bf-c454-43d5-b8e2-eec6a1f4155d",
    "taskType": "GetOrderState",
    "objectId": 199990232,
    "agentGuid": "62225260-c097-4c75-abef-106c7207f9ff"
  },
  "error": {
    "agentError": {
      "code": "WsaOrderError",
      "desc": "RkInternal: Ошибки MidServ [2202] The order \"{0d357290-0195-4619-9383-071862efa0d1}\" is not found."
    }
  }
}

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