Сервис получения промежуточной выписки

Обновлено 12 октября 2022

C помощью данного API Клиент может настроить в ERP получение промежуточной (внутридневной) выписки в формате camt.052.001.08 ISO20022.

Используемые форматы перечислены здесь Форматы финансовых сообщений.

Описание бизнес-процесса

1. Клиент формирует запрос на получение промежуточной выписки;
2. ERP Клиента вызывает API для аутентификации и авторизации;
3. API Сбербанка проводит аутентификацию и авторизацию, возвращает Клиенту access token;
4. ERP Клиента вызывает API для передачи запроса на получение промежуточной выписки;
5. API проводит форматно-логический контроль запроса;
6. Модуль клиентских запросов проводит идентификацию Клиента SberConnect, сравнивает клиента, отправившего запрос на формирование, и клиента, запрашивающего промежуточную выписку;
7. Модуль клиентских запросов проводит валидацию запроса;
8. Модуль клиентских запросов выполняет поиск выписки по значению MsgId исходного запроса;
9. Модуль клиентских запросов направляет выписку Клиенту.

Описание атрибутов запроса

Параметры	Описание
X-IBM-Client-Id (header)	Уникальный идентификатор системы партнера, полученный при регистрации на Портале разработчика
Authorization (header)	Получение токена авторизации в методе Сервиc получения токена авторизации
RqUID (header)	Уникальный идентификатор сообщения, сгенерированный Клиентом в формате [0-9A-Fa-f]{32}. Чтобы гарантировать уникальность, требуется использовать стандартные библиотеки и классы генерации UUID (https://ru.wikipedia.org/wiki/UUID), убрав из результата символ разделителя «-». Если заголовок отсутствует в запросе, идентификатор будет сгенерирован автоматически и передан клиенту в аналогичном заголовке ответа
PageNumber (header)	Поле опциональное, указываются номера частей выписки. В случае, если часть выписки не указана в запросе, то в ответе Клиенту направляется только первая часть выписки
msgId (path)	Уникальный идентификатор запроса исходного сообщения (значение тега /Document/AcctRptgReq/GrpHdr/MsgId), которое передается в формате MX_camt_060_001_05_SB.xsd

Пример

Запрос на получение промежуточной выписки:

Тип запроса GET

GET https://api.sberbank.ru:8443/prod/sberconnect/v1/statements/periodic/2DCC86187E09066A9C1243C6B6AEDE59
 
Connection: keep-alive
RqUID: 898adf45a6cc4d2ca03c8b8354897aab
X-IBM-Client-Id: eeaa3778-46a4-4274-8d0a-08ad7cce1838
Authorization: Bearer 29453357-7ef1-45bc-b8ab-4f1944fd0b43
Content-Type: application/xml;charset=utf-8
Host: api.sberbank.ru:8443
User-Agent: Apache-HttpClient/4.5.10 (Java/1.8.0_161)

Ответ сервиса

HTTP/1.1 200
RqUID: 898adf45a6cc4d2ca03c8b8354897aab
Content-Type: application/xml;charset=UTF-8
Content-Length: 1218
Date: Fri, 20 Mar 2020 14:31:52 GMT
PageNumber: 1
TotalNbOfPgs: 8
 
 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.08" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <BkToCstmrAcctRpt>
        <GrpHdr>
            <MsgId>4d08e355576b4ccc99efa95461ba654c</MsgId>
            <CreDtTm>2020-05-07T06:13:39Z</CreDtTm>
            <MsgPgntn>
                <PgNb>5</PgNb>
                <LastPgInd>false</LastPgInd>
            </MsgPgntn>
            <OrgnlBizQry>
                <MsgId>2DCC86187E09066A9C1243C6B6AEDE59</MsgId>
            </OrgnlBizQry>
        </GrpHdr>
        <Rpt>
            <Id>4ba49b9177e2488298e4278f09be7884</Id>
            <CreDtTm>2020-05-07T06:13:39Z</CreDtTm>
            <FrToDt>
                <FrDtTm>2020-05-07T00:00:00</FrDtTm>
                <ToDtTm>2020-05-07T00:00:00</ToDtTm>
            </FrToDt>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40706810611122233904</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUB</Ccy>
                <Svcr>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525225</MmbId>
                        </ClrSysMmbId>
                        <Nm>ПАО СБЕРБАНК</Nm>
                    </FinInstnId>
                </Svcr>
            </Acct>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>OPBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUB">1198.83</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2020-05-07</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUB">1198.83</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2020-05-07</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>XPCD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUB">1195.83</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2020-05-07</Dt>
                </Dt>
            </Bal>
            <TxsSummry>
                <TtlCdtNtries>
                    <Sum>0.0</Sum>
                </TtlCdtNtries>
                <TtlDbtNtries>
                    <Sum>0.0</Sum>
                </TtlDbtNtries>
            </TxsSummry>
        </Rpt>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="1">
                        <ds:SignedInfo>
                            <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
                            <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
                            <ds:Reference URI="">
                                <ds:Transforms>
                                    <ds:Transform Algorithm="http://www.w3.org/2002/06/xmldsig-filter2">
                                        <dsig-xpath:XPath xmlns:dsig-xpath="http://www.w3.org/2002/06/xmldsig-filter2" Filter="subtract">/node()[name()='Document']/*/*[name()='SplmtryData']/descendant::node()[name()='SgntrSt']/ancestor::node()[name()='SplmtryData']</dsig-xpath:XPath>
                                    </ds:Transform>
                                    <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
                                </ds:Transforms>
                                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
                                <ds:DigestValue>onD9SavQ3e4V+cbN03vZG57GQUZX517RymPfZpQnGt4=</ds:DigestValue>
                            </ds:Reference>
                        </ds:SignedInfo>
                        <ds:SignatureValue>GAIm2/kyBemcArdR8cyyAcd/PobwAO0XCStmZqfi/0RlnZeFqbJ6a/rvFWCgRkZDJsQAL2dTa7pRBX/Kh2CbtQ==</ds:SignatureValue>
                        <ds:KeyInfo>
                            <ds:X509Data>
               <ds:X509Certificate>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</ds:X509Certificate>
                            </ds:X509Data>
                        </ds:KeyInfo>
                    </ds:Signature>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </BkToCstmrAcctRpt>
</Document>