Внесение изменений в валютные контракты

POST

https://business.tbank.ru/openapi/api/v1/currency/contracts/openapi/amendment

Внесение изменений в учетные контракты

Авторизация

Security

Bearer API Token

RPS

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

Scopes

Валютные контракты → Работа с методами сервиса валютных контрактов

Запрос

Header parameters

X-Request-Id

String<uuid>

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

Request body schema application/json

amendmentDocuments

Array of objects ()

Requirements: <= 1000 items

Список документов на внесение изменений

Required

documentDate

String<date>

documentNumber

String

Requirements: <= 100 characters

Required

attachments

Array of objects ()

Requirements: <= 1000 items

Required

documentId

Integer<int64>

Идентификатор файла в TECM

documentName

String

Requirements: <= 200 characters

version

Integer<int32>

Required

amendments

Object (AmendmentContractBodyL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

oneOf

ContractL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s
CreditL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s

amount

Number

assignmentResidentInfo

Object (AmendmentAssignmentResidentInfoL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

address

Object (ResidentAddress1L29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Адрес резидента

address

String

Requirements: <= 100 characters

Адрес

city

String

Requirements: <= 100 characters

Город

district

String

Requirements: <= 100 characters

Район

Required

subject

String

Requirements: <= 100 characters

Субъект Российской Федерации

Required

inn

String

Requirements: <= 12 characters

ИНН

Required

name

String

Requirements: <= 100 characters

Полное имя резидента

companyInfoUpdateType

String (CompanyInfoUpdateTypeL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Requirements: [NAME, KPP, NAME_AND_KPP]

Тип изменения данных о компании

contractDate

String<date>

contractNumber

String

Requirements: <= 100 characters

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

counterparty

Array of objects ()

Requirements: <= 1000 items

Required

name

String

Requirements: <= 300 characters

Наименование контрагента

Required

countryCode

String

Requirements: <= 3 characters

Цифровой код страны

signAffiliation

String (SignAffiliationL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Requirements: [YES, NO]

Признак аффилированности нерезидента

currencyCode

String

Requirements: <= 3 characters

Числовой код валюты

liabilitiesFinishDate

String<date>

Required

recordType

String

Requirements: [REGISTERED_CONTRACT]

specialContractTerms

Object (SpecialContractTermsL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

paymentFrequencyCode

Integer (PaymentFrequencyCodeL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)<int32>

Requirements: [1, 2, 3, 4, 5, 6]

Код периодичности платежей: 1 - День, 2 - Месяц, 3 - Квартал, 4 - Полугодие, 5 - Год, 6 - Иное

signOfConcession

String (SignOfConcessionL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Requirements: [YES, NO]

Признак наличия в контракте условий, соответствующих пункту 8.5 настоящей Инструкции

amount

Number

amountCreditedAbroad

Number

amountRepaidRevenue

Number

assignmentResidentInfo

Object (AmendmentAssignmentResidentInfoL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

address

Object (ResidentAddress1L29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Адрес резидента

address

String

Requirements: <= 100 characters

Адрес

city

String

Requirements: <= 100 characters

Город

district

String

Requirements: <= 100 characters

Район

Required

subject

String

Requirements: <= 100 characters

Субъект Российской Федерации

Required

inn

String

Requirements: <= 12 characters

ИНН

Required

name

String

Requirements: <= 100 characters

Полное имя резидента

companyInfoUpdateType

String (CompanyInfoUpdateTypeL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Requirements: [NAME, KPP, NAME_AND_KPP]

Тип изменения данных о компании

contractDate

String<date>

contractNumber

String

Requirements: <= 100 characters

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

counterparty

Array of objects ()

Requirements: <= 1000 items

Required

name

String

Requirements: <= 300 characters

Наименование контрагента

Required

countryCode

String

Requirements: <= 3 characters

Цифровой код страны

signAffiliation

String (SignAffiliationL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Requirements: [YES, NO]

Признак аффилированности нерезидента

creditBackgroundInfo

Object (CreditBackgroundInfoRequestL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

collateralAmount

Number<BigDecimal>

Requirements: <= 99999999999999.98

Сумма залогового или другого обеспечения

Required

directInvestmentMark

String (DirectInvestmentMarkL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

Requirements: [YES, NO]

Отметка о наличии отношений прямого инвестирования

paymentSchedule

Array of objects ()

Requirements: <= 1000 items

Описание графика платежей по возврату основного долга и процентных платежей

Required

currencyCode

String

Requirements: <= 3 characters

Код валюты кредитного договора

debtPaymentAmount

Number<BigDecimal>

Сумма платежа по погашению основного долга

debtPaymentDate

String<date>

Дата платежа по погашению основного долга

interestPaymentAmount

Number<BigDecimal>

Сумма платежа по погашению процентов

interestPaymentDate

String<date>

Дата платежа по погашению процентов

specialTerms

String

Requirements: <= 3000 characters

Описание особых условий

Required

sourceOfData

String

Requirements: [CREDIT_CONTRACT, ESTIMATED]

Основания заполнения подпункта

syndicatedCredits

Array of objects ()

Requirements: <= 1000 items

Информация о привлечении резидентом кредита (займа), предоставленного нерезидентами на синдицированный (консорциональной) основе

amount

Number

Required

counterpartyCountry

String

Requirements: <= 3 characters

Цифровой код страны

Required

counterpartyName

String

Requirements: <= 300 characters

Наименование контрагента

Number

creditSpecialInfo

Object (CreditSpecialInfoRequestL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

debt

Object

Сумма задолженности по основному долгу на дату, предшествующую по дате постановки на учет кредитного договора (присвоения уникального номера)

Required

amount

Number<BigDecimal>

Requirements: <= 999999999999.99

Сумма [BigDecimal]

bankRegistrationNumber

String

Requirements: Value must match regular expression ^\d{4}/\d{4}$

Рег. номер банка/филиала

Required

currencyCode

String

Requirements: <= 3 characters

Код валюты кредитного договора

reasonCode

Integer (ReasonCodeL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)<int32>

Requirements: [0, 1, 2, 3, 4, 5, 6, 7, 8]

Код основания погашения долга: 0 - Иное основание, 1 - Уступка уполномоченным банком другому лицу - резиденту требования к нерезиденту, 2 - Уступка физическим лицом - резидентом другому лицу - резиденту требования к нерезиденту, 3 - Уступка нерезидентом резиденту требования к другому лицу - нерезиденту, являющемуся стороной по заключенному между нерезидентами кредитному договору, 4 - Замена первоначального обязательства нерезидента перед резидентом по контракту обязательством нерезидента перед резидентом по кредитному договору (новация), 5 - Уступка уполномоченным банком нерезиденту требования к резиденту, 6 - Уступка физическим лицом - резидентом нерезиденту требования к другому лицу - резиденту, 7 - Уступка резидентом (первоначальным кредитором) нерезиденту требования к другому лицу - резиденту, являющемуся стороной по заключенному между резидентами кредитному договору, 8 - Замена первоначального обязательства резидента перед нерезидентом по контракту обязательством резидента по кредитному договору (новация)

uniqueContractNumbers

Array

Requirements: <= 1000 items

interestPayments

Object

Процентные платежи, предусмотренные кредитным договором (за исключением платежей по возврату основного долга)

interestRate

Number<BigDecimal>

Фиксированный размер процентной ставки, % годовых

interestSurcharge

Number<BigDecimal>

Размер процентной надбавки (дополнительных платежей) к базовой процентной ставке, % годовых

liborCode

String

Requirements: <= 6 characters

Код ставки LIBOR (London Interbank Offer Rate)

otherMethodsForInterestRate

String

Requirements: <= 3000 characters

Другие методы определения процентной ставки

otherPayments

Array

Requirements: <= 1000 items

Иные платежи, предусмотренные кредитным договором (за исключением платежей по возврату основного долга и процентных платежей)

currencyCode

String

Requirements: <= 3 characters

Числовой код валюты

durationCode

Integer<int32>

Requirements: [0, 1, 2, 3, 4, 6, 7, 8, 9]

Код срока привлечения (представления): 0 - Месяц, 1 - Квартал, 2 - Полугодие, 3 - Год, 4 - Три года, 6 - До востребования, 7 - Пять лет, 8 - Десять лет, 9 - Более десяти лет

historyTrancheInfoRequest

Object (HistoryTrancheInfoRequestL29wZW5hcGktYjJiLWN1cnJlbmN5LWNvbnRyYWN0cy55YW1s)

history

Array of objects ()

Requirements: >= 1 items, <= 1000 items

Required

amount

Number<BigDecimal>

Requirements: <= 999999999999.99

Сумма транша [BigDecimal]

Required

currencyCode

String

Requirements: <= 3 characters

Код валюты кредитного договора

Required

expectedTrancheDate

String<date>

Ожидаемая дата поступления транша

Required

trancheProvisionTermCode

Integer<int32>

Requirements: [0, 1, 2, 3, 4, 6, 7, 8, 9]

liabilitiesFinishDate

String<date>

Required

recordType

String

Requirements: [REGISTERED_CREDIT_CONTRACT]

Required

openApiApplicationId

String

Requirements: <= 36 characters

ID заявления полученного через OpenAPI

Required

uniqueContractNumber

String

Requirements: Value must match regular expression ^(?!0{2})\d{2}(?!0{2})\d{2}\d{4}/(?!0{4})\d{4}/\d{4}/\d/\d$

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

Ответ

200

400

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

401

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

403

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

422

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

429

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

500

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

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

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