25. Зарплатная ведомость

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

O

Расчетный счет для выбранного в ведомости зарплатного проекта

InitgPty.Id.OrgId.Othr[2].Id

-

9

O

Признак использования счёта

InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа "ACC"

10

O

Если у клиента нет расчетного счета, то вместо счета должно передаваться значение "Идентификатор Клиента в Банке"

InitgPty.Id.OrgId.Othr[2].Id

-

11

O

Признак использования "Идентификатор Клиента в Банке"

InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа "BOID"

Общий путь Document.CstmrDrctDbtInitn.PmtInf

12

R

Идентификатор ведомости

PmtInfId

-

13

R

Вид договора

PmtMtd

Поле обязательно по схеме (Константа 'DD')

14

R

Номер реестра

NbOfTxs

Макс. длина 11 цифр

15

R

Дата формирования реестра

ReqdColltnDt

-

16

R

Номер договора по зарплатному проекту (Сведения о договоре в АЗОН)

Cdtr.Nm

-

17

R

Вид зачисления

CdtrAcct.Id.Othr.Id

Актуальный справочник см. на странице https://alfabank.ru/sme/salaryproject/ →"Полезно знать"→"Управление зарплатным проектом"→"Начисление денежных средств"→"Перечень соответствия оснований начислений в рамках зарплатного проекта кодам вида дохода (КВД) и кодам вида валютных операций (КВО)…​"

18

R

БИК банка, указанного в зарплатном проекте

CdtrAgt.FinInstnId.Nm

-

19

R

Номер строки в ведомости

DrctDbtTxInf.PmtId.InstrId

Макс. длина 7 цифр. Нумерация начинается с единицы должна идти строго по порядку (1,2,3…​).

20

R

Идентификатор строки ведомости (внутр.)

DrctDbtTxInf.PmtId.EndToEndId

-

21

R

Сумма к выплате сотруднику

DrctDbtTxInf.InstdAmt

-

22

R

Цифровой код валюты

DrctDbtTxInf.InstdAmt@Ccy

На данный момент ведомости формируются только в рублях (код - 643)

23

R

Отделение банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.FinInstnId.Nm

Возможно указание константы '0000'.
Список кодов отделений можно найти на странице https://alfabank.ru/sme/salaryproject/
Раздел "Полезно знать", вкладка "Управление зарплатным проектом", подраздел "Открытие счетов и выпуск зарплатных карт для сотрудников резидентов РФ", п.5 "Справочник отделений"
Скачать XLS файл, в нём таблица "Отделение доставки карты", столбец - "Цифровой код"
XLS файл периодически обновляется, рекомендуется проверять обновления раз в полгода
Макс. длина 4 цифры

24

R

Филиал отделения банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.FinInstnId.Othr.Id

Константа '0000'. Макс. длина 4 цифры

25

O

БИК банка, в котором открыт счёт, в случае, если он отличается от банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.BrnchId.Id

-

26

R

Фамилия сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.Dept

Макс. длина 30 символов

27

R

Имя сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.SubDept

Макс. длина 30 символов

28

0

Отчество сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.StrtNm

Макс. длина 30 символов

29

R

Номер лицевого счета сотрудника

DrctDbtTxInf.DbtrAcct.Id.Othr.Id

-

30

0

Сумма удержания (взыскания)

DrctDbtTxInf.Tax.TtlTaxAmt@Ccy

-

Блок с подписью Document.CstmrDrctDbtInitn

31

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

Описание схемы: [ZP_STS]

Таблица кодов ответа

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

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

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает

Пример Зарплатной ведомости
<?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>2024-03-15T12: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>40702810400000002221</Id> <!-- Расчетный Счет Организации -->
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>7421w6f13a01983593e8dffb71fa6d15</PmtInfId> <!-- Идентификатор ведомости -->
            <PmtMtd>DD</PmtMtd> <!-- Константа -->
            <NbOfTxs>1</NbOfTxs> <!-- Номер Реестра -->
            <ReqdColltnDt>2024-03-15</ReqdColltnDt> <!-- Дата Реестра -->
            <Cdtr>
                <Nm>00IDLM</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>40817810904050000004</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>40817810204050000005</Id> <!-- Лицевой Счет -->
                        </Othr>
                    </Id>
                </DbtrAcct>
                <Tax>
                    <TtlTaxAmt Ccy="RUB">23.00</TtlTaxAmt> <!-- Сумма удержания (Взыскания) -->
                </Tax>
            </DrctDbtTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt></SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrDrctDbtInitn>
</Document>