Request for bank statement
Clients have the opportunity to receive the requested statement in two formats:
Final Statement [camt.053.001.05]
Interim statement [camt.052.001.05]
To receive a statement in camt.052.001.05 format from the client’s side, when requesting a statement, it will be necessary to send a new optional header: stmt_format = 'camt052', if it is specified, the statement is generated in camt.052.
If the header was not transferred or transferred, but stmt_format is not equal to 'camt052', then the statement will be generated in camt.053. Clients need to control the hit of the current date in the request period by themselves in order to receive a statement in the required format.
[Important] It is necessary to understand that the statement in the camt.053.001.05 format will be non-final (some operations in the statement may disappear or new ones may appear), if the current date falls within the request period. For example, statement in this format requested for today will be final only on the morning of the next day.
URI
HTTP POST: /API/v1/ISO20022/Statements
XSD scheme
camt.060.001.03
Scheme description
Description | Link | Comment Example |
---|---|---|
Absolute path Document.AcctRptgReq |
||
Unique message ID |
GrpHdr.MsgId |
Statement request is made by virtue of identifier |
Date and time the message was created |
GrpHdr.CreDtTm |
Date format YYYY-MM-DDTHH:MM:SS 2018-11-27T17:13:45 |
Unique package ID with request |
RptgReq.Id |
Statement request for each account number is required in a separate package |
Get data by type Statement |
RptgReq.ReqdMsgNmId |
|
Account number |
RptgReq.Acct.Id.Othr.Id |
|
Period Start Date |
RptgReq.RptgPrd.FrToDt.FrDt |
|
Period End Date |
RptgReq.RptgPrd.FrToDt.ToDt |
|
Period Start Time |
RptgReq.RptgPrd.FrToTm.FrTm |
00:00:00 |
Period End Time |
RptgReq.RptgPrd.FrToTm.ToTm |
24:00:00 |
"Show all operations" |
RptgReq.RptgPrd.Tp |
Constant 'ALLL' |
Name of the company |
RptgReq.AcctOwnr.Pty.Nm |
ANSWER
HTTP code | Type | Body | Description |
---|---|---|---|
200 |
OK |
- |
Statement request was accepted without errors. |
401 |
Err |
Wrong username or password |
|
401 |
Err |
User was not found |
|
403 |
Err |
User is disabled |
|
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 |
|
400 |
Err |
FrDt/ToDt is in the future |
|
400 |
Err |
Date period is not specified |
|
400 |
Err |
FrDt is later than ToDt |
|
409 |
Err |
MsgId is not unique |
|
400 |
Err |
XML does not match schema |
Statement request example
<?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>77866e0f08374910bb1cc6f77a664727</MsgId>
<CreDtTm>2019-02-06T15:27:10</CreDtTm>
</GrpHdr>
<RptgReq>
<Id>2d60068df7644b8587ef440299ed53c6</Id>
<ReqdMsgNmId>HMQSTASCF</ReqdMsgNmId>
<Acct>
<Id>
<Othr>
<Id>40702810901300013000</Id>
</Othr>
</Id>
</Acct>
<AcctOwnr>
<Pty>
<Nm>ООО "Тест Альфа-Линк"</Nm>
</Pty>
</AcctOwnr>
<RptgPrd>
<FrToDt>
<FrDt>2019-02-06</FrDt>
<ToDt>2019-02-06</ToDt>
</FrToDt>
<FrToTm>
<FrTm>00:00:00</FrTm>
<ToTm>24:00:00</ToTm>
</FrToTm>
<Tp>ALLL</Tp>
</RptgPrd>
</RptgReq>
<SplmtryData>
<Envlp>
<SgntrSt>
<ds:Signature Id="sigID1" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<ds:SignedInfo>
<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
<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/2000/09/xmldsig#enveloped-signature"/>
<ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
</ds:Transforms>
<ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
<ds:DigestValue>Z2vwp/Mem4Zj5by4IYqLXI3XiEubfnvf7DGoKO3rxnc=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>ZfwVlNGJTw+ifvmIB4zZH+sRRCYPaarPODDx5fBREULABeoChQO3jSJl1GIRr7aa6TJiHvXqIIs3Y+kgNH3w+g==</ds:SignatureValue>
<ds:KeyInfo>
<ds:X509Data>
<ds:X509Certificate>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</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</ds:Signature>
</SgntrSt>
</Envlp>
</SplmtryData>
</AcctRptgReq>
</Document>