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

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

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

22

R

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

DrctDbtTxInf.DbtrAgt.FinInstnId.Othr.Id

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

23

O

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

DrctDbtTxInf.DbtrAgt.BrnchId.Id

24

R

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

DrctDbtTxInf.Dbtr.PstlAdr.Dept

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

25

R

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

DrctDbtTxInf.Dbtr.PstlAdr.SubDept

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

26

O

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

DrctDbtTxInf.Dbtr.PstlAdr.StrtNm

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

27

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>