23. Зарплатная ведомость
URI
POST: /API/v1/ISO20022/Payroll
XSD схема
pain.008.001.05
Описание схемы
№ | R/O | Описание | Путь | Комментарий/ Пример |
---|---|---|---|---|
Общий путь Document.CstmrDrctDbtInitn.GrpHdr |
||||
1 |
R |
Идентификатор сообщения |
MsgId |
|
2 |
R |
Дата документа |
CreDtTm |
Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (Обязательно указание часового пояса Москвы. В случае, если часовой пояс не указан, то время будет восприниматься по UTC). |
3 |
R |
Количество строк в ведомости |
NbOfTxs |
|
4 |
R |
Общая сумма строк ведомости |
CtrlSum |
|
5 |
R |
Краткое наименование для выбранной в ведомости организации |
InitgPty.Nm |
|
6 |
R |
ИНН выбранной в ведомости организации |
InitgPty.Id.OrgId.Othr[1].Id |
|
7 |
R |
Признак использования ИНН |
InitgPty.Id.OrgId.Othr[1].SchmeNm.Cd |
Константа TXID |
8 |
R |
Расчетный счет для выбранного в ведомости зарплатного проекта |
InitgPty.Id.OrgId.Othr[2].Id |
|
9 |
R |
Признак использования счёта |
InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd |
Костанта ACC |
Общий путь Document.CstmrDrctDbtInitn.PmtInf |
||||
10 |
R |
Идентификатор ведомости |
PmtInfId |
|
11 |
R |
Вид договора |
PmtMtd |
Поле обязательно по схеме (константа DD) |
12 |
R |
Номер реестра |
NbOfTxs |
Макс. длина 11 цифр |
13 |
R |
Дата формирования реестра |
ReqdColltnDt |
|
14 |
R |
Номер договора |
Cdtr.Nm |
|
15 |
R |
Вид зачисления |
CdtrAcct.Id.Othr.Id |
|
16 |
R |
БИК банка, указанного в зарплатном проекте |
CdtrAgt.FinInstnId.Nm |
|
17 |
R |
Номер строки в ведомости |
DrctDbtTxInf.PmtId.InstrId |
Макс. длина 7 цифр. Нумерация начинается с единицы должна идти строго по порядку (1,2,3…). |
18 |
R |
Идентификатор строки ведомости (внутр.) |
DrctDbtTxInf.PmtId.EndToEndId |
|
19 |
R |
Сумма к выплате сотруднику |
DrctDbtTxInf.InstdAmt |
|
20 |
R |
Цифровой код валюты |
DrctDbtTxInf.InstdAmt@Ccy |
На данный момент ведомости формируются только в рублях (код - 643) |
21 |
R |
Отделение банка зарплатного проекта |
DrctDbtTxInf.DbtrAgt.FinInstnId.Nm |
Список кодов отделений можно найти на странице https://alfabank.ru/sme/salaryproject/ |
22 |
R |
Филиал отделения банка зарплатного проекта |
DrctDbtTxInf.DbtrAgt.FinInstnId.Othr.Id |
Константа '0000'. Макс. длина 4 цифры |
23 |
R |
Фамилия сотрудника |
DrctDbtTxInf.Dbtr.PstlAdr.Dept |
Макс. длина 30 символов |
24 |
R |
Имя сотрудника |
DrctDbtTxInf.Dbtr.PstlAdr.SubDept |
Макс. длина 30 символов |
25 |
R |
Отчество сотрудника |
DrctDbtTxInf.Dbtr.PstlAdr.StrtNm |
Макс. длина 30 символов |
26 |
R |
Номер лицевого счета сотрудника |
DrctDbtTxInf.DbtrAcct.Id.Othr.Id |
Ответ
Ответом является XML-документ, соответствующий схеме pain.002.001.06.
Описание схемы: [ZP_STS]
Таблица кодов ответа:
HTTP код | Тип | Body | Описание |
---|---|---|---|
200 |
OK |
- |
Запрос принят без ошибок. |
401 |
Err |
Wrong username or password |
Неверный логин или пароль |
401 |
Err |
User was not found |
Пользователь не найден |
403 |
Err |
User is disabled |
Пользователь заблокирован |
401 |
Err |
Signer is not allowed to sign this operation type |
Пользователь не имеет право подписывать документы такого типа |
500 |
Err |
Warrant service error |
Сервис проверки доверенности не отвечает |
403 |
Err |
User does not have permission |
Нет прав на выполнение запроса |
406 |
Err |
Signature is missing |
Нет подписи |
403 |
Err |
Certificate is not valid |
Сертификат подписи невалидный |
403 |
Err |
Signer’s warrant is expired |
Доверенность подписанта истекла |
403 |
Err |
Signer’s warrant is disabled |
Доверенность подписанта заблокирована |
403 |
Err |
Number of signatures is not enough for this operation type |
Недостаточно подписей для типа операции |
403 |
Err |
Certificate is disabled |
Сертификат заблокирован |
403 |
Err |
The signer certificate is not valid (revoked or not active) |
Сертификат подписанта отозван или невалидный |
406 |
Err |
Signature value is not valid |
Подпись невалидна |
406 |
Err |
Internal sign check state error |
Внутренняя ошибка сервиса |
502 |
Err |
Bad Gateway |
Ошибочный шлюз |
503 |
Err |
Service Unavailable |
Сервис недоступен |
504 |
Err |
Gateway Timeout |
Шлюз не отвечает |
500 |
Err |
Internal Error |
Внутренняя ошибка приложения |
409 |
Err |
MsgId is not unique |
Id запроса неуникальный |
400 |
Err |
XML does not match schema |
Документ не соответствует схеме |
Пример Зарплатной ведомости
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.008.001.05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<CstmrDrctDbtInitn>
<GrpHdr>
<MsgId>7421w6f13a01983593e8dffb71fa6d15</MsgId> <!-- Идентификатор сообщения -->
<CreDtTm>2022-03-30T12:00:00+03:00</CreDtTm> <!-- Дата Формирования -->
<NbOfTxs>2</NbOfTxs>
<CtrlSum>200.00</CtrlSum>
<InitgPty>
<Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк ЗУП"</Nm> <!-- Наименование Организации -->
<Id>
<OrgId>
<Othr>
<Id>0664010623</Id> <!-- ИНН -->
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
<Othr>
<Id>40702810800000000111</Id> <!-- Расчетный Счет Организации -->
<SchmeNm>
<Cd>ACC</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</InitgPty>
</GrpHdr>
<PmtInf>
<PmtInfId>7421w6f13a01983593e8dffb71fa6d15</PmtInfId> <!-- Идентификатор ведомости -->
<PmtMtd>DD</PmtMtd> <!-- Константа -->
<NbOfTxs>1</NbOfTxs> <!-- Номер Реестра -->
<ReqdColltnDt>2022-03-30</ReqdColltnDt> <!-- Дата Реестра -->
<Cdtr>
<Nm>00753Z</Nm> <!-- Номер Договора -->
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>01</Id> <!-- Вид Зачисления -->
</Othr>
</Id>
</CdtrAcct>
<CdtrAgt>
<FinInstnId>
<Nm>044525593</Nm> <!-- БИК -->
</FinInstnId>
</CdtrAgt>
<DrctDbtTxInf>
<PmtId>
<InstrId>1</InstrId> <!-- Номер строки ведомости -->
<EndToEndId>7421w6f13a01983593e8dffb71fa6d15</EndToEndId> <!-- Идентификатор строки ведомости -->
</PmtId>
<InstdAmt Ccy="RUB">100.00</InstdAmt> <!-- Код Валюты + Сумма -->
<DbtrAgt>
<FinInstnId>
<Nm>0000</Nm> <!-- Отделение Банка -->
<Othr>
<Id>0000</Id> <!-- Филиал Отделения Банка -->
</Othr>
</FinInstnId>
</DbtrAgt>
<Dbtr>
<PstlAdr>
<!-- Фамилия сотрудника -->
<Dept>Матросова</Dept>
<!-- Имя сотрудника -->
<SubDept>Алина</SubDept>
<!-- Отчество сотрудника -->
<StrtNm>Николаевна</StrtNm>
</PstlAdr>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40817810904980000006</Id> <!-- Лицевой Счет -->
</Othr>
</Id>
</DbtrAcct>
</DrctDbtTxInf>
<DrctDbtTxInf>
<PmtId>
<InstrId>2</InstrId> <!-- Номер строки ведомости -->
<EndToEndId>7421w6f13a01983593e8dffb71fa6d16</EndToEndId> <!-- Идентификатор строки ведомости -->
</PmtId>
<InstdAmt Ccy="RUB">100.00</InstdAmt> <!-- Код Валюты + Сумма -->
<DbtrAgt>
<FinInstnId>
<Nm>0000</Nm> <!-- Отделение Банка -->
<Othr>
<Id>0000</Id> <!-- Филиал Отделения Банка -->
</Othr>
</FinInstnId>
</DbtrAgt>
<Dbtr>
<PstlAdr>
<!-- Фамилия сотрудника -->
<Dept>ПечкинПечкин</Dept>
<!-- Имя сотрудника -->
<SubDept>ЕвгенийЕвгений</SubDept>
<!-- Отчество сотрудника -->
<StrtNm>АлексеевичАлексеевич</StrtNm>
</PstlAdr>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40817810504980000011</Id> <!-- Лицевой Счет -->
</Othr>
</Id>
</DbtrAcct>
</DrctDbtTxInf>
</PmtInf>
<SplmtryData>
<Envlp>
<SgntrSt></SgntrSt>
</Envlp>
</SplmtryData>
</CstmrDrctDbtInitn>
</Document>