Платёжное поручение
URI
POST: /API/v1/ISO20022/Payments
XML схема
pain.001.001.06
Описание схемы
Описание | Путь | Комментарий Пример |
||
---|---|---|---|---|
1 |
R |
Дата и Время создания сообщения |
Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm |
Формат даты YYYY-MM-DDTHH:MM:SS 2018-11-27T17:13:45 |
2 |
R |
Уникальный id сообщения |
Document.CstmrCdtTrfInitn.GrpHdr.MsgId |
Указывается идентификатор сообщения присвоенный во внешней системе. |
3 |
R |
Количество транзакций в сообщении |
Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs |
Общее число поручений (секций CdtTrfTxInf) в сообщении |
4 |
R |
Уникальный id пакета платежей |
Document.CstmrCdtTrfInitn.PmtInf.PmtInfId |
Указывается идентифкатор группы распоряжений. Идентификатор не должен совпадать с MsgId и другими идентификаторами |
5 |
R |
Уникальный id платежа |
Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId |
Идентифкатор исходного поручения |
6 |
R |
Метод оплаты |
Document.CstmrCdtTrfInitn.PmtInf.PmtMtd |
Значение "TRF" по умолчанию |
7 |
R |
Подпись 1 |
SplmtryData.Envlp.Signature. |
|
8 |
O |
Подпись n |
SplmtryData.Envlp.Signature. |
Описание | Путь | Комментарий Пример |
||
---|---|---|---|---|
Document.CstmrCdtTrfInitn.PmtInf |
||||
1 |
R |
Дата документа (4) |
CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt |
YYYY-MM-DD, если параметр не заполнен, считываем значение параметра ReqdExctnDt |
2 |
R |
Номер документа (3) |
CdtTrfTxInf.PmtId.EndToEndId |
Целое число до 6 символов. Уникальность номера в течение дня проверяется исходя из уникальности группы параметров: дата платежа, номер платежа, счет плательщика, счет получателя, сумма платежа. |
3 |
R |
Сумма документа |
CdtTrfTxInf.Amt.InstdAmt |
|
4 |
R |
Вид платежа (5) |
CdtTrfTxInf.PmtTpInf.SvcLvl.Cd |
Принимаемые значения: |
5 |
R |
Очередность платежа (21) |
CdtTrfTxInf.Purp.Prtry |
"HIGH" - отправлять на обработку в первую очередь "NORM" - отправлять во вторую очередь |
6 |
R |
Код платежа (22) |
CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref |
|
Назначение платежа (24) |
||||
7 |
O |
Признак валютной операции |
CdtTrfTxInf.RgltryRptg.Dtls.Tp |
Для валютных операций - константа Tp = "VO" |
8 |
O |
Код валютной операции |
CdtTrfTxInf.RgltryRptg.Dtls.Cd |
Обязателен, если указан Tp |
9 |
O |
Информация получателю |
CdtTrfTxInf.RmtInf.Ustrd[1..2] |
|
10 |
O |
Тип НДС |
CdtTrfTxInf.Tax.Rcrd.AddtlInf |
VTIN - Включая НДС; |
11 |
O |
Значение НДС |
CdtTrfTxInf.Tax.Rcrd.TaxAmt.Rate |
Обязателен, если AddtlInf = "VTIN" |
12 |
R |
Наименование плательщика (8) |
Dbtr.Nm |
|
13 |
R |
Наименование плательщика (8)* |
Dbtr.CtctDtls.Nm |
Заполняется в случае, если наименование плательщика больше 140 символов. |
14 |
R |
ИНН плательщика (60) |
Dbtr.Id.OrgId.Othr.Id |
|
15 |
O |
КПП плательщика (102) |
CdtTrfTxInf.Tax.Dbtr.TaxTp |
|
16 |
R |
Счет плательщика (9) |
DbtrAcct.Id.Othr.Id |
|
17 |
R |
БИК банка плательщика (11) |
DbtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
18 |
R |
Наименование банка плательщика (10) |
DbtrAgt.FinInstnId.Nm |
|
19 |
R |
Корсчет банка плательщика (12) |
DbtrAgtAcct.Id.Othr.Id |
|
20 |
R |
Наименование получателя (16) |
CdtTrfTxInf.Cdtr.Nm |
|
21 |
R |
ИНН получателя (61) |
CdtTrfTxInf.Cdtr.Id.OrgId.Othr.Id |
|
22 |
O |
КПП получателя (103) |
CdtTrfTxInf.Tax.Cdtr.TaxTp |
|
23 |
O |
Счет получателя (17) |
CdtTrfTxInf.CdtrAcct.Id.Othr.Id |
|
24 |
R |
БИК банка получателя (14) |
CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId |
|
25 |
R |
Наименование банка получателя (13) |
CdtTrfTxInf.CdtrAgt.FinInstnId.Nm |
|
26 |
R |
Корсчет банка получателя (15) |
CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id |
|
27 |
O |
Код вида дохода (20) |
CdtTrfTxInf.RgltryRptg.Dtls.Cd |
Также необходимо заполнить поле PmtInf.CdtTrfTxInf.RgltryRptg.Dtls.Tp = "PTCD"
Код "1" - при переводе денежных средств, являющихся заработной платой и (или) иными доходами, в отношении которых статьей 99 Федерального закона от 2.10.2007 N 229-ФЗ установлены ограничения размеров удержания. При наличии исполнительного документа укажите взысканную вами сумму в поле «Назначение платежа (24)». Код "2" - при переводе денежных средств, являющихся доходами, на которые в соответствии со статьей 101 Федерального закона от 2.10. 2007 N 229-ФЗ не может быть обращено взыскание, за исключением доходов, к которым в соответствии с частью 2 статьи 101 Федерального закона от 2.10.2007 N 229-ФЗ ограничения по обращению взыскания не применяются. Код "3" - при переводе денежных средств, являющихся доходами, к которым в соответствии с частью 2 статьи 101 Федерального закона от 2.10. 2007 N 229-ФЗ ограничения по обращению взыскания не применяются. При наличии исполнительного листа укажите в поле «Назначение платежа (24)» взысканную вами сумму. Обратите внимание, что по доходам с кодом 3 взыскания могут совершаться только по алиментным обязательствам в отношении несовершеннолетних лиц или по обязательствам о возмещении вреда в связи со смертью кормильца. В остальных случаях код не указывается Как указать взысканную сумму в поле «Назначение платежа (24)»? Если из переводимых физическому лицу денежных средств, составляющих доходы, указанные в ст. 99 или 101 Федерального закона "Об исполнительном производстве", вами произведено удержание по исполнительному документу, то в поле «Назначение платежа (24)» укажите взысканную сумму в формате: //ВЗС//рубли-копейки//. Например, //ВЗС//100000-00//. Закон и порядок Подробная информация в Федеральном законе от 21.02.2019 N 12-ФЗ "О внесении изменений в Федеральный закон "Об исполнительном производстве", Указании Банка России от 14.10.2019 N 5286-У "О порядке указания кода вида дохода в распоряжениях о переводе денежных средств |
28 |
O |
Код выплат (110) |
CdtTrfTxInf.Tax.Rcrd.Tp |
Чтобы корректно заполнить поле «Код выплат (110)», определите тип дохода, который получит физ. лицо в результате перевода. Если ваш платёж не подпадает под перечень из Постановления, код указывать не нужно. Код 1 проставляется в случае выплат на счёт физ. лица: 1. Пособия по временной нетрудоспособности (только в отношении граждан, подвергшихся воздействию радиации); 2. Пособия по беременности и родам; 3. Единовременного пособия женщинам, вставшим на учёт в медицинских организациях в ранние сроки беременности; 4. Единовременного пособия при рождении ребенка; 5. Ежемесячного пособия по уходу за ребёнком. Все виды доходов, подпадающих под код 1, перечислены в частях 5.5 и 5.6 статьи 30.5 Федерального закона «О национальной платёжной системе». В остальных случаях код не указывается. В случае некорректного заполнения поля возможны претензии со стороны физических лиц и/или контролирующих органов. Закон и порядок Подробная информация в статье 30.5 Закона РФ от 27.06.2011 № 161-ФЗ «О национальной платёжной системе», Постановлении Правительства РФ от 01.12.2018 № 1466 «Об утверждении перечня иных выплат за счет средств бюджетов бюджетной системы Российской Федерации для целей применения частей 5 и 5.1 статьи 30.5 Федерального закона «О национальной платежной системе» |
Бюджетные реквизиты платежного поручения |
||||
29 |
O |
Статус составителя документа (101) |
CdtTrfTxInf.Tax.Rcrd.DbtrSts |
|
30 |
O |
Код бюджетной классификации (104) |
CdtTrfTxInf.Tax.Rcrd.CtgyDtls |
|
31 |
O |
ОКТМО (105) |
CdtTrfTxInf.Tax.AdmstnZn |
|
32 |
O |
Код основания налогового платежа (106) |
CdtTrfTxInf.Tax.Rcrd.Ctgy |
|
33 |
O |
Номер налогового документа (108) |
CdtTrfTxInf.Tax.RefNb |
|
34 |
O |
Дата налогового документа (109) |
CdtTrfTxInf.Tax.Dt |
|
Реквизит "Код налогового периода (107)": код таможенного органа, показателя налогового периода, дата уплаты налогов. |
||||
35 |
O |
Дата уплаты налогов |
CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt |
Алгоритм обработки приведен ниже |
36 |
O |
Конец периода |
CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.ToDt |
Не используется, указывается только для соблюдения формата. |
37 |
O |
Год налогового периода |
CdtTrfTxInf.Tax.Rcrd.Prd.Yr |
|
38 |
O |
Налоговый период в кодировке ISO20022 |
CdtTrfTxInf.Tax.Rcrd.Prd.Tp |
MM - МС; |
39 |
O |
Код таможенного органа |
CdtTrfTxInf.Tax.Cdtr.RegnId |
Алгоритм обработки параметра "Код налогового периода (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.
HTTP код | Тип | 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 |
Id запроса неуникальный |
400 |
Err |
XML does not match schema |
Документ не соответствует схеме |
Пример платежа с подписью
<?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>
++++