Поручение на покупку валюты

URI

POST: /API/v1/ISO20022/ForeignExchanges

XSD схема

pain.001.001.06

Описание схемы

Документ является покупкой, если счет списания Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Id.Othr.Id является рублевым, а счет зачисления Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Id.Othr.Id является валютным.

Описание Путь Комментарий
Пример

R

Уникальный id сообщения

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

Указывается идентификатор сообщения присвоенный во внешней системе

R

Дата и Время создания сообщения

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

Формат даты YYYY-MM-DDTHH:MM:SS 2018-11-27T17:13:45

R

Количество транзакций в сообщении

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

Общий путь Document.CstmrCdtTrfInitn.PmtInf - Уровень пакета документов

R

Уникальный id пакета поручений на покупку валюты

Document.CstmrCdtTrfInitn.PmtInf.PmtInfId

Указывается идентифкатор группы поручений

R

Уникальный id поручения

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId

Идентифкатор исходного поручения

R

Метод оплаты

Document.CstmrCdtTrfInitn.PmtInf.PmtMtd

Значение "TRF" по умолчанию

R

Тип пакета документов

Document.CstmrCdtTrfInitn.PmtInf.PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

R

ИНН

Document.CstmrCdtTrfInitn.PmtInf.Dbtr.Id.OrgId.Othr.Id

R

Наименование организации

Document.CstmrCdtTrfInitn.PmtInf.Dbtr.Nm

Не более 140 символов

R

Р/с в валюте РФ для списания

Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Id.Othr.Id

R

Вид счета

Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Id.Other.SchmeNm.Cd

Константа 'BBAN'

R/O

Удерживать комиссию с р/с в валюте РФ

Document.CstmrCdtTrfInitn.PmtInf.ChrgsAcct.Id.Othr.Id

Указать счет списания комиссии (комиссия может быть включена в курс обмена). Обязательно, если поле "Удерживать комиссию" = DEBT

R

Срок действия поручения до

Document.CstmrCdtTrfInitn.PmtInf.ReqdExctnDt

Формат даты YYYY-MM-DD

O

Контактный телефон

Document.CstmrCdtTrfInitn.PmtInf.Dbtr.CtctDtls.PhneNb

O

ФИО сотрудника, уполномоченного на решение вопросов по сделке

Document.CstmrCdtTrfInitn.PmtInf.Dbtr.CtctDtls.Nm

O

Почтовый адрес

Document.CstmrCdtTrfInitn.PmtInf.Dbtr.PstlAdr.AdrLine

Общий путь Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf - Уровень поручения

R

Уникальный id поручения

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId

Указывается идентифкатор поручения

R

Номер документа

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.EndToEndId

R

Тип пакета документов

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

O

КПП

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.Tax.Dbtr.TaxTp

R

Р/с в ин.валюте для зачисления

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Id.Othr.Id

R

Код валюты

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Ccy

R

Удерживать комиссию

Document.CstmrCdtTrfInitn.PmtInf.ChrgBr или Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.ChrgBr

CRED - иное
DEBT -с расчетного счета в валюте РФ
SHAR - иное
Если указаны PmtInf.ChrgBr и CdtTrfTxInf.ChrgBr, используется из PmtInf.ChrgBr

R

Сумма покупки валюты

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.Amt.InstdAmt

Если требуется задать сумму покупаемой валюты, то поле CCY необходимо заполнить кодом покупаемой валюты, например:
<InstdAmt Ccy="USD">150</InstdAmt>

R

Сумма предварительно депонированных средств в валюте РФ

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.Amt.InstdAmt

Если неизвестно, сколько валюты требуется приобрести, но известно, сколько рублей требуется обменять, то поле CCY требуется задать кодом продаваемой валюты, например:
<InstdAmt Ccy="RUB">150</InstdAmt>

O

По курсу не выше

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.XchgRateInf.XchgRate

O

Реквизиты банка, в котором открыт р/с в ин.валюте

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

R

Тип курса

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.XchgRateInf.RateTp

SPOT - "по курсу Банка"
AGRD - "по курсу Дилера ТОМ"
SALE - "по текущему курсу АЛЬФА-ФОРЕКС TOD"

R

Дата документа

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

Формат даты YYYY-MM-DD

R

Подпись 1

SplmtryData.Envlp.Signature.

O

Подпись n

SplmtryData.Envlp.Signature.

Пример: Покупка валюты
<?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">
        <CstmrCdtTrfInitn>
                <GrpHdr>
                        <MsgId>test_getval_010128_4</MsgId>
                        <CreDtTm>2020-01-28T11:00:10+04:00</CreDtTm>
                        <NbOfTxs>1</NbOfTxs>
                        <InitgPty>
                                <Nm>ООО "Мир технологий"</Nm>
                                <Id>
                                        <OrgId>
                                                <Othr>
                                                        <Id>6315016823</Id>
                                                        <SchmeNm>
                                                                <Cd>TXID</Cd>
                                                        </SchmeNm>
                                                </Othr>
                                        </OrgId>
                                </Id>
                        </InitgPty>
                </GrpHdr>
                <PmtInf>
                        <PmtInfId>test_getval_010128_4</PmtInfId>
                        <PmtMtd>TRF</PmtMtd>
                        <PmtTpInf>
                                <InstrPrty>NORM</InstrPrty>
                                <SvcLvl>
                                        <Cd>NURG</Cd>
                                </SvcLvl>
                                <LclInstrm>
                                        <Prtry>RU-FX</Prtry>
                                </LclInstrm>
                        </PmtTpInf>
                        <ReqdExctnDt>2020-01-28</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>
                                <CtctDtls>
                                <Nm>Иванов Иван Иванович</Nm>
                                <PhneNb>+7-495-000-00-00</PhneNb>
                                </CtctDtls>
                        </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>
                        <ChrgsAcct>
                                        <Id>
                                                <Othr>
                                                        <Id>40702810001300013144</Id>
                                                </Othr>
                                        </Id>
                                </ChrgsAcct>
                        <CdtTrfTxInf>
                                <PmtId>
                                        <InstrId>test_getval_010128_4</InstrId>
                                        <EndToEndId>00095</EndToEndId>
                                </PmtId>
                                <PmtTpInf>
                                        <LclInstrm>
                                                <Prtry>RU-FX</Prtry>
                                        </LclInstrm>
                                </PmtTpInf>
                                <Amt>
                                        <InstdAmt Ccy="RUB">90.85</InstdAmt>
                    <!-- или <InstdAmt Ccy="USD">90.85</InstdAmt>-->
                                </Amt>
                                <XchgRateInf>
                                        <XchgRate>13.00</XchgRate>
                                        <RateTp>AGRD</RateTp>
                                </XchgRateInf>
                                <ChrgBr>CRED</ChrgBr>
                                <CdtrAgt>
                                        <FinInstnId>
                                                <ClrSysMmbId>
                                                        <ClrSysId>
                                                                <Cd>RUCBC</Cd>
                                                        </ClrSysId>
                                                        <MmbId>044525593</MmbId>
                                                </ClrSysMmbId>
                                                <Nm>АО "АЛЬФА-БАНК"</Nm>
                                                <PstlAdr>
                                                        <Ctry>RU</Ctry>
                                                </PstlAdr>
                                        </FinInstnId>
                                </CdtrAgt>
                                <Cdtr>
                                        <Nm>ООО "Мир технологий"</Nm>
                                        <PstlAdr>
                                                <Ctry>RU</Ctry>
                                        </PstlAdr>
                                        <Id>
                                                <OrgId>
                                                        <Othr>
                                                                <Id>6315016823</Id>
                                                                <SchmeNm>
                                                                        <Cd>TXID</Cd>
                                                                </SchmeNm>
                                                        </Othr>
                                                </OrgId>
                                        </Id>
                                </Cdtr>
                                <CdtrAcct>
                                        <Id>
                                                <Othr>
                                                        <Id>40702840101850000001</Id>
                                                        <SchmeNm>
                                                                <Cd>BBAN</Cd>
                                                        </SchmeNm>
                                                </Othr>
                                        </Id>
                                        <Ccy>USD</Ccy>
                                </CdtrAcct>
                                <RgltryRptg>
                                        <DbtCdtRptgInd>DEBT</DbtCdtRptgInd>
                                </RgltryRptg>
                                <Tax>
                                        <Dbtr>
                                                <TaxTp>631501001</TaxTp>
                                        </Dbtr>
                                </Tax>
                                <RmtInf>
                                        <Ustrd>Покупка RUB - USD</Ustrd>
                                        <Strd>
                                                <RfrdDocInf>
                                                        <Tp>
                                                                <CdOrPrtry>
                                                                        <Prtry>POD</Prtry>
                                                                </CdOrPrtry>
                                                        </Tp>
                                                        <RltdDt>2020-01-28</RltdDt>
                                                </RfrdDocInf>
                                        </Strd>
                                </RmtInf>
                        </CdtTrfTxInf>
                </PmtInf>
                <SplmtryData>
                        <Envlp>
                                <SgntrSt>
                                </SgntrSt>
                        </Envlp>
                </SplmtryData>
        </CstmrCdtTrfInitn>
</Document>

Ответ

Ответом является XML-документ, соответвующий схеме pain.002.001.06.