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

Создание зарплатной ведомости

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

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

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

Если в запросе на создание платежного документа передать ЭП к документу (объект digestSignatures), то Банк сразу начнет его обработку. Если в запросе не передавать ЭП к документу, то документ будет создан в статусе черновик. Для начала его обработки Банком потребуется зайти в интерфейс СберБизнес и подписать его.

Рекомендации по тестированию в песочнице

При тестировании создания исходящего платежного требования в Песочнице соблюдайте правила:

  • Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (certificateUuid).
  • Все остальные поля запроса заполняйте произвольными данными (реквизиты, суммы) в соответствии с требованиями в документации.

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

Для тестирования сценариев используйте фиксированные значения certificateUuid. При использовании любых других значений certificateUuid вернется ошибка UNKNOWN_EXCEPTION.


1. Чтобы создать неподписанный черновик зарплатной ведомости, отправьте запрос без объекта digestSignatures.

Статус в ответе: bankStatus: "CREATED"


2. Для отправки документа с единственной или двумя подписями передайте в объекте digestSignatures тестовые certificateUuid.

Параметры:

  • bb014b5d-8159-40be-97c1-eafeed4a8c3d (единственная подпись)
  • d5d4f811-f4d4-4205-a70f-58f772eeab72 (первая подпись)
  • 4f29c8ef-b55d-43c7-a321-f2b1303a29cd (вторая подпись)

Статус в ответе: bankStatus: "DELIVERED"

Пример:

#Единственная подпись
"digestSignatures": [
\{
"certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c3d",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\}
],


#Первая и вторая подпись
"digestSignatures": [
\{
"certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\},
\{
"certificateUuid": "4f29c8ef-b55d-43c7-a321-f2b1303a29cd",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\}
],

3. Для создания документа с ошибкой используете параметр number со значением 111111111.

Статус в ответе: bankStatus: "CHECKERROR"


4. Для получения ошибки «Документ уже существует» используйте параметр externalId со значением 20251028-12e1-476e-bfee-f2112e4573a8.

Статус в ответе: bankStatus: "WORKFLOW_FAULT"

Запрос

Ответы

Создан

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