Платёжное поручение

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

Принимаемые значения:
URGP - срочный платеж
NURG - обычный платеж

Очередность платежа (21)

CdtTrfTxInf.Purp.Prtry

"HIGH" - отправлять на обработку в первую очередь "NORM" - отправлять во вторую очередь

Код (22)

CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref

Назначение платежа (20).
Длина строки ['{VO' + Код ВО + '}'] + [Информация получателю] + [Информация о НДС] не должна превышать 210 символов.

Признак валютной операции

CdtTrfTxInf.RgltryRptg.Dtls.Tp

Tp = "VO"

Код валютной операции

CdtTrfTxInf.RgltryRptg.Dtls.Cd

Обязателен, если указан Tp

Информация получателю

CdtTrfTxInf.RmtInf.Ustrd[1..2]

Тип НДС

CdtTrfTxInf.Tax.Rcrd.AddtlInf

VTIN - Включая НДС;
VTNA - НДС не облагается;
VTPS - Не включая НДС;
Либо может содержать другое значение.

Значение НДС

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 - МС;
QTR - КВ;
HLF - ПЛ;
не указано - ГД.

Код таможенного органа

CdtTrfTxInf.Tax.Cdtr.RegnId

Номер налогового документа (108)

CdtTrfTxInf.Tax.RefNb

Дата налогового документа (109)

CdtTrfTxInf.Tax.Dt

Алгоритм обработки параметра "Код налогового периода (107)" на стороне банка

Если FrDt содержит значение, то необходимо FrDt, преобразовать к формату ДД.ММ.ГГГГ. Иначе:

  1. Если Tp начинается с 'MM', то Код налогового периода = ''МС.'+substring(Tp,3,2)+YEAR(Yr);

  2. Если Tp начинается с 'QTR', Код налогового периода = ''КВ.0'+substring(Tp,4,1)+YEAR(Yr);

  3. Если Tp начинается с 'HLF', Код налогового периода = ''ПЛ.0'+substring(Tp,4,1)+YEAR(Yr);

  4. Если 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>
++++