Перевод в валюте

Тип документа предназначен для перевода сумм в валюте.

Получение допустимых значений для перевода в валюте

Не является обязательным к использованию. Предназначен для удобства использования API по созданию и редактированию документа.

endpoint	/api/payment/international-transfer/source-field
Параметры строки запроса / Query String Parameters	fieldList=ACCOUNTS%2CCOMPANY_PERSONS%2CCOUNTERPARTIES%2CFEE_ACCOUNTS%2CKNP%2CPURPOSES%2CKBE%2CFEE_TYPES%2CCOUNTRIES%2CCURRENCY_OPERATION_TYPES%2CTEMPLATES%2CCONSTRAINTS%2CKVO%2CTRANSFER_RUB_CODE_OPERATIONS%2CBASIS_TAX_PAYMENTS%2CTAX_DOCUMENT_TYPES%2CCUSTOMER%2CDOCUMENT_NUMBER%2CUPLOAD_CONSTRAINTS
Request method	GET
Response status	200

примечание

разделитель для параметра fieldList – encoded - %2C; decoded –  , (запятая).

Дополнительные заголовки / Additional headers

Content-Type	application/json

Ответ / Response object

!Важно: В таблице описания ответа в графе “Примечание” описано значение и приведен связанный атрибут отправляемого объекта при создании или редактировании документа. Описание структур объектов ответа приведено в разделе ДЕНЕЖНЫЕ ОПЕРАЦИИ > Описание объектов

№	Поле	Тип данных	Примечание
1	ACCOUNTS	array of objects	Счета клиента национальной валюте (тенге). Соответствующий атрибут - account
2	BASIS_TAX_PAYMENTS	array of objects	Соответствующий атрибут basisTaxPayment = code
3	COMPANY_PERSONS	array of arrays	Массив фиксированной длины = 2. Для первого элемента – список лиц с правом первой подписи. Соответствующий атрибут – director. Для первого элемента – список лиц с правом второй подписи. Соответствующий атрибут - accountant
4	CONSTRAINTS	object	Список параметров для валидации атрибутов отправляемого объекта при создании или редактирования документа
5	COUNTRIES	array of objects	Список стран
6	CURRENCY_OPERATION_TYPES	array of objects	Типы валютных операций. Связанный атрибут currencyOperationType = code
7	CUSTOMER	object	Данные Компании-клиента (customer)
8	DOCUMENT_NUMBER	string	Возможный следующий номер создаваемого документа
9	FEE_ACCOUNTS	array of objects	Счет комиссии
10	FEE_TYPES	array of objects	Типы комиссий.  Соответствующий атрибут – feeTypeCode = code
11	KBE	array of objects	КБЕ бенефициара. Соответствующий атрибут – benefResidencyCode = code
12	KNP	array of objects	КНП
13	KVO	array of objects	Код валютной операции. Соответствующий атрибут – kvo = code
14	PURPOSES	array of strings	Список ранее используемых назначений платежа. Соответствующий атрибут – purpose
15	TAX_DOCUMENT_TYPES	array of objects
16	TEMPLATES	array of objects	Список шаблонов документа
17	TRANSFER_RUB_CODE_OPERATIONS	array of objects	Типы операций переводов в рубли
18	UPLOAD_CONSTRAINTS	object	ограничения для загружаемых файлов

Создание перевода в валюте

endpoint	/api/payment/ international-transfer/new
Request method	POST
Response status	200

Дополнительные заголовки / Additional headers

Content-Type	application/json

Тело запроса / Body

!ВАЖНО: в примечаниях постоянные значения в рамках текущего запроса выделяются цветом.

