Получение статуса зарплатной ведомости

Обновлено 18 апреля 2025

GET

/v1/payrolls/{externalId}/state

Запрос для получения статуса ранее отправленной зарплатной ведомости. Должен содержать токено доступа (access_token) пользователя в параметре Authorization заголовка и идентификатором документа (externalId) в path-параметре.

Для доступа к этому методу в параметре scope ссылки авторизации должно быть указано значение PAYROLL.

Запрос

Ответы

• 200
• 400
• 401
• 403
• 404
• 429
• 500
• 503

"Успешный код возврата"

bankStatus	Наименование статуса	Назначение кода состояния
Промежуточный/Продолжать опрашивать
ACCEPTED	Принят	Электронный документ принят на стороне Банка
ACCEPTED_BY_ABS	Принят АБС или Принят	Электронный документ был принят к обработке в АБС Банка
CARD2	Картотека 2 или Ожидает оплаты	АБС обнаружено, что на счете плательщика недостаточно средств для иcполнения документа
CREATED	Создан	Документ записан в БД, проверки не выполнялись
DELAYED	Приостановлен	Обработка электронного документа была приостановлена
DELIVERED	Доставлен	Запрос доставлен в ДБО и взят в обработку
FRAUDALLOW	Одобрен ФРОД	Проверка во ФРОДЕ прошла успешно, переход на «Принят»
FRAUDREVIEW	На проверке у специалиста Банка	Со стороны ФРОД-анализа получен статус документа «На проверке у специалиста Банка»
FRAUDSENT	Отправлен во ФРОД	Документ отправлен на проверку в АС Fraud-мониторинг
FRAUDSMS	Требуется подтверждение sms-паролем	Со стороны ФРОД-анализа получен статус документа «Требуется подтверждение sms-паролем»
PARTSIGNED	Частично подписан	ЭД подписан частью подписей, входящих в предусмотренный для данного документа комплект подписей
SENDING_TO_RZK	Отправляется в СБК	Электронный документ отправлен в СБК, но не получен квиток о доставке
SENT_TO_RZK	Отправлено в СБК
WAITING_FOR_RZK	Ожидание от СБК
SIGNED	Подписан	ЭД подписан предусмотренным для него комплектом подписей.
VALIDEDS	ЭП/АСП верна
TRIED	Проверен
PROCESSING	Согласование контролирующей организацией
CORRESPONDENT_APPROVE_WAITING	Ожидает подтверждения контрагента
EXPORTED	Выгружен
SIGNED_BANK	Подписан Банком
IMPORTED	Импортирован
TRANSIT	Транзитный
WAITING_FOR_ORDER	Ожидает распоряжения
WAITING_FOR_MIGRATION	Ожидает миграции
EXPORTING	Выгружается
Окончательный (Не успешный)/Прекратить опрос
TEMPLATE	Шаблон
INCONSISTENT_DATA	Нарушена целостность документа
UNABLE_TO_RECEIVE	Ошибка при приеме
FRAUDDENY	Отвергнут ФРОД	Документ отказан на основе проверки в АС Fraud-мониторинг, переходим в «Отвергнут банком»
CHECKERROR	Ошибка контроля	ЭД сформирован, но при сохранении не прошел проверку корректности заполнения полей и сохранен с имеющимися в нем ошибками
INVALIDEDS	ЭП/АСП не верна Подпись неверна	Проверка ЭП под ЭД на стороне Банка дала отрицательный результат
REFUSEDBYBANK	Отвергнут банком или Отклонен банком	Электронный документ отвергнут банком
REFUSEDBYABS	Отказан АБС	Электронный документ не прошел проверки в АБС
REQUISITEERROR	Ошибка реквизитов	В ЭД указаны ошибочные реквизиты
REFUSED_BY_RZK	Отказан контролирующей организацией	Электронный документ не прошел проверки контролирующей организацией
Окончательный (Успешный)/Прекратить опрос
IMPLEMENTED	Исполнен	Электронный документ исполнен Банком
PARTIMPLEMENTED	Частично исполнен

