Таблица ошибок при выполнении команд
Общие ошибки
Формат xml:
<RP code="0" version="1.6.0"> <ERROR code="1" text="Internal error" /> </RP>
| Код | Группа | Текстовое сообщение клиенту (англ) | Описание |
|---|---|---|---|
| 0 | WS | OK | Нет ошибки |
| 1 | WS | Internal error | Внутренняя необработанная ошибка |
| 2 | WS | Authentication failed | Ошибка авторизации. Необходимо переавторизоваться. |
| 3 | WS | Authentication failed. User temparary blocked | Пользователь временно заблокирован (на 5 минут) в связи с многократными попытками авторизации (3 и более за 5 минут). Необходимо подождать 5 минут до слелующей попытки авторизации. Клиенткий сервис должен сохранять сессию для всех потоков своих запросов, она может длиться несколько часов. Фактически нужно сохранять сессию до получения ошибки 2, потом повторно авторизоваться и передать всем дочерним процессам новую сессию. |
| 4 | WS | Authentication failed. User blocked | Пользователь заблокирован, нужно звонить в саппорт (бан) |
| 5 | WS | Bad request | Неправильный формат сообщения (xml и проч параметры) |
| 6 | WS | Invalid licence request. | Отсутствует лицензия на продукт, объект, неактивная лицензия и любая другая ошибка лицензирования при корректном ответе системы лицензирования. В случае неактивной лицензии или отсутствия лицензии, пишется какая лицензия у какого объекта отсутствует |
| 7 | WS | AgentСonflict | Два агента от одного объекта |
| 8 | WS | Timeout | Таймаут при выполнении запроса (не удалось выполнить запрос за отведённое время, по умолчанию 2 минуты). В случае появления такой ошибки, запрос можно повторить сразу же (в зависимости от конкретного сценария интеграции). В большинстве случаев не запущен агент в ресторане, не запущен кассовый сервер или у ресторана нет сети в данный момент. |
| 9 | WS | Callback is too big | Слишком большой колбэк, который не сохраняется в БД |
| 10 | WS | License. Suspicious operation. | Возвращается агенту в случае, если он работает только с SH, и в лицензии не содержатся данные об ИНН и КПП. |
| 80-99 | Коды ошибок балансировки и служебных сообщений | ||
| 80 | WS.Sys | System.Redirect | Команда клиенту “перейти на другой сервер”. Клиентский сервис должен перейти на работу с другим сервером (он будет указан в xml сообщении). На другом сервере необходимо повторно авторизоваться |
| 81 | WS.Sys | System.ConfigChanged | Изменение конфигурации кластеров (добавление, удаление серверов из кластер). Клиент должен сохранять у себя актуальный список серверов. Обычно используется в паре с ошибкой 80. Например, в кластере 3 сервера (с1, с2, с3). Приходит сообщение 81 и новый список серверов (с2, с3, с4) - с1 отключается, с4 - добавлен. При попытке соединения с с1 будет появляться ошибка 80 с редиректом на другой сервер. Но когда сервер будет выключен, то 80 ошибка уже не будет приходить. Поэтому нужно обрабатывать код 81. |
| 82 | Агент | Агент | Ошибка подключения агента к RK или SH (зависит от того на что был лицензирован агент ) |
| 100-199 | Резерв под ошибки систем UCS | ||
| 100 | UcsApp | UCS.Internal error | RK Кассовый сервер недоступен (XML API) |
| 102 | UcsApp | UCS.Internal error | SH недоступен |
| 103 | UcsApp | UCS.Internal error | GPX недоступен |
| 105 | Агент | Агент | Ошибка подключения агента к RK |
| 106 | UcsApp | UCS.Internal error | Сервер справочников недоступен (XML API) |
| 107 | UcsApp | UCS.Internal error | Сервер отчетов недоступен (XML API) |
| 108 | UcsApp | UCS.Internal error | Кассовый клиент недоступен (XML API) |
| 200-299 | UcsApp | UCS.Internal error | Резерв под ошибки внешних систем |
| 306 | Agent | Delivery club requests are not supported in WSA. Please use WSAConf | В настройках агента не включена интеграция с DeliveryClub |
Дополнительные коды ошибок лицензирования
Если проблема с лицензией WSClient:
<RP code="0" version="X.X.X.XXXX"> <ERROR code="6" Text="License not found" ExtCode="3" ExtText="WSAgent (agentID: 123456789)"/> </RP>
Если проблема с лицензией WSServer:
<RP code="0" version="X.X.X.XXXX"> <ERROR code="6" Text="License not found" ExtCode="1" ExtText="WSAggregator (aggregatorID: 12345)"/> </RP>
Если проблема с лицензией TESTSYSTEM (Название индивидуально для агрегаторов):
<RP code="0" version="X.X.X.XXXX"> <ERROR code="6" Text="License not found" ExtCode="2" ExtText="WSProduct(abstract soft) (agentID: 123456789)"/> </RP>
Дополнительные коды ошибок лицензирования
| ExtCode | ExtText | Описание | Решение |
|---|---|---|---|
| 5 | License. Suspicious operation. | Возвращается агенту в случае, если он работает только с SH, и в лицензии не содержатся данные об ИНН и КПП. | Перегенерировать лицензию в конфигураторе WSAgent |
| 6 | License. Soft code error. | Возвращается при авторизации в случае, если софт код лицензии != 33 (возможно вместо нее стоит использовать дополнительный код 1) | |
| 9 | CheckHours exceeded | Истекло время работы агента с оффлайн лицензированием | |
| 10 | Can not work with main server | Нет флага «Может работать с прод сервером» |