№	Поле	Тип данных	Является обязательным	Примечание
1	account	object	Да	AccountShortView – описание в таблице далее
2	director	object	Да	CustomerUserShortView – описание в таблице далее
3	accountant	object	Да	CustomerUserShortView – описание в таблице далее
4	agentCorrAccount	string		Банк-агент: Корреспондентский счет
5	agentBankId	long		Банк-агент: Идентификатор в системе
6	agentBankName	string		Банк-агент: Название
7	agentBankCode	string		Банк-агент: Код
8	agentBankCountry	string		Банк-агент: Страна
9	agentBankCountryCode	string		Банк-агент: Код страны
10	agentBankCity	string		Банк-агент: Город
11	agentBankAddress	string		Банк-агент: Адрес
12	basisTaxPayment	string
13	benefAccount	string	Да	Счет бенефициара
14	benefAddress	string	Да	Адрес бенефициара
15	benefBankCode	string	Да	Код банка бенефициара
16	benefBankAddress	string	Да	Адрес банка бенефициара
17	benefBankCity	string	Да	Город банка бенефициара
18	benefBankCorrAccount	string		Корреспондентский счет банка бенефициара
19	benefBankCountry	string	Да	Страна банка бенефициара
20	benefBankCountryCode	string		Код страны банка бенефициара
21	benefBankName	string	Да	Название банка бенефициара
22	benefCity	string	Да	Город бенефициара
23	benefCountryCode	string	Да	Код страны бенефициара
24	benefId	long		Идентификатор бенефициара в Системе
25	benefKpp	string
26	benefName	string	Да	Наименование бенефициара
27	benefResidencyCode	string	Да	Код резидента бенефициара
28	benefTaxCode	string		БИН бенефициара
29	amount	decimal	Да	Сумма перевода. Формат – "########.##"
30	contractAuditDate	date
31	contractAuditNumber	string
32	contractDate	string		Дата валютного контракта
33	contractId	long		Идентификатор валютного контракта в Системе
34	contractNumber	string		Номер валютного контракта
35	currencyOperationType	string	Да	Значение - ""
36	feeAccount	object		Счет взимания комиссии. Обязательно при feeTypeCode = "OUR"
37	feeTypeCode	string	Да
38	field_N4	string
39	field_N5	string
40	info	string
41	invoice	string		Номер инвойса
42	invoiceDate	date		Дата инвойса
43	operationTypeCode	string
44	number	string	Да	Номер платежного документа. Не более 9 знаков.
45	valueDate	date	Да	Дата документа. Формат - "dd.MM.yyyy"
46	priority	boolean	Да	Срочный платеж (false)
47	purposeCode	string	Да	Код КНП
48	purpose	string	Да	Назначение
49	purposeUserValue	string	Да
50	senderAddress	string	Да	Адрес отправителя
51	taxDocumentDate	date
52	taxDocumentType	string
53	taxIdNumber	long
54	taxPeriod	date
55	transliterate	boolean	Да	false
56	kvo	string		Код валютной операции
57	kvoLabe	string		Расшифровка кода валютной операции
58	isNotLinkTerrorism	boolean	Да	true
59	isNotNeedUnc	boolean	Да	false
60	isPermitGiveInformation	boolean	Да	false
61	isRaw	boolean	Да	Признак для черновика (false)
62	isTemplate	boolean	Да	false
63	templateName	string		null
64	internationalCodeOperationCny	string
65	internationalCodeOperationUae	string
66	custTaxCode	string
67	internationalPaymentTypes	string
68	withNDS	boolean

Object: account (AccountShortView)

№	Поле	Тип данных	Является обязательным	Примечание
1	id	long	Да	Идентификатор в Системе
2	number	string	Да	Номер счета
3	cardNumber	string
4	currency	string		Валюта
5	currencyDigital	long
6	balance	decimal		Текущий баланс
7	plannedBalance	decimal
8	alias	string
9	externalCustomerId	string
10	type	string
11	accountType	string
12	expirationDate	datetime
13	status	object		CodeDto – описание в таблице в разделе ДЕНЕЖНЫЕ ОПЕРАЦИИ > Описание базового объекта (PaymentView)
14	gk

Object: feeAccount (AccountShortView)

