Introduction
The document describes the rules an electornic document management system for corporations and banks. That is necessary for making payments, currency conversion, currency control functions and providing banks with reports to corporations related to the above services and products based on the international standard ISO 20022.
Request for bank statement
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 |
|
401 |
Err |
User is disabled |
|
401 |
Err |
Warrant is expired |
|
401 |
Err |
Warrant was not found |
|
401 |
Err |
Warrant service error |
|
406 |
Err |
User does not have permission |
|
406 |
Err |
Signature is missing |
|
406 |
Err |
Certificate is not valid |
|
406 |
Err |
Signature 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 |
|
400 |
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>
<ds:SignedInfo>
<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#" />
<ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102001-gostr3411" />
<ds:Reference URI="">
<ds:Transforms>
<ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
</ds:Transforms>
<ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr3411" />
<ds:DigestValue>Mv8l/zkKhXIgc+NYS5AahbSAxcR4fITrtwi72Wsid8k=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>cUvrSEG06N8434QLqap1JjCFks2p+zYFrmi6KDduU8aJL3dShmoBKqUlloU+9lOu
29r9/DTaeaJtiWhkihEsSw==</ds:SignatureValue>
<ds:KeyInfo>
<ds:X509Data>
<ds:X509Certificate>MIIDbjCCAx2gAwIBAgITEgAvPdF2qLVO81iKLwAAAC890TAIBgYqhQMCAgMwfzEj
MCEGCSqGSIb3DQEJARYUc3VwcG9ydEBjcnlwdG9wcm8ucnUxCzAJBgNVBAYTAlJV
MQ8wDQYDVQQHEwZNb3Njb3cxFzAVBgNVBAoTDkNSWVBUTy1QUk8gTExDMSEwHwYD
VQQDExhDUllQVE8tUFJPIFRlc3QgQ2VudGVyIDIwHhcNMTgxMTE1MDk0NDE2WhcN
MTkwMjE1MDk1NDE2WjB9MRswGQYJKoZIhvcNAQkBFgxtYWlsQG1haWwucnUxFDAS
BgNVBAMMC0VWUkFaUkVHL1RUMQ0wCwYDVQQLDARkZXB0MQwwCgYDVQQKDANOUkQx
DTALBgNVBAcMBGNpdHkxDzANBgNVBAgMBnJlZ2lvbjELMAkGA1UEBhMCUlUwYzAc
BgYqhQMCAhMwEgYHKoUDAgIkAAYHKoUDAgIeAQNDAARAjuTSuHIiQAL4J0GYGowk
NHjHM95GScbUpd5cuD0MU7qJDj8BpP95dD9dbc5chWq/+AUoVh2mvIRwqp3wqG
wqOCAXAwggFsMA4GA1UdDwEB/wQEAwIE8DATBgNVHSUEDDAKBggrBgEFBQcDAjAd
BgNVHQ4EFgQU9C6wJ7PrpufrQalBt7nMe1PQeuIwHwYDVR0jBBgwFoAUFTF8sI0a
3mbXFZxJUpcXJLkBeoMwWQYDVR0fBFIwUDBOoEygSoZIaHR0cDovL3Rlc3RjYS5j
cnlwdG9wcm8ucnUvQ2VydEVucm9sbC9DUllQVE8tUFJPJTIwVGVzdCUyMENlbnRl
ciUyMDIuY3JsMIGpBggrBgEFBQcBAQSBnDCBmTBhBggrBgEFBQcwAoZVaHR0cDov
L3Rlc3RjYS5jcnlwdG9wcm8ucnUvQ2VydEVucm9sbC90ZXN0LWNhLTIwMTRfQ1JZ
UFRPLVBSTyUyMFRlc3QlMjBDZW50ZXIlMjAyLmNydDA0BggrBgEFBQcwAYYoaHR0
cDovL3Rlc3RjYS5jcnlwdG9wcm8ucnUvb2NzcC9vY3NwLnNyZjAIBgYqhQMCAgMD
QQBhwelOmwMKApnFmrtTiegDOv3wF4imE+k193xizjiO8MI1+JG32WI4ZUF1wXUL
mFk/7avO4MNBzZAt8NxB/nmW</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</ds:Signature>
</SgntrSt>
</Envlp>
</SplmtryData>
</AcctRptgReq>
</Document>
Receiving a statement
Clients have the opportunity to request a 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, the client will need to send a new optional header: intraday_stmt_format = 'camt052', if it is specified, the statement is generated in camt.052.
If the header was not transferred or transferred, but intraday_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
GET: /API/v1/ISO20022/Statements/<MsgId>
XSD scheme
camt.053.001.05, camt.052.001.05
Scheme description
Description | Link |
---|---|
Common path Document.BkToCstmrStmt.GrpHdr [camt.053] / Document.BkToCstmrAcctRpt.GrpHdr [camt.052] |
|
Unique message ID |
MsgId |
Date and Time the message was created |
MsgIdCreDtTm |
Name of the Recipient |
MsgRcpt.Nm |
TIN of the recipient of the statement |
MsgRcpt.Id.OrgId.Othr.Id |
Page Number (pagination) |
MsgPgntn.PgNb |
Last page indicator |
MsgPgntn.LastPgInd |
Description | Link | Comment Example |
---|---|---|
Common path Document.BkToCstmrStmt.Stmt [camt.053] / Document.BkToCstmrAcctRpt.Rpt [camt.052] |
||
Bank statement ID |
Id |
|
Date and time of the statement generation |
CreDtTm |
|
Period Start Date |
FrToDt.FrDtTm |
|
End date |
FrToDt.ToDtTm |
|
Account number |
Acct.Id.Othr.Id |
20 characters |
Name of the account holder |
Acct.Ownr.Nm |
Name of the client (organization) |
TIN of the account holder |
Acct.Ownr.Id.OrgId.Othr.Id |
TIN of the Client |
ISO data type code for TIN |
Acct.Ownr.Id.OrgId.Othr.SchmeNm.Cd |
Constant 'TXID' |
Bank details |
||
BIC of the bank serving the account |
Acct.Svcr.FinInstnId.BICFI |
Set SWIFTs for currency documents. Information on BICs, see "BIC Bank / branch serving the account". |
Designation of the Russian settlement system |
Acct.Svcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd |
Constant 'RUCBC' |
BIC of the bank / branch serving the account |
Acct.Svcr.FinInstnId.ClrSysMmbId.MmbId |
|
Name of the bank / branch serving the account |
Acct.Svcr.FinInstnId.Nm |
|
Address of the bank / branch serving the account |
Acct.Svcr.FinInstnId.PstlAdr.AdrLine |
|
TIN of the bank / branch serving the account |
Acct.Svcr.FinInstnId.Othr.Id |
|
Balance Information |
||
Balance Type (Incoming) (1 block) |
Bal.Tp.CdOrPrtry.Cd |
Constant "OPBD" |
Incoming balance (account currency) |
Bal.Amt@Ccy |
|
Credit indicator ('CRDT') |
Bal.CdtDbtInd |
Constant "CRDT" |
Balance date |
Bal.Dt.Dt |
|
Balance Type (Outgoing) (2 block) |
Bal.Tp.CdOrPrtry.Cd |
Constant "CLBD" |
Outgoing balance (account currency) |
Bal.Amt@Ccy |
|
Debit Indicator ('DBIT') |
Bal.CdtDbtInd |
Constant DBIT |
Balance date |
Bal.Dt.Dt |
|
Credit Turnovers |
TxsSummry.TtlCdtNtries.Sum |
|
Debit Turnovers |
TxsSummry.TtlDbtNtries.Sum |
Currency transfer / payment order
Description | Path | Comment/Example | ||
---|---|---|---|---|
Generic Path Document.BkToCstmrStmt.Stmt.Ntry [camt.053] / Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052] |
||||
1 |
R |
Transaction amount |
Amt@Ccy |
<AmtCcy = "USD">1500.00<.Amt> |
2 |
R |
Transaction currency |
Amt @Ccy |
<AmtCcy= "USD">1500.00<.Amt> |
3 |
R |
Indicator: |
CdtDbtInd |
|
4 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
5 |
R |
Date of operation |
BookgDt.Dt |
|
6 |
O |
Value date |
ValDt.Dt |
|
7 |
R |
Transaction code |
BkTxCd.Domn.Cd |
See table of correspondence of the type of operation |
8 |
R |
Transaction typen |
BkTxCd.Domn.Fmly.Cd |
See table of correspondence of the type of operation |
9 |
O |
Transaction subtype |
BkTxCd.Domn.Fmly.SubFmlyCd |
See table of correspondence of the type of operation |
10 |
R |
Ruble equivalent of the amount to be paid |
AmtDtls.PrtryAmt.Amt@Ccy |
Ccy in this case is equal to RUR |
11 |
O |
Type description |
AmtDtls.PrtryAmt.Tp |
"Operation Amount in Rubles" |
12 |
O |
Debtor code |
AcctSvcrRef |
5 characters |
13 |
O |
Debtor code (extended) |
AddtlNtryInf |
8 characters |
Description | Path | Comment/Example | ||
---|---|---|---|---|
Public Path Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053] / Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052] |
||||
1 |
R |
Document number |
Refs. EndToEndId |
|
2 |
R |
Payer’s name |
RltdPties.Dbtr. Nm |
|
3 |
O |
Payer’s name * |
RltdPties.Dbtr.PstlAdr. AdrLine |
Filled in if the payer’s name is more than 140 characters |
4 |
O |
INN / KIO of the payer |
RltdPties.Dbtr.Id.OrgId.Othr. Id |
|
5 |
O |
ISO data type code for the payer’s TIN |
RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm. * Cd * |
Mandatory when specifying TIN |
6 |
R |
Payer’s account number |
RltdPties.DbtrAcct.Id.Othr. Id |
|
7 |
R |
Beneficiary name |
RltdPties.Cdtr. Nm |
|
8 |
O |
Beneficiary name * |
RltdPties.Cdtr.PstlAdr. AdrLine |
Characters 141 to 160 of the beneficiary name. To be filled in if the recipient’s name is more than 140 characters |
9 |
O |
Recipient name * |
RltdPties.Cdtr.CtctDtls. Nm |
Characters from 141 to 160 of recipient name (duplicates RltdPties.Cdtr.PstlAdr. AdrLine ). |
10 |
O |
TIN / KIO of the recipient |
RltdPties.Cdtr.Id.OrgId.Othr. Id |
|
11 |
O |
ISO data type code for the recipient’s TIN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm. Cd |
Mandatory when specifying TIN |
12 |
R |
Beneficiary account number |
RltdPties.CdtrAcct.Id.Othr. Id |
|
13 |
O |
SWIFT of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId. BICFI |
|
14 |
O |
ISO code of data type for bank BIC |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.ClrSysId. * Cd * |
|
15 |
O |
BIC of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId. * MmbId * |
|
16 |
O |
Corresponding account of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Othr. * Id * |
|
17 |
O |
Payer’s bank clearing code |
RltdAgts.DbtrAgt.FinInstnId.Othr. * Issr * |
|
18 |
O |
Name of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId. Nm |
|
19 |
O |
Name of the payer’s bank * |
RltdAgts.DbtrAgt.FinInstnId.PstlAdr. AdrLine |
Filled in if the name of the payer’s bank is more than 140 characters |
20 |
O |
Beneficiary’s bank SWIFT |
RltdAgts.CdtrAgt.FinInstnId. BICFI |
|
21 |
О |
ISO code of data type for bank BIC |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId. Cd |
|
22 |
О |
BIC of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId. * MmbId * |
|
23 |
О |
Beneficiary bank clearing code |
RltdAgts.CdtrAgt.FinInstnId.Othr. * Issr * |
|
24 |
О |
Beneficiary bank name |
RltdAgts.CdtrAgt.FinInstnId. Nm |
|
25 |
O |
Beneficiary bank name * |
RltdAgts.CdtrAgt.FinInstnId.PstlAdr. AdrLine |
|
26 |
О |
Corresponding account of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.Othr. * Id * |
|
27 |
O |
Correspondent Bank SWIFT |
RltdAgts.IntrmyAgt1.FinInstnId. BICFI |
|
28 |
О |
Clearing code of the correspondent bank |
RltdAgts.IntrmyAgt1.FinInstnId.ClrSysMmbId.ClrSysId. Cd |
|
29 |
О |
Name of the correspondent bank |
RltdAgts.IntrmyAgt1.FinInstnId. Nm |
|
30 |
О |
Beneficiary’s bank account in correspondent bank |
RltdAgts.IntrmyAgt1.FinInstnId.Othr. Id |
|
31 |
R |
Purpose of payment, there can be more than one field |
RmtInf. Ustrd |
|
32 |
O |
Code |
RmtInf.Strd [1] .CdtrRefInf. * Ref * |
|
33 |
R |
Order of payment |
Purp. * Prtry * |
|
34 |
R |
Type of commission write-off |
Chrgs.Rcrd. Br |
|
35 |
O |
Commission write-off account |
Chrgs.Rcrd.Agt.FinInstnId.Othr. Id |
|
36 |
O |
Sender to recipient information |
RmtInf.Strd. AddtlRmtInf |
|
37 |
R |
Transaction amount |
Amt @ Ccy = "AAA" |
|
38 |
O |
Transit account enrollment notification number |
SplmtryData.Envlp.Notif. * Nuved * |
|
39 |
O |
Date of notification NUVED |
SplmtryData.Envlp.Notif. * Dtuv * |
Date in ISO format: YYYY-MM-DD. |
40 |
O |
End date of submission of documents |
SplmtryData.Envlp.Notif. * Dtcpd * |
Date in ISO format: YYYY-MM-DD. |
41 |
O |
Violation start date |
SplmtryData.Envlp.Notif. * Bviol * |
Date in ISO format: YYYY-MM-DD. |
42 |
O |
CP Document ID |
SplmtryData.Envlp. * NumSB * |
5+ |
To be filled in only for ruble payment orders |
43 |
O |
Payment code (110) |
Tax.Rcrd. * Tp * |
44 |
O |
Income type code (20) |
AmtDtls.PrtryAmt. * Tp * |
|
45 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
|
Filled in with a value of 0, if the Income type code (20) |
46 |
O |
Taxpayer status (101) |
Tax.Rcrd.DbtrSts |
47 |
O |
Payer’s checkpoint (102) |
Tax.Dbtr.TaxTp |
|
48 |
O |
Beneficiary’s checkpoint (103) |
Tax.Cdtr.TaxTp |
|
49 |
O |
KBK (104) |
Tax.Rcrd.CtgyDtls |
|
50 |
O |
OKTMO (105) |
Tax.AdmstnZn |
|
51 |
O |
Basis of tax payment (106) |
Tax.Rcrd.Ctgy |
|
52 |
O |
Year of tax period (107) |
Tax.Rcrd.Prd.Yr |
|
53 |
O |
Tax period type (107) |
Tax.Rcrd.Prd.Tp |
|
Can be one of the following values: |
54 |
O |
Date of tax period (107) |
Tax.Rcrd.Prd.FrToDt.FrDt |
55 |
O |
Date of tax period (107) |
Tax.Rcrd.Prd.FrToDt.ToDt |
|
Indicated to comply with the format. |
56 |
O |
Customs authority code (107) |
Tax.Cdtr.RegnId |
57 |
O |
Tax payment number (108) |
Tax.RefNb |
|
58 |
O |
Date of tax document (109) |
Tax.Dt, values "0" or "00" are specified in Tax.Mtd |
Payment request
Description | Path | Comment/ Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry |
||||
1 |
R |
Transaction amount |
Amt@ Ccy |
|
2 |
R |
Currency code |
Amt @Ccy |
|
3 |
R |
Debit / Credit |
CdtDbtInd |
"DBIT" / "CRDT" |
4 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
5 |
R |
Date of operation |
BookgDt.Dt |
|
6 |
O |
Decommissioned from the account. boards. |
ValDt.Dt |
|
7 |
R |
Transaction code |
BkTxCd.Domn.Cd |
see table of correspondence of the type of operation |
8 |
R |
Transaction type |
BkTxCd.Domn.Fmly.Cd |
see table of correspondence of the type of operation |
9 |
O |
Transaction subtype |
BkTxCd.Domn.Fmly.SubFmlyCd |
see operation type correspondence table |
10 |
O |
Ruble equivalent of the amount to be paid |
AmtDtls.PrtryAmt.Amt@Ccy |
Amt - sum |
11 |
O |
Type description |
AmtDtls.PrtryAmt.Tp |
"Operation Amount in Rubles" |
12 |
O |
Debtor code |
AcctSvcrRef |
5 characters |
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls |
||||
1 |
R |
PAYMENT CLAIM N (3) |
Refs.EndToEndId |
|
2 |
R |
Payer’s name |
RltdPties.Dbtr.Nm |
|
3 |
O |
Payer’s name* |
RltdPties.Dbtr.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
4 |
O |
INN / KIO of the payer |
RltdPties.Dbtr.Id.OrgId.Othr.Id |
|
5 |
O |
ISO data type code for the payer’s TIN |
RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying TIN. |
6 |
R |
Payer’s account number |
RltdPties.DbtrAcct.Id.Othr.Id |
|
7 |
O |
BIC of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
8 |
O |
Payer’s bank account |
RltdAgts.DbtrAgt.FinInstnId.Othr.Id |
|
9 |
O |
Payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Nm |
|
10 |
O |
Payer’s bank* |
RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
11 |
R |
Beneficiary name |
RltdPties.Cdtr.Nm |
|
12 |
O |
Name of the recipient* |
RltdPties.Cdtr.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
13 |
O |
TIN / KIO of the recipient |
RltdPties.Cdtr.Id.OrgId.Othr.Id |
|
14 |
O |
ISO data type code for the recipient’s INN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying the INN. |
15 |
R |
Beneficiary account number |
RltdPties.CdtrAcct.Id.Othr.Id |
|
16 |
O |
SWIFT of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.BICFI |
|
17 |
O |
BIC of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
18 |
O |
Beneficiary bank clearing code |
RltdAgts.CdtrAgt.FinInstnId.Othr.Issr |
|
19 |
O |
Beneficiary bank SWIFT |
RltdAgts.CdtrAgt.FinInstnId.BICFI |
|
20 |
O |
Beneficiary’s bank account |
RltdAgts.CdtrAgt.FinInstnId.Othr.Id |
|
21 |
О |
Beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.Nm |
|
22 |
O |
Beneficiary’s bank* |
RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine |
|
23 |
R |
Purpose of payment |
RmtInf.Ustrd[1] |
|
24 |
O |
Purpose of payment* |
RmtInf.Ustrd[2] |
|
25 |
O |
Code (22) |
RmtInf.Strd [1] .CdtrRefInf.Ref |
|
26 |
R |
Payment order (21) |
Purp.Prtry |
|
27 |
O |
Terms of payment (35) |
RmtInf.Strd [1].AddtlRmtInf[1] |
|
28 |
O |
Terms of payment (35)* |
RmtInf.Strd [1].AddtlRmtInf[2] |
To be filled in if the value is more than 140 characters. |
29 |
O |
Access. to card bank (62) |
RmtInf.Strd [1] .TaxRmt.Dt |
Added field. |
30 |
O |
Term for acceptance |
RmtInf.Strd [2] .TaxRmt.AdmstnZone |
Added field. |
31 |
O |
End time of acceptance |
RmtInf.Strd [3] .TaxRmt.Dt |
Added field. |
32 |
R |
Commission amount |
Chrgs.Rcrd.Amt@Ccy |
|
33 |
R |
Transaction amount |
Amt @ Ccy |
|
34 |
O |
Transit account enrollment notification number |
SplmtryData.Envlp.Notif.Nuved |
|
35 |
O |
Date of notification NUVED |
SplmtryData.Envlp.Notif.Dtuv |
Date in ISO format: YYYY-MM-DD. |
36 |
O |
End date of submission of documents |
SplmtryData.Envlp.Notif.Dtcpd |
Date in ISO format: YYYY-MM-DD. |
37 |
O |
Start date of violation |
SplmtryData.Envlp.Notif.Bviol |
Date in ISO format: YYYY-MM-DD. |
38 |
O |
CP Document ID |
SplmtryData.Envlp.NumSB |
|
39 |
O |
Payment code (110) |
Tax.Rcrd.Tp |
|
40 |
O |
Income type code (20) |
AmtDtls.PrtryAmt.Tp |
|
41 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
Filled in with a value of 0, if the Income type code (20) |
Collection order
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry |
||||
1 |
R |
Transaction amount |
Amt@ Ccy |
< AmtCcy = "USD">1500.00<. Amt> |
2 |
R |
Transaction currency |
Amt @Ccy |
<AmtCcy= " USD"> 1500.00 <.Amt> |
3 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
4 |
R |
Date of operation |
BookgDt.Dt |
- |
5 |
R |
Domain ISO Transaction Codification |
BkTxCd.Domn.Cd |
see operation type correspondence table |
6 |
R |
Transaction typen (Family ISO Transaction Codification) |
BkTxCd.Domn.Fmly.Cd |
see operation type correspondence table |
7 |
O |
Subfamily ISO Transaction Codification |
BkTxCd.Domn.Fmly.SubFmlyCd |
see operation type correspondence table |
8 |
O |
Debtor code |
AcctSvcrRef |
5 characters |
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls |
||||
1 |
R |
Document number |
Refs.EndToEndId |
|
2 |
R |
Sum (7) |
Amt@ Ccy |
- |
3 |
R |
Payer’s name |
RltdPties.Dbtr.Nm |
- |
4 |
O |
Tax ID of the payer |
RltdPties.Dbtr.Id.OrgId.Othr.Id |
- |
5 |
O |
ISO data type code for the payer’s TIN |
RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying TIN. |
6 |
R |
Payer’s account number |
RltdPties.DbtrAcct.Id.Othr.Id |
- |
7 |
R |
Name of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Nm |
- |
8 |
O |
SWIFT code of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.BICFI |
- |
9 |
O |
BIK of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
- |
10 |
O |
Correspondent account of the bank sending the payment to the Central Bank |
RltdAgts.DbtrAgt.FinInstnId.Othr.Id |
- |
11 |
O |
Clearing code of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Othr.Issr |
- |
12 |
R |
Recipient’s name |
RltdPties.Cdtr.Nm |
- |
13 |
O |
Recipient’s name* |
RltdPties.Cdtr.PstlAdr.AdrLine |
To be filled in if the recipient’s name is more than 140 characters |
14 |
O |
TIN of the recipient |
RltdPties.Cdtr.Id.OrgId.Othr.Id |
- |
15 |
O |
ISO data type code for the recipient’s TIN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying TIN |
16 |
R |
Beneficiary account number |
RltdPties.CdtrAcct.Id.Othr.Id |
- |
17 |
O |
SWIFT of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.BICFI |
- |
18 |
O |
ISO code of data type for BIK bank |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd |
- |
19 |
R |
Beneficiary bank name |
RltdAgts.CdtrAgt.FinInstnId.Nm |
- |
20 |
R |
BIK of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
- |
21 |
O |
Beneficiary Bank Clearing Code |
RltdAgts.CdtrAgt.FinInstnId.Othr.Issr |
- |
22 |
R |
Correspondent account of the bank executing the payment in the Central Bank |
RltdAgts.CdtrAgt.FinInstnId.Othr.Id |
- |
23 |
R |
Order of payment |
Purp.Prtry |
- |
24 |
O |
Code (22) |
RmtInf.Strd.CdtrRefInf.Ref |
- |
25 |
R |
Purpose of payment |
RmtInf.Ustrd [1] |
- |
26 |
O |
Purpose of payment* |
RmtInf.Ustrd [2] |
To be filled in if the purpose of the payment is more than 140 characters |
27 |
R |
Date of receipt of the document in the bank |
SplmtryData.Envlp.DocRcvDt |
- |
28 |
R |
Date of debiting from the payer’s account |
SplmtryData.Envlp.DocWrOffDt |
- |
29 |
R |
Type of payment |
SplmtryData.Envlp.PmtType |
- |
30 |
O |
Notification number of crediting to transit account (added field) |
SplmtryData.Envlp.Notif.Nuved |
|
31 |
O |
NUVED Notice Date (added field) |
SplmtryData.Envlp.Notif.Dtuv |
Date in ISO format: YYYY-MM-DD |
32 |
O |
End date of submission of documents (added field) |
SplmtryData.Envlp.Notif.Dtcpd |
Date in ISO format: YYYY-MM-DD |
33 |
O |
Start date of violation (added field) |
SplmtryData.Envlp.Notif.Bviol |
Date in ISO format: YYYY-MM-DD |
34 |
O |
CP document ID (added field) |
SplmtryData.Envlp.NumSB |
|
35 |
O |
Payment code (110) |
Tax.Rcrd.Tp |
|
36 |
O |
Income type code (20) |
AmtDtls.PrtryAmt.Tp |
|
37 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
Filled in with a value of 0, if the Income type code (20) |
38 |
O |
Taxpayer status (101) |
Tax.Rcrd.DbtrSts |
- |
39 |
O |
Payer’s checkpoint (102) |
Tax.Dbtr.TaxTp |
- |
40 |
O |
Recipient’s checkpoint (103) |
Tax.Cdtr.TaxTp |
|
41 |
O |
KBK (104) |
Tax.Rcrd.CtgyDtls |
- |
42 |
O |
OKTMO (105) |
Tax.AdmstnZn |
- |
43 |
O |
Basis of tax payment (106) |
Tax.Rcrd.Ctgy |
- |
44 |
O |
Year of tax period (107) |
Tax.Rcrd.Prd.Yr |
- |
45 |
O |
Type of tax period (107) |
Tax.Rcrd.Prd.Tp |
Can be one of the following values: |
46 |
O |
Date of tax period (107) |
Tax.Rcrd.Prd.FrToDt.FrDt |
- |
47 |
O |
Date of tax period (107) |
Tax.Rcrd.Prd.FrToDt.ToDt |
Indicated to comply with the format. |
48 |
O |
Customs Code (107) |
Tax.Cdtr.RegnId |
- |
49 |
O |
Tax payment number (108) |
Tax.RefNb |
- |
50 |
O |
Date of tax document (109) |
Tax.Dt, values "0" or "00" are specified in Tax.Mtd |
- |
Letter of credit
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry |
||||
1 |
R |
Operation amount |
Amt @ Ccy |
|
2 |
R |
Debit / Credit |
CdtDbtInd |
"DBIT" / "CRDT" |
3 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
4 |
R |
Date of operation |
BookgDt.Dt |
|
5 |
O |
Decommissioned from the account. boards. |
ValDt.Dt |
|
6 |
R |
Transaction code |
BkTxCd.Domn.Cd |
"PMNT" |
7 |
R |
Transaction type |
BkTxCd.Domn.Fmly.Cd |
"DRFT" |
8 |
O |
Transaction subtype |
BkTxCd.Domn.Fmly.SubFmlyCd |
"NTAV" |
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls |
||||
1 |
R |
LETTER OF CREDIT NO. (3) |
Refs.EndToEndId |
|
2 |
R |
Payer’s name |
RltdPties.Dbtr.Nm |
|
3 |
O |
Payer’s name* |
RltdPties.Dbtr.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
4 |
O |
INN / KIO of the payer |
RltdPties.Dbtr.Id.OrgId.Othr.Id |
|
5 |
R |
Payer’s account number |
RltdPties.DbtrAcct.Id.Othr.Id |
|
6 |
O |
BIC of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
7 |
O |
Payer’s bank account |
RltdAgts.DbtrAgt.FinInstnId.Othr.Id |
|
8 |
O |
Payer’s bank clearing code |
RltdAgts.DbtrAgt.FinInstnId.Othr.Issr |
|
9 |
O |
Payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Nm |
|
10 |
O |
Payer’s bank* |
RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
11 |
O |
Beneficiary’s bank SWIFT |
RltdAgts.CdtrAgt.FinInstnId.BICFI |
|
12 |
R |
Beneficiary name |
RltdPties.Cdtr.Nm |
|
13 |
O |
Beneficiary name* |
RltdPties.Cdtr.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
14 |
O |
Beneficiary’s bank correspondent account |
RltdAgts.CdtrAgt.FinInstnId.Othr.Id |
|
15 |
O |
TIN / KIO of the recipient |
RltdPties.Cdtr.Id.OrgId.Othr.Id |
|
16 |
O |
ISO data type code for the recipient’s INN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying the INN. |
17 |
R |
Beneficiary account number |
RltdPties.CdtrAcct.Id.Othr.Id |
|
18 |
O |
SWIFT of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.BICFI |
|
19 |
O |
BIC of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
20 |
O |
Beneficiary bank clearing code |
RltdAgts.CdtrAgt.FinInstnId.Othr.Issr |
|
21 |
O |
Beneficiary bank account |
RltdAgts.CdtrAgt.FinInstnId.Othr.Id |
|
22 |
О |
Beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.Nm |
|
23 |
O |
Beneficiary’s bank* |
RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine |
|
24 |
R |
Purpose of payment |
RmtInf.Ustrd[1] |
|
25 |
O |
Purpose of payment* |
RmtInf.Ustrd[2] |
|
26 |
O |
Code (22) |
RmtInf.Strd [1] .CdtrRefInf.Ref |
|
27 |
R |
Expiration date accreditation. |
RmtInf.Strd [1] .TaxRmt.Dt |
Added field. |
28 |
O |
Type of letter of credit |
RmtInf.Strd [1].AddtlRmtInf[1] |
Added field. |
29 |
O |
Terms of payment |
RmtInf.Strd [1].AddtlRmtInf[2] |
Added field. |
30 |
O |
Payment by presentation (document type) |
RmtInf.Strd [2].AddtlRmtInf[1] |
Added field. |
31 |
O |
Additional conditions |
RmtInf.Strd [2].AddtlRmtInf[2] |
Added field. |
32 |
O |
Account no. Sender |
RmtInf.Strd [1] .TaxRmt.Dbtr.TaxId |
Added field. |
33 |
R |
Commission amount |
Chrgs.Rcrd.Amt@Ccy |
|
34 |
R |
Transaction amount |
Amt @ Ccy |
|
35 |
O |
Transit account enrollment notification number |
SplmtryData.Envlp.Notif.Nuved |
|
36 |
O |
Date of notification NUVED |
SplmtryData.Envlp.Notif.Dtuv |
Date in ISO format: YYYY-MM-DD. |
37 |
O |
End date of submission of documents |
SplmtryData.Envlp.Notif.Dtcpd |
Date in ISO format: YYYY-MM-DD. |
38 |
O |
Start date of violation |
SplmtryData.Envlp.Notif.Bviol |
Date in ISO format: YYYY-MM-DD. |
39 |
O |
CP document ID |
SplmtryData.Envlp.NumSB |
|
40 |
O |
Payment code (110) |
Tax.Rcrd.Tp |
|
41 |
O |
Income type code (20) |
AmtDtls.PrtryAmt.Tp |
|
42 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
Filled in with a value of 0 if the Income type code (20) |
Memorial warrant
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry |
||||
1 |
R |
Transaction amount |
Amt@ Ccy |
< AmtCcy = "USD">1500.00</Amt> |
2 |
R |
Transaction currency |
Amt @Ccy |
<AmtCcy= " USD"> 1500.00 </Amt> |
3 |
R |
Debit / Credit |
CdtDbtInd |
Constant "DBIT" or "CRDT" |
4 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
5 |
R |
Date of operation |
BookgDt.Dt |
|
6 |
R |
Domain ISO Transaction Codification |
BkTxCd.Domn.Cd |
see table of correspondence of the type of operation |
7 |
R |
Transaction typen (Family ISO Transaction Codification) |
BkTxCd.Domn.Fmly.Cd |
see table of correspondence of the type of operation |
8 |
O |
Subfamily ISO Transaction Codification |
BkTxCd.Domn.Fmly.SubFmlyCd |
see table of correspondence of the type of operation |
9 |
O |
Ruble equivalent of the amount to be paid |
AmtDtls.PrtryAmt.Amt@Ccy |
In this case, Ccy = RUR |
10 |
O |
Type description |
AmtDtls.PrtryAmt.Tp |
"Operation Amount in Rubles" |
11 |
O |
Debtor code |
AcctSvcrRef |
5 characters |
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls |
||||
1 |
R |
Document number |
Refs.EndToEndId |
|
2 |
R |
Amount |
Amt @ Ccy |
- |
3 |
R |
Payer’s name |
RltdPties.Dbtr.Nm |
|
4 |
O |
Payer’s name* |
RltdPties.Dbtr.PstlAdr.AdrLine |
To be filled in if the name of the payer is more than 140 characters. |
5 |
O |
TIN / KIO of the payer |
RltdPties.Dbtr.Id.OrgId.Othr.Id |
|
6 |
O |
ISO data type code for the payer’s TIN |
RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying TIN. |
7 |
R |
Payer’s account number |
RltdPties.DbtrAcct.Id.Othr.Id |
|
8 |
R |
Recipient’s name |
RltdPties.Cdtr.Nm |
|
9 |
O |
Recipient’s name* |
RltdPties.Cdtr.PstlAdr.AdrLine |
To be filled in if the name of the recipient is more than 140 characters. |
10 |
O |
TIN / KIO of the recipient |
RltdPties.Cdtr.Id.OrgId.Othr.Id |
|
11 |
O |
SWIFT of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.BICFI |
|
12 |
O |
BIK of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
13 |
O |
Beneficiary Bank Clearing Code |
RltdAgts.CdtrAgt.FinInstnId.Othr.Issr |
|
14 |
O |
Correspondent account of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.Othr.Id |
|
15 |
O |
ISO data type code for the recipient’s TIN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying TIN. |
16 |
R |
Beneficiary account number |
RltdPties.CdtrAcct.Id.Othr.Id |
|
17 |
O |
SWIFT of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.BICFI |
|
18 |
O |
BIK of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
19 |
O |
Correspondent account of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Othr.Id |
|
20 |
O |
Clearing code of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Othr.Issr |
|
21 |
O |
SWIFT of the beneficiary’s bank |
RltdAgts.CdtrAgt.FinInstnId.BICFI |
|
22 |
O |
Beneficiary Bank Clearing Code |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd |
|
23 |
O |
Beneficiary bank name |
RltdAgts.CdtrAgt.FinInstnId.Nm |
|
24 |
O |
Beneficiary bank name* |
RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine |
|
25 |
R |
Purpose of payment |
RmtInf.Ustrd [1] |
|
26 |
R |
Purpose of payment* |
RmtInf.Ustrd [2] |
To be filled in if the purpose of the payment is more than 140 characters. |
27 |
O |
Order of payment |
Purp.Prtry |
|
28 |
O |
Compiled by |
RltdAgts.DbtrAgt.FinInstnId.Nm |
- |
29 |
O |
Name of the payer’s bank* |
RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine |
|
30 |
O |
Loan amount |
SplmtryData.Envlp.CrdtSum |
- |
31 |
O |
Notification number of crediting to transit account |
SplmtryData.Envlp.Notif.Nuved |
|
32 |
O |
NUVED Notice Date |
SplmtryData.Envlp.Notif.Dtuv |
Date in ISO format: YYYY-MM-DD. |
33 |
O |
End date of submission of documents |
SplmtryData.Envlp.Notif.Dtcpd |
Date in ISO format: YYYY-MM-DD. |
34 |
O |
Start date of violation |
SplmtryData.Envlp.Notif.Bviol |
Date in ISO format: YYYY-MM-DD. |
35 |
O |
CP document ID |
SplmtryData.Envlp.NumSB |
|
36 |
O |
Payment code (110) |
Tax.Rcrd.Tp |
|
37 |
O |
Income type code (20) |
AmtDtls.PrtryAmt.Tp |
|
38 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
Filled in with a value of 0 if the Income type code (20) |
Payment order
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry |
||||
1 |
R |
Transaction amount |
Amt@ Ccy |
- |
2 |
R |
Operation type |
Amt @Ccy |
- |
3 |
R |
Debit / Credit |
CdtDbtInd |
"DBIT" / "CRDT" |
4 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
5 |
R |
Date of operation |
BookgDt.Dt |
- |
6 |
O |
Decommissioned from the account. boards. |
ValDt.Dt |
- |
7 |
R |
Transaction code |
BkTxCd.Domn.Cd |
see table of correspondence of the type of operation |
8 |
R |
Transaction type |
BkTxCd.Domn.Fmly.Cd |
see table of correspondence of the type of operation |
9 |
O |
Transaction subtype |
BkTxCd.Domn.Fmly.SubFmlyCd |
see table of correspondence of the type of operation |
10 |
О |
Ruble equivalent of the amount to be paid |
AmtDtls.PrtryAmt.Amt@Ccy |
Amt - amount |
11 |
O |
Type description |
AmtDtls.PrtryAmt.Tp |
"Operation Amount in Rubles" |
12 |
O |
Debtor code |
AcctSvcrRef |
5 characters |
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls |
||||
1 |
R |
PAYMENT ORDER N (3) |
Refs.EndToEndId |
|
2 |
R |
Sum (7) |
Amt @ Ccy |
- |
3 |
R |
Payer (8) |
RltdPties.Dbtr.Nm |
|
4 |
O |
Payer (8)* |
RltdPties.Dbtr.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
5 |
O |
Payer’s INN (60) |
RltdPties.Dbtr.Id.OrgId.Othr.Id |
|
6 |
O |
ISO data type code for the payer’s TIN |
RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying TIN. |
7 |
R |
Payer’s account number (9) |
RltdPties.DbtrAcct.Id.Othr.Id |
|
8 |
O |
SWIFT of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.BICFI |
|
9 |
O |
Payer’s bank clearing code |
RltdAgts.DbtrAgt.FinInstnId.Othr.Issr |
|
10 |
O |
BIC of the payer’s bank (11) |
RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
11 |
O |
Payer’s bank account (12) |
RltdAgts.DbtrAgt.FinInstnId.Othr.Id |
|
12 |
O |
Payer’s bank (10) |
RltdAgts.DbtrAgt.FinInstnId.Nm |
|
13 |
O |
Payer’s bank (10)* |
RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
14 |
R |
Recipient (16) |
RltdPties.Cdtr.Nm |
|
15 |
O |
Recipient (16)* |
RltdPties.Cdtr.PstlAdr.AdrLine |
Filled in if the name is more than 140 characters |
16 |
O |
Beneficiary’s INN (61) |
RltdPties.Cdtr.Id.OrgId.Othr.Id |
|
17 |
O |
ISO data type code for the recipient’s TIN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd |
Mandatory when specifying the TIN. |
18 |
R |
Beneficiary account number (17) |
RltdPties.CdtrAcct.Id.Othr.Id |
|
19 |
O |
BIC of the beneficiary’s bank (14) |
RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
20 |
O |
Beneficiary’s bank SWIFT |
RltdAgts.CdtrAgt.FinInstnId.BICFI |
|
21 |
O |
Beneficiary bank clearing code |
RltdAgts.CdtrAgt.FinInstnId.Othr.Issr |
|
22 |
O |
Beneficiary’s bank account (15) |
RltdAgts.CdtrAgt.FinInstnId.Othr.Id |
|
23 |
О |
Beneficiary’s bank (13) |
RltdAgts.CdtrAgt.FinInstnId.Nm |
|
24 |
O |
Beneficiary’s bank (13)* |
RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine |
|
25 |
O |
KPP of the recipient (103) |
Tax.Cdtr.TaxTp |
|
26 |
O |
Payer’s checkpoint (102) |
Tax.Dbtr.TaxTp |
|
27 |
R |
Purpose of payment |
RmtInf.Ustrd[1] |
|
28 |
O |
Purpose of payment* |
RmtInf.Ustrd[2] |
|
29 |
O |
Code (22) |
RmtInf.Strd [1] .CdtrRefInf.Ref |
|
30 |
R |
Order of payment (21) |
Purp.Prtry |
|
31 |
R |
Commission Amount |
Chrgs.Rcrd.Amt@Ccy |
|
32 |
R |
Transaction amount |
Amt @ Ccy |
|
33 |
O |
Transit account enrollment notification number |
SplmtryData.Envlp.Notif.Nuved |
|
34 |
O |
Date of notification NUVED |
SplmtryData.Envlp.Notif.Dtuv |
Date in ISO format: YYYY-MM-DD. |
35 |
O |
End date of submission of documents |
SplmtryData.Envlp.Notif.Dtcpd |
Date in ISO format: YYYY-MM-DD. |
36 |
O |
Start date of violation |
SplmtryData.Envlp.Notif.Bviol |
Date in ISO format: YYYY-MM-DD. |
37 |
O |
CP Document ID |
SplmtryData.Envlp.NumSB |
|
38 |
O |
Payment code (110) |
Tax.Rcrd.Tp |
|
39 |
O |
Income type code (20) |
AmtDtls.PrtryAmt.Tp |
|
40 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
Filled in with a value of 0 if the Income type code (20) |
41 |
O |
Taxpayer status (101) |
Tax.Rcrd.DbtrSts |
|
42 |
O |
KBK (104) |
Tax.Rcrd.CtgyDtls |
|
43 |
O |
OKTMO (105) |
Tax.AdmstnZn |
|
44 |
O |
Basis of tax payment (106) |
Tax.Rcrd.Ctgy |
|
45 |
O |
Year of tax period (107) |
Tax.Rcrd.Prd.Yr |
|
46 |
O |
Tax period type (107) |
Tax.Rcrd.Prd.Tp |
Can be one of the following values: |
47 |
O |
Date of the tax period (107) |
Tax.Rcrd.Prd.FrToDt.FrDt |
R831 (in the format "YYYY-MM-DD"), if the R831 value corresponds to the format "DD.MM.YYYY" |
48 |
O |
Date of the tax period (107) |
Tax.Rcrd.Prd.FrToDt.ToDt |
Indicated to comply with the format. |
49 |
O |
Customs authority code (107) |
Tax.Cdtr.RegnId |
|
50 |
O |
Tax payment number (108) |
Tax.RefNb |
|
51 |
O |
Date of tax document (109) |
Tax.Dt, values "0" or "00" are specified in Tax.Mtd |
Bank order
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntr |
||||
1 |
R |
Transaction amount |
Amt@ Ccy |
< AmtCcy = "USD">1500.00</Amt> |
2 |
R |
Transaction currency |
Amt @Ccy |
<AmtCcy= " USD"> 1500.00 </Amt> |
3 |
R |
Indicator Debit ('DBIT') / Credit ('CRDT') |
CdtDbtInd |
|
4 |
R |
Operation status: |
Sts |
For interim statement 'PDNG'. |
5 |
R |
Date of operation |
BookgDt.Dt |
|
6 |
R |
Transaction code |
BkTxCd.Domn.Cd |
see table of correspondence of the type of operation |
7 |
R |
Transaction typen |
BkTxCd.Domn.Fmly.Cd |
see table of correspondence of the type of operation |
8 |
O |
Transaction subtype |
BkTxCd.Domn.Fmly.SubFmlyCd |
see table of correspondence of the type of operation |
9 |
O |
Ruble equivalent of the amount to be paid |
AmtDtls.PrtryAmt.Amt@Ccy |
Ccy in this case is equal to RUR |
10 |
O |
Type description |
AmtDtls.PrtryAmt.Tp |
"Operation Amount in Rubles" |
11 |
O |
Debtor code |
AcctSvcrRef |
5 characters |
Description | Path | Comment Example |
||
---|---|---|---|---|
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls |
||||
1 |
R |
ISO data type code for the payer’s TIN |
RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd |
Constant 'TXID' |
2 |
O |
TIN / KIO of the payer |
RltdPties.Dbtr.Id.OrgId.Othr.Id |
|
3 |
O / R |
ISO data type code for the recipient’s TIN |
RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd |
Pazameter is required when specifying TIN. |
4 |
O |
TIN / KIO of the recipient |
RltdPties.Cdtr.Id.OrgId.Othr.Id |
|
5 |
R |
Purpose of payment |
RmtInf.Ustrd [1] |
There can be more than one field |
6 |
O |
Purpose of payment* |
RmtInf.Ustrd [2] |
|
7 |
R |
Payer’s name |
RltdPties.Dbtr.Nm |
|
8 |
O |
Payer’s name |
RltdPties.Dbtr.PstlAdr.AdrLine |
To be filled in if the name of the payer is more than 140 characters |
9 |
R |
Recipient’s name |
RltdPties.Cdtr.Nm |
|
10 |
O |
Recipient’s name* |
RltdPties.Cdtr.PstlAdr.AdrLine |
To be filled in when the recipient’s name is more than 140 characters |
11 |
R |
Document number |
Refs.EndToEndId |
|
12 |
R |
Payer’s account number |
RltdPties.DbtrAcct.Id.Othr.Id |
|
13 |
R |
Beneficiary account number |
RltdPties.CdtrAcct.Id.Othr.Id |
|
14 |
O |
Payer’s bank account |
RltdAgts.DbtrAgt.FinInstnId.Othr.Id |
|
15 |
O |
Name of the payer’s bank |
RltdAgts.DbtrAgt.FinInstnId.Nm |
|
16 |
O |
Name of the payer’s bank* |
RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine |
|
17 |
R |
Order of payment |
Purp.Prtry |
|
18 |
O |
Payment code (110) |
Tax.Rcrd.Tp |
|
19 |
O |
Income type code (20) |
AmtDtls.PrtryAmt.Tp |
|
20 |
O |
Amount (constant) |
AmtDtls.PrtryAmt.Amt@Ccy |
Filled in with a value of 0 if the Income type code (20) |
Table of correspondence of the type of operation with a collection of ISO documents
Code | Type of operation | Domain Code Set | Family Code Set | Sub-Family Code Set |
---|---|---|---|---|
01 |
Currency transfer Payment order |
PMNT |
ICDT - debit |
NTAV |
02 |
Payment Request |
PMNT |
CHRG |
NTAV |
06 |
Collection order |
PMNT |
ICCN - debit |
NTAV |
08 |
Letter of Credit |
PMNT |
DRFT |
NTAV |
17 |
Bank Order |
PMNT |
RDDT |
NTAV |
04 |
Announcement for Cash Deposit |
PMNT |
CNTR |
NTAV |
03 |
Outlet Cash Order |
PMNT |
ICHQ |
NTAV |
04 |
Receipt cash order |
PMNT |
RCHQ |
NTAV |
09 |
Memorial Warrant |
PMNT |
MDOP - Debit |
COMM |
16 |
Payment Order |
DERV |
OSWP |
SWPP |
Documents whose operation type is not: "01", "02", "06", "08", "16", "17" are parsed as a memorial order with the operation type "09".
Answer
If the request is successful, the service returns an XML document that matches the camt.053.001.05 format. Otherwise, the service returns one of the following messages:
HTTP Code | Type | Body | Description |
---|---|---|---|
200 |
OK |
The request is still being processed. Try later |
Statement has not been generated yet. Please contact later. |
401 |
Err |
Wrong username or password |
Invalid username or password |
401 |
Err |
User was not found |
User not found |
403 |
Err |
User is disabled |
User blocked |
401 |
Err |
Warrant service error |
Power of attorney verification service is not responding |
502 |
Err |
Bad Gateway |
Wrong gateway |
503 |
Err |
Service Unavailable |
Service unavailable |
504 |
Err |
Gateway Timeout |
Gateway not responding |
500 |
Err |
Internal Error |
Internal application error |
400 |
Err |
Request has not been not found by MsgId |
Request not found by MsgId |
500 |
Err |
The statement is not final and has incorrect closing date: <current business date> |
The statement is not final and cannot be generated |
500 |
Err |
The request has not been processed due to errors. Please contact the service support. |
The statement was not generated due to errors (for all invoices from the request). Contact technical support |
Statement example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.053.001.05">
<BkToCstmrStmt>
<GrpHdr>
<MsgId>e584449c1e094e7190abfde65bd33c91</MsgId>
<CreDtTm>2021-03-18T15:01:30.385+03:00</CreDtTm>
</GrpHdr>
<Stmt>
<Id>25efb2a4c4ef4fa6a0a981ac35f56ac2</Id>
<CreDtTm>2021-03-18T15:01:30.385+03:00</CreDtTm>
<FrToDt>
<FrDtTm>2021-03-18T00:00:00Z</FrDtTm>
<ToDtTm>2021-03-18T00:00:00Z</ToDtTm>
</FrToDt>
<Acct>
<Id>
<Othr>
<Id>40701810601850000354</Id>
</Othr>
</Id>
<Ccy>RUR</Ccy>
<Ownr>
<Nm>ООО "Альфа-Форекс"</Nm>
<Id>
<OrgId>
<Othr>
<Id>7708294216</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>
<PstlAdr>
<AdrLine>107078,Россия, г.Москва, ул.Маши Порываевой д.34</AdrLine>
</PstlAdr>
<Othr>
<Id>7728168971</Id>
</Othr>
</FinInstnId>
</Svcr>
</Acct>
<Bal>
<Tp>
<CdOrPrtry>
<Cd>OPBD</Cd>
</CdOrPrtry>
</Tp>
<Amt Ccy="RUR">103719670.32</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Dt>
<Dt>2021-03-18</Dt>
</Dt>
<Avlbty>
<Dt>
<ActlDt>2021-03-18</ActlDt>
</Dt>
<Amt Ccy="RUR">103719670.32</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
</Avlbty>
</Bal>
<Bal>
<Tp>
<CdOrPrtry>
<Cd>CLBD</Cd>
</CdOrPrtry>
</Tp>
<Amt Ccy="RUR">103719672.78</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Dt>
<Dt>2021-03-18</Dt>
</Dt>
<Avlbty>
<Dt>
<ActlDt>2021-03-18</ActlDt>
</Dt>
<Amt Ccy="RUR">103719672.78</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
</Avlbty>
</Bal>
<TxsSummry>
<TtlCdtNtries>
<Sum>2.46</Sum>
</TtlCdtNtries>
<TtlDbtNtries>
<Sum>0.00</Sum>
</TtlDbtNtries>
</TxsSummry>
<Ntry>
<Amt Ccy="RUR">1.23</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Sts>PDNG</Sts>
<BookgDt>
<Dt>2021-03-18</Dt>
</BookgDt>
<ValDt>
<Dt>2021-03-18</Dt>
</ValDt>
<BkTxCd>
<Domn>
<Cd>PMNT</Cd>
<Fmly>
<Cd>RCDT</Cd>
<SubFmlyCd>NTAV</SubFmlyCd>
</Fmly>
</Domn>
</BkTxCd>
<NtryDtls>
<TxDtls>
<Refs>
<EndToEndId>84798</EndToEndId>
</Refs>
<Amt Ccy="RUR">1.23</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Chrgs>
<Rcrd>
<Amt Ccy="RUR">0.00</Amt>
<Br>CRED</Br>
<Agt>
<FinInstnId/>
</Agt>
</Rcrd>
</Chrgs>
<RltdPties>
<Dbtr>
<Nm>Муравев Иван Евгеньевич</Nm>
<Id>
<OrgId>
<Othr>
<Id>500909451727</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40817810415170000004</Id>
</Othr>
</Id>
</DbtrAcct>
<Cdtr>
<Nm>ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСВЕННОСТЬЮ "АЛЬФА-ФОРЕКС"</Nm>
<Id>
<OrgId>
<Othr>
<Id>7708294216</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>40701810601850000354</Id>
</Othr>
</Id>
</CdtrAcct>
</RltdPties>
<RltdAgts>
<DbtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО "АЛЬФА-БАНК" г Москва</Nm>
<Othr>
<Id>30101810200000000593</Id>
</Othr>
</FinInstnId>
</DbtrAgt>
<CdtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО "АЛЬФА-БАНК" г Москва</Nm>
<Othr>
<Id>30101810200000000593</Id>
</Othr>
</FinInstnId>
</CdtrAgt>
<IntrmyAgt1>
<FinInstnId/>
</IntrmyAgt1>
</RltdAgts>
<Purp>
<Prtry>5</Prtry>
</Purp>
<RmtInf>
<Ustrd>Перевод по договору 1751-19/РМ Специальный раздел НС $$99982810014870001318$$</Ustrd>
<Strd>
<RfrdDocInf>
<RltdDt>2021-03-18</RltdDt>
</RfrdDocInf>
</Strd>
</RmtInf>
<SplmtryData>
<Envlp>
<NumSB>D851803210000011</NumSB>
</Envlp>
</SplmtryData>
</TxDtls>
</NtryDtls>
</Ntry>
<Ntry>
<Amt Ccy="RUR">1.23</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Sts>PDNG</Sts>
<BookgDt>
<Dt>2021-03-18</Dt>
</BookgDt>
<ValDt>
<Dt>2021-03-18</Dt>
</ValDt>
<BkTxCd>
<Domn>
<Cd>PMNT</Cd>
<Fmly>
<Cd>RCDT</Cd>
<SubFmlyCd>NTAV</SubFmlyCd>
</Fmly>
</Domn>
</BkTxCd>
<NtryDtls>
<TxDtls>
<Refs>
<EndToEndId>84612</EndToEndId>
</Refs>
<Amt Ccy="RUR">1.23</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Chrgs>
<Rcrd>
<Amt Ccy="RUR">0.00</Amt>
<Br>CRED</Br>
<Agt>
<FinInstnId/>
</Agt>
</Rcrd>
</Chrgs>
<RltdPties>
<Dbtr>
<Nm>Муравев Иван Евгеньевич</Nm>
<Id>
<OrgId>
<Othr>
<Id>500909451727</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40817810415170000004</Id>
</Othr>
</Id>
</DbtrAcct>
<Cdtr>
<Nm>ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСВЕННОСТЬЮ "АЛЬФА-ФОРЕКС"</Nm>
<Id>
<OrgId>
<Othr>
<Id>7708294216</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>40701810601850000354</Id>
</Othr>
</Id>
</CdtrAcct>
</RltdPties>
<RltdAgts>
<DbtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО "АЛЬФА-БАНК" г Москва</Nm>
<Othr>
<Id>30101810200000000593</Id>
</Othr>
</FinInstnId>
</DbtrAgt>
<CdtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО "АЛЬФА-БАНК" г Москва</Nm>
<Othr>
<Id>30101810200000000593</Id>
</Othr>
</FinInstnId>
</CdtrAgt>
<IntrmyAgt1>
<FinInstnId/>
</IntrmyAgt1>
</RltdAgts>
<Purp>
<Prtry>5</Prtry>
</Purp>
<RmtInf>
<Ustrd>Перевод по договору 1751-19/РМ Специальный раздел НС $$99982810014870001318$$</Ustrd>
<Strd>
<RfrdDocInf>
<RltdDt>2021-03-18</RltdDt>
</RfrdDocInf>
</Strd>
</RmtInf>
<SplmtryData>
<Envlp>
<NumSB>D851803210000006</NumSB>
</Envlp>
</SplmtryData>
</TxDtls>
</NtryDtls>
</Ntry>
</Stmt>
</BkToCstmrStmt>
</Document>
Payments
URI
POST: /API/v1/ISO20022/Payments
XML scheme
pain.001.001.06
Scheme description
№ | Description | Link | Comment/Example | |
---|---|---|---|---|
1 |
R |
Date and time the message was created |
Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm |
Date format YYYY-MM-DDTHH:MM:SS 2018-11-27T17:13:45 |
2 |
R |
Unique message ID |
Document.CstmrCdtTrfInitn.GrpHdr.MsgId |
Message ID assigned in the external system is specified. |
3 |
R |
Number of transactions in the message |
Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs |
The total number of payments (CdtTrfTxInf sections) in the message |
4 |
R |
Full name of the company |
Document.CstmrCdtTrfInitn.GrpHdr.InitgPty.Nm |
|
5 |
R |
TIN of the account holder |
Document.CstmrCdtTrfInitn.GrpHdr.InitgPty.Id.OrgId.Othr.Id |
|
6 |
R |
ISO data type code for TIN |
Document.CstmrCdtTrfInitn.GrpHdr.InitgPty.Id.OrgId.Othr.SchmeNm.Cd |
Константа "TXID" |
7 |
R |
Unique package ID |
Document.CstmrCdtTrfInitn.PmtInf.PmtInfId |
The ID of the payments group is specified. The ID must not match the MsgId and other identifiers |
8 |
R |
Unique payment id |
Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId |
ID of the original payment |
9 |
R |
Payment method |
Document.CstmrCdtTrfInitn.PmtInf.PmtMtd |
The default value is "TRF" |
10 |
R |
Signature 1 |
SplmtryData.Envlp.Signature. |
|
11 |
O |
Signature n |
SplmtryData.Envlp.Signature. |
Description | Link | Comment/Example | ||
---|---|---|---|---|
Document.CstmrCdtTrfInitn.PmtInf |
||||
1 |
R |
Document date (4) |
CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt |
YYYY-MM-DD, if the parameter is not filled in, we read the value of the ReqdExctnDt parameter |
2 |
R |
Document number (3) |
CdtTrfTxInf.PmtId.EndToEndId |
Integer up to 6 characters. The uniqueness of the number during the day is checked based on the uniqueness of the group of parameters: payment date, payment number, payer’s account, recipient’s account, payment amount. |
3 |
R |
Document amount |
CdtTrfTxInf.Amt.InstdAmt |
|
4 |
R |
Type of payment (5) |
CdtTrfTxInf.PmtTpInf.SvcLvl.Cd |
Accepted values: URGP - urgent payment NURG - regular payment |
5 |
R |
The order of payment (21) |
CdtTrfTxInf.Purp.Prtry |
|
6 |
R |
Payment code (22) |
CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref |
|
Purpose of payment (24) The field is formed on the side of the Alpha-Link system from several tags according to the following algorithm: [' {' + Currency transaction attribute + Currency transaction code + '}'] + [Information to the recipient] + [VAT information] It is allowed to fill in only the "Information to the recipient" field with all the necessary information. The total length of the field (24) should not exceed 210 characters. |
||||
7 |
O |
Record type |
CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.Tp.CdOrPrtry.Prtry |
The "POD" constant |
8 |
O |
Currency transaction attribute |
CdtTrfTxInf.RgltryRptg.Dtls.Tp |
For currency transactions - the constant Tp = "VO" |
9 |
O |
Currency transaction code |
CdtTrfTxInf.RgltryRptg.Dtls.Cd |
Required if specified Tp |
10 |
O |
Information to the recipient |
CdtTrfTxInf.RmtInf.Ustrd[1..2] |
|
11 |
O |
VAT type |
CdtTrfTxInf.Tax.Rcrd.AddtlInf |
VTIN - including VAT; VTNA - not subject to VAT; VTPS - not including VAT; Or may contain another value. |
12 |
O |
VAT value |
CdtTrfTxInf.Tax.Rcrd.TaxAmt.Rate |
Required if AddtlInf = "VTIN" |
13 |
R |
Name of the payer (8) |
Dbtr.Nm |
|
14 |
R |
Name of the payer (8) |
Dbtr.CtctDtls.Nm |
It is filled in if the name of the payer is more than 140 characters. |
15 |
R |
Payer’s TIN (60) |
Dbtr.Id.OrgId.Othr.Id |
|
16 |
R |
ISO data type code for TIN |
Dbtr.Id.OrgId.Othr.SchmeNmCd |
Constant 'TXID' |
17 |
O |
Payer’s Tax Registration Reason Code (KPP) (102) |
CdtTrfTxInf.Tax.Dbtr.TaxTp |
|
18 |
R |
Payer’s account (9) |
DbtrAcct.Id.Othr.Id |
|
19 |
R |
Currency code |
DbtrAcct.Ccy |
|
20 |
R |
BIC of the payer’s bank (11) |
DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
21 |
R |
Name of the payer’s bank (10) |
DbtrAgt.FinInstnId.Nm |
|
22 |
R |
Clearing system code |
DbtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd |
Constant "RUCBC" |
23 |
R |
The payer’s bank account (12) |
DbtrAgtAcct.Id.Othr.Id |
|
24 |
R |
Name of the recipient (16) |
CdtTrfTxInf.Cdtr.Nm |
|
25 |
R |
Recipient’s TIN (61) |
CdtTrfTxInf.Cdtr.Id.OrgId.Othr.Id |
|
26 |
R |
ISO data type code for TIN |
CdtTrfTxInf.Cdtr.Id.OrgId.Othr.SchmeNmCd |
Constant "TXID" |
27 |
O |
Recipient’s Tax Registration Reason Code (KPP) (103) |
CdtTrfTxInf.Tax.Cdtr.TaxTp |
|
28 |
O |
Recipient’s account (17) |
CdtTrfTxInf.CdtrAcct.Id.Othr.Id |
|
29 |
R |
BIC of the recipient’s bank (14) |
CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
30 |
R |
Clearing system code |
CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd |
Constant "RUCBC" |
31 |
R |
Name of the recipient’s bank (13) |
CdtTrfTxInf.CdtrAgt.FinInstnId.Nm |
|
32 |
R |
Account of the recipient’s bank (15) |
CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id |
|
33 |
O |
Code of the type of income (20) |
CdtTrfTxInf.RgltryRptg.Dtls.Cd |
You also need to fill in the PmtInf.CdtTrfTxInf.RgltryRptg.Dtls field. < b>Tp** = "PTCD" This constant is an indication that the Income Type code field is filled in |
Field 33 filling rule To fill in the field correctly, determine the type of income that an individual will receive as a result of the transfer. If your payment does not fall under the list from the Federal Law, you do not need to fill in the field. Code "1" - when transferring funds that are wages and (or) other income, in respect of which Article 99 of the Federal Law No. 229-FZ of 2.10.2007 establishes restrictions on the amount of deduction. If there is a writ of execution, specify the amount you have collected in the "Purpose of payment (24)" field. Code " 2 " - when transferring funds that are income, for which, in accordance with Article 101 of the Federal Law of 2.10. 2007 N 229-FZ, foreclosure cannot be levied, except for income to which, in accordance with part 2 of Article 101 of the Federal Law of 2.10.2007 N 229-FZ, restrictions on foreclosure are not applied. Code "3" - when transferring funds that are income, to which, in accordance with part 2 of Article 101 of Federal Law No. 229-FZ of 2.10. 2007, restrictions on foreclosure are not applied. If there is a writ of execution, specify the amount you have collected in the "Purpose of payment (24)" field. Please note that for income with code 3, penalties can only be made for alimony obligations against minors or for obligations to compensate for damage due to the death of the breadwinner. In other cases, the code is not specified How can I specify the collected amount in the "Purpose of payment (24)" field? If you have made a deduction from the funds transferred to an individual that make up the income specified in Article 99 or 101 of the Federal Law "On Enforcement Proceedings", then in the field "Purpose of payment (24)" specify the amount collected in the format://VCS / / rubles-kopecks//. For example, //VZS//100000-00//. Law and Order Detailed information is provided in Federal Law No. 12-FZ of 21.02.2019 "On Amendments to the Federal Law "On Enforcement Proceedings", Instruction of the Bank of Russia No. 5286-U of 14.10.2019 "On the Procedure for Specifying the Income Type Code in Money Transfer Orders |
||||
34 |
O |
Payment code (110) |
CdtTrfTxInf.Tax.Rcrd.Tp |
|
Field 33 filling rule To correctly fill in the "Payment code (110)" field, determine the type of income that an individual will receive. the person as a result of the transfer. If your payment does not fall under the list from the Resolution, you do not need to specify the code. The code 1 is put down in case of payments to the account of an individual. persons: 1. Temporary disability benefits (only for citizens exposed to radiation); 2.Maternity benefits; 3.A one-time allowance for women who have registered with medical organizations in the early stages of pregnancy; 4.One-time allowance at the birth of a child; 5. Monthly child care allowance. All types of income falling under code 1 are listed in parts 5.5 and 5.6 of Article 30.5 of the Federal Law "On the National Payment System". In other cases, the code is not specified. If the field is filled in incorrectly, there may be claims from individuals and / or regulatory authorities. Detailed information is provided in Article 30.5 of the Law of the Russian Federation No. 161-FZ of 27.06.2011 "On the National Payment System", Decree of the Government of the Russian Federation No. 1466 of 01.12.2018 "On Approval of the List of Other Payments at the Expense of the Budgets of the Budgetary System of the Russian Federation for the Purposes of Applying Parts 5 and 5.1 of Article 30.5 of the Federal Law "On the National Payment System" |
||||
Budget details of the payment order |
||||
35 |
O |
The status of the originator of the document (101) |
CdtTrfTxInf.Tax.Rcrd.DbtrSts |
|
36 |
O |
Budget classification code (104) |
CdtTrfTxInf.Tax.Rcrd.CtgyDtls |
|
37 |
O |
OKTMO (105) |
CdtTrfTxInf.Tax.AdmstnZn |
|
38 |
O |
Code of the basis of the tax payment (106) |
CdtTrfTxInf.Tax.Rcrd.Ctgy |
|
39 |
O |
Tax document number (108) |
CdtTrfTxInf.Tax.RefNb |
|
40 |
O |
Date of the tax document (109) |
PmtInf.CdtTrfTxInf.Tax.Dt The values "0" or "00" must be specified in PmtInf.CdtTrfTxInf.Tax.Mtd |
|
Details "Tax period code (107)": the code of the customs authority, the indicator of the tax period, the date of payment of taxes. This field is composite and is formed by the Alpha-Link system according to the algorithm specified after the table. |
||||
41 |
O |
Date of payment of taxes |
CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt |
The processing algorithm is given below |
42 |
O |
End of the period (not used) |
CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.ToDt |
Not used, specified only to comply with the format. |
43 |
O |
Year of the tax period |
CdtTrfTxInf.Tax.Rcrd.Prd.Yr |
|
44 |
O |
Tax period in encoding ISO20022 |
CdtTrfTxInf.Tax.Rcrd.Prd.Tp |
MM-MS; QTR-KV; HLF-PL; not specified-GD. |
45 |
O |
Code of the customs authority |
CdtTrfTxInf.Tax.Cdtr.RegnId |
The algorithm for processing the parameter " Tax period code (107)" on the bank’s side
If FrDt contains a value, then it is necessary to convert FrDt to the format DD. MM.YYYY.
Otherwise:
-
If Tp starts with 'MM', then the tax period code = 'МС.' +substring(Tp, 3, 2)+YEAR (Yr);
-
If Tp starts with 'QR', the tax period code = 'КВ. 0' +substring(Tp, 4, 1)+YEAR (Yr);
-
If Tp starts with 'HLF', the tax period code = 'ПЛ. 0' +substring(Tp, 4, 1)+YEAR (Yr);
-
If Tp is not specified, then the tax period code = 'ГД. 00.' +YEAR (Yr).
Otherwise, if RegnId contains a value, then the tax period code = RegnId.
If RegnId, FrDt, Yr, Tp are not filled in, then the tax period code = 0.
Where:
-
FrDt - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt - date of the tax period
-
Yr - PmtInf. CdtTrfTxInf. Tax.Rcrd.Prd.Yr - year of the tax period
-
Tp - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Tp - tax period
-
RegnId - PmtInf.CdtTrfTxInf.Tax.Cdtr.RegnId - code of the tax authority (ToDt - Not used, specified to comply with the format)
Example:
-
12.03.2016
-
ГД.00.2016
-
ПЛ.01.2015
-
КВ.03.2016
-
МС.10.2014
-
10001010
Answer
The response is an XML document corresponding to the scheme pain. 002.001.06.
HTTP code | Type | Body |
---|---|---|
200 |
OK |
- |
401 |
Err |
Wrong username or password |
401 |
Err |
User was not found |
401 |
Err |
User is disabled |
401 |
Err |
Warrant is expired |
401 |
Err |
Warrant was not found |
401 |
Err |
Warrant service error |
406 |
Err |
User does not have permission |
406 |
Err |
Signature is missing |
406 |
Err |
Certificate is not valid |
406 |
Err |
Signature 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 |
MsgId is not unique |
400 |
Err |
XML does not match schema |
Example of a payment with a signature
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06">
<CstmrCdtTrfInitn>
<GrpHdr>
<MsgId>TEST_MSG_2021-03-18-105554812</MsgId>
<CreDtTm>2021-03-18T10:55:54.812</CreDtTm>
<NbOfTxs>1</NbOfTxs>
<CtrlSum>100.00</CtrlSum>
<InitgPty>
<Nm>ООО "Мир Технологий"</Nm>
<Id>
<OrgId>
<Othr>
<Id>6315016823</Id>
<SchmeNm>
<Prtry>TXID</Prtry>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</InitgPty>
<FwdgAgt>
<FinInstnId>
<BICFI>ALFARUMMXXX</BICFI>
<Nm>АО АЛЬФА-БАНК</Nm>
</FinInstnId>
</FwdgAgt>
</GrpHdr>
<PmtInf>
<PmtInfId>TEST_PCT_2021-03-18-105554812</PmtInfId>
<PmtMtd>TRF</PmtMtd>
<PmtTpInf>
<SvcLvl>
<Cd>NURG</Cd>
</SvcLvl>
</PmtTpInf>
<ReqdExctnDt>2021-03-18</ReqdExctnDt>
<Dbtr>
<Nm>ООО "Мир Технологий"</Nm>
<PstlAdr>
<Ctry>RU</Ctry>
<AdrLine>//ул Дачная, д.24, кв./оф.23, г.Москва, Россия 111111//</AdrLine>
</PstlAdr>
<Id>
<OrgId>
<Othr>
<Id>6315016823</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40702810001300013144</Id>
<SchmeNm>
<Cd>BBAN</Cd>
</SchmeNm>
</Othr>
</Id>
<Ccy>RUB</Ccy>
</DbtrAcct>
<DbtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО АЛЬФА-БАНК</Nm>
<PstlAdr>
<Ctry>RU</Ctry>
</PstlAdr>
</FinInstnId>
</DbtrAgt>
<DbtrAgtAcct>
<Id>
<Othr>
<Id>30101810200000000593</Id>
</Othr>
</Id>
</DbtrAgtAcct>
<CdtTrfTxInf>
<PmtId>
<InstrId>TEST_PMT_2021-03-18-105554812</InstrId>
<EndToEndId>105554</EndToEndId>
</PmtId>
<PmtTpInf>
<SvcLvl>
<Cd>NURG</Cd>
</SvcLvl>
</PmtTpInf>
<Amt>
<InstdAmt Ccy="RUR">100</InstdAmt>
</Amt>
<ChrgBr>DEBT</ChrgBr>
<CdtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО АЛЬФА-БАНК</Nm>
<PstlAdr>
<Ctry>RU</Ctry>
</PstlAdr>
</FinInstnId>
</CdtrAgt>
<CdtrAgtAcct>
<Id>
<Othr>
<Id>30101810200000000593</Id>
</Othr>
</Id>
</CdtrAgtAcct>
<Cdtr>
<Nm>ООО УК"Альфа-Капитал"Д.У.</Nm>
<PstlAdr>
<Ctry>RU</Ctry>
</PstlAdr>
<Id>
<OrgId>
<Othr>
<Id>7728142469</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>40701810301600000105</Id>
<SchmeNm>
<Cd>BBAN</Cd>
</SchmeNm>
</Othr>
</Id>
</CdtrAcct>
<Purp>
<Prtry>5</Prtry>
</Purp>
<RgltryRptg>
<Dtls>
<Tp>PTCD</Tp>
<Cd>1</Cd>
</Dtls>
</RgltryRptg>
<Tax>
<Cdtr>
<RegnId>03.10.2020</RegnId>
<TaxTp>772901001</TaxTp>
</Cdtr>
<Dbtr>
<TaxTp>631501001</TaxTp>
</Dbtr>
<AdmstnZn>45286580</AdmstnZn>
<RefNb>0</RefNb>
<Dt>2021-03-03</Dt>
<Rcrd>
<Ctgy>ТП</Ctgy>
<CtgyDtls>18210601010031000110</CtgyDtls>
<DbtrSts>01</DbtrSts>
</Rcrd>
</Tax>
<RmtInf>
<Ustrd>тестирование</Ustrd>
<Ustrd>h2h</Ustrd>
<Strd>
<RfrdDocInf>
<Tp>
<CdOrPrtry>
<Prtry>POD</Prtry>
</CdOrPrtry>
</Tp>
<RltdDt>2021-03-18</RltdDt>
</RfrdDocInf>
<CdtrRefInf>
<Ref>0</Ref>
</CdtrRefInf>
<AddtlRmtInf>тестирование h2h</AddtlRmtInf>
</Strd>
</RmtInf>
</CdtTrfTxInf>
</PmtInf>
<SplmtryData>
<Envlp>
<SgntrSt>
<ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="sigID1"><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>pap8FDxMME9531uyzJux2dgyxrtkys1/xjwReMGAd/Q=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>kw88NbkHSzbewaaMAvkzwUT/PIcLP3ZKmqslmDFm4DKwBtHwqXZzQlZ6ovjo+6Om0VM2yhnV2Q8AY7n7srOYdQ==</ds:SignatureValue><ds:KeyInfo><ds:X509Data><ds:X509Certificate>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</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></SgntrSt>
</Envlp>
</SplmtryData>
</CstmrCdtTrfInitn>
</Document>
Example of a payment status pain. 002.001. 06
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
<CstmrPmtStsRpt>
<GrpHdr>
<MsgId>3c402c01c9b849a0ac5c0434299aecc1</MsgId>
<CreDtTm>2019-01-30T16:13:24.665+03:00</CreDtTm>
<InitgPty>
<Id>
<OrgId>
<AnyBIC>ALFARUMM</AnyBIC>
<Othr>
<Id>044525593</Id>
</Othr>
</OrgId>
</Id>
</InitgPty>
</GrpHdr>
<OrgnlGrpInfAndSts>
<OrgnlMsgId>0b94215ea5604a5ab00aad436dad0900</OrgnlMsgId>
<OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
<OrgnlCreDtTm>2019-01-29T15:25:53.000+03:00</OrgnlCreDtTm>
<GrpSts>RCVD</GrpSts>
</OrgnlGrpInfAndSts>
<OrgnlPmtInfAndSts>
<OrgnlPmtInfId>PKG31d00a62a203465095f93ed1c924ca67</OrgnlPmtInfId>
<PmtInfSts>RCVD</PmtInfSts>
<TxInfAndSts>
<OrgnlInstrId>PMTec020f8f93884a8baad2361eaf13f70b</OrgnlInstrId>
<TxSts>ACTC</TxSts>
</TxInfAndSts>
</OrgnlPmtInfAndSts>
</CstmrPmtStsRpt>
</Document>
Electronic signature
An electronic signature is generated by the algorithm GOST R 34.10-2012 (256 and 512 bits) according to the XMLDSig standard. The Signature section, which contains the XMLDSig-generated EP, is placed in the SgntrSt section inside the SplmtryData section, which is designed to accommodate arbitrary data. Each Signature section contains a link to the section to be signed (s) inside the xml document. The message must be fully signed, including the section
<SplmtryData>
<Envlp>
<SgntrSt>
</SgntrSt>
</Envlp>
</SplmtryData>
General recommendations for generating an XMLDSig signature:
1) You can use a certified combination of the cryptographic provider CryptoPro CSP and the API from Java to it CryptoPro JavaCSP, but you must specify JavaCSP in your software
2)You can use CryptoPro JCP 2.0. There is .jar with examples: samples.jar samples-sources.jar including xmlSign in its distribution.
When you sign with two keys, you should sign only the data. When you sign with the second signature, the first signature is not signed
To avoid the "UnrecoverableKeyException: Get Key failed" error, you need to transfer the keys and certificate from the * .pfx repository to the HDImageStore repository (this will be a folder with 6 * .key files), which Java distinguishes with installed CryptoPro (more details https://www.cryptopro.ru/forum2/default.aspx?g=posts&t=8271)
Examples of implementation and signed documents: https://github.com/alfa-laboratory/iso20022-signature
Signature Formation Example
<CstmrCdtTrfInitn>
...
<SplmtryData>
<Envlp>
<SgntrSt>
<Signature хmlns="http://www.w3.org/2000/09/xmldsig#">
{ЭП #1 …}
</Signature>
<Signature хmlns="http://www.w3.org/2000/09/xmldsig#">
{ЭП #2 …}
</Signature>
</SgntrSt>
</Envlp>
</SplmtryData>
</CstmrCdtTrfInitn>
Example request summary extract with signature
<?xml version="1.0" encoding="UTF-8"?><p:Document xmlns:p="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03 xsd/camt.060.001.03.xsd ">
<p:AcctRptgReq>
<p:GrpHdr>
<p:MsgId>MSG_20170830_test_55</p:MsgId>
<p:CreDtTm>2017-05-26T12:00:00</p:CreDtTm>
</p:GrpHdr>
<p:RptgReq>
<p:Id>REQ_20170830_test_55</p:Id>
<p:ReqdMsgNmId>HMQSTASCF</p:ReqdMsgNmId>
<p:Acct>
<p:Id>
<p:Othr>
<p:Id>40702810001300013144</p:Id>
</p:Othr>
</p:Id>
</p:Acct>
<p:AcctOwnr>
<p:Pty>
<p:Nm>ООО "Мир Технологий"</p:Nm>
</p:Pty>
</p:AcctOwnr>
<p:RptgPrd>
<p:FrToDt>
<p:FrDt>2017-02-23</p:FrDt>
<p:ToDt>2017-02-23</p:ToDt>
</p:FrToDt>
<p:FrToTm>
<p:FrTm>00:00:00</p:FrTm>
<p:ToTm>24:00:00</p:ToTm>
</p:FrToTm>
<p:Tp>ALLL</p:Tp>
</p:RptgPrd>
</p:RptgReq>
<p:RptgReq>
<p:Id>REQ_20170830_test_56</p:Id>
<p:ReqdMsgNmId>HMQSTASCF</p:ReqdMsgNmId>
<p:Acct>
<p:Id>
<p:Othr>
<p:Id>40702810100000000921</p:Id>
</p:Othr>
</p:Id>
</p:Acct>
<p:AcctOwnr>
<p:Pty>
<p:Nm>ООО "Мир Технологий"</p:Nm>
</p:Pty>
</p:AcctOwnr>
<p:RptgPrd>
<p:FrToDt>
<p:FrDt>2017-02-23</p:FrDt>
<p:ToDt>2017-02-23</p:ToDt>
</p:FrToDt>
<p:FrToTm>
<p:FrTm>00:00:00</p:FrTm>
<p:ToTm>24:00:00</p:ToTm>
</p:FrToTm>
<p:Tp>ALLL</p:Tp>
</p:RptgPrd>
</p:RptgReq>
<p:SplmtryData>
<p:Envlp>
<SgntrSt>
<ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="sigID1">
<ds:SignedInfo>
<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
<ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411"/>
<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="http://www.w3.org/2001/04/xmldsig-more#gostr3411"/>
<ds:DigestValue>ALQVhJd+YufeR5ebo1dFcv5Fdv0eqSSNWfEOm2soDrU=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>
S3XOmm7Mm4CnzXRng7gXTuMLuuOsQ1BcKVJz43NZHtd28hnBUR6uojAvQBE4bLhR9lxMioagvQF0
fP81BHvEUw==
</ds:SignatureValue>
<ds:KeyInfo>
<ds:X509Data>
<ds:X509Certificate>
MIIDcjCCAyGgAwIBAgITEgAewCrzlZtxaIf/EAAAAB7AKjAIBgYqhQMCAgMwfzEjMCEGCSqGSIb3
DQEJARYUc3VwcG9ydEBjcnlwdG9wcm8ucnUxCzAJBgNVBAYTAlJVMQ8wDQYDVQQHEwZNb3Njb3cx
FzAVBgNVBAoTDkNSWVBUTy1QUk8gTExDMSEwHwYDVQQDExhDUllQVE8tUFJPIFRlc3QgQ2VudGVy
IDIwHhcNMTcwNzI4MDgxNzIzWhcNMTcxMDI4MDgyNzIzWjCBgDEeMBwGCSqGSIb3DQEJARYPaXZh
bm92QGl2YW4uY29tMRYwFAYDVQQDDA1jZXJ0aWZpY2F0ZTA3MQwwCgYDVQQLDANkZXAxDDAKBgNV
BAoMA29yZzENMAsGA1UEBwwEY2l0eTEOMAwGA1UECAwFc3RhdGUxCzAJBgNVBAYTAlJVMGMwHAYG
KoUDAgITMBIGByqFAwICIwEGByqFAwICHgEDQwAEQHMSlGtvqSHl25faa9kJ2M4PckhXZZReBvRX
dbHwXWB0omjM6mwi2Kt72GdVcg/JJKXG6/xEyOdyXfgGMIsjAYOjggFwMIIBbDAOBgNVHQ8BAf8E
BAMCBsAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwHQYDVR0OBBYEFBLW6VyxD2CMbq8kKTZE/7G+dHCF
MB8GA1UdIwQYMBaAFBUxfLCNGt5m1xWcSVKXFyS5AXqDMFkGA1UdHwRSMFAwTqBMoEqGSGh0dHA6
Ly90ZXN0Y2EuY3J5cHRvcHJvLnJ1L0NlcnRFbnJvbGwvQ1JZUFRPLVBSTyUyMFRlc3QlMjBDZW50
ZXIlMjAyLmNybDCBqQYIKwYBBQUHAQEEgZwwgZkwYQYIKwYBBQUHMAKGVWh0dHA6Ly90ZXN0Y2Eu
Y3J5cHRvcHJvLnJ1L0NlcnRFbnJvbGwvdGVzdC1jYS0yMDE0X0NSWVBUTy1QUk8lMjBUZXN0JTIw
Q2VudGVyJTIwMi5jcnQwNAYIKwYBBQUHMAGGKGh0dHA6Ly90ZXN0Y2EuY3J5cHRvcHJvLnJ1L29j
c3Avb2NzcC5zcmYwCAYGKoUDAgIDA0EAL9Hgr5aVBQ1FYVbEHBIjbejchr4RO09Sr05AAORWwGhv
x7BO717qODeZl3uKX4oRaJ6EIZJW0yyvE6VwnE7h+Q==
</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</ds:Signature></SgntrSt>
</p:Envlp>
</p:SplmtryData>
</p:AcctRptgReq>
</p:Document>