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

Обновлено 2 июля 2026

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

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

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

Дайджест

Дайджест это текстовый документ, содержащий перечень и значения полей запроса, к которому он относится и предназначенный для подписания ЭП. Сохраняйте порядок и количество полей дайджеста, как показано в примере ниже, иначе подписать его не получится.

Наименование поля	Описание поля	Пример
account	Номер счета клиента	40702810600000001523
admissionValue	Вид зачисления (цифровое значение вида зачисления) из справочника видов зачисления SalType	01
amount.amount	Сумма по договору	1240687.00
amount.currencyName	Трехбуквенный код валюты	RUB
authPersonName	Имя уполномоченного сотрудника организации пользователя	Иванов Алексей Сергеевич
authPersonTelfax	Номер телефона, факса уполномоченного сотрудника организации пользователя	8(495)3612541
bic	БИК банка пользователя	044525225
contractDate	Дата договора	2018-02-20
contractNumber	Номер договора	456
date	Дата составления документа	2018-02-20
employeesNumber	Количество сотрудников	300
externalId	Идентификатор документа, присвоенный сервисом (UUID)	550e8400-e29b-41d4-a716-446655440000
incomeTypeCode	Код вида дохода получателей выплаты по 229-ФЗ	1
loanAmount	Сумма оплаты за счет кредитных средств	1000.00
loanDate	Дата кредитного договора	04.03.2019
loanNumber	Номер кредитного договора	155
month	Месяц отчетного периода	Январь
orgName	Наименование организации пользователя	ООО Ромашка
orgTaxNumber	ИНН пользователя	222201236445
year	Год отчетного периода	2018
TABLES
TABLES=employeeSalaries
account	Номер счета физического лица Счет физического лица (получателя зарплаты) не может быть открыт в стороннем банке. Подразделение Сбербанка определяется в СББОЛ по счету, а именно по цифрам из отмеченных разрядов хххххххххХХХХххххххх	40702810600000001673
amount.amount	Сумма	675988.00
amount.currencyName	Трехбуквенный код валюты	RUB
bic	БИК	040407777
firstName	Имя физического лица	Дмитрий
lastName	Фамилия физического лица	Петров
middleName	Отчество физического лица	Дмитриевич
withheldAmount	Сумма удержанных средств по исполнительному документу	1010.01
Не заполняется если в зарплатном договоре стоит признак «с резервированием»!
TABLES=payDocs
amount.amount	Сумма	675988.00
amount.currencyName	Трехбуквенный код валюты	RUB
docDate	Дата расчетного документа (по местному времени обслуживающего подразделения банка)	2018-02-20
number	Номер расчетного документа	388
payeeAccount	Номер счета получателя	40702810500006103990
payeeBic	БИК банка зачисления	044525225
payerAccount	Номер счета плательщика	40702810500006103990
payerBic	БИК банка плательщика	044525225
purpose	Назначение платежа	Зачисление зарплаты

Пример:

account=40702810078452334405
admissionValue=01
amount.amount=10000.55
amount.currencyName=RUB
authPersonName=Иванов Александр Сергеевич
authPersonTelfax=+7(812)1234567
bic=044525225
contractDate=2019-02-04
contractNumber=46096
date=2019-02-04
employeesNumber=2
externalId=b37fbdbc-d7a3-49c4-a191-be8e8b49ffba
incomeTypeCode=1
loanamount=1000.00
loandate=04.03.2019
loanNumber=155
month=Январь
orgName=Организация MuSAAIQKoXSVAFU
orgTaxNumber=4781796357
year=2019
TABLES
Table=EmployeeSalaries
account=42301810600000200001
amount.amount=5000.50
amount.currencyName=RUB
bic=040407777
firstName=Иван
lastName=Иванов
middleName=Иванович
withheldAmount=1010.01
#
account=42301810600000200002
amount.amount=5000.05
amount.currencyName=RUB
bic=040407777
firstName=Петр
lastName=Петров
middleName=Петрович
withheldAmount=1020.01
#

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

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

• Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (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"

Запрос

Ответы

Создан

Ошибка в запросе

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

Запрещено

В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization

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

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

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

Loading...