№	Поле	Тип данных	Является обязательным	Примечание
1	id	long	Да	Идентификатор в Системе
2	number	string	Да	Номер счета
3	accountType	string
4	alias	string
5	balance	decimal		Текущий баланс
6	cardNumber	string
7	currency	string		Валюта
8	currencyDigital	long
9	expirationDate	datetime
10	externalCustomerId	string
11	plannedBalance	decimal
12	type	string
13	status	object		CodeDto – описание в таблице в разделе ДЕНЕЖНЫЕ ОПЕРАЦИИ > Описание базового объекта (PaymentView)
14	gk

Object: director, accountant (CustomerUserShortView)

№	Поле	Тип данных	Является обязательным	Примечание
1	id	long	Да	Идентификатор в Системе
2	fullName	string	Да	ФИО
3	position	string		Должность
4	sign_level	string	Да	Уровень права подписи

Ответ / Response object

№	Поле	Тип данных	Примечание
1	value	long	Идентификатор созданного в Системе документа id

Пример запроса

Показать запрос

cURL

curl --location \
  'https://api-test.berekebank.kz/api/payment/international-transfer/new' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data-raw $'{"account":{"id":6231119,"number":"KZ00000KZT0000000000","cardNumber":null,"currency":"RUB","currencyDigital":null,"balance":0,"plannedBalance":0,"alias":"Текущий счет АО «Демо Трейд»                                       ","externalCustomerId":null,"type":null,"accountType":"Current","expirationDate":null,"status":{"id":null,"code":"1","label":"Открыт","subCode":"1","subLabel":"Открыт"},"gk":2203},"amount":"5","valueDate":"27.06.2025","purpose":"\'(VO00000)\' ИНВрлпароапроапшро ДТ01.06.2025   БЕЗ НДС","purposeCode":"710","purposeUserValue":"","number":"1","isTemplate":false,"director":{"id":482113,"fullName":"Иванов Иван Иванович","position":"","sign_level":"A"},"senderAddress":"Almaty, mkr. Demo, 28/4","accountant":{"id":-1,"value":{"id":-1},"label":"Не предусмотрен","fullName":"Не предусмотрен"},"transliterate":true,"feeTypeCode":"OUR","feeAccount":{"id":0,"number":"KZ00000KZT0000000000","cardNumber":null,"currency":"KZT","currencyDigital":null,"balance":0,"plannedBalance":0,"alias":"Текущий счет АО «Демо Трейд»                                       ","externalCustomerId":null,"type":null,"accountType":"Current","expirationDate":null,"status":{"id":null,"code":"1","label":"Открыт","subCode":"1","subLabel":"Открыт"},"gk":2203},"kvo":null,"kvoLabe":null,"internationalCodeOperationCny":null,"internationalCodeOperationUae":null,"currencyOperationType":"00000","contractNumber":"","contractDate":null,"invoice":"рлпароапроапшро","invoiceDate":"01.06.2025","contractAuditNumber":null,"contractAuditDate":null,"contractId":null,"isNotNeedUnc":false,"isNotLinkTerrorism":true,"benefName":"ПАО ","benefTaxCode":"0000000000","benefAccount":"00000000000000000000","benefBankCode":"BRKEKZKA","benefResidencyCode":"24","benefKpp":"000000000","benefCountryCode":"RU","benefCity":"РФ","benefAddress":"111111, г. Москва, ул. Демонстрационная, д.19","benefBankCorrAccount":"KZ00000KZT0000000000","benefBankName":"АО \\"Bereke Bank\\"","benefBankCountry":"КАЗАХСТАН","benefBankCountryCode":"KZ","benefBankCity":"АЛМАТЫ","benefBankAddress":"РК, г. Алматы, пр. Демонстрационный, 220","agentBankName":null,"agentBankCode":null,"agentCorrAccount":null,"agentBankCountry":null,"agentBankCity":null,"agentBankAddress":null,"isPermitGiveInformation":false,"isRaw":false,"operationTypeCode":null,"field_N4":null,"field_N5":null,"basisTaxPayment":null,"taxPeriod":null,"taxIdNumber":null,"taxDocumentDate":null,"taxDocumentType":null,"custTaxCode":"000000000000","internationalPaymentTypes":"Russia_Or_BB","withNDS":false}'

Пример ответа

Показать ответ

{
  "value": 123456
}

Редактирование перевода в валюте

Редактирование платежного поручения доступно только для документов с активным статусом Черновик (Raw) или Новый (Draft).

endpoint	/api/payment/international-transfer/{id}
Request method	POST
Response status	200

примечание

id – идентификатор созданного в Системе документа.

Дополнительные заголовки / Additional headers

Content-Type	application/json

Тело запроса / Body

Смотреть Создание перевода в валюте > Тело запроса / Body

Ответ / Response object

№	Поле	Тип данных	Примечание
1	value	long	Идентификатор отредактированного в Системе документа id

Пример запроса

Показать запрос

cURL

curl --location 'https://api-test.business-t.berekebank.kz/api/payment/international-transfer/1111111' \
  --header 'Authorization: []' \
  --data '{ "account": { "id": 0, "number": "KZ00000KZT0000000000", "cardNumber": null, "currency": "USD", "currencyDigital": null, "balance": 0, "plannedBalance": 0, "alias": "Текущий счет АО «Демо Трейд»", "externalCustomerId": null, "type": null, "accountType": "Current", "expirationDate": null, "status": { "id": null, "code": "1", "label": "Открыт", "subCode": "1", "subLabel": "Открыт" }, "gk": 0 }, "amount": "50", "valueDate": "18.02.2025", "purpose": "Кнтр405/50 ДТ17.03.2017 УНВД0/000/0000/0000 ДТ10.07.2019 123", "purposeCode": "131", "purposeUserValue": "", "number": "6", "isTemplate": false, "director": { "id": 0, "fullName": "Иванов Иван Иванович", "position": null, "sign_level": "A" }, "senderAddress": "Almaty, mkr. Demo, 28/4", "accountant": { "id": 0, "fullName": "Иванов Иван Иванович", "position": "", "sign_level": "A" }, "info": "000", "transliterate": false, "feeTypeCode": "OUR", "feeAccount": { "id": 980, "number": "KZ00000KZT0000000000", "cardNumber": null, "currency": "KZT", "currencyDigital": null, "balance": 0.00, "plannedBalance": 0.00, "alias": "Общий счет", "externalCustomerId": null, "type": null, "accountType": "Current", "expirationDate": null, "status": { "id": null, "code": "1", "label": "Открыт", "subCode": "1", "subLabel": "Открыт" }, "gk": 2203 }, "kvo": "000", "kvoLabe": "перевод денег с (на) собственного (собственный) счета (счет) в иностранном банке", "internationalCodeOperationCny": null, "internationalCodeOperationUae": null, "currencyOperationType": "", "contractNumber": "000/00", "contractDate": "17.03.2017", "invoiceDate": "", "contractAuditNumber": "0/000/0000/0000", "contractAuditDate": "10.07.2019", "contractId": 0, "isNotNeedUnc": false, "isNotLinkTerrorism": true, "benefName": "OOO DEMO IMPORT", "benefTaxCode": "190940000029", "benefAccount": "qwe", "benefBankCode": "EABRKZKA", "benefResidencyCode": "26", "benefKpp": null, "benefCountryCode": "AE", "benefCity": "Москва", "benefAddress": "111111, г. Москва, ул. Демонстрационная, д.19", "benefBankCorrAccount": "KZ00000KZT0000000000", "benefBankName": "АО «Демо Банк РФ»", "benefBankCountry": "РОССИЯ", "benefBankCountryCode": "RU", "benefBankCity": "Алматы", "benefBankAddress": "РК, г. Алматы, пр. Демонстрационный, 220", "isPermitGiveInformation": false, "isRaw": false, "operationTypeCode": null, "field_N4": null, "field_N5": null, "basisTaxPayment": null, "taxPeriod": null, "taxIdNumber": null, "taxDocumentDate": null, "taxDocumentType": null, "custTaxCode": "000000000000", "internationalPaymentTypes": "Another_Country", "withNDS": false }'

Пример ответа

Показать ответ

{
  "value": 36550042
}