Создание СВО

/api/v1/currency/rosbank/foreign-exchange-transaction

POST

https://business.tbank.ru/openapi/api/v1/currency/rosbank/foreign-exchange-transaction

Создание СВО по одному или нескольким платежам

Авторизация

Security

Bearer API Token

RPS

Ограничение — 20 запросов в секунду

Запрос

Header parameters

X-Request-Id

String<uuid>

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

Request body schema application/json

Required

id

String

Requirements: <= 128 characters

ID СВО

Required

document

Object

Информация о документе - источнике запроса

Required

id

String

Requirements: <= 128 characters

ID документа в системе-источнике

Required

byPayment

Array of objects ()

Requirements: <= 1024 items

Информация о платеже внутри СВО

Required

payment

Object

Информация о платеже

oneOf

MOD1

Required

type

String

Requirements: [INCOMING]

Тип платежа

Required

account

String

Requirements: <= 128 characters

Номер счета

Required

currency

String

Requirements: <= 16 characters

Буквенный код валюты

Required

keys

Object

Ключевые поля входящего платежа

Required

document

Object

Информация об уведомлении о пополнении транзитного счёта

Required

number

String

Requirements: <= 128 characters

Номер уведомления о пополнении транзитного счёта

Required

date

String<date>

Дата уведомления о пополнении транзитного счёта

Required

date

String<date>

Дата платежа

MOD2

Required

type

String

Requirements: [OUTGOING]

Тип платежа

Required

account

String

Requirements: <= 128 characters

Номер счета

Required

currency

String

Requirements: <= 16 characters

Буквенный код валюты

Required

keys

Object

Ключевые поля исходящего платежа

Required

document

Object

Информация о документе исходящего платежа

Required

number

String

Requirements: <= 128 characters

Номер документа исходящего платежа

Required

date

String<date>

Дата документа исходящего платежа

Required

date

String<date>

Дата платежа

Required

parts

Array of objects ()

Requirements: <= 1024 items

Информация об идентифицируемой части платежа

Required

id

String

Requirements: <= 128 characters

ID идентифицируемой части платежа

Required

sum

Number

Сумма идентифицируемой части платежа

Required

contract

Object

Информация о контракте

oneOf

MOD1

Required

type

String

Requirements: [REGISTERED]

Тип контракта

sum

Number

Сумма идентифицируемой части платежа в валюте контракта

Required

details

Object

Атрибуты УК контракта

Required

uniqueContractNumber

String

Requirements: <= 128 characters

Уникальный номер контракта

MOD2

Required

type

String

Requirements: [SMALL]

Тип контракта

sum

Number

Сумма идентифицируемой части платежа в валюте контракта

Required

details

Object

Атрибуты малого контракта

Required

number

String

Requirements: <= 128 characters

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

Required

date

String<date>

Срок возврата аванса

Required

operationTypeCode

String

Requirements: <= 64 characters

Код Вида Операции

documents

Array of objects ()

Requirements: <= 1024 items

Информация о подтверждающем документе

Required

id

String

Requirements: <= 128 characters

ID подтверждающего документа

Required

name

String

Requirements: <= 256 characters

Имя подтверждающего документа

expectedDeliveryDate

String<date>

Срок поставки товара

expectedPaybackDate

String<date>

Срок возврата аванса

Required

contactPerson

Object

Информация о представителя компании клиента, с которым нужно связывать по вопросам этого платежа

Required

name

String

Requirements: <= 256 characters

Имя представителя

Required

phone

String

Requirements: <= 128 characters

Телефон представителя

additionalInfo

String

Requirements: <= 4096 characters

Комментарий пользователя для валютного контроля по платежу внутри СВО

additionalInfo

String

Requirements: <= 4096 characters

Комментарий пользователя по СВО для валютного контроля по всему СВО

Ответ

200

Success

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Loading...