5. Онлайн остаток

У клиентов есть возможность получить остатки по счетам в режиме реального времени в двух форматах:

  • Базовый остаток

  • Расширенный остаток

Базовый остаток
  • Доступный баланс - Реальная сумма, доступная по счету

  • Зарезервированный баланс - зарезервированная сумма по счету

Расширенный остаток
  • Входящий баланс (Входящее сальдо) - остаток по счёту на начало текущего дня

  • Исходящий баланс (Исходящее сальдо) - рассчитывается как арифметическая сумма входящего сальдо и оборотов за текущий день

  • Доступный баланс - Реальная сумма, доступная по счету

  • Зарезервированный баланс - зарезервированная сумма по счету

Обратите внимание!

Сформированный онлайн остаток приходит в ответ на POST-запрос в синхронном режиме.

Запрос

URI

HTTP POST: /API/v1/ISO20022/Statements/AccountBalance - базовый остаток

HTTP POST: /API/v1/ISO20022/Statements/AccountBalanceExtended - расширенный остаток

XML схема

camt.060.001.03

Описание схемы

Описание Путь Комментарий
Пример

Общий путь Document.AcctRptgReq

1

Уникальный ID сообщения

GrpHdr.MsgId

2

Дата и время создания сообщения

GrpHdr.CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

Уникальный ID пакета с запросом

RptgReq.Id

4

Признак "Получить данные по типу "Выписка"

RptgReq.ReqdMsgNmId

5

Номер счета

RptgReq.Acct.Id.Othr.Id

6

Наименование организации

RptgReq.AcctOwnr.Pty.Nm

Пример запроса онлайн остатка
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    <AcctRptgReq>
        <GrpHdr>
            <MsgId>H2H_TEST_STMT_112368042870656700001</MsgId>
            <CreDtTm>2022-05-24T10:00:18</CreDtTm>
        </GrpHdr>
        <RptgReq>
            <Id>H2H_TEST_STMT_112368042870656700001</Id>
            <ReqdMsgNmId>HMQSTASCF</ReqdMsgNmId>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
            </Acct>
            <AcctOwnr>
                <Pty>
                    <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                </Pty>
            </AcctOwnr>
        </RptgReq>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </AcctRptgReq>
</Document>

Ответ

XSD схема

camt.052.001.05

Описание схемы

Описание Путь Комментарий
Пример

Общий путь Document.BkToCstmrAcctRpt

1

Уникальный ID сообщения

GrpHdr.MsgId

2

Дата и Время создания сообщения

GrpHdr.CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

Общий путь Document.BkToCstmrAcctRpt.Rpt

3

ID

Id

4

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

5

Номер счета

Acct.Id.Othr.Id

6

Буквенный код валюты счета

Acct.Ccy

7

Наименование владельца счета

Acct.Ownr.Nm

Наименование клиента (организации)

8

ИНН / КИО владельца счета

Acct.Ownr.Id.OrgId.Othr.Id

ИНН Клиента

9

ISO код типа данных для ИНН

Acct.Ownr.Id.OrgId.Othr.SchmeNm.Cd

Константа 'TXID'

Реквизиты обслуживающего банка

10

BIC банка, обслуживающего счет

Acct.Svcr.FinInstnId.BICFI

11

Обозначение российской расчетной системы

Acct.Svcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

Константа 'RUCBC'

12

БИК банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.ClrSysMmbId.MmbId

13

Наименование банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.Nm

Секция с информацией о балансах для Базового остатка

Описание Путь Комментарий
Пример

Доступный баланс

14

Тип баланса (доступный баланс)
(1 блок)

Bal[1].Tp.CdOrPrtry.Cd

Константа "ITAV"

15

Доступный баланс

Bal[1].Amt

16

Код валюты доступного баланса

Bal[1].Amt@Ccy

17

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].CdtDbtInd

18

Дата баланса

Bal[1].Dt.Dt

Зарезервированный баланс

19

Тип баланса (Зарезервированный баланс)
(2 блок)

Bal[2].Tp.CdOrPrtry.Cd

Константа "INFO"

20

Зарезервированный баланс

Bal[2].Amt

21

Код валюты зарезервированного баланса

Bal[2].Amt@Ccy

