Коды ответов и ошибки
Внимание
Новые ключи временно не выпускаются в связи с обновлением продукта.
Перечень кодов с описанием
По коду ответа можно узнать результат выполнения операции. В таблице приведен список кодов, которые поддерживаются в API ОФД.
HTTP-код |
Код ошибки |
Сообщение |
Описание |
200 |
— |
OK |
Успешный запрос. |
204 |
— |
No Content |
Успешный запрос. Ответ не содержит тела сообщения. |
405 |
0 |
The method is not allowed for the requested URL |
HTTP-метод запрещен для данного ресурса. |
401 |
1 |
Incorrect Yandex Key |
Ошибка авторизации по заголовку |
401 |
1 |
Incorrect X-Yandex-Uid header |
Ошибка авторизации по заголовку |
401 |
2 |
Incorrect Ofd Key |
Ошибка авторизации по заголовку |
401 |
2 |
User is not associated with a client |
К пользователю не привязан клиент. |
403 |
3 |
Company not found |
К запрошенной компании нет доступа или она не существует. |
403 |
4 |
Cash Register not found |
К запрошенной кассе нет доступа или она не существует. |
400 |
5 |
Bad Request |
Ошибочные данные в запросе. Возможные причины:
|
422 |
7 |
Invalid payload structure |
Неверная структура тела запроса. Возможные причины см. ниже. |
403 |
18 |
Registration was not found |
Диалог не найден. |
403 |
22 |
Retail point was not found |
Точка продаж не найдена. |
403 |
23 |
Wrong registration status |
Регистрация в неправильном статусе чтобы вызывать этот метод. |
403 |
25 |
Document not found |
Документ не найден. |
500 |
26 |
Nalog.ru request error |
Ошибка соединения с ФНС. |
403 |
27 |
Vendor not found |
Поставщик не найден. |
403 |
29 |
Sign not found |
КСКПЭП не найден. |
403 |
34 |
Client has no access for the offer |
У клиента нет доступа к данному предложению. |
500 |
35 |
Cannot create sign registration request |
Не удалось создать запрос на регистрацию. |
500 |
36 |
Incorrect data for registration |
Неудачная попытка регистрации. |
500 |
37 |
File was not sent |
Файл не был передан. |
500 |
38 |
Cannot add document to sign registration |
Не удалось добавить документ к запросу на регистрацию. |
503 |
39 |
Sign service is unavailable. Please retry the request |
Вышло время ожидания подписи документов. |
500 |
39 |
Sign registration not found |
Запрос на регистрацию не найден. |
500 |
40 |
Cannot send sign registration |
Не удалось отправить заявку в сервис получения электронной подписи (ЗАО «Калуга Астрал»). |
400 |
41 |
Kaluga answered with error |
Сервис получения электронной подписи (ЗАО «Калуга Астрал») ответил ошибкой. |
400 |
42 |
Sign request has wrong status |
Заявка находится в неверном состоянии. |
400 |
43 |
Unable to get certificate |
Не удалось получить сертификат. |
503 |
47 |
Unable to download document |
Не удалось скачать файл. |
400 |
48 |
Unknown aggregation group type |
Неизвестный тип группировки для агрегации. |
500 |
51 |
Cannot create sign edit request |
Не удалось создать запрос на изменение. |
500 |
55 |
Cannot delete request |
Не удалось удалить заявку. |
403 |
60 |
FiscalCorrection not found |
Перерегистрация ККТ не найдена. |
400 |
60 |
File has incorrect format |
Неверный формат файла. |
400 |
62 |
CashboxImport has wrong status |
Заявка на заведение ККТ находится в неверном состоянии. |
403 |
63 |
FiscalCorrection not found |
Перерегистрация ККТ не найдена. |
403 |
64 |
User passport linked to another client |
Пользователь привязан к другому клиенту. |
400 |
65 |
General user assosiation error |
Ошибка привязки клиента к пользователю. |
403 |
66 |
Subpartner not found |
К запрошенному субпартнеру нет доступа или он не существует. |
403 |
67 |
User not found |
Пользователь не найден. |
403 |
68 |
Role not found |
Роль не найдена. |
403 |
69 |
Permission not found |
Право доступа не найдено. |
400 |
70 |
User passport linked to this client |
Пользователь привязан к этому клиенту. |
400 |
71 |
User passport not found |
Пользователь не найден в биллинге. |
400 |
72 |
Client not found in billing |
Клиент не найден в биллинге. |
400 |
73 |
User already exists |
Пользователь уже существует. |
403 |
74 |
FiscalCorrection is active please stop it before starting new dialogue |
Перерегистрация в процессе ожидания. |
403 |
75 |
Cant stop not active FiscalCorrection |
Перерегистрация не активна. |
500 |
76 |
Cannot authenticate by OAuth |
Ошибка при обращению к ЧЯ. |
401 |
77 |
Invalid x-token |
Ошибка авторизации по OAuth. |
Вложенные коды ошибки 422 (Invalid payload structure)
HTTP-код | Код ошибки | Сообщение | Описание |
---|---|---|---|
422 | 1 | ERR_FORMAT | Некорректный формат параметра. |
2 | ERR_INVALID | Неверный тип параметра. | |
3 | ERR_REQUIRED | Отсутствует обязательный параметр. | |
4 | ERR_NULL <параметр> | <Параметр> не может иметь значение «NULL». | |
5 | ERR_NOT_FOUND | Неизвестное параметр. | |
6 | ERR_DUPLICATE | Параметр не найден. | |
7 | ERR_NOT_ALLOWED | К параметру нет доступа. | |
8 | ERR_COUPON_DISABLED | Купон отключен. | |
9 | ERR_COUPON_USED | Купон выключен. | |
10 | ERR_COUPON_INN | Некорректный ИНН для применяемого купона. | |
11 | ERR_COUPON_QUOTA | Превышена квота по купонам. | |
12 | ERR_DIFFERENT_COMPANIES | В визард переданы ККТ из разных компаний. |
Формат сообщения об ошибке
Если во время выполнения запроса произошла ошибка, API отвечает одним из кодов (таблица кодов приведена выше) и возвращает информацию об ошибке в теле ответа:
{
"description": "{Описание ошибки}",
"message": "{Сообщение}",
"code": {Код ошибки}
}
Ошибки от системы электронного документооборота
Описание ошибок от системы электронного документооборота (ЭДО), которые возвращаются в запросах регистрации и перерегистрации ККТ в ФНС.
Электронный документооборот. Представляет собой юридически значимый обмен электронными документами, подписанными КЭП.
Параметры:
Код | Сообщение | Описание |
---|---|---|
1 | IRUD error | Ошибка ИРУД (ошибка проверка подписей или ошибка регистрации пользователей в ИРУД). |
2 | Rejected to accept declaration | Заявление на регистрацию кассы не принято ЭДО. |
3 | Rejected to register | Заявление на регистрацию отклонено отделением ФНС. |
4 | Rejected to accept | Документ не принят ЭДО. |
5 | Wrong report | В ЭДО передан некорректный тип документа. |
6 | Wrong fiscal sign error | У отчета о регистрации указан невалидный фискальный признак. |
Информационный реестр участников документооборота. Позволяет проводить автоматическую регистрацию и актуализацию регистрационных данных участников информационной системы ФНС России.