Платёжное поручение
URI
POST: /API/v1/ISO20022/Payments
XML схема
pain.001.001.06
Описание схемы
Описание | Путь | Комментарий Пример |
|
---|---|---|---|
R |
Дата и Время создания сообщения |
Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm |
Формат даты YYYY-MM-DDTHH:MM:SS 2018-11-27T17:13:45 |
R |
Уникальный id сообщения |
Document.CstmrCdtTrfInitn.GrpHdr.MsgId |
Указывается идентификатор сообщения присвоенный во внешней системе. |
R |
Количество транзакций в сообщении |
Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs |
Общее число поручений (секций CdtTrfTxInf) в сообщении |
R |
Уникальный id пакета платежей |
Document.CstmrCdtTrfInitn.PmtInf.PmtInfId |
Указывается идентифкатор группы распоряжений. Идентификатор не должен совпадать с MsgId и другими идентификаторами |
R |
Уникальный id платежа |
Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId |
Идентифкатор исходного поручения |
R |
Метод оплаты |
Document.CstmrCdtTrfInitn.PmtInf.PmtMtd |
Значение "TRF" по умолчанию |
R |
Подпись 1 |
SplmtryData.Envlp.Signature. |
|
O |
Подпись n |
SplmtryData.Envlp.Signature. |
Описание | Путь | Комментарий Пример |
---|---|---|
Document.CstmrCdtTrfInitn.PmtInf |
||
Дата документа (4) |
PmtInf.CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt |
YYYY-MM-DD, если параметр не заполнен, считываем значение параметра ReqdExctnDt |
Номер документа (3) |
CdtTrfTxInf.PmtId.EndToEndId |
Целое число до 6 символов. Уникальность номера в течение дня проверяется исходя из уникальности группы параметров: дата платежа, номер платежа, счет плательщика, счет получателя, сумма платежа. |
Сумма документа |
CdtTrfTxInf.Amt.InstdAmt |
|
Вид платежа (5) |
CdtTrfTxInf.PmtTpInf.SvcLvl.Cd |
Принимаемые значения: |
Очередность платежа (21) |
CdtTrfTxInf.Purp.Prtry |
"HIGH" - отправлять на обработку в первую очередь "NORM" - отправлять во вторую очередь |
Код (22) |
CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref |
|
Назначение платежа (20). |
||
Признак валютной операции |
CdtTrfTxInf.RgltryRptg.Dtls.Tp |
Tp = "VO" |
Код валютной операции |
CdtTrfTxInf.RgltryRptg.Dtls.Cd |
Обязателен, если указан Tp |
Информация получателю |
CdtTrfTxInf.RmtInf.Ustrd[1..2] |
|
Тип НДС |
CdtTrfTxInf.Tax.Rcrd.AddtlInf |
VTIN - Включая НДС; |
Значение НДС |
CdtTrfTxInf.Tax.Rcrd.TaxAmt.Rate |
Обязателен, если AddtlInf = "VTIN" |
Наименование плательщика (8) |
Dbtr.Nm |
|
Наименование плательщика (8)* |
Dbtr.CtctDtls.Nm |
Заполняется в случае, если наименование плательщика больше 140 символов. |
ИНН плательщика (60) |
Dbtr.Id.OrgId.Othr.Id |
|
КПП плательщика (102) |
CdtTrfTxInf.Tax.Dbtr.TaxTp |
|
Счет плательщика (9) |
DbtrAcct.Id.Othr.Id |
|
БИК банка плательщика (11) |
DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
Наименование банка плательщика (10) |
DbtrAgt.FinInstnId.Nm |
|
Корсчет банка плательщика (12) |
DbtrAgtAcct.Id.Othr.Id |
|
Наименование получателя (16) |
CdtTrfTxInf.Cdtr.Nm |
|
ИНН получателя (61) |
CdtTrfTxInf.Cdtr.Id.OrgId.Othr.Id |
|
КПП получателя (103) |
CdtTrfTxInf.Tax.Cdtr.TaxTp |
|
Счет получателя (17) |
CdtTrfTxInf.CdtrAcct.Id.Othr.Id |
|
БИК банка получателя (14) |
CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
Наименование банка получателя (13) |
CdtTrfTxInf.CdtrAgt.FinInstnId.Nm |
|
CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id |
Корсчет банка получателя (15) |
|
Бюджетные реквизиты платежного поручения |
||
Статус составителя документа (101) |
CdtTrfTxInf.Tax.Rcrd.DbtrSts |
|
Код бюджетной классификации (104) |
CdtTrfTxInf.Tax.Rcrd.CtgyDtls |
|
ОКТМО (105) |
CdtTrfTxInf.Tax.AdmstnZn |
|
Код основания налогового платежа (106) |
CdtTrfTxInf.Tax.Rcrd.Ctgy |
|
Реквизит 107: код таможенного органа, показателя налогового периода, дата уплаты налогов. |
||
Дата уплаты налогов |
CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt |
Алгоритм обработки приведен ниже |
Конец периода |
CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.ToDt |
Не используется, указывается только для соблюдения формата. |
Год налогового периода |
CdtTrfTxInf.Tax.Rcrd.Prd.Yr |
|
Налоговый период в кодировке ISO20022 |
CdtTrfTxInf.Tax.Rcrd.Prd.Tp |
MM - МС; |
Код таможенного органа |
CdtTrfTxInf.Tax.Cdtr.RegnId |
|
Номер налогового документа (108) |
CdtTrfTxInf.Tax.RefNb |
|
Дата налогового документа (109) |
CdtTrfTxInf.Tax.Dt |
Алгоритм обработки параметра "Код налогового периода (107)" на стороне банка
Если FrDt содержит значение, то необходимо FrDt, преобразовать к формату ДД.ММ.ГГГГ. Иначе:
-
Если Tp начинается с 'MM', то Код налогового периода = ''МС.'+substring(Tp,3,2)+YEAR(Yr);
-
Если Tp начинается с 'QTR', Код налогового периода = ''КВ.0'+substring(Tp,4,1)+YEAR(Yr);
-
Если Tp начинается с 'HLF', Код налогового периода = ''ПЛ.0'+substring(Tp,4,1)+YEAR(Yr);
-
Если Tp не указано, то Код налогового периода = 'ГД.00.'+YEAR(Yr). Иначе, если RegnId содержит значение, то Код налогового периода = RegnId. Если не заполнены RegnId, FrDt, Yr, Tp, то Код налогового периода = 0. Где: FrDt - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt - дата налогового периода Yr - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Yr - год налогового периода Tp - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Tp - налоговый период RegnId - PmtInf.CdtTrfTxInf.Tax.Cdtr.RegnId - код налогового органа (прим. ToDt - Не используется, указывается для соблюдения формата)
Пример:
12.03.2016
ГД.00.2016
ПЛ.01.2015
КВ.03.2016
МС.10.2014
10001010
Ответ
Ответом является XML-документ, соответвующий схеме pain.002.001.06.
Пример платежа с подписью
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<CstmrCdtTrfInitn>
<GrpHdr>
<MsgId>9703ab757ffe418a9118b9e538e2f2e6</MsgId>
<CreDtTm>2019-01-29T12:25:53.0000000</CreDtTm>
<NbOfTxs>1</NbOfTxs>
<CtrlSum>58.00</CtrlSum>
<InitgPty>
<Nm>АО "ДИСКИ"</Nm>
<Id>
<OrgId>
<Othr>
<Id>5036045205</Id>
<SchmeNm>
<Prtry>CFTBIC</Prtry>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</InitgPty>
</GrpHdr>
<PmtInf>
<PmtInfId>PKG8922c37e1e564965be5c4220680fff75</PmtInfId>
<PmtMtd>TRF</PmtMtd>
<NbOfTxs>1</NbOfTxs>
<ReqdExctnDt>2019-01-29</ReqdExctnDt>
<Dbtr>
<Nm>ОАО "ДИСКИ"</Nm>
<Id>
<OrgId>
<Othr>
<Id>5036045205</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40702810901300013000</Id>
</Othr>
</Id>
<Ccy>RUB</Ccy>
</DbtrAcct>
<DbtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО "АЛЬФА-БАНК", Г МОСКВА, УЛ КАЛАНЧЁВСКАЯ, 27</Nm>
<PstlAdr>
<Ctry>RU</Ctry>
</PstlAdr>
</FinInstnId>
</DbtrAgt>
<DbtrAgtAcct>
<Id>
<Othr>
<Id>30101810200000000593</Id>
<SchmeNm>
<Cd>BBAN</Cd>
</SchmeNm>
</Othr>
</Id>
</DbtrAgtAcct>
<CdtTrfTxInf>
<PmtId>
<InstrId>PMTebe7f52168b84c55a9d3419e95c006e7</InstrId>
<EndToEndId>85114</EndToEndId>
</PmtId>
<PmtTpInf>
<SvcLvl>
<Cd>NURG</Cd>
</SvcLvl>
</PmtTpInf>
<Amt>
<InstdAmt Ccy="RUB">58.00</InstdAmt>
</Amt>
<ChrgBr>DEBT</ChrgBr>
<CdtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО "АЛЬФА-БАНК", Г МОСКВА, УЛ КАЛАНЧЁВСКАЯ, 27</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>5036045205</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>40702810001850000500</Id>
<SchmeNm>
<Cd>BBAN</Cd>
</SchmeNm>
</Othr>
</Id>
</CdtrAcct>
<Purp>
<Prtry>5</Prtry>
</Purp>
<Tax>
<Cdtr>
<TaxTp>509950001</TaxTp>
</Cdtr>
<Dbtr>
<TaxTp>997350001</TaxTp>
</Dbtr>
</Tax>
<RmtInf>
<Ustrd>Пополнение расчетного счета предприятия для текущей деятельности. НДС не облагается</Ustrd>
<Strd>
<RfrdDocInf>
<Tp>
<CdOrPrtry>
<Prtry>POD</Prtry>
</CdOrPrtry>
</Tp>
<RltdDt>2019-01-29</RltdDt>
</RfrdDocInf>
</Strd>
</RmtInf>
</CdtTrfTxInf>
</PmtInf>
<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>41oYHqGcb3FQN+/ouYfrhrgNVywZiJIx2YKgCPILYmg=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>NUGY+R8KqtLZZ3gonWBawbVfx17gC4vW3E7/oISjLtQDfPoBIgCVywxMmLbDjHZ3
IUNwSTZBG5uwTM/fKJqafA==</ds:SignatureValue>
<ds:KeyInfo>
<ds:X509Data>
<ds:X509Certificate>MIIDZzCCAxagAwIBAgITEgAvajwQ6+aBm0dZ1AAAAC9qPDAIBgYqhQMCAgMwfzEj
MCEGCSqGSIb3DQEJARYUc3VwcG9ydEBjcnlwdG9wcm8ucnUxCzAJBgNVBAYTAlJV
MQ8wDQYDVQQHEwZNb3Njb3cxFzAVBgNVBAoTDkNSWVBUTy1QUk8gTExDMSEwHwYD
VQQDExhDUllQVE8tUFJPIFRlc3QgQ2VudGVyIDIwHhcNMTgxMTIxMDg0MDA5WhcN
MTkwMjIxMDg1MDA5WjB2MRswGQYJKoZIhvcNAQkBFgxtYWlsQG1haWwucnUxDTAL
BgNVBAMMBE5SRDIxDTALBgNVBAsMBGRlcHQxDDAKBgNVBAoMA29yZzENMAsGA1UE
BwwEY2l0eTEPMA0GA1UECAwGcmVnaW9uMQswCQYDVQQGEwJSVTBjMBwGBiqFAwIC
EzASBgcqhQMCAiQABgcqhQMCAh4A0MABEBhJ8tNt//ZiUVpJdfGv1jaD7FmBFaR
du1AszW5HgBOBQEJbr50GRdq+9LtfSWCj0sX5kpscWxmPO8BXrvJmvxso4IBcDCC
AWwwDgYDVR0PAQH/BAQDAgTwMBMGA1UdJQQMMAoGCCsGAQUFBwMCMB0GA1UdDgQW
BBQsNWab0rMXh6+o8Sz0S7J5q+TPXDAfBgNVHSMEGDAWgBQVMXywjRreZtcVnElS
lxckuQF6gzBZBgNVHR8EUjBQME6gTKBKhkhodHRwOi8vdGVzdGNhLmNyeXB0b3By
by5ydS9DZXJ0RW5yb2xsL0NSWVBUTy1QUk8lMjBUZXN0JTIwQ2VudGVyJTIwMi5j
cmwwgakGCCsGAQUFBwEBBIGcMIGZMGEGCCsGAQUFBzAChlVodHRwOi8vdGVzdGNh
LmNyeXB0b3Byby5ydS9DZXJ0RW5yb2xsL3Rlc3QtY2EtMjAxNF9DUllQVE8tUFJP
JTIwVGVzdCUyMENlbnRlciUyMDIuY3J0MDQGCCsGAQUFBzABhihodHRwOi8vdGVz
dGNhLmNyeXB0b3Byby5ydS9vY3NwL29jc3Auc3JmMAgGBiqFAwICAwNBAFLI0inU
sUiMcl0WlXOL1M1r7cBg251dX5vuHDsTZSsKdfGJXJkZE2EV/QPWIeKOFnBEXACX
pao0IO/aIWRHeao=</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</ds:Signature>
</SgntrSt>
</Envlp>
</SplmtryData>
</CstmrCdtTrfInitn>
</Document>
Пример квитанции на платеж 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>
----
++++
</details>
++++