22

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].CdtDbtInd

23

Дата баланса

Bal[2].Dt.Dt

Секция с информацией о балансах для Расширенного остатка

Описание Путь Комментарий
Пример

Входящий баланс

24

Тип баланса (Входящий)
(1 блок)

Bal[1].Tp.CdOrPrtry.Cd

Константа "OPBD"

25

Входящий баланс

Bal[1].Amt@Ccy

26

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].CdtDbtInd

27

Дата формирования входящего баланса

Bal[1].Dt.Dt

28

Дата формирования входящего баланса в рублёвом эквиваленте

Bal[1].Avlbty.Dt.ActlDt

29

Входящий баланс в рублёвом эквиваленте

Bal[1].Avlbty.Amt

30

Код валюты входящего остатка в рублёвом эквиваленте

Bal[1].Avlbty.Amt@Ccy

31

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].Avlbty.CdtDbtInd

Исходящий баланс

32

Тип баланса (Исходящий)
(2 блок)

Bal[2].Tp.CdOrPrtry.Cd

Константа "CLBD"

33

Исходящий баланс

Bal[2].Amt

34

Код валюты исходящего баланса

Bal[2].Amt@Ccy

35

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].CdtDbtInd

36

Дата формирования исходящего баланса

Bal[2].Dt.Dt

37

Дата формирования исходящего баланса в рублёвом эквиваленте

Bal[2].Avlbty.Dt.ActlDt

38

Исходящий баланс в рублёвом эквиваленте

Bal[2].Avlbty.Amt

39

Код валюты исходящего баланса в рублёвом эквиваленте

Bal[2].Avlbty.Amt@Ccy

40

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].Avlbty.CdtDbtInd

Доступный баланс

41

Тип баланса (Доступный баланс)
(3 блок)

Bal[3].Tp.CdOrPrtry.Cd

Константа "ITAV"

42

Доступный баланс

Bal[3].Amt

43

Код валюты доступного баланса

Bal[3].Amt@Ccy

44

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[3].CdtDbtInd

45

Дата баланса

Bal[3].Dt.Dt

Зарезервированный баланс

46

Тип баланса (Зарезервированный баланс)
(4 блок)

Bal[4].Tp.CdOrPrtry.Cd

Константа "INFO"

47

Зарезервированный баланс

Bal[4].Amt

48

Код валюты зарезервированного баланса

Bal[4].Amt@Ccy

49

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[4].CdtDbtInd

50

Дата баланса

Bal[4].Dt.Dt

Пример сформированного Базового остатка
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.05">
    <BkToCstmrAcctRpt>
        <GrpHdr>
            <MsgId>37f79863e8424f1a92d0632fbd4a71b0</MsgId>
            <CreDtTm>2022-05-24T11:50:18.091+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>a83b805424404f0394fbf273807ac75a</Id>
            <CreDtTm>2022-05-24T11:50:18.377+03:00</CreDtTm>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
                <Ownr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Ownr>
                <Svcr>
                    <FinInstnId>
                        <BICFI>ALFARUMMXXX</BICFI>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                    </FinInstnId>
                </Svcr>
            </Acct>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITAV</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15996923005.30</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">1565224.78</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
        </Rpt>
    </BkToCstmrAcctRpt>
</Document>
Пример сформированного Расширенного остатка
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.05">
    <BkToCstmrAcctRpt>
        <GrpHdr>
            <MsgId>e4d6975f5c6e46fca732fb7597c46fc9</MsgId>
            <CreDtTm>2022-05-24T11:57:38.231+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>042100f056b84f8da5ddfcde0a54ccfb</Id>
            <CreDtTm>2022-05-24T11:57:38.341+03:00</CreDtTm>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
                <Ownr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Ownr>
                <Svcr>
                    <FinInstnId>
                        <BICFI>ALFARUMMXXX</BICFI>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                    </FinInstnId>
                </Svcr>
            </Acct>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>OPBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15998489805.08</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2022-05-24</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">15998489805.08</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>CLBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15998489019.08</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2022-05-24</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">15998489019.08</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITAV</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15996923005.30</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">1565224.78</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
        </Rpt>
    </BkToCstmrAcctRpt>
</Document>