При запросе данных по самозанятому в ответе возвращаются два дополнительных атрибута:

• receiptStatus – статус регистрации чека в ФНС,
• receiptResult – ссылка на чек в ФНС.

Описание ошибок в параметрах receiptResult и receiptStatus

Код ошибки	Описание
IRB0540	Ошибка: Получателю необходимо создать чек самостоятельно. Описание: Полученный ИНН не был найден в ФНС либо не зарегистрирован. В ФНС нет данных по указанному ИНН. ИНН получателя не совпадают в АС Банка и ФНС. Что необходимо сделать: Получателю необходимо самостоятельно зарегистрировать полученный доход и прислать ссылку на чек. Для избежание повтора ошибки рекомендуй актуализировать свои данные в АС Банка или в ФНС.
IRB0541	Ошибка: Получателю необходимо создать чек самостоятельно. Описание: Для ИНН переданного в запросе, Сбербанк не подключен как партнер. Получатель не предоставил права доступа Сбербанку. Что необходимо сделать: * самостоятельно зарегистрировать полученный доход и прислать ссылку на чек; * во избежание повтора ошибки подключить сервис "Свое дело". При регистрации в сервисе автоматически ФЛ в ФНС приобретает статус Самозанятого и предоставляются права Сбербанку на регистрацию дохода.
IRB0542	Ошибка: Получателю необходимо создать чек самостоятельно. Описание: Для Сбербанка как партнера недостаточно прав на совершение операции. Получатель уже зарегистрирован в ФНС и в сервисе "Свое дело". НО, получатель предоставил права на регистрацию дохода другому Банку. Что необходимо сделать: * самостоятельно зарегистрировать полученный доход и прислать ссылку на чек; * во избежание повтора ошибки необходимо предоставить права Сбербанку в приложении «Мой налог» или на сайте ФНС.
IRB0543	Ошибка: Получателю необходимо создать чек самостоятельно. Описание: Не получилось найти клиента. Что необходимо сделать: * самостоятельно зарегистрировать полученный доход и прислать ссылку на чек; * обновить паспортные данные из Госуслуг в профиле или обратиться в любой офис банка с паспортом.
IRB0546	Ошибка: Не удалось получить чек. Описание: Неправильно указан ИНН клиента. Что необходимо сделать: Повторите формирование чека позднее. Если при многократной повторной отправке запроса на регистрацию дохода, не приходит итоговый (зарегистрирован/не зарегистрирован) статус, то получателю необходимо самостоятельно зарегистрировать полученный доход и прислать ссылку на чек.
IRB0547	Ошибка: Превышен годовой лимит. Описание: Получатель на текущий момент достиг лимита дохода в 2,4 млн рублей в год. Превышен допустимый порог суммы зачисления для самозанятого. Что необходимо сделать: Получатель не сможет зарегистрировать доход и получить чек. Ему необходимо сняться с учета в качестве самозанятого в ФНС. Чтобы продолжить работу, получатель имеет возможность стать ИП или подобрать налоговый режим с помощью Сбербанка.
IRB0548	Ошибка: Превышен годовой лимит. Описание: При попытке регистрации чека будет превышен лимит дохода получателя в 2,4 млн рублей за год. Что необходимо сделать: Создание чека превысит лимит. В 2023/2024 году получатель зарегистрировал доход самозанятого на сумму более 2,4 млн ₽ в год. Чтобы продолжить работу, получатель имеет возможность стать ИП и подобрать налоговый режим с помощью Сбербанка.
IRB0549	Ошибка: Получателю необходимо создать чек самостоятельно. Описание: Ошибка валидации запроса. Фатальная техническая ошибка (ошибка-инцидент). Что необходимо сделать: Получателю необходимо самостоятельно зарегистрировать полученный доход и прислать ссылку на чек.

Ошибка в запросе или его жизненном цикле

Не авторизован

Запрещено

Не найдено

Превышен лимит запросов

Внутренняя ошибка сервера

Сервис временно недоступен

Loading...

Loading...