Основные варианты использования
API позволяет осуществить:
- отправку в банк пакета неподписанных сведений о транзакциях в формате auth.024.001.03
Отправка неподписанных сведений о транзакциях в Банк
Чтобы загрузить сведения о транзакциях в банк, вам необходимо:
- получить AccessToken
- сгенерировать XML в формате auth.024.001.03 см. формат на странице Формат импорта
- отправить POST-запрос
- получить синхронный ответ с идентификатором текущей задачи
Загрузка неподписанных сведений о транзакциях
Запрос
| Запрос | POST /v1/iso20022/currency-transaction-certificate |
|---|---|
| Описание | Импорт неподписанных валютных платежей в формате auth.024.001.03 Примечание: с помощью одного POST /v1/iso20022/currency-transaction-certificate можно загрузить только одно сообщение в формате auth.024.001.03. Но сообщение может содержать несколько сведений о транзакциях |
| Content-Type | application/xml |
| Тело запроса | xml в формате auth.024.001.03 |
Ответ
Банк вернет синхронный ответ, который будет содержать:
- HTTP статус код в соответствии со стандартом
| HTTP статус код | Статус получения сообщения | Описание причины |
|---|---|---|
| 200 | Created | Задача на создание сведений о транзакции была успешно создана |
| 400 | Bad request | Ошибка валидации XML |
| 401 | Unauthorized | Ошибка авторизации |
| 403 | Forbidden | Доступ к запрошенному ресурсу запрещен |
| 409 | Conflict | Идентификатор сообщения или идентификатор транзакции дублируется |
| 500 | Internal Server Error | Произошла непредвиденная ошибка (недоступность сервера и т.д.) |
Пример тела запроса для создания сведений о валютной операции
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.024.001.03" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:auth.024.001.03 ../ISO_TRCE_03/auth.024.001.03.xsd">
<PmtRgltryInfNtfctn>
<GrpHdr>
<!--Идентификатор Сообщения. Инструктирующая сторона должна убедиться, что Идентификация сообщения уникальна для каждой инструктируемой стороны в течение заранее согласованного периода.-->
<MsgId>b9fbb41c-5711-4612-9d39-5a844d6aee2</MsgId>
<!--Дата и время создания сообщения-->
<CreDtTm>2024-10-01T10:10:10+02:00</CreDtTm>
<!--Число элементов в сообщении-->
<NbOfItms>1</NbOfItms>
<!--Секция: Отправитель сообщения-->
<InitgPty>
<Pty>
<!-- Наименование отправителя сообщения -->
<Nm>ООО 3ОАО НСГ ОАО</Nm>
<Id>
<!-- Секция: Идентификация компании -->
<OrgId>
<Othr>
<!-- ИНН/КИО отправителя -->
<Id>7867961169</Id>
<SchmeNm>
<!-- Код типа данных в поле Id (Обязательно к заполнению, если 2 и более секции <Othr>) -->
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
<CtctDtls>
<Nm>test name</Nm>
<PhneNb>+7-900-000-00-00</PhneNb>
</CtctDtls>
<!-- Секция: Контактная информация -->
</Pty>
</InitgPty>
</GrpHdr>
<!--Секция: Извещение о валютных операциях-->
<TxNtfctn>
<!-- Уникальный id пакета СВО во внешней системе -->
<TxNtfctnId>TESTRUMM-CTCNTF-20160503-001</TxNtfctnId>
<!--Секция: Владелец счета-->
<AcctOwnr>
<!-- Наименование владельца счета -->
<Nm>ООО 3ОАО НСГ ОАО</Nm>
<Id>
<OrgId>
<Othr>
<!-- ИНН/КИО владельца счета -->
<Id>7867961169</Id>
<SchmeNm>
<!-- Код типа данных в поле Id (Обязательно к заполнению, если 2 и более секции <Othr>) -->
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</AcctOwnr>
<!--Секция: Идентификация Финансовой организации-->
<AcctSvcr>
<FinInstnId>
<!--SWIFT-код банка клиента. Код, присвоенный финансовому учреждению регистрирующим органом ISO 9362-->
<BICFI>ABCDRUMMXXX</BICFI>
<!-- Секция: Идентификация в клиринговой системе -->
<ClrSysMmbId>
<!-- БИК банка, присвоенный ЦБ РФ-->
<MmbId>044525700</MmbId>
</ClrSysMmbId>
<!-- Наименование уполномоченного банка / Банк обслуживающий счет -->
<Nm>АО Raiffeisenbank</Nm>
</FinInstnId>
</AcctSvcr>
<!-- Секция: Справка о Валютных Операциях -->
<TxCert>
<!-- Уникальный идентификатор СВО -->
<TxId>TESTRUMM-CTCNTF-20160503-00101</TxId>
<Cert>
<!-- Номер документа по валютной операции -->
<Id>1</Id>
<!-- Дата составления СВО -->
<DtOfIsse>2024-10-01</DtOfIsse>
</Cert>
<!-- Счет, по которому прошла транзакция в рамках Паспорта Сделки -->
<Acct>
<Id>
<!-- Номер счета в формате IBAN (заполняется при наличии IBAN) -->
<!-- Если заполен IBAN, то секция Othr ниже не заполняется -->
<!-- <IBAN>DE89370400440532013000</IBAN> -->
<Othr>
<!-- Номер счета. Не заполняется, если заполнен IBAN строкой выше -->
<Id>40702810503000483656</Id>
<SchmeNm>
<!-- Код типа данных в поле Id (Обязательно к заполнению, если 2 и более секции <Othr>) -->
<Cd>BBAN</Cd>
</SchmeNm>
</Othr>
</Id>
</Acct>
<!-- Страна в которой открыт счет в случае если банк находится в другой стране -->
<BkAcctDmcltnCtry>US</BkAcctDmcltnCtry>
<!-- Секция: Информация о валютных платежах -->
<CertRcrd>
<!-- Номер строки СВО -->
<CertRcrdId>1</CertRcrdId>
<!--Секция: информация об операции(транзакции)-->
<Tx>
<!-- Секция: информация об исходном документе, на основании которого совершена операция или выписка по счету -->
<RfrdDoc>
<Id>
<!-- Идентификатор сообщения -->
<MsgId>3001</MsgId>
<!-- Референс транзакции, присвоенный банком -->
<AcctSvcrRef>RI201605010001</AcctSvcrRef>
<!-- Уникальный идентификатор для связи с ВП и РСТС -->
<!-- Чтобы установилась связь с ПП, ВП значение в этом теге должно совпадать со значением в теге /Document/CstmrCdtTrfInitn/PmtInf/PmtInfId в ПП, ВП -->
<PmtInfId>1cf2aaec-358c-43c4-b4ef-2acec53c2f7</PmtInfId>
<!-- Уникальный идентификатор платежной инструкции -->
<InstrId>345678</InstrId>
<!-- Идентификатор платежного поручения -->
<EndToEndId>79</EndToEndId>
</Id>
<!-- Дата документа, на основании которого совершена операция -->
<Dt>2024-09-30</Dt>
</RfrdDoc>
<!-- Дата транзакции/Дата операции -->
<TxDt>2024-10-01</TxDt>
<!-- Направление (признак) платежа: -->
<TxTp>1</TxTp>
<!-- Код валютной операции -->
<LclInstrm>11100</LclInstrm>
<!-- Сумма и валюта операции -->
<Amt Ccy="RUB">145400.03</Amt>
</Tx>
<!-- Секция: информация о транзакции относящаяся к контракту -->
<Ctrct>
<!-- Секция: информация о Контракте/Паспорте сделки -->
<CtrctRef>
<!-- Номер паспорта сделки -->
<RegdCtrctId>20020018/3292/0111/3/1</RegdCtrctId>
</CtrctRef>
<!-- Сумма и валюта операции в валюте контракта -->
<TxAmtInCtrctCcy Ccy="EUR">16500.00</TxAmtInCtrctCcy>
<!-- Ожидаемая дата поставки товара/услуги -->
<XpctdShipmntDt>2024-10-25</XpctdShipmntDt>
<!-- Ожидаемая дата возврата аванса -->
<XpctdAdvncPmtRtrDt>2024-10-25</XpctdAdvncPmtRtrDt>
<!-- Дополнительная информация -->
<AddtlInf>Примечание Test</AddtlInf>
</Ctrct>
</CertRcrd>
</TxCert>
</TxNtfctn>
</PmtRgltryInfNtfctn>
</Document>Пример тела запроса для корректировки сведений о валютной операции
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.024.001.03" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:auth.024.001.03 ../ISO_TRCE_03/auth.024.001.03.xsd">
<PmtRgltryInfNtfctn>
<GrpHdr>
<!--Идентификатор Сообщения. Инструктирующая сторона должна убедиться, что Идентификация сообщения уникальна для каждой инструктируемой стороны в течение заранее согласованного периода.-->
<MsgId>b9fbb41c-5711-4612-9d39-5a844d6aee2</MsgId>
<!--Дата и время создания сообщения-->
<CreDtTm>2024-10-01T10:10:10+02:00</CreDtTm>
<!--Число элементов в сообщении-->
<NbOfItms>1</NbOfItms>
<!--Секция: Отправитель сообщения-->
<InitgPty>
<Pty>
<!-- Наименование отправителя сообщения -->
<Nm>ООО 3ОАО НСГ ОАО</Nm>
<Id>
<!-- Секция: Идентификация компании -->
<OrgId>
<Othr>
<!-- ИНН/КИО отправителя -->
<Id>7867961169</Id>
<SchmeNm>
<!-- Код типа данных в поле Id (Обязательно к заполнению, если 2 и более секции <Othr>) -->
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
<CtctDtls>
<Nm>test name</Nm>
<PhneNb>+7-900-000-00-00</PhneNb>
</CtctDtls>
<!-- Секция: Контактная информация -->
</Pty>
</InitgPty>
</GrpHdr>
<!--Секция: Извещение о валютных операциях-->
<TxNtfctn>
<!-- Уникальный id пакета СВО во внешней системе -->
<TxNtfctnId>TESTRUMM-CTCNTF-20160503-001</TxNtfctnId>
<!--Секция: Владелец счета-->
<AcctOwnr>
<!-- Наименование владельца счета -->
<Nm>ООО 3ОАО НСГ ОАО</Nm>
<Id>
<OrgId>
<Othr>
<!-- ИНН/КИО владельца счета -->
<Id>7867961169</Id>
<SchmeNm>
<!-- Код типа данных в поле Id (Обязательно к заполнению, если 2 и более секции <Othr>) -->
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</AcctOwnr>
<!--Секция: Идентификация Финансовой организации-->
<AcctSvcr>
<FinInstnId>
<!--SWIFT-код банка клиента. Код, присвоенный финансовому учреждению регистрирующим органом ISO 9362-->
<BICFI>ABCDRUMMXXX</BICFI>
<!-- Секция: Идентификация в клиринговой системе -->
<ClrSysMmbId>
<!-- БИК банка, присвоенный ЦБ РФ-->
<MmbId>044525700</MmbId>
</ClrSysMmbId>
<!-- Наименование уполномоченного банка / Банк обслуживающий счет -->
<Nm>АО Raiffeisenbank</Nm>
</FinInstnId>
</AcctSvcr>
<!-- Секция: Справка о Валютных Операциях -->
<TxCert>
<!-- Уникальный идентификатор СВО -->
<TxId>TESTRUMM-CTCNTF-20160503-00101</TxId>
<Cert>
<!-- Номер документа по валютной операции -->
<Id>1</Id>
<!-- Дата составления СВО -->
<DtOfIsse>2024-10-01</DtOfIsse>
</Cert>
<!-- Счет, по которому прошла транзакция в рамках Паспорта Сделки -->
<Acct>
<Id>
<!-- Номер счета в формате IBAN (заполняется при наличии IBAN) -->
<!-- Если заполен IBAN, то секция Othr ниже не заполняется -->
<!-- <IBAN>DE89370400440532013000</IBAN> -->
<Othr>
<!-- Номер счета. Не заполняется, если заполнен IBAN строкой выше -->
<Id>40702810503000483656</Id>
<SchmeNm>
<!-- Код типа данных в поле Id (Обязательно к заполнению, если 2 и более секции <Othr>) -->
<Cd>BBAN</Cd>
</SchmeNm>
</Othr>
</Id>
</Acct>
<!-- Страна в которой открыт счет в случае если банк находится в другой стране -->
<BkAcctDmcltnCtry>US</BkAcctDmcltnCtry>
<!-- Секция: корректировочная информация -->
<Amdmnt>
<CrrctnId>777</CrrctnId>
<OrgnlDocId>TESTRUMM-CTCGTF-655689964-4734</OrgnlDocId>
</Amdmnt>
<!-- Секция: Информация о валютных платежах -->
<CertRcrd>
<!-- Номер строки СВО -->
<CertRcrdId>1</CertRcrdId>
<!--Секция: информация об операции(транзакции)-->
<Tx>
<!-- Секция: информация об исходном документе, на основании которого совершена операция или выписка по счету -->
<RfrdDoc>
<Id>
<!-- Идентификатор сообщения -->
<MsgId>3001</MsgId>
<!-- Референс транзакции, присвоенный банком -->
<AcctSvcrRef>RI201605010001</AcctSvcrRef>
<!-- Уникальный идентификатор для связи с ВП и РСТС -->
<!-- Чтобы установилась связь с ПП, ВП значение в этом теге должно совпадать со значением в теге /Document/CstmrCdtTrfInitn/PmtInf/PmtInfId в ПП, ВП -->
<PmtInfId>1cf2aaec-358c-43c4-b4ef-2acec53c2f7</PmtInfId>
<!-- Уникальный идентификатор платежной инструкции -->
<InstrId>345678</InstrId>
<!-- Идентификатор платежного поручения -->
<EndToEndId>79</EndToEndId>
</Id>
<!-- Дата документа, на основании которого совершена операция -->
<Dt>2024-09-30</Dt>
</RfrdDoc>
<!-- Дата транзакции/Дата операции -->
<TxDt>2024-10-01</TxDt>
<!-- Направление (признак) платежа: -->
<TxTp>1</TxTp>
<!-- Код валютной операции -->
<LclInstrm>11100</LclInstrm>
<!-- Сумма и валюта операции -->
<Amt Ccy="RUB">145400.03</Amt>
</Tx>
<!-- Секция: информация о транзакции относящаяся к контракту -->
<Ctrct>
<!-- Секция: информация о Контракте/Паспорте сделки -->
<CtrctRef>
<!-- Номер паспорта сделки -->
<RegdCtrctId>20020018/3292/0111/3/1</RegdCtrctId>
</CtrctRef>
<!-- Сумма и валюта операции в валюте контракта -->
<TxAmtInCtrctCcy Ccy="EUR">16500.00</TxAmtInCtrctCcy>
<!-- Ожидаемая дата поставки товара/услуги -->
<XpctdShipmntDt>2024-10-25</XpctdShipmntDt>
<!-- Ожидаемая дата возврата аванса -->
<XpctdAdvncPmtRtrDt>2024-10-25</XpctdAdvncPmtRtrDt>
<!-- Дополнительная информация -->
<AddtlInf>Примечание Test</AddtlInf>
</Ctrct>
</CertRcrd>
</TxCert>
</TxNtfctn>
</PmtRgltryInfNtfctn>
</Document>Подробно с форматом сообщений вы можете ознакомиться в разделе Формат импорта