ym88659208ym87991671
Получение статуса зарплатной ведомости | Документация для разработчиков

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

Обновлено 18 марта 2025
GET
/v1/payrolls/{externalId}/state

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

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

Запрос

Path Parameters

    externalId
    string
    required

    Внешний UUID зарплатной ведомости

    Example: 22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6

Header Parameters

    Authorization
    string
    required

    Access token организации-клиента, полученный через SSO

    Example: f8ad3141-b7e8-4924-92de-3de4fd0a464e-1

Ответы

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

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

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

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

Код ошибкиОписание
IRB0540Ошибка:
Получателю необходимо создать чек самостоятельно.
Описание:
Полученный ИНН не был найден в ФНС либо не зарегистрирован. В ФНС нет данных по указанному ИНН. ИНН получателя не совпадают в АС Банка и ФНС.
Что необходимо сделать:
Получателю необходимо самостоятельно зарегистрировать полученный доход и прислать ссылку на чек. Для избежание повтора ошибки рекомендуй актуализировать свои данные в АС Банка или в ФНС.
IRB0541Ошибка:
Получателю необходимо создать чек самостоятельно.
Описание:
Для ИНН переданного в запросе, Сбербанк не подключен как партнер. Получатель не предоставил права доступа Сбербанку.
Что необходимо сделать:
* самостоятельно зарегистрировать полученный доход и прислать ссылку на чек;
* во избежание повтора ошибки подключить сервис "Свое дело".

При регистрации в сервисе автоматически ФЛ в ФНС приобретает статус Самозанятого и предоставляются права Сбербанку на регистрацию дохода.
IRB0542Ошибка:
Получателю необходимо создать чек самостоятельно.
Описание:
Для Сбербанка как партнера недостаточно прав на совершение операции. Получатель уже зарегистрирован в ФНС и в сервисе "Свое дело". НО, получатель предоставил права на регистрацию дохода другому Банку.
Что необходимо сделать:
* самостоятельно зарегистрировать полученный доход и прислать ссылку на чек;
* во избежание повтора ошибки необходимо предоставить права Сбербанку в приложении «Мой налог» или на сайте ФНС.
IRB0543Ошибка:
Получателю необходимо создать чек самостоятельно.
Описание:
Не получилось найти клиента.
Что необходимо сделать:
* самостоятельно зарегистрировать полученный доход и прислать ссылку на чек;
* обновить паспортные данные из Госуслуг в профиле или обратиться в любой офис банка с паспортом.
IRB0546Ошибка:
Не удалось получить чек.
Описание:
Неправильно указан ИНН клиента.
Что необходимо сделать:
Повторите формирование чека позднее.

Если при многократной повторной отправке запроса на регистрацию дохода, не приходит итоговый (зарегистрирован/не зарегистрирован) статус, то получателю необходимо самостоятельно зарегистрировать полученный доход и прислать ссылку на чек.
IRB0547Ошибка:
Превышен годовой лимит.
Описание:
Получатель на текущий момент достиг лимита дохода в 2,4 млн рублей в год.
Превышен допустимый порог суммы зачисления для самозанятого.
Что необходимо сделать:
Получатель не сможет зарегистрировать доход и получить чек. Ему необходимо сняться с учета в качестве самозанятого в ФНС.
Чтобы продолжить работу, получатель имеет возможность стать ИП или подобрать налоговый режим с помощью Сбербанка.
IRB0548Ошибка:
Превышен годовой лимит.
Описание:
При попытке регистрации чека будет превышен лимит дохода получателя в 2,4 млн рублей за год.
Что необходимо сделать:
Создание чека превысит лимит. В 2023/2024 году получатель зарегистрировал доход самозанятого на сумму более 2,4 млн ₽ в год. Чтобы продолжить работу, получатель имеет возможность стать ИП и подобрать налоговый режим с помощью Сбербанка.
IRB0549Ошибка:
Получателю необходимо создать чек самостоятельно.
Описание:
Ошибка валидации запроса. Фатальная техническая ошибка (ошибка-инцидент).
Что необходимо сделать:
Получателю необходимо самостоятельно зарегистрировать полученный доход и прислать ссылку на чек.

Schema

    bankComment
    string

    Банковский комментарий к статусу документа

    bankStatus
    string

    Статус документа

    receiptStatus
    string

    Статус процесса обработки регистрации самозанятых в ФНС

Loading...
Loading...
Это полезный материал?
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.