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

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

Обновлено 24 марта 2026

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

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

Описание ошибок по самозанятым

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

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

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

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

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

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

При получении зарплатной ведомости в песочнице, ответ зависит от переданного параметра externalId.

Сценарии тестирования

1. Для получения зарплатного реестра с указанием рублевого платежного поручения (по договору без резервирования) используйте параметр externalId со значение 20251028-12e1-476e-bfee-f2112e4573a8.


2. Для получения зарплатного реестра с выплатой в другой банк используйте параметр externalId со значение 20251028-13e1-476e-bfee-f2112e4573a8.


3. Для получения зарплатного реестра с выплатой за счет кредитных средств используйте параметр externalId со значение 20251028-14e1-476e-bfee-f2112e4573a8.


4. Для получения зарплатного реестра с выплатой самозанятым используйте параметр externalId со значение 20251028-15e1-476e-bfee-f2112e4573a8.


5 Для получения иных статусов используйте следующие тестовые идентификаторы:

Передаваемое значение externalIdВозвращаемое значение bankStatus
20241028-14e1-476e-bfee-f2112e4573a8ACCEPTED_BY_ABS
20251028-03e1-476e-bfee-f2112e4573a8CHECKERROR
20241028-01e1-476e-bfee-f2112e4573a8DELIVERED
20241028-12e1-476e-bfee-f2112e4573a8DELIVERED
20241028-02e1-476e-bfee-f2112e4573a8IMPLEMENTED
20241028-13e1-476e-bfee-f2112e4573a8IMPLEMENTED
20231028-04e1-476e-bfee-f2112e4573a8PARTIMPLEMENTED
20241028-15e1-476e-bfee-f2112e4573a8PARTIMPLEMENTED
20211028-06e1-476e-bfee-f2112e4573a8INVALIDEDS
20221028-05e1-476e-bfee-f2112e4573a8REQUISITEERROR
20241028-08e1-476e-bfee-f2112e4573a8WORKFLOW_FAULT
20241028-09e1-476e-bfee-f2112e4573a8WORKFLOW_FAULT
20191028-10e1-476e-bfee-f2112e4573a8ACTION_ACCESS_EXCEPTION
20191028-07e1-476e-bfee-f2112e4573a8DATA_NOT_FOUND_EXCEPTION
20241028-11e1-476e-bfee-f2112e4573a8TOO_MANY_REQUESTS
20241028-11e1-476e-bfee-f2112e4573a8UNAVAILABLE_RESOURCE_EXCEPTION
Любое другое валидное значениеCREATED

Запрос

Ответы